@datamoc/mw_games 0.44.2 → 0.45.0

package/dist/simulation/EventPresentation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"EventPresentation.js","sourceRoot":"","sources":["../../src/simulation/EventPresentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AA2BjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,OAAO,iBAAiB;IAO7B,YAAY,OAA2D;QAF/D,cAAS,GAAc,EAAE,CAAC;QAGjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,IAAI,iBAAiB,CAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED,yGAAyG;IACzG,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAAgB;QACtB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,oEAAoE;IACpE,MAAM,CAAC,EAAU;QAChB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtB,IAAI,CAAC,cAAc,EAAE,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,MAAM;QACL,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,GAAG,CAAC;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAAO,CACb,QAAmC,EACnC,OAMC;QAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAA2B,QAAQ,EAAE;YAC7E,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;SACxB,CAAC,CAAC;QACH,OAAO,IAAI,iBAAiB,CAA2B;YACtD,OAAO;YACP,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC1B,CAAC,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,OAAgB;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,UAAU;YAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,gGAAgG;IACxF,cAAc;QACrB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAa,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;CACD"}

package/dist/simulation/Harness.d.ts

@@ -1,26 +0,0 @@
-import { Generator } from '../core/Random.ts';
-import { type Scenario, type ScenarioResult } from './Scenario.ts';
-export interface HeadlessScenario<State, Command, Event> {
-    readonly seed: number;
-    readonly initialState: State;
-    readonly commands: readonly Command[];
-    readonly step: Scenario<State, Command, Event, Generator>['step'];
-    readonly status?: Scenario<State, Command, Event, Generator>['status'];
-}
-export interface HeadlessScenarioResult<State, Event> extends ScenarioResult<State, Event> {
-    readonly seed: number;
-    readonly random: readonly [number, number, number, number];
-}
-/**
- * Execute a deterministic scenario without a renderer, returning state, outputs and RNG state for CI.
- * @example
- * ```ts
- * import { runHeadlessScenario } from '@datamoc/mw_games/simulation';
- * const result = runHeadlessScenario({
- *   seed: 7, initialState: { score: 0 }, commands: [1],
- *   step: (state, command) => ({ state: { score: state.score + command }, events: [], status: 'ready' }),
- * });
- * ```
- */
-export declare function runHeadlessScenario<State, Command, Event>(scenario: HeadlessScenario<State, Command, Event>): HeadlessScenarioResult<State, Event>;
-//# sourceMappingURL=Harness.d.ts.map

package/dist/simulation/Harness.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Harness.d.ts","sourceRoot":"","sources":["../../src/simulation/Harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAe,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAGhF,MAAM,WAAW,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAE,SAAQ,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EACxD,QAAQ,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,GAC/C,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,CAUtC"}

package/dist/simulation/Harness.js

@@ -1,26 +0,0 @@
-import { Generator } from '../core/Random.js';
-import { runScenario } from './Scenario.js';
-import { cloneData } from '../core/Clone.js';
-/**
- * Execute a deterministic scenario without a renderer, returning state, outputs and RNG state for CI.
- * @example
- * ```ts
- * import { runHeadlessScenario } from '@datamoc/mw_games/simulation';
- * const result = runHeadlessScenario({
- *   seed: 7, initialState: { score: 0 }, commands: [1],
- *   step: (state, command) => ({ state: { score: state.score + command }, events: [], status: 'ready' }),
- * });
- * ```
- */
-export function runHeadlessScenario(scenario) {
-    const random = new Generator(scenario.seed);
-    const result = runScenario({
-        state: cloneData(scenario.initialState, 'initialState'),
-        commands: scenario.commands,
-        status: scenario.status,
-        random,
-        step: scenario.step,
-    });
-    return { ...result, seed: scenario.seed, random: random.getState() };
-}
-//# sourceMappingURL=Harness.js.map

package/dist/simulation/Harness.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Harness.js","sourceRoot":"","sources":["../../src/simulation/Harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAsC,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAe7C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAClC,QAAiD;IAEjD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,WAAW,CAAC;QAC1B,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;QACvD,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,MAAM;QACN,IAAI,EAAE,QAAQ,CAAC,IAAI;KACnB,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AACtE,CAAC"}

package/dist/simulation/Runtime.d.ts

@@ -1,189 +0,0 @@
-import { Generator } from '../core/Random.ts';
-import { ActionJournal, type ActionJournalEntry } from '../core/ActionJournal.ts';
-import { type UndoHistoryOptions } from '../core/UndoHistory.ts';
-import { Scheduler, type Actor, type SchedulerSnapshot } from '../roguelike/Scheduler.ts';
-import type { SimulationStatus } from './Scenario.ts';
-/** What a rule receives besides state and command: the two sources of non-determinism a
- * simulation must route explicitly rather than reach for globally. */
-export interface SimulationContext<A extends Actor> {
-    readonly random: Generator;
-    readonly scheduler: Scheduler<A>;
-}
-export interface SimulationOutcome<State, Event> {
-    state: State;
-    events: readonly Event[];
-    status: SimulationStatus;
-    /** time this command cost its actor at speed 1, charged via `scheduler.spend`; omit or
-     * null for a command that does not consume a scheduler turn (a menu action, a query). */
-    cost?: number | null;
-}
-export type SimulationRuntimeRule<State, Command, Event, A extends Actor> = (state: State, command: Command, context: SimulationContext<A>) => SimulationOutcome<State, Event>;
-/** The logical state a game needs to resume a run bit-for-bit: not the storage format
- * (`core.SaveSystem` owns that), but what it wraps. */
-export interface SimulationSnapshot<State> {
-    version: number;
-    state: State;
-    scheduler: SchedulerSnapshot;
-    random: readonly [number, number, number, number];
-    /** Commands already committed, retained for replay, undo checkpoints, and diagnostics. */
-    readonly journal?: readonly ActionJournalEntry<unknown, unknown>[];
-}
-export interface SimulationReplayMismatch<Command, Event> {
-    readonly index: number;
-    readonly action: Command;
-    readonly expectedEvents: readonly Event[];
-    readonly actualEvents: readonly Event[];
-    readonly reason: 'sequence' | 'events' | 'execution' | 'final-state';
-    readonly error?: string;
-}
-export interface SimulationReplayResult<State, Command, Event> {
-    readonly valid: boolean;
-    readonly checked: number;
-    readonly state: State;
-    readonly journal: readonly ActionJournalEntry<Command, Event>[];
-    readonly mismatch?: SimulationReplayMismatch<Command, Event>;
-}
-export interface SimulationRuntimeHistoryOptions<A extends Actor = Actor> extends UndoHistoryOptions {
-    /** Resolves scheduler actor ids when an undo or redo restores a checkpoint. */
-    readonly actorOf: (id: string) => A;
-}
-/**
- * Replays a journal from an initial snapshot and compares deterministic event batches. The
- * initial snapshot is treated as a checkpoint, so any journal it carries is ignored. An optional
- * final-state check catches rules that changed state without emitting an event.
- *
- * @example
- * ```ts
- * import { validateSimulationReplay, type SimulationRuntimeRule, type SimulationSnapshot } from '@datamoc/mw_games/simulation';
- * import type { ActionJournalEntry } from '@datamoc/mw_games/core';
- * import type { Actor } from '@datamoc/mw_games/roguelike';
- *
- * declare const initialSnapshot: SimulationSnapshot<unknown>;
- * declare const recordedJournal: readonly ActionJournalEntry<unknown, unknown>[];
- * declare const rule: SimulationRuntimeRule<unknown, unknown, unknown, Actor>;
- * declare const actorOf: (id: string) => Actor;
- * declare const actorId: (actor: Actor) => string;
- * const result = validateSimulationReplay(initialSnapshot, recordedJournal, {
- *   rule, actorOf, actorId,
- * });
- * if (!result.valid) console.error('replay diverged at', result.mismatch?.index);
- * ```
- */
-export declare function validateSimulationReplay<State, Command, Event, A extends Actor>(initial: SimulationSnapshot<State>, entries: readonly ActionJournalEntry<Command, Event>[], options: {
-    rule: SimulationRuntimeRule<State, Command, Event, A>;
-    actorOf: (id: string) => A;
-    actorId: (actor: A) => string;
-    expectedFinalState?: State;
-}): SimulationReplayResult<State, Command, Event>;
-/**
- * A small facade over one state + one scheduler + one RNG, for the interactive half of a
- * turn-based simulation: the command a player just issued, dispatched through the game's own
- * rule. `advanceToInput`/`runScenario` (`simulation/Turns.ts`/`Scenario.ts`) still cover the
- * automatic-actor loop and fixed-command replay respectively; a game composes both against
- * the same `scheduler` rather than choosing one over the other.
- *
- * Every command and event batch is journalled (pass `journal: null` to disable the journal
- * entirely: `dispatch` then skips the append, `snapshot()` exposes an empty journal, and
- * replay/undo have nothing to replay), and with `history` every committed state is
- * checkpointed, all through `structuredClone`: `Command`, `Event` and `State` must be plain data.
- * A command naming its target as a live actor object (one that owns a `ReactionTable`, or any
- * other callback) cannot be copied, so carry the actor's id and resolve it in the rule. A
- * `dispatch` whose command, events or checkpoint cannot be copied throws a `TypeError` naming
- * the offending path and commits nothing: state, scheduler, random stream and journal stay as
- * they were before the call. The type system cannot enforce this, since a class instance with
- * methods is perfectly cloneable while a plain object with one function field is not.
- *
- * @example
- * ```ts
- * import { SimulationRuntime, type SimulationRuntimeRule } from '@datamoc/mw_games/simulation';
- * import { Scheduler, type Actor } from '@datamoc/mw_games/roguelike';
- * import { Generator } from '@datamoc/mw_games/core';
- *
- * interface Fighter extends Actor { id: string; hp: number }
- * type State = { hero: Fighter; rat: Fighter };
- * type Command = 'attack';
- * type Event = { type: 'damage'; targetId: string; amount: number };
- *
- * const rule: SimulationRuntimeRule<State, Command, Event, Fighter> = (state, _cmd, { random }) => {
- *   const amount = random.int(3) + 1;
- *   const rat = { ...state.rat, hp: state.rat.hp - amount };
- *   const next = { ...state, rat };
- *   return { state: next, events: [{ type: 'damage', targetId: rat.id, amount }], status: 'ready', cost: 1 };
- * };
- *
- * const hero: Fighter = { id: 'hero', hp: 10 };
- * const rat: Fighter = { id: 'rat', hp: 5 };
- * const scheduler = new Scheduler<Fighter>();
- * scheduler.add(hero);
- * scheduler.add(rat);
- *
- * const runtime = new SimulationRuntime<State, Command, Event, Fighter>({
- *   state: { hero, rat },
- *   scheduler,
- *   random: new Generator(1),
- *   rule,
- *   actorId: (fighter) => fighter.id,
- * });
- *
- * const { events } = runtime.dispatch('attack');
- * ```
- */
-export declare class SimulationRuntime<State, Command, Event, A extends Actor> {
-    private _state;
-    private _scheduler;
-    readonly random: Generator;
-    readonly journal: ActionJournal<Command, Event>;
-    private readonly recordJournal;
-    private readonly rule;
-    private readonly actorId;
-    private readonly history;
-    private readonly actorOf;
-    constructor(options: {
-        state: State;
-        scheduler: Scheduler<A>;
-        random: Generator;
-        rule: SimulationRuntimeRule<State, Command, Event, A>;
-        actorId: (actor: A) => string;
-        /**
-         * Where committed commands are recorded. Pass `null` for a journal-free
-         * dispatch facade: no append (and no `structuredClone` cost),
-         * `snapshot()` carries an empty journal, and replay/undo have nothing
-         * to replay. `restore()` always resumes with recording enabled from
-         * the snapshot's journal.
-         */
-        journal?: ActionJournal<Command, Event> | null;
-        history?: SimulationRuntimeHistoryOptions<A>;
-    });
-    get scheduler(): Scheduler<A>;
-    get state(): State;
-    /** Runs one command through the rule, commits the resulting state, and charges its cost
-     * to the scheduler's current actor when one is given. */
-    dispatch(command: Command): SimulationOutcome<State, Event>;
-    get canUndo(): boolean;
-    get canRedo(): boolean;
-    /** Restores the previous committed simulation checkpoint, or null when undo is disabled. */
-    undo(): SimulationSnapshot<State> | null;
-    /** Restores the next checkpoint after an undo, or null when no redo is available. */
-    redo(): SimulationSnapshot<State> | null;
-    snapshot(version?: number): SimulationSnapshot<State>;
-    /**
-     * Rebuilds a runtime from a snapshot taken by `snapshot()`. The caller supplies
-     * `actorOf` to resolve the scheduler's ids back to live actor objects, the same way
-     * `Scheduler.restore` does - the runtime has no identity primitive of its own to lean on.
-     */
-    static restore<State, Command, Event, A extends Actor>(snapshot: SimulationSnapshot<State>, options: {
-        rule: SimulationRuntimeRule<State, Command, Event, A>;
-        actorOf: (id: string) => A;
-        actorId: (actor: A) => string;
-        /**
-         * Adopt this generator instead of creating one: its state is set from
-         * the snapshot, so passing the ambient global generator reconciles the
-         * two streams and later draws stay in lockstep. Defaults to a new generator.
-         */
-        random?: Generator;
-    }): SimulationRuntime<State, Command, Event, A>;
-    /** `snapshot()` already copies the scheduler, random state and journal; only state is live. */
-    private historySnapshot;
-    private restoreCheckpoint;
-}
-//# sourceMappingURL=Runtime.d.ts.map

package/dist/simulation/Runtime.d.ts.map

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

package/dist/simulation/Runtime.js

@@ -1,244 +0,0 @@
-import { Generator } from '../core/Random.js';
-import { ActionJournal } from '../core/ActionJournal.js';
-import { cloneData } from '../core/Clone.js';
-import { stateChecksum } from '../core/SyncGuard.js';
-import { UndoHistory } from '../core/UndoHistory.js';
-import { Scheduler } from '../roguelike/Scheduler.js';
-/**
- * Replays a journal from an initial snapshot and compares deterministic event batches. The
- * initial snapshot is treated as a checkpoint, so any journal it carries is ignored. An optional
- * final-state check catches rules that changed state without emitting an event.
- *
- * @example
- * ```ts
- * import { validateSimulationReplay, type SimulationRuntimeRule, type SimulationSnapshot } from '@datamoc/mw_games/simulation';
- * import type { ActionJournalEntry } from '@datamoc/mw_games/core';
- * import type { Actor } from '@datamoc/mw_games/roguelike';
- *
- * declare const initialSnapshot: SimulationSnapshot<unknown>;
- * declare const recordedJournal: readonly ActionJournalEntry<unknown, unknown>[];
- * declare const rule: SimulationRuntimeRule<unknown, unknown, unknown, Actor>;
- * declare const actorOf: (id: string) => Actor;
- * declare const actorId: (actor: Actor) => string;
- * const result = validateSimulationReplay(initialSnapshot, recordedJournal, {
- *   rule, actorOf, actorId,
- * });
- * if (!result.valid) console.error('replay diverged at', result.mismatch?.index);
- * ```
- */
-export function validateSimulationReplay(initial, entries, options) {
-    const runtime = SimulationRuntime.restore({ ...initial, journal: [] }, options);
-    const failed = (value) => ({
-        valid: false,
-        checked: value.index,
-        state: runtime.state,
-        journal: runtime.journal.toJSON(),
-        mismatch: value,
-    });
-    for (let index = 0; index < entries.length; index++) {
-        const entry = entries[index];
-        if (entry.sequence !== index)
-            return failed({
-                index,
-                action: entry.action,
-                expectedEvents: entry.events,
-                actualEvents: [],
-                reason: 'sequence',
-            });
-        let outcome;
-        try {
-            outcome = runtime.dispatch(entry.action);
-        }
-        catch (error) {
-            return failed({
-                index,
-                action: entry.action,
-                expectedEvents: entry.events,
-                actualEvents: [],
-                reason: 'execution',
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-        if (stateChecksum(outcome.events) !== stateChecksum(entry.events))
-            return failed({
-                index,
-                action: entry.action,
-                expectedEvents: entry.events,
-                actualEvents: outcome.events,
-                reason: 'events',
-            });
-    }
-    if (options.expectedFinalState !== undefined &&
-        stateChecksum(runtime.state) !== stateChecksum(options.expectedFinalState))
-        return failed({
-            index: entries.length,
-            action: entries.at(-1)?.action,
-            expectedEvents: [],
-            actualEvents: [],
-            reason: 'final-state',
-        });
-    return { valid: true, checked: entries.length, state: runtime.state, journal: runtime.journal.toJSON() };
-}
-/**
- * A small facade over one state + one scheduler + one RNG, for the interactive half of a
- * turn-based simulation: the command a player just issued, dispatched through the game's own
- * rule. `advanceToInput`/`runScenario` (`simulation/Turns.ts`/`Scenario.ts`) still cover the
- * automatic-actor loop and fixed-command replay respectively; a game composes both against
- * the same `scheduler` rather than choosing one over the other.
- *
- * Every command and event batch is journalled (pass `journal: null` to disable the journal
- * entirely: `dispatch` then skips the append, `snapshot()` exposes an empty journal, and
- * replay/undo have nothing to replay), and with `history` every committed state is
- * checkpointed, all through `structuredClone`: `Command`, `Event` and `State` must be plain data.
- * A command naming its target as a live actor object (one that owns a `ReactionTable`, or any
- * other callback) cannot be copied, so carry the actor's id and resolve it in the rule. A
- * `dispatch` whose command, events or checkpoint cannot be copied throws a `TypeError` naming
- * the offending path and commits nothing: state, scheduler, random stream and journal stay as
- * they were before the call. The type system cannot enforce this, since a class instance with
- * methods is perfectly cloneable while a plain object with one function field is not.
- *
- * @example
- * ```ts
- * import { SimulationRuntime, type SimulationRuntimeRule } from '@datamoc/mw_games/simulation';
- * import { Scheduler, type Actor } from '@datamoc/mw_games/roguelike';
- * import { Generator } from '@datamoc/mw_games/core';
- *
- * interface Fighter extends Actor { id: string; hp: number }
- * type State = { hero: Fighter; rat: Fighter };
- * type Command = 'attack';
- * type Event = { type: 'damage'; targetId: string; amount: number };
- *
- * const rule: SimulationRuntimeRule<State, Command, Event, Fighter> = (state, _cmd, { random }) => {
- *   const amount = random.int(3) + 1;
- *   const rat = { ...state.rat, hp: state.rat.hp - amount };
- *   const next = { ...state, rat };
- *   return { state: next, events: [{ type: 'damage', targetId: rat.id, amount }], status: 'ready', cost: 1 };
- * };
- *
- * const hero: Fighter = { id: 'hero', hp: 10 };
- * const rat: Fighter = { id: 'rat', hp: 5 };
- * const scheduler = new Scheduler<Fighter>();
- * scheduler.add(hero);
- * scheduler.add(rat);
- *
- * const runtime = new SimulationRuntime<State, Command, Event, Fighter>({
- *   state: { hero, rat },
- *   scheduler,
- *   random: new Generator(1),
- *   rule,
- *   actorId: (fighter) => fighter.id,
- * });
- *
- * const { events } = runtime.dispatch('attack');
- * ```
- */
-export class SimulationRuntime {
-    constructor(options) {
-        this._state = options.state;
-        this._scheduler = options.scheduler;
-        this.random = options.random;
-        this.rule = options.rule;
-        this.actorId = options.actorId;
-        this.recordJournal = options.journal !== null;
-        this.journal = options.journal ?? new ActionJournal();
-        this.actorOf = options.history?.actorOf ?? null;
-        this.history = options.history ? new UndoHistory(options.history) : null;
-        if (this.history)
-            this.history.push(this.historySnapshot());
-    }
-    get scheduler() {
-        return this._scheduler;
-    }
-    get state() {
-        return this._state;
-    }
-    /** Runs one command through the rule, commits the resulting state, and charges its cost
-     * to the scheduler's current actor when one is given. */
-    dispatch(command) {
-        const random = this.random.getState();
-        const outcome = this.rule(this._state, command, { random: this.random, scheduler: this._scheduler });
-        let checkpoint;
-        try {
-            checkpoint = this.history ? cloneData(outcome.state, 'state') : null;
-            // Last fallible step, so a refused command or event batch leaves the journal unchanged.
-            if (this.recordJournal)
-                this.journal.append(command, outcome.events);
-        }
-        catch (error) {
-            this.random.setState(random);
-            throw error;
-        }
-        this._state = outcome.state;
-        if (outcome.cost != null)
-            this._scheduler.spend(outcome.cost);
-        if (this.history)
-            this.history.push(this.historySnapshot(checkpoint));
-        return outcome;
-    }
-    get canUndo() {
-        return this.history?.canUndo ?? false;
-    }
-    get canRedo() {
-        return this.history?.canRedo ?? false;
-    }
-    /** Restores the previous committed simulation checkpoint, or null when undo is disabled. */
-    undo() {
-        if (!this.history || !this.actorOf)
-            return null;
-        const snapshot = this.history.undo();
-        if (!snapshot)
-            return null;
-        this.restoreCheckpoint(snapshot);
-        return this.snapshot();
-    }
-    /** Restores the next checkpoint after an undo, or null when no redo is available. */
-    redo() {
-        if (!this.history || !this.actorOf)
-            return null;
-        const snapshot = this.history.redo();
-        if (!snapshot)
-            return null;
-        this.restoreCheckpoint(snapshot);
-        return this.snapshot();
-    }
-    snapshot(version = 1) {
-        return {
-            version,
-            state: this._state,
-            scheduler: this.scheduler.toJSON(this.actorId),
-            random: this.random.getState(),
-            journal: this.journal.toJSON(),
-        };
-    }
-    /**
-     * Rebuilds a runtime from a snapshot taken by `snapshot()`. The caller supplies
-     * `actorOf` to resolve the scheduler's ids back to live actor objects, the same way
-     * `Scheduler.restore` does - the runtime has no identity primitive of its own to lean on.
-     */
-    static restore(snapshot, options) {
-        const random = options.random ?? new Generator();
-        random.setState(snapshot.random);
-        const scheduler = Scheduler.restore(snapshot.scheduler, options.actorOf);
-        return new SimulationRuntime({
-            state: snapshot.state,
-            scheduler,
-            random,
-            journal: ActionJournal.fromJSON((snapshot.journal ?? [])),
-            rule: options.rule,
-            actorId: options.actorId,
-        });
-    }
-    /** `snapshot()` already copies the scheduler, random state and journal; only state is live. */
-    historySnapshot(state = cloneData(this._state, 'state')) {
-        return { ...this.snapshot(), state };
-    }
-    restoreCheckpoint(snapshot) {
-        if (!this.actorOf)
-            throw new Error('simulation history needs actorOf to restore a checkpoint');
-        this._state = structuredClone(snapshot.state);
-        this._scheduler = Scheduler.restore(snapshot.scheduler, this.actorOf);
-        this.random.setState(snapshot.random);
-        this.journal.replace((snapshot.journal ?? []));
-    }
-}
-//# sourceMappingURL=Runtime.js.map

package/dist/simulation/Runtime.js.map

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

package/dist/simulation/Scenario.d.ts

@@ -1,44 +0,0 @@
-export type SimulationStatus = 'ready' | 'finished';
-export interface SimulationStep<State, Event> {
-    state: State;
-    events: readonly Event[];
-    status: SimulationStatus;
-}
-/** The game owns state, rules, event types, and the random-source interface. */
-export type SimulationRule<State, Command, Event, Random> = (state: State, command: Command, random: Random) => SimulationStep<State, Event>;
-export interface Scenario<State, Command, Event, Random> {
-    state: State;
-    /** Finite command sequence; automatic work inside a rule needs its own budget. */
-    commands: readonly Command[];
-    random: Random;
-    step: SimulationRule<State, Command, Event, Random>;
-    /** Use finished when resuming an already terminal snapshot. */
-    status?: SimulationStatus;
-}
-export interface ScenarioResult<State, Event> extends SimulationStep<State, Event> {
-    processedCommands: number;
-}
-/**
- * Run commands without frames, input devices, or rendering, collecting ordered events.
- * The random object is passed through unchanged. Reproducibility requires identical
- * initial state, random state, commands, and rules that use only those inputs.
- * No cloning or rollback is implicit: mutable rules and throwing rules remain the game's
- * responsibility. Persist a game's snapshot and random state together to resume a run.
- *
- * @example
- * ```ts
- * import { runScenario, type SimulationRule } from '@datamoc/mw_games/simulation';
- * import { Generator } from '@datamoc/mw_games/core';
- *
- * type State = { hp: number };
- * const step: SimulationRule<State, 'attack', { damage: number }, Generator> = (state, _cmd, rng) => {
- *   const damage = rng.int(3) + 1;
- *   const hp = state.hp - damage;
- *   return { state: { hp }, events: [{ damage }], status: hp <= 0 ? 'finished' : 'ready' };
- * };
- *
- * const result = runScenario({ state: { hp: 10 }, commands: ['attack', 'attack'], random: new Generator(1), step });
- * ```
- */
-export declare function runScenario<State, Command, Event, Random>(scenario: Scenario<State, Command, Event, Random>): ScenarioResult<State, Event>;
-//# sourceMappingURL=Scenario.d.ts.map

package/dist/simulation/Scenario.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Scenario.d.ts","sourceRoot":"","sources":["../../src/simulation/Scenario.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,CAAC;AAEpD,MAAM,WAAW,cAAc,CAAC,KAAK,EAAE,KAAK;IAC3C,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;CACzB;AAED,gFAAgF;AAChF,MAAM,MAAM,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAC3D,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,KACV,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAElC,MAAM,WAAW,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;IACtD,KAAK,EAAE,KAAK,CAAC;IACb,kFAAkF;IAClF,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACpD,+DAA+D;IAC/D,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc,CAAC,KAAK,EAAE,KAAK,CAAE,SAAQ,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC;IACjF,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EACxD,QAAQ,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,GAC/C,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAc9B"}

package/dist/simulation/Scenario.js

@@ -1,40 +0,0 @@
-/**
- * Run commands without frames, input devices, or rendering, collecting ordered events.
- * The random object is passed through unchanged. Reproducibility requires identical
- * initial state, random state, commands, and rules that use only those inputs.
- * No cloning or rollback is implicit: mutable rules and throwing rules remain the game's
- * responsibility. Persist a game's snapshot and random state together to resume a run.
- *
- * @example
- * ```ts
- * import { runScenario, type SimulationRule } from '@datamoc/mw_games/simulation';
- * import { Generator } from '@datamoc/mw_games/core';
- *
- * type State = { hp: number };
- * const step: SimulationRule<State, 'attack', { damage: number }, Generator> = (state, _cmd, rng) => {
- *   const damage = rng.int(3) + 1;
- *   const hp = state.hp - damage;
- *   return { state: { hp }, events: [{ damage }], status: hp <= 0 ? 'finished' : 'ready' };
- * };
- *
- * const result = runScenario({ state: { hp: 10 }, commands: ['attack', 'attack'], random: new Generator(1), step });
- * ```
- */
-export function runScenario(scenario) {
-    let state = scenario.state;
-    let status = scenario.status ?? 'ready';
-    const events = [];
-    let processedCommands = 0;
-    for (const command of scenario.commands) {
-        if (status === 'finished')
-            break;
-        const next = scenario.step(state, command, scenario.random);
-        state = next.state;
-        status = next.status;
-        for (const event of next.events)
-            events.push(event);
-        processedCommands++;
-    }
-    return { state, events, status, processedCommands };
-}
-//# sourceMappingURL=Scenario.js.map

package/dist/simulation/Scenario.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Scenario.js","sourceRoot":"","sources":["../../src/simulation/Scenario.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,WAAW,CAC1B,QAAiD;IAEjD,IAAI,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC3B,IAAI,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC;IACxC,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACzC,IAAI,MAAM,KAAK,UAAU;YAAE,MAAM;QACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5D,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACnB,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpD,iBAAiB,EAAE,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;AACrD,CAAC"}