@datamoc/mw_games 0.1.1

package/dist/core/Random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Random.js","sourceRoot":"","sources":["../../src/core/Random.ts"],"names":[],"mappings":"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"}

package/dist/core/Replay.d.ts

@@ -0,0 +1,71 @@
+import type { Signal } from './Signal.ts';
+/**
+ * One action dispatched on one frame of the game loop.
+ *
+ * The frame is a count of frames since recording started, not a timestamp: a
+ * replay re-dispatches the same actions at the same frame counts while driving
+ * the loop itself with `Game.step(dt)`, so wall-clock timing never matters.
+ */
+export interface ReplayEvent {
+    frame: number;
+    action: string;
+}
+/**
+ * Records every action dispatched on a signal, stamped with the current frame.
+ *
+ * In a game the two signals are `Input.onAction` and `Game.onFrame`:
+ *
+ * ```ts
+ * const recorder = new Recorder(Input.onAction, game.onFrame);
+ * // ...play...
+ * const saved = serializeReplay(recorder.toJSON());
+ * ```
+ *
+ * The signals are parameters rather than imports so tests can drive a
+ * recorder with plain `Signal` instances instead of a whole `Game`.
+ */
+export declare class Recorder {
+    private frame;
+    private readonly recorded;
+    private readonly actions;
+    private readonly frames;
+    private readonly onAction;
+    private readonly onFrame;
+    constructor(actions: Signal<string>, frames: Signal<number>);
+    get events(): readonly ReplayEvent[];
+    /** A deep copy, safe to serialise or hand to a `Player`. */
+    toJSON(): ReplayEvent[];
+    /** Detaches both listeners; safe to call twice. */
+    stop(): void;
+}
+/**
+ * Re-dispatches recorded events at their recorded frames.
+ *
+ * ```ts
+ * const player = new Player(deserializeReplay(saved), (a) => Input.onAction.dispatch(a), game.onFrame);
+ * // ...drive the loop by hand: game.step(1 / 60) per frame...
+ * ```
+ *
+ * Events are dispatched on the frame signal whose count has reached their
+ * stamp, before the player's own count advances - the same relative point a
+ * live action held during recording. `dispatch` usually forwards into
+ * `Input.onAction`, but tests pass a collector instead.
+ */
+export declare class Player {
+    private frame;
+    private index;
+    private readonly events;
+    private readonly dispatch;
+    private readonly frames;
+    private readonly onFrame;
+    constructor(events: readonly ReplayEvent[], dispatch: (action: string) => void, frames: Signal<number>);
+    /** True once every event has been dispatched. */
+    get done(): boolean;
+    /** Detaches the frame listener; safe to call twice. */
+    stop(): void;
+    private pump;
+}
+export declare function serializeReplay(events: readonly ReplayEvent[]): string;
+/** Parses what `serializeReplay` wrote, rejecting anything else. */
+export declare function deserializeReplay(json: string): ReplayEvent[];
+//# sourceMappingURL=Replay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Replay.d.ts","sourceRoot":"","sources":["../../src/core/Replay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,QAAQ;IACpB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IAErC,YAAY,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAY1D;IAED,IAAI,MAAM,IAAI,SAAS,WAAW,EAAE,CAEnC;IAED,4DAA4D;IAC5D,MAAM,IAAI,WAAW,EAAE,CAEtB;IAED,mDAAmD;IACnD,IAAI,IAAI,IAAI,CAGX;CACD;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,MAAM;IAClB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IAErC,YACC,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAClC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAOtB;IAED,iDAAiD;IACjD,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,uDAAuD;IACvD,IAAI,IAAI,IAAI,CAEX;IAED,OAAO,CAAC,IAAI;CAOZ;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAEtE;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAe7D"}

package/dist/core/Replay.js

@@ -0,0 +1,102 @@
+/**
+ * Records every action dispatched on a signal, stamped with the current frame.
+ *
+ * In a game the two signals are `Input.onAction` and `Game.onFrame`:
+ *
+ * ```ts
+ * const recorder = new Recorder(Input.onAction, game.onFrame);
+ * // ...play...
+ * const saved = serializeReplay(recorder.toJSON());
+ * ```
+ *
+ * The signals are parameters rather than imports so tests can drive a
+ * recorder with plain `Signal` instances instead of a whole `Game`.
+ */
+export class Recorder {
+    constructor(actions, frames) {
+        this.frame = 0;
+        this.recorded = [];
+        this.actions = actions;
+        this.frames = frames;
+        //returns void, never true: recording must not swallow the action
+        this.onAction = (action) => {
+            this.recorded.push({ frame: this.frame, action });
+        };
+        this.onFrame = () => {
+            this.frame++;
+        };
+        actions.add(this.onAction);
+        frames.add(this.onFrame);
+    }
+    get events() {
+        return this.recorded;
+    }
+    /** A deep copy, safe to serialise or hand to a `Player`. */
+    toJSON() {
+        return this.recorded.map((e) => ({ frame: e.frame, action: e.action }));
+    }
+    /** Detaches both listeners; safe to call twice. */
+    stop() {
+        this.actions.remove(this.onAction);
+        this.frames.remove(this.onFrame);
+    }
+}
+/**
+ * Re-dispatches recorded events at their recorded frames.
+ *
+ * ```ts
+ * const player = new Player(deserializeReplay(saved), (a) => Input.onAction.dispatch(a), game.onFrame);
+ * // ...drive the loop by hand: game.step(1 / 60) per frame...
+ * ```
+ *
+ * Events are dispatched on the frame signal whose count has reached their
+ * stamp, before the player's own count advances - the same relative point a
+ * live action held during recording. `dispatch` usually forwards into
+ * `Input.onAction`, but tests pass a collector instead.
+ */
+export class Player {
+    constructor(events, dispatch, frames) {
+        this.frame = 0;
+        this.index = 0;
+        this.events = events;
+        this.dispatch = dispatch;
+        this.frames = frames;
+        this.onFrame = () => this.pump();
+        frames.add(this.onFrame);
+    }
+    /** True once every event has been dispatched. */
+    get done() {
+        return this.index >= this.events.length;
+    }
+    /** Detaches the frame listener; safe to call twice. */
+    stop() {
+        this.frames.remove(this.onFrame);
+    }
+    pump() {
+        while (this.index < this.events.length && this.events[this.index].frame <= this.frame) {
+            this.dispatch(this.events[this.index].action);
+            this.index++;
+        }
+        this.frame++;
+    }
+}
+export function serializeReplay(events) {
+    return JSON.stringify(events);
+}
+/** Parses what `serializeReplay` wrote, rejecting anything else. */
+export function deserializeReplay(json) {
+    const parsed = JSON.parse(json);
+    if (!Array.isArray(parsed))
+        throw new Error('a replay must be an array of {frame, action}');
+    return parsed.map((entry) => {
+        if (typeof entry !== 'object' ||
+            entry === null ||
+            !Number.isInteger(entry.frame) ||
+            entry.frame < 0 ||
+            typeof entry.action !== 'string') {
+            throw new Error('a replay entry must be {frame: a non-negative integer, action: a string}');
+        }
+        return { frame: entry.frame, action: entry.action };
+    });
+}
+//# sourceMappingURL=Replay.js.map

package/dist/core/Replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Replay.js","sourceRoot":"","sources":["../../src/core/Replay.ts"],"names":[],"mappings":"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"}

package/dist/core/Save.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Named save slots, versioned, with a preview - built on plain, JSON-serialisable state
+ * rather than truly arbitrary object graphs. A game's own classes are expected to flatten
+ * themselves the same way `mwg/rpg`'s `GameState` already does (a `toJSON`/reviving
+ * constructor pair), not to be serialised by reference with cycles preserved; that is a
+ * different, much larger problem than a save system needs to solve.
+ */
+export interface SaveMeta {
+    version: number;
+    savedAt: number;
+    /** whatever a save-select screen shows: a summary string, a screenshot data URI, anything */
+    preview?: unknown;
+}
+export interface SaveData<T> {
+    meta: SaveMeta;
+    state: T;
+}
+/** the storage a `SaveSystem` writes through - `localStorage`'s shape, so that is the default */
+export interface SaveStorage {
+    read(key: string): string | null;
+    write(key: string, value: string): void;
+    remove(key: string): void;
+    keys(): string[];
+}
+/** `localStorage` where it exists, the in-memory fallback where it does not (including `file://`) */
+export declare function defaultStorage(): SaveStorage;
+export interface SaveSystemOptions {
+    /** namespaces every slot key, so two games sharing an origin never collide */
+    namespace: string;
+    version: number;
+    /** upgrades state saved at key `v` to version `v + 1`; applied in sequence up to `version` */
+    migrations?: Record<number, (state: unknown) => unknown>;
+    storage?: SaveStorage;
+}
+export declare class SaveSystem<T> {
+    private namespace;
+    private version;
+    private migrations;
+    private storage;
+    constructor(options: SaveSystemOptions);
+    private key;
+    save(slot: string, state: T, preview?: unknown): void;
+    /** reads a slot, migrating it up to the current version if it was saved at an older one */
+    load(slot: string): SaveData<T> | null;
+    delete(slot: string): void;
+    /** every slot with a save, and its metadata - for a save-select screen */
+    list(): Array<{
+        slot: string;
+        meta: SaveMeta;
+    }>;
+}
+//# sourceMappingURL=Save.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Save.d.ts","sourceRoot":"","sources":["../../src/core/Save.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,QAAQ;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAEhB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,CAAC,CAAC;CACT;AAED,iGAAiG;AACjG,MAAM,WAAW,WAAW;IAC3B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,IAAI,MAAM,EAAE,CAAC;CACjB;AAuBD,qGAAqG;AACrG,wBAAgB,cAAc,IAAI,WAAW,CAS5C;AAED,MAAM,WAAW,iBAAiB;IACjC,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAEhB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;IACzD,OAAO,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,qBAAa,UAAU,CAAC,CAAC;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,OAAO,CAAc;IAE7B,YAAY,OAAO,EAAE,iBAAiB,EAKrC;IAED,OAAO,CAAC,GAAG;IAIX,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAGpD;IAED,2FAA2F;IAC3F,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAWrC;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEzB;IAED,0EAA0E;IAC1E,IAAI,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,CAY9C;CACD"}

package/dist/core/Save.js

@@ -0,0 +1,81 @@
+/**
+ * Named save slots, versioned, with a preview - built on plain, JSON-serialisable state
+ * rather than truly arbitrary object graphs. A game's own classes are expected to flatten
+ * themselves the same way `mwg/rpg`'s `GameState` already does (a `toJSON`/reviving
+ * constructor pair), not to be serialised by reference with cycles preserved; that is a
+ * different, much larger problem than a save system needs to solve.
+ */
+/** an in-memory fallback, so saving still works where `localStorage` is unavailable */
+class MemoryStorage {
+    constructor() {
+        this.data = new Map();
+    }
+    read(key) {
+        return this.data.get(key) ?? null;
+    }
+    write(key, value) {
+        this.data.set(key, value);
+    }
+    remove(key) {
+        this.data.delete(key);
+    }
+    keys() {
+        return [...this.data.keys()];
+    }
+}
+/** `localStorage` where it exists, the in-memory fallback where it does not (including `file://`) */
+export function defaultStorage() {
+    if (typeof localStorage === 'undefined')
+        return new MemoryStorage();
+    return {
+        read: (key) => localStorage.getItem(key),
+        write: (key, value) => localStorage.setItem(key, value),
+        remove: (key) => localStorage.removeItem(key),
+        keys: () => Object.keys(localStorage),
+    };
+}
+export class SaveSystem {
+    constructor(options) {
+        this.namespace = options.namespace;
+        this.version = options.version;
+        this.migrations = options.migrations ?? {};
+        this.storage = options.storage ?? defaultStorage();
+    }
+    key(slot) {
+        return `mwg-save:${this.namespace}:${slot}`;
+    }
+    save(slot, state, preview) {
+        const data = { meta: { version: this.version, savedAt: Date.now(), preview }, state };
+        this.storage.write(this.key(slot), JSON.stringify(data));
+    }
+    /** reads a slot, migrating it up to the current version if it was saved at an older one */
+    load(slot) {
+        const raw = this.storage.read(this.key(slot));
+        if (!raw)
+            return null;
+        const data = JSON.parse(raw);
+        let state = data.state;
+        for (let v = data.meta.version; v < this.version; v++) {
+            state = (this.migrations[v] ?? ((s) => s))(state);
+        }
+        return { meta: { ...data.meta, version: this.version }, state: state };
+    }
+    delete(slot) {
+        this.storage.remove(this.key(slot));
+    }
+    /** every slot with a save, and its metadata - for a save-select screen */
+    list() {
+        const prefix = `mwg-save:${this.namespace}:`;
+        const out = [];
+        for (const key of this.storage.keys()) {
+            if (!key.startsWith(prefix))
+                continue;
+            const raw = this.storage.read(key);
+            if (!raw)
+                continue;
+            out.push({ slot: key.slice(prefix.length), meta: JSON.parse(raw).meta });
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=Save.js.map

package/dist/core/Save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Save.js","sourceRoot":"","sources":["../../src/core/Save.ts"],"names":[],"mappings":"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"}

package/dist/core/Scene.d.ts

@@ -0,0 +1,40 @@
+import { Container } from 'pixi.js';
+import { Signal } from './Signal.ts';
+/**
+ * One screen of the game: a title, a menu, the dungeon itself.
+ *
+ * A scene owns a Pixi container and everything in it. Switching scenes destroys the old
+ * one, so a scene may hold whatever state it likes without cleaning up by hand.
+ */
+export declare abstract class Scene {
+    /** everything this scene draws hangs off here */
+    readonly stage: Container<import("pixi.js").ContainerChild>;
+    /** fires when the scene is torn down, for listeners that need to detach */
+    readonly onDestroy: Signal<void>;
+    private destroyed;
+    /** builds the scene's contents; assets are already loaded when this runs */
+    abstract create(): void;
+    /** @param dt seconds since the previous frame, already clamped */
+    update(_dt: number): void;
+    /** the display was resized; the scene may relayout rather than be rebuilt */
+    resize(_width: number, _height: number): void;
+    /**
+     * Called when another scene is pushed on top of this one.
+     *
+     * Updating already stops on its own - only the top scene runs - but input
+     * listeners do not stand down by themselves. A scene holding windows, music
+     * or key handlers pauses or detaches them here; the default does nothing.
+     */
+    onSuspend(): void;
+    /**
+     * Called when the scene above pops, reporting back what it decided.
+     *
+     * @param result whatever the popped scene passed to `popScene` - a choice,
+     * a score, or nothing at all. Games cast it to what their minigame returns.
+     */
+    onResume(_result: unknown): void;
+    destroy(): void;
+    get isDestroyed(): boolean;
+}
+export type SceneClass = new () => Scene;
+//# sourceMappingURL=Scene.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Scene.d.ts","sourceRoot":"","sources":["../../src/core/Scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;GAKG;AACH,8BAAsB,KAAK;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,8CAAmB;IAEjC,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,eAAsB;IAExC,OAAO,CAAC,SAAS,CAAS;IAE1B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC;IAExB,kEAAkE;IAClE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAExB;IAED,6EAA6E;IAC7E,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE5C;IAED;;;;;;OAMG;IACH,SAAS,IAAI,IAAI,CAEhB;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE/B;IAED,OAAO,IAAI,IAAI,CAOd;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;CACD;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,KAAK,CAAC"}

package/dist/core/Scene.js

@@ -0,0 +1,56 @@
+import { Container } from 'pixi.js';
+import { Signal } from './Signal.js';
+/**
+ * One screen of the game: a title, a menu, the dungeon itself.
+ *
+ * A scene owns a Pixi container and everything in it. Switching scenes destroys the old
+ * one, so a scene may hold whatever state it likes without cleaning up by hand.
+ */
+export class Scene {
+    constructor() {
+        /** everything this scene draws hangs off here */
+        this.stage = new Container();
+        /** fires when the scene is torn down, for listeners that need to detach */
+        this.onDestroy = new Signal();
+        this.destroyed = false;
+    }
+    /** @param dt seconds since the previous frame, already clamped */
+    update(_dt) {
+        //scenes that only react to input need no per-frame work
+    }
+    /** the display was resized; the scene may relayout rather than be rebuilt */
+    resize(_width, _height) {
+        //most scenes lay out in create() and are rebuilt instead
+    }
+    /**
+     * Called when another scene is pushed on top of this one.
+     *
+     * Updating already stops on its own - only the top scene runs - but input
+     * listeners do not stand down by themselves. A scene holding windows, music
+     * or key handlers pauses or detaches them here; the default does nothing.
+     */
+    onSuspend() {
+        //scenes with nothing live need nothing stood down
+    }
+    /**
+     * Called when the scene above pops, reporting back what it decided.
+     *
+     * @param result whatever the popped scene passed to `popScene` - a choice,
+     * a score, or nothing at all. Games cast it to what their minigame returns.
+     */
+    onResume(_result) {
+        //scenes that pushed nothing back need nothing reported
+    }
+    destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        this.onDestroy.dispatch();
+        this.onDestroy.removeAll();
+        this.stage.destroy({ children: true });
+    }
+    get isDestroyed() {
+        return this.destroyed;
+    }
+}
+//# sourceMappingURL=Scene.js.map

package/dist/core/Scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scene.js","sourceRoot":"","sources":["../../src/core/Scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;GAKG;AACH,MAAM,OAAgB,KAAK;IAA3B;QACC,iDAAiD;QACxC,UAAK,GAAG,IAAI,SAAS,EAAE,CAAC;QAEjC,2EAA2E;QAClE,cAAS,GAAG,IAAI,MAAM,EAAQ,CAAC;QAEhC,cAAS,GAAG,KAAK,CAAC;IAgD3B,CAAC;IA3CA,kEAAkE;IAClE,MAAM,CAAC,GAAW;QACjB,wDAAwD;IACzD,CAAC;IAED,6EAA6E;IAC7E,MAAM,CAAC,MAAc,EAAE,OAAe;QACrC,yDAAyD;IAC1D,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACR,kDAAkD;IACnD,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAgB;QACxB,uDAAuD;IACxD,CAAC;IAED,OAAO;QACN,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,WAAW;QACd,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;CACD"}

package/dist/core/SceneStack.d.ts

@@ -0,0 +1,37 @@
+import type { Scene } from './Scene.ts';
+/**
+ * The stack of scenes a `Game` runs: exactly one updates, all render.
+ *
+ * `switchScene` replaces the whole stack, for moving between screens.
+ * `pushScene` suspends the current scene and starts another on top of it - a
+ * minigame over the dungeon, a pause menu over play - and `popScene` destroys
+ * the top and resumes whatever was underneath, reporting back a result. Only
+ * the top scene updates; every scene in the stack stays in the display list, so
+ * a pushed scene can be translucent (layered *over*) or opaque (*instead of*).
+ *
+ * Takes instances, never classes: constructing scenes is the `Game`'s job, and
+ * keeping it out is what keeps this testable without a browser.
+ */
+export declare class SceneStack {
+    private scenes;
+    /** the scene that updates, or null when the stack is empty */
+    get current(): Scene | null;
+    get depth(): number;
+    /** replaces everything with one scene, destroying what was there */
+    replace(scene: Scene): void;
+    /** suspends the current scene and starts another above it */
+    push(scene: Scene): void;
+    /**
+     * Destroys the top scene and resumes the one below with `result`.
+     *
+     * Throws when only one scene is left: popping it would leave the game with
+     * nothing to run, which is always an authoring error rather than intent.
+     */
+    pop(result?: unknown): void;
+    /** only the top scene runs; the suspended ones wait underneath */
+    update(dt: number): void;
+    /** every scene relayouts, including the suspended ones waiting underneath */
+    resize(width: number, height: number): void;
+    destroy(): void;
+}
+//# sourceMappingURL=SceneStack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SceneStack.d.ts","sourceRoot":"","sources":["../../src/core/SceneStack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAU;IACtB,OAAO,CAAC,MAAM,CAAe;IAE7B,8DAA8D;IAC9D,IAAI,OAAO,IAAI,KAAK,GAAG,IAAI,CAE1B;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,oEAAoE;IACpE,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAI1B;IAED,6DAA6D;IAC7D,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAIvB;IAED;;;;;OAKG;IACH,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAO1B;IAED,kEAAkE;IAClE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEvB;IAED,6EAA6E;IAC7E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE1C;IAED,OAAO,IAAI,IAAI,CAGd;CACD"}

package/dist/core/SceneStack.js

@@ -0,0 +1,67 @@
+/**
+ * The stack of scenes a `Game` runs: exactly one updates, all render.
+ *
+ * `switchScene` replaces the whole stack, for moving between screens.
+ * `pushScene` suspends the current scene and starts another on top of it - a
+ * minigame over the dungeon, a pause menu over play - and `popScene` destroys
+ * the top and resumes whatever was underneath, reporting back a result. Only
+ * the top scene updates; every scene in the stack stays in the display list, so
+ * a pushed scene can be translucent (layered *over*) or opaque (*instead of*).
+ *
+ * Takes instances, never classes: constructing scenes is the `Game`'s job, and
+ * keeping it out is what keeps this testable without a browser.
+ */
+export class SceneStack {
+    constructor() {
+        this.scenes = [];
+    }
+    /** the scene that updates, or null when the stack is empty */
+    get current() {
+        return this.scenes.length === 0 ? null : this.scenes[this.scenes.length - 1];
+    }
+    get depth() {
+        return this.scenes.length;
+    }
+    /** replaces everything with one scene, destroying what was there */
+    replace(scene) {
+        for (const old of this.scenes)
+            old.destroy();
+        this.scenes = [scene];
+        scene.create();
+    }
+    /** suspends the current scene and starts another above it */
+    push(scene) {
+        this.current?.onSuspend();
+        this.scenes.push(scene);
+        scene.create();
+    }
+    /**
+     * Destroys the top scene and resumes the one below with `result`.
+     *
+     * Throws when only one scene is left: popping it would leave the game with
+     * nothing to run, which is always an authoring error rather than intent.
+     */
+    pop(result) {
+        if (this.scenes.length <= 1) {
+            throw new Error('cannot pop the last scene off the stack - switchScene somewhere instead');
+        }
+        const top = this.scenes.pop();
+        top?.destroy();
+        this.current?.onResume(result);
+    }
+    /** only the top scene runs; the suspended ones wait underneath */
+    update(dt) {
+        this.current?.update(dt);
+    }
+    /** every scene relayouts, including the suspended ones waiting underneath */
+    resize(width, height) {
+        for (const scene of this.scenes)
+            scene.resize(width, height);
+    }
+    destroy() {
+        for (const scene of this.scenes)
+            scene.destroy();
+        this.scenes = [];
+    }
+}
+//# sourceMappingURL=SceneStack.js.map

package/dist/core/SceneStack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneStack.js","sourceRoot":"","sources":["../../src/core/SceneStack.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,UAAU;IAAvB;QACS,WAAM,GAAY,EAAE,CAAC;IAsD9B,CAAC;IApDA,8DAA8D;IAC9D,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,oEAAoE;IACpE,OAAO,CAAC,KAAY;QACnB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM;YAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC;QACtB,KAAK,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,6DAA6D;IAC7D,IAAI,CAAC,KAAY;QAChB,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,KAAK,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,MAAgB;QACnB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAC9B,GAAG,EAAE,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,kEAAkE;IAClE,MAAM,CAAC,EAAU;QAChB,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,6EAA6E;IAC7E,MAAM,CAAC,KAAa,EAAE,MAAc;QACnC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO;QACN,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IAClB,CAAC;CACD"}

package/dist/core/Signal.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A list of listeners that can consume an event.
+ *
+ * Unlike a DOM event, a listener returning `true` stops the dispatch. Input handling in a
+ * roguelike needs that: a modal window has to be able to swallow a keypress before the map
+ * below it sees it.
+ */
+export type SignalListener<T> = (value: T) => boolean | void;
+export declare class Signal<T> {
+    private listeners;
+    private readonly stackMode;
+    /**
+     * @param stackMode when true, new listeners are added at the front rather than the
+     * back, so the most recently opened window is offered the event first.
+     */
+    constructor(stackMode?: boolean);
+    add(listener: SignalListener<T>): void;
+    remove(listener: SignalListener<T>): void;
+    removeAll(): void;
+    get size(): number;
+    /** @returns true if a listener consumed the event */
+    dispatch(value: T): boolean;
+}
+//# sourceMappingURL=Signal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Signal.d.ts","sourceRoot":"","sources":["../../src/core/Signal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,CAAC;AAE7D,qBAAa,MAAM,CAAC,CAAC;IACpB,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IAEpC;;;OAGG;IACH,YAAY,SAAS,UAAQ,EAE5B;IAED,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAKrC;IAED,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAGxC;IAED,SAAS,IAAI,IAAI,CAEhB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAS1B;CACD"}

package/dist/core/Signal.js

@@ -0,0 +1,41 @@
+export class Signal {
+    /**
+     * @param stackMode when true, new listeners are added at the front rather than the
+     * back, so the most recently opened window is offered the event first.
+     */
+    constructor(stackMode = false) {
+        this.listeners = [];
+        this.stackMode = stackMode;
+    }
+    add(listener) {
+        if (!this.listeners.includes(listener)) {
+            if (this.stackMode)
+                this.listeners.unshift(listener);
+            else
+                this.listeners.push(listener);
+        }
+    }
+    remove(listener) {
+        const i = this.listeners.indexOf(listener);
+        if (i !== -1)
+            this.listeners.splice(i, 1);
+    }
+    removeAll() {
+        this.listeners.length = 0;
+    }
+    get size() {
+        return this.listeners.length;
+    }
+    /** @returns true if a listener consumed the event */
+    dispatch(value) {
+        //iterating a copy lets a listener remove itself, or others, mid-dispatch
+        const snapshot = this.listeners.slice();
+        for (const listener of snapshot) {
+            if (this.listeners.includes(listener) && listener(value) === true) {
+                return true;
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=Signal.js.map

package/dist/core/Signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Signal.js","sourceRoot":"","sources":["../../src/core/Signal.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,MAAM;IAIlB;;;OAGG;IACH,YAAY,SAAS,GAAG,KAAK;QAPrB,cAAS,GAAwB,EAAE,CAAC;QAQ3C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,QAA2B;QAC9B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,SAAS;gBAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;;gBAChD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;IACF,CAAC;IAED,MAAM,CAAC,QAA2B;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,SAAS;QACR,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,qDAAqD;IACrD,QAAQ,CAAC,KAAQ;QAChB,yEAAyE;QACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACxC,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;gBACnE,OAAO,IAAI,CAAC;YACb,CAAC;QACF,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;CACD"}