@league-of-foundry-developers/foundry-vtt-types 0.8.9-9 → 9.245.0

package/src/foundry/foundry.js/applications/formApplications/wallConfig.d.ts

@@ -7,7 +7,7 @@ declare global {
    * @typeParam Data    - The data structure used to render the handlebars template.
    */
   class WallConfig<
-    Options extends FormApplication.Options = FormApplication.Options,
+    Options extends FormApplicationOptions = FormApplicationOptions,
     Data extends object = WallConfig.Data<Options>
   > extends FormApplication<Options, Data, InstanceType<ConfiguredDocumentClassForName<'Wall'>>> {
     /**
@@ -20,7 +20,7 @@ declare global {
      * options.width = 400;
      * ```
      */
-    static get defaultOptions(): FormApplication.Options;
+    static get defaultOptions(): FormApplicationOptions;
 
     /** @override */
     get title(): string;
@@ -39,7 +39,7 @@ declare global {
   }
 
   namespace WallConfig {
-    interface Data<Options extends FormApplication.Options = FormApplication.Options> {
+    interface Data<Options extends FormApplicationOptions = FormApplicationOptions> {
       object: foundry.data.WallData['_source'];
       options: Options;
       moveTypes: {
@@ -61,12 +61,12 @@ declare global {
     }
 
     interface FormData {
-      dir: foundry.CONST.WallDirection;
-      door: foundry.CONST.WallDoorType;
-      ds?: foundry.CONST.WallDoorState;
-      move: foundry.CONST.WallMovementType;
-      sense: foundry.CONST.WallSenseType;
-      sound: foundry.CONST.WallSenseType;
+      dir: foundry.CONST.WALL_DIRECTIONS;
+      door: foundry.CONST.WALL_DOOR_TYPES;
+      ds?: foundry.CONST.WALL_DOOR_STATES;
+      move: foundry.CONST.WALL_MOVEMENT_TYPES;
+      sense: foundry.CONST.WALL_SENSE_TYPES;
+      sound: foundry.CONST.WALL_SENSE_TYPES;
     }
   }
 }

package/src/foundry/foundry.js/applications/formApplications/worldConfig.d.ts

@@ -57,7 +57,7 @@ declare namespace WorldConfig {
     systems?: Game.SystemData<foundry.packages.SystemData>[];
   }
 
-  interface Options extends FormApplication.Options {
+  interface Options extends FormApplicationOptions {
     /**
      * @defaultValue `false`
      */

package/src/foundry/foundry.js/applications/frameViewer.d.ts

@@ -21,7 +21,7 @@ declare class FrameViewer extends Application {
   static get defaultOptions(): typeof Application['defaultOptions'];
 
   /** @override */
-  getData(options?: Partial<Application.Options>): Promise<{ src: string }>;
+  getData(options?: Partial<ApplicationOptions>): Promise<{ src: string }>;
 
   /** @override */
   close(options?: Application.CloseOptions): ReturnType<Application['close']>;

package/src/foundry/foundry.js/applications/headsUpDisplay.d.ts

@@ -2,7 +2,7 @@
  * Render the HUD container
  * @typeParam Options - the type of the options object
  */
-declare class HeadsUpDisplay<Options extends Application.Options = Application.Options> extends Application<Options> {
+declare class HeadsUpDisplay<Options extends ApplicationOptions = ApplicationOptions> extends Application<Options> {
   /**
    * Token HUD
    */
@@ -34,7 +34,7 @@ declare class HeadsUpDisplay<Options extends Application.Options = Application.O
    * })
    * ```
    */
-  static get defaultOptions(): Application.Options;
+  static get defaultOptions(): ApplicationOptions;
 
   /** @override */
   getData(options?: Partial<Options>): {} | { width: number; height: number };

package/src/foundry/foundry.js/applications/hotbar.d.ts

@@ -16,7 +16,7 @@ declare global {
    *
    * @typeParam Options - the type of the options object
    */
-  class Hotbar<Options extends Application.Options = Application.Options> extends Application<Options> {
+  class Hotbar<Options extends ApplicationOptions = ApplicationOptions> extends Application<Options> {
     constructor(options?: Partial<Options>);
 
     /**
@@ -55,7 +55,7 @@ declare global {
      * })
      * ```
      */
-    static get defaultOptions(): Application.Options;
+    static get defaultOptions(): ApplicationOptions;
 
     /** @override */
     getData(options?: Partial<Options>): Hotbar.Data | Promise<Hotbar.Data>;

package/src/foundry/foundry.js/applications/mainMenu.d.ts

@@ -14,7 +14,7 @@ declare class MainMenu extends Application {
    * }
    * ```
    * */
-  static get defaultOptions(): Application.Options;
+  static get defaultOptions(): ApplicationOptions;
 
   /**
    * The structure of menu items
@@ -54,7 +54,7 @@ declare class MainMenu extends Application {
    * @override
    * @param options - (unused)
    */
-  getData(options?: Partial<Application.Options>): { items: MainMenu.MenuStructure };
+  getData(options?: Partial<ApplicationOptions>): { items: MainMenu.MenuStructure };
 
   /** @override */
   activateListeners(html: JQuery): void;

package/src/foundry/foundry.js/applications/notifications.d.ts

@@ -13,7 +13,7 @@
  *
  * @typeParam Options - the type of the options object
  */
-declare class Notifications<Options extends Application.Options = Application.Options> extends Application<Options> {
+declare class Notifications<Options extends ApplicationOptions = ApplicationOptions> extends Application<Options> {
   constructor(options?: Partial<Options>);
 
   /**
@@ -39,15 +39,18 @@ declare class Notifications<Options extends Application.Options = Application.Op
    * });
    * ```
    */
-  static get defaultOptions(): Application.Options;
+  static get defaultOptions(): ApplicationOptions;
 
   /**
    * Initialize the Notifications system by displaying any system-generated messages which were passed from the server.
    */
   initialize(): void;
 
-  /** @override */
-  protected _renderInner(data: object): JQuery;
+  /**
+   * @override
+   * @remarks This return a `JQuery`, which is incompatible with the expected `Promise<JQuery>` (see https://gitlab.com/foundrynet/foundryvtt/-/issues/6554).
+   */
+  protected _renderInner(data: object): any;
 
   /** @override */
   protected _render(force?: boolean, options?: Application.RenderOptions<Options>): Promise<void>;

package/src/foundry/foundry.js/applications/pause.d.ts

@@ -5,10 +5,10 @@
  * @typeParam Data    - The data structure used to render the handlebars template.
  */
 declare class Pause<
-  Options extends Application.Options = Application.Options,
+  Options extends ApplicationOptions = ApplicationOptions,
   Data extends object = Pause.Data
 > extends Application<Options> {
-  static get defaultOptions(): Application.Options;
+  static get defaultOptions(): ApplicationOptions;
 
   /** @override */
   getData(options?: Partial<Options>): Data | Promise<Data>;

package/src/foundry/foundry.js/applications/playerList.d.ts

@@ -6,7 +6,7 @@ declare global {
    *
    * @typeParam Options - the type of the options object
    */
-  class PlayerList<Options extends Application.Options = Application.Options> extends Application<Options> {
+  class PlayerList<Options extends ApplicationOptions = ApplicationOptions> extends Application<Options> {
     constructor(options?: Partial<Options>);
 
     /**
@@ -25,7 +25,7 @@ declare global {
      * })
      * ```
      */
-    static get defaultOptions(): Application.Options;
+    static get defaultOptions(): ApplicationOptions;
 
     /** @override */
     render(force?: boolean, options?: Application.RenderOptions<Options>): this;

package/src/foundry/foundry.js/applications/sceneControls.d.ts

@@ -33,7 +33,7 @@ interface SceneControl {
  * Scene controls navigation menu
  * @typeParam Options - the type of the options object
  */
-declare class SceneControls<Options extends Application.Options = Application.Options> extends Application<Options> {
+declare class SceneControls<Options extends ApplicationOptions = ApplicationOptions> extends Application<Options> {
   constructor(options?: Partial<Options>);
 
   /**
@@ -118,7 +118,7 @@ declare class SceneControls<Options extends Application.Options = Application.Op
 }
 
 declare namespace SceneControls {
-  export interface Options extends Application.Options {
+  export interface Options extends ApplicationOptions {
     /**
      * @defaultValue `100`
      */

package/src/foundry/foundry.js/applications/sceneNavigation.d.ts

@@ -8,7 +8,7 @@ declare global {
    * @typeParam Data    - The data structure used to render the handlebars template.
    */
   class SceneNavigation<
-    Options extends Application.Options = Application.Options,
+    Options extends ApplicationOptions = ApplicationOptions,
     Data extends object = SceneNavigation.Data
   > extends Application<Options> {
     constructor(options?: Partial<Options>);
@@ -31,7 +31,7 @@ declare global {
      * })
      * ```
      */
-    static get defaultOptions(): Application.Options;
+    static get defaultOptions(): ApplicationOptions;
 
     /**
      * Return an Array of Scenes which are displayed in the Navigation bar
@@ -45,7 +45,7 @@ declare global {
     protected _render(force?: boolean, options?: Application.RenderOptions<Options>): Promise<void>;
 
     /** @override */
-    getData(options?: Partial<Application.Options>): Data | Promise<Data>;
+    getData(options?: Partial<ApplicationOptions>): Data | Promise<Data>;
 
     /**
      * Expand the SceneNavigation menu, sliding it down if it is currently collapsed

package/src/foundry/foundry.js/applications/sidebar.d.ts

@@ -2,7 +2,7 @@
  * Render the Sidebar container, and after rendering insert Sidebar tabs.
  * @typeParam Options - the type of the options object
  */
-declare class Sidebar<Options extends Application.Options = Application.Options> extends Application<Options> {
+declare class Sidebar<Options extends ApplicationOptions = ApplicationOptions> extends Application<Options> {
   /**
    * Singleton application instances for each sidebar tab
    * @defaultValue `{}`
@@ -29,7 +29,7 @@ declare class Sidebar<Options extends Application.Options = Application.Options>
    * }
    * ```
    */
-  static get defaultOptions(): Application.Options;
+  static get defaultOptions(): ApplicationOptions;
 
   /**
    * Return the name of the active Sidebar tab

package/src/foundry/foundry.js/applications/sidebarTab.d.ts

@@ -3,12 +3,12 @@
  * @typeParam Options - The type of the options object
  */
 declare abstract class SidebarTab<
-  Options extends Application.Options = Application.Options
+  Options extends ApplicationOptions = ApplicationOptions
 > extends Application<Options> {
   constructor(...args: ConstructorParameters<typeof Application>);
   /**
    * The base name of this sidebar tab
-   * @defaultValue `''`
+   * @defaultValue `""`
    */
   tabName: string;
 
@@ -36,16 +36,13 @@ declare abstract class SidebarTab<
    * });
    * ```
    */
-  static get defaultOptions(): Application.Options;
-
-  /**  @override */
-  protected _renderInner(data: object): Promise<JQuery>;
+  static get defaultOptions(): ApplicationOptions;
 
   /** @override */
   protected _render(force?: boolean, options?: Application.RenderOptions<Options>): Promise<void>;
 
-  /** @override */
-  render(force?: boolean, options?: Application.RenderOptions<Options>): unknown;
+  /**  @override */
+  protected _renderInner(data: object): Promise<JQuery>;
 
   /**
    * Activate this SidebarTab, switching focus to it

package/src/foundry/foundry.js/applications/sidebarTabs/chatLog.d.ts

@@ -1,4 +1,5 @@
-import { ConfiguredDocumentClass, ConstructorDataType } from '../../../../types/helperTypes';
+import { ConfiguredDocumentClass } from '../../../../types/helperTypes';
+import type { ChatMessageDataConstructorData } from '../../../common/data/data.mjs/chatMessageData.js';
 
 declare global {
   /**
@@ -162,7 +163,7 @@ declare global {
     protected _processDiceCommand(
       command: string,
       match: RegExpMatchArray,
-      chatData: ConstructorDataType<foundry.data.ChatMessageData>,
+      chatData: ChatMessageDataConstructorData,
       createOptions: DocumentModificationContext
     ): void;
 
@@ -178,7 +179,7 @@ declare global {
     protected _processWhisperCommand(
       command: string,
       match: RegExpMatchArray,
-      chatData: ConstructorDataType<foundry.data.ChatMessageData>,
+      chatData: ChatMessageDataConstructorData,
       createOptions: DocumentModificationContext
     ): void;
 
@@ -193,7 +194,7 @@ declare global {
     protected _processChatCommand(
       command: string,
       match: RegExpMatchArray,
-      chatData: ConstructorDataType<foundry.data.ChatMessageData>,
+      chatData: ChatMessageDataConstructorData,
       createOptions: DocumentModificationContext
     ): void;
 
@@ -275,7 +276,7 @@ declare global {
      * @param mode - The new roll mode setting
      * @internal
      */
-    protected static _setRollMode(mode: foundry.CONST.DiceRollMode): void;
+    protected static _setRollMode(mode: keyof CONFIG.Dice.RollModes): void;
   }
 
   namespace ChatLog {
@@ -296,12 +297,12 @@ declare global {
 
     interface Data {
       user: InstanceType<ConfiguredDocumentClass<typeof User>>;
-      rollMode: foundry.CONST.DiceRollMode;
+      rollMode: keyof CONFIG.Dice.RollModes;
       rollModes: typeof CONFIG['Dice']['rollModes'];
       isStream: boolean;
     }
 
-    interface Options extends Application.Options {
+    interface Options extends ApplicationOptions {
       /**
        * @defaultValue `'chat'`
        */

package/src/foundry/foundry.js/applications/sidebarTabs/combatTracker.d.ts

@@ -4,7 +4,7 @@ declare global {
   /**
    * The sidebar directory which organizes and displays world-level Combat documents.
    */
-  class CombatTracker<Options extends Application.Options = CombatTracker.Options> extends SidebarTab<Options> {
+  class CombatTracker<Options extends ApplicationOptions = ApplicationOptions> extends SidebarTab<Options> {
     constructor(options?: Partial<Options>);
 
     /**
@@ -20,13 +20,23 @@ declare global {
      */
     viewed: StoredDocument<InstanceType<ConfiguredDocumentClass<typeof Combat>>> | null;
 
-    /** @override */
-    static get defaultOptions(): CombatTracker.Options;
+    /**
+     * @defaultValue
+     * ```typescript
+     * foundry.utils.mergeObject(super.defaultOptions, {
+     *   id: "combat",
+     *   template: "templates/sidebar/combat-tracker.html",
+     *   title: "COMBAT.SidebarTitle",
+     *   scrollY: [".directory-list"]
+     * })
+     * ```
+     */
+    static get defaultOptions(): ApplicationOptions;
 
     /**
      * Return an array of Combat encounters which occur within the current Scene.
      */
-    get combats(): ReturnType<CombatEncounters['filter']>;
+    get combats(): StoredDocument<InstanceType<ConfiguredDocumentClass<typeof Combat>>>[];
 
     /** @override */
     createPopout(): this;
@@ -115,6 +125,12 @@ declare global {
      */
     protected _onCombatantHoverOut(event: JQuery.MouseLeaveEvent): void;
 
+    /**
+     * Highlight a hovered combatant in the tracker.
+     * @param combatant - The Combatant
+     * @param hover     - Whether they are being hovered in or out.
+     */
+    hoverCombatant(combatant: InstanceType<ConfiguredDocumentClass<typeof Combatant>>, hover: boolean): void;
     /**
      * Attach context menu options to elements in the tracker
      * @param html - The HTML element to which context options are attached
@@ -123,8 +139,8 @@ declare global {
     protected _contextMenu(html: JQuery): void;
 
     /**
-     * Get the sidebar directory entry context options
-     * @returns The sidebar entry context options
+     * Get the Combatant entry context options
+     * @returns The Combatant entry context options
      * @internal
      */
     protected _getEntryContextOptions(): ContextMenuEntry[];
@@ -144,6 +160,8 @@ declare global {
           combatCount: number;
           started: boolean;
           settings: ClientSettings.Values[`core.${typeof Combat.CONFIG_SETTING}`];
+          linked: boolean;
+          labels: { scoped: string };
           currentIndex: -1;
           hasCombat: false;
           combat: null;
@@ -158,6 +176,8 @@ declare global {
           combatCount: number;
           started: boolean;
           settings: ClientSettings.Values[`core.${typeof Combat.CONFIG_SETTING}`];
+          linked: boolean;
+          labels: { scoped: string };
           currentIndex: number;
           hasCombat: true;
           combat: StoredDocument<InstanceType<ConfiguredDocumentClass<typeof Combat>>>;
@@ -184,27 +204,5 @@ declare global {
       css: string;
       effects: Set<string>;
     };
-
-    interface Options extends Application.Options {
-      /**
-       * @defaultValue `'combat'`
-       */
-      id: string;
-
-      /**
-       * @defaultValue `'templates/sidebar/combat-tracker.html'`
-       */
-      template: string;
-
-      /**
-       * @defaultValue `'Combat Tracker'`
-       */
-      title: string;
-
-      /**
-       * @defaultValue `['.directory-list']`
-       */
-      scrollY: string[];
-    }
   }
 }

package/src/foundry/foundry.js/applications/sidebarTabs/compendiumDirectory.d.ts

@@ -5,7 +5,7 @@ declare global {
    * A compendium of knowledge arcane and mystical!
    * @typeParam Options - The type of the options object
    */
-  class CompendiumDirectory<Options extends Application.Options = Application.Options> extends SidebarTab<Options> {
+  class CompendiumDirectory<Options extends ApplicationOptions = ApplicationOptions> extends SidebarTab<Options> {
     /**
      * @override
      * @defaultValue
@@ -17,7 +17,7 @@ declare global {
      * });
      * ```
      */
-    static get defaultOptions(): Application.Options;
+    static get defaultOptions(): ApplicationOptions;
 
     /**
      * @param options - (unused)
@@ -60,10 +60,10 @@ declare global {
   namespace CompendiumDirectory {
     interface Data {
       user: InstanceType<ConfiguredDocumentClass<typeof User>>;
-      packs: { [DocumentName in foundry.CONST.CompendiumEntityType]?: PackData<DocumentName> };
+      packs: { [DocumentName in foundry.CONST.COMPENDIUM_DOCUMENT_TYPES]?: PackData<DocumentName> };
     }
 
-    interface PackData<DocumentName extends foundry.CONST.CompendiumEntityType> {
+    interface PackData<DocumentName extends foundry.CONST.COMPENDIUM_DOCUMENT_TYPES> {
       label: DocumentName;
       packs: CompendiumCollection<CompendiumCollection.Metadata & { entity: DocumentName }>[];
     }

package/src/foundry/foundry.js/applications/sidebarTabs/settings.d.ts

@@ -6,7 +6,7 @@ declare global {
    * The Settings sidebar is the furthest-to-right using a triple-cogs icon.
    * @typeParam Options - The type of the options object
    */
-  class Settings<Options extends Application.Options = Application.Options> extends SidebarTab<Options> {
+  class Settings<Options extends ApplicationOptions = ApplicationOptions> extends SidebarTab<Options> {
     /**
      * @override
      * @defaultValue
@@ -18,7 +18,7 @@ declare global {
      * })
      * ```
      */
-    static get defaultOptions(): Application.Options;
+    static get defaultOptions(): ApplicationOptions;
 
     /**
      * @param options - (unused)

package/src/foundry/foundry.js/applications/sidebarTabs/sidebarDirectories/cardsDirectory.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The sidebar directory which organizes and displays world-level Cards documents.
+ */
+declare class CardsDirectory extends SidebarDirectory<'Cards'> {
+  /** @override */
+  static documentName: 'Cards';
+}

package/src/foundry/foundry.js/applications/sidebarTabs/sidebarDirectories/index.d.ts

@@ -1,4 +1,5 @@
 import './actorDirectory';
+import './cardsDirectory';
 import './itemDirectory';
 import './journalDirectory';
 import './macroDirectory';

package/src/foundry/foundry.js/applications/sidebarTabs/sidebarDirectories/playlistDirectory.d.ts

@@ -114,13 +114,13 @@ declare global {
      * Given a constant playback mode, provide the FontAwesome icon used to display it
      * @internal
      */
-    protected _getModeIcon(mode: foundry.CONST.PlaylistMode): string;
+    protected _getModeIcon(mode: foundry.CONST.PLAYLIST_MODES): string;
 
     /**
      * Given a constant playback mode, provide the string tooltip used to describe it
      * @internal
      */
-    protected _getModeTooltip(mode: foundry.CONST.PlaylistMode): string;
+    protected _getModeTooltip(mode: foundry.CONST.PLAYLIST_MODES): string;
 
     /** @override */
     activateListeners(html: JQuery): void;

package/src/foundry/foundry.js/applications/sidebarTabs/sidebarDirectory.d.ts

@@ -8,7 +8,7 @@ declare global {
    * @typeParam Options - The type of the options object
    */
   abstract class SidebarDirectory<
-    Name extends foundry.CONST.EntityType | 'FogExploration',
+    Name extends foundry.CONST.DOCUMENT_TYPES | 'FogExploration',
     Options extends SidebarDirectory.Options = SidebarDirectory.Options
   > extends SidebarTab<Options> {
     constructor(options?: Partial<SidebarDirectory.Options>);
@@ -54,7 +54,7 @@ declare global {
      * The WorldCollection instance which this Sidebar Directory displays.
      */
     static get collection(): WorldCollection<
-      ConfiguredDocumentClassForName<foundry.CONST.EntityType | 'FogExploration'>,
+      ConfiguredDocumentClassForName<foundry.CONST.DOCUMENT_TYPES | 'FogExploration'>,
       string
     >;
 
@@ -224,7 +224,7 @@ declare global {
       sidebarIcon: string;
     }
 
-    interface Options extends Application.Options {
+    interface Options extends ApplicationOptions {
       renderUpdateKeys: string[];
       contextMenuSelector: string;
     }

package/src/foundry/foundry.js/audioContainer.d.ts

@@ -2,7 +2,6 @@
  * An AudioSourceNode container which handles the strategy of node type to use for playback.
  * Used by the Sound interface which controls playback.
  * This class is for internal use only and should not be used by external callers.
- * @internal
  */
 declare class AudioContainer {
   constructor(src: string);
@@ -31,16 +30,11 @@ declare class AudioContainer {
   isBuffer: boolean;
 
   /**
-   * Has the source for this audio container been loaded to a point that playback can begin?
-   * @defaultValue `false`
-   */
-  loaded: boolean;
-
-  /**
-   * Did the audio source fail to load (a 404 or some other reason).
-   * @defaultValue `false`
+   * Whether we have attempted to load the audio node or not, and whether it failed.
+   * @see {@link LOAD_STATES}
+   * @defaultValue `AudioContainer.LOAD_STATES.NONE`
    */
-  failed: boolean;
+  loadState: AudioContainer.LOAD_STATES;
 
   /**
    * Is the audio source currently playing?
@@ -65,6 +59,26 @@ declare class AudioContainer {
    */
   static MAX_BUFFER_DURATION: number;
 
+  /**
+   * The sequence of container loading states.
+   */
+  static LOAD_STATES: {
+    FAILED: -1;
+    NONE: 0;
+    LOADING: 1;
+    LOADED: 2;
+  };
+
+  /**
+   * Has the audio file been loaded either fully or for streaming.
+   */
+  get loaded(): boolean;
+
+  /**
+   * Did the audio file fail to load.
+   */
+  get failed(): boolean;
+
   /**
    * A reference to the AudioBuffer if the sourceNode is a AudioBufferSourceNode.
    */
@@ -155,3 +169,7 @@ declare class AudioContainer {
    */
   protected _unloadMediaNode(): void;
 }
+
+declare namespace AudioContainer {
+  type LOAD_STATES = ValueOf<typeof AudioContainer['LOAD_STATES']>;
+}

package/src/foundry/foundry.js/avSettings.d.ts

@@ -116,22 +116,22 @@ declare class AVSettings {
       type: string;
 
       /**
-       * @defaultValue `''`
+       * @defaultValue `""`
        */
       url: string;
 
       /**
-       * @defaultValue `''`
+       * @defaultValue `""`
        */
       room: string;
 
       /**
-       * @defaultValue `''`
+       * @defaultValue `""`
        */
       username: string;
 
       /**
-       * @defaultValue `''`
+       * @defaultValue `""`
        */
       password: string;
     };
@@ -143,17 +143,17 @@ declare class AVSettings {
       type: string;
 
       /**
-       * @defaultValue `''`
+       * @defaultValue `""`
        */
       url: string;
 
       /**
-       * @defaultValue `''`
+       * @defaultValue `""`
        */
       username: string;
 
       /**
-       * @defaultValue `''`
+       * @defaultValue `""`
        */
       password: string;
     };