@league-of-foundry-developers/foundry-vtt-types 9.242.0 → 9.249.2

package/src/foundry/foundry.js/applications/formApplications/documentSheets/userConfig.d.ts

@@ -7,7 +7,7 @@ declare global {
    * @typeParam Data    - The data structure used to render the handlebars template.
    */
   class UserConfig<
-    Options extends DocumentSheet.Options = UserConfig.Options,
+    Options extends DocumentSheetOptions = UserConfig.Options,
     Data extends object = UserConfig.Data<Options>
   > extends DocumentSheet<Options, Data, InstanceType<ConfiguredDocumentClass<typeof User>>> {
     /**
@@ -48,32 +48,32 @@ declare global {
   }
 
   namespace UserConfig {
-    interface Data<Options extends DocumentSheet.Options> {
+    interface Data<Options extends DocumentSheetOptions> {
       user: InstanceType<ConfiguredDocumentClass<typeof User>>;
       actors: InstanceType<ConfiguredDocumentClass<typeof Actor>>[];
       options: Options;
     }
 
-    interface Options extends DocumentSheet.Options {
+    interface Options extends DocumentSheetOptions {
       /**
        * @defaultValue `["sheet", "user-config"]`
        */
-      classes: DocumentSheet.Options['classes'];
+      classes: DocumentSheetOptions['classes'];
 
       /**
        * @defaultValue `"templates/user/user-config.html"`
        */
-      template: DocumentSheet.Options['template'];
+      template: DocumentSheetOptions['template'];
 
       /**
        * @defaultValue `400`
        */
-      width: DocumentSheet.Options['width'];
+      width: DocumentSheetOptions['width'];
 
       /**
        * @defaultValue `auto`
        */
-      height: DocumentSheet.Options['height'];
+      height: DocumentSheetOptions['height'];
     }
   }
 }

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

@@ -94,7 +94,7 @@ declare global {
       z: number | null;
     }
 
-    interface Options extends FormApplication.Options {
+    interface Options extends FormApplicationOptions {
       /**
        * Configure the default drawing settings, instead of a specific Drawing
        * @defaultValue `false`

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

@@ -8,7 +8,7 @@ declare global {
    * @typeParam ConcreteDocument - The type of the Document which is being managed
    */
   class EntitySheetConfig<
-    Options extends FormApplication.Options = FormApplication.Options,
+    Options extends FormApplicationOptions = FormApplicationOptions,
     Data extends object = EntitySheetConfig.Data<foundry.abstract.Document<any, any>, Options>,
     ConcreteDocument extends foundry.abstract.Document<any, any> = Data extends EntitySheetConfig.Data<infer T>
       ? T
@@ -24,7 +24,7 @@ declare global {
      * })
      * ```
      */
-    static get defaultOptions(): FormApplication.Options;
+    static get defaultOptions(): FormApplicationOptions;
 
     /**
      * An array of pending sheet assignments which are submitted before other elements of the framework are ready.
@@ -64,7 +64,7 @@ declare global {
     static registerSheet(
       documentClass: DocumentConstructor,
       scope: string,
-      sheetClass: ConstructorOf<Application>,
+      sheetClass: ConstructorOf<FormApplication<FormApplicationOptions, any, any>>,
       { label, types, makeDefault }?: EntitySheetConfig.RegisterSheetOptions
     ): void;
 
@@ -91,7 +91,7 @@ declare global {
     static unregisterSheet(
       documentClass: DocumentConstructor,
       scope: string,
-      sheetClass: ConstructorOf<Application>,
+      sheetClass: ConstructorOf<FormApplication<FormApplicationOptions, any, any>>,
       { types }?: { types?: string[] }
     ): void;
 
@@ -137,7 +137,7 @@ declare global {
      */
     interface Data<
       ConcreteDocument extends foundry.abstract.Document<any, any>,
-      Options extends FormApplication.Options = FormApplication.Options
+      Options extends FormApplicationOptions = FormApplicationOptions
     > {
       isGM: boolean;
       object: foundry.utils.Duplicated<ConcreteDocument['data']>;

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

@@ -5,7 +5,7 @@ declare global {
    * A tool for fine tuning the grid in a Scene
    * @typeParam Options - the type of the options object
    */
-  class GridConfig<Options extends FormApplication.Options = FormApplication.Options> extends FormApplication<
+  class GridConfig<Options extends FormApplicationOptions = FormApplicationOptions> extends FormApplication<
     Options,
     GridConfig.Data,
     InstanceType<ConfiguredDocumentClass<typeof Scene>>

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

@@ -91,7 +91,7 @@ declare class ImagePopout extends FormApplication<ImagePopout.Options, ImagePopo
 }
 
 declare namespace ImagePopout {
-  interface Options extends FormApplication.Options {
+  interface Options extends FormApplicationOptions {
     /**
      * @defaultValue `'templates/apps/image-popout.html'`
      */

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

@@ -2,7 +2,7 @@
  * Allows for viewing and editing of Keybinding Actions
  */
 declare class KeybindingsConfig<
-  Options extends FormApplication.Options = FormApplication.Options,
+  Options extends FormApplicationOptions = FormApplicationOptions,
   Data extends KeybindingsConfig.Data = KeybindingsConfig.Data
 > extends FormApplication<Options, Data> {
   /**
@@ -37,7 +37,7 @@ declare class KeybindingsConfig<
    * })
    * ```
    */
-  static get defaultOptions(): FormApplication.Options;
+  static get defaultOptions(): FormApplicationOptions;
 
   /**
    * @param options - (unused)

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

@@ -7,7 +7,7 @@
  */
 
 declare class ModuleManagement<
-  Options extends FormApplication.Options = FormApplication.Options,
+  Options extends FormApplicationOptions = FormApplicationOptions,
   Data extends object = ModuleManagement.Data
 > extends FormApplication<Options, Data, undefined> {
   /**
@@ -50,7 +50,7 @@ declare class ModuleManagement<
    * });
    * ```
    */
-  static get defaultOptions(): FormApplication.Options;
+  static get defaultOptions(): FormApplicationOptions;
 
   /** @override */
   get isEditable(): boolean;

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

@@ -1,7 +1,7 @@
 /**
  * An application for configuring the permissions which are available to each User role.
  */
-declare class PermissionConfig extends FormApplication<FormApplication.Options, PermissionConfig.Data> {
+declare class PermissionConfig extends FormApplication<FormApplicationOptions, PermissionConfig.Data> {
   /**
    * @override
    * @defaultValue
@@ -23,7 +23,7 @@ declare class PermissionConfig extends FormApplication<FormApplication.Options,
    * @param options - (unused)
    * @override
    */
-  getData(options?: Partial<FormApplication.Options>): PermissionConfig.Data;
+  getData(options?: Partial<FormApplicationOptions>): PermissionConfig.Data;
 
   /**
    * Prepare the permissions object used to render the configuration template

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

@@ -8,7 +8,7 @@ declare global {
    * @typeParam Data    - The data structure used to render the handlebars template.
    */
   class SettingsConfig<
-    Options extends FormApplication.Options = FormApplication.Options,
+    Options extends FormApplicationOptions = FormApplicationOptions,
     Data extends object = SettingsConfig.Data
   > extends FormApplication<Options, Data> {
     /**

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

@@ -1,5 +1,5 @@
 import type { ConfiguredDocumentClassForName } from '../../../../types/helperTypes';
-import type { TokenDataConstructorData } from '../../../common/data/data.mjs/tokenData.js';
+import type { TokenDataConstructorData } from '../../../common/data/data.mjs/tokenData';
 
 declare global {
   /**
@@ -8,7 +8,7 @@ declare global {
    * @typeParam Data    - The data structure used to render the handlebars template.
    */
   class TokenConfig<
-    Options extends FormApplication.Options = FormApplication.Options,
+    Options extends FormApplicationOptions = FormApplicationOptions,
     Data extends object = TokenConfig.Data<Options>
   > extends FormApplication<
     Options,
@@ -37,7 +37,7 @@ declare global {
      * })
      * ```
      */
-    static get defaultOptions(): FormApplication.Options;
+    static get defaultOptions(): FormApplicationOptions;
 
     /** @override */
     get id(): string;
@@ -103,7 +103,7 @@ declare global {
       value: string[][];
     }
 
-    interface Data<Options extends FormApplication.Options = FormApplication.Options> {
+    interface Data<Options extends FormApplicationOptions = FormApplicationOptions> {
       cssClasses: string;
       isPrototype: boolean;
       hasAlternates: boolean;

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: {

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,7 +3,7 @@
  * @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>);
   /**
@@ -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,5 +1,5 @@
 import { ConfiguredDocumentClass } from '../../../../types/helperTypes';
-import type { ChatMessageDataConstructorData } from '../../../common/data/data.mjs/chatMessageData.js';
+import type { ChatMessageDataConstructorData } from '../../../common/data/data.mjs/chatMessageData';
 
 declare global {
   /**
@@ -302,7 +302,7 @@ declare global {
       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)

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)