strict-ts-lib-v5.4 0.4.0

package/libs/es6/index.d.ts

@@ -0,0 +1,7 @@
+/// <reference no-default-lib="true"/>
+
+/// <reference lib="es2015" />
+/// <reference lib="dom" />
+/// <reference lib="dom.iterable" />
+/// <reference lib="webworker.importscripts" />
+/// <reference lib="scripthost" />

package/libs/esnext/collection/index.d.ts

@@ -0,0 +1,13 @@
+/// <reference no-default-lib="true"/>
+
+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[]>;
+}

package/libs/esnext/decorators/index.d.ts

@@ -0,0 +1,12 @@
+/// <reference no-default-lib="true"/>
+
+/// <reference lib="es2015.symbol" />
+/// <reference lib="decorators" />
+
+interface SymbolConstructor {
+  readonly metadata: unique symbol;
+}
+
+interface Function {
+  readonly [Symbol.metadata]: DecoratorMetadata | null;
+}

package/libs/esnext/disposable/index.d.ts

@@ -0,0 +1,169 @@
+/// <reference no-default-lib="true"/>
+
+/// <reference lib="es2015.symbol" />
+
+interface SymbolConstructor {
+  /**
+   * A method that is used to release resources held by an object. Called by the semantics of the `using` statement.
+   */
+  readonly dispose: unique symbol;
+
+  /**
+   * A method that is used to asynchronously release resources held by an object. Called by the semantics of the `await using` statement.
+   */
+  readonly asyncDispose: unique symbol;
+}
+
+interface Disposable {
+  [Symbol.dispose](): void;
+}
+
+interface AsyncDisposable {
+  [Symbol.asyncDispose](): PromiseLike<void>;
+}
+
+interface SuppressedError extends Error {
+  readonly error: unknown;
+  readonly suppressed: unknown;
+}
+
+interface SuppressedErrorConstructor {
+  new (error: unknown, suppressed: unknown, message?: string): SuppressedError;
+  (error: unknown, suppressed: unknown, message?: string): SuppressedError;
+  readonly prototype: SuppressedError;
+}
+declare const SuppressedError: SuppressedErrorConstructor;
+
+interface DisposableStack {
+  /**
+   * Returns a value indicating whether this stack has been disposed.
+   */
+  readonly disposed: boolean;
+  /**
+   * Disposes each resource in the stack in the reverse order that they were added.
+   */
+  dispose(): void;
+  /**
+   * Adds a disposable resource to the stack, returning the resource.
+   * @param value The resource to add. `null` and `undefined` will not be added, but will be returned.
+   * @returns The provided {@link value}.
+   */
+  use<T extends Disposable | null | undefined>(value: T): T;
+  /**
+   * Adds a value and associated disposal callback as a resource to the stack.
+   * @param value The value to add.
+   * @param onDispose The callback to use in place of a `[Symbol.dispose]()` method. Will be invoked with `value`
+   * as the first parameter.
+   * @returns The provided {@link value}.
+   */
+  adopt<T>(value: T, onDispose: (value: T) => void): T;
+  /**
+   * Adds a callback to be invoked when the stack is disposed.
+   */
+  defer(onDispose: () => void): void;
+  /**
+   * Move all resources out of this stack and into a new `DisposableStack`, and marks this stack as disposed.
+   * @example
+   * ```ts
+   * class C {
+   *   #res1: Disposable;
+   *   #res2: Disposable;
+   *   #disposables: DisposableStack;
+   *   constructor() {
+   *     // stack will be disposed when exiting constructor for any reason
+   *     using stack = new DisposableStack();
+   *
+   *     // get first resource
+   *     this.#res1 = stack.use(getResource1());
+   *
+   *     // get second resource. If this fails, both `stack` and `#res1` will be disposed.
+   *     this.#res2 = stack.use(getResource2());
+   *
+   *     // all operations succeeded, move resources out of `stack` so that they aren't disposed
+   *     // when constructor exits
+   *     this.#disposables = stack.move();
+   *   }
+   *
+   *   [Symbol.dispose]() {
+   *     this.#disposables.dispose();
+   *   }
+   * }
+   * ```
+   */
+  move(): DisposableStack;
+  [Symbol.dispose](): void;
+  readonly [Symbol.toStringTag]: string;
+}
+
+interface DisposableStackConstructor {
+  new (): DisposableStack;
+  readonly prototype: DisposableStack;
+}
+declare const DisposableStack: DisposableStackConstructor;
+
+interface AsyncDisposableStack {
+  /**
+   * Returns a value indicating whether this stack has been disposed.
+   */
+  readonly disposed: boolean;
+  /**
+   * Disposes each resource in the stack in the reverse order that they were added.
+   */
+  disposeAsync(): Promise<void>;
+  /**
+   * Adds a disposable resource to the stack, returning the resource.
+   * @param value The resource to add. `null` and `undefined` will not be added, but will be returned.
+   * @returns The provided {@link value}.
+   */
+  use<T extends AsyncDisposable | Disposable | null | undefined>(value: T): T;
+  /**
+   * Adds a value and associated disposal callback as a resource to the stack.
+   * @param value The value to add.
+   * @param onDisposeAsync The callback to use in place of a `[Symbol.asyncDispose]()` method. Will be invoked with `value`
+   * as the first parameter.
+   * @returns The provided {@link value}.
+   */
+  adopt<T>(value: T, onDisposeAsync: (value: T) => PromiseLike<void> | void): T;
+  /**
+   * Adds a callback to be invoked when the stack is disposed.
+   */
+  defer(onDisposeAsync: () => PromiseLike<void> | void): void;
+  /**
+   * Move all resources out of this stack and into a new `DisposableStack`, and marks this stack as disposed.
+   * @example
+   * ```ts
+   * class C {
+   *   #res1: Disposable;
+   *   #res2: Disposable;
+   *   #disposables: DisposableStack;
+   *   constructor() {
+   *     // stack will be disposed when exiting constructor for any reason
+   *     using stack = new DisposableStack();
+   *
+   *     // get first resource
+   *     this.#res1 = stack.use(getResource1());
+   *
+   *     // get second resource. If this fails, both `stack` and `#res1` will be disposed.
+   *     this.#res2 = stack.use(getResource2());
+   *
+   *     // all operations succeeded, move resources out of `stack` so that they aren't disposed
+   *     // when constructor exits
+   *     this.#disposables = stack.move();
+   *   }
+   *
+   *   [Symbol.dispose]() {
+   *     this.#disposables.dispose();
+   *   }
+   * }
+   * ```
+   */
+  move(): AsyncDisposableStack;
+  [Symbol.asyncDispose](): Promise<void>;
+  readonly [Symbol.toStringTag]: string;
+}
+
+interface AsyncDisposableStackConstructor {
+  new (): AsyncDisposableStack;
+  readonly prototype: AsyncDisposableStack;
+}
+declare const AsyncDisposableStack: AsyncDisposableStackConstructor;

package/libs/esnext/full/index.d.ts

@@ -0,0 +1,8 @@
+/// <reference no-default-lib="true"/>
+
+/// <reference lib="esnext" />
+/// <reference lib="dom" />
+/// <reference lib="webworker.importscripts" />
+/// <reference lib="scripthost" />
+/// <reference lib="dom.iterable" />
+/// <reference lib="dom.asynciterable" />

package/libs/esnext/index.d.ts

@@ -0,0 +1,9 @@
+/// <reference no-default-lib="true"/>
+
+/// <reference lib="es2023" />
+/// <reference lib="esnext.intl" />
+/// <reference lib="esnext.decorators" />
+/// <reference lib="esnext.disposable" />
+/// <reference lib="esnext.promise" />
+/// <reference lib="esnext.object" />
+/// <reference lib="esnext.collection" />

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

@@ -0,0 +1,15 @@
+/// <reference no-default-lib="true"/>
+
+declare namespace Intl {
+  interface NumberRangeFormatPart extends NumberFormatPart {
+    readonly source: 'startRange' | 'endRange' | 'shared';
+  }
+
+  interface NumberFormat {
+    formatRange(start: number | bigint, end: number | bigint): string;
+    formatRangeToParts(
+      start: number | bigint,
+      end: number | bigint,
+    ): NumberRangeFormatPart[];
+  }
+}

package/libs/esnext/object/index.d.ts

@@ -0,0 +1,13 @@
+/// <reference no-default-lib="true"/>
+
+interface ObjectConstructor {
+  /**
+   * 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 extends PropertyKey, T>(
+    items: Iterable<T>,
+    keySelector: (item: T, index: number) => K,
+  ): Partial<import('ts-type-forge').MutableRecord<K, T[]>>;
+}

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

@@ -0,0 +1,19 @@
+/// <reference no-default-lib="true"/>
+
+interface PromiseWithResolvers<T> {
+  readonly promise: Promise<T>;
+  readonly resolve: (value: T | PromiseLike<T>) => void;
+  readonly reject: (reason?: unknown) => void;
+}
+
+interface PromiseConstructor {
+  /**
+   * Creates a new Promise and returns it in an object, along with its resolve and reject functions.
+   * @returns An object with the properties `promise`, `resolve`, and `reject`.
+   *
+   * ```ts
+   * const { promise, resolve, reject } = Promise.withResolvers<T>();
+   * ```
+   */
+  withResolvers<T>(): PromiseWithResolvers<T>;
+}

package/libs/scripthost/index.d.ts

@@ -0,0 +1,310 @@
+/// <reference no-default-lib="true"/>
+
+/////////////////////////////
+/// Windows Script Host APIS
+/////////////////////////////
+
+interface ActiveXObject {
+  new (s: string): unknown;
+}
+declare const ActiveXObject: ActiveXObject;
+
+interface ITextWriter {
+  Write(s: string): void;
+  WriteLine(s: string): void;
+  Close(): void;
+}
+
+interface TextStreamBase {
+  /**
+   * The column number of the current character position in an input stream.
+   */
+  readonly Column: number;
+
+  /**
+   * The current line number in an input stream.
+   */
+  readonly Line: number;
+
+  /**
+   * Closes a text stream.
+   * It is not necessary to close standard streams; they close automatically when the process ends. If
+   * you close a standard stream, be aware that any other pointers to that standard stream become invalid.
+   */
+  Close(): void;
+}
+
+interface TextStreamWriter extends TextStreamBase {
+  /**
+   * Sends a string to an output stream.
+   */
+  Write(s: string): void;
+
+  /**
+   * Sends a specified number of blank lines (newline characters) to an output stream.
+   */
+  WriteBlankLines(intLines: number): void;
+
+  /**
+   * Sends a string followed by a newline character to an output stream.
+   */
+  WriteLine(s: string): void;
+}
+
+interface TextStreamReader extends TextStreamBase {
+  /**
+   * Returns a specified number of characters from an input stream, starting at the current pointer position.
+   * Does not return until the ENTER key is pressed.
+   * Can only be used on a stream in reading mode; causes an error in writing or appending mode.
+   */
+  Read(characters: number): string;
+
+  /**
+   * Returns all characters from an input stream.
+   * Can only be used on a stream in reading mode; causes an error in writing or appending mode.
+   */
+  ReadAll(): string;
+
+  /**
+   * Returns an entire line from an input stream.
+   * Although this method extracts the newline character, it does not add it to the returned string.
+   * Can only be used on a stream in reading mode; causes an error in writing or appending mode.
+   */
+  ReadLine(): string;
+
+  /**
+   * Skips a specified number of characters when reading from an input text stream.
+   * Can only be used on a stream in reading mode; causes an error in writing or appending mode.
+   * @param characters Positive number of characters to skip forward. (Backward skipping is not supported.)
+   */
+  Skip(characters: number): void;
+
+  /**
+   * Skips the next line when reading from an input text stream.
+   * Can only be used on a stream in reading mode, not writing or appending mode.
+   */
+  SkipLine(): void;
+
+  /**
+   * Indicates whether the stream pointer position is at the end of a line.
+   */
+  readonly AtEndOfLine: boolean;
+
+  /**
+   * Indicates whether the stream pointer position is at the end of a stream.
+   */
+  readonly AtEndOfStream: boolean;
+}
+
+declare const WScript: {
+  /**
+   * Outputs text to either a message box (under WScript.exe) or the command console window followed by
+   * a newline (under CScript.exe).
+   */
+  Echo(s: unknown): void;
+
+  /**
+   * Exposes the write-only error output stream for the current script.
+   * Can be accessed only while using CScript.exe.
+   */
+  readonly StdErr: TextStreamWriter;
+
+  /**
+   * Exposes the write-only output stream for the current script.
+   * Can be accessed only while using CScript.exe.
+   */
+  readonly StdOut: TextStreamWriter;
+  readonly Arguments: { readonly length: number; Item(n: number): string };
+
+  /**
+   *  The full path of the currently running script.
+   */
+  readonly ScriptFullName: string;
+
+  /**
+   * Forces the script to stop immediately, with an optional exit code.
+   */
+  Quit(exitCode?: number): number;
+
+  /**
+   * The Windows Script Host build version number.
+   */
+  readonly BuildVersion: number;
+
+  /**
+   * Fully qualified path of the host executable.
+   */
+  readonly FullName: string;
+
+  /**
+   * Gets/sets the script mode - interactive(true) or batch(false).
+   */
+  readonly Interactive: boolean;
+
+  /**
+   * The name of the host executable (WScript.exe or CScript.exe).
+   */
+  readonly Name: string;
+
+  /**
+   * Path of the directory containing the host executable.
+   */
+  readonly Path: string;
+
+  /**
+   * The filename of the currently running script.
+   */
+  readonly ScriptName: string;
+
+  /**
+   * Exposes the read-only input stream for the current script.
+   * Can be accessed only while using CScript.exe.
+   */
+  readonly StdIn: TextStreamReader;
+
+  /**
+   * Windows Script Host version
+   */
+  readonly Version: string;
+
+  /**
+   * Connects a COM object's event sources to functions named with a given prefix, in the form prefix_event.
+   */
+  ConnectObject(objEventSource: unknown, strPrefix: string): void;
+
+  /**
+   * Creates a COM object.
+   * @param strProgiID
+   * @param strPrefix Function names in the form prefix_event will be bound to this object's COM events.
+   */
+  CreateObject(strProgID: string, strPrefix?: string): unknown;
+
+  /**
+   * Disconnects a COM object from its event sources.
+   */
+  DisconnectObject(obj: unknown): void;
+
+  /**
+   * Retrieves an existing object with the specified ProgID from memory, or creates a new one from a file.
+   * @param strPathname Fully qualified path to the file containing the object persisted to disk.
+   *                       For objects in memory, pass a zero-length string.
+   * @param strProgID
+   * @param strPrefix Function names in the form prefix_event will be bound to this object's COM events.
+   */
+  GetObject(
+    strPathname: string,
+    strProgID?: string,
+    strPrefix?: string,
+  ): unknown;
+
+  /**
+   * Suspends script execution for a specified length of time, then continues execution.
+   * @param intTime Interval (in milliseconds) to suspend script execution.
+   */
+  Sleep(intTime: number): void;
+};
+
+/**
+ * WSH is an alias for WScript under Windows Script Host
+ */
+declare const WSH: typeof WScript;
+
+/**
+ * Represents an Automation SAFEARRAY
+ */
+declare class SafeArray<T = unknown> {
+  private constructor();
+  private SafeArray_typekey: SafeArray<T>;
+}
+
+/**
+ * Allows enumerating over a COM collection, which may not have indexed item access.
+ */
+interface Enumerator<T = unknown> {
+  /**
+   * Returns true if the current item is the last one in the collection, or the collection is empty,
+   * or the current item is undefined.
+   */
+  atEnd(): boolean;
+
+  /**
+   * Returns the current item in the collection
+   */
+  item(): T;
+
+  /**
+   * Resets the current item in the collection to the first item. If there are no items in the collection,
+   * the current item is set to undefined.
+   */
+  moveFirst(): void;
+
+  /**
+   * Moves the current item to the next item in the collection. If the enumerator is at the end of
+   * the collection or the collection is empty, the current item is set to undefined.
+   */
+  moveNext(): void;
+}
+
+interface EnumeratorConstructor {
+  new <T = unknown>(safearray: SafeArray<T>): Enumerator<T>;
+  new <T = unknown>(collection: { Item(index: unknown): T }): Enumerator<T>;
+  new <T = unknown>(collection: unknown): Enumerator<T>;
+}
+
+declare const Enumerator: EnumeratorConstructor;
+
+/**
+ * Enables reading from a COM safe array, which might have an alternate lower bound, or multiple dimensions.
+ */
+interface VBArray<T = unknown> {
+  /**
+   * Returns the number of dimensions (1-based).
+   */
+  dimensions(): number;
+
+  /**
+   * Takes an index for each dimension in the array, and returns the item at the corresponding location.
+   */
+  getItem(dimension1Index: number, ...dimensionNIndexes: readonly number[]): T;
+
+  /**
+   * Returns the smallest available index for a given dimension.
+   * @param dimension 1-based dimension (defaults to 1)
+   */
+  lbound(dimension?: number): number;
+
+  /**
+   * Returns the largest available index for a given dimension.
+   * @param dimension 1-based dimension (defaults to 1)
+   */
+  ubound(dimension?: number): number;
+
+  /**
+   * Returns a Javascript array with all the elements in the VBArray. If there are multiple dimensions,
+   * each successive dimension is appended to the end of the array.
+   * Example: [[1,2,3],[4,5,6]] becomes [1,2,3,4,5,6]
+   */
+  toArray(): T[];
+}
+
+interface VBArrayConstructor {
+  new <T = unknown>(safeArray: SafeArray<T>): VBArray<T>;
+}
+
+declare const VBArray: VBArrayConstructor;
+
+/**
+ * Automation date (VT_DATE)
+ */
+declare class VarDate {
+  private constructor();
+  private VarDate_typekey: VarDate;
+}
+
+interface DateConstructor {
+  new (vd: VarDate): Date;
+}
+
+interface Date {
+  readonly getVarDate: () => VarDate;
+}

package/libs/webworker/asynciterable/index.d.ts

@@ -0,0 +1,14 @@
+/// <reference no-default-lib="true"/>
+
+/////////////////////////////
+/// Worker Async Iterable APIs
+/////////////////////////////
+
+interface FileSystemDirectoryHandle {
+  [Symbol.asyncIterator](): AsyncIterableIterator<
+    readonly [string, FileSystemHandle]
+  >;
+  entries(): AsyncIterableIterator<readonly [string, FileSystemHandle]>;
+  keys(): AsyncIterableIterator<string>;
+  values(): AsyncIterableIterator<FileSystemHandle>;
+}

package/libs/webworker/importscripts/index.d.ts

@@ -0,0 +1,7 @@
+/// <reference no-default-lib="true"/>
+
+/////////////////////////////
+/// WorkerGlobalScope APIs
+/////////////////////////////
+// These are only available in a Web Worker
+declare function importScripts(...urls: readonly string[]): void;