strict-ts-lib-v6.0 0.2.0

package/libs/es2025/intl/index.d.ts

@@ -0,0 +1,221 @@
+/// <reference lib="es2018.intl" />
+
+declare namespace Intl {
+  /**
+   * The locale matching algorithm to use.
+   *
+   * [MDN](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl#Locale_negotiation).
+   */
+  type DurationFormatLocaleMatcher = 'lookup' | 'best fit';
+
+  /**
+   * The style of the formatted duration.
+   *
+   * [MDN](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/DurationFormat#style).
+   */
+  type DurationFormatStyle = 'long' | 'short' | 'narrow' | 'digital';
+
+  /**
+   * Whether to always display a unit, or only if it is non-zero.
+   *
+   * [MDN](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/DurationFormat#display).
+   */
+  type DurationFormatDisplayOption = 'always' | 'auto';
+
+  /**
+   * Value of the `unit` property in duration objects
+   *
+   * [MDN](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/format#duration).
+   */
+  type DurationFormatUnit =
+    | 'years'
+    | 'months'
+    | 'weeks'
+    | 'days'
+    | 'hours'
+    | 'minutes'
+    | 'seconds'
+    | 'milliseconds'
+    | 'microseconds'
+    | 'nanoseconds';
+
+  type DurationFormatUnitSingular =
+    | 'year'
+    | 'month'
+    | 'week'
+    | 'day'
+    | 'hour'
+    | 'minute'
+    | 'second'
+    | 'millisecond'
+    | 'microsecond'
+    | 'nanosecond';
+
+  /**
+   * An object representing the relative time format in parts
+   * that can be used for custom locale-aware formatting.
+   *
+   * [MDN](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/formatToParts).
+   */
+  type DurationFormatPart =
+    | {
+        readonly type: 'literal';
+        readonly value: string;
+        readonly unit?: DurationFormatUnitSingular;
+      }
+    | {
+        readonly type: Exclude<NumberFormatPartTypes, 'literal'>;
+        readonly value: string;
+        readonly unit: DurationFormatUnitSingular;
+      };
+
+  /**
+   * An object with some or all properties of the `Intl.DurationFormat` constructor `options` parameter.
+   *
+   * [MDN](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/DurationFormat#parameters)
+   */
+  interface DurationFormatOptions {
+    readonly localeMatcher?: DurationFormatLocaleMatcher | undefined;
+    readonly numberingSystem?: string | undefined;
+    readonly style?: DurationFormatStyle | undefined;
+    readonly years?: 'long' | 'short' | 'narrow' | undefined;
+    readonly yearsDisplay?: DurationFormatDisplayOption | undefined;
+    readonly months?: 'long' | 'short' | 'narrow' | undefined;
+    readonly monthsDisplay?: DurationFormatDisplayOption | undefined;
+    readonly weeks?: 'long' | 'short' | 'narrow' | undefined;
+    readonly weeksDisplay?: DurationFormatDisplayOption | undefined;
+    readonly days?: 'long' | 'short' | 'narrow' | undefined;
+    readonly daysDisplay?: DurationFormatDisplayOption | undefined;
+    readonly hours?:
+      | 'long'
+      | 'short'
+      | 'narrow'
+      | 'numeric'
+      | '2-digit'
+      | undefined;
+    readonly hoursDisplay?: DurationFormatDisplayOption | undefined;
+    readonly minutes?:
+      | 'long'
+      | 'short'
+      | 'narrow'
+      | 'numeric'
+      | '2-digit'
+      | undefined;
+    readonly minutesDisplay?: DurationFormatDisplayOption | undefined;
+    readonly seconds?:
+      | 'long'
+      | 'short'
+      | 'narrow'
+      | 'numeric'
+      | '2-digit'
+      | undefined;
+    readonly secondsDisplay?: DurationFormatDisplayOption | undefined;
+    readonly milliseconds?: 'long' | 'short' | 'narrow' | 'numeric' | undefined;
+    readonly millisecondsDisplay?: DurationFormatDisplayOption | undefined;
+    readonly microseconds?: 'long' | 'short' | 'narrow' | 'numeric' | undefined;
+    readonly microsecondsDisplay?: DurationFormatDisplayOption | undefined;
+    readonly nanoseconds?: 'long' | 'short' | 'narrow' | 'numeric' | undefined;
+    readonly nanosecondsDisplay?: DurationFormatDisplayOption | undefined;
+    readonly fractionalDigits?:
+      | 0
+      | 1
+      | 2
+      | 3
+      | 4
+      | 5
+      | 6
+      | 7
+      | 8
+      | 9
+      | undefined;
+  }
+
+  /**
+   * The Intl.DurationFormat object enables language-sensitive duration formatting.
+   *
+   * [MDN](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat)
+   */
+  interface DurationFormat {
+    /**
+     * @param duration The duration object to be formatted. It should include some or all of the following properties: months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds.
+     *
+     * [MDN](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/format).
+     */
+    format(duration: Partial<Record<DurationFormatUnit, number>>): string;
+    /**
+     * @param duration The duration object to be formatted. It should include some or all of the following properties: months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds.
+     *
+     * [MDN](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/formatToParts).
+     */
+    formatToParts(
+      duration: Partial<Record<DurationFormatUnit, number>>,
+    ): DurationFormatPart[];
+    /**
+     * [MDN](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/resolvedOptions).
+     */
+    resolvedOptions(): ResolvedDurationFormatOptions;
+  }
+
+  interface ResolvedDurationFormatOptions {
+    readonly locale: UnicodeBCP47LocaleIdentifier;
+    readonly numberingSystem: string;
+    readonly style: DurationFormatStyle;
+    readonly years: 'long' | 'short' | 'narrow';
+    readonly yearsDisplay: DurationFormatDisplayOption;
+    readonly months: 'long' | 'short' | 'narrow';
+    readonly monthsDisplay: DurationFormatDisplayOption;
+    readonly weeks: 'long' | 'short' | 'narrow';
+    readonly weeksDisplay: DurationFormatDisplayOption;
+    readonly days: 'long' | 'short' | 'narrow';
+    readonly daysDisplay: DurationFormatDisplayOption;
+    readonly hours: 'long' | 'short' | 'narrow' | 'numeric' | '2-digit';
+    readonly hoursDisplay: DurationFormatDisplayOption;
+    readonly minutes: 'long' | 'short' | 'narrow' | 'numeric' | '2-digit';
+    readonly minutesDisplay: DurationFormatDisplayOption;
+    readonly seconds: 'long' | 'short' | 'narrow' | 'numeric' | '2-digit';
+    readonly secondsDisplay: DurationFormatDisplayOption;
+    readonly milliseconds: 'long' | 'short' | 'narrow' | 'numeric';
+    readonly millisecondsDisplay: DurationFormatDisplayOption;
+    readonly microseconds: 'long' | 'short' | 'narrow' | 'numeric';
+    readonly microsecondsDisplay: DurationFormatDisplayOption;
+    readonly nanoseconds: 'long' | 'short' | 'narrow' | 'numeric';
+    readonly nanosecondsDisplay: DurationFormatDisplayOption;
+    readonly fractionalDigits?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+  }
+
+  const DurationFormat: {
+    readonly prototype: DurationFormat;
+
+    /**
+     * @param locales A string with a BCP 47 language tag, or an array of such strings.
+     *   For the general form and interpretation of the `locales` argument, see the [Intl](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl#locale_identification_and_negotiation)
+     *   page.
+     *
+     * @param options An object for setting up a duration format.
+     *
+     * [MDN](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/DurationFormat).
+     */
+    new (
+      locales?: LocalesArgument,
+      options?: DurationFormatOptions,
+    ): DurationFormat;
+
+    /**
+     * Returns an array containing those of the provided locales that are supported in display names without having to fall back to the runtime's default locale.
+     *
+     * @param locales A string with a BCP 47 language tag, or an array of such strings.
+     *   For the general form and interpretation of the `locales` argument, see the [Intl](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl#locale_identification_and_negotiation)
+     *   page.
+     *
+     * @param options An object with a locale matcher.
+     *
+     * @returns An array of strings representing a subset of the given locale tags that are supported in display names without having to fall back to the runtime's default locale.
+     *
+     * [MDN](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/supportedLocalesOf).
+     */
+    supportedLocalesOf(
+      locales?: LocalesArgument,
+      options?: { readonly localeMatcher?: DurationFormatLocaleMatcher },
+    ): UnicodeBCP47LocaleIdentifier[];
+  };
+}

package/libs/es2025/iterator/index.d.ts

@@ -0,0 +1,170 @@
+/// <reference lib="es2015.iterable" />
+
+// NOTE: This is specified as what is essentially an unreachable module. All actual global declarations can be found
+//       in the `declare global` section, below. This is necessary as there is currently no way to declare an `abstract`
+//       member without declaring a `class`, but declaring `class Iterator<T>` globally would conflict with TypeScript's
+//       general purpose `Iterator<T>` interface.
+export {};
+
+// Abstract type that allows us to mark `next` as `abstract`
+declare abstract class Iterator<T, TResult = undefined, TNext = unknown> {
+  // eslint-disable-line @typescript-eslint/no-unsafe-declaration-merging
+  abstract next(value?: TNext): IteratorResult<T, TResult>;
+}
+
+// Merge all members of `IteratorObject<T>` into `Iterator<T>`
+interface Iterator<T, TResult, TNext> extends globalThis.IteratorObject<
+  T,
+  TResult,
+  TNext
+> {}
+
+// Capture the `Iterator` constructor in a type we can use in the `extends` clause of `IteratorConstructor`.
+type IteratorObjectConstructor = typeof Iterator;
+
+declare global {
+  // Global `IteratorObject<T, TReturn, TNext>` interface that can be augmented by polyfills
+  interface IteratorObject<T, TReturn, TNext> {
+    /**
+     * Returns this iterator.
+     */
+    [Symbol.iterator](): IteratorObject<T, TReturn, TNext>;
+
+    /**
+     * Creates an iterator whose values are the result of applying the callback to the values from this iterator.
+     * @param callbackfn A function that accepts up to two arguments to be used to transform values from the underlying iterator.
+     */
+    map<U>(
+      callbackfn: (value: T, index: number) => U,
+    ): IteratorObject<U, undefined, unknown>;
+
+    /**
+     * Creates an iterator whose values are those from this iterator for which the provided predicate returns true.
+     * @param predicate A function that accepts up to two arguments to be used to test values from the underlying iterator.
+     */
+    filter<S extends T>(
+      predicate: (value: T, index: number) => value is S,
+    ): IteratorObject<S, undefined, unknown>;
+
+    /**
+     * Creates an iterator whose values are those from this iterator for which the provided predicate returns true.
+     * @param predicate A function that accepts up to two arguments to be used to test values from the underlying iterator.
+     */
+    filter(
+      predicate: (value: T, index: number) => unknown,
+    ): IteratorObject<T, undefined, unknown>;
+
+    /**
+     * Creates an iterator whose values are the values from this iterator, stopping once the provided limit is reached.
+     * @param limit The maximum number of values to yield.
+     */
+    take(limit: number): IteratorObject<T, undefined, unknown>;
+
+    /**
+     * Creates an iterator whose values are the values from this iterator after skipping the provided count.
+     * @param count The number of values to drop.
+     */
+    drop(count: number): IteratorObject<T, undefined, unknown>;
+
+    /**
+     * Creates an iterator whose values are the result of applying the callback to the values from this iterator and then flattening the resulting iterators or iterables.
+     * @param callback A function that accepts up to two arguments to be used to transform values from the underlying iterator into new iterators or iterables to be flattened into the result.
+     */
+    flatMap<U>(
+      callback: (
+        value: T,
+        index: number,
+      ) => Iterator<U, unknown, undefined> | Iterable<U, unknown, undefined>,
+    ): IteratorObject<U, undefined, unknown>;
+
+    /**
+     * Calls the specified callback function for all the elements in this iterator. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
+     * @param callbackfn A function that accepts up to three arguments. The reduce method calls the callbackfn function one time for each element in the iterator.
+     * @param initialValue If initialValue is specified, it is used as the initial value to start the accumulation. The first call to the callbackfn function provides this value as an argument instead of a value from the iterator.
+     */
+    reduce(
+      callbackfn: (
+        previousValue: T,
+        currentValue: T,
+        currentIndex: number,
+      ) => T,
+    ): T;
+    reduce(
+      callbackfn: (
+        previousValue: T,
+        currentValue: T,
+        currentIndex: number,
+      ) => T,
+      initialValue: T,
+    ): T;
+
+    /**
+     * Calls the specified callback function for all the elements in this iterator. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
+     * @param callbackfn A function that accepts up to three arguments. The reduce method calls the callbackfn function one time for each element in the iterator.
+     * @param initialValue If initialValue is specified, it is used as the initial value to start the accumulation. The first call to the callbackfn function provides this value as an argument instead of a value from the iterator.
+     */
+    reduce<U>(
+      callbackfn: (
+        previousValue: U,
+        currentValue: T,
+        currentIndex: number,
+      ) => U,
+      initialValue: U,
+    ): U;
+
+    /**
+     * Creates a new array from the values yielded by this iterator.
+     */
+    toArray(): T[];
+
+    /**
+     * Performs the specified action for each element in the iterator.
+     * @param callbackfn A function that accepts up to two arguments. forEach calls the callbackfn function one time for each element in the iterator.
+     */
+    forEach(callbackfn: (value: T, index: number) => void): void;
+
+    /**
+     * Determines whether the specified callback function returns true for any element of this iterator.
+     * @param predicate A function that accepts up to two arguments. The some method calls
+     * the predicate function for each element in this iterator until the predicate returns a value
+     * true, or until the end of the iterator.
+     */
+    some(predicate: (value: T, index: number) => unknown): boolean;
+
+    /**
+     * Determines whether all the members of this iterator satisfy the specified test.
+     * @param predicate A function that accepts up to two arguments. The every method calls
+     * the predicate function for each element in this iterator until the predicate returns
+     * false, or until the end of this iterator.
+     */
+    every(predicate: (value: T, index: number) => unknown): boolean;
+
+    /**
+     * Returns the value of the first element in this iterator where predicate is true, and undefined
+     * otherwise.
+     * @param predicate find calls predicate once for each element of this iterator, in
+     * order, until it finds one where predicate returns true. If such an element is found, find
+     * immediately returns that element value. Otherwise, find returns undefined.
+     */
+    find<S extends T>(
+      predicate: (value: T, index: number) => value is S,
+    ): S | undefined;
+    find(predicate: (value: T, index: number) => unknown): T | undefined;
+
+    readonly [Symbol.toStringTag]: string;
+  }
+
+  // Global `IteratorConstructor` interface that can be augmented by polyfills
+  interface IteratorConstructor extends IteratorObjectConstructor {
+    /**
+     * Creates a native iterator from an iterator or iterable object.
+     * Returns its input if the input already inherits from the built-in Iterator class.
+     * @param value An iterator or iterable object to convert a native iterator.
+     */
+    from<T>(
+      value: Iterator<T, unknown, undefined> | Iterable<T, unknown, undefined>,
+    ): IteratorObject<T, undefined, unknown>;
+  }
+
+  const Iterator: IteratorConstructor;
+}

package/libs/es2025/promise/index.d.ts

@@ -0,0 +1,19 @@
+interface PromiseConstructor {
+  /**
+   * Takes a callback of any kind (returns or throws, synchronously or asynchronously) and wraps its result
+   * in a Promise.
+   *
+   * @param callbackFn A function that is called synchronously. It can do anything: either return
+   * a value, throw an error, or return a promise.
+   * @param args Additional arguments, that will be passed to the callback.
+   *
+   * @returns A Promise that is:
+   * - Already fulfilled, if the callback synchronously returns a value.
+   * - Already rejected, if the callback synchronously throws an error.
+   * - Asynchronously fulfilled or rejected, if the callback returns a promise.
+   */
+  try<T, U extends readonly unknown[]>(
+    callbackFn: (...args: U) => T | PromiseLike<T>,
+    ...args: U
+  ): Promise<Awaited<T>>;
+}

package/libs/es2025/regexp/index.d.ts

@@ -0,0 +1,14 @@
+interface RegExpConstructor {
+  /**
+   * Escapes any RegExp syntax characters in the input string, returning a
+   * new string that can be safely interpolated into a RegExp as a literal
+   * string to match.
+   * @example
+   * ```ts
+   * const regExp = new RegExp(RegExp.escape("foo.bar"));
+   * regExp.test("foo.bar"); // true
+   * regExp.test("foo!bar"); // false
+   * ```
+   */
+  escape(string: string): string;
+}