@vpmedia/phaser 1.118.0 → 1.119.0

package/dist/phaser/core/game.d.ts

@@ -9,16 +9,42 @@ import { Loader } from './loader.js';
 import { RequestAnimationFrame } from './raf.js';
 import { ScaleManager } from './scale_manager.js';
 import { SceneManager } from './scene_manager.js';
+import type { SceneDefinition } from './scene_manager.js';
 import { Signal } from './signal.js';
 import { SoundManager } from './sound_manager.js';
 import { Stage } from './stage.js';
 import { Time } from './time.js';
 import { TweenManager } from './tween_manager.js';
 import { World } from './world.js';
+/**
+ * The options a game is created with. Everything the constructor defaults is always present on
+ * `Game.config`; the rest is only there when the caller supplied it.
+ */
+export type GameConfig = {
+    width: number;
+    height: number;
+    backgroundColor: number;
+    canvasID: string;
+    canvasStyle: Record<string, string> | undefined;
+    resolution: number;
+    transparent: boolean | 'notMultiplied';
+    antialias: boolean;
+    preserveDrawingBuffer: boolean;
+    clearBeforeRender: boolean;
+    roundPixels: boolean;
+    renderType: number;
+    isForceDisabledAudio: boolean;
+    maxParallelDownloads: number;
+    canvas?: HTMLCanvasElement;
+    isSkipTicker?: boolean;
+    parent?: string | HTMLElement;
+    state?: SceneDefinition | string;
+    logger?: Logger;
+};
 export declare class Game {
     /** Set when the scene manager kick-starts the first scene. */
     isKickStart: boolean;
-    config: any;
+    config: GameConfig;
     id: number;
     parent: string | HTMLElement;
     width: number;
@@ -46,8 +72,8 @@ export declare class Game {
     onResume: Signal;
     onBoot: Signal;
     isPaused: boolean;
-    contextLostBinded: any;
-    contextRestoredBinded: any;
+    contextLostBinded: EventListener | null;
+    contextRestoredBinded: EventListener | null;
     /**
      * Creates a new Game instance.
      * @param {object} gameConfig - The configuration object for the game.
@@ -68,7 +94,7 @@ export declare class Game {
      * @param {string|HTMLElement} gameConfig.parent - The parent element to append the canvas to.
      * @param {object} gameConfig.state - The initial state object or class.
      */
-    constructor(gameConfig?: any);
+    constructor(gameConfig?: Partial<GameConfig>);
     /**
      * Boots the game and initializes all systems.
      */
@@ -87,22 +113,22 @@ export declare class Game {
      * @param {string} key - The configuration key to parse.
      * @param {*} defaultValue - The default value if the key is not found in config.
      */
-    parseConfigElement(config: any, key: string, defaultValue?: any): void;
+    parseConfigElement<K extends keyof GameConfig>(config: Partial<GameConfig>, key: K, defaultValue?: GameConfig[K]): void;
     /**
      * Parses the configuration object and sets up game properties.
      * @param {object} config - The configuration object to parse.
      */
-    parseConfig(config: any): void;
+    parseConfig(config: Partial<GameConfig>): void;
     /**
      * Called when the WebGL context is lost.
      * @param {WebGLContextEvent | Event} event - The WebGL context loss event.
      */
-    contextLost(event: any): void;
+    contextLost(event: Event): void;
     /**
      * Called when the WebGL context is restored.
      * @param {WebGLContextEvent | Event} event - The WebGL context restore event.
      */
-    contextRestored(event: any): void;
+    contextRestored(event: Event): void;
     /**
      * Updates the game state.
      * @param {number} time - The current timestamp.

package/dist/phaser/core/game.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../../src/phaser/core/game.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../../src/phaser/core/game.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,GAAG,eAAe,CAAC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,KAAK,CAAC,EAAE,eAAe,GAAG,MAAM,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,IAAI;IACf,8DAA8D;IACvD,WAAW,UAAS;IACpB,MAAM,EAAG,UAAU,CAAC;IACpB,EAAE,EAAG,MAAM,CAAC;IACZ,MAAM,EAAG,MAAM,GAAG,WAAW,CAAC;IAC9B,KAAK,EAAG,MAAM,CAAC;IACf,MAAM,EAAG,MAAM,CAAC;IAChB,QAAQ,EAAG,cAAc,GAAG,aAAa,CAAC;IAC1C,KAAK,EAAG,YAAY,CAAC;IACrB,QAAQ,EAAG,OAAO,CAAC;IACnB,MAAM,EAAG,OAAO,CAAC;IACjB,GAAG,EAAG,qBAAqB,CAAC;IAC5B,GAAG,EAAG,iBAAiB,CAAC;IACxB,KAAK,EAAG,KAAK,CAAC;IACd,KAAK,EAAG,KAAK,CAAC;IACd,IAAI,EAAG,MAAM,CAAC;IACd,KAAK,EAAG,YAAY,CAAC;IACrB,KAAK,EAAG,YAAY,CAAC;IACrB,KAAK,EAAG,KAAK,CAAC;IACd,IAAI,EAAG,IAAI,CAAC;IACZ,MAAM,EAAG,YAAY,CAAC;IACtB,KAAK,EAAG,KAAK,CAAC;IACd,MAAM,EAAG,MAAM,CAAC;IAChB,MAAM,EAAG,MAAM,CAAC;IAChB,MAAM,EAAG,iBAAiB,CAAC;IAC3B,OAAO,EACV,wBAAwB,GACxB,2BAA2B,GAC3B,qBAAqB,GACrB,sBAAsB,GACtB,IAAI,CAAC;IACF,OAAO,EAAG,MAAM,CAAC;IACjB,QAAQ,EAAG,MAAM,CAAC;IAClB,MAAM,EAAG,MAAM,CAAC;IAChB,QAAQ,EAAG,OAAO,CAAC;IACnB,iBAAiB,EAAG,aAAa,GAAG,IAAI,CAAC;IACzC,qBAAqB,EAAG,aAAa,GAAG,IAAI,CAAC;IACpD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,YAAmB,UAAU,GAAE,OAAO,CAAC,UAAU,CAAM,EA6BtD;IAED;;OAEG;IACI,IAAI,IAAI,IAAI,CA+BlB;IAED;;OAEG;IACI,oBAAoB,IAAI,IAAI,CAkBlC;IAED;;OAEG;IACI,YAAY,IAAI,IAAI,CA2C1B;IAED;;;;;OAKG;IACI,kBAAkB,CAAC,CAAC,SAAS,MAAM,UAAU,EAClD,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,EAC3B,GAAG,EAAE,CAAC,EACN,YAAY,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAC3B,IAAI,CAEN;IAED;;;OAGG;IACI,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAsBpD;IAED;;;OAGG;IACI,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAMrC;IAED;;;OAGG;IACI,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAOzC;IAED;;;OAGG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkBhC;IAED;;OAEG;IACI,OAAO,IAAI,IAAI,CAwCrB;CACF"}

package/dist/phaser/core/scene.d.ts

@@ -1,6 +1,7 @@
+import type { Game } from './game.js';
 export declare class Scene {
-    game: any;
-    key: any;
+    game: Game | null;
+    key: string;
     /**
      * Creates a new Scene instance.
      */

package/dist/phaser/core/scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/phaser/core/scene.ts"],"names":[],"mappings":"AAAA,qBAAa,KAAK;IACT,IAAI,EAAE,GAAG,CAAQ;IACjB,GAAG,EAAE,GAAG,CAAM;IACrB;;OAEG;IAEH;;;OAGG;IACI,IAAI,IAAI,IAAI,CAElB;IAED;;;OAGG;IACI,OAAO,IAAI,IAAI,CAErB;IAED;;;OAGG;IACI,MAAM,IAAI,IAAI,CAEpB;IAED;;;OAGG;IACI,MAAM,IAAI,IAAI,CAEpB;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEnD;IAED;;;OAGG;IACI,WAAW,IAAI,IAAI,CAEzB;IAED;;;OAGG;IACI,QAAQ,IAAI,IAAI,CAEtB;CACF"}
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/phaser/core/scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,qBAAa,KAAK;IACT,IAAI,EAAE,IAAI,GAAG,IAAI,CAAQ;IACzB,GAAG,SAAM;IAChB;;OAEG;IAEH;;;OAGG;IACI,IAAI,IAAI,IAAI,CAElB;IAED;;;OAGG;IACI,OAAO,IAAI,IAAI,CAErB;IAED;;;OAGG;IACI,MAAM,IAAI,IAAI,CAEpB;IAED;;;OAGG;IACI,MAAM,IAAI,IAAI,CAEpB;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEnD;IAED;;;OAGG;IACI,WAAW,IAAI,IAAI,CAEzB;IAED;;;OAGG;IACI,QAAQ,IAAI,IAAI,CAEtB;CACF"}

package/dist/phaser/core/scene_manager.d.ts

@@ -6,33 +6,43 @@ export type SceneHooks = {
     preload?: () => void;
     create?: () => void;
     update?: () => void;
+    render?: () => void;
     resize?: (width: number, height: number) => void;
     pauseUpdate?: () => void;
     shutdown?: () => void;
 };
+/** A scene once the manager holds it: its hooks plus the wiring the manager adds. */
+export type SceneState = SceneHooks & {
+    game?: Game | null;
+    key?: string;
+};
+/** What the manager accepts as a scene: an instance, a plain hook object, or a class to build one. */
+export type SceneDefinition = SceneState | (new (game: Game) => SceneState);
+/** A hook invoked with the scene as its receiver and the game as its argument. */
+type SceneCallback = (game: Game) => void;
 export declare class SceneManager {
     game: Game;
-    states: any;
-    _pendingState: any;
-    _clearWorld: any;
-    _clearCache: any;
-    _created: any;
-    _args: any;
+    states: Record<string, SceneState>;
+    _pendingState: SceneDefinition | string | null;
+    _clearWorld: boolean;
+    _clearCache: boolean;
+    _created: boolean;
+    _args: unknown[];
     current: string;
-    onInitCallback: any;
-    onPreloadCallback: any;
-    onCreateCallback: any;
-    onUpdateCallback: any;
-    onResizeCallback: any;
-    onPauseUpdateCallback: any;
-    onShutDownCallback: any;
-    callbackContext: SceneHooks;
+    onInitCallback: ((...args: unknown[]) => void) | null;
+    onPreloadCallback: SceneCallback | null;
+    onCreateCallback: SceneCallback | null;
+    onUpdateCallback: SceneCallback | null;
+    onResizeCallback: ((width: number, height: number) => void) | null;
+    onPauseUpdateCallback: SceneCallback | null;
+    onShutDownCallback: SceneCallback | null;
+    callbackContext: SceneState;
     /**
      * Creates a new SceneManager instance.
      * @param {Game} game - The game instance this manager belongs to.
      * @param {string} pendingState - The state to load when the game boots.
      */
-    constructor(game: Game, pendingState: string);
+    constructor(game: Game, pendingState: SceneDefinition | string | null);
     /**
      * Initialize the scene manager.
      * This method is called when the game boots and sets up the initial state.
@@ -45,7 +55,7 @@ export declare class SceneManager {
      * @param {boolean} autoStart - Whether to start this state immediately.
      * @returns {Scene|object} The created scene or state object.
      */
-    add(key: string, state: any, autoStart?: boolean): any;
+    add(key: string, state: SceneDefinition, autoStart?: boolean): SceneState;
     /**
      * Remove a scene state from the manager.
      * @param {string} key - The unique key for the state to remove.
@@ -138,6 +148,7 @@ export declare class SceneManager {
      * Get whether the scene has been created.
      * @returns {boolean} True if the scene has been created, false otherwise.
      */
-    get created(): any;
+    get created(): boolean;
 }
+export {};
 //# sourceMappingURL=scene_manager.d.ts.map

package/dist/phaser/core/scene_manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene_manager.d.ts","sourceRoot":"","sources":["../../../src/phaser/core/scene_manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scene_manager.d.ts","sourceRoot":"","sources":["../../../src/phaser/core/scene_manager.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpmedia/phaser",
-  "version": "1.118.0",
+  "version": "1.119.0",
   "description": "@vpmedia/phaser is the modern ECMAScript port of the popular Phaser game engine v2.6.2",
   "author": "Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)",
   "license": "MIT",

package/src/phaser/core/game.ts

@@ -12,6 +12,7 @@ import { Loader } from './loader.js';
 import { RequestAnimationFrame } from './raf.js';
 import { ScaleManager } from './scale_manager.js';
 import { SceneManager } from './scene_manager.js';
+import type { SceneDefinition } from './scene_manager.js';
 import { Signal } from './signal.js';
 import { SoundManager } from './sound_manager.js';
 import { Stage } from './stage.js';
@@ -20,10 +21,36 @@ import { TweenManager } from './tween_manager.js';
 import { World } from './world.js';
 import { getRegistry } from './registry.js';
 
+/**
+ * The options a game is created with. Everything the constructor defaults is always present on
+ * `Game.config`; the rest is only there when the caller supplied it.
+ */
+export type GameConfig = {
+  width: number;
+  height: number;
+  backgroundColor: number;
+  canvasID: string;
+  canvasStyle: Record<string, string> | undefined;
+  resolution: number;
+  transparent: boolean | 'notMultiplied';
+  antialias: boolean;
+  preserveDrawingBuffer: boolean;
+  clearBeforeRender: boolean;
+  roundPixels: boolean;
+  renderType: number;
+  isForceDisabledAudio: boolean;
+  maxParallelDownloads: number;
+  canvas?: HTMLCanvasElement;
+  isSkipTicker?: boolean;
+  parent?: string | HTMLElement;
+  state?: SceneDefinition | string;
+  logger?: Logger;
+};
+
 export class Game {
   /** Set when the scene manager kick-starts the first scene. */
   public isKickStart = false;
-  public config!: any;
+  public config!: GameConfig;
   public id!: number;
   public parent!: string | HTMLElement;
   public width!: number;
@@ -56,8 +83,8 @@ export class Game {
   public onResume!: Signal;
   public onBoot!: Signal;
   public isPaused!: boolean;
-  public contextLostBinded!: any;
-  public contextRestoredBinded!: any;
+  public contextLostBinded!: EventListener | null;
+  public contextRestoredBinded!: EventListener | null;
   /**
    * Creates a new Game instance.
    * @param {object} gameConfig - The configuration object for the game.
@@ -78,9 +105,8 @@ export class Game {
    * @param {string|HTMLElement} gameConfig.parent - The parent element to append the canvas to.
    * @param {object} gameConfig.state - The initial state object or class.
    */
-  public constructor(gameConfig: any = {}) {
+  public constructor(gameConfig: Partial<GameConfig> = {}) {
     getRegistry();
-    this.config = {};
     this.id = 0;
     this.parent = '';
     this.width = 800;
@@ -160,7 +186,7 @@ export class Game {
       this.canvas = create(this, this.width, this.height, this.config.canvasID, true);
     }
     if (this.config.canvasStyle) {
-      const canvasStyle = this.config.canvasStyle as Record<string, string>;
+      const { canvasStyle } = this.config;
       for (const property of Object.keys(canvasStyle)) {
         this.canvas.style.setProperty(property, canvasStyle[property] ?? null);
       }
@@ -223,21 +249,22 @@ export class Game {
    * @param {string} key - The configuration key to parse.
    * @param {*} defaultValue - The default value if the key is not found in config.
    */
-  public parseConfigElement(config: any, key: string, defaultValue?: any): void {
-    if (config[key] !== undefined) {
-      this.config[key] = config[key];
-    } else {
-      this.config[key] = defaultValue;
-    }
+  public parseConfigElement<K extends keyof GameConfig>(
+    config: Partial<GameConfig>,
+    key: K,
+    defaultValue?: GameConfig[K]
+  ): void {
+    this.config[key] = (config[key] ?? defaultValue)!;
   }
 
   /**
    * Parses the configuration object and sets up game properties.
    * @param {object} config - The configuration object to parse.
    */
-  public parseConfig(config: any): void {
+  public parseConfig(config: Partial<GameConfig>): void {
     this.logger = config.logger ?? getLogger(['phaser']);
     this.logger.info('parseConfig');
+    this.config = {} as GameConfig;
     this.parseConfigElement(config, 'width', 800);
     this.parseConfigElement(config, 'height', 600);
     this.parseConfigElement(config, 'backgroundColor', 0x00_00_00);
@@ -255,19 +282,15 @@ export class Game {
     if (config.parent) {
       this.parent = config.parent;
     }
-    let state = null;
-    if (config.state) {
-      ({ state } = config);
-    }
-    this.state = new SceneManager(this, state);
+    this.state = new SceneManager(this, config.state ?? null);
   }
 
   /**
    * Called when the WebGL context is lost.
    * @param {WebGLContextEvent | Event} event - The WebGL context loss event.
    */
-  public contextLost(event: any): void {
-    this.logger.info('contextLost', event);
+  public contextLost(event: Event): void {
+    this.logger.info('contextLost', { type: event.type });
     event.preventDefault();
     if (this.renderer) {
       this.renderer.contextLost = true;
@@ -278,8 +301,8 @@ export class Game {
    * Called when the WebGL context is restored.
    * @param {WebGLContextEvent | Event} event - The WebGL context restore event.
    */
-  public contextRestored(event: any): void {
-    this.logger.info('contextRestored', event);
+  public contextRestored(event: Event): void {
+    this.logger.info('contextRestored', { type: event.type });
     if (this.renderer) {
       this.renderer.initContext(this);
       // This.cache.clearGLTextures();

package/src/phaser/core/scene.ts

@@ -1,6 +1,8 @@
+import type { Game } from './game.js';
+
 export class Scene {
-  public game: any = null;
-  public key: any = '';
+  public game: Game | null = null;
+  public key = '';
   /**
    * Creates a new Scene instance.
    */

package/src/phaser/core/scene_manager.test.ts

@@ -0,0 +1,193 @@
+import { describe, expect, it, vi } from 'vitest';
+import { Scene } from './scene.js';
+import { SceneManager } from './scene_manager.js';
+import type { Game } from './game.js';
+import type { SceneState } from './scene_manager.js';
+
+const createGame = (isBooted = true): Game =>
+  ({
+    isBooted,
+    isKickStart: false,
+    world: { x: 0, y: 0, destroy: vi.fn() },
+    tweens: { removeAll: vi.fn() },
+    input: { reset: vi.fn() },
+    time: { removeAll: vi.fn() },
+    scale: { reset: vi.fn() },
+    cache: { destroy: vi.fn() },
+    load: { reset: vi.fn(), start: vi.fn(), totalQueuedFiles: (): number => 0, totalQueuedPacks: (): number => 0 },
+  }) as unknown as Game;
+
+const createManager = (pendingState: ConstructorParameters<typeof SceneManager>[1] = null): SceneManager =>
+  new SceneManager(createGame(), pendingState);
+
+describe('SceneManager', () => {
+  describe('add', () => {
+    it('takes a plain hook object and links the game onto it', () => {
+      const manager = createManager();
+      const state: SceneState = { create: vi.fn<() => void>() };
+      expect(manager.add('menu', state)).toBe(state);
+      expect(state.game).toBeDefined();
+    });
+
+    it('builds a state from a constructor', () => {
+      const manager = createManager();
+      class Menu extends Scene {}
+      expect(manager.add('menu', Menu)).toBeInstanceOf(Menu);
+    });
+
+    it('takes a scene instance as-is', () => {
+      const manager = createManager();
+      const scene = new Scene();
+      expect(manager.add('menu', scene)).toBe(scene);
+    });
+
+    it('queues the state when the game has not booted', () => {
+      const manager = new SceneManager(createGame(false), null);
+      manager.add('menu', { create: vi.fn<() => void>() }, true);
+      expect(manager._pendingState).toBe('menu');
+    });
+
+    it('starts the state right away once the game has booted', () => {
+      const manager = createManager();
+      manager.add('menu', { create: vi.fn<() => void>() }, true);
+      expect(manager._pendingState).toBe('menu');
+    });
+  });
+
+  describe('boot', () => {
+    it('registers a state given as an object under the default key', () => {
+      const manager = createManager({ create: vi.fn<() => void>() });
+      manager.boot();
+      expect(manager.states['default']).toBeDefined();
+    });
+
+    it('leaves a state given by key alone', () => {
+      const manager = createManager('menu');
+      manager.boot();
+      expect(manager.states['default']).toBeUndefined();
+    });
+  });
+
+  describe('checkState', () => {
+    it('accepts a state carrying any of the lifecycle hooks', () => {
+      const manager = createManager();
+      manager.add('menu', { update: vi.fn<() => void>() });
+      expect(manager.checkState('menu')).toBe(true);
+    });
+
+    it('rejects a state with no hooks at all', () => {
+      const manager = createManager();
+      manager.add('menu', {});
+      expect(manager.checkState('menu')).toBe(false);
+    });
+
+    it('rejects a key it does not hold', () => {
+      expect(createManager().checkState('nope')).toBe(false);
+    });
+  });
+
+  describe('setCurrentState', () => {
+    it('binds the hooks the state provides and leaves the rest null', () => {
+      const manager = createManager();
+      const create = vi.fn<() => void>();
+      manager.add('menu', { create });
+      manager.setCurrentState('menu');
+      expect(manager.current).toBe('menu');
+      expect(manager.onCreateCallback).toBe(create);
+      expect(manager.onUpdateCallback).toBeNull();
+      expect(manager.onPreloadCallback).toBeNull();
+    });
+
+    it('falls back to a no-op for init and shutdown', () => {
+      const manager = createManager();
+      manager.add('menu', {});
+      manager.setCurrentState('menu');
+      expect(manager.onInitCallback).toBe(manager.dummy);
+      expect(manager.onShutDownCallback).toBe(manager.dummy);
+    });
+
+    it('calls init with the arguments start was given', () => {
+      const manager = createManager();
+      const init = vi.fn<() => void>();
+      manager.add('menu', { init, update: vi.fn<() => void>() });
+      manager.start('menu', true, false, 'a', 1);
+      manager.setCurrentState('menu');
+      expect(init).toHaveBeenCalledWith('a', 1);
+    });
+
+    it('stamps the key onto the state', () => {
+      const manager = createManager();
+      const state: SceneState = { create: vi.fn<() => void>() };
+      manager.add('menu', state);
+      manager.setCurrentState('menu');
+      expect(state.key).toBe('menu');
+    });
+  });
+
+  describe('start', () => {
+    it('ignores a key with no lifecycle hooks', () => {
+      const manager = createManager();
+      manager.add('menu', {});
+      manager.start('menu');
+      expect(manager._pendingState).toBeNull();
+    });
+  });
+
+  describe('update', () => {
+    it('runs the update hook only once the scene has been created', () => {
+      const manager = createManager();
+      const update = vi.fn<() => void>();
+      manager.add('menu', { update });
+      manager.setCurrentState('menu');
+      manager.update();
+      expect(update).not.toHaveBeenCalled();
+      manager.loadComplete();
+      manager.update();
+      expect(update).toHaveBeenCalledTimes(1);
+    });
+
+    it('runs the create hook exactly once', () => {
+      const manager = createManager();
+      const create = vi.fn<() => void>();
+      manager.add('menu', { create });
+      manager.setCurrentState('menu');
+      manager.loadComplete();
+      manager.loadComplete();
+      expect(create).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  describe('resize', () => {
+    it('passes the new size to the scene', () => {
+      const manager = createManager();
+      const resize = vi.fn<(width: number, height: number) => void>();
+      manager.add('menu', { resize });
+      manager.setCurrentState('menu');
+      manager.resize(320, 240);
+      expect(resize).toHaveBeenCalledWith(320, 240);
+    });
+  });
+
+  describe('remove', () => {
+    it('drops the state and unbinds its hooks when it is current', () => {
+      const manager = createManager();
+      manager.add('menu', { create: vi.fn<() => void>() });
+      manager.setCurrentState('menu');
+      manager.remove('menu');
+      expect(manager.states['menu']).toBeUndefined();
+      expect(manager.onCreateCallback).toBeNull();
+    });
+  });
+
+  describe('destroy', () => {
+    it('empties the manager', () => {
+      const manager = createManager();
+      manager.add('menu', { create: vi.fn<() => void>(), shutdown: vi.fn<() => void>() });
+      manager.setCurrentState('menu');
+      manager.destroy();
+      expect(manager.states).toStrictEqual({});
+      expect(manager.current).toBe('');
+      expect(manager._pendingState).toBeNull();
+    });
+  });
+});