@league-of-foundry-developers/foundry-vtt-types 13.340.1 → 13.345.1-beta.20250704.94554

package/src/foundry/client/core/settings.d.mts

@@ -1,386 +0,0 @@
-import type { AnyArray, AnyObject, InexactPartial, FixedInstanceType } from "fvtt-types/utils";
-import type ApplicationV2 from "#client-esm/applications/api/application.d.mts";
-import type { CustomFormInput } from "#client-esm/applications/forms/fields.d.mts";
-import type DataModel from "#common/abstract/data.d.mts";
-import type { DataField } from "#common/data/fields.d.mts";
-
-declare global {
-  /**
-   * A class responsible for managing defined game settings or settings menus.
-   * Each setting is a string key/value pair belonging to a certain package and a certain store scope.
-   *
-   * When Foundry Virtual Tabletop is initialized, a singleton instance of this class is constructed within the global
-   * Game object as as game.settings.
-   *
-   * @see {@link Game.settings | `Game#settings`}
-   * @see {@link Settings | `Settings`}
-   * @see {@link SettingsConfig | `SettingsConfig`}
-   */
-  class ClientSettings {
-    constructor(worldSettings?: Setting.Implementation["_source"][]);
-
-    /**
-     * A object of registered game settings for this scope
-     */
-    settings: Map<keyof globalThis.SettingConfig & (string & {}), ClientSettings.SettingConfig>;
-
-    /**
-     * Registered settings menus which trigger secondary applications
-     */
-    menus: Map<string, ClientSettings.SettingSubmenuConfig>;
-
-    /**
-     * The storage interfaces used for persisting settings
-     * Each storage interface shares the same API as window.localStorage
-     * @remarks This is a lie, it doesn't actually have the same interface...
-     */
-    storage: Map<string, Storage | WorldSettings>;
-
-    /**
-     * Return a singleton instance of the Game Settings Configuration app
-     */
-    get sheet(): SettingsConfig;
-
-    /**
-     * Register a new game setting under this setting scope
-     *
-     * @param namespace - The namespace under which the setting is registered
-     * @param key       - The key name for the setting under the namespace
-     * @param data      - Configuration for setting data
-     *
-     * @example Register a client setting
-     * ```js
-     * game.settings.register("myModule", "myClientSetting", {
-     *   name: "Register a Module Setting with Choices",
-     *   hint: "A description of the registered setting and its behavior.",
-     *   scope: "client",     // This specifies a client-stored setting
-     *   config: true,        // This specifies that the setting appears in the configuration view
-     *   requiresReload: true // This will prompt the user to reload the application for the setting to take effect.
-     *   type: String,
-     *   choices: {           // If choices are defined, the resulting setting will be a select menu
-     *     "a": "Option A",
-     *     "b": "Option B"
-     *   },
-     *   default: "a",        // The default value for the setting
-     *   onChange: value => { // A callback function which triggers when the setting is changed
-     *     console.log(value)
-     *   }
-     * });
-     * ```
-     *
-     * @example Register a world setting
-     * ```js
-     * game.settings.register("myModule", "myWorldSetting", {
-     *   name: "Register a Module Setting with a Range slider",
-     *   hint: "A description of the registered setting and its behavior.",
-     *   scope: "world",      // This specifies a world-level setting
-     *   config: true,        // This specifies that the setting appears in the configuration view
-     *   requiresReload: true // This will prompt the GM to have all clients reload the application for the setting to
-     *                        // take effect.
-     *   type: new foundry.fields.NumberField({nullable: false, min: 0, max: 100, step: 10}),
-     *   default: 50,         // The default value for the setting
-     *   onChange: value => { // A callback function which triggers when the setting is changed
-     *     console.log(value)
-     *   }
-     * });
-     * ```
-     */
-    register<
-      T extends ClientSettings.Type,
-      N extends ClientSettings.Namespace = ClientSettings.Namespace,
-      K extends ClientSettings.KeyFor<N> = ClientSettings.KeyFor<N>,
-    >(
-      namespace: N,
-      key: K,
-      data: ClientSettings.Type extends T
-        ? ClientSettings.RegisterOptions<globalThis.SettingConfig[`${N}.${K}` & keyof SettingConfig]>
-        : ClientSettings.RegisterOptions<NoInfer<T>>,
-    ): void;
-
-    /**
-     * Register a new sub-settings menu
-     *
-     * @param namespace - The namespace under which the menu is registered
-     * @param key       - The key name for the setting under the namespace module
-     * @param data      - Configuration for setting data
-     * @typeParam N     - The namespace under which the menu is registered, as a type
-     * @typeParam K     - The key name for the setting under the namespace module, as a type
-     *
-     * @example Define a settings submenu which handles advanced configuration needs
-     * ```typescript
-     * game.settings.registerMenu("myModule", "mySettingsMenu", {
-     *   name: "My Settings Submenu",
-     *   label: "Settings Menu Label",      // The text label used in the button
-     *   hint: "A description of what will occur in the submenu dialog.",
-     *   icon: "fas fa-bars",               // A Font Awesome icon used in the submenu button
-     *   type: MySubmenuApplicationClass,   // A FormApplication subclass which should be created
-     *   restricted: true                   // Restrict this submenu to gamemaster only?
-     * });
-     * ```
-     */
-    registerMenu<N extends string, K extends string>(namespace: N, key: K, data: ClientSettings.RegisterSubmenu): void;
-
-    /**
-     * Get the value of a game setting for a certain namespace and setting key
-     *
-     * @param namespace - The namespace under which the setting is registered
-     * @param key       - The setting key to retrieve
-     * @typeParam N     - The namespace under which the setting is registered, as a type
-     * @typeParam K     - The setting key to retrieve, as a type
-     *
-     * @example Retrieve the current setting value
-     * ```typescript
-     * game.settings.get("myModule", "myClientSetting");
-     * ```
-     */
-    get<N extends ClientSettings.Namespace, K extends ClientSettings.KeyFor<N>>(
-      namespace: N,
-      key: K,
-    ): ClientSettings.SettingInitializedType<N, K>;
-
-    /**
-     * Set the value of a game setting for a certain namespace and setting key
-     *
-     * @param namespace - The namespace under which the setting is registered
-     * @param key       - The setting key to retrieve
-     * @param value     - The data to assign to the setting key
-     * @param options   - Additional options passed to the server when updating world-scope settings
-     * @typeParam N     - The namespace under which the setting is registered, as a type
-     * @typeParam K     - The setting key to retrieve, as a type
-     * @typeParam V     - The type of the value being set
-     * @returns         - The assigned setting value
-     *
-     * @example
-     * ```typescript
-     * // Update the current value of a setting
-     * game.settings.set("myModule", "myClientSetting", "b");
-     * ```
-     */
-    set<N extends ClientSettings.Namespace, K extends ClientSettings.KeyFor<N>>(
-      namespace: N,
-      key: K,
-      value: ClientSettings.SettingAssignmentType<N, K>,
-      options?: Setting.Database.CreateOperation<undefined | false> | Setting.Database.UpdateOperation,
-    ): Promise<ClientSettings.SettingInitializedType<N, K>>;
-  }
-
-  namespace ClientSettings {
-    type Namespace = GetNamespaces<keyof globalThis.SettingConfig>;
-    type KeyFor<N extends Namespace> = GetKeys<N, keyof globalThis.SettingConfig>;
-
-    /**
-     * A compile type is a type for a setting that only exists at compile time.
-     * For example `string` does not correspond to a real runtime value like `String` does.
-     */
-    type TypeScriptType = string | number | boolean | symbol | bigint | AnyArray | AnyObject;
-
-    // The type `typeof DataModel<any, any>` is used because Foundry actually constructs with its regular constructor parameters in this case.
-    type RuntimeType = DataField.Any | typeof DataModel<any, any> | SettingFunction | SettingConstructor;
-
-    type Type = TypeScriptType | RuntimeType;
-
-    type ToRuntimeType<T extends Type> =
-      | (T extends RuntimeType ? T : never)
-      | (T extends string ? typeof String : never)
-      | (T extends number ? typeof Number : never)
-      | (T extends boolean ? typeof Boolean : never)
-      | (T extends symbol ? typeof Symbol : never)
-      | (T extends bigint ? typeof BigInt : never)
-      | (T extends readonly (infer V)[] ? typeof Array<V> : never)
-      | (T extends AnyObject ? typeof Object : never);
-
-    type SettingAssignmentType<N extends Namespace, K extends KeyFor<N>> = ToSettingAssignmentType<
-      ConfiguredType<N, K>
-    >;
-    type ToSettingAssignmentType<T extends Type> = ReplaceUndefinedWithNull<
-      | SettingType<T>
-      // TODO(LukeAbby): The `fromSource` function is called with `strict` which changes how fallback behaviour works. See `ClientSettings#set`
-      // Note(LukeAbby): This doesn't use `InstanceType` because of this TypeScript issue: https://github.com/microsoft/TypeScript/issues/60839
-      | (T extends (abstract new (...args: infer _1) => infer Instance extends DataModel.Any)
-          ? DataModel.ConstructorDataFor<Instance>
-          : never)
-    >;
-
-    type SettingInitializedType<N extends Namespace, K extends KeyFor<N>> = ToSettingInitializedType<
-      ConfiguredType<N, K>
-    >;
-    type ToSettingInitializedType<T extends Type> = ReplaceUndefinedWithNull<
-      SettingType<T> | (T extends DataModel.Any ? T : never)
-    >;
-
-    /**
-     * @internal
-     */
-    interface _SettingConfig<RuntimeType extends ClientSettings.RuntimeType, AssignmentType> {
-      /** A unique machine-readable id for the setting */
-      key: string;
-
-      /** The namespace the setting belongs to */
-      namespace: string;
-
-      /** The human readable name */
-      name?: string | undefined;
-
-      /** An additional human readable hint */
-      hint?: string | undefined;
-
-      /**
-       * The scope the Setting is stored in, either World or Client
-       * @defaultValue `"client"`
-       */
-      scope: "world" | "client";
-
-      /** Indicates if this Setting should render in the Config application */
-      config?: boolean | undefined;
-
-      /** The JS Type that the Setting is storing */
-      type?: RuntimeType;
-
-      /** For string Types, defines the allowable values */
-      choices?: AssignmentType extends string
-        ? {
-            readonly [K in AssignmentType]?: string;
-          }
-        : never;
-
-      /** For numeric Types, defines the allowable range */
-      range?: AssignmentType extends number
-        ? {
-            max: number;
-            min: number;
-            step: number;
-          }
-        : never;
-
-      /** The default value */
-      default: AssignmentType;
-
-      /** Whether setting requires Foundry to be reloaded on change  */
-      requiresReload?: boolean;
-
-      /** Executes when the value of this Setting changes */
-      onChange?: (value: AssignmentType) => void;
-
-      /**
-       * A custom form field input used in conjunction with a DataField type
-       */
-      input?: CustomFormInput | undefined;
-    }
-
-    /**
-     * A Client Setting
-     * @remarks Copied from `resources/app/common/types.mjs`
-     * @remarks Not to be confused with {@link globalThis.SettingConfig | `globalThis.SettingConfig`} which is how you register setting types in this project
-     */
-    interface SettingConfig<T extends Type = (value: unknown) => unknown>
-      extends _SettingConfig<ToRuntimeType<T>, ToSettingAssignmentType<T>> {}
-
-    interface RegisterOptions<T extends Type> extends InexactPartial<Omit<SettingConfig<T>, "key" | "namespace">> {}
-
-    /**
-     * A Client Setting Submenu
-     * @remarks Copied from `resources/app/common/types.mjs`
-     */
-    interface SettingSubmenuConfig {
-      key: string;
-
-      namespace: string;
-
-      /** The human-readable name */
-      name?: string | undefined;
-
-      /** An additional human-readable hint */
-      label?: string | undefined;
-
-      /** An additional human readable hint */
-      hint?: string | undefined;
-
-      /** The classname of an Icon to render */
-      icon?: string | undefined;
-
-      /** The FormApplication or ApplicationV2 to render */
-      // In SettingsConfig#_onClickSubmenu this type is constructed and not given any options.
-      type: (new () => FormApplication.Any) | (new () => ApplicationV2.Any);
-
-      /** If true, only a GM can edit this Setting */
-      restricted?: boolean | undefined;
-    }
-
-    interface RegisterSubmenu {
-      /** The human readable name */
-      name: string;
-
-      /** The human readable label */
-      label: string;
-
-      /** An additional human readable hint */
-      hint: string;
-
-      /** The classname of an Icon to render */
-      icon: string;
-
-      /**
-       * The FormApplication class to render
-       *
-       * @privateRemarks The phrase "TODO better typing" in the original documentation was stripped.
-       */
-      type: (new () => FormApplication.Any) | (new () => ApplicationV2.Any);
-
-      /** If true, only a GM can edit this Setting */
-      restricted: boolean;
-    }
-  }
-}
-
-type SettingFunction = (value: never) => unknown;
-type SettingConstructor = new (value: never) => unknown;
-
-// Matches what's in `Setting#PRIMITIVE_TYPES`.
-// Foundry itself uses this nomenclature despite the fact that it's a misnomer.
-type PRIMITIVE_TYPES = readonly [
-  typeof String,
-  typeof Number,
-  typeof Boolean,
-  typeof Array,
-  typeof Symbol,
-  typeof BigInt,
-];
-
-// A type can be both a constructor and a function at once.
-// Foundry prioritizes the constructor over the function unless it's in `Setting#PRIMITIVE_TYPES`.
-type ConstructorToSettingType<T extends SettingConstructor> = T extends PRIMITIVE_TYPES[number]
-  ? PrimitiveConstructorToSettingType<T>
-  : FixedInstanceType<T>;
-
-// In theory this is just the `ReturnType<T>`.
-// However the function end of `Array` returns `any[]` while `Object` returns `any`.
-// To increase safety they're special cased here.
-type PrimitiveConstructorToSettingType<T extends PRIMITIVE_TYPES[number]> = T extends typeof Array
-  ? AnyArray
-  : T extends typeof Object
-    ? AnyObject
-    : ReturnType<T>;
-
-// The `& keyof SettingConfig` is necessary because otherwise the fact that `K` depends on `N`
-// will confuse TypeScript and make it think that `${N}.${K}` can be invalid keys like
-// "core.moduleSetting" but in reality that would be disallowed by the dependent constraint of `K`.
-type ConfiguredType<
-  N extends ClientSettings.Namespace,
-  K extends ClientSettings.KeyFor<N>,
-> = globalThis.SettingConfig[`${N}.${K}` & keyof SettingConfig];
-
-type SettingType<T extends ClientSettings.Type> =
-  // Note(LukeAbby): This isn't written as `T extends ClientSettings.TypeScriptType ? T : never` because then types like `DataField.Any` would be matched.
-  | (T extends ClientSettings.RuntimeType ? never : T)
-  // TODO(LukeAbby): The `validate` function is called with `strict` which changes how fallback behavior works. See `ClientSettings#set`
-  // eslint-disable-next-line @typescript-eslint/no-deprecated
-  | (T extends DataField.Any ? DataField.AssignmentTypeFor<T> : never)
-  | (T extends SettingConstructor ? ConstructorToSettingType<T> : T extends SettingFunction ? ReturnType<T> : never);
-
-// TODO(LukeAbby): The exact semantics for when `undefined` is replaced with `null` are unclear.
-type ReplaceUndefinedWithNull<T> = T extends undefined ? null : T;
-
-type GetNamespaces<SettingPath extends PropertyKey> = SettingPath extends `${infer Scope}.${string}` ? Scope : never;
-type GetKeys<N extends string, SettingPath extends PropertyKey> = SettingPath extends `${N}.${infer Name}`
-  ? Name
-  : never;

package/src/foundry/client/core/socket.d.mts

@@ -1,62 +0,0 @@
-import type { AnyObject } from "fvtt-types/utils";
-import type { DatabaseOperationMap, DocumentSocketRequest } from "#common/abstract/_types.d.mts";
-
-declare global {
-  class SocketInterface {
-    /**
-     * Standardize the way that socket messages are dispatched and their results are handled
-     * @param eventName - The socket event name being handled
-     * @param request   - Request data provided to the Socket event
-     * @returns A Promise which resolves to the SocketResponse
-     */
-    static dispatch<DatabaseAction extends keyof DatabaseOperationMap>(
-      eventName: string,
-      request: DocumentSocketRequest<DatabaseAction> | CompendiumCollection.ManageCompendiumRequest,
-    ): Promise<SocketInterface.SocketResponse>;
-  }
-
-  namespace SocketInterface {
-    /** @remarks Copied from `resources/app/common/types.mjs` */
-    type RequestData = AnyObject | AnyObject[] | string | readonly string[];
-
-    /** @remarks Copied from `resources/app/common/types.mjs` */
-    interface SocketRequest {
-      /** Additional options applied to the request */
-      options?: AnyObject | undefined;
-      broadcast?: boolean | undefined;
-    }
-
-    /** @remarks Copied from `resources/app/common/types.mjs` */
-    interface SocketResponse {
-      /**
-       * The initial request
-       */
-      request: SocketRequest;
-
-      /**
-       * An error, if one occurred
-       */
-      error?: Error | undefined;
-
-      /**
-       * The status of the request
-       */
-      status?: string | undefined;
-
-      /**
-       * The ID of the requesting User
-       */
-      userId?: string | undefined;
-
-      /**
-       * Data returned as a result of the request
-       */
-      data?: RequestData | undefined;
-
-      /**
-       * An Array of created data objects
-       */
-      result?: AnyObject[] | readonly string[] | undefined;
-    }
-  }
-}

package/src/foundry/client/core/sorting.d.mts

@@ -1,76 +0,0 @@
-export {};
-
-declare global {
-  /**
-   * A collection of functions related to sorting objects within a parent container.
-   */
-  class SortingHelpers {
-    /**
-     * Given a source object to sort, a target to sort relative to, and an Array of siblings in the container:
-     * Determine the updated sort keys for the source object, or all siblings if a reindex is required.
-     * Return an Array of updates to perform, it is up to the caller to dispatch these updates.
-     * Each update is structured as:
-     * ```typescript
-     * {
-     *   target: object,
-     *   update: {sortKey: sortValue}
-     * }
-     * ```
-     *
-     * @param source  - source object being sorted
-     * @param options - Options which modify the sort behavior
-     * @typeParam T   - the type of the source and target object
-     *
-     * @returns An Array of updates for the caller of the helper function to perform
-     */
-    static performIntegerSort<T, SortKey extends string = "sort">(
-      source: T,
-      options?: SortingHelpers.SortOptions<T, SortKey>,
-    ): Array<{
-      target: T;
-      update: {
-        [Key in SortKey]: number;
-      };
-    }>;
-
-    /**
-     * Given an ordered Array of siblings and a target position, return the [min,max] indices to sort before the target
-     */
-    protected static _sortBefore<T>(siblings: T[], idx: number, sortKey: string): [T, T];
-
-    /**
-     * Given an ordered Array of siblings and a target position, return the [min,max] indices to sort after the target
-     */
-    protected static _sortAfter<T>(siblings: T[], idx: number, sortKey: string): [T, T];
-  }
-
-  namespace SortingHelpers {
-    interface SortOptions<T, SortKey extends string = "sort"> {
-      /**
-       * The target object relative which to sort
-       * @defaultValue `null`
-       */
-      target?: T | null | undefined;
-
-      /**
-       * The sorted Array of siblings which share the same sorted container
-       * @defaultValue `[]`
-       */
-      siblings?: T[] | undefined;
-
-      /**
-       * The name of the data property within the source object which defines the sort key
-       * @defaultValue `"sort"`
-       */
-      sortKey?: SortKey | undefined;
-
-      /**
-       * Whether to explicitly sort before (true) or sort after (false). If nothing is passed
-       * the sort order will be automatically determined, preferring before.
-       *
-       * @defaultValue `true`
-       */
-      sortBefore?: boolean | undefined;
-    }
-  }
-}

package/src/foundry/client/core/time.d.mts

@@ -1,76 +0,0 @@
-export {};
-
-declare global {
-  /**
-   * A singleton class {@link game.time | `game#time`} which keeps the official Server and World time stamps.
-   * Uses a basic implementation of https://www.geeksforgeeks.org/cristians-algorithm/ for synchronization.
-   */
-  class GameTime {
-    constructor(socket?: io.Socket | null);
-
-    /**
-     * The most recently synchronized timestamps retrieved from the server.
-     * @defaultValue `{}`
-     */
-    protected _time: GameTime.Timestamps;
-
-    /**
-     * The average one-way latency across the most recent 5 trips
-     * @defaultValue `0`
-     */
-    protected _dt: number;
-
-    /**
-     * The most recent five synchronization durations
-     * @defaultValue `[]`
-     */
-    protected _dts: number[];
-
-    /**
-     * The amount of time to delay before re-syncing the official server time.
-     * @defaultValue `1000 * 60 * 5`
-     */
-    static SYNC_INTERVAL_MS: number;
-
-    /**
-     * The current server time based on the last synchronization point and the approximated one-way latency.
-     */
-    get serverTime(): number;
-
-    /**
-     * The current World time based on the last recorded value of the core.time setting
-     */
-    get worldTime(): number;
-
-    /**
-     * Advance the game time by a certain number of seconds
-     * @param seconds - The number of seconds to advance (or rewind if negative) by
-     * @param options - Additional options passed to game.settings.set
-     * @returns The new game time
-     */
-    advance(
-      seconds: number,
-      options?: Setting.Database.CreateOperation<false | undefined> | Setting.Database.UpdateOperation,
-    ): Promise<number>;
-
-    /**
-     * Synchronize the local client game time with the official time kept by the server
-     * @param socket - The connected server Socket instance
-     */
-    sync(socket?: io.Socket | null): Promise<this>;
-
-    /**
-     * Handle follow-up actions when the official World time is changed
-     * @param worldTime - The new canonical World time.
-     */
-    onUpdateWorldTime(worldTime: number): void;
-  }
-
-  namespace GameTime {
-    interface Timestamps {
-      clientTime: number;
-      serverTime: number;
-      worldTime: number;
-    }
-  }
-}