@react-shimeji/core 0.2.3 → 0.3.0

package/dist/index.d.cts

@@ -43,6 +43,8 @@ interface Pose {
 interface AnimationDefinition {
     /** Optional Shimeji expression controlling whether this animation applies. */
     condition?: string;
+    /** Whether this animation is the turning variant of a Move action. */
+    turn?: boolean;
     /** Ordered pose frames. */
     poses: Pose[];
 }
@@ -82,6 +84,12 @@ interface ActionDefinition {
     x?: string | number;
     /** Vertical offset expression. */
     y?: string | number;
+    /** Dragging/carrying horizontal offset expression. */
+    offsetX?: string | number;
+    /** Dragging/carrying vertical offset expression. */
+    offsetY?: string | number;
+    /** Whether offsets are measured from the image origin or anchor. */
+    offsetType?: string;
     /** Initial horizontal velocity expression. */
     initialVx?: string | number;
     /** Initial vertical velocity expression. */
@@ -98,6 +106,12 @@ interface ActionDefinition {
     bornY?: string | number;
     /** Behavior assigned to a spawned child. */
     bornBehavior?: string;
+    /** Optional character identifier assigned to a spawned child. */
+    bornMascot?: string;
+    /** Number of children produced by breeding actions. */
+    bornCount?: string | number;
+    /** Tick interval used by repeating breeding actions. */
+    bornInterval?: string | number;
     /** Carried-element horizontal offset expression. */
     ieOffsetX?: string | number;
     /** Carried-element vertical offset expression. */
@@ -119,6 +133,10 @@ interface BehaviorDefinition {
     conditions: string[];
     /** Candidates considered after this behavior completes. */
     nextBehaviors: BehaviorDefinition[];
+    /** Whether normal global candidates are retained alongside next behaviors. */
+    nextAdditive?: boolean;
+    /** Action name when it differs from the behavior name. */
+    actionName?: string;
     /** Menu grouping value retained from legacy packs. */
     groupIndex: number;
     /** Whether user interfaces should hide the behavior. */
@@ -260,11 +278,11 @@ interface MascotEnvironment {
                 dx: number;
                 dy: number;
             };
-            /** Current viewport dimensions. */
+            /** Current container dimensions and, at runtime, its local edge geometry. */
             screen: {
                 width: number;
                 height: number;
-            };
+            } & Partial<EnvironmentRectangle>;
             /** Current work-area bounds and edge predicates. */
             workArea: EnvironmentRectangle;
             /** Alias for the work-area bottom edge. */
@@ -289,6 +307,10 @@ interface MascotEnvironment {
     footX?: number;
     /** Dragging animation foot y-coordinate. */
     footY?: number;
+    /** Current horizontal action velocity. */
+    velocityX?: number;
+    /** Current vertical action velocity. */
+    velocityY?: number;
 }
 /** Edge predicate exposed to legacy expressions. */
 interface EnvironmentEdge {
@@ -333,9 +355,12 @@ declare class ShimejiEngine {
     private destroyed;
     private initialized;
     private platformSource;
+    private additionalPlatformElements;
+    private readonly movedPlatforms;
+    private readonly platformRectangles;
     /** Creates and initializes an engine inside a host DOM element. */
     constructor(container: HTMLElement, options?: ShimejiEngineOptions);
-    /** Starts the clock and global listeners. Calling this method more than once is harmless. */
+    /** Starts the clock and container-aware listeners. Calling this method more than once is harmless. */
     initialize(): void;
     /** Registers or replaces a parsed or legacy character specification. */
     registerCharacter(spec: CharacterSpec | unknown): string;
@@ -353,8 +378,8 @@ declare class ShimejiEngine {
     getState(): MascotState[];
     /** Subscribes to a typed engine event and returns an unsubscribe function. */
     on<K extends keyof ShimejiEngineEventMap>(event: K, listener: ShimejiEventListener<K>): () => void;
-    /** Replaces the DOM elements (or selector) exposed to mascots as platforms. */
-    setPlatforms(platforms: string | readonly HTMLElement[]): void;
+    /** Replaces the primary platform source and any additional registered elements. */
+    setPlatforms(platforms: string | readonly HTMLElement[], additionalPlatforms?: readonly HTMLElement[]): void;
     /** Stops animation and timers, removes listeners and DOM, and revokes all object URLs. */
     destroy(): void;
     /** Returns whether this engine has completed permanent teardown. */
@@ -362,6 +387,7 @@ declare class ShimejiEngine {
     private readonly onAnimationFrame;
     private renderAll;
     private readFrameGeometry;
+    private movePlatform;
     private emitState;
     private listen;
     private assertAlive;
@@ -377,11 +403,11 @@ declare function normalizeCharacterSpec(input: CharacterSpec | LegacyCharacterPa
 declare function loadCharacter(source: CharacterSource): Promise<CharacterSpec>;
 
 /** Safely evaluates a legacy Shimeji expression without using `eval` or `Function`. */
-declare function evaluateExpression(expression: string | number | boolean | undefined, environment: MascotEnvironment, fallback: number): number;
+declare function evaluateExpression(expression: string | number | boolean | undefined, environment: MascotEnvironment, fallback: number, random?: () => number): number;
 /** Safely evaluates a legacy Shimeji expression without using `eval` or `Function`. */
-declare function evaluateExpression(expression: string | number | boolean | undefined, environment: MascotEnvironment, fallback: boolean): boolean;
+declare function evaluateExpression(expression: string | number | boolean | undefined, environment: MascotEnvironment, fallback: boolean, random?: () => number): boolean;
 /** Returns true when every condition in a behavior or action is satisfied. */
-declare function conditionsMatch(conditions: readonly string[], environment: MascotEnvironment): boolean;
+declare function conditionsMatch(conditions: readonly string[], environment: MascotEnvironment, random?: () => number): boolean;
 /** Chooses one item with probability proportional to its non-negative weight. */
 declare function selectWeighted<T>(items: readonly T[], weight: (item: T) => number, random?: () => number): T | undefined;
 /** Selects applicable behaviors and resolves legacy behavior references. */
@@ -389,30 +415,44 @@ declare class BehaviorController {
     private readonly spec;
     private readonly random;
     private previous;
+    private fallbackSelected;
     /** Creates a behavior selector for a normalized character specification. */
     constructor(spec: CharacterSpec, random?: () => number);
     /** Selects an initial behavior, honoring an explicit requested name when possible. */
     selectInitial(environment: MascotEnvironment, requestedName?: string): BehaviorDefinition | undefined;
     /** Selects the weighted transition following the current behavior. */
     selectNext(environment: MascotEnvironment): BehaviorDefinition | undefined;
+    /** Whether the most recent transition had no effective weighted candidate. */
+    usedFallback(): boolean;
     /** Replaces selection history so an external interaction can force a behavior. */
     force(name: string): BehaviorDefinition | undefined;
     private choose;
     private resolve;
     private findFallBehavior;
-    private isOnAnyBoundary;
 }
 
+/** A platform rectangle paired with the DOM element that produced it. */
+interface PlatformRectangle extends Rectangle {
+    element: HTMLElement;
+}
+/** Resolves a platform option into connected DOM elements contained by the supplied root. */
+declare function resolvePlatformElements(source: string | readonly HTMLElement[], root: Document | HTMLElement, excludedRoot?: HTMLElement): HTMLElement[];
+/** Reads platform bounds once and converts viewport coordinates to the supplied origin. */
+declare function readPlatformRectangles(elements: readonly HTMLElement[], workAreaRectangle: Pick<DOMRect, "left" | "top">): PlatformRectangle[];
+
 /** Callbacks through which embedded actions request engine-level operations. */
 interface ActionExecutorCallbacks {
-    /** Spawns another mascot from the same character. */
+    /** Spawns another mascot, optionally from another registered character. */
     spawn(position: {
         x: number;
         y: number;
         behaviorName?: string;
-    }): void;
+        lookRight?: boolean;
+    }, characterId?: string): void;
     /** Removes the mascot owning this executor. */
     remove(): void;
+    /** Moves a DOM platform for the legacy IE-carrying actions. */
+    movePlatform?(element: HTMLElement, point: Point): void;
 }
 /** Settings used while interpreting actions. */
 interface ActionExecutorOptions {
@@ -420,20 +460,30 @@ interface ActionExecutorOptions {
     frameDuration: number;
     /** Gravity used when a Fall action does not define one. */
     gravity: number;
+    /** Optional deterministic random-number source. */
+    random?: (() => number) | undefined;
 }
-/** Executes normalized action trees independently from DOM rendering. */
+type ActionTickResult = "running" | "complete" | "lost-ground";
+/** Executes normalized action trees using Shimeji-ee's discrete action lifecycle. */
 declare class ActionExecutor {
     private readonly spec;
     private readonly state;
     private readonly options;
     private readonly callbacks;
     private runtime;
-    /** Creates an executor bound to one mascot's mutable internal state. */
+    private accumulator;
+    private readonly random;
     constructor(spec: CharacterSpec, state: MascotState, options: ActionExecutorOptions, callbacks: ActionExecutorCallbacks);
     /** Starts the action whose name matches a selected behavior. */
-    start(actionName: string, environment: MascotEnvironment): boolean;
-    /** Advances the current action and returns true when it has completed. */
-    tick(deltaMs: number, environment: MascotEnvironment, bounds: Rectangle): boolean;
+    start(actionName: string, environment: MascotEnvironment, _preserveLookRight?: boolean, bounds?: Rectangle, platforms?: readonly PlatformRectangle[]): boolean;
+    /** Advances by elapsed milliseconds and reports completion. */
+    tick(deltaMs: number, environment: MascotEnvironment, bounds: Rectangle, platforms?: readonly PlatformRectangle[]): boolean;
+    /** Advances exactly one legacy frame. */
+    step(environment: MascotEnvironment, bounds: Rectangle, platforms?: readonly PlatformRectangle[]): ActionTickResult;
+    /** Returns whether the current action can execute another legacy frame. */
+    hasNext(environment: MascotEnvironment, bounds: Rectangle, platforms?: readonly PlatformRectangle[]): boolean;
+    /** Retained for source compatibility with the previous collision API. */
+    consumeViewportWallCollision(): boolean;
     /** Cancels the current action tree. */
     cancel(): void;
     private createRuntime;
@@ -451,20 +501,14 @@ declare function isOnLeft(point: Point, rectangle: Rectangle, tolerance?: number
 declare function isOnRight(point: Point, rectangle: Rectangle, tolerance?: number): boolean;
 /** Returns whether an anchor satisfies an action's boundary requirement. */
 declare function isOnBorder(state: MascotState, bounds: Rectangle, border: "Floor" | "Wall" | "Ceiling" | undefined, platform?: Rectangle): boolean;
-/** Advances ballistic motion and clamps the mascot to the work-area boundaries. */
+/**
+ * Advances one legacy Fall tick. Velocity is damped and accelerated before
+ * movement, then the path is sampled one pixel at a time just like Shimeji-ee.
+ */
 declare function applyGravity(state: MascotState, bounds: Rectangle, frameScale: number, gravity: number, resistanceX?: number, resistanceY?: number, platform?: Rectangle): boolean;
 /** Moves a mascot toward a target without overshooting it. */
 declare function moveToward(state: MascotState, target: Point, speed: number, frameScale: number): boolean;
 
-/** A platform rectangle paired with the DOM element that produced it. */
-interface PlatformRectangle extends Rectangle {
-    element: HTMLElement;
-}
-/** Resolves a platform option into DOM elements, excluding engine-owned nodes. */
-declare function resolvePlatformElements(source: string | readonly HTMLElement[], document: Document, excludedRoot?: HTMLElement): HTMLElement[];
-/** Reads platform bounds once and converts viewport coordinates to the supplied origin. */
-declare function readPlatformRectangles(elements: readonly HTMLElement[], workAreaRectangle: Pick<DOMRect, "left" | "top">): PlatformRectangle[];
-
 /** A resolved image and optional atlas crop for one sprite frame. */
 interface ResolvedSprite {
     /** Browser-loadable image URL. */
@@ -494,7 +538,7 @@ declare function isIndividualSprite(sprite: SpriteRectangle | IndividualSprite |
 
 /** DOM nodes and resources owned by one mascot. */
 interface MascotDomHandle {
-    /** Fixed, pointer-transparent mascot wrapper. */
+    /** Absolutely positioned, pointer-transparent mascot wrapper. */
     element: HTMLDivElement;
     /** Pointer-interactive child element on which sprite images are painted. */
     spriteElement: HTMLDivElement;
@@ -515,6 +559,8 @@ interface MascotCallbacks {
     spawn(characterId: string, options: SpawnOptions): void;
     /** Requests removal of this mascot. */
     remove(id: string): void;
+    /** Moves a registered platform for legacy IE interaction actions. */
+    movePlatform?(element: HTMLElement, point: Point): void;
     /** Reports a click without a drag gesture. */
     click(state: MascotState): void;
     /** Reports a recoverable runtime failure. */

package/dist/index.d.ts

@@ -43,6 +43,8 @@ interface Pose {
 interface AnimationDefinition {
     /** Optional Shimeji expression controlling whether this animation applies. */
     condition?: string;
+    /** Whether this animation is the turning variant of a Move action. */
+    turn?: boolean;
     /** Ordered pose frames. */
     poses: Pose[];
 }
@@ -82,6 +84,12 @@ interface ActionDefinition {
     x?: string | number;
     /** Vertical offset expression. */
     y?: string | number;
+    /** Dragging/carrying horizontal offset expression. */
+    offsetX?: string | number;
+    /** Dragging/carrying vertical offset expression. */
+    offsetY?: string | number;
+    /** Whether offsets are measured from the image origin or anchor. */
+    offsetType?: string;
     /** Initial horizontal velocity expression. */
     initialVx?: string | number;
     /** Initial vertical velocity expression. */
@@ -98,6 +106,12 @@ interface ActionDefinition {
     bornY?: string | number;
     /** Behavior assigned to a spawned child. */
     bornBehavior?: string;
+    /** Optional character identifier assigned to a spawned child. */
+    bornMascot?: string;
+    /** Number of children produced by breeding actions. */
+    bornCount?: string | number;
+    /** Tick interval used by repeating breeding actions. */
+    bornInterval?: string | number;
     /** Carried-element horizontal offset expression. */
     ieOffsetX?: string | number;
     /** Carried-element vertical offset expression. */
@@ -119,6 +133,10 @@ interface BehaviorDefinition {
     conditions: string[];
     /** Candidates considered after this behavior completes. */
     nextBehaviors: BehaviorDefinition[];
+    /** Whether normal global candidates are retained alongside next behaviors. */
+    nextAdditive?: boolean;
+    /** Action name when it differs from the behavior name. */
+    actionName?: string;
     /** Menu grouping value retained from legacy packs. */
     groupIndex: number;
     /** Whether user interfaces should hide the behavior. */
@@ -260,11 +278,11 @@ interface MascotEnvironment {
                 dx: number;
                 dy: number;
             };
-            /** Current viewport dimensions. */
+            /** Current container dimensions and, at runtime, its local edge geometry. */
             screen: {
                 width: number;
                 height: number;
-            };
+            } & Partial<EnvironmentRectangle>;
             /** Current work-area bounds and edge predicates. */
             workArea: EnvironmentRectangle;
             /** Alias for the work-area bottom edge. */
@@ -289,6 +307,10 @@ interface MascotEnvironment {
     footX?: number;
     /** Dragging animation foot y-coordinate. */
     footY?: number;
+    /** Current horizontal action velocity. */
+    velocityX?: number;
+    /** Current vertical action velocity. */
+    velocityY?: number;
 }
 /** Edge predicate exposed to legacy expressions. */
 interface EnvironmentEdge {
@@ -333,9 +355,12 @@ declare class ShimejiEngine {
     private destroyed;
     private initialized;
     private platformSource;
+    private additionalPlatformElements;
+    private readonly movedPlatforms;
+    private readonly platformRectangles;
     /** Creates and initializes an engine inside a host DOM element. */
     constructor(container: HTMLElement, options?: ShimejiEngineOptions);
-    /** Starts the clock and global listeners. Calling this method more than once is harmless. */
+    /** Starts the clock and container-aware listeners. Calling this method more than once is harmless. */
     initialize(): void;
     /** Registers or replaces a parsed or legacy character specification. */
     registerCharacter(spec: CharacterSpec | unknown): string;
@@ -353,8 +378,8 @@ declare class ShimejiEngine {
     getState(): MascotState[];
     /** Subscribes to a typed engine event and returns an unsubscribe function. */
     on<K extends keyof ShimejiEngineEventMap>(event: K, listener: ShimejiEventListener<K>): () => void;
-    /** Replaces the DOM elements (or selector) exposed to mascots as platforms. */
-    setPlatforms(platforms: string | readonly HTMLElement[]): void;
+    /** Replaces the primary platform source and any additional registered elements. */
+    setPlatforms(platforms: string | readonly HTMLElement[], additionalPlatforms?: readonly HTMLElement[]): void;
     /** Stops animation and timers, removes listeners and DOM, and revokes all object URLs. */
     destroy(): void;
     /** Returns whether this engine has completed permanent teardown. */
@@ -362,6 +387,7 @@ declare class ShimejiEngine {
     private readonly onAnimationFrame;
     private renderAll;
     private readFrameGeometry;
+    private movePlatform;
     private emitState;
     private listen;
     private assertAlive;
@@ -377,11 +403,11 @@ declare function normalizeCharacterSpec(input: CharacterSpec | LegacyCharacterPa
 declare function loadCharacter(source: CharacterSource): Promise<CharacterSpec>;
 
 /** Safely evaluates a legacy Shimeji expression without using `eval` or `Function`. */
-declare function evaluateExpression(expression: string | number | boolean | undefined, environment: MascotEnvironment, fallback: number): number;
+declare function evaluateExpression(expression: string | number | boolean | undefined, environment: MascotEnvironment, fallback: number, random?: () => number): number;
 /** Safely evaluates a legacy Shimeji expression without using `eval` or `Function`. */
-declare function evaluateExpression(expression: string | number | boolean | undefined, environment: MascotEnvironment, fallback: boolean): boolean;
+declare function evaluateExpression(expression: string | number | boolean | undefined, environment: MascotEnvironment, fallback: boolean, random?: () => number): boolean;
 /** Returns true when every condition in a behavior or action is satisfied. */
-declare function conditionsMatch(conditions: readonly string[], environment: MascotEnvironment): boolean;
+declare function conditionsMatch(conditions: readonly string[], environment: MascotEnvironment, random?: () => number): boolean;
 /** Chooses one item with probability proportional to its non-negative weight. */
 declare function selectWeighted<T>(items: readonly T[], weight: (item: T) => number, random?: () => number): T | undefined;
 /** Selects applicable behaviors and resolves legacy behavior references. */
@@ -389,30 +415,44 @@ declare class BehaviorController {
     private readonly spec;
     private readonly random;
     private previous;
+    private fallbackSelected;
     /** Creates a behavior selector for a normalized character specification. */
     constructor(spec: CharacterSpec, random?: () => number);
     /** Selects an initial behavior, honoring an explicit requested name when possible. */
     selectInitial(environment: MascotEnvironment, requestedName?: string): BehaviorDefinition | undefined;
     /** Selects the weighted transition following the current behavior. */
     selectNext(environment: MascotEnvironment): BehaviorDefinition | undefined;
+    /** Whether the most recent transition had no effective weighted candidate. */
+    usedFallback(): boolean;
     /** Replaces selection history so an external interaction can force a behavior. */
     force(name: string): BehaviorDefinition | undefined;
     private choose;
     private resolve;
     private findFallBehavior;
-    private isOnAnyBoundary;
 }
 
+/** A platform rectangle paired with the DOM element that produced it. */
+interface PlatformRectangle extends Rectangle {
+    element: HTMLElement;
+}
+/** Resolves a platform option into connected DOM elements contained by the supplied root. */
+declare function resolvePlatformElements(source: string | readonly HTMLElement[], root: Document | HTMLElement, excludedRoot?: HTMLElement): HTMLElement[];
+/** Reads platform bounds once and converts viewport coordinates to the supplied origin. */
+declare function readPlatformRectangles(elements: readonly HTMLElement[], workAreaRectangle: Pick<DOMRect, "left" | "top">): PlatformRectangle[];
+
 /** Callbacks through which embedded actions request engine-level operations. */
 interface ActionExecutorCallbacks {
-    /** Spawns another mascot from the same character. */
+    /** Spawns another mascot, optionally from another registered character. */
     spawn(position: {
         x: number;
         y: number;
         behaviorName?: string;
-    }): void;
+        lookRight?: boolean;
+    }, characterId?: string): void;
     /** Removes the mascot owning this executor. */
     remove(): void;
+    /** Moves a DOM platform for the legacy IE-carrying actions. */
+    movePlatform?(element: HTMLElement, point: Point): void;
 }
 /** Settings used while interpreting actions. */
 interface ActionExecutorOptions {
@@ -420,20 +460,30 @@ interface ActionExecutorOptions {
     frameDuration: number;
     /** Gravity used when a Fall action does not define one. */
     gravity: number;
+    /** Optional deterministic random-number source. */
+    random?: (() => number) | undefined;
 }
-/** Executes normalized action trees independently from DOM rendering. */
+type ActionTickResult = "running" | "complete" | "lost-ground";
+/** Executes normalized action trees using Shimeji-ee's discrete action lifecycle. */
 declare class ActionExecutor {
     private readonly spec;
     private readonly state;
     private readonly options;
     private readonly callbacks;
     private runtime;
-    /** Creates an executor bound to one mascot's mutable internal state. */
+    private accumulator;
+    private readonly random;
     constructor(spec: CharacterSpec, state: MascotState, options: ActionExecutorOptions, callbacks: ActionExecutorCallbacks);
     /** Starts the action whose name matches a selected behavior. */
-    start(actionName: string, environment: MascotEnvironment): boolean;
-    /** Advances the current action and returns true when it has completed. */
-    tick(deltaMs: number, environment: MascotEnvironment, bounds: Rectangle): boolean;
+    start(actionName: string, environment: MascotEnvironment, _preserveLookRight?: boolean, bounds?: Rectangle, platforms?: readonly PlatformRectangle[]): boolean;
+    /** Advances by elapsed milliseconds and reports completion. */
+    tick(deltaMs: number, environment: MascotEnvironment, bounds: Rectangle, platforms?: readonly PlatformRectangle[]): boolean;
+    /** Advances exactly one legacy frame. */
+    step(environment: MascotEnvironment, bounds: Rectangle, platforms?: readonly PlatformRectangle[]): ActionTickResult;
+    /** Returns whether the current action can execute another legacy frame. */
+    hasNext(environment: MascotEnvironment, bounds: Rectangle, platforms?: readonly PlatformRectangle[]): boolean;
+    /** Retained for source compatibility with the previous collision API. */
+    consumeViewportWallCollision(): boolean;
     /** Cancels the current action tree. */
     cancel(): void;
     private createRuntime;
@@ -451,20 +501,14 @@ declare function isOnLeft(point: Point, rectangle: Rectangle, tolerance?: number
 declare function isOnRight(point: Point, rectangle: Rectangle, tolerance?: number): boolean;
 /** Returns whether an anchor satisfies an action's boundary requirement. */
 declare function isOnBorder(state: MascotState, bounds: Rectangle, border: "Floor" | "Wall" | "Ceiling" | undefined, platform?: Rectangle): boolean;
-/** Advances ballistic motion and clamps the mascot to the work-area boundaries. */
+/**
+ * Advances one legacy Fall tick. Velocity is damped and accelerated before
+ * movement, then the path is sampled one pixel at a time just like Shimeji-ee.
+ */
 declare function applyGravity(state: MascotState, bounds: Rectangle, frameScale: number, gravity: number, resistanceX?: number, resistanceY?: number, platform?: Rectangle): boolean;
 /** Moves a mascot toward a target without overshooting it. */
 declare function moveToward(state: MascotState, target: Point, speed: number, frameScale: number): boolean;
 
-/** A platform rectangle paired with the DOM element that produced it. */
-interface PlatformRectangle extends Rectangle {
-    element: HTMLElement;
-}
-/** Resolves a platform option into DOM elements, excluding engine-owned nodes. */
-declare function resolvePlatformElements(source: string | readonly HTMLElement[], document: Document, excludedRoot?: HTMLElement): HTMLElement[];
-/** Reads platform bounds once and converts viewport coordinates to the supplied origin. */
-declare function readPlatformRectangles(elements: readonly HTMLElement[], workAreaRectangle: Pick<DOMRect, "left" | "top">): PlatformRectangle[];
-
 /** A resolved image and optional atlas crop for one sprite frame. */
 interface ResolvedSprite {
     /** Browser-loadable image URL. */
@@ -494,7 +538,7 @@ declare function isIndividualSprite(sprite: SpriteRectangle | IndividualSprite |
 
 /** DOM nodes and resources owned by one mascot. */
 interface MascotDomHandle {
-    /** Fixed, pointer-transparent mascot wrapper. */
+    /** Absolutely positioned, pointer-transparent mascot wrapper. */
     element: HTMLDivElement;
     /** Pointer-interactive child element on which sprite images are painted. */
     spriteElement: HTMLDivElement;
@@ -515,6 +559,8 @@ interface MascotCallbacks {
     spawn(characterId: string, options: SpawnOptions): void;
     /** Requests removal of this mascot. */
     remove(id: string): void;
+    /** Moves a registered platform for legacy IE interaction actions. */
+    movePlatform?(element: HTMLElement, point: Point): void;
     /** Reports a click without a drag gesture. */
     click(state: MascotState): void;
     /** Reports a recoverable runtime failure. */