like2d 1.0.0 → 2.0.1

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"}

package/dist/core/audio.js

@@ -0,0 +1,226 @@
+/** 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.
+ *
+ */
+/**
+ * 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 class Source {
+    constructor(path, audioRef, options = {}) {
+        Object.defineProperty(this, "path", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** Underlying HTMLAudioElement. Modify directly for looping, pitch, etc. Use methods for playback control. Avoid setting volume directly. */
+        Object.defineProperty(this, "audio", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "options", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** Resolves when the audio is loaded and ready to play. */
+        Object.defineProperty(this, "ready", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "loadState", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: { loaded: false, pendingPlay: false, pendingSeek: 0 }
+        });
+        Object.defineProperty(this, "audioRef", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.path = path;
+        this.audioRef = audioRef;
+        this.audio = document.createElement('audio');
+        this.audio.src = path;
+        this.options = {
+            volume: Math.max(0, Math.min(1, options.volume ?? 1))
+        };
+        this.audio.volume = this.options.volume * audioRef.getVolume();
+        this.ready = new Promise((resolve, reject) => {
+            this.audio.oncanplaythrough = () => {
+                if (this.loadState.loaded)
+                    return;
+                const { pendingPlay, pendingSeek } = this.loadState;
+                this.loadState = { loaded: true };
+                this.audio.currentTime = pendingSeek;
+                if (pendingPlay) {
+                    this.audio.play()?.catch(() => {
+                        // Play failed (autoplay policy) - reset so user can retry
+                    });
+                }
+                resolve();
+            };
+            this.audio.onerror = () => reject(new Error(`Failed to load audio: ${path}`));
+            // Handle audio that is already loaded (cached) when we attach the listener
+            if (this.audio.readyState >= 3) {
+                this.loadState = { loaded: true };
+                resolve();
+            }
+        });
+    }
+    isReady() {
+        return this.loadState.loaded;
+    }
+    play() {
+        if (this.loadState.loaded) {
+            this.audio.play()?.catch(() => {
+                // Play failed (autoplay policy) - ignore
+            });
+        }
+        else {
+            this.loadState.pendingPlay = true;
+        }
+    }
+    stop() {
+        if (this.loadState.loaded) {
+            this.audio.pause();
+            this.audio.currentTime = 0;
+        }
+        else {
+            this.loadState.pendingPlay = false;
+            this.loadState.pendingSeek = 0;
+        }
+    }
+    pause() {
+        if (this.loadState.loaded) {
+            this.audio.pause();
+        }
+        else {
+            this.loadState.pendingPlay = false;
+        }
+    }
+    resume() {
+        if (this.loadState.loaded) {
+            if (this.audio.paused) {
+                this.audio.play()?.catch(() => {
+                    // Play failed (autoplay policy, etc.) - ignore
+                });
+            }
+        }
+        else {
+            this.loadState.pendingPlay = true;
+        }
+    }
+    seek(position) {
+        if (this.loadState.loaded) {
+            this.audio.currentTime = position;
+        }
+        else {
+            this.loadState.pendingSeek = position;
+        }
+    }
+    tell() {
+        if (this.loadState.loaded)
+            return this.audio.currentTime;
+        return this.loadState.pendingSeek;
+    }
+    isPlaying() {
+        if (this.loadState.loaded)
+            return !this.audio.paused && !this.audio.ended;
+        return this.loadState.pendingPlay;
+    }
+    isPaused() {
+        if (this.loadState.loaded)
+            return this.audio.paused;
+        return !this.loadState.pendingPlay;
+    }
+    isStopped() {
+        if (this.loadState.loaded)
+            return this.audio.paused && this.audio.currentTime === 0;
+        return !this.loadState.pendingPlay && this.loadState.pendingSeek === 0;
+    }
+    /** Set volume (0-1). Applies global volume scaling. Prefer this over `source.audio.volume`. */
+    setVolume(volume) {
+        this.options.volume = Math.max(0, Math.min(1, volume));
+        this.audio.volume = this.options.volume * this.audioRef.getVolume();
+    }
+    getVolume() {
+        return this.options.volume;
+    }
+    getDuration() {
+        if (this.loadState.loaded)
+            return this.audio.duration;
+        return 0;
+    }
+}
+export class Audio {
+    constructor() {
+        Object.defineProperty(this, "sources", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "globalVolume", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 1
+        });
+    }
+    newSource(path, options) {
+        const source = new Source(path, this, options);
+        this.sources.push(new WeakRef(source));
+        return source;
+    }
+    /** Get all audio sources -- note that sources are tracked
+      * using weak references, and storing this list can cause
+      * a memory leak.
+      */
+    getAllSources() {
+        const active = [];
+        for (const sourceRef of this.sources) {
+            const source = sourceRef.deref();
+            if (source)
+                active.push(source);
+        }
+        return active;
+    }
+    stopAll() {
+        this.getAllSources().forEach(s => s.stop());
+    }
+    pauseAll() {
+        this.getAllSources().forEach(s => s.pause());
+    }
+    resumeAll() {
+        this.getAllSources().forEach(s => s.resume());
+    }
+    setVolume(volume) {
+        this.globalVolume = Math.max(0, Math.min(1, volume));
+        this.getAllSources().forEach(s => {
+            s.audio.volume = s.options.volume * this.globalVolume;
+        });
+    }
+    getVolume() {
+        return this.globalVolume;
+    }
+    clone(source) {
+        return this.newSource(source.path, { ...source.options });
+    }
+}

package/dist/core/canvas-config.d.ts

@@ -0,0 +1,22 @@
+import type { Vector2 } from './vector2';
+export type CanvasMode = 'fixed' | 'native';
+export type CanvasConfig = {
+    mode: 'fixed';
+    size: Vector2;
+    pixelArt?: boolean;
+} | {
+    mode: 'native';
+};
+/**
+ * Calculate the scale and offset for rendering fixed-size content to a target canvas.
+ * This is useful when you want to render in "native" mode but maintain a fixed game resolution.
+ *
+ * @param canvasSize - The actual canvas size in pixels
+ * @param gameSize - The desired game resolution (fixed size)
+ * @returns Object containing the scale factor and offset for centering
+ */
+export declare function calcFixedScale(canvasSize: Vector2, gameSize: Vector2): {
+    scale: number;
+    offset: Vector2;
+};
+//# sourceMappingURL=canvas-config.d.ts.map

package/dist/core/canvas-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-config.d.ts","sourceRoot":"","sources":["../../src/core/canvas-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5C,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAKzG"}

package/dist/core/canvas-config.js

@@ -0,0 +1,14 @@
+/**
+ * Calculate the scale and offset for rendering fixed-size content to a target canvas.
+ * This is useful when you want to render in "native" mode but maintain a fixed game resolution.
+ *
+ * @param canvasSize - The actual canvas size in pixels
+ * @param gameSize - The desired game resolution (fixed size)
+ * @returns Object containing the scale factor and offset for centering
+ */
+export function calcFixedScale(canvasSize, gameSize) {
+    const scale = Math.min(canvasSize[0] / gameSize[0], canvasSize[1] / gameSize[1]);
+    const scaledGame = [gameSize[0] * scale, gameSize[1] * scale];
+    const offset = [(canvasSize[0] - scaledGame[0]) * 0.5, (canvasSize[1] - scaledGame[1]) * 0.5];
+    return { scale, offset };
+}