@datamoc/mw_games 0.43.0 → 0.45.0

package/dist/core/Save.d.ts

@@ -1,123 +0,0 @@
-export interface SaveMeta {
-    version: number;
-    savedAt: number;
-    /** whatever a save-select screen shows: a summary string, a screenshot data URI, anything */
-    preview?: unknown;
-}
-export interface SaveData<T> {
-    meta: SaveMeta;
-    state: T;
-}
-/** the storage a `SaveSystem` writes through - `localStorage`'s shape, so that is the default */
-export interface SaveStorage {
-    read(key: string): string | null;
-    write(key: string, value: string): void;
-    remove(key: string): void;
-    keys(): string[];
-}
-/** an in-memory fallback, so saving still works where `localStorage` is unavailable */
-export declare class MemoryStorage implements SaveStorage {
-    private data;
-    read(key: string): string | null;
-    write(key: string, value: string): void;
-    remove(key: string): void;
-    keys(): string[];
-}
-/** `localStorage` where it exists, the in-memory fallback where it does not (including `file://`) */
-export declare function defaultStorage(): SaveStorage;
-export interface SaveSystemOptions {
-    /** namespaces every slot key, so two games sharing an origin never collide */
-    namespace: string;
-    version: number;
-    /** upgrades state saved at key `v` to version `v + 1`; applied in sequence up to `version` */
-    migrations?: Record<number, (state: unknown) => unknown>;
-    storage?: SaveStorage;
-}
-/**
- * Named, versioned save slots over `localStorage` (an in-memory store where there is none),
- * for plain JSON state. Bump `version` when the state's shape changes and give `migrations`
- * the step from each older version: a slot saved by an earlier release is upgraded when it
- * loads. `load` returns `null` for a slot that is missing or damaged, so a save-select screen
- * never meets an exception.
- *
- * @example
- * ```ts
- * import { SaveSystem } from '@datamoc/mw_games/core';
- *
- * interface RunState {
- * 	depth: number;
- * 	gold: number;
- * 	inventory: string[];
- * }
- *
- * //version 2 added `inventory`: a slot saved at version 1 gets an empty one when it loads
- * const saves = new SaveSystem<RunState>({
- * 	namespace: 'my-game',
- * 	version: 2,
- * 	migrations: { 1: (old) => ({ ...(old as Omit<RunState, 'inventory'>), inventory: [] }) },
- * });
- *
- * saves.save('auto', { depth: 3, gold: 40, inventory: ['rope'] }, 'Floor 3, 40 gold');
- *
- * const slot = saves.load('auto');
- * if (slot) console.log(slot.state.inventory, slot.meta.preview); // ['rope'] 'Floor 3, 40 gold'
- * saves.delete('auto');
- * ```
- */
-export declare class SaveSystem<T> {
-    private namespace;
-    private version;
-    private migrations;
-    private storage;
-    constructor(options: SaveSystemOptions);
-    private key;
-    save(slot: string, state: T, preview?: unknown): void;
-    /**
-     * Reads a slot, migrating it up to the current version if it was saved at an older one.
-     * Returns `null` for a corrupted, malformed or tampered slot the same way it already does
-     * for a missing one. The slot is read through `parseInbound` and a shape check, not trusted
-     * because this `SaveSystem` wrote it: a truncated write (an interrupted flush, a quota
-     * eviction) is possible anywhere, and under `file://` Chromium shares one `localStorage`
-     * between every local page, so any other HTML file on the machine can rewrite it. A
-     * save-select screen should see "no usable save here", not an uncaught `SyntaxError`.
-     */
-    load(slot: string): SaveData<T> | null;
-    /**
-     * Adopts a save this `SaveSystem` never wrote: `normalize` runs once on `externalBytes`,
-     * producing state at version 0, which is then carried up through the same `migrations`
-     * chain an ordinary `load` already uses to reach the current version - a game supplies
-     * one `normalize` per external format it wants to accept (an `rpg.decodeMarshal`-based
-     * one for a `Game.rxdata`, say), rather than hand-rolling "decode, then call `save`"
-     * outside the versioned pipeline every migration otherwise goes through.
-     *
-     * `externalBytes` is size-checked before `normalize` ever sees it - a cheap, structural
-     * guard against a truncated or hostile file, ahead of and distinct from validating
-     * whatever shape `normalize` itself produces.
-     */
-    importExternal(slot: string, externalBytes: Uint8Array, normalize: (bytes: Uint8Array) => unknown, preview?: unknown): void;
-    delete(slot: string): void;
-    /**
-     * Reads a slot back out as a portable string a player can carry to another browser or
-     * device, or hand to their own server - the counterpart to `importSlot`, for `mwg`'s own
-     * save shape rather than a foreign one (`importExternal` covers that side). `scrambleKey`,
-     * when given, runs the payload through `scramble` first: not encryption, only enough to
-     * stop a save being hand-edited in a text editor. Returns null for a slot with no save.
-     */
-    exportSlot(slot: string, scrambleKey?: string): string | null;
-    /**
-     * Writes a payload from this `SaveSystem`'s own `exportSlot` back as an ordinary save,
-     * migrated up to the current version the same way `load` migrates an older save found
-     * locally. `scrambleKey` must match whatever `exportSlot` scrambled it with, if any.
-     *
-     * `payload` is size-checked before it is unscrambled, then read through `parseInbound` and
-     * the same shape check `load` applies; any failure throws a named `Error` and leaves the
-     * slot untouched.
-     */
-    importSlot(slot: string, payload: string, scrambleKey?: string): void;
-    /** every slot holding a readable save, and its metadata - for a save-select screen */
-    list(): Array<{
-        slot: string;
-        meta: SaveMeta;
-    }>;
-}
-//# sourceMappingURL=Save.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Save.d.ts","sourceRoot":"","sources":["../../src/core/Save.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,QAAQ;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAEhB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,CAAC,CAAC;CACT;AAeD,iGAAiG;AACjG,MAAM,WAAW,WAAW;IAC3B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,IAAI,MAAM,EAAE,CAAC;CACjB;AAED,uFAAuF;AACvF,qBAAa,aAAc,YAAW,WAAW;IAChD,OAAO,CAAC,IAAI,CAA6B;IAEzC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE/B;IAED,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEtC;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAExB;IAED,IAAI,IAAI,MAAM,EAAE,CAEf;CACD;AAED,qGAAqG;AACrG,wBAAgB,cAAc,IAAI,WAAW,CAS5C;AAED,MAAM,WAAW,iBAAiB;IACjC,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAEhB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;IACzD,OAAO,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,UAAU,CAAC,CAAC;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,OAAO,CAAc;IAE7B,YAAY,OAAO,EAAE,iBAAiB,EAKrC;IAED,OAAO,CAAC,GAAG;IAIX,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAGpD;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAcrC;IAED;;;;;;;;;;;OAWG;IACH,cAAc,CACb,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,UAAU,EACzB,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,EACzC,OAAO,CAAC,EAAE,OAAO,GACf,IAAI,CASN;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEzB;IAED;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI5D;IAED;;;;;;;;OAQG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAWpE;IAED,sFAAsF;IACtF,IAAI,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,CAgB9C;CACD"}

package/dist/core/Save.js

@@ -1,216 +0,0 @@
-/**
- * Named save slots, versioned, with a preview - built on plain, JSON-serialisable state
- * rather than truly arbitrary object graphs. A game's own classes are expected to flatten
- * themselves the same way `mwg/rpg`'s `GameState` already does (a `toJSON`/reviving
- * constructor pair), not to be serialised by reference with cycles preserved; that is a
- * different, much larger problem than a save system needs to solve.
- *
- * Nothing stored here is private. Under `file://`, Chromium shares one `localStorage` between
- * every local page, so any HTML file opened on the same machine can read and rewrite these
- * slots; every read is checked (`parseInbound` and the slot shape) for that reason. Never store
- * a secret in a save.
- *
- * @example
- * ```ts
- * import { SaveSystem } from '@datamoc/mw_games/core';
- *
- * interface RunState { depth: number; hp: number }
- *
- * const saves = new SaveSystem<RunState>({ namespace: 'my-game', version: 1 });
- * saves.save('slot1', { depth: 3, hp: 12 }, 'Floor 3, 12 HP');
- *
- * const loaded = saves.load('slot1');
- * if (loaded) console.log(loaded.state.depth); // 3
- * ```
- */
-import { scramble, unscramble } from './Scramble.js';
-import { checkSize, parseInbound } from './Sanitize.js';
-/** `parseInbound`, then the `{ meta: { version, savedAt }, state }` shape every slot has */
-function parseSaveData(text, label) {
-    const data = parseInbound(text, { label });
-    const meta = data?.meta;
-    if (typeof data !== 'object' || data === null || Array.isArray(data) || !('state' in data))
-        throw new Error(`${label} is not save data (expected { meta, state })`);
-    if (typeof meta !== 'object' || meta === null || !Number.isSafeInteger(meta.version) || meta.version < 0)
-        throw new Error(`${label} has no valid meta.version`);
-    if (typeof meta.savedAt !== 'number' || !Number.isFinite(meta.savedAt))
-        throw new Error(`${label} has no valid meta.savedAt`);
-    return data;
-}
-/** an in-memory fallback, so saving still works where `localStorage` is unavailable */
-export class MemoryStorage {
-    constructor() {
-        this.data = new Map();
-    }
-    read(key) {
-        return this.data.get(key) ?? null;
-    }
-    write(key, value) {
-        this.data.set(key, value);
-    }
-    remove(key) {
-        this.data.delete(key);
-    }
-    keys() {
-        return [...this.data.keys()];
-    }
-}
-/** `localStorage` where it exists, the in-memory fallback where it does not (including `file://`) */
-export function defaultStorage() {
-    if (typeof localStorage === 'undefined')
-        return new MemoryStorage();
-    return {
-        read: (key) => localStorage.getItem(key),
-        write: (key, value) => localStorage.setItem(key, value),
-        remove: (key) => localStorage.removeItem(key),
-        keys: () => Object.keys(localStorage),
-    };
-}
-/**
- * Named, versioned save slots over `localStorage` (an in-memory store where there is none),
- * for plain JSON state. Bump `version` when the state's shape changes and give `migrations`
- * the step from each older version: a slot saved by an earlier release is upgraded when it
- * loads. `load` returns `null` for a slot that is missing or damaged, so a save-select screen
- * never meets an exception.
- *
- * @example
- * ```ts
- * import { SaveSystem } from '@datamoc/mw_games/core';
- *
- * interface RunState {
- * 	depth: number;
- * 	gold: number;
- * 	inventory: string[];
- * }
- *
- * //version 2 added `inventory`: a slot saved at version 1 gets an empty one when it loads
- * const saves = new SaveSystem<RunState>({
- * 	namespace: 'my-game',
- * 	version: 2,
- * 	migrations: { 1: (old) => ({ ...(old as Omit<RunState, 'inventory'>), inventory: [] }) },
- * });
- *
- * saves.save('auto', { depth: 3, gold: 40, inventory: ['rope'] }, 'Floor 3, 40 gold');
- *
- * const slot = saves.load('auto');
- * if (slot) console.log(slot.state.inventory, slot.meta.preview); // ['rope'] 'Floor 3, 40 gold'
- * saves.delete('auto');
- * ```
- */
-export class SaveSystem {
-    constructor(options) {
-        this.namespace = options.namespace;
-        this.version = options.version;
-        this.migrations = options.migrations ?? {};
-        this.storage = options.storage ?? defaultStorage();
-    }
-    key(slot) {
-        return `mwg-save:${this.namespace}:${slot}`;
-    }
-    save(slot, state, preview) {
-        const data = { meta: { version: this.version, savedAt: Date.now(), preview }, state };
-        this.storage.write(this.key(slot), JSON.stringify(data));
-    }
-    /**
-     * Reads a slot, migrating it up to the current version if it was saved at an older one.
-     * Returns `null` for a corrupted, malformed or tampered slot the same way it already does
-     * for a missing one. The slot is read through `parseInbound` and a shape check, not trusted
-     * because this `SaveSystem` wrote it: a truncated write (an interrupted flush, a quota
-     * eviction) is possible anywhere, and under `file://` Chromium shares one `localStorage`
-     * between every local page, so any other HTML file on the machine can rewrite it. A
-     * save-select screen should see "no usable save here", not an uncaught `SyntaxError`.
-     */
-    load(slot) {
-        const raw = this.storage.read(this.key(slot));
-        if (!raw)
-            return null;
-        try {
-            const data = parseSaveData(raw, `save slot "${slot}"`);
-            let state = data.state;
-            for (let v = data.meta.version; v < this.version; v++) {
-                state = (this.migrations[v] ?? ((s) => s))(state);
-            }
-            return { meta: { ...data.meta, version: this.version }, state: state };
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Adopts a save this `SaveSystem` never wrote: `normalize` runs once on `externalBytes`,
-     * producing state at version 0, which is then carried up through the same `migrations`
-     * chain an ordinary `load` already uses to reach the current version - a game supplies
-     * one `normalize` per external format it wants to accept (an `rpg.decodeMarshal`-based
-     * one for a `Game.rxdata`, say), rather than hand-rolling "decode, then call `save`"
-     * outside the versioned pipeline every migration otherwise goes through.
-     *
-     * `externalBytes` is size-checked before `normalize` ever sees it - a cheap, structural
-     * guard against a truncated or hostile file, ahead of and distinct from validating
-     * whatever shape `normalize` itself produces.
-     */
-    importExternal(slot, externalBytes, normalize, preview) {
-        checkSize(externalBytes);
-        let state = normalize(externalBytes);
-        for (let v = 0; v < this.version; v++) {
-            state = (this.migrations[v] ?? ((s) => s))(state);
-        }
-        const data = { meta: { version: this.version, savedAt: Date.now(), preview }, state: state };
-        this.storage.write(this.key(slot), JSON.stringify(data));
-    }
-    delete(slot) {
-        this.storage.remove(this.key(slot));
-    }
-    /**
-     * Reads a slot back out as a portable string a player can carry to another browser or
-     * device, or hand to their own server - the counterpart to `importSlot`, for `mwg`'s own
-     * save shape rather than a foreign one (`importExternal` covers that side). `scrambleKey`,
-     * when given, runs the payload through `scramble` first: not encryption, only enough to
-     * stop a save being hand-edited in a text editor. Returns null for a slot with no save.
-     */
-    exportSlot(slot, scrambleKey) {
-        const raw = this.storage.read(this.key(slot));
-        if (raw === null)
-            return null;
-        return scrambleKey ? scramble(raw, scrambleKey) : raw;
-    }
-    /**
-     * Writes a payload from this `SaveSystem`'s own `exportSlot` back as an ordinary save,
-     * migrated up to the current version the same way `load` migrates an older save found
-     * locally. `scrambleKey` must match whatever `exportSlot` scrambled it with, if any.
-     *
-     * `payload` is size-checked before it is unscrambled, then read through `parseInbound` and
-     * the same shape check `load` applies; any failure throws a named `Error` and leaves the
-     * slot untouched.
-     */
-    importSlot(slot, payload, scrambleKey) {
-        checkSize(payload);
-        const raw = scrambleKey ? unscramble(payload, scrambleKey) : payload;
-        const data = parseSaveData(raw, 'SaveSystem.importSlot: payload');
-        let state = data.state;
-        for (let v = data.meta.version; v < this.version; v++) {
-            state = (this.migrations[v] ?? ((s) => s))(state);
-        }
-        const normalized = { meta: { ...data.meta, version: this.version }, state: state };
-        this.storage.write(this.key(slot), JSON.stringify(normalized));
-    }
-    /** every slot holding a readable save, and its metadata - for a save-select screen */
-    list() {
-        const prefix = `mwg-save:${this.namespace}:`;
-        const out = [];
-        for (const key of this.storage.keys()) {
-            if (!key.startsWith(prefix))
-                continue;
-            const raw = this.storage.read(key);
-            if (!raw)
-                continue;
-            try {
-                out.push({ slot: key.slice(prefix.length), meta: parseSaveData(raw, key).meta });
-            }
-            catch {
-                //a slot `load` would refuse is not listed as usable either
-            }
-        }
-        return out;
-    }
-}
-//# sourceMappingURL=Save.js.map

package/dist/core/Save.js.map

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

package/dist/core/SaveSync.d.ts

@@ -1,43 +0,0 @@
-import { HttpTransport, type HttpTransportOptions } from './HttpTransport.ts';
-/**
- * Uploads/downloads `SaveSystem.exportSlot` payloads to a game's own HTTPS endpoint - the
- * server half of item 124's save export/import, following `FeedbackClient`'s own shape
- * (an injectable transport a game points at its own endpoint) rather than a second pattern:
- * `mwg` ships no backend and assumes none here either.
- *
- * Every call names a `slot`, the same name `SaveSystem.exportSlot`/`importSlot` already use
- * locally, so a player with several named profiles (`SaveSystem` supports as many as a game
- * creates) can sync each independently against one endpoint rather than the endpoint holding
- * only ever one save. `list()` is the seam a profile picker reads before choosing which slot
- * to `download`.
- *
- * @example
- * ```ts
- * import { SaveSyncClient, SaveSystem } from '@datamoc/mw_games/core';
- *
- * const sync = new SaveSyncClient({ endpoint: 'https://example.com/api/saves' });
- * const saves = new SaveSystem<{ depth: number }>({ namespace: 'my-game', version: 1 });
- *
- * const payload = saves.exportSlot('slot1');
- * if (payload) await sync.upload('slot1', payload);
- *
- * const slots = await sync.list();
- * const restored = await sync.download('slot1');
- * ```
- */
-export type SaveSyncOptions = HttpTransportOptions;
-export interface SaveSyncResponse {
-    ok: boolean;
-    status: number;
-}
-export declare class SaveSyncClient extends HttpTransport {
-    constructor(options: SaveSyncOptions);
-    /** sends an `exportSlot` payload for `slot` to the endpoint, replacing whatever it held before */
-    upload(slot: string, payload: string): Promise<SaveSyncResponse>;
-    /** fetches whatever payload the endpoint currently holds for `slot`, ready for `SaveSystem.importSlot` */
-    download(slot: string): Promise<string>;
-    /** every slot name this endpoint currently holds for this player, for a profile picker to list */
-    list(): Promise<string[]>;
-    private slotUrl;
-}
-//# sourceMappingURL=SaveSync.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"SaveSync.d.ts","sourceRoot":"","sources":["../../src/core/SaveSync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,cAAe,SAAQ,aAAa;IAChD,YAAY,OAAO,EAAE,eAAe,EAEnC;IAED,kGAAkG;IAC5F,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAarE;IAED,0GAA0G;IACpG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS5C;IAED,kGAAkG;IAC5F,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAU9B;IAED,OAAO,CAAC,OAAO;CAIf"}

package/dist/core/SaveSync.js

@@ -1,56 +0,0 @@
-import { HttpTransport } from './HttpTransport.js';
-export class SaveSyncClient extends HttpTransport {
-    constructor(options) {
-        super(options, 'save sync');
-    }
-    /** sends an `exportSlot` payload for `slot` to the endpoint, replacing whatever it held before */
-    async upload(slot, payload) {
-        if (!slot)
-            throw new Error('save sync slot name is required');
-        if (!payload)
-            throw new Error('save sync payload cannot be empty');
-        return this.withTimeout(async (signal) => {
-            const response = await this.fetchFn(this.slotUrl(slot), {
-                method: 'POST',
-                headers: { 'content-type': 'application/json' },
-                body: JSON.stringify({ payload }),
-                signal,
-            });
-            if (!response.ok)
-                throw new Error(`save upload failed with HTTP ${response.status}`);
-            return { ok: true, status: response.status };
-        });
-    }
-    /** fetches whatever payload the endpoint currently holds for `slot`, ready for `SaveSystem.importSlot` */
-    async download(slot) {
-        if (!slot)
-            throw new Error('save sync slot name is required');
-        return this.withTimeout(async (signal) => {
-            const response = await this.fetchFn(this.slotUrl(slot), { signal });
-            if (!response.ok)
-                throw new Error(`save download failed with HTTP ${response.status}`);
-            const data = (await this.readJson(response, 'download'));
-            if (typeof data?.payload !== 'string')
-                throw new Error('save download response missing a string payload');
-            return data.payload;
-        });
-    }
-    /** every slot name this endpoint currently holds for this player, for a profile picker to list */
-    async list() {
-        return this.withTimeout(async (signal) => {
-            const response = await this.fetchFn(this.endpoint, { signal });
-            if (!response.ok)
-                throw new Error(`save slot list failed with HTTP ${response.status}`);
-            const data = (await this.readJson(response, 'slot list'));
-            if (!Array.isArray(data?.slots) || !data.slots.every((slot) => typeof slot === 'string')) {
-                throw new Error('save slot list response missing a string array of slots');
-            }
-            return data.slots;
-        });
-    }
-    slotUrl(slot) {
-        const separator = this.endpoint.includes('?') ? '&' : '?';
-        return `${this.endpoint}${separator}slot=${encodeURIComponent(slot)}`;
-    }
-}
-//# sourceMappingURL=SaveSync.js.map

package/dist/core/SaveSync.js.map

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

package/dist/core/Scene.d.ts

@@ -1,63 +0,0 @@
-import { Signal } from './Signal.ts';
-/**
- * One screen of the game: a title, a menu, the dungeon itself.
- *
- * This is the lifecycle half only, and owns no renderer: `create`, `update`, `resize`, the
- * suspend/resume pair a pushed scene needs, and a destroy that fires once. `two-d.Scene2D`
- * adds the Pixi container a 2D game draws into; a Babylon game supplies its own equivalent.
- * The split exists so `SceneStack` - which never touches a display node, only these methods -
- * works for either, rather than scene management being something only a Pixi game gets.
- *
- * Switching scenes destroys the old one, so a scene may hold whatever state it likes without
- * cleaning up by hand.
- *
- * @example
- * ```ts
- * import { Scene } from '@datamoc/mw_games/core';
- *
- * // a 2D game extends two-d.Scene2D instead, which adds the Pixi display container;
- * // this base is what a renderer-free game (or a Babylon one) extends directly.
- * class TitleScreen extends Scene {
- *   create(): void {
- *     // build the screen's own state here
- *   }
- * }
- * ```
- */
-export declare abstract class Scene {
-    /** fires when the scene is torn down, for listeners that need to detach */
-    readonly onDestroy: Signal<void>;
-    private destroyed;
-    /** builds the scene's contents; assets are already loaded when this runs */
-    abstract create(): void;
-    /** @param dt seconds since the previous frame, already clamped */
-    update(_dt: number): void;
-    /** the display was resized; the scene may relayout rather than be rebuilt */
-    resize(_width: number, _height: number): void;
-    /**
-     * Called when another scene is pushed on top of this one.
-     *
-     * Updating already stops on its own - only the top scene runs - but input
-     * listeners do not stand down by themselves. A scene holding windows, music
-     * or key handlers pauses or detaches them here; the default does nothing.
-     */
-    onSuspend(): void;
-    /**
-     * Called when the scene above pops, reporting back what it decided.
-     *
-     * @param result whatever the popped scene passed to `popScene` - a choice,
-     * a score, or nothing at all. Games cast it to what their minigame returns.
-     */
-    onResume(_result: unknown): void;
-    destroy(): void;
-    /**
-     * Renderer-owned resources this scene holds, released exactly once as it is destroyed.
-     *
-     * The base owns none, because it owns no renderer; `two-d.Scene2D` destroys its container
-     * here. A subclass overriding it does not need to call `super.teardown()`.
-     */
-    protected teardown(): void;
-    get isDestroyed(): boolean;
-}
-export type SceneClass<T extends Scene = Scene> = new () => T;
-//# sourceMappingURL=Scene.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Scene.d.ts","sourceRoot":"","sources":["../../src/core/Scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,8BAAsB,KAAK;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,eAAsB;IAExC,OAAO,CAAC,SAAS,CAAS;IAE1B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC;IAExB,kEAAkE;IAClE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAExB;IAED,6EAA6E;IAC7E,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE5C;IAED;;;;;;OAMG;IACH,SAAS,IAAI,IAAI,CAEhB;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE/B;IAED,OAAO,IAAI,IAAI,CAOd;IAED;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,IAAI,IAAI,CAEzB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;CACD;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI,UAAU,CAAC,CAAC"}

package/dist/core/Scene.js

@@ -1,81 +0,0 @@
-import { Signal } from './Signal.js';
-/**
- * One screen of the game: a title, a menu, the dungeon itself.
- *
- * This is the lifecycle half only, and owns no renderer: `create`, `update`, `resize`, the
- * suspend/resume pair a pushed scene needs, and a destroy that fires once. `two-d.Scene2D`
- * adds the Pixi container a 2D game draws into; a Babylon game supplies its own equivalent.
- * The split exists so `SceneStack` - which never touches a display node, only these methods -
- * works for either, rather than scene management being something only a Pixi game gets.
- *
- * Switching scenes destroys the old one, so a scene may hold whatever state it likes without
- * cleaning up by hand.
- *
- * @example
- * ```ts
- * import { Scene } from '@datamoc/mw_games/core';
- *
- * // a 2D game extends two-d.Scene2D instead, which adds the Pixi display container;
- * // this base is what a renderer-free game (or a Babylon one) extends directly.
- * class TitleScreen extends Scene {
- *   create(): void {
- *     // build the screen's own state here
- *   }
- * }
- * ```
- */
-export class Scene {
-    constructor() {
-        /** fires when the scene is torn down, for listeners that need to detach */
-        this.onDestroy = new Signal();
-        this.destroyed = false;
-    }
-    /** @param dt seconds since the previous frame, already clamped */
-    update(_dt) {
-        //scenes that only react to input need no per-frame work
-    }
-    /** the display was resized; the scene may relayout rather than be rebuilt */
-    resize(_width, _height) {
-        //most scenes lay out in create() and are rebuilt instead
-    }
-    /**
-     * Called when another scene is pushed on top of this one.
-     *
-     * Updating already stops on its own - only the top scene runs - but input
-     * listeners do not stand down by themselves. A scene holding windows, music
-     * or key handlers pauses or detaches them here; the default does nothing.
-     */
-    onSuspend() {
-        //scenes with nothing live need nothing stood down
-    }
-    /**
-     * Called when the scene above pops, reporting back what it decided.
-     *
-     * @param result whatever the popped scene passed to `popScene` - a choice,
-     * a score, or nothing at all. Games cast it to what their minigame returns.
-     */
-    onResume(_result) {
-        //scenes that pushed nothing back need nothing reported
-    }
-    destroy() {
-        if (this.destroyed)
-            return;
-        this.destroyed = true;
-        this.onDestroy.dispatch();
-        this.onDestroy.removeAll();
-        this.teardown();
-    }
-    /**
-     * Renderer-owned resources this scene holds, released exactly once as it is destroyed.
-     *
-     * The base owns none, because it owns no renderer; `two-d.Scene2D` destroys its container
-     * here. A subclass overriding it does not need to call `super.teardown()`.
-     */
-    teardown() {
-        //nothing renderer-shaped at this level
-    }
-    get isDestroyed() {
-        return this.destroyed;
-    }
-}
-//# sourceMappingURL=Scene.js.map

package/dist/core/Scene.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Scene.js","sourceRoot":"","sources":["../../src/core/Scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAgB,KAAK;IAA3B;QACC,2EAA2E;QAClE,cAAS,GAAG,IAAI,MAAM,EAAQ,CAAC;QAEhC,cAAS,GAAG,KAAK,CAAC;IA0D3B,CAAC;IArDA,kEAAkE;IAClE,MAAM,CAAC,GAAW;QACjB,wDAAwD;IACzD,CAAC;IAED,6EAA6E;IAC7E,MAAM,CAAC,MAAc,EAAE,OAAe;QACrC,yDAAyD;IAC1D,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACR,kDAAkD;IACnD,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAgB;QACxB,uDAAuD;IACxD,CAAC;IAED,OAAO;QACN,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,QAAQ,EAAE,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACO,QAAQ;QACjB,uCAAuC;IACxC,CAAC;IAED,IAAI,WAAW;QACd,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;CACD"}