@datamoc/mw_games 0.1.1

package/dist/world/Encounters.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A weighted encounter table, checked once per step - what decides that walking through
+ * tall grass sometimes meets a wild creature and usually does not, and that a rarer species
+ * turns up less often than a common one.
+ *
+ * Built on `mwg/core`'s `Random.chance` and `Random.weighted` rather than its own dice, so
+ * an encounter roll is seeded and reproducible the same way everything else in a run is.
+ */
+export interface EncounterEntry<T> {
+    value: T;
+    weight: number;
+}
+export interface EncounterTable<T> {
+    entries: readonly EncounterEntry<T>[];
+    /** probability of any encounter at all, per step, 0 to 1 */
+    rate: number;
+}
+/** @returns the encounter for this step, or null when the roll misses or the table is empty */
+export declare function rollEncounter<T>(table: EncounterTable<T>): T | null;
+//# sourceMappingURL=Encounters.d.ts.map

package/dist/world/Encounters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Encounters.d.ts","sourceRoot":"","sources":["../../src/world/Encounters.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAChC,OAAO,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtC,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;CACb;AAED,+FAA+F;AAC/F,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAKnE"}

package/dist/world/Encounters.js

@@ -0,0 +1,9 @@
+import * as Random from '../core/Random.js';
+/** @returns the encounter for this step, or null when the roll misses or the table is empty */
+export function rollEncounter(table) {
+    if (table.entries.length === 0 || !Random.chance(table.rate))
+        return null;
+    const index = Random.weighted(table.entries.map((entry) => entry.weight));
+    return index === -1 ? null : table.entries[index].value;
+}
+//# sourceMappingURL=Encounters.js.map

package/dist/world/Encounters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Encounters.js","sourceRoot":"","sources":["../../src/world/Encounters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAsB5C,+FAA+F;AAC/F,MAAM,UAAU,aAAa,CAAI,KAAwB;IACxD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1E,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1E,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC;AACzD,CAAC"}

package/dist/world/Overworld.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A named point on a map that leads somewhere else - a town gate, a cave mouth, a dungeon
+ * entrance on the overworld. This is the shared floor `mwg/rpg`'s tile events (item pages,
+ * triggers) will sit on top of later; on its own it is just the lookup, by position or by
+ * name, that turns "the player stepped here" into "which map, and which spawn, is next".
+ */
+export interface Location {
+    id: string;
+    x: number;
+    y: number;
+    /** the map id this location leads to */
+    leadsTo: string;
+    /** the spawn point to enter that map at, passed straight to `World.enter` */
+    spawn?: string;
+}
+export declare class Overworld {
+    private locations;
+    add(location: Location): void;
+    remove(id: string): void;
+    get(id: string): Location | undefined;
+    /** the location at these exact coordinates, if any - for "the player stepped onto it" */
+    at(x: number, y: number): Location | undefined;
+    get all(): readonly Location[];
+}
+//# sourceMappingURL=Overworld.d.ts.map

package/dist/world/Overworld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Overworld.d.ts","sourceRoot":"","sources":["../../src/world/Overworld.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IAEV,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAEhB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,SAAS;IACrB,OAAO,CAAC,SAAS,CAA+B;IAEhD,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAE5B;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEvB;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAEpC;IAED,yFAAyF;IACzF,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAK7C;IAED,IAAI,GAAG,IAAI,SAAS,QAAQ,EAAE,CAE7B;CACD"}

package/dist/world/Overworld.js

@@ -0,0 +1,26 @@
+export class Overworld {
+    constructor() {
+        this.locations = new Map();
+    }
+    add(location) {
+        this.locations.set(location.id, location);
+    }
+    remove(id) {
+        this.locations.delete(id);
+    }
+    get(id) {
+        return this.locations.get(id);
+    }
+    /** the location at these exact coordinates, if any - for "the player stepped onto it" */
+    at(x, y) {
+        for (const location of this.locations.values()) {
+            if (location.x === x && location.y === y)
+                return location;
+        }
+        return undefined;
+    }
+    get all() {
+        return [...this.locations.values()];
+    }
+}
+//# sourceMappingURL=Overworld.js.map

package/dist/world/Overworld.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Overworld.js","sourceRoot":"","sources":["../../src/world/Overworld.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,SAAS;IAAtB;QACS,cAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAyBjD,CAAC;IAvBA,GAAG,CAAC,QAAkB;QACrB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,EAAU;QAChB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,yFAAyF;IACzF,EAAE,CAAC,CAAS,EAAE,CAAS;QACtB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAChD,IAAI,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAC,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAC;QAC3D,CAAC;QACD,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,IAAI,GAAG;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;CACD"}

package/dist/world/TurnClock.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The slower clock a roguelike's hunger, poison and other long-running effects run on -
+ * distinct from `mwg/roguelike`'s `Scheduler`, which decides who acts next *within* a turn.
+ * `TurnClock` counts turns that have already happened and drives whatever should happen
+ * once per turn, or run out after a fixed number of them, regardless of who took the turn.
+ */
+export interface TimedEffect {
+    /** called once per `advance`, with the clock's new total */
+    tick: (turn: number) => void;
+    /** turns remaining before this effect is removed automatically; omit to run forever */
+    duration?: number;
+    /** called once, the moment `duration` runs out, right before the effect is removed */
+    onExpire?: () => void;
+}
+export declare class TurnClock {
+    turn: number;
+    private effects;
+    /** registers an effect and returns a handle for `remove` */
+    add(effect: TimedEffect): symbol;
+    remove(id: symbol): void;
+    has(id: symbol): boolean;
+    /** advances the clock and ticks every effect, removing any whose duration has elapsed */
+    advance(turns?: number): void;
+}
+//# sourceMappingURL=TurnClock.d.ts.map

package/dist/world/TurnClock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnClock.d.ts","sourceRoot":"","sources":["../../src/world/TurnClock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B,4DAA4D;IAC5D,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAE7B,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,qBAAa,SAAS;IACrB,IAAI,SAAK;IAET,OAAO,CAAC,OAAO,CAAkC;IAEjD,4DAA4D;IAC5D,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAI/B;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEvB;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEvB;IAED,yFAAyF;IACzF,OAAO,CAAC,KAAK,SAAI,GAAG,IAAI,CAcvB;CACD"}

package/dist/world/TurnClock.js

@@ -0,0 +1,33 @@
+export class TurnClock {
+    constructor() {
+        this.turn = 0;
+        this.effects = new Map();
+    }
+    /** registers an effect and returns a handle for `remove` */
+    add(effect) {
+        const id = Symbol();
+        this.effects.set(id, { ...effect });
+        return id;
+    }
+    remove(id) {
+        this.effects.delete(id);
+    }
+    has(id) {
+        return this.effects.has(id);
+    }
+    /** advances the clock and ticks every effect, removing any whose duration has elapsed */
+    advance(turns = 1) {
+        this.turn += turns;
+        for (const [id, effect] of this.effects) {
+            effect.tick(this.turn);
+            if (effect.duration !== undefined) {
+                effect.duration -= turns;
+                if (effect.duration <= 0) {
+                    this.effects.delete(id);
+                    effect.onExpire?.();
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=TurnClock.js.map

package/dist/world/TurnClock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnClock.js","sourceRoot":"","sources":["../../src/world/TurnClock.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,SAAS;IAAtB;QACC,SAAI,GAAG,CAAC,CAAC;QAED,YAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAiClD,CAAC;IA/BA,4DAA4D;IAC5D,GAAG,CAAC,MAAmB;QACtB,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACpC,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,CAAC,EAAU;QAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,yFAAyF;IACzF,OAAO,CAAC,KAAK,GAAG,CAAC;QAChB,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;QAEnB,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEvB,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC;gBACzB,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;oBAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACxB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACrB,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;CACD"}

package/dist/world/World.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Many maps in one world, joined by transitions.
+ *
+ * `mwg` deliberately does not say what a "map" is here - a `TileMap` and a `Level`, a
+ * `DialogueStage`, or a game's own bundle of the two. What `World` owns is the part that is
+ * the same regardless: a map is created from a factory registered by id, and by default kept
+ * alive for as long as the world exists - so a monster left half-dead in a dungeon room is
+ * still half-dead when the player wanders back in, without the game writing that by hand.
+ *
+ * That default is ADOM's shape, not every game's. A game with SPD's shape - most floors are
+ * never revisited, and the ones that are should feel new - marks those maps
+ * `persistent: false` at `define` time: `enter` then rebuilds them from the factory every
+ * time, discarding whatever was there. Both live in the same `World`; a game's overworld and
+ * towns can stay persistent while its dungeon floors do not.
+ */
+export declare class World<M> {
+    private factories;
+    private loaded;
+    private currentId;
+    private lastSpawn;
+    /**
+     * Registers how to build a map.
+     *
+     * @param persistent false rebuilds the map from `create` on every `enter`, discarding
+     * its previous state - the default, true, keeps it alive for as long as `World` does
+     */
+    define(id: string, create: () => M, options?: {
+        persistent?: boolean;
+    }): void;
+    /**
+     * Switches to a map - creating it on first entry, reusing it on every one after unless
+     * it was defined `persistent: false`, in which case every entry rebuilds it.
+     *
+     * @param spawn a named entry point within the target map; the game reads it back from
+     * `World.spawn` to know where to place the player - `World` does not know what a
+     * position is, only that one was asked for
+     */
+    enter(id: string, spawn?: string): M;
+    get current(): M | null;
+    get currentMapId(): string | null;
+    /** the spawn point passed to the most recent `enter`, for the game to place its player by */
+    get spawn(): string | undefined;
+    /** true once a map has been created, whether or not it is the current one */
+    isLoaded(id: string): boolean;
+    /** true if this id was `define`d with `persistent: false` */
+    isPersistent(id: string): boolean;
+    /** drops a map's live state, so its factory builds a fresh one next time it is entered */
+    unload(id: string): void;
+}
+//# sourceMappingURL=World.d.ts.map

package/dist/world/World.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"World.d.ts","sourceRoot":"","sources":["../../src/world/World.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;GAcG;AACH,qBAAa,KAAK,CAAC,CAAC;IACnB,OAAO,CAAC,SAAS,CAAuC;IACxD,OAAO,CAAC,MAAM,CAAwB;IAEtC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,SAAS,CAAqB;IAEtC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI,CAEhF;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAanC;IAED,IAAI,OAAO,IAAI,CAAC,GAAG,IAAI,CAEtB;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAEhC;IAED,6FAA6F;IAC7F,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE5B;IAED,6DAA6D;IAC7D,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEhC;IAED,0FAA0F;IAC1F,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAGvB;CACD"}

package/dist/world/World.js

@@ -0,0 +1,77 @@
+/**
+ * Many maps in one world, joined by transitions.
+ *
+ * `mwg` deliberately does not say what a "map" is here - a `TileMap` and a `Level`, a
+ * `DialogueStage`, or a game's own bundle of the two. What `World` owns is the part that is
+ * the same regardless: a map is created from a factory registered by id, and by default kept
+ * alive for as long as the world exists - so a monster left half-dead in a dungeon room is
+ * still half-dead when the player wanders back in, without the game writing that by hand.
+ *
+ * That default is ADOM's shape, not every game's. A game with SPD's shape - most floors are
+ * never revisited, and the ones that are should feel new - marks those maps
+ * `persistent: false` at `define` time: `enter` then rebuilds them from the factory every
+ * time, discarding whatever was there. Both live in the same `World`; a game's overworld and
+ * towns can stay persistent while its dungeon floors do not.
+ */
+export class World {
+    constructor() {
+        this.factories = new Map();
+        this.loaded = new Map();
+        this.currentId = null;
+    }
+    /**
+     * Registers how to build a map.
+     *
+     * @param persistent false rebuilds the map from `create` on every `enter`, discarding
+     * its previous state - the default, true, keeps it alive for as long as `World` does
+     */
+    define(id, create, options = {}) {
+        this.factories.set(id, { create, persistent: options.persistent ?? true });
+    }
+    /**
+     * Switches to a map - creating it on first entry, reusing it on every one after unless
+     * it was defined `persistent: false`, in which case every entry rebuilds it.
+     *
+     * @param spawn a named entry point within the target map; the game reads it back from
+     * `World.spawn` to know where to place the player - `World` does not know what a
+     * position is, only that one was asked for
+     */
+    enter(id, spawn) {
+        const definition = this.factories.get(id);
+        if (!definition)
+            throw new Error(`no such map: "${id}"`);
+        let map = this.loaded.get(id);
+        if (!map || !definition.persistent) {
+            map = definition.create();
+            this.loaded.set(id, map);
+        }
+        this.currentId = id;
+        this.lastSpawn = spawn;
+        return map;
+    }
+    get current() {
+        return this.currentId ? (this.loaded.get(this.currentId) ?? null) : null;
+    }
+    get currentMapId() {
+        return this.currentId;
+    }
+    /** the spawn point passed to the most recent `enter`, for the game to place its player by */
+    get spawn() {
+        return this.lastSpawn;
+    }
+    /** true once a map has been created, whether or not it is the current one */
+    isLoaded(id) {
+        return this.loaded.has(id);
+    }
+    /** true if this id was `define`d with `persistent: false` */
+    isPersistent(id) {
+        return this.factories.get(id)?.persistent ?? true;
+    }
+    /** drops a map's live state, so its factory builds a fresh one next time it is entered */
+    unload(id) {
+        if (id === this.currentId)
+            throw new Error(`cannot unload the current map: "${id}"`);
+        this.loaded.delete(id);
+    }
+}
+//# sourceMappingURL=World.js.map

package/dist/world/World.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"World.js","sourceRoot":"","sources":["../../src/world/World.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,KAAK;IAAlB;QACS,cAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;QAChD,WAAM,GAAG,IAAI,GAAG,EAAa,CAAC;QAE9B,cAAS,GAAkB,IAAI,CAAC;IAgEzC,CAAC;IA7DA;;;;;OAKG;IACH,MAAM,CAAC,EAAU,EAAE,MAAe,EAAE,OAAO,GAA6B,EAAE;QACzE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,EAAU,EAAE,KAAc;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;QAEzD,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;YACpC,GAAG,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,CAAC;IAED,IAAI,YAAY;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,6FAA6F;IAC7F,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,6EAA6E;IAC7E,QAAQ,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,6DAA6D;IAC7D,YAAY,CAAC,EAAU;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,UAAU,IAAI,IAAI,CAAC;IACnD,CAAC;IAED,0FAA0F;IAC1F,MAAM,CAAC,EAAU;QAChB,IAAI,EAAE,KAAK,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;QACrF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;CACD"}

package/dist/world/index.d.ts

@@ -0,0 +1,8 @@
+export { World } from './World.ts';
+export { Overworld } from './Overworld.ts';
+export type { Location } from './Overworld.ts';
+export { TurnClock } from './TurnClock.ts';
+export type { TimedEffect } from './TurnClock.ts';
+export { rollEncounter } from './Encounters.ts';
+export type { EncounterEntry, EncounterTable } from './Encounters.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/world/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/world/index.js

@@ -0,0 +1,5 @@
+export { World } from './World.js';
+export { Overworld } from './Overworld.js';
+export { TurnClock } from './TurnClock.js';
+export { rollEncounter } from './Encounters.js';
+//# sourceMappingURL=index.js.map

package/dist/world/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/world/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@datamoc/mw_games",
+  "version": "0.1.1",
+  "description": "A framework for building 2D top-down games that run from a local file, with no server and no install.",
+  "license": "MPL-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "tools/compile-resources.mjs",
+    "LICENSE",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": "./dist/core/index.js",
+    "./render": "./dist/render/index.js",
+    "./roguelike": "./dist/roguelike/index.js",
+    "./assets": "./dist/assets/index.js",
+    "./tools/compile-resources": "./tools/compile-resources.mjs",
+    "./ui": "./dist/ui/index.js",
+    "./stage": "./dist/stage/index.js",
+    "./i18n": "./dist/i18n/index.js",
+    "./actors": "./dist/actors/index.js",
+    "./world": "./dist/world/index.js",
+    "./rpg": "./dist/rpg/index.js",
+    "./battle": "./dist/battle/index.js",
+    "./board": "./dist/board/index.js",
+    "./audio": "./dist/audio/index.js"
+  },
+  "scripts": {
+    "build": "npm run build:pkg && npm run build:global",
+    "build:pkg": "tsc -p tsconfig.build.json",
+    "build:global": "vite build --config vite.lib.config.ts",
+    "check": "tsc --noEmit",
+    "example": "vite --config examples/colour-transform/vite.config.ts",
+    "example:build": "vite build --config examples/colour-transform/vite.config.ts && node tools/emit-page.mjs examples/colour-transform",
+    "test": "node --test \"tests/**/*.test.ts\"",
+    "assets": "node tools/make-example-assets.mjs",
+    "extract:rgssad": "node tools/extract-rgssad.mjs",
+    "example:ui": "vite --config examples/interface/vite.config.ts",
+    "example:ui:build": "vite build --config examples/interface/vite.config.ts && node tools/emit-page.mjs examples/interface",
+    "example:dialogue": "vite --config examples/dialogue/vite.config.ts",
+    "example:dialogue:build": "vite build --config examples/dialogue/vite.config.ts && node tools/emit-page.mjs examples/dialogue",
+    "example:dungeon": "vite --config examples/dungeon/vite.config.ts",
+    "example:dungeon:build": "vite build --config examples/dungeon/vite.config.ts && node tools/emit-page.mjs examples/dungeon",
+    "example:village": "vite --config examples/village/vite.config.ts",
+    "example:village:build": "vite build --config examples/village/vite.config.ts && node tools/emit-page.mjs examples/village",
+    "example:battle": "vite --config examples/battle/vite.config.ts",
+    "example:battle:build": "vite build --config examples/battle/vite.config.ts && node tools/emit-page.mjs examples/battle",
+    "example:minigame": "vite --config examples/minigame/vite.config.ts",
+    "example:minigame:build": "vite build --config examples/minigame/vite.config.ts && node tools/emit-page.mjs examples/minigame",
+    "example:chess": "vite --config examples/chess/vite.config.ts",
+    "example:chess:build": "vite build --config examples/chess/vite.config.ts && node tools/emit-page.mjs examples/chess",
+    "webpage:examples": "node tools/build-webpage-examples.mjs",
+    "webpage:docs": "node tools/build-webpage-docs.mjs"
+  },
+  "dependencies": {
+    "pixi.js": "^8.20.1",
+    "rot-js": "^2.2.1"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.1",
+    "typescript": "^7.0.2",
+    "vite": "^8.2.2"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "unpkg": "./dist/mw_games.global.js"
+}

package/tools/compile-resources.mjs

@@ -0,0 +1,129 @@
+import { readdir, readFile, mkdir, writeFile, rm } from 'node:fs/promises';
+import { join, extname, relative, sep, dirname, basename } from 'node:path';
+
+/**
+ * Turns a folder of assets into scripts a `file://` page can load.
+ *
+ * Opening a page from disk removes three things a normal web game relies on:
+ *
+ *   - `fetch()` and XHR are blocked, so nothing can be loaded on demand and no directory
+ *     can be listed;
+ *   - ES modules are blocked by CORS, so the page cannot use a module loader;
+ *   - an `<img>` read from a sibling file counts as cross-origin in Chrome, so uploading
+ *     it into a WebGL texture throws a SecurityError.
+ *
+ * The last one is the awkward one: even shipping plain .png files next to the page does
+ * not work. What does work is a `<script src>`, which is exempt from those rules. So each
+ * asset becomes a `data:` URI inside a generated script, grouped by folder so no single
+ * file is enormous and a rebuild only rewrites what changed.
+ *
+ * The result is a global `__MWG_ASSETS__` mapping asset path to `data:` URI, which
+ * `mwg/assets` reads.
+ */
+
+export const DEFAULT_MIME = {
+	'.png': 'image/png',
+	'.jpg': 'image/jpeg',
+	'.jpeg': 'image/jpeg',
+	'.webp': 'image/webp',
+	'.gif': 'image/gif',
+	'.svg': 'image/svg+xml',
+	'.wav': 'audio/wav',
+	'.ogg': 'audio/ogg',
+	'.mp3': 'audio/mpeg',
+	'.ttf': 'font/ttf',
+	'.woff2': 'font/woff2',
+	'.json': 'application/json',
+	'.txt': 'text/plain',
+};
+
+async function* walk(dir) {
+	let entries;
+	try {
+		entries = await readdir(dir, { withFileTypes: true });
+	} catch {
+		return;
+	}
+	for (const entry of entries) {
+		const full = join(dir, entry.name);
+		if (entry.isDirectory()) yield* walk(full);
+		else yield full;
+	}
+}
+
+/**
+ * @param options.from folder holding the assets
+ * @param options.to folder to write the generated scripts into
+ * @param options.mime extension to MIME type, merged over the defaults
+ * @param options.groupBy how to name the script an asset lands in; defaults to its top folder
+ * @returns the group names, in the order the page should load them
+ */
+export async function compileResources({ from, to, mime = {}, groupBy } = {}) {
+	if (!from || !to) throw new Error('compileResources needs both `from` and `to`');
+
+	const types = { ...DEFAULT_MIME, ...mime };
+	const group = groupBy ?? ((key) => (key.includes('/') ? key.slice(0, key.indexOf('/')) : 'assets'));
+
+	await rm(to, { recursive: true, force: true });
+	await mkdir(to, { recursive: true });
+
+	const groups = new Map();
+	let skipped = 0;
+	let rawBytes = 0;
+
+	for await (const file of walk(from)) {
+		const type = types[extname(file).toLowerCase()];
+		if (!type) {
+			skipped++;
+			continue;
+		}
+
+		const key = relative(from, file).split(sep).join('/');
+		const data = await readFile(file);
+
+		const name = group(key);
+		if (!groups.has(name)) groups.set(name, {});
+		groups.get(name)[key] = `data:${type};base64,${data.toString('base64')}`;
+		rawBytes += data.length;
+	}
+
+	const written = [];
+	for (const [name, assets] of groups) {
+		const js =
+			'//generated by mwg/tools/compile-resources, do not edit\n' +
+			'(function(){var a=window.__MWG_ASSETS__||(window.__MWG_ASSETS__={});' +
+			`var g=${JSON.stringify(assets)};for(var k in g)a[k]=g[k];})();\n`;
+
+		await writeFile(join(to, `${name}.js`), js, 'utf8');
+		written.push({ name, count: Object.keys(assets).length, size: js.length });
+	}
+
+	return { groups: written, rawBytes, skipped };
+}
+
+// ---------------------------------------------------------------- CLI
+
+const isMain = process.argv[1] && import.meta.url.endsWith(basename(process.argv[1]));
+
+if (isMain) {
+	const [from, to] = process.argv.slice(2);
+	if (!from || !to) {
+		console.error('usage: node compile-resources.mjs <asset folder> <output folder>');
+		process.exit(1);
+	}
+
+	const { groups, rawBytes, skipped } = await compileResources({
+		from,
+		to,
+		//a flat folder has no subdirectories to group by, so everything lands in one file
+		groupBy: (key) => (key.includes('/') ? key.slice(0, key.indexOf('/')) : 'assets'),
+	});
+
+	const kb = (n) => (n / 1024).toFixed(1).padStart(8) + ' KB';
+	for (const { name, count, size } of groups) {
+		console.log(`  ${join(relative(process.cwd(), to), name + '.js').padEnd(40)}${kb(size)}  (${count} files)`);
+	}
+	console.log(`  ${groups.length} script(s), ${kb(rawBytes)} of assets` + (skipped ? `, ${skipped} skipped` : ''));
+}
+
+export { dirname };