@datamoc/mw_games 0.43.0 → 0.45.0

package/dist/actors/Appearances.d.ts

@@ -1,48 +0,0 @@
-/**
- * Per-run appearance shuffling for unidentified items: which look each kind wears.
- *
- * A game with identification needs this the moment it has more than one unidentified
- * kind in a category - without it, every run's "red potion" would always be the same
- * kind, and identifying one would identify them all forever. The mapping is drawn once
- * per run (a seeded shuffle, so a run's seed fully determines it) and stays fixed until
- * the run ends; revealing a kind's true nature stays the game's own `identify()` call,
- * which keeps reading the mapping for the *unidentified* label only.
- */
-export interface AppearanceTable {
-    /** the item kinds sharing one pool of looks, e.g. every potion kind */
-    kinds: readonly string[];
-    /** the distinct looks to deal out; must cover every kind, extras stay unused */
-    labels: readonly string[];
-}
-/**
- * Deals each kind a distinct label from a shuffled copy of the pool - pure, so a game
- * that wants the shuffle scoped (one seed per run, say) wraps it in `Random.withSeed`.
- *
- * @example
- * ```ts
- * import { assignAppearances, Appearances } from '@datamoc/mw_games/actors';
- *
- * const potions = assignAppearances({ kinds: ['healing', 'poison'], labels: ['red', 'blue'] });
- * console.log(potions.get('healing')); // 'red' or 'blue', fixed for this shuffle
- *
- * // Appearances wraps this per category, drawing lazily on first ask and caching for the run
- * const appearances = new Appearances({ potions: { kinds: ['healing', 'poison'], labels: ['red', 'blue'] } });
- * const label = appearances.appearanceOf('potions', 'healing');
- * ```
- */
-export declare function assignAppearances(table: AppearanceTable): Map<string, string>;
-export declare class Appearances {
-    private tables;
-    private assigned;
-    constructor(tables: Record<string, AppearanceTable>);
-    /** the look `kind` wears this run in `category`, drawing the shuffle on first ask */
-    appearanceOf(category: string, kind: string): string;
-    toJSON(): {
-        assigned: [string, [string, string][]][];
-    };
-    /** rebuilds appearances from save data - the tables themselves are supplied fresh, the same as `QuestLog` definitions */
-    static fromJSON(tables: Record<string, AppearanceTable>, data: {
-        assigned: [string, [string, string][]][];
-    }): Appearances;
-}
-//# sourceMappingURL=Appearances.d.ts.map

package/dist/actors/Appearances.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Appearances.d.ts","sourceRoot":"","sources":["../../src/actors/Appearances.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,MAAM,WAAW,eAAe;IAC/B,uEAAuE;IACvE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAEzB,gFAAgF;IAChF,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAY7E;AAED,qBAAa,WAAW;IACvB,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,QAAQ,CAA0C;IAE1D,YAAY,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAElD;IAED,qFAAqF;IACrF,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAWnD;IAED,MAAM,IAAI;QAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAA;KAAE,CAErD;IAED,yHAAyH;IACzH,MAAM,CAAC,QAAQ,CACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACvC,IAAI,EAAE;QAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAA;KAAE,GAChD,WAAW,CAIb;CACD"}

package/dist/actors/Appearances.js

@@ -1,62 +0,0 @@
-import * as Random from '../core/Random.js';
-/**
- * Deals each kind a distinct label from a shuffled copy of the pool - pure, so a game
- * that wants the shuffle scoped (one seed per run, say) wraps it in `Random.withSeed`.
- *
- * @example
- * ```ts
- * import { assignAppearances, Appearances } from '@datamoc/mw_games/actors';
- *
- * const potions = assignAppearances({ kinds: ['healing', 'poison'], labels: ['red', 'blue'] });
- * console.log(potions.get('healing')); // 'red' or 'blue', fixed for this shuffle
- *
- * // Appearances wraps this per category, drawing lazily on first ask and caching for the run
- * const appearances = new Appearances({ potions: { kinds: ['healing', 'poison'], labels: ['red', 'blue'] } });
- * const label = appearances.appearanceOf('potions', 'healing');
- * ```
- */
-export function assignAppearances(table) {
-    if (table.labels.length < table.kinds.length) {
-        throw new Error(`not enough appearances: ${table.kinds.length} kinds but only ${table.labels.length} labels`);
-    }
-    const pool = [...table.labels];
-    for (let i = pool.length - 1; i > 0; i--) {
-        const j = Random.int(0, i + 1);
-        [pool[i], pool[j]] = [pool[j], pool[i]];
-    }
-    const out = new Map();
-    table.kinds.forEach((kind, index) => out.set(kind, pool[index]));
-    return out;
-}
-export class Appearances {
-    constructor(tables) {
-        this.assigned = new Map();
-        this.tables = tables;
-    }
-    /** the look `kind` wears this run in `category`, drawing the shuffle on first ask */
-    appearanceOf(category, kind) {
-        let categoryMap = this.assigned.get(category);
-        if (!categoryMap) {
-            const table = this.tables[category];
-            if (!table)
-                throw new Error(`no such appearance category: "${category}"`);
-            categoryMap = assignAppearances(table);
-            this.assigned.set(category, categoryMap);
-        }
-        const label = categoryMap.get(kind);
-        if (label === undefined)
-            throw new Error(`"${kind}" is not in appearance category "${category}"`);
-        return label;
-    }
-    toJSON() {
-        return { assigned: [...this.assigned].map(([category, map]) => [category, [...map]]) };
-    }
-    /** rebuilds appearances from save data - the tables themselves are supplied fresh, the same as `QuestLog` definitions */
-    static fromJSON(tables, data) {
-        const appearances = new Appearances(tables);
-        for (const [category, entries] of data.assigned)
-            appearances.assigned.set(category, new Map(entries));
-        return appearances;
-    }
-}
-//# sourceMappingURL=Appearances.js.map

package/dist/actors/Appearances.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Appearances.js","sourceRoot":"","sources":["../../src/actors/Appearances.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAqB5C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAsB;IACvD,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,CAAC,KAAK,CAAC,MAAM,mBAAmB,KAAK,CAAC,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC;IAC/G,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjE,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,MAAM,OAAO,WAAW;IAIvB,YAAY,MAAuC;QAF3C,aAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;QAGzD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,qFAAqF;IACrF,YAAY,CAAC,QAAgB,EAAE,IAAY;QAC1C,IAAI,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,WAAW,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACpC,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,GAAG,CAAC,CAAC;YAC1E,WAAW,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,oCAAoC,QAAQ,GAAG,CAAC,CAAC;QAClG,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM;QACL,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxF,CAAC;IAED,yHAAyH;IACzH,MAAM,CAAC,QAAQ,CACd,MAAuC,EACvC,IAAkD;QAElD,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QAC5C,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ;YAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QACtG,OAAO,WAAW,CAAC;IACpB,CAAC;CACD"}

package/dist/actors/Aura.d.ts

@@ -1,45 +0,0 @@
-import { StatBlock, type Modifier } from './StatBlock.ts';
-/** "adjacent allies fight better while this unit is nearby" - the modifiers, not the radius */
-export interface AuraDef {
-    name: string;
-    modifiers: readonly Omit<Modifier, 'source'>[];
-}
-/** anyone who might carry or receive an aura; `aura` absent or `null` means "carries none" */
-export interface AuraParticipant {
-    stats: StatBlock;
-    aura?: AuraDef | null;
-}
-/**
- * Continuously reapplies auras as who is adjacent to whom changes, unlike `battle.BattleHooks`
- * (triggered once) or `actors.StatusEffect` (expires on a timer) - neither re-checks "is a
- * qualifying unit still adjacent" on its own, which is exactly what a positional aura needs
- * every time anyone moves.
- *
- * Call `update` once per relevant tick with the full roster and an adjacency test; "adjacent"
- * is deliberately left to the caller (square grid, hex grid, board-tactics neighbours all mean
- * something different) rather than assumed here. Each call diffs against who was affected by
- * each carrier last time: a unit that just became adjacent gets the carrier's modifiers added,
- * one that just left loses exactly those modifiers, and one that stays adjacent is left alone
- * rather than having its modifiers reapplied on every tick.
- *
- * @example
- * ```ts
- * import { AuraField, StatBlock, type AuraParticipant } from '@datamoc/mw_games/actors';
- *
- * const field = new AuraField();
- * const captain: AuraParticipant = {
- *   stats: new StatBlock({ base: {} }),
- *   aura: { name: 'rally', modifiers: [{ stat: 'attack', op: 'add', value: 2 }] },
- * };
- * const soldier: AuraParticipant = { stats: new StatBlock({ base: { attack: 5 } }) };
- *
- * // call every time positions change, with whatever "adjacent" means on this grid
- * field.update([captain, soldier], (a, b) => a === captain && b === soldier);
- * console.log(soldier.stats.get('attack')); // 7, while adjacent
- * ```
- */
-export declare class AuraField {
-    private affected;
-    update(participants: readonly AuraParticipant[], isAdjacent: (a: AuraParticipant, b: AuraParticipant) => boolean): void;
-}
-//# sourceMappingURL=Aura.d.ts.map

package/dist/actors/Aura.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Aura.d.ts","sourceRoot":"","sources":["../../src/actors/Aura.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1D,+FAA+F;AAC/F,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;CAC/C;AAED,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,SAAS;IAGrB,OAAO,CAAC,QAAQ,CAA4D;IAE5E,MAAM,CACL,YAAY,EAAE,SAAS,eAAe,EAAE,EACxC,UAAU,EAAE,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,KAAK,OAAO,GAC7D,IAAI,CA8CN;CACD"}

package/dist/actors/Aura.js

@@ -1,85 +0,0 @@
-import { StatBlock } from './StatBlock.js';
-/**
- * Continuously reapplies auras as who is adjacent to whom changes, unlike `battle.BattleHooks`
- * (triggered once) or `actors.StatusEffect` (expires on a timer) - neither re-checks "is a
- * qualifying unit still adjacent" on its own, which is exactly what a positional aura needs
- * every time anyone moves.
- *
- * Call `update` once per relevant tick with the full roster and an adjacency test; "adjacent"
- * is deliberately left to the caller (square grid, hex grid, board-tactics neighbours all mean
- * something different) rather than assumed here. Each call diffs against who was affected by
- * each carrier last time: a unit that just became adjacent gets the carrier's modifiers added,
- * one that just left loses exactly those modifiers, and one that stays adjacent is left alone
- * rather than having its modifiers reapplied on every tick.
- *
- * @example
- * ```ts
- * import { AuraField, StatBlock, type AuraParticipant } from '@datamoc/mw_games/actors';
- *
- * const field = new AuraField();
- * const captain: AuraParticipant = {
- *   stats: new StatBlock({ base: {} }),
- *   aura: { name: 'rally', modifiers: [{ stat: 'attack', op: 'add', value: 2 }] },
- * };
- * const soldier: AuraParticipant = { stats: new StatBlock({ base: { attack: 5 } }) };
- *
- * // call every time positions change, with whatever "adjacent" means on this grid
- * field.update([captain, soldier], (a, b) => a === captain && b === soldier);
- * console.log(soldier.stats.get('attack')); // 7, while adjacent
- * ```
- */
-export class AuraField {
-    constructor() {
-        //per carrier, which participants currently carry that carrier's modifiers and under
-        //what source symbol - a unit inside two carriers' auras at once tracks both independently
-        this.affected = new Map();
-    }
-    update(participants, isAdjacent) {
-        const roster = new Set(participants);
-        const carriers = participants.filter((p) => !!p.aura);
-        const carrierSet = new Set(carriers);
-        for (const carrier of carriers) {
-            let currentlyAffected = this.affected.get(carrier);
-            if (!currentlyAffected) {
-                currentlyAffected = new Map();
-                this.affected.set(carrier, currentlyAffected);
-            }
-            for (const other of participants) {
-                if (other === carrier)
-                    continue;
-                const adjacent = isAdjacent(carrier, other);
-                const source = currentlyAffected.get(other);
-                if (adjacent && !source) {
-                    const newSource = Symbol(`aura:${carrier.aura.name}`);
-                    for (const modifier of carrier.aura.modifiers)
-                        other.stats.addModifier({ ...modifier, source: newSource });
-                    currentlyAffected.set(other, newSource);
-                }
-                else if (!adjacent && source) {
-                    other.stats.removeModifiersFrom(source);
-                    currentlyAffected.delete(other);
-                }
-            }
-            //a target affected last call but absent from this call's roster entirely (died,
-            //was removed) is never visited by the loop above, since that only walks
-            //`participants` - left alone, its modifiers and its own strong reference here
-            //would both persist forever
-            for (const [other, source] of [...currentlyAffected]) {
-                if (roster.has(other))
-                    continue;
-                other.stats.removeModifiersFrom(source);
-                currentlyAffected.delete(other);
-            }
-        }
-        //a carrier that died, lost its aura, or simply is not in this call's roster any more
-        //stops affecting anyone it was still affecting, rather than leaving stale modifiers
-        for (const [carrier, currentlyAffected] of [...this.affected]) {
-            if (carrierSet.has(carrier))
-                continue;
-            for (const [other, source] of currentlyAffected)
-                other.stats.removeModifiersFrom(source);
-            this.affected.delete(carrier);
-        }
-    }
-}
-//# sourceMappingURL=Aura.js.map

package/dist/actors/Aura.js.map

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

package/dist/actors/Barrier.d.ts

@@ -1,60 +0,0 @@
-/**
- * A shield/barrier pool absorbed before HP, decaying on its own each tick unlike a plain
- * `StatBlock` stat, which only ever changes when something explicitly touches it. Several
- * layers can be held at once - a fresh cast over an older one, a ward stacked on a shield -
- * absorption always drains the most recently added layer first, so a ward cast on top of a
- * standing shield breaks before the shield underneath it does, matching how a layered proc
- * family (barrier-then-shield, shield-then-barrier) is meant to read regardless of order cast.
- *
- * @example
- * ```ts
- * import { Barrier } from '@datamoc/mw_games/actors';
- *
- * const barrier = new Barrier();
- * barrier.add(20); // a shield spell
- * barrier.add(10, 2); // a ward on top, decaying 2 per turn on its own
- *
- * const absorbed = barrier.absorb(15); // drains the ward first, then spills into the shield
- * barrier.advance(1); // one turn of decay
- * console.log(barrier.total);
- * ```
- */
-export interface BarrierLayer {
-    amount: number;
-    /** how much this layer's `amount` drops per turn advanced; 0 (the default) never decays on its own */
-    decayPerTick?: number;
-}
-export declare class Barrier {
-    private layers;
-    /** adds a new outermost layer; a non-positive amount is a no-op rather than an empty layer */
-    add(amount: number, decayPerTick?: number): void;
-    /** total absorption currently held, across every layer */
-    get total(): number;
-    /** how many independent layers are currently held */
-    get layerCount(): number;
-    /**
-     * Absorbs up to `amount` of incoming damage, draining the outermost layer first and
-     * spilling into the next one once a layer empties.
-     *
-     * @returns the amount actually absorbed - never more than `amount`, never more than
-     * `total` was before the call - so the caller applies `amount - absorbed` to HP
-     */
-    absorb(amount: number): number;
-    /**
-     * Decays every layer by its own `decayPerTick`, removing any that reach zero or below.
-     *
-     * Named `advance(turns)` like every other turn-scale ticker here (`TurnClock`, `Charges`,
-     * `Field`, `AbilityCycle`) rather than `decay`, so one word means one thing across the
-     * framework: `advance` takes whole turns, `update` takes `dt` seconds.
-     */
-    advance(turns?: number): void;
-    /** drops every layer at once - a dispel, a fresh encounter starting clean */
-    clear(): void;
-    toJSON(): {
-        layers: BarrierLayer[];
-    };
-    static fromJSON(data: {
-        layers: BarrierLayer[];
-    }): Barrier;
-}
-//# sourceMappingURL=Barrier.d.ts.map

package/dist/actors/Barrier.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Barrier.d.ts","sourceRoot":"","sources":["../../src/actors/Barrier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAC;IAEf,sGAAsG;IACtG,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,OAAO;IACnB,OAAO,CAAC,MAAM,CAAsB;IAEpC,8FAA8F;IAC9F,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,SAAI,GAAG,IAAI,CAG1C;IAED,0DAA0D;IAC1D,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,qDAAqD;IACrD,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAY7B;IAED;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,SAAI,GAAG,IAAI,CAOvB;IAED,6EAA6E;IAC7E,KAAK,IAAI,IAAI,CAEZ;IAED,MAAM,IAAI;QAAE,MAAM,EAAE,YAAY,EAAE,CAAA;KAAE,CAEnC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,YAAY,EAAE,CAAA;KAAE,GAAG,OAAO,CAIzD;CACD"}

package/dist/actors/Barrier.js

@@ -1,70 +0,0 @@
-export class Barrier {
-    constructor() {
-        this.layers = [];
-    }
-    /** adds a new outermost layer; a non-positive amount is a no-op rather than an empty layer */
-    add(amount, decayPerTick = 0) {
-        if (amount <= 0)
-            return;
-        this.layers.push({ amount, decayPerTick });
-    }
-    /** total absorption currently held, across every layer */
-    get total() {
-        return this.layers.reduce((sum, layer) => sum + layer.amount, 0);
-    }
-    /** how many independent layers are currently held */
-    get layerCount() {
-        return this.layers.length;
-    }
-    /**
-     * Absorbs up to `amount` of incoming damage, draining the outermost layer first and
-     * spilling into the next one once a layer empties.
-     *
-     * @returns the amount actually absorbed - never more than `amount`, never more than
-     * `total` was before the call - so the caller applies `amount - absorbed` to HP
-     */
-    absorb(amount) {
-        let remaining = amount;
-        let absorbed = 0;
-        while (remaining > 0 && this.layers.length > 0) {
-            const layer = this.layers[this.layers.length - 1];
-            const take = Math.min(layer.amount, remaining);
-            layer.amount -= take;
-            remaining -= take;
-            absorbed += take;
-            if (layer.amount <= 0)
-                this.layers.pop();
-        }
-        return absorbed;
-    }
-    /**
-     * Decays every layer by its own `decayPerTick`, removing any that reach zero or below.
-     *
-     * Named `advance(turns)` like every other turn-scale ticker here (`TurnClock`, `Charges`,
-     * `Field`, `AbilityCycle`) rather than `decay`, so one word means one thing across the
-     * framework: `advance` takes whole turns, `update` takes `dt` seconds.
-     */
-    advance(turns = 1) {
-        for (let i = this.layers.length - 1; i >= 0; i--) {
-            const layer = this.layers[i];
-            if (!layer.decayPerTick)
-                continue;
-            layer.amount -= layer.decayPerTick * turns;
-            if (layer.amount <= 0)
-                this.layers.splice(i, 1);
-        }
-    }
-    /** drops every layer at once - a dispel, a fresh encounter starting clean */
-    clear() {
-        this.layers = [];
-    }
-    toJSON() {
-        return { layers: this.layers.map((layer) => ({ ...layer })) };
-    }
-    static fromJSON(data) {
-        const barrier = new Barrier();
-        barrier.layers = data.layers.map((layer) => ({ ...layer }));
-        return barrier;
-    }
-}
-//# sourceMappingURL=Barrier.js.map

package/dist/actors/Barrier.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Barrier.js","sourceRoot":"","sources":["../../src/actors/Barrier.ts"],"names":[],"mappings":"AA4BA,MAAM,OAAO,OAAO;IAApB;QACS,WAAM,GAAmB,EAAE,CAAC;IAqErC,CAAC;IAnEA,8FAA8F;IAC9F,GAAG,CAAC,MAAc,EAAE,YAAY,GAAG,CAAC;QACnC,IAAI,MAAM,IAAI,CAAC;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,0DAA0D;IAC1D,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,qDAAqD;IACrD,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,MAAc;QACpB,IAAI,SAAS,GAAG,MAAM,CAAC;QACvB,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,OAAO,SAAS,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAC/C,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC;YACrB,SAAS,IAAI,IAAI,CAAC;YAClB,QAAQ,IAAI,IAAI,CAAC;YACjB,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,GAAG,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,YAAY;gBAAE,SAAS;YAClC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC;YAC3C,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjD,CAAC;IACF,CAAC;IAED,6EAA6E;IAC7E,KAAK;QACJ,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,MAAM;QACL,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAgC;QAC/C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5D,OAAO,OAAO,CAAC;IAChB,CAAC;CACD"}

package/dist/actors/Charges.d.ts

@@ -1,66 +0,0 @@
-/**
- * A resource that refills on its own as turns pass - a wand's limited charges regenerating
- * one every few turns - distinct from a straight spendable pool (mana spent per cast,
- * restored only by an explicit event, which a `StatBlock` stat already covers on its own).
- * What that alone cannot express is "this refills automatically over time," so `Charges`
- * carries its own regeneration progress instead of leaning on `TurnClock` for it - a charge
- * either has or does not have enough banked turns to regenerate, which is exactly the kind
- * of running total a class holds more naturally than a callback would.
- *
- * @example
- * ```ts
- * import { Charges } from '@datamoc/mw_games/actors';
- *
- * const wand = new Charges({ max: 3, regenRate: 10 }); // one charge every 10 turns
- * wand.spend(1);
- *
- * wand.advance(10); // 10 turns pass; one charge regenerates
- * console.log(wand.current); // back to max
- *
- * wand.refund(1); // a kill or crit grants a charge directly, outside the normal regen path
- * ```
- */
-export interface ChargesOptions {
-    /** the most this can ever hold */
-    max: number;
-    /** starting amount; defaults to `max` (a fresh wand starts full) */
-    current?: number;
-    /** turns of banked time needed to regenerate one charge */
-    regenRate: number;
-}
-export declare class Charges {
-    readonly max: number;
-    private regenRate;
-    private value;
-    private progress;
-    constructor(options: ChargesOptions);
-    get current(): number;
-    canAfford(cost: number): boolean;
-    /** @returns false, spending nothing, if `cost` is not affordable right now */
-    spend(cost: number): boolean;
-    /**
-     * Restores charges directly, outside the normal regen path - a killing blow or a crit
-     * refunding one on the spot. Capped at `max`.
-     *
-     * @returns how many were actually added, which is less than `amount` once `max` is hit
-     */
-    refund(amount?: number): number;
-    /** banks `turns` of regeneration time, converting whole `regenRate`-sized chunks into charges */
-    advance(turns?: number): void;
-    /**
-     * Charges held, and progress banked towards the next one.
-     *
-     * The banked progress matters as much as the count: without it, saving and loading part
-     * way to a recharge would silently reset that wait, so a player could refresh a wand a
-     * little faster by reloading. `max` and `regenRate` are definitions, supplied fresh.
-     */
-    toJSON(): {
-        current: number;
-        progress: number;
-    };
-    static fromJSON(options: ChargesOptions, data: {
-        current: number;
-        progress: number;
-    }): Charges;
-}
-//# sourceMappingURL=Charges.d.ts.map

package/dist/actors/Charges.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Charges.d.ts","sourceRoot":"","sources":["../../src/actors/Charges.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,cAAc;IAC9B,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IAEZ,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,OAAO;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAK;IAErB,YAAY,OAAO,EAAE,cAAc,EAIlC;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/B;IAED,8EAA8E;IAC9E,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAI3B;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAM,SAAI,GAAG,MAAM,CAIzB;IAED,iGAAiG;IACjG,OAAO,CAAC,KAAK,SAAI,GAAG,IAAI,CAWvB;IAED;;;;;;OAMG;IACH,MAAM,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAE9C;IAED,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAI7F;CACD"}

package/dist/actors/Charges.js

@@ -1,61 +0,0 @@
-export class Charges {
-    constructor(options) {
-        this.progress = 0;
-        this.max = options.max;
-        this.regenRate = options.regenRate;
-        this.value = options.current ?? options.max;
-    }
-    get current() {
-        return this.value;
-    }
-    canAfford(cost) {
-        return this.value >= cost;
-    }
-    /** @returns false, spending nothing, if `cost` is not affordable right now */
-    spend(cost) {
-        if (!this.canAfford(cost))
-            return false;
-        this.value -= cost;
-        return true;
-    }
-    /**
-     * Restores charges directly, outside the normal regen path - a killing blow or a crit
-     * refunding one on the spot. Capped at `max`.
-     *
-     * @returns how many were actually added, which is less than `amount` once `max` is hit
-     */
-    refund(amount = 1) {
-        const added = Math.min(amount, this.max - this.value);
-        this.value += added;
-        return added;
-    }
-    /** banks `turns` of regeneration time, converting whole `regenRate`-sized chunks into charges */
-    advance(turns = 1) {
-        if (this.value >= this.max)
-            return;
-        this.progress += turns;
-        while (this.progress >= this.regenRate && this.value < this.max) {
-            this.progress -= this.regenRate;
-            this.value++;
-        }
-        //full again: no point banking further progress towards a charge there is no room for
-        if (this.value >= this.max)
-            this.progress = 0;
-    }
-    /**
-     * Charges held, and progress banked towards the next one.
-     *
-     * The banked progress matters as much as the count: without it, saving and loading part
-     * way to a recharge would silently reset that wait, so a player could refresh a wand a
-     * little faster by reloading. `max` and `regenRate` are definitions, supplied fresh.
-     */
-    toJSON() {
-        return { current: this.value, progress: this.progress };
-    }
-    static fromJSON(options, data) {
-        const charges = new Charges({ ...options, current: data.current });
-        charges.progress = data.progress;
-        return charges;
-    }
-}
-//# sourceMappingURL=Charges.js.map

package/dist/actors/Charges.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Charges.js","sourceRoot":"","sources":["../../src/actors/Charges.ts"],"names":[],"mappings":"AAiCA,MAAM,OAAO,OAAO;IAMnB,YAAY,OAAuB;QAF3B,aAAQ,GAAG,CAAC,CAAC;QAGpB,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC;IAC7C,CAAC;IAED,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,SAAS,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;IAC3B,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,IAAY;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAM,GAAG,CAAC;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;QACpB,OAAO,KAAK,CAAC;IACd,CAAC;IAED,iGAAiG;IACjG,OAAO,CAAC,KAAK,GAAG,CAAC;QAChB,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG;YAAE,OAAO;QAEnC,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC;QACvB,OAAO,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC;YAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACd,CAAC;QAED,qFAAqF;QACrF,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;OAMG;IACH,MAAM;QACL,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,OAAuB,EAAE,IAA2C;QACnF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QACjC,OAAO,OAAO,CAAC;IAChB,CAAC;CACD"}