@datamoc/mw_games 0.44.2 → 0.46.0

package/dist/actors/Inventory.js

@@ -1,165 +0,0 @@
-/**
- * Items a character carries: stacking, weight, and containers within containers.
- *
- * A slot holds a quantity of one kind of item rather than one entry per item, which is what
- * stacking means in practice - forty arrows are one inventory slot, not forty. Weight and
- * capacity are optional: a game that does not track carry weight simply never sets a
- * capacity, and every check trivially passes.
- *
- * @example
- * ```ts
- * import { Inventory } from '@datamoc/mw_games/actors';
- *
- * const bag = new Inventory({ capacity: 50 });
- * bag.add({ id: 'potion', quantity: 3, stackable: true, weight: 0.5 });
- * bag.add({ id: 'potion', quantity: 2, stackable: true, weight: 0.5 }); // merges into one stack of 5
- *
- * const potion = bag.find('potion');
- * console.log(potion?.quantity, bag.totalWeight);
- * ```
- */
-export class Inventory {
-    constructor(options = {}) {
-        this.slots = [];
-        this.capacity = options.capacity;
-    }
-    get items() {
-        return this.slots;
-    }
-    get totalWeight() {
-        return this.slots.reduce((sum, item) => sum + this.weightOf(item), 0);
-    }
-    weightOf(item) {
-        return (item.weight ?? 0) * item.quantity + (item.contents?.totalWeight ?? 0);
-    }
-    /** Finds the first item of a kind, or the matching instance when `instanceId` is supplied. */
-    find(id, instanceId) {
-        return this.slots.find((item) => item.id === id && (instanceId === undefined || item.instanceId === instanceId));
-    }
-    /**
-     * Adds an item, merging into an existing stack when both are stackable.
-     *
-     * @returns false when a capacity is set and this would exceed it - nothing is added
-     */
-    add(item) {
-        if (!Number.isFinite(item.quantity) || item.quantity <= 0)
-            return false;
-        if (item.weight !== undefined && (!Number.isFinite(item.weight) || item.weight < 0))
-            return false;
-        if (this.capacity !== undefined && this.totalWeight + this.weightOf(item) > this.capacity) {
-            return false;
-        }
-        if (item.stackable) {
-            const existing = this.slots.find((s) => s.id === item.id && s.stackable && s.instanceId === item.instanceId);
-            if (existing) {
-                existing.quantity += item.quantity;
-                return true;
-            }
-        }
-        this.slots.push({ ...item });
-        return true;
-    }
-    /** removes up to `quantity` (default: the whole stack); the slot disappears once empty */
-    remove(id, quantity, instanceId) {
-        if (quantity !== undefined && (!Number.isFinite(quantity) || quantity <= 0))
-            return;
-        const index = this.slots.findIndex((item) => item.id === id && (instanceId === undefined || item.instanceId === instanceId));
-        if (index === -1)
-            return;
-        const item = this.slots[index];
-        item.quantity -= quantity ?? item.quantity;
-        if (item.quantity <= 0)
-            this.slots.splice(index, 1);
-    }
-    /**
-     * Takes up to `quantity` from one stack and returns an item snapshot suitable for adding to
-     * another inventory. All instance state travels with it; only the quantity is split.
-     */
-    take(id, quantity = 1, instanceId) {
-        if (!Number.isFinite(quantity) || quantity <= 0)
-            return undefined;
-        const index = this.slots.findIndex((item) => item.id === id && (instanceId === undefined || item.instanceId === instanceId));
-        if (index === -1)
-            return undefined;
-        const item = this.slots[index];
-        const taken = Math.min(Math.floor(quantity), item.quantity);
-        if (taken <= 0)
-            return undefined;
-        const snapshot = { ...item, quantity: taken };
-        item.quantity -= taken;
-        if (item.quantity <= 0)
-            this.slots.splice(index, 1);
-        return snapshot;
-    }
-    /**
-     * What a save has to remember about one slot: its id, how many, and every field that can
-     * diverge between two items sharing that id.
-     *
-     * The split is the whole design question here. `stackable` and `weight` describe the *kind*
-     * of item and live in a game's own item table, so they are supplied fresh on load like
-     * every other definition in this framework, and a game that rebalances an item's weight
-     * sees the new value on an old save rather than the stale one baked into it. Everything
-     * else - an enchantment level, wear, a rolled affix, whether it has been identified, the
-     * `instanceId` keeping two otherwise-identical swords apart - belongs to the individual
-     * item and is exactly what would be lost if a save recorded only "3 x potion".
-     */
-    toJSON() {
-        return {
-            capacity: this.capacity,
-            slots: this.slots.map((item) => ({
-                id: item.id,
-                quantity: item.quantity,
-                instanceId: item.instanceId,
-                identified: item.identified,
-                cursed: item.cursed,
-                blessed: item.blessed,
-                level: item.level,
-                affix: item.affix,
-                durability: item.durability,
-                maxDurability: item.maxDurability,
-                contents: item.contents?.toJSON(),
-            })),
-        };
-    }
-    /**
-     * Rebuilds an inventory, taking each item's kind-level fields from `defs`.
-     *
-     * Throws on an id `defs` does not know, rather than restoring a weightless unstackable
-     * ghost of it: a save naming an item the game no longer has is a real problem, and finding
-     * out at load is far cheaper than finding out when a carry-weight check silently disagrees.
-     */
-    static fromJSON(defs, data) {
-        const inventory = new Inventory({ capacity: data.capacity });
-        inventory.slots = data.slots.map((saved) => {
-            const definition = defs.get(saved.id);
-            if (!definition)
-                throw new Error(`Inventory.fromJSON: no definition for item "${saved.id}"`);
-            const { contents, ...instance } = saved;
-            //the definition first, then the saved instance state over it, with absent optional
-            //fields dropped rather than written as undefined - spreading those would overwrite
-            //the definition's own weight or stackable flag with nothing
-            const item = {
-                ...definition,
-                ...stripUndefined(instance),
-                id: saved.id,
-                quantity: saved.quantity,
-            };
-            if (contents)
-                item.contents = Inventory.fromJSON(defs, contents);
-            return item;
-        });
-        return inventory;
-    }
-}
-/**
- * Drops keys whose value is `undefined`.
- *
- * `toJSON` writes every optional field, so a slot that never had a `level` round-trips as
- * `level: undefined`. Spreading that over a definition would overwrite the definition's own
- * value with `undefined` rather than leaving it alone, which is how a restored item would
- * quietly lose its weight.
- */
-function stripUndefined(value) {
-    return Object.fromEntries(Object.entries(value).filter(([, v]) => v !== undefined));
-}
-//# sourceMappingURL=Inventory.js.map

package/dist/actors/Inventory.js.map

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

package/dist/actors/ItemState.d.ts

@@ -1,43 +0,0 @@
-import type { InventoryItem } from './Inventory.ts';
-/**
- * The three item-shaped states `Inventory` only had fields for, not behaviour: identification,
- * an enchantment/upgrade level, and durability that wears down with use. Small, focused
- * functions over a plain `InventoryItem` - the same size of primitive `skillCheck` already is -
- * rather than a class, since none of the three need to remember anything beyond the item.
- *
- * @example
- * ```ts
- * import { identify, enchant, damageItem, repairItem } from '@datamoc/mw_games/actors';
- *
- * const sword = { id: 'sword', quantity: 1, durability: 30, maxDurability: 50 };
- *
- * identify(sword);
- * enchant(sword, 1); // now +1
- *
- * const broke = damageItem(sword, 40); // durability floors at 0
- * repairItem(sword, 10);
- * ```
- */
-/** reveals an item's real nature - a potion's true effect, a ring's curse - once identified */
-export declare function identify(item: InventoryItem): void;
-/** whether an upgrade leaves an item's affix as it is, or strips it */
-export type AffixUpgradePolicy = 'keep' | 'remove';
-/**
- * Raises (or, given a negative delta, lowers) an item's enchantment/upgrade level.
- *
- * @param affixPolicy `'keep'` (the default, and the only behaviour before this option
- * existed) leaves whatever affix the item carries untouched; `'remove'` strips it - some
- * upgrade paths only preserve an enchantment past a certain rarity tier, a game's own rule
- * this only ever applies when asked to
- */
-export declare function enchant(item: InventoryItem, delta: number, affixPolicy?: AffixUpgradePolicy): number;
-/**
- * Wears an item down by `amount`. An item with no `maxDurability` set cannot wear out at all
- * and this is a no-op - durability is opt-in per item, not a hidden default every item pays for.
- *
- * @returns true once the item's durability has reached zero and it should break
- */
-export declare function damageItem(item: InventoryItem, amount: number): boolean;
-/** restores durability, capped at `maxDurability`; a no-op for an item with none set */
-export declare function repairItem(item: InventoryItem, amount: number): void;
-//# sourceMappingURL=ItemState.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ItemState.d.ts","sourceRoot":"","sources":["../../src/actors/ItemState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,+FAA+F;AAC/F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAElD;AAED,uEAAuE;AACvE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAE,kBAA2B,GAAG,MAAM,CAK5G;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAMvE;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAIpE"}

package/dist/actors/ItemState.js

@@ -1,63 +0,0 @@
-import { removeAffix } from './Affix.js';
-/**
- * The three item-shaped states `Inventory` only had fields for, not behaviour: identification,
- * an enchantment/upgrade level, and durability that wears down with use. Small, focused
- * functions over a plain `InventoryItem` - the same size of primitive `skillCheck` already is -
- * rather than a class, since none of the three need to remember anything beyond the item.
- *
- * @example
- * ```ts
- * import { identify, enchant, damageItem, repairItem } from '@datamoc/mw_games/actors';
- *
- * const sword = { id: 'sword', quantity: 1, durability: 30, maxDurability: 50 };
- *
- * identify(sword);
- * enchant(sword, 1); // now +1
- *
- * const broke = damageItem(sword, 40); // durability floors at 0
- * repairItem(sword, 10);
- * ```
- */
-/** reveals an item's real nature - a potion's true effect, a ring's curse - once identified */
-export function identify(item) {
-    item.identified = true;
-}
-/**
- * Raises (or, given a negative delta, lowers) an item's enchantment/upgrade level.
- *
- * @param affixPolicy `'keep'` (the default, and the only behaviour before this option
- * existed) leaves whatever affix the item carries untouched; `'remove'` strips it - some
- * upgrade paths only preserve an enchantment past a certain rarity tier, a game's own rule
- * this only ever applies when asked to
- */
-export function enchant(item, delta, affixPolicy = 'keep') {
-    if (!Number.isFinite(delta))
-        return item.level ?? 0;
-    item.level = (item.level ?? 0) + delta;
-    if (affixPolicy === 'remove')
-        removeAffix(item);
-    return item.level;
-}
-/**
- * Wears an item down by `amount`. An item with no `maxDurability` set cannot wear out at all
- * and this is a no-op - durability is opt-in per item, not a hidden default every item pays for.
- *
- * @returns true once the item's durability has reached zero and it should break
- */
-export function damageItem(item, amount) {
-    if (item.maxDurability === undefined)
-        return false;
-    if (!Number.isFinite(amount) || amount <= 0)
-        return (item.durability ?? item.maxDurability) <= 0;
-    item.durability = Math.max(0, (item.durability ?? item.maxDurability) - amount);
-    return item.durability <= 0;
-}
-/** restores durability, capped at `maxDurability`; a no-op for an item with none set */
-export function repairItem(item, amount) {
-    if (item.maxDurability === undefined)
-        return;
-    if (!Number.isFinite(amount) || amount <= 0)
-        return;
-    item.durability = Math.min(item.maxDurability, (item.durability ?? item.maxDurability) + amount);
-}
-//# sourceMappingURL=ItemState.js.map

package/dist/actors/ItemState.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ItemState.js","sourceRoot":"","sources":["../../src/actors/ItemState.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CAAC,IAAmB;IAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;AACxB,CAAC;AAKD;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,IAAmB,EAAE,KAAa,EAAE,WAAW,GAAuB,MAAM;IACnG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;IACvC,IAAI,WAAW,KAAK,QAAQ;QAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,IAAmB,EAAE,MAAc;IAC7D,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAEjG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,CAAC;IAChF,OAAO,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,IAAmB,EAAE,MAAc;IAC7D,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;QAAE,OAAO;IAC7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO;IACpD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,CAAC;AAClG,CAAC"}

package/dist/actors/ItemStatusEffect.d.ts

@@ -1,40 +0,0 @@
-import { type EffectClock } from './StatusEffect.ts';
-export interface ItemStatusEffectOptions<T> {
-    /** fields applied to the item for the duration, restored to their prior value on expiry */
-    fields: Partial<T>;
-    /** turns until the fields are restored */
-    duration: number;
-    /** called once per turn the effect is active, such as a poison coating's own tick */
-    tick?: (turn: number) => void;
-}
-/** ends an `ItemStatusEffect` early, restoring the item's fields immediately rather than at expiry */
-export interface ItemStatusEffectHandle {
-    cancel(): void;
-}
-/**
- * A temporary status on an item itself - a weapon coated in poison for a fixed number of
- * turns, a shield reinforced until it wears off, a ring blessed only "for this floor" - the
- * item-targeted counterpart to `applyStatusEffect`, which only ever targets a `StatBlock`.
- * Today's item-level fields (`cursed`, `blessed`, `level`, `affix`) are all permanent until
- * a game explicitly changes them; this is what expires one instead.
- *
- * Applies `fields` onto `item`, remembering each field's prior value (not merely deleting
- * it), and restores exactly that value once `clock` expires the effect or `cancel()` is
- * called early - the same "never has to remember to remove what it added" guarantee
- * `applyStatusEffect` already gives a `StatBlock`.
- *
- * @example
- * ```ts
- * import { applyItemStatusEffect } from '@datamoc/mw_games/actors';
- * import { TurnClock } from '@datamoc/mw_games/world';
- *
- * const sword = { id: 'sword', quantity: 1, blessed: false };
- * const clock = new TurnClock();
- *
- * const blessing = applyItemStatusEffect(sword, clock, { fields: { blessed: true }, duration: 3 });
- * clock.advance(3); // blessed reverts to false automatically
- * blessing.cancel(); // or end it early
- * ```
- */
-export declare function applyItemStatusEffect<T extends object>(item: T, clock: EffectClock, options: ItemStatusEffectOptions<T>): ItemStatusEffectHandle;
-//# sourceMappingURL=ItemStatusEffect.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ItemStatusEffect.d.ts","sourceRoot":"","sources":["../../src/actors/ItemStatusEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAEjE,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACzC,2FAA2F;IAC3F,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEnB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IAEjB,qFAAqF;IACrF,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,sGAAsG;AACtG,MAAM,WAAW,sBAAsB;IACtC,MAAM,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EACrD,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GACjC,sBAAsB,CAYxB"}

package/dist/actors/ItemStatusEffect.js

@@ -1,39 +0,0 @@
-import { leaseClock } from './StatusEffect.js';
-/**
- * A temporary status on an item itself - a weapon coated in poison for a fixed number of
- * turns, a shield reinforced until it wears off, a ring blessed only "for this floor" - the
- * item-targeted counterpart to `applyStatusEffect`, which only ever targets a `StatBlock`.
- * Today's item-level fields (`cursed`, `blessed`, `level`, `affix`) are all permanent until
- * a game explicitly changes them; this is what expires one instead.
- *
- * Applies `fields` onto `item`, remembering each field's prior value (not merely deleting
- * it), and restores exactly that value once `clock` expires the effect or `cancel()` is
- * called early - the same "never has to remember to remove what it added" guarantee
- * `applyStatusEffect` already gives a `StatBlock`.
- *
- * @example
- * ```ts
- * import { applyItemStatusEffect } from '@datamoc/mw_games/actors';
- * import { TurnClock } from '@datamoc/mw_games/world';
- *
- * const sword = { id: 'sword', quantity: 1, blessed: false };
- * const clock = new TurnClock();
- *
- * const blessing = applyItemStatusEffect(sword, clock, { fields: { blessed: true }, duration: 3 });
- * clock.advance(3); // blessed reverts to false automatically
- * blessing.cancel(); // or end it early
- * ```
- */
-export function applyItemStatusEffect(item, clock, options) {
-    const previous = new Map();
-    for (const key of Object.keys(options.fields)) {
-        previous.set(key, item[key]);
-        item[key] = options.fields[key];
-    }
-    const restore = () => {
-        for (const [key, value] of previous)
-            item[key] = value;
-    };
-    return leaseClock(clock, { duration: options.duration, tick: options.tick, onExpire: restore });
-}
-//# sourceMappingURL=ItemStatusEffect.js.map

package/dist/actors/ItemStatusEffect.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ItemStatusEffect.js","sourceRoot":"","sources":["../../src/actors/ItemStatusEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAkBjE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,qBAAqB,CACpC,IAAO,EACP,KAAkB,EAClB,OAAmC;IAEnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAgB,EAAE,CAAC;QAC9D,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAe,CAAC;IAC/C,CAAC;IAED,MAAM,OAAO,GAAG,GAAS,EAAE;QAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACxD,CAAC,CAAC;IAEF,OAAO,UAAU,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;AACjG,CAAC"}

package/dist/actors/Loot.d.ts

@@ -1,38 +0,0 @@
-/**
- * A weighted drop table for what a monster leaves behind - the same shape as
- * `mwg/world`'s `EncounterTable`, deliberately: both are "roll whether anything happens at
- * all, then weight-pick which," just naming an item instead of an encounter value. A corpse
- * as a lootable world object needs no code of its own beyond this - it is an `Inventory`
- * placed at the monster's last position, exactly like any other dropped item already is.
- */
-export interface LootEntry {
-    id: string;
-    weight: number;
-    /** how many of `id` this entry grants; defaults to 1 */
-    quantity?: number;
-}
-export interface LootTable {
-    entries: readonly LootEntry[];
-    /** probability that this table drops anything at all, 0 to 1; defaults to 1 (always) */
-    chance?: number;
-}
-/**
- * @returns what dropped, or null when the roll misses or the table is empty
- *
- * @example
- * ```ts
- * import { rollLoot, type LootTable } from '@datamoc/mw_games/actors';
- *
- * const ratLoot: LootTable = {
- *   chance: 0.5,
- *   entries: [{ id: 'gold', weight: 3, quantity: 5 }, { id: 'cheese', weight: 1 }],
- * };
- *
- * const drop = rollLoot(ratLoot); // { id: 'gold', quantity: 5 }, or null, most of the time
- * ```
- */
-export declare function rollLoot(table: LootTable): {
-    id: string;
-    quantity: number;
-} | null;
-//# sourceMappingURL=Loot.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Loot.d.ts","sourceRoot":"","sources":["../../src/actors/Loot.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACzB,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IAE9B,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASlF"}

package/dist/actors/Loot.js

@@ -1,28 +0,0 @@
-import * as Random from '../core/Random.js';
-/**
- * @returns what dropped, or null when the roll misses or the table is empty
- *
- * @example
- * ```ts
- * import { rollLoot, type LootTable } from '@datamoc/mw_games/actors';
- *
- * const ratLoot: LootTable = {
- *   chance: 0.5,
- *   entries: [{ id: 'gold', weight: 3, quantity: 5 }, { id: 'cheese', weight: 1 }],
- * };
- *
- * const drop = rollLoot(ratLoot); // { id: 'gold', quantity: 5 }, or null, most of the time
- * ```
- */
-export function rollLoot(table) {
-    if (table.entries.length === 0)
-        return null;
-    if (!Random.chance(table.chance ?? 1))
-        return null;
-    const index = Random.weighted(table.entries.map((entry) => entry.weight));
-    if (index === null)
-        return null;
-    const entry = table.entries[index];
-    return { id: entry.id, quantity: entry.quantity ?? 1 };
-}
-//# sourceMappingURL=Loot.js.map

package/dist/actors/Loot.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Loot.js","sourceRoot":"","sources":["../../src/actors/Loot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAuB5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAgB;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnD,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,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;AACxD,CAAC"}

package/dist/actors/Progression.d.ts

@@ -1,52 +0,0 @@
-/**
- * Levels, experience, and the growth curve between them.
- *
- * The curve is a small interface rather than a formula, so it is entirely replaceable: a
- * game that wants Pokémon-style fast/medium/slow curves, or a flat curve with no cap, or one
- * read from a spreadsheet, supplies its own `GrowthCurve` and everything else here still
- * works unchanged.
- */
-export interface GrowthCurve {
-    /** total experience needed to *reach* this level; level 1 should be 0 */
-    experienceFor(level: number): number;
-    /** the highest level the curve defines; levelling stops here */
-    maxLevel: number;
-}
-/**
- * A curve reaching `maxLevel` at roughly `base * (level - 1) ^ power` total experience.
- *
- * @example
- * ```ts
- * import { powerCurve, Progression } from '@datamoc/mw_games/actors';
- *
- * const curve = powerCurve(100, 1.5, 50); // level 50 caps out around 100 * 49^1.5 experience
- * const progression = new Progression(curve);
- *
- * const levelsGained = progression.addExperience(250);
- * console.log(progression.level, progression.experienceToNext);
- * ```
- */
-export declare function powerCurve(base: number, power: number, maxLevel: number): GrowthCurve;
-export declare class Progression {
-    private curve;
-    level: number;
-    experience: number;
-    constructor(curve: GrowthCurve, start?: {
-        level?: number;
-        experience?: number;
-    });
-    /** experience still needed for the next level; null once the curve's cap is reached */
-    get experienceToNext(): number | null;
-    /** @returns how many levels were gained, 0 if none - a single large gain may span several */
-    addExperience(amount: number): number;
-    /** level and experience; the curve itself is a definition, supplied fresh on load */
-    toJSON(): {
-        level: number;
-        experience: number;
-    };
-    static fromJSON(curve: GrowthCurve, data: {
-        level: number;
-        experience: number;
-    }): Progression;
-}
-//# sourceMappingURL=Progression.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Progression.d.ts","sourceRoot":"","sources":["../../src/actors/Progression.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,WAAW;IAC3B,yEAAyE;IACzE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAErC,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAKrF;AAED,qBAAa,WAAW;IACvB,OAAO,CAAC,KAAK,CAAc;IAE3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IAEnB,YAAY,KAAK,EAAE,WAAW,EAAE,KAAK,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,EAIlF;IAED,uFAAuF;IACvF,IAAI,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAGpC;IAED,6FAA6F;IAC7F,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CASpC;IAED,qFAAqF;IACrF,MAAM,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAE9C;IAED,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW,CAE5F;CACD"}

package/dist/actors/Progression.js

@@ -1,59 +0,0 @@
-/**
- * Levels, experience, and the growth curve between them.
- *
- * The curve is a small interface rather than a formula, so it is entirely replaceable: a
- * game that wants Pokémon-style fast/medium/slow curves, or a flat curve with no cap, or one
- * read from a spreadsheet, supplies its own `GrowthCurve` and everything else here still
- * works unchanged.
- */
-/**
- * A curve reaching `maxLevel` at roughly `base * (level - 1) ^ power` total experience.
- *
- * @example
- * ```ts
- * import { powerCurve, Progression } from '@datamoc/mw_games/actors';
- *
- * const curve = powerCurve(100, 1.5, 50); // level 50 caps out around 100 * 49^1.5 experience
- * const progression = new Progression(curve);
- *
- * const levelsGained = progression.addExperience(250);
- * console.log(progression.level, progression.experienceToNext);
- * ```
- */
-export function powerCurve(base, power, maxLevel) {
-    return {
-        maxLevel,
-        experienceFor: (level) => (level <= 1 ? 0 : Math.round(base * Math.pow(level - 1, power))),
-    };
-}
-export class Progression {
-    constructor(curve, start = {}) {
-        this.curve = curve;
-        this.level = start.level ?? 1;
-        this.experience = start.experience ?? this.curve.experienceFor(this.level);
-    }
-    /** experience still needed for the next level; null once the curve's cap is reached */
-    get experienceToNext() {
-        if (this.level >= this.curve.maxLevel)
-            return null;
-        return this.curve.experienceFor(this.level + 1) - this.experience;
-    }
-    /** @returns how many levels were gained, 0 if none - a single large gain may span several */
-    addExperience(amount) {
-        this.experience += amount;
-        let gained = 0;
-        while (this.level < this.curve.maxLevel && this.experience >= this.curve.experienceFor(this.level + 1)) {
-            this.level++;
-            gained++;
-        }
-        return gained;
-    }
-    /** level and experience; the curve itself is a definition, supplied fresh on load */
-    toJSON() {
-        return { level: this.level, experience: this.experience };
-    }
-    static fromJSON(curve, data) {
-        return new Progression(curve, data);
-    }
-}
-//# sourceMappingURL=Progression.js.map

package/dist/actors/Progression.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Progression.js","sourceRoot":"","sources":["../../src/actors/Progression.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAa,EAAE,QAAgB;IACvE,OAAO;QACN,QAAQ;QACR,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;KAC1F,CAAC;AACH,CAAC;AAED,MAAM,OAAO,WAAW;IAMvB,YAAY,KAAkB,EAAE,KAAK,GAA4C,EAAE;QAClF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5E,CAAC;IAED,uFAAuF;IACvF,IAAI,gBAAgB;QACnB,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;IACnE,CAAC;IAED,6FAA6F;IAC7F,aAAa,CAAC,MAAc;QAC3B,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC;QAE1B,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,OAAO,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;YACxG,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,MAAM,EAAE,CAAC;QACV,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;IAED,qFAAqF;IACrF,MAAM;QACL,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,KAAkB,EAAE,IAA2C;QAC9E,OAAO,IAAI,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;CACD"}

package/dist/actors/Resource.d.ts

@@ -1,53 +0,0 @@
-import type { StatBlock } from './StatBlock.ts';
-import type { Charges } from './Charges.ts';
-/**
- * One spendable cost: `amount` of the `stat` pool, the way a spell costs mana.
- *
- * Costs operate on the stat's *base* value - the stored pool - not its modified
- * total: a buff that raises maximum mana changes the ceiling, not what is left
- * to spend. Restoring the pool is just `stats.setBase`; only spending needed a
- * primitive of its own.
- *
- * @example
- * ```ts
- * import { canAfford, spend, refund, convertToCharges, StatBlock, Charges } from '@datamoc/mw_games/actors';
- *
- * const stats = new StatBlock({ base: { mana: 30 } });
- * const cost = { stat: 'mana', amount: 10 };
- *
- * if (canAfford(stats, cost)) spend(stats, cost);
- * refund(stats, cost, 0.5); // half the cost back, e.g. on a missed cast
- *
- * const battery = new Charges({ max: 5, regenRate: 10 });
- * convertToCharges(stats, { stat: 'mana', amount: 20 }, battery, 5); // 20 mana -> 4 charges
- * ```
- */
-export interface ResourceCost {
-    stat: string;
-    amount: number;
-}
-/** True when every cost in `cost` is currently affordable, without spending anything. */
-export declare function canAfford(stats: StatBlock, cost: ResourceCost | readonly ResourceCost[]): boolean;
-/**
- * Spends every cost in `cost` at once, the way `craft` resolves a recipe.
- *
- * All or nothing: when any one cost is unaffordable nothing is deducted and
- * this returns false. A zero cost is always affordable and deducts nothing.
- */
-export declare function spend(stats: StatBlock, cost: ResourceCost | readonly ResourceCost[]): boolean;
-/**
- * Refunds a previously spent cost - a missed cast, an ability that returns part of its own
- * cost on a kill - the mirror of `spend`, without `spend`'s all-or-nothing check since there
- * is nothing to check on the way back in. `fraction` scales every cost in `cost` at once
- * (`0.5` for "half back").
- */
-export declare function refund(stats: StatBlock, cost: ResourceCost | readonly ResourceCost[], fraction?: number): void;
-/**
- * Spends `cost` from a `StatBlock` pool and converts it into charges of a different resource
- * at `rate` per charge - "channel mana into a battery" - all-or-nothing the same way `spend`
- * itself is: nothing is spent, and no charge is gained, unless the full cost is affordable.
- *
- * @returns the charges actually gained, capped by `charges`' own `max` (0 when the spend failed)
- */
-export declare function convertToCharges(stats: StatBlock, cost: ResourceCost, charges: Charges, rate: number): number;
-//# sourceMappingURL=Resource.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Resource.d.ts","sourceRoot":"","sources":["../../src/actors/Resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf;AAoBD,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,OAAO,CAEjG;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,OAAO,CAI7F;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,EAAE,QAAQ,SAAI,GAAG,IAAI,CAEzG;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7G"}