@drincs/pixi-vn 1.8.25 → 1.9.1

package/dist/index.d.cts

@@ -1,4 +1,3 @@
-import { S as SoundGameState, a as SoundManagerInterface } from './SoundManagerInterface-Dd0b88_N.cjs';
 import * as canvasUtils from '@drincs/pixi-vn/canvas';
 export * from '@drincs/pixi-vn/canvas';
 import * as characterUtils from '@drincs/pixi-vn/characters';
@@ -17,31 +16,21 @@ export * from '@drincs/pixi-vn/sound';
 import * as storageUtils from '@drincs/pixi-vn/storage';
 export * from '@drincs/pixi-vn/storage';
 export { C as CachedMap } from './CachedMap-DZLvJAnA.cjs';
-import { P as PauseType, R as RepeatType, e as CanvasGameState } from './ContainerMemory-D2HtgX7w.cjs';
-import { H as HistoryGameState } from './HistoryGameState-C28NcKKl.cjs';
-import { S as StorageGameState } from './StorageGameState-CtjNJpvE.cjs';
-import { O as OpenedLabel } from './OpenedLabel-BxfL31aQ.cjs';
+import { e as CanvasGameState } from './ContainerMemory-BpDgacyr.cjs';
+import { H as HistoryGameState } from './HistoryGameState-CGfvq5iL.cjs';
+import { S as SoundGameState } from './SoundGameState-C_6ZsQX6.cjs';
+import { S as StorageGameState } from './StorageGameState-C3PGrFPr.cjs';
+import { O as OpenedLabel } from './OpenedLabel-Cmd675NI.cjs';
 import { Devtools } from '@pixi/devtools';
-import 'tone';
 import 'lru-cache';
 import '@drincs/pixi-vn';
-import './HistoryStep-G9dUn0Lf.cjs';
+import './HistoryStep-WGB6nA4N.cjs';
 import 'microdiff';
+import 'tone';
 import './StorageElementType-C7ETezlL.cjs';
 
-var version = "1.8.25";
+var version = "1.9.1";
 
-/**
- * @deprecated
- */
-declare const Repeat: RepeatType;
-/**
- * Pause the tickers for a duration.
- * @param duration Duration in seconds
- * @returns The pause object
- * @deprecated
- */
-declare function Pause(duration: number): PauseType;
 /**
  * Is a special alias to indicate the game layer.
  */
@@ -218,15 +207,9 @@ declare namespace Game {
     function exportGameState(): GameState;
     /**
      * Load the save data
-     * @param data The save data
+     * @param data The save data object to restore the game state from.
      */
     function restoreGameState(data: GameState): Promise<void>;
-    /**
-     * @deprecated Use `restoreGameState(data)` (without the `navigate` argument) and configure navigation via `Game.init({ navigate })` or `Game.onNavigate(...)`.
-     * @param data The save data
-     * @param navigate Navigation function to use for this restore call.
-     */
-    function restoreGameState(data: GameState, navigate: (path: string) => void | Promise<void>): Promise<void>;
     /**
      * Start the game with a label. This function will clear all the game data and start the narration from the specified label.
      * @param label The label to start the game with. It can be a string or a LabelAbstract instance. If it is a string, it will be used as the id of the label to start. If it is a LabelAbstract instance, it will be used directly. If the label is not found, an error will be thrown.
@@ -250,10 +233,6 @@ declare namespace Game {
      * ```
      */
     function onEnd(value: narrationUtils.StepLabelType): void;
-    /**
-     * @deprecated Game.onError is deprecated. Use Game.addOnError / Game.removeOnError to register multiple handlers.
-     */
-    function onError(handler: (type: "step", error: any, props: narrationUtils.StepLabelPropsType) => void | Promise<void>): () => void;
     /**
      * Register an error handler. Multiple handlers can be registered; they
      * will be executed in registration order.
@@ -346,6 +325,27 @@ declare namespace Game {
         closeCurrentLabel?: boolean;
         type: string;
     }, defaultStart: () => Promise<narrationUtils.StepLabelResultType>) => narrationUtils.StepLabelResultType | Promise<narrationUtils.StepLabelResultType>): void;
+    /**
+     * Is a function that will be executed every time the current label is about to close because it
+     * naturally ran out of steps and control is returning to the label that called it.
+     *
+     * By default (when this is not set), the label closes immediately, exactly like before this hook
+     * existed. If you set it, you take control: call `defaultClose()` yourself whenever you actually
+     * want the label to close — right away, or later (e.g. on a subsequent player action in your
+     * template). Until `defaultClose()` is called, the label stays open and narration does not
+     * continue into the parent label.
+     *
+     * This does not fire for a `jump` or a choice's `closeCurrentLabel` option - those close the
+     * current label as part of starting a new one, so {@link onLabelStarting} already covers
+     * deferring them.
+     * @example
+     * ```ts
+     * Game.onLabelClosing((labelId, props, defaultClose) => {
+     *     pendingLabelClose = defaultClose; // keep it for later, don't run it now
+     * })
+     * ```
+     */
+    function onLabelClosing(value: (labelId: narrationUtils.LabelIdType, props: narrationUtils.StepLabelPropsType, defaultClose: () => Promise<narrationUtils.StepLabelResultType>) => narrationUtils.StepLabelResultType | Promise<narrationUtils.StepLabelResultType>): void;
     /**
      * Function to be executed when navigation is requested.
      * @example
@@ -364,11 +364,131 @@ declare namespace Game {
      */
     function addOnPreContinue(handler: () => Promise<void> | void): void;
     function removeOnPreContinue(handler: () => Promise<void> | void): void;
+    /**
+     * Lets an AI agent (or any external script/browser console) drive and inspect a running game
+     * through `window`, without needing to know the app's own UI wiring. Not enabled by default —
+     * something must opt in, typically only in development. Two pieces are needed:
+     * - `enable()`/`disable()` turn the `window` bridge on/off — the `@drincs/pixi-vn/vite` plugin's
+     *   `testing` option does this automatically while its dev server is running, with no extra code.
+     * - `setProps(props)` keeps the live app props (`navigate`/`t`/`toast`/etc.) available to every
+     *   action — call it unconditionally from wherever your app builds those props (e.g. at the end
+     *   of a `useGameProps()`-style hook), since every action needs up-to-date props whether or not
+     *   testing happens to be enabled right now.
+     * See the `pixi-vn-testing` skill for the full guide (activation patterns, the complete command
+     * surface, and cookbook snippets for a browser-driven test session).
+     */
+    namespace testing {
+        /**
+         * One error captured by {@link enable} while testing is active, via {@link Game.addOnError}.
+         */
+        interface GameTestingErrorEntry {
+            error: unknown;
+            timestamp: number;
+        }
+        /**
+         * A read-only snapshot of everything a test session typically needs to decide its next
+         * action, gathered from {@link narrationUtils.narration} and {@link historyUtils.stepHistory}
+         * in a single call instead of reading several properties one by one.
+         */
+        interface GameTestingState {
+            dialogue: narrationUtils.DialogueInterface | undefined;
+            dialogueGlue: boolean;
+            choices: narrationUtils.StoredIndexedChoiceInterface[] | undefined;
+            input: {
+                isRequired: boolean;
+                type: string | undefined;
+                value: storageUtils.StorageElementType;
+            };
+            canContinue: boolean;
+            canGoBack: boolean;
+            labelsOpened: narrationUtils.OpenedLabel[];
+            currentLabelId: string | undefined;
+            stepCounter: number;
+        }
+        /**
+         * The object attached to `window` (and returned) by {@link enable}. Every action method
+         * merges the most recent props passed to {@link setProps} with any `extraProps` given here,
+         * then delegates to the matching narration/history call — so calling these behaves exactly
+         * like a real player action (the same `navigate`/`t`/`toast`/etc. the real UI uses).
+         *
+         * `narration`, `storage`, `stepHistory` and `Game` are also exposed directly for anything not
+         * covered by the action methods (e.g. `storage.set(...)`, `Game.exportGameState()`).
+         */
+        interface GameTestingAPI<T extends {} = {}> {
+            readonly Game: typeof Game;
+            readonly narration: narrationUtils.NarrationManagerInterface;
+            readonly storage: storageUtils.StorageManagerInterface;
+            readonly stepHistory: historyUtils.HistoryManagerInterface;
+            /**
+             * The most recent props passed to {@link setProps} — whatever your app's `StepLabelProps`
+             * augmentation defines (e.g. `navigate`, `toast`). Useful to drive the app's UI directly
+             * during a test session — e.g. `pixiVN.props.navigate("/settings")` — not just narration,
+             * for full control over what's on screen.
+             */
+            readonly props: narrationUtils.StepLabelPropsType<T>;
+            /** {@link Game.start} using the live props plus any `extraProps`. */
+            start(label: narrationUtils.LabelAbstract<any, T> | narrationUtils.LabelIdType, extraProps?: Partial<T>): Promise<narrationUtils.StepLabelResultType>;
+            /** {@link narrationUtils.NarrationManagerInterface.continue} using the live props plus any `extraProps`. */
+            continue(extraProps?: Partial<T>, options?: {
+                steps?: number;
+                runNow?: boolean;
+            }): Promise<narrationUtils.StepLabelResultType>;
+            /** {@link narrationUtils.NarrationManagerInterface.call} using the live props plus any `extraProps`. */
+            call(label: narrationUtils.LabelAbstract<any, T> | narrationUtils.LabelIdType, extraProps?: Partial<T>): Promise<narrationUtils.StepLabelResultType>;
+            /** {@link narrationUtils.NarrationManagerInterface.jump} using the live props plus any `extraProps`. */
+            jump(label: narrationUtils.LabelAbstract<any, T> | narrationUtils.LabelIdType, extraProps?: Partial<T>): Promise<narrationUtils.StepLabelResultType>;
+            /**
+             * Selects the currently open choice with this `choiceIndex` (as seen in
+             * `getState().choices`), using the live props plus any `extraProps`.
+             * @throws when no open choice has that index.
+             */
+            selectChoice(choiceIndex: number, extraProps?: Partial<T>): Promise<narrationUtils.StepLabelResultType>;
+            /** Resolves a pending `narration.input.request(...)` with `value`, exactly like the player typing an answer and confirming. */
+            setInput(value: storageUtils.StorageElementType): void;
+            /** {@link historyUtils.HistoryManagerInterface.back} using the live props plus any `extraProps`. */
+            goBack(extraProps?: Partial<T>, options?: {
+                steps?: number;
+            }): Promise<narrationUtils.StepLabelResultType>;
+            /** {@link narrationUtils.NarrationLabelsInterface.closeCurrent} */
+            closeCurrentLabel(): void;
+            /** {@link narrationUtils.NarrationLabelsInterface.closeAll}. **Can end the game.** */
+            closeAllLabels(): void;
+            /** A snapshot of dialogue/choices/input/canContinue/canGoBack/labels — see {@link GameTestingState}. */
+            getState(): GameTestingState;
+            /** Errors caught via {@link Game.addOnError} since `enable()` was called (or since the last {@link clearErrors}). */
+            readonly errors: GameTestingErrorEntry[];
+            clearErrors(): void;
+        }
+        /**
+         * Updates the live props every {@link GameTestingAPI} action merges `extraProps` on top of.
+         * Call this unconditionally from wherever your app builds its `StepLabelProps` (e.g. the end
+         * of a `useGameProps()`-style hook that already runs throughout the app) — it's a cheap
+         * assignment, safe to call whether or not testing is currently {@link enable}d.
+         * @param props The app's current `StepLabelProps` (the same object your UI passes to
+         * `narration.continue`/`Game.start`).
+         */
+        function setProps<T extends {} = {}>(props: narrationUtils.StepLabelPropsType<T>): void;
+        /**
+         * Enables the testing API: builds it, attaches it to `window[windowKey]` (default
+         * `"pixiVN"`), and returns it. Calling this again replaces the previous session.
+         * @param options.windowKey The property name to attach the API under on `window`. @default "pixiVN"
+         */
+        function enable<T extends {} = {}>(options?: {
+            windowKey?: string;
+        }): GameTestingAPI<T>;
+        /**
+         * Disables a session started with {@link enable}: removes the error handler and, if it's
+         * still the current value, deletes `window[windowKey]`. No-op if testing isn't enabled.
+         */
+        function disable(): void;
+        /** Whether a testing session is currently active. */
+        function isEnabled(): boolean;
+    }
 }
 declare const _default: {
     canvas: canvasUtils.CanvasManagerInterface;
     narration: narrationUtils.NarrationManagerInterface;
-    sound: SoundManagerInterface;
+    sound: soundUtils.SoundManagerInterface;
     storage: storageUtils.StorageManagerInterface;
     history: historyUtils.HistoryManagerInterface;
     Game: typeof Game;
@@ -379,9 +499,7 @@ declare const _default: {
     narrationUtils: typeof narrationUtils;
     soundUtils: typeof soundUtils;
     CANVAS_APP_GAME_LAYER_ALIAS: string;
-    Pause: typeof Pause;
-    Repeat: "repeat";
     PIXIVN_VERSION: string;
 };
 
-export { CANVAS_APP_GAME_LAYER_ALIAS, Game, type GameState, type GameStepStateData, version as PIXIVN_VERSION, Pause, Repeat, SYSTEM_RESERVED_STORAGE_KEYS, createExportableElement, _default as default };
+export { CANVAS_APP_GAME_LAYER_ALIAS, Game, type GameState, type GameStepStateData, version as PIXIVN_VERSION, SYSTEM_RESERVED_STORAGE_KEYS, createExportableElement, _default as default };

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-import { S as SoundGameState, a as SoundManagerInterface } from './SoundManagerInterface-Dd0b88_N.js';
 import * as canvasUtils from '@drincs/pixi-vn/canvas';
 export * from '@drincs/pixi-vn/canvas';
 import * as characterUtils from '@drincs/pixi-vn/characters';
@@ -17,31 +16,21 @@ export * from '@drincs/pixi-vn/sound';
 import * as storageUtils from '@drincs/pixi-vn/storage';
 export * from '@drincs/pixi-vn/storage';
 export { C as CachedMap } from './CachedMap-DZLvJAnA.js';
-import { P as PauseType, R as RepeatType, e as CanvasGameState } from './ContainerMemory-D2HtgX7w.js';
-import { H as HistoryGameState } from './HistoryGameState-CmjUtlkV.js';
-import { S as StorageGameState } from './StorageGameState-BJy57o6K.js';
-import { O as OpenedLabel } from './OpenedLabel-DLfFuZgk.js';
+import { e as CanvasGameState } from './ContainerMemory-BpDgacyr.js';
+import { H as HistoryGameState } from './HistoryGameState-C8ATx9K6.js';
+import { S as SoundGameState } from './SoundGameState-C_6ZsQX6.js';
+import { S as StorageGameState } from './StorageGameState-jAexrJLj.js';
+import { O as OpenedLabel } from './OpenedLabel-CmRdzTXP.js';
 import { Devtools } from '@pixi/devtools';
-import 'tone';
 import 'lru-cache';
 import '@drincs/pixi-vn';
-import './HistoryStep-G9dUn0Lf.js';
+import './HistoryStep-WGB6nA4N.js';
 import 'microdiff';
+import 'tone';
 import './StorageElementType-C7ETezlL.js';
 
-var version = "1.8.25";
+var version = "1.9.1";
 
-/**
- * @deprecated
- */
-declare const Repeat: RepeatType;
-/**
- * Pause the tickers for a duration.
- * @param duration Duration in seconds
- * @returns The pause object
- * @deprecated
- */
-declare function Pause(duration: number): PauseType;
 /**
  * Is a special alias to indicate the game layer.
  */
@@ -218,15 +207,9 @@ declare namespace Game {
     function exportGameState(): GameState;
     /**
      * Load the save data
-     * @param data The save data
+     * @param data The save data object to restore the game state from.
      */
     function restoreGameState(data: GameState): Promise<void>;
-    /**
-     * @deprecated Use `restoreGameState(data)` (without the `navigate` argument) and configure navigation via `Game.init({ navigate })` or `Game.onNavigate(...)`.
-     * @param data The save data
-     * @param navigate Navigation function to use for this restore call.
-     */
-    function restoreGameState(data: GameState, navigate: (path: string) => void | Promise<void>): Promise<void>;
     /**
      * Start the game with a label. This function will clear all the game data and start the narration from the specified label.
      * @param label The label to start the game with. It can be a string or a LabelAbstract instance. If it is a string, it will be used as the id of the label to start. If it is a LabelAbstract instance, it will be used directly. If the label is not found, an error will be thrown.
@@ -250,10 +233,6 @@ declare namespace Game {
      * ```
      */
     function onEnd(value: narrationUtils.StepLabelType): void;
-    /**
-     * @deprecated Game.onError is deprecated. Use Game.addOnError / Game.removeOnError to register multiple handlers.
-     */
-    function onError(handler: (type: "step", error: any, props: narrationUtils.StepLabelPropsType) => void | Promise<void>): () => void;
     /**
      * Register an error handler. Multiple handlers can be registered; they
      * will be executed in registration order.
@@ -346,6 +325,27 @@ declare namespace Game {
         closeCurrentLabel?: boolean;
         type: string;
     }, defaultStart: () => Promise<narrationUtils.StepLabelResultType>) => narrationUtils.StepLabelResultType | Promise<narrationUtils.StepLabelResultType>): void;
+    /**
+     * Is a function that will be executed every time the current label is about to close because it
+     * naturally ran out of steps and control is returning to the label that called it.
+     *
+     * By default (when this is not set), the label closes immediately, exactly like before this hook
+     * existed. If you set it, you take control: call `defaultClose()` yourself whenever you actually
+     * want the label to close — right away, or later (e.g. on a subsequent player action in your
+     * template). Until `defaultClose()` is called, the label stays open and narration does not
+     * continue into the parent label.
+     *
+     * This does not fire for a `jump` or a choice's `closeCurrentLabel` option - those close the
+     * current label as part of starting a new one, so {@link onLabelStarting} already covers
+     * deferring them.
+     * @example
+     * ```ts
+     * Game.onLabelClosing((labelId, props, defaultClose) => {
+     *     pendingLabelClose = defaultClose; // keep it for later, don't run it now
+     * })
+     * ```
+     */
+    function onLabelClosing(value: (labelId: narrationUtils.LabelIdType, props: narrationUtils.StepLabelPropsType, defaultClose: () => Promise<narrationUtils.StepLabelResultType>) => narrationUtils.StepLabelResultType | Promise<narrationUtils.StepLabelResultType>): void;
     /**
      * Function to be executed when navigation is requested.
      * @example
@@ -364,11 +364,131 @@ declare namespace Game {
      */
     function addOnPreContinue(handler: () => Promise<void> | void): void;
     function removeOnPreContinue(handler: () => Promise<void> | void): void;
+    /**
+     * Lets an AI agent (or any external script/browser console) drive and inspect a running game
+     * through `window`, without needing to know the app's own UI wiring. Not enabled by default —
+     * something must opt in, typically only in development. Two pieces are needed:
+     * - `enable()`/`disable()` turn the `window` bridge on/off — the `@drincs/pixi-vn/vite` plugin's
+     *   `testing` option does this automatically while its dev server is running, with no extra code.
+     * - `setProps(props)` keeps the live app props (`navigate`/`t`/`toast`/etc.) available to every
+     *   action — call it unconditionally from wherever your app builds those props (e.g. at the end
+     *   of a `useGameProps()`-style hook), since every action needs up-to-date props whether or not
+     *   testing happens to be enabled right now.
+     * See the `pixi-vn-testing` skill for the full guide (activation patterns, the complete command
+     * surface, and cookbook snippets for a browser-driven test session).
+     */
+    namespace testing {
+        /**
+         * One error captured by {@link enable} while testing is active, via {@link Game.addOnError}.
+         */
+        interface GameTestingErrorEntry {
+            error: unknown;
+            timestamp: number;
+        }
+        /**
+         * A read-only snapshot of everything a test session typically needs to decide its next
+         * action, gathered from {@link narrationUtils.narration} and {@link historyUtils.stepHistory}
+         * in a single call instead of reading several properties one by one.
+         */
+        interface GameTestingState {
+            dialogue: narrationUtils.DialogueInterface | undefined;
+            dialogueGlue: boolean;
+            choices: narrationUtils.StoredIndexedChoiceInterface[] | undefined;
+            input: {
+                isRequired: boolean;
+                type: string | undefined;
+                value: storageUtils.StorageElementType;
+            };
+            canContinue: boolean;
+            canGoBack: boolean;
+            labelsOpened: narrationUtils.OpenedLabel[];
+            currentLabelId: string | undefined;
+            stepCounter: number;
+        }
+        /**
+         * The object attached to `window` (and returned) by {@link enable}. Every action method
+         * merges the most recent props passed to {@link setProps} with any `extraProps` given here,
+         * then delegates to the matching narration/history call — so calling these behaves exactly
+         * like a real player action (the same `navigate`/`t`/`toast`/etc. the real UI uses).
+         *
+         * `narration`, `storage`, `stepHistory` and `Game` are also exposed directly for anything not
+         * covered by the action methods (e.g. `storage.set(...)`, `Game.exportGameState()`).
+         */
+        interface GameTestingAPI<T extends {} = {}> {
+            readonly Game: typeof Game;
+            readonly narration: narrationUtils.NarrationManagerInterface;
+            readonly storage: storageUtils.StorageManagerInterface;
+            readonly stepHistory: historyUtils.HistoryManagerInterface;
+            /**
+             * The most recent props passed to {@link setProps} — whatever your app's `StepLabelProps`
+             * augmentation defines (e.g. `navigate`, `toast`). Useful to drive the app's UI directly
+             * during a test session — e.g. `pixiVN.props.navigate("/settings")` — not just narration,
+             * for full control over what's on screen.
+             */
+            readonly props: narrationUtils.StepLabelPropsType<T>;
+            /** {@link Game.start} using the live props plus any `extraProps`. */
+            start(label: narrationUtils.LabelAbstract<any, T> | narrationUtils.LabelIdType, extraProps?: Partial<T>): Promise<narrationUtils.StepLabelResultType>;
+            /** {@link narrationUtils.NarrationManagerInterface.continue} using the live props plus any `extraProps`. */
+            continue(extraProps?: Partial<T>, options?: {
+                steps?: number;
+                runNow?: boolean;
+            }): Promise<narrationUtils.StepLabelResultType>;
+            /** {@link narrationUtils.NarrationManagerInterface.call} using the live props plus any `extraProps`. */
+            call(label: narrationUtils.LabelAbstract<any, T> | narrationUtils.LabelIdType, extraProps?: Partial<T>): Promise<narrationUtils.StepLabelResultType>;
+            /** {@link narrationUtils.NarrationManagerInterface.jump} using the live props plus any `extraProps`. */
+            jump(label: narrationUtils.LabelAbstract<any, T> | narrationUtils.LabelIdType, extraProps?: Partial<T>): Promise<narrationUtils.StepLabelResultType>;
+            /**
+             * Selects the currently open choice with this `choiceIndex` (as seen in
+             * `getState().choices`), using the live props plus any `extraProps`.
+             * @throws when no open choice has that index.
+             */
+            selectChoice(choiceIndex: number, extraProps?: Partial<T>): Promise<narrationUtils.StepLabelResultType>;
+            /** Resolves a pending `narration.input.request(...)` with `value`, exactly like the player typing an answer and confirming. */
+            setInput(value: storageUtils.StorageElementType): void;
+            /** {@link historyUtils.HistoryManagerInterface.back} using the live props plus any `extraProps`. */
+            goBack(extraProps?: Partial<T>, options?: {
+                steps?: number;
+            }): Promise<narrationUtils.StepLabelResultType>;
+            /** {@link narrationUtils.NarrationLabelsInterface.closeCurrent} */
+            closeCurrentLabel(): void;
+            /** {@link narrationUtils.NarrationLabelsInterface.closeAll}. **Can end the game.** */
+            closeAllLabels(): void;
+            /** A snapshot of dialogue/choices/input/canContinue/canGoBack/labels — see {@link GameTestingState}. */
+            getState(): GameTestingState;
+            /** Errors caught via {@link Game.addOnError} since `enable()` was called (or since the last {@link clearErrors}). */
+            readonly errors: GameTestingErrorEntry[];
+            clearErrors(): void;
+        }
+        /**
+         * Updates the live props every {@link GameTestingAPI} action merges `extraProps` on top of.
+         * Call this unconditionally from wherever your app builds its `StepLabelProps` (e.g. the end
+         * of a `useGameProps()`-style hook that already runs throughout the app) — it's a cheap
+         * assignment, safe to call whether or not testing is currently {@link enable}d.
+         * @param props The app's current `StepLabelProps` (the same object your UI passes to
+         * `narration.continue`/`Game.start`).
+         */
+        function setProps<T extends {} = {}>(props: narrationUtils.StepLabelPropsType<T>): void;
+        /**
+         * Enables the testing API: builds it, attaches it to `window[windowKey]` (default
+         * `"pixiVN"`), and returns it. Calling this again replaces the previous session.
+         * @param options.windowKey The property name to attach the API under on `window`. @default "pixiVN"
+         */
+        function enable<T extends {} = {}>(options?: {
+            windowKey?: string;
+        }): GameTestingAPI<T>;
+        /**
+         * Disables a session started with {@link enable}: removes the error handler and, if it's
+         * still the current value, deletes `window[windowKey]`. No-op if testing isn't enabled.
+         */
+        function disable(): void;
+        /** Whether a testing session is currently active. */
+        function isEnabled(): boolean;
+    }
 }
 declare const _default: {
     canvas: canvasUtils.CanvasManagerInterface;
     narration: narrationUtils.NarrationManagerInterface;
-    sound: SoundManagerInterface;
+    sound: soundUtils.SoundManagerInterface;
     storage: storageUtils.StorageManagerInterface;
     history: historyUtils.HistoryManagerInterface;
     Game: typeof Game;
@@ -379,9 +499,7 @@ declare const _default: {
     narrationUtils: typeof narrationUtils;
     soundUtils: typeof soundUtils;
     CANVAS_APP_GAME_LAYER_ALIAS: string;
-    Pause: typeof Pause;
-    Repeat: "repeat";
     PIXIVN_VERSION: string;
 };
 
-export { CANVAS_APP_GAME_LAYER_ALIAS, Game, type GameState, type GameStepStateData, version as PIXIVN_VERSION, Pause, Repeat, SYSTEM_RESERVED_STORAGE_KEYS, createExportableElement, _default as default };
+export { CANVAS_APP_GAME_LAYER_ALIAS, Game, type GameState, type GameStepStateData, version as PIXIVN_VERSION, SYSTEM_RESERVED_STORAGE_KEYS, createExportableElement, _default as default };