1681-engine 0.5.8 → 0.5.10

package/dist/types/ambient/life/ChimneySmoke.d.ts

@@ -0,0 +1,37 @@
+import type { ViewRect } from '../../core/Camera.js';
+import type { Stage } from '../../core/Stage.js';
+import { type LifeAir, type LifePoint } from './lifeMotion.js';
+export interface ChimneySmokeOptions {
+    /** The chimneys' mouths in world pixels. */
+    mouths: readonly LifePoint[];
+    /** The puff's frames from young to old (it grows through them and dithers away). */
+    frames: readonly string[];
+    /** Puffs in each chimney's pool (default 7). */
+    puffs?: number;
+    /** A puff every this many ms, give or take 30% (default 650). */
+    puffEveryMs?: number;
+    /** A puff's life (ms, default 4600). */
+    lifeMs?: number;
+    /** World px a second it climbs (default 7). */
+    rise?: number;
+    /** World px a second the wind leans it (default 9). */
+    drift?: number;
+    /** Depth in the world layer (default 900_000). */
+    depth?: number;
+    snap?: boolean;
+    random?: () => number;
+}
+/**
+ * Smoke rising from chimneys: each mouth lets out a puff every so often that climbs, grows through its frames, leans
+ * downwind and is gone. Only mouths on screen puff; a mouth that leaves the view drops its puffs at once.
+ */
+export declare class ChimneySmoke {
+    private readonly options;
+    private readonly chimneys;
+    private readonly snap;
+    private readonly random;
+    constructor(stage: Stage, options: ChimneySmokeOptions);
+    update(now: number, view: ViewRect, air: LifeAir, enabled?: boolean): void;
+    destroy(): void;
+}
+//# sourceMappingURL=ChimneySmoke.d.ts.map

package/dist/types/ambient/life/ChimneySmoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChimneySmoke.d.ts","sourceRoot":"","sources":["../../../../src/ambient/life/ChimneySmoke.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAc,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B,oFAAoF;IACpF,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB;AAeD;;;GAGG;AACH,qBAAa,YAAY;IAOrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAGpC,KAAK,EAAE,KAAK,EACK,OAAO,EAAE,mBAAmB;IAgB/C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,UAAO,GAAG,IAAI;IAwCvE,OAAO,IAAI,IAAI;CAIhB"}

package/dist/types/ambient/life/Drift.d.ts

@@ -0,0 +1,58 @@
+import type { ViewRect } from '../../core/Camera.js';
+import type { Stage } from '../../core/Stage.js';
+import type { LifeAir, LifeSource } from './lifeMotion.js';
+/**
+ * How a drift moves:
+ * - `leaf`: tumbles down through its frames, lands, lies a moment and is gone;
+ * - `seed`: blown across the view on a slow wobble (dandelion seed, spores, ash on the wind);
+ * - `ember`: rises, cooling through its frames, and goes out within a tile or three;
+ * - `mote`: hangs in the air, barely moving, and winks out now and then (underground dust);
+ * - `ash`: blown across like a seed, but from a source it lifts off the ground instead.
+ */
+export type DriftKind = 'leaf' | 'seed' | 'ember' | 'mote' | 'ash';
+export interface DriftOptions {
+    kind: DriftKind;
+    /** Bodies in the pool; a body off screen is hidden and re-used, never freed. */
+    count: number;
+    /**
+     * The looks, each a list of frames; body `i` wears `looks[i % looks.length]`. A leaf tumbles through its frames and
+     * lies on the first; an ember cools from its first to its last; the others wear the first.
+     */
+    looks: readonly (readonly string[])[];
+    /**
+     * Where a body sets off from, if anywhere in particular: a canopy on screen a leaf falls from (and lands just under),
+     * a patch of ground ash or embers lift off. Null when there is none in view now.
+     */
+    from?: LifeSource;
+    /**
+     * Only from `from` (a drift over certain ground): a body waits rather than drift in from the view's edge. Default
+     * false — a leaf with no canopy in view still blows in from the edge.
+     */
+    sourceOnly?: boolean;
+    /** Depth in the world layer (default 900_000: over the bodies and props, under the weather and the names). */
+    depth?: number;
+    /** Positions on whole world pixels (default true). */
+    snap?: boolean;
+    random?: () => number;
+}
+/**
+ * One kind of thing on the air: a fixed pool that lives only inside the camera's view, each body on whole world
+ * pixels and flipped between painted frames rather than rotated (a rotated pixel leaf reads as a different art style).
+ * Feed it the frame's view and the air; `enabled` false hides it (a reduced-effects setting).
+ */
+export declare class Drift {
+    private readonly options;
+    private readonly motes;
+    private readonly kind;
+    private readonly snap;
+    private readonly random;
+    constructor(stage: Stage, options: DriftOptions);
+    /** `now` and `dt` in ms. */
+    update(now: number, dt: number, view: ViewRect, air: LifeAir, enabled?: boolean): void;
+    destroy(): void;
+    /** `anywhere`: a first fill lands bodies all over the view, not only at its edge, so a scene opens already alive. */
+    private spawn;
+    private spawnFrom;
+    private step;
+}
+//# sourceMappingURL=Drift.d.ts.map

package/dist/types/ambient/life/Drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Drift.d.ts","sourceRoot":"","sources":["../../../../src/ambient/life/Drift.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAW,UAAU,EAAE,MAAM,cAAc,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IACtC;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8GAA8G;IAC9G,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB;AAuBD;;;;GAIG;AACH,qBAAa,KAAK;IAQd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAGpC,KAAK,EAAE,KAAK,EACK,OAAO,EAAE,YAAY;IAaxC,4BAA4B;IAC5B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,UAAO,GAAG,IAAI;IAuBnF,OAAO,IAAI,IAAI;IAKf,qHAAqH;IACrH,OAAO,CAAC,KAAK;IA2Bb,OAAO,CAAC,SAAS;IAwBjB,OAAO,CAAC,IAAI;CAwCb"}

package/dist/types/ambient/life/Fireflies.d.ts

@@ -0,0 +1,43 @@
+import { Container } from 'pixi.js';
+import type { ViewRect } from '../../core/Camera.js';
+import type { Stage } from '../../core/Stage.js';
+import { type LifeAir, type LifeSource } from './lifeMotion.js';
+export interface FirefliesOptions {
+    count: number;
+    /** The two frames: a dim pixel, and the glow. */
+    frames: readonly [dim: string, lit: string];
+    /** Somewhere in view to hover round (the water's edge, the feet of trees), or null when none is on screen. */
+    home: LifeSource;
+    /**
+     * Where the layer goes. Default `'screen'`: on the screen layer, following the camera, so it can be laid **over** a
+     * darkness drawn there (`NightShade`, `Darkness`) instead of being darkened with the world under it — add it after
+     * the darkness. `'world'`: in the world layer at `depth`, for a game with no darkness over its world.
+     */
+    layer?: 'screen' | 'world';
+    /** World-layer depth when `layer` is `'world'` (default 900_000). */
+    depth?: number;
+    snap?: boolean;
+    random?: () => number;
+}
+/**
+ * Fireflies at night: single pixels drifting slowly round homes on screen, each lighting up and going out on its own
+ * clock. How many are out grows with the dark (none before night 0.5, all by 0.85). They are a light, so by default
+ * their layer sits on the screen and follows the camera (`Camera.follow` copies the world layer's transform, shake
+ * included, once the frame's camera is known).
+ */
+export declare class Fireflies {
+    private readonly stage;
+    private readonly options;
+    readonly layer: Container<import("pixi.js").ContainerChild>;
+    private readonly flies;
+    private readonly dim;
+    private readonly lit;
+    private readonly onScreen;
+    private readonly snap;
+    private readonly random;
+    constructor(stage: Stage, options: FirefliesOptions);
+    update(now: number, view: ViewRect, air: LifeAir, enabled?: boolean): void;
+    destroy(): void;
+    private settle;
+}
+//# sourceMappingURL=Fireflies.d.ts.map

package/dist/types/ambient/life/Fireflies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fireflies.d.ts","sourceRoot":"","sources":["../../../../src/ambient/life/Fireflies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAwB,MAAM,SAAS,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAA4C,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAEvG,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,MAAM,EAAE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5C,8GAA8G;IAC9G,IAAI,EAAE,UAAU,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC3B,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB;AAUD;;;;;GAKG;AACH,qBAAa,SAAS;IAUlB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAV1B,QAAQ,CAAC,KAAK,8CAAmB;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAU;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAU;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAGnB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,gBAAgB;IAwB5C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,UAAO,GAAG,IAAI;IA8BvE,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,MAAM;CAQf"}

package/dist/types/ambient/life/lifeMotion.d.ts

@@ -0,0 +1,63 @@
+import type { ViewRect } from '../../core/Camera.js';
+/** A point in world pixels. */
+export interface LifePoint {
+    x: number;
+    y: number;
+}
+/** A box in world pixels (a canopy leaves fall from, a tile ash lifts off); a point is a box of no size. */
+export interface LifeBox extends LifePoint {
+    w?: number;
+    h?: number;
+}
+/** The air the life reads: how dark it is and how hard the wind blows. */
+export interface LifeAir {
+    /** 0 by day, 1 at full night (birds and butterflies keep away from the dark, fireflies come out of it). */
+    night: number;
+    /** 0 still air, 1 a gale: leans the drift, hastens a flock, bends smoke. */
+    wind: number;
+}
+/** Hands back somewhere to be: inside the camera's view, or null when there is nowhere there now. */
+export type LifeSource<T extends LifeBox = LifeBox> = (view: ViewRect, random: () => number) => T | null;
+/** Whether the box touches the view grown by `margin` on every side. */
+export declare function boxInView(b: LifeBox, view: ViewRect, margin?: number): boolean;
+/**
+ * One of `items` in view, tried `tries` times at random rather than filtered: a forest's thousands of tiles cost the
+ * same few reads as a hamlet's dozen, and a miss only means the body waits a frame to try again.
+ */
+export declare function pickInView<T extends LifeBox>(items: readonly T[], view: ViewRect, random: () => number, tries?: number): T | null;
+/** A `LifeSource` over a fixed list (flower beds, the water's edge, tiles of burnt ground). */
+export declare function sourceOf<T extends LifeBox>(items: readonly T[], tries?: number): LifeSource<T>;
+/** A bird's frame: a few beats (0, 1, 0, 1, 0), then a glide on raised wings (0) for three, each bird on its clock. */
+export declare function birdFrame(now: number, offset: number, beatMs?: number): 0 | 1;
+/**
+ * Where the `i`-th bird of a flock flies behind the leader: a loose V trailing back along `dirX` (its sign), ranks
+ * alternating side to side. `jitter` (0..1 each) loosens it so no two flocks are drawn alike.
+ */
+export declare function flockSlot(i: number, dirX: number, jitterX: number, jitterY: number): {
+    dx: number;
+    dy: number;
+};
+/** A firefly's blink at `t` seconds: 0 dark most of the time, 2 a glow for a beat, 1 a dim pixel either side of it. */
+export declare function fireflyGlow(t: number): 0 | 1 | 2;
+/** A firefly's slow wander about its home at `t` seconds: two sines across, one up and down. */
+export declare function fireflyOffset(t: number): {
+    dx: number;
+    dy: number;
+};
+/** How many of a pool of `count` fireflies are out at `night`: none before 0.5, all by 0.85. */
+export declare function firefliesOut(count: number, night: number): number;
+export interface PuffMotion {
+    /** World px a second it climbs. */
+    rise: number;
+    /** World px a second the wind leans it at full age. */
+    drift: number;
+}
+/**
+ * Where a puff of smoke is `sec` seconds after it left a chimney's mouth, `age` the share of its life gone: it climbs
+ * straight out of the pot, then the wind takes it more the higher it gets. `seed` (0..1) gives each its own wobble.
+ */
+export declare function puffOffset(sec: number, age: number, seed: number, wind: number, m: PuffMotion): {
+    dx: number;
+    dy: number;
+};
+//# sourceMappingURL=lifeMotion.d.ts.map

package/dist/types/ambient/life/lifeMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifeMotion.d.ts","sourceRoot":"","sources":["../../../../src/ambient/life/lifeMotion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAQlD,+BAA+B;AAC/B,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,4GAA4G;AAC5G,MAAM,WAAW,OAAQ,SAAQ,SAAS;IACxC,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,0EAA0E;AAC1E,MAAM,WAAW,OAAO;IACtB,2GAA2G;IAC3G,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qGAAqG;AACrG,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC;AAEzG,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,SAAI,GAAG,OAAO,CAEzE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,MAAM,EAAE,KAAK,SAAI,GAAG,CAAC,GAAG,IAAI,CAO5H;AAED,+FAA+F;AAC/F,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,SAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAEzF;AAED,uHAAuH;AACvH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,CAAC,GAAG,CAAC,CAG1E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAI/G;AAED,uHAAuH;AACvH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAGhD;AAED,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAEnE;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAK1H"}

package/dist/types/assets/AssetLoader.d.ts

@@ -1,4 +1,7 @@
+import type { CanvasTexture } from '../core/TextureRegistry.js';
+import type { LdtkProject } from '../tilemap/ldtk.js';
 import { type TileMap, type Tileset } from '../tilemap/tiled.js';
+import { type AtlasFrame } from './textureAtlas.js';
 /** Where loaded images go: the stage's `TextureRegistry` satisfies it. */
 export interface TextureSink {
     addCanvas(key: string, canvas: HTMLCanvasElement): unknown;
@@ -6,6 +9,26 @@ export interface TextureSink {
         frameWidth: number;
         frameHeight: number;
     }): unknown;
+    /** Needed only by `atlas`; the stage's `TextureRegistry` has it. */
+    addAtlas?(key: string, pages: readonly {
+        canvas: HTMLCanvasElement;
+        frames: readonly AtlasFrame[];
+    }[]): CanvasTexture | unknown;
+}
+/** What a fetch must answer with; `arrayBuffer` is optional so older custom transports keep working (blob is used). */
+export interface AssetResponse {
+    ok: boolean;
+    status: number;
+    blob(): Promise<Blob>;
+    json(): Promise<unknown>;
+    text(): Promise<string>;
+    arrayBuffer?(): Promise<ArrayBuffer>;
+}
+/** What an atlas brought besides its textures: its frame names (every page) and animations. */
+export interface AtlasInfo {
+    frames: string[];
+    animations: Record<string, string[]>;
+    pages: number;
 }
 export interface AssetLoaderOptions {
     /** Prefix for relative URLs (default: none, so relative to the page). */
@@ -13,20 +36,28 @@ export interface AssetLoaderOptions {
     /** Requests running at once (default 6). */
     concurrency?: number;
     /** For tests and custom transports: defaults to the global `fetch`. */
-    fetch?: (url: string) => Promise<{
-        ok: boolean;
-        status: number;
-        blob(): Promise<Blob>;
-        json(): Promise<unknown>;
-        text(): Promise<string>;
-    }>;
+    fetch?: (url: string) => Promise<AssetResponse>;
     /** Turns image bytes into a canvas; defaults to `createImageBitmap` drawn onto a new canvas. */
     toCanvas?: (blob: Blob) => Promise<HTMLCanvasElement>;
+    /**
+     * The context `audio` decodes through (default: the engine's sound context, `sound.audioContext`, once a gesture
+     * opened it). Null means "not yet": the bytes are kept and decoded on first `decodeAudio`.
+     */
+    audioContext?: () => BaseAudioContext | null;
+    /** Installs a font's bytes; defaults to a `FontFace` added to `document.fonts`. */
+    addFont?: (family: string, data: ArrayBuffer, descriptors?: FontFaceDescriptors) => Promise<void>;
 }
 export interface TilemapAssetOptions {
     /** The texture key a tileset's image is loaded under (default: the tileset's name). */
     textureKey?: (tileset: Tileset) => string;
 }
+export interface LdtkAssetOptions extends TilemapAssetOptions {
+    /**
+     * Which external level files to fetch with the project (by level identifier); default every one. A level left out
+     * stays `loaded: false`, to be fetched later and read with `loadLdtkLevel`.
+     */
+    levels?: readonly string[];
+}
 export interface LoadProgress {
     done: number;
     total: number;
@@ -37,7 +68,8 @@ export interface LoadProgress {
 export declare function resolveUrl(url: string, base: string): string;
 /**
  * Loads a scene's assets before it starts: queue them, then `await load()`. Images become textures in the stage's
- * registry (frames of a sprite sheet named 0, 1, 2…); JSON, text and Tiled maps are kept here by key. A failed asset
+ * registry (frames of a sprite sheet named 0, 1, 2…); JSON, text and Tiled maps are kept here by key; atlases register every frame under their key; fonts go to
+ * `document.fonts`; audio is decoded into `AudioBuffer`s (or kept as bytes until a context exists). A failed asset
  * fails the whole load with its URL in the message.
  *
  * ```ts
@@ -55,6 +87,12 @@ export declare class AssetLoader {
     private readonly queue;
     private readonly data;
     private readonly maps;
+    private readonly ldtks;
+    private readonly atlases;
+    /** Decoded audio by key; a key with bytes only waits for a context (`decodeAudio`). */
+    private readonly audioBuffers;
+    private readonly audioBytes;
+    private readonly decoding;
     private readonly fetcher;
     private readonly toCanvas;
     private total;
@@ -70,6 +108,38 @@ export declare class AssetLoader {
     text(key: string, url: string): this;
     /** A Tiled JSON map, then every tileset image it names (resolved beside the map file). */
     tilemap(key: string, url: string, options?: TilemapAssetOptions): this;
+    /**
+     * An LDtk project: the `.ldtk` file, the `.ldtkl` file of each level it saves apart (resolved beside the project),
+     * then every tileset image (resolved beside the project, as LDtk writes `relPath`). Counts as one asset, plus one
+     * per tileset image. Read it back with `ldtkProject(key)`; each level's `map` goes to `TilemapView` as it is.
+     */
+    ldtk(key: string, url: string, options?: LdtkAssetOptions): this;
+    /** A loaded LDtk project. */
+    ldtkProject(key: string): LdtkProject;
+    /**
+     * A TexturePacker (or Pixi) JSON atlas, hash or array format: its page image, and for a multipack atlas every page
+     * named in `meta.related_multi_packs` (each resolved beside the file naming it). The first page is the texture
+     * `key`, further pages `key~1`, `key~2`…, and every frame of every page is found as `textures.get(key, frameName)`.
+     * Counts as one asset in the progress.
+     */
+    atlas(key: string, url: string): this;
+    /**
+     * A web font (woff2, woff, ttf) under `family`, added to `document.fonts` once loaded so canvas text and the DOM can
+     * use it at once — load fonts before the first `Text` is drawn, or it measures with the fallback.
+     */
+    font(family: string, url: string, descriptors?: FontFaceDescriptors): this;
+    /**
+     * A sound file decoded into an `AudioBuffer` through the engine's audio context (`getAudio`). Before any context
+     * exists (browsers open one only after a gesture) the bytes are kept and decoded by `decodeAudio`, so a loading
+     * screen never has to wait for the player to click.
+     */
+    audio(key: string, url: string): this;
+    /** A loaded sound, decoded; null while it waits for an audio context (`decodeAudio`). */
+    getAudio(key: string): AudioBuffer | null;
+    /** A loaded sound, decoding its kept bytes through `ctx` (default: the loader's context) the first time. */
+    decodeAudio(key: string, ctx?: BaseAudioContext): Promise<AudioBuffer>;
+    /** What a loaded atlas holds: its frame names and animations. */
+    getAtlas(key: string): AtlasInfo;
     /** Runs everything queued; `onProgress` after each asset. Safe to call again after queueing more. */
     load(onProgress?: (p: LoadProgress) => void): Promise<void>;
     /** A loaded JSON value. */
@@ -79,7 +149,12 @@ export declare class AssetLoader {
     /** A loaded Tiled map. */
     map(key: string): TileMap;
     private add;
+    private full;
     private request;
     private blob;
+    /** An image file decoded into a canvas; a file that is not an image fails naming its URL. */
+    private canvas;
+    private bytes;
+    private decode;
 }
 //# sourceMappingURL=AssetLoader.d.ts.map

package/dist/types/assets/AssetLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetLoader.d.ts","sourceRoot":"","sources":["../../../src/assets/AssetLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE1E,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAC3D,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;CACpH;AAED,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;QAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC;IAC5I,gGAAgG;IAChG,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,mBAAmB;IAClC,uFAAuF;IACvF,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;CACb;AAID,oGAAoG;AACpG,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAU5D;AAcD;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;IAUpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAV1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6C;IACtE,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,IAAI,CAAK;gBAGE,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,kBAAuB;IAMnD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAMrC,qFAAqF;IACrF,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAM9F,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAMpC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAMpC,0FAA0F;IAC1F,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI;IAS1E,qGAAqG;IAC/F,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAajE,2BAA2B;IAC3B,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAKpC,0BAA0B;IAC1B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI5B,0BAA0B;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAMzB,OAAO,CAAC,GAAG;YAMG,OAAO;YAYP,IAAI;CAGnB"}
+{"version":3,"file":"AssetLoader.d.ts","sourceRoot":"","sources":["../../../src/assets/AssetLoader.ts"],"names":[],"mappings":"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"}

package/dist/types/assets/Prepainter.d.ts

@@ -0,0 +1,64 @@
+/** A painted RGBA image: `w` × `h` pixels, 4 bytes each, row by row (what `ImageData` holds). */
+export interface PaintedPixels {
+    w: number;
+    h: number;
+    pixels: ArrayBuffer;
+}
+/** Paints an item's texture off the main thread (`workerPainter`), or anywhere else that answers with a promise. */
+export interface Painter<T> {
+    paint(item: T, id: string): Promise<PaintedPixels>;
+    /** Stops it for good (a worker terminated). */
+    dispose?(): void;
+}
+/** What a `Prepainter` needs of a texture registry (`TextureRegistry` has it). */
+export interface PrepainterTextures {
+    exists(key: string): boolean;
+    remove(key: string): void;
+    addCanvas(key: string, canvas: HTMLCanvasElement): unknown;
+}
+export interface PrepainterOptions<T> {
+    textures: PrepainterTextures;
+    /** The item's id, unique among items. */
+    id: (item: T) => string;
+    /** The texture key an id's painting is kept under (default the id itself). */
+    key?: (id: string) => string;
+    /** Null where nothing can be painted ahead: then everything is painted on arrival, as without a prepainter. */
+    painter: Painter<T> | null;
+    /** Turns painted pixels into a canvas (default a DOM canvas; tests hand in a stand-in). */
+    canvas?: (painted: PaintedPixels) => HTMLCanvasElement | null;
+    /** Told when a painting landed in the registry. */
+    onPainted?: (id: string) => void;
+}
+/**
+ * Paints ahead the big textures a player may need next (the maps beyond the current one's doors, the next level's
+ * backdrop) so the step into them finds them ready instead of painting them there and then — a large map's ground was
+ * two seconds of main-thread work, which froze the first step through every door. It also frees the rest: each such
+ * texture is one big image, and a long session through thirty-odd places kept every one of them.
+ *
+ * Whatever is not ready yet is the caller's to paint on arrival, as before; a painter that cannot start or fails only
+ * means nothing is painted ahead.
+ */
+export declare class Prepainter<T> {
+    private readonly options;
+    private readonly pending;
+    /** Ids whose painting is held as a texture: the current one and its neighbours. */
+    private readonly held;
+    private readonly key;
+    private destroyed;
+    constructor(options: PrepainterOptions<T>);
+    /**
+     * Stands on `current`: its texture (painted by the caller on arrival, or ahead) and its neighbours' are kept, every
+     * other one this prepainter held is freed, and the neighbours not yet painted are started.
+     */
+    enter(current: T, next: readonly T[]): void;
+    /** Whether `id` is being painted right now (so a caller may wait for it a moment rather than paint it again). */
+    painting(id: string): boolean;
+    /** Ids held as textures now. */
+    get holding(): ReadonlySet<string>;
+    /** Starts painting `item` unless it is painted or under way. */
+    prepare(item: T): void;
+    /** Stops painting; textures already made are left to the registry. */
+    destroy(): void;
+    private receive;
+}
+//# sourceMappingURL=Prepainter.d.ts.map

package/dist/types/assets/Prepainter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prepainter.d.ts","sourceRoot":"","sources":["../../../src/assets/Prepainter.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,oHAAoH;AACpH,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACnD,+CAA+C;IAC/C,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED,kFAAkF;AAClF,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;CAC5D;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,yCAAyC;IACzC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IACxB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7B,+GAA+G;IAC/G,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3B,2FAA2F;IAC3F,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,iBAAiB,GAAG,IAAI,CAAC;IAC9D,mDAAmD;IACnD,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAaD;;;;;;;;GAQG;AACH,qBAAa,UAAU,CAAC,CAAC;IAOX,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,mFAAmF;IACnF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyB;IAC7C,OAAO,CAAC,SAAS,CAAS;gBAEG,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAI1D;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI;IAa3C,iHAAiH;IACjH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI7B,gCAAgC;IAChC,IAAI,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAEjC;IAED,gEAAgE;IAChE,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAatB,sEAAsE;IACtE,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,OAAO;CAYhB"}

package/dist/types/assets/textureAtlas.d.ts

@@ -0,0 +1,35 @@
+import type { PackedFrame } from '../core/TextureRegistry.js';
+/**
+ * Reads TexturePacker's JSON atlases — the "JSON (Hash)" and "JSON (Array)" exports, which Pixi's own `Spritesheet`
+ * also reads — into plain numbers, with no Pixi or DOM, so the parsing is tested under node. A multipack atlas lists
+ * its other pages' JSON files in `meta.related_multi_packs`; the loader follows them and registers every frame of
+ * every page under one key.
+ */
+/** One frame as the registry needs it: where it lies on its page and how it is trimmed or turned. */
+export type AtlasFrame = PackedFrame;
+/** One page of an atlas: its image and its frames. */
+export interface PackedAtlasPage {
+    /** The page image as named in `meta.image`, relative to the JSON file. */
+    image: string;
+    frames: AtlasFrame[];
+    /** Animations by name, each a list of frame names (`animations` in Pixi-flavoured JSON). */
+    animations: Record<string, string[]>;
+    /** Further pages' JSON files (`meta.related_multi_packs`), relative to this one. */
+    related: string[];
+    /** Pixels per unit the page was exported at (`meta.scale`, default 1). */
+    scale: number;
+}
+/** Parses one atlas JSON file; throws naming `where` (its URL) when it is not one. */
+export declare function parseAtlas(json: unknown, where?: string): PackedAtlasPage;
+/**
+ * Every page of a multipack atlas, the first first, each JSON fetched once however the pages name each other
+ * (TexturePacker lists every other page in each page). `load(url)` returns a page's parsed JSON; `resolve` turns a
+ * related name into a URL beside the file naming it.
+ */
+export declare function collectAtlasPages(url: string, load: (url: string) => Promise<PackedAtlasPage>, resolve: (name: string, base: string) => string): Promise<{
+    url: string;
+    page: PackedAtlasPage;
+}[]>;
+/** Frame names that appear on more than one page: the later page's frame wins, which is almost always a mistake. */
+export declare function duplicateFrames(pages: readonly PackedAtlasPage[]): string[];
+//# sourceMappingURL=textureAtlas.d.ts.map

package/dist/types/assets/textureAtlas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textureAtlas.d.ts","sourceRoot":"","sources":["../../../src/assets/textureAtlas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;GAKG;AAEH,qGAAqG;AACrG,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC;AAErC,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,4FAA4F;IAC5F,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC,oFAAoF;IACpF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;CACf;AAsDD,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,SAAU,GAAG,eAAe,CAqB1E;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,EAC/C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,GAC9C,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,EAAE,CAAC,CAgBnD;AAED,oHAAoH;AACpH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,EAAE,CAK3E"}

package/dist/types/assets/workerPainter.d.ts

@@ -0,0 +1,21 @@
+import type { PaintedPixels, Painter } from './Prepainter.js';
+/** What the worker posts back for one request: the painted pixels (the buffer transferred), or why it could not. */
+export type PaintReply = {
+    id: string;
+} & (PaintedPixels | {
+    error: string;
+});
+export interface WorkerPainterOptions<T> {
+    /** Makes the worker, the first time something is painted: `() => new Worker(new URL('./paint.ts', import.meta.url), { type: 'module' })`. */
+    create: () => Worker;
+    /** The message posted for an item (default `{ id, item }`); the worker answers with a `PaintReply` naming that id. */
+    message?: (item: T, id: string) => unknown;
+}
+/**
+ * A `Painter` that paints in a worker. The worker answers each request with a `PaintReply` carrying the request's id,
+ * transferring the pixel buffer (`postMessage(reply, { transfer: [reply.pixels] })`) so nothing is copied back. A
+ * worker that cannot start or fails rejects everything under way and everything after: a prepainter then simply
+ * paints nothing ahead.
+ */
+export declare function workerPainter<T>(options: WorkerPainterOptions<T>): Painter<T>;
+//# sourceMappingURL=workerPainter.d.ts.map

package/dist/types/assets/workerPainter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerPainter.d.ts","sourceRoot":"","sources":["../../../src/assets/workerPainter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE3D,oHAAoH;AACpH,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,CAAC,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE9E,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,6IAA6I;IAC7I,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,sHAAsH;IACtH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAmD7E"}

package/dist/types/audio/SoundEngine.d.ts

@@ -27,6 +27,11 @@ export declare class SoundEngine {
     } | null;
     private onRunning;
     constructor();
+    /**
+     * The effects' audio context once something opened it (the first gesture does), else null: never created here, so
+     * asking does not open a context the browser would hold suspended. `AssetLoader.audio` decodes through it.
+     */
+    get audioContext(): AudioContext | null;
     play(name: string | undefined, opts?: SoundOptions): void;
     private level;
     private context;

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

@@ -1 +1 @@
-{"version":3,"file":"SoundEngine.d.ts","sourceRoot":"","sources":["../../../src/audio/SoundEngine.ts"],"names":[],"mappings":"AAqCA,MAAM,WAAW,YAAY;IAC3B,iGAAiG;IACjG,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iGAAiG;IACjG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAA6B;IACxC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,MAAM,CAAK;IACnB,yFAAyF;IACzF,QAAQ,EAAE,MAAM;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAc;IAC7D,OAAO,CAAC,SAAS,CAAwC;;IAmCzD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,GAAE,YAAiB,GAAG,IAAI;IA0D7D,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,OAAO;IA0Bf;;;OAGG;IACH,OAAO,CAAC,SAAS;IAajB,0EAA0E;IAC1E,OAAO,CAAC,MAAM;CAaf;AAED,eAAO,MAAM,KAAK,aAAoB,CAAC"}
+{"version":3,"file":"SoundEngine.d.ts","sourceRoot":"","sources":["../../../src/audio/SoundEngine.ts"],"names":[],"mappings":"AAqCA,MAAM,WAAW,YAAY;IAC3B,iGAAiG;IACjG,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iGAAiG;IACjG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAA6B;IACxC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,MAAM,CAAK;IACnB,yFAAyF;IACzF,QAAQ,EAAE,MAAM;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAc;IAC7D,OAAO,CAAC,SAAS,CAAwC;;IAmCzD;;;OAGG;IACH,IAAI,YAAY,IAAI,YAAY,GAAG,IAAI,CAEtC;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,GAAE,YAAiB,GAAG,IAAI;IA0D7D,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,OAAO;IA0Bf;;;OAGG;IACH,OAAO,CAAC,SAAS;IAajB,0EAA0E;IAC1E,OAAO,CAAC,MAAM;CAaf;AAED,eAAO,MAAM,KAAK,aAAoB,CAAC"}

package/dist/types/core/Camera.d.ts

@@ -30,7 +30,7 @@ export declare class Camera {
     zoom: number;
     /** The zoom `reset` goes back to: the engine sets it from its `zoom` option (default 1). */
     defaultZoom: number;
-    /** Backing pixels per screen pixel (the renderer's resolution, `zoomResolution`): what `snap` rounds to. */
+    /** Backing pixels per screen pixel (the renderer's resolution, `zoomResolution(zoom, devicePixelRatio)`): what `snap` rounds to. */
     resolution: number;
     /** Lands the view on whole backing pixels (pixel art); off, the world moves smoothly between them. */
     roundPixels: boolean;

package/dist/types/core/Camera.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Camera.d.ts","sourceRoot":"","sources":["../../../src/core/Camera.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mGAAmG;IACnG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,MAAM;IA4Bf,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IA5BzB,IAAI,SAAK;IACT,4FAA4F;IAC5F,WAAW,SAAK;IAChB,4GAA4G;IAC5G,UAAU,SAAK;IACf,sGAAsG;IACtG,WAAW,UAAS;IACpB,OAAO,SAAK;IACZ,OAAO,SAAK;IACZ,KAAK,SAAK;IACV,MAAM,SAAK;IACX,OAAO,CAAC,MAAM,CAAwE;IACtF,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,SAAS,CAAK;IACtB,2GAA2G;IAC3G,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,MAAM,CAA2D;IACzE,OAAO,CAAC,SAAS,CAAoG;IACrH,OAAO,CAAC,SAAS,CAAM;gBAGJ,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,SAAS;IAGpC,IAAI,SAAS,IAAI,QAAQ,CAIxB;IAED,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKxB,oGAAoG;IACpG,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAKvB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKpE,uCAAuC;IACvC,WAAW,IAAI,IAAI;IAKnB;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI;IAYb,kCAAkC;IAClC,IAAI,QAAQ,IAAI;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAEhE;IAED,kDAAkD;IAClD,IAAI,UAAU,IAAI;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAEnH;IAED,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAOpC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAOrC;;;OAGG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAS1D;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAI9B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIhC,kFAAkF;IAClF,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,UAAQ,EAAE,IAAI,SAAI,GAAG,IAAI;IAWlF;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI;IAO3F,OAAO,IAAI,IAAI;IAKf,wEAAwE;IACxE,OAAO,CAAC,OAAO;IAqBf,6FAA6F;IAC7F,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAkCxB,OAAO,CAAC,KAAK;CAQd"}
+{"version":3,"file":"Camera.d.ts","sourceRoot":"","sources":["../../../src/core/Camera.ts"],"names":[],"mappings":"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"}

package/dist/types/core/Clock.d.ts

@@ -1,10 +1,22 @@
-/** Scene time and one-shot timers, advanced by the frame loop. */
+/**
+ * Scene time and one-shot timers, advanced by the frame loop.
+ *
+ * `update` allocates nothing (`runDue`): a game scheduling effect beats every few milliseconds made two filtered
+ * arrays a frame. A timer that throws is reported to `onError` and dropped, and the others due that frame still run.
+ */
 export declare class Clock {
     now: number;
-    private timers;
+    /** Told of every error a timer throws (default: logged). `Stage` routes it into its guarded-step reporting. */
+    onError: (err: unknown) => void;
+    private readonly timers;
+    private readonly due;
+    /** Made once, so `update` hands `runDue` no fresh closure; reads `onError` late so it may be swapped any time. */
+    private readonly report;
     delayedCall(ms: number, fn: () => void): {
         remove: () => void;
     };
+    /** Timers waiting to run (removed ones not yet swept included). */
+    get pending(): number;
     update(now: number): void;
     clear(): void;
 }

package/dist/types/core/Clock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Clock.d.ts","sourceRoot":"","sources":["../../../src/core/Clock.ts"],"names":[],"mappings":"AAMA,kEAAkE;AAClE,qBAAa,KAAK;IAChB,GAAG,SAAqB;IACxB,OAAO,CAAC,MAAM,CAAe;IAE7B,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE;IAM/D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAezB,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"Clock.d.ts","sourceRoot":"","sources":["../../../src/core/Clock.ts"],"names":[],"mappings":"AAgBA;;;;;GAKG;AACH,qBAAa,KAAK;IAChB,GAAG,SAAqB;IACxB,+GAA+G;IAC/G,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAiD;IAChF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,kHAAkH;IAClH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;IAEpE,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE;IAM/D,mEAAmE;IACnE,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzB,KAAK,IAAI,IAAI;CAKd"}

package/dist/types/core/Pointer.d.ts

@@ -16,10 +16,28 @@ export declare class Pointer {
     worldX: number;
     worldY: number;
     private buttons;
+    /** Raw mouse travel (`movementX/Y`) summed since the last `takeMovement`, kept only while the pointer is locked. */
+    private moveX;
+    private moveY;
     private readonly cleanup;
     constructor(canvas: HTMLCanvasElement);
     leftButtonDown(): boolean;
     rightButtonDown(): boolean;
+    /** True while the canvas holds the pointer (`lock`). */
+    get locked(): boolean;
+    /**
+     * Locks the pointer to the canvas for mouse-look: the cursor hides and `takeMovement` returns how far the mouse went.
+     * Call from a press or key handler (browsers allow it only in a gesture); resolves whether the lock holds.
+     */
+    lock(options?: {
+        raw?: boolean;
+    }): Promise<boolean>;
+    unlock(): void;
+    /** The mouse travel (CSS pixels) since the last call while locked, then zeroed; read it once per step. */
+    takeMovement(): {
+        x: number;
+        y: number;
+    };
     updateWorldPoint(cam: Camera): void;
     destroy(): void;
     private track;