@datamoc/mw_games 0.43.0 → 0.45.0

package/dist/core/State.js

@@ -1,177 +0,0 @@
-import { cloneData } from './Clone.js';
-/**
- * A single JSON-safe source of truth for a game's logical state. The root value belongs to the
- * game, while framework or game subsystems register independent versioned extensions beside it.
- * Reads and writes clone values, so a renderer cannot mutate authoritative state accidentally.
- *
- * @example
- * ```ts
- * import { CanonicalState } from '@datamoc/mw_games/core';
- *
- * const state = new CanonicalState({ turn: 1, gold: 10 });
- * state.update((current) => ({ ...current, gold: current.gold - 3 }));
- * const save = state.snapshot();
- * state.restore(save);
- * ```
- */
-export class CanonicalState {
-    constructor(initial, options = {}) {
-        this._state = cloneData(initial, 'initial state');
-        this.version = options.version ?? 1;
-        this.migrations = options.migrations ?? {};
-        this.extensions = options.extensions ?? new StateRegistry();
-    }
-    get state() {
-        return structuredClone(this._state);
-    }
-    set(next) {
-        this._state = cloneData(next, 'state');
-    }
-    update(transform) {
-        const next = transform(this.state);
-        this.set(next);
-        return this.state;
-    }
-    snapshot() {
-        const extensions = this.extensions.snapshot();
-        return {
-            version: this.version,
-            state: this.state,
-            extensions: extensions.extensions,
-            extensionVersions: extensions.versions,
-        };
-    }
-    restore(snapshot, options = {}) {
-        if (!Number.isSafeInteger(snapshot.version) || snapshot.version < 1)
-            throw new Error('canonical state snapshot version must be a positive integer');
-        if (snapshot.version > this.version)
-            throw new Error(`canonical state snapshot version ${snapshot.version} is newer than ${this.version}`);
-        const before = this.snapshot();
-        try {
-            let state = cloneData(snapshot.state, 'snapshot.state');
-            for (let version = snapshot.version; version < this.version; version++) {
-                const migration = this.migrations[version + 1];
-                if (!migration)
-                    throw new Error(`missing canonical state migration to version ${version + 1}`);
-                state = migration(state);
-            }
-            this._state = cloneData(state, 'migrated state');
-            return this.extensions.restore({ extensions: snapshot.extensions, versions: snapshot.extensionVersions }, options);
-        }
-        catch (error) {
-            this._state = structuredClone(before.state);
-            this.extensions.restore({ extensions: before.extensions, versions: before.extensionVersions }, { missing: 'keep' });
-            throw error;
-        }
-    }
-    transaction(work) {
-        const before = this.snapshot();
-        try {
-            return work(this);
-        }
-        catch (error) {
-            this.restore(before);
-            throw error;
-        }
-    }
-}
-/**
- * Coordinates game-owned save state without knowing its schema.
- *
- * Each extension owns its data and restore logic. `transaction` captures all registered
- * extensions before running work and restores that snapshot if work throws, which prevents
- * half-applied saves when one subsystem rejects an update.
- *
- * @example
- * ```ts
- * import { StateRegistry } from '@datamoc/mw_games/core';
- *
- * let inventory = { gold: 10 };
- * const state = new StateRegistry();
- * state.register({ id: 'inventory', capture: () => inventory, restore: (saved) => { inventory = saved; } });
- * state.transaction(() => { inventory.gold -= 5; });
- * const save = state.snapshot();
- * ```
- */
-export class StateRegistry {
-    constructor() {
-        this.extensions = new Map();
-    }
-    register(extension) {
-        if (!/^[A-Za-z_][A-Za-z0-9_.-]*$/.test(extension.id))
-            throw new Error(`invalid state extension id: ${extension.id}`);
-        if (this.extensions.has(extension.id))
-            throw new Error(`state extension already registered: ${extension.id}`);
-        this.extensions.set(extension.id, {
-            id: extension.id,
-            capture: () => extension.capture(),
-            restore: (state) => extension.restore(state),
-            version: extension.version ?? 1,
-            migrations: extension.migrations,
-            reset: extension.reset,
-            remove: extension.remove,
-        });
-        return () => this.extensions.delete(extension.id);
-    }
-    snapshot() {
-        const extensions = {};
-        for (const [id, extension] of this.extensions)
-            extensions[id] = cloneData(extension.capture(), `extension ${id}`);
-        const versions = {};
-        for (const [id, extension] of this.extensions)
-            versions[id] = extension.version ?? 1;
-        return { extensions, versions };
-    }
-    restore(snapshot, options = {}) {
-        const before = this.snapshot();
-        const diagnostics = [];
-        try {
-            for (const [id, extension] of this.extensions) {
-                if (!(id in snapshot.extensions)) {
-                    if (options.missing === 'reset') {
-                        if (extension.reset)
-                            extension.reset();
-                        diagnostics.push({ extension: id, from: 0, to: extension.version ?? 1, status: 'reset' });
-                    }
-                    else if (options.missing === 'remove') {
-                        if (extension.remove)
-                            extension.remove();
-                        diagnostics.push({ extension: id, from: 0, to: extension.version ?? 1, status: 'removed' });
-                    }
-                    continue;
-                }
-                const from = snapshot.versions?.[id] ?? 1;
-                const to = extension.version ?? 1;
-                let state = cloneData(snapshot.extensions[id], `snapshot.extensions.${id}`);
-                for (let version = from; version < to; version++) {
-                    const migration = extension.migrations?.[version + 1];
-                    if (!migration)
-                        throw new Error(`missing state migration for ${id} to version ${version + 1}`);
-                    state = migration(state);
-                }
-                extension.restore(cloneData(state, `migrated extension ${id}`));
-                diagnostics.push({ extension: id, from, to, status: from === to ? 'unchanged' : 'migrated' });
-            }
-        }
-        catch (error) {
-            for (const [id, extension] of this.extensions)
-                if (id in before.extensions)
-                    extension.restore(structuredClone(before.extensions[id]));
-            throw error;
-        }
-        for (const diagnostic of diagnostics)
-            options.onDiagnostic?.(diagnostic);
-        return diagnostics;
-    }
-    transaction(work) {
-        const before = this.snapshot();
-        try {
-            return work();
-        }
-        catch (error) {
-            this.restore(before);
-            throw error;
-        }
-    }
-}
-//# sourceMappingURL=State.js.map

package/dist/core/State.js.map

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

package/dist/core/Stats.d.ts

@@ -1,46 +0,0 @@
-import { type SaveStorage } from './Save.ts';
-export interface PlayerStatsOptions<T, S = T> {
-    /** namespaces the stored total, so two games sharing an origin never collide */
-    namespace: string;
-    storage?: SaveStorage;
-    /** the total before anything has ever been recorded */
-    initial: T;
-    /** folds one run's own summary into the running total */
-    combine: (total: T, summary: S) => T;
-}
-/**
- * A lifetime running total, folded in one run at a time - distinct from `RunHistory`, which
- * keeps individual runs and may drop the oldest ones once its own `limit` is reached.
- * Deriving a lifetime total by reducing over `RunHistory.all()` would silently undercount the
- * moment that limit trims anything, so this keeps its own persisted total instead, updated
- * incrementally by `record` and never recomputed from a list that can shrink. A game wanting
- * both a "last 50 runs" list and a true lifetime total uses both classes side by side, each
- * for the question it actually answers.
- *
- * @example
- * ```ts
- * import { PlayerStats } from '@datamoc/mw_games/core';
- *
- * const lifetimeKills = new PlayerStats<number, number>({
- *   namespace: 'my-game',
- *   initial: 0,
- *   combine: (total, killsThisRun) => total + killsThisRun,
- * });
- *
- * lifetimeKills.record(12); // this run's own kill count folds into the total
- * console.log(lifetimeKills.get());
- * ```
- */
-export declare class PlayerStats<T, S = T> {
-    private readonly store;
-    private readonly initial;
-    private readonly combine;
-    constructor(options: PlayerStatsOptions<T, S>);
-    /** the current lifetime total, `initial` if nothing has been recorded yet */
-    get(): T;
-    /** folds `summary` into the running total and persists it, returning the new total */
-    record(summary: S): T;
-    /** back to `initial`, as a new save file or a "reset stats" option should */
-    reset(): void;
-}
-//# sourceMappingURL=Stats.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Stats.d.ts","sourceRoot":"","sources":["../../src/core/Stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7D,MAAM,WAAW,kBAAkB,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC;IAC3C,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,uDAAuD;IACvD,OAAO,EAAE,CAAC,CAAC;IACX,yDAAyD;IACzD,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,WAAW,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAI;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IAEtD,YAAY,OAAO,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EAI5C;IAED,6EAA6E;IAC7E,GAAG,IAAI,CAAC,CAEP;IAED,sFAAsF;IACtF,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAIpB;IAED,6EAA6E;IAC7E,KAAK,IAAI,IAAI,CAEZ;CACD"}

package/dist/core/Stats.js

@@ -1,47 +0,0 @@
-import { defaultStorage } from './Save.js';
-import { StoredValue } from './StoredValue.js';
-/**
- * A lifetime running total, folded in one run at a time - distinct from `RunHistory`, which
- * keeps individual runs and may drop the oldest ones once its own `limit` is reached.
- * Deriving a lifetime total by reducing over `RunHistory.all()` would silently undercount the
- * moment that limit trims anything, so this keeps its own persisted total instead, updated
- * incrementally by `record` and never recomputed from a list that can shrink. A game wanting
- * both a "last 50 runs" list and a true lifetime total uses both classes side by side, each
- * for the question it actually answers.
- *
- * @example
- * ```ts
- * import { PlayerStats } from '@datamoc/mw_games/core';
- *
- * const lifetimeKills = new PlayerStats<number, number>({
- *   namespace: 'my-game',
- *   initial: 0,
- *   combine: (total, killsThisRun) => total + killsThisRun,
- * });
- *
- * lifetimeKills.record(12); // this run's own kill count folds into the total
- * console.log(lifetimeKills.get());
- * ```
- */
-export class PlayerStats {
-    constructor(options) {
-        this.store = new StoredValue(options.storage ?? defaultStorage(), `mwg-stats:${options.namespace}`);
-        this.initial = options.initial;
-        this.combine = options.combine;
-    }
-    /** the current lifetime total, `initial` if nothing has been recorded yet */
-    get() {
-        return this.store.read(this.initial);
-    }
-    /** folds `summary` into the running total and persists it, returning the new total */
-    record(summary) {
-        const next = this.combine(this.get(), summary);
-        this.store.write(next);
-        return next;
-    }
-    /** back to `initial`, as a new save file or a "reset stats" option should */
-    reset() {
-        this.store.remove();
-    }
-}
-//# sourceMappingURL=Stats.js.map

package/dist/core/Stats.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Stats.js","sourceRoot":"","sources":["../../src/core/Stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAoB,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAY/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,WAAW;IAKvB,YAAY,OAAiC;QAC5C,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAI,OAAO,CAAC,OAAO,IAAI,cAAc,EAAE,EAAE,aAAa,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QACvG,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,6EAA6E;IAC7E,GAAG;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,sFAAsF;IACtF,MAAM,CAAC,OAAU;QAChB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,6EAA6E;IAC7E,KAAK;QACJ,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACrB,CAAC;CACD"}

package/dist/core/StoredValue.d.ts

@@ -1,30 +0,0 @@
-import type { SaveStorage } from './Save.ts';
-/**
- * One JSON value under one storage key: the read-with-fallback / write / remove trio that
- * `PlayerStats`, `RunHistory` and `NewsSeenTracker` each hand-rolled, with slightly
- * different falsy-vs-null edges per copy. The one here treats any missing or empty read as
- * absent (the `raw ? ... : fallback` rule two of the three already followed); corrupt JSON
- * or a forbidden key throws a named error (`parseInbound`), since silently inventing a value would hide a real bug.
- *
- * Public so a game can keep its own progress (a level list, a best score) as structured JSON
- * under one key, with `defaultStorage()` as the storage. Multi-key shapes (`Collection`'s
- * prefix scan, `SaveSystem`'s slots) do not fit it and keep their own code.
- *
- * @example
- * ```ts
- * import { StoredValue, defaultStorage } from '@datamoc/mw_games/core';
- *
- * const progress = new StoredValue<{ solved: number[] }>(defaultStorage(), 'mygame.progress');
- * progress.write({ solved: [...progress.read({ solved: [] }).solved, 3] });
- * ```
- */
-export declare class StoredValue<T> {
-    private readonly storage;
-    private readonly key;
-    constructor(storage: SaveStorage, key: string);
-    /** the stored value, or `fallback` when nothing has been written yet */
-    read(fallback: T): T;
-    write(value: T): void;
-    remove(): void;
-}
-//# sourceMappingURL=StoredValue.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"StoredValue.d.ts","sourceRoot":"","sources":["../../src/core/StoredValue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAW,CAAC,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAE7B,YAAY,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAG5C;IAED,wEAAwE;IACxE,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAGnB;IAED,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAEpB;IAED,MAAM,IAAI,IAAI,CAEb;CACD"}

package/dist/core/StoredValue.js

@@ -1,38 +0,0 @@
-import { parseInbound } from './Sanitize.js';
-/**
- * One JSON value under one storage key: the read-with-fallback / write / remove trio that
- * `PlayerStats`, `RunHistory` and `NewsSeenTracker` each hand-rolled, with slightly
- * different falsy-vs-null edges per copy. The one here treats any missing or empty read as
- * absent (the `raw ? ... : fallback` rule two of the three already followed); corrupt JSON
- * or a forbidden key throws a named error (`parseInbound`), since silently inventing a value would hide a real bug.
- *
- * Public so a game can keep its own progress (a level list, a best score) as structured JSON
- * under one key, with `defaultStorage()` as the storage. Multi-key shapes (`Collection`'s
- * prefix scan, `SaveSystem`'s slots) do not fit it and keep their own code.
- *
- * @example
- * ```ts
- * import { StoredValue, defaultStorage } from '@datamoc/mw_games/core';
- *
- * const progress = new StoredValue<{ solved: number[] }>(defaultStorage(), 'mygame.progress');
- * progress.write({ solved: [...progress.read({ solved: [] }).solved, 3] });
- * ```
- */
-export class StoredValue {
-    constructor(storage, key) {
-        this.storage = storage;
-        this.key = key;
-    }
-    /** the stored value, or `fallback` when nothing has been written yet */
-    read(fallback) {
-        const raw = this.storage.read(this.key);
-        return raw ? parseInbound(raw, { label: `stored value "${this.key}"` }) : fallback;
-    }
-    write(value) {
-        this.storage.write(this.key, JSON.stringify(value));
-    }
-    remove() {
-        this.storage.remove(this.key);
-    }
-}
-//# sourceMappingURL=StoredValue.js.map

package/dist/core/StoredValue.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"StoredValue.js","sourceRoot":"","sources":["../../src/core/StoredValue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,WAAW;IAIvB,YAAY,OAAoB,EAAE,GAAW;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IAChB,CAAC;IAED,wEAAwE;IACxE,IAAI,CAAC,QAAW;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,GAAG,CAAC,CAAC,CAAE,YAAY,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,iBAAiB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC3F,CAAC;IAED,KAAK,CAAC,KAAQ;QACb,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,MAAM;QACL,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;CACD"}

package/dist/core/SyncGuard.d.ts

@@ -1,57 +0,0 @@
-/**
- * Out-of-sync detection for lockstep play: a deterministic checksum of JSON-serialisable state,
- * and a guard that compares the checksums peers compute for the same tick. `LockstepClient` moves
- * inputs between peers; this is how a game notices that the same inputs produced different state
- * on two of them, which lockstep cannot otherwise see - it never compares state, only inputs.
- *
- * A checksum is not security: it is a fast, stable hash that catches a divergence, not one that
- * resists an attacker. Its one real requirement is determinism across machines, so object keys are
- * sorted and the encoding is fixed rather than left to `JSON.stringify`'s engine-defined key order.
- */
-/**
- * A 32-bit FNV-1a checksum of a state value, stable across machines and across property order.
- *
- * @example
- * ```ts
- * import { stateChecksum } from '@datamoc/mw_games/core';
- *
- * // same state, whatever order the keys happen to be in
- * stateChecksum({ hp: 7, x: 2 }) === stateChecksum({ x: 2, hp: 7 }); // true
- * stateChecksum({ hp: 7 }) === stateChecksum({ hp: 6 }); // false
- * ```
- */
-export declare function stateChecksum(value: unknown): number;
-/**
- * Compares the checksum peers compute for each tick. The first checksum seen for a tick is taken
- * as the reference; a later observation of the same tick that disagrees marks the run divergent and
- * is remembered as the first such tick, so a game can report exactly where the two peers parted.
- *
- * @example
- * ```ts
- * import { SyncGuard, stateChecksum } from '@datamoc/mw_games/core';
- *
- * const localState = { hp: 7 };
- * const remoteState = { hp: 6 };
- *
- * const guard = new SyncGuard();
- * guard.observe(12, stateChecksum(localState)); // true
- * guard.observe(12, stateChecksum(remoteState)); // false if the two peers disagree
- * if (guard.divergent) console.log('desync at tick', guard.atTick);
- * ```
- */
-export declare class SyncGuard {
-    private readonly reference;
-    private desyncTick;
-    /**
-     * Records `checksum` for `tick`; true when it matches the tick's reference (or is the first
-     * one), false on the first disagreement, which is then remembered.
-     */
-    observe(tick: number, checksum: number): boolean;
-    /** true once any tick has disagreed */
-    get divergent(): boolean;
-    /** the first tick that disagreed, or null while the run is in sync */
-    get atTick(): number | null;
-    /** forgets every observation, for a new run */
-    reset(): void;
-}
-//# sourceMappingURL=SyncGuard.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"SyncGuard.d.ts","sourceRoot":"","sources":["../../src/core/SyncGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmCH;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQpD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,UAAU,CAAuB;IAEzC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAS/C;IAED,uCAAuC;IACvC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,sEAAsE;IACtE,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED,+CAA+C;IAC/C,KAAK,IAAI,IAAI,CAGZ;CACD"}

package/dist/core/SyncGuard.js

@@ -1,116 +0,0 @@
-/**
- * Out-of-sync detection for lockstep play: a deterministic checksum of JSON-serialisable state,
- * and a guard that compares the checksums peers compute for the same tick. `LockstepClient` moves
- * inputs between peers; this is how a game notices that the same inputs produced different state
- * on two of them, which lockstep cannot otherwise see - it never compares state, only inputs.
- *
- * A checksum is not security: it is a fast, stable hash that catches a divergence, not one that
- * resists an attacker. Its one real requirement is determinism across machines, so object keys are
- * sorted and the encoding is fixed rather than left to `JSON.stringify`'s engine-defined key order.
- */
-const FNV_OFFSET = 0x811c9dc5;
-const FNV_PRIME = 0x01000193;
-/**
- * A stable string encoding of a JSON-serialisable value, with object keys sorted so two
- * structurally equal values always encode identically regardless of insertion order. Values JSON
- * itself has no representation for (`undefined`, functions, symbols, `NaN`, infinities) follow
- * JSON's own rules: an object entry with one is omitted, an array element becomes `null`.
- */
-function canonical(value, inArray = false) {
-    if (value === null || value === undefined)
-        return 'null';
-    switch (typeof value) {
-        case 'boolean':
-            return value ? 'true' : 'false';
-        case 'number':
-            return Number.isFinite(value) ? String(value) : 'null';
-        case 'string':
-            return JSON.stringify(value);
-        case 'bigint':
-            return JSON.stringify(value.toString());
-        case 'function':
-        case 'symbol':
-            return inArray ? 'null' : 'undefined';
-    }
-    if (Array.isArray(value))
-        return `[${value.map((entry) => canonical(entry, true)).join(',')}]`;
-    const entries = Object.entries(value)
-        .filter(([, entry]) => entry !== undefined && typeof entry !== 'function' && typeof entry !== 'symbol')
-        .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0));
-    return `{${entries.map(([key, entry]) => `${JSON.stringify(key)}:${canonical(entry)}`).join(',')}}`;
-}
-/**
- * A 32-bit FNV-1a checksum of a state value, stable across machines and across property order.
- *
- * @example
- * ```ts
- * import { stateChecksum } from '@datamoc/mw_games/core';
- *
- * // same state, whatever order the keys happen to be in
- * stateChecksum({ hp: 7, x: 2 }) === stateChecksum({ x: 2, hp: 7 }); // true
- * stateChecksum({ hp: 7 }) === stateChecksum({ hp: 6 }); // false
- * ```
- */
-export function stateChecksum(value) {
-    const text = canonical(value);
-    let hash = FNV_OFFSET;
-    for (let i = 0; i < text.length; i++) {
-        hash ^= text.charCodeAt(i);
-        hash = Math.imul(hash, FNV_PRIME) >>> 0;
-    }
-    return hash >>> 0;
-}
-/**
- * Compares the checksum peers compute for each tick. The first checksum seen for a tick is taken
- * as the reference; a later observation of the same tick that disagrees marks the run divergent and
- * is remembered as the first such tick, so a game can report exactly where the two peers parted.
- *
- * @example
- * ```ts
- * import { SyncGuard, stateChecksum } from '@datamoc/mw_games/core';
- *
- * const localState = { hp: 7 };
- * const remoteState = { hp: 6 };
- *
- * const guard = new SyncGuard();
- * guard.observe(12, stateChecksum(localState)); // true
- * guard.observe(12, stateChecksum(remoteState)); // false if the two peers disagree
- * if (guard.divergent) console.log('desync at tick', guard.atTick);
- * ```
- */
-export class SyncGuard {
-    constructor() {
-        this.reference = new Map();
-        this.desyncTick = null;
-    }
-    /**
-     * Records `checksum` for `tick`; true when it matches the tick's reference (or is the first
-     * one), false on the first disagreement, which is then remembered.
-     */
-    observe(tick, checksum) {
-        const expected = this.reference.get(tick);
-        if (expected === undefined) {
-            this.reference.set(tick, checksum);
-            return true;
-        }
-        if (expected === checksum)
-            return true;
-        if (this.desyncTick === null)
-            this.desyncTick = tick;
-        return false;
-    }
-    /** true once any tick has disagreed */
-    get divergent() {
-        return this.desyncTick !== null;
-    }
-    /** the first tick that disagreed, or null while the run is in sync */
-    get atTick() {
-        return this.desyncTick;
-    }
-    /** forgets every observation, for a new run */
-    reset() {
-        this.reference.clear();
-        this.desyncTick = null;
-    }
-}
-//# sourceMappingURL=SyncGuard.js.map

package/dist/core/SyncGuard.js.map

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

package/dist/core/Telemetry.d.ts

@@ -1,63 +0,0 @@
-import { HttpTransport, type HttpTransportOptions } from './HttpTransport.ts';
-export interface TelemetryEvent {
-    name: string;
-    properties?: Record<string, string | number | boolean | null>;
-}
-export interface TelemetryOptions extends HttpTransportOptions {
-    /** longest string sent (event name, property name or value), in characters; a longer one is cut there. Default 256 */
-    maxStringLength?: number;
-    /** most properties one event carries; the rest are dropped. Default 32 */
-    maxProperties?: number;
-    /** the only property names sent, when given; any other is dropped */
-    allowedProperties?: readonly string[];
-}
-export interface TelemetryResponse {
-    ok: boolean;
-    status: number;
-}
-/**
- * An injectable transport for automatic, structured analytics events - `FeedbackClient`'s own
- * shape, for a different question. `FeedbackClient` is a player choosing to write something
- * and send it; this is a game deciding on its own to send something, which needs its own
- * consent gate before anything ever leaves the machine, unlike a player action that already
- * consents to sending just by happening. `send` is a silent no-op, not an error, until
- * `setConsent(true)` has been called - automatic collection defaults off.
- *
- * `mwg` stays opinion-free on what an event actually contains, what "consent" means for a
- * given game (a settings toggle, a first-launch prompt, a platform-level flag), and where the
- * endpoint lives - the same boundary `FeedbackClient`'s own doc comment draws for manual
- * reports.
- *
- * @example
- * ```ts
- * import { TelemetryClient } from '@datamoc/mw_games/core';
- *
- * const telemetry = new TelemetryClient({ endpoint: 'https://example.com/api/telemetry' });
- *
- * // nothing sends until a game's own consent flow grants it
- * telemetry.setConsent(true);
- * await telemetry.send({ name: 'level_started', properties: { level: 3 } });
- * ```
- */
-export declare class TelemetryClient extends HttpTransport {
-    private consented;
-    private readonly maxStringLength;
-    private readonly maxProperties;
-    private readonly allowed;
-    constructor(options: TelemetryOptions);
-    /** whether `send` will actually transmit anything right now */
-    get hasConsent(): boolean;
-    /** a game calls this from its own consent flow; not read from anywhere `mwg` controls */
-    setConsent(granted: boolean): void;
-    /** sends one structured event; a silent no-op before consent is granted, not an error */
-    send(event: TelemetryEvent): Promise<TelemetryResponse | null>;
-    /**
-     * The event as it leaves the machine: strings cut at `maxStringLength`, at most
-     * `maxProperties` properties, and only `allowedProperties` when that list is given. A game
-     * that passes an error message or a file path by mistake then sends a bounded fragment of
-     * it rather than the whole thing, and an allowlist makes the payload's shape a decision
-     * rather than whatever the calling code happened to put in.
-     */
-    private bounded;
-}
-//# sourceMappingURL=Telemetry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Telemetry.d.ts","sourceRoot":"","sources":["../../src/core/Telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC7D,sHAAsH;IACtH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,eAAgB,SAAQ,aAAa;IACjD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD,YAAY,OAAO,EAAE,gBAAgB,EAKpC;IAED,+DAA+D;IAC/D,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,yFAAyF;IACzF,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjC;IAED,yFAAyF;IACnF,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAcnE;IAED;;;;;;OAMG;IACH,OAAO,CAAC,OAAO;CAaf"}