@datamoc/mw_games 0.3.1 → 0.4.0

package/dist/roguelike/Boss.d.ts

@@ -27,7 +27,7 @@ export declare class BossPhases {
      * a game fires each phase's enter-hook exactly once; a single massive hit can enter
      * several at once, and all of them are reported
      */
-    update(hpFraction: number): number[];
+    check(hpFraction: number): number[];
     /** restarts the fight at phase 0, for a rematch or a reused boss object */
     reset(): void;
     toJSON(): {
@@ -38,7 +38,7 @@ export declare class BossPhases {
     }): BossPhases;
 }
 /**
- * One ability per named slot, each with its own cooldown in turns: `tick()` counts every
+ * One ability per named slot, each with its own cooldown in turns: `advance()` counts every
  * cooldown down by one turn, `ready()` lists whatever may fire now, and `use(id)` spends
  * one - resetting its full cooldown - reporting whether it was actually ready, so a game
  * can tell "fired" from "still waiting" without tracking the counters itself.
@@ -47,8 +47,8 @@ export declare class AbilityCycle {
     private cooldowns;
     private remaining;
     constructor(cooldowns: Record<string, number>);
-    /** counts every cooling-down ability one turn closer to ready */
-    tick(): void;
+    /** counts every cooling-down ability `turns` closer to ready */
+    advance(turns?: number): void;
     /** ids that may fire right now, in definition order */
     ready(): string[];
     /**

package/dist/roguelike/Boss.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Boss.d.ts","sourceRoot":"","sources":["../../src/roguelike/Boss.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qBAAa,UAAU;IACtB,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,OAAO,CAAK;IAEpB;;;;OAIG;IACH,YAAY,UAAU,GAAE,SAAS,MAAM,EAAO,EAO7C;IAED,oFAAoF;IACpF,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAUnC;IAED,2EAA2E;IAC3E,KAAK,IAAI,IAAI,CAEZ;IAED,MAAM,IAAI;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAE1B;IAED,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU,CAIlF;CACD;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,SAAS,CAA6B;IAE9C,YAAY,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAE5C;IAED,iEAAiE;IACjE,IAAI,IAAI,IAAI,CAKX;IAED,uDAAuD;IACvD,KAAK,IAAI,MAAM,EAAE,CAMhB;IAED;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAKvB;IAED,MAAM,IAAI;QAAE,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,CAE1C;IAED,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE;QAAE,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,GAAG,YAAY,CAIxG;CACD"}
+{"version":3,"file":"Boss.d.ts","sourceRoot":"","sources":["../../src/roguelike/Boss.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qBAAa,UAAU;IACtB,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,OAAO,CAAK;IAEpB;;;;OAIG;IACH,YAAY,UAAU,GAAE,SAAS,MAAM,EAAO,EAO7C;IAED,oFAAoF;IACpF,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAUlC;IAED,2EAA2E;IAC3E,KAAK,IAAI,IAAI,CAEZ;IAED,MAAM,IAAI;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAE1B;IAED,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU,CAIlF;CACD;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,SAAS,CAA6B;IAE9C,YAAY,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAE5C;IAED,gEAAgE;IAChE,OAAO,CAAC,KAAK,SAAI,GAAG,IAAI,CAKvB;IAED,uDAAuD;IACvD,KAAK,IAAI,MAAM,EAAE,CAMhB;IAED;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAKvB;IAED,MAAM,IAAI;QAAE,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,CAE1C;IAED,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE;QAAE,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,GAAG,YAAY,CAIxG;CACD"}

package/dist/roguelike/Boss.js

@@ -35,7 +35,7 @@ export class BossPhases {
      * a game fires each phase's enter-hook exactly once; a single massive hit can enter
      * several at once, and all of them are reported
      */
-    update(hpFraction) {
+    check(hpFraction) {
         let phase = 0;
         while (phase < this.thresholds.length && hpFraction <= this.thresholds[phase])
             phase++;
@@ -60,7 +60,7 @@ export class BossPhases {
     }
 }
 /**
- * One ability per named slot, each with its own cooldown in turns: `tick()` counts every
+ * One ability per named slot, each with its own cooldown in turns: `advance()` counts every
  * cooldown down by one turn, `ready()` lists whatever may fire now, and `use(id)` spends
  * one - resetting its full cooldown - reporting whether it was actually ready, so a game
  * can tell "fired" from "still waiting" without tracking the counters itself.
@@ -70,13 +70,13 @@ export class AbilityCycle {
         this.remaining = new Map();
         this.cooldowns = new Map(Object.entries(cooldowns));
     }
-    /** counts every cooling-down ability one turn closer to ready */
-    tick() {
+    /** counts every cooling-down ability `turns` closer to ready */
+    advance(turns = 1) {
         for (const [id, left] of this.remaining) {
-            if (left <= 1)
+            if (left <= turns)
                 this.remaining.delete(id);
             else
-                this.remaining.set(id, left - 1);
+                this.remaining.set(id, left - turns);
         }
     }
     /** ids that may fire right now, in definition order */

package/dist/roguelike/Boss.js.map

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

package/dist/roguelike/Combat.d.ts

@@ -1,3 +1,4 @@
+import { HookRegistry } from '../core/Hooks.ts';
 export type CombatEvent = 'beforeAttack' | 'beforeDamage' | 'afterDamage' | 'onKill' | string;
 export interface DamageContext<C> {
     attacker: C;
@@ -6,18 +7,16 @@ export interface DamageContext<C> {
     prevented: boolean;
     [kind: string]: unknown;
 }
-export interface CombatHook<C> {
-    event: CombatEvent;
-    handler: (context: DamageContext<C>) => void;
-    source?: unknown;
-}
-/** Generic combat lifecycle hooks; the game owns HP, formulas, and when each event fires. */
-export declare class CombatHooks<C> {
-    private hooks;
-    on(event: CombatEvent, handler: (context: DamageContext<C>) => void, source?: unknown): void;
-    offSource(source: unknown): void;
-    emit(event: CombatEvent, context: DamageContext<C>): void;
+/**
+ * Generic combat lifecycle hooks; the game owns HP, formulas, and when each event fires.
+ *
+ * The registry is `core.HookRegistry`, the same one `battle.BattleHooks` uses - these were two
+ * copies of one class for a while. What is combat-specific is that a handler receives a single
+ * mutable `DamageContext`, and the `modifyDamage` seam below built on it.
+ */
+export declare class CombatHooks<C> extends HookRegistry<[context: DamageContext<C>]> {
     /** Runs the pre-damage seam and clamps the resulting amount at zero. */
     modifyDamage(attacker: C, defender: C, amount: number): DamageContext<C>;
 }
+export type { Hook as CombatHook } from '../core/Hooks.ts';
 //# sourceMappingURL=Combat.d.ts.map

package/dist/roguelike/Combat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Combat.d.ts","sourceRoot":"","sources":["../../src/roguelike/Combat.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,cAAc,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9F,MAAM,WAAW,aAAa,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC;IACZ,QAAQ,EAAE,CAAC,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,6FAA6F;AAC7F,qBAAa,WAAW,CAAC,CAAC;IACzB,OAAO,CAAC,KAAK,CAAuB;IAEpC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAE3F;IAED,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAE/B;IAED,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAExD;IAED,wEAAwE;IACxE,YAAY,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAMvE;CACD"}
+{"version":3,"file":"Combat.d.ts","sourceRoot":"","sources":["../../src/roguelike/Combat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,cAAc,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9F,MAAM,WAAW,aAAa,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC;IACZ,QAAQ,EAAE,CAAC,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,qBAAa,WAAW,CAAC,CAAC,CAAE,SAAQ,YAAY,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,wEAAwE;IACxE,YAAY,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAMvE;CACD;AAED,YAAY,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/roguelike/Combat.js

@@ -1,19 +1,12 @@
-/** Generic combat lifecycle hooks; the game owns HP, formulas, and when each event fires. */
-export class CombatHooks {
-    constructor() {
-        this.hooks = [];
-    }
-    on(event, handler, source) {
-        this.hooks.push({ event, handler, source });
-    }
-    offSource(source) {
-        this.hooks = this.hooks.filter((hook) => hook.source !== source);
-    }
-    emit(event, context) {
-        for (const hook of this.hooks)
-            if (hook.event === event)
-                hook.handler(context);
-    }
+import { HookRegistry } from '../core/Hooks.js';
+/**
+ * Generic combat lifecycle hooks; the game owns HP, formulas, and when each event fires.
+ *
+ * The registry is `core.HookRegistry`, the same one `battle.BattleHooks` uses - these were two
+ * copies of one class for a while. What is combat-specific is that a handler receives a single
+ * mutable `DamageContext`, and the `modifyDamage` seam below built on it.
+ */
+export class CombatHooks extends HookRegistry {
     /** Runs the pre-damage seam and clamps the resulting amount at zero. */
     modifyDamage(attacker, defender, amount) {
         const context = { attacker, defender, amount, prevented: false };

package/dist/roguelike/Combat.js.map

@@ -1 +1 @@
-{"version":3,"file":"Combat.js","sourceRoot":"","sources":["../../src/roguelike/Combat.ts"],"names":[],"mappings":"AAgBA,6FAA6F;AAC7F,MAAM,OAAO,WAAW;IAAxB;QACS,UAAK,GAAoB,EAAE,CAAC;IAsBrC,CAAC;IApBA,EAAE,CAAC,KAAkB,EAAE,OAA4C,EAAE,MAAgB;QACpF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,SAAS,CAAC,MAAe;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC,KAAkB,EAAE,OAAyB;QACjD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;gBAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChF,CAAC;IAED,wEAAwE;IACxE,YAAY,CAAC,QAAW,EAAE,QAAW,EAAE,MAAc;QACpD,MAAM,OAAO,GAAqB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACnF,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;QACnD,OAAO,OAAO,CAAC;IAChB,CAAC;CACD"}
+{"version":3,"file":"Combat.js","sourceRoot":"","sources":["../../src/roguelike/Combat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAYhD;;;;;;GAMG;AACH,MAAM,OAAO,WAAe,SAAQ,YAAyC;IAC5E,wEAAwE;IACxE,YAAY,CAAC,QAAW,EAAE,QAAW,EAAE,MAAc;QACpD,MAAM,OAAO,GAAqB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACnF,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;QACnD,OAAO,OAAO,CAAC;IAChB,CAAC;CACD"}

package/dist/roguelike/ContentRoll.d.ts

@@ -0,0 +1,43 @@
+/**
+ * A weighted regular-roster entry, optionally swappable into a named alternative variant.
+ * `mwg` names none of `T` - a monster kind, an item id, anything a game's own roster holds.
+ */
+export interface RosterEntry<T> {
+    value: T;
+    /** an alternative this entry may swap into once placed in the roster */
+    alternative?: {
+        value: T;
+        chance: number;
+    };
+}
+/** an extra entry that may or may not join the roster this roll, beyond the regular ones */
+export interface RareEntry<T> {
+    value: T;
+    chance: number;
+    /**
+     * false skips this entry's roll entirely without consuming RNG - an explicit *deferred*
+     * roll, distinct from one that rolled and lost (`'skipped'`), so a parity trace can tell
+     * "this depth never asks" from "this depth asked and the roll failed"
+     */
+    enabled?: boolean;
+}
+export type RollOutcome = 'added' | 'skipped' | 'deferred' | 'swapped' | 'kept' | 'shuffled';
+export interface RollTraceEntry {
+    step: 'rare' | 'alternative' | 'shuffle';
+    index: number;
+    outcome: RollOutcome;
+}
+export interface ContentRollResult<T> {
+    roster: T[];
+    trace: RollTraceEntry[];
+}
+/**
+ * Rolls a spawn/content roster: the regular entries, then whichever rare additions rolled in,
+ * then a per-entry alternative-variant swap over the regular entries only, then (unless
+ * disabled) a shuffle - the "add-rare, swap, shuffle" order a variant-spawn table commonly
+ * needs. Every roll, including a disabled rare entry's explicit non-roll, is recorded in
+ * `trace`, so two runs against the same seed can be diffed roll for roll rather than only by
+ * final roster.
+ */
+export declare function rollRoster<T>(regular: readonly RosterEntry<T>[], rare?: readonly RareEntry<T>[], shuffleResult?: boolean): ContentRollResult<T>;
+//# sourceMappingURL=ContentRoll.d.ts.map

package/dist/roguelike/ContentRoll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentRoll.d.ts","sourceRoot":"","sources":["../../src/roguelike/ContentRoll.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC;IAET,wEAAwE;IACxE,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,4FAA4F;AAC5F,MAAM,WAAW,SAAS,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAE7F,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IACnC,MAAM,EAAE,CAAC,EAAE,CAAC;IACZ,KAAK,EAAE,cAAc,EAAE,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,GAAE,SAAS,SAAS,CAAC,CAAC,CAAC,EAAO,EAAE,aAAa,UAAO,GAAG,iBAAiB,CAAC,CAAC,CAAC,CA8BhJ"}

package/dist/roguelike/ContentRoll.js

@@ -0,0 +1,38 @@
+import * as Random from '../core/Random.js';
+/**
+ * Rolls a spawn/content roster: the regular entries, then whichever rare additions rolled in,
+ * then a per-entry alternative-variant swap over the regular entries only, then (unless
+ * disabled) a shuffle - the "add-rare, swap, shuffle" order a variant-spawn table commonly
+ * needs. Every roll, including a disabled rare entry's explicit non-roll, is recorded in
+ * `trace`, so two runs against the same seed can be diffed roll for roll rather than only by
+ * final roster.
+ */
+export function rollRoster(regular, rare = [], shuffleResult = true) {
+    const trace = [];
+    const roster = regular.map((entry) => entry.value);
+    rare.forEach((entry, index) => {
+        if (entry.enabled === false) {
+            trace.push({ step: 'rare', index, outcome: 'deferred' });
+            return;
+        }
+        const rolled = Random.chance(entry.chance);
+        trace.push({ step: 'rare', index, outcome: rolled ? 'added' : 'skipped' });
+        if (rolled)
+            roster.push(entry.value);
+    });
+    for (let i = 0; i < regular.length; i++) {
+        const alternative = regular[i].alternative;
+        if (!alternative)
+            continue;
+        const rolled = Random.chance(alternative.chance);
+        trace.push({ step: 'alternative', index: i, outcome: rolled ? 'swapped' : 'kept' });
+        if (rolled)
+            roster[i] = alternative.value;
+    }
+    if (shuffleResult) {
+        Random.shuffle(roster);
+        trace.push({ step: 'shuffle', index: -1, outcome: 'shuffled' });
+    }
+    return { roster, trace };
+}
+//# sourceMappingURL=ContentRoll.js.map

package/dist/roguelike/ContentRoll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentRoll.js","sourceRoot":"","sources":["../../src/roguelike/ContentRoll.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAuC5C;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAI,OAAkC,EAAE,IAAI,GAA4B,EAAE,EAAE,aAAa,GAAG,IAAI;IACzH,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,MAAM,MAAM,GAAQ,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAExD,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7B,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;YACzD,OAAO;QACR,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QAC3E,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAC3C,IAAI,CAAC,WAAW;YAAE,SAAS;QAE3B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACpF,IAAI,MAAM;YAAE,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC;IAC3C,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QACnB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC"}

package/dist/roguelike/DungeonParity.d.ts

@@ -0,0 +1,42 @@
+import type { RoomEdge } from './generate.ts';
+/**
+ * Everything a seeded generation run produced, flattened into plain data a parity check can
+ * diff: the room graph and retry count from `generateDungeonGraph`, the terrain it painted,
+ * whatever feature layer and content rolls a game attached, and however many RNG draws the
+ * game itself chose to count. `mwg` dictates none of the game-side shapes here (`content` is
+ * whatever a game's own roll traces are) - only how to compare two of them.
+ */
+export interface DungeonArtifacts {
+    graph: readonly RoomEdge[];
+    retries: number;
+    /** which builder carved each room, by room index - a paint-stage artifact, not a graph one */
+    roomBuilders: readonly string[];
+    width: number;
+    height: number;
+    terrain: ArrayLike<number>;
+    features: readonly [number, string][];
+    content: readonly unknown[];
+    rngDraws: number;
+}
+/** which half of the pipeline a mismatch belongs to, so a graph bug and a paint bug never get conflated */
+export type DungeonParityStage = 'graph' | 'paint';
+export interface DungeonMismatch {
+    stage: DungeonParityStage;
+    field: string;
+    expected: unknown;
+    actual: unknown;
+}
+/**
+ * Diffs two artifact snapshots (this port's own run against a reference implementation's, or
+ * a golden fixture), reporting every mismatch tagged with which stage it belongs to: `'graph'`
+ * for the room graph and retry count, `'paint'` for terrain, features, content placements and
+ * RNG draw count. An empty result means the two runs are equivalent by every artifact checked.
+ */
+export declare function compareDungeonArtifacts(expected: DungeonArtifacts, actual: DungeonArtifacts): DungeonMismatch[];
+/**
+ * Runs `generate` repeatedly and diffs every later run against the first - the same seed
+ * (pushed by the caller around `generate`) must produce byte-identical artifacts every time,
+ * or the generator itself is non-deterministic regardless of what it is being compared against.
+ */
+export declare function checkDeterminism(generate: () => DungeonArtifacts, runs?: number): DungeonMismatch[];
+//# sourceMappingURL=DungeonParity.d.ts.map

package/dist/roguelike/DungeonParity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DungeonParity.d.ts","sourceRoot":"","sources":["../../src/roguelike/DungeonParity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAEhB,8FAA8F;IAC9F,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAEhC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IACtC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,2GAA2G;AAC3G,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CAChB;AAmBD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,GAAG,eAAe,EAAE,CA2B/G;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,gBAAgB,EAAE,IAAI,SAAI,GAAG,eAAe,EAAE,CAO9F"}

package/dist/roguelike/DungeonParity.js

@@ -0,0 +1,63 @@
+function edgesEqual(a, b) {
+    return a.length === b.length && a.every((edge, i) => edge.a === b[i].a && edge.b === b[i].b && edge.extra === b[i].extra);
+}
+function arraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++)
+        if (a[i] !== b[i])
+            return false;
+    return true;
+}
+function featuresEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    const sortedA = [...a].sort((x, y) => x[0] - y[0]);
+    const sortedB = [...b].sort((x, y) => x[0] - y[0]);
+    return sortedA.every(([cell, kind], i) => cell === sortedB[i][0] && kind === sortedB[i][1]);
+}
+/**
+ * Diffs two artifact snapshots (this port's own run against a reference implementation's, or
+ * a golden fixture), reporting every mismatch tagged with which stage it belongs to: `'graph'`
+ * for the room graph and retry count, `'paint'` for terrain, features, content placements and
+ * RNG draw count. An empty result means the two runs are equivalent by every artifact checked.
+ */
+export function compareDungeonArtifacts(expected, actual) {
+    const mismatches = [];
+    if (expected.retries !== actual.retries) {
+        mismatches.push({ stage: 'graph', field: 'retries', expected: expected.retries, actual: actual.retries });
+    }
+    if (!edgesEqual(expected.graph, actual.graph)) {
+        mismatches.push({ stage: 'graph', field: 'graph', expected: expected.graph, actual: actual.graph });
+    }
+    if (expected.width !== actual.width || expected.height !== actual.height || !arraysEqual(expected.terrain, actual.terrain)) {
+        mismatches.push({ stage: 'paint', field: 'terrain', expected: expected.terrain, actual: actual.terrain });
+    }
+    if (expected.roomBuilders.length !== actual.roomBuilders.length || expected.roomBuilders.some((id, i) => id !== actual.roomBuilders[i])) {
+        mismatches.push({ stage: 'paint', field: 'roomBuilders', expected: expected.roomBuilders, actual: actual.roomBuilders });
+    }
+    if (!featuresEqual(expected.features, actual.features)) {
+        mismatches.push({ stage: 'paint', field: 'features', expected: expected.features, actual: actual.features });
+    }
+    if (JSON.stringify(expected.content) !== JSON.stringify(actual.content)) {
+        mismatches.push({ stage: 'paint', field: 'content', expected: expected.content, actual: actual.content });
+    }
+    if (expected.rngDraws !== actual.rngDraws) {
+        mismatches.push({ stage: 'paint', field: 'rngDraws', expected: expected.rngDraws, actual: actual.rngDraws });
+    }
+    return mismatches;
+}
+/**
+ * Runs `generate` repeatedly and diffs every later run against the first - the same seed
+ * (pushed by the caller around `generate`) must produce byte-identical artifacts every time,
+ * or the generator itself is non-deterministic regardless of what it is being compared against.
+ */
+export function checkDeterminism(generate, runs = 2) {
+    const first = generate();
+    const mismatches = [];
+    for (let i = 1; i < runs; i++) {
+        mismatches.push(...compareDungeonArtifacts(first, generate()));
+    }
+    return mismatches;
+}
+//# sourceMappingURL=DungeonParity.js.map

package/dist/roguelike/DungeonParity.js.map

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

package/dist/roguelike/Features.d.ts

@@ -0,0 +1,42 @@
+/**
+ * A generated cell wearing a named behaviour: a sign, a well, a plant, a statue, a chasm
+ * edge, a trap - anything a regional generator places that the player later looks at or
+ * steps on. `mwg` supplies the four rule slots every one of those shares (inspect it without
+ * triggering it, interact with it, run the consequence that follows, and decide whether it
+ * persists), never what any specific kind actually does - that stays the game's own
+ * definition, supplied fresh each load the way `QuestLog`'s quest definitions already are.
+ */
+export interface CellFeatureDef<TContext = unknown> {
+    /** looking at or searching the cell, without triggering anything */
+    inspect?(cell: number, ctx: TContext): void;
+    /** stepping on or using the cell; returning false refuses the interaction before any consequence runs */
+    interact?(cell: number, ctx: TContext): boolean | void;
+    /** runs once `interact` did not refuse it - the actual effect: damage, an item, a reveal */
+    consequence?(cell: number, ctx: TContext): void;
+    /** false removes the feature immediately after its consequence runs once; default true (repeatable) */
+    persistent?: boolean;
+}
+export declare class FeatureLayer<TContext = unknown> {
+    private defs;
+    private placed;
+    /** registers what a named kind does; call again to replace it, e.g. after loading a save */
+    define(kind: string, def: CellFeatureDef<TContext>): void;
+    /** places a defined kind onto a cell, replacing whatever was there */
+    place(cell: number, kind: string): void;
+    has(cell: number): boolean;
+    kindAt(cell: number): string | undefined;
+    remove(cell: number): void;
+    /** looking at or searching the cell; a no-op on a cell with no feature or no `inspect` rule */
+    inspect(cell: number, ctx: TContext): void;
+    /** using or stepping on the cell; runs `interact` then, unless refused, `consequence` */
+    interact(cell: number, ctx: TContext): void;
+    private defAt;
+    /** only which cell has which kind is save data; definitions are supplied fresh on load */
+    toJSON(): {
+        cells: [number, string][];
+    };
+    static fromJSON<T>(defs: ReadonlyMap<string, CellFeatureDef<T>>, data: {
+        cells: [number, string][];
+    }): FeatureLayer<T>;
+}
+//# sourceMappingURL=Features.d.ts.map

package/dist/roguelike/Features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Features.d.ts","sourceRoot":"","sources":["../../src/roguelike/Features.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc,CAAC,QAAQ,GAAG,OAAO;IACjD,oEAAoE;IACpE,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE5C,yGAAyG;IACzG,QAAQ,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;IAEvD,4FAA4F;IAC5F,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IAEhD,uGAAuG;IACvG,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,YAAY,CAAC,QAAQ,GAAG,OAAO;IAC3C,OAAO,CAAC,IAAI,CAA+C;IAC3D,OAAO,CAAC,MAAM,CAA6B;IAE3C,4FAA4F;IAC5F,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAExD;IAED,sEAAsE;IACtE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGtC;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzB;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvC;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEzB;IAED,+FAA+F;IAC/F,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAGzC;IAED,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAS1C;IAED,OAAO,CAAC,KAAK;IAKb,0FAA0F;IAC1F,MAAM,IAAI;QAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,CAEtC;IAED,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAKrH;CACD"}

package/dist/roguelike/Features.js

@@ -0,0 +1,59 @@
+export class FeatureLayer {
+    constructor() {
+        this.defs = new Map();
+        this.placed = new Map();
+    }
+    /** registers what a named kind does; call again to replace it, e.g. after loading a save */
+    define(kind, def) {
+        this.defs.set(kind, def);
+    }
+    /** places a defined kind onto a cell, replacing whatever was there */
+    place(cell, kind) {
+        if (!this.defs.has(kind))
+            throw new Error(`FeatureLayer.place: no definition for kind "${kind}"`);
+        this.placed.set(cell, kind);
+    }
+    has(cell) {
+        return this.placed.has(cell);
+    }
+    kindAt(cell) {
+        return this.placed.get(cell);
+    }
+    remove(cell) {
+        this.placed.delete(cell);
+    }
+    /** looking at or searching the cell; a no-op on a cell with no feature or no `inspect` rule */
+    inspect(cell, ctx) {
+        const def = this.defAt(cell);
+        def?.inspect?.(cell, ctx);
+    }
+    /** using or stepping on the cell; runs `interact` then, unless refused, `consequence` */
+    interact(cell, ctx) {
+        const def = this.defAt(cell);
+        if (!def)
+            return;
+        const allowed = def.interact ? def.interact(cell, ctx) !== false : true;
+        if (!allowed)
+            return;
+        def.consequence?.(cell, ctx);
+        if (def.persistent === false)
+            this.remove(cell);
+    }
+    defAt(cell) {
+        const kind = this.placed.get(cell);
+        return kind === undefined ? undefined : this.defs.get(kind);
+    }
+    /** only which cell has which kind is save data; definitions are supplied fresh on load */
+    toJSON() {
+        return { cells: [...this.placed.entries()] };
+    }
+    static fromJSON(defs, data) {
+        const layer = new FeatureLayer();
+        for (const [kind, def] of defs)
+            layer.define(kind, def);
+        for (const [cell, kind] of data.cells)
+            layer.place(cell, kind);
+        return layer;
+    }
+}
+//# sourceMappingURL=Features.js.map

package/dist/roguelike/Features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Features.js","sourceRoot":"","sources":["../../src/roguelike/Features.ts"],"names":[],"mappings":"AAsBA,MAAM,OAAO,YAAY;IAAzB;QACS,SAAI,GAAG,IAAI,GAAG,EAAoC,CAAC;QACnD,WAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IA2D5C,CAAC;IAzDA,4FAA4F;IAC5F,MAAM,CAAC,IAAY,EAAE,GAA6B;QACjD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,IAAY,EAAE,IAAY;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,GAAG,CAAC,CAAC;QAClG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,IAAY;QAClB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,+FAA+F;IAC/F,OAAO,CAAC,IAAY,EAAE,GAAa;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,GAAG,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,yFAAyF;IACzF,QAAQ,CAAC,IAAY,EAAE,GAAa;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG;YAAE,OAAO;QAEjB,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACxE,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7B,IAAI,GAAG,CAAC,UAAU,KAAK,KAAK;YAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IAEO,KAAK,CAAC,IAAY;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,0FAA0F;IAC1F,MAAM;QACL,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,QAAQ,CAAI,IAA4C,EAAE,IAAmC;QACnG,MAAM,KAAK,GAAG,IAAI,YAAY,EAAK,CAAC;QACpC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI;YAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACxD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/D,OAAO,KAAK,CAAC;IACd,CAAC;CACD"}

package/dist/roguelike/MonsterAI.js

@@ -34,7 +34,7 @@ export function decideMonsterAI(level, pathfinder, self, hpFraction, target, opt
 /** a random open neighbour, or null when boxed in - wandering needs no path, just a step */
 function wanderStep(level, self, options) {
     const open = openNeighbours(level, self, options);
-    return open.length > 0 ? Random.element(open) : null;
+    return Random.element(open);
 }
 /** the open neighbour furthest from the target - moving away needs no path either */
 function fleeStep(level, self, target, options) {

package/dist/roguelike/MonsterAI.js.map

@@ -1 +1 @@
-{"version":3,"file":"MonsterAI.js","sourceRoot":"","sources":["../../src/roguelike/MonsterAI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAgD,MAAM,iBAAiB,CAAC;AAgCjG;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC9B,KAAY,EACZ,UAAsB,EACtB,IAAU,EACV,UAAkB,EAClB,MAAY,EACZ,OAAO,GAAqB,EAAE;IAE9B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,SAAS,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC;IAE5F,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;IACnC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAExC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;IACpE,CAAC;IAED,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACxE,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,4FAA4F;AAC5F,SAAS,UAAU,CAAC,KAAY,EAAE,IAAU,EAAE,OAAoB;IACjE,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC;AAED,qFAAqF;AACrF,SAAS,QAAQ,CAAC,KAAY,EAAE,IAAU,EAAE,MAAY,EAAE,OAAoB;IAC7E,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,IAAI,GAAgB,IAAI,CAAC;IAC7B,IAAI,YAAY,GAAG,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEjD,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,QAAQ,GAAG,YAAY,EAAE,CAAC;YAC7B,YAAY,GAAG,QAAQ,CAAC;YACxB,IAAI,GAAG,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAC,KAAY,EAAE,IAAU,EAAE,OAAoB;IACrE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,MAAM,GAAG,GAAW,EAAE,CAAC;IAEvB,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;YAAE,SAAS;QAC9C,IAAI,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YAAE,SAAS;QACxD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,SAAS,eAAe,CAAC,CAAO,EAAE,CAAO;IACxC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"MonsterAI.js","sourceRoot":"","sources":["../../src/roguelike/MonsterAI.ts"],"names":[],"mappings":"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"}

package/dist/roguelike/MultiStageAbility.d.ts

@@ -0,0 +1,43 @@
+/**
+ * An ability whose own use unfolds through named stages in sequence (windup, active, recovery)
+ * rather than resolving instantly - the multi-stage subclass/ability shape a talent branch's
+ * capstone move often needs, distinct from `AbilityCycle`'s cooldown-only view of "may I use
+ * this yet". `mwg` tracks only which stage is current and when it should advance; what each
+ * stage does (grant invulnerability, deal damage, open a window for a follow-up) stays the
+ * game's own hook, fired from `advance`'s returned stage name.
+ */
+export interface AbilityStage {
+    name: string;
+    /** turns this stage lasts once entered */
+    duration: number;
+}
+export declare class MultiStageAbility {
+    private stages;
+    private index;
+    private remaining;
+    constructor(stages: readonly AbilityStage[]);
+    /** whether the ability is currently mid-sequence */
+    get active(): boolean;
+    /** the currently active stage, or null when not in use */
+    get stage(): AbilityStage | null;
+    /** begins the ability at its first stage; a no-op, reporting false, while already active */
+    start(): boolean;
+    /**
+     * Advances one turn.
+     *
+     * @returns the newly entered stage's name the turn a stage changes, `'done'` the turn the
+     * last stage finishes, or null when nothing changed (still mid-stage, or never started)
+     */
+    advance(): string | null;
+    /** ends the ability early - interrupted mid-windup, say */
+    cancel(): void;
+    toJSON(): {
+        index: number;
+        remaining: number;
+    };
+    static fromJSON(stages: readonly AbilityStage[], data: {
+        index: number;
+        remaining: number;
+    }): MultiStageAbility;
+}
+//# sourceMappingURL=MultiStageAbility.d.ts.map

package/dist/roguelike/MultiStageAbility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiStageAbility.d.ts","sourceRoot":"","sources":["../../src/roguelike/MultiStageAbility.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,SAAS,CAAK;IAEtB,YAAY,MAAM,EAAE,SAAS,YAAY,EAAE,EAG1C;IAED,oDAAoD;IACpD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,0DAA0D;IAC1D,IAAI,KAAK,IAAI,YAAY,GAAG,IAAI,CAE/B;IAED,4FAA4F;IAC5F,KAAK,IAAI,OAAO,CAKf;IAED;;;;;OAKG;IACH,OAAO,IAAI,MAAM,GAAG,IAAI,CAYvB;IAED,2DAA2D;IAC3D,MAAM,IAAI,IAAI,CAGb;IAED,MAAM,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAE7C;IAED,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,CAK9G;CACD"}

package/dist/roguelike/MultiStageAbility.js

@@ -0,0 +1,60 @@
+export class MultiStageAbility {
+    constructor(stages) {
+        this.index = -1;
+        this.remaining = 0;
+        if (stages.length === 0)
+            throw new Error('a multi-stage ability needs at least one stage');
+        this.stages = stages;
+    }
+    /** whether the ability is currently mid-sequence */
+    get active() {
+        return this.index >= 0;
+    }
+    /** the currently active stage, or null when not in use */
+    get stage() {
+        return this.index >= 0 ? this.stages[this.index] : null;
+    }
+    /** begins the ability at its first stage; a no-op, reporting false, while already active */
+    start() {
+        if (this.active)
+            return false;
+        this.index = 0;
+        this.remaining = this.stages[0].duration;
+        return true;
+    }
+    /**
+     * Advances one turn.
+     *
+     * @returns the newly entered stage's name the turn a stage changes, `'done'` the turn the
+     * last stage finishes, or null when nothing changed (still mid-stage, or never started)
+     */
+    advance() {
+        if (!this.active)
+            return null;
+        this.remaining--;
+        if (this.remaining > 0)
+            return null;
+        this.index++;
+        if (this.index >= this.stages.length) {
+            this.index = -1;
+            return 'done';
+        }
+        this.remaining = this.stages[this.index].duration;
+        return this.stages[this.index].name;
+    }
+    /** ends the ability early - interrupted mid-windup, say */
+    cancel() {
+        this.index = -1;
+        this.remaining = 0;
+    }
+    toJSON() {
+        return { index: this.index, remaining: this.remaining };
+    }
+    static fromJSON(stages, data) {
+        const ability = new MultiStageAbility(stages);
+        ability.index = data.index;
+        ability.remaining = data.remaining;
+        return ability;
+    }
+}
+//# sourceMappingURL=MultiStageAbility.js.map