1681-engine 0.0.0-stage → 0.5.9

package/dist/types/rig/rigTypes.d.ts

@@ -0,0 +1,82 @@
+/**
+ * A limb of two bones: [upper angle, upper length, lower angle relative to the upper, lower length]. Angles in
+ * degrees in sprite space of a character facing right (0 = forward, 90 = down), lengths in grid pixels.
+ */
+export type Limb = [number, number, number, number];
+export type Face = 'blink' | 'happy' | 'tired' | 'dizzy';
+/**
+ * A pose of the humanoid rig (a JSON object of bone angles). Every field is optional: a pose that leaves one
+ * out takes it from the pose it is laid over (a guard only moves the weapon arm, an attack keeps the running legs).
+ */
+export interface RigPose {
+    /** Pixels the chest (torso, head, shoulders) sits below its rest height; negative rises. */
+    by?: number;
+    armF?: Limb;
+    armB?: Limb;
+    legF?: Limb;
+    legB?: Limb;
+    /** Offset of both hips from their rest place. */
+    hipDx?: number;
+    hipDy?: number;
+    /** Offset of the head from the chest. */
+    headDx?: number;
+    headDy?: number;
+    face?: Face;
+    /** The head faces backwards. */
+    lookBack?: boolean;
+    /** Pixels the cape and ponytail stream behind while running. */
+    trail?: number;
+    /** Chest expansion and delayed cloth sway of the breathing cycle. */
+    breathe?: boolean;
+    sway?: number;
+    /** The far arm crosses in front of the body (drawing a bow with both hands). */
+    armBFront?: boolean;
+    /** Arm the front arm just swept through, left as a translucent smear. */
+    smearArm?: Limb;
+    /** Tumbling: the torso is a curled ball centred here (grid pixels) instead of standing. */
+    curl?: [number, number];
+}
+/** The rig's proportions (`rig/humanoid.json`), in grid pixels of the 20x24 character frame. */
+export interface RigDef {
+    /** Art pixels per grid pixel of the rendered body. */
+    scale: number;
+    width: number;
+    height: number;
+    /** Top centre of the torso at rest. */
+    chest: [number, number];
+    shoulderF: [number, number];
+    shoulderB: [number, number];
+    /** How much further out both shoulders sit on a bulky body. */
+    bulkyShoulder: number;
+    hipF: [number, number];
+    hipB: [number, number];
+    /** Thickness of the arms and legs. */
+    limbWidth: number;
+    /** Brightness of the far leg and the far arm, which stand in the torso's shadow. */
+    backShade: number;
+    backArmShade: number;
+}
+export interface Point {
+    x: number;
+    y: number;
+}
+/** Joint positions of one solved pose, in grid pixels (fractional). */
+export interface Joints {
+    chest: Point;
+    head: Point;
+    shoulderF: Point;
+    elbowF: Point;
+    wristF: Point;
+    shoulderB: Point;
+    elbowB: Point;
+    wristB: Point;
+    hipF: Point;
+    kneeF: Point;
+    ankleF: Point;
+    hipB: Point;
+    kneeB: Point;
+    ankleB: Point;
+    /** Direction the front forearm points (radians, sprite space facing right): the line a held weapon follows. */
+    forearm: number;
+}
+//# sourceMappingURL=rigTypes.d.ts.map

package/dist/types/rig/rigTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rigTypes.d.ts","sourceRoot":"","sources":["../../../src/rig/rigTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,4FAA4F;IAC5F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,2FAA2F;IAC3F,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzB;AAED,gGAAgG;AAChG,MAAM,WAAW,MAAM;IACrB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,uEAAuE;AACvE,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;IACd,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;IACd,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,KAAK,CAAC;IACd,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,KAAK,CAAC;IACd,+GAA+G;IAC/G,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/save/Autosaver.d.ts

@@ -0,0 +1,43 @@
+import type { SaveStore } from './SaveStore.js';
+/** The clock and timers the autosaver uses; tests hand in fake ones. */
+export interface AutosaveTimers {
+    now(): number;
+    setTimeout(fn: () => void, ms: number): unknown;
+    clearTimeout(handle: unknown): void;
+}
+export interface AutosaverOptions {
+    /** Least time between two saves, ms (default 30,000). */
+    intervalMs?: number;
+    /** Small summary stored beside each save (see `SaveStore.save`). */
+    meta?: () => unknown;
+    /** Told when a save fails; autosaving carries on. */
+    onError?: (err: unknown) => void;
+    timers?: AutosaveTimers;
+}
+/**
+ * Saves a slot when the game says something changed, but never more often than `intervalMs`: a burst of changes
+ * (every pickup in a fight) becomes one save now and one trailing save at the end of the interval with the newest
+ * state. `snapshot` is read when the save happens, not when it was asked for, so the trailing save is never stale.
+ */
+export declare class Autosaver {
+    private readonly store;
+    private readonly slot;
+    private readonly snapshot;
+    private readonly options;
+    private readonly intervalMs;
+    private readonly timers;
+    private lastSave;
+    private dirty;
+    private timer;
+    private inFlight;
+    private disposed;
+    constructor(store: SaveStore, slot: string, snapshot: () => unknown, options?: AutosaverOptions);
+    /** Something worth saving changed. */
+    request(): void;
+    /** Saves now if anything is waiting (leaving the game, a scene change); resolves when it is written. */
+    flush(): Promise<void>;
+    /** Stops autosaving; a pending trailing save is dropped (call `flush` first to keep it). */
+    dispose(): void;
+    private run;
+}
+//# sourceMappingURL=Autosaver.d.ts.map

package/dist/types/save/Autosaver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Autosaver.d.ts","sourceRoot":"","sources":["../../../src/save/Autosaver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,GAAG,IAAI,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC;IACrB,qDAAqD;IACrD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAQD;;;;GAIG;AACH,qBAAa,SAAS;IAUlB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZ1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAAS;gBAGN,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,OAAO,EACvB,OAAO,GAAE,gBAAqB;IAMjD,sCAAsC;IACtC,OAAO,IAAI,IAAI;IAYf,wGAAwG;IAClG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,4FAA4F;IAC5F,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,GAAG;CAsBZ"}

package/dist/types/save/MemoryBackend.d.ts

@@ -0,0 +1,10 @@
+import type { SaveBackend } from './SaveBackend.js';
+/** Slots kept in a map for the life of the page: for tests, tools and a browser that refuses storage. */
+export declare class MemoryBackend implements SaveBackend {
+    readonly entries: Map<string, string>;
+    read(key: string): Promise<string | null>;
+    write(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+    keys(prefix: string): Promise<string[]>;
+}
+//# sourceMappingURL=MemoryBackend.d.ts.map

package/dist/types/save/MemoryBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryBackend.d.ts","sourceRoot":"","sources":["../../../src/save/MemoryBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,yGAAyG;AACzG,qBAAa,aAAc,YAAW,WAAW;IAC/C,QAAQ,CAAC,OAAO,sBAA6B;IAEvC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAG9C"}

package/dist/types/save/SaveBackend.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Where save slots are kept. Asynchronous so a game can plug in IndexedDB, a file through Electron, or a native
+ * key–value store (Capacitor Preferences, a secure store) behind the same `SaveStore`; the synchronous ones
+ * (`WebStorageBackend`, `MemoryBackend`) simply answer at once.
+ */
+export interface SaveBackend {
+    /** The text stored under `key`, or null when there is none. */
+    read(key: string): Promise<string | null>;
+    write(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+    /** Every stored key starting with `prefix`. */
+    keys(prefix: string): Promise<string[]>;
+}
+//# sourceMappingURL=SaveBackend.d.ts.map

package/dist/types/save/SaveBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SaveBackend.d.ts","sourceRoot":"","sources":["../../../src/save/SaveBackend.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,+CAA+C;IAC/C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACzC"}

package/dist/types/save/SaveStore.d.ts

@@ -0,0 +1,73 @@
+import { type Migrations } from './migrateSave.js';
+import type { SaveBackend } from './SaveBackend.js';
+export interface SaveStoreOptions {
+    /** The schema version this build writes; older saves go through `migrations` on load. */
+    version: number;
+    /** `migrations[n]` turns data of version n into version n + 1. */
+    migrations?: Migrations;
+    /** Where slots are kept (default `localStorage`, or memory where there is none). */
+    backend?: SaveBackend;
+    /** Prepended to every slot's key, so two games (or a game and its tools) on one origin never share slots. */
+    prefix?: string;
+    /** Keep the slot's previous good save beside it and fall back to it when the slot is corrupt (default true). */
+    backup?: boolean;
+    /** Wall clock for `savedAt` (default `Date.now`). */
+    now?: () => number;
+}
+/** What a slot holds besides the game's data: shown on a load screen without loading the save. */
+export interface SaveInfo {
+    slot: string;
+    version: number;
+    savedAt: number;
+    /** Whatever small summary the game passed to `save` (level reached, play time, a title). */
+    meta: unknown;
+}
+export type LoadFailure = 'missing' | 'corrupt' | 'too-new' | 'no-migration' | 'migration-failed';
+export type LoadResult<T> = {
+    ok: true;
+    data: T;
+    info: SaveInfo;
+    migrated: boolean;
+    fromBackup: boolean;
+} | {
+    ok: false;
+    slot: string;
+    reason: LoadFailure;
+    error?: unknown;
+};
+/**
+ * Named save slots with a schema version, migrations from older versions, a checksum to catch a damaged slot, and a
+ * backup of the previous save to fall back to. Data must be JSON-safe (plain objects, arrays, strings, finite
+ * numbers, booleans, null).
+ *
+ * ```ts
+ * const saves = new SaveStore({ version: 3, migrations: { 1: addInventory, 2: renameGold } });
+ * await saves.save('slot1', state, { level: 4 });
+ * const r = await saves.load<GameState>('slot1');
+ * if (r.ok) start(r.data); else if (r.reason !== 'missing') warn(r.reason);
+ * ```
+ *
+ * Writes to one slot are queued in order, so an autosave and a manual save never land the wrong way round.
+ */
+export declare class SaveStore {
+    readonly version: number;
+    private readonly backend;
+    private readonly prefix;
+    private readonly migrations;
+    private readonly backup;
+    private readonly now;
+    private readonly queues;
+    constructor(options: SaveStoreOptions);
+    /** Writes `data` to `slot` at the current version. Rejects when the backend does (a full disk, a quota). */
+    save(slot: string, data: unknown, meta?: unknown): Promise<SaveInfo>;
+    /** Reads `slot`, brought to the current version. Never throws for a bad slot: the result says what went wrong. */
+    load<T>(slot: string): Promise<LoadResult<T>>;
+    /** Removes a slot and its backup. */
+    delete(slot: string): Promise<void>;
+    /** Every slot that reads, newest first, without migrating its data. A damaged slot is left out. */
+    list(): Promise<SaveInfo[]>;
+    private open;
+    private key;
+    private queued;
+}
+//# sourceMappingURL=SaveStore.d.ts.map

package/dist/types/save/SaveStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SaveStore.d.ts","sourceRoot":"","sources":["../../../src/save/SaveStore.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,MAAM,WAAW,gBAAgB;IAC/B,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,oFAAoF;IACpF,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,6GAA6G;IAC7G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gHAAgH;IAChH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,kGAAkG;AAClG,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,kBAAkB,CAAC;AAElG,MAAM,MAAM,UAAU,CAAC,CAAC,IACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAC7E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAmBtE;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;gBAElD,OAAO,EAAE,gBAAgB;IAUrC,4GAA4G;IAC5G,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAE,OAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiB1E,kHAAkH;IAClH,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAU7C,qCAAqC;IACrC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnC,mGAAmG;IAC7F,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YAYnB,IAAI;IAclB,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,MAAM;CAUf"}

package/dist/types/save/WebStorageBackend.d.ts

@@ -0,0 +1,14 @@
+import type { SaveBackend } from './SaveBackend.js';
+/**
+ * Slots in a Web Storage area, `localStorage` by default. Small and synchronous, so keep saves to a few hundred KB:
+ * browsers allow about 5 MB a site, and a write over that throws (reported to the caller of `save`).
+ */
+export declare class WebStorageBackend implements SaveBackend {
+    private readonly storage;
+    constructor(storage?: Storage);
+    read(key: string): Promise<string | null>;
+    write(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+    keys(prefix: string): Promise<string[]>;
+}
+//# sourceMappingURL=WebStorageBackend.d.ts.map

package/dist/types/save/WebStorageBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebStorageBackend.d.ts","sourceRoot":"","sources":["../../../src/save/WebStorageBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,GAAE,OAAiC;IAIjE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAQ9C"}

package/dist/types/save/checksum.d.ts

@@ -0,0 +1,7 @@
+/**
+ * FNV-1a over the UTF-16 code units of `text`, as 8 hex digits. Not a defence against tampering (anyone can
+ * recompute it); it catches a slot cut short by a full disk, a crash mid-write or a hand edit gone wrong, which is
+ * what a save needs to tell before it loads half a world.
+ */
+export declare function checksum(text: string): string;
+//# sourceMappingURL=checksum.d.ts.map

package/dist/types/save/checksum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../../../src/save/checksum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO7C"}

package/dist/types/save/migrateSave.d.ts

@@ -0,0 +1,17 @@
+/** Steps that bring saved data forward one schema version each: `migrations[n]` turns version n into n + 1. */
+export type Migrations = Readonly<Record<number, (data: unknown) => unknown>>;
+/** Why data could not be brought to the current version. */
+export declare class MigrationError extends Error {
+    readonly reason: 'too-new' | 'no-migration' | 'migration-failed';
+    readonly fromVersion: number;
+    constructor(message: string, reason: 'too-new' | 'no-migration' | 'migration-failed', fromVersion: number, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Runs the chain from `from` up to `to`, one step at a time, so a save three versions old goes through every step
+ * written since rather than needing a direct path from each old version. Data newer than the game (a save from a
+ * later build, then a downgrade) is refused rather than read wrong.
+ */
+export declare function migrateSave(data: unknown, from: number, to: number, migrations: Migrations): unknown;
+//# sourceMappingURL=migrateSave.d.ts.map

package/dist/types/save/migrateSave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrateSave.d.ts","sourceRoot":"","sources":["../../../src/save/migrateSave.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC;AAE9E,4DAA4D;AAC5D,qBAAa,cAAe,SAAQ,KAAK;IAGrC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,GAAG,kBAAkB;IAChE,QAAQ,CAAC,WAAW,EAAE,MAAM;gBAF5B,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,SAAS,GAAG,cAAc,GAAG,kBAAkB,EACvD,WAAW,EAAE,MAAM,EAC5B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKhC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAepG"}

package/dist/types/settings.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The few player settings the engine itself reads. A game keeps its own settings store and mirrors these fields
+ * into this one (`engineSettings.set`) whenever they change; the engine never reads the game's store.
+ */
+export interface EngineSettings {
+    /** Fewer particles and lighter effects. */
+    reducedFx: boolean;
+    /** Turns off everything that only costs battery: transient lights, heavy particles. */
+    batterySaver: boolean;
+    /** Short-lived lights a fight throws into the dark (`pixel/lights.ts`). */
+    combatLights: boolean;
+    /** 0–1, the combat sounds' volume (`audio/SoundEngine.ts`). */
+    sfxVolume: number;
+    /** 0–1, the music's volume. */
+    musicVolume: number;
+}
+export type SettingsListener = (s: EngineSettings) => void;
+/** Same shape as the zustand stores the game used (`getState`, `subscribe`), so moved code reads it unchanged. */
+export declare const engineSettings: {
+    getState(): EngineSettings;
+    set(patch: Partial<EngineSettings>): void;
+    subscribe(listener: SettingsListener): () => void;
+    reset(): void;
+};
+//# sourceMappingURL=settings.d.ts.map

package/dist/types/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,uFAAuF;IACvF,YAAY,EAAE,OAAO,CAAC;IACtB,2EAA2E;IAC3E,YAAY,EAAE,OAAO,CAAC;IACtB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;AAa3D,kHAAkH;AAClH,eAAO,MAAM,cAAc;gBACb,cAAc;eAGf,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;wBAIrB,gBAAgB,GAAG,MAAM,IAAI;aAIxC,IAAI;CAGd,CAAC"}

package/dist/types/tilemap/TilemapView.d.ts

@@ -0,0 +1,42 @@
+import { Container } from 'pixi.js';
+import type { Stage } from '../core/Stage.js';
+import { type TileMap, type Tileset } from './tiled.js';
+export interface TilemapViewOptions {
+    /** The texture key holding a tileset's image (loaded with `AssetLoader.image`, or painted). Default: `tileset.name`. */
+    textureFor?: (tileset: Tileset) => string;
+    /** Tiles per chunk side (default 32): each chunk is painted once into a texture of its own. */
+    chunkTiles?: number;
+    /** Only these tile layers, by name; default every visible tile layer. */
+    layers?: string[];
+    /**
+     * Depth of the first layer in the world layer; each layer after it one higher. Bodies are usually drawn at their y,
+     * so the default keeps the map under every one of them. A layer with a numeric `depth` property is drawn there
+     * instead (a roof layer over the bodies: `depth` = 1e6).
+     */
+    baseDepth?: number;
+    /** Where the layers go (default the stage's world layer); a scene passes its `root` so they leave with it. */
+    parent?: Container;
+}
+/**
+ * Draws a Tiled map's tile layers. Each layer is cut into chunks painted once into textures; a frame only toggles
+ * which chunks are in view (`update`), so a map of any size costs a handful of sprites a frame.
+ *
+ * Animated tiles are drawn on their first frame.
+ */
+export declare class TilemapView {
+    private readonly stage;
+    readonly map: TileMap;
+    /** One container per drawn tile layer, by name, each at its own depth among the bodies. */
+    readonly layers: Map<string, Container<import("pixi.js").ContainerChild>>;
+    private readonly chunks;
+    private readonly id;
+    constructor(stage: Stage, map: TileMap, options?: TilemapViewOptions);
+    /** Shows only the chunks in the camera's view (plus a margin in world px). Call once a frame. */
+    update(margin?: number): void;
+    /** World size of the map in px. */
+    get widthPx(): number;
+    get heightPx(): number;
+    destroy(): void;
+    private paintChunk;
+}
+//# sourceMappingURL=TilemapView.d.ts.map

package/dist/types/tilemap/TilemapView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TilemapView.d.ts","sourceRoot":"","sources":["../../../src/tilemap/TilemapView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAU,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAA4D,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAE/G,MAAM,WAAW,kBAAkB;IACjC,wHAAwH;IACxH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IAC1C,+FAA+F;IAC/F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8GAA8G;IAC9G,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAID;;;;;GAKG;AACH,qBAAa,WAAW;IAOpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,QAAQ,CAAC,GAAG,EAAE,OAAO;IAPvB,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,2DAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqF;IAC5G,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;gBAGd,KAAK,EAAE,KAAK,EACpB,GAAG,EAAE,OAAO,EACrB,OAAO,GAAE,kBAAuB;IA0BlC,iGAAiG;IACjG,MAAM,CAAC,MAAM,SAAK,GAAG,IAAI;IAOzB,mCAAmC;IACnC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,UAAU;CA0CnB"}

package/dist/types/tilemap/collision.d.ts

@@ -0,0 +1,16 @@
+import { type CollisionGrid, type CollisionGridOptions } from '../net/movement.js';
+import { type TileMap } from './tiled.js';
+export interface TiledCollisionOptions extends Omit<CollisionGridOptions, 'ground'> {
+    /**
+     * What makes a cell solid:
+     * - a layer name: every non-empty cell of that tile layer is solid (a hidden "collision" layer is the usual way);
+     * - `{ property }`: a cell is solid when its tile has that custom property set to true, on any tile layer.
+     * Default: the layer named "collision" if there is one, else tiles with a `solid` property.
+     */
+    solid?: string | {
+        property: string;
+    };
+}
+/** The `CollisionGrid` of a Tiled map, for `stepMover`; cells are the map's tiles. */
+export declare function collisionFromTiled(map: TileMap, options?: TiledCollisionOptions): CollisionGrid;
+//# sourceMappingURL=collision.d.ts.map

package/dist/types/tilemap/collision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collision.d.ts","sourceRoot":"","sources":["../../../src/tilemap/collision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACrG,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAEtD,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC;IACjF;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,qBAA0B,GAAG,aAAa,CAsBnG"}

package/dist/types/tilemap/tiled.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Maps made in Tiled (https://www.mapeditor.org), read from its JSON format (`.tmj`, or `.json`). Supported:
+ * orthogonal, finite maps; tile layers as CSV arrays or uncompressed base64; object layers; group layers (flattened);
+ * custom properties; flipped tiles. Not supported (refused with a message saying so): infinite maps, compressed layer
+ * data, isometric and hexagonal maps, external `.tsj` tilesets (embed them: Map → Embed Tilesets).
+ *
+ * Pure: no Pixi, no DOM, so a server can read the same map for collision.
+ */
+/** The three flags Tiled keeps in a gid's high bits; the rest is the tile id. */
+export declare const FLIP_H = 2147483648;
+export declare const FLIP_V = 1073741824;
+export declare const FLIP_D = 536870912;
+export type TiledPropertyValue = string | number | boolean;
+export type Properties = Record<string, TiledPropertyValue>;
+export interface TileLayer {
+    kind: 'tiles';
+    name: string;
+    /** Row-major gids (0 = empty), flip flags kept. Read the tile id with `gidOf`. */
+    data: Uint32Array;
+    visible: boolean;
+    opacity: number;
+    offsetX: number;
+    offsetY: number;
+    properties: Properties;
+}
+export interface MapObject {
+    id: number;
+    name: string;
+    type: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+    /** A tile object's gid, if it is one. */
+    gid?: number;
+    point: boolean;
+    ellipse: boolean;
+    polygon?: {
+        x: number;
+        y: number;
+    }[];
+    properties: Properties;
+}
+export interface ObjectLayer {
+    kind: 'objects';
+    name: string;
+    objects: MapObject[];
+    visible: boolean;
+    properties: Properties;
+}
+export type MapLayer = TileLayer | ObjectLayer;
+export interface Tileset {
+    name: string;
+    firstGid: number;
+    /** The image's path as written in the map, relative to the map file. */
+    image: string;
+    imageWidth: number;
+    imageHeight: number;
+    tileWidth: number;
+    tileHeight: number;
+    columns: number;
+    tileCount: number;
+    margin: number;
+    spacing: number;
+    /** Per local tile id: its custom properties. */
+    tileProperties: Map<number, Properties>;
+    /** Per local tile id: an animation (local tile ids and how long each shows, ms). */
+    animations: Map<number, {
+        tileId: number;
+        duration: number;
+    }[]>;
+    properties: Properties;
+}
+export interface TileMap {
+    width: number;
+    height: number;
+    tileWidth: number;
+    tileHeight: number;
+    layers: MapLayer[];
+    tilesets: Tileset[];
+    properties: Properties;
+    backgroundColor?: string;
+}
+/** The tile id of a gid, without its flip flags. */
+export declare const gidOf: (raw: number) => number;
+/** Which tileset a gid belongs to, and the tile's id inside it; null for an empty cell or an unknown gid. */
+export declare function tileAt(map: TileMap, raw: number): {
+    tileset: Tileset;
+    local: number;
+} | null;
+/** Where tile `local` sits in its tileset image. */
+export declare function tileRect(ts: Tileset, local: number): {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};
+export declare function layerByName(map: TileMap, name: string): MapLayer | undefined;
+/** Every object of every object layer (optionally only those of one `type`/class). */
+export declare function objectsOf(map: TileMap, type?: string): MapObject[];
+/** Reads a Tiled JSON map (already parsed with `JSON.parse`). Throws a `Tiled map: …` error saying what is wrong. */
+export declare function parseTiled(json: unknown): TileMap;
+//# sourceMappingURL=tiled.d.ts.map

package/dist/types/tilemap/tiled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiled.d.ts","sourceRoot":"","sources":["../../../src/tilemap/tiled.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,iFAAiF;AACjF,eAAO,MAAM,MAAM,aAAa,CAAC;AACjC,eAAO,MAAM,MAAM,aAAa,CAAC;AACjC,eAAO,MAAM,MAAM,YAAa,CAAC;AAGjC,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAE5D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrC,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAE/C,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,oFAAoF;IACpF,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IAChE,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,oDAAoD;AACpD,eAAO,MAAM,KAAK,GAAI,KAAK,MAAM,KAAG,MAAwB,CAAC;AAE7D,6GAA6G;AAC7G,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO5F;AAED,oDAAoD;AACpD,wBAAgB,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAInG;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAE5E;AAED,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAIlE;AAoHD,qHAAqH;AACrH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAoBjD"}

package/dist/types/transitions/CrossfadeTransition.d.ts

@@ -0,0 +1,20 @@
+import type { Transition, TransitionContext } from './Transition.js';
+export interface CrossfadeOptions {
+    /** Ms the old scene takes to fade out over the new one (default 400). */
+    duration?: number;
+}
+/**
+ * The old scene's last frame laid over the new scene and faded out. Two live scenes cannot both be drawn (the old
+ * one is gone once the new one enters), so the old frame is captured into one screen-sized render texture, freed
+ * when the transition ends. The new scene's `onEnter` runs under the still frame, so a long load reads as a pause.
+ */
+export declare class CrossfadeTransition implements Transition {
+    private readonly options;
+    private still;
+    private texture;
+    constructor(options?: CrossfadeOptions);
+    cover(ctx: TransitionContext): Promise<void>;
+    reveal(ctx: TransitionContext): Promise<void>;
+    dispose(): void;
+}
+//# sourceMappingURL=CrossfadeTransition.d.ts.map

package/dist/types/transitions/CrossfadeTransition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrossfadeTransition.d.ts","sourceRoot":"","sources":["../../../src/transitions/CrossfadeTransition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGlE,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,UAAU;IAIxC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,OAAO,CAA8B;gBAEhB,OAAO,GAAE,gBAAqB;IAErD,KAAK,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5C,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,OAAO,IAAI,IAAI;CAMhB"}

package/dist/types/transitions/DitherWipeTransition.d.ts

@@ -0,0 +1,35 @@
+import type { Transition, TransitionContext } from './Transition.js';
+export interface DitherWipeOptions {
+    /** `0xrrggbb` (default black). */
+    color?: number;
+    /** Ms for each half (default 450). */
+    duration?: number;
+    /** The way the wipe travels, or 'none' for the whole screen dissolving at once (default 'right'). */
+    direction?: 'left' | 'right' | 'up' | 'down' | 'none';
+    /** Screen pixels per dither cell (default the main camera's zoom, so a cell is one world pixel). */
+    cell?: number;
+    /** Share of the screen the dithered edge spans (default 0.35). */
+    softness?: number;
+}
+/**
+ * A pixel-friendly wipe: the screen fills with an ordered-dither pattern whose density sweeps across it, in hard
+ * whole cells rather than a smooth gradient. The screen is cut into bands along the direction of travel, each a
+ * tiling sprite of one dither level, so a frame costs a texture swap per band rather than a rect per cell (a
+ * 1080p screen at 2-px cells is half a million cells). Bands are whole tiles wide so the pattern runs on unbroken.
+ */
+export declare class DitherWipeTransition implements Transition {
+    private readonly options;
+    private readonly bands;
+    private root;
+    private stopResize;
+    private readonly state;
+    private reversed;
+    constructor(options?: DitherWipeOptions);
+    cover(ctx: TransitionContext): Promise<void>;
+    reveal(ctx: TransitionContext): Promise<void>;
+    dispose(): void;
+    private run;
+    private layout;
+    private paint;
+}
+//# sourceMappingURL=DitherWipeTransition.d.ts.map

package/dist/types/transitions/DitherWipeTransition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DitherWipeTransition.d.ts","sourceRoot":"","sources":["../../../src/transitions/DitherWipeTransition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAIlE,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qGAAqG;IACrG,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IACtD,oGAAoG;IACpG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAoBD;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,UAAU;IAOzC,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAS;gBAEI,OAAO,GAAE,iBAAsB;IAEtD,KAAK,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,GAAG;IAUX,OAAO,CAAC,MAAM;IA8Bd,OAAO,CAAC,KAAK;CAed"}

package/dist/types/transitions/FadeTransition.d.ts

@@ -0,0 +1,20 @@
+import type { Transition, TransitionContext } from './Transition.js';
+export interface FadeOptions {
+    /** `0xrrggbb` (default black). */
+    color?: number;
+    /** Ms for each half (default 300). */
+    duration?: number;
+    /** Ms to rest fully covered before revealing (default 0). */
+    hold?: number;
+}
+/** Fades to a colour, swaps the scene, fades back. */
+export declare class FadeTransition implements Transition {
+    private readonly options;
+    private sheet;
+    private stopResize;
+    constructor(options?: FadeOptions);
+    cover(ctx: TransitionContext): Promise<void>;
+    reveal(ctx: TransitionContext): Promise<void>;
+    dispose(): void;
+}
+//# sourceMappingURL=FadeTransition.d.ts.map

package/dist/types/transitions/FadeTransition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FadeTransition.d.ts","sourceRoot":"","sources":["../../../src/transitions/FadeTransition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGlE,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,sDAAsD;AACtD,qBAAa,cAAe,YAAW,UAAU;IAInC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,UAAU,CAA6B;gBAElB,OAAO,GAAE,WAAgB;IAEhD,KAAK,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5C,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnD,OAAO,IAAI,IAAI;CAMhB"}