@league-of-foundry-developers/foundry-vtt-types 12.331.3-beta → 12.331.5

package/src/foundry/client/config.d.mts

@@ -1,8 +1,8 @@
-import type { GetKey } from "../../types/helperTypes.d.mts";
 import type * as CONST from "../common/constants.d.mts";
 import type { DataModel, Document } from "../common/abstract/module.d.mts";
-import type PointLightSource from "../client-esm/canvas/sources/point-light-source.d.mts";
-import type { AnyObject, HandleEmptyObject, MaybePromise } from "../../types/utils.d.mts";
+import type { GetKey, AnyObject, HandleEmptyObject, MaybePromise } from "#utils";
+import type BaseLightSource from "../client-esm/canvas/sources/base-light-source.d.mts";
+import type RenderedEffectSource from "../client-esm/canvas/sources/rendered-effect-source.d.mts";
 
 declare global {
   namespace CONFIG {
@@ -52,7 +52,7 @@ declare global {
          * resolver. This resolver must therefore be capable of handling manual
          * rolls.
          */
-        resolver: typeof foundry.applications.dice.RollResolver;
+        resolver: foundry.applications.dice.RollResolver.AnyConstructor;
       }
 
       /**
@@ -67,7 +67,9 @@ declare global {
         options?: AnyObject,
       ) => Promise<number | void>;
 
-      type RollFunction = (arg0: never, ...args: never[]) => MaybePromise<number>;
+      type RollFunction = (...args: Array<string | number>) => MaybePromise<number | `${number}`>;
+
+      type DTermDiceStrings = "d4" | "d6" | "d8" | "d10" | "d12" | "d20" | "d100";
     }
 
     interface Dice {
@@ -75,7 +77,7 @@ declare global {
        * The Dice types which are supported.
        * @defaultValue `[foundry.dice.terms.Die, foundry.dice.terms.FateDie]`
        */
-      types: Array<typeof foundry.dice.terms.DiceTerm>;
+      types: Array<foundry.dice.terms.DiceTerm.AnyConstructor>;
 
       rollModes: CONFIG.Dice.RollModes;
 
@@ -83,7 +85,7 @@ declare global {
        * Configured Roll class definitions
        * @defaultValue `[Roll]`
        */
-      rolls: Array<typeof foundry.dice.Roll>;
+      rolls: Array<foundry.dice.Roll.AnyConstructor>;
 
       /**
        * Configured DiceTerm class definitions
@@ -100,14 +102,14 @@ declare global {
        * }
        * ```
        */
-      termTypes: Record<string, typeof foundry.dice.terms.RollTerm>;
+      termTypes: Record<string, foundry.dice.terms.RollTerm.AnyConstructor>;
 
       /** Configured roll terms and the classes they map to. */
       terms: {
-        c: typeof foundry.dice.terms.Coin;
-        d: typeof foundry.dice.terms.Die;
-        f: typeof foundry.dice.terms.FateDie;
-      } & Record<string, typeof foundry.dice.terms.DiceTerm>;
+        c: foundry.dice.terms.Coin.AnyConstructor;
+        d: foundry.dice.terms.Die.AnyConstructor;
+        f: foundry.dice.terms.FateDie.AnyConstructor;
+      } & Record<string, foundry.dice.terms.DiceTerm.AnyConstructor>;
 
       /**
        * A function used to provide random uniform values.
@@ -116,7 +118,7 @@ declare global {
       randomUniform: () => number;
 
       /** A parser implementation for parsing Roll expressions. */
-      parser: typeof foundry.dice.RollParser;
+      parser: foundry.dice.RollParser.AnyConstructor;
 
       /** A collection of custom functions that can be included in roll expressions.*/
       functions: Record<string, CONFIG.Dice.RollFunction>;
@@ -130,7 +132,7 @@ declare global {
     /**
      * Configured status effects which are recognized by the game system
      */
-    type StatusEffect = foundry.documents.BaseActiveEffect.ConstructorData & {
+    type StatusEffect = foundry.documents.BaseActiveEffect.CreateData & {
       /**
        * A string identifier for the effect
        */
@@ -231,7 +233,7 @@ declare global {
      * include or specifically exclude certain file paths or warning messages.
      * Exclusion rules take precedence over inclusion rules.
      *
-     * @see {@link CONST.COMPATIBILITY_MODES}
+     * @see {@link CONST.COMPATIBILITY_MODES | `CONST.COMPATIBILITY_MODES`}
      *
      * @example Include Specific Errors
      * ```js
@@ -293,10 +295,10 @@ declare global {
      */
     Actor: {
       /** @defaultValue `Actor` */
-      documentClass: Document.ConfiguredClassForName<"Actor">;
+      documentClass: Document.ImplementationClassFor<"Actor">;
 
       /** @defaultValue `Actors` */
-      collection: typeof Actors;
+      collection: Actors.AnyConstructor;
 
       /** @defaultValue `[]` */
       compendiumIndexFields: string[];
@@ -311,18 +313,18 @@ declare global {
        * @defaultValue `{}`
        * @remarks `TypeDataModel` is preferred to `DataModel` per core Foundry team
        */
-      dataModels: Record<string, typeof DataModel<any, Actor>>;
+      dataModels: Record<string, typeof DataModel<any, Actor.Implementation>>;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
        */
-      sheetClasses: Record<foundry.documents.BaseActor.TypeNames, Record<string, SheetClassConfig>>;
+      sheetClasses: Record<foundry.documents.BaseActor.SubType, Record<string, SheetClassConfig>>;
 
       /**
        * @defaultValue `{}`
        * @remarks Initialized by `Localization#initialize`, is an empty object until `i18nInit`
        */
-      typeLabels: Record<foundry.documents.BaseActor.TypeNames, string>;
+      typeLabels: Record<foundry.documents.BaseActor.SubType, string>;
 
       /** @defaultValue `{}` */
       typeIcons: Record<string, string>;
@@ -338,7 +340,7 @@ declare global {
      */
     Adventure: {
       /** @defaultValue `foundry.documents.BaseAdventure` */
-      documentClass: Document.ConfiguredClassForName<"Adventure">;
+      documentClass: Document.ImplementationClassFor<"Adventure">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -365,13 +367,13 @@ declare global {
      */
     Cards: {
       /** @defaultValue `CardStacks` */
-      collection: typeof CardStacks;
+      collection: CardStacks.AnyConstructor;
 
       /** @defaultValue `[]` */
       compendiumIndexFields: string[];
 
       /** @defaultValue `Cards` */
-      documentClass: Document.ConfiguredClassForName<"Cards">;
+      documentClass: Document.ImplementationClassFor<"Cards">;
 
       /** @defaultValue `"fa-solid fa-cards"` */
       sidebarIcon: string;
@@ -380,7 +382,7 @@ declare global {
        * @defaultValue `{}`
        * @remarks `TypeDataModel` is preferred to `DataModel` per core Foundry team
        */
-      dataModels: Record<string, typeof DataModel<any, Cards>>;
+      dataModels: Record<string, typeof DataModel<any, Cards.Implementation>>;
 
       /**
        * @defaultValue
@@ -404,13 +406,13 @@ declare global {
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
        */
-      sheetClasses: Record<foundry.documents.BaseCards.TypeNames, Record<string, SheetClassConfig>>;
+      sheetClasses: Record<foundry.documents.BaseCards.SubType, Record<string, SheetClassConfig>>;
 
       /**
        * @defaultValue `{}`
        * @remarks Initialized by `Localization#initialize`, is an empty object until `i18nInit`
        */
-      typeLabels: Record<foundry.documents.BaseCards.TypeNames, string>;
+      typeLabels: Record<foundry.documents.BaseCards.SubType, string>;
 
       typeIcons: {
         /** @defaultValue `"fas fa-cards"` */
@@ -429,10 +431,10 @@ declare global {
      */
     ChatMessage: {
       /** @defaultValue `ChatMessage` */
-      documentClass: Document.ConfiguredClassForName<"ChatMessage">;
+      documentClass: Document.ImplementationClassFor<"ChatMessage">;
 
       /** @defaultValue `Messages` */
-      collection: typeof Messages;
+      collection: Messages.AnyConstructor;
 
       /** @defaultValue `"templates/sidebar/chat-message.html"` */
       template: string;
@@ -444,18 +446,18 @@ declare global {
        * @defaultValue `{}`
        * @remarks `TypeDataModel` is preferred to `DataModel` per core Foundry team
        */
-      dataModels: Record<string, typeof DataModel<any, ChatMessage>>;
+      dataModels: Record<string, typeof DataModel<any, ChatMessage.Implementation>>;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
        */
-      sheetClasses: Record<foundry.documents.BaseChatMessage.TypeNames, Record<string, SheetClassConfig>>;
+      sheetClasses: Record<foundry.documents.BaseChatMessage.SubType, Record<string, SheetClassConfig>>;
 
       /**
        * @defaultValue `{}`
        * @remarks Initialized by `Localization#initialize`, is an empty object until `i18nInit`
        */
-      typeLabels: Record<foundry.documents.BaseChatMessage.TypeNames, string>;
+      typeLabels: Record<foundry.documents.BaseChatMessage.SubType, string>;
 
       /** @defaultValue `{}` */
       typeIcons: Record<string, string>;
@@ -469,10 +471,10 @@ declare global {
      */
     Combat: {
       /** @defaultValue `Combat` */
-      documentClass: Document.ConfiguredClassForName<"Combat">;
+      documentClass: Document.ImplementationClassFor<"Combat">;
 
       /** @defaultValue `CombatEncounters` */
-      collection: typeof CombatEncounters;
+      collection: CombatEncounters.AnyConstructor;
 
       /** @defaultValue `"fas fa-swords"` */
       sidebarIcon: string;
@@ -481,18 +483,18 @@ declare global {
        * @defaultValue `{}`
        * @remarks `TypeDataModel` is preferred to `DataModel` per core Foundry team
        */
-      dataModels: Record<string, typeof DataModel<any, Combat>>;
+      dataModels: Record<string, typeof DataModel<any, Combat.Implementation>>;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
        */
-      sheetClasses: Record<foundry.documents.BaseCombat.TypeNames, Record<string, SheetClassConfig>>;
+      sheetClasses: Record<foundry.documents.BaseCombat.SubType, Record<string, SheetClassConfig>>;
 
       /**
        * @defaultValue `{}`
        * @remarks Initialized by `Localization#initialize`, is an empty object until `i18nInit`
        */
-      typeLabels: Record<foundry.documents.BaseCombat.TypeNames, string>;
+      typeLabels: Record<foundry.documents.BaseCombat.SubType, string>;
 
       /** @defaultValue `{}` */
       typeIcons: Record<string, string>;
@@ -537,7 +539,7 @@ declare global {
      */
     FogExploration: {
       /** @defaultValue `FogExploration` */
-      documentClass: Document.ConfiguredClassForName<"FogExploration">;
+      documentClass: Document.ImplementationClassFor<"FogExploration">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -550,7 +552,7 @@ declare global {
       typeLabels?: Record<"base", string>;
 
       /** @defaultValue `FogExplorations` */
-      collection: typeof FogExplorations;
+      collection: FogExplorations.AnyConstructor;
     };
 
     /**
@@ -558,10 +560,10 @@ declare global {
      */
     Folder: {
       /** @defaultValue `Folder` */
-      documentClass: Document.ConfiguredClassForName<"Folder">;
+      documentClass: Document.ImplementationClassFor<"Folder">;
 
       /** @defaultValue `Folders` */
-      collection: typeof Folders;
+      collection: Folders.AnyConstructor;
 
       /** @defaultValue `"fas fa-folder"` */
       sidebarIcon: string;
@@ -582,10 +584,10 @@ declare global {
      */
     Item: {
       /** @defaultValue `Item` */
-      documentClass: Document.ConfiguredClassForName<"Item">;
+      documentClass: Document.ImplementationClassFor<"Item">;
 
       /** @defaultValue `Items` */
-      collection: typeof Items;
+      collection: Items.AnyConstructor;
 
       /** @defaultValue `[]` */
       compendiumIndexFields: string[];
@@ -600,18 +602,18 @@ declare global {
        * @defaultValue `{}`
        * @remarks `TypeDataModel` is preferred to `DataModel` per core Foundry team
        */
-      dataModels: Record<string, typeof DataModel<any, Item>>;
+      dataModels: Record<string, typeof DataModel<any, Item.Implementation>>;
 
       /**
        * @defaultValue `{}`
        * @remarks Initialized by `Localization#initialize`, is an empty object until `i18nInit`
        */
-      typeLabels: Record<foundry.documents.BaseItem.TypeNames, string>;
+      typeLabels: Record<foundry.documents.BaseItem.SubType, string>;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
        */
-      sheetClasses: Record<foundry.documents.BaseItem.TypeNames, Record<string, SheetClassConfig>>;
+      sheetClasses: Record<foundry.documents.BaseItem.SubType, Record<string, SheetClassConfig>>;
     };
 
     /**
@@ -619,7 +621,7 @@ declare global {
      */
     JournalEntry: {
       /** @defaultValue `JournalEntry` */
-      documentClass: Document.ConfiguredClassForName<"JournalEntry">;
+      documentClass: Document.ImplementationClassFor<"JournalEntry">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -632,7 +634,7 @@ declare global {
       typeLabels?: Record<"base", string>;
 
       /** @defaultValue `Journal` */
-      collection: typeof Journal;
+      collection: Journal.AnyConstructor;
 
       /** @defaultValue `[]` */
       compendiumIndexFields: string[];
@@ -732,20 +734,20 @@ declare global {
      */
     Macro: {
       /** @defaultValue `Macro` */
-      documentClass: Document.ConfiguredClassForName<"Macro">;
+      documentClass: Document.ImplementationClassFor<"Macro">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
        */
-      sheetClasses: Record<foundry.documents.BaseMacro.TypeNames, Record<string, SheetClassConfig>>;
+      sheetClasses: Record<foundry.documents.BaseMacro.SubType, Record<string, SheetClassConfig>>;
 
       /**
        * @remarks Initialized by `Localization#initialize`, is undefined until `i18nInit`
        */
-      typeLabels?: Record<foundry.documents.BaseMacro.TypeNames, string>;
+      typeLabels?: Record<foundry.documents.BaseMacro.SubType, string>;
 
       /** @defaultValue `Macros` */
-      collection: typeof Macros;
+      collection: Macros.AnyConstructor;
 
       /** @defaultValue `[]` */
       compendiumIndexFields: string[];
@@ -762,7 +764,7 @@ declare global {
      */
     Playlist: {
       /** @defaultValue `Playlist` */
-      documentClass: Document.ConfiguredClassForName<"Playlist">;
+      documentClass: Document.ImplementationClassFor<"Playlist">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -775,7 +777,7 @@ declare global {
       typeLabels?: Record<"base", string>;
 
       /** @defaultValue `Playlists` */
-      collection: typeof Playlists;
+      collection: Playlists.AnyConstructor;
 
       /** @defaultValue `[]` */
       compendiumIndexFields: string[];
@@ -795,7 +797,7 @@ declare global {
      */
     RollTable: {
       /** @defaultValue `RollTable` */
-      documentClass: Document.ConfiguredClassForName<"RollTable">;
+      documentClass: Document.ImplementationClassFor<"RollTable">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -808,7 +810,7 @@ declare global {
       typeLabels?: Record<"base", string>;
 
       /** @defaultValue `RollTables` */
-      collection: typeof RollTables;
+      collection: RollTables.AnyConstructor;
 
       /** @defaultValue `["formula"]` */
       compendiumIndexFields: string[];
@@ -831,7 +833,7 @@ declare global {
      */
     Scene: {
       /** @defaultValue `Scene` */
-      documentClass: Document.ConfiguredClassForName<"Scene">;
+      documentClass: Document.ImplementationClassFor<"Scene">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -844,7 +846,7 @@ declare global {
       typeLabels?: Record<"base", string>;
 
       /** @defaultValue `Scenes` */
-      collection: typeof Scenes;
+      collection: Scenes.AnyConstructor;
 
       /** @defaultValue `[]` */
       compendiumIndexFields: string[];
@@ -858,7 +860,7 @@ declare global {
 
     Setting: {
       /** @defaultValue `Setting` */
-      documentClass: Document.ConfiguredClassForName<"Setting">;
+      documentClass: Document.ImplementationClassFor<"Setting">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -871,7 +873,7 @@ declare global {
       typeLabels?: Record<"base", string>;
 
       /** @defaultValue `WorldSettings` */
-      collection: typeof WorldSettings;
+      collection: WorldSettings.AnyConstructor;
     };
 
     /**
@@ -879,7 +881,7 @@ declare global {
      */
     User: {
       /** @defaultValue `User` */
-      documentClass: Document.ConfiguredClassForName<"User">;
+      documentClass: Document.ImplementationClassFor<"User">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -892,7 +894,7 @@ declare global {
       typeLabels?: Record<"base", string>;
 
       /** @defaultValue `Users` */
-      collection: typeof Users;
+      collection: Users.AnyConstructor;
     };
 
     /**
@@ -914,7 +916,7 @@ declare global {
       /** @defaultValue `0xffffff` */
       brightestColor: number;
 
-      chatBubblesClass: typeof ChatBubbles;
+      chatBubblesClass: ChatBubbles.AnyConstructor;
 
       /** @defaultValue `0.25` */
       darknessLightPenalty: number;
@@ -944,6 +946,7 @@ declare global {
 
       /**
        * The class used to render door control icons
+       * @remarks Not `AnyConstructor` because it's instantiated with a `Wall.Implementation` as its first argument
        */
       doorControlClass: typeof DoorControl;
 
@@ -959,14 +962,34 @@ declare global {
       /** @defaultValue `10000` */
       daylightToDarknessAnimationMS: number;
 
+      /**
+       * @defaultValue `foundry.canvas.sources.PointDarknessSource`
+       * @remarks Can't be `AnyConstructor` as it's instantiated expecting a compatible constructor
+       */
       darknessSourceClass: typeof foundry.canvas.sources.PointDarknessSource;
 
+      /**
+       * @defaultValue `foundry.canvas.sources.PointLightSource`
+       * @remarks Can't be `AnyConstructor` as it's instantiated expecting a compatible constructor
+       */
       lightSourceClass: typeof foundry.canvas.sources.PointLightSource;
 
+      /**
+       * @defaultValue `foundry.canvas.sources.GlobalLightSource`
+       * @remarks Can't be `AnyConstructor` as it's instantiated expecting a compatible constructor
+       */
       globalLightSourceClass: typeof foundry.canvas.sources.GlobalLightSource;
 
+      /**
+       * @defaultValue `foundry.canvas.sources.PointVisionSource`
+       * @remarks Can't be `AnyConstructor` as it's instantiated expecting a compatible constructor
+       */
       visionSourceClass: typeof foundry.canvas.sources.PointVisionSource;
 
+      /**
+       * @defaultValue `foundry.canvas.sources.PointSoundSource`
+       * @remarks Can't be `AnyConstructor` as it's instantiated via `new`
+       */
       soundSourceClass: typeof foundry.canvas.sources.PointSoundSource;
 
       groups: CONFIG.Canvas.Groups;
@@ -987,28 +1010,34 @@ declare global {
         bright: number;
       };
 
-      /** @defaultValue `FogManager` */
+      /**
+       * @defaultValue `FogManager`
+       * @remarks Can't be `AnyConstructor` because Foundry assumes it can call `new` with the same arguments FogManager accepts
+       */
       fogManager: typeof FogManager;
 
       polygonBackends: {
         /** @defaultValue `typeof ClockwiseSweepPolygon` */
-        sight: typeof PointSourcePolygon;
+        sight: PointSourcePolygon.AnyConstructor;
         /** @defaultValue `typeof ClockwiseSweepPolygon` */
-        light: typeof PointSourcePolygon;
+        light: PointSourcePolygon.AnyConstructor;
         /** @defaultValue `typeof ClockwiseSweepPolygon` */
-        sound: typeof PointSourcePolygon;
+        sound: PointSourcePolygon.AnyConstructor;
         /** @defaultValue `typeof ClockwiseSweepPolygon` */
-        move: typeof PointSourcePolygon;
+        move: PointSourcePolygon.AnyConstructor;
       };
 
       /** @defaultValue `number` */
       darknessSourcePaddingMultiplier: number;
 
-      visibilityFilter: typeof VisibilityFilter;
+      visibilityFilter: VisibilityFilter.AnyConstructor;
 
-      visualEffectsMaskingFilter: typeof VisualEffectsMaskingFilter;
+      visualEffectsMaskingFilter: VisualEffectsMaskingFilter.AnyConstructor;
 
-      /** @defaultValue `Ruler` */
+      /**
+       * @defaultValue `Ruler`
+       * @remarks Not `AnyConstructor` because it's instantiated with a `User.Implementation` as its first argument
+       */
       rulerClass: typeof Ruler;
 
       /** @defaultValue `0.8` */
@@ -1020,21 +1049,109 @@ declare global {
       /** @defaultValue `4` */
       objectBorderThickness: number;
 
-      gridStyles: Record<string, CONFIG.Canvas.GridStyle>;
+      gridStyles: {
+        [key: string]: GridLayer.GridStyle;
+
+        /**
+         * @defaultValue
+         * ```js
+         * {
+         *   label: "GRID.STYLES.SolidLines",
+         *   shaderClass: GridShader,
+         *   shaderOptions: {
+         *     style: 0
+         *   }
+         * }
+         * ```
+         */
+        solidLines: GridLayer.GridStyle;
+
+        /**
+         * @defaultValue
+         * ```js
+         * {
+         *   label: "GRID.STYLES.DashedLines",
+         *   shaderClass: GridShader,
+         *   shaderOptions: {
+         *     style: 1
+         *   }
+         * }
+         * ```
+         */
+        dashedLines: GridLayer.GridStyle;
+
+        /**
+         * @defaultValue
+         * ```js
+         * {
+         *   label: "GRID.STYLES.DottedLines",
+         *   shaderClass: GridShader,
+         *   shaderOptions: {
+         *     style: 0
+         *   }
+         * }
+         * ```
+         */
+        dottedLines: GridLayer.GridStyle;
+
+        /**
+         * @defaultValue
+         * ```js
+         * {
+         *   label: "GRID.STYLES.SquarePoints",
+         *   shaderClass: GridShader,
+         *   shaderOptions: {
+         *     style: 0
+         *   }
+         * }
+         * ```
+         */
+        squarePoints: GridLayer.GridStyle;
+
+        /**
+         * @defaultValue
+         * ```js
+         * {
+         *   label: "GRID.STYLES.DiamondPoints",
+         *   shaderClass: GridShader,
+         *   shaderOptions: {
+         *     style: 0
+         *   }
+         * }
+         * ```
+         */
+        diamondPoints: GridLayer.GridStyle;
+
+        /**
+         * @defaultValue
+         * ```js
+         * {
+         *   label: "GRID.STYLES.RoundPoints",
+         *   shaderClass: GridShader,
+         *   shaderOptions: {
+         *     style: 0
+         *   }
+         * }
+         * ```
+         */
+        roundPoints: GridLayer.GridStyle;
+      };
+
+      lightAnimations: {
+        [key: string]: RenderedEffectSource.LightAnimationConfig;
 
-      lightAnimations: CONFIG.Canvas.LightSourceAnimationConfig & {
         flame: {
           /** @defaultValue `"LIGHT.AnimationFame"` */
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateFlickering` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: BaseLightSource.LightAnimationFunction;
 
           /** @defaultValue `FlameIlluminationShader` */
-          illuminationShader: typeof AbstractBaseShader;
+          illuminationShader: AdaptiveIlluminationShader.AnyConstructor;
 
           /** @defaultValue `FlameColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         torch: {
@@ -1042,13 +1159,13 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTorch` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: BaseLightSource.LightAnimationFunction;
 
           /** @defaultValue `TorchIlluminationShader` */
-          illuminationShader: typeof AbstractBaseShader;
+          illuminationShader: AdaptiveIlluminationShader.AnyConstructor;
 
           /** @defaultValue `TorchColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         revolving: {
@@ -1056,10 +1173,10 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: BaseLightSource.LightAnimationFunction;
 
           /** @defaultValue `RevolvingColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         siren: {
@@ -1067,13 +1184,13 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTorch` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: BaseLightSource.LightAnimationFunction;
 
           /** @defaultValue `SirenIlluminationShader` */
-          illuminationShader: typeof AbstractBaseShader;
+          illuminationShader: AdaptiveIlluminationShader.AnyConstructor;
 
           /** @defaultValue `SirenIlluminationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         pulse: {
@@ -1081,13 +1198,13 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animatePulse` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: BaseLightSource.LightAnimationFunction;
 
           /** @defaultValue `PulseIlluminationShader` */
-          illuminationShader: typeof AbstractBaseShader;
+          illuminationShader: AdaptiveIlluminationShader.AnyConstructor;
 
           /** @defaultValue `PulseColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         chroma: {
@@ -1095,10 +1212,10 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: RenderedEffectSource.AnimationFunction;
 
           /** @defaultValue `ChromaColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         wave: {
@@ -1106,13 +1223,13 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: RenderedEffectSource.AnimationFunction;
 
           /** @defaultValue `WaveIlluminationShader` */
-          illuminationShader: typeof AbstractBaseShader;
+          illuminationShader: AdaptiveIlluminationShader.AnyConstructor;
 
           /** @defaultValue `WaveColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         fog: {
@@ -1120,10 +1237,10 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: RenderedEffectSource.AnimationFunction;
 
           /** @defaultValue `FogColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         sunburst: {
@@ -1131,13 +1248,13 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: RenderedEffectSource.AnimationFunction;
 
           /** @defaultValue `SunburstIlluminationShader` */
-          illuminationShader: typeof AbstractBaseShader;
+          illuminationShader: AdaptiveIlluminationShader.AnyConstructor;
 
           /** @defaultValue `SunburstColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         dome: {
@@ -1145,10 +1262,10 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: RenderedEffectSource.AnimationFunction;
 
           /** @defaultValue `LightDomeColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         emanation: {
@@ -1156,10 +1273,10 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: RenderedEffectSource.AnimationFunction;
 
           /** @defaultValue `EmanationColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         hexa: {
@@ -1167,10 +1284,10 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: RenderedEffectSource.AnimationFunction;
 
           /** @defaultValue `HexaDomeColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         ghost: {
@@ -1178,13 +1295,13 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: RenderedEffectSource.AnimationFunction;
 
           /** @defaultValue `GhostLightIlluminationShader` */
-          illuminationShader: typeof AbstractBaseShader;
+          illuminationShader: AdaptiveIlluminationShader.AnyConstructor;
 
           /** @defaultValue `GhostLightColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         energy: {
@@ -1192,10 +1309,10 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: RenderedEffectSource.AnimationFunction;
 
           /** @defaultValue `EnergyFieldColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         vortex: {
@@ -1203,13 +1320,13 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: RenderedEffectSource.AnimationFunction;
 
           /** @defaultValue `VortexIlluminationShader` */
-          illuminationShader: typeof AbstractBaseShader;
+          illuminationShader: AdaptiveIlluminationShader.AnyConstructor;
 
           /** @defaultValue `VortexColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         witchwave: {
@@ -1217,13 +1334,13 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: RenderedEffectSource.AnimationFunction;
 
           /** @defaultValue `BewitchingWaveIlluminationShader` */
-          illuminationShader: typeof AbstractBaseShader;
+          illuminationShader: AdaptiveIlluminationShader.AnyConstructor;
 
           /** @defaultValue `BewitchingWaveColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         rainbowswirl: {
@@ -1231,10 +1348,10 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: RenderedEffectSource.AnimationFunction;
 
           /** @defaultValue `SwirlingRainbowColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         radialrainbow: {
@@ -1242,10 +1359,10 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: RenderedEffectSource.AnimationFunction;
 
           /** @defaultValue `RadialRainbowColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
 
         fairy: {
@@ -1253,20 +1370,57 @@ declare global {
           label: string;
 
           /** @defaultValue `foundry.canvas.sources.LightSource.prototype.animateTime` */
-          animation: CONFIG.Canvas.LightAnimationFunction;
+          animation: RenderedEffectSource.AnimationFunction;
 
           /** @defaultValue `FairyLightIlluminationShader` */
-          illuminationShader: typeof AbstractBaseShader;
+          illuminationShader: AdaptiveIlluminationShader.AnyConstructor;
 
           /** @defaultValue `FairyLightColorationShader` */
-          colorationShader: typeof AbstractBaseShader;
+          colorationShader: AdaptiveColorationShader.AnyConstructor;
         };
       };
 
-      darknessAnimations: CONFIG.Canvas.DarknessSourceAnimationConfig;
+      darknessAnimations: {
+        [key: string]: RenderedEffectSource.DarknessAnimationConfig;
+
+        magicalGloom: {
+          /** @defaultValue `"LIGHT.AnimationMagicalGloom"` */
+          label: string;
+
+          /** @defaultValue `foundry.canvas.sources.PointDarknessSource.prototype.animateTime` */
+          animation: RenderedEffectSource.AnimationFunction;
+
+          /** @defaultValue `MagicalGloomDarknessShader` */
+          darknessShader: AdaptiveDarknessShader.AnyConstructor;
+        };
+
+        roiling: {
+          /** @defaultValue `"LIGHT.AnimationRoilingMass"` */
+          label: string;
+
+          /** @defaultValue `foundry.canvas.sources.PointDarknessSource.prototype.animateTime` */
+          animation: RenderedEffectSource.AnimationFunction;
+
+          /** @defaultValue `RoilingDarknessShader` */
+          darknessShader: AdaptiveDarknessShader.AnyConstructor;
+        };
+
+        hole: {
+          /** @defaultValue `"LIGHT.AnimationBlackHole"` */
+          label: string;
+
+          /** @defaultValue `foundry.canvas.sources.PointDarknessSource.prototype.animateTime` */
+          animation: RenderedEffectSource.AnimationFunction;
+
+          /** @defaultValue `BlackHoleDarknessShader` */
+          darknessShader: AdaptiveDarknessShader.AnyConstructor;
+        };
+      };
 
       /**
        * A registry of Scenes which are managed by a specific SceneManager class.
+       * @remarks Keys are Scene IDs
+       * @privateRemarks Can't be `AnyConstructor` because it's instantiated expecting a compatible constructor
        */
       managedScenes: Record<string, typeof foundry.canvas.SceneManager>;
 
@@ -1558,7 +1712,7 @@ declare global {
      * Available Weather Effects implementations
      */
     weatherEffects: {
-      [key: string]: CONFIG.WeatherAmbienceConfiguration;
+      [key: string]: WeatherEffects.AmbienceConfiguration;
 
       /**
        * @defaultValue
@@ -1573,7 +1727,7 @@ declare global {
        * }
        * ```
        */
-      leaves: CONFIG.WeatherAmbienceConfiguration;
+      leaves: WeatherEffects.AmbienceConfiguration;
 
       /**
        * @defaultValue
@@ -1601,7 +1755,7 @@ declare global {
        * }
        * ```
        */
-      rain: CONFIG.WeatherAmbienceConfiguration;
+      rain: WeatherEffects.AmbienceConfiguration;
 
       /**
        * @defaultValue
@@ -1642,7 +1796,7 @@ declare global {
        * }
        * ```
        */
-      rainStorm: CONFIG.WeatherAmbienceConfiguration;
+      rainStorm: WeatherEffects.AmbienceConfiguration;
 
       /**
        * @defaultValue
@@ -1667,7 +1821,7 @@ declare global {
        * }
        * ```
        */
-      fog: CONFIG.WeatherAmbienceConfiguration;
+      fog: WeatherEffects.AmbienceConfiguration;
 
       /**
        * @defaultValue
@@ -1693,7 +1847,7 @@ declare global {
        * }
        * ```
        * */
-      snow: CONFIG.WeatherAmbienceConfiguration;
+      snow: WeatherEffects.AmbienceConfiguration;
 
       /**
        * @defaultValue
@@ -1731,7 +1885,7 @@ declare global {
        * }
        * ```
        */
-      blizzard: CONFIG.WeatherAmbienceConfiguration;
+      blizzard: WeatherEffects.AmbienceConfiguration;
     };
 
     /**
@@ -2075,24 +2229,24 @@ declare global {
      */
     ActiveEffect: {
       /** @defaultValue `ActiveEffect` */
-      documentClass: Document.ConfiguredClassForName<"ActiveEffect">;
+      documentClass: Document.ImplementationClassFor<"ActiveEffect">;
 
       /**
        * @defaultValue `{}`
        * @remarks `TypeDataModel` is preferred to `DataModel` per core Foundry team
        */
-      dataModels: Record<string, typeof DataModel<any, ChatMessage>>;
+      dataModels: Record<string, typeof DataModel<any, ActiveEffect.Implementation>>;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
        */
-      sheetClasses: Record<foundry.documents.BaseActiveEffect.TypeNames, Record<string, SheetClassConfig>>;
+      sheetClasses: Record<foundry.documents.BaseActiveEffect.SubType, Record<string, SheetClassConfig>>;
 
       /**
        * @defaultValue `{}`
        * @remarks Initialized by `Localization#initialize`, is an empty object until `i18nInit`
        */
-      typeLabels: Record<foundry.documents.BaseActiveEffect.TypeNames, string>;
+      typeLabels: Record<foundry.documents.BaseActiveEffect.SubType, string>;
 
       /** @defaultValue `{}` */
       typeIcons: Record<string, string>;
@@ -2112,7 +2266,7 @@ declare global {
      */
     ActorDelta: {
       /** @defaultValue `ActorDelta` */
-      documentClass: Document.ConfiguredClassForName<"ActorDelta">;
+      documentClass: Document.ImplementationClassFor<"ActorDelta">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -2130,24 +2284,24 @@ declare global {
      */
     Card: {
       /** @defaultValue `Card` */
-      documentClass: Document.ConfiguredClassForName<"Card">;
+      documentClass: Document.ImplementationClassFor<"Card">;
 
       /**
        * @defaultValue `{}`
        * @remarks `TypeDataModel` is preferred to `DataModel` per core Foundry team
        */
-      dataModels: Record<string, typeof DataModel<any, Card>>;
+      dataModels: Record<string, typeof DataModel<any, Card.Implementation>>;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
        */
-      sheetClasses: Record<foundry.documents.BaseCard.TypeNames, Record<string, SheetClassConfig>>;
+      sheetClasses: Record<foundry.documents.BaseCard.SubType, Record<string, SheetClassConfig>>;
 
       /**
        * @defaultValue `{}`
        * @remarks Initialized by `Localization#initialize`, is an empty object until `i18nInit`
        */
-      typeLabels: Record<foundry.documents.BaseCard.TypeNames, string>;
+      typeLabels: Record<foundry.documents.BaseCard.SubType, string>;
 
       /** @defaultValue `{}` */
       typeIcons: Record<string, string>;
@@ -2158,39 +2312,39 @@ declare global {
      */
     TableResult: {
       /** @defaultValue `TableResult` */
-      documentClass: Document.ConfiguredClassForName<"TableResult">;
+      documentClass: Document.ImplementationClassFor<"TableResult">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
        */
-      sheetClasses: Record<foundry.documents.BaseTableResult.TypeNames, Record<string, SheetClassConfig>>;
+      sheetClasses: Record<foundry.documents.BaseTableResult.SubType, Record<string, SheetClassConfig>>;
 
       /**
        * @remarks Initialized by `Localization#initialize`, is undefined until `i18nInit`
        */
-      typeLabels?: Record<foundry.documents.BaseTableResult.TypeNames, string>;
+      typeLabels?: Record<foundry.documents.BaseTableResult.SubType, string>;
     };
 
     JournalEntryPage: {
       /** @defaultValue `JournalEntryPage` */
-      documentClass: Document.ConfiguredClassForName<"JournalEntryPage">;
+      documentClass: Document.ImplementationClassFor<"JournalEntryPage">;
 
       /**
        * @defaultValue `{}`
        * @remarks `TypeDataModel` is preferred to `DataModel` per core Foundry team
        */
-      dataModels: Record<string, typeof DataModel<any, JournalEntryPage>>;
+      dataModels: Record<string, typeof DataModel<any, JournalEntryPage.Implementation>>;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
        */
-      sheetClasses: Record<foundry.documents.BaseJournalEntryPage.TypeNames, Record<string, SheetClassConfig>>;
+      sheetClasses: Record<foundry.documents.BaseJournalEntryPage.SubType, Record<string, SheetClassConfig>>;
 
       /**
        * @defaultValue `{}`
        * @remarks Initialized by `Localization#initialize`, is an empty object until `i18nInit`
        */
-      typeLabels: Record<foundry.documents.BaseJournalEntryPage.TypeNames, string>;
+      typeLabels: Record<foundry.documents.BaseJournalEntryPage.SubType, string>;
 
       typeIcons: {
         [type: string]: string;
@@ -2217,7 +2371,7 @@ declare global {
      */
     PlaylistSound: {
       /** @defaultValue `PlaylistSound` */
-      documentClass: Document.ConfiguredClassForName<"PlaylistSound">;
+      documentClass: Document.ImplementationClassFor<"PlaylistSound">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -2235,7 +2389,7 @@ declare global {
      */
     AmbientLight: {
       /** @defaultValue `AmbientLightDocument` */
-      documentClass: Document.ConfiguredClassForName<"AmbientLight">;
+      documentClass: Document.ImplementationClassFor<"AmbientLight">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -2247,11 +2401,12 @@ declare global {
        */
       typeLabels?: Record<"base", string>;
 
-      /** @defaultValue `AmbientLightDocument` */
+      /** @defaultValue `typeof AmbientLightDocument` */
+      // eslint-disable-next-line no-restricted-syntax
       objectClass: ConfiguredObjectClassOrDefault<typeof AmbientLight>;
 
-      /** @defaultValue `LightingLayer` */
-      layerClass: typeof LightingLayer;
+      /** @defaultValue `typeof LightingLayer` */
+      layerClass: LightingLayer.AnyConstructor;
     };
 
     /**
@@ -2259,7 +2414,7 @@ declare global {
      */
     AmbientSound: {
       /** @defaultValue `AmbientSoundDocument` */
-      documentClass: Document.ConfiguredClassForName<"AmbientSound">;
+      documentClass: Document.ImplementationClassFor<"AmbientSound">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -2271,11 +2426,12 @@ declare global {
        */
       typeLabels?: Record<"base", string>;
 
-      /** @defaultValue `AmbientSound` */
+      /** @defaultValue `typeof AmbientSound` */
+      // eslint-disable-next-line no-restricted-syntax
       objectClass: ConfiguredObjectClassOrDefault<typeof AmbientSound>;
 
-      /** @defaultValue `SoundsLayer` */
-      layerClass: typeof SoundsLayer;
+      /** @defaultValue `typeof SoundsLayer` */
+      layerClass: SoundsLayer.AnyConstructor;
     };
 
     /**
@@ -2283,24 +2439,24 @@ declare global {
      */
     Combatant: {
       /** @defaultValue `Combatant` */
-      documentClass: Document.ConfiguredClassForName<"Combatant">;
+      documentClass: Document.ImplementationClassFor<"Combatant">;
 
       /**
        * @defaultValue `{}`
        * @remarks `TypeDataModel` is preferred to `DataModel` per core Foundry team
        */
-      dataModels: Record<string, typeof DataModel<any, ChatMessage>>;
+      dataModels: Record<string, typeof DataModel<any, Combatant.Implementation>>;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
        */
-      sheetClasses: Record<foundry.documents.BaseCombatant.TypeNames, Record<string, SheetClassConfig>>;
+      sheetClasses: Record<foundry.documents.BaseCombatant.SubType, Record<string, SheetClassConfig>>;
 
       /**
        * @defaultValue `{}`
        * @remarks Initialized by `Localization#initialize`, is an empty object until `i18nInit`
        */
-      typeLabels: Record<foundry.documents.BaseCombatant.TypeNames, string>;
+      typeLabels: Record<foundry.documents.BaseCombatant.SubType, string>;
 
       /** @defaultValue `{}` */
       typeIcons: Record<string, string>;
@@ -2311,7 +2467,7 @@ declare global {
      */
     Drawing: {
       /** @defaultValue `DrawingDocument` */
-      documentClass: Document.ConfiguredClassForName<"Drawing">;
+      documentClass: Document.ImplementationClassFor<"Drawing">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -2323,13 +2479,14 @@ declare global {
        */
       typeLabels?: Record<"base", string>;
 
-      /** @defaultValue `Drawing` */
+      /** @defaultValue `typeof Drawing` */
+      // eslint-disable-next-line no-restricted-syntax
       objectClass: ConfiguredObjectClassOrDefault<typeof Drawing>;
 
-      /** @defaultValue `DrawingsLayer` */
+      /** @defaultValue `typeof DrawingsLayer` */
       layerClass: typeof DrawingsLayer;
 
-      /** @defaultValue `DrawingHUD` */
+      /** @defaultValue `typeof DrawingHUD` */
       hudClass: typeof DrawingHUD;
     };
 
@@ -2360,7 +2517,7 @@ declare global {
       };
 
       /** @defaultValue `MeasuredTemplateDocument` */
-      documentClass: Document.ConfiguredClassForName<"MeasuredTemplate">;
+      documentClass: Document.ImplementationClassFor<"MeasuredTemplate">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -2372,10 +2529,11 @@ declare global {
        */
       typeLabels?: Record<"base", string>;
 
-      /** @defaultValue `MeasuredTemplate` */
+      /** @defaultValue `typeof MeasuredTemplate` */
+      // eslint-disable-next-line no-restricted-syntax
       objectClass: ConfiguredObjectClassOrDefault<typeof MeasuredTemplate>;
 
-      /** @defaultValue `TemplateLayer` */
+      /** @defaultValue `typeof TemplateLayer` */
       layerClass: typeof TemplateLayer;
     };
 
@@ -2384,7 +2542,7 @@ declare global {
      */
     Note: {
       /** @defaultValue `NoteDocument` */
-      documentClass: Document.ConfiguredClassForName<"Note">;
+      documentClass: Document.ImplementationClassFor<"Note">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -2396,21 +2554,42 @@ declare global {
        */
       typeLabels?: Record<"base", string>;
 
-      /** @defaultValue `Note` */
+      /** @defaultValue `typeof Note` */
+      // eslint-disable-next-line no-restricted-syntax
       objectClass: ConfiguredObjectClassOrDefault<typeof Note>;
 
-      /** @defaultValue `NotesLayer` */
-      layerClass: typeof NotesLayer;
+      /** @defaultValue `typeof NotesLayer` */
+      layerClass: NotesLayer.AnyConstructor;
     };
 
-    // TODO: Regions
+    Region: {
+      /** @defaultValue `RegionDocument` */
+      documentClass: Document.ImplementationClassFor<"Region">;
+
+      /** @defaultValue `Region` */
+      // eslint-disable-next-line no-restricted-syntax
+      objectClass: ConfiguredObjectClassOrDefault<typeof Region>;
+
+      /** @defaultValue `RegionLayer` */
+      layerClass: RegionLayer.AnyConstructor;
+
+      /**
+       * @remarks added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
+       */
+      sheetClasses: Record<"base", Record<string, SheetClassConfig>>;
+
+      /**
+       * @remarks Initialized by `Localization#initialize`, is undefined until `i18nInit`
+       */
+      typeLabels?: Record<"base", string>;
+    };
 
     /**
      * Configuration for the Tile embedded document type and its representation on the game Canvas
      */
     Tile: {
       /** @defaultValue `TileDocument` */
-      documentClass: Document.ConfiguredClassForName<"Tile">;
+      documentClass: Document.ImplementationClassFor<"Tile">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -2422,14 +2601,15 @@ declare global {
        */
       typeLabels?: Record<"base", string>;
 
-      /** @defaultValue `Tile` */
+      /** @defaultValue `typeof Tile` */
+      // eslint-disable-next-line no-restricted-syntax
       objectClass: ConfiguredObjectClassOrDefault<typeof Tile>;
 
-      /** @defaultValue `TilesLayer` */
-      layerClass: typeof TilesLayer;
+      /** @defaultValue `typeof TilesLayer` */
+      layerClass: TilesLayer.AnyConstructor;
 
-      /** @defaultValue `TileHUD` */
-      hudClass: typeof TileHUD;
+      /** @defaultValue `typeof TileHUD` */
+      hudClass: TileHUD.AnyConstructor;
     };
 
     /**
@@ -2437,7 +2617,7 @@ declare global {
      */
     Token: {
       /** @defaultValue `TokenDocument` */
-      documentClass: Document.ConfiguredClassForName<"Token">;
+      documentClass: Document.ImplementationClassFor<"Token">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -2449,26 +2629,28 @@ declare global {
        */
       typeLabels?: Record<"base", string>;
 
-      /** @defaultValue `Token` */
+      /** @defaultValue `typeof Token` */
+      // eslint-disable-next-line no-restricted-syntax
       objectClass: ConfiguredObjectClassOrDefault<typeof Token>;
 
-      /** @defaultValue `TokenLayer` */
-      layerClass: typeof TokenLayer;
+      /** @defaultValue `typeof TokenLayer` */
+      layerClass: TokenLayer.AnyConstructor;
 
-      /** @defaultValue `TokenConfig` */
-      prototypeSheetClass: typeof TokenConfig;
+      /** @defaultValue `typeof TokenConfig` */
+      prototypeSheetClass: TokenConfig.AnyConstructor;
 
-      /** @defaultValue `TokenHUD` */
-      hudClass: typeof TokenHUD;
+      /** @defaultValue `typeof TokenHUD` */
+      hudClass: TokenHUD.AnyConstructor;
 
       /** @defaultValue `"TOKEN.Adjectives"` */
       adjectivesPrefix: string;
 
       /**
        * @defaultValue `foundry.canvas.tokens.TokenRingConfig`
-       * @remarks `"ring property is initialized in foundry.canvas.tokens.TokenRingConfig.initialize"`
+       * @remarks Foundry leaves a comment claiming `"ring property is initialized in foundry.canvas.tokens.TokenRingConfig.initialize"`,
+       * and while that's true, it's _instantiated_ here in `config.js` via defineProperty (`enumerable: true`)
        */
-      ring?: foundry.canvas.tokens.TokenRingConfig;
+      readonly ring: foundry.canvas.tokens.TokenRingConfig;
     };
 
     /**
@@ -2476,7 +2658,7 @@ declare global {
      */
     Wall: {
       /** @defaultValue `WallDocument` */
-      documentClass: Document.ConfiguredClassForName<"Wall">;
+      documentClass: Document.ImplementationClassFor<"Wall">;
 
       /**
        * @remarks Added by `DocumentSheetConfig._registerDefaultSheets` in `tail.js`
@@ -2488,11 +2670,12 @@ declare global {
        */
       typeLabels?: Record<"base", string>;
 
-      /** @defaultValue `Wall` */
+      /** @defaultValue `typeof Wall` */
+      // eslint-disable-next-line no-restricted-syntax
       objectClass: ConfiguredObjectClassOrDefault<typeof Wall>;
 
-      /** @defaultValue `WallsLayer` */
-      layerClass: typeof WallsLayer;
+      /** @defaultValue `typeof WallsLayer` */
+      layerClass: WallsLayer.AnyConstructor;
 
       /** @defaultValue `1` */
       thresholdAttenuationMultiplier: number;
@@ -2776,9 +2959,9 @@ declare global {
      * An enumeration of sound effects which can be applied to Sound instances.
      */
     soundEffects: {
-      lowPass: { label: string; effectClass: typeof AudioNode };
-      highpass: { label: string; effectClass: typeof AudioNode };
-      reverb: { label: string; effectClass: typeof AudioNode };
+      lowPass: { label: string; effectClass: AudioNode.AnyConstructor };
+      highpass: { label: string; effectClass: AudioNode.AnyConstructor };
+      reverb: { label: string; effectClass: AudioNode.AnyConstructor };
     };
 
     /**
@@ -2802,7 +2985,7 @@ declare global {
      */
     WebRTC: {
       /** @defaultValue `SimplePeerAVClient` */
-      clientClass: GetKey<WebRTCConfig, "clientClass", typeof SimplePeerAVClient>;
+      clientClass: GetKey<WebRTCConfig, "clientClass", SimplePeerAVClient.AnyConstructor>;
 
       /** @defaultValue `50` */
       detectPeerVolumeInterval: number;
@@ -2832,67 +3015,67 @@ declare global {
   namespace CONFIG {
     interface UI {
       /** @defaultValue `MainMenu` */
-      menu: typeof MainMenu;
+      menu: MainMenu.AnyConstructor;
 
       /** @defaultValue `Sidebar` */
-      sidebar: typeof Sidebar;
+      sidebar: Sidebar.AnyConstructor;
 
       /** @defaultValue `Pause` */
-      pause: typeof Pause;
+      pause: Pause.AnyConstructor;
 
       /** @defaultValue `SceneNavigation` */
-      nav: typeof SceneNavigation;
+      nav: SceneNavigation.AnyConstructor;
 
       /** @defaultValue `Notifications` */
-      notifications: typeof Notifications;
+      notifications: Notifications.AnyConstructor;
 
       /** @defaultValue `ActorDirectory` */
-      actors: typeof ActorDirectory;
+      actors: ActorDirectory.AnyConstructor;
 
       /** @defaultValue `CardsDirectory` */
-      cards: typeof CardsDirectory;
+      cards: CardsDirectory.AnyConstructor;
 
       /** @defaultValue `ChatLog` */
-      chat: typeof ChatLog;
+      chat: ChatLog.AnyConstructor;
 
       /** @defaultValue `CombatTracker` */
-      combat: typeof CombatTracker;
+      combat: CombatTracker.AnyConstructor;
 
       /** @defaultValue `CompendiumDirectory` */
-      compendium: typeof CompendiumDirectory;
+      compendium: CompendiumDirectory.AnyConstructor;
 
       /** @defaultValue `SceneControls` */
-      controls: typeof SceneControls;
+      controls: SceneControls.AnyConstructor;
 
       /** @defaultValue `Hotbar` */
-      hotbar: typeof Hotbar;
+      hotbar: Hotbar.AnyConstructor;
 
       /** @defaultValue `ItemDirectory` */
-      items: typeof ItemDirectory;
+      items: ItemDirectory.AnyConstructor;
 
       /** @defaultValue `JournalDirectory` */
-      journal: typeof JournalDirectory;
+      journal: JournalDirectory.AnyConstructor;
 
       /** @defaultValue `MacroDirectory` */
-      macros: typeof MacroDirectory;
+      macros: MacroDirectory.AnyConstructor;
 
       /** @defaultValue `PlayerList` */
-      players: typeof PlayerList;
+      players: PlayerList.AnyConstructor;
 
       /** @defaultValue `PlaylistDirectory` */
-      playlists: typeof PlaylistDirectory;
+      playlists: PlaylistDirectory.AnyConstructor;
 
       /** @defaultValue `SceneDirectory` */
-      scenes: typeof SceneDirectory;
+      scenes: SceneDirectory.AnyConstructor;
 
       /** @defaultValue `Settings` */
-      settings: typeof Settings;
+      settings: Settings.AnyConstructor;
 
       /** @defaultValue `RollTableDirectory` */
-      tables: typeof RollTableDirectory;
+      tables: RollTableDirectory.AnyConstructor;
 
       /** @defaultValue `CameraViews` */
-      webrtc: typeof CameraViews;
+      webrtc: CameraViews.AnyConstructor;
     }
 
     namespace Canvas {
@@ -2924,97 +3107,56 @@ declare global {
 
       interface Layers {
         /** @defaultValue `{ layerClass: WeatherLayer, group: "primary" }` */
-        weather: LayerDefinition<typeof WeatherEffects>;
+        weather: LayerDefinition<typeof WeatherEffects, "primary">;
 
         /** @defaultValue `{ layerClass: GridLayer, group: "interface" }` */
-        grid: LayerDefinition<typeof GridLayer>;
+        grid: LayerDefinition<typeof GridLayer, "interface">;
 
         /** @defaultValue `{ layerClass: RegionLayer, group: "interface" }` */
-        // regions: LayerDefinition<typeof RegionLayer>;
+        // regions: LayerDefinition<typeof RegionLayer, "interface">;
 
         /** @defaultValue `{ layerClass: DrawingsLayer, group: "interface" }` */
-        drawings: LayerDefinition<typeof DrawingsLayer>;
+        drawings: LayerDefinition<typeof DrawingsLayer, "interface">;
 
         /** @defaultValue `{ layerClass: TemplateLayer, group: "interface" }` */
-        templates: LayerDefinition<typeof TemplateLayer>;
+        templates: LayerDefinition<typeof TemplateLayer, "interface">;
 
         /** @defaultValue `{ layerClass: TokenLayer, group: "interface" }` */
-        tiles: LayerDefinition<typeof TilesLayer>;
+        tiles: LayerDefinition<typeof TilesLayer, "interface">;
 
         /** @defaultValue `{ layerClass: WallsLayer, group: "interface" }` */
-        walls: LayerDefinition<typeof WallsLayer>;
+        walls: LayerDefinition<typeof WallsLayer, "interface">;
 
         /** @defaultValue `{ layerClass: TokenLayer, group: "interface" }` */
-        tokens: LayerDefinition<typeof TokenLayer>;
+        tokens: LayerDefinition<typeof TokenLayer, "interface">;
 
         /** @defaultValue `{ layerClass: SoundsLayer, group: "interface" }` */
-        sounds: LayerDefinition<typeof SoundsLayer>;
+        sounds: LayerDefinition<typeof SoundsLayer, "interface">;
 
         /** @defaultValue `{ layerClass: LightingLayer, group: "interface" }` */
-        lighting: LayerDefinition<typeof LightingLayer>;
+        lighting: LayerDefinition<typeof LightingLayer, "interface">;
 
         /** @defaultValue `{ layerClass: NotesLayer, group: "interface" }` */
-        notes: LayerDefinition<typeof NotesLayer>;
+        notes: LayerDefinition<typeof NotesLayer, "interface">;
 
         /** @defaultValue `{ layerClass: ControlsLayer, group: "interface" }` */
-        controls: LayerDefinition<typeof ControlsLayer>;
-
-        [key: string]: LayerDefinition;
+        controls: LayerDefinition<typeof ControlsLayer, "interface">;
       }
 
-      interface GroupDefinition<
-        GroupClass extends ToSpriteConstructor<CanvasGroupConstructor> = ToSpriteConstructor<CanvasGroupConstructor>,
-      > {
+      // This requires `CanvasGroupConstructor` because `Canvas##createGroups` assumes there's no parameters.
+      interface GroupDefinition<GroupClass extends CanvasGroupConstructor = CanvasGroupConstructor> {
         groupClass: GroupClass;
         parent: string;
         zIndexDrawings?: number;
         zIndexScrollingText?: number;
       }
 
-      interface LayerDefinition<LayerClass extends typeof CanvasLayer = typeof CanvasLayer> {
+      // This requires `typeof CanvasLayer` because `CanvasGroupMixin#_createLayers` assumes there's no parameters.
+      interface LayerDefinition<LayerClass extends typeof CanvasLayer, Group extends keyof CONFIG["Canvas"]["groups"]> {
         layerClass: LayerClass;
-        group: keyof CONFIG["Canvas"]["groups"];
-      }
-
-      interface GridStyle {
-        label: string;
-        shaderClass: typeof GridShader;
-        shaderOptions: {
-          style: number;
-        };
+        group: Group;
       }
 
-      /**
-       * A light source animation configuration object.
-       */
-      type LightSourceAnimationConfig = Record<
-        string,
-        {
-          label: string;
-          animation: LightAnimationFunction;
-          backgroundShader?: typeof AdaptiveBackgroundShader;
-          illuminationShader?: typeof AbstractBaseShader;
-          colorationShader?: typeof AbstractBaseShader;
-        }
-      >;
-
-      /**
-       * A darkness source animation configuration object.
-       */
-      type DarknessSourceAnimationConfig = Record<
-        string,
-        { label: string; animation: LightAnimationFunction; darknessShader: typeof AdaptiveDarknessShader }
-      >;
-
-      type LightAnimationFunction = (
-        // `this` is technically not a `PointLightSource`.
-        // Instead it is `foundry.canvas.sources.Pointfoundry.canvas.sources.LightSource.prototype`.
-        // However differentiating this would be a lot of work for little gain as nothing critical happens in the constructor.
-        this: PointLightSource,
-        dt: number,
-        properties?: { speed?: number; intensity?: number; reverse?: false },
-      ) => void;
-
       namespace Pings {
         interface Style {
           class: unknown;
@@ -3025,23 +3167,6 @@ declare global {
       }
     }
 
-    interface WeatherAmbienceConfiguration {
-      id: string;
-      label: string;
-      filter: {
-        enabled: boolean;
-        blendMode: PIXI.BLEND_MODES;
-      };
-      effects: WeatherEffectConfiguration;
-    }
-
-    interface WeatherEffectConfiguration {
-      id: string;
-      effectClass: typeof ParticleEffect | typeof WeatherShaderEffect;
-      blendMode: PIXI.BLEND_MODES;
-      config: Record<string, unknown>;
-    }
-
     // The point of this interface is to be declaration merged into so you can override `DefaultSpecialStatusEffects` and remove existing keys. It's never used when empty.
     // eslint-disable-next-line @typescript-eslint/no-empty-object-type
     interface SpecialStatusEffects {}
@@ -3082,24 +3207,40 @@ declare global {
       }
     }
 
+    /** @privateRemarks Foundry does not document the array options */
     interface WallDoorSound {
       /** A localization string label */
       label: string;
 
-      /** A sound path when the door is closed */
-      close: string;
+      /**
+       * A sound path when the door is closed
+       * @remarks If an array is provided, a random entry is chosen
+       */
+      close?: string | string[];
 
-      /** A sound path when the door becomes locked */
-      lock: string;
+      /**
+       * A sound path when the door becomes locked
+       * @remarks If an array is provided, a random entry is chosen
+       */
+      lock?: string | string[];
 
-      /** A sound path when opening the door */
-      open: string;
+      /**
+       * A sound path when opening the door
+       * @remarks If an array is provided, a random entry is chosen
+       */
+      open?: string | string[];
 
-      /** A sound path when attempting to open a locked door */
-      test: string;
+      /**
+       * A sound path when attempting to open a locked door
+       * @remarks If an array is provided, a random entry is chosen
+       */
+      test?: string | string[];
 
-      /** A sound path when the door becomes unlocked */
-      unlock: string;
+      /**
+       * A sound path when the door becomes unlocked
+       * @remarks If an array is provided, a random entry is chosen
+       */
+      unlock?: string | string[];
     }
 
     namespace Dice {
@@ -3128,7 +3269,7 @@ interface SheetClassConfig {
 
   canConfigure: boolean;
 
-  cls: typeof DocumentSheet;
+  cls: DocumentSheet.AnyConstructor;
 
   default: boolean;
 
@@ -3137,7 +3278,7 @@ interface SheetClassConfig {
   label: string;
 }
 
-type PixiContainerConstructor = typeof PIXI.Container;
+type PixiContainerConstructor = PIXI.Container.AnyConstructor;
 interface CanvasGroup extends PIXI.Container {
   sortableChildren: boolean;
 }
@@ -3147,16 +3288,7 @@ interface CanvasGroupConstructor extends PixiContainerConstructor {
 
   /**
    * The name of this canvas group
-   * @remarks Not used in EffectsCanvasGroup in v11
+   * @remarks Can be undefined in some cases (e.g `EffectsCanvasGroup`) to prevent other groups using it as a parent
    */
-  groupName?: string;
-}
-
-type AnySpriteClass = abstract new (sprite?: SpriteMesh) => unknown;
-
-type ToSpriteConstructor<Class extends AnySpriteClass> = ToSpriteConstructorInterface<Class>;
-
-// @ts-expect-error - Ignore the "incorrectly extends interface" error inherent to this pattern.
-interface ToSpriteConstructorInterface<T extends AnySpriteClass> extends T {
-  new (sprite: SpriteMesh): InstanceType<T>;
+  groupName?: string | undefined;
 }