@league-of-foundry-developers/foundry-vtt-types 9.255.3 → 9.268.2

package/src/foundry/common/documents.mjs/basePlaylist.d.ts

@@ -21,11 +21,9 @@ type PlaylistMetadata = Merge<
  * The base Playlist model definition which defines common behavior of an Playlist document between both client and server.
  */
 export declare class BasePlaylist extends Document<data.PlaylistData, null, PlaylistMetadata> {
-  /** @override */
-  static get schema(): typeof data.PlaylistData;
+  static override get schema(): typeof data.PlaylistData;
 
-  /** @override */
-  static get metadata(): PlaylistMetadata;
+  static override get metadata(): PlaylistMetadata;
 
   /**
    * A reference to the Collection of ActiveEffect instances in the Actor document, indexed by _id.

package/src/foundry/common/documents.mjs/basePlaylistSound.d.ts

@@ -25,14 +25,11 @@ export declare class BasePlaylistSound extends Document<
   InstanceType<ConfiguredDocumentClass<typeof BasePlaylist>>,
   PlaylistSoundMetadata
 > {
-  /** @override */
-  static get schema(): typeof data.PlaylistSoundData;
+  static override get schema(): typeof data.PlaylistSoundData;
 
-  /** @override */
-  static get metadata(): PlaylistSoundMetadata;
+  static override get metadata(): PlaylistSoundMetadata;
 
-  /** @override */
-  testUserPermission(
+  override testUserPermission(
     user: BaseUser,
     permission: keyof typeof foundry.CONST.DOCUMENT_PERMISSION_LEVELS | foundry.CONST.DOCUMENT_PERMISSION_LEVELS,
     { exact }?: { exact?: boolean }

package/src/foundry/common/documents.mjs/baseRollTable.d.ts

@@ -20,11 +20,9 @@ type RollTableMetadata = Merge<
  * The base RollTable model definition which defines common behavior of an RollTable document between both client and server.
  */
 export declare class BaseRollTable extends Document<foundry.data.RollTableData, null, RollTableMetadata> {
-  /** @override */
-  static get schema(): typeof foundry.data.RollTableData;
+  static override get schema(): typeof foundry.data.RollTableData;
 
-  /** @override */
-  static get metadata(): RollTableMetadata;
+  static override get metadata(): RollTableMetadata;
 
   /**
    * A reference to the Collection of TableResult instances in this document, indexed by _id.

package/src/foundry/common/documents.mjs/baseScene.d.ts

@@ -35,11 +35,9 @@ type SceneMetadata = Merge<
  * The base Scene model definition which defines common behavior of an Scene document between both client and server.
  */
 export declare class BaseScene extends Document<data.SceneData, null, SceneMetadata> {
-  /** @override */
-  static get schema(): typeof data.SceneData;
+  static override get schema(): typeof data.SceneData;
 
-  /** @override */
-  static get metadata(): SceneMetadata;
+  static override get metadata(): SceneMetadata;
 
   /**
    * A reference to the Collection of Drawing instances in the Scene document, indexed by _id.

package/src/foundry/common/documents.mjs/baseSetting.d.ts

@@ -22,11 +22,9 @@ type SettingMetadata = Merge<
  * The base Setting model definition which defines common behavior of an Setting document between both client and server.
  */
 export declare class BaseSetting extends Document<data.SettingData, null, SettingMetadata> {
-  /** @override */
-  static get schema(): typeof data.SettingData;
+  static override get schema(): typeof data.SettingData;
 
-  /** @override */
-  static get metadata(): SettingMetadata;
+  static override get metadata(): SettingMetadata;
 
   /**
    * A convenience reference to the key which identifies this game setting.

package/src/foundry/common/documents.mjs/baseTableResult.d.ts

@@ -31,11 +31,9 @@ export declare class BaseTableResult extends Document<
   InstanceType<ConfiguredDocumentClass<typeof BaseRollTable>>,
   TableResultMetadata
 > {
-  /** @override */
-  static get schema(): typeof foundry.data.TableResultData;
+  static override get schema(): typeof foundry.data.TableResultData;
 
-  /** @override */
-  static get metadata(): TableResultMetadata;
+  static override get metadata(): TableResultMetadata;
 
   /**
    * Is a user able to update an existing TableResult?
@@ -46,8 +44,7 @@ export declare class BaseTableResult extends Document<
     data: DeepPartial<TableResultDataConstructorData>
   ): boolean;
 
-  /** @override */
-  testUserPermission(
+  override testUserPermission(
     user: BaseUser,
     permission: keyof typeof foundry.CONST.DOCUMENT_PERMISSION_LEVELS | foundry.CONST.DOCUMENT_PERMISSION_LEVELS,
     { exact }?: { exact?: boolean }

package/src/foundry/common/documents.mjs/baseTile.d.ts

@@ -23,9 +23,7 @@ export declare class BaseTile extends Document<
   InstanceType<ConfiguredDocumentClass<typeof BaseScene>>,
   TileMetadata
 > {
-  /** @override */
-  static get schema(): typeof data.TileData;
+  static override get schema(): typeof data.TileData;
 
-  /** @override */
-  static get metadata(): TileMetadata;
+  static override get metadata(): TileMetadata;
 }

package/src/foundry/common/documents.mjs/baseToken.d.ts

@@ -28,11 +28,9 @@ export declare class BaseToken extends Document<
   InstanceType<ConfiguredDocumentClass<typeof foundry.documents.BaseScene>>,
   TokenMetadata
 > {
-  /** @override */
-  static get schema(): typeof data.TokenData;
+  static override get schema(): typeof data.TokenData;
 
-  /** @override */
-  static get metadata(): TokenMetadata;
+  static override get metadata(): TokenMetadata;
 
   /**
    * A convenience reference to the name which should be displayed for the Token

package/src/foundry/common/documents.mjs/baseUser.d.ts

@@ -30,11 +30,9 @@ export declare class BaseUser extends Document<data.UserData, null, UserMetadata
    */
   readonly role: ValueOf<typeof CONST.USER_ROLES>;
 
-  /** @override */
-  static get schema(): typeof data.UserData;
+  static override get schema(): typeof data.UserData;
 
-  /** @override */
-  static get metadata(): UserMetadata;
+  static override get metadata(): UserMetadata;
 
   /**
    * Is a user able to create an existing User?
@@ -79,8 +77,7 @@ export declare class BaseUser extends Document<data.UserData, null, UserMetadata
     action: ValueOf<typeof CONST.USER_ROLES> | keyof typeof CONST.USER_ROLES | keyof typeof CONST.USER_PERMISSIONS
   ): boolean;
 
-  /** @override */
-  getUserLevel(
+  override getUserLevel(
     user: BaseUser
   ): typeof CONST.DOCUMENT_PERMISSION_LEVELS.OWNER | typeof CONST.DOCUMENT_PERMISSION_LEVELS.NONE;
 

package/src/foundry/common/documents.mjs/baseWall.d.ts

@@ -32,11 +32,9 @@ export declare class BaseWall extends Document<data.WallData, InstanceType<Confi
     context?: Context<InstanceType<ConfiguredDocumentClass<typeof BaseScene>>>
   );
 
-  /** @override */
-  static get schema(): typeof data.WallData;
+  static override get schema(): typeof data.WallData;
 
-  /** @override */
-  static get metadata(): WallMetadata;
+  static override get metadata(): WallMetadata;
 
   /**
    * Is a user able to update an existing Wall?

package/src/foundry/common/packages.mjs/moduleData.d.ts

@@ -48,8 +48,7 @@ interface ModuleDataConstructorData extends PackageDataConstructorData {
  * Extends the basic PackageData schema with some additional module-specific fields.
  */
 export class ModuleData extends PackageData<ModuleDataSchema, ModuleDataProperties, ModuleDataConstructorData> {
-  /** @override */
-  static defineSchema(): ModuleDataSchema;
+  static override defineSchema(): ModuleDataSchema;
 }
 
 // eslint-disable-next-line @typescript-eslint/no-empty-interface

package/src/foundry/common/packages.mjs/packageAuthorData.d.ts

@@ -51,8 +51,7 @@ export class PackageAuthorData extends DocumentData<
 > {
   constructor(data?: PackageAuthorDataConstructorData, document?: null);
 
-  /** @override */
-  static defineSchema(): PackageAuthorDataSchema;
+  static override defineSchema(): PackageAuthorDataSchema;
 }
 
 // eslint-disable-next-line @typescript-eslint/no-empty-interface

package/src/foundry/common/packages.mjs/packageCompendiumData.d.ts

@@ -79,11 +79,9 @@ export class PackageCompendiumData extends DocumentData<
   PackageCompendiumDataSource,
   PackageCompendiumDataConstructorData
 > {
-  /** @override */
-  static defineSchema(): PackageCompendiumDataSchema;
+  static override defineSchema(): PackageCompendiumDataSchema;
 
-  /** @override */
-  _initializeSource(data: PackageCompendiumDataConstructorData): PackageCompendiumDataSource;
+  override _initializeSource(data: PackageCompendiumDataConstructorData): PackageCompendiumDataSource;
 }
 
 // eslint-disable-next-line @typescript-eslint/no-empty-interface

package/src/foundry/common/packages.mjs/packageData.d.ts

@@ -305,11 +305,9 @@ export class PackageData<
   Properties extends Omit<PackageDataProperties, 'system'>,
   ConstructorData extends Omit<PackageDataConstructorData, 'system'>
 > extends DocumentData<Schema, Properties, PropertiesToSource<Properties>, ConstructorData> {
-  /** @override */
-  static defineSchema(): Omit<PackageDataSchema, 'system'>;
+  static override defineSchema(): Omit<PackageDataSchema, 'system'>;
 
-  /** @override */
-  _initializeSource(data: ConstructorData): PropertiesToSource<Properties>;
+  override _initializeSource(data: ConstructorData): PropertiesToSource<Properties>;
 
   /**
    * Determine the availability a package based on the version numbers of its dependencies.

package/src/foundry/common/packages.mjs/packageDependencyData.d.ts

@@ -54,14 +54,15 @@ export class PackageDependencyData extends DocumentData<
   PackageDependencyDataSource,
   PackageDependencyDataConstructorData
 > {
-  /** @override */
-  static defineSchema(): PackageDependencyDataSchema;
+  static override defineSchema(): PackageDependencyDataSchema;
 
-  /** @override */
-  protected _getMissingFieldErrorMessage(name: string, field: DocumentField<unknown>): string;
+  protected override _getMissingFieldErrorMessage(name: string, field: DocumentField<unknown>): string;
 
-  /** @override */
-  protected _getInvalidFieldValueErrorMessage(name: string, field: DocumentField<unknown>, value: unknown): string;
+  protected override _getInvalidFieldValueErrorMessage(
+    name: string,
+    field: DocumentField<unknown>,
+    value: unknown
+  ): string;
 }
 
 // eslint-disable-next-line @typescript-eslint/no-empty-interface

package/src/foundry/common/packages.mjs/packageLanguageData.d.ts

@@ -59,11 +59,9 @@ export class PackageLanguageData extends DocumentData<
   PackageLanguageDataSource,
   PackageLanguageDataConstructorData
 > {
-  /** @override */
-  static defineSchema(): PackageLanguageDataSchema;
+  static override defineSchema(): PackageLanguageDataSchema;
 
-  /** @override */
-  protected _initialize(): void;
+  protected override _initialize(): void;
 
   /**
    * Validate that a language code is supported as a canonical locale

package/src/foundry/common/packages.mjs/systemData.d.ts

@@ -51,8 +51,7 @@ interface SystemDataConstructorData extends PackageDataConstructorData {
  * Extends the basic PackageData schema with some additional system-specific fields.
  */
 export class SystemData extends PackageData<SystemDataSchema, SystemDataProperties, SystemDataConstructorData> {
-  /** @override */
-  static defineSchema(): SystemDataSchema;
+  static override defineSchema(): SystemDataSchema;
 }
 
 // eslint-disable-next-line @typescript-eslint/no-empty-interface

package/src/foundry/common/packages.mjs/worldData.d.ts

@@ -69,8 +69,7 @@ interface WorldDataConstructorData extends Omit<PackageDataConstructorData, 'sys
  * Extends the basic PackageData schema with some additional world-specific fields.
  */
 export class WorldData extends PackageData<WorldDataSchema, WorldDataProperties, WorldDataConstructorData> {
-  /** @override */
-  static defineSchema(): WorldDataSchema;
+  static override defineSchema(): WorldDataSchema;
 }
 
 // eslint-disable-next-line @typescript-eslint/no-empty-interface

package/src/foundry/common/utils/helpers.mjs.d.ts

@@ -198,6 +198,7 @@ export declare function getParentClasses(cls: ConstructorOf<any>): Array<Constru
  * @param object - The object to traverse
  * @param key    - An object property with notation a.b.c
  * @returns The value of the found property
+ * @throws {@link Error} Throws an Error if the object is not in fact an object
  */
 export declare function getProperty(object: object, key: string): any;
 

package/src/foundry/index.d.ts

@@ -1,76 +1,3 @@
 import './common/module.mjs';
-import './foundry.js/application';
-import './foundry.js/applications';
-import './foundry.js/audioContainer';
-import './foundry.js/audioHelper';
-import './foundry.js/avClient';
-import './foundry.js/avClients';
-import './foundry.js/avMaster';
-import './foundry.js/avSettings';
-import './foundry.js/cameraPopoutAppWrapper';
-import './foundry.js/canvas';
-import './foundry.js/canvasAnimation';
-import './foundry.js/canvasDocumentMixin';
-import './foundry.js/chatBubbles';
-import './foundry.js/clientDatabaseBackend';
-import './foundry.js/clientDocumentMixin';
-import './foundry.js/clientDocuments';
-import './foundry.js/clientKeybindings';
-import './foundry.js/clientSettings';
-import './foundry.js/collections';
-import './foundry.js/collisionResult';
-import './foundry.js/config';
-import './foundry.js/contextMenu';
-import './foundry.js/dragDrop';
-import './foundry.js/draggable';
-import './foundry.js/formDataExtended';
-import './foundry.js/game';
-import './foundry.js/gameTime';
-import './foundry.js/gamepadManager';
-import './foundry.js/globalVariables';
-import './foundry.js/handlebarsHelpers';
-import './foundry.js/hooks';
-import './foundry.js/imageHelper';
-import './foundry.js/keyboardManager';
-import './foundry.js/localization';
-import './foundry.js/mersenneTwister';
-import './foundry.js/mouseInteractionManager';
-import './foundry.js/mouseManager';
-import './foundry.js/newUserExperience';
-import './foundry.js/perceptionManager';
-import './foundry.js/pixi';
-import './foundry.js/pointSource';
-import './foundry.js/pointSources';
-import './foundry.js/polygonEdge';
-import './foundry.js/polygonVertex';
-import './foundry.js/quadtree';
-import './foundry.js/quadtreeCulling';
-import './foundry.js/ray';
-import './foundry.js/rays';
-import './foundry.js/roll';
-import './foundry.js/rollTerm';
-import './foundry.js/rollTerms/diceTerm';
-import './foundry.js/rollTerms/diceTerms/coin';
-import './foundry.js/rollTerms/diceTerms/die';
-import './foundry.js/rollTerms/diceTerms/fateDie';
-import './foundry.js/rollTerms/mathTerm';
-import './foundry.js/rollTerms/numericTerm';
-import './foundry.js/rollTerms/operatorTerm';
-import './foundry.js/rollTerms/parentheticalTerm';
-import './foundry.js/rollTerms/poolTerm';
-import './foundry.js/rollTerms/stringTerm';
-import './foundry.js/screenCulling';
-import './foundry.js/searchFilter';
-import './foundry.js/socketInterface';
-import './foundry.js/sortingHelpers';
-import './foundry.js/sound';
-import './foundry.js/specialEffect';
-import './foundry.js/specialEffects';
-import './foundry.js/tabs';
-import './foundry.js/templateUtils';
-import './foundry.js/textEditor';
-import './foundry.js/textureLoader';
-import './foundry.js/textureUtils';
-import './foundry.js/userTargets';
-import './foundry.js/utils';
-import './foundry.js/videoHelper';
+import './client';
+import './templates';

package/src/foundry/templates/index.d.ts

@@ -0,0 +1 @@
+import './views/layouts/main.hbs';

package/src/foundry/templates/views/layouts/main.hbs.d.ts

@@ -0,0 +1,11 @@
+declare global {
+  const SIGNED_EULA: boolean;
+
+  const ROUTE_PREFIX: string;
+
+  const MESSAGES:
+    | { type: Notifications.Notification['type']; message: string; options: Notifications.Options }[]
+    | null;
+}
+
+export {};

package/src/types/augments/index.d.ts

@@ -1,3 +1,5 @@
+import './pixiGraphicsSmooth';
+import './pixiLegacyGraphics';
 import './pixiParticles';
 import './simple-peer';
 import './socket.io-client';

package/src/types/augments/pixiGraphicsSmooth.d.ts

@@ -0,0 +1,7 @@
+import * as graphicsSmooth from '@pixi/graphics-smooth';
+
+declare global {
+  namespace PIXI {
+    export import smooth = graphicsSmooth; // eslint-disable-line @typescript-eslint/no-unused-vars
+  }
+}

package/src/types/augments/pixiLegacyGraphics.d.ts

@@ -0,0 +1,7 @@
+declare global {
+  namespace PIXI {
+    export const LegacyGraphics: typeof PIXI.Graphics;
+  }
+}
+
+export {};

package/src/types/config.d.ts

@@ -0,0 +1,183 @@
+declare global {
+  /**
+   * Some global variables (such as {@link game}) are only initialized after certain events have happened during the
+   * initialization of Foundry VTT. For that reason, the correct types for these variables include the types for the
+   * uninitialized state.
+   *
+   * While this is correct from a type checking perspective, it can be inconvenient to have to type guard these global
+   * variables everywhere. Some users might prefer the convenience over the 100% correctness in type checking.
+   *
+   * For this reason, this interface provides a way for users to configure certain global variables to be typed more
+   * leniently, i.e., as the types of their initialized state. This is done via declaration merging. To configure a
+   * specific global variable to be typed leniently, the user simply needs to merge a property with the name of the
+   * variable into this interface (the type doesn't matter).
+   *
+   * The currently supported variables are:
+   * - {@link game}
+   * - {@link socket}
+   * - {@link ui}
+   * - {@link canvas}
+   *
+   * @example
+   * ```typescript
+   * declare global {
+   *   interface LenientGlobalVariableTypes {
+   *     game: never; // the type doesn't matter
+   *   }
+   * }
+   *
+   * const referenceToGame: Game = game; // ok! :)
+   * ```
+   */
+  // eslint-disable-next-line @typescript-eslint/no-empty-interface
+  interface LenientGlobalVariableTypes {}
+
+  /**
+   * This interface is used to configure the used document classes at a type
+   * level. Module and system authors should use declaration merging to provide
+   * the types of their configured document classes. It is extremely important
+   * that this is kept in sync with the configuration that actually happens at
+   * runtime.
+   *
+   * @example
+   * ```typescript
+   * // myActor.ts
+   * class MyActor extends Actor {}
+   *
+   * // entryPoint.ts
+   * import { MyActor } from './myActor'
+   *
+   * hooks.once('init', () => {
+   *   CONFIG.Actor.documentClass = typeof MyActor;
+   * });
+   *
+   * declare global {
+   *   interface DocumentClassConfig {
+   *     Actor: typeof MyActor
+   *   }
+   * }
+   * ```
+   */
+  //eslint-disable-next-line @typescript-eslint/no-empty-interface
+  interface DocumentClassConfig {}
+
+  /**
+   * This interface is used to configure the used object classes at a type
+   * level. Module and system authors should use declaration merging to provide
+   * the types of their configured object classes. It is extremely important
+   * that this is kept in sync with the configuration that actually happens at
+   * runtime.
+   *
+   * @example
+   * ```typescript
+   * // myToken.ts
+   * class MyToken extends Token {}
+   *
+   * // entryPoint.ts
+   * import { MyToken } from './myToken'
+   *
+   * Hooks.once('init', () => {
+   *   CONFIG.Token.objectClass = MyToken;
+   * });
+   *
+   * declare global {
+   *   interface PlaceableObjectClassConfig {
+   *     Token: typeof MyToken;
+   *   }
+   * }
+   * ```
+   */
+  //eslint-disable-next-line @typescript-eslint/no-empty-interface
+  interface PlaceableObjectClassConfig {}
+
+  /**
+   * This interface together with {@link SourceConfig} is used to configure the
+   * types of the `data`  and `data._source` properties of the
+   * {@link foundry.documents.BaseActor} and {@link foundry.documents.BaseItem}
+   * classes. System authors should use declaration merging to provide the types
+   * that match their `template.json` file. It is also very important for these
+   * types to stay in sync with the `template.json` file, otherwise unexpected
+   * runtime errors might appear.
+   *
+   * @example
+   * ```typescript
+   * interface ArmorDataSourceData {
+   *   armorValue: number;
+   * }
+   *
+   * interface ArmorDataSource {
+   *   type: 'armor';
+   *   data: ArmorDataSourceData;
+   * }
+   *
+   * interface WeaponDataSourceData {
+   *   damagePerHit: number;
+   *   attackSpeed: number;
+   * }
+   *
+   * interface WeaponDataSource {
+   *   type: 'weapon';
+   *   data: WeaponDataSourceData;
+   * }
+   *
+   * interface ArmorDataPropertiesData extends ArmorDataSourceData {
+   *   weight: number;
+   * }
+   *
+   * interface ArmorDataProperties {
+   *   type: 'armor';
+   *   data: ArmorDataPropertiesData;
+   * }
+   *
+   * interface WeaponDataPropertiesData extends WeaponDataSourceData {
+   *   damage: number;
+   * }
+   *
+   * interface WeaponDataProperties {
+   *   type: 'weapon';
+   *   data: WeaponDataPropertiesData;
+   * }
+   *
+   * type MyItemDataSource = ArmorDataSource | WeaponDataSource;
+   * type MyItemDataProperties = ArmorDataProperties | WeaponDataProperties;
+   *
+   * declare global {
+   *   interface DataConfig {
+   *     Item: MyItemDataProperties;
+   *   }
+   *
+   *   interface SourceConfig {
+   *     Item: MyItemDataSource;
+   *   }
+   * }
+   * const item = await Item.create({
+   *   name: 'Axe',
+   *   type: 'weapon',
+   *   attackSpeed: 1,
+   *   damage: 5
+   * });
+   *
+   * if(item.data.type === 'weapon') {
+   *   const damage: number = item.data.data.damage;
+   * }
+   *
+   * if(item.data._source.type === 'armor') {
+   *   const armorValue = item.data._source.data.armorValue;
+   * }
+   * ```
+   */
+  // eslint-disable-next-line @typescript-eslint/no-empty-interface
+  interface DataConfig {}
+
+  /** @see {@link DataConfig} */
+  // eslint-disable-next-line @typescript-eslint/no-empty-interface
+  interface SourceConfig {}
+
+  // eslint-disable-next-line @typescript-eslint/no-empty-interface
+  interface FlagConfig {}
+
+  // eslint-disable-next-line @typescript-eslint/no-empty-interface
+  interface WebRTCConfig {}
+}
+
+export {};

package/src/types/index.d.ts

@@ -1,2 +1,3 @@
 import './augments';
+import './config';
 import './utils';

package/src/foundry/foundry.js/applications/basePlaceableHUDs/index.d.ts

@@ -1,3 +0,0 @@
-import './drawingHUD';
-import './tileHUD';
-import './tokenHUD';