Introduce ES2025 target & Add missing ScriptTargetFeatures (#63046)

Co-authored-by: lionel-rowe <[email protected]>
Co-authored-by: 김상두 <[email protected]>
Co-authored-by: Jake Bailey <[email protected]>

Author: 4 people

src/compiler/commandLineParser.ts

@@ -141,12 +141,12 @@ const jsxOptionMap = new Map(Object.entries({
 export const inverseJsxOptionMap: Map<string, string> = new Map(mapIterator(jsxOptionMap.entries(), ([key, value]: [string, JsxEmit]) => ["" + value, key] as const));
 
 // NOTE: The order here is important to default lib ordering as entries will have the same
-//       order in the generated program (see `getDefaultLibPriority` in program.ts). This
+//       order in the generated program (see `getDefaultLibFilePriority` in program.ts). This
 //       order also affects overload resolution when a type declared in one lib is
 //       augmented in another lib.
 // NOTE: We must reevaluate the target for upcoming features when each successive TC39 edition is ratified in
 //       June of each year. This includes changes to `LanguageFeatureMinimumTarget`, `ScriptTarget`,
-//       `ScriptTargetFeatures` transformers/esnext.ts, compiler/commandLineParser.ts,
+//       `ScriptTargetFeatures`, `CommandLineOptionOfCustomType`, transformers/esnext.ts, compiler/commandLineParser.ts,
 //       compiler/utilitiesPublic.ts, and the contents of each lib/esnext.*.d.ts file.
 const libEntries: [string, string][] = [
     // JavaScript only
@@ -163,6 +163,7 @@ const libEntries: [string, string][] = [
     ["es2022", "lib.es2022.d.ts"],
     ["es2023", "lib.es2023.d.ts"],
     ["es2024", "lib.es2024.d.ts"],
+    ["es2025", "lib.es2025.d.ts"],
     ["esnext", "lib.esnext.d.ts"],
     // Host only
     ["dom", "lib.dom.d.ts"],
@@ -173,7 +174,7 @@ const libEntries: [string, string][] = [
     ["webworker.iterable", "lib.webworker.iterable.d.ts"],
     ["webworker.asynciterable", "lib.webworker.asynciterable.d.ts"],
     ["scripthost", "lib.scripthost.d.ts"],
-    // ES2015 Or ESNext By-feature options
+    // ES2015 and later By-feature options
     ["es2015.core", "lib.es2015.core.d.ts"],
     ["es2015.collection", "lib.es2015.collection.d.ts"],
     ["es2015.generator", "lib.es2015.generator.d.ts"],
@@ -230,27 +231,33 @@ const libEntries: [string, string][] = [
     ["es2024.regexp", "lib.es2024.regexp.d.ts"],
     ["es2024.sharedmemory", "lib.es2024.sharedmemory.d.ts"],
     ["es2024.string", "lib.es2024.string.d.ts"],
-    ["esnext.array", "lib.es2023.array.d.ts"],
-    ["esnext.collection", "lib.esnext.collection.d.ts"],
-    ["esnext.symbol", "lib.es2019.symbol.d.ts"],
+    ["es2025.collection", "lib.es2025.collection.d.ts"],
+    ["es2025.float16", "lib.es2025.float16.d.ts"],
+    ["es2025.intl", "lib.es2025.intl.d.ts"],
+    ["es2025.iterator", "lib.es2025.iterator.d.ts"],
+    ["es2025.promise", "lib.es2025.promise.d.ts"],
+    ["es2025.regexp", "lib.es2025.regexp.d.ts"],
+    // Fallback for backward compatibility
     ["esnext.asynciterable", "lib.es2018.asynciterable.d.ts"],
-    ["esnext.intl", "lib.esnext.intl.d.ts"],
-    ["esnext.disposable", "lib.esnext.disposable.d.ts"],
+    ["esnext.symbol", "lib.es2019.symbol.d.ts"],
     ["esnext.bigint", "lib.es2020.bigint.d.ts"],
-    ["esnext.string", "lib.es2022.string.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.es2024.object.d.ts"],
-    ["esnext.array", "lib.esnext.array.d.ts"],
     ["esnext.regexp", "lib.es2024.regexp.d.ts"],
     ["esnext.string", "lib.es2024.string.d.ts"],
-    ["esnext.iterator", "lib.esnext.iterator.d.ts"],
-    ["esnext.promise", "lib.esnext.promise.d.ts"],
-    ["esnext.float16", "lib.esnext.float16.d.ts"],
-    ["esnext.typedarrays", "lib.esnext.typedarrays.d.ts"],
+    ["esnext.collection", "lib.es2025.collection.d.ts"],
+    ["esnext.float16", "lib.es2025.float16.d.ts"],
+    ["esnext.iterator", "lib.es2025.iterator.d.ts"],
+    ["esnext.promise", "lib.es2025.promise.d.ts"],
+    // ESNext By-feature options
+    ["esnext.array", "lib.esnext.array.d.ts"],
+    ["esnext.decorators", "lib.esnext.decorators.d.ts"],
+    ["esnext.disposable", "lib.esnext.disposable.d.ts"],
     ["esnext.error", "lib.esnext.error.d.ts"],
+    ["esnext.intl", "lib.esnext.intl.d.ts"],
     ["esnext.sharedmemory", "lib.esnext.sharedmemory.d.ts"],
+    ["esnext.typedarrays", "lib.esnext.typedarrays.d.ts"],
+    // Decorators
     ["decorators", "lib.decorators.d.ts"],
     ["decorators.legacy", "lib.decorators.legacy.d.ts"],
 ];
@@ -555,6 +562,10 @@ export const commonOptionsWithBuild: CommandLineOption[] = [
     },
 ];
 
+// NOTE: We must reevaluate the target for upcoming features when each successive TC39 edition is ratified in
+//       June of each year. This includes changes to `LanguageFeatureMinimumTarget`, `ScriptTarget`,
+//       `ScriptTargetFeatures`, `CommandLineOptionOfCustomType`, transformers/esnext.ts, compiler/commandLineParser.ts,
+//       compiler/utilitiesPublic.ts, and the contents of each lib/esnext.*.d.ts file.
 /** @internal */
 export const targetOptionDeclaration: CommandLineOptionOfCustomType = {
     name: "target",
@@ -573,6 +584,7 @@ export const targetOptionDeclaration: CommandLineOptionOfCustomType = {
         es2022: ScriptTarget.ES2022,
         es2023: ScriptTarget.ES2023,
         es2024: ScriptTarget.ES2024,
+        es2025: ScriptTarget.ES2025,
         esnext: ScriptTarget.ESNext,
     })),
     affectsSourceFile: true,

src/compiler/transformers/esnext.ts

@@ -71,7 +71,7 @@ const enum UsingKind {
 export function transformESNext(context: TransformationContext): (x: SourceFile | Bundle) => SourceFile | Bundle {
     // NOTE: We must reevaluate the target for upcoming features when each successive TC39 edition is ratified in
     //       June of each year. This includes changes to `LanguageFeatureMinimumTarget`, `ScriptTarget`,
-    //       `ScriptTargetFeatures` transformers/esnext.ts, compiler/commandLineParser.ts,
+    //       `ScriptTargetFeatures`, `CommandLineOptionOfCustomType`, transformers/esnext.ts, compiler/commandLineParser.ts,
     //       compiler/utilitiesPublic.ts, and the contents of each lib/esnext.*.d.ts file.
 
     const {

src/compiler/types.ts

@@ -7655,7 +7655,7 @@ export const enum ScriptKind {
 
 // NOTE: We must reevaluate the target for upcoming features when each successive TC39 edition is ratified in
 //       June of each year. This includes changes to `LanguageFeatureMinimumTarget`, `ScriptTarget`,
-//       `ScriptTargetFeatures` transformers/esnext.ts, compiler/commandLineParser.ts,
+//       `ScriptTargetFeatures`, `CommandLineOptionOfCustomType`, transformers/esnext.ts, compiler/commandLineParser.ts,
 //       compiler/utilitiesPublic.ts, and the contents of each lib/esnext.*.d.ts file.
 export const enum ScriptTarget {
     /** @deprecated */
@@ -7672,10 +7672,11 @@ export const enum ScriptTarget {
     ES2022 = 9,
     ES2023 = 10,
     ES2024 = 11,
+    ES2025 = 12,
     ESNext = 99,
     JSON = 100,
     Latest = ESNext,
-    LatestStandard = ES2024,
+    LatestStandard = ES2025,
 }
 
 export const enum LanguageVariant {
@@ -8461,7 +8462,7 @@ export type LanugageFeatures =
     // Upcoming Features
     // NOTE: We must reevaluate the target for upcoming features when each successive TC39 edition is ratified in
     //       June of each year. This includes changes to `LanguageFeatureMinimumTarget`, `ScriptTarget`,
-    //       `ScriptTargetFeatures` transformers/esnext.ts, compiler/commandLineParser.ts,
+    //       `ScriptTargetFeatures`, `CommandLineOptionOfCustomType`, transformers/esnext.ts, compiler/commandLineParser.ts,
     //       compiler/utilitiesPublic.ts, and the contents of each lib/esnext.*.d.ts file.
     | "UsingAndAwaitUsing" // `using x = y`, `await using x = y`
     | "ClassAndClassElementDecorators" // `@dec class C {}`, `class C { @dec m() {} }`

src/compiler/utilities.ts

@@ -1378,7 +1378,7 @@ export type ScriptTargetFeatures = ReadonlyMap<string, ReadonlyMap<string, strin
 
 // NOTE: We must reevaluate the target for upcoming features when each successive TC39 edition is ratified in
 //       June of each year. This includes changes to `LanguageFeatureMinimumTarget`, `ScriptTarget`,
-//       `ScriptTargetFeatures` transformers/esnext.ts, compiler/commandLineParser.ts,
+//       `ScriptTargetFeatures`, `CommandLineOptionOfCustomType`, transformers/esnext.ts, compiler/commandLineParser.ts,
 //       compiler/utilitiesPublic.ts, and the contents of each lib/esnext.*.d.ts file.
 /** @internal */
 export const getScriptTargetFeatures: () => ScriptTargetFeatures = /* @__PURE__ */ memoize((): ScriptTargetFeatures =>
@@ -1486,6 +1486,11 @@ export const getScriptTargetFeatures: () => ScriptTargetFeatures = /* @__PURE__
                 "unicodeSets",
             ],
         })),
+        RegExpConstructor: new Map(Object.entries({
+            es2025: [
+                "escape",
+            ],
+        })),
         Reflect: new Map(Object.entries({
             es2015: [
                 "apply",
@@ -1565,7 +1570,7 @@ export const getScriptTargetFeatures: () => ScriptTargetFeatures = /* @__PURE__
                 "fround",
                 "cbrt",
             ],
-            esnext: [
+            es2025: [
                 "f16round",
             ],
         })),
@@ -1587,7 +1592,7 @@ export const getScriptTargetFeatures: () => ScriptTargetFeatures = /* @__PURE__
                 "keys",
                 "values",
             ],
-            esnext: [
+            es2025: [
                 "union",
                 "intersection",
                 "difference",
@@ -1613,6 +1618,9 @@ export const getScriptTargetFeatures: () => ScriptTargetFeatures = /* @__PURE__
             es2024: [
                 "withResolvers",
             ],
+            es2025: [
+                "try",
+            ],
         })),
         Symbol: new Map(Object.entries({
             es2015: [
@@ -1714,6 +1722,21 @@ export const getScriptTargetFeatures: () => ScriptTargetFeatures = /* @__PURE__
             es2018: [
                 "PluralRules",
             ],
+            es2020: [
+                "RelativeTimeFormat",
+                "Locale",
+                "DisplayNames",
+            ],
+            es2021: [
+                "ListFormat",
+                "DateTimeFormat",
+            ],
+            es2022: [
+                "Segmenter",
+            ],
+            es2025: [
+                "DurationFormat",
+            ],
         })),
         NumberFormat: new Map(Object.entries({
             es2018: [
@@ -1737,7 +1760,7 @@ export const getScriptTargetFeatures: () => ScriptTargetFeatures = /* @__PURE__
                 "getBigInt64",
                 "getBigUint64",
             ],
-            esnext: [
+            es2025: [
                 "setFloat16",
                 "getFloat16",
             ],
@@ -1850,7 +1873,7 @@ export const getScriptTargetFeatures: () => ScriptTargetFeatures = /* @__PURE__
             ],
         })),
         Float16Array: new Map(Object.entries({
-            esnext: emptyArray,
+            es2025: emptyArray,
         })),
         Float32Array: new Map(Object.entries({
             es2022: [
@@ -1911,12 +1934,23 @@ export const getScriptTargetFeatures: () => ScriptTargetFeatures = /* @__PURE__
                 "cause",
             ],
         })),
+        ErrorConstructor: new Map(Object.entries({
+            esnext: [
+                "isError",
+            ],
+        })),
         Uint8ArrayConstructor: new Map(Object.entries({
             esnext: [
                 "fromBase64",
                 "fromHex",
             ],
         })),
+        DisposableStack: new Map(Object.entries({
+            esnext: emptyArray,
+        })),
+        AsyncDisposableStack: new Map(Object.entries({
+            esnext: emptyArray,
+        })),
     }))
 );
 

src/compiler/utilitiesPublic.ts

@@ -307,10 +307,11 @@ export function sortAndDeduplicateDiagnostics<T extends Diagnostic>(diagnostics:
 /** @internal */
 // NOTE: We must reevaluate the target for upcoming features when each successive TC39 edition is ratified in
 //       June of each year. This includes changes to `LanguageFeatureMinimumTarget`, `ScriptTarget`,
-//       `ScriptTargetFeatures` transformers/esnext.ts, compiler/commandLineParser.ts,
+//       `ScriptTargetFeatures`, `CommandLineOptionOfCustomType`, transformers/esnext.ts, compiler/commandLineParser.ts,
 //       compiler/utilitiesPublic.ts, and the contents of each lib/esnext.*.d.ts file.
 export const targetToLibMap: Map<ScriptTarget, string> = new Map([
     [ScriptTarget.ESNext, "lib.esnext.full.d.ts"],
+    [ScriptTarget.ES2025, "lib.es2025.full.d.ts"],
     [ScriptTarget.ES2024, "lib.es2024.full.d.ts"],
     [ScriptTarget.ES2023, "lib.es2023.full.d.ts"],
     [ScriptTarget.ES2022, "lib.es2022.full.d.ts"],
@@ -327,6 +328,7 @@ export function getDefaultLibFileName(options: CompilerOptions): string {
     const target = getEmitScriptTarget(options);
     switch (target) {
         case ScriptTarget.ESNext:
+        case ScriptTarget.ES2025:
         case ScriptTarget.ES2024:
         case ScriptTarget.ES2023:
         case ScriptTarget.ES2022:

src/lib/esnext.collection.d.ts src/lib/es2025.collection.d.tssrc/lib/esnext.collection.d.ts renamed to src/lib/es2025.collection.d.ts

@@ -0,0 +1,7 @@
+/// <reference lib="es2024" />
+/// <reference lib="es2025.collection" />
+/// <reference lib="es2025.float16" />
+/// <reference lib="es2025.intl" />
+/// <reference lib="es2025.iterator" />
+/// <reference lib="es2025.promise" />
+/// <reference lib="es2025.regexp" />

src/lib/es2025.d.ts

@@ -0,0 +1,6 @@
+/// <reference lib="es2025" />
+/// <reference lib="dom" />
+/// <reference lib="webworker.importscripts" />
+/// <reference lib="scripthost" />
+/// <reference lib="dom.iterable" />
+/// <reference lib="dom.asynciterable" />