typescript 5.1.6 → 5.2.2

package/lib/lib.es2023.collection.d.ts

@@ -0,0 +1,21 @@
+/*! *****************************************************************************
+Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License. You may obtain a copy of the
+License at http://www.apache.org/licenses/LICENSE-2.0
+
+THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
+WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
+MERCHANTABLITY OR NON-INFRINGEMENT.
+
+See the Apache Version 2.0 License for specific language governing permissions
+and limitations under the License.
+***************************************************************************** */
+
+
+/// <reference no-default-lib="true"/>
+
+interface WeakKeyTypes {
+    symbol: symbol;
+}

package/lib/lib.es2023.d.ts

@@ -18,3 +18,4 @@ and limitations under the License.
 
 /// <reference lib="es2022" />
 /// <reference lib="es2023.array" />
+/// <reference lib="es2023.collection" />

package/lib/lib.es5.d.ts

@@ -1665,6 +1665,15 @@ type Uncapitalize<S extends string> = intrinsic;
  */
 interface ThisType<T> { }
 
+/**
+ * Stores types to be used with WeakSet, WeakMap, WeakRef, and FinalizationRegistry
+ */
+interface WeakKeyTypes {
+    object: object;
+}
+
+type WeakKey = WeakKeyTypes[keyof WeakKeyTypes];
+
 /**
  * Represents a raw buffer of binary data, which is used to store data for the
  * different typed arrays. ArrayBuffers cannot be read from or written to directly,
@@ -1880,10 +1889,10 @@ interface Int8Array {
      * @param target If target is negative, it is treated as length+target where length is the
      * length of the array.
      * @param start If start is negative, it is treated as length+start. If end is negative, it
-     * is treated as length+end. If start is omitted, `0` is used.
+     * is treated as length+end.
      * @param end If not specified, length of the this object is used as its default value.
      */
-    copyWithin(target: number, start?: number, end?: number): this;
+    copyWithin(target: number, start: number, end?: number): this;
 
     /**
      * Determines whether all the members of an array satisfy the specified test.
@@ -2162,10 +2171,10 @@ interface Uint8Array {
      * @param target If target is negative, it is treated as length+target where length is the
      * length of the array.
      * @param start If start is negative, it is treated as length+start. If end is negative, it
-     * is treated as length+end. If start is omitted, `0` is used.
+     * is treated as length+end.
      * @param end If not specified, length of the this object is used as its default value.
      */
-    copyWithin(target: number, start?: number, end?: number): this;
+    copyWithin(target: number, start: number, end?: number): this;
 
     /**
      * Determines whether all the members of an array satisfy the specified test.
@@ -2444,10 +2453,10 @@ interface Uint8ClampedArray {
      * @param target If target is negative, it is treated as length+target where length is the
      * length of the array.
      * @param start If start is negative, it is treated as length+start. If end is negative, it
-     * is treated as length+end. If start is omitted, `0` is used.
+     * is treated as length+end.
      * @param end If not specified, length of the this object is used as its default value.
      */
-    copyWithin(target: number, start?: number, end?: number): this;
+    copyWithin(target: number, start: number, end?: number): this;
 
     /**
      * Determines whether all the members of an array satisfy the specified test.
@@ -2725,10 +2734,10 @@ interface Int16Array {
      * @param target If target is negative, it is treated as length+target where length is the
      * length of the array.
      * @param start If start is negative, it is treated as length+start. If end is negative, it
-     * is treated as length+end. If start is omitted, `0` is used.
+     * is treated as length+end.
      * @param end If not specified, length of the this object is used as its default value.
      */
-    copyWithin(target: number, start?: number, end?: number): this;
+    copyWithin(target: number, start: number, end?: number): this;
 
     /**
      * Determines whether all the members of an array satisfy the specified test.
@@ -3007,10 +3016,10 @@ interface Uint16Array {
      * @param target If target is negative, it is treated as length+target where length is the
      * length of the array.
      * @param start If start is negative, it is treated as length+start. If end is negative, it
-     * is treated as length+end. If start is omitted, `0` is used.
+     * is treated as length+end.
      * @param end If not specified, length of the this object is used as its default value.
      */
-    copyWithin(target: number, start?: number, end?: number): this;
+    copyWithin(target: number, start: number, end?: number): this;
 
     /**
      * Determines whether all the members of an array satisfy the specified test.
@@ -3289,10 +3298,10 @@ interface Int32Array {
      * @param target If target is negative, it is treated as length+target where length is the
      * length of the array.
      * @param start If start is negative, it is treated as length+start. If end is negative, it
-     * is treated as length+end. If start is omitted, `0` is used.
+     * is treated as length+end.
      * @param end If not specified, length of the this object is used as its default value.
      */
-    copyWithin(target: number, start?: number, end?: number): this;
+    copyWithin(target: number, start: number, end?: number): this;
 
     /**
      * Determines whether all the members of an array satisfy the specified test.
@@ -3571,10 +3580,10 @@ interface Uint32Array {
      * @param target If target is negative, it is treated as length+target where length is the
      * length of the array.
      * @param start If start is negative, it is treated as length+start. If end is negative, it
-     * is treated as length+end. If start is omitted, `0` is used.
+     * is treated as length+end.
      * @param end If not specified, length of the this object is used as its default value.
      */
-    copyWithin(target: number, start?: number, end?: number): this;
+    copyWithin(target: number, start: number, end?: number): this;
 
     /**
      * Determines whether all the members of an array satisfy the specified test.
@@ -3852,10 +3861,10 @@ interface Float32Array {
      * @param target If target is negative, it is treated as length+target where length is the
      * length of the array.
      * @param start If start is negative, it is treated as length+start. If end is negative, it
-     * is treated as length+end. If start is omitted, `0` is used.
+     * is treated as length+end.
      * @param end If not specified, length of the this object is used as its default value.
      */
-    copyWithin(target: number, start?: number, end?: number): this;
+    copyWithin(target: number, start: number, end?: number): this;
 
     /**
      * Determines whether all the members of an array satisfy the specified test.
@@ -4135,10 +4144,10 @@ interface Float64Array {
      * @param target If target is negative, it is treated as length+target where length is the
      * length of the array.
      * @param start If start is negative, it is treated as length+start. If end is negative, it
-     * is treated as length+end. If start is omitted, `0` is used.
+     * is treated as length+end.
      * @param end If not specified, length of the this object is used as its default value.
      */
-    copyWithin(target: number, start?: number, end?: number): this;
+    copyWithin(target: number, start: number, end?: number): this;
 
     /**
      * Determines whether all the members of an array satisfy the specified test.

package/lib/lib.esnext.d.ts

@@ -18,3 +18,5 @@ and limitations under the License.
 
 /// <reference lib="es2023" />
 /// <reference lib="esnext.intl" />
+/// <reference lib="esnext.decorators" />
+/// <reference lib="esnext.disposable" />

package/lib/lib.esnext.decorators.d.ts

@@ -0,0 +1,28 @@
+/*! *****************************************************************************
+Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License. You may obtain a copy of the
+License at http://www.apache.org/licenses/LICENSE-2.0
+
+THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
+WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
+MERCHANTABLITY OR NON-INFRINGEMENT.
+
+See the Apache Version 2.0 License for specific language governing permissions
+and limitations under the License.
+***************************************************************************** */
+
+
+/// <reference no-default-lib="true"/>
+
+/// <reference lib="es2015.symbol" />
+/// <reference lib="decorators" />
+
+interface SymbolConstructor {
+    readonly metadata: unique symbol;
+}
+
+interface Function {
+    [Symbol.metadata]: DecoratorMetadata | null;
+}

package/lib/lib.esnext.disposable.d.ts

@@ -0,0 +1,185 @@
+/*! *****************************************************************************
+Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License. You may obtain a copy of the
+License at http://www.apache.org/licenses/LICENSE-2.0
+
+THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
+WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
+MERCHANTABLITY OR NON-INFRINGEMENT.
+
+See the Apache Version 2.0 License for specific language governing permissions
+and limitations under the License.
+***************************************************************************** */
+
+
+/// <reference no-default-lib="true"/>
+
+/// <reference lib="es2015.symbol" />
+
+interface SymbolConstructor {
+    /**
+     * A method that is used to release resources held by an object. Called by the semantics of the `using` statement.
+     */
+    readonly dispose: unique symbol;
+
+    /**
+     * A method that is used to asynchronously release resources held by an object. Called by the semantics of the `await using` statement.
+     */
+    readonly asyncDispose: unique symbol;
+}
+
+interface Disposable {
+    [Symbol.dispose](): void;
+}
+
+interface AsyncDisposable {
+    [Symbol.asyncDispose](): PromiseLike<void>;
+}
+
+interface SuppressedError extends Error {
+    error: any;
+    suppressed: any;
+}
+
+interface SuppressedErrorConstructor extends ErrorConstructor {
+    new (error: any, suppressed: any, message?: string): SuppressedError;
+    (error: any, suppressed: any, message?: string): SuppressedError;
+    readonly prototype: SuppressedError;
+}
+declare var SuppressedError: SuppressedErrorConstructor;
+
+interface DisposableStack {
+    /**
+     * Returns a value indicating whether this stack has been disposed.
+     */
+    readonly disposed: boolean;
+    /**
+     * Disposes each resource in the stack in the reverse order that they were added.
+     */
+    dispose(): void;
+    /**
+     * Adds a disposable resource to the stack, returning the resource.
+     * @param value The resource to add. `null` and `undefined` will not be added, but will be returned.
+     * @returns The provided {@link value}.
+     */
+    use<T extends Disposable | null | undefined>(value: T): T;
+    /**
+     * Adds a value and associated disposal callback as a resource to the stack.
+     * @param value The value to add.
+     * @param onDispose The callback to use in place of a `[Symbol.dispose]()` method. Will be invoked with `value`
+     * as the first parameter.
+     * @returns The provided {@link value}.
+     */
+    adopt<T>(value: T, onDispose: (value: T) => void): T;
+    /**
+     * Adds a callback to be invoked when the stack is disposed.
+     */
+    defer(onDispose: () => void): void;
+    /**
+     * Move all resources out of this stack and into a new `DisposableStack`, and marks this stack as disposed.
+     * @example
+     * ```ts
+     * class C {
+     *   #res1: Disposable;
+     *   #res2: Disposable;
+     *   #disposables: DisposableStack;
+     *   constructor() {
+     *     // stack will be disposed when exiting constructor for any reason
+     *     using stack = new DisposableStack();
+     * 
+     *     // get first resource
+     *     this.#res1 = stack.use(getResource1());
+     * 
+     *     // get second resource. If this fails, both `stack` and `#res1` will be disposed.
+     *     this.#res2 = stack.use(getResource2());
+     * 
+     *     // all operations succeeded, move resources out of `stack` so that they aren't disposed
+     *     // when constructor exits
+     *     this.#disposables = stack.move();
+     *   }
+     * 
+     *   [Symbol.dispose]() {
+     *     this.#disposables.dispose();
+     *   }
+     * }
+     * ```
+     */
+    move(): DisposableStack;
+    [Symbol.dispose](): void;
+    readonly [Symbol.toStringTag]: string;
+}
+
+interface DisposableStackConstructor {
+    new(): DisposableStack;
+    readonly prototype: DisposableStack;
+}
+declare var DisposableStack: DisposableStackConstructor;
+
+interface AsyncDisposableStack {
+    /**
+     * Returns a value indicating whether this stack has been disposed.
+     */
+    readonly disposed: boolean;
+    /**
+     * Disposes each resource in the stack in the reverse order that they were added.
+     */
+    disposeAsync(): Promise<void>;
+    /**
+     * Adds a disposable resource to the stack, returning the resource.
+     * @param value The resource to add. `null` and `undefined` will not be added, but will be returned.
+     * @returns The provided {@link value}.
+     */
+    use<T extends AsyncDisposable | Disposable | null | undefined>(value: T): T;
+    /**
+     * Adds a value and associated disposal callback as a resource to the stack.
+     * @param value The value to add.
+     * @param onDisposeAsync The callback to use in place of a `[Symbol.asyncDispose]()` method. Will be invoked with `value`
+     * as the first parameter.
+     * @returns The provided {@link value}.
+     */
+    adopt<T>(value: T, onDisposeAsync: (value: T) => PromiseLike<void> | void): T;
+    /**
+     * Adds a callback to be invoked when the stack is disposed.
+     */
+    defer(onDisposeAsync: () => PromiseLike<void> | void): void;
+    /**
+     * Move all resources out of this stack and into a new `DisposableStack`, and marks this stack as disposed.
+     * @example
+     * ```ts
+     * class C {
+     *   #res1: Disposable;
+     *   #res2: Disposable;
+     *   #disposables: DisposableStack;
+     *   constructor() {
+     *     // stack will be disposed when exiting constructor for any reason
+     *     using stack = new DisposableStack();
+     * 
+     *     // get first resource
+     *     this.#res1 = stack.use(getResource1());
+     * 
+     *     // get second resource. If this fails, both `stack` and `#res1` will be disposed.
+     *     this.#res2 = stack.use(getResource2());
+     * 
+     *     // all operations succeeded, move resources out of `stack` so that they aren't disposed
+     *     // when constructor exits
+     *     this.#disposables = stack.move();
+     *   }
+     * 
+     *   [Symbol.dispose]() {
+     *     this.#disposables.dispose();
+     *   }
+     * }
+     * ```
+     */
+    move(): AsyncDisposableStack;
+    [Symbol.asyncDispose](): Promise<void>;
+    readonly [Symbol.toStringTag]: string;
+}
+
+interface AsyncDisposableStackConstructor {
+    new(): AsyncDisposableStack;
+    readonly prototype: AsyncDisposableStack;
+}
+declare var AsyncDisposableStack: AsyncDisposableStackConstructor;