@datamoc/mw_games 0.44.2 → 0.45.0

package/dist/mwl/package.js

@@ -1,382 +0,0 @@
-import { version as mwgVersion } from '../version.js';
-import { compileNodes } from './compiler.js';
-import { decodePackage, PackageError, PackageFormatError, sha256Hex, } from './package-container.js';
-import { compareVersions, KNOWN_PACKAGE_CAPABILITIES, parsePackageDocument, satisfiesVersionRange, } from './package-document.js';
-/**
- * A second package with the same id and version, or one whose dependency is not merged.
- *
- * @example
- * ```ts
- * import { PackageConflictError } from '@datamoc/mw_games/mwl';
- *
- * console.log(new PackageConflictError('already merged').name); // 'PackageConflictError'
- * ```
- */
-export class PackageConflictError extends PackageError {
-    constructor(message) {
-        super(message);
-        this.name = 'PackageConflictError';
-    }
-}
-/**
- * Decodes a `.mwp` (digests, limits, paths) and reads its main document. Nothing in the package
- * is executed, fetched or compiled: this is the whole install step.
- *
- * @example
- * ```ts
- * import { encodePackage, loadPackage } from '@datamoc/mw_games/mwl';
- *
- * const source = "[{ tag: 'package', id: 'marta', version: '1.0.0' }]";
- * const bytes = await encodePackage([{ path: 'content.mwl', data: new TextEncoder().encode(source) }]);
- * console.log((await loadPackage(bytes)).document.meta.id); // 'marta'
- * ```
- */
-export async function loadPackage(bytes, limits = {}) {
-    const decoded = await decodePackage(bytes, limits);
-    const decoder = new TextDecoder('utf-8', { fatal: true });
-    const documents = Object.create(null);
-    for (const file of decoded.files) {
-        if (!file.path.endsWith('.mwl'))
-            continue;
-        try {
-            documents[file.path] = decoder.decode(file.data);
-        }
-        catch {
-            throw new PackageFormatError(`"${file.path}" is not UTF-8 text`);
-        }
-    }
-    if (!Object.hasOwn(documents, decoded.main))
-        throw new PackageFormatError(`main "${decoded.main}" is not a .mwl document`);
-    const document = parsePackageDocument(documents[decoded.main], { file: decoded.main, files: documents });
-    const directory = decoded.entries.map((entry) => `${entry.path}\n${entry.sha256}\n`).join('');
-    return {
-        document,
-        main: decoded.main,
-        files: decoded.files,
-        hash: await sha256Hex(new TextEncoder().encode(directory)),
-    };
-}
-/**
- * The exact identity a save game records: `id@version#sha256`.
- *
- * @example
- * ```ts
- * import { encodePackage, loadPackage, packageRef } from '@datamoc/mw_games/mwl';
- *
- * const source = "[{ tag: 'package', id: 'marta', version: '1.0.0' }]";
- * const bytes = await encodePackage([{ path: 'content.mwl', data: new TextEncoder().encode(source) }]);
- * console.log(packageRef(await loadPackage(bytes)).startsWith('marta@1.0.0#')); // true
- * ```
- */
-export function packageRef(pkg) {
-    return `${pkg.document.meta.id}@${pkg.document.meta.version}#${pkg.hash}`;
-}
-/**
- * Splits a reference written by `packageRef` back into its three parts.
- *
- * @example
- * ```ts
- * import { parsePackageRef } from '@datamoc/mw_games/mwl';
- *
- * console.log(parsePackageRef('marta@1.0.0#abc').version); // '1.0.0'
- * ```
- */
-export function parsePackageRef(ref) {
-    const match = /^([A-Za-z_][\w.-]*)@(\d+\.\d+\.\d+[\w.+-]*)#([0-9a-f]{64}|[\w-]+)$/.exec(ref);
-    if (!match)
-        throw new PackageFormatError(`"${ref}" is not an id@version#sha256 package reference`);
-    return { id: match[1], version: match[2], hash: match[3] };
-}
-/**
- * What a package asks for: its declared capabilities plus `script` when any script carries code.
- *
- * @example
- * ```ts
- * import { parsePackageDocument, requestedCapabilities } from '@datamoc/mw_games/mwl';
- *
- * const document = parsePackageDocument("[{ tag: 'package', id: 'p', version: '1.0.0' }, { tag: 'script', id: 's', on: 'start', code: '1' }]");
- * console.log(requestedCapabilities(document)); // ['script']
- * ```
- */
-export function requestedCapabilities(document) {
-    const capabilities = new Set(document.meta.requires.capabilities);
-    if (document.scripts.some((script) => script.code !== undefined))
-        capabilities.add('script');
-    return [...capabilities].sort();
-}
-/**
- * Evaluates a package against what a game accepts and returns readable refusals; an empty list
- * means accepted. Nothing is executed or fetched: the decision rests on the declared requests.
- *
- * @example
- * ```ts
- * import { checkPackagePolicy, parsePackageDocument } from '@datamoc/mw_games/mwl';
- *
- * const document = parsePackageDocument(
- *   "[{ tag: 'package', id: 'marta', version: '1.0.0', requires: { capabilities: ['script'] } }]",
- * );
- * console.log(checkPackagePolicy(document, { allow: ['audio'] })); // ['asks for the "script" capability, which this game does not allow']
- * ```
- */
-export function checkPackagePolicy(document, policy) {
-    const refusals = [];
-    const { requires } = document.meta;
-    for (const capability of requestedCapabilities(document)) {
-        const known = KNOWN_PACKAGE_CAPABILITIES.includes(capability);
-        if (!policy.allow.includes(capability) && (known || policy.refuseUnknown !== false))
-            refusals.push(`asks for the "${capability}" capability, which this game does not allow`);
-    }
-    const mwg = policy.provides?.mwg ?? mwgVersion;
-    if (requires.mwg !== undefined && !rangeHolds(mwg, requires.mwg, 'requires.mwg', refusals))
-        refusals.push(`requires mwg ${requires.mwg}, this game runs ${mwg}`);
-    if (requires.retroAudio !== undefined) {
-        const provided = policy.provides?.retroAudio;
-        if (provided === undefined)
-            refusals.push(`requires retro-audio ${requires.retroAudio}, which this game does not provide`);
-        else if (!rangeHolds(provided, requires.retroAudio, 'requires.retroAudio', refusals))
-            refusals.push(`requires retro-audio ${requires.retroAudio}, this game provides ${provided}`);
-    }
-    return refusals;
-}
-/** true when the range holds; a malformed range is reported once and counts as holding, to avoid a second message */
-export function rangeHolds(version, range, label, problems) {
-    try {
-        return satisfiesVersionRange(version, range);
-    }
-    catch {
-        problems.push(`${label} "${range}" is not a valid version range`);
-        return true;
-    }
-}
-/**
- * Adds a package to a content set (a new set; the old one is untouched). Dependencies named by
- * `import` must already be in the set. Two versions of one package may coexist: the newest owns
- * the plain `packageId:id` names, every version answers to `packageId@version:id`.
- *
- * @example
- * ```ts
- * import { encodePackage, loadPackage, mergePackage, packageContent } from '@datamoc/mw_games/mwl';
- *
- * const source = "[{ tag: 'package', id: 'marta', version: '1.0.0' }, { tag: 'sound_effect', id: 'ouch', chip: 'sn76489' }]";
- * const bytes = await encodePackage([{ path: 'content.mwl', data: new TextEncoder().encode(source) }]);
- * const set = mergePackage(await loadPackage(bytes));
- * console.log(Object.keys(packageContent(set).soundEffects)); // ['marta:ouch']
- * ```
- */
-export function mergePackage(pkg, into = { packages: [] }) {
-    const { id, version } = pkg.document.meta;
-    if (into.packages.some((other) => other.document.meta.id === id && other.document.meta.version === version))
-        throw new PackageConflictError(`package ${id}@${version} is already in the content set`);
-    for (const dependency of pkg.document.imports) {
-        if (dependency.package === undefined)
-            continue;
-        const present = into.packages.filter((other) => other.document.meta.id === dependency.package);
-        if (!present.some((other) => dependency.version === undefined ||
-            satisfiesVersionRange(other.document.meta.version, dependency.version)))
-            throw new PackageConflictError(`${id}@${version} imports package ${dependency.package}${dependency.version ? ` ${dependency.version}` : ''}, which is not merged`);
-    }
-    return { packages: [...into.packages, pkg] };
-}
-/** the name prefix of a package in a set: the plain id for the newest version, `id@version` for older ones */
-function prefixOf(set, pkg) {
-    const { id, version } = pkg.document.meta;
-    const newest = set.packages
-        .filter((other) => other.document.meta.id === id)
-        .every((other) => compareVersions(version, other.document.meta.version) >= 0);
-    return newest ? id : `${id}@${version}`;
-}
-/**
- * The namespaced view of a set: every id becomes `packageId:id`, and every reference written
- * without a prefix is resolved to the same package first. A reference that already has a prefix
- * points at another package and is left alone. Each item records the package it came from.
- *
- * @example
- * ```ts
- * import { encodePackage, loadPackage, mergePackage, packageContent } from '@datamoc/mw_games/mwl';
- *
- * const source = "[{ tag: 'package', id: 'marta', version: '1.0.0' }, { tag: 'music', id: 'theme', src: 'song' }]";
- * const bytes = await encodePackage([{ path: 'content.mwl', data: new TextEncoder().encode(source) }]);
- * console.log(packageContent(mergePackage(await loadPackage(bytes))).music['marta:theme']?.src); // 'marta:song'
- * ```
- */
-export function packageContent(set) {
-    const out = {
-        assets: {},
-        characters: {},
-        animations: {},
-        soundEffects: {},
-        music: {},
-        scripts: {},
-    };
-    for (const pkg of set.packages) {
-        const prefix = prefixOf(set, pkg);
-        const owner = `${pkg.document.meta.id}@${pkg.document.meta.version}`;
-        const key = (id) => `${prefix}:${id}`;
-        const ref = (name) => (name.includes(':') ? name : key(name));
-        const { document } = pkg;
-        for (const asset of document.assets)
-            out.assets[key(asset.id)] = { ...asset, id: key(asset.id), path: assetPath(prefix, asset), package: owner };
-        for (const item of document.animations)
-            out.animations[key(item.id)] = {
-                ...item,
-                id: key(item.id),
-                events: Object.fromEntries(Object.entries(item.events).map(([frame, event]) => [frame, { sound: ref(event.sound) }])),
-                package: owner,
-            };
-        for (const item of document.soundEffects)
-            out.soundEffects[key(item.id)] = { ...item, id: key(item.id), package: owner };
-        for (const item of document.music)
-            out.music[key(item.id)] = {
-                ...item,
-                id: key(item.id),
-                src: ref(item.src),
-                ...(item.fallback === undefined ? {} : { fallback: ref(item.fallback) }),
-                package: owner,
-            };
-        for (const item of document.scripts)
-            out.scripts[key(item.id)] = {
-                ...item,
-                id: key(item.id),
-                do: item.do.map((action) => qualifyAction(action, ref)),
-                package: owner,
-            };
-        for (const item of document.characters)
-            out.characters[key(item.id)] = {
-                ...item,
-                id: key(item.id),
-                ...(item.portrait === undefined ? {} : { portrait: ref(item.portrait) }),
-                ...(item.sprite === undefined ? {} : { sprite: { ...item.sprite, image: ref(item.sprite.image) } }),
-                ...(item.theme === undefined ? {} : { theme: ref(item.theme) }),
-                animations: mapValues(item.animations, ref),
-                sounds: mapValues(item.sounds, ref),
-                scripts: item.scripts.map(ref),
-                package: owner,
-            };
-    }
-    return out;
-}
-function mapValues(record, map) {
-    return Object.fromEntries(Object.entries(record).map(([name, value]) => [name, map(value)]));
-}
-function qualifyAction(action, ref) {
-    const sound = action.attributes.sound;
-    return action.tag === 'play' && typeof sound === 'string'
-        ? { tag: action.tag, attributes: { ...action.attributes, sound: ref(sound) } }
-        : action;
-}
-/** the logical path the game's asset step serves a package file under */
-function assetPath(prefix, asset) {
-    return `${prefix}/${asset.path}`;
-}
-/** the unit_type attributes a character's stats can set; the rest stay on the character record */
-const UNIT_TYPE_STATS = [
-    'hitpoints',
-    'movement',
-    'level',
-    'experience',
-    'cost',
-    'alignment',
-    'race',
-    'usage',
-    'movetype',
-    'movement_type',
-];
-/**
- * Compiles a content set: each character expands into a `unit_type` named `packageId:id`, and
- * the result is an ordinary compiled game, with the packages' `_()` strings in `messages` and
- * the packages' media paths in `assets`. A set with no package compiles to an empty game.
- *
- * @example
- * ```ts
- * import { compilePackages, encodePackage, loadPackage, mergePackage } from '@datamoc/mw_games/mwl';
- *
- * const source = "[{ tag: 'package', id: 'marta', version: '1.0.0' }, { tag: 'character', id: 'marta', hitpoints: 28 }]";
- * const bytes = await encodePackage([{ path: 'content.mwl', data: new TextEncoder().encode(source) }]);
- * console.log(compilePackages(mergePackage(await loadPackage(bytes))).roots[0]?.attributes.id); // 'marta:marta'
- * ```
- */
-export function compilePackages(set) {
-    const nodes = [];
-    const messages = new Set();
-    const assets = new Set();
-    for (const pkg of set.packages) {
-        const { document } = pkg;
-        const prefix = prefixOf(set, pkg);
-        const location = { file: `${pkg.document.meta.id}/${pkg.main}`, line: 1, column: 1 };
-        for (const message of document.messages)
-            messages.add(message);
-        for (const asset of document.assets)
-            assets.add(assetPath(prefix, asset));
-        for (const character of document.characters) {
-            const attributes = { id: `${prefix}:${character.id}` };
-            if (character.name !== undefined)
-                attributes.name = character.name;
-            if (character.description !== undefined)
-                attributes.description = character.description;
-            for (const stat of UNIT_TYPE_STATS)
-                if (character.stats[stat] !== undefined)
-                    attributes[stat] = String(character.stats[stat]);
-            const pathOf = (id) => {
-                const asset = document.assets.find((candidate) => candidate.id === id);
-                return asset ? assetPath(prefix, asset) : undefined;
-            };
-            const image = character.sprite && pathOf(character.sprite.image);
-            if (image)
-                attributes.image = image;
-            const profile = character.portrait && pathOf(character.portrait);
-            if (profile)
-                attributes.profile = profile;
-            const damage = character.stats.attack;
-            nodes.push({
-                tag: 'unit_type',
-                attributes,
-                children: typeof damage === 'number'
-                    ? [
-                        {
-                            tag: 'attack',
-                            attributes: { id: 'attack', damage: String(damage) },
-                            children: [],
-                            location,
-                        },
-                    ]
-                    : [],
-                location,
-                gettext: [],
-            });
-        }
-    }
-    const game = compileNodes(nodes);
-    return { ...game, messages: [...messages].sort(), assets: [...assets].sort() };
-}
-/**
- * The credits text for the packages present, in the format of the `CREDITS.txt` the asset step
- * writes: one block per package and per asset, each with its licence and, when known, its source.
- *
- * @example
- * ```ts
- * import { generateCredits, parsePackageDocument } from '@datamoc/mw_games/mwl';
- *
- * const document = parsePackageDocument(
- *   "[{ tag: 'package', id: 'marta', version: '1.0.0', author: 'Ada', license: 'CC-BY-4.0' }]",
- * );
- * console.log(generateCredits([document])); // 'marta 1.0.0 by Ada\nLicense: CC-BY-4.0\n'
- * ```
- */
-export function generateCredits(documents) {
-    const blocks = [];
-    for (const { meta, assets } of [...documents].sort((a, b) => a.meta.id < b.meta.id ? -1 : a.meta.id > b.meta.id ? 1 : 0)) {
-        const author = meta.author ? ` by ${meta.author}` : '';
-        if (meta.license)
-            blocks.push(`${meta.id} ${meta.version}${author}\nLicense: ${meta.license}`);
-        for (const asset of [...assets].sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0))) {
-            if (!asset.license)
-                continue;
-            const lines = [`${asset.id} (${meta.id})${author}`, `License: ${asset.license}`];
-            if (asset.source)
-                lines.push(asset.source);
-            blocks.push(lines.join('\n'));
-        }
-    }
-    return blocks.length ? `${blocks.join('\n\n')}\n` : '';
-}
-//# sourceMappingURL=package.js.map

package/dist/mwl/package.js.map

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

package/dist/mwl/persistence.d.ts

@@ -1,67 +0,0 @@
-import type { ActionJournalEntry } from '../core/ActionJournal.ts';
-import type { MwlWorld } from './runtime.ts';
-export interface MwlSaveEnvelope {
-    readonly format: 'mwl-save';
-    readonly version: number;
-    readonly world: MwlWorld;
-    /** Explicitly declared game-owned hook state, keyed by hook id. */
-    readonly hookState?: Readonly<Record<string, unknown>>;
-    /** Public runtime operations and trace batches, when saved by `MwlRuntime`. */
-    readonly journal?: readonly ActionJournalEntry<unknown, unknown>[];
-}
-export type MwlMigration = (world: MwlWorld) => MwlWorld;
-export interface MwlPersistenceOptions {
-    readonly version: number;
-    readonly migrations?: Readonly<Record<number, MwlMigration>>;
-}
-/**
- * Serialises a world to a versioned JSON snapshot.
- *
- * @example
- * ```ts
- * import { createWorld, encodeSave } from '@datamoc/mw_games/mwl';
- *
- * const snapshot = encodeSave(createWorld(), { version: 1 });
- * console.log(typeof snapshot); // 'string'
- * ```
- */
-export declare function encodeSave(world: MwlWorld, options: MwlPersistenceOptions, hookState?: Readonly<Record<string, unknown>>, journal?: readonly ActionJournalEntry<unknown, unknown>[]): string;
-/**
- * Restores a world from a snapshot, applying migrations up to `options.version`.
- *
- * @example
- * ```ts
- * import { createWorld, decodeSave, encodeSave } from '@datamoc/mw_games/mwl';
- *
- * const snapshot = encodeSave(createWorld(), { version: 1 });
- * console.log(decodeSave(snapshot, { version: 1 }).turn); // 1
- * ```
- */
-export declare function decodeSave(snapshot: string, options: MwlPersistenceOptions): MwlWorld;
-/**
- * Restores the complete save envelope, including declared game-owned hook state.
- *
- * @example
- * ```ts
- * import { createWorld, decodeSaveEnvelope, encodeSave } from '@datamoc/mw_games/mwl';
- *
- * const save = encodeSave(createWorld(), { version: 1 }, { 'item-effect:demo': { charges: 1 } });
- * console.log(decodeSaveEnvelope(save, { version: 1 }).hookState?.['item-effect:demo']);
- * ```
- */
-export declare function decodeSaveEnvelope(snapshot: string, options: MwlPersistenceOptions): MwlSaveEnvelope;
-/**
- * Checks a decoded value really is a world, and throws by name when it is not. Also rejects a
- * `__proto__`/`constructor`/`prototype` key anywhere in the value (`assertNoForbiddenKeys`):
- * `MwlRuntime.restore` merges this result into its own world with `Object.assign`, which would
- * otherwise let such a key substitute the target's prototype instead of merely setting a value.
- *
- * @example
- * ```ts
- * import { createWorld, validateWorld } from '@datamoc/mw_games/mwl';
- *
- * console.log(validateWorld(createWorld()).turn); // 1
- * ```
- */
-export declare function validateWorld(value: unknown): MwlWorld;
-//# sourceMappingURL=persistence.d.ts.map

package/dist/mwl/persistence.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/mwl/persistence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG7C,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;CACnE;AACD,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,QAAQ,CAAC;AACzD,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;CAC7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,qBAAqB,EAC9B,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC7C,OAAO,CAAC,EAAE,SAAS,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,GACvD,MAAM,CAWR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,QAAQ,CAErF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,eAAe,CAkBpG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAetD"}

package/dist/mwl/persistence.js

@@ -1,135 +0,0 @@
-import { assertNoForbiddenKeys } from '../core/Sanitize.js';
-import { cloneData } from '../core/Clone.js';
-/**
- * Serialises a world to a versioned JSON snapshot.
- *
- * @example
- * ```ts
- * import { createWorld, encodeSave } from '@datamoc/mw_games/mwl';
- *
- * const snapshot = encodeSave(createWorld(), { version: 1 });
- * console.log(typeof snapshot); // 'string'
- * ```
- */
-export function encodeSave(world, options, hookState, journal) {
-    if (!Number.isInteger(options.version) || options.version < 1)
-        throw new Error('MWL save version must be a positive integer');
-    const envelope = {
-        format: 'mwl-save',
-        version: options.version,
-        world,
-        ...(hookState === undefined ? {} : { hookState: cloneJsonObject(hookState) }),
-        ...(journal === undefined ? {} : { journal: cloneJsonArray(journal) }),
-    };
-    return JSON.stringify(envelope);
-}
-/**
- * Restores a world from a snapshot, applying migrations up to `options.version`.
- *
- * @example
- * ```ts
- * import { createWorld, decodeSave, encodeSave } from '@datamoc/mw_games/mwl';
- *
- * const snapshot = encodeSave(createWorld(), { version: 1 });
- * console.log(decodeSave(snapshot, { version: 1 }).turn); // 1
- * ```
- */
-export function decodeSave(snapshot, options) {
-    return decodeSaveEnvelope(snapshot, options).world;
-}
-/**
- * Restores the complete save envelope, including declared game-owned hook state.
- *
- * @example
- * ```ts
- * import { createWorld, decodeSaveEnvelope, encodeSave } from '@datamoc/mw_games/mwl';
- *
- * const save = encodeSave(createWorld(), { version: 1 }, { 'item-effect:demo': { charges: 1 } });
- * console.log(decodeSaveEnvelope(save, { version: 1 }).hookState?.['item-effect:demo']);
- * ```
- */
-export function decodeSaveEnvelope(snapshot, options) {
-    const value = JSON.parse(snapshot);
-    const envelope = isEnvelope(value) ? value : { format: 'mwl-save', version: 1, world: value };
-    if (envelope.version > options.version)
-        throw new Error(`MWL save version ${envelope.version} is newer than supported version ${options.version}`);
-    let world = validateWorld(envelope.world);
-    for (let version = envelope.version; version < options.version; version++) {
-        const migration = options.migrations?.[version + 1];
-        if (!migration)
-            throw new Error(`missing MWL save migration to version ${version + 1}`);
-        world = validateWorld(migration(world));
-    }
-    return {
-        format: 'mwl-save',
-        version: options.version,
-        world,
-        ...(envelope.hookState === undefined ? {} : { hookState: cloneJsonObject(envelope.hookState) }),
-        ...(envelope.journal === undefined ? {} : { journal: cloneJsonArray(envelope.journal) }),
-    };
-}
-/**
- * Checks a decoded value really is a world, and throws by name when it is not. Also rejects a
- * `__proto__`/`constructor`/`prototype` key anywhere in the value (`assertNoForbiddenKeys`):
- * `MwlRuntime.restore` merges this result into its own world with `Object.assign`, which would
- * otherwise let such a key substitute the target's prototype instead of merely setting a value.
- *
- * @example
- * ```ts
- * import { createWorld, validateWorld } from '@datamoc/mw_games/mwl';
- *
- * console.log(validateWorld(createWorld()).turn); // 1
- * ```
- */
-export function validateWorld(value) {
-    if (!value || typeof value !== 'object')
-        throw new Error('invalid MWL saved world');
-    assertNoForbiddenKeys(value);
-    const world = value;
-    if (!Number.isInteger(world.turn) ||
-        !world.variables ||
-        typeof world.variables !== 'object' ||
-        !world.units ||
-        typeof world.units !== 'object')
-        throw new Error('invalid MWL saved world: turn, variables, and units are required');
-    if (world.status !== undefined && !['playing', 'won', 'lost'].includes(world.status))
-        throw new Error('invalid MWL saved world status');
-    return cloneData(world, 'saved world');
-}
-function isEnvelope(value) {
-    return (!!value &&
-        typeof value === 'object' &&
-        value.format === 'mwl-save' &&
-        typeof value.version === 'number' &&
-        'world' in value);
-}
-function cloneJsonObject(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value))
-        throw new Error('invalid MWL hook state');
-    assertNoForbiddenKeys(value);
-    let encoded;
-    try {
-        encoded = JSON.stringify(value);
-    }
-    catch {
-        throw new Error('MWL hook state must be JSON-serialisable');
-    }
-    const decoded = JSON.parse(encoded);
-    if (!decoded || typeof decoded !== 'object' || Array.isArray(decoded))
-        throw new Error('invalid MWL hook state');
-    return decoded;
-}
-function cloneJsonArray(value) {
-    try {
-        const encoded = JSON.stringify(value);
-        const decoded = JSON.parse(encoded);
-        if (!Array.isArray(decoded))
-            throw new Error();
-        assertNoForbiddenKeys(decoded);
-        return decoded;
-    }
-    catch {
-        throw new Error('MWL journal must be JSON-serialisable');
-    }
-}
-//# sourceMappingURL=persistence.js.map

package/dist/mwl/persistence.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../src/mwl/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAiB7C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CACzB,KAAe,EACf,OAA8B,EAC9B,SAA6C,EAC7C,OAAyD;IAEzD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAoB;QACjC,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK;QACL,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;KACtE,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,OAA8B;IAC1E,OAAO,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC;AACpD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,OAA8B;IAClF,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAmB,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAiB,EAAE,CAAC;IACnH,IAAI,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO;QACrC,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,OAAO,oCAAoC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5G,IAAI,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1C,KAAK,IAAI,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;QAC3E,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC;QACxF,KAAK,GAAG,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,OAAO;QACN,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK;QACL,GAAG,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/F,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;KACxF,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACpF,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,KAA0B,CAAC;IACzC,IACC,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7B,CAAC,KAAK,CAAC,SAAS;QAChB,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,CAAC,KAAK,CAAC,KAAK;QACZ,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAE/B,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACrF,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QACnF,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACnD,OAAO,SAAS,CAAC,KAAiB,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IACjC,OAAO,CACN,CAAC,CAAC,KAAK;QACP,OAAO,KAAK,KAAK,QAAQ;QACxB,KAA8B,CAAC,MAAM,KAAK,UAAU;QACrD,OAAQ,KAA+B,CAAC,OAAO,KAAK,QAAQ;QAC5D,OAAO,IAAI,KAAK,CAChB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAwC;IAChE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC3G,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACJ,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,OAAO,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACjH,OAAO,OAA4C,CAAC;AACrD,CAAC;AAED,SAAS,cAAc,CAAC,KAAyB;IAChD,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,OAAO,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,MAAM,IAAI,KAAK,EAAE,CAAC;QAC/C,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,OAA0D,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC1D,CAAC;AACF,CAAC"}