like2d 2.8.0 → 2.9.0

package/dist/core/mouse.js

@@ -1,149 +1,94 @@
+import { Vec2 } from '../math/vector2';
+const mouseButtons = ["left", "middle", "right"];
+const numToButton = (i) => mouseButtons[i];
 /**
  * Mouse input handling. Bound to canvas. Emits relative movement when pointer locked.
  * Buttons: 1 = left, 2 = middle, 3 = right.
  */
-export class Mouse {
-    constructor(canvas, transformFn) {
-        Object.defineProperty(this, "x", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 0
-        });
-        Object.defineProperty(this, "y", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 0
-        });
-        Object.defineProperty(this, "buttons", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Set()
-        });
-        Object.defineProperty(this, "cursorVisible", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: true
-        });
-        Object.defineProperty(this, "onMouseMove", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "onMouseDown", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "onMouseUp", {
+export class MouseInternal {
+    constructor(canvas, dispatch) {
+        Object.defineProperty(this, "canvas", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: canvas
         });
-        Object.defineProperty(this, "transformFn", {
+        Object.defineProperty(this, "dispatch", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: dispatch
         });
-        Object.defineProperty(this, "canvas", {
+        Object.defineProperty(this, "pos", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: null
+            value: [0, 0]
         });
-        // Event handler references for cleanup
-        Object.defineProperty(this, "mousemoveHandler", {
+        Object.defineProperty(this, "lastPos", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: [0, 0]
         });
-        Object.defineProperty(this, "mousedownHandler", {
+        Object.defineProperty(this, "buttons", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: new Set()
         });
-        Object.defineProperty(this, "mouseupHandler", {
+        Object.defineProperty(this, "cursorVisible", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: true
         });
-        Object.defineProperty(this, "wheelHandler", {
+        Object.defineProperty(this, "abort", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: new AbortController()
         });
-        this.canvas = canvas;
-        this.transformFn = transformFn;
-        if (this.canvas) {
-            this.canvas.tabIndex = 0;
-        }
-        this.mousemoveHandler = this.handleMouseMove.bind(this);
-        this.mousedownHandler = this.handleMouseDown.bind(this);
-        this.mouseupHandler = this.handleMouseUp.bind(this);
-        this.wheelHandler = this.handleWheel.bind(this);
-        if (this.canvas) {
-            this.canvas.addEventListener('mousemove', this.mousemoveHandler);
-            this.canvas.addEventListener('mousedown', this.mousedownHandler);
-            window.addEventListener('mouseup', this.mouseupHandler);
-            this.canvas.addEventListener('wheel', this.wheelHandler, { passive: false });
-        }
-    }
-    setTransform(transformFn) {
-        this.transformFn = transformFn;
+        this.canvas.addEventListener('like:mousemoved', this.handleMouseMove.bind(this), { signal: this.abort.signal });
+        this.canvas.addEventListener('mousedown', this.handleMouseDown.bind(this), { signal: this.abort.signal });
+        window.addEventListener('mouseup', this.handleMouseUp.bind(this), { signal: this.abort.signal });
+        this.canvas.addEventListener('wheel', this.handleWheel.bind(this), { passive: false, signal: this.abort.signal });
+        this.canvas.addEventListener('mouseleave', () => this.buttons.clear(), { signal: this.abort.signal });
     }
     handleMouseMove(e) {
         if (this.isPointerLocked()) {
-            // When locked, emit relative movement
-            this.onMouseMove?.([e.movementX, e.movementY], true);
+            /** In pointer-lock mode, simulate a real cursor bounded by the canvas. */
+            this.pos = Vec2.clamp(Vec2.add(this.pos, e.detail.delta), [0, 0], e.detail.renderSize);
+            this.dispatch('mousemoved', [this.pos, e.detail.delta]);
         }
         else {
-            // Normal mode: track position and emit absolute coords
-            this.x = e.offsetX;
-            this.y = e.offsetY;
-            const pos = this.getPosition();
-            this.onMouseMove?.(pos, false);
+            /** In non-pointer locked mode, calculate deltas ourselves. */
+            this.pos = e.detail.pos;
+            this.dispatch('mousemoved', [this.pos, Vec2.sub(this.pos, this.lastPos)]);
         }
+        this.lastPos = this.pos;
     }
     handleMouseDown(e) {
-        this.buttons.add(e.button + 1);
-        const pos = this.transformFn ? this.transformFn(e.offsetX, e.offsetY) : [e.offsetX, e.offsetY];
-        this.onMouseDown?.(pos, e.button + 1);
+        // hack: ignore right clicks because they cause a refocus
+        if (!this.isPointerLocked() && e.button == 2)
+            return;
+        this.buttons.add(numToButton(e.button));
+        this.dispatch('mousepressed', [[e.offsetX, e.offsetY], numToButton(e.button)]);
         this.canvas?.focus();
     }
     handleMouseUp(e) {
-        this.buttons.delete(e.button + 1);
-        const pos = this.transformFn ? this.transformFn(e.offsetX, e.offsetY) : [e.offsetX, e.offsetY];
-        this.onMouseUp?.(pos, e.button + 1);
+        this.buttons.delete(numToButton(e.button));
+        this.dispatch('mousereleased', [[e.offsetX, e.offsetY], numToButton(e.button)]);
     }
     handleWheel(e) {
         e.preventDefault();
     }
-    dispose() {
-        if (this.canvas) {
-            this.canvas.removeEventListener('mousemove', this.mousemoveHandler);
-            this.canvas.removeEventListener('mousedown', this.mousedownHandler);
-            this.canvas.removeEventListener('wheel', this.wheelHandler);
-        }
-        window.removeEventListener('mouseup', this.mouseupHandler);
-        this.buttons.clear();
+    _dispose() {
+        this.abort.abort();
     }
-    /** Mouse position in canvas pixels. */
+    /** Mouse position, transformed to canvas pixels. */
     getPosition() {
-        if (this.transformFn) {
-            return this.transformFn(this.x, this.y);
-        }
-        return [this.x, this.y];
+        return this.pos;
     }
     /** Check if button is held. Button 1 = left, 2 = middle, 3 = right. */
     isDown(button) {
@@ -153,11 +98,26 @@ export class Mouse {
     getPressedButtons() {
         return new Set(this.buttons);
     }
-    /** True when pointer is locked to canvas. */
+    /** True when pointer is locked to canvas.
+     * {@link lockPointer}
+     */
     isPointerLocked() {
         return document.pointerLockElement !== null;
     }
-    /** Lock or unlock pointer. When locked, mousemoved emits relative deltas. */
+    /**
+     * Whether to lock (capture) the pointer.
+     *
+     * In locked mode, the cursor cannot escape the canvas.
+     * It also becomes invisible.
+     *
+     * Note that event {@link mousemoved} passes both
+     * `pos` and `delta`.
+     *
+     * Though the emulated cursor in locked mode
+     * (locked mode doesn't natively track absolute position)
+     * may be stuck on canvas edges, the `delta` field always
+     * represents mouse movement.
+    */
     lockPointer(locked) {
         if (!this.canvas)
             return;

package/dist/core/timer.d.ts

@@ -1,17 +1,14 @@
-export declare class Timer {
+export declare class TimerInternal {
     private currentDelta;
     private totalTime;
     private frameCount;
     private fps;
     private fpsAccumulator;
     private sleepUntil;
-    private sceneStartTime;
-    update(dt: number): void;
-    resetSceneTime(): void;
+    _update(dt: number): void;
     getDelta(): number;
     getFPS(): number;
     getTime(): number;
-    getSceneTime(): number;
     isSleeping(): boolean;
     sleep(duration: number): void;
 }

package/dist/core/timer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../src/core/timer.ts"],"names":[],"mappings":"AAAA,qBAAa,KAAK;IAChB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,cAAc,CAAK;IAE3B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAaxB,cAAc,IAAI,IAAI;IAItB,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,MAAM;IAIhB,OAAO,IAAI,MAAM;IAIjB,YAAY,IAAI,MAAM;IAItB,UAAU,IAAI,OAAO;IAUrB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAG9B"}
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../src/core/timer.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,UAAU,CAAuB;IAEzC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAazB,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,MAAM;IAIhB,OAAO,IAAI,MAAM;IAIjB,UAAU,IAAI,OAAO;IAUrB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAG9B"}

package/dist/core/timer.js

@@ -1,4 +1,4 @@
-export class Timer {
+export class TimerInternal {
     constructor() {
         Object.defineProperty(this, "currentDelta", {
             enumerable: true,
@@ -36,14 +36,8 @@ export class Timer {
             writable: true,
             value: null
         });
-        Object.defineProperty(this, "sceneStartTime", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 0
-        });
     }
-    update(dt) {
+    _update(dt) {
         this.currentDelta = dt;
         this.totalTime += dt;
         this.frameCount++;
@@ -54,9 +48,6 @@ export class Timer {
             this.fpsAccumulator = 0;
         }
     }
-    resetSceneTime() {
-        this.sceneStartTime = this.totalTime;
-    }
     getDelta() {
         return this.currentDelta;
     }
@@ -66,9 +57,6 @@ export class Timer {
     getTime() {
         return this.totalTime;
     }
-    getSceneTime() {
-        return this.totalTime - this.sceneStartTime;
-    }
     isSleeping() {
         if (this.sleepUntil === null)
             return false;

package/dist/engine.d.ts

@@ -1,25 +1,70 @@
-import type { Like2DEvent } from './core/events';
-import type { PartialCanvasMode } from './core/canvas-config';
-import type { Like } from './core/like';
+/**
+ * @module engine
+ * @description Core game engine - lifecycle management and event dispatch.
+ *
+ * You've reached the most evil part of the codebase -- the man
+ * behind the curtain.
+ *
+ * The secret force gluing everything together.
+ *
+ * If you want to use modules independently, look here first.
+ *
+ * ## Memory Management
+ *
+ * Always call `dispose()` when destroying an engine instance:
+ * - Removes all event listeners
+ * - Stops the game loop
+ * - Removes canvas from DOM
+ * - Cleans up canvas manager resources
+ *
+ */
+import type { LikeInternal } from './core/like';
+export type EngineDispatch = Engine["dispatch"];
+/**
+ * Core game engine managing the event loop and subsystems.
+ *
+ * Normally you don't instantiate this directly - use {@link createLike} instead.
+ * The Engine class is exposed for advanced use cases like testing or
+ * custom initialization sequences.
+ *
+ * All subsystems are accessible via the {@link like} property.
+ */
 export declare class Engine {
+    private container;
     private canvas;
     private isRunning;
     private lastTime;
-    private container;
-    private canvasManager;
-    private handleEvent;
-    private currentScene;
-    private gfxState;
-    private windowFocusHandler;
-    private windowBlurHandler;
-    private canvasFocusHandler;
-    private canvasBlurHandler;
-    private fullscreenChangeHandler;
-    readonly like: Like;
+    private abort;
+    /**
+     * The Like interface providing access to all engine subsystems.
+     * This object is passed to all scene callbacks and game code.
+     */
+    readonly like: LikeInternal;
     constructor(container: HTMLElement);
     private dispatch;
-    setMode(mode: PartialCanvasMode): void;
-    start(handleEvent: (event: Like2DEvent) => void): Promise<void>;
+    /**
+     * Start the game loop.
+     *
+     * @remarks
+     * This method:
+     * 1. Dispatches the initial `load` event
+     * 2. Starts the requestAnimationFrame loop
+     *
+     * The engine runs until dispose() is called.
+     */
+    start(): Promise<void>;
+    /**
+     * Clean up all resources and stop the engine.
+     *
+     * @remarks
+     * This method:
+     * - Stops the game loop
+     * - Removes all event listeners (keyboard, mouse, window, fullscreen)
+     * - Disposes canvas manager (removes resize observer)
+     * - Removes the canvas element from the DOM
+     *
+     * The engine cannot be restarted after disposal - create a new instance.
+     */
     dispose(): void;
 }
 //# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAIxC,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAA+C;IAClE,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,QAAQ,CAA8B;IAG9C,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,uBAAuB,CAA6B;IAE5D,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;gBAER,SAAS,EAAE,WAAW;IAqFlC,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAUhC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BrE,OAAO,IAAI,IAAI;CAiBhB"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAUH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AAEhD;;;;;;;;GAQG;AACH,qBAAa,MAAM;IAaL,OAAO,CAAC,SAAS;IAZ7B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAK;IAErB,OAAO,CAAC,KAAK,CAAyB;IAEtC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;gBAER,SAAS,EAAE,WAAW;IAmD1C,OAAO,CAAC,QAAQ;IAShB;;;;;;;;;OASG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B5B;;;;;;;;;;;OAWG;IACH,OAAO,IAAI,IAAI;CAahB"}