@league-of-foundry-developers/foundry-vtt-types 13.346.0-beta.20250804084032 → 13.346.0-beta.20250805163236

package/src/foundry/client/canvas/groups/primary.d.mts

@@ -1,4 +1,4 @@
-import type { Brand, HandleEmptyObject, Identity } from "#utils";
+import type { Brand, FixedInstanceType, HandleEmptyObject, Identity } from "#utils";
 import type { PrimaryCanvasGroupAmbienceFilter } from "#client/canvas/rendering/filters/_module.d.mts";
 import type { CachedContainer, SpriteMesh } from "#client/canvas/containers/_module.d.mts";
 import type { CanvasGroupMixin } from "#client/canvas/groups/_module.d.mts";
@@ -13,7 +13,7 @@ import type {
 declare module "#configuration" {
   namespace Hooks {
     interface CanvasGroupConfig {
-      PrimaryCanvasGroup: PrimaryCanvasGroup.Any;
+      PrimaryCanvasGroup: PrimaryCanvasGroup.Implementation;
     }
   }
 }
@@ -21,17 +21,26 @@ declare module "#configuration" {
 /**
  * The primary Canvas group which generally contains tangible physical objects which exist within the Scene.
  * This group is a {@linkcode CachedContainer} which is rendered to the Scene as a {@linkcode SpriteMesh}.
- * This allows the rendered result of the Primary Canvas Group to be affected by a {@linkcode BaseSamplerShader}.
+ * This allows the rendered result of the Primary Canvas Group to be affected by a
+ * {@linkcode foundry.canvas.rendering.shaders.BaseSamplerShader | BaseSamplerShader}.
  */
 declare class PrimaryCanvasGroup<
   DrawOptions extends PrimaryCanvasGroup.DrawOptions = PrimaryCanvasGroup.DrawOptions,
   TearDownOptions extends PrimaryCanvasGroup.TearDownOptions = PrimaryCanvasGroup.TearDownOptions,
 > extends CanvasGroupMixin<typeof CachedContainer, "primary">(CachedContainer)<DrawOptions, TearDownOptions> {
+  // static override groupName is handled by the CanvasGroupMixin type
+
   /**
    * @param sprite - (default: `new SpriteMesh(undefined, BaseSamplerShader)`)
+   * @remarks Because `Canvas##createGroups` passes no arguments, this will always just use the default
    */
   constructor(sprite?: SpriteMesh);
 
+  /**
+   * @defaultValue `"none"`
+   */
+  override eventMode: PIXI.EventMode;
+
   /**
    * Sort order to break ties on the group/layer level.
    */
@@ -49,11 +58,6 @@ declare class PrimaryCanvasGroup<
    */
   static override textureConfiguration: CachedContainer.TextureConfiguration;
 
-  /**
-   * @defaultValue `"none"`
-   */
-  override eventMode: PIXI.EventMode;
-
   /**
    * @defaultValue `[0, 0, 0, 0]`
    */
@@ -61,13 +65,14 @@ declare class PrimaryCanvasGroup<
 
   /**
    * The background color in RGB.
+   * @internal
    */
-  _backgroundColor: Color.RGBColorVector | undefined;
+  protected _backgroundColor: Color.RGBColorVector | undefined;
 
   /**
    * Track the set of HTMLVideoElements which are currently playing as part of this group.
    */
-  videoMeshes: Set<SpriteMesh>;
+  videoMeshes: Set<PrimarySpriteMesh.Any>;
 
   /**
    * Occludable objects above this elevation are faded on hover.
@@ -78,18 +83,21 @@ declare class PrimaryCanvasGroup<
   /**
    * Allow API users to override the default elevation of the background layer.
    * This is a temporary solution until more formal support for scene levels is added in a future release.
+   * @defaultValue `0`
    */
   static BACKGROUND_ELEVATION: number;
 
   /**
    * The primary background image configured for the Scene, rendered as a SpriteMesh.
+   * @remarks Only `undefined` prior to first draw
    */
-  background: SpriteMesh | undefined;
+  background: PrimarySpriteMesh | undefined;
 
   /**
    * The primary foreground image configured for the Scene, rendered as a SpriteMesh.
+   * @remarks Only `undefined` prior to first draw
    */
-  foreground: SpriteMesh | undefined;
+  foreground: PrimarySpriteMesh | undefined;
 
   /**
    * A Quadtree which partitions and organizes primary canvas objects.
@@ -98,7 +106,6 @@ declare class PrimaryCanvasGroup<
 
   /**
    * The collection of PrimaryDrawingContainer objects which are rendered in the Scene.
-   * @privateRemarks Foundry types this as `Collection<PrimaryDrawingContainer>`, which doesn't exist. It's `PrimaryGraphics` in practice.
    */
   drawings: Collection<PrimaryGraphics>;
 
@@ -116,18 +123,17 @@ declare class PrimaryCanvasGroup<
 
   /**
    * The ambience filter which is applying post-processing effects.
+   * @internal
    */
-  _ambienceFilter: PrimaryCanvasGroupAmbienceFilter | undefined;
+  protected _ambienceFilter: PrimaryCanvasGroupAmbienceFilter | undefined;
 
   /**
    * Return the base HTML image or video element which provides the background texture.
-   * @privateRemarks Foundry does not indicate the possibility of a null return
    */
   get backgroundSource(): HTMLImageElement | HTMLVideoElement | null;
 
   /**
    * Return the base HTML image or video element which provides the foreground texture.
-   * @privateRemarks Foundry does not indicate the possibility of a null return
    */
   get foregroundSource(): HTMLImageElement | HTMLVideoElement | null;
 
@@ -143,7 +149,7 @@ declare class PrimaryCanvasGroup<
 
   protected override _draw(options: HandleEmptyObject<DrawOptions>): Promise<void>;
 
-  protected override _render(_renderer: PIXI.Renderer): void;
+  protected override _render(renderer: PIXI.Renderer): void;
 
   protected override _tearDown(options: HandleEmptyObject<TearDownOptions>): Promise<void>;
 
@@ -188,32 +194,53 @@ declare class PrimaryCanvasGroup<
 
   /**
    * Override the default PIXI.Container behavior for how objects in this container are sorted.
-   * @remarks Actually an override of `PIXI.Container#sortChildren`
    */
-  sortChildren(): void;
+  override sortChildren(): void;
 
   /**
-   * Handle mousemove events on the primary group to update the hovered state of its children.
-   * @remarks Foundry marked `@internal`
+   * The sorting function used to order objects inside the Primary Canvas Group.
+   * Overrides the default sorting function defined for the PIXI.Container.
+   * Sort Tokens PCO above other objects except WeatherEffects, then Drawings PCO, all else held equal.
+   * @param a - An object to display
+   * @param b - Some other object to display
+   * @internal
    */
-  _onMouseMove(): void;
+  protected static _compareObjects(
+    a: PrimaryCanvasObjectMixin.AnyMixed | PIXI.DisplayObject,
+    b: PrimaryCanvasObjectMixin.AnyMixed | PIXI.DisplayObject,
+  ): number;
 
   /**
-   * @deprecated since v12, will be removed in v14
-   * @remarks `"PrimaryCanvasGroup#mapElevationAlpha is deprecated. Use canvas.masks.depth.mapElevation(elevation) instead."`
+   * Handle mousemove events on the primary group to update the hovered state of its children.
+   * @param currentPos    - Current mouse position
+   * @param hasMouseMoved - Has the mouse been moved (or it is a simulated mouse move event)?
+   * @internal
    */
-  mapElevationToDepth(elevation: number): number;
+  protected _onMouseMove(currentPos: PIXI.Point, hasMouseMoved: boolean): void;
 
   /**
-   * @deprecated since v11, will be removed in v13
-   * @remarks "PrimaryCanvasGroup#mapElevationAlpha is deprecated in favor of PrimaryCanvasGroup#mapElevationToDepth"
+   * @deprecated "`PrimaryCanvasGroup#mapElevationAlpha` is deprecated. Use {@linkcode foundry.canvas.layers.CanvasDepthMask.mapElevation | canvas.masks.depth.mapElevation(elevation)}
+   * instead." (since v12, until v14)
    */
-  mapElevationAlpha(elevation: number): number;
+  mapElevationToDepth(elevation: number): number;
+
+  #PrimaryCanvasGroup: true;
 }
 
 declare namespace PrimaryCanvasGroup {
-  interface Any extends AnyPrimaryCanvasGroup {}
-  interface AnyConstructor extends Identity<typeof AnyPrimaryCanvasGroup> {}
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode Implementation} instead */
+  type Any = Internal.Any;
+
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode ImplementationClass} instead */
+  type AnyConstructor = Internal.AnyConstructor;
+
+  namespace Internal {
+    interface Any extends AnyPrimaryCanvasGroup {}
+    interface AnyConstructor extends Identity<typeof AnyPrimaryCanvasGroup> {}
+  }
+
+  interface ImplementationClass extends Identity<typeof CONFIG.Canvas.groups.primary.groupClass> {}
+  interface Implementation extends FixedInstanceType<ImplementationClass> {}
 
   interface DrawOptions extends CanvasGroupMixin.DrawOptions {}
 

package/src/foundry/client/canvas/groups/rendered.d.mts

@@ -1,10 +1,10 @@
-import type { Identity } from "#utils";
+import type { FixedInstanceType, Identity } from "#utils";
 import type { CanvasGroupMixin } from "#client/canvas/groups/_module.d.mts";
 
 declare module "#configuration" {
   namespace Hooks {
     interface CanvasGroupConfig {
-      RenderedCanvasGroup: RenderedCanvasGroup.Any;
+      RenderedCanvasGroup: RenderedCanvasGroup.Implementation;
     }
   }
 }
@@ -16,6 +16,8 @@ declare class RenderedCanvasGroup<
   DrawOptions extends RenderedCanvasGroup.DrawOptions = RenderedCanvasGroup.DrawOptions,
   TearDownOptions extends RenderedCanvasGroup.TearDownOptions = RenderedCanvasGroup.TearDownOptions,
 > extends CanvasGroupMixin<typeof PIXI.Container, "rendered">(PIXI.Container)<DrawOptions, TearDownOptions> {
+  // static override groupName is handled by the CanvasGroupMixin type
+
   /**
    * Should this group tear down its non-layer children?
    * @defaultValue `false`
@@ -24,8 +26,19 @@ declare class RenderedCanvasGroup<
 }
 
 declare namespace RenderedCanvasGroup {
-  interface Any extends AnyRenderedCanvasGroup {}
-  interface AnyConstructor extends Identity<typeof AnyRenderedCanvasGroup> {}
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode Implementation} instead */
+  type Any = Internal.Any;
+
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode ImplementationClass} instead */
+  type AnyConstructor = Internal.AnyConstructor;
+
+  namespace Internal {
+    interface Any extends AnyRenderedCanvasGroup {}
+    interface AnyConstructor extends Identity<typeof AnyRenderedCanvasGroup> {}
+  }
+
+  interface ImplementationClass extends Identity<typeof CONFIG.Canvas.groups.rendered.groupClass> {}
+  interface Implementation extends FixedInstanceType<ImplementationClass> {}
 
   interface DrawOptions extends CanvasGroupMixin.DrawOptions {}
 

package/src/foundry/client/canvas/groups/visibility.d.mts

@@ -1,4 +1,4 @@
-import type { EmptyObject, HandleEmptyObject, Identity, InexactPartial } from "#utils";
+import type { EmptyObject, FixedInstanceType, HandleEmptyObject, Identity, InexactPartial } from "#utils";
 import type { Canvas } from "#client/canvas/_module.mjs";
 import type { VisibilityFilter } from "#client/canvas/rendering/filters/_module.mjs";
 import type { CanvasGroupMixin } from "#client/canvas/groups/_module.d.mts";
@@ -15,7 +15,7 @@ import type { AllHooks as hookEvents } from "#client/hooks.mjs";
 declare module "#configuration" {
   namespace Hooks {
     interface CanvasGroupConfig {
-      CanvasVisibility: CanvasVisibility.Any;
+      CanvasVisibility: CanvasVisibility.Implementation;
     }
   }
 }
@@ -178,8 +178,19 @@ declare class CanvasVisibility<
 }
 
 declare namespace CanvasVisibility {
-  interface Any extends AnyCanvasVisibility {}
-  interface AnyConstructor extends Identity<typeof AnyCanvasVisibility> {}
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode Implementation} instead */
+  type Any = Internal.Any;
+
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode ImplementationClass} instead */
+  type AnyConstructor = Internal.AnyConstructor;
+
+  namespace Internal {
+    interface Any extends AnyCanvasVisibility {}
+    interface AnyConstructor extends Identity<typeof AnyCanvasVisibility> {}
+  }
+
+  interface ImplementationClass extends Identity<typeof CONFIG.Canvas.groups.visibility.groupClass> {}
+  interface Implementation extends FixedInstanceType<ImplementationClass> {}
 
   interface DrawOptions extends CanvasGroupMixin.DrawOptions {}
 
@@ -192,7 +203,7 @@ declare namespace CanvasVisibility {
      * @remarks Only `undefined` immediately following construction. Gets set to a Source or `null` when {@linkcode Canvas.perception | canvas.perception} receives the
      * {@linkcode PerceptionManager.RENDER_FLAGS.initializeVisionModes | initializeVisionModes} render flag
      */
-    source: PointVisionSource.Any | null | undefined;
+    source: PointVisionSource.Internal.Any | null | undefined;
 
     /**
      * @remarks Defaults to `{}` at construction. Gets set to {@linkcode VisionMode.lighting | this.visionModeData.source?.visionMode.lighting}`|| {}` when
@@ -287,7 +298,7 @@ declare namespace CanvasVisibility {
      */
     elevation?: number;
 
-    los: Map<PointVisionSource.Any, boolean>;
+    los: Map<PointVisionSource.Internal.Any, boolean>;
   }
 
   /**

package/src/foundry/client/canvas/interaction/ruler/ruler.d.mts

@@ -69,8 +69,16 @@ declare class Ruler extends BaseRuler {
 }
 
 declare namespace Ruler {
-  interface Any extends AnyRuler {}
-  interface AnyConstructor extends Identity<typeof AnyRuler> {}
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode Implementation} instead */
+  type Any = Internal.Any;
+
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode ImplementationClass} instead */
+  type AnyConstructor = Internal.AnyConstructor;
+
+  namespace Internal {
+    interface Any extends AnyRuler {}
+    interface AnyConstructor extends Identity<typeof AnyRuler> {}
+  }
 
   interface ImplementationClass extends Identity<CONFIG["Canvas"]["rulerClass"]> {}
   interface Implementation extends FixedInstanceType<ImplementationClass> {}

package/src/foundry/client/canvas/layers/controls.d.mts

@@ -9,7 +9,7 @@ import type { Ping, Ruler } from "#client/canvas/interaction/_module.d.mts";
 declare module "#configuration" {
   namespace Hooks {
     interface InteractionLayerConfig {
-      ControlsLayer: ControlsLayer.Any;
+      ControlsLayer: ControlsLayer.Implementation;
     }
   }
 }
@@ -235,11 +235,19 @@ declare class ControlsLayer extends InteractionLayer {
 }
 
 declare namespace ControlsLayer {
-  interface Any extends AnyControlsLayer {}
-  interface AnyConstructor extends Identity<typeof AnyControlsLayer> {}
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode Implementation} instead */
+  type Any = Internal.Any;
 
-  type ImplementationClass = CONFIG["Canvas"]["layers"]["controls"]["layerClass"];
-  type Implementation = FixedInstanceType<ImplementationClass>;
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode ImplementationClass} instead */
+  type AnyConstructor = Internal.AnyConstructor;
+
+  namespace Internal {
+    interface Any extends AnyControlsLayer {}
+    interface AnyConstructor extends Identity<typeof AnyControlsLayer> {}
+  }
+
+  interface ImplementationClass extends Identity<CONFIG["Canvas"]["layers"]["controls"]["layerClass"]> {}
+  interface Implementation extends FixedInstanceType<ImplementationClass> {}
 
   interface DrawOptions extends InteractionLayer.DrawOptions {}
 

package/src/foundry/client/canvas/layers/sounds.d.mts

@@ -30,7 +30,7 @@ declare class SoundsLayer extends PlaceablesLayer<"AmbientSound"> {
    * A mapping of ambient audio sources which are active within the rendered Scene
    * @defaultValue `new foundry.utils.Collection()`
    */
-  sources: foundry.utils.Collection<foundry.canvas.sources.PointSoundSource.Any>;
+  sources: Collection<foundry.canvas.sources.PointSoundSource.Internal.Any>;
 
   /**
    * @privateRemarks This is not overridden in foundry but reflects the real behavior.

package/src/foundry/client/canvas/perception/detection-mode.d.mts

@@ -48,7 +48,7 @@ declare class DetectionMode extends DataModel<DetectionMode.Schema> {
    * @returns Is the test target visible?
    */
   testVisibility(
-    visionSource: PointVisionSource.Any,
+    visionSource: PointVisionSource.Internal.Any,
     mode: TokenDocument.DetectionModeData,
     config: CanvasVisibility.TestConfig,
   ): boolean;
@@ -62,7 +62,10 @@ declare class DetectionMode extends DataModel<DetectionMode.Schema> {
    * @remarks Will always be passed a `target` when called by {@linkcode testVisibility | DetectionMode#testVisibility}, it just might possibly be `undefined`.
    * All use is gated behind an `instanceof Token` check, so that's fine.
    */
-  protected _canDetect(visionSource: PointVisionSource.Any, target: CanvasVisibility.TestObject | undefined): boolean;
+  protected _canDetect(
+    visionSource: PointVisionSource.Internal.Any,
+    target: CanvasVisibility.TestObject | undefined,
+  ): boolean;
 
   /**
    * Evaluate a single test point to confirm whether it is visible.
@@ -77,7 +80,7 @@ declare class DetectionMode extends DataModel<DetectionMode.Schema> {
    * See {@linkcode _canDetect} remarks.
    */
   protected _testPoint(
-    visionSource: PointVisionSource.Any,
+    visionSource: PointVisionSource.Internal.Any,
     mode: TokenDocument.DetectionModeData,
     target: CanvasVisibility.TestObject | undefined,
     test: CanvasVisibility.Test,
@@ -97,7 +100,7 @@ declare class DetectionMode extends DataModel<DetectionMode.Schema> {
    * See {@linkcode _canDetect} remarks.
    */
   protected _testLOS(
-    visionSource: PointVisionSource.Any,
+    visionSource: PointVisionSource.Internal.Any,
     mode: TokenDocument.DetectionModeData,
     target: CanvasVisibility.TestObject | undefined,
     test: CanvasVisibility.Test,
@@ -115,7 +118,7 @@ declare class DetectionMode extends DataModel<DetectionMode.Schema> {
    * See {@linkcode _canDetect} remarks.
    */
   protected _testAngle(
-    visionSource: PointVisionSource.Any,
+    visionSource: PointVisionSource.Internal.Any,
     mode: TokenDocument.DetectionModeData,
     target: CanvasVisibility.TestObject | undefined,
     test: CanvasVisibility.Test,
@@ -133,7 +136,7 @@ declare class DetectionMode extends DataModel<DetectionMode.Schema> {
    * See {@linkcode _canDetect} remarks.
    */
   protected _testRange(
-    visionSource: PointVisionSource.Any,
+    visionSource: PointVisionSource.Internal.Any,
     mode: TokenDocument.DetectionModeData,
     target: CanvasVisibility.TestObject | undefined,
     test: CanvasVisibility.Test,

package/src/foundry/client/canvas/perception/detection-modes/darkvision.d.mts

@@ -10,7 +10,7 @@ import type { PointVisionSource } from "#client/canvas/sources/_module.d.mts";
  */
 declare class DetectionModeDarkvision extends DetectionMode {
   protected override _canDetect(
-    visionSource: PointVisionSource.Any,
+    visionSource: PointVisionSource.Internal.Any,
     target: CanvasVisibility.TestObject | undefined,
   ): boolean;
 }

package/src/foundry/client/canvas/perception/detection-modes/invisibility-perception.d.mts

@@ -17,7 +17,7 @@ declare class DetectionModeInvisibility extends DetectionMode {
   protected static override _detectionFilter: GlowOverlayFilter | undefined;
 
   protected override _canDetect(
-    visionSource: PointVisionSource.Any,
+    visionSource: PointVisionSource.Internal.Any,
     target: CanvasVisibility.TestObject | undefined,
   ): boolean;
 }

package/src/foundry/client/canvas/perception/detection-modes/light-perception.d.mts

@@ -10,12 +10,12 @@ import type { PointVisionSource } from "#client/canvas/sources/_module.d.mts";
  */
 declare class DetectionModeLightPerception extends DetectionMode {
   protected override _canDetect(
-    visionSource: PointVisionSource.Any,
+    visionSource: PointVisionSource.Internal.Any,
     target: CanvasVisibility.TestObject | undefined,
   ): boolean;
 
   protected override _testPoint(
-    visionSource: PointVisionSource.Any,
+    visionSource: PointVisionSource.Internal.Any,
     mode: TokenDocument.DetectionModeData,
     target: CanvasVisibility.TestObject | undefined,
     test: CanvasVisibility.Test,

package/src/foundry/client/canvas/perception/detection-modes/super-perception.d.mts

@@ -15,7 +15,7 @@ declare class DetectionModeAll extends DetectionMode {
   protected static override _detectionFilter: OutlineOverlayFilter | undefined;
 
   protected override _canDetect(
-    visionSource: PointVisionSource.Any,
+    visionSource: PointVisionSource.Internal.Any,
     target: CanvasVisibility.TestObject | undefined,
   ): boolean;
 }

package/src/foundry/client/canvas/perception/detection-modes/tremor-perception.d.mts

@@ -14,7 +14,7 @@ declare class DetectionModeTremor extends DetectionMode {
   protected static override _detectionFilter: OutlineOverlayFilter | undefined;
 
   protected override _canDetect(
-    visionSource: PointVisionSource.Any,
+    visionSource: PointVisionSource.Internal.Any,
     target: CanvasVisibility.TestObject | undefined,
   ): boolean;
 }

package/src/foundry/client/canvas/perception/fog.d.mts

@@ -48,7 +48,7 @@ declare class FogManager extends EventEmitterMixin() {
    * The configured options used for the saved fog-of-war texture.
    * @remarks Only `undefined` prior to the first time the canvas visibility layer is `#draw()`n
    */
-  get textureConfiguration(): CanvasVisibility["textureConfiguration"];
+  get textureConfiguration(): CanvasVisibility.Implementation["textureConfiguration"];
 
   /**
    * Does the currently viewed Scene support Token field of vision?
@@ -144,11 +144,19 @@ declare class FogManager extends EventEmitterMixin() {
 }
 
 declare namespace FogManager {
-  interface Any extends AnyFogManager {}
-  interface AnyConstructor extends Identity<typeof AnyFogManager> {}
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode Implementation} instead */
+  type Any = Internal.Any;
 
-  type ImplementationClass = CONFIG["Canvas"]["fogManager"];
-  type Implementation = FixedInstanceType<ImplementationClass>;
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode ImplementationClass} instead */
+  type AnyConstructor = Internal.AnyConstructor;
+
+  namespace Internal {
+    interface Any extends AnyFogManager {}
+    interface AnyConstructor extends Identity<typeof AnyFogManager> {}
+  }
+
+  interface ImplementationClass extends Identity<CONFIG["Canvas"]["fogManager"]> {}
+  interface Implementation extends FixedInstanceType<ImplementationClass> {}
 
   /**
    * @deprecated Replaced by {@linkcode FogManager.ImplementationClass}.

package/src/foundry/client/canvas/perception/vision-mode.d.mts

@@ -105,25 +105,25 @@ declare class VisionMode extends DataModel<
    * Special activation handling that could be implemented by `VisionMode` subclasses
    * @param source - Activate this `VisionMode` for a specific source
    */
-  protected _activate(source: PointVisionSource.Any): void;
+  protected _activate(source: PointVisionSource.Internal.Any): void;
 
   /**
    * Special deactivation handling that could be implemented by `VisionMode` subclasses
    * @param source - Deactivate this `VisionMode` for a specific source
    */
-  protected _deactivate(source: PointVisionSource.Any): void;
+  protected _deactivate(source: PointVisionSource.Internal.Any): void;
 
   /**
    * Special handling which is needed when this Vision Mode is activated for a VisionSource.
    * @param source - Activate this `VisionMode` for a specific source
    */
-  activate(source: PointVisionSource.Any): void;
+  activate(source: PointVisionSource.Internal.Any): void;
 
   /**
    * Special handling which is needed when this Vision Mode is deactivated for a VisionSource.
    * @param source - Deactivate this `VisionMode` for a specific source
    */
-  deactivate(source: PointVisionSource.Any): void;
+  deactivate(source: PointVisionSource.Internal.Any): void;
 
   /**
    * An animation function which runs every frame while this Vision Mode is active.

package/src/foundry/client/canvas/placeables/tokens/ring.d.mts

@@ -198,8 +198,16 @@ declare class TokenRing {
 }
 
 declare namespace TokenRing {
-  interface Any extends AnyTokenRing {}
-  interface AnyConstructor extends Identity<typeof AnyTokenRing> {}
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode Implementation} instead */
+  type Any = Internal.Any;
+
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode ImplementationClass} instead */
+  type AnyConstructor = Internal.AnyConstructor;
+
+  namespace Internal {
+    interface Any extends AnyTokenRing {}
+    interface AnyConstructor extends Identity<typeof AnyTokenRing> {}
+  }
 
   interface ImplementationClass extends Identity<CONFIG["Token"]["ring"]["ringClass"]> {}
   interface Implementation extends FixedInstanceType<ImplementationClass> {}

package/src/foundry/client/canvas/primary/primary-canvas-object.d.mts

@@ -178,7 +178,7 @@ declare namespace PrimaryCanvasObjectMixin {
    * @remarks {@linkcode PrimaryCanvasObject._onAdded | PrimaryCanvasObject#_onAdded} throws if not passed a either {@linkcode PrimaryCanvasContainer}
    * or whatever {@linkcode canvas.primary} currently is, which presumably will be a {@linkcode PrimaryCanvasGroup}
    */
-  type Parent = PrimaryCanvasGroup.Any | primary.PrimaryCanvasContainer.Any;
+  type Parent = PrimaryCanvasGroup.Implementation | primary.PrimaryCanvasContainer.Any;
 
   /** @remarks See {@linkcode PrimaryCanvasObject.object | PrimaryCanvasObject#object} remarks */
   type OwningObject = placeables.PlaceableObject.Any | CanvasGroupMixin.AnyMixed;

package/src/foundry/client/canvas/rendering/filters/effects-masking.d.mts

@@ -94,11 +94,18 @@ declare class VisualEffectsMaskingFilter extends AbstractBaseMaskFilter {
 }
 
 declare namespace VisualEffectsMaskingFilter {
-  interface Any extends AnyVisualEffectsMaskingFilter {}
-  interface AnyConstructor extends Identity<typeof AnyVisualEffectsMaskingFilter> {}
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode Implementation} instead */
+  type Any = Internal.Any;
 
-  // TODO: This can't be an interface yet because of 'An interface can only extend an object type or intersection of object types with statically known members' errors
-  type ImplementationClass = CONFIG["Canvas"]["visualEffectsMaskingFilter"];
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode ImplementationClass} instead */
+  type AnyConstructor = Internal.AnyConstructor;
+
+  namespace Internal {
+    interface Any extends AnyVisualEffectsMaskingFilter {}
+    interface AnyConstructor extends Identity<typeof AnyVisualEffectsMaskingFilter> {}
+  }
+
+  interface ImplementationClass extends Identity<CONFIG["Canvas"]["visualEffectsMaskingFilter"]> {}
   interface Implementation extends FixedInstanceType<ImplementationClass> {}
 
   type PostProcessModes = Array<keyof typeof VisualEffectsMaskingFilter.POST_PROCESS_TECHNIQUES>;

package/src/foundry/client/canvas/rendering/filters/visibility.d.mts

@@ -60,11 +60,18 @@ declare class VisibilityFilter extends AbstractBaseMaskFilter {
 }
 
 declare namespace VisibilityFilter {
-  interface Any extends AnyVisibilityFilter {}
-  interface AnyConstructor extends Identity<typeof AnyVisibilityFilter> {}
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode Implementation} instead */
+  type Any = Internal.Any;
 
-  // TODO: This can't be an interface yet because of 'An interface can only extend an object type or intersection of object types with statically known members' errors
-  type ImplementationClass = CONFIG["Canvas"]["visibilityFilter"];
+  /** @deprecated There should only be a single implementation of this class in use at one time, use {@linkcode ImplementationClass} instead */
+  type AnyConstructor = Internal.AnyConstructor;
+
+  namespace Internal {
+    interface Any extends AnyVisibilityFilter {}
+    interface AnyConstructor extends Identity<typeof AnyVisibilityFilter> {}
+  }
+
+  interface ImplementationClass extends Identity<CONFIG["Canvas"]["visibilityFilter"]> {}
   interface Implementation extends FixedInstanceType<ImplementationClass> {}
 
   /** @internal */

package/src/foundry/client/canvas/sources/base-effect-source.d.mts

@@ -59,8 +59,7 @@ declare abstract class BaseEffectSource<
    * Some other object which is responsible for this source.
    * @privateRemarks see {@linkcode BaseEffectSource.ConstructorOptions.object}
    */
-  // TODO: 4th type param for this?
-  object: placeables.PlaceableObject.Any | EnvironmentCanvasGroup.Any | null;
+  object: placeables.PlaceableObject.Any | EnvironmentCanvasGroup.Implementation | null;
 
   /**
    * The source id linked to this effect source.
@@ -230,7 +229,7 @@ declare namespace BaseEffectSource {
      * as an exception to Foundry's typing of just {@linkcode PlaceableObject}. Otherwise, is only ever {@linkcode placeables.AmbientLight | AmbientLight},
      * {@linkcode placeables.AmbientSound | AmbientSound}, or {@linkcode placeables.Token | Token} in Foundry usage
      */
-    object: placeables.PlaceableObject.Any | EnvironmentCanvasGroup.Any;
+    object: placeables.PlaceableObject.Any | EnvironmentCanvasGroup.Implementation;
 
     /**
      * A unique ID for this source. This will be set automatically if an object is provided, otherwise is required.