like2d 1.0.0 → 2.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Samuel Pagenkopf
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -1,66 +1,90 @@
-# LÏKE2D Framework Library
+# LÏKE2D
 
-You've reached the more detailed docs for this framework.
-For now, the source code is the best API docs we have. 
+A web-native 2D game framework inspired by [LÖVE](https://love2d.org/), built for simplicity and the modern web.
 
-## Features of LIKE
+## What it is
 
-**Stateless Canvas API**
+Like2D is a thin, performant wrapper around the browser's Canvas and Web Audio APIs. It provides:
+- **Stateless Graphics:** No more `ctx.save()` and `ctx.restore()` for colors and transforms.
+- **Fire-and-forget Assets:** Synchronous handles for images and audio that load in the background.
+- **Unified Input:** Normalized keyboard, mouse, and gamepad support with action mapping.
+- **Scaling Modes:** Built-in support for "fixed" resolution with pixel-perfect stretching.
+- **Flexible Patterns:** Use Love2D-style global callbacks or class-based scenes.
 
-JS canvas has state to keep track of like color and line width.
-LIKE abstracts that away so it's easy to reason about.
+## Installation
 
-**Fire-and-forget asset loading**
+```bash
+npm install like2d
+# or
+pnpm add like2d
+```
 
-Loading sound and images in Vanilla JS is clunky and can interrupt your game loop.
-LIKE has synchronous asset handles and abstracts away the clunkiness.
+## Quick Start
 
-**Zero boilerplate, physical game input**
+### Callback Pattern (Love2D-style)
 
-LIKE does the input boilerplate for you.
- - Keeping track of what's held/pressed.
- - Controller mapping by physical location. Not every A is in the same spot.
- - Mapping inputs into actions for easy remapping.
+Ideal for small games, jams, or prototyping.
 
-**Declarative event system**
+```typescript
+import { love, graphics, input } from 'like2d/callback';
 
-Don't bother juggling stateful listeners.
-LIKE keeps event handling simple by running it all through a single callback.
+love.load = () => {
+  love.setScaling({ mode: 'fixed', size: [800, 600] });
+  input.map('jump', ['Space', 'ButtonBottom']);
+};
 
-**Build it how you want it**
+love.update = (dt) => {
+  if (input.justPressed('jump')) {
+    console.log('Jump!');
+  }
+};
 
-It's not an engine, it's a framework.
-For new developers, this means making simple games easily: no engine, no problem!
-For others, get to work faster making your own specialized tooling, engine, and more,
-all without banging your head on browser APIs.
+love.draw = () => {
+  graphics.clear([0.1, 0.1, 0.1, 1]);
+  graphics.circle('fill', 'dodgerblue', [400, 300], 50);
+  graphics.print('white', 'Hello Like2D!', [20, 20]);
+};
 
-## Getting started
+love.init(document.body);
+```
 
-TODO: fill this in.
+### Scene Pattern (Class-based)
 
-Then run:
-```bash
-pnpm install
-pnpm run dev
-```
+Ideal for larger projects with menus, levels, and explicit state management.
 
-## For LOVE developers
+```typescript
+import { SceneRunner, type Scene, Vec2 } from 'like2d/scene';
 
-LIKE is not compatible with LOVE.
+class MyScene implements Scene {
+  load() {
+    console.log('Scene loaded!');
+  }
+
+  update(dt: number) {
+    // update logic
+  }
+
+  draw(canvas: HTMLCanvasElement) {
+    // draw logic
+  }
+}
+
+const runner = new SceneRunner(document.body);
+await runner.start(new MyScene());
+```
 
-To summarize the differences:
- - We don't keep track of color etc. as state (via setColor, etc.), so it gets passed in each draw call.
- - We use objects for optional arguments, and avoid function overloading.
- - We make use of tuples for passing around colors, coordinates, and rects.
- - In LOVE, Callbacks such as `love.keypressed` needed to be wrapped in order to make Scenes. This pattern is part of LIKE.
- - 2d Canvas so, no shaders.
- - No built-in physics.
+## API Overview
 
-## Full Disclosure about AI
+Like2D exports pure library functions for math and geometry that work with native arrays.
 
-Yes, this framework was created with the help of heavily supervised AI.
+- **Vec2:** Vector operations using `[number, number]` tuples.
+- **Rect:** Rectangle operations using `[x, y, w, h]` tuples.
+- **Graphics:** Stateless drawing commands.
+- **Audio:** Simple source/playback management.
+- **Input:** Action-based input mapping.
 
-Virtually every design decision was made by me, and I have micro-managed the code output.
+See the [PHILOSOPHY.md](./docs/PHILOSOPHY.md) for the principles behind the design.
 
-Over time, I will rewrite parts of it by hand as desired. Possibly the whole thing.
+## License
 
+MIT

package/dist/adapters/callback/index.d.ts

@@ -0,0 +1,43 @@
+import { Graphics } from '../../core/graphics';
+import { Audio } from '../../core/audio';
+import { Input } from '../../core/input';
+import { Timer } from '../../core/timer';
+import { Keyboard } from '../../core/keyboard';
+import { Mouse } from '../../core/mouse';
+import { Gamepad } from '../../core/gamepad';
+import type { CanvasConfig } from '../../core/canvas-config';
+import type { Like2DEvent } from '../../core/events';
+import type { Vector2 } from '../../core/vector2';
+export { ImageHandle } from '../../core/graphics';
+export { getGPName, GP } from '../../core/gamepad';
+export { Vec2 } from '../../core/vector2';
+export { Rect } from '../../core/rect';
+export { calcFixedScale } from '../../core/canvas-config';
+export declare let graphics: Graphics;
+export declare const audio: Audio;
+export declare const timer: Timer;
+export declare let keyboard: Keyboard;
+export declare let mouse: Mouse;
+export declare let gamepad: Gamepad;
+export declare let input: Input;
+export declare const like: {
+    load: (() => void) | undefined;
+    update: ((dt: number) => void) | undefined;
+    draw: ((canvas: HTMLCanvasElement) => void) | undefined;
+    resize: ((size: Vector2, pixelSize: Vector2, fullscreen: boolean) => void) | undefined;
+    keypressed: ((scancode: string, keycode: string) => void) | undefined;
+    keyreleased: ((scancode: string, keycode: string) => void) | undefined;
+    mousepressed: ((x: number, y: number, button: number) => void) | undefined;
+    mousereleased: ((x: number, y: number, button: number) => void) | undefined;
+    gamepadpressed: ((i: number, b: number, n: string) => void) | undefined;
+    gamepadreleased: ((i: number, b: number, n: string) => void) | undefined;
+    actionpressed: ((action: string) => void) | undefined;
+    actionreleased: ((action: string) => void) | undefined;
+    handleEvent: ((event: Like2DEvent) => void) | undefined;
+    toggleFullscreen(): void;
+    setScaling(config: CanvasConfig): void;
+    init(container: HTMLElement): Promise<void>;
+    dispose(): void;
+};
+export { like as love };
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/callback/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/callback/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,eAAO,IAAI,QAAQ,EAAE,QAAQ,CAAC;AAC9B,eAAO,MAAM,KAAK,OAAc,CAAC;AACjC,eAAO,MAAM,KAAK,OAAc,CAAC;AACjC,eAAO,IAAI,QAAQ,EAAE,QAAQ,CAAC;AAC9B,eAAO,IAAI,KAAK,EAAE,KAAK,CAAC;AACxB,eAAO,IAAI,OAAO,EAAE,OAAO,CAAC;AAC5B,eAAO,IAAI,KAAK,EAAE,KAAK,CAAC;AAIxB,eAAO,MAAM,IAAI;UACI,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS;YACtB,CAAC,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS;UACpC,CAAC,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC,GAAG,SAAS;YAC/C,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS;gBAC1E,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS;iBACxD,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS;kBACxD,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS;mBAC3D,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS;oBAC3D,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS;qBACtD,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS;mBACzD,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS;oBACrC,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS;iBACzC,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,SAAS;wBAEhD,IAAI;uBAIL,YAAY,GAAG,IAAI;oBAIhB,WAAW;eAyBtB,IAAI;CAkBhB,CAAC;AAEF,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC"}

package/dist/adapters/callback/index.js

@@ -0,0 +1,80 @@
+import { Graphics } from '../../core/graphics';
+import { Audio } from '../../core/audio';
+import { Input } from '../../core/input';
+import { Timer } from '../../core/timer';
+import { Keyboard } from '../../core/keyboard';
+import { Mouse } from '../../core/mouse';
+import { Gamepad } from '../../core/gamepad';
+import { Engine } from '../../engine';
+export { ImageHandle } from '../../core/graphics';
+export { getGPName, GP } from '../../core/gamepad';
+export { Vec2 } from '../../core/vector2';
+export { Rect } from '../../core/rect';
+export { calcFixedScale } from '../../core/canvas-config';
+export let graphics;
+export const audio = new Audio();
+export const timer = new Timer();
+export let keyboard;
+export let mouse;
+export let gamepad;
+export let input;
+let engine = null;
+export const like = {
+    load: undefined,
+    update: undefined,
+    draw: undefined,
+    resize: undefined,
+    keypressed: undefined,
+    keyreleased: undefined,
+    mousepressed: undefined,
+    mousereleased: undefined,
+    gamepadpressed: undefined,
+    gamepadreleased: undefined,
+    actionpressed: undefined,
+    actionreleased: undefined,
+    handleEvent: undefined,
+    toggleFullscreen() {
+        engine?.toggleFullscreen();
+    },
+    setScaling(config) {
+        engine?.setScaling(config);
+    },
+    async init(container) {
+        engine = new Engine(container);
+        graphics = new Graphics(engine.getContext());
+        keyboard = new Keyboard();
+        mouse = new Mouse((cssX, cssY) => engine.transformMousePosition(cssX, cssY));
+        gamepad = new Gamepad();
+        input = new Input({ keyboard, mouse, gamepad });
+        engine.setDeps({ graphics, input, timer, audio, keyboard, mouse, gamepad });
+        await gamepad.init();
+        engine.start((event) => {
+            // 1. handleEvent first
+            like.handleEvent?.(event);
+            // 2. Direct handlers
+            const handler = like[event.type];
+            if (handler) {
+                handler(...event.args);
+            }
+        });
+    },
+    dispose() {
+        engine?.stop();
+        engine?.dispose();
+        engine = null;
+        this.load = undefined;
+        this.update = undefined;
+        this.draw = undefined;
+        this.resize = undefined;
+        this.keypressed = undefined;
+        this.keyreleased = undefined;
+        this.mousepressed = undefined;
+        this.mousereleased = undefined;
+        this.gamepadpressed = undefined;
+        this.gamepadreleased = undefined;
+        this.actionpressed = undefined;
+        this.actionreleased = undefined;
+        this.handleEvent = undefined;
+    }
+};
+export { like as love };

package/dist/adapters/scene/index.d.ts

@@ -0,0 +1,42 @@
+import { Graphics } from '../../core/graphics';
+import { Audio } from '../../core/audio';
+import { Input } from '../../core/input';
+import { Timer } from '../../core/timer';
+import { Keyboard } from '../../core/keyboard';
+import { Mouse } from '../../core/mouse';
+import { Gamepad } from '../../core/gamepad';
+import type { Scene } from './scene';
+import type { CanvasConfig } from '../../core/canvas-config';
+import { StartupScene } from './startup-scene';
+export { Graphics, ImageHandle } from '../../core/graphics';
+export { StartupScene };
+export { Audio } from '../../core/audio';
+export { Input } from '../../core/input';
+export { Timer } from '../../core/timer';
+export { Keyboard } from '../../core/keyboard';
+export { Mouse } from '../../core/mouse';
+export { Gamepad, getGPName, GP } from '../../core/gamepad';
+export type { Like2DEvent as Event } from '../../core/events';
+export type { Scene } from './scene';
+export type { Vector2 } from '../../core/vector2';
+export { Vec2 } from '../../core/vector2';
+export { Rect } from '../../core/rect';
+export type { CanvasConfig } from '../../core/canvas-config';
+export { calcFixedScale } from '../../core/canvas-config';
+export declare class SceneRunner {
+    private engine;
+    private scene;
+    readonly graphics: Graphics;
+    readonly audio: Audio;
+    readonly timer: Timer;
+    readonly input: Input;
+    readonly keyboard: Keyboard;
+    readonly mouse: Mouse;
+    readonly gamepad: Gamepad;
+    constructor(container: HTMLElement);
+    setScaling(config: CanvasConfig): void;
+    setScene(scene: Scene): void;
+    start(scene: Scene): Promise<void>;
+    dispose(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/scene/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/scene/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EAAE,WAAW,IAAI,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAsB;IAEnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAEd,SAAS,EAAE,WAAW;IAWlC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAItC,QAAQ,CAAC,KAAK,EAAE,KAAK;IAKf,KAAK,CAAC,KAAK,EAAE,KAAK;IAiBxB,OAAO,IAAI,IAAI;CAKhB"}

package/dist/adapters/scene/index.js

@@ -0,0 +1,112 @@
+import { Graphics } from '../../core/graphics';
+import { Audio } from '../../core/audio';
+import { Input } from '../../core/input';
+import { Timer } from '../../core/timer';
+import { Keyboard } from '../../core/keyboard';
+import { Mouse } from '../../core/mouse';
+import { Gamepad } from '../../core/gamepad';
+import { Engine } from '../../engine';
+import { StartupScene } from './startup-scene';
+export { Graphics, ImageHandle } from '../../core/graphics';
+export { StartupScene };
+export { Audio } from '../../core/audio';
+export { Input } from '../../core/input';
+export { Timer } from '../../core/timer';
+export { Keyboard } from '../../core/keyboard';
+export { Mouse } from '../../core/mouse';
+export { Gamepad, getGPName, GP } from '../../core/gamepad';
+export { Vec2 } from '../../core/vector2';
+export { Rect } from '../../core/rect';
+export { calcFixedScale } from '../../core/canvas-config';
+export class SceneRunner {
+    constructor(container) {
+        Object.defineProperty(this, "engine", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "scene", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "graphics", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "audio", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "timer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "input", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "keyboard", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "mouse", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "gamepad", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.engine = new Engine(container);
+        this.graphics = new Graphics(this.engine.getContext());
+        this.keyboard = new Keyboard();
+        this.mouse = new Mouse((cssX, cssY) => this.engine.transformMousePosition(cssX, cssY));
+        this.gamepad = new Gamepad();
+        this.input = new Input({ keyboard: this.keyboard, mouse: this.mouse, gamepad: this.gamepad });
+        this.timer = new Timer();
+        this.audio = new Audio();
+    }
+    setScaling(config) {
+        this.engine.setScaling(config);
+    }
+    setScene(scene) {
+        this.scene = scene;
+        this.scene.load?.();
+    }
+    async start(scene) {
+        this.setScene(scene);
+        this.engine.setDeps({ graphics: this.graphics, input: this.input, timer: this.timer, audio: this.audio, keyboard: this.keyboard, mouse: this.mouse, gamepad: this.gamepad });
+        await this.gamepad.init();
+        this.engine.start((event) => {
+            // 1. handleEvent runs first
+            this.scene?.handleEvent?.(event);
+            // 2. Direct handlers
+            const handler = this.scene?.[event.type];
+            if (handler) {
+                handler.apply(this.scene, event.args);
+            }
+        });
+    }
+    dispose() {
+        this.engine.stop();
+        this.engine.dispose();
+        this.scene = null;
+    }
+}

package/dist/adapters/scene/scene.d.ts

@@ -0,0 +1,18 @@
+import type { Vector2 } from '../../core/vector2';
+import type { Like2DEvent } from '../../core/events';
+export type Scene = {
+    load?(): void;
+    update?(dt: number): void;
+    draw?(canvas: HTMLCanvasElement): void;
+    resize?(size: Vector2, pixelSize: Vector2, fullscreen: boolean): void;
+    keypressed?(scancode: string, keycode: string): void;
+    keyreleased?(scancode: string, keycode: string): void;
+    mousepressed?(x: number, y: number, button: number): void;
+    mousereleased?(x: number, y: number, button: number): void;
+    gamepadpressed?(gamepadIndex: number, buttonIndex: number, buttonName: string): void;
+    gamepadreleased?(gamepadIndex: number, buttonIndex: number, buttonName: string): void;
+    actionpressed?(action: string): void;
+    actionreleased?(action: string): void;
+    handleEvent?(event: Like2DEvent): void;
+};
+//# sourceMappingURL=scene.d.ts.map

package/dist/adapters/scene/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/adapters/scene/scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,CAAC,IAAI,IAAI,CAAC;IACd,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvC,MAAM,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IACtE,UAAU,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,WAAW,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3D,cAAc,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACrF,eAAe,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACtF,aAAa,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,cAAc,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,WAAW,CAAC,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CACxC,CAAC"}

package/dist/adapters/scene/startup-scene.d.ts

@@ -0,0 +1,17 @@
+import type { Like2DEvent } from '../../core/events';
+import type { Scene } from './scene';
+import type { Graphics } from '../../core/graphics';
+export type StartupSceneConfig = {
+    nextScene: Scene;
+    draw?: (g: Graphics, canvas: HTMLCanvasElement) => void;
+};
+export declare class StartupScene implements Scene {
+    private graphics;
+    private config;
+    private onStart;
+    private started;
+    constructor(graphics: Graphics, config: StartupSceneConfig, onStart: () => void);
+    draw(canvas: HTMLCanvasElement): void;
+    handleEvent(event: Like2DEvent): void;
+}
+//# sourceMappingURL=startup-scene.d.ts.map

package/dist/adapters/scene/startup-scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-scene.d.ts","sourceRoot":"","sources":["../../../src/adapters/scene/startup-scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,KAAK,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACzD,CAAC;AAMF,qBAAa,YAAa,YAAW,KAAK;IAItC,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IALjB,OAAO,CAAC,OAAO,CAAS;gBAGd,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,MAAM,IAAI;IAK7B,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAIrC,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;CAMtC"}

package/dist/adapters/scene/startup-scene.js

@@ -0,0 +1,41 @@
+function defaultDraw(g, canvas) {
+    g.print('white', 'Click to Start', [canvas.width / 2, canvas.height / 2], { align: 'center' });
+}
+export class StartupScene {
+    constructor(graphics, config, onStart) {
+        Object.defineProperty(this, "graphics", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: graphics
+        });
+        Object.defineProperty(this, "config", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: config
+        });
+        Object.defineProperty(this, "onStart", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: onStart
+        });
+        Object.defineProperty(this, "started", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        this.graphics.setBackgroundColor('black');
+    }
+    draw(canvas) {
+        (this.config.draw ?? defaultDraw)(this.graphics, canvas);
+    }
+    handleEvent(event) {
+        if (event.type === 'mousepressed' && !this.started) {
+            this.started = true;
+            this.onStart();
+        }
+    }
+}

package/dist/core/audio.d.ts

@@ -0,0 +1,61 @@
+/** The audio module performs a few things:
+ *
+ * ## Make audio resources behave as if synchronous
+ * Functions like playback and seeking are deferred until the sound is loaded.
+ *
+ * ## Track and give global control to all audio objects
+ * Start, stop, or set global volume for every currently playing sound.
+ *
+ */
+export type SourceOptions = {
+    volume?: number;
+};
+/**
+ * Handle to a loaded audio resource.
+ * Use `play()`, `stop()`, `pause()`, `resume()` for playback control.
+ * Access the underlying HTMLAudioElement via `source.audio` for looping,
+ * pitch, etc. Note: Use `source.setVolume()` instead of setting
+ * `source.audio.volume` directly to ensure global volume scaling works correctly.
+ */
+export declare class Source {
+    readonly path: string;
+    /** Underlying HTMLAudioElement. Modify directly for looping, pitch, etc. Use methods for playback control. Avoid setting volume directly. */
+    readonly audio: HTMLAudioElement;
+    readonly options: Required<SourceOptions>;
+    /** Resolves when the audio is loaded and ready to play. */
+    readonly ready: Promise<void>;
+    private loadState;
+    private audioRef;
+    constructor(path: string, audioRef: Audio, options?: SourceOptions);
+    isReady(): boolean;
+    play(): void;
+    stop(): void;
+    pause(): void;
+    resume(): void;
+    seek(position: number): void;
+    tell(): number;
+    isPlaying(): boolean;
+    isPaused(): boolean;
+    isStopped(): boolean;
+    /** Set volume (0-1). Applies global volume scaling. Prefer this over `source.audio.volume`. */
+    setVolume(volume: number): void;
+    getVolume(): number;
+    getDuration(): number;
+}
+export declare class Audio {
+    private sources;
+    private globalVolume;
+    newSource(path: string, options?: SourceOptions): Source;
+    /** Get all audio sources -- note that sources are tracked
+      * using weak references, and storing this list can cause
+      * a memory leak.
+      */
+    private getAllSources;
+    stopAll(): void;
+    pauseAll(): void;
+    resumeAll(): void;
+    setVolume(volume: number): void;
+    getVolume(): number;
+    clone(source: Source): Source;
+}
+//# sourceMappingURL=audio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/core/audio.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAA;AAMD;;;;;;GAMG;AACH,qBAAa,MAAM;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6IAA6I;IAC7I,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC1C,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,aAAkB;IAmCtE,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,qBAAa,KAAK;IAChB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,YAAY,CAAK;IAEzB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAMxD;;;QAGI;IACJ,OAAO,CAAC,aAAa;IASrB,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,MAAM,GAAG,MAAM;CAG9B"}