@league-of-foundry-developers/foundry-vtt-types 9.249.4 → 9.255.2

package/src/foundry/foundry.js/clientDocuments/user.d.ts

@@ -90,7 +90,7 @@ declare global {
 
     /**
      * Assign a Macro to a numbered hotbar slot between 1 and 50
-     * @param macro    - The Macro entity to assign
+     * @param macro    - The Macro document to assign
      * @param slot     - A specific numbered hotbar slot to fill
      * @param fromSlot - An optional origin slot from which the Macro is being shifted
      * @returns A Promise which resolves once the User update is complete
@@ -120,7 +120,7 @@ declare global {
     broadcastActivity(activityData?: ActivityData): void;
 
     /**
-     * Get an Array of Macro Entities on this User's Hotbar by page
+     * Get an Array of Macro Documents on this User's Hotbar by page
      * @param page - The hotbar page number
      *               (default: `1`)
      */
@@ -145,16 +145,6 @@ declare global {
     /** @override  */
     _onDelete(options: DocumentModificationOptions, userId: string): void;
 
-    /**
-     * @deprecated since 0.8.0
-     */
-    isRole(role: Parameters<User['hasRole']>[0]): boolean;
-
-    /**
-     * @deprecated since 0.8.0
-     */
-    setPermission(permission: keyof typeof CONST.USER_PERMISSIONS, allowed: boolean): Promise<this>;
-
     /** @remarks This property is set by PlayerList.getData() */
     charname?: string;
 

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

@@ -1,249 +1,222 @@
-/**
- * A class responsible for managing defined game settings or settings menus.
- * Each setting is a string key/value pair belonging to a certain package and a certain store scope.
- *
- * When Foundry Virtual Tabletop is initialized, a singleton instance of this class is constructed within the global
- * Game object as as game.settings.
- *
- * @see {@link Game#settings}
- * @see {@link Settings}
- * @see {@link SettingsConfig}
- */
-declare class ClientSettings {
-  constructor(worldSettings?: Setting['data']['_source'][]);
+import type { DocumentSubTypes, DocumentType } from '../../types/helperTypes';
 
-  /**
-   * A object of registered game settings for this scope
-   */
-  settings: Map<string, ClientSettings.CompleteSetting>;
+import type { TokenDataSource } from '../common/data/data.mjs/tokenData';
 
+declare global {
   /**
-   * Registered settings menus which trigger secondary applications
+   * A class responsible for managing defined game settings or settings menus.
+   * Each setting is a string key/value pair belonging to a certain package and a certain store scope.
+   *
+   * When Foundry Virtual Tabletop is initialized, a singleton instance of this class is constructed within the global
+   * Game object as as game.settings.
+   *
+   * @see {@link Game#settings}
+   * @see {@link Settings}
+   * @see {@link SettingsConfig}
    */
-  menus: Map<string, ClientSettings.CompleteMenuSetting>;
+  class ClientSettings {
+    constructor(worldSettings?: Setting['data']['_source'][]);
 
-  /**
-   * The storage interfaces used for persisting settings
-   * Each storage interface shares the same API as window.localStorage
-   * @remarks This is a lie, it doesn't actually have the same interface...
-   */
-  storage: Map<string, Storage | WorldSettings>;
+    /**
+     * A object of registered game settings for this scope
+     */
+    settings: Map<string, SettingConfig>;
 
-  /**
-   * The types of settings which should be constructed as a primitive type
-   */
-  protected static PRIMITIVE_TYPES: [typeof String, typeof Number, typeof Boolean, typeof Array];
+    /**
+     * Registered settings menus which trigger secondary applications
+     */
+    menus: Map<string, SettingSubmenuConfig>;
 
-  /**
-   * Return a singleton instance of the Game Settings Configuration app
-   */
-  get sheet(): SettingsConfig;
+    /**
+     * The storage interfaces used for persisting settings
+     * Each storage interface shares the same API as window.localStorage
+     * @remarks This is a lie, it doesn't actually have the same interface...
+     */
+    storage: Map<string, Storage | WorldSettings>;
 
-  /**
-   * Register a new game setting under this setting scope
-   *
-   * @param module - The namespace under which the setting is registered
-   * @param key    - The key name for the setting under the namespace module
-   * @param data   - Configuration for setting data
-   * @typeParam M  - The module name to register the setting for
-   * @typeParam K  - The key to register the setting for
-   * @typeParam T  - The type of the setting value
-   *
-   * @example
-   * ```typescript
-   * // Register a client setting
-   * game.settings.register("myModule", "myClientSetting", {
-   *   name: "Register a Module Setting with Choices",
-   *   hint: "A description of the registered setting and its behavior.",
-   *   scope: "client",     // This specifies a client-stored setting
-   *   config: true,        // This specifies that the setting appears in the configuration view
-   *   type: String,
-   *   choices: {           // If choices are defined, the resulting setting will be a select menu
-   *     "a": "Option A",
-   *     "b": "Option B"
-   *   },
-   *   default: "a",        // The default value for the setting
-   *   onChange: value => { // A callback function which triggers when the setting is changed
-   *     console.log(value)
-   *   }
-   * });
-   * ```
-   *
-   * @example
-   * ```typescript
-   * // Register a world setting
-   * game.settings.register("myModule", "myWorldSetting", {
-   *   name: "Register a Module Setting with a Range slider",
-   *   hint: "A description of the registered setting and its behavior.",
-   *   scope: "world",      // This specifies a world-level setting
-   *   config: true,        // This specifies that the setting appears in the configuration view
-   *   type: Number,
-   *   range: {             // If range is specified, the resulting setting will be a range slider
-   *     min: 0,
-   *     max: 100,
-   *     step: 10
-   *   }
-   *   default: 50,         // The default value for the setting
-   *   onChange: value => { // A callback function which triggers when the setting is changed
-   *     console.log(value)
-   *   }
-   * });
-   * ```
-   */
-  register<M extends string, K extends string, T>(
-    module: M,
-    key: K,
-    data: ClientSettings.Values[`${M}.${K}`] extends boolean | number | bigint | string | symbol | object
-      ? ClientSettings.PartialSetting<ClientSettings.Values[`${M}.${K}`]>
-      : ClientSettings.PartialSetting<T>
-  ): void;
+    /**
+     * The types of settings which should be constructed as a primitive type
+     */
+    protected static PRIMITIVE_TYPES: [typeof String, typeof Number, typeof Boolean, typeof Array];
 
-  /**
-   * Register a new sub-settings menu
-   *
-   * @param module - The namespace under which the menu is registered
-   * @param key    - The key name for the setting under the namespace module
-   * @param data   - Configuration for setting data
-   * @typeParam M  - The module name to register the menu setting for
-   * @typeParam K  - The key to register the menu setting for
-   *
-   * @example
-   * ```typescript
-   * // Define a settings submenu which handles advanced configuration needs
-   * game.settings.registerMenu("myModule", "mySettingsMenu", {
-   *   name: "My Settings Submenu",
-   *   label: "Settings Menu Label",      // The text label used in the button
-   *   hint: "A description of what will occur in the submenu dialog.",
-   *   icon: "fas fa-bars",               // A Font Awesome icon used in the submenu button
-   *   type: MySubmenuApplicationClass,   // A FormApplication subclass which should be created
-   *   restricted: true                   // Restrict this submenu to gamemaster only?
-   * });
-   * ```
-   */
-  registerMenu<M extends string, K extends string>(
-    module: M,
-    key: K,
-    data: ClientSettings.RegisteredMenuSettings[`${M}.${K}`]
-  ): void;
-
-  /**
-   * Get the value of a game setting for a certain module and setting key
-   *
-   * @param module - The module namespace under which the setting is registered
-   * @param key    - The setting key to retrieve
-   * @typeParam M  - The module name to register the get for
-   * @typeParam K  - The key to get the setting for
-   *
-   * @example
-   * ```typescript
-   * // Retrieve the current setting value
-   * game.settings.get("myModule", "myClientSetting");
-   * ```
-   */
-  get<M extends string, K extends string>(module: M, key: K): ClientSettings.Values[`${M}.${K}`];
+    /**
+     * Return a singleton instance of the Game Settings Configuration app
+     */
+    get sheet(): SettingsConfig;
 
-  /**
-   * Set the value of a game setting for a certain module and setting key
-   *
-   * @param module - The module namespace under which the setting is registered
-   * @param key    - The setting key to retrieve
-   * @param value  - The data to assign to the setting key
-   * @typeParam M  - The module name to register the get for
-   * @typeParam K  - The key to get the setting for
-   * @typeParam V  - The value type to get the value for
-   *
-   * @example
-   * ```typescript
-   * // Update the current value of a setting
-   * game.settings.set("myModule", "myClientSetting", "b");
-   * ```
-   */
-  set<M extends string, K extends string, V extends ClientSettings.Values[`${M}.${K}`]>(
-    module: M,
-    key: K,
-    value: V
-  ): Promise<V>;
-}
+    /**
+     * Register a new game setting under this setting scope
+     *
+     * @param namespace - The namespace under which the setting is registered
+     * @param key       - The key name for the setting under the namespace module
+     * @param data      - Configuration for setting data
+     * @typeParam N     - The namespace under which the setting is registered, as a type
+     * @typeParam K     - The key name for the setting under the namespace module, as a type
+     * @typeParam T     - The type of the setting value
+     *
+     * @example
+     * ```typescript
+     * // Register a client setting
+     * game.settings.register("myModule", "myClientSetting", {
+     *   name: "Register a Module Setting with Choices",
+     *   hint: "A description of the registered setting and its behavior.",
+     *   scope: "client",     // This specifies a client-stored setting
+     *   config: true,        // This specifies that the setting appears in the configuration view
+     *   type: String,
+     *   choices: {           // If choices are defined, the resulting setting will be a select menu
+     *     "a": "Option A",
+     *     "b": "Option B"
+     *   },
+     *   default: "a",        // The default value for the setting
+     *   onChange: value => { // A callback function which triggers when the setting is changed
+     *     console.log(value)
+     *   }
+     * });
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Register a world setting
+     * game.settings.register("myModule", "myWorldSetting", {
+     *   name: "Register a Module Setting with a Range slider",
+     *   hint: "A description of the registered setting and its behavior.",
+     *   scope: "world",      // This specifies a world-level setting
+     *   config: true,        // This specifies that the setting appears in the configuration view
+     *   type: Number,
+     *   range: {             // If range is specified, the resulting setting will be a range slider
+     *     min: 0,
+     *     max: 100,
+     *     step: 10
+     *   }
+     *   default: 50,         // The default value for the setting
+     *   onChange: value => { // A callback function which triggers when the setting is changed
+     *     console.log(value)
+     *   }
+     * });
+     * ```
+     */
+    register<N extends string, K extends string, T>(
+      namespace: N,
+      key: K,
+      data: ClientSettings.Values[`${N}.${K}`] extends string | number | boolean | Array<any> | object
+        ? ClientSettings.PartialSettingConfig<ClientSettings.Values[`${N}.${K}`]>
+        : ClientSettings.PartialSettingConfig<T>
+    ): void;
 
-declare namespace ClientSettings {
-  interface CompleteSetting<T = unknown> extends PartialSetting<T> {
-    key: string;
-    module: string;
-  }
+    /**
+     * Register a new sub-settings menu
+     *
+     * @param namespace - The namespace under which the menu is registered
+     * @param key       - The key name for the setting under the namespace module
+     * @param data      - Configuration for setting data
+     * @typeParam N     - The namespace under which the menu is registered, as a type
+     * @typeParam K     - The key name for the setting under the namespace module, as a type
+     *
+     * @example
+     * ```typescript
+     * // Define a settings submenu which handles advanced configuration needs
+     * game.settings.registerMenu("myModule", "mySettingsMenu", {
+     *   name: "My Settings Submenu",
+     *   label: "Settings Menu Label",      // The text label used in the button
+     *   hint: "A description of what will occur in the submenu dialog.",
+     *   icon: "fas fa-bars",               // A Font Awesome icon used in the submenu button
+     *   type: MySubmenuApplicationClass,   // A FormApplication subclass which should be created
+     *   restricted: true                   // Restrict this submenu to gamemaster only?
+     * });
+     * ```
+     */
+    registerMenu<N extends string, K extends string>(
+      namespace: N,
+      key: K,
+      data: ClientSettings.PartialSettingSubmenuConfig
+    ): void;
 
-  interface CompleteMenuSetting extends PartialMenuSetting {
-    key: string;
-    module: string;
-  }
+    /**
+     * Get the value of a game setting for a certain namespace and setting key
+     *
+     * @param namespace - The namespace under which the setting is registered
+     * @param key       - The setting key to retrieve
+     * @typeParam N     - The namespace under which the setting is registered, as a type
+     * @typeParam K     - The setting key to retrieve, as a type
+     *
+     * @example
+     * ```typescript
+     * // Retrieve the current setting value
+     * game.settings.get("myModule", "myClientSetting");
+     * ```
+     */
+    get<N extends string, K extends string>(namespace: N, key: K): ClientSettings.Values[`${N}.${K}`];
 
-  interface PartialSetting<T = unknown> {
-    choices?: Record<string, string>;
-    config?: boolean;
-    default?: T;
-    hint?: string;
-    name?: string;
-    onChange?: (value: T) => void;
-    range?: T extends number
-      ? {
-          max: number;
-          min: number;
-          step: number;
-        }
-      : undefined;
-    filePicker?: T extends string ? true | 'audio' | 'image' | 'video' | 'imagevideo' | 'folder' : undefined;
-    scope: string;
-    type?: T extends boolean
-      ? typeof Boolean
-      : T extends number
-      ? typeof Number
-      : T extends bigint
-      ? typeof BigInt
-      : T extends string
-      ? typeof String
-      : T extends symbol
-      ? typeof Symbol
-      : ConstructorOf<T>;
+    /**
+     * Set the value of a game setting for a certain namespace and setting key
+     *
+     * @param namespace - The namespace under which the setting is registered
+     * @param key       - The setting key to retrieve
+     * @param value     - The data to assign to the setting key
+     * @typeParam N     - The namespace under which the setting is registered, as a type
+     * @typeParam K     - The setting key to retrieve, as a type
+     * @typeParam V     - The type of the value being set
+     *
+     * @example
+     * ```typescript
+     * // Update the current value of a setting
+     * game.settings.set("myModule", "myClientSetting", "b");
+     * ```
+     */
+    set<N extends string, K extends string, V extends ClientSettings.Values[`${N}.${K}`]>(
+      namespace: N,
+      key: K,
+      value: V
+    ): Promise<V>;
   }
 
-  interface PartialMenuSetting {
-    hint?: string;
-    icon?: string;
-    label?: string;
-    name?: string;
-    restricted: boolean;
-    type: ConstructorOf<FormApplication<FormApplicationOptions, object, undefined>>;
-  }
+  namespace ClientSettings {
+    type PartialSettingConfig<T = unknown> = InexactPartial<Omit<SettingConfig<T>, 'key' | 'namespace'>>;
 
-  interface RegisteredMenuSettings {
-    [key: string]: PartialMenuSetting;
-  }
+    type PartialSettingSubmenuConfig = Omit<SettingSubmenuConfig, 'key' | 'namespace'>;
 
-  interface Values {
-    'core.animateRollTable': boolean;
-    'core.chatBubbles': boolean;
-    'core.chatBubblesPan': boolean;
-    'core.combatTrackerConfig': { resource: string; skipDefeated: boolean } | {};
-    'core.compendiumConfiguration': Partial<Record<string, CompendiumCollection.Configuration>>;
-    'core.coneTemplateType': 'round' | 'flat';
-    'core.defaultDrawingConfig': foundry.data.DrawingData['_source'] | {};
-    'core.globalAmbientVolume': number;
-    'core.globalInterfaceVolume': number;
-    'core.globalPlaylistVolume': number;
-    'core.keybindings': Record<string, KeybindingActionBinding[]>;
-    'core.language': string;
-    'core.leftClickRelease': boolean;
-    'core.lightAnimation': boolean;
-    'core.maxFPS': number;
-    'core.mipmap': boolean;
-    'core.moduleConfiguration': Record<string, boolean>;
-    'core.nue.shownTips': boolean;
-    'core.noCanvas': boolean;
-    'core.permissions': Game.Permissions;
-    'core.rollMode': keyof CONFIG.Dice.RollModes;
-    'core.softShadows': boolean;
-    'core.time': number;
-    'core.tokenDragPreview': boolean;
-    'core.visionAnimation': boolean;
-    [key: string]: unknown;
+    interface Values {
+      'core.animateRollTable': boolean;
+      'core.chatBubbles': boolean;
+      'core.chatBubblesPan': boolean;
+      'core.combatTrackerConfig': { resource: string; skipDefeated: boolean } | {};
+      'core.compendiumConfiguration': Partial<Record<string, CompendiumCollection.Configuration>>;
+      'core.coneTemplateType': 'round' | 'flat';
+      'core.defaultDrawingConfig': foundry.data.DrawingData['_source'] | {};
+      'core.defaultToken': DeepPartial<TokenDataSource>;
+      'core.disableResolutionScaling': boolean;
+      'core.fontSize': number;
+      'core.fpsMeter': boolean;
+      'core.globalAmbientVolume': number;
+      'core.globalInterfaceVolume': number;
+      'core.globalPlaylistVolume': number;
+      'core.keybindings': Record<string, KeybindingActionBinding[]>;
+      'core.language': string;
+      'core.leftClickRelease': boolean;
+      'core.lightAnimation': boolean;
+      'core.maxFPS': number;
+      'core.mipmap': boolean;
+      'core.moduleConfiguration': Record<string, boolean>;
+      'core.noCanvas': boolean;
+      'core.notesDisplayToggle': boolean;
+      'core.nue.shownTips': boolean;
+      'core.performanceMode': boolean;
+      'core.permissions': Game.Permissions;
+      'core.playlist.playingLocation': 'top' | 'bottom';
+      'core.rollMode': keyof CONFIG.Dice.RollModes;
+      'core.rtcClientSettings': typeof AVSettings.DEFAULT_CLIENT_SETTINGS;
+      'core.rtcWorldSettings': typeof AVSettings.DEFAULT_WORLD_SETTINGS;
+      'core.scrollingStatusText': boolean;
+      'core.sheetClasses': {
+        [Key in DocumentType as DocumentSubTypes<Key> extends string ? Key : never]?: Record<
+          DocumentSubTypes<Key> & string,
+          string
+        >;
+      };
+      'core.time': number;
+      'core.tokenDragPreview': boolean;
+      'core.visionAnimation': boolean;
+      [key: string]: unknown;
+    }
   }
 }

package/src/foundry/foundry.js/collections/documentCollections/compendiumCollection.d.ts

@@ -164,10 +164,12 @@ declare global {
      * Provide a dialog form that prompts the user to import the full contents of a Compendium pack into the World.
      * @param options - Additional options passed to the Dialog.confirm method
      *                  (default: `{}`)
-     * @returns A Promise which resolves or rejects once the dialog has been submitted or closed
+     * @returns A promise which resolves in the following ways: an array of imported
+     *          Documents if the "yes" button was pressed, false if the "no" button was pressed, or
+     *          null if the dialog was closed without making a choice.
      */
     importDialog(
-      options?: Dialog.Options | undefined
+      options?: DialogOptions | undefined
     ): Promise<StoredDocument<DocumentInstanceForCompendiumMetadata<T>>[] | null | false>;
 
     /**

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

@@ -382,6 +382,9 @@ declare global {
 
       /** @defaultValue `Folders` */
       collection: ConstructorOf<Folders>;
+
+      /** @defaultValue `'fas fa-folder'` */
+      sidebarIcon: string;
     };
 
     /**

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

@@ -524,7 +524,7 @@ declare global {
         private: boolean;
         system?: string;
         type: foundry.CONST.COMPENDIUM_DOCUMENT_TYPES;
-      };
+      }[];
       scripts: string[];
       styles: string[];
       type: 'world' | 'system' | 'module';

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

@@ -2,6 +2,18 @@
 declare class GamepadManager {
   constructor();
 
+  /**
+   * @defaultValue `null`
+   * @internal
+   */
+  protected _gamepadPoller: number | null;
+
+  /**
+   * The connected Gamepads
+   * @internal
+   */
+  protected _connectedGamepads: Map<string, ConnectedGamepad>;
+
   /**
    * How often Gamepad polling should check for button presses
    * @defaultValue `100`

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

@@ -70,37 +70,6 @@ declare global {
   /** The client-side console is the default logger  */
   let logger: typeof console;
 
-  /**
-   * @deprecated since 0.8.0
-   * You are referencing the FEATURES object which has been deprecated as it is no longer an agreed-upon method for how to track evolution of the Foundry Virtual Tabletop API. Discussion about alternate approaches is actively ongoing within the League of Developers community. For the time being the recommendation is to test against game.data.version to understand the current Foundry VTT version which is active. The FEATURES object will be removed in 0.9.0.
-   */
-  let FEATURES: {
-    readonly ACTIVE_EFFECTS: 2;
-    readonly ACTORS: 3;
-    readonly AUDIO_VIDEO: 2;
-    readonly CHAT: 3;
-    readonly COMBAT: 3;
-    readonly COMPENDIUM: 3;
-    readonly DICE: 2;
-    readonly DRAWINGS: 3;
-    readonly ENTITIES: 5;
-    readonly GRID: 2;
-    readonly ITEMS: 3;
-    readonly JOURNAL: 2;
-    readonly LIGHTING: 3;
-    readonly LOCALIZATION: 2;
-    readonly MACROS: 2;
-    readonly NOTES: 2;
-    readonly PLAYLISTS: 2;
-    readonly ROLL_TABLES: 2;
-    readonly SETTINGS: 3;
-    readonly SOUND: 2;
-    readonly TEMPLATES: 2;
-    readonly TILES: 3;
-    readonly TOKENS: 4;
-    readonly WALLS: 3;
-  };
-
   /**
    * @defaultValue `undefined`
    * Initialized between the `'DOMContentLoaded'` event and the `'init'` hook event.

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

@@ -7,6 +7,23 @@ declare class HandlebarsHelpers {
    */
   static checked(value: unknown): string;
 
+  /**
+   * For use in form inputs. If the supplied value is truthy, add the "disabled" property, otherwise add nothing.
+   */
+  static disabled(value: unknown): string;
+
+  /**
+   * Concatenate a number of string terms into a single string.
+   * This is useful for passing arguments with variable names.
+   * @param values - The values to concatenate
+   *
+   * @example <caption>Concatenate several string parts to create a dynamic variable</caption>
+   * ```handlebars
+   * {{filePicker target=(concat "faces." i ".img") type="image"}}
+   * ```
+   */
+  static concat(...values: string[]): Handlebars.SafeString;
+
   /**
    * Render a pair of inputs for selecting a color.
    * @param options - Helper options
@@ -31,12 +48,15 @@ declare class HandlebarsHelpers {
    * @example <caption>Translate a provided localization string, optionally including formatting parameters</caption>
    * ```handlebars
    * <label>{{localize "ACTOR.Create"}}</label> <!-- "Create Actor" -->
-   * <label>{{localize "CHAT.InvalidCommand", command=foo}}</label> <!-- "foo is not a valid chat message command." -->
+   * <label>{{localize "CHAT.InvalidCommand" command=foo}}</label> <!-- "foo is not a valid chat message command." -->
    * ```
    */
   static localize(value: string, options: HandlebarsHelpers.LocalizeOptions): string;
 
   /**
+   * @param value   - A numeric value to format
+   * @param options - Additional options which customize the resulting format
+   * @returns The formatted string to be included in a template
    * A string formatting helper to display a number with a certain fixed number of decimals and an explicit sign.
    */
   static numberFormat(value: string, options: HandlebarsHelpers.NumberFormatOptions): string;
@@ -78,7 +98,7 @@ declare class HandlebarsHelpers {
   ): Handlebars.SafeString;
 
   /**
-   * Render a pair of inputs for selecting a color.
+   * Render a pair of inputs for selecting a value in a range.
    * @param options - Helper options
    */
   static rangePicker(options: HandlebarsHelpers.RangePickerOptions): Handlebars.SafeString;
@@ -206,10 +226,10 @@ declare namespace HandlebarsHelpers {
       editable?: boolean;
 
       /**
-       * Replace dynamic entity links?
+       * Replace dynamic document links?
        * @defaultValue `true`
        */
-      entities?: boolean;
+      documents?: boolean;
 
       /**
        * The data object providing context for inline rolls
@@ -245,11 +265,13 @@ declare namespace HandlebarsHelpers {
   interface NumberFormatOptions extends Handlebars.HelperOptions {
     hash: {
       /**
+       * The number of decimal places to include in the resulting string
        * @defaultValue `0`
        */
       decimals?: number;
 
       /**
+       * Whether to include an explicit "+" sign for positive numbers
        * @defaultValue `false`
        */
       sign?: boolean;