@energy8platform/game-engine 0.1.0 → 0.2.1

package/dist/index.cjs.js

@@ -993,6 +993,150 @@ class AudioManager {
     }
 }
 
+/**
+ * Unified input manager for touch, mouse, and keyboard.
+ *
+ * Features:
+ * - Unified pointer events (works with touch + mouse)
+ * - Swipe gesture detection
+ * - Keyboard input with isKeyDown state
+ * - Input locking (block input during animations)
+ *
+ * @example
+ * ```ts
+ * const input = new InputManager(app.canvas);
+ *
+ * input.on('tap', ({ x, y }) => console.log('Tapped at', x, y));
+ * input.on('swipe', ({ direction }) => console.log('Swiped', direction));
+ * input.on('keydown', ({ key }) => {
+ *   if (key === ' ') spin();
+ * });
+ *
+ * // Block input during animations
+ * input.lock();
+ * await playAnimation();
+ * input.unlock();
+ * ```
+ */
+class InputManager extends EventEmitter {
+    _canvas;
+    _locked = false;
+    _keysDown = new Set();
+    _destroyed = false;
+    // Gesture tracking
+    _pointerStart = null;
+    _swipeThreshold = 50; // minimum distance in px
+    _swipeMaxTime = 300; // max ms for swipe gesture
+    constructor(canvas) {
+        super();
+        this._canvas = canvas;
+        this.setupPointerEvents();
+        this.setupKeyboardEvents();
+    }
+    /** Whether input is currently locked */
+    get locked() {
+        return this._locked;
+    }
+    /** Lock all input (e.g., during animations) */
+    lock() {
+        this._locked = true;
+    }
+    /** Unlock input */
+    unlock() {
+        this._locked = false;
+    }
+    /** Check if a key is currently pressed */
+    isKeyDown(key) {
+        return this._keysDown.has(key.toLowerCase());
+    }
+    /** Destroy the input manager */
+    destroy() {
+        this._destroyed = true;
+        this._canvas.removeEventListener('pointerdown', this.onPointerDown);
+        this._canvas.removeEventListener('pointerup', this.onPointerUp);
+        this._canvas.removeEventListener('pointermove', this.onPointerMove);
+        document.removeEventListener('keydown', this.onKeyDown);
+        document.removeEventListener('keyup', this.onKeyUp);
+        this._keysDown.clear();
+        this.removeAllListeners();
+    }
+    // ─── Private: Pointer ──────────────────────────────────
+    setupPointerEvents() {
+        this._canvas.addEventListener('pointerdown', this.onPointerDown);
+        this._canvas.addEventListener('pointerup', this.onPointerUp);
+        this._canvas.addEventListener('pointermove', this.onPointerMove);
+    }
+    onPointerDown = (e) => {
+        if (this._locked || this._destroyed)
+            return;
+        const pos = this.getCanvasPosition(e);
+        this._pointerStart = { ...pos, time: Date.now() };
+        this.emit('press', pos);
+    };
+    onPointerUp = (e) => {
+        if (this._locked || this._destroyed)
+            return;
+        const pos = this.getCanvasPosition(e);
+        this.emit('release', pos);
+        // Check for tap vs swipe
+        if (this._pointerStart) {
+            const dx = pos.x - this._pointerStart.x;
+            const dy = pos.y - this._pointerStart.y;
+            const dist = Math.sqrt(dx * dx + dy * dy);
+            const elapsed = Date.now() - this._pointerStart.time;
+            if (dist > this._swipeThreshold && elapsed < this._swipeMaxTime) {
+                // Swipe detected
+                const absDx = Math.abs(dx);
+                const absDy = Math.abs(dy);
+                let direction;
+                if (absDx > absDy) {
+                    direction = dx > 0 ? 'right' : 'left';
+                }
+                else {
+                    direction = dy > 0 ? 'down' : 'up';
+                }
+                this.emit('swipe', { direction, velocity: dist / elapsed });
+            }
+            else if (dist < 10) {
+                // Tap (minimal movement)
+                this.emit('tap', pos);
+            }
+        }
+        this._pointerStart = null;
+    };
+    onPointerMove = (e) => {
+        if (this._locked || this._destroyed)
+            return;
+        this.emit('move', this.getCanvasPosition(e));
+    };
+    getCanvasPosition(e) {
+        const rect = this._canvas.getBoundingClientRect();
+        return {
+            x: e.clientX - rect.left,
+            y: e.clientY - rect.top,
+        };
+    }
+    // ─── Private: Keyboard ─────────────────────────────────
+    setupKeyboardEvents() {
+        document.addEventListener('keydown', this.onKeyDown);
+        document.addEventListener('keyup', this.onKeyUp);
+    }
+    onKeyDown = (e) => {
+        if (this._locked || this._destroyed)
+            return;
+        this._keysDown.add(e.key.toLowerCase());
+        this.emit('keydown', { key: e.key, code: e.code });
+    };
+    onKeyUp = (e) => {
+        if (this._destroyed)
+            return;
+        this._keysDown.delete(e.key.toLowerCase());
+        if (this._locked)
+            return;
+        this.emit('keyup', { key: e.key, code: e.code });
+    };
+}
+
 /**
  * Manages responsive scaling of the game canvas to fit its container.
  *
@@ -1696,6 +1840,8 @@ class GameApplication extends EventEmitter {
     assets;
     /** Audio manager */
     audio;
+    /** Input manager */
+    input;
     /** Viewport manager */
     viewport;
     /** SDK instance (null in offline mode) */
@@ -1772,6 +1918,7 @@ class GameApplication extends EventEmitter {
             removeCSSPreloader(this._container);
             // 8. Load assets with loading screen
             await this.loadAssets(firstScene, sceneData);
+            this.emit('loaded', undefined);
             // 9. Start the game loop
             this._running = true;
             this.emit('started', undefined);
@@ -1791,12 +1938,13 @@ class GameApplication extends EventEmitter {
         this._destroyed = true;
         this._running = false;
         this.scenes?.destroy();
+        this.input?.destroy();
         this.audio?.destroy();
         this.viewport?.destroy();
         this.sdk?.destroy();
         this.app?.destroy(true, { children: true, texture: true });
-        this.removeAllListeners();
         this.emit('destroyed', undefined);
+        this.removeAllListeners();
     }
     // ─── Private initialization steps ──────────────────────
     resolveContainer() {
@@ -1858,6 +2006,8 @@ class GameApplication extends EventEmitter {
         this.assets = new AssetManager(basePath, this.config.manifest);
         // Audio Manager
         this.audio = new AudioManager(this.config.audio);
+        // Input Manager
+        this.input = new InputManager(this.app.canvas);
         // Viewport Manager
         this.viewport = new ViewportManager(this.app, this._container, {
             designWidth: this.config.designWidth,
@@ -1875,6 +2025,10 @@ class GameApplication extends EventEmitter {
         this.viewport.on('orientationChange', (orientation) => {
             this.emit('orientationChange', orientation);
         });
+        // Wire scene changes → engine event
+        this.scenes.on('change', ({ from, to }) => {
+            this.emit('sceneChange', { from, to });
+        });
         // Connect ticker → scene updates
         this.app.ticker.add((ticker) => {
             // Always update scenes (loading screen needs onUpdate before _running=true)
@@ -2341,150 +2495,6 @@ class SpineHelper {
     }
 }
 
-/**
- * Unified input manager for touch, mouse, and keyboard.
- *
- * Features:
- * - Unified pointer events (works with touch + mouse)
- * - Swipe gesture detection
- * - Keyboard input with isKeyDown state
- * - Input locking (block input during animations)
- *
- * @example
- * ```ts
- * const input = new InputManager(app.canvas);
- *
- * input.on('tap', ({ x, y }) => console.log('Tapped at', x, y));
- * input.on('swipe', ({ direction }) => console.log('Swiped', direction));
- * input.on('keydown', ({ key }) => {
- *   if (key === ' ') spin();
- * });
- *
- * // Block input during animations
- * input.lock();
- * await playAnimation();
- * input.unlock();
- * ```
- */
-class InputManager extends EventEmitter {
-    _canvas;
-    _locked = false;
-    _keysDown = new Set();
-    _destroyed = false;
-    // Gesture tracking
-    _pointerStart = null;
-    _swipeThreshold = 50; // minimum distance in px
-    _swipeMaxTime = 300; // max ms for swipe gesture
-    constructor(canvas) {
-        super();
-        this._canvas = canvas;
-        this.setupPointerEvents();
-        this.setupKeyboardEvents();
-    }
-    /** Whether input is currently locked */
-    get locked() {
-        return this._locked;
-    }
-    /** Lock all input (e.g., during animations) */
-    lock() {
-        this._locked = true;
-    }
-    /** Unlock input */
-    unlock() {
-        this._locked = false;
-    }
-    /** Check if a key is currently pressed */
-    isKeyDown(key) {
-        return this._keysDown.has(key.toLowerCase());
-    }
-    /** Destroy the input manager */
-    destroy() {
-        this._destroyed = true;
-        this._canvas.removeEventListener('pointerdown', this.onPointerDown);
-        this._canvas.removeEventListener('pointerup', this.onPointerUp);
-        this._canvas.removeEventListener('pointermove', this.onPointerMove);
-        document.removeEventListener('keydown', this.onKeyDown);
-        document.removeEventListener('keyup', this.onKeyUp);
-        this._keysDown.clear();
-        this.removeAllListeners();
-    }
-    // ─── Private: Pointer ──────────────────────────────────
-    setupPointerEvents() {
-        this._canvas.addEventListener('pointerdown', this.onPointerDown);
-        this._canvas.addEventListener('pointerup', this.onPointerUp);
-        this._canvas.addEventListener('pointermove', this.onPointerMove);
-    }
-    onPointerDown = (e) => {
-        if (this._locked || this._destroyed)
-            return;
-        const pos = this.getCanvasPosition(e);
-        this._pointerStart = { ...pos, time: Date.now() };
-        this.emit('press', pos);
-    };
-    onPointerUp = (e) => {
-        if (this._locked || this._destroyed)
-            return;
-        const pos = this.getCanvasPosition(e);
-        this.emit('release', pos);
-        // Check for tap vs swipe
-        if (this._pointerStart) {
-            const dx = pos.x - this._pointerStart.x;
-            const dy = pos.y - this._pointerStart.y;
-            const dist = Math.sqrt(dx * dx + dy * dy);
-            const elapsed = Date.now() - this._pointerStart.time;
-            if (dist > this._swipeThreshold && elapsed < this._swipeMaxTime) {
-                // Swipe detected
-                const absDx = Math.abs(dx);
-                const absDy = Math.abs(dy);
-                let direction;
-                if (absDx > absDy) {
-                    direction = dx > 0 ? 'right' : 'left';
-                }
-                else {
-                    direction = dy > 0 ? 'down' : 'up';
-                }
-                this.emit('swipe', { direction, velocity: dist / elapsed });
-            }
-            else if (dist < 10) {
-                // Tap (minimal movement)
-                this.emit('tap', pos);
-            }
-        }
-        this._pointerStart = null;
-    };
-    onPointerMove = (e) => {
-        if (this._locked || this._destroyed)
-            return;
-        this.emit('move', this.getCanvasPosition(e));
-    };
-    getCanvasPosition(e) {
-        const rect = this._canvas.getBoundingClientRect();
-        return {
-            x: e.clientX - rect.left,
-            y: e.clientY - rect.top,
-        };
-    }
-    // ─── Private: Keyboard ─────────────────────────────────
-    setupKeyboardEvents() {
-        document.addEventListener('keydown', this.onKeyDown);
-        document.addEventListener('keyup', this.onKeyUp);
-    }
-    onKeyDown = (e) => {
-        if (this._locked || this._destroyed)
-            return;
-        this._keysDown.add(e.key.toLowerCase());
-        this.emit('keydown', { key: e.key, code: e.code });
-    };
-    onKeyUp = (e) => {
-        if (this._destroyed)
-            return;
-        this._keysDown.delete(e.key.toLowerCase());
-        if (this._locked)
-            return;
-        this.emit('keyup', { key: e.key, code: e.code });
-    };
-}
-
 const DEFAULT_COLORS = {
     normal: 0xffd700,
     hover: 0xffe44d,