[api-extractor] Upgrade bundled TypeScript to 5.7 (#4815)

* WIP: [api-extractor] Upgrade bundled TypeScript to 5.5

1. Upgrade TypeScript to `5.5.2`
2. Upgrade @typescript-eslint/parser to `7.14.1`
3. Adopt breaking changes of typescript-eslint

* rush change

* Upgrade API Extractor's bundled TypeScript version to 5.7.2

* Update TypeScriptInternals.ts to reflect changes in TypeScript 5.7.2
NOTE: This is a type signature change that didn't affect the runtime contract; it should be fully backwards compatible

* rush update

* Fix a warning caused by TypeScript 5.7.2 strict checks complaining about resolve() signatures being inconsistent between @types/node/module.d.ts and lib.dom.d.ts:

Warning: C:/Git/rushstack/common/temp/default/node_modules/.pnpm/@types[email protected]/node_modules/@types/node/module.d.ts:210:13 - (TS2386) Overload signatures must all be optional or required.

* Temporarily suppress warning caused by TypeScript 5.7.2 being incompatible with @types/[email protected]:

Warning: C:\Git\rushstack\common\temp\default\node_modules\.pnpm\@types[email protected]\node_modules\@types\node\ts3.2\globals.d.ts:10:11 - (TS2320) Interface 'Buffer' cannot simultaneously extend types 'Uint8Array<ArrayBuffer>' and 'Uint8Array<ArrayBufferLike>'.
Named property 'buffer' of types 'Uint8Array<ArrayBuffer>' and 'Uint8Array<ArrayBufferLike>' are not identical.

* rush change

---------

Co-authored-by: Qingyu Wang <[email protected]>
Co-authored-by: Pete Gonzalez <[email protected]>

Author: colinaaa

apps/api-extractor/package.json

@@ -49,7 +49,7 @@
     "resolve": "~1.22.1",
     "semver": "~7.5.4",
     "source-map": "~0.6.1",
-    "typescript": "5.4.2"
+    "typescript": "5.7.2"
   },
   "devDependencies": {
     "@rushstack/heft-node-rig": "2.6.44",

apps/api-extractor/src/analyzer/TypeScriptInternals.ts

@@ -101,12 +101,12 @@ export class TypeScriptInternals {
    * Gets the mode required for module resolution required with the addition of Node16/nodenext
    */
   public static getModeForUsageLocation(
-    file: { impliedNodeFormat?: ts.SourceFile['impliedNodeFormat'] },
+    file: ts.SourceFile,
     usage: ts.StringLiteralLike,
     compilerOptions: ts.CompilerOptions
   ): ts.ModuleKind.CommonJS | ts.ModuleKind.ESNext | undefined {
     // Compiler internal:
-    // https://github.com/microsoft/TypeScript/blob/v4.7.2/src/compiler/program.ts#L568
+    // https://github.com/microsoft/TypeScript/blob/v5.7.2/src/compiler/program.ts#L940
 
     return ts.getModeForUsageLocation?.(file, usage, compilerOptions);
   }

apps/api-extractor/src/generators/ApiModelGenerator.ts

@@ -266,7 +266,7 @@ export class ApiModelGenerator {
   }
 
   private _tryFindFunctionDeclaration(astDeclaration: AstDeclaration): ts.FunctionDeclaration | undefined {
-    const children: ts.Node[] = astDeclaration.declaration.getChildren(
+    const children: readonly ts.Node[] = astDeclaration.declaration.getChildren(
       astDeclaration.declaration.getSourceFile()
     );
     return children.find(ts.isFunctionTypeNode) as ts.FunctionDeclaration | undefined;

build-tests/api-documenter-scenarios/tsconfig.json

@@ -9,7 +9,7 @@
     "experimentalDecorators": true,
     "strictNullChecks": true,
     "types": ["node", "jest"],
-    "lib": ["es5", "scripthost", "es2015.collection", "es2015.promise", "es2015.iterable", "dom"],
+    "lib": ["es5", "scripthost", "es2015.collection", "es2015.promise", "es2015.iterable"],
     "outDir": "lib"
   },
   "include": ["src/**/*.ts"]

build-tests/api-extractor-d-cts-test/tsconfig.json

@@ -9,7 +9,7 @@
     "experimentalDecorators": true,
     "strictNullChecks": true,
     "types": ["node", "jest"],
-    "lib": ["es5", "scripthost", "es2015.collection", "es2015.promise", "es2015.iterable", "dom"],
+    "lib": ["es5", "scripthost", "es2015.collection", "es2015.promise", "es2015.iterable"],
     "outDir": "lib"
   },
   "include": ["src/**/*.cts", "typings/tsd.d.ts"]

build-tests/api-extractor-d-mts-test/tsconfig.json

@@ -9,7 +9,7 @@
     "experimentalDecorators": true,
     "strictNullChecks": true,
     "types": ["node", "jest"],
-    "lib": ["es5", "scripthost", "es2015.collection", "es2015.promise", "es2015.iterable", "dom"],
+    "lib": ["es5", "scripthost", "es2015.collection", "es2015.promise", "es2015.iterable"],
     "outDir": "lib"
   },
   "include": ["src/**/*.mts", "typings/tsd.d.ts"]

build-tests/api-extractor-lib1-test/tsconfig.json

@@ -7,7 +7,7 @@
     "sourceMap": true,
     "experimentalDecorators": true,
     "strictNullChecks": true,
-    "lib": ["es5", "scripthost", "es2015.collection", "es2015.promise", "es2015.iterable", "dom"],
+    "lib": ["es5", "scripthost", "es2015.collection", "es2015.promise", "es2015.iterable"],
     "outDir": "lib"
   },
   "include": ["src/**/*.ts"]

build-tests/api-extractor-lib2-test/tsconfig.json

@@ -9,7 +9,7 @@
     "experimentalDecorators": true,
     "strictNullChecks": true,
     "types": ["node", "jest"],
-    "lib": ["es5", "scripthost", "es2015.collection", "es2015.promise", "es2015.iterable", "dom"],
+    "lib": ["es5", "scripthost", "es2015.collection", "es2015.promise", "es2015.iterable"],
     "outDir": "lib"
   },
   "include": ["src/**/*.ts", "typings/tsd.d.ts"]

build-tests/api-extractor-lib3-test/tsconfig.json

@@ -9,7 +9,7 @@
     "experimentalDecorators": true,
     "strictNullChecks": true,
     "types": ["node", "jest"],
-    "lib": ["es5", "scripthost", "es2015.collection", "es2015.promise", "es2015.iterable", "dom"],
+    "lib": ["es5", "scripthost", "es2015.collection", "es2015.promise", "es2015.iterable"],
     "outDir": "lib"
   },
   "include": ["src/**/*.ts", "typings/tsd.d.ts"]

build-tests/api-extractor-lib4-test/tsconfig.json

@@ -9,7 +9,7 @@
     "experimentalDecorators": true,
     "strictNullChecks": true,
     "types": ["node", "jest"],
-    "lib": ["es5", "scripthost", "es2015.collection", "es2015.promise", "es2015.iterable", "dom"],
+    "lib": ["es5", "scripthost", "es2015.collection", "es2015.promise", "es2015.iterable"],
     "outDir": "lib"
   },
   "include": ["src/**/*.ts", "typings/tsd.d.ts"]