like2d 2.9.0 → 2.10.0

package/README.md

@@ -31,9 +31,10 @@
  </g>
 </svg>
 
-Lightweight Web framework inspired by [LÖVE](https://love2d.org/).
+Lightweight web game framework inspired by [LÖVE](https://love2d.org/).
 
 ## <div style="color:red">During v2.x.x, LIKE's API will change.</div>
+
 ## What it is
 
 LIKE is a cozy way to make 2d games for browser.
@@ -43,11 +44,11 @@ LIKE is a cozy way to make 2d games for browser.
 - **🔥 Fire-and-forget Assets:** Graphics and audio that pretend to be synchronous.
 - **🎯 DWIM graphics:** Turns repetitive draw calls into one while removing state bleed for properties like `lineCap`.
 - **↔️ Two Canvas Modes:**
-   - 🖊️ Audio-resize the canvas; sharp at any resolution.
-   - 👾 For retro-style developers, pixels stay crisp but smooth via prescaling.
-- **⭕ Easier Geometry:** `Vector2` and `Rect` are just number tuples (arrays), but a pure-functional library makes them easy to work with and plays nice with `map` and `reduce`. 
-- **🚲 Easy Input:** Keyboard, Mouse, and Gamepad all are given both event-based and tracking-based options. Choose what fits your architecture.
-- **👟 Consistent APIs:** Colors 0-1, not 0-255. Seconds, not milliseconds.
+  - 🖊️ Audio-resize the canvas; sharp at any resolution.
+  - 👾 For retro-style developers, pixels stay crisp but smooth via prescaling.
+- **⭕ Easier Geometry:** `Vector2` and `Rect` are just number tuples (arrays), but a pure-functional library makes them easy to work with and plays nice with `map` and `reduce`.
+- **🚲 Easy Input:** Keyboard, Mouse, and Gamepad all are given both event-based and query-based options. Choose what fits your architecture. Most gamepads get auto-mapped perfectly, are easy to remap, and LIKE can load and save user mappings automatically.
+- **👟Consistent APIs:** Colors 0-1, not 0-255. Seconds, not milliseconds. Physical gamepad buttons, not "A" or "B".
 - **👉 Actions System:** An input layer maps inputs to actions, which fire usable events.
 - **🌎 Global control:** Choose how to handle LIKE events, and manage resources with centralized trackers. LIKE is a great foundation for your own engine.
 - **🐦 Light and Elegant:** Zero dependencies and less than 5000 lines of code -- focused entirely on what matters.
@@ -55,6 +56,7 @@ LIKE is a cozy way to make 2d games for browser.
 ## Installation
 
 Most package managers will work.
+
 ```bash
 npm install like2d
 # or ...
@@ -66,6 +68,7 @@ deno add jsr:@like2d/like
 
 To try Like2D quickly, use this starter with
 hot reloading and a basic webpage.
+
 ```bash
 npx degit 44100hertz/Like2D/examples/starter my-game
 ```
@@ -73,25 +76,25 @@ npx degit 44100hertz/Like2D/examples/starter my-game
 ## Usage Example
 
 ```typescript
-import { createLike } from 'like2d';
+import { createLike } from "like2d";
 
 const like = createLike(document.body);
 
 like.load = () => {
   like.setMode([800, 600]);
-  like.input.setAction('jump', ['Space', 'ButtonBottom']);
+  like.input.setAction("jump", ["Space", "BBottom"]);
 };
 
 like.update = (dt) => {
-  if (like.input.justPressed('jump')) {
-    console.log('Jump!');
+  if (like.input.justPressed("jump")) {
+    console.log("Jump!");
   }
 };
 
 like.draw = () => {
   like.gfx.clear([0.1, 0.1, 0.1, 1]);
-  like.gfx.circle('fill', 'dodgerblue', [400, 300], 50);
-  like.gfx.print('white', 'Hello Like2D!', [20, 20]);
+  like.gfx.circle("fill", "dodgerblue", [400, 300], 50);
+  like.gfx.print("white", "Hello Like2D!", [20, 20]);
 };
 
 await like.start();
@@ -100,11 +103,12 @@ await like.start();
 ## For Love2D Developers
 
 LIKE's API is not the same as LOVE, but similar in spirit. Notable differences:
- - Draw your graphics in one call, that's all. No setup or state bleed.
- - You manage your own instance of like in a big friendly object. This allows us to have multiple games on one page.
- - We use Vector2 and Rect tuples (like `[x, y]`) instead of loose coordinates.
- - Theres an actions system -- `input.setAction` / `actionpressed` and `actionreleased` callbacks.
- - Some things are missing either due to browser limitations or smaller scope.
+
+- Draw your graphics in one call, that's all. No setup or state bleed.
+- You manage your own instance of like in a big friendly object. This allows us to have multiple games on one page.
+- We use Vector2 and Rect tuples (like `[x, y]`) instead of loose coordinates.
+- Theres an actions system -- `input.setAction` / `actionpressed` and `actionreleased` callbacks.
+- Some things are missing either due to browser limitations or smaller scope.
 
 ## Feedback welcome
 

package/dist/__benchmarks__/vector2.bench.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vector2.bench.d.ts.map

package/dist/__benchmarks__/vector2.bench.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector2.bench.d.ts","sourceRoot":"","sources":["../../src/__benchmarks__/vector2.bench.ts"],"names":[],"mappings":""}

package/dist/__benchmarks__/vector2.bench.js

@@ -0,0 +1,74 @@
+import { bench, describe } from 'vitest';
+import { Vec2 } from '../math/vector2';
+const VEC2_COUNT = 10000;
+function makeVec2s(count) {
+    const vec2s = [];
+    for (let i = 0; i < count; i++) {
+        vec2s.push([Math.random() * 1000, Math.random() * 1000]);
+    }
+    return vec2s;
+}
+describe('Vector2', () => {
+    const a = makeVec2s(VEC2_COUNT);
+    const b = makeVec2s(VEC2_COUNT);
+    describe('binary operations', () => {
+        bench('add', () => {
+            let sum = 0;
+            for (let i = 0; i < VEC2_COUNT; i++) {
+                const result = Vec2.add(a[i], b[i]);
+                sum += result[0];
+            }
+            if (sum === -1)
+                console.log(sum);
+        });
+        bench('sub', () => {
+            let sum = 0;
+            for (let i = 0; i < VEC2_COUNT; i++) {
+                const result = Vec2.sub(a[i], b[i]);
+                sum += result[0];
+            }
+            if (sum === -1)
+                console.log(sum);
+        });
+        bench('mul', () => {
+            let sum = 0;
+            for (let i = 0; i < VEC2_COUNT; i++) {
+                const result = Vec2.mul(a[i], b[i]);
+                sum += result[0];
+            }
+            if (sum === -1)
+                console.log(sum);
+        });
+        bench('div', () => {
+            let sum = 0;
+            for (let i = 0; i < VEC2_COUNT; i++) {
+                const result = Vec2.div(a[i], b[i]);
+                sum += result[0];
+            }
+            if (sum === -1)
+                console.log(sum);
+        });
+        bench('dot', () => {
+            let sum = 0;
+            for (let i = 0; i < VEC2_COUNT; i++) {
+                const result = Vec2.dot(a[i], b[i]);
+                sum += result;
+            }
+            if (sum === -1)
+                console.log(sum);
+        });
+        bench('chained ops (add, sub, mul, div, dot)', () => {
+            let sum = 0;
+            for (let i = 0; i < VEC2_COUNT; i++) {
+                const r1 = Vec2.add(a[i], b[i]);
+                const r2 = Vec2.sub(r1, a[i]);
+                const r3 = Vec2.mul(r2, 2);
+                const r4 = Vec2.div(r3, b[i]);
+                const result = Vec2.dot(r4, a[i]);
+                sum += result;
+            }
+            if (sum === -1)
+                console.log(sum);
+        });
+    });
+});

package/dist/{core → audio}/audio.d.ts

@@ -5,8 +5,8 @@
  *
  * ## Track and give global control to all audio objects
  * Start, stop, or set global volume for every currently playing sound.
- *
  */
+/** Pass this into like.audio.newSource as config. */
 export type AudioSourceOptions = {
     volume?: number;
 };
@@ -21,12 +21,13 @@ export declare class AudioSource {
     readonly path: string;
     /** Underlying HTMLAudioElement. Modify directly for looping, pitch, etc. Use methods for playback control. Avoid setting volume directly. */
     readonly audio: HTMLAudioElement;
+    /** Avoid setting these directly. */
     readonly options: Required<AudioSourceOptions>;
     /** Resolves when the audio is loaded and ready to play. */
     readonly ready: Promise<void>;
     private loadState;
     private audioRef;
-    constructor(path: string, audioRef: AudioInternal, options?: AudioSourceOptions);
+    constructor(path: string, audioRef: Audio, options?: AudioSourceOptions);
     isReady(): boolean;
     play(): void;
     stop(): void;
@@ -42,7 +43,15 @@ export declare class AudioSource {
     getVolume(): number;
     getDuration(): number;
 }
-export declare class AudioInternal {
+/**
+ * The audio subsystem.
+ *
+ * Manages a handful of AudioSource objects, for things like global volume,
+ * global play/pause, etc..
+ *
+ * To make a new source, use `like.audio.newSource`.
+ */
+export declare class Audio {
     private sources;
     private globalVolume;
     /**

package/dist/audio/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/audio/audio.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAA;AAMD;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6IAA6I;IAC7I,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC/C,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,SAAS,CAAoE;IACrF,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,GAAE,kBAAuB;IAmC3E,OAAO,IAAI,OAAO;IAIlB,IAAI,IAAI,IAAI;IAUZ,IAAI,IAAI,IAAI;IAUZ,KAAK,IAAI,IAAI;IAQb,MAAM,IAAI,IAAI;IAYd,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQ5B,IAAI,IAAI,MAAM;IAKd,SAAS,IAAI,OAAO;IAKpB,QAAQ,IAAI,OAAO;IAKnB,SAAS,IAAI,OAAO;IAKpB,+FAA+F;IAC/F,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,SAAS,IAAI,MAAM;IAInB,WAAW,IAAI,MAAM;CAItB;AAED;;;;;;;GAOG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,YAAY,CAAK;IAEzB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW;IAMlE;;;QAGI;IACJ,aAAa,IAAI,WAAW,EAAE;IAS9B,OAAO,IAAI,IAAI;IAIf,QAAQ,IAAI,IAAI;IAIhB,SAAS,IAAI,IAAI;IAIjB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO/B,SAAS,IAAI,MAAM;IAInB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW;CAGxC"}

package/dist/{core → audio}/audio.js

@@ -5,7 +5,6 @@
  *
  * ## Track and give global control to all audio objects
  * Start, stop, or set global volume for every currently playing sound.
- *
  */
 /**
  * Handle to a loaded audio resource, which pretends to be synchronous.
@@ -29,6 +28,7 @@ export class AudioSource {
             writable: true,
             value: void 0
         });
+        /** Avoid setting these directly. */
         Object.defineProperty(this, "options", {
             enumerable: true,
             configurable: true,
@@ -169,7 +169,15 @@ export class AudioSource {
         return 0;
     }
 }
-export class AudioInternal {
+/**
+ * The audio subsystem.
+ *
+ * Manages a handful of AudioSource objects, for things like global volume,
+ * global play/pause, etc..
+ *
+ * To make a new source, use `like.audio.newSource`.
+ */
+export class Audio {
     constructor() {
         Object.defineProperty(this, "sources", {
             enumerable: true,

package/dist/audio/index.d.ts

@@ -0,0 +1,2 @@
+export type { AudioSource, Audio, AudioSourceOptions } from "./audio";
+//# sourceMappingURL=index.d.ts.map

package/dist/audio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,kBAAkB,EAAC,MAAM,SAAS,CAAA"}

package/dist/audio/index.js

@@ -0,0 +1 @@
+export {};

package/dist/engine.d.ts

@@ -1,69 +1,39 @@
 /**
  * @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"];
+import type { EventType, EventMap, Dispatcher } from './events';
+import type { Like } from './like';
+export type EngineDispatcher = Dispatcher<EventType>;
+export type EngineProps<T extends keyof EventMap> = {
+    canvas: HTMLCanvasElement;
+    abort: AbortSignal;
+    dispatch: Dispatcher<T>;
+};
 /**
+ * @private
  * 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;
+    /** The canvas on which we bind all events. Not always the same canvas
+     * that we render to. */
     private canvas;
     private isRunning;
     private lastTime;
     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;
+    readonly like: Like;
     constructor(container: HTMLElement);
     private dispatch;
     /**
      * 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;
 }

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EAAa,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAInC,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;AACrD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,QAAQ,IAAI;IAClD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CACzB,CAAA;AAED;;;GAGG;AACH,qBAAa,MAAM;IAaL,OAAO,CAAC,SAAS;IAZ7B;4BACwB;IACxB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,KAAK,CAAyB;IAEtC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;gBAEA,SAAS,EAAE,WAAW;IAuD1C,OAAO,CAAC,QAAQ;IAShB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}

package/dist/engine.js

@@ -1,40 +1,19 @@
 /**
  * @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 { AudioInternal } from './core/audio';
-import { InputInternal } from './core/input';
-import { TimerInternal } from './core/timer';
-import { KeyboardInternal } from './core/keyboard';
-import { MouseInternal } from './core/mouse';
-import { GamepadInternal } from './core/gamepad';
-import { bindGraphics } from './core/graphics';
-import { CanvasInternal } from './core/canvas';
+import { Audio } from './audio/audio';
+import { Input } from './input/input';
+import { Timer } from './timer/timer';
+import { Keyboard } from './input/keyboard';
+import { Mouse } from './input/mouse';
+import { Gamepad } from './input/gamepad';
+import { bindGraphics } from './graphics/index';
+import { Canvas } from './graphics/canvas';
 import { sceneDispatch } from './scene';
 /**
+ * @private
  * 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 class Engine {
     constructor(container) {
@@ -44,6 +23,8 @@ export class Engine {
             writable: true,
             value: container
         });
+        /** The canvas on which we bind all events. Not always the same canvas
+         * that we render to. */
         Object.defineProperty(this, "canvas", {
             enumerable: true,
             configurable: true,
@@ -70,7 +51,6 @@ export class Engine {
         });
         /**
          * The Like interface providing access to all engine subsystems.
-         * This object is passed to all scene callbacks and game code.
          */
         Object.defineProperty(this, "like", {
             enumerable: true,
@@ -78,22 +58,26 @@ export class Engine {
             writable: true,
             value: void 0
         });
-        this.canvas = new CanvasInternal(this.dispatch.bind(this));
-        const canvas = this.canvas._displayCanvas;
-        canvas.addEventListener("like:updateRenderTarget", (event) => {
+        this.canvas = document.createElement('canvas');
+        const canvas = new Canvas(this.canvas, this.dispatch.bind(this), this.abort.signal);
+        this.canvas.addEventListener("like:updateRenderTarget", (event) => {
             if (!(event instanceof CustomEvent))
                 return;
             this.like.gfx = bindGraphics(event.detail.target.getContext('2d'));
         });
-        this.container.appendChild(canvas);
-        let gfx = bindGraphics(canvas.getContext('2d'));
-        const dispatch = this.dispatch.bind(this);
-        const audio = new AudioInternal();
-        const timer = new TimerInternal();
-        const keyboard = new KeyboardInternal(canvas, dispatch);
-        const mouse = new MouseInternal(canvas, dispatch);
-        const gamepad = new GamepadInternal(dispatch);
-        const input = new InputInternal({ keyboard, mouse, gamepad });
+        this.container.appendChild(this.canvas);
+        let gfx = bindGraphics(this.canvas.getContext('2d'));
+        const props = {
+            canvas: this.canvas,
+            dispatch: this.dispatch.bind(this),
+            abort: this.abort.signal,
+        };
+        const audio = new Audio();
+        const timer = new Timer(props);
+        const keyboard = new Keyboard(props);
+        const mouse = new Mouse(props);
+        const gamepad = new Gamepad(props);
+        const input = new Input(props.dispatch, { keyboard, mouse, gamepad });
         this.like = {
             audio,
             timer,
@@ -102,13 +86,14 @@ export class Engine {
             mouse,
             gamepad,
             gfx,
-            canvas: this.canvas,
+            canvas,
             start: this.start.bind(this),
             dispose: this.dispose.bind(this),
             setScene: (scene) => {
                 if (scene) {
                     this.like.handleEvent = (event) => sceneDispatch(scene, this.like, event);
-                    this.dispatch("load", []);
+                    if (this.isRunning)
+                        this.dispatch("load", []);
                 }
                 else {
                     this.like.handleEvent = undefined;
@@ -121,8 +106,7 @@ export class Engine {
         };
         window.addEventListener('focus', () => this.dispatch('focus', ['tab']));
         window.addEventListener('blur', () => this.dispatch('blur', ['tab']));
-        canvas.addEventListener('focus', () => this.dispatch('focus', ['canvas']));
-        canvas.addEventListener('focus', () => this.dispatch('focus', ['canvas']));
+        this.canvas.addEventListener('focus', () => this.dispatch('focus', ['canvas']));
     }
     dispatch(type, args) {
         const event = { type, args, timestamp: this.like.timer.getTime() };
@@ -135,13 +119,6 @@ export class Engine {
     }
     /**
      * 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.
      */
     async start() {
         this.isRunning = true;
@@ -153,14 +130,12 @@ export class Engine {
             const dt = (now - this.lastTime) / 1000;
             this.lastTime = now;
             if (!this.like.timer.isSleeping()) {
-                this.like.timer._update(dt);
-                const { pressed, released } = this.like.input._update();
-                pressed.forEach(action => this.dispatch('actionpressed', [action]));
-                released.forEach(action => this.dispatch('actionreleased', [action]));
+                this.canvas.dispatchEvent(new CustomEvent("update", { detail: { dt } }));
                 this.dispatch('update', [dt]);
             }
+            this.canvas.dispatchEvent(new CustomEvent("like:preDraw"));
             this.dispatch('draw', []);
-            this.canvas._present();
+            this.canvas.dispatchEvent(new CustomEvent("like:postDraw"));
             requestAnimationFrame(loop);
         };
         this.dispatch('load', []);
@@ -168,26 +143,9 @@ export class Engine {
     }
     /**
      * 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() {
-        const canvas = this.canvas._displayCanvas;
         this.isRunning = false;
-        this.like.keyboard._dispose();
-        this.like.mouse._dispose();
-        this.like.gamepad._dispose();
-        this.canvas._dispose();
         this.abort.abort();
-        if (canvas.parentNode === this.container) {
-            this.container.removeChild(canvas);
-        }
     }
 }

package/dist/{core/events.d.ts → events.d.ts}

@@ -1,57 +1,31 @@
 /**
  * @module events
  * @description All events that flow through the engine.
- *
- * ## Overview
- *
- * LIKE uses events at its core.
- * These pass through the engine and down to your
- * callbacks or scene.
- *
- * This module is the single source of truth for what
- * events are possible.
- *
- * Use it as a reference.
- *
- * @see {@link EventMap} lists every event.
- * @see {@link Scene} for implementing callbacks in a class
- * @see {@link Like} for global callback assignment
- * @see {@link Input} for action mapping
  */
-import type { Vector2 } from '../math/vector2';
-import { LikeButton } from './gamepad-mapping';
+import type { Vector2 } from './math/vector2';
+import type { LikeButton } from './input';
 export type MouseButton = 'left' | 'middle' | 'right';
 declare global {
     interface HTMLElementEventMap {
         ['like:mousemoved']: CustomEvent<{
             pos: Vector2;
             delta: Vector2;
-            renderSize: Vector2;
         }>;
         ['like:updateRenderTarget']: CustomEvent<{
             target: HTMLCanvasElement;
         }>;
+        ['like:resizeCanvas']: CustomEvent<{
+            size: Vector2;
+        }>;
+        ['like:preDraw']: CustomEvent<{}>;
+        ['like:postDraw']: CustomEvent<{}>;
+        ['like:update']: CustomEvent<{
+            dt: number;
+        }>;
     }
 }
 /**
  * The master type will all events on it.
- *
- * Each frame:
- * 1. `update(dt)` - Game logic with delta time in seconds
- * 2. `draw` - Render the frame
- *
- * Input events fire immediately when they occur:
- * - `keypressed`/`keyreleased` - Keyboard input
- * - `mousemoved`/`mousepressed`/`mousereleased` - Mouse input
- * - `gamepadpressed`/`gamepadreleased` - Controller input
- * - `actionpressed`/`actionreleased` - Mapped actions (see {@link Input})
- *
- * Window events:
- * - `focus`/`blur` - Tab/window focus changes
- * - `resize` - Canvas size changes
- *
- * Lifecycle:
- * - `load` - Called once when the game starts
  */
 export type EventMap = {
     /** Game initialization. Called once before the first frame. */
@@ -76,28 +50,31 @@ export type EventMap = {
     mousepressed: [pos: Vector2, button: MouseButton];
     /** Mouse button released. */
     mousereleased: [pos: Vector2, button: MouseButton];
-    /** Gamepad button pressed. index is controller number (0-3). */
-    gamepadpressed: [source: number, num: number, name: LikeButton];
-    /** Gamepad button released. */
-    gamepadreleased: [source: number, num: number, name: LikeButton];
+    /** Gamepad button pressed. `source` is controller index, `name` is derived from a mapping on the raw `num` */
+    gamepadpressed: [source: number, name: LikeButton, num: number];
+    /** Gamepad button released. `source` is controller index, `name` is derived from a mapping on the raw `num` */
+    gamepadreleased: [source: number, name: LikeButton, num: number];
+    /**
+     * Fires when a gamepad is connected.
+     */
+    gamepadconnected: [index: number];
+    /** Fires when a gamepad is disconnected. */
+    gamepaddisconnected: [index: number];
     /** Mapped action triggered. See {@link Input} for action mapping. */
     actionpressed: [action: string];
     /** Mapped action released. */
     actionreleased: [action: string];
 };
 export type EventType = keyof EventMap;
+export type LikeMouseEvent = 'mousemoved' | 'mousepressed' | 'mousereleased';
+export type LikeKeyboardEvent = 'keypressed' | 'keyreleased';
+export type LikeGamepadEvent = 'gamepadpressed' | 'gamepadreleased' | 'gamepadconnected' | 'gamepaddisconnected';
+/**
+ * Generic dispatcher - each module defines its own event subset
+ */
+export type Dispatcher<T extends EventType> = <K extends T>(type: K, args: EventMap[K]) => void;
 /**
  * Discriminated union of all event objects.
- * Use this with `handleEvent` to receive all events generically.
- *
- * @example
- * ```typescript
- * handleEvent(like: Like, event: Like2DEvent) {
- *   if (event.type === 'update') {
- *     const dt = event.args[0];
- *   }
- * }
- * ```
  */
 export type LikeEvent = {
     [K in EventType]: {

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,mBAAmB;QAC3B,CAAC,iBAAiB,CAAC,EAAE,WAAW,CAAC;YAAC,GAAG,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,OAAO,CAAA;SAAC,CAAC,CAAC;QACjE,CAAC,yBAAyB,CAAC,EAAE,WAAW,CAAC;YAAC,MAAM,EAAE,iBAAiB,CAAA;SAAC,CAAC,CAAC;QACtE,CAAC,mBAAmB,CAAC,EAAE,WAAW,CAAC;YAAC,IAAI,EAAE,OAAO,CAAA;SAAC,CAAC,CAAC;QACpD,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC,eAAe,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAC,CAAC,CAAC;KAC5C;CACF;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,+DAA+D;IAC/D,IAAI,EAAE,EAAE,CAAC;IAET,yEAAyE;IACzE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAErB,8DAA8D;IAC9D,IAAI,EAAE,EAAE,CAAC;IAET,sFAAsF;IACtF,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAExB,oFAAoF;IACpF,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAEhD,6BAA6B;IAC7B,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAEjD,iEAAiE;IACjE,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC;IAElC,8DAA8D;IAC9D,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC;IAEjC,iEAAiE;IACjE,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAE3C,qFAAqF;IACrF,YAAY,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAElD,6BAA6B;IAC7B,aAAa,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAEnD,8GAA8G;IAC9G,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAEhE,+GAA+G;IAC/G,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAEjE;;OAEG;IACH,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAElC,4CAA4C;IAC5C,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAErC,qEAAqE;IACrE,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC,8BAA8B;IAC9B,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC;AAEvC,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,cAAc,GAAG,eAAe,CAAC;AAC7E,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,aAAa,CAAC;AAC7D,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,qBAAqB,CAAC;AAEjH;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC,EACxD,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KACd,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;KACrB,CAAC,IAAI,SAAS,GAAG;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CACpE,CAAC,SAAS,CAAC,CAAC"}