Upgrade TypeScript to 4.9

Author: uhyo

TypeScript

@@ -5,20 +5,25 @@ Index: es2015.collection.d.ts
 ===================================================================
 --- es2015.collection.d.ts
 +++ es2015.collection.d.ts
-@@ -1,28 +1,27 @@
- interface Map<K, V> {
-   clear(): void;
+@@ -3,14 +3,11 @@
+   /**
+    * @returns true if an element in the Map existed and has been removed, or false if the element does not exist.
+    */
    delete(key: K): boolean;
+-  /**
+-   * Executes a provided function once per each key/value pair in the Map, in insertion order.
+-   */
 -  forEach(
 -    callbackfn: (value: V, key: K, map: Map<K, V>) => void,
 -    thisArg?: any
 +  forEach<This = undefined>(
 +    callbackfn: (this: This, value: V, key: K, map: this) => void,
 +    thisArg?: This
    ): void;
-   get(key: K): V | undefined;
-   has(key: K): boolean;
-   set(key: K, value: V): this;
+   /**
+    * 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 +27,17 @@
    readonly size: number;
  }
 
@@ -41,7 +46,7 @@ Index: es2015.collection.d.ts
    get(key: K): V | undefined;
    has(key: K): boolean;
    readonly size: number;
-@@ -35,37 +34,37 @@
+@@ -68,12 +64,12 @@
    set(key: K, value: V): this;
  }
 
@@ -57,17 +62,25 @@ Index: es2015.collection.d.ts
  declare var WeakMap: WeakMapConstructor;
 
  interface Set<T> {
-   add(value: T): this;
-   clear(): void;
+@@ -87,14 +83,11 @@
+    * Removes a specified value from the Set.
+    * @returns Returns true if an element in the Set existed and has been removed, or false if the element does not exist.
+    */
    delete(value: T): boolean;
+-  /**
+-   * Executes a provided function once per each value in the Set object, in insertion order.
+-   */
 -  forEach(
 -    callbackfn: (value: T, value2: T, set: Set<T>) => void,
 -    thisArg?: any
 +  forEach<This = undefined>(
 +    callbackfn: (this: This, value: T, value2: T, set: this) => void,
 +    thisArg?: This
    ): void;
-   has(value: T): boolean;
+   /**
+    * @returns a boolean indicating whether an element with the specified value exists in the Set or not.
+    */
+@@ -105,17 +98,17 @@
    readonly size: number;
  }
 

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

@@ -85,55 +85,14 @@ Index: es2015.core.d.ts
 
    /**
     * Returns a new array from a set of elements.
-@@ -209,36 +219,35 @@
-    * that is representable as a Number value, which is approximately:
-    * 2.2204460492503130808472633361816 x 10‍−‍16.
-    */
-   readonly EPSILON: number;
--
-   /**
-    * Returns true if passed value is finite.
-    * Unlike the global isFinite, Number.isFinite doesn't forcibly convert the parameter to a
-    * number. Only finite values of the type number, result in true.
-    * @param number A numeric value.
-    */
--  isFinite(number: unknown): boolean;
-+  isFinite(number: unknown): number is number;
- 
-   /**
-    * Returns true if the value passed is an integer, false otherwise.
-    * @param number A numeric value.
-    */
--  isInteger(number: unknown): boolean;
-+  isInteger(number: unknown): number is number;
- 
-   /**
-    * Returns a Boolean value that indicates whether a value is the reserved value NaN (not a
-    * number). Unlike the global isNaN(), Number.isNaN() doesn't forcefully convert the parameter
-    * to a number. Only values of the type number, that are also NaN, result in true.
-    * @param number A numeric value.
-    */
--  isNaN(number: unknown): boolean;
-+  isNaN(number: unknown): number is number;
- 
-   /**
-    * Returns true if the value passed is a safe integer.
-    * @param number A numeric value.
-    */
--  isSafeInteger(number: unknown): boolean;
-+  isSafeInteger(number: unknown): number is number;
- 
-   /**
-    * The value of the largest integer n such that n and n + 1 are both exactly representable as
-    * a Number value.
-@@ -273,49 +282,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.
     * @param target The target object to copy to.
 -   * @param source The source object from which to copy properties.
 -   */
--  assign<T, U>(target: T, source: U): T & U;
+-  assign<T extends {}, U>(target: T, source: U): T & U;
 -
 -  /**
 -   * Copy the values of all of the enumerable own properties from one or more source objects to a
@@ -142,7 +101,7 @@ Index: es2015.core.d.ts
 -   * @param source1 The first source object from which to copy properties.
 -   * @param source2 The second source object from which to copy properties.
 -   */
--  assign<T, U, V>(target: T, source1: U, source2: V): T & U & V;
+-  assign<T extends {}, U, V>(target: T, source1: U, source2: V): T & U & V;
 -
 -  /**
 -   * Copy the values of all of the enumerable own properties from one or more source objects to a
@@ -152,7 +111,7 @@ Index: es2015.core.d.ts
 -   * @param source2 The second source object from which to copy properties.
 -   * @param source3 The third source object from which to copy properties.
 -   */
--  assign<T, U, V, W>(
+-  assign<T extends {}, U, V, W>(
 -    target: T,
 -    source1: U,
 -    source2: V,
@@ -181,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 +306,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.
@@ -207,7 +166,7 @@ Index: es2015.core.d.ts
 
  interface ReadonlyArray<T> {
    /**
-@@ -346,20 +333,25 @@
+@@ -346,20 +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.
@@ -244,7 +203,7 @@ Index: es2015.core.d.ts
 
    /**
     * Returns the index of the first element in the array where predicate is true, and -1
-@@ -369,11 +361,11 @@
+@@ -369,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.
@@ -259,7 +218,7 @@ Index: es2015.core.d.ts
  }
 
  interface RegExp {
-@@ -433,26 +425,17 @@
+@@ -433,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.core.d.ts.md

@@ -5,41 +5,117 @@ Index: es2015.proxy.d.ts
 ===================================================================
 --- es2015.proxy.d.ts
 +++ es2015.proxy.d.ts
-@@ -1,25 +1,25 @@
+@@ -1,101 +1,35 @@
  interface ProxyHandler<T extends object> {
+-  /**
+-   * A trap method for a function call.
+-   * @param target The original callable object which is being proxied.
+-   */
 -  apply?(target: T, thisArg: any, argArray: any[]): any;
+-
+-  /**
+-   * A trap for the `new` operator.
+-   * @param target The original object which is being proxied.
+-   * @param newTarget The constructor that was originally called.
+-   */
 -  construct?(target: T, argArray: any[], newTarget: Function): object;
+-
+-  /**
+-   * A trap for `Object.defineProperty()`.
+-   * @param target The original object which is being proxied.
+-   * @returns A `Boolean` indicating whether or not the property has been defined.
+-   */
 +  apply?(target: T, thisArg: unknown, argArray: unknown[]): any;
 +  construct?(target: T, argArray: unknown[], newTarget: unknown): object;
    defineProperty?(
      target: T,
--    p: string | symbol,
+-    property: string | symbol,
 +    p: PropertyKey,
      attributes: PropertyDescriptor
    ): boolean;
+-
+-  /**
+-   * A trap for the `delete` operator.
+-   * @param target The original object which is being proxied.
+-   * @param p The name or `Symbol` of the property to delete.
+-   * @returns A `Boolean` indicating whether or not the property was deleted.
+-   */
 -  deleteProperty?(target: T, p: string | symbol): boolean;
+-
+-  /**
+-   * A trap for getting a property value.
+-   * @param target The original object which is being proxied.
+-   * @param p The name or `Symbol` of the property to get.
+-   * @param receiver The proxy or an object that inherits from the proxy.
+-   */
 -  get?(target: T, p: string | symbol, receiver: any): any;
+-
+-  /**
+-   * A trap for `Object.getOwnPropertyDescriptor()`.
+-   * @param target The original object which is being proxied.
+-   * @param p The name of the property whose description should be retrieved.
+-   */
 +  deleteProperty?(target: T, p: PropertyKey): boolean;
 +  get?(target: T, p: PropertyKey, receiver: unknown): any;
    getOwnPropertyDescriptor?(
      target: T,
 -    p: string | symbol
 +    p: PropertyKey
    ): PropertyDescriptor | undefined;
+-
+-  /**
+-   * A trap for the `[[GetPrototypeOf]]` internal method.
+-   * @param target The original object which is being proxied.
+-   */
    getPrototypeOf?(target: T): object | null;
--  has?(target: T, p: string | symbol): boolean;
 +  has?(target: T, p: PropertyKey): boolean;
+ 
+   /**
+-   * A trap for the `in` operator.
+-   * @param target The original object which is being proxied.
+-   * @param p The name or `Symbol` of the property to check for existence.
+-   */
+-  has?(target: T, p: string | symbol): boolean;
+-
+-  /**
+    * A trap for `Object.isExtensible()`.
+    * @param target The original object which is being proxied.
+    */
    isExtensible?(target: T): boolean;
--  ownKeys?(target: T): ArrayLike<string | symbol>;
 +  ownKeys?(target: T): PropertyKey[];
+ 
+   /**
+-   * A trap for `Reflect.ownKeys()`.
+-   * @param target The original object which is being proxied.
+-   */
+-  ownKeys?(target: T): ArrayLike<string | symbol>;
+-
+-  /**
+    * A trap for `Object.preventExtensions()`.
+    * @param target The original object which is being proxied.
+    */
    preventExtensions?(target: T): boolean;
--  set?(target: T, p: string | symbol, value: any, receiver: any): boolean;
+-
+-  /**
+-   * A trap for setting a property value.
+-   * @param target The original object which is being proxied.
+-   * @param p The name or `Symbol` of the property to set.
+-   * @param receiver The object to which the assignment was originally directed.
+-   * @returns A `Boolean` indicating whether or not the property was set.
+-   */
+-  set?(target: T, p: string | symbol, newValue: any, receiver: any): boolean;
+-
+-  /**
+-   * A trap for `Object.setPrototypeOf()`.
+-   * @param target The original object which is being proxied.
+-   * @param newPrototype The object's new prototype or `null`.
+-   */
 -  setPrototypeOf?(target: T, v: object | null): boolean;
 +  set?(target: T, p: PropertyKey, value: unknown, receiver: unknown): boolean;
 +  setPrototypeOf?(target: T, v: unknown): boolean;
  }
 
  interface ProxyConstructor {
-   revocable<T extends object>(
+   /**
 
 ```