consider this code :
//some-lib.d.ts
declare function foo():number | undefined
when somebody use some-lib.d.ts with tsc1.8 , they will got a exception some-lib.d.ts(1,33): error TS2304: Cannot find name 'undefined'. . And they will be confused because they may not know about strict-null features in TypeScript 2.0
So I think we should add a 'min-tsc-version' on d.ts file , for example :
//some-lib.d.ts
/// min-tsc-version : 2.0.0
declare function foo():number | undefined
//tsconfig.json
{
“compileOption": {
"min-tsc-version":2.0.0
}
}