feat: upgrade TypeScript to 5.0

Author: uhyo

TypeScript

@@ -23,7 +23,10 @@ async function main() {
   const libFiles = await getLibFiles();
   const hasDiffFiles: string[] = [];
   for (const [targetFile, sourceFile] of libFiles.entries()) {
-    const betterLib = generate(tsLibDir, targetFile, sourceFile, false);
+    const betterLib = generate(tsLibDir, targetFile, sourceFile, {
+      emitOriginalAsComment: false,
+      emitNoDefaultLib: false,
+    });
     if (betterLib === undefined) {
       continue;
     }

build/diff.ts

@@ -21,7 +21,10 @@ async function main() {
 
   // modify each lib file
   for (const [targetFile, sourceFile] of libFiles.entries()) {
-    let result = generate(tsLibDir, targetFile, sourceFile, true);
+    let result = generate(tsLibDir, targetFile, sourceFile, {
+      emitOriginalAsComment: true,
+      emitNoDefaultLib: true,
+    });
     if (result === undefined) {
       continue;
     }

build/lib.ts

@@ -6,14 +6,19 @@ import { projectDir } from "./projectDir";
 
 const betterLibDir = path.join(projectDir, "lib");
 
+type GenerateOptions = {
+  emitOriginalAsComment?: boolean;
+  emitNoDefaultLib?: boolean;
+};
+
 /**
  * Generate one better lib file.
  */
 export function generate(
   tsLibDir: string,
   targetFile: string,
   sourceFile: string,
-  emitOriginalAsComment: boolean
+  { emitOriginalAsComment = false, emitNoDefaultLib = false }: GenerateOptions
 ): string | undefined {
   const tsLibFile = path.join(tsLibDir, sourceFile);
   const originalProgram = ts.createProgram([tsLibFile], {});
@@ -24,9 +29,11 @@ export function generate(
 
   const printer = ts.createPrinter();
 
-  // This is used as a good indicator of being a default lib file
-  let result = `/// <reference no-default-lib="true"/>
-`;
+  let result = emitNoDefaultLib
+    ? // This is used as a good indicator of being a default lib file
+      `/// <reference no-default-lib="true"/>
+`
+    : "";
 
   const replacementTargets = scanBetterFile(printer, targetFile);
 
@@ -332,10 +339,10 @@ function printInterface(
   let result = originalNode
     .getFullText(originalSourceFile)
     .slice(0, originalNode.getLeadingTriviaWidth(originalSourceFile));
-  for (const dec of originalNode.decorators ?? []) {
+  for (const mod of originalNode.modifiers ?? []) {
     result += printer.printNode(
       ts.EmitHint.Unspecified,
-      dec,
+      mod,
       originalSourceFile
     );
   }
@@ -414,7 +421,7 @@ function replaceAliases(
         }
         return ts.visitEachChild(node, visitor, context);
       };
-      return ts.visitNode(sourceStatement, visitor);
+      return ts.visitNode(sourceStatement, visitor, ts.isStatement);
     },
   ]).transformed[0];
 }

build/logic/generate.ts

@@ -4,72 +4,20 @@
 The following files are improved in better-typescript-lib:
 
 - [es5.d.ts](./diff/es5.d.ts.md)
-- [es2015.d.ts](./diff/es2015.d.ts.md)
-- [es2016.d.ts](./diff/es2016.d.ts.md)
-- [es2017.d.ts](./diff/es2017.d.ts.md)
-- [es2018.d.ts](./diff/es2018.d.ts.md)
-- [es2019.d.ts](./diff/es2019.d.ts.md)
-- [es2020.d.ts](./diff/es2020.d.ts.md)
-- [es2021.d.ts](./diff/es2021.d.ts.md)
-- [es2022.d.ts](./diff/es2022.d.ts.md)
-- [esnext.d.ts](./diff/esnext.d.ts.md)
 - [dom.generated.d.ts](./diff/dom.generated.d.ts.md)
-- [dom.iterable.generated.d.ts](./diff/dom.iterable.generated.d.ts.md)
-- [webworker.generated.d.ts](./diff/webworker.generated.d.ts.md)
-- [webworker.importscripts.d.ts](./diff/webworker.importscripts.d.ts.md)
-- [webworker.iterable.generated.d.ts](./diff/webworker.iterable.generated.d.ts.md)
-- [scripthost.d.ts](./diff/scripthost.d.ts.md)
 - [es2015.core.d.ts](./diff/es2015.core.d.ts.md)
 - [es2015.collection.d.ts](./diff/es2015.collection.d.ts.md)
 - [es2015.generator.d.ts](./diff/es2015.generator.d.ts.md)
 - [es2015.iterable.d.ts](./diff/es2015.iterable.d.ts.md)
 - [es2015.promise.d.ts](./diff/es2015.promise.d.ts.md)
 - [es2015.proxy.d.ts](./diff/es2015.proxy.d.ts.md)
 - [es2015.reflect.d.ts](./diff/es2015.reflect.d.ts.md)
-- [es2015.symbol.d.ts](./diff/es2015.symbol.d.ts.md)
 - [es2015.symbol.wellknown.d.ts](./diff/es2015.symbol.wellknown.d.ts.md)
-- [es2016.array.include.d.ts](./diff/es2016.array.include.d.ts.md)
 - [es2017.object.d.ts](./diff/es2017.object.d.ts.md)
-- [es2017.sharedmemory.d.ts](./diff/es2017.sharedmemory.d.ts.md)
-- [es2017.string.d.ts](./diff/es2017.string.d.ts.md)
-- [es2017.intl.d.ts](./diff/es2017.intl.d.ts.md)
-- [es2017.typedarrays.d.ts](./diff/es2017.typedarrays.d.ts.md)
 - [es2018.asyncgenerator.d.ts](./diff/es2018.asyncgenerator.d.ts.md)
 - [es2018.asynciterable.d.ts](./diff/es2018.asynciterable.d.ts.md)
-- [es2018.regexp.d.ts](./diff/es2018.regexp.d.ts.md)
-- [es2018.promise.d.ts](./diff/es2018.promise.d.ts.md)
-- [es2018.intl.d.ts](./diff/es2018.intl.d.ts.md)
-- [es2019.array.d.ts](./diff/es2019.array.d.ts.md)
 - [es2019.object.d.ts](./diff/es2019.object.d.ts.md)
-- [es2019.string.d.ts](./diff/es2019.string.d.ts.md)
-- [es2019.symbol.d.ts](./diff/es2019.symbol.d.ts.md)
-- [es2019.intl.d.ts](./diff/es2019.intl.d.ts.md)
 - [es2020.bigint.d.ts](./diff/es2020.bigint.d.ts.md)
-- [es2020.date.d.ts](./diff/es2020.date.d.ts.md)
-- [es2020.promise.d.ts](./diff/es2020.promise.d.ts.md)
-- [es2020.sharedmemory.d.ts](./diff/es2020.sharedmemory.d.ts.md)
-- [es2020.string.d.ts](./diff/es2020.string.d.ts.md)
-- [es2020.symbol.wellknown.d.ts](./diff/es2020.symbol.wellknown.d.ts.md)
-- [es2020.intl.d.ts](./diff/es2020.intl.d.ts.md)
-- [es2020.number.d.ts](./diff/es2020.number.d.ts.md)
 - [es2021.string.d.ts](./diff/es2021.string.d.ts.md)
 - [es2021.promise.d.ts](./diff/es2021.promise.d.ts.md)
-- [es2021.weakref.d.ts](./diff/es2021.weakref.d.ts.md)
-- [es2021.intl.d.ts](./diff/es2021.intl.d.ts.md)
-- [es2022.array.d.ts](./diff/es2022.array.d.ts.md)
-- [es2022.error.d.ts](./diff/es2022.error.d.ts.md)
-- [es2022.intl.d.ts](./diff/es2022.intl.d.ts.md)
 - [es2022.object.d.ts](./diff/es2022.object.d.ts.md)
-- [es2022.sharedmemory.d.ts](./diff/es2022.sharedmemory.d.ts.md)
-- [es2022.string.d.ts](./diff/es2022.string.d.ts.md)
-- [esnext.intl.d.ts](./diff/esnext.intl.d.ts.md)
-- [es5.full.d.ts](./diff/es5.full.d.ts.md)
-- [es2015.full.d.ts](./diff/es2015.full.d.ts.md)
-- [es2016.full.d.ts](./diff/es2016.full.d.ts.md)
-- [es2017.full.d.ts](./diff/es2017.full.d.ts.md)
-- [es2018.full.d.ts](./diff/es2018.full.d.ts.md)
-- [es2019.full.d.ts](./diff/es2019.full.d.ts.md)
-- [es2020.full.d.ts](./diff/es2020.full.d.ts.md)
-- [es2021.full.d.ts](./diff/es2021.full.d.ts.md)
-- [es2022.full.d.ts](./diff/es2022.full.d.ts.md)
-- [esnext.full.d.ts](./diff/esnext.full.d.ts.md)

docs/diff.md

@@ -5,13 +5,7 @@ Index: dom.generated.d.ts
 ===================================================================
 --- dom.generated.d.ts
 +++ dom.generated.d.ts
-@@ -1,4 +1,5 @@
-+/// <reference no-default-lib="true"/>
- /////////////////////////////
- /// Window APIs
- /////////////////////////////
- 
-@@ -2800,9 +2801,9 @@
+@@ -2821,9 +2821,9 @@
    readonly bodyUsed: boolean;
    arrayBuffer(): Promise<ArrayBuffer>;
    blob(): Promise<Blob>;

docs/diff/dom.generated.d.ts.md

@@ -5,13 +5,7 @@ Index: es2015.collection.d.ts
 ===================================================================
 --- es2015.collection.d.ts
 +++ es2015.collection.d.ts
-@@ -1,4 +1,5 @@
-+/// <reference no-default-lib="true"/>
- interface Map<K, V> {
-   clear(): void;
-   /**
-    * @returns true if an element in the Map existed and has been removed, or false if the element does not exist.
-@@ -6,11 +7,11 @@
+@@ -6,11 +6,11 @@
    delete(key: K): boolean;
    /**
     * Executes a provided function once per each key/value pair in the Map, in insertion order.
@@ -26,7 +20,7 @@ Index: es2015.collection.d.ts
    /**
     * Returns a specified element from the Map object. If the value that is associated to the provided key is an object, then you will get a reference to that object and any change made to that object will effectively modify it inside the Map.
     * @returns Returns the element associated with the specified key. If no element is associated with the specified key, undefined is returned.
-@@ -30,18 +31,17 @@
+@@ -30,18 +30,17 @@
    readonly size: number;
  }
 
@@ -49,7 +43,7 @@ Index: es2015.collection.d.ts
    get(key: K): V | undefined;
    has(key: K): boolean;
    readonly size: number;
-@@ -68,12 +68,12 @@
+@@ -68,12 +67,12 @@
    set(key: K, value: V): this;
  }
 
@@ -65,7 +59,7 @@ Index: es2015.collection.d.ts
  declare var WeakMap: WeakMapConstructor;
 
  interface Set<T> {
-@@ -90,11 +90,11 @@
+@@ -90,11 +89,11 @@
    delete(value: T): boolean;
    /**
     * Executes a provided function once per each value in the Set object, in insertion order.
@@ -80,7 +74,7 @@ Index: es2015.collection.d.ts
    /**
     * @returns a boolean indicating whether an element with the specified value exists in the Set or not.
     */
-@@ -105,17 +105,17 @@
+@@ -105,17 +104,17 @@
    readonly size: number;
  }
 

docs/diff/dom.iterable.generated.d.ts.md

@@ -5,19 +5,13 @@ Index: es2015.core.d.ts
 ===================================================================
 --- es2015.core.d.ts
 +++ es2015.core.d.ts
-@@ -1,4 +1,5 @@
-+/// <reference no-default-lib="true"/>
- interface Array<T> {
-   /**
-    * Returns the value of the first element in the array where predicate is true, and undefined
-    * otherwise.
-@@ -7,15 +8,25 @@
+@@ -7,15 +7,25 @@
     * immediately returns that element value. Otherwise, find returns undefined.
     * @param thisArg If provided, it will be used as the this value for each invocation of
     * predicate. If it is not provided, undefined is used instead.
     */
 -  find<S extends T>(
--    predicate: (this: void, value: T, index: number, obj: T[]) => value is S,
+-    predicate: (value: T, index: number, obj: T[]) => value is S,
 -    thisArg?: any
 +  find<S extends T, This = undefined>(
 +    predicate: (this: This, value: T, index: number, obj: this) => value is S,
@@ -43,7 +37,7 @@ Index: es2015.core.d.ts
 
    /**
     * Returns the index of the first element in the array where predicate is true, and -1
-@@ -25,11 +36,11 @@
+@@ -25,11 +35,11 @@
     * findIndex immediately returns that element index. Otherwise, findIndex returns -1.
     * @param thisArg If provided, it will be used as the this value for each invocation of
     * predicate. If it is not provided, undefined is used instead.
@@ -58,7 +52,7 @@ Index: es2015.core.d.ts
 
    /**
     * Changes all array elements from `start` to `end` index to a static `value` and returns the modified array
-@@ -54,23 +65,23 @@
+@@ -54,23 +64,23 @@
  }
 
  interface ArrayConstructor {
@@ -91,7 +85,7 @@ Index: es2015.core.d.ts
 
    /**
     * Returns a new array from a set of elements.
-@@ -273,49 +284,20 @@
+@@ -273,49 +283,20 @@
    /**
     * Copy the values of all of the enumerable own properties from one or more source objects to a
     * target object. Returns the target object.
@@ -146,7 +140,7 @@ Index: es2015.core.d.ts
    /**
     * Returns the names of the enumerable string properties and methods of an object.
     * @param o Object that contains the properties and methods. This can be an object that you created or an existing Document Object Model (DOM) object.
-@@ -326,16 +308,23 @@
+@@ -326,16 +307,23 @@
     * Returns true if the values are the same value, false otherwise.
     * @param value1 The first value.
     * @param value2 The second value.
@@ -172,18 +166,13 @@ Index: es2015.core.d.ts
 
  interface ReadonlyArray<T> {
    /**
-@@ -346,20 +335,25 @@
+@@ -346,15 +334,25 @@
     * immediately returns that element value. Otherwise, find returns undefined.
     * @param thisArg If provided, it will be used as the this value for each invocation of
     * predicate. If it is not provided, undefined is used instead.
     */
 -  find<S extends T>(
--    predicate: (
--      this: void,
--      value: T,
--      index: number,
--      obj: readonly T[]
--    ) => value is S,
+-    predicate: (value: T, index: number, obj: readonly T[]) => value is S,
 -    thisArg?: any
 +  find<S extends T, This = undefined>(
 +    predicate: (this: This, value: T, index: number, obj: this) => value is S,
@@ -209,7 +198,7 @@ Index: es2015.core.d.ts
 
    /**
     * Returns the index of the first element in the array where predicate is true, and -1
-@@ -369,11 +363,11 @@
+@@ -364,11 +362,11 @@
     * findIndex immediately returns that element index. Otherwise, findIndex returns -1.
     * @param thisArg If provided, it will be used as the this value for each invocation of
     * predicate. If it is not provided, undefined is used instead.
@@ -224,7 +213,7 @@ Index: es2015.core.d.ts
  }
 
  interface RegExp {
-@@ -433,26 +427,17 @@
+@@ -428,26 +426,17 @@
     * same as the corresponding elements of this object (converted to a String) starting at
     * endPosition – length(this). Otherwise returns false.
     */

docs/diff/es2015.collection.d.ts.md

@@ -5,8 +5,7 @@ Index: es2015.generator.d.ts
 ===================================================================
 --- es2015.generator.d.ts
 +++ es2015.generator.d.ts
-@@ -1,7 +1,8 @@
-+/// <reference no-default-lib="true"/>
+@@ -1,7 +1,7 @@
  /// <reference lib="es2015.iterable" />
 
 -interface Generator<T = unknown, TReturn = any, TNext = unknown>