@league-of-foundry-developers/foundry-vtt-types 0.8.9-7 → 0.8.9-8

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

@@ -1,33 +1,33 @@
-// TODO: Remove when updating this class!!!
-// eslint-disable-next-line
-// @ts-nocheck
-
 /**
  * The World Management setup application
+ * @typeParam Options - The type of the options object
+ * @typeParam Data    - The data structure used to render the handlebars template.
  */
-declare class WorldConfig extends FormApplication<WorldConfig.Options, WorldConfig.Data, Game.World> {
+declare class WorldConfig<
+  Options extends WorldConfig.Options = WorldConfig.Options,
+  Data extends object = WorldConfig.Data
+> extends FormApplication<Options, Data, Game.WorldData<foundry.packages.WorldData>> {
   /**
    * @defaultValue
    * ```typescript
-   * mergeObject(super.defaultOptions, {
+   * foundry.utils.mergeObject(super.defaultOptions, {
    *   id: "world-config",
-   *   template: "templates/setup/world-config.html",
+   *   template: "templates/sidebar/apps/world-config.html",
    *   width: 600,
    *   height: "auto",
-   *   create: false
-   * });
+   *   create: false,
+   * })
    * ```
    */
   static get defaultOptions(): WorldConfig.Options;
 
+  static WORLD_KB_URL: 'https://foundryvtt.com/article/game-worlds/';
+
   /** @override */
   get title(): string;
 
-  /**
-   * @param options - (unused)
-   * @override
-   */
-  getData(options?: Partial<WorldConfig.Options>): WorldConfig.Data;
+  /** @override */
+  getData(options?: Partial<Options>): Data | Promise<Data>;
 
   /**
    * @remarks This method returns `Promise<void>`.
@@ -39,16 +39,22 @@ declare class WorldConfig extends FormApplication<WorldConfig.Options, WorldConf
    * @remarks This method does not exist on WorldConfig and only exists to make the typescript compile!
    */
   protected _updateObject(...args: unknown[]): Promise<unknown>;
+
+  /** @override **/
+  activateEditor(name: string, options?: TextEditor.Options, initialContent?: string): void;
 }
 
 declare namespace WorldConfig {
   interface Data {
-    world: WorldConfig['object'];
-    systems: Game.System[];
-    isCreate: WorldConfig['options']['create'];
+    world: Game.WorldData<foundry.packages.WorldData>;
+    isCreate: boolean;
     submitText: string;
     nextDate: string;
     nextTime: string;
+    worldKbUrl: typeof WorldConfig['WORLD_KB_URL'];
+    inWorld: boolean;
+    showEditFields: boolean;
+    systems?: Game.SystemData<foundry.packages.SystemData>[];
   }
 
   interface Options extends FormApplication.Options {
@@ -56,5 +62,7 @@ declare namespace WorldConfig {
      * @defaultValue `false`
      */
     create: boolean;
+
+    inWorld?: boolean;
   }
 }

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

@@ -133,10 +133,11 @@ declare global {
      */
     protected _canDragDrop(selector: string): boolean;
 
-    /** @override */
-    protected _onDrop(
-      event: DragEvent
-    ): void | ReturnType<InstanceType<ConfiguredDocumentClass<typeof User>>['assignHotbarMacro']>;
+    /**
+     * @override
+     * @internal
+     */
+    protected _onDrop(event: DragEvent): void;
 
     /**
      * Handle click events to toggle display of the macro bar

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

@@ -1,89 +1,108 @@
-// TODO: Remove when updating this class!!!
-// eslint-disable-next-line
-// @ts-nocheck
-
-/**
- * Top menu scene navigation
- */
-declare class SceneNavigation extends Application {
-  /**
-   * Assign the default options which are supported by the SceneNavigation UI
-   * @defaultValue
-   * ```typescript
-   * {
-   *   ...super.defaultOptions,
-   *   id: 'navigation',
-   *   template: 'templates/hud/navigation.html',
-   *   popOut: false,
-   *   dragDrop: [{dragSelector: ".scene"}]
-   * }
-   * ```
-   */
-  static get defaultOptions(): typeof Application['defaultOptions'];
+import type { ConfiguredDocumentClassForName, ToObjectFalseType } from '../../../types/helperTypes';
 
+declare global {
   /**
-   * Return an Array of Scenes which are displayed in the Navigation bar
+   * The UI element which displays the Scene documents which are currently enabled for quick navigation.
+   *
+   * @typeParam Options - the type of the options object
+   * @typeParam Data    - The data structure used to render the handlebars template.
    */
-  get scenes(): Scene[];
+  class SceneNavigation<
+    Options extends Application.Options = Application.Options,
+    Data extends object = SceneNavigation.Data
+  > extends Application<Options> {
+    constructor(options?: Partial<Options>);
 
-  /** @override */
-  render(force?: boolean, options?: Application.RenderOptions): this | undefined;
+    /**
+     * Navigation collapsed state
+     * @internal
+     */
+    protected _collapsed: boolean;
 
-  /** @override */
-  protected _render(force?: boolean, options?: Application.RenderOptions): Promise<void>;
+    /**
+     * @override
+     * @defaultValue
+     * ```typescript
+     * foundry.utils.mergeObject(super.defaultOptions, {
+     *   id: "navigation",
+     *   template: "templates/hud/navigation.html",
+     *   popOut: false,
+     *   dragDrop: [{ dragSelector: ".scene" }],
+     * })
+     * ```
+     */
+    static get defaultOptions(): Application.Options;
 
-  /** @override */
-  getData(options?: Partial<Application.Options>): SceneNavigation.Data | Promise<SceneNavigation.Data>;
+    /**
+     * Return an Array of Scenes which are displayed in the Navigation bar
+     */
+    get scenes(): InstanceType<ConfiguredDocumentClassForName<'Scene'>>[];
 
-  /**
-   * Expand the SceneNavigation menu, sliding it down if it is currently collapsed
-   */
-  expand(): Promise<boolean>;
+    /** @override */
+    render(force?: boolean, context?: Application.RenderOptions<Options>): this | void;
 
-  /**
-   * Collapse the SceneNavigation menu, sliding it up if it is currently expanded
-   */
-  collapse(): Promise<boolean>;
+    /** @override */
+    protected _render(force?: boolean, options?: Application.RenderOptions<Options>): Promise<void>;
 
-  /**
-   * Activate Scene Navigation event listeners
-   */
-  activateListeners(html: JQuery): void;
+    /** @override */
+    getData(options?: Partial<Application.Options>): Data | Promise<Data>;
 
-  /**
-   * Get the set of ContextMenu options which should be applied for Scenes in the menu
-   */
-  private _getContextMenuOptions(): ContextMenuEntry[];
+    /**
+     * Expand the SceneNavigation menu, sliding it down if it is currently collapsed
+     */
+    expand(): Promise<boolean>;
 
-  /**
-   * Handle left-click events on the scenes in the navigation menu
-   */
-  private _onClickScene(event: JQuery.ClickEvent): void;
+    /**
+     * Collapse the SceneNavigation menu, sliding it up if it is currently expanded
+     */
+    collapse(): Promise<boolean>;
 
-  /** @override */
-  protected _onDragStart(event: DragEvent): void;
+    /** @override */
+    activateListeners(html: JQuery): void;
 
-  /** @override */
-  protected _onDrop(event: DragEvent): Promise<boolean | undefined | void>;
+    /**
+     * Get the set of ContextMenu options which should be applied for Scenes in the menu
+     * @returns The Array of context options passed to the ContextMenu instance
+     * @internal
+     */
+    protected _getContextMenuOptions(): ContextMenuEntry[];
 
-  /** @override */
-  private _onToggleNav(event: JQuery.ClickEvent): void;
+    /**
+     * Handle left-click events on the scenes in the navigation menu
+     * @internal
+     */
+    protected _onClickScene(event: JQuery.ClickEvent): void;
 
-  /**
-   * Updated the loading progress bar
-   * @param context - The message to display in the progress back
-   * @param pct     - The percentage the progress bar has completed
-   */
-  static _onLoadProgress(context: string, pct: number): void;
-}
+    /**
+     * @override
+     * @internal
+     */
+    protected _onDragStart(event: DragEvent): void;
+
+    /**
+     * @override
+     * @internal
+     */
+    protected _onDrop(event: DragEvent): void;
+
+    /**
+     * Handle navigation menu toggle click events
+     * @internal
+     */
+    protected _onToggleNav(event: JQuery.ClickEvent): void;
+
+    static _onLoadProgress(context: string, pct: number): void;
+  }
 
-declare namespace SceneNavigation {
-  interface Data {
-    collapsed: boolean;
-    scenes: (foundry.utils.Duplicated<Scene['data']> & {
-      users: { letter: string; color: User['data']['color'] };
-      visible: boolean;
-      css: [string | null];
-    })[];
+  namespace SceneNavigation {
+    interface Data {
+      collapsed: boolean;
+      scenes: (ToObjectFalseType<foundry.data.SceneData> & {
+        name: string;
+        users: { letter: string; color: string };
+        visible: boolean;
+        css: string;
+      })[];
+    }
   }
 }

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

@@ -1,67 +1,24 @@
-// TODO: Remove when updating this class!!!
-// eslint-disable-next-line
-// @ts-nocheck
-
 /**
- * A directory list of Actor entities in the Sidebar
- * @see {@link Actor}
+ * The sidebar directory which organizes and displays world-level Actor documents.
  */
-declare class ActorDirectory extends SidebarDirectory {
-  /**
-   * @override
-   */
-  static get entity(): 'Actor';
-
-  /**
-   * @override
-   * @see {@link Game.actors}
-   */
-  static get collection(): Game['actors'];
+declare class ActorDirectory extends SidebarDirectory<'Actor'> {
+  constructor(...args: ConstructorParameters<typeof SidebarDirectory>);
 
-  /**
-   * @param options - (unused)
-   * @override
-   */
-  getData(options?: Partial<SidebarDirectory.Options>): ActorDirectory.Data;
+  /** @override */
+  static documentName: 'Actor';
 
-  /**
-   * @param selector - (unused)
-   * @override
-   */
-  protected _canDragStart(selector: string | null): boolean;
+  /** @override */
+  protected _canDragStart(selector: string): boolean;
 
-  /**
-   * @override
-   */
-  protected _onDragStart(event: DragEvent): false | void;
+  /**  @override */
+  protected _onDragStart(event: DragEvent): void;
 
-  /**
-   * @param selector - (unused)
-   * @override
-   */
-  protected _canDragDrop(selector: string | null): boolean;
+  /** @override */
+  protected _canDragDrop(selector: string): boolean;
 
-  /**
-   * @override
-   */
+  /** @override */
   protected _onClickEntityName(event: JQuery.ClickEvent): Promise<void>;
 
-  /**
-   * @override
-   */
+  /** @override */
   protected _getEntryContextOptions(): ContextMenuEntry[];
 }
-
-declare namespace ActorDirectory {
-  interface Data extends SidebarDirectory.Data {
-    /**
-     * @defaultValue `'templates/sidebar/folder-partial.html'`
-     */
-    folderPartial: string;
-
-    /**
-     * @defaultValue `'templates/sidebar/actor-partial.html'`
-     */
-    entityPartial: string;
-  }
-}

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

@@ -1,36 +1,13 @@
-// TODO: Remove when updating this class!!!
-// eslint-disable-next-line
-// @ts-nocheck
-
 /**
- * A directory of Item entities in the Sidebar
+ * The sidebar directory which organizes and displays world-level Item documents.
  */
-declare class ItemDirectory extends SidebarDirectory {
-  /**
-   * @override
-   */
-  static get entity(): 'Item';
-
-  /**
-   * @override
-   * @see {@link Game.items}
-   */
-  static get collection(): Game['items'];
-
-  /**
-   * @param selector - (unused)
-   * @override
-   */
-  protected _canDragStart(selector: string | null): boolean;
+declare class ItemDirectory extends SidebarDirectory<'Item'> {
+  /** @override */
+  static documentName: 'Item';
 
-  /**
-   * @param selector - (unused)
-   * @override
-   */
-  protected _canDragDrop(selector: string | null): boolean;
+  /** @override */
+  protected _canDragDrop(selector: string): boolean;
 
-  /**
-   * @override
-   */
+  /** @override */
   protected _getEntryContextOptions(): ContextMenuEntry[];
 }

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

@@ -1,47 +1,27 @@
 /**
- * A directory list of JournalEntry entities in the Sidebar
+ * The sidebar directory which organizes and displays world-level JournalEntry documents.
  */
-// TODO: Remove when this class is updated!!!
-// eslint-disable-next-line
-// @ts-ignore
-declare class JournalDirectory extends SidebarDirectory<JournalDirectory.Options> {
-  /**
-   * @override
-   */
-  static get defaultOptions(): JournalDirectory.Options;
-
-  /**
-   * @override
-   */
-  get title(): string;
+declare class JournalDirectory extends SidebarDirectory<'JournalEntry'> {
+  /** @override */
+  static documentName: 'JournalEntry';
 
   /**
    * @override
+   * @defaultValue
+   * ```typescript
+   * const options = super.defaultOptions;
+   * options.id = "journal";
+   * options.template = "templates/sidebar/journal-directory.html";
+   * return options;
+   * ```
    */
-  static get entity(): 'JournalEntry';
+  static get defaultOptions(): SidebarDirectory.Options;
 
   /**
    * @override
-   * @see {@link Game.journal}
    */
-  static get collection(): Game['journal'];
+  get title(): string;
 
-  /**
-   * @override
-   */
+  /** @override */
   protected _getEntryContextOptions(): ContextMenuEntry[];
 }
-
-declare namespace JournalDirectory {
-  interface Options extends SidebarDirectory.Options {
-    /**
-     * @defaultValue `'journal'`
-     */
-    id: string;
-
-    /**
-     * @defaultValue `'templates/sidebar/journal-directory.html'`
-     */
-    template: string;
-  }
-}

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

@@ -1,65 +1,19 @@
 /**
- * A directory list of Macro entities. Unlike other directories, this app is only rendered in pop-out mode.
+ * The directory, not displayed in the sidebar, which organizes and displays world-level Macro documents.
  *
- * @see {@link Macros}        The EntityCollection of Macro Entities
+ * @see {@link Macros}        The WorldCollection of Macro Entities
  * @see {@link Macro}         The Macro Entity
  * @see {@link MacroConfig}   The Macro Configuration Sheet
  */
-// TODO: Remove when this class is updated!!!
-// eslint-disable-next-line
-// @ts-ignore
-declare class MacroDirectory extends SidebarDirectory<MacroDirectory.Options> {
-  static get defaultOptions(): MacroDirectory.Options;
+declare class MacroDirectory extends SidebarDirectory<'Macro'> {
+  constructor(options?: Partial<SidebarDirectory.Options>);
 
-  /**
-   * @override
-   */
-  static get entity(): 'Macro';
-
-  /**
-   * @override
-   * @see {@link Game.macros}
-   */
-  static get collection(): Game['macros'];
-
-  /**
-   * @override
-   */
-  protected _render(force?: boolean, options?: SidebarDirectory.RenderContext<MacroDirectory.Options>): Promise<void>;
+  /** @override */
+  static documentName: 'Macro';
 
   /**
    * @override
    * @remarks This is never called.
    */
   protected _onCreate(event: Event): Promise<void>;
-
-  /**
-   * @param selector - (unused)
-   * @override
-   */
-  protected _canDragStart(selector: string | null): true;
-}
-
-declare namespace MacroDirectory {
-  interface Options extends SidebarDirectory.Options {
-    /**
-     * @defaultValue `'macros'`
-     */
-    id: string;
-
-    /**
-     * @defaultValue `'templates/sidebar/macro-directory.html'`
-     */
-    template: string;
-
-    /**
-     * @defaultValue `true`
-     */
-    canDrag: boolean;
-
-    /**
-     * @defaultValue `680`
-     */
-    height: number;
-  }
 }

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

@@ -1,30 +1,13 @@
-// TODO: Remove when updating this class!!!
-// eslint-disable-next-line
-// @ts-nocheck
-
 /**
  * A directory listing of active game scenes
  */
-declare class SceneDirectory extends SidebarDirectory {
-  /**
-   * @override
-   */
-  static get entity(): 'Scene';
-
-  /**
-   * @override
-   * @see {@link Game.scenes}
-   */
-  static get collection(): Game['scenes'];
+declare class SceneDirectory extends SidebarDirectory<'Scene'> {
+  /** @override */
+  static documentName: 'Scene';
 
-  /**
-   * @override
-   * @remarks This is never called.
-   */
-  protected _onCreate(event: Event): Promise<Scene>;
+  /** @override */
+  protected _render(force?: boolean, options?: Application.RenderOptions<SidebarDirectory.Options>): Promise<void>;
 
-  /**
-   * @override
-   */
+  /** @override */
   protected _getEntryContextOptions(): ContextMenuEntry[];
 }

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

@@ -168,11 +168,9 @@ declare global {
 
     /**
      * @override
-     * @remarks
-     * The return type could be specified in more detail but it is not supposed to be used and this allows more
-     * flexibility for deriving classes.
+     * @internal
      */
-    protected _onDrop(event: DragEvent): unknown;
+    protected _onDrop(event: DragEvent): void;
 
     /**
      * Handle Document data being dropped into the directory.

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

@@ -4,9 +4,9 @@
  */
 declare class CameraPopoutAppWrapper {
   /**
-   * @param view- The CameraViews application that this popout belongs to
-   * @param userId- ID of the user this popout belongs to
-   * @param element- The div element of this specific popout window
+   * @param view    - The CameraViews application that this popout belongs to
+   * @param userId  - ID of the user this popout belongs to
+   * @param element - The div element of this specific popout window
    */
   constructor(view: CameraViews, userId: string, element: JQuery);
 
@@ -25,16 +25,21 @@ declare class CameraPopoutAppWrapper {
    */
   userId: string;
 
+  /** @defaultValue `true` */
+  popOut: boolean;
+
+  /** @defaultValue `{}` */
+  options: Record<string, unknown>;
+
   /**
    * Get the current position of this popout window
    */
   get position(): Application.Position;
 
-  /** @override */
-  setPosition({ left, top, width, height, scale }?: Partial<Application.Position>): void;
+  setPosition(options?: Partial<Application.Position>): (Application.Position & { height: number }) | void;
 
-  private _onResize(event: Event): void;
+  /** @internal */
+  protected _onResize(event: Event): void;
 
-  /** @override */
   bringToTop(): void;
 }

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

@@ -399,8 +399,9 @@ declare global {
 
     /**
      * Event handler for the drop portion of a drag-and-drop event.
+     * @internal
      */
-    protected _onDrop(event: DragEvent): unknown;
+    protected _onDrop(event: DragEvent): void;
 
     /**
      * Add a pending canvas operation that should fire once the socket handling workflow concludes.