Update: migrate to ES2024

microsoft · rbuckton · Sep 27, 2024 · Jun 13, 2023 · Jun 14, 2023 · Jun 17, 2023
commit 2b68ab70bd3ac9f239729ed6c3ee2d166ff45723
diff --git a/src/compiler/commandLineParser.ts b/src/compiler/commandLineParser.ts
@@ -162,6 +162,7 @@ const libEntries: [string, string][] = [
     ["es2021", "lib.es2021.d.ts"],
     ["es2022", "lib.es2022.d.ts"],
     ["es2023", "lib.es2023.d.ts"],
+    ["es2024", "lib.es2024.d.ts"],
     ["esnext", "lib.esnext.d.ts"],
     // Host only
     ["dom", "lib.dom.d.ts"],
@@ -222,19 +223,24 @@ const libEntries: [string, string][] = [
     ["es2023.array", "lib.es2023.array.d.ts"],
     ["es2023.collection", "lib.es2023.collection.d.ts"],
     ["es2023.intl", "lib.es2023.intl.d.ts"],
+    ["es2024.arraybuffer", "lib.es2024.arraybuffer.d.ts"],
+    ["es2024.collection", "lib.es2024.collection.d.ts"],
+    ["es2024.full", "lib.es2024.full.d.ts"],
+    ["es2024.object", "lib.es2024.object.d.ts"],
+    ["es2024.promise", "lib.es2024.promise.d.ts"],
+    ["es2024.sharedmemory", "lib.es2024.sharedmemory.d.ts"],
     ["esnext.array", "lib.es2023.array.d.ts"],
     ["esnext.collection", "lib.esnext.collection.d.ts"],
     ["esnext.symbol", "lib.es2019.symbol.d.ts"],
-    ["esnext.arraybuffer", "lib.esnext.arraybuffer.d.ts"],
     ["esnext.asynciterable", "lib.es2018.asynciterable.d.ts"],
     ["esnext.intl", "lib.esnext.intl.d.ts"],
     ["esnext.disposable", "lib.esnext.disposable.d.ts"],
     ["esnext.bigint", "lib.es2020.bigint.d.ts"],
     ["esnext.string", "lib.es2022.string.d.ts"],
-    ["esnext.promise", "lib.esnext.promise.d.ts"],
+    ["esnext.promise", "lib.es2024.promise.d.ts"],
     ["esnext.weakref", "lib.es2021.weakref.d.ts"],
     ["esnext.decorators", "lib.esnext.decorators.d.ts"],
-    ["esnext.object", "lib.esnext.object.d.ts"],
+    ["esnext.object", "lib.es2024.object.d.ts"],
     ["esnext.array", "lib.esnext.array.d.ts"],
     ["esnext.regexp", "lib.esnext.regexp.d.ts"],
     ["esnext.string", "lib.esnext.string.d.ts"],

diff --git a/src/lib/es2024.arraybuffer.d.ts b/src/lib/es2024.arraybuffer.d.ts
@@ -0,0 +1,26 @@
+interface ArrayBuffer {
+    /**
+     * If this ArrayBuffer is resizable, returns the maximum byte length given during construction; returns the byte length if not.
+     *
+     * [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/maxByteLength)
+     */
+    get maxByteLength(): number;
+
+    /**
+     * Returns true if this ArrayBuffer can be resized.
+     *
+     * [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/resizable)
+     */
+    get resizable(): boolean;
+
+    /**
+     * Resizes the ArrayBuffer to the specified size (in bytes).
+     *
+     * [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/resize)
+     */
+    resize(newByteLength: number): undefined;
+}
+
+interface ArrayBufferConstructor {
+    new (byteLength: number, options?: { maxByteLength?: number; }): ArrayBuffer;
+}
diff --git a/src/lib/es2024.collection.d.ts b/src/lib/es2024.collection.d.ts
@@ -0,0 +1,11 @@
+interface MapConstructor {
+    /**
+     * Groups members of an iterable according to the return value of the passed callback.
+     * @param items An iterable.
+     * @param keySelector A callback which will be invoked for each item in items.
+     */
+    groupBy<K, T>(
+        items: Iterable<T>,
+        keySelector: (item: T, index: number) => K,
+    ): Map<K, T[]>;
+}
diff --git a/src/lib/es2024.d.ts b/src/lib/es2024.d.ts
@@ -0,0 +1,6 @@
+/// <reference lib="es2023" />
+/// <reference lib="es2024.arraybuffer" />
+/// <reference lib="es2024.collection" />
+/// <reference lib="es2024.object" />
+/// <reference lib="es2024.promise" />
+/// <reference lib="es2024.sharedmemory" />
diff --git a/src/lib/es2024.full.d.ts b/src/lib/es2024.full.d.ts
@@ -0,0 +1,6 @@
+/// <reference lib="es2024" />
+/// <reference lib="dom" />
+/// <reference lib="webworker.importscripts" />
+/// <reference lib="scripthost" />
+/// <reference lib="dom.iterable" />
+/// <reference lib="dom.asynciterable" />
diff --git a/src/lib/esnext.object.d.ts → src/lib/es2024.object.d.ts b/src/lib/esnext.object.d.ts → src/lib/es2024.object.d.ts
diff --git a/src/lib/esnext.promise.d.ts → src/lib/es2024.promise.d.ts b/src/lib/esnext.promise.d.ts → src/lib/es2024.promise.d.ts
diff --git a/src/lib/es2024.sharedmemory.d.ts b/src/lib/es2024.sharedmemory.d.ts
@@ -0,0 +1,27 @@
+interface SharedArrayBuffer {
+    /**
+     * Returns true if this SharedArrayBuffer can be grown.
+     *
+     * [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer/growable)
+     */
+    get growable(): number;
+
+    /**
+     * If this SharedArrayBuffer is growable, returns the maximum byte length given during construction; returns the byte length if not.
+     *
+     * [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer/maxByteLength)
+     */
+    get maxByteLength(): number;
+
+    /**
+     * Grows the SharedArrayBuffer to the specified size (in bytes).
+     *
+     * [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer/grow)
+     */
+    grow(newByteLength: number): undefined;
+}
+
+interface SharedArrayBufferConstructor {
+    new ();
+    new (byteLength: number, options?: { maxByteLength?: number; }): SharedArrayBuffer;
+}
diff --git a/src/lib/esnext.arraybuffer.d.ts b/src/lib/esnext.arraybuffer.d.ts
diff --git a/src/lib/esnext.collection.d.ts b/src/lib/esnext.collection.d.ts
@@ -1,15 +1,3 @@
-interface MapConstructor {
-    /**
-     * Groups members of an iterable according to the return value of the passed callback.
-     * @param items An iterable.
-     * @param keySelector A callback which will be invoked for each item in items.
-     */
-    groupBy<K, T>(
-        items: Iterable<T>,
-        keySelector: (item: T, index: number) => K,
-    ): Map<K, T[]>;
-}
-
 interface ReadonlySetLike<T> {
     /**
      * Despite its name, returns an iterator of the values in the set-like.

diff --git a/src/lib/esnext.d.ts b/src/lib/esnext.d.ts
@@ -1,10 +1,7 @@
 /// <reference lib="es2023" />
 /// <reference lib="esnext.intl" />
-/// <reference lib="esnext.arraybuffer" />
 /// <reference lib="esnext.decorators" />
 /// <reference lib="esnext.disposable" />
-/// <reference lib="esnext.promise" />
-/// <reference lib="esnext.object" />
 /// <reference lib="esnext.collection" />
 /// <reference lib="esnext.array" />
 /// <reference lib="esnext.regexp" />