fraxel 0.1.0-alpha.1

package/dist/animation/tween.js

@@ -0,0 +1,103 @@
+import { linear } from './easing.js';
+/**
+ * Creates a tween that interpolates a numeric property on a target object.
+ *
+ * @example
+ * ```ts
+ * import { tween, easeOutQuad } from 'dinix/animation'
+ *
+ * const controller = tween({
+ *   target: sprite,
+ *   prop: 'opacity',
+ *   from: 0,
+ *   to: 1,
+ *   duration: 0.5,
+ *   easing: easeOutQuad,
+ *   onComplete: () => console.log('fade in done'),
+ * })
+ *
+ * // Later:
+ * controller.pause()
+ * controller.resume()
+ * ```
+ */
+export function tween(options) {
+    const { target, prop, from, to, duration, easing = linear, onUpdate, onComplete } = options;
+    let elapsed = 0;
+    let playing = true;
+    let rafId = 0;
+    let lastTime = 0;
+    const step = (time) => {
+        if (!playing)
+            return;
+        if (lastTime === 0)
+            lastTime = time;
+        const dt = (time - lastTime) / 1000;
+        lastTime = time;
+        elapsed += dt;
+        const t = Math.min(elapsed / duration, 1);
+        const easedT = easing(t);
+        const value = from + (to - from) * easedT;
+        target[prop] = value;
+        onUpdate?.(value);
+        if (t >= 1) {
+            onComplete?.();
+            return;
+        }
+        rafId = requestAnimationFrame(step);
+    };
+    rafId = requestAnimationFrame(step);
+    return {
+        get isPlaying() {
+            return playing;
+        },
+        get progress() {
+            return Math.min(elapsed / duration, 1);
+        },
+        pause() {
+            playing = false;
+            cancelAnimationFrame(rafId);
+        },
+        resume() {
+            if (playing)
+                return;
+            playing = true;
+            lastTime = 0;
+            rafId = requestAnimationFrame(step);
+        },
+        stop() {
+            playing = false;
+            cancelAnimationFrame(rafId);
+            elapsed = 0;
+        },
+    };
+}
+/**
+ * Creates a tween that updates a callback with interpolated values.
+ * Useful for animating values without a target object.
+ *
+ * @example
+ * ```ts
+ * import { tweenValue } from 'dinix/animation'
+ *
+ * tweenValue({
+ *   from: 0,
+ *   to: 100,
+ *   duration: 1,
+ *   onUpdate: (value) => console.log(value),
+ * })
+ * ```
+ */
+export function tweenValue(options) {
+    const holder = { v: 0 };
+    const { onUpdate: userOnUpdate, ...rest } = options;
+    return tween({
+        target: holder,
+        prop: 'v',
+        ...rest,
+        onUpdate: (value) => {
+            userOnUpdate?.(value);
+        },
+    });
+}
+//# sourceMappingURL=tween.js.map

package/dist/animation/tween.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tween.js","sourceRoot":"","sources":["../../src/animation/tween.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAwCpC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,KAAK,CAAI,OAAwB;IAC/C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAA;IAE3F,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,IAAI,OAAO,GAAG,IAAI,CAAA;IAClB,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,QAAQ,GAAG,CAAC,CAAA;IAEhB,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE;QAC5B,IAAI,CAAC,OAAO;YAAE,OAAM;QAEpB,IAAI,QAAQ,KAAK,CAAC;YAAE,QAAQ,GAAG,IAAI,CAAA;QACnC,MAAM,EAAE,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAA;QACnC,QAAQ,GAAG,IAAI,CAAA;QAEf,OAAO,IAAI,EAAE,CAAA;QAEb,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAA;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QACxB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAA;QAEzC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAuB,CAAA;QACtC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAA;QAEjB,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACX,UAAU,EAAE,EAAE,CAAA;YACd,OAAM;QACR,CAAC;QAED,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC,CAAA;IAED,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAA;IAEnC,OAAO;QACL,IAAI,SAAS;YACX,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,IAAI,QAAQ;YACV,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAA;QACxC,CAAC;QACD,KAAK;YACH,OAAO,GAAG,KAAK,CAAA;YACf,oBAAoB,CAAC,KAAK,CAAC,CAAA;QAC7B,CAAC;QACD,MAAM;YACJ,IAAI,OAAO;gBAAE,OAAM;YACnB,OAAO,GAAG,IAAI,CAAA;YACd,QAAQ,GAAG,CAAC,CAAA;YACZ,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAA;QACrC,CAAC;QACD,IAAI;YACF,OAAO,GAAG,KAAK,CAAA;YACf,oBAAoB,CAAC,KAAK,CAAC,CAAA;YAC3B,OAAO,GAAG,CAAC,CAAA;QACb,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU,CACxB,OAAsE;IAEtE,MAAM,MAAM,GAA2B,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;IAC/C,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAA;IACnD,OAAO,KAAK,CAAC;QACX,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,GAAG;QACT,GAAG,IAAI;QACP,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,YAAY,EAAE,CAAC,KAAK,CAAC,CAAA;QACvB,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/assets/index.d.ts

@@ -0,0 +1,6 @@
+export { Texture, getTexture } from './texture.js';
+export { loadTexture, unloadTexture } from './load-texture.js';
+export { loadSound, getSound, unloadSound } from './load-sound.js';
+export { loadBatch, loadBatchAsset } from './loader.js';
+export type { LoaderOptions, AssetType } from './loader.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACvD,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}

package/dist/assets/index.js

@@ -0,0 +1,5 @@
+export { Texture, getTexture } from './texture.js';
+export { loadTexture, unloadTexture } from './load-texture.js';
+export { loadSound, getSound, unloadSound } from './load-sound.js';
+export { loadBatch, loadBatchAsset } from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/assets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/assets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA"}

package/dist/assets/load-sound.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The **`loadSound`** function loads an audio file and returns a symbol ID.
+ * @param url Audio file URL
+ * @returns A symbol ID referencing the loaded audio buffer
+ */
+export declare function loadSound(url: string): Promise<symbol>;
+/**
+ * Returns an `AudioBuffer` by its symbol ID.
+ * @param id The symbol ID returned by `loadSound`
+ */
+export declare function getSound(id: symbol): AudioBuffer;
+/**
+ * Unloads a sound from memory.
+ * @param id The sound symbol ID to unload
+ */
+export declare function unloadSound(id: symbol): void;
+//# sourceMappingURL=load-sound.d.ts.map

package/dist/assets/load-sound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-sound.d.ts","sourceRoot":"","sources":["../../src/assets/load-sound.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU5D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAIhD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE5C"}

package/dist/assets/load-sound.js

@@ -0,0 +1,35 @@
+import { getAudioContext } from '../audio/audio-context.js';
+import { SoundNotFoundError } from '../errors/assets.js';
+const sounds = new Map();
+/**
+ * The **`loadSound`** function loads an audio file and returns a symbol ID.
+ * @param url Audio file URL
+ * @returns A symbol ID referencing the loaded audio buffer
+ */
+export async function loadSound(url) {
+    const ctx = getAudioContext();
+    const response = await fetch(url);
+    const arrayBuffer = await response.arrayBuffer();
+    const audioBuffer = await ctx.decodeAudioData(arrayBuffer);
+    const id = Symbol(url);
+    sounds.set(id, audioBuffer);
+    return id;
+}
+/**
+ * Returns an `AudioBuffer` by its symbol ID.
+ * @param id The symbol ID returned by `loadSound`
+ */
+export function getSound(id) {
+    const buffer = sounds.get(id);
+    if (buffer == null)
+        throw new SoundNotFoundError(id.toString());
+    return buffer;
+}
+/**
+ * Unloads a sound from memory.
+ * @param id The sound symbol ID to unload
+ */
+export function unloadSound(id) {
+    sounds.delete(id);
+}
+//# sourceMappingURL=load-sound.js.map

package/dist/assets/load-sound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-sound.js","sourceRoot":"","sources":["../../src/assets/load-sound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAExD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAA;AAE7C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,GAAG,GAAG,eAAe,EAAE,CAAA;IAC7B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAA;IAChD,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,WAAW,CAAC,CAAA;IAE1D,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IACtB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,CAAA;IAE3B,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC7B,IAAI,MAAM,IAAI,IAAI;QAAE,MAAM,IAAI,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC/D,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACnB,CAAC"}

package/dist/assets/load-texture.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The **`loadTexture`** function loads a single texture.
+ * @param url Image URL
+ * @returns A symbol ID referencing the loaded texture
+ */
+export declare function loadTexture(url: string): Promise<symbol>;
+/**
+ * Unloads a texture from memory.
+ * @param id The texture symbol ID to unload
+ */
+export declare function unloadTexture(id: symbol): void;
+//# sourceMappingURL=load-texture.d.ts.map

package/dist/assets/load-texture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-texture.d.ts","sourceRoot":"","sources":["../../src/assets/load-texture.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA+B9D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE9C"}

package/dist/assets/load-texture.js

@@ -0,0 +1,40 @@
+import { Texture, textures } from './texture.js';
+/**
+ * The **`loadTexture`** function loads a single texture.
+ * @param url Image URL
+ * @returns A symbol ID referencing the loaded texture
+ */
+export async function loadTexture(url) {
+    const entry = [...textures.entries()].find(([_, val]) => val.image.src === url);
+    if (entry != null)
+        return entry[0];
+    const id = Symbol(url);
+    const image = new Image();
+    await new Promise((resolve, reject) => {
+        const removeEvents = () => {
+            image.removeEventListener('load', onLoaded);
+            image.removeEventListener('error', onError);
+        };
+        const onLoaded = () => {
+            removeEvents();
+            resolve();
+        };
+        const onError = (err) => {
+            removeEvents();
+            reject(err);
+        };
+        image.addEventListener('load', onLoaded);
+        image.addEventListener('error', onError);
+        image.src = url;
+    });
+    textures.set(id, new Texture(image));
+    return id;
+}
+/**
+ * Unloads a texture from memory.
+ * @param id The texture symbol ID to unload
+ */
+export function unloadTexture(id) {
+    textures.delete(id);
+}
+//# sourceMappingURL=load-texture.js.map

package/dist/assets/load-texture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-texture.js","sourceRoot":"","sources":["../../src/assets/load-texture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEhD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,CAAA;IAC/E,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;IAElC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IACtB,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAA;IAEzB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,YAAY,GAAG,GAAG,EAAE;YACxB,KAAK,CAAC,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;YAC3C,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC7C,CAAC,CAAA;QAED,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,YAAY,EAAE,CAAA;YACd,OAAO,EAAE,CAAA;QACX,CAAC,CAAA;QACD,MAAM,OAAO,GAAG,CAAC,GAAe,EAAE,EAAE;YAClC,YAAY,EAAE,CAAA;YACd,MAAM,CAAC,GAAG,CAAC,CAAA;QACb,CAAC,CAAA;QAED,KAAK,CAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QACxC,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAExC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAA;IACjB,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IAEpC,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACrB,CAAC"}

package/dist/assets/loader.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Options for batch loading.
+ */
+export interface LoaderOptions {
+    /**
+     * Callback invoked as assets finish loading.
+     * @param loaded Number of assets loaded so far
+     * @param total Total number of assets to load
+     */
+    onProgress?: (loaded: number, total: number) => void;
+}
+/**
+ * Asset type for `loadBatchAsset`.
+ */
+export type AssetType = 'texture' | 'sound';
+/**
+ * Loads multiple assets in parallel with progress tracking.
+ * Each loader is a function that returns a promise.
+ *
+ * @param loaders Array of loader functions
+ * @param options Loading options
+ * @returns Array of results in the same order as the input loaders
+ *
+ * @example
+ * ```ts
+ * const [bg, player] = await loadBatch([
+ *   () => loadTexture('/assets/bg.png'),
+ *   () => loadSound('/assets/shoot.ogg'),
+ * ], {
+ *   onProgress: (loaded, total) => console.log(`${loaded}/${total}`),
+ * })
+ * ```
+ */
+export declare function loadBatch<T>(loaders: (() => Promise<T>)[], options?: LoaderOptions): Promise<T[]>;
+/**
+ * Loads multiple assets of the same type in parallel with progress tracking.
+ *
+ * @param type Asset type: `'texture'` or `'sound'`
+ * @param urls Array of URLs to load
+ * @param options Loading options
+ * @returns Array of symbol IDs in the same order as the input URLs
+ *
+ * @example
+ * ```ts
+ * const [bg, player] = await loadBatchAsset('texture', [
+ *   '/assets/bg.png',
+ *   '/assets/player.png',
+ * ], {
+ *   onProgress: (loaded, total) => console.log(`${loaded}/${total}`),
+ * })
+ *
+ * const [shoot, hit] = await loadBatchAsset('sound', [
+ *   '/assets/shoot.ogg',
+ *   '/assets/hit.ogg',
+ * ])
+ * ```
+ */
+export declare function loadBatchAsset(type: AssetType, urls: string[], options?: LoaderOptions): Promise<symbol[]>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/assets/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/assets/loader.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACrD;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;AAE3C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,OAAO,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAC7B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,CAAC,EAAE,CAAC,CAYd;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,EAAE,CAAC,CAanB"}

package/dist/assets/loader.js

@@ -0,0 +1,65 @@
+import { loadTexture } from './load-texture.js';
+import { loadSound } from './load-sound.js';
+/**
+ * Loads multiple assets in parallel with progress tracking.
+ * Each loader is a function that returns a promise.
+ *
+ * @param loaders Array of loader functions
+ * @param options Loading options
+ * @returns Array of results in the same order as the input loaders
+ *
+ * @example
+ * ```ts
+ * const [bg, player] = await loadBatch([
+ *   () => loadTexture('/assets/bg.png'),
+ *   () => loadSound('/assets/shoot.ogg'),
+ * ], {
+ *   onProgress: (loaded, total) => console.log(`${loaded}/${total}`),
+ * })
+ * ```
+ */
+export async function loadBatch(loaders, options) {
+    let loaded = 0;
+    const total = loaders.length;
+    return Promise.all(loaders.map(async (fn) => {
+        const result = await fn();
+        loaded++;
+        options?.onProgress?.(loaded, total);
+        return result;
+    }));
+}
+/**
+ * Loads multiple assets of the same type in parallel with progress tracking.
+ *
+ * @param type Asset type: `'texture'` or `'sound'`
+ * @param urls Array of URLs to load
+ * @param options Loading options
+ * @returns Array of symbol IDs in the same order as the input URLs
+ *
+ * @example
+ * ```ts
+ * const [bg, player] = await loadBatchAsset('texture', [
+ *   '/assets/bg.png',
+ *   '/assets/player.png',
+ * ], {
+ *   onProgress: (loaded, total) => console.log(`${loaded}/${total}`),
+ * })
+ *
+ * const [shoot, hit] = await loadBatchAsset('sound', [
+ *   '/assets/shoot.ogg',
+ *   '/assets/hit.ogg',
+ * ])
+ * ```
+ */
+export async function loadBatchAsset(type, urls, options) {
+    const loader = type === 'texture' ? loadTexture : loadSound;
+    let loaded = 0;
+    const total = urls.length;
+    return Promise.all(urls.map(async (url) => {
+        const id = await loader(url);
+        loaded++;
+        options?.onProgress?.(loaded, total);
+        return id;
+    }));
+}
+//# sourceMappingURL=loader.js.map

package/dist/assets/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/assets/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAmB3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAA6B,EAC7B,OAAuB;IAEvB,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAA;IAE5B,OAAO,OAAO,CAAC,GAAG,CAChB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAA;QACzB,MAAM,EAAE,CAAA;QACR,OAAO,EAAE,UAAU,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACpC,OAAO,MAAM,CAAA;IACf,CAAC,CAAC,CACH,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAe,EACf,IAAc,EACd,OAAuB;IAEvB,MAAM,MAAM,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAA;IAC3D,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAA;IAEzB,OAAO,OAAO,CAAC,GAAG,CAChB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAA;QAC5B,MAAM,EAAE,CAAA;QACR,OAAO,EAAE,UAAU,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACpC,OAAO,EAAE,CAAA;IACX,CAAC,CAAC,CACH,CAAA;AACH,CAAC"}

package/dist/assets/texture.d.ts

@@ -0,0 +1,36 @@
+import { Vector2 } from '../math/vector2.js';
+export declare class Texture {
+    /** A loaded image */
+    image: HTMLImageElement;
+    /** The **`width`** of the texture. */
+    width: number;
+    /** The **`height`** of the texture. */
+    height: number;
+    constructor(
+    /** A loaded image */
+    image: HTMLImageElement);
+    /**
+     * The **`draw`** method draws the texture in the `canvas`.
+     * @param options Texture draw options
+     */
+    draw(options: TextureDrawOptions): void;
+}
+interface TextureDrawOptions {
+    /** Position to draw */
+    position: Vector2;
+    /** Size of the texture */
+    sourceSize?: Vector2 | undefined;
+    /** Size of the result texture */
+    displaySize?: Vector2 | undefined;
+    /** Offset of the texture */
+    margin?: Vector2 | undefined;
+}
+export declare const textures: Map<symbol, Texture>;
+/**
+ * The **`getTexture`** function returns a texture by id.
+ * @param id Texture Id
+ * @returns A Texture
+ */
+export declare function getTexture(id: symbol): Texture;
+export {};
+//# sourceMappingURL=texture.d.ts.map

package/dist/assets/texture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture.d.ts","sourceRoot":"","sources":["../../src/assets/texture.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAE5C,qBAAa,OAAO;IAOhB,qBAAqB;IACd,KAAK,EAAE,gBAAgB;IAPhC,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAA;;IAGZ,qBAAqB;IACd,KAAK,EAAE,gBAAgB;IAMhC;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,kBAAkB;CA8BjC;AAED,UAAU,kBAAkB;IAC1B,uBAAuB;IACvB,QAAQ,EAAE,OAAO,CAAA;IACjB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAChC,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACjC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC7B;AAED,eAAO,MAAM,QAAQ,sBAA6B,CAAA;AAElD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,WAMpC"}

package/dist/assets/texture.js

@@ -0,0 +1,49 @@
+import { GameConfig } from '../core/game-config.js';
+import { TextureNotFoundError } from '../errors/assets.js';
+import { Vector2 } from '../math/vector2.js';
+export class Texture {
+    image;
+    /** The **`width`** of the texture. */
+    width;
+    /** The **`height`** of the texture. */
+    height;
+    constructor(
+    /** A loaded image */
+    image) {
+        this.image = image;
+        this.width = image.width;
+        this.height = image.height;
+    }
+    /**
+     * The **`draw`** method draws the texture in the `canvas`.
+     * @param options Texture draw options
+     */
+    draw(options) {
+        const width = options.sourceSize?.x ?? this.width;
+        const height = options.sourceSize?.y ?? this.height;
+        const rWidth = options.displaySize?.x ?? width;
+        const rHeight = options.displaySize?.y ?? height;
+        const flipX = rWidth !== Math.abs(rWidth);
+        const flipY = rHeight !== Math.abs(rHeight);
+        const scaleX = flipX ? -1 : 1;
+        const scaleY = flipY ? -1 : 1;
+        const pos = options.position.toMultiplied(new Vector2(scaleX, scaleY));
+        GameConfig.ctx.save();
+        GameConfig.ctx.scale(scaleX, scaleY);
+        GameConfig.ctx.drawImage(this.image, options.margin?.x ?? 0, options.margin?.y ?? 0, width, height, pos.x, pos.y, rWidth, rHeight);
+        GameConfig.ctx.restore();
+    }
+}
+export const textures = new Map();
+/**
+ * The **`getTexture`** function returns a texture by id.
+ * @param id Texture Id
+ * @returns A Texture
+ */
+export function getTexture(id) {
+    const texture = textures.get(id);
+    if (texture == null)
+        throw new TextureNotFoundError(id.toString());
+    return texture;
+}
+//# sourceMappingURL=texture.js.map

package/dist/assets/texture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture.js","sourceRoot":"","sources":["../../src/assets/texture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAE5C,MAAM,OAAO,OAAO;IAQT;IAPT,sCAAsC;IACtC,KAAK,CAAQ;IACb,uCAAuC;IACvC,MAAM,CAAQ;IAEd;IACE,qBAAqB;IACd,KAAuB;QAAvB,UAAK,GAAL,KAAK,CAAkB;QAE9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;QACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;IAC5B,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,OAA2B;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAA;QACjD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,CAAA;QAEnD,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,KAAK,CAAA;QAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,MAAM,CAAA;QAEhD,MAAM,KAAK,GAAG,MAAM,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACzC,MAAM,KAAK,GAAG,OAAO,KAAK,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAE3C,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAE7B,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;QAEtE,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;QACrB,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACpC,UAAU,CAAC,GAAG,CAAC,SAAS,CACtB,IAAI,CAAC,KAAK,EACV,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EACtB,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EACtB,KAAK,EACL,MAAM,EACN,GAAG,CAAC,CAAC,EACL,GAAG,CAAC,CAAC,EACL,MAAM,EACN,OAAO,CACR,CAAA;QACD,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;CACF;AAaD,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAA;AAElD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAEhC,IAAI,OAAO,IAAI,IAAI;QAAE,MAAM,IAAI,oBAAoB,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAA;IAElE,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/audio/audio-context.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Returns the shared `AudioContext`, creating it lazily on first call.
+ * The context starts in `suspended` state and must be resumed after a user gesture.
+ *
+ * @example
+ * ```ts
+ * const audioCtx = getAudioContext()
+ * if (audioCtx.state === 'suspended') {
+ *   await audioCtx.resume()
+ * }
+ * ```
+ */
+export declare function getAudioContext(): AudioContext;
+//# sourceMappingURL=audio-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio-context.d.ts","sourceRoot":"","sources":["../../src/audio/audio-context.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C"}

package/dist/audio/audio-context.js

@@ -0,0 +1,20 @@
+let ctx = null;
+/**
+ * Returns the shared `AudioContext`, creating it lazily on first call.
+ * The context starts in `suspended` state and must be resumed after a user gesture.
+ *
+ * @example
+ * ```ts
+ * const audioCtx = getAudioContext()
+ * if (audioCtx.state === 'suspended') {
+ *   await audioCtx.resume()
+ * }
+ * ```
+ */
+export function getAudioContext() {
+    if (ctx == null) {
+        ctx = new AudioContext();
+    }
+    return ctx;
+}
+//# sourceMappingURL=audio-context.js.map

package/dist/audio/audio-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-context.js","sourceRoot":"","sources":["../../src/audio/audio-context.ts"],"names":[],"mappings":"AAAA,IAAI,GAAG,GAAwB,IAAI,CAAA;AAEnC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,GAAG,GAAG,IAAI,YAAY,EAAE,CAAA;IAC1B,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/audio/index.d.ts

@@ -0,0 +1,2 @@
+export { getAudioContext } from './audio-context.js';
+//# 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,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/audio/index.js

@@ -0,0 +1,2 @@
+export { getAudioContext } from './audio-context.js';
+//# sourceMappingURL=index.js.map

package/dist/audio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/collision/broadphase/spatial-hash.d.ts

@@ -0,0 +1,32 @@
+import type { Collider } from '../../nodes/node2d/collider.js';
+import type { CollisionBounds } from '../types.js';
+/**
+ * The **`SpatialHash`** class is a broadphase spatial partitioning structure.
+ * It divides the game world into a grid of cells and tracks which colliders occupy each cell.
+ * This allows the collision system to quickly narrow down potential collision pairs.
+ */
+export declare class SpatialHash {
+    #private;
+    /**
+     * Creates a new `SpatialHash` with the given cell size.
+     * @param cellSize The size of each grid cell in pixels. Defaults to 64.
+     */
+    constructor(cellSize?: number);
+    /**
+     * The **`clear`** method removes all colliders from the grid.
+     * Called automatically before each broadphase rebuild.
+     */
+    clear(): void;
+    /**
+     * The **`insert`** method adds a collider to all grid cells it overlaps.
+     * @param collider The collider to insert into the spatial hash.
+     */
+    insert(collider: Collider): void;
+    /**
+     * The **`query`** method returns all colliders that overlap with the given bounds.
+     * @param bounds The bounding box to query.
+     * @returns A set of colliders that may intersect the bounds.
+     */
+    query(bounds: CollisionBounds): Set<Collider>;
+}
+//# sourceMappingURL=spatial-hash.d.ts.map

package/dist/collision/broadphase/spatial-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial-hash.d.ts","sourceRoot":"","sources":["../../../src/collision/broadphase/spatial-hash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD;;;;GAIG;AACH,qBAAa,WAAW;;IAItB;;;OAGG;gBACS,QAAQ,SAAK;IAIzB;;;OAGG;IACH,KAAK;IAIL;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ;IAoBzB;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,GAAG,CAAC,QAAQ,CAAC;CAwC9C"}