@league-of-foundry-developers/foundry-vtt-types 12.331.3-beta → 12.331.5

package/src/foundry/client/apps/hud/menu.d.mts

@@ -1,4 +1,4 @@
-import type { MaybePromise } from "../../../../types/utils.d.mts";
+import type { MaybePromise, Identity } from "#utils";
 
 declare global {
   /**
@@ -15,7 +15,7 @@ declare global {
      * });
      * ```
      * */
-    static override get defaultOptions(): ApplicationOptions;
+    static override get defaultOptions(): Application.Options;
 
     /**
      * The structure of menu items
@@ -54,7 +54,7 @@ declare global {
      */
     get items(): MainMenu.MenuStructure;
 
-    override getData(options?: Partial<ApplicationOptions>): MaybePromise<object>;
+    override getData(options?: Partial<Application.Options>): MaybePromise<object>;
 
     override activateListeners(html: JQuery): void;
 
@@ -65,6 +65,9 @@ declare global {
   }
 
   namespace MainMenu {
+    interface Any extends AnyMainMenu {}
+    interface AnyConstructor extends Identity<typeof AnyMainMenu> {}
+
     interface MenuItem {
       label: string;
       icon: string;
@@ -75,3 +78,7 @@ declare global {
     type MenuStructure = Record<string, MenuItem>;
   }
 }
+
+declare abstract class AnyMainMenu extends MainMenu {
+  constructor(...args: never);
+}

package/src/foundry/client/apps/hud/navigation.d.mts

@@ -1,4 +1,4 @@
-import type { GetDataReturnType, MaybePromise } from "../../../../types/utils.d.mts";
+import type { GetDataReturnType, MaybePromise, Identity } from "#utils";
 
 declare global {
   /**
@@ -6,7 +6,7 @@ declare global {
    *
    * @typeParam Options - the type of the options object
    */
-  class SceneNavigation<Options extends ApplicationOptions = ApplicationOptions> extends Application<Options> {
+  class SceneNavigation<Options extends Application.Options = Application.Options> extends Application<Options> {
     constructor(options?: Partial<Options>);
 
     /**
@@ -26,19 +26,19 @@ declare global {
      * })
      * ```
      */
-    static override get defaultOptions(): ApplicationOptions;
+    static override get defaultOptions(): Application.Options;
 
     /**
      * Return an Array of Scenes which are displayed in the Navigation bar
      */
-    get scenes(): Scene.ConfiguredInstance[];
+    get scenes(): Scene.Implementation[];
 
-    override render(force?: boolean, context?: Application.RenderOptions<Options>): this | void;
+    override render(force?: boolean, context?: Application.RenderOptions<Options>): this;
 
     protected override _render(force?: boolean, options?: Application.RenderOptions<Options>): Promise<void>;
 
     override getData(
-      options?: Partial<ApplicationOptions>,
+      options?: Partial<Application.Options>,
     ): MaybePromise<GetDataReturnType<SceneNavigation.SceneNavigationData>>;
 
     /**
@@ -58,7 +58,7 @@ declare global {
      * @returns The Array of context options passed to the ContextMenu instance
      * @internal
      */
-    protected _getContextMenuOptions(): ContextMenuEntry[];
+    protected _getContextMenuOptions(): ContextMenu.Entry[];
 
     /**
      * Handle left-click events on the scenes in the navigation menu
@@ -84,14 +84,15 @@ declare global {
   }
 
   namespace SceneNavigation {
-    type Any = SceneNavigation<any>;
+    interface Any extends AnySceneNavigation {}
+    interface AnyConstructor extends Identity<typeof AnySceneNavigation> {}
 
     interface SceneData {
       id: string;
       active: boolean;
       name: string;
       tooltip: string | null;
-      users: { letter: string; color: User["color"] }[];
+      users: { letter: string; color: User.Implementation["color"] }[];
       visible: boolean;
       css: string;
     }
@@ -114,3 +115,7 @@ declare global {
     }
   }
 }
+
+declare abstract class AnySceneNavigation extends SceneNavigation<Application.Options> {
+  constructor(...args: never);
+}

package/src/foundry/client/apps/hud/pause.d.mts

@@ -1,4 +1,4 @@
-import type { GetDataReturnType, MaybePromise } from "../../../../types/utils.d.mts";
+import type { GetDataReturnType, MaybePromise, Identity } from "#utils";
 
 declare global {
   /**
@@ -6,7 +6,7 @@ declare global {
    *
    * @typeParam Options - the type of the options object
    */
-  class Pause<Options extends ApplicationOptions = ApplicationOptions> extends Application<Options> {
+  class Pause<Options extends Application.Options = Application.Options> extends Application<Options> {
     /**
      * @defaultValue
      * ```ts
@@ -17,16 +17,21 @@ declare global {
      * return options;
      * ```
      */
-    static get defaultOptions(): ApplicationOptions;
+    static get defaultOptions(): Application.Options;
 
     override getData(options?: Partial<Options>): MaybePromise<GetDataReturnType<Pause.PauseData>>;
   }
 
   namespace Pause {
-    type Any = Pause<any>;
+    interface Any extends AnyPause {}
+    interface AnyConstructor extends Identity<typeof AnyPause> {}
 
     interface PauseData {
       paused: boolean;
     }
   }
 }
+
+declare abstract class AnyPause extends Pause<Application.Options> {
+  constructor(...args: never);
+}

package/src/foundry/client/apps/hud/players.d.mts

@@ -1,4 +1,4 @@
-import type { GetDataReturnType, MaybePromise } from "../../../../types/utils.d.mts";
+import type { GetDataReturnType, MaybePromise, Identity } from "#utils";
 
 declare global {
   /**
@@ -6,7 +6,7 @@ declare global {
    *
    * @typeParam Options - the type of the options object
    */
-  class PlayerList<Options extends ApplicationOptions = ApplicationOptions> extends Application<Options> {
+  class PlayerList<Options extends Application.Options = Application.Options> extends Application<Options> {
     constructor(options?: Partial<Options>);
 
     /**
@@ -25,7 +25,7 @@ declare global {
      * })
      * ```
      */
-    static get defaultOptions(): ApplicationOptions;
+    static get defaultOptions(): Application.Options;
 
     /**
      * Whether the players list is in a configuration where it is hidden
@@ -39,7 +39,7 @@ declare global {
     /**
      * Prepare a displayed name string for the User which includes their name, pronouns, character, or GM tag.
      */
-    protected _getDisplayName(user: User): string;
+    protected _getDisplayName(user: User.Implementation): string;
 
     /**
      * Position this Application in the main DOM appropriately.
@@ -51,7 +51,7 @@ declare global {
     /**
      * Return the default context options available for the Players application
      */
-    protected _getUserContextOptions(): ContextMenuEntry[];
+    protected _getUserContextOptions(): ContextMenu.Entry[];
 
     /**
      * Toggle display of the Players hud setting for whether or not to display offline players
@@ -61,12 +61,13 @@ declare global {
   }
 
   namespace PlayerList {
-    type Any = PlayerList<any>;
+    interface Any extends AnyPlayerList {}
+    interface AnyConstructor extends Identity<typeof AnyPlayerList> {}
 
     interface UserData {
-      active: User["active"];
-      isGM: User["isGM"];
-      isSelf: User["isSelf"];
+      active: User.Implementation["active"];
+      isGM: User.Implementation["isGM"];
+      isSelf: User.Implementation["isSelf"];
       charname: string;
       color: string;
       border: string;
@@ -80,3 +81,7 @@ declare global {
     }
   }
 }
+
+declare abstract class AnyPlayerList extends PlayerList<Application.Options> {
+  constructor(...args: never);
+}

package/src/foundry/client/apps/i18n.d.mts

@@ -1,4 +1,4 @@
-import type { InexactPartial } from "../../../types/utils.d.mts";
+export {};
 
 declare global {
   /**
@@ -86,18 +86,7 @@ declare global {
      */
     static localizeDataModel(
       model: foundry.abstract.DataModel.AnyConstructor,
-      options?: InexactPartial<{
-        /**
-         * An array of localization key prefixes to use. If not specified, prefixes
-         * are learned from the DataModel.LOCALIZATION_PREFIXES static property.
-         */
-        prefixes: string[];
-
-        /**
-         * A localization path prefix used to prefix all field names within this model. This is generally not required.
-         */
-        prefixPath: string;
-      }>,
+      options?: Localization.LocalizeDataModelOptions,
     ): void;
 
     /**
@@ -190,26 +179,16 @@ declare global {
 
     /**
      * Retreive list formatter configured to the world's language setting.
-     * @see [Intl.ListFormat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/ListFormat/ListFormat)
-     */
-    getListFormatter(
-      options?: InexactPartial<{
-        /**
-         * The list formatter style, either "long", "short", or "narrow".
-         */
-        style: Intl.ListFormatStyle;
-        /**
-         * The list formatter type, either "conjunction", "disjunction", or "unit".
-         */
-        type: Intl.ListFormatType;
-      }>,
-    ): Intl.ListFormat;
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/ListFormat/ListFormat | Intl.ListFormat}
+     */
+    getListFormatter(options?: Localization.GetListFormatterOptions): Intl.ListFormat;
 
     /**
      * Sort an array of objects by a given key in a localization-aware manner.
      * @param objects - The objects to sort, this array will be mutated
      * @param key     - The key to sort the objects by. This can be provided in dot-notation.
      */
+    // TODO(LukeAbby): Should be constrainted to dot property keys of `objects`
     sortObjects<T extends object>(objects: Array<T>, key: string): T[];
   }
 
@@ -217,5 +196,30 @@ declare global {
     interface Translations {
       [K: string]: string | Translations;
     }
+
+    interface LocalizeDataModelOptions {
+      /**
+       * An array of localization key prefixes to use. If not specified, prefixes
+       * are learned from the DataModel.LOCALIZATION_PREFIXES static property.
+       */
+      prefixes?: string[] | undefined;
+
+      /**
+       * A localization path prefix used to prefix all field names within this model. This is generally not required.
+       */
+      prefixPath?: string | undefined;
+    }
+
+    interface GetListFormatterOptions {
+      /**
+       * The list formatter style, either "long", "short", or "narrow".
+       */
+      style?: Intl.ListFormatStyle | undefined;
+
+      /**
+       * The list formatter type, either "conjunction", "disjunction", or "unit".
+       */
+      type?: Intl.ListFormatType | undefined;
+    }
   }
 }

package/src/foundry/client/apps/index.d.mts

@@ -8,3 +8,4 @@ import "./i18n.d.mts";
 import "./placeables/index.d.mts";
 import "./sidebar/index.d.mts";
 import "./templates.d.mts";
+import "./dice/index.d.mts";

package/src/foundry/client/apps/placeables/drawing-config.d.mts

@@ -1,21 +1,16 @@
-import type { MaybePromise } from "../../../../types/utils.d.mts";
+import type { MaybePromise } from "#utils";
 
 declare global {
-  interface DrawingConfigOptions extends FormApplicationOptions {
-    /**
-     * Configure the default drawing settings, instead of a specific Drawing
-     * @defaultValue `false`
-     */
-    configureDefault: boolean;
-  }
+  /** @deprecated {@link DrawingConfig.Options | `DrawingConfig.Options`} */
+  type DrawingConfigOptions = DrawingConfig.Options;
 
   /**
    * The Application responsible for configuring a single Drawing document within a parent Scene.
    * @typeParam Options - the type of the options object
    */
-  class DrawingConfig<Options extends DrawingConfigOptions = DrawingConfigOptions> extends FormApplication<
+  class DrawingConfig<Options extends DrawingConfig.Options = DrawingConfig.Options> extends FormApplication<
     Options,
-    DrawingDocument.ConfiguredInstance
+    DrawingDocument.Implementation
   > {
     /**
      * @defaultValue
@@ -30,7 +25,7 @@ declare global {
      * });
      * ```
      */
-    static override get defaultOptions(): DrawingConfigOptions;
+    static override get defaultOptions(): DrawingConfig.Options;
 
     override get title(): string;
 
@@ -52,29 +47,42 @@ declare global {
   }
 
   namespace DrawingConfig {
-    type Any = DrawingConfig<any>;
+    interface Any extends DrawingConfig<any> {}
+
+    interface Options extends FormApplication.Options {
+      /**
+       * Configure the default drawing settings, instead of a specific Drawing
+       * @defaultValue `false`
+       */
+      configureDefault: boolean;
+    }
 
-    interface FormData {
-      author: string;
-      bezierFactor: DrawingDocument["bezierFactor"];
-      fillAlpha: DrawingDocument["fillAlpha"];
-      fillColor: DrawingDocument["fillColor"];
-      fillType: DrawingDocument["fillType"];
-      fontFamily: DrawingDocument["fontFamily"];
-      fontSize: DrawingDocument["fontSize"];
-      "shape.height": DrawingDocument["shape"]["height"];
-      rotation: DrawingDocument["rotation"];
-      strokeAlpha: DrawingDocument["strokeAlpha"];
-      strokeColor: DrawingDocument["strokeColor"];
-      strokeWidth: DrawingDocument["strokeWidth"];
-      text: DrawingDocument["text"];
-      textAlpha: DrawingDocument["textAlpha"];
-      textColor: DrawingDocument["textColor"];
-      texture: DrawingDocument["texture"];
-      "shape.width": DrawingDocument["shape"]["width"];
-      x: DrawingDocument["x"];
-      y: DrawingDocument["y"];
-      z: DrawingDocument["z"];
+    /** @internal */
+    type _FormData = Pick<
+      DrawingDocument.Implementation,
+      | "author"
+      | "bezierFactor"
+      | "elevation"
+      | "fillAlpha"
+      | "fillColor"
+      | "fillType"
+      | "fontFamily"
+      | "fontSize"
+      | "rotation"
+      | "sort"
+      | "strokeAlpha"
+      | "strokeColor"
+      | "strokeWidth"
+      | "text"
+      | "textAlpha"
+      | "textColor"
+      | "texture"
+      | "x"
+      | "y"
+    >;
+    interface FormData extends _FormData {
+      "shape.height": DrawingDocument.Implementation["shape"]["height"];
+      "shape.width": DrawingDocument.Implementation["shape"]["width"];
     }
   }
 }

package/src/foundry/client/apps/placeables/drawing-hud.d.mts

@@ -1,12 +1,12 @@
-import type { MaybePromise } from "../../../../types/utils.d.mts";
+import type { MaybePromise } from "#utils";
 
 declare global {
   /**
    * An implementation of the PlaceableHUD base class which renders a heads-up-display interface for Drawing objects.
    * @typeParam Options - the type of the options object
    */
-  class DrawingHUD<Options extends ApplicationOptions = ApplicationOptions> extends BasePlaceableHUD<
-    Drawing.ConfiguredInstance,
+  class DrawingHUD<Options extends Application.Options = Application.Options> extends BasePlaceableHUD<
+    Drawing.Object,
     Options
   > {
     /**
@@ -18,7 +18,7 @@ declare global {
      * })
      * ```
      */
-    static override get defaultOptions(): ApplicationOptions;
+    static override get defaultOptions(): Application.Options;
 
     override getData(options?: Partial<Options>): MaybePromise<object>; // TODO: Implement GetDataReturnType
 
@@ -26,6 +26,6 @@ declare global {
   }
 
   namespace DrawingHUD {
-    type Any = DrawingHUD<any>;
+    interface Any extends DrawingHUD<any> {}
   }
 }

package/src/foundry/client/apps/placeables/index.d.mts

@@ -1,8 +1,6 @@
 import "./drawing-config.d.mts";
 import "./drawing-hud.d.mts";
-import "./light-config.d.mts";
 import "./note-config.d.mts";
-import "./sound-config.d.mts";
 import "./tile-config.d.mts";
 import "./tile-hud.d.mts";
 import "./token-config.d.mts";

package/src/foundry/client/apps/placeables/note-config.d.mts

@@ -1,4 +1,4 @@
-import type { MaybePromise } from "../../../../types/utils.d.mts";
+import type { MaybePromise } from "#utils";
 
 declare global {
   /**
@@ -7,8 +7,8 @@ declare global {
    */
   class NoteConfig<
     Options extends
-      DocumentSheetOptions<NoteDocument.ConfiguredInstance> = DocumentSheetOptions<NoteDocument.ConfiguredInstance>,
-  > extends DocumentSheet<Options, NoteDocument.ConfiguredInstance> {
+      DocumentSheet.Options<NoteDocument.Implementation> = DocumentSheet.Options<NoteDocument.Implementation>,
+  > extends DocumentSheet<Options, NoteDocument.Implementation> {
     /**
      * @defaultValue
      * ```typescript
@@ -19,7 +19,7 @@ declare global {
      * })
      * ```
      */
-    static override get defaultOptions(): DocumentSheetOptions<NoteDocument>;
+    static override get defaultOptions(): DocumentSheet.Options<NoteDocument.Implementation>;
 
     override getData(options?: Partial<Options>): MaybePromise<object>; // TODO: Implement GetDataReturnType
 
@@ -45,21 +45,31 @@ declare global {
   }
 
   namespace NoteConfig {
-    type Any = NoteConfig<any>;
+    interface Any extends NoteConfig<any> {}
 
-    interface FormData {
-      entryId: NoteDocument["entryId"];
-      fontFamily: NoteDocument["fontFamily"];
-      fontSize: NoteDocument["fontSize"];
-      "icon.selected": NoteDocument["texture"]["src"];
-      "icon.custom": NoteDocument["texture"]["src"] | "";
-      iconSize: NoteDocument["iconSize"];
-      iconTint: NoteDocument["texture"]["tint"];
-      text: NoteDocument["text"];
-      textAnchor: NoteDocument["textAnchor"];
-      textColor: NoteDocument["textColor"];
-      x: NoteDocument["x"];
-      y: NoteDocument["y"];
+    /** @internal */
+    type _FormData = Pick<
+      NoteDocument.Implementation,
+      | "elevation"
+      | "entryId"
+      | "fontFamily"
+      | "fontSize"
+      | "global"
+      | "iconSize"
+      | "pageId"
+      | "sort"
+      | "text"
+      | "textAnchor"
+      | "textColor"
+      | "x"
+      | "y"
+    >;
+
+    interface FormData extends _FormData {
+      "icon.selected": NoteDocument.Implementation["texture"]["src"];
+
+      /** @remarks Only appears in the form data if `icon.selected` is set to "Custom" (`""` value) */
+      "icon.custom"?: NoteDocument.Implementation["texture"]["src"];
     }
   }
 }

package/src/foundry/client/apps/placeables/tile-config.d.mts

@@ -1,4 +1,4 @@
-import type { MaybePromise } from "../../../../types/utils.d.mts";
+import type { MaybePromise } from "#utils";
 
 declare global {
   /**
@@ -7,7 +7,7 @@ declare global {
    */
   class TileConfig<Options extends TileConfig.Options = TileConfig.Options> extends DocumentSheet<
     Options,
-    TileDocument.ConfiguredInstance
+    TileDocument.Implementation
   > {
     /**
      * @defaultValue
@@ -35,16 +35,29 @@ declare global {
   }
 
   namespace TileConfig {
-    type Any = TileConfig<any>;
+    interface Any extends TileConfig<any> {}
 
-    type FormData = Pick<TileDocument, "alpha" | "height" | "rotation" | "width" | "x" | "y" | "overhead" | "roof"> & {
-      "texture.src": string | null;
-      "texture.scaleX": number | null;
-      "texture.scaleY": number | null;
-      "texture.tint": string;
-    };
+    /** @internal */
+    type _FormData = Pick<
+      TileDocument.Implementation,
+      "alpha" | "elevation" | "height" | "rotation" | "sort" | "width" | "x" | "y"
+    >;
 
-    interface Options extends DocumentSheetOptions<TileDocument> {
+    interface FormData extends _FormData {
+      "occlusion.alpha": TileDocument.Implementation["occlusion"]["alpha"];
+      "occlusion.mode": TileDocument.Implementation["occlusion"]["mode"];
+      "restrictions.light": TileDocument.Implementation["restrictions"]["light"];
+      "restrictions.weather": TileDocument.Implementation["restrictions"]["weather"];
+      "texture.src": TileDocument.Implementation["texture"]["src"];
+      "texture.scaleX": TileDocument.Implementation["texture"]["scaleX"];
+      "texture.scaleY": TileDocument.Implementation["texture"]["scaleY"];
+      "texture.tint": TileDocument.Implementation["texture"]["tint"];
+      "video.autoplay": TileDocument.Implementation["video"]["autoplay"];
+      "video.loop": TileDocument.Implementation["video"]["loop"];
+      "video.volume": TileDocument.Implementation["video"]["volume"];
+    }
+
+    interface Options extends DocumentSheet.Options<TileDocument.Implementation> {
       /**
        * Configure a preview version of a tile which is not yet saved
        */

package/src/foundry/client/apps/placeables/tile-hud.d.mts

@@ -1,12 +1,12 @@
-import type { MaybePromise } from "../../../../types/utils.d.mts";
+import type { MaybePromise, Identity } from "#utils";
 
 declare global {
   /**
    * An implementation of the PlaceableHUD base class which renders a heads-up-display interface for Tile objects.
    * @typeParam Options - the type of the options object
    */
-  class TileHUD<Options extends ApplicationOptions = ApplicationOptions> extends BasePlaceableHUD<
-    Tile.ConfiguredInstance,
+  class TileHUD<Options extends Application.Options = Application.Options> extends BasePlaceableHUD<
+    Tile.Object,
     Options
   > {
     /**
@@ -18,7 +18,7 @@ declare global {
      * })
      * ```
      */
-    static override get defaultOptions(): ApplicationOptions;
+    static override get defaultOptions(): Application.Options;
 
     override getData(options?: Partial<Options>): MaybePromise<object>; // TODO: Implement GetDataReturnType
 
@@ -32,6 +32,11 @@ declare global {
   }
 
   namespace TileHUD {
-    type Any = TileHUD<any>;
+    interface Any extends AnyTileHUD {}
+    interface AnyConstructor extends Identity<typeof AnyTileHUD> {}
   }
 }
+
+declare abstract class AnyTileHUD extends TileHUD<Application.Options> {
+  constructor(...args: never);
+}