@datamoc/mw_games 0.5.0 → 0.5.2

package/dist/actors/EntityTemplate.d.ts

@@ -0,0 +1,127 @@
+import { StatBlock, type Stats } from './StatBlock.ts';
+import { Progression, type GrowthCurve } from './Progression.ts';
+import { type AffixDef } from './Affix.ts';
+import type { InventoryItem } from './Inventory.ts';
+import { ReactionTable } from '../core/Reactions.ts';
+/**
+ * One row of a hero or monster "file" - a `core.parseCSV` result, typically - turned into a
+ * fully wired entity: a `StatBlock` of base stats, an optional `Progression` against a named
+ * growth curve, an optional starting item carrying a named starting affix, and a
+ * `ReactionTable` already holding a low-HP rule if the row names one. The single call a game
+ * makes once per row, in place of the per-field glue code every one of those systems would
+ * otherwise need written out by hand.
+ *
+ * A handful of column names are reserved (`id`, `growth`, `level`, `startingAffix`,
+ * `startingItem`, `lowHpReaction`); every other column in the row becomes a base stat, so a
+ * game's own stat names (`attack`, `speed`, `armor`, whatever it calls them) need no
+ * declaring here. What each named growth curve, affix, and item actually *is* stays the
+ * game's own `EntityTemplateCatalog` - `mwg` resolves the reference, never invents the
+ * content behind it, the same boundary `AffixDef.id` already draws.
+ *
+ * Deliberately narrow: one low-HP threshold per row, not an arbitrary list of reactions -
+ * add a second column and a second `ReactionRule` in a game's own code the moment a second
+ * one is actually needed, rather than a general reaction-list column format speculatively
+ * built ahead of that need.
+ *
+ * @example
+ * ```ts
+ * import { parseCSV } from '@datamoc/mw_games/core';
+ * import { buildEntities, type EntityTemplateRow } from '@datamoc/mw_games/actors';
+ *
+ * const csv = `id,attack,speed,growth,startingAffix,startingItem,lowHpReaction
+ * fireling,10,8,steep,blazing,ember_charm,0.25`;
+ *
+ * const rows = parseCSV<EntityTemplateRow>(csv, {
+ *   columns: { attack: 'number', speed: 'number', lowHpReaction: 'number' },
+ * });
+ *
+ * const monsters = buildEntities(rows, {
+ *   growthCurves: { steep: { maxLevel: 20, experienceFor: (level) => level * level * 10 } },
+ *   affixes: { blazing: { id: 'blazing', trigger: 'strike', weight: 1 } },
+ *   items: { ember_charm: () => ({ id: 'ember_charm', quantity: 1 }) },
+ * }, (entity) => console.log(`${entity.id} panics at low hp`));
+ *
+ * monsters[0].reactions.check({ hp: 2, maxHp: 10 }); // fires the callback above
+ * ```
+ */
+export interface EntityTemplateRow {
+    id: string;
+    growth?: string;
+    level?: number;
+    startingAffix?: string;
+    startingItem?: string;
+    lowHpReaction?: number;
+    /** any other column is a base stat by that name; must be a number */
+    [stat: string]: unknown;
+}
+/** what each row's named references actually mean - entirely the game's own content */
+export interface EntityTemplateCatalog {
+    growthCurves?: Record<string, GrowthCurve>;
+    affixes?: Record<string, AffixDef>;
+    /** a factory, not a shared instance, so every built entity gets its own item object */
+    items?: Record<string, () => InventoryItem>;
+}
+export interface BuiltEntity {
+    id: string;
+    stats: StatBlock;
+    progression?: Progression;
+    item?: InventoryItem;
+    reactions: ReactionTable<{
+        hp: number;
+        maxHp: number;
+    }>;
+}
+/** what a `BuiltEntity` actually needs saved - everything else is the row/catalog, definitions supplied fresh on load */
+export interface EntitySaveState {
+    stats: {
+        base: Stats;
+    };
+    progression?: {
+        level: number;
+        experience: number;
+    };
+    item?: InventoryItem;
+}
+/**
+ * @example
+ * ```ts
+ * import { buildEntity } from '@datamoc/mw_games/actors';
+ *
+ * const goblin = buildEntity({ id: 'goblin', attack: 4, speed: 3 }, {});
+ * console.log(goblin.stats.get('attack')); // 4
+ * ```
+ */
+export declare function buildEntity(row: EntityTemplateRow, catalog?: EntityTemplateCatalog, onLowHp?: (entity: BuiltEntity) => void): BuiltEntity;
+/** `buildEntity` over every row - the usual shape once a whole file's worth loads at once */
+export declare function buildEntities(rows: readonly EntityTemplateRow[], catalog?: EntityTemplateCatalog, onLowHp?: (entity: BuiltEntity) => void): BuiltEntity[];
+/**
+ * A `BuiltEntity`'s mutable state, in the same "definitions supplied fresh on load" shape
+ * `StatBlock.toJSON`/`Progression.toJSON` already draw: base stat values, level and
+ * experience, and the carried item, never the row or catalog that produced them.
+ *
+ * @example
+ * ```ts
+ * import { buildEntity, toEntitySaveState, fromEntitySaveState, type EntityTemplateCatalog } from '@datamoc/mw_games/actors';
+ *
+ * const catalog: EntityTemplateCatalog = {
+ *   growthCurves: { steep: { maxLevel: 20, experienceFor: (level) => level * level * 10 } },
+ * };
+ *
+ * const row = { id: 'fireling', growth: 'steep', attack: 10 };
+ * const fireling = buildEntity(row, catalog);
+ * fireling.stats.setBase('attack', 12);
+ * fireling.progression?.addExperience(500);
+ *
+ * const saved = toEntitySaveState(fireling); // JSON.stringify this into a save slot
+ * const restored = fromEntitySaveState(row, catalog, saved);
+ * restored.stats.get('attack'); // 12, not the row's original 10
+ * ```
+ */
+export declare function toEntitySaveState(entity: BuiltEntity): EntitySaveState;
+/**
+ * Rebuilds a `BuiltEntity` the same way `buildEntity` does - same row, same catalog, so the
+ * reactions and item lookups stay validated the same way - then overlays the saved base
+ * stats, level/experience, and carried item on top of the fresh one.
+ */
+export declare function fromEntitySaveState(row: EntityTemplateRow, catalog: EntityTemplateCatalog, data: EntitySaveState, onLowHp?: (entity: BuiltEntity) => void): BuiltEntity;
+//# sourceMappingURL=EntityTemplate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntityTemplate.d.ts","sourceRoot":"","sources":["../../src/actors/EntityTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,qEAAqE;IACrE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,uFAAuF;AACvF,MAAM,WAAW,qBAAqB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEnC,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,aAAa,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAED,yHAAyH;AACzH,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE;QAAE,IAAI,EAAE,KAAK,CAAA;KAAE,CAAC;IACvB,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,IAAI,CAAC,EAAE,aAAa,CAAC;CACrB;AAID;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,GAAE,qBAA0B,EAAE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,WAAW,CAgC7I;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,iBAAiB,EAAE,EAAE,OAAO,GAAE,qBAA0B,EAAE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,WAAW,EAAE,CAE7J;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,CAKtE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,qBAAqB,EAC9B,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GACrC,WAAW,CAab"}

package/dist/actors/EntityTemplate.js

@@ -0,0 +1,117 @@
+import { StatBlock } from './StatBlock.js';
+import { Progression } from './Progression.js';
+import { applyAffix } from './Affix.js';
+import { ReactionTable } from '../core/Reactions.js';
+const RESERVED_KEYS = new Set(['id', 'growth', 'level', 'startingAffix', 'startingItem', 'lowHpReaction']);
+/**
+ * @example
+ * ```ts
+ * import { buildEntity } from '@datamoc/mw_games/actors';
+ *
+ * const goblin = buildEntity({ id: 'goblin', attack: 4, speed: 3 }, {});
+ * console.log(goblin.stats.get('attack')); // 4
+ * ```
+ */
+export function buildEntity(row, catalog = {}, onLowHp) {
+    const stats = new StatBlock({ base: statsFrom(row) });
+    let progression;
+    if (row.growth !== undefined) {
+        progression = new Progression(growthCurveFor(row, catalog), { level: row.level ?? 1 });
+    }
+    let item;
+    if (row.startingItem !== undefined) {
+        const factory = catalog.items?.[row.startingItem];
+        if (!factory)
+            throw new Error(`entity template "${row.id}": unknown starting item "${row.startingItem}"`);
+        item = factory();
+        if (row.startingAffix !== undefined) {
+            const affix = catalog.affixes?.[row.startingAffix];
+            if (!affix)
+                throw new Error(`entity template "${row.id}": unknown affix "${row.startingAffix}"`);
+            applyAffix(item, affix);
+        }
+    }
+    else if (row.startingAffix !== undefined) {
+        throw new Error(`entity template "${row.id}": a starting affix needs a starting item to carry it`);
+    }
+    const reactions = new ReactionTable();
+    const entity = { id: row.id, stats, progression, item, reactions };
+    if (row.lowHpReaction !== undefined) {
+        if (!onLowHp)
+            throw new Error(`entity template "${row.id}": names a lowHpReaction threshold but no onLowHp callback was given`);
+        const threshold = row.lowHpReaction;
+        reactions.add({ id: 'low-hp', when: (s) => s.hp / s.maxHp <= threshold, action: () => onLowHp(entity) });
+    }
+    return entity;
+}
+/** `buildEntity` over every row - the usual shape once a whole file's worth loads at once */
+export function buildEntities(rows, catalog = {}, onLowHp) {
+    return rows.map((row) => buildEntity(row, catalog, onLowHp));
+}
+/**
+ * A `BuiltEntity`'s mutable state, in the same "definitions supplied fresh on load" shape
+ * `StatBlock.toJSON`/`Progression.toJSON` already draw: base stat values, level and
+ * experience, and the carried item, never the row or catalog that produced them.
+ *
+ * @example
+ * ```ts
+ * import { buildEntity, toEntitySaveState, fromEntitySaveState, type EntityTemplateCatalog } from '@datamoc/mw_games/actors';
+ *
+ * const catalog: EntityTemplateCatalog = {
+ *   growthCurves: { steep: { maxLevel: 20, experienceFor: (level) => level * level * 10 } },
+ * };
+ *
+ * const row = { id: 'fireling', growth: 'steep', attack: 10 };
+ * const fireling = buildEntity(row, catalog);
+ * fireling.stats.setBase('attack', 12);
+ * fireling.progression?.addExperience(500);
+ *
+ * const saved = toEntitySaveState(fireling); // JSON.stringify this into a save slot
+ * const restored = fromEntitySaveState(row, catalog, saved);
+ * restored.stats.get('attack'); // 12, not the row's original 10
+ * ```
+ */
+export function toEntitySaveState(entity) {
+    const state = { stats: entity.stats.toJSON() };
+    if (entity.progression)
+        state.progression = entity.progression.toJSON();
+    if (entity.item)
+        state.item = entity.item;
+    return state;
+}
+/**
+ * Rebuilds a `BuiltEntity` the same way `buildEntity` does - same row, same catalog, so the
+ * reactions and item lookups stay validated the same way - then overlays the saved base
+ * stats, level/experience, and carried item on top of the fresh one.
+ */
+export function fromEntitySaveState(row, catalog, data, onLowHp) {
+    const entity = buildEntity(row, catalog, onLowHp);
+    entity.stats = StatBlock.fromJSON({ base: statsFrom(row) }, data.stats);
+    if (data.progression !== undefined) {
+        if (!entity.progression) {
+            throw new Error(`entity template "${row.id}": save data has progression but the row names no growth curve`);
+        }
+        entity.progression = Progression.fromJSON(growthCurveFor(row, catalog), data.progression);
+    }
+    if (data.item !== undefined)
+        entity.item = data.item;
+    return entity;
+}
+function growthCurveFor(row, catalog) {
+    const curve = catalog.growthCurves?.[row.growth ?? ''];
+    if (!curve)
+        throw new Error(`entity template "${row.id}": unknown growth curve "${row.growth}"`);
+    return curve;
+}
+function statsFrom(row) {
+    const stats = {};
+    for (const [key, value] of Object.entries(row)) {
+        if (RESERVED_KEYS.has(key))
+            continue;
+        if (typeof value !== 'number')
+            throw new Error(`entity template "${row.id}": stat "${key}" must be a number, got ${typeof value}`);
+        stats[key] = value;
+    }
+    return stats;
+}
+//# sourceMappingURL=EntityTemplate.js.map

package/dist/actors/EntityTemplate.js.map

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

package/dist/actors/index.d.ts

@@ -41,4 +41,6 @@ export { AuraField } from './Aura.ts';
 export type { AuraDef, AuraParticipant } from './Aura.ts';
 export { SupportLedger } from './Support.ts';
 export type { SupportLevel, SupportChange, SupportSave } from './Support.ts';
+export { buildEntity, buildEntities, toEntitySaveState, fromEntitySaveState } from './EntityTemplate.ts';
+export type { EntityTemplateRow, EntityTemplateCatalog, BuiltEntity, EntitySaveState } from './EntityTemplate.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actors/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC1H,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3E,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAClH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACpG,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzG,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/actors/index.js

@@ -20,4 +20,5 @@ export { Barrier } from './Barrier.js';
 export { assignTraits } from './Traits.js';
 export { AuraField } from './Aura.js';
 export { SupportLedger } from './Support.js';
+export { buildEntity, buildEntities, toEntitySaveState, fromEntitySaveState } from './EntityTemplate.js';
 //# sourceMappingURL=index.js.map

package/dist/actors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/actors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpG,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/actors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpG,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/board/HexSkirmish.d.ts

@@ -0,0 +1,213 @@
+/**
+ * A Wesnoth-style hex army-game rules layer: terrain that costs different movement points and
+ * grants a defence bonus per terrain kind, adjacent attacks that always let a surviving
+ * defender strike back, capturable villages that grant income and heal whoever stands on one,
+ * and per-side turn income built on both. Distinct from `board.Tactics` (an X-COM-style
+ * action-point/cover/overwatch layer, ranged attacks, no retaliation) - this is the other
+ * shape a hex army game needs, adjacency-only combat with a hit chance and no zone of control.
+ *
+ * `mwg` supplies the mechanism only: `SkirmishTerrain`'s move cost and defence numbers, unit
+ * attack/hit-chance/hp values, and income rates are entirely the game's own data, the same
+ * policy `board.Army`'s `armyIncome` already follows.
+ *
+ * @example
+ * ```ts
+ * import { startingSkirmish, setSkirmishTerrain, addSkirmishUnit, skirmishMoves, moveSkirmishUnit, skirmishAttack, endSkirmishTurn, skirmishIncome } from '@datamoc/mw_games/board';
+ *
+ * const terrain = { plain: { moveCost: 1, defense: 0 }, forest: { moveCost: 2, defense: 0.3 } };
+ * const state = startingSkirmish(6, 6, terrain);
+ * setSkirmishTerrain(state, 2, 2, 'forest');
+ * setSkirmishTerrain(state, 0, 0, 'plain', true); // a village at the corner
+ *
+ * addSkirmishUnit(state, { id: 'axeman', owner: 'blue', x: 0, y: 0, hp: 10, maxHp: 10, moves: 4, attack: 4, hitChance: 0.7 });
+ * addSkirmishUnit(state, { id: 'raider', owner: 'red', x: 1, y: 0, hp: 10, maxHp: 10, moves: 4, attack: 3, hitChance: 0.6 });
+ *
+ * const moves = skirmishMoves(state, 'axeman'); // reachable cells, weighted by terrain cost
+ * const exchange = skirmishAttack(state, 'axeman', 'raider'); // both strike if raider survives
+ *
+ * endSkirmishTurn(state); // hands the turn to red, refills moves, heals units on owned villages
+ * const income = skirmishIncome(state, 'blue', 2, 1); // base 2, +1 per village blue owns
+ * ```
+ */
+export interface SkirmishTerrain {
+    /** movement points spent entering this terrain kind; `Infinity` makes it impassable */
+    moveCost: number;
+    /** 0-1 defence bonus for whoever is standing here while defending - what it multiplies is `skirmishAttack`'s own formula, not this terrain's own business */
+    defense: number;
+}
+export interface SkirmishCell {
+    terrain: string;
+    /** a capturable village - `moveSkirmishUnit` sets `owner` to whoever last stood here */
+    village?: boolean;
+    owner?: string;
+}
+export interface SkirmishUnit {
+    id: string;
+    owner: string;
+    x: number;
+    y: number;
+    hp: number;
+    maxHp: number;
+    /** movement points available this turn; refilled to `moves` by `endSkirmishTurn` */
+    moves: number;
+    remainingMoves?: number;
+    attack: number;
+    /** 0-1 base chance to land a hit, before the defender's terrain defence reduces it */
+    hitChance: number;
+}
+export interface SkirmishState {
+    width: number;
+    height: number;
+    terrainTable: Record<string, SkirmishTerrain>;
+    cells: SkirmishCell[];
+    units: SkirmishUnit[];
+    turn: string;
+    round: number;
+}
+export interface SkirmishMove {
+    unit: string;
+    x: number;
+    y: number;
+    cost: number;
+}
+export interface SkirmishStrike {
+    attacker: string;
+    defender: string;
+    hit: boolean;
+    damage: number;
+    killed: boolean;
+}
+export interface SkirmishExchange {
+    strikes: SkirmishStrike[];
+}
+/**
+ * @example
+ * ```ts
+ * import { startingSkirmish } from '@datamoc/mw_games/board';
+ *
+ * const state = startingSkirmish(6, 6, { plain: { moveCost: 1, defense: 0 } });
+ * console.log(state.width, state.round); // 6 1
+ * ```
+ */
+export declare function startingSkirmish(width: number, height: number, terrainTable: Record<string, SkirmishTerrain>, defaultTerrain?: string): SkirmishState;
+/**
+ * @example
+ * ```ts
+ * import { startingSkirmish, setSkirmishTerrain } from '@datamoc/mw_games/board';
+ *
+ * const state = startingSkirmish(6, 6, { plain: { moveCost: 1, defense: 0 }, forest: { moveCost: 2, defense: 0.3 } });
+ * setSkirmishTerrain(state, 2, 2, 'forest', true);
+ * console.log(state.cells[2 * 6 + 2]); // { terrain: 'forest', village: true }
+ * ```
+ */
+export declare function setSkirmishTerrain(state: SkirmishState, x: number, y: number, terrain: string, village?: boolean): void;
+/**
+ * whether a unit could be placed at (x, y) right now - on the map, passable, and unoccupied
+ *
+ * @example
+ * ```ts
+ * import { startingSkirmish, addSkirmishUnit, canPlaceSkirmishUnit } from '@datamoc/mw_games/board';
+ *
+ * const state = startingSkirmish(6, 6, { plain: { moveCost: 1, defense: 0 } });
+ * addSkirmishUnit(state, { id: 'axeman', owner: 'blue', x: 0, y: 0, hp: 10, maxHp: 10, moves: 4, attack: 4, hitChance: 0.7 });
+ *
+ * console.log(canPlaceSkirmishUnit(state, 1, 0)); // true
+ * console.log(canPlaceSkirmishUnit(state, 0, 0)); // false - axeman is already there
+ * ```
+ */
+export declare function canPlaceSkirmishUnit(state: SkirmishState, x: number, y: number): boolean;
+/**
+ * Places a unit at full remaining movement; the first unit added decides whose turn it is.
+ *
+ * @example
+ * ```ts
+ * import { startingSkirmish, addSkirmishUnit } from '@datamoc/mw_games/board';
+ *
+ * const state = startingSkirmish(6, 6, { plain: { moveCost: 1, defense: 0 } });
+ * addSkirmishUnit(state, { id: 'axeman', owner: 'blue', x: 0, y: 0, hp: 10, maxHp: 10, moves: 4, attack: 4, hitChance: 0.7 });
+ * console.log(state.turn); // 'blue'
+ * ```
+ */
+export declare function addSkirmishUnit(state: SkirmishState, unit: SkirmishUnit): void;
+/**
+ * Every cell a unit can reach with its remaining movement points this turn, weighted by each
+ * terrain kind's own `moveCost` - no zone of control, unlike `board.Tactics`.
+ *
+ * @example
+ * ```ts
+ * import { startingSkirmish, addSkirmishUnit, skirmishMoves } from '@datamoc/mw_games/board';
+ *
+ * const state = startingSkirmish(6, 6, { plain: { moveCost: 1, defense: 0 } });
+ * addSkirmishUnit(state, { id: 'axeman', owner: 'blue', x: 0, y: 0, hp: 10, maxHp: 10, moves: 2, attack: 4, hitChance: 0.7 });
+ *
+ * console.log(skirmishMoves(state, 'axeman').length); // 6 - every hex within 2 plain steps
+ * ```
+ */
+export declare function skirmishMoves(state: SkirmishState, unitId: string): SkirmishMove[];
+/**
+ * @example
+ * ```ts
+ * import { startingSkirmish, addSkirmishUnit, skirmishMoves, moveSkirmishUnit } from '@datamoc/mw_games/board';
+ *
+ * const state = startingSkirmish(6, 6, { plain: { moveCost: 1, defense: 0 } });
+ * addSkirmishUnit(state, { id: 'axeman', owner: 'blue', x: 0, y: 0, hp: 10, maxHp: 10, moves: 2, attack: 4, hitChance: 0.7 });
+ *
+ * moveSkirmishUnit(state, skirmishMoves(state, 'axeman')[0]);
+ * console.log(state.units[0].remainingMoves); // 1 - one plain hex spent
+ * ```
+ */
+export declare function moveSkirmishUnit(state: SkirmishState, move: SkirmishMove): void;
+/**
+ * An attacker's strike against an adjacent enemy, followed by the defender's own retaliation
+ * if it survives - both use the same formula: `hitChance` reduced by the defender's terrain
+ * defence, `Random.chance` deciding whether it lands, `attack` as the flat damage on a hit.
+ *
+ * @example
+ * ```ts
+ * import { startingSkirmish, addSkirmishUnit, skirmishAttack } from '@datamoc/mw_games/board';
+ * import { Random } from '@datamoc/mw_games/core';
+ *
+ * const state = startingSkirmish(6, 6, { plain: { moveCost: 1, defense: 0 } });
+ * addSkirmishUnit(state, { id: 'axeman', owner: 'blue', x: 0, y: 0, hp: 10, maxHp: 10, moves: 4, attack: 4, hitChance: 1 });
+ * addSkirmishUnit(state, { id: 'raider', owner: 'red', x: 1, y: 0, hp: 10, maxHp: 10, moves: 4, attack: 3, hitChance: 1 });
+ *
+ * const exchange = Random.withSeed(1, () => skirmishAttack(state, 'axeman', 'raider'));
+ * console.log(exchange.strikes.map((strike: { attacker: string }) => strike.attacker)); // ['axeman', 'raider'] - raider survived to retaliate
+ * ```
+ */
+export declare function skirmishAttack(state: SkirmishState, attackerId: string, defenderId: string): SkirmishExchange;
+/**
+ * Net income for one side, from a flat base plus every village it currently owns - purely a
+ * function of the map's own village ownership, no formula beyond that belongs here, the same
+ * policy `board.Army`'s `armyIncome` already follows.
+ *
+ * @example
+ * ```ts
+ * import { startingSkirmish, setSkirmishTerrain, skirmishIncome } from '@datamoc/mw_games/board';
+ *
+ * const state = startingSkirmish(4, 1, { plain: { moveCost: 1, defense: 0 } });
+ * setSkirmishTerrain(state, 0, 0, 'plain', true);
+ * state.cells[0].owner = 'blue';
+ *
+ * console.log(skirmishIncome(state, 'blue', 2, 1)); // 3 - base 2, plus 1 for the one village
+ * ```
+ */
+export declare function skirmishIncome(state: SkirmishState, owner: string, baseIncome: number, perVillage: number): number;
+/**
+ * Hands the turn to the next owner with units on the board, refilling their movement and
+ * healing every one of their units standing on a village they own.
+ *
+ * @example
+ * ```ts
+ * import { startingSkirmish, addSkirmishUnit, endSkirmishTurn } from '@datamoc/mw_games/board';
+ *
+ * const state = startingSkirmish(6, 6, { plain: { moveCost: 1, defense: 0 } });
+ * addSkirmishUnit(state, { id: 'axeman', owner: 'blue', x: 0, y: 0, hp: 10, maxHp: 10, moves: 4, attack: 4, hitChance: 0.7 });
+ * addSkirmishUnit(state, { id: 'raider', owner: 'red', x: 3, y: 0, hp: 10, maxHp: 10, moves: 4, attack: 3, hitChance: 0.6 });
+ *
+ * endSkirmishTurn(state, 2);
+ * console.log(state.turn, state.round); // 'red' 1
+ * ```
+ */
+export declare function endSkirmishTurn(state: SkirmishState, healPerVillage?: number): void;
+//# sourceMappingURL=HexSkirmish.d.ts.map

package/dist/board/HexSkirmish.d.ts.map

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