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

package/README.md

@@ -15,29 +15,31 @@ TypeScript type definitions for [Foundry Virtual Tabletop](https://foundryvtt.co
 
 We aim to support the latest release of each Foundry VTT version (0.7, 0.8, 9, etc.), starting with 0.7.
 
-At the moment, versions 0.7, 0.8, and 9 are fully supported with partial support for versions 10 and 11. Work on support for version 12 is currently underway. See the [open foundry V12 issues](https://github.com/League-of-Foundry-Developers/foundry-vtt-types/issues?q=is%3Aopen+is%3Aissue+label%3A%22foundry+V12%22).
+At the moment, versions 0.7, 0.8, and 9 are fully supported with partial support for versions 10, 11, and 12. Work on support for version 13 is currently underway.
 
-## V12 Installation
+## AI
 
-Currently v12 is still in beta. There are known bugs, issues in the ergonomics, and major unfinished work in the current implementation. To get a direct line of communication about the current status of development as well as to help us understand what areas need to be prioritized first, join the [League of Extraordinary FoundryVTT Developers Discord](https://discord.gg/73HTMuK7dT) or file an issue.
+AI cannot be provided the source of Foundry VTT Types. This is because Foundry VTT Types contains documentation from Foundry and AI is _**not**_ allowed to be used on the source of Foundry due to its [End User License Agreement (EULA)](https://foundryvtt.com/article/license/). Staff members have confirmed there is no exception for AI.
 
-The recommended way to install for v12 is this command:
+## V13 Installation
+
+Currently v13 is still in beta. There are known bugs, issues in the ergonomics, and unfinished work in the current implementation. To get a direct line of communication about the current status of development as well as to help us understand what areas need to be prioritized first, join the [League of Extraordinary FoundryVTT Developers Discord](https://discord.gg/73HTMuK7dT) or file an issue.
+
+The recommended way to install for v13 is this command:
 
 ```sh
 npm add -D fvtt-types@github:League-of-Foundry-Developers/foundry-vtt-types#main
 ```
 
-Alternatively, if you're using yarn you'll need to use the command `yarn add --dev fvtt-types@github:League-of-Foundry-Developers/foundry-vtt-types#main`.
+The command for other package managers is similar, for example with yarn you'll need to use the command `yarn add --dev fvtt-types@github:League-of-Foundry-Developers/foundry-vtt-types#main`.
 
-This will add the current commit on `main` as a dependency. Both npm and yarn's lockfile will store the commit you initially installed this command and so updates to your dependency will not happen automatically or even after a fresh install. To update you will need to be rerun the prior command periodically to update as improvements are added frequently.
-
-If you've been using the types for a few months now, the best branch would be `maintenance` instead. `main` will have a number of backwards incompatible breaking changes going forward.
+This will add the current commit on `main` as a dependency. Every popular package manager has a lockfile which will store the commit you initially installed this command and so updates to your dependency will not happen automatically or even after a fresh install. To update you will need to be rerun the prior command periodically to update as improvements are added frequently.
 
 ## Installation
 
 You can install historical versions of foundry-vtt-types from the [npm registry](https://npmjs.org/).
 
-In order to install the latest stable version (v9), run
+In order to install the latest stable version, run
 
 ```sh
 npm add --save-dev fvtt-types@npm:@league-of-foundry-developers/foundry-vtt-types
@@ -124,34 +126,6 @@ Please read [CONTRIBUTING.md](CONTRIBUTING.md) for more details on how to contri
 If you have any specific questions, feel free to contact us in the
 [League of Extraordinary Foundry Developers Discord](https://discord.gg/52DNPzqm2Z).
 
-## Type-Checking, Linting, Testing
-
-When contributing, make sure that the type checks pass, the linter is green and the tests are green. We _do_ have
-checks in the CI but running this locally also helps you while developing and saves you time as you don't have to wait
-for the CI.
-
-You can run type checking and linting with the following command:
-
-```shell
-npm run lint
-```
-
-You can run the tests with
-
-```shell
-npm run test
-```
-
-## Creating a release
-
-To create a release, you have to create a new release commit, tag it and create a GitHub release from that. The CI will
-handle the rest.
-
-```shell
-npm version <release-type>
-git push --follow-tags
-```
-
 ## License
 
 This project is licensed under the MIT license. You can find a copy at [LICENSE](LICENSE).

package/package.json

@@ -1,10 +1,10 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@league-of-foundry-developers/foundry-vtt-types",
-  "version": "13.340.1",
+  "version": "13.345.1-beta.20250704.94554",
   "description": "TypeScript type definitions for Foundry VTT",
   "type": "module",
-  "types": "./index.d.mts",
+  "types": "./src/index.d.mts",
   "exports": {
     ".": {
       "types": "./src/index.d.mts"
@@ -29,11 +29,14 @@
     "#client/*": {
       "import": "./src/foundry/client/*"
     },
-    "#client-esm/*": {
-      "import": "./src/foundry/client-esm/*"
-    },
     "#common/*": {
       "import": "./src/foundry/common/*"
+    },
+    "#utils": {
+      "import": "./src/utils/index.d.mts"
+    },
+    "#configuration": {
+      "import": "./src/configuration/index.d.mts"
     }
   },
   "scripts": {
@@ -46,7 +49,7 @@
     "prettier:fix": "prettier -l -w .",
     "eslint:report": "eslint --cache --output-file eslint_report.json --format json .",
     "test": "vitest --typecheck",
-    "typecheck": "tsc -b tsconfig.main.json",
+    "typecheck": "tsc",
     "prepare": "is-ci || husky",
     "betterer": "betterer",
     "betterer:update": "betterer --update"
@@ -94,45 +97,44 @@
   ],
   "dependencies": {
     "@codemirror/lang-html": "^6.4.9",
-    "@codemirror/lang-javascript": "^6.2.2",
+    "@codemirror/lang-javascript": "^6.2.3",
     "@codemirror/lang-json": "^6.0.1",
-    "@codemirror/lang-markdown": "^6.3.1",
-    "@pixi/basis": "^7.4.2",
-    "@pixi/graphics-smooth": "^1.1.0",
-    "@pixi/particle-emitter": "^5.0.8",
-    "@types/earcut": "^3.0.0",
-    "@types/jquery": "~3.5.22",
+    "@codemirror/lang-markdown": "^6.3.2",
+    "@pixi/basis": "github:foundry-vtt-types/pixi-basis#main",
+    "@pixi/graphics-smooth": "^1.1.1",
+    "@pixi/particle-emitter": "github:foundry-vtt-types/pixi-particle-emitter#main",
+    "@types/jquery": "^3.5.32",
     "@types/showdown": "~2.0.6",
     "@types/simple-peer": "~9.11.1",
     "@types/youtube": "~0.0.48",
     "codemirror": "^6.0.1",
-    "earcut": "^3.0.1",
     "handlebars": "^4.7.8",
     "handlebars-intl": "^1.1.2",
     "jquery": "^3.7.1",
     "mime-types": "^3.0.1",
     "peggy": "^4.2.0",
-    "pixi.js": "^7.4.2",
+    "pixi.js": "github:foundry-vtt-types/pixi.js#main",
+    "pixi-basis-ktx2": "^0.0.22",
     "prosemirror-collab": "^1.3.1",
-    "prosemirror-commands": "^1.6.2",
+    "prosemirror-commands": "^1.7.0",
     "prosemirror-dropcursor": "^1.8.1",
     "prosemirror-gapcursor": "^1.3.2",
     "prosemirror-history": "^1.4.1",
-    "prosemirror-inputrules": "^1.4.0",
+    "prosemirror-inputrules": "^1.5.0",
     "prosemirror-keymap": "^1.2.2",
-    "prosemirror-model": "^1.23.0",
-    "prosemirror-schema-list": "^1.4.1",
+    "prosemirror-model": "^1.25.0",
+    "prosemirror-schema-list": "^1.5.1",
     "prosemirror-state": "^1.4.3",
-    "prosemirror-tables": "^1.6.1",
-    "prosemirror-transform": "^1.10.2",
-    "prosemirror-view": "^1.36.0",
-    "sanitize-html": "^2.13.1",
+    "prosemirror-tables": "^1.6.4",
+    "prosemirror-transform": "^1.10.3",
+    "prosemirror-view": "^1.38.1",
+    "sanitize-html": "^2.15.0",
     "showdown": "^2.1.0",
     "simple-peer": "^9.11.1",
     "socket.io": "^4.8.1",
     "socket.io-client": "^4.8.1",
     "spark-md5": "^3.0.2",
-    "tinymce": "^7.5.1"
+    "tinymce": "^6.8.5"
   },
   "devDependencies": {
     "@actions/core": "^1.11.1",
@@ -141,48 +143,40 @@
     "@betterer/cli": "^6.0.0-alpha.1",
     "@eslint/compat": "^1.2.6",
     "@eslint/js": "^9.19.0",
-    "@ts-morph/common": "^0.26.1",
     "@types/debug": "^4.1.12",
     "@types/fvtt-types": "file:.",
-    "@types/picomatch": "^4.0.0",
     "@typescript-eslint/eslint-plugin": "^8.31.0",
     "@typescript-eslint/parser": "^8.31.0",
     "@typescript-eslint/scope-manager": "^8.31.0",
     "@typescript-eslint/utils": "^8.31.0",
-    "enhanced-resolve": "^5.18.1",
+    "@typescript/native-preview": "^7.0.0-dev.20250620.1",
     "eslint": "^9.19.0",
     "eslint-config-prettier": "^10.0.1",
     "eslint-import-resolver-typescript": "^4.3.2",
     "eslint-plugin-import-x": "^4.6.1",
+    "eslint-plugin-jsdoc": "^51.0.1",
     "eslint-plugin-tsdoc": "^0.4.0",
     "globals": "^16.0.0",
     "husky": "^9.1.4",
     "is-ci": "^4.1.0",
-    "lint-staged": "^15.3.0",
-    "npm-run-all": "^4.1.5",
+    "lint-staged": "^16.0.0",
+    "npm-run-all2": "^8.0.1",
     "pathe": "^2.0.2",
     "prettier": "^3.0.3",
-    "type-fest": "^4.34.0",
+    "type-fest": "^4.41.0",
     "typescript": "^5.8.2",
     "typescript-eslint": "^8.31.0",
-    "vitest": "^3.0.5"
+    "vitest": "^4.0.0-beta.1"
   },
   "peerDependencies": {
     "typescript": "^5.4"
   },
-  "overrides": {
-    "@types/css-font-loading-module": "^0.0.14",
-    "@pixi/utils": {
-      "@types/earcut": "3.0.0"
-    }
-  },
   "files": [
     "index.d.mts",
     "index-lenient.d.mts",
     "src",
-    "tsconfig.json",
-    "tsconfig.main.json",
-    "tsconfig.miscellaneous.json"
+    "tsconfig.base.json",
+    "tsconfig.json"
   ],
   "publishConfig": {
     "access": "public"

package/src/configuration/configuration.d.mts

@@ -1,9 +1,12 @@
-import type { DeepPartial, MaybeEmpty } from "fvtt-types/utils";
+import type { DeepPartial, InterfaceToObject, MaybeEmpty } from "#utils";
 import type { fields } from "../foundry/common/data/_module.d.mts";
 import type Document from "../foundry/common/abstract/document.d.mts";
 
+import AVSettings = foundry.av.AVSettings;
+import Game = foundry.Game;
+
 /**
- * Some global variables (such as {@link game | `game`}) are only initialized after certain events have happened during the
+ * Some global variables (such as {@linkcode 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.
  *
@@ -95,9 +98,9 @@ export interface DocumentClassConfig {}
 export interface PlaceableObjectClassConfig {}
 
 /**
- * This interface together with {@link SourceConfig | `SourceConfig`} is used to configure the
+ * This interface together with {@linkcode SourceConfig} is used to configure the
  * types of the `data`  and `data._source` properties of the
- * {@link foundry.documents.BaseActor | `foundry.documents.BaseActor`} and {@link foundry.documents.BaseItem | `foundry.documents.BaseItem`}
+ * {@linkcode foundry.documents.BaseActor} and {@linkcode 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
@@ -187,7 +190,7 @@ export interface GetDataConfig {}
 // eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export interface DataModelConfig {}
 
-/** @see {@link DataConfig | `DataConfig`} */
+/** @see {@linkcode DataConfig} */
 // eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export interface SourceConfig {}
 
@@ -199,8 +202,8 @@ export interface WebRTCConfig {}
 
 /**
  * Injects extra data for modules from `game.modules.get("module-id")`.
- * @see {@link RequiredModules | `RequiredModules`} for removing the `undefined` type for required modules.
- *  @example
+ * @see {@linkcode RequiredModules} for removing the `undefined` type for required modules.
+ * @example
  * ```typescript
  * interface ModuleConfig {
  *   "module-id": {
@@ -216,7 +219,7 @@ export interface ModuleConfig {}
 /**
  * Removes `undefined` for modules listed as keys here from the return type of `game.modules.get`.
  * Useful if a module is a required dependency.
- * @see {@link ModuleConfig | `ModuleConfig`} for adding useful properties to the returned modules, like APIs.
+ * @see {@linkcode ModuleConfig} for adding useful properties to the returned modules, like APIs.
  * @example
  * ```typescript
  * interface RequiredModules {
@@ -233,7 +236,10 @@ export interface SettingConfig {
   "core.chatBubbles": fields.BooleanField<{ initial: true }>;
   "core.chatBubblesPan": fields.BooleanField<{ initial: true }>;
   "core.combatTrackerConfig": MaybeEmpty<{ resource: string; skipDefeated: boolean }>;
-  "core.compendiumConfiguration": Partial<Record<string, CompendiumCollection.Configuration>>;
+  "core.compendiumConfiguration": Partial<
+    Record<string, foundry.documents.collections.CompendiumCollection.Configuration>
+  >;
+  "core.gridTemplates": fields.BooleanField<{ initial: false }>;
   "core.coneTemplateType": "round" | "flat";
   "core.colorSchema": fields.StringField<{
     required: true;
@@ -264,7 +270,7 @@ export interface SettingConfig {
   "core.globalAmbientVolume": number;
   "core.globalInterfaceVolume": number;
   "core.globalPlaylistVolume": number;
-  "core.keybindings": Record<string, ClientKeybindings.KeybindingActionBinding[]>;
+  "core.keybindings": Record<string, foundry.helpers.interaction.ClientKeybindings.KeybindingActionBinding[]>;
   "core.language": fields.StringField<{
     required: true;
     blank: false;
@@ -295,14 +301,25 @@ export interface SettingConfig {
   "core.permissions": Game.Permissions;
   "core.pixelRatioResolutionScaling": fields.BooleanField<{ initial: true }>;
   "core.playlist.playingLocation": "top" | "bottom";
-  "core.rollMode": fields.StringField<{
-    required: true;
-    blank: false;
-    initial: typeof CONST.DICE_ROLL_MODES.PUBLIC;
-    choices: typeof CONFIG.Dice.rollModes;
-  }>;
-  "core.rtcClientSettings": typeof AVSettings.DEFAULT_CLIENT_SETTINGS;
-  "core.rtcWorldSettings": typeof AVSettings.DEFAULT_WORLD_SETTINGS;
+
+  /**
+   * @remarks `choices` is a type with the index signature of {@linkcode CONFIG.Dice.rollModes} removed.
+   * If you want to use a custom `rollMode`, you must register it in `CONFIG`.
+   */
+  "core.rollMode": fields.StringField<
+    {
+      required: true;
+      blank: false;
+      initial: typeof CONST.DICE_ROLL_MODES.PUBLIC;
+      choices: InterfaceToObject<typeof CONFIG.Dice.rollModes>;
+    },
+    // Note(LukeAbby): This override is necessary because the `initial` wasn't removing `null`.
+    (string & keyof typeof CONFIG.Dice.rollModes) | null | undefined,
+    string & keyof typeof CONFIG.Dice.rollModes,
+    string & keyof typeof CONFIG.Dice.rollModes
+  >;
+  "core.rtcClientSettings": typeof AVSettings.schemaFields.client;
+  "core.rtcWorldSettings": typeof AVSettings.schemaFields.world;
   "core.scrollingStatusText": fields.BooleanField<{ initial: true }>;
   "core.sheetClasses": {
     [Key in Document.Type as Document.SubTypesOf<Key> extends string ? Key : never]?: Record<
@@ -314,3 +331,20 @@ export interface SettingConfig {
   "core.tokenDragPreview": boolean;
   "core.visionAnimation": boolean;
 }
+
+/**
+ * Allows you to control the name of your system. Useful for typing things like `game.system.id`
+ * @example
+ * ```typescript
+ * declare module "fvtt-types/configuration" {
+ *   interface SystemNameConfig {
+ *     name: "lancer";
+ *   }
+ * }
+ *
+ * const systemName = game.system.id;
+ * //    ^? "lancer"
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface SystemNameConfig {}

package/src/configuration/documents.d.mts

@@ -2,7 +2,7 @@
 
 /**
  * Use this interface to configure your custom generic `ActiveEffect` implementation.
- * See also {@link DocumentClassConfig | `DocumentClassConfig`} to configure your class.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
  *
  * @example
  * ```typescript
@@ -23,7 +23,7 @@ export interface ConfiguredActiveEffect<SubType extends ActiveEffect.SubType> {}
 
 /**
  * Use this interface to configure your custom generic `ActorDelta` implementation.
- * See also {@link DocumentClassConfig | `DocumentClassConfig`} to configure your class.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
  *
  * @example
  * ```typescript
@@ -44,7 +44,7 @@ export interface ConfiguredActorDelta<SubType extends ActorDelta.SubType> {}
 
 /**
  * Use this interface to configure your custom generic `Actor` implementation.
- * See also {@link DocumentClassConfig | `DocumentClassConfig`} to configure your class.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
  *
  * @example
  * ```typescript
@@ -65,7 +65,7 @@ export interface ConfiguredActor<SubType extends Actor.SubType> {}
 
 /**
  * Use this interface to configure your custom generic `Card` implementation.
- * See also {@link DocumentClassConfig | `DocumentClassConfig`} to configure your class.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
  *
  * @example
  * ```typescript
@@ -86,7 +86,7 @@ export interface ConfiguredCard<SubType extends Card.SubType> {}
 
 /**
  * Use this interface to configure your custom generic `Cards` implementation.
- * See also {@link DocumentClassConfig | `DocumentClassConfig`} to configure your class.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
  *
  * @example
  * ```typescript
@@ -107,7 +107,7 @@ export interface ConfiguredCards<SubType extends Cards.SubType> {}
 
 /**
  * Use this interface to configure your custom generic `ChatMessage` implementation.
- * See also {@link DocumentClassConfig | `DocumentClassConfig`} to configure your class.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
  *
  * @example
  * ```typescript
@@ -128,7 +128,7 @@ export interface ConfiguredChatMessage<SubType extends ChatMessage.SubType> {}
 
 /**
  * Use this interface to configure your custom generic `Combat` implementation.
- * See also {@link DocumentClassConfig | `DocumentClassConfig`} to configure your class.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
  *
  * @example
  * ```typescript
@@ -149,7 +149,7 @@ export interface ConfiguredCombat<SubType extends Combat.SubType> {}
 
 /**
  * Use this interface to configure your custom generic `Combatant` implementation.
- * See also {@link DocumentClassConfig | `DocumentClassConfig`} to configure your class.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
  *
  * @example
  * ```typescript
@@ -168,9 +168,30 @@ export interface ConfiguredCombat<SubType extends Combat.SubType> {}
  */
 export interface ConfiguredCombatant<SubType extends Combatant.SubType> {}
 
+/**
+ * Use this interface to configure your custom generic `CombatantGroup` implementation.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
+ *
+ * @example
+ * ```typescript
+ * class CustomCombatantGroup<
+ *   SubType extends CombatantGroup.SubType
+ * > extends CombatantGroup<SubType> {
+ *   ...
+ * }
+ *
+ * declare module "fvtt-types/configuration" {
+ *   interface ConfiguredCombatantGroup<SubType extends CombatantGroup.SubType> {
+ *     document: CustomCombatantGroup<SubType>;
+ *   }
+ * }
+ * ```
+ */
+export interface ConfiguredCombatantGroup<SubType extends CombatantGroup.SubType> {}
+
 /**
  * Use this interface to configure your custom generic `Folder` implementation.
- * See also {@link DocumentClassConfig | `DocumentClassConfig`} to configure your class.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
  *
  * @example
  * ```typescript
@@ -191,7 +212,7 @@ export interface ConfiguredFolder<SubType extends Folder.SubType> {}
 
 /**
  * Use this interface to configure your custom generic `Item` implementation.
- * See also {@link DocumentClassConfig | `DocumentClassConfig`} to configure your class.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
  *
  * @example
  * ```typescript
@@ -212,7 +233,7 @@ export interface ConfiguredItem<SubType extends Item.SubType> {}
 
 /**
  * Use this interface to configure your custom generic `JournalEntryPage` implementation.
- * See also {@link DocumentClassConfig | `DocumentClassConfig`} to configure your class.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
  *
  * @example
  * ```typescript
@@ -233,7 +254,7 @@ export interface ConfiguredJournalEntryPage<SubType extends JournalEntryPage.Sub
 
 /**
  * Use this interface to configure your custom generic `Macro` implementation.
- * See also {@link DocumentClassConfig | `DocumentClassConfig`} to configure your class.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
  *
  * @example
  * ```typescript
@@ -254,7 +275,7 @@ export interface ConfiguredMacro<SubType extends Macro.SubType> {}
 
 /**
  * Use this interface to configure your custom generic `RegionBehavior` implementation.
- * See also {@link DocumentClassConfig | `DocumentClassConfig`} to configure your class.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
  *
  * @example
  * ```typescript
@@ -275,7 +296,7 @@ export interface ConfiguredRegionBehavior<SubType extends RegionBehavior.SubType
 
 /**
  * Use this interface to configure your custom generic `TableResult` implementation.
- * See also {@link DocumentClassConfig | `DocumentClassConfig`} to configure your class.
+ * See also {@linkcode DocumentClassConfig} to configure your class.
  *
  * @example
  * ```typescript