@datamoc/mw_games 0.5.0 → 0.5.2

package/dist/board/HexSkirmish.js

@@ -0,0 +1,271 @@
+import { hexNeighbors, hexDistance } from '../core/Hex.js';
+import * as Random from '../core/Random.js';
+/**
+ * @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 function startingSkirmish(width, height, terrainTable, defaultTerrain) {
+    if (width < 1 || height < 1)
+        throw new Error('a skirmish map needs positive dimensions');
+    const terrain = defaultTerrain ?? Object.keys(terrainTable)[0];
+    if (!terrain || !terrainTable[terrain])
+        throw new Error('a skirmish map needs at least one terrain kind');
+    return {
+        width,
+        height,
+        terrainTable,
+        cells: Array.from({ length: width * height }, () => ({ terrain })),
+        units: [],
+        turn: '',
+        round: 1,
+    };
+}
+/**
+ * @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 function setSkirmishTerrain(state, x, y, terrain, village = false) {
+    if (!inside(state, x, y))
+        throw new Error('cell is outside the skirmish map');
+    if (!state.terrainTable[terrain])
+        throw new Error(`unknown skirmish terrain "${terrain}"`);
+    state.cells[y * state.width + x] = village ? { terrain, village: true } : { terrain };
+}
+/**
+ * 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 function canPlaceSkirmishUnit(state, x, y) {
+    return inside(state, x, y) && moveCostOf(state, x, y) < Infinity && !occupied(state, x, y);
+}
+/**
+ * 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 function addSkirmishUnit(state, unit) {
+    if (!canPlaceSkirmishUnit(state, unit.x, unit.y))
+        throw new Error('skirmish unit cannot be placed there');
+    state.units.push({ ...unit, remainingMoves: unit.moves });
+    if (!state.turn)
+        state.turn = unit.owner;
+}
+/**
+ * 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 function skirmishMoves(state, unitId) {
+    const unit = getUnit(state, unitId);
+    const budget = unit.remainingMoves ?? unit.moves;
+    if (unit.owner !== state.turn || budget <= 0)
+        return [];
+    const out = [];
+    for (let y = 0; y < state.height; y++)
+        for (let x = 0; x < state.width; x++) {
+            if ((x === unit.x && y === unit.y) || moveCostOf(state, x, y) === Infinity || occupied(state, x, y))
+                continue;
+            const cost = pathCost(state, unit, x, y, budget);
+            if (cost !== null)
+                out.push({ unit: unitId, x, y, cost });
+        }
+    return out;
+}
+/**
+ * @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 function moveSkirmishUnit(state, move) {
+    const legal = skirmishMoves(state, move.unit).find((candidate) => candidate.x === move.x && candidate.y === move.y);
+    if (!legal)
+        throw new Error('illegal skirmish move');
+    const unit = getUnit(state, move.unit);
+    unit.x = move.x;
+    unit.y = move.y;
+    unit.remainingMoves = (unit.remainingMoves ?? unit.moves) - legal.cost;
+    const cell = state.cells[move.y * state.width + move.x];
+    if (cell.village)
+        cell.owner = unit.owner;
+}
+/**
+ * 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 function skirmishAttack(state, attackerId, defenderId) {
+    const attacker = getUnit(state, attackerId);
+    const defender = getUnit(state, defenderId);
+    if (attacker.owner !== state.turn || attacker.owner === defender.owner)
+        throw new Error('invalid skirmish attack');
+    if (hexDistance(attacker, defender) !== 1)
+        throw new Error('skirmish combat is adjacency-only');
+    const strikes = [strike(state, attacker, defender)];
+    if (defender.hp > 0)
+        strikes.push(strike(state, defender, attacker));
+    state.units = state.units.filter((unit) => unit.hp > 0);
+    return { strikes };
+}
+function strike(state, attacker, defender) {
+    const defense = terrainOf(state, defender.x, defender.y).defense;
+    const hit = Random.chance(Math.max(0, Math.min(1, attacker.hitChance * (1 - defense))));
+    const damage = hit ? Math.min(attacker.attack, defender.hp) : 0;
+    defender.hp -= damage;
+    return { attacker: attacker.id, defender: defender.id, hit, damage, killed: defender.hp <= 0 };
+}
+/**
+ * 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 function skirmishIncome(state, owner, baseIncome, perVillage) {
+    const villages = state.cells.filter((cell) => cell.village && cell.owner === owner).length;
+    return baseIncome + villages * perVillage;
+}
+/**
+ * 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 function endSkirmishTurn(state, healPerVillage = 0) {
+    const owners = [...new Set(state.units.map((unit) => unit.owner))];
+    if (owners.length === 0)
+        return;
+    const next = owners.indexOf(state.turn) + 1;
+    if (next >= owners.length)
+        state.round++;
+    state.turn = owners[next % owners.length];
+    for (const unit of state.units) {
+        if (unit.owner !== state.turn)
+            continue;
+        unit.remainingMoves = unit.moves;
+        const cell = state.cells[unit.y * state.width + unit.x];
+        if (cell.village && cell.owner === unit.owner && healPerVillage > 0) {
+            unit.hp = Math.min(unit.maxHp, unit.hp + healPerVillage);
+        }
+    }
+}
+function getUnit(state, id) {
+    const unit = state.units.find((candidate) => candidate.id === id);
+    if (!unit)
+        throw new Error(`unknown skirmish unit "${id}"`);
+    return unit;
+}
+function inside(state, x, y) { return x >= 0 && y >= 0 && x < state.width && y < state.height; }
+function occupied(state, x, y) { return state.units.some((unit) => unit.x === x && unit.y === y); }
+function terrainOf(state, x, y) { return state.terrainTable[state.cells[y * state.width + x].terrain]; }
+function moveCostOf(state, x, y) { return terrainOf(state, x, y).moveCost; }
+//the real weighted walking cost to (targetX, targetY), never exceeding `budget`, or null if it
+//cannot be reached within that budget - Dijkstra over a small grid rather than BFS, since
+//terrain move cost varies per cell unlike board.Tactics' uniform one-step cost
+function pathCost(state, unit, targetX, targetY, budget) {
+    const best = new Map([[`${unit.x},${unit.y}`, 0]]);
+    const todo = [{ x: unit.x, y: unit.y, cost: 0 }];
+    while (todo.length > 0) {
+        todo.sort((a, b) => a.cost - b.cost);
+        const current = todo.shift();
+        const key = `${current.x},${current.y}`;
+        if (current.cost > (best.get(key) ?? Infinity))
+            continue;
+        if (current.x === targetX && current.y === targetY)
+            return current.cost;
+        for (const next of hexNeighbors(current.x, current.y)) {
+            if (!inside(state, next.x, next.y))
+                continue;
+            const stepCost = moveCostOf(state, next.x, next.y);
+            if (stepCost === Infinity)
+                continue;
+            if (occupied(state, next.x, next.y) && !(next.x === targetX && next.y === targetY))
+                continue;
+            const total = current.cost + stepCost;
+            if (total > budget)
+                continue;
+            const nextKey = `${next.x},${next.y}`;
+            if (total < (best.get(nextKey) ?? Infinity)) {
+                best.set(nextKey, total);
+                todo.push({ x: next.x, y: next.y, cost: total });
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=HexSkirmish.js.map

package/dist/board/HexSkirmish.js.map

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

package/dist/board/index.d.ts

@@ -10,4 +10,6 @@ export { FactionFog } from './FogOfWar.ts';
 export type { VisionCell } from './FogOfWar.ts';
 export { startingArmy, recruit, recall, bankUnit, armyIncome, applyUpkeep } from './Army.ts';
 export type { UnitTemplate, ArmyState, UpkeepRates } from './Army.ts';
+export { startingSkirmish, setSkirmishTerrain, canPlaceSkirmishUnit, addSkirmishUnit, skirmishMoves, moveSkirmishUnit, skirmishAttack, skirmishIncome, endSkirmishTurn, } from './HexSkirmish.ts';
+export type { SkirmishTerrain, SkirmishCell, SkirmishUnit, SkirmishState, SkirmishMove, SkirmishStrike, SkirmishExchange, } from './HexSkirmish.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/board/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,aAAa,EACb,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,EACT,OAAO,EACP,UAAU,EACV,EAAE,EACF,UAAU,GACV,MAAM,YAAY,CAAC;AACpB,YAAY,EACX,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,UAAU,EACV,WAAW,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EACN,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAO,EACP,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,IAAI,EACJ,WAAW,EACX,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,yBAAyB,EACzB,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,OAAO,EACP,SAAS,GACT,MAAM,eAAe,CAAC;AACvB,YAAY,EACX,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,OAAO,EACP,OAAO,EACP,YAAY,EACZ,SAAS,EACT,eAAe,EACf,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,cAAc,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxM,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC3H,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7F,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/board/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,aAAa,EACb,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,EACT,OAAO,EACP,UAAU,EACV,EAAE,EACF,UAAU,GACV,MAAM,YAAY,CAAC;AACpB,YAAY,EACX,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,UAAU,EACV,WAAW,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EACN,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAO,EACP,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,IAAI,EACJ,WAAW,EACX,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,yBAAyB,EACzB,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,OAAO,EACP,SAAS,GACT,MAAM,eAAe,CAAC;AACvB,YAAY,EACX,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,OAAO,EACP,OAAO,EACP,YAAY,EACZ,SAAS,EACT,eAAe,EACf,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,cAAc,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxM,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC3H,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7F,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EACN,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,eAAe,GACf,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,cAAc,EACd,gBAAgB,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/board/index.js

@@ -4,4 +4,5 @@ export { BoardGrid, startingCheckers, checkersMoves, applyCheckersMove, starting
 export { startingTactics, addTacticalUnit, canPlaceTacticalUnit, tacticalMoves, moveTacticalUnit, setTacticalOverwatch, triggerTacticalOverwatch, tacticalAttack, endTacticalTurn } from './Tactics.js';
 export { FactionFog } from './FogOfWar.js';
 export { startingArmy, recruit, recall, bankUnit, armyIncome, applyUpkeep } from './Army.js';
+export { startingSkirmish, setSkirmishTerrain, canPlaceSkirmishUnit, addSkirmishUnit, skirmishMoves, moveSkirmishUnit, skirmishAttack, skirmishIncome, endSkirmishTurn, } from './HexSkirmish.js';
 //# sourceMappingURL=index.js.map

package/dist/board/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/board/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,aAAa,EACb,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,EACT,OAAO,EACP,UAAU,EACV,EAAE,EACF,UAAU,GACV,MAAM,YAAY,CAAC;AAYpB,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EACN,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAO,EACP,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,IAAI,EACJ,WAAW,EACX,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,yBAAyB,EACzB,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,OAAO,EACP,SAAS,GACT,MAAM,eAAe,CAAC;AAmBvB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAExM,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/board/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,aAAa,EACb,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,EACT,OAAO,EACP,UAAU,EACV,EAAE,EACF,UAAU,GACV,MAAM,YAAY,CAAC;AAYpB,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EACN,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAO,EACP,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,IAAI,EACJ,WAAW,EACX,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,yBAAyB,EACzB,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,OAAO,EACP,SAAS,GACT,MAAM,eAAe,CAAC;AAmBvB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAExM,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7F,OAAO,EACN,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,eAAe,GACf,MAAM,kBAAkB,CAAC"}

package/dist/core/Csv.d.ts

@@ -0,0 +1,64 @@
+/**
+ * A header-row CSV into an array of typed row objects - so a content designer edits a
+ * spreadsheet instead of a `.ts` object literal for a table shaped like `actors.AffixTable`,
+ * `actors.LootTable`, or any other array-of-records a game defines. The same precedent
+ * `i18n`'s `parseFTL` already set: this takes a raw string and has no opinion on how that
+ * string reached the game (a small table can sit in a `.ts` template literal; a larger one
+ * loads through a bundler's raw-text import - Vite resolves a `?raw`-suffixed path to its
+ * file's contents as a plain string - or through a game's own asset pipeline) - `mwg`
+ * supplies the parsing, not the loading.
+ *
+ * Every cell is a string until a column says otherwise: `columns` names which fields are
+ * `'number'`/`'boolean'`/`'list'` (semicolon-separated by default, for a field shaped like
+ * `AffixDef.kinds`) /`'map'` (semicolon-separated `key=value` pairs, for a per-row property
+ * bag such as `{ str: '2', dex: '-1' }` a game reads its own way) - and an undeclared column
+ * stays a plain string. An **empty cell omits that field from the row entirely**, the same as
+ * never setting an optional property - so a blank `curse` column reads exactly like the
+ * `curse?: boolean` it fills never being set.
+ *
+ * Follows RFC 4180 far enough for real game-data text: a quoted field may contain the
+ * delimiter, a newline, or an escaped `""` for a literal quote, which a naive `split(',')`
+ * cannot survive the moment a description contains a comma.
+ *
+ * What this cannot hold: a `core.ReactionTable` rule's `when`/`action` are executable code,
+ * not data, so no cell format expresses them - the same boundary `AffixDef.id` already draws
+ * (a string the game interprets, `mwg` never does). A CSV row can drive *which* reactions a
+ * game builds at startup (an id, a comparison string like `'hp<=0.25'`, a threshold number a
+ * `'number'` column already coerces) with the game's own code turning each row into a real
+ * `ReactionRule`; it cannot hold the rule's logic itself.
+ *
+ * @example
+ * ```ts
+ * import { parseCSV } from '@datamoc/mw_games/core';
+ * import type { AffixDef, AffixTable } from '@datamoc/mw_games/actors';
+ *
+ * const csv = `id,trigger,weight,curse,description
+ * blazing,strike,3,,Ignites the victim
+ * wayward,strike,1,true,"Cursed: -3 accuracy"`;
+ *
+ * const table: AffixTable = {
+ *   entries: parseCSV<AffixDef>(csv, { columns: { weight: 'number', curse: 'boolean' } }),
+ * };
+ * console.log(table.entries[1]); // { id: 'wayward', trigger: 'strike', weight: 1, curse: true, description: 'Cursed: -3 accuracy' }
+ * ```
+ */
+export type CsvColumnType = 'string' | 'number' | 'boolean' | 'list' | 'map';
+export interface CsvOptions {
+    /** how to interpret each named column beyond a plain string; an undeclared column stays one */
+    columns?: Record<string, CsvColumnType>;
+    /** splits a `'list'`/`'map'` column's cell into individual entries; default `;` */
+    listDelimiter?: string;
+    /** splits a `'map'` entry into its key and value; default `=` */
+    mapDelimiter?: string;
+}
+/**
+ * @example
+ * ```ts
+ * import { parseCSV } from '@datamoc/mw_games/core';
+ *
+ * const rows = parseCSV('id,weight\nblazing,3\nchilling,3', { columns: { weight: 'number' } });
+ * console.log(rows); // [{ id: 'blazing', weight: 3 }, { id: 'chilling', weight: 3 }]
+ * ```
+ */
+export declare function parseCSV<T = Record<string, string>>(source: string, options?: CsvOptions): T[];
+//# sourceMappingURL=Csv.d.ts.map

package/dist/core/Csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Csv.d.ts","sourceRoot":"","sources":["../../src/core/Csv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7E,MAAM,WAAW,UAAU;IAC1B,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAExC,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,CAAC,EAAE,CAiBlG"}

package/dist/core/Csv.js

@@ -0,0 +1,164 @@
+/**
+ * A header-row CSV into an array of typed row objects - so a content designer edits a
+ * spreadsheet instead of a `.ts` object literal for a table shaped like `actors.AffixTable`,
+ * `actors.LootTable`, or any other array-of-records a game defines. The same precedent
+ * `i18n`'s `parseFTL` already set: this takes a raw string and has no opinion on how that
+ * string reached the game (a small table can sit in a `.ts` template literal; a larger one
+ * loads through a bundler's raw-text import - Vite resolves a `?raw`-suffixed path to its
+ * file's contents as a plain string - or through a game's own asset pipeline) - `mwg`
+ * supplies the parsing, not the loading.
+ *
+ * Every cell is a string until a column says otherwise: `columns` names which fields are
+ * `'number'`/`'boolean'`/`'list'` (semicolon-separated by default, for a field shaped like
+ * `AffixDef.kinds`) /`'map'` (semicolon-separated `key=value` pairs, for a per-row property
+ * bag such as `{ str: '2', dex: '-1' }` a game reads its own way) - and an undeclared column
+ * stays a plain string. An **empty cell omits that field from the row entirely**, the same as
+ * never setting an optional property - so a blank `curse` column reads exactly like the
+ * `curse?: boolean` it fills never being set.
+ *
+ * Follows RFC 4180 far enough for real game-data text: a quoted field may contain the
+ * delimiter, a newline, or an escaped `""` for a literal quote, which a naive `split(',')`
+ * cannot survive the moment a description contains a comma.
+ *
+ * What this cannot hold: a `core.ReactionTable` rule's `when`/`action` are executable code,
+ * not data, so no cell format expresses them - the same boundary `AffixDef.id` already draws
+ * (a string the game interprets, `mwg` never does). A CSV row can drive *which* reactions a
+ * game builds at startup (an id, a comparison string like `'hp<=0.25'`, a threshold number a
+ * `'number'` column already coerces) with the game's own code turning each row into a real
+ * `ReactionRule`; it cannot hold the rule's logic itself.
+ *
+ * @example
+ * ```ts
+ * import { parseCSV } from '@datamoc/mw_games/core';
+ * import type { AffixDef, AffixTable } from '@datamoc/mw_games/actors';
+ *
+ * const csv = `id,trigger,weight,curse,description
+ * blazing,strike,3,,Ignites the victim
+ * wayward,strike,1,true,"Cursed: -3 accuracy"`;
+ *
+ * const table: AffixTable = {
+ *   entries: parseCSV<AffixDef>(csv, { columns: { weight: 'number', curse: 'boolean' } }),
+ * };
+ * console.log(table.entries[1]); // { id: 'wayward', trigger: 'strike', weight: 1, curse: true, description: 'Cursed: -3 accuracy' }
+ * ```
+ */
+/**
+ * @example
+ * ```ts
+ * import { parseCSV } from '@datamoc/mw_games/core';
+ *
+ * const rows = parseCSV('id,weight\nblazing,3\nchilling,3', { columns: { weight: 'number' } });
+ * console.log(rows); // [{ id: 'blazing', weight: 3 }, { id: 'chilling', weight: 3 }]
+ * ```
+ */
+export function parseCSV(source, options = {}) {
+    const rows = tokenizeCsv(source);
+    if (rows.length === 0)
+        return [];
+    const [header, ...body] = rows;
+    const listDelimiter = options.listDelimiter ?? ';';
+    const mapDelimiter = options.mapDelimiter ?? '=';
+    return body.map((cells, rowIndex) => {
+        const row = {};
+        header.forEach((name, columnIndex) => {
+            const raw = cells[columnIndex] ?? '';
+            if (raw === '')
+                return; //an empty cell omits the field, the same as an optional property never set
+            row[name] = coerceCsvCell(raw, options.columns?.[name] ?? 'string', name, rowIndex, listDelimiter, mapDelimiter);
+        });
+        return row;
+    });
+}
+function coerceCsvCell(raw, type, column, rowIndex, listDelimiter, mapDelimiter) {
+    switch (type) {
+        case 'string':
+            return raw;
+        case 'number': {
+            const value = Number(raw);
+            if (!Number.isFinite(value))
+                throw new Error(`CSV row ${rowIndex + 1}, column "${column}": "${raw}" is not a number`);
+            return value;
+        }
+        case 'boolean': {
+            const lower = raw.toLowerCase();
+            if (lower === 'true')
+                return true;
+            if (lower === 'false')
+                return false;
+            throw new Error(`CSV row ${rowIndex + 1}, column "${column}": "${raw}" is not "true" or "false"`);
+        }
+        case 'list':
+            return raw.split(listDelimiter).map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+        case 'map': {
+            const map = {};
+            for (const entry of raw.split(listDelimiter).map((piece) => piece.trim()).filter((piece) => piece.length > 0)) {
+                const at = entry.indexOf(mapDelimiter);
+                if (at === -1)
+                    throw new Error(`CSV row ${rowIndex + 1}, column "${column}": "${entry}" has no "${mapDelimiter}" to split a key from its value`);
+                map[entry.slice(0, at).trim()] = entry.slice(at + mapDelimiter.length).trim();
+            }
+            return map;
+        }
+    }
+}
+//RFC 4180-shaped tokenizer, char by char rather than split(',')/split('\n'): a quoted field may
+//itself contain the delimiter, a bare newline, or an escaped `""` for a literal quote, none of
+//which a naive split survives the moment a description column contains a comma
+function tokenizeCsv(source) {
+    const rows = [];
+    let row = [];
+    let field = '';
+    let inQuotes = false;
+    let i = 0;
+    while (i < source.length) {
+        const char = source[i];
+        if (inQuotes) {
+            if (char === '"') {
+                if (source[i + 1] === '"') {
+                    field += '"';
+                    i += 2;
+                    continue;
+                }
+                inQuotes = false;
+                i++;
+                continue;
+            }
+            field += char;
+            i++;
+            continue;
+        }
+        if (char === '"') {
+            inQuotes = true;
+            i++;
+            continue;
+        }
+        if (char === ',') {
+            row.push(field);
+            field = '';
+            i++;
+            continue;
+        }
+        if (char === '\r') {
+            i++;
+            continue;
+        } //normalize CRLF, and swallow a bare CR too
+        if (char === '\n') {
+            row.push(field);
+            rows.push(row);
+            row = [];
+            field = '';
+            i++;
+            continue;
+        }
+        field += char;
+        i++;
+    }
+    if (field.length > 0 || row.length > 0) {
+        row.push(field);
+        rows.push(row);
+    }
+    //a trailing newline (the common case for a hand-edited file) would otherwise flush one
+    //more, entirely blank row after the real data
+    return rows.filter((cells) => !(cells.length === 1 && cells[0] === ''));
+}
+//# sourceMappingURL=Csv.js.map

package/dist/core/Csv.js.map

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

package/dist/core/Registry.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A named lookup of values, registered once and read back by name - the shape underneath a
+ * catalog of factories, handlers, or scene sections, so a game can grow that catalog by
+ * registering another entry instead of adding another branch to a hand-written `if`/`switch`.
+ *
+ * Deliberately does not discover or import anything on its own: a game still writes the
+ * import and the `register` call for each entry itself, the same explicit-import style
+ * `core`/`two-d` already use throughout - this only replaces the dispatch step after that,
+ * not the wiring step before it.
+ *
+ * @example
+ * ```ts
+ * import { Registry } from '@datamoc/mw_games/core';
+ *
+ * const commands = new Registry<(args: string[]) => void>();
+ * commands.register('heal', (args) => console.log('healing', args[0]));
+ *
+ * commands.get('heal')(['fireling']); // "healing fireling"
+ * commands.get('missing'); // throws: no registration named "missing"
+ * ```
+ */
+export declare class Registry<T> {
+    private items;
+    /** throws if `name` is already registered - a duplicate is always an authoring error */
+    register(name: string, value: T): void;
+    get(name: string): T;
+    has(name: string): boolean;
+    /** every registered name, in registration order */
+    list(): string[];
+}
+//# sourceMappingURL=Registry.d.ts.map

package/dist/core/Registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Registry.d.ts","sourceRoot":"","sources":["../../src/core/Registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,QAAQ,CAAC,CAAC;IACtB,OAAO,CAAC,KAAK,CAAwB;IAErC,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAGrC;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAInB;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzB;IAED,mDAAmD;IACnD,IAAI,IAAI,MAAM,EAAE,CAEf;CACD"}

package/dist/core/Registry.js

@@ -0,0 +1,46 @@
+/**
+ * A named lookup of values, registered once and read back by name - the shape underneath a
+ * catalog of factories, handlers, or scene sections, so a game can grow that catalog by
+ * registering another entry instead of adding another branch to a hand-written `if`/`switch`.
+ *
+ * Deliberately does not discover or import anything on its own: a game still writes the
+ * import and the `register` call for each entry itself, the same explicit-import style
+ * `core`/`two-d` already use throughout - this only replaces the dispatch step after that,
+ * not the wiring step before it.
+ *
+ * @example
+ * ```ts
+ * import { Registry } from '@datamoc/mw_games/core';
+ *
+ * const commands = new Registry<(args: string[]) => void>();
+ * commands.register('heal', (args) => console.log('healing', args[0]));
+ *
+ * commands.get('heal')(['fireling']); // "healing fireling"
+ * commands.get('missing'); // throws: no registration named "missing"
+ * ```
+ */
+export class Registry {
+    constructor() {
+        this.items = new Map();
+    }
+    /** throws if `name` is already registered - a duplicate is always an authoring error */
+    register(name, value) {
+        if (this.items.has(name))
+            throw new Error(`"${name}" is already registered`);
+        this.items.set(name, value);
+    }
+    get(name) {
+        const value = this.items.get(name);
+        if (value === undefined)
+            throw new Error(`no registration named "${name}"`);
+        return value;
+    }
+    has(name) {
+        return this.items.has(name);
+    }
+    /** every registered name, in registration order */
+    list() {
+        return [...this.items.keys()];
+    }
+}
+//# sourceMappingURL=Registry.js.map

package/dist/core/Registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Registry.js","sourceRoot":"","sources":["../../src/core/Registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,QAAQ;IAArB;QACS,UAAK,GAAG,IAAI,GAAG,EAAa,CAAC;IAsBtC,CAAC;IApBA,wFAAwF;IACxF,QAAQ,CAAC,IAAY,EAAE,KAAQ;QAC9B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,yBAAyB,CAAC,CAAC;QAC7E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,IAAY;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,GAAG,CAAC,CAAC;QAC5E,OAAO,KAAK,CAAC;IACd,CAAC;IAED,GAAG,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,mDAAmD;IACnD,IAAI;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/B,CAAC;CACD"}