@datamoc/mw_games 0.1.1

package/dist/core/Achievements.js

@@ -0,0 +1,80 @@
+/**
+ * Achievements: named milestones unlocked by counters crossing a target - monsters
+ * slain, gold collected, floors descended, runs won.
+ *
+ * The shape every badge/achievement list shares: a definition names a counter and the
+ * value that earns it, the game increments counters as things happen, and unlocking is
+ * derived (a counter at or past its target), never stored separately - so a counter
+ * can only ever move one way and an unlocked achievement can never disagree with the
+ * count behind it. Descriptions are display text `mwg` never reads; persistence is the
+ * usual definitions-fresh, progress-saved split (`QuestLog`'s own convention).
+ */
+export class Achievements {
+    constructor() {
+        this.definitions = new Map();
+        this.counts = new Map();
+        /** every achievement id unlocked since the last `drainNew` call, oldest first */
+        this.fresh = [];
+    }
+    define(definition) {
+        this.definitions.set(definition.id, definition);
+    }
+    /** the current value of a counter; 0 for one nothing has touched yet */
+    count(counter) {
+        return this.counts.get(counter) ?? 0;
+    }
+    /**
+     * Adds to a counter, unlocking whatever that newly earns.
+     *
+     * @returns the ids unlocked by exactly this increment, so a game can announce each
+     * one once ("Achievement unlocked: ...") rather than re-scanning everything
+     */
+    increment(counter, amount = 1) {
+        const before = this.count(counter);
+        this.counts.set(counter, before + amount);
+        const earned = [];
+        for (const definition of this.definitions.values()) {
+            if (definition.counter !== counter)
+                continue;
+            if (before < definition.target && before + amount >= definition.target) {
+                earned.push(definition.id);
+                this.fresh.push(definition.id);
+            }
+        }
+        return earned;
+    }
+    /** whether an achievement's counter has reached its target - throws for an unknown id */
+    unlocked(id) {
+        const definition = this.definitions.get(id);
+        if (!definition)
+            throw new Error(`no such achievement: "${id}"`);
+        return this.count(definition.counter) >= definition.target;
+    }
+    /** progress towards an achievement: current count and target - throws for an unknown id */
+    progress(id) {
+        const definition = this.definitions.get(id);
+        if (!definition)
+            throw new Error(`no such achievement: "${id}"`);
+        return { count: this.count(definition.counter), target: definition.target };
+    }
+    /** every id unlocked but not yet announced, clearing the queue as it reads */
+    drainNew() {
+        const out = this.fresh;
+        this.fresh = [];
+        return out;
+    }
+    toJSON() {
+        return { counts: [...this.counts] };
+    }
+    /** rebuilds achievements from save data - definitions are supplied fresh, the same as `QuestLog` */
+    static fromJSON(definitions, data) {
+        const achievements = new Achievements();
+        for (const definition of definitions)
+            achievements.define(definition);
+        for (const [counter, count] of data.counts)
+            achievements.counts.set(counter, count);
+        //a loaded game announces nothing: whatever was earned was earned before the save
+        return achievements;
+    }
+}
+//# sourceMappingURL=Achievements.js.map

package/dist/core/Achievements.js.map

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

package/dist/core/Collection.d.ts

@@ -0,0 +1,46 @@
+import { type SaveStorage } from './Save.ts';
+/**
+ * One JSON record in a `Collection`: a string id plus whatever fields the game
+ * keeps - quest stages, bestiary sightings, achievements.
+ */
+export interface DbRecord {
+    id: string;
+    [field: string]: unknown;
+}
+export interface CollectionOptions {
+    /** key prefix, so two games sharing a browser never meet; defaults to the game's name */
+    namespace?: string;
+    /** defaults to `localStorage`, falling back to memory where it is unavailable */
+    storage?: SaveStorage;
+}
+/**
+ * A named collection of records, queried and filtered - the shape `SaveSystem`
+ * does not cover. A save slot is one blob loaded wholesale; a collection is many
+ * small records asked questions: `where((q) => !q.done)` is "everything not yet
+ * completed".
+ *
+ * Every call hits the storage directly - nothing is cached, so there is no copy
+ * to go stale, and two `Collection` objects over the same name agree trivially.
+ * Records come back in insertion order. Built for logs and bestiaries (hundreds
+ * of records), not for anything scanned per frame.
+ */
+export declare class Collection {
+    private readonly prefix;
+    private readonly storage;
+    constructor(name: string, options?: CollectionOptions);
+    /** how many records the collection holds */
+    get size(): number;
+    /** every record, in insertion order */
+    all(): DbRecord[];
+    get(id: string): DbRecord | undefined;
+    /** inserts or replaces the record with the same id */
+    put(record: DbRecord): void;
+    remove(id: string): void;
+    /** the records a predicate keeps - "everything not yet completed" reads exactly like that */
+    where(predicate: (record: DbRecord) => boolean): DbRecord[];
+    /** empties this collection, and nothing else sharing the storage */
+    clear(): void;
+    private keys;
+    private read;
+}
+//# sourceMappingURL=Collection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Collection.d.ts","sourceRoot":"","sources":["../../src/core/Collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IACjC,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,OAAO,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IAEtC,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,EAIxD;IAED,4CAA4C;IAC5C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,uCAAuC;IACvC,GAAG,IAAI,QAAQ,EAAE,CAEhB;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAGpC;IAED,sDAAsD;IACtD,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAQ1B;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEvB;IAED,6FAA6F;IAC7F,KAAK,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,OAAO,GAAG,QAAQ,EAAE,CAE1D;IAED,oEAAoE;IACpE,KAAK,IAAI,IAAI,CAEZ;IAED,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,IAAI;CAGZ"}

package/dist/core/Collection.js

@@ -0,0 +1,61 @@
+import { defaultStorage } from './Save.js';
+/**
+ * A named collection of records, queried and filtered - the shape `SaveSystem`
+ * does not cover. A save slot is one blob loaded wholesale; a collection is many
+ * small records asked questions: `where((q) => !q.done)` is "everything not yet
+ * completed".
+ *
+ * Every call hits the storage directly - nothing is cached, so there is no copy
+ * to go stale, and two `Collection` objects over the same name agree trivially.
+ * Records come back in insertion order. Built for logs and bestiaries (hundreds
+ * of records), not for anything scanned per frame.
+ */
+export class Collection {
+    constructor(name, options = {}) {
+        if (!name)
+            throw new Error('a collection needs a name');
+        this.prefix = `mwg-db:${options.namespace ?? 'default'}:${name}:`;
+        this.storage = options.storage ?? defaultStorage();
+    }
+    /** how many records the collection holds */
+    get size() {
+        return this.keys().length;
+    }
+    /** every record, in insertion order */
+    all() {
+        return this.keys().map((key) => this.read(key));
+    }
+    get(id) {
+        const raw = this.storage.read(this.prefix + id);
+        return raw === null ? undefined : JSON.parse(raw);
+    }
+    /** inserts or replaces the record with the same id */
+    put(record) {
+        if (typeof record !== 'object' || record === null || Array.isArray(record)) {
+            throw new Error('a record must be an object with a string id');
+        }
+        if (typeof record.id !== 'string' || record.id === '') {
+            throw new Error('a record must be an object with a string id');
+        }
+        this.storage.write(this.prefix + record.id, JSON.stringify(record));
+    }
+    remove(id) {
+        this.storage.remove(this.prefix + id);
+    }
+    /** the records a predicate keeps - "everything not yet completed" reads exactly like that */
+    where(predicate) {
+        return this.all().filter(predicate);
+    }
+    /** empties this collection, and nothing else sharing the storage */
+    clear() {
+        for (const key of this.keys())
+            this.storage.remove(key);
+    }
+    keys() {
+        return this.storage.keys().filter((key) => key.startsWith(this.prefix));
+    }
+    read(key) {
+        return JSON.parse(this.storage.read(key));
+    }
+}
+//# sourceMappingURL=Collection.js.map

package/dist/core/Collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Collection.js","sourceRoot":"","sources":["../../src/core/Collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAoB,MAAM,WAAW,CAAC;AAkB7D;;;;;;;;;;GAUG;AACH,MAAM,OAAO,UAAU;IAItB,YAAY,IAAY,EAAE,OAAO,GAAsB,EAAE;QACxD,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,GAAG,UAAU,OAAO,CAAC,SAAS,IAAI,SAAS,IAAI,IAAI,GAAG,CAAC;QAClE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,EAAE,CAAC;IACpD,CAAC;IAED,4CAA4C;IAC5C,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,uCAAuC;IACvC,GAAG;QACF,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,GAAG,CAAC,EAAU;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QAChD,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;IACjE,CAAC;IAED,sDAAsD;IACtD,GAAG,CAAC,MAAgB;QACnB,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,CAAC,EAAU;QAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,6FAA6F;IAC7F,KAAK,CAAC,SAAwC;QAC7C,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,oEAAoE;IACpE,KAAK;QACJ,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE;YAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IAEO,IAAI;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACzE,CAAC;IAEO,IAAI,CAAC,GAAW;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAW,CAAa,CAAC;IACjE,CAAC;CACD"}

package/dist/core/Game.d.ts

@@ -0,0 +1,115 @@
+import { Application } from 'pixi.js';
+import type { Scene, SceneClass } from './Scene.ts';
+import { Signal } from './Signal.ts';
+export interface GameOptions {
+    /** the canvas to draw into; one is created and appended if omitted */
+    canvas?: HTMLCanvasElement;
+    /** background colour behind everything, as 0xRRGGBB */
+    background?: number;
+    /**
+     * Longest frame the game will simulate, in seconds.
+     *
+     * A backgrounded tab reports an enormous delta on its first frame back, which would
+     * teleport everything that moves. Frames longer than this are treated as this long,
+     * so the game slows down rather than jumping.
+     */
+    maxDelta?: number;
+    /**
+     * Pixel art is never smoothed when scaled - both inside the game (texture sampling)
+     * and in the browser's own compositing of the canvas element onto the page, which is a
+     * separate step and blurs on its own if left at the default. Set false for a game whose
+     * art is not pixel art and should smooth when magnified.
+     */
+    pixelArt?: boolean;
+    /**
+     * What the renderer sizes itself to. Defaults to the window.
+     *
+     * Sizing to the canvas's parent looks tidier but circles: a canvas styled to fill its
+     * parent gives the parent no height of its own, so both collapse. Pass an element only
+     * when that element has a size the canvas does not depend on.
+     */
+    resizeTo?: HTMLElement | Window;
+}
+/**
+ * The application: owns the renderer, the loop, and the current scene.
+ *
+ * Construct it, `await start(FirstScene)`, and the rest is scenes.
+ */
+export declare class Game {
+    private static instance;
+    readonly app: Application<import("pixi.js").Renderer>;
+    /** seconds elapsed in the previous frame, clamped by `maxDelta` */
+    elapsed: number;
+    /** total seconds since the current scene was created */
+    timeTotal: number;
+    /** multiplies elapsed time; 0 pauses the game without stopping the renderer */
+    timeScale: number;
+    /** fires after every frame's update, for systems that are not scene-owned */
+    readonly onFrame: Signal<number>;
+    private stack;
+    private pending;
+    private options;
+    private started;
+    constructor(options?: GameOptions);
+    /** the viewport width in css pixels, which is what scenes lay out against */
+    get width(): number;
+    get height(): number;
+    /** the running game, for the few places that genuinely need a global */
+    static get current(): Game;
+    start(first: SceneClass): Promise<void>;
+    /**
+     * Queues a scene change; it happens at the start of the next frame.
+     *
+     * The whole stack goes: every scene is destroyed, suspended or not, and the
+     * new one starts alone. For a scene that returns, push it instead.
+     */
+    switchScene(next: SceneClass): void;
+    /**
+     * Queues a scene on top of the current one; it starts at the next frame.
+     *
+     * The scene underneath suspends but is not destroyed: it stops updating and
+     * keeps rendering, so the new scene can layer over it or replace it
+     * outright, and `popScene` resumes exactly where play left off.
+     */
+    pushScene(next: SceneClass): void;
+    /**
+     * Queues the top scene's removal; it happens at the start of the next frame.
+     *
+     * @param result reported back to the resumed scene's `onResume`
+     */
+    popScene(result?: unknown): void;
+    /** the scene currently updating: the top of the stack */
+    get currentScene(): Scene | null;
+    /**
+     * Advances the game by one frame and draws it, without waiting for the browser.
+     *
+     * The loop normally runs on requestAnimationFrame, which browsers suspend while a tab
+     * is not visible. That is right for a game and wrong for a test or a screenshot, so
+     * this drives a frame directly.
+     *
+     * @param dt seconds to advance by
+     */
+    step(dt: number): void;
+    /**
+     * Publishes the running game on the global object, for tools and for the console.
+     *
+     * `__PIXI_APP__` is the name the PixiJS devtools extension looks for, so declaring it
+     * costs nothing and makes the scene graph inspectable. `__MWG__` is the game itself,
+     * which is what makes `__MWG__.step(1/60)` possible from a console — the only way to
+     * advance a game whose tab the browser has suspended, and the difference between
+     * diagnosing a frozen page and guessing at it.
+     *
+     * Neither is read by the framework. Nothing depends on them existing.
+     */
+    private expose;
+    private frame;
+    private switchNow;
+    /** a new scene alone: everything else is destroyed, the clocks restart */
+    private applySwitch;
+    /** a new scene over the current one, which suspends but survives underneath */
+    private applyPush;
+    /** the top scene leaves, reporting back to whatever it covered */
+    private applyPop;
+    destroy(): void;
+}
+//# sourceMappingURL=Game.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Game.d.ts","sourceRoot":"","sources":["../../src/core/Game.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiB,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA2BrC,MAAM,WAAW,WAAW;IAC3B,sEAAsE;IACtE,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAE3B,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,qBAAa,IAAI;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqB;IAE5C,QAAQ,CAAC,GAAG,0CAAqB;IAEjC,mEAAmE;IACnE,OAAO,SAAK;IAEZ,wDAAwD;IACxD,SAAS,SAAK;IAEd,+EAA+E;IAC/E,SAAS,SAAK;IAEd,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,iBAAwB;IAExC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,OAAO,CAAS;IAExB,YAAY,OAAO,GAAE,WAAgB,EAuBpC;IAED,6EAA6E;IAC7E,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,wEAAwE;IACxE,MAAM,KAAK,OAAO,IAAI,IAAI,CAGzB;IAEK,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C5C;IAED;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAElC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAEhC;IAED;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAE/B;IAED,yDAAyD;IACzD,IAAI,YAAY,IAAI,KAAK,GAAG,IAAI,CAE/B;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAGrB;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,KAAK;IAoBb,OAAO,CAAC,SAAS;IAIjB,0EAA0E;IAC1E,OAAO,CAAC,WAAW;IAanB,+EAA+E;IAC/E,OAAO,CAAC,SAAS;IAYjB,kEAAkE;IAClE,OAAO,CAAC,QAAQ;IAMhB,OAAO,IAAI,IAAI,CAMd;CACD"}

package/dist/core/Game.js

@@ -0,0 +1,236 @@
+import { Application, TextureSource } from 'pixi.js';
+import { SceneStack } from './SceneStack.js';
+import { Signal } from './Signal.js';
+import { registerColorTransform } from '../render/TintedSprite.js';
+import * as Input from './Input.js';
+const PIXEL_ART_CLASS = 'mwg-pixel-art';
+/**
+ * A class beats an inline `canvas.style.imageRendering` because Pixi's own `autoDensity`/
+ * `resizeTo` rewrite the canvas's `style` attribute wholesale (see `start()`); this rule
+ * lives in the CSSOM instead, in a stylesheet Pixi never touches, so it survives that.
+ * Injected once per page, however many `Game`s end up on it.
+ */
+function ensurePixelArtStylesheet() {
+    if (document.getElementById(PIXEL_ART_CLASS))
+        return;
+    const style = document.createElement('style');
+    style.id = PIXEL_ART_CLASS;
+    style.textContent = `.${PIXEL_ART_CLASS} { image-rendering: pixelated; }`;
+    document.head.appendChild(style);
+}
+/**
+ * The application: owns the renderer, the loop, and the current scene.
+ *
+ * Construct it, `await start(FirstScene)`, and the rest is scenes.
+ */
+export class Game {
+    static { this.instance = null; }
+    constructor(options = {}) {
+        this.app = new Application();
+        /** seconds elapsed in the previous frame, clamped by `maxDelta` */
+        this.elapsed = 0;
+        /** total seconds since the current scene was created */
+        this.timeTotal = 0;
+        /** multiplies elapsed time; 0 pauses the game without stopping the renderer */
+        this.timeScale = 1;
+        /** fires after every frame's update, for systems that are not scene-owned */
+        this.onFrame = new Signal();
+        this.stack = new SceneStack();
+        this.pending = [];
+        this.started = false;
+        this.options = {
+            canvas: options.canvas ?? document.createElement('canvas'),
+            background: options.background ?? 0x000000,
+            maxDelta: options.maxDelta ?? 0.25,
+            pixelArt: options.pixelArt ?? true,
+            resizeTo: options.resizeTo ?? window,
+        };
+        if (this.options.pixelArt) {
+            //set here rather than in start(), because textures are usually loaded before
+            //the game starts and each one takes the default that was current when it was
+            //created. nearest sampling is what keeps magnified pixel art crisp - but only
+            //inside the game's own rendering; the browser then does a second, entirely
+            //separate resize when it composites the canvas element onto the page (its
+            //backing buffer is rarely the same size as its CSS display size, especially at
+            //a devicePixelRatio other than 1), and that step defaults to smooth
+            //interpolation regardless of anything Pixi does - see `start()` for the other
+            //half of this, since `app.init()` overwrites whatever style is set here.
+            TextureSource.defaultOptions.scaleMode = 'nearest';
+        }
+        Game.instance = this;
+    }
+    /** the viewport width in css pixels, which is what scenes lay out against */
+    get width() {
+        return this.app.renderer.screen.width;
+    }
+    get height() {
+        return this.app.renderer.screen.height;
+    }
+    /** the running game, for the few places that genuinely need a global */
+    static get current() {
+        if (!Game.instance)
+            throw new Error('no Game has been created yet');
+        return Game.instance;
+    }
+    async start(first) {
+        if (this.started)
+            throw new Error('this Game has already been started');
+        this.started = true;
+        //batchers and pipes have to be registered before the renderer is built, so that
+        //TintedSprite has somewhere to render to
+        registerColorTransform();
+        Input.attach();
+        await this.app.init({
+            canvas: this.options.canvas,
+            background: this.options.background,
+            resizeTo: this.options.resizeTo,
+            antialias: false,
+            //the game clears and redraws every frame, so the buffer need not be preserved
+            preserveDrawingBuffer: false,
+            //drawing at device resolution is what keeps pixel art on whole device pixels
+            resolution: window.devicePixelRatio || 1,
+            autoDensity: true,
+        });
+        if (!this.options.canvas.isConnected) {
+            document.body.appendChild(this.options.canvas);
+        }
+        //`autoDensity` (and `resizeTo`, on its own asynchronous schedule) rewrite the canvas
+        //element's `style` attribute wholesale to keep its CSS size matching the backing
+        //buffer - which loses anything else set through `canvas.style`, including right
+        //after `init` and again from inside pixi's own 'resize' event. A class, rather than
+        //an inline style, lives in a different attribute entirely and survives that.
+        if (this.options.pixelArt) {
+            ensurePixelArtStylesheet();
+            this.options.canvas.classList.add(PIXEL_ART_CLASS);
+        }
+        //`screen` is the logical size in css pixels; `renderer.width` is the backing store,
+        //which is larger on a hidpi display. Scenes lay out in logical units, so handing
+        //them the backing size would push everything they centre off the screen.
+        this.app.renderer.on('resize', () => {
+            this.stack.resize(this.width, this.height);
+        });
+        this.expose();
+        this.switchNow(first);
+        //pixi's ticker drives the loop, so its own systems stay in step with the game
+        this.app.ticker.add((ticker) => this.frame(ticker.deltaMS / 1000));
+    }
+    /**
+     * Queues a scene change; it happens at the start of the next frame.
+     *
+     * The whole stack goes: every scene is destroyed, suspended or not, and the
+     * new one starts alone. For a scene that returns, push it instead.
+     */
+    switchScene(next) {
+        this.pending.push({ kind: 'switch', next });
+    }
+    /**
+     * Queues a scene on top of the current one; it starts at the next frame.
+     *
+     * The scene underneath suspends but is not destroyed: it stops updating and
+     * keeps rendering, so the new scene can layer over it or replace it
+     * outright, and `popScene` resumes exactly where play left off.
+     */
+    pushScene(next) {
+        this.pending.push({ kind: 'push', next });
+    }
+    /**
+     * Queues the top scene's removal; it happens at the start of the next frame.
+     *
+     * @param result reported back to the resumed scene's `onResume`
+     */
+    popScene(result) {
+        this.pending.push({ kind: 'pop', result });
+    }
+    /** the scene currently updating: the top of the stack */
+    get currentScene() {
+        return this.stack.current;
+    }
+    /**
+     * Advances the game by one frame and draws it, without waiting for the browser.
+     *
+     * The loop normally runs on requestAnimationFrame, which browsers suspend while a tab
+     * is not visible. That is right for a game and wrong for a test or a screenshot, so
+     * this drives a frame directly.
+     *
+     * @param dt seconds to advance by
+     */
+    step(dt) {
+        this.frame(dt);
+        this.app.renderer.render(this.app.stage);
+    }
+    /**
+     * Publishes the running game on the global object, for tools and for the console.
+     *
+     * `__PIXI_APP__` is the name the PixiJS devtools extension looks for, so declaring it
+     * costs nothing and makes the scene graph inspectable. `__MWG__` is the game itself,
+     * which is what makes `__MWG__.step(1/60)` possible from a console — the only way to
+     * advance a game whose tab the browser has suspended, and the difference between
+     * diagnosing a frozen page and guessing at it.
+     *
+     * Neither is read by the framework. Nothing depends on them existing.
+     */
+    expose() {
+        const target = globalThis;
+        target.__PIXI_APP__ = this.app;
+        target.__MWG__ = this;
+    }
+    frame(deltaSeconds) {
+        //queued scene changes run first, in order, so a frame never updates a
+        //scene that was already asked to leave
+        for (const request of this.pending) {
+            if (request.kind === 'switch')
+                this.applySwitch(request.next);
+            else if (request.kind === 'push')
+                this.applyPush(request.next);
+            else
+                this.applyPop(request.result);
+        }
+        this.pending.length = 0;
+        this.elapsed = Math.min(deltaSeconds, this.options.maxDelta) * this.timeScale;
+        this.timeTotal += this.elapsed;
+        this.stack.update(this.elapsed);
+        this.onFrame.dispatch(this.elapsed);
+        //after everything has had a chance to poll it, so nothing misses a press
+        Input.endFrame();
+    }
+    switchNow(next) {
+        this.applySwitch(next);
+    }
+    /** a new scene alone: everything else is destroyed, the clocks restart */
+    applySwitch(next) {
+        const scene = new next();
+        this.stack.replace(scene);
+        this.app.stage.removeChildren();
+        this.app.stage.addChild(scene.stage);
+        this.elapsed = 0;
+        this.timeTotal = 0;
+        this.timeScale = 1;
+        scene.resize(this.width, this.height);
+    }
+    /** a new scene over the current one, which suspends but survives underneath */
+    applyPush(next) {
+        const scene = new next();
+        this.stack.push(scene);
+        this.app.stage.addChild(scene.stage);
+        this.elapsed = 0;
+        this.timeTotal = 0;
+        this.timeScale = 1;
+        scene.resize(this.width, this.height);
+    }
+    /** the top scene leaves, reporting back to whatever it covered */
+    applyPop(result) {
+        const top = this.stack.current;
+        this.stack.pop(result);
+        if (top)
+            this.app.stage.removeChild(top.stage);
+    }
+    destroy() {
+        Input.detach();
+        this.stack.destroy();
+        this.onFrame.removeAll();
+        this.app.destroy(true, { children: true });
+        if (Game.instance === this)
+            Game.instance = null;
+    }
+}
+//# sourceMappingURL=Game.js.map

package/dist/core/Game.js.map

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

package/dist/core/Hex.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Flat-top hexagon geometry, addressed the same way a square grid is: `x` the column, `y`
+ * the row, both integers - which is what lets `mwg/roguelike`'s `Level` (grid logic) and
+ * `mwg/render`'s `TileMap` (pixel positions) each reuse it without depending on the other.
+ * It lives in `mwg/core` for exactly that reason: neither of those two modules is allowed
+ * to depend on the other, and this needs to sit below both.
+ *
+ * Internally this converts to and from cube coordinates (`x + y + z = 0`) for every
+ * calculation, because the six neighbour directions are then a fixed, orientation-agnostic
+ * list rather than a column-parity-dependent table someone has to get right twice. The
+ * offset "odd-q" scheme below - odd columns pushed half a row down - is what makes that
+ * cube math round-trip back to integers; nothing about it is rot.js's, which is deliberate
+ * (see the roadmap: rot.js's own hex `Path` topology is doubled-width coordinates built for
+ * *pointy-top* hexagons, and does not match this orientation).
+ */
+export interface HexCoord {
+    x: number;
+    y: number;
+}
+/** the six cells sharing an edge with `(x, y)` */
+export declare function hexNeighbors(x: number, y: number): HexCoord[];
+/** the number of hex steps between two cells */
+export declare function hexDistance(a: HexCoord, b: HexCoord): number;
+/**
+ * Every cell a straight line crosses from `a` to `b`, both included - the hex-grid analogue
+ * of `mwg/roguelike`'s `traceLine`, and what a simple (non-shadowcast) hex field of view is
+ * built from: walk the line to a candidate cell and see whether anything on it is opaque.
+ */
+export declare function hexLine(a: HexCoord, b: HexCoord): HexCoord[];
+/** every cell within `radius` hex steps of `center`, `center` itself included */
+export declare function hexRange(center: HexCoord, radius: number): HexCoord[];
+/** the pixel position of a hex cell's centre, for a flat-top tile of the given size */
+export declare function hexToPixel(x: number, y: number, tileWidth: number, tileHeight: number): {
+    x: number;
+    y: number;
+};
+/**
+ * The hex cell under a pixel position - the inverse of `hexToPixel`.
+ *
+ * Fractional cube coordinates first, rounded only at the end (`cubeRound`), the same way
+ * `hexLine` resolves a fractional step to a cell - rounding column and row independently
+ * would round to the wrong cell right at a hex's edge.
+ */
+export declare function pixelToHex(px: number, py: number, tileWidth: number, tileHeight: number): HexCoord;
+//# sourceMappingURL=Hex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Hex.d.ts","sourceRoot":"","sources":["../../src/core/Hex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,QAAQ;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV;AA+BD,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE,CAG7D;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAI5D;AAoBD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAsB5D;AAED,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CAYrE;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAKhH;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ,CASlG"}