@datamoc/mw_games 0.44.2 → 0.46.0

package/dist/actors/Resource.js

@@ -1,57 +0,0 @@
-function all(cost) {
-    const list = Array.isArray(cost) ? cost : [cost];
-    for (const c of list) {
-        if (!Number.isFinite(c.amount) || c.amount < 0) {
-            throw new Error(`a resource cost must be a non-negative number, "${c.stat}" costs ${c.amount}`);
-        }
-    }
-    return list;
-}
-//several costs on the same stat (two effects both drawing mana, say) must be checked
-//against their combined total, not each independently against the same starting pool
-function totals(cost) {
-    const out = new Map();
-    for (const c of cost)
-        out.set(c.stat, (out.get(c.stat) ?? 0) + c.amount);
-    return out;
-}
-/** True when every cost in `cost` is currently affordable, without spending anything. */
-export function canAfford(stats, cost) {
-    return [...totals(all(cost))].every(([stat, amount]) => stats.base(stat) >= amount);
-}
-/**
- * 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 function spend(stats, cost) {
-    if (!canAfford(stats, cost))
-        return false;
-    for (const [stat, amount] of totals(all(cost)))
-        stats.setBase(stat, stats.base(stat) - amount);
-    return true;
-}
-/**
- * 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 function refund(stats, cost, fraction = 1) {
-    for (const [stat, amount] of totals(all(cost)))
-        stats.setBase(stat, stats.base(stat) + amount * fraction);
-}
-/**
- * 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 function convertToCharges(stats, cost, charges, rate) {
-    if (!spend(stats, cost))
-        return 0;
-    return charges.refund(Math.floor(cost.amount / rate));
-}
-//# sourceMappingURL=Resource.js.map

package/dist/actors/Resource.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Resource.js","sourceRoot":"","sources":["../../src/actors/Resource.ts"],"names":[],"mappings":"AA8BA,SAAS,GAAG,CAAC,IAA4C;IACxD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACjG,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,qFAAqF;AACrF,qFAAqF;AACrF,SAAS,MAAM,CAAC,IAA6B;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,IAA4C;IACvF,OAAO,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC;AACrF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,KAAgB,EAAE,IAA4C;IACnF,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IAC/F,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,KAAgB,EAAE,IAA4C,EAAE,QAAQ,GAAG,CAAC;IAClG,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;AAC3G,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgB,EAAE,IAAkB,EAAE,OAAgB,EAAE,IAAY;IACpG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/actors/Scaling.d.ts

@@ -1,30 +0,0 @@
-import type { Modifier, ModifierOp } from './StatBlock.ts';
-/**
- * Level-scaled item modifiers: the shape passive gear whose bonus grows with its own
- * upgrade level shares, without any one game's scaling curve.
- *
- * A ring that grants +1 evasion per level and a weapon that hastes 5% per level are the
- * same thing here: each entry names a stat, an op, a value at level 0, and a per-level
- * increment, resolved to plain `Modifier`s for a given level. `mwg` picks no curve
- * beyond linear - anything fancier (diminishing returns, breakpoints) is a game's own
- * `from` function on a derived stat, not a framework formula.
- *
- * @example
- * ```ts
- * import { scaledModifiers, type LevelScale } from '@datamoc/mw_games/actors';
- *
- * const ringScales: LevelScale[] = [{ stat: 'evasion', op: 'add', base: 1, perLevel: 1 }];
- * const modifiers = scaledModifiers(3, ringScales); // [{ stat: 'evasion', op: 'add', value: 4 }]
- * ```
- */
-export interface LevelScale {
-    stat: string;
-    op: ModifierOp;
-    /** the modifier value at level 0 */
-    base: number;
-    /** added once per level above 0 */
-    perLevel: number;
-}
-/** resolves every scale entry at `level`: value = base + perLevel * level */
-export declare function scaledModifiers(level: number, scales: readonly LevelScale[]): Modifier[];
-//# sourceMappingURL=Scaling.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Scaling.d.ts","sourceRoot":"","sources":["../../src/actors/Scaling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,UAAU,CAAC;IAEf,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,QAAQ,EAAE,CAMxF"}

package/dist/actors/Scaling.js

@@ -1,9 +0,0 @@
-/** resolves every scale entry at `level`: value = base + perLevel * level */
-export function scaledModifiers(level, scales) {
-    return scales.map((scale) => ({
-        stat: scale.stat,
-        op: scale.op,
-        value: scale.base + scale.perLevel * level,
-    }));
-}
-//# sourceMappingURL=Scaling.js.map

package/dist/actors/Scaling.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Scaling.js","sourceRoot":"","sources":["../../src/actors/Scaling.ts"],"names":[],"mappings":"AAgCA,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,MAA6B;IAC3E,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,QAAQ,GAAG,KAAK;KAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/actors/Shop.d.ts

@@ -1,40 +0,0 @@
-import type { StatBlock } from './StatBlock.ts';
-import type { Inventory } from './Inventory.ts';
-/**
- * A buy/sell transaction between two `Inventory`s, paid for from a `StatBlock` stat acting as
- * currency - the same role `craft()` fills for a recipe: check everything first, touch
- * nothing until every check passes, and if any later step fails (the buyer's bag has no
- * room), roll back whatever the earlier steps already did rather than losing stock or coin
- * for nothing.
- *
- * @example
- * ```ts
- * import { buy, sell, StatBlock, Inventory, type ShopOptions } from '@datamoc/mw_games/actors';
- *
- * const wallet = new StatBlock({ base: { gold: 100 } });
- * const shopStock = new Inventory();
- * shopStock.add({ id: 'potion', quantity: 10, stackable: true });
- * const bag = new Inventory();
- *
- * const options: ShopOptions = { currency: 'gold', prices: new Map([['potion', { buy: 15, sell: 5 }]]) };
- *
- * buy(wallet, shopStock, bag, 'potion', 2, options); // 30 gold spent, 2 potions in bag
- * sell(wallet, shopStock, bag, 'potion', 1, options); // 5 gold refunded
- * ```
- */
-export interface Price {
-    /** cost to buy one unit from the shop */
-    buy: number;
-    /** amount refunded per unit sold to the shop */
-    sell: number;
-}
-export interface ShopOptions {
-    /** the `StatBlock` stat name holding the spendable currency */
-    currency: string;
-    prices: ReadonlyMap<string, Price>;
-}
-/** @returns false, touching nothing, if the price is unknown, stock is short, or coin is short */
-export declare function buy(wallet: StatBlock, stock: Inventory, bag: Inventory, id: string, quantity: number, options: ShopOptions): boolean;
-/** @returns false, touching nothing, if the price is unknown or the seller lacks the quantity */
-export declare function sell(wallet: StatBlock, stock: Inventory, bag: Inventory, id: string, quantity: number, options: ShopOptions): boolean;
-//# sourceMappingURL=Shop.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Shop.d.ts","sourceRoot":"","sources":["../../src/actors/Shop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,KAAK;IACrB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC3B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CACnC;AAED,kGAAkG;AAClG,wBAAgB,GAAG,CAClB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GAClB,OAAO,CAkBT;AAED,iGAAiG;AACjG,wBAAgB,IAAI,CACnB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GAClB,OAAO,CAcT"}

package/dist/actors/Shop.js

@@ -1,36 +0,0 @@
-/** @returns false, touching nothing, if the price is unknown, stock is short, or coin is short */
-export function buy(wallet, stock, bag, id, quantity, options) {
-    const price = options.prices.get(id);
-    if (!price)
-        return false;
-    const forSale = stock.find(id);
-    if (!forSale || forSale.quantity < quantity)
-        return false;
-    const cost = price.buy * quantity;
-    if (wallet.base(options.currency) < cost)
-        return false;
-    stock.remove(id, quantity);
-    if (!bag.add({ ...forSale, quantity })) {
-        stock.add({ ...forSale, quantity }); //the buyer's bag had no room - put the stock back
-        return false;
-    }
-    wallet.setBase(options.currency, wallet.base(options.currency) - cost);
-    return true;
-}
-/** @returns false, touching nothing, if the price is unknown or the seller lacks the quantity */
-export function sell(wallet, stock, bag, id, quantity, options) {
-    const price = options.prices.get(id);
-    if (!price)
-        return false;
-    const item = bag.find(id);
-    if (!item || item.quantity < quantity)
-        return false;
-    bag.remove(id, quantity);
-    if (!stock.add({ ...item, quantity })) {
-        bag.add({ ...item, quantity }); //the shop's stock had no room - put the item back
-        return false;
-    }
-    wallet.setBase(options.currency, wallet.base(options.currency) + price.sell * quantity);
-    return true;
-}
-//# sourceMappingURL=Shop.js.map

package/dist/actors/Shop.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Shop.js","sourceRoot":"","sources":["../../src/actors/Shop.ts"],"names":[],"mappings":"AAsCA,kGAAkG;AAClG,MAAM,UAAU,GAAG,CAClB,MAAiB,EACjB,KAAgB,EAChB,GAAc,EACd,EAAU,EACV,QAAgB,EAChB,OAAoB;IAEpB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,GAAG,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE1D,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG,QAAQ,CAAC;IAClC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI;QAAE,OAAO,KAAK,CAAC;IAEvD,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,kDAAkD;QACvF,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC;AACb,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,IAAI,CACnB,MAAiB,EACjB,KAAgB,EAChB,GAAc,EACd,EAAU,EACV,QAAgB,EAChB,OAAoB;IAEpB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,GAAG,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEpD,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACzB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,kDAAkD;QAClF,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC;IACxF,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/actors/SkillPoints.d.ts

@@ -1,72 +0,0 @@
-import type { StatBlock } from './StatBlock.ts';
-export interface SkillPointsOptions {
-    /** the highest rank a stat can be raised to via `spend`; uncapped if omitted */
-    cap?: (stat: string) => number;
-    /** points one more rank of `stat` costs, given the rank being bought (1 for the first
-     * point spent into it, 2 for the second, and so on); a flat 1 per rank if omitted */
-    cost?: (stat: string, rank: number) => number;
-}
-/**
- * The seam `StatBlock` and `Progression` never had: a levelling curve already tells a game
- * how many levels it just gained, and a stat block already holds any named stat a game
- * invents - `lockpicking` exactly as well as `strength` - but nothing turns "gained a level"
- * into "has a point to spend", or spends one with the usual rules a skill spend wants (a
- * cap, a cost that rises the more of a stat is already bought).
- *
- * Deliberately not a wrapper around `Progression` itself: a game grants points from
- * levelling (`grant(levelsGained)` after `Progression.addExperience` returns a positive
- * number), from a quest reward, from a trainer NPC, or all three - this only tracks the
- * ledger and the spend rule, the same way `skillCheck` is a dice roll and nothing about who
- * is rolling it.
- *
- * @example
- * ```ts
- * import { SkillPoints, StatBlock } from '@datamoc/mw_games/actors';
- *
- * const stats = new StatBlock({ base: { lockpicking: 0 } });
- * const points = new SkillPoints(stats, { cap: () => 10, cost: (_stat, rank) => rank });
- *
- * points.grant(3); // e.g. after Progression.addExperience returned levelsGained
- * if (points.canSpend('lockpicking')) points.spend('lockpicking');
- *
- * console.log(stats.base('lockpicking'), points.points);
- * ```
- */
-export declare class SkillPoints {
-    private stats;
-    private capFor;
-    private costFor;
-    private available;
-    constructor(stats: StatBlock, options?: SkillPointsOptions);
-    /** points not yet spent */
-    get points(): number;
-    /** adds points to the ledger - typically levels gained times however many a level grants */
-    grant(points: number): void;
-    /** whether `stat` could be raised one more rank right now - affordable, and under its cap */
-    canSpend(stat: string): boolean;
-    /**
-     * Raises `stat`'s base value by one rank, spending whatever that rank costs.
-     *
-     * @returns false, spending nothing, if the rank is capped or not affordable
-     */
-    spend(stat: string): boolean;
-    /** the cost of `stat`'s next rank, or `null` if it is capped or unaffordable - computes
-     * the cost callback exactly once, so `canSpend` and `spend` never call it twice between
-     * them for the same decision */
-    private nextRankCost;
-    /**
-     * The unspent ledger, and only that.
-     *
-     * Spent points are already saved: `spend` raises a stat's *base* value on the `StatBlock`,
-     * so restoring that block restores every rank ever bought. Recording them a second time
-     * here would be state kept in two places, which is exactly the kind of pair that drifts
-     * the first time one path forgets to update the other.
-     */
-    toJSON(): {
-        points: number;
-    };
-    static fromJSON(stats: StatBlock, options: SkillPointsOptions, data: {
-        points: number;
-    }): SkillPoints;
-}
-//# sourceMappingURL=SkillPoints.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"SkillPoints.d.ts","sourceRoot":"","sources":["../../src/actors/SkillPoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IAClC,gFAAgF;IAChF,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAE/B;yFACqF;IACrF,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAAyC;IAExD,OAAO,CAAC,SAAS,CAAK;IAEtB,YAAY,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,kBAAuB,EAI7D;IAED,2BAA2B;IAC3B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,4FAA4F;IAC5F,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE1B;IAED,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9B;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ3B;IAED;;oCAEgC;IAChC,OAAO,CAAC,YAAY;IAQpB;;;;;;;OAOG;IACH,MAAM,IAAI;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAE3B;IAED,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW,CAIpG;CACD"}

package/dist/actors/SkillPoints.js

@@ -1,87 +0,0 @@
-/**
- * The seam `StatBlock` and `Progression` never had: a levelling curve already tells a game
- * how many levels it just gained, and a stat block already holds any named stat a game
- * invents - `lockpicking` exactly as well as `strength` - but nothing turns "gained a level"
- * into "has a point to spend", or spends one with the usual rules a skill spend wants (a
- * cap, a cost that rises the more of a stat is already bought).
- *
- * Deliberately not a wrapper around `Progression` itself: a game grants points from
- * levelling (`grant(levelsGained)` after `Progression.addExperience` returns a positive
- * number), from a quest reward, from a trainer NPC, or all three - this only tracks the
- * ledger and the spend rule, the same way `skillCheck` is a dice roll and nothing about who
- * is rolling it.
- *
- * @example
- * ```ts
- * import { SkillPoints, StatBlock } from '@datamoc/mw_games/actors';
- *
- * const stats = new StatBlock({ base: { lockpicking: 0 } });
- * const points = new SkillPoints(stats, { cap: () => 10, cost: (_stat, rank) => rank });
- *
- * points.grant(3); // e.g. after Progression.addExperience returned levelsGained
- * if (points.canSpend('lockpicking')) points.spend('lockpicking');
- *
- * console.log(stats.base('lockpicking'), points.points);
- * ```
- */
-export class SkillPoints {
-    constructor(stats, options = {}) {
-        this.available = 0;
-        this.stats = stats;
-        this.capFor = options.cap ?? (() => Infinity);
-        this.costFor = options.cost ?? (() => 1);
-    }
-    /** points not yet spent */
-    get points() {
-        return this.available;
-    }
-    /** adds points to the ledger - typically levels gained times however many a level grants */
-    grant(points) {
-        this.available += points;
-    }
-    /** whether `stat` could be raised one more rank right now - affordable, and under its cap */
-    canSpend(stat) {
-        return this.nextRankCost(stat) !== null;
-    }
-    /**
-     * Raises `stat`'s base value by one rank, spending whatever that rank costs.
-     *
-     * @returns false, spending nothing, if the rank is capped or not affordable
-     */
-    spend(stat) {
-        const cost = this.nextRankCost(stat);
-        if (cost === null)
-            return false;
-        const rank = this.stats.base(stat);
-        this.available -= cost;
-        this.stats.setBase(stat, rank + 1);
-        return true;
-    }
-    /** the cost of `stat`'s next rank, or `null` if it is capped or unaffordable - computes
-     * the cost callback exactly once, so `canSpend` and `spend` never call it twice between
-     * them for the same decision */
-    nextRankCost(stat) {
-        const rank = this.stats.base(stat);
-        if (rank >= this.capFor(stat))
-            return null;
-        const cost = this.costFor(stat, rank + 1);
-        return this.available >= cost ? cost : null;
-    }
-    /**
-     * The unspent ledger, and only that.
-     *
-     * Spent points are already saved: `spend` raises a stat's *base* value on the `StatBlock`,
-     * so restoring that block restores every rank ever bought. Recording them a second time
-     * here would be state kept in two places, which is exactly the kind of pair that drifts
-     * the first time one path forgets to update the other.
-     */
-    toJSON() {
-        return { points: this.available };
-    }
-    static fromJSON(stats, options, data) {
-        const ledger = new SkillPoints(stats, options);
-        ledger.available = data.points;
-        return ledger;
-    }
-}
-//# sourceMappingURL=SkillPoints.js.map

package/dist/actors/SkillPoints.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SkillPoints.js","sourceRoot":"","sources":["../../src/actors/SkillPoints.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,WAAW;IAOvB,YAAY,KAAgB,EAAE,OAAO,GAAuB,EAAE;QAFtD,cAAS,GAAG,CAAC,CAAC;QAGrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,2BAA2B;IAC3B,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,4FAA4F;IAC5F,KAAK,CAAC,MAAc;QACnB,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;IAC1B,CAAC;IAED,6FAA6F;IAC7F,QAAQ,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAY;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAEhC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;oCAEgC;IACxB,YAAY,CAAC,IAAY;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAE3C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IAED;;;;;;;OAOG;IACH,MAAM;QACL,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,KAAgB,EAAE,OAA2B,EAAE,IAAwB;QACtF,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/B,OAAO,MAAM,CAAC;IACf,CAAC;CACD"}

package/dist/actors/StatBlock.d.ts

@@ -1,86 +0,0 @@
-/**
- * A character's numbers: base attributes, values derived from them, and the modifiers -
- * equipment, buffs, states - that push either around.
- *
- * This is deliberately the *shape*, not a formula. A game names its own base attributes
- * (`strength`, `sanity`, whatever it needs) and its own derived ones (`maxHp` from
- * `vitality`, say); mwg supplies the machinery that combines a base value with however many
- * modifiers are active, in a stated order, and keeps it correct as either side changes.
- */
-export type Stats = Record<string, number>;
-/** how a modifier combines with a stat's running value */
-export type ModifierOp = 'add' | 'multiply' | 'set';
-export interface Modifier {
-    stat: string;
-    op: ModifierOp;
-    value: number;
-    /**
-     * Modifiers apply in ascending order within their own op (see `resolve`). Equal order
-     * preserves the order they were added in.
-     */
-    order?: number;
-    /** whatever granted this modifier - an equipped item, an active buff - for bulk removal */
-    source?: unknown;
-}
-export interface DerivedStat {
-    name: string;
-    /** reads every base attribute and any derived stat already resolved earlier in the list */
-    from: (stats: Readonly<Stats>) => number;
-}
-export interface StatBlockOptions {
-    base: Stats;
-    derived?: DerivedStat[];
-}
-/**
- * Resolves one stat's modifiers into a single number, in the framework's
- * canonical add, multiply, then set composition.
- *
- * Every `add` modifier applies first (summed together), then every `multiply` (each
- * scaling the running total), then every `set` (the last one wins) - a stated, fixed order,
- * so a +10% ring and a cursed -2 sword combine the same way regardless of equip order, and
- * a `set` modifier (a polymorph, a stat drained to exactly zero) always wins over the rest.
- *
- * @example
- * ```ts
- * import { composeModifiers } from '@datamoc/mw_games/actors';
- *
- * const attack = composeModifiers(10, [{ stat: 'attack', op: 'add', value: 2 }]);
- * console.log(attack); // 12
- * ```
- */
-export declare function composeModifiers(base: number, modifiers: readonly Modifier[]): number;
-export declare class StatBlock {
-    private baseValues;
-    private derived;
-    private modifiers;
-    private cache;
-    constructor(options: StatBlockOptions);
-    /** the unmodified base value; 0 for a name that was never given one */
-    base(name: string): number;
-    setBase(name: string, value: number): void;
-    addModifier(modifier: Modifier): void;
-    removeModifier(modifier: Modifier): void;
-    /** removes every modifier carrying this `source`, such as an item just unequipped */
-    removeModifiersFrom(source: unknown): void;
-    /** the final value: a base attribute or a derived stat, with every modifier resolved */
-    get(name: string): number;
-    private resolveAll;
-    private modifiersFor;
-    /**
-     * Base attribute values, and deliberately nothing else.
-     *
-     * Modifiers are not saved, because every one of them is owned by whatever applied it: a
-     * worn item through `EquipmentSlots`, a timed effect through `applyStatusEffect`, an
-     * adjacency bonus through `AuraField`. Each of those reapplies its own on load, tagged
-     * with its own `source`, so saving them here as well would double every bonus the instant
-     * a restored character re-equipped what it was already wearing. Derived stats are
-     * definitions, supplied fresh on load like every other definition in this framework.
-     */
-    toJSON(): {
-        base: Stats;
-    };
-    static fromJSON(options: StatBlockOptions, data: {
-        base: Stats;
-    }): StatBlock;
-}
-//# sourceMappingURL=StatBlock.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"StatBlock.d.ts","sourceRoot":"","sources":["../../src/actors/StatBlock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,UAAU,GAAG,KAAK,CAAC;AAEpD,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,2FAA2F;IAC3F,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,2FAA2F;IAC3F,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CASrF;AAED,qBAAa,SAAS;IACrB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,KAAK,CAAsB;IAEnC,YAAY,OAAO,EAAE,gBAAgB,EAGpC;IAED,uEAAuE;IACvE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzB;IAED,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGzC;IAED,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAGpC;IAED,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAIvC;IAED,qFAAqF;IACrF,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAGzC;IAED,wFAAwF;IACxF,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExB;IAED,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,YAAY;IAIpB;;;;;;;;;OASG;IACH,MAAM,IAAI;QAAE,IAAI,EAAE,KAAK,CAAA;KAAE,CAExB;IAED,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,KAAK,CAAA;KAAE,GAAG,SAAS,CAO3E;CACD"}

package/dist/actors/StatBlock.js

@@ -1,110 +0,0 @@
-/**
- * A character's numbers: base attributes, values derived from them, and the modifiers -
- * equipment, buffs, states - that push either around.
- *
- * This is deliberately the *shape*, not a formula. A game names its own base attributes
- * (`strength`, `sanity`, whatever it needs) and its own derived ones (`maxHp` from
- * `vitality`, say); mwg supplies the machinery that combines a base value with however many
- * modifiers are active, in a stated order, and keeps it correct as either side changes.
- */
-/**
- * Resolves one stat's modifiers into a single number, in the framework's
- * canonical add, multiply, then set composition.
- *
- * Every `add` modifier applies first (summed together), then every `multiply` (each
- * scaling the running total), then every `set` (the last one wins) - a stated, fixed order,
- * so a +10% ring and a cursed -2 sword combine the same way regardless of equip order, and
- * a `set` modifier (a polymorph, a stat drained to exactly zero) always wins over the rest.
- *
- * @example
- * ```ts
- * import { composeModifiers } from '@datamoc/mw_games/actors';
- *
- * const attack = composeModifiers(10, [{ stat: 'attack', op: 'add', value: 2 }]);
- * console.log(attack); // 12
- * ```
- */
-export function composeModifiers(base, modifiers) {
-    const byOp = (op) => modifiers.filter((m) => m.op === op).sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
-    let value = base;
-    for (const m of byOp('add'))
-        value += m.value;
-    for (const m of byOp('multiply'))
-        value *= m.value;
-    for (const m of byOp('set'))
-        value = m.value;
-    return value;
-}
-export class StatBlock {
-    constructor(options) {
-        this.modifiers = [];
-        this.cache = null;
-        this.baseValues = { ...options.base };
-        this.derived = options.derived ?? [];
-    }
-    /** the unmodified base value; 0 for a name that was never given one */
-    base(name) {
-        return this.baseValues[name] ?? 0;
-    }
-    setBase(name, value) {
-        this.baseValues[name] = value;
-        this.cache = null;
-    }
-    addModifier(modifier) {
-        this.modifiers.push(modifier);
-        this.cache = null;
-    }
-    removeModifier(modifier) {
-        const i = this.modifiers.indexOf(modifier);
-        if (i !== -1)
-            this.modifiers.splice(i, 1);
-        this.cache = null;
-    }
-    /** removes every modifier carrying this `source`, such as an item just unequipped */
-    removeModifiersFrom(source) {
-        this.modifiers = this.modifiers.filter((m) => m.source !== source);
-        this.cache = null;
-    }
-    /** the final value: a base attribute or a derived stat, with every modifier resolved */
-    get(name) {
-        return this.resolveAll()[name] ?? 0;
-    }
-    resolveAll() {
-        if (this.cache)
-            return this.cache;
-        const result = { ...this.baseValues };
-        for (const name of Object.keys(result)) {
-            result[name] = composeModifiers(result[name], this.modifiersFor(name));
-        }
-        for (const d of this.derived) {
-            result[d.name] = composeModifiers(d.from(result), this.modifiersFor(d.name));
-        }
-        this.cache = result;
-        return result;
-    }
-    modifiersFor(stat) {
-        return this.modifiers.filter((m) => m.stat === stat);
-    }
-    /**
-     * Base attribute values, and deliberately nothing else.
-     *
-     * Modifiers are not saved, because every one of them is owned by whatever applied it: a
-     * worn item through `EquipmentSlots`, a timed effect through `applyStatusEffect`, an
-     * adjacency bonus through `AuraField`. Each of those reapplies its own on load, tagged
-     * with its own `source`, so saving them here as well would double every bonus the instant
-     * a restored character re-equipped what it was already wearing. Derived stats are
-     * definitions, supplied fresh on load like every other definition in this framework.
-     */
-    toJSON() {
-        return { base: { ...this.baseValues } };
-    }
-    static fromJSON(options, data) {
-        const stats = new StatBlock(options);
-        //the saved values win, but a stat added to the game since the save was written keeps
-        //the definition's starting value rather than vanishing
-        stats.baseValues = { ...options.base, ...data.base };
-        stats.cache = null;
-        return stats;
-    }
-}
-//# sourceMappingURL=StatBlock.js.map

package/dist/actors/StatBlock.js.map

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

package/dist/actors/StatusEffect.d.ts

@@ -1,67 +0,0 @@
-import { StatBlock, type Modifier } from './StatBlock.ts';
-/**
- * The shape `TurnClock.add` needs - declared here rather than imported from `mwg/world`, so
- * `mwg/actors` stays independent of it the same way every other pair of sibling modules is;
- * `TurnClock` already satisfies this structurally, with nothing to wire up on its side.
- */
-export interface EffectClock {
-    add(effect: {
-        tick: (turn: number) => void;
-        duration?: number;
-        onExpire?: () => void;
-    }): symbol;
-    remove(id: symbol): void;
-}
-export interface StatusEffectOptions {
-    /** applied for the duration, then removed automatically - `source` is filled in, not given */
-    modifiers: readonly Omit<Modifier, 'source'>[];
-    /** turns until the modifiers are removed */
-    duration: number;
-    /** called once per turn the effect is active, such as a poison tick's own damage */
-    tick?: (turn: number) => void;
-}
-/** ends a `StatusEffect` early, removing its modifiers immediately rather than at expiry */
-export interface StatusEffectHandle {
-    cancel(): void;
-}
-/**
- * The half both `applyStatusEffect` and `applyItemStatusEffect` share: register `onExpire`
- * with `clock` for `duration` turns, and hand back a `cancel()` that unregisters early and
- * still runs `onExpire` once. Lives here rather than in a third file because this module
- * already owns `EffectClock`, the only type it needs.
- */
-export declare function leaseClock(clock: EffectClock, options: {
-    duration: number;
-    tick?: (turn: number) => void;
-    onExpire: () => void;
-}): StatusEffectHandle;
-/**
- * A temporary buff or debuff: applies `modifiers` to `stats` and registers their expiry with
- * `clock`, so a game never has to remember to remove what it added. The seam `TurnClock` and
- * `StatBlock` never had on their own - `TurnClock` ticks and expires effects, `StatBlock`
- * resolves modifiers, but nothing tied one's expiry to the other's removal.
- *
- * `cancel()` on the returned handle removes the modifiers immediately and unregisters the
- * clock entry - needed because `TurnClock.remove` alone only stops future ticks, it does not
- * know this entry ever touched a `StatBlock` at all.
- *
- * @example
- * ```ts
- * import { applyStatusEffect, StatBlock } from '@datamoc/mw_games/actors';
- * import { TurnClock } from '@datamoc/mw_games/world';
- *
- * const stats = new StatBlock({ base: { hp: 20, attack: 5 } });
- * const clock = new TurnClock();
- *
- * const poison = applyStatusEffect(stats, clock, {
- *   modifiers: [{ stat: 'attack', op: 'add', value: -2 }],
- *   duration: 3,
- *   tick: () => stats.setBase('hp', stats.base('hp') - 2),
- * });
- *
- * clock.advance(); // one poison tick
- * poison.cancel(); // a cure spell removes it early
- * ```
- */
-export declare function applyStatusEffect(stats: StatBlock, clock: EffectClock, options: StatusEffectOptions): StatusEffectHandle;
-//# sourceMappingURL=StatusEffect.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"StatusEffect.d.ts","sourceRoot":"","sources":["../../src/actors/StatusEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,MAAM,CAAC;IAChG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IACnC,8FAA8F;IAC9F,SAAS,EAAE,SAAS,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;IAE/C,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IAEjB,oFAAoF;IACpF,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,4FAA4F;AAC5F,MAAM,WAAW,kBAAkB;IAClC,MAAM,IAAI,IAAI,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;CAAE,GAChF,kBAAkB,CAapB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,mBAAmB,GAC1B,kBAAkB,CASpB"}