Update version to 5.0.1-rc and LKG.

microsoft · Feb 25, 2023 · 89515ce · 89515ce
1 parent d3815df
commit 89515ce
Show file tree

Hide file tree

Showing 85 changed files with 12,704 additions and 14,832 deletions.
diff --git a/lib/lib.d.ts b/lib/lib.d.ts
@@ -14,10 +14,8 @@ and limitations under the License.
 ***************************************************************************** */
 
 
-
 /// <reference no-default-lib="true"/>
 
-
 /// <reference lib="es5" />
 /// <reference lib="dom" />
 /// <reference lib="webworker.importscripts" />

diff --git a/lib/lib.decorators.d.ts b/lib/lib.decorators.d.ts
@@ -14,12 +14,10 @@ and limitations under the License.
 ***************************************************************************** */
 
 
-
 /// <reference no-default-lib="true"/>
 
-
 /**
- * The decorator context types provided to class member decorators.
+ * The decorator context types provided to class element decorators.
  */
 type ClassMemberDecoratorContext =
     | ClassMethodDecoratorContext
@@ -80,34 +78,37 @@ interface ClassMethodDecoratorContext<
     This = unknown,
     Value extends (this: This, ...args: any) => any = (this: This, ...args: any) => any,
 > {
-    /** The kind of class member that was decorated. */
+    /** The kind of class element that was decorated. */
     readonly kind: "method";
 
-    /** The name of the decorated class member. */
+    /** The name of the decorated class element. */
     readonly name: string | symbol;
 
-    /** A value indicating whether the class member is a static (`true`) or instance (`false`) member. */
+    /** A value indicating whether the class element is a static (`true`) or instance (`false`) element. */
     readonly static: boolean;
 
-    /** A value indicating whether the class member has a private name. */
+    /** A value indicating whether the class element has a private name. */
     readonly private: boolean;
 
-    // NOTE: Disabled, pending the outcome of https://github.com/tc39/proposal-decorators/issues/494
-    // /** An object that can be used to access the current value of the class member at runtime. */
-    // readonly access: {
-    //     /**
-    //      * Gets the current value of the method from the provided receiver.
-    //      *
-    //      * @example
-    //      * let fn = context.access.get.call(instance);
-    //      */
-    //     get(this: This): Value;
-    // };
+    /** An object that can be used to access the current value of the class element at runtime. */
+    readonly access: {
+        /**
+         * Determines whether an object has a property with the same name as the decorated element.
+         */
+        has(object: This): boolean;
+        /**
+         * Gets the current value of the method from the provided object.
+         *
+         * @example
+         * let fn = context.access.get(instance);
+         */
+        get(object: This): Value;
+    };
 
     /**
      * Adds a callback to be invoked either before static initializers are run (when
-     * decorating a `static` member), or before instance initializers are run (when
-     * decorating a non-`static` member).
+     * decorating a `static` element), or before instance initializers are run (when
+     * decorating a non-`static` element).
      *
      * @example
      * ```ts
@@ -141,34 +142,37 @@ interface ClassGetterDecoratorContext<
     This = unknown,
     Value = unknown,
 > {
-    /** The kind of class member that was decorated. */
+    /** The kind of class element that was decorated. */
     readonly kind: "getter";
 
-    /** The name of the decorated class member. */
+    /** The name of the decorated class element. */
     readonly name: string | symbol;
 
-    /** A value indicating whether the class member is a static (`true`) or instance (`false`) member. */
+    /** A value indicating whether the class element is a static (`true`) or instance (`false`) element. */
     readonly static: boolean;
 
-    /** A value indicating whether the class member has a private name. */
+    /** A value indicating whether the class element has a private name. */
     readonly private: boolean;
 
-    // NOTE: Disabled, pending the outcome of https://github.com/tc39/proposal-decorators/issues/494
-    // /** An object that can be used to access the current value of the class member at runtime. */
-    // readonly access: {
-    //     /**
-    //      * Invokes the getter on the provided receiver.
-    //      *
-    //      * @example
-    //      * let value = context.access.get.call(instance);
-    //      */
-    //     get(this: This): Value;
-    // };
+    /** An object that can be used to access the current value of the class element at runtime. */
+    readonly access: {
+        /**
+         * Determines whether an object has a property with the same name as the decorated element.
+         */
+        has(object: This): boolean;
+        /**
+         * Invokes the getter on the provided object.
+         *
+         * @example
+         * let value = context.access.get(instance);
+         */
+        get(object: This): Value;
+    };
 
     /**
      * Adds a callback to be invoked either before static initializers are run (when
-     * decorating a `static` member), or before instance initializers are run (when
-     * decorating a non-`static` member).
+     * decorating a `static` element), or before instance initializers are run (when
+     * decorating a non-`static` element).
      */
     addInitializer(initializer: (this: This) => void): void;
 }
@@ -183,34 +187,37 @@ interface ClassSetterDecoratorContext<
     This = unknown,
     Value = unknown,
 > {
-    /** The kind of class member that was decorated. */
+    /** The kind of class element that was decorated. */
     readonly kind: "setter";
 
-    /** The name of the decorated class member. */
+    /** The name of the decorated class element. */
     readonly name: string | symbol;
 
-    /** A value indicating whether the class member is a static (`true`) or instance (`false`) member. */
+    /** A value indicating whether the class element is a static (`true`) or instance (`false`) element. */
     readonly static: boolean;
 
-    /** A value indicating whether the class member has a private name. */
+    /** A value indicating whether the class element has a private name. */
     readonly private: boolean;
 
-    // NOTE: Disabled, pending the outcome of https://github.com/tc39/proposal-decorators/issues/494
-    /** An object that can be used to access the current value of the class member at runtime. */
-    // readonly access: {
-    //     /**
-    //      * Invokes the setter on the provided receiver.
-    //      *
-    //      * @example
-    //      * context.access.set.call(instance, value);
-    //      */
-    //     set(this: This, value: Value): void;
-    // };
+    /** An object that can be used to access the current value of the class element at runtime. */
+    readonly access: {
+        /**
+         * Determines whether an object has a property with the same name as the decorated element.
+         */
+        has(object: This): boolean;
+        /**
+         * Invokes the setter on the provided object.
+         *
+         * @example
+         * context.access.set(instance, value);
+         */
+        set(object: This, value: Value): void;
+    };
 
     /**
      * Adds a callback to be invoked either before static initializers are run (when
-     * decorating a `static` member), or before instance initializers are run (when
-     * decorating a non-`static` member).
+     * decorating a `static` element), or before instance initializers are run (when
+     * decorating a non-`static` element).
      */
     addInitializer(initializer: (this: This) => void): void;
 }
@@ -225,42 +232,46 @@ interface ClassAccessorDecoratorContext<
     This = unknown,
     Value = unknown,
 > {
-    /** The kind of class member that was decorated. */
+    /** The kind of class element that was decorated. */
     readonly kind: "accessor";
 
-    /** The name of the decorated class member. */
+    /** The name of the decorated class element. */
     readonly name: string | symbol;
 
-    /** A value indicating whether the class member is a static (`true`) or instance (`false`) member. */
+    /** A value indicating whether the class element is a static (`true`) or instance (`false`) element. */
     readonly static: boolean;
 
-    /** A value indicating whether the class member has a private name. */
+    /** A value indicating whether the class element has a private name. */
     readonly private: boolean;
 
-    // NOTE: Disabled, pending the outcome of https://github.com/tc39/proposal-decorators/issues/494
-    // /** An object that can be used to access the current value of the class member at runtime. */
-    // readonly access: {
-    //     /**
-    //      * Invokes the getter on the provided receiver.
-    //      *
-    //      * @example
-    //      * let value = context.access.get.call(instance);
-    //      */
-    //     get(this: This): Value;
-
-    //     /**
-    //      * Invokes the setter on the provided receiver.
-    //      *
-    //      * @example
-    //      * context.access.set.call(instance, value);
-    //      */
-    //     set(this: This, value: Value): void;
-    // };
+    /** An object that can be used to access the current value of the class element at runtime. */
+    readonly access: {
+        /**
+         * Determines whether an object has a property with the same name as the decorated element.
+         */
+        has(object: This): boolean;
+
+        /**
+         * Invokes the getter on the provided object.
+         *
+         * @example
+         * let value = context.access.get(instance);
+         */
+        get(object: This): Value;
+
+        /**
+         * Invokes the setter on the provided object.
+         *
+         * @example
+         * context.access.set(instance, value);
+         */
+        set(object: This, value: Value): void;
+    };
 
     /**
      * Adds a callback to be invoked either before static initializers are run (when
-     * decorating a `static` member), or before instance initializers are run (when
-     * decorating a non-`static` member).
+     * decorating a `static` element), or before instance initializers are run (when
+     * decorating a non-`static` element).
      */
     addInitializer(initializer: (this: This) => void): void;
 }
@@ -322,36 +333,40 @@ interface ClassFieldDecoratorContext<
     This = unknown,
     Value = unknown,
 > {
-    /** The kind of class member that was decorated. */
+    /** The kind of class element that was decorated. */
     readonly kind: "field";
 
-    /** The name of the decorated class member. */
+    /** The name of the decorated class element. */
     readonly name: string | symbol;
 
-    /** A value indicating whether the class member is a static (`true`) or instance (`false`) member. */
+    /** A value indicating whether the class element is a static (`true`) or instance (`false`) element. */
     readonly static: boolean;
 
-    /** A value indicating whether the class member has a private name. */
+    /** A value indicating whether the class element has a private name. */
     readonly private: boolean;
 
-    // NOTE: Disabled, pending the outcome of https://github.com/tc39/proposal-decorators/issues/494
-    // /** An object that can be used to access the current value of the class member at runtime. */
-    // readonly access: {
-    //     /**
-    //      * Gets the value of the field on the provided receiver.
-    //      */
-    //     get(this: This): Value;
+    /** An object that can be used to access the current value of the class element at runtime. */
+    readonly access: {
+        /**
+         * Determines whether an object has a property with the same name as the decorated element.
+         */
+        has(object: This): boolean;
+
+        /**
+         * Gets the value of the field on the provided object.
+         */
+        get(object: This): Value;
 
-    //     /**
-    //      * Sets the value of the field on the provided receiver.
-    //      */
-    //     set(this: This, value: Value): void;
-    // };
+        /**
+         * Sets the value of the field on the provided object.
+         */
+        set(object: This, value: Value): void;
+    };
 
     /**
      * Adds a callback to be invoked either before static initializers are run (when
-     * decorating a `static` member), or before instance initializers are run (when
-     * decorating a non-`static` member).
+     * decorating a `static` element), or before instance initializers are run (when
+     * decorating a non-`static` element).
      */
     addInitializer(initializer: (this: This) => void): void;
 }
diff --git a/lib/lib.decorators.legacy.d.ts b/lib/lib.decorators.legacy.d.ts
@@ -14,10 +14,8 @@ and limitations under the License.
 ***************************************************************************** */
 
 
-
 /// <reference no-default-lib="true"/>
 
-
 declare type ClassDecorator = <TFunction extends Function>(target: TFunction) => TFunction | void;
 declare type PropertyDecorator = (target: Object, propertyKey: string | symbol) => void;
 declare type MethodDecorator = <T>(target: Object, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T> | void;

diff --git a/lib/lib.dom.d.ts b/lib/lib.dom.d.ts
@@ -14,10 +14,8 @@ and limitations under the License.
 ***************************************************************************** */
 
 
-
 /// <reference no-default-lib="true"/>
 
-
 /////////////////////////////
 /// Window APIs
 /////////////////////////////

diff --git a/lib/lib.dom.iterable.d.ts b/lib/lib.dom.iterable.d.ts
@@ -14,10 +14,8 @@ and limitations under the License.
 ***************************************************************************** */
 
 
-
 /// <reference no-default-lib="true"/>
 
-
 /////////////////////////////
 /// Window Iterable APIs
 /////////////////////////////

diff --git a/lib/lib.es2015.collection.d.ts b/lib/lib.es2015.collection.d.ts
@@ -14,10 +14,8 @@ and limitations under the License.
 ***************************************************************************** */
 
 
-
 /// <reference no-default-lib="true"/>
 
-
 interface Map<K, V> {
 
     clear(): void;

diff --git a/lib/lib.es2015.core.d.ts b/lib/lib.es2015.core.d.ts
@@ -14,10 +14,8 @@ and limitations under the License.
 ***************************************************************************** */
 
 
-
 /// <reference no-default-lib="true"/>
 
-
 interface Array<T> {
     /**
      * Returns the value of the first element in the array where predicate is true, and undefined

diff --git a/lib/lib.es2015.d.ts b/lib/lib.es2015.d.ts
@@ -14,10 +14,8 @@ and limitations under the License.
 ***************************************************************************** */
 
 
-
 /// <reference no-default-lib="true"/>
 
-
 /// <reference lib="es5" />
 /// <reference lib="es2015.core" />
 /// <reference lib="es2015.collection" />

diff --git a/lib/lib.es2015.generator.d.ts b/lib/lib.es2015.generator.d.ts
@@ -14,10 +14,8 @@ and limitations under the License.
 ***************************************************************************** */
 
 
-
 /// <reference no-default-lib="true"/>
 
-
 /// <reference lib="es2015.iterable" />
 
 interface Generator<T = unknown, TReturn = any, TNext = unknown> extends Iterator<T, TReturn, TNext> {