@datamoc/mw_games 0.44.2 → 0.46.0

package/dist/core/Registry.js

@@ -1,46 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}

package/dist/core/Replay.d.ts

@@ -1,126 +0,0 @@
-import type { Signal } from './Signal.ts';
-/**
- * One action dispatched on one frame of the game loop.
- *
- * The frame is a count of frames since recording started, not a timestamp: a
- * replay re-dispatches the same actions at the same frame counts while driving
- * the loop itself with `Game.step(dt)`, so wall-clock timing never matters.
- */
-export interface ReplayEvent {
-    frame: number;
-    action: string;
-}
-/**
- * Records every action dispatched on a signal, stamped with the current frame.
- *
- * In a game the two signals are `Input.onAction` and `Game.onFrame`:
- *
- * ```ts
- * const recorder = new Recorder(Input.onAction, game.onFrame);
- * // ...play...
- * const saved = serializeReplay(recorder.toJSON());
- * ```
- *
- * The signals are parameters rather than imports so tests can drive a
- * recorder with plain `Signal` instances instead of a whole `Game`. A restored
- * run continues its recording mid-run: pass the checkpoint's frame as `fromFrame`
- * and new actions stamp from there, never from zero.
- *
- * @example
- * ```ts
- * import { Recorder, Signal, serializeReplay } from '@datamoc/mw_games/core';
- *
- * const onAction = new Signal<string>();
- * const onFrame = new Signal<number>();
- *
- * const recorder = new Recorder(onAction, onFrame);
- * onFrame.dispatch(0);
- * onAction.dispatch('confirm');
- *
- * const saved = serializeReplay(recorder.toJSON());
- * recorder.stop();
- * ```
- */
-export declare class Recorder {
-    private frameStamp;
-    private readonly fromFrame;
-    private readonly recorded;
-    private readonly actions;
-    private readonly frames;
-    private readonly onAction;
-    private readonly onFrame;
-    constructor(actions: Signal<string>, frames: Signal<number>, options?: {
-        fromFrame?: number;
-    });
-    get events(): readonly ReplayEvent[];
-    /** The frame count the recording is currently stamped with, so a run can be checkpointed. */
-    get frame(): number;
-    /** A deep copy, safe to serialise or hand to a `Player`. */
-    toJSON(): ReplayEvent[];
-    /** Detaches both listeners; safe to call twice. */
-    stop(): void;
-}
-/**
- * Re-dispatches recorded events at their recorded frames.
- *
- * ```ts
- * const player = new Player(deserializeReplay(saved), (a) => Input.onAction.dispatch(a), game.onFrame);
- * // ...drive the loop by hand: game.step(1 / 60) per frame...
- * ```
- *
- * Events are dispatched on the frame signal whose count has reached their
- * stamp, before the player's own count advances - the same relative point a
- * live action held during recording. `dispatch` usually forwards into
- * `Input.onAction`, but tests pass a collector instead.
- *
- * @example
- * ```ts
- * import { Player, Signal, deserializeReplay } from '@datamoc/mw_games/core';
- *
- * declare const saved: string; // written by serializeReplay, see Recorder
- *
- * const onFrame = new Signal<number>();
- * const replayed: string[] = [];
- *
- * const player = new Player(deserializeReplay(saved), (action) => replayed.push(action), onFrame);
- * onFrame.dispatch(0);
- *
- * console.log(player.done);
- * player.stop();
- * ```
- */
-export declare class Player {
-    private frame;
-    private index;
-    private readonly fromFrame;
-    private readonly events;
-    private readonly dispatch;
-    private readonly frames;
-    private readonly onFrame;
-    constructor(events: readonly ReplayEvent[], dispatch: (action: string) => void, frames: Signal<number>, options?: {
-        fromFrame?: number;
-    });
-    /** True once every event has been dispatched. */
-    get done(): boolean;
-    /** Detaches the frame listener; safe to call twice. */
-    stop(): void;
-    private pump;
-}
-export declare function serializeReplay(events: readonly ReplayEvent[]): string;
-/** Parses what `serializeReplay` wrote, rejecting anything else. */
-export declare function deserializeReplay(json: string): ReplayEvent[];
-/**
- * Validates an already-parsed replay - the same `{ frame, action }` checks `deserializeReplay`
- * applies, for the callers that hold parsed JSON rather than a string: a replay-file envelope
- * nests its events as an array, and re-stringifying them to parse them again would be the only
- * reason this half could not exist.
- *
- * @example
- * ```ts
- * import { parseReplayEvents } from '@datamoc/mw_games/core';
- *
- * const events = parseReplayEvents([{ frame: 3, action: 'confirm' }]);
- * ```
- */
-export declare function parseReplayEvents(parsed: unknown): ReplayEvent[];
-//# sourceMappingURL=Replay.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Replay.d.ts","sourceRoot":"","sources":["../../src/core/Replay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,QAAQ;IACpB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IAErC,YAAY,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAgB5F;IAED,IAAI,MAAM,IAAI,SAAS,WAAW,EAAE,CAEnC;IAED,6FAA6F;IAC7F,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,4DAA4D;IAC5D,MAAM,IAAI,WAAW,EAAE,CAEtB;IAED,mDAAmD;IACnD,IAAI,IAAI,IAAI,CAGX;CACD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,MAAM;IAClB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IAErC,YACC,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAClC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EACtB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAahC;IAED,iDAAiD;IACjD,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,uDAAuD;IACvD,IAAI,IAAI,IAAI,CAEX;IAED,OAAO,CAAC,IAAI;CAOZ;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAEtE;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAE7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,EAAE,CAchE"}

package/dist/core/Replay.js

@@ -1,162 +0,0 @@
-/**
- * Records every action dispatched on a signal, stamped with the current frame.
- *
- * In a game the two signals are `Input.onAction` and `Game.onFrame`:
- *
- * ```ts
- * const recorder = new Recorder(Input.onAction, game.onFrame);
- * // ...play...
- * const saved = serializeReplay(recorder.toJSON());
- * ```
- *
- * The signals are parameters rather than imports so tests can drive a
- * recorder with plain `Signal` instances instead of a whole `Game`. A restored
- * run continues its recording mid-run: pass the checkpoint's frame as `fromFrame`
- * and new actions stamp from there, never from zero.
- *
- * @example
- * ```ts
- * import { Recorder, Signal, serializeReplay } from '@datamoc/mw_games/core';
- *
- * const onAction = new Signal<string>();
- * const onFrame = new Signal<number>();
- *
- * const recorder = new Recorder(onAction, onFrame);
- * onFrame.dispatch(0);
- * onAction.dispatch('confirm');
- *
- * const saved = serializeReplay(recorder.toJSON());
- * recorder.stop();
- * ```
- */
-export class Recorder {
-    constructor(actions, frames, options) {
-        this.recorded = [];
-        this.fromFrame = options?.fromFrame ?? 0;
-        if (!Number.isInteger(this.fromFrame) || this.fromFrame < 0)
-            throw new RangeError('a resumed recorder needs a non-negative fromFrame');
-        this.frameStamp = this.fromFrame;
-        this.actions = actions;
-        this.frames = frames;
-        //returns void, never true: recording must not swallow the action
-        this.onAction = (action) => {
-            this.recorded.push({ frame: this.frameStamp, action });
-        };
-        this.onFrame = () => {
-            this.frameStamp++;
-        };
-        actions.add(this.onAction);
-        frames.add(this.onFrame);
-    }
-    get events() {
-        return this.recorded;
-    }
-    /** The frame count the recording is currently stamped with, so a run can be checkpointed. */
-    get frame() {
-        return this.frameStamp;
-    }
-    /** A deep copy, safe to serialise or hand to a `Player`. */
-    toJSON() {
-        return this.recorded.map((e) => ({ frame: e.frame, action: e.action }));
-    }
-    /** Detaches both listeners; safe to call twice. */
-    stop() {
-        this.actions.remove(this.onAction);
-        this.frames.remove(this.onFrame);
-    }
-}
-/**
- * Re-dispatches recorded events at their recorded frames.
- *
- * ```ts
- * const player = new Player(deserializeReplay(saved), (a) => Input.onAction.dispatch(a), game.onFrame);
- * // ...drive the loop by hand: game.step(1 / 60) per frame...
- * ```
- *
- * Events are dispatched on the frame signal whose count has reached their
- * stamp, before the player's own count advances - the same relative point a
- * live action held during recording. `dispatch` usually forwards into
- * `Input.onAction`, but tests pass a collector instead.
- *
- * @example
- * ```ts
- * import { Player, Signal, deserializeReplay } from '@datamoc/mw_games/core';
- *
- * declare const saved: string; // written by serializeReplay, see Recorder
- *
- * const onFrame = new Signal<number>();
- * const replayed: string[] = [];
- *
- * const player = new Player(deserializeReplay(saved), (action) => replayed.push(action), onFrame);
- * onFrame.dispatch(0);
- *
- * console.log(player.done);
- * player.stop();
- * ```
- */
-export class Player {
-    constructor(events, dispatch, frames, options) {
-        this.events = events;
-        this.dispatch = dispatch;
-        this.frames = frames;
-        this.fromFrame = options?.fromFrame ?? 0;
-        if (!Number.isInteger(this.fromFrame) || this.fromFrame < 0)
-            throw new RangeError('a resumed player needs a non-negative fromFrame');
-        this.index = this.events.findIndex((event) => event.frame >= this.fromFrame);
-        if (this.index < 0)
-            this.index = this.events.length;
-        this.frame = this.fromFrame;
-        this.onFrame = () => this.pump();
-        frames.add(this.onFrame);
-    }
-    /** True once every event has been dispatched. */
-    get done() {
-        return this.index >= this.events.length;
-    }
-    /** Detaches the frame listener; safe to call twice. */
-    stop() {
-        this.frames.remove(this.onFrame);
-    }
-    pump() {
-        while (this.index < this.events.length && this.events[this.index].frame <= this.frame) {
-            this.dispatch(this.events[this.index].action);
-            this.index++;
-        }
-        this.frame++;
-    }
-}
-export function serializeReplay(events) {
-    return JSON.stringify(events);
-}
-/** Parses what `serializeReplay` wrote, rejecting anything else. */
-export function deserializeReplay(json) {
-    return parseReplayEvents(JSON.parse(json));
-}
-/**
- * Validates an already-parsed replay - the same `{ frame, action }` checks `deserializeReplay`
- * applies, for the callers that hold parsed JSON rather than a string: a replay-file envelope
- * nests its events as an array, and re-stringifying them to parse them again would be the only
- * reason this half could not exist.
- *
- * @example
- * ```ts
- * import { parseReplayEvents } from '@datamoc/mw_games/core';
- *
- * const events = parseReplayEvents([{ frame: 3, action: 'confirm' }]);
- * ```
- */
-export function parseReplayEvents(parsed) {
-    if (!Array.isArray(parsed))
-        throw new Error('a replay must be an array of {frame, action}');
-    return parsed.map((entry) => {
-        if (typeof entry !== 'object' ||
-            entry === null ||
-            !Number.isInteger(entry.frame) ||
-            entry.frame < 0 ||
-            typeof entry.action !== 'string') {
-            throw new Error('a replay entry must be {frame: a non-negative integer, action: a string}');
-        }
-        return { frame: entry.frame, action: entry.action };
-    });
-}
-//# sourceMappingURL=Replay.js.map

package/dist/core/Replay.js.map

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

package/dist/core/ReplayFile.d.ts

@@ -1,197 +0,0 @@
-import { Recorder, Player } from './Replay.ts';
-import type { ReplayEvent } from './Replay.ts';
-import { type SaveStorage } from './Save.ts';
-import type { Signal } from './Signal.ts';
-/**
- * A run made durable: the recording `core` already takes, in a shape that survives a page
- * reload, crosses machines, and refuses to play against a build it was not recorded on.
- *
- * `Recorder`/`Player` record and replay in memory; this file is everything around that:
- * a self-describing file format (export and import), the newest recording kept in storage
- * (last-run capture), and a mid-run checkpoint pairing the partial recording with the
- * game state beside it. The `file://` rule shapes the plumbing: an export is a download and
- * an import is a file picker, `fetch()` is never used, and Node-side tools read and write
- * the same file directly.
- */
-/** The self-describing envelope a recorded run is exported as. */
-export interface ReplayFile {
-    format: 'mwg-replay';
-    version: 1;
-    /** the framework build the run was recorded against - `version` from the package root */
-    framework: string;
-    /** the game's own identity, so a replay of one game is refused by another by name */
-    game: string;
-    /** the run's seed, so a seeded environment walks the same trajectory on import */
-    seed?: number;
-    /** wall-clock moment of export, for a file listing; playback never reads it */
-    recordedAt?: number;
-    events: readonly ReplayEvent[];
-}
-/** What `exportReplayFile` stamps into the envelope beside the recording itself. */
-export interface ReplayFileMeta {
-    framework: string;
-    game: string;
-    seed?: number;
-    recordedAt?: number;
-}
-/**
- * Wraps a recording in the versioned, self-describing envelope, as a JSON string ready to
- * save as a file. The events are validated and copied, so the exported file cannot drift
- * with a recording that keeps running.
- *
- * @example
- * ```ts
- * import { exportReplayFile, Recorder, Signal, version } from '@datamoc/mw_games';
- *
- * declare const recorder: Recorder;
- * const file = exportReplayFile(recorder.toJSON(), {
- * 	framework: version,
- * 	game: 'my-game',
- * 	recordedAt: Date.now(),
- * });
- * ```
- */
-export declare function exportReplayFile(events: readonly ReplayEvent[], meta: ReplayFileMeta): string;
-/**
- * Parses and checks a replay file, refusing by name anything that is not this game on this
- * framework: a replay from another build does not fail somewhere mid-playback, it is
- * rejected at the door with what it actually carries.
- *
- * @example
- * ```ts
- * import { importReplayFile, version } from '@datamoc/mw_games';
- *
- * declare const json: string; // read from a file, see readReplayFile
- * const file = importReplayFile(json, { framework: version, game: 'my-game' });
- * console.log(file.events.length, file.seed);
- * ```
- */
-export declare function importReplayFile(json: string, expect: {
-    framework: string;
-    game: string;
-}): ReplayFile;
-/** The kept newest recording, as `LastRun.load` hands it back. */
-export interface LastRunData {
-    version: 1;
-    seed?: number;
-    events: readonly ReplayEvent[];
-}
-export interface LastRunOptions {
-    /** namespaces the kept recording, so two games sharing an origin never collide */
-    namespace: string;
-    storage?: SaveStorage;
-    /** once a recording holds more events than this, the newest are kept; default 10000 */
-    maxEvents?: number;
-}
-/**
- * The newest recording, always kept, bounded: what "watch the previous run" reads. One
- * recording deep by design (the newest replaces the older one), stored through the same
- * `SaveStorage` a `SaveSystem` slot uses, so it survives a reload and lands in the
- * in-memory fallback under `file://`.
- *
- * @example
- * ```ts
- * import { LastRun, Recorder } from '@datamoc/mw_games/core';
- *
- * declare const recorder: Recorder;
- * const last = new LastRun({ namespace: 'my-game' });
- * last.keep(recorder.toJSON());
- * const kept = last.load();
- * console.log(kept ? kept.events.length : 'no run yet');
- * ```
- */
-export declare class LastRun {
-    private readonly store;
-    private readonly maxEvents;
-    constructor(options: LastRunOptions);
-    /** Keeps the newest recording, replacing any previous one. An oversized tail keeps its newest events. */
-    keep(events: readonly ReplayEvent[], seed?: number): void;
-    /** The kept recording, or null when no run has been kept yet. Corrupt storage throws by name. */
-    load(): LastRunData | null;
-    /** Drops the kept recording. */
-    clear(): void;
-}
-/** A run in progress, checkpointed: the partial recording beside the game state it captured. */
-export interface RunCheckpoint<T> {
-    version: 1;
-    /** the frame count the recording reached, so playback resumes mid-run */
-    frame: number;
-    events: readonly ReplayEvent[];
-    state: T;
-}
-/**
- * Pairs a live recording with the state a save already captured, as plain data a
- * `SaveSystem` slot stores: restoring the slot restores the run, not just the numbers.
- *
- * @example
- * ```ts
- * import { runCheckpoint, Recorder } from '@datamoc/mw_games/core';
- *
- * declare const recorder: Recorder;
- * const checkpoint = runCheckpoint(recorder, { depth: 4, hp: 9 });
- * console.log(checkpoint.frame, checkpoint.state.hp);
- * ```
- */
-export declare function runCheckpoint<T>(recorder: Recorder, state: T): RunCheckpoint<T>;
-/**
- * The playback half of a restored checkpoint: a `Player` that continues the recording from
- * the checkpoint's frame, skipping the events before it, so the run resumes rather than
- * restarting. The restored state and the resumed playback travel together: the game loads
- * the slot, then starts this player against the same frame signal it records on.
- *
- * @example
- * ```ts
- * import { resumeRunPlayer, runCheckpoint, Recorder, Signal } from '@datamoc/mw_games/core';
- *
- * declare const recorder: Recorder;
- * const checkpoint = runCheckpoint(recorder, { hp: 9 });
- * const onFrame = new Signal<number>();
- * const player = resumeRunPlayer(checkpoint, (action) => console.log(action), onFrame);
- * player.stop();
- * ```
- */
-export declare function resumeRunPlayer<T>(checkpoint: RunCheckpoint<T>, dispatch: (action: string) => void, frames: Signal<number>): Player;
-/**
- * Saves a replay file locally: a Blob download, which works from a `file://` page with no
- * server and no `fetch()`. Nothing is read back; the file is the export.
- *
- * @example
- * ```ts
- * import { downloadReplayFile, exportReplayFile } from '@datamoc/mw_games/core';
- *
- * const json = exportReplayFile([], { framework: '0.26.1', game: 'my-game' });
- * downloadReplayFile(json, 'run-1.mwgreplay.json');
- * ```
- */
-export declare function downloadReplayFile(json: string, filename: string): void;
-/**
- * Reads a chosen file (or any Blob) as text, headless and in the browser alike: the
- * browser half of an import is the picker, this is the rest. `Blob.text()` needs no DOM,
- * so the same function reads a `node:fs` buffer's Blob in a tool.
- *
- * @example
- * ```ts
- * import { importReplayFile, readReplayFile, version } from '@datamoc/mw_games';
- *
- * declare const file: Blob; // from pickReplayFile, or a Node-side Blob
- * const json = await readReplayFile(file);
- * const replay = importReplayFile(json, { framework: version, game: 'my-game' });
- * ```
- */
-export declare function readReplayFile(file: Blob): Promise<string>;
-/**
- * Opens a file picker for one replay file, resolving null when the player cancels. The
- * `file://` import path: no `fetch()`, no drag-drop wiring to get wrong.
- *
- * @example
- * ```ts
- * import { importReplayFile, pickReplayFile, readReplayFile, version } from '@datamoc/mw_games';
- *
- * const picked = await pickReplayFile();
- * if (picked) {
- * 	const replay = importReplayFile(await readReplayFile(picked), { framework: version, game: 'my-game' });
- * }
- * ```
- */
-export declare function pickReplayFile(accept?: string): Promise<Blob | null>;
-//# sourceMappingURL=ReplayFile.d.ts.map

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

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