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

package/src/foundry/client/apps/sidebar/tabs/combat-tracker.d.mts

@@ -1,165 +0,0 @@
-import type { Identity } from "fvtt-types/utils";
-
-declare global {
-  /**
-   * The sidebar directory which organizes and displays world-level Combat documents.
-   */
-  class CombatTracker<Options extends Application.Options = Application.Options> extends SidebarTab<Options> {
-    constructor(options?: Partial<Options>);
-
-    /**
-     * Record a reference to the currently highlighted Token
-     * @defaultValue `null`
-     * @internal
-     */
-    protected _highlighted: Token.Implementation | null;
-
-    /**
-     * Record the currently tracked Combat encounter
-     * @defaultValue `null`
-     */
-    viewed: Combat.Stored | null;
-
-    /**
-     * @defaultValue
-     * ```typescript
-     * foundry.utils.mergeObject(super.defaultOptions, {
-     *   id: "combat",
-     *   template: "templates/sidebar/combat-tracker.html",
-     *   title: "COMBAT.SidebarTitle",
-     *   scrollY: [".directory-list"]
-     * })
-     * ```
-     */
-    static get defaultOptions(): Application.Options;
-
-    /**
-     * Return an array of Combat encounters which occur within the current Scene.
-     */
-    get combats(): Combat.Stored[];
-
-    override createPopout(): this;
-
-    /**
-     * Initialize the combat tracker to display a specific combat encounter.
-     * If no encounter is provided, the tracker will be initialized with the first encounter in the viewed scene.
-     * @param combat - The combat encounter to initialize
-     *                 (default: `null`)
-     * @param render - Whether to re-render the sidebar after initialization
-     *                 (default: `true`)
-     */
-    initialize({ combat, render }?: { combat?: Combat.Implementation | null; render?: boolean }): void;
-
-    /**
-     * Scroll the combat log container to ensure the current Combatant turn is centered vertically
-     */
-    scrollToTurn(): void;
-
-    // TODO: Implement GetDataReturnType
-    override getData(options?: Partial<Options>): Promise<object>;
-
-    /**
-     * Retrieve a source image for a combatant.
-     * @param combatant - The combatant queried for image.
-     * @returns The source image attributed for this combatant.
-     */
-    protected _getCombatantThumbnail(combatant: Combatant.Implementation): Promise<string>;
-
-    override activateListeners(html: JQuery): void;
-
-    /**
-     * Handle new Combat creation request
-     * @internal
-     */
-    protected _onCombatCreate(event: JQuery.ClickEvent): Promise<void>;
-
-    /**
-     * Handle a Combat cycle request
-     * @internal
-     */
-    protected _onCombatCycle(event: Event): Promise<void>;
-
-    /**
-     * Handle click events on Combat control buttons
-     * @param event - The originating mousedown event
-     * @internal
-     */
-    protected _onCombatControl(event: JQuery.ClickEvent): Promise<void>;
-
-    /**
-     * Handle a Combatant control toggle
-     * @param event - The originating mousedown event
-     * @internal
-     */
-    protected _onCombatantControl(event: JQuery.ClickEvent): Promise<void>;
-
-    /**
-     * Handle toggling the defeated status effect on a combatant Token
-     * @param combatant - The combatant data being modified
-     * @returns A Promise that resolves after all operations are complete
-     * @internal
-     */
-    protected _onToggleDefeatedStatus(combatant: Combatant.Implementation): Promise<void>;
-
-    /**
-     * Handle pinging a combatant Token
-     * @param combatant - The combatant data
-     */
-    protected _onPingCombatant(combatant: Combatant.Implementation): Promise<number | undefined>;
-
-    /**
-     * Handle mouse-down event on a combatant name in the tracker
-     * @param event - The originating mousedown event
-     * @returns A Promise that resolves once the pan is complete
-     * @internal
-     */
-    protected _onCombatantMouseDown(event: JQuery.ClickEvent): Promise<boolean | void>;
-
-    /**
-     * Handle mouse-hover events on a combatant in the tracker
-     * @internal
-     */
-    protected _onCombatantHoverIn(event: JQuery.MouseEnterEvent): void;
-
-    /**
-     * Handle mouse-unhover events for a combatant in the tracker
-     * @internal
-     */
-    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: Combatant.Implementation, hover: boolean): void;
-    /**
-     * Attach context menu options to elements in the tracker
-     * @param html - The HTML element to which context options are attached
-     * @internal
-     */
-    protected _contextMenu(html: JQuery): void;
-
-    /**
-     * Get the Combatant entry context options
-     * @returns The Combatant entry context options
-     * @internal
-     */
-    protected _getEntryContextOptions(): foundry.applications.ux.ContextMenu.Entry<JQuery>[];
-
-    /**
-     * Display a dialog which prompts the user to enter a new initiative value for a Combatant
-     * @internal
-     */
-    protected _onConfigureCombatant(li: JQuery): void;
-  }
-
-  namespace CombatTracker {
-    interface Any extends AnyCombatTracker {}
-    interface AnyConstructor extends Identity<typeof AnyCombatTracker> {}
-  }
-}
-
-declare abstract class AnyCombatTracker extends CombatTracker<Application.Options> {
-  constructor(...args: never);
-}

package/src/foundry/client/apps/sidebar/tabs/compendium-directory.d.mts

@@ -1,120 +0,0 @@
-import type { Identity } from "fvtt-types/utils";
-
-declare global {
-  /**
-   * A compendium of knowledge arcane and mystical!
-   * Renders the sidebar directory of compendium packs
-   * @typeParam Options - The type of the options object
-   */
-  class CompendiumDirectory<
-    Options extends DocumentDirectory.Options = DocumentDirectory.Options,
-  > extends DirectoryApplicationMixin(SidebarTab)<Options> {
-    /**
-     * @defaultValue
-     * ```typescript
-     * foundry.utils.mergeObject(super.defaultOptions, {
-     *   id: "compendium",
-     *   template: "templates/sidebar/compendium-directory.html",
-     *   title: "COMPENDIUM.SidebarTitle",
-     *   contextMenuSelector: ".directory-item.compendium",
-     *   entryClickSelector: ".compendium"
-     * });
-     * ```
-     */
-    static override get defaultOptions(): DocumentDirectory.Options;
-
-    get activeFilters(): string[];
-
-    // NOTE: It seems in source this is erroneously defined as a property, not a getter
-    override get entryType(): "Compendium";
-
-    static override entryPartial: "templates/sidebar/partials/pack-partial.html";
-
-    protected override _entryAlreadyExists(entry: DirectoryApplicationMixin.Entry): boolean;
-
-    protected override _getEntryDragData(entryId: string): object;
-
-    protected override _entryIsSelf(
-      entry: DirectoryApplicationMixin.Entry,
-      otherEntry: DirectoryApplicationMixin.Entry,
-    ): boolean;
-
-    protected override _sortRelative(
-      entry: DirectoryApplicationMixin.Entry,
-      sortData: { sortKey: string; sortBefore: boolean; updateData: object },
-    ): Promise<object>;
-
-    override activateListeners(html: JQuery): void;
-
-    /**
-     * Display a menu of compendium types to filter by
-     * @param event - The originating pointer event
-     */
-    protected _displayFilterCompendiumMenu(event: PointerEvent): Promise<void>;
-
-    /**
-     * Handle toggling a compendium type filter
-     * @param event - The originating pointer event
-     * @param type  - The compendium type to filter by. If null, clear all filters.
-     */
-    protected _onToggleCompendiumFilterType(event: PointerEvent, type: string | null): void;
-
-    /**
-     * The collection of Compendium Packs which are displayed in this Directory
-     */
-    get collection(): CompendiumPacks;
-
-    /**
-     * Get the dropped Entry from the drop data
-     * @param data - The data being dropped
-     * @returns The dropped Entry
-     */
-    protected _getDroppedEntryFromData(data: object): Promise<DirectoryApplicationMixin.Entry>;
-
-    protected override _createDroppedEntry(
-      entry: DirectoryApplicationMixin.Entry,
-      folderId?: string,
-    ): Promise<DirectoryApplicationMixin.Entry>;
-
-    protected override _getEntryName(entry: object): string;
-
-    protected override _getEntryId(entry: object): string;
-
-    // TODO: Implement GetDataReturnType
-    override getData(options?: Partial<Options>): Promise<object>;
-
-    // NOTE(LukeAbby): In v12 this is async for no apparent reason given that it doesn't call
-    // anything that is async. However given that v13 fixes this I decided to prematurely fix it
-    // to fix tests (e.g. allow superclasses to return `this`).
-    override render(force?: boolean, options?: Application.RenderOptions<Options>): this;
-
-    /**
-     * Get the sidebar directory entry context options
-     * @returns The sidebar entry context options
-     * @internal
-     */
-    protected override _getEntryContextOptions(): foundry.applications.ux.ContextMenu.Entry<JQuery>[];
-
-    protected override _onClickEntryName(event: PointerEvent): Promise<void>;
-
-    protected override _onCreateEntry(event: PointerEvent): Promise<void>;
-
-    /**
-     * Handle a Compendium Pack deletion request
-     * @param pack - The pack object requested for deletion
-     * @internal
-     */
-    protected _onDeleteCompendium(
-      pack: CompendiumCollection<CompendiumCollection.Metadata>,
-    ): Promise<CompendiumCollection<CompendiumCollection.Metadata> | void>;
-  }
-
-  namespace CompendiumDirectory {
-    interface Any extends AnyCompendiumDirectory {}
-    interface AnyConstructor extends Identity<typeof AnyCompendiumDirectory> {}
-  }
-}
-
-declare abstract class AnyCompendiumDirectory extends CompendiumDirectory<DocumentDirectory.Options> {
-  constructor(...args: ConstructorParameters<typeof CompendiumDirectory>);
-}

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

@@ -1,12 +0,0 @@
-import "./actors-directory.d.mts";
-import "./cards-directory.d.mts";
-import "./chat-log.d.mts";
-import "./combat-tracker.d.mts";
-import "./compendium-directory.d.mts";
-import "./items-directory.d.mts";
-import "./journal-directory.d.mts";
-import "./macros-directory.d.mts";
-import "./playlists-directory.d.mts";
-import "./roll-table-directory.d.mts";
-import "./scenes-directory.d.mts";
-import "./settings.d.mts";

package/src/foundry/client/apps/sidebar/tabs/items-directory.d.mts

@@ -1,23 +0,0 @@
-import type { Identity } from "fvtt-types/utils";
-
-declare global {
-  /**
-   * The sidebar directory which organizes and displays world-level Item documents.
-   */
-  class ItemDirectory extends DocumentDirectory<"Item"> {
-    static override documentName: "Item";
-
-    protected override _canDragDrop(selector: string): boolean;
-
-    protected override _getEntryContextOptions(): foundry.applications.ux.ContextMenu.Entry<JQuery>[];
-  }
-
-  namespace ItemDirectory {
-    interface Any extends AnyItemDirectory {}
-    interface AnyConstructor extends Identity<typeof AnyItemDirectory> {}
-  }
-}
-
-declare abstract class AnyItemDirectory extends ItemDirectory {
-  constructor(...args: never);
-}

package/src/foundry/client/apps/sidebar/tabs/journal-directory.d.mts

@@ -1,22 +0,0 @@
-import type { Identity } from "fvtt-types/utils";
-
-declare global {
-  /**
-   * The sidebar directory which organizes and displays world-level JournalEntry documents.
-   * @typeParam Options - The type of the options object
-   */
-  class JournalDirectory extends DocumentDirectory<"JournalEntry"> {
-    static override documentName: "JournalEntry";
-
-    protected override _getEntryContextOptions(): foundry.applications.ux.ContextMenu.Entry<JQuery>[];
-  }
-
-  namespace JournalDirectory {
-    interface Any extends AnyJournalDirectory {}
-    interface AnyConstructor extends Identity<typeof AnyJournalDirectory> {}
-  }
-}
-
-declare abstract class AnyJournalDirectory extends JournalDirectory {
-  constructor(...args: never);
-}

package/src/foundry/client/apps/sidebar/tabs/macros-directory.d.mts

@@ -1,25 +0,0 @@
-import type { Identity } from "fvtt-types/utils";
-
-declare global {
-  /**
-   * The directory, not displayed in the sidebar, which organizes and displays world-level Macro documents.
-   *
-   * @see {@link Macros | `Macros`}        The WorldCollection of Macro Documents
-   * @see {@link Macro | `Macro`}         The Macro Document
-   * @see {@link MacroConfig | `MacroConfig`}   The Macro Configuration Sheet
-   */
-  class MacroDirectory extends DocumentDirectory<"Macro"> {
-    constructor(options?: Partial<DocumentDirectory.Options>);
-
-    static override documentName: "Macro";
-  }
-
-  namespace MacroDirectory {
-    interface Any extends AnyMacroDirectory {}
-    interface AnyConstructor extends Identity<typeof AnyMacroDirectory> {}
-  }
-}
-
-declare abstract class AnyMacroDirectory extends MacroDirectory {
-  constructor(...args: never);
-}

package/src/foundry/client/apps/sidebar/tabs/playlists-directory.d.mts

@@ -1,283 +0,0 @@
-import type { Identity } from "fvtt-types/utils";
-
-declare global {
-  /**
-   * The sidebar directory which organizes and displays world-level Playlist documents.
-   * @typeParam Options - The type of the options object
-   */
-  class PlaylistDirectory<
-    Options extends DocumentDirectory.Options = DocumentDirectory.Options,
-  > extends DocumentDirectory<"Playlist", Options> {
-    constructor(options?: Partial<Options>);
-
-    /**
-     * Track the playlist IDs which are currently expanded in their display
-     * @internal
-     */
-    protected _expanded: Set<string>;
-
-    /**
-     * Are the global volume controls currently expanded?
-     * @defaultValue `false`
-     * @internal
-     */
-    protected _volumeExpanded: boolean;
-
-    /**
-     * Cache the set of Playlist documents that are displayed as playing when the directory is rendered
-     * @defaultValue `[]`
-     */
-    protected _playingPlaylists: Playlist.Implementation[];
-
-    /**
-     * Cache the set of PlaylistSound documents that are displayed as playing when the directory is rendered
-     * @defaultValue `[]`
-     */
-    protected _playingSounds: PlaylistSound.Implementation[];
-
-    /**
-     * @internal
-     * @defaultValue `undefined`
-     * @remarks This is only initialized and set in `getData`.
-     */
-    protected _playingSoundsData?: PlaylistDirectory.SoundData[] | undefined;
-
-    static override documentName: "Playlist";
-
-    /**
-     * @defaultValue `"templates/sidebar/partials/playlist-partial.html"`
-     */
-    static override entryPartial: string;
-
-    /**
-     * @defaultValue
-     * ```typescript
-     * const options = super.defaultOptions;
-     * options.template = "templates/sidebar/playlists-directory.html";
-     * options.dragDrop[0].dragSelector = ".folder, .playlist-name, .sound-name";
-     * options.renderUpdateKeys = ["name", "playing", "mode", "sounds", "sort", "sorting", "folder"];
-     * options.contextMenuSelector = ".document .playlist-header";
-     * return options;
-     * ```
-     */
-    static override get defaultOptions(): DocumentDirectory.Options;
-
-    /**
-     * Initialize the set of Playlists which should be displayed in an expanded form
-     * @internal
-     */
-    protected _createExpandedSet(): Set<string>;
-
-    /**
-     * Return an Array of the Playlist documents which are currently playing
-     */
-    get playing(): Playlist.Implementation[];
-
-    /**
-     * Whether the "currently playing" element is pinned to the top or bottom of the display.
-     * @internal
-     */
-    protected get _playingLocation(): "top" | "bottom";
-
-    // TODO: Implement GetDataReturnType
-    override getData(options?: Partial<Options>): Promise<object>;
-
-    /**
-     * Converts a volume level to a human-friendly % value
-     * @param volume - Value between [0, 1] of the volume level
-     */
-    static volumeToTooltip(volume: number): string;
-
-    /**
-     * Augment the tree directory structure with playlist-level data objects for rendering
-     * @param node - The tree leaf node being prepared
-     * @internal
-     */
-    protected _prepareTreeData(node: DirectoryCollectionMixin.TreeNode<Playlist.Implementation>): void;
-
-    /**
-     * Create an object of rendering data for each Playlist document being displayed
-     * @param playlist - The playlist to display
-     * @returns The data for rendering
-     * @internal
-     */
-    protected _preparePlaylistData(playlist: Playlist.Implementation): PlaylistDirectory.PlaylistData;
-
-    /**
-     * Get the icon used to represent the "play/stop" icon for the PlaylistSound
-     * @param sound - The sound being rendered
-     * @returns The icon that should be used
-     * @internal
-     */
-    protected _getPlayIcon(sound: PlaylistSound.Implementation): string;
-
-    /**
-     * Get the icon used to represent the pause/loading icon for the PlaylistSound
-     * @param sound - The sound being rendered
-     * @returns The icon that should be used
-     * @internal
-     */
-    protected _getPauseIcon(sound: PlaylistSound.Implementation): string;
-
-    /**
-     * Given a constant playback mode, provide the FontAwesome icon used to display it
-     * @internal
-     */
-    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.PLAYLIST_MODES): string;
-
-    override activateListeners(html: JQuery): void;
-
-    /**
-     * Handle global volume change for the playlist sidebar
-     * @param event - The initial click event
-     * @internal
-     */
-    protected _onGlobalVolume(event: JQuery.ClickEvent): unknown;
-
-    override collapseAll(): void;
-
-    protected override _onClickEntryName(event: PointerEvent): Promise<void>;
-
-    /**
-     * Handle global volume control collapse toggle
-     * @param event - The initial click event
-     * @internal
-     */
-    protected _onVolumeCollapse(event: JQuery.ClickEvent): void;
-
-    /**
-     * Helper method to render the expansion or collapse of playlists
-     * @param speed - (default: `250`)
-     * @internal
-     */
-    protected _collapse(el: HTMLElement, collapse: boolean, speed?: number): void;
-
-    /**
-     * Handle Playlist playback state changes
-     * @param event   - The initial click event
-     * @param playing - Is the playlist now playing?
-     * @internal
-     */
-    protected _onPlaylistPlay(event: JQuery.ClickEvent, playing: boolean): Promise<Playlist.Implementation>;
-
-    /**
-     * Handle advancing the playlist to the next (or previous) sound
-     * @param event  - The initial click event
-     * @param action - The control action requested
-     * @internal
-     */
-    protected _onPlaylistSkip(event: JQuery.ClickEvent, action: string): Promise<Playlist.Implementation>;
-
-    /**
-     * Handle cycling the playback mode for a Playlist
-     * @param event - The initial click event
-     * @internal
-     */
-    protected _onPlaylistToggleMode(event: JQuery.ClickEvent): Promise<Playlist.Implementation>;
-
-    /**
-     * Handle Playlist track addition request
-     * @param event - The initial click event
-     * @internal
-     */
-    protected _onSoundCreate(event: JQuery.ClickEvent): void;
-
-    /**
-     * Modify the playback state of a Sound within a Playlist
-     * @param event  - The initial click event
-     * @param action - The sound control action performed
-     * @internal
-     */
-    protected _onSoundPlay(event: JQuery.ClickEvent, action: string): Promise<Playlist.Implementation | undefined>;
-
-    /**
-     * Handle volume adjustments to sounds within a Playlist
-     * @param event - The initial change event
-     * @internal
-     */
-    protected _onSoundVolume(event: JQuery.ChangeEvent): void;
-
-    /**
-     * Handle changes to the sound playback mode
-     * @param event - The initial click event
-     * @internal
-     */
-    protected _onSoundToggleMode(event: JQuery.ClickEvent): Promise<void>;
-
-    /** @internal */
-    protected _onPlayingPin(): void;
-
-    protected override _onSearchFilter(event: KeyboardEvent, query: string, rgx: RegExp, html: HTMLElement): void;
-
-    /**
-     * Update the displayed timestamps for all currently playing audio sources.
-     * Runs on an interval every 1000ms.
-     * @internal
-     */
-    protected _updateTimestamps(): void;
-
-    /**
-     * Format the displayed timestamp given a number of seconds as input
-     * @param seconds - The current playback time in seconds
-     * @returns The formatted timestamp
-     * @internal
-     */
-    protected _formatTimestamp(seconds: number): string;
-
-    protected override _contextMenu(html: JQuery): void;
-
-    protected override _getFolderContextOptions(): foundry.applications.ux.ContextMenu.Entry<JQuery>[];
-
-    protected override _getEntryContextOptions(): foundry.applications.ux.ContextMenu.Entry<JQuery>[];
-
-    /**
-     * Get context menu options for individual sound effects
-     * @returns The context options for each sound
-     * @internal
-     */
-    protected _getSoundContextOptions(): foundry.applications.ux.ContextMenu.Entry<JQuery>[];
-
-    protected override _onDragStart(event: DragEvent): void;
-
-    // eslint-disable-next-line @typescript-eslint/no-misused-promises
-    protected override _onDrop(event: DragEvent): Promise<Playlist.Implementation | boolean>;
-  }
-
-  namespace PlaylistDirectory {
-    interface Any extends AnyPlaylistDirectory {}
-    interface AnyConstructor extends Identity<typeof AnyPlaylistDirectory> {}
-
-    interface PlaylistData extends Playlist.Source {
-      modeTooltip: string;
-      modeIcon: string;
-      disabled: boolean;
-      expanded: boolean;
-      css: string;
-      controlCSS: string;
-      sounds: SoundData[];
-    }
-
-    interface SoundData extends PlaylistSound.Source {
-      playlistId: string | null;
-      css: string;
-      controlCSS: string;
-      playIcon: string;
-      playTitle: string;
-      isPaused?: boolean;
-      pauseIcon?: string;
-      lvolume?: number;
-      currentTime?: string;
-      durationTime?: string;
-    }
-  }
-}
-
-declare abstract class AnyPlaylistDirectory extends PlaylistDirectory<DocumentDirectory.Options> {
-  constructor(...args: never);
-}

package/src/foundry/client/apps/sidebar/tabs/roll-table-directory.d.mts

@@ -1,22 +0,0 @@
-import type { Identity } from "fvtt-types/utils";
-
-declare global {
-  /**
-   * The sidebar directory which organizes and displays world-level RollTable documents.
-   * @typeParam Options - The type of the options object
-   */
-  class RollTableDirectory extends DocumentDirectory<"RollTable"> {
-    static override documentName: "RollTable";
-
-    protected override _getEntryContextOptions(): foundry.applications.ux.ContextMenu.Entry<JQuery>[];
-  }
-
-  namespace RollTableDirectory {
-    interface Any extends AnyRollTableDirectory {}
-    interface AnyConstructor extends Identity<typeof AnyRollTableDirectory> {}
-  }
-}
-
-declare abstract class AnyRollTableDirectory extends RollTableDirectory {
-  constructor(...args: never);
-}