@league-of-foundry-developers/foundry-vtt-types 13.340.0 → 13.340.1

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

@@ -1,4 +1,4 @@
-import type { MaybePromise, ValueOf } from "fvtt-types/utils";
+import type { MaybePromise, Identity, ValueOf } from "fvtt-types/utils";
 
 declare global {
   /**
@@ -14,115 +14,14 @@ declare global {
   const MIN_WINDOW_WIDTH: 200;
   const MIN_WINDOW_HEIGHT: 50;
 
-  interface ApplicationOptions {
-    /**
-     * A named "base application" which generates an additional hook
-     * @defaultValue `null`
-     */
-    baseApplication: string | null;
-
-    /**
-     * The default pixel width for the rendered HTML
-     * @defaultValue `null`
-     */
-    width: number | null;
-
-    /**
-     * The default pixel height for the rendered HTML
-     * @defaultValue `null`
-     */
-    height: number | "auto" | null;
-
-    /**
-     * The default offset-top position for the rendered HTML
-     * @defaultValue `null`
-     */
-    top: number | null;
-
-    /**
-     * The default offset-left position for the rendered HTML
-     * @defaultValue `null`
-     */
-    left: number | null;
-
-    /**
-     * A transformation scale for the rendered HTML
-     * @defaultValue `null`
-     */
-    scale: number | null;
-
-    /**
-     * Whether to display the application as a pop-out container
-     * @defaultValue `true`
-     */
-    popOut: boolean;
-
-    /**
-     * Whether the rendered application can be minimized (popOut only)
-     * @defaultValue `true`
-     */
-    minimizable: boolean;
-
-    /**
-     * Whether the rendered application can be drag-resized (popOut only)
-     * @defaultValue `false`
-     */
-    resizable: boolean;
-
-    /**
-     * The default CSS id to assign to the rendered HTML
-     * @defaultValue `""`
-     */
-    id: string;
-
-    /**
-     * An array of CSS string classes to apply to the rendered HTML
-     * @defaultValue `[]`
-     */
-    classes: string[];
-
-    /**
-     * A default window title string (popOut only)
-     * @defaultValue `""`
-     */
-    title: string;
-
-    /**
-     * The default HTML template path to render for this Application
-     * @defaultValue `null`
-     */
-    template: string | null;
-
-    /**
-     * A list of unique CSS selectors which target containers that should
-     * have their vertical scroll positions preserved during a re-render.
-     * @defaultValue `[]`
-     */
-    scrollY: string[];
-
-    /**
-     * An array of tabbed container configurations which should be enabled
-     * for the application.
-     * @defaultValue `[]`
-     */
-    tabs: Omit<TabsConfiguration, "callback">[];
-
-    /**
-     * @defaultValue `[]`
-     */
-    dragDrop: Omit<DragDropConfiguration, "permissions" | "callbacks">[];
-
-    /**
-     * @defaultValue `[]`
-     */
-    filters: Omit<SearchFilterConfiguration, "callback">[];
-  }
+  /** @deprecated {@link Application.Options | `Application.Options`} */
+  type ApplicationOptions = Application.Options;
 
   /**
    * The standard application window that is rendered for a large variety of UI elements in Foundry VTT.
    * @typeParam Options - the type of the options object
    */
-  abstract class Application<Options extends ApplicationOptions = ApplicationOptions> {
+  abstract class Application<Options extends Application.Options = Application.Options> {
     /**
      * @param options - Configuration options which control how the application is rendered.
      *                  Application subclasses may add additional supported options, but the
@@ -177,16 +76,16 @@ declare global {
 
     /**
      * Track the render state of the Application
-     * @defaultValue {@link Application.RENDER_STATES.NONE}
-     * @see {@link Application.RENDER_STATES}
+     * @defaultValue {@link Application.RENDER_STATES.NONE | `Application.RENDER_STATES.NONE`}
+     * @see {@link Application.RENDER_STATES | `Application.RENDER_STATES`}
      */
     protected _state: Application.RenderState;
 
     /**
      * The prior render state of this Application.
      * This allows for rendering logic to understand if the application is being rendered for the first time.
-     * @defaultValue {@link Application.RENDER_STATES.NONE}
-     * @see {@link Application.RENDER_STATES}
+     * @defaultValue {@link Application.RENDER_STATES.NONE | `Application.RENDER_STATES.NONE`}
+     * @see {@link Application.RENDER_STATES | `Application.RENDER_STATES`}
      */
     protected _priorState: Application.RenderState;
 
@@ -198,7 +97,7 @@ declare global {
 
     /**
      * The sequence of rendering states that track the Application life-cycle.
-     * @see {@link Application.RenderState}
+     * @see {@link Application.RenderState | `Application.RenderState`}
      */
     static RENDER_STATES: Readonly<{
       CLOSING: -2;
@@ -235,7 +134,7 @@ declare global {
      * in this object are merged with any provided option values which are passed to the constructor upon initialization.
      * Application subclasses may include additional options which are specific to their usage.
      */
-    static get defaultOptions(): ApplicationOptions;
+    static get defaultOptions(): Application.Options;
 
     /**
      * Return the CSS application ID which uniquely references this UI element
@@ -294,7 +193,7 @@ declare global {
      * @returns The rendered Application instance
      * @remarks Some subclasses return other results.
      */
-    render(force?: boolean, options?: Application.RenderOptions<Options>): unknown;
+    render(force?: boolean, options?: Application.RenderOptions<Options>): this;
 
     /**
      * An asynchronous inner function which handles the rendering of the Application
@@ -370,7 +269,7 @@ declare global {
     protected _getHeaderButtons(): Application.HeaderButton[];
 
     /**
-     * Create a {@link ContextMenu} for this Application.
+     * Create a {@link ContextMenu | `ContextMenu`} for this Application.
      * @param html - The Application's HTML.
      * @internal
      */
@@ -511,9 +410,112 @@ declare global {
   }
 
   namespace Application {
-    type Any = Application<any>;
+    interface Any extends AnyApplication {}
+    interface AnyConstructor extends Identity<typeof AnyApplication> {}
+
+    interface Options {
+      /**
+       * A named "base application" which generates an additional hook
+       * @defaultValue `null`
+       */
+      baseApplication: string | null;
+
+      /**
+       * The default pixel width for the rendered HTML
+       * @defaultValue `null`
+       */
+      width: number | null;
+
+      /**
+       * The default pixel height for the rendered HTML
+       * @defaultValue `null`
+       */
+      height: number | "auto" | null;
+
+      /**
+       * The default offset-top position for the rendered HTML
+       * @defaultValue `null`
+       */
+      top: number | null;
+
+      /**
+       * The default offset-left position for the rendered HTML
+       * @defaultValue `null`
+       */
+      left: number | null;
+
+      /**
+       * A transformation scale for the rendered HTML
+       * @defaultValue `null`
+       */
+      scale: number | null;
+
+      /**
+       * Whether to display the application as a pop-out container
+       * @defaultValue `true`
+       */
+      popOut: boolean;
+
+      /**
+       * Whether the rendered application can be minimized (popOut only)
+       * @defaultValue `true`
+       */
+      minimizable: boolean;
 
-    type AnyConstructor = typeof AnyApplication;
+      /**
+       * Whether the rendered application can be drag-resized (popOut only)
+       * @defaultValue `false`
+       */
+      resizable: boolean;
+
+      /**
+       * The default CSS id to assign to the rendered HTML
+       * @defaultValue `""`
+       */
+      id: string;
+
+      /**
+       * An array of CSS string classes to apply to the rendered HTML
+       * @defaultValue `[]`
+       */
+      classes: string[];
+
+      /**
+       * A default window title string (popOut only)
+       * @defaultValue `""`
+       */
+      title: string;
+
+      /**
+       * The default HTML template path to render for this Application
+       * @defaultValue `null`
+       */
+      template: string | null;
+
+      /**
+       * A list of unique CSS selectors which target containers that should
+       * have their vertical scroll positions preserved during a re-render.
+       * @defaultValue `[]`
+       */
+      scrollY: string[];
+
+      /**
+       * An array of tabbed container configurations which should be enabled
+       * for the application.
+       * @defaultValue `[]`
+       */
+      tabs: Omit<Tabs.Configuration, "callback">[];
+
+      /**
+       * @defaultValue `[]`
+       */
+      dragDrop: Omit<DragDrop.Configuration, "permissions" | "callbacks">[];
+
+      /**
+       * @defaultValue `[]`
+       */
+      filters: Omit<SearchFilter.Configuration, "callback">[];
+    }
 
     interface CloseOptions {
       force?: boolean | undefined;
@@ -548,7 +550,7 @@ declare global {
 
     // TODO(LukeAbby): This should accept already partial options but all callers have to be changed.
     // `_RenderOptions` should probably become the default and applications will extend that plus their optional options.
-    type RenderOptions<Options extends ApplicationOptions = ApplicationOptions> = Partial<Options> & _RenderOptions;
+    type RenderOptions<Options extends Application.Options = Application.Options> = Partial<Options> & _RenderOptions;
 
     /** @internal */
     interface _RenderOptions {
@@ -596,12 +598,12 @@ declare global {
     }
 
     /**
-     * @see {@link Application.RENDER_STATES}
+     * @see {@link Application.RENDER_STATES | `Application.RENDER_STATES`}
      */
     type RenderState = ValueOf<typeof Application.RENDER_STATES>;
   }
 }
 
-declare abstract class AnyApplication extends Application<any> {
-  constructor(arg0: never, ...args: never[]);
+declare abstract class AnyApplication extends Application<Application.Options> {
+  constructor(...args: never);
 }

package/src/foundry/client/apps/av/av-config.d.mts

@@ -1,4 +1,4 @@
-import type { GetDataReturnType, MaybePromise } from "fvtt-types/utils";
+import type { GetDataReturnType, MaybePromise, Identity } from "fvtt-types/utils";
 
 declare global {
   /**
@@ -6,12 +6,12 @@ declare global {
    *
    * @typeParam Options - The type of the options object
    */
-  class AVConfig<Options extends FormApplicationOptions = FormApplicationOptions> extends FormApplication<
-    Options,
-    AVMaster
+  class AVConfig<Options extends FormApplication.Options = FormApplication.Options> extends FormApplication<
+    AVMaster,
+    Options
   > {
     /**
-     * @param object  - The {@link AVMaster} instance being configured.
+     * @param object  - The {@link AVMaster | `AVMaster`} instance being configured.
      * @param options - Application configuration options.
      */
     constructor(object?: AVMaster, options?: Partial<Options>);
@@ -30,7 +30,7 @@ declare global {
      * });
      * ```
      */
-    static override get defaultOptions(): FormApplicationOptions;
+    static override get defaultOptions(): FormApplication.Options;
 
     override getData(options?: Partial<Options>): MaybePromise<GetDataReturnType<AVConfig.AVConfigData>>;
 
@@ -66,10 +66,11 @@ declare global {
   }
 
   namespace AVConfig {
-    type Any = AVConfig<any>;
+    interface Any extends AnyAVConfig {}
+    interface AnyConstructor extends Identity<typeof AnyAVConfig> {}
 
     interface AVConfigData {
-      user: User;
+      user: User.Implementation;
       modes: Record<AVSettings.AV_MODES, string>;
       voiceModes: Record<AVSettings.VOICE_MODES, string>;
       serverTypes: { FVTT: "WEBRTC.FVTTSignalingServer"; custom: "WEBRTC.CustomSignalingServer" };
@@ -91,3 +92,7 @@ declare global {
     }
   }
 }
+
+declare abstract class AnyAVConfig extends AVConfig<FormApplication.Options> {
+  constructor(...args: never);
+}

package/src/foundry/client/apps/av/cameras.d.mts

@@ -1,12 +1,12 @@
-import type { GetDataReturnType, MaybePromise } from "fvtt-types/utils";
-import type Document from "../../../common/abstract/document.d.mts";
+import type { GetDataReturnType, MaybePromise, Identity } from "fvtt-types/utils";
+import type Document from "#common/abstract/document.d.mts";
 
 declare global {
   /**
    * The Camera UI View that displays all the camera feeds as individual video elements.
    * @typeParam Options - the type of the options object
    */
-  class CameraViews<Options extends ApplicationOptions = ApplicationOptions> extends Application<Options> {
+  class CameraViews<Options extends Application.Options = Application.Options> extends Application<Options> {
     constructor(options: Options);
 
     /** @defaultValue `undefined` */
@@ -24,7 +24,7 @@ declare global {
      * })
      * ```
      */
-    static override get defaultOptions(): ApplicationOptions;
+    static override get defaultOptions(): Application.Options;
 
     /**
      * A reference to the master AV orchestrator instance
@@ -66,7 +66,7 @@ declare global {
     /**
      * @param force   - Render and display the application even if it is not currently displayed.
      *                  (default: `false`)
-     * @param options - Additional options which update the current values of the @see Application#options object
+     * @param options - Additional options which update the current values of the @see {@link Application.options | `Application#options`} object
      * @internal
      */
     protected override _render(force?: boolean, options?: Application.RenderOptions<Options>): Promise<void>;
@@ -161,13 +161,13 @@ declare global {
   }
 
   namespace CameraViews {
-    type Any = AnyCameraViews;
-    type AnyConstructor = typeof AnyCameraViews;
+    interface Any extends AnyCameraViews {}
+    interface AnyConstructor extends Identity<typeof AnyCameraViews> {}
 
     interface User {
-      user: Document.Stored<globalThis.User>;
+      user: Document.Stored<globalThis.User.Implementation>;
       settings: AVSettings.UserSettings;
-      local: Document.Stored<globalThis.User>["isSelf"];
+      local: Document.Stored<globalThis.User.Implementation>["isSelf"];
       charname: string;
       volume: number;
       cameraViewClass: string;
@@ -189,6 +189,6 @@ declare global {
   }
 }
 
-declare abstract class AnyCameraViews extends CameraViews<ApplicationOptions> {
-  constructor(arg0: never, ...args: never[]);
+declare abstract class AnyCameraViews extends CameraViews<Application.Options> {
+  constructor(...args: never);
 }

package/src/foundry/client/apps/dice/dice-config.d.mts

@@ -1,10 +1,13 @@
-import type { MaybePromise, GetDataReturnType, EmptyObject } from "fvtt-types/utils";
+import type { MaybePromise, GetDataReturnType, EmptyObject, Identity } from "fvtt-types/utils";
 
 declare global {
   /**
    * An application responsible for configuring how dice are rolled and evaluated.
    */
-  class DiceConfig<Options extends FormApplicationOptions = FormApplicationOptions> extends FormApplication<Options> {
+  class DiceConfig<Options extends FormApplication.Options = FormApplication.Options> extends FormApplication<
+    FormApplication.NoObject,
+    Options
+  > {
     /**
      * @defaultValue
      * ```typescript
@@ -16,9 +19,9 @@ declare global {
      * });
      * ```
      */
-    static get defaultOptions(): FormApplicationOptions;
+    static get defaultOptions(): FormApplication.Options;
 
-    override getData(options?: Partial<Options>): MaybePromise<GetDataReturnType<DiceConfig.DiceConfigData>>;
+    override getData(options?: Partial<Options>): MaybePromise<GetDataReturnType<DiceConfig.Data>>;
 
     protected override _updateObject(
       event: Event,
@@ -27,15 +30,22 @@ declare global {
   }
 
   namespace DiceConfig {
-    type Any = DiceConfig<any>;
+    interface Any extends AnyDiceConfig {}
+    interface AnyConstructor extends Identity<typeof AnyDiceConfig> {}
 
-    interface DiceConfigData {
-      dice: DiceConfigDiceData[];
+    /** @deprecated {@link DiceConfig.Data | `DiceConfig.Data`} */
+    type DiceConfigData = Data;
+
+    /** @deprecated {@link DiceConfig.DiceDat | `DiceConfig.DiceDat`} */
+    type DiceConfigDiceData = DiceData;
+
+    interface Data {
+      dice: DiceData[];
       methods: Record<string, CONFIG.Dice.FulfillmentMethod>;
       object: EmptyObject;
     }
 
-    interface DiceConfigDiceData {
+    interface DiceData {
       label: string;
       icon: string;
       denomination: CONFIG.Dice.DTermDiceStrings;
@@ -43,3 +53,7 @@ declare global {
     }
   }
 }
+
+declare abstract class AnyDiceConfig extends DiceConfig<FormApplication.Options> {
+  constructor(...args: never);
+}