feat(lib/es2020.intl): Add Intl.RelativeTimeFormat (part of microsoft#29129);

Author: Dmitry Makhnev

src/compiler/commandLineParser.ts

@@ -53,6 +53,7 @@ namespace ts {
         ["es2020.promise", "lib.es2020.promise.d.ts"],
         ["es2020.string", "lib.es2020.string.d.ts"],
         ["es2020.symbol.wellknown", "lib.es2020.symbol.wellknown.d.ts"],
+        ["es2020.intl", "lib.es2020.intl.d.ts"],
         ["esnext.array", "lib.es2019.array.d.ts"],
         ["esnext.symbol", "lib.es2019.symbol.d.ts"],
         ["esnext.asynciterable", "lib.es2018.asynciterable.d.ts"],

src/lib/es2020.d.ts

@@ -3,3 +3,4 @@
 /// <reference lib="es2020.promise" />
 /// <reference lib="es2020.string" />
 /// <reference lib="es2020.symbol.wellknown" />
+/// <reference lib="es2020.intl" />

src/lib/es2020.intl.d.ts

@@ -0,0 +1,48 @@
+declare namespace Intl {
+    type RelativeTimeFormatUnit = "year" | "quarter" | "month" | "week" | "day" | "hour" | "minute" | "second";
+    type RelativeTimeFormatLocaleMatcher = "lookup" | "best fit";
+    type RelativeTimeFormatNumeric = "always" | "auto";
+    type RelativeTimeFormatStyle = "long" | "short" | "narrow";
+
+    interface RelativeTimeFormatOptions {
+        localeMatcher?: RelativeTimeFormatLocaleMatcher;
+        numeric?: RelativeTimeFormatNumeric;
+        style?: RelativeTimeFormatStyle;
+    }
+
+    interface ResolvedRelativeTimeFormatOptions {
+        locale: string;
+        style: RelativeTimeFormatStyle;
+        numeric: RelativeTimeFormatNumeric;
+        numberingSystem: string;
+    }
+
+    interface RelativeTimeFormatPart {
+        type: string;
+        value: string;
+        unit?: RelativeTimeFormatUnit;
+    }
+
+    interface RelativeTimeFormat {
+        format(
+            value: number,
+            unit: RelativeTimeFormatUnit,
+        ): string;
+        formatToParts(
+            value: number,
+            unit: RelativeTimeFormatUnit,
+        ): RelativeTimeFormatPart[];
+        resolvedOptions(): ResolvedRelativeTimeFormatOptions;
+    }
+
+    const RelativeTimeFormat: {
+        new(
+            locales?: string | string[],
+            options?: RelativeTimeFormatOptions,
+        ): RelativeTimeFormat;
+        supportedLocalesOf(
+            locales: string | string[],
+            options?: RelativeTimeFormatOptions,
+        ): string[];
+    }
+}

src/lib/libs.json

@@ -44,6 +44,7 @@
         "es2020.promise",
         "es2020.string",
         "es2020.symbol.wellknown",
+        "es2020.intl",
         "esnext.intl",
         // Default libraries
         "es5.full",

src/testRunner/unittests/config/commandLineParsing.ts

@@ -85,7 +85,7 @@ namespace ts {
             assertParseResult(["--lib", "es5,invalidOption", "0.ts"],
                 {
                     errors: [{
-                        messageText: "Argument for '--lib' option must be: 'es5', 'es6', 'es2015', 'es7', 'es2016', 'es2017', 'es2018', 'es2019', 'es2020', 'esnext', 'dom', 'dom.iterable', 'webworker', 'webworker.importscripts', 'scripthost', 'es2015.core', 'es2015.collection', 'es2015.generator', 'es2015.iterable', 'es2015.promise', 'es2015.proxy', 'es2015.reflect', 'es2015.symbol', 'es2015.symbol.wellknown', 'es2016.array.include', 'es2017.object', 'es2017.sharedmemory', 'es2017.string', 'es2017.intl', 'es2017.typedarrays', 'es2018.asyncgenerator', 'es2018.asynciterable', 'es2018.intl', 'es2018.promise', 'es2018.regexp', 'es2019.array', 'es2019.object', 'es2019.string', 'es2019.symbol', 'es2020.bigint', 'es2020.promise', 'es2020.string', 'es2020.symbol.wellknown', 'esnext.array', 'esnext.symbol', 'esnext.asynciterable', 'esnext.intl', 'esnext.bigint'.",
+                        messageText: "Argument for '--lib' option must be: 'es5', 'es6', 'es2015', 'es7', 'es2016', 'es2017', 'es2018', 'es2019', 'es2020', 'esnext', 'dom', 'dom.iterable', 'webworker', 'webworker.importscripts', 'scripthost', 'es2015.core', 'es2015.collection', 'es2015.generator', 'es2015.iterable', 'es2015.promise', 'es2015.proxy', 'es2015.reflect', 'es2015.symbol', 'es2015.symbol.wellknown', 'es2016.array.include', 'es2017.object', 'es2017.sharedmemory', 'es2017.string', 'es2017.intl', 'es2017.typedarrays', 'es2018.asyncgenerator', 'es2018.asynciterable', 'es2018.intl', 'es2018.promise', 'es2018.regexp', 'es2019.array', 'es2019.object', 'es2019.string', 'es2019.symbol', 'es2020.bigint', 'es2020.promise', 'es2020.string', 'es2020.symbol.wellknown', 'es2020.intl', 'esnext.array', 'esnext.symbol', 'esnext.asynciterable', 'esnext.intl', 'esnext.bigint'.",
                         category: Diagnostics.Argument_for_0_option_must_be_Colon_1.category,
                         code: Diagnostics.Argument_for_0_option_must_be_Colon_1.code,
                         file: undefined,