@datamoc/mw_games 0.43.0 → 0.45.0

package/dist/core/Telemetry.js

@@ -1,83 +0,0 @@
-import { HttpTransport } from './HttpTransport.js';
-/**
- * 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 class TelemetryClient extends HttpTransport {
-    constructor(options) {
-        super(options, 'telemetry');
-        this.consented = false;
-        this.maxStringLength = options.maxStringLength ?? 256;
-        this.maxProperties = options.maxProperties ?? 32;
-        this.allowed = options.allowedProperties ? new Set(options.allowedProperties) : null;
-    }
-    /** whether `send` will actually transmit anything right now */
-    get hasConsent() {
-        return this.consented;
-    }
-    /** a game calls this from its own consent flow; not read from anywhere `mwg` controls */
-    setConsent(granted) {
-        this.consented = granted;
-    }
-    /** sends one structured event; a silent no-op before consent is granted, not an error */
-    async send(event) {
-        if (!event.name)
-            throw new Error('telemetry event needs a name');
-        if (!this.consented)
-            return null;
-        return this.withTimeout(async (signal) => {
-            const response = await this.fetchFn(this.endpoint, {
-                method: 'POST',
-                headers: { 'content-type': 'application/json' },
-                body: JSON.stringify(this.bounded(event)),
-                signal,
-            });
-            if (!response.ok)
-                throw new Error(`telemetry request failed with HTTP ${response.status}`);
-            return { ok: true, status: response.status };
-        });
-    }
-    /**
-     * 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.
-     */
-    bounded(event) {
-        const cut = (value) => value.length > this.maxStringLength ? value.slice(0, this.maxStringLength) : value;
-        if (!event.properties)
-            return { name: cut(event.name) };
-        const properties = {};
-        let count = 0;
-        for (const [key, value] of Object.entries(event.properties)) {
-            if (this.allowed && !this.allowed.has(key))
-                continue;
-            if (count++ >= this.maxProperties)
-                break;
-            properties[cut(key)] = typeof value === 'string' ? cut(value) : value;
-        }
-        return { name: cut(event.name), properties };
-    }
-}
-//# sourceMappingURL=Telemetry.js.map

package/dist/core/Telemetry.js.map

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

package/dist/core/Twee.d.ts

@@ -1,101 +0,0 @@
-/**
- * The Twee-notation parsing engine behind both `two-d/stage.importTwee` and
- * `rpg.importTwee` - the passage/link parsing lives here once, in `core` (already the home
- * of `parseCSV`, another generic text-format parser other modules build their own typed
- * result around), so a bug fix or a format extension lands in one place instead of two
- * silently-drifting copies. `TweeCommand`/`TweeChoice` are structurally compatible with both
- * `two-d/stage`'s `StoryScript`/`StageChoice` and `rpg`'s `EventStoryScript`/`EventChoice` -
- * each module's own `importTwee` wrapper only names its own return type, with no per-field
- * conversion needed.
- *
- * Only structure is imported: each passage's text lines become `say` commands and its
- * `[[links]]` become one closing `ask` whose choices jump (`[[text]]`, `[[text->target]]`
- * and `[[target<-text]]`) - the last text line doubles as the question, since a choice box
- * needs a prompt and repeating it works. No story-format macro language (Harlowe, SugarCube,
- * Chapbook) is interpreted - body text reaches the game untouched, and a link carrying a
- * setter throws instead of silently dropping the behaviour the setter described.
- *
- * ```twee
- * :: Start
- * You stand at a crossroads.
- *
- * [[Take the left path->Left]]
- * [[Take the right path->Right]]
- *
- * :: Left
- * The path ends at a wall.
- * [[Go back->Start]]
- * ```
- *
- * @example
- * ```ts
- * import { parseTwee, type TweeStory } from '@datamoc/mw_games/core';
- *
- * const story: TweeStory = parseTwee(`:: Start
- * Pick a door.
- *
- * [[Left->A]]
- * [[Right->B]]
- *
- * :: A
- * Treasure.
- *
- * :: B
- * Nothing.
- * `);
- * console.log(story.start); // 'Start'
- * ```
- */
-export interface TweeChoice {
-    text: string;
-    goto?: string;
-}
-export type TweeCommand = {
-    say: string;
-} | {
-    ask: string;
-    choices: TweeChoice[];
-};
-export interface TweeStory {
-    story: Record<string, TweeCommand[]>;
-    /** `StoryData`'s start passage when the file names one, else the first passage */
-    start: string;
-    /** the `StoryTitle` passage, when the file has one */
-    title?: string;
-}
-/**
- * Parses Twee passages (`:: Name`, text lines, `[[links]]`) into a `TweeStory`: each passage a list
- * of `say` commands closed by an `ask` when it has links. To play one on a scene, import the source
- * with `importTwee` from `two-d/stage` (or `rpg`), which names that module's own script type.
- *
- * @example
- * ```ts
- * import { parseTwee } from '@datamoc/mw_games/core';
- *
- * const story = parseTwee(`:: Start
- * You reach the gorge.
- *
- * [[Build a bridge->Build]]
- * [[Turn back->Home]]
- *
- * :: Build
- * The planks hold.
- *
- * :: Home
- * You go home.
- * `);
- *
- * function show(passage: string): void {
- * 	for (const command of story.story[passage]) {
- * 		if ('say' in command) console.log(command.say);
- * 		else {
- * 			console.log(command.ask); //the last text line doubles as the question
- * 			for (const choice of command.choices) console.log(' -', choice.text, '->', choice.goto);
- * 		}
- * 	}
- * }
- * show(story.start);
- * ```
- */
-export declare function parseTwee(source: string): TweeStory;
-//# sourceMappingURL=Twee.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Twee.d.ts","sourceRoot":"","sources":["../../src/core/Twee.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAEnF,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACrC,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CA0CnD"}

package/dist/core/Twee.js

@@ -1,174 +0,0 @@
-/**
- * Parses Twee passages (`:: Name`, text lines, `[[links]]`) into a `TweeStory`: each passage a list
- * of `say` commands closed by an `ask` when it has links. To play one on a scene, import the source
- * with `importTwee` from `two-d/stage` (or `rpg`), which names that module's own script type.
- *
- * @example
- * ```ts
- * import { parseTwee } from '@datamoc/mw_games/core';
- *
- * const story = parseTwee(`:: Start
- * You reach the gorge.
- *
- * [[Build a bridge->Build]]
- * [[Turn back->Home]]
- *
- * :: Build
- * The planks hold.
- *
- * :: Home
- * You go home.
- * `);
- *
- * function show(passage: string): void {
- * 	for (const command of story.story[passage]) {
- * 		if ('say' in command) console.log(command.say);
- * 		else {
- * 			console.log(command.ask); //the last text line doubles as the question
- * 			for (const choice of command.choices) console.log(' -', choice.text, '->', choice.goto);
- * 		}
- * 	}
- * }
- * show(story.start);
- * ```
- */
-export function parseTwee(source) {
-    const passages = splitPassages(source);
-    if (passages.length === 0)
-        throw new Error('this twee source has no passages - passages start with ":: Name"');
-    const story = {};
-    let title;
-    let start;
-    for (const passage of passages) {
-        if (passage.name === 'StoryTitle') {
-            title = passage.body.trim() || undefined;
-            continue;
-        }
-        if (passage.name === 'StoryData') {
-            start = readStart(passage.body);
-            continue;
-        }
-        if (Object.prototype.hasOwnProperty.call(story, passage.name)) {
-            throw new Error(`this twee source defines "${passage.name}" twice`);
-        }
-        story[passage.name] = passageCommands(passage.name, passage.body);
-    }
-    const names = Object.keys(story);
-    if (names.length === 0)
-        throw new Error('this twee source has no story passages, only StoryTitle/StoryData');
-    if (start !== undefined && !Object.prototype.hasOwnProperty.call(story, start)) {
-        throw new Error(`StoryData starts at "${start}", which is not a passage in this file`);
-    }
-    for (const [name, commands] of Object.entries(story)) {
-        for (const command of commands) {
-            if ('ask' in command) {
-                for (const choice of command.choices) {
-                    if (choice.goto !== undefined && !Object.prototype.hasOwnProperty.call(story, choice.goto)) {
-                        throw new Error(`passage "${name}" links to "${choice.goto}", which is not a passage in this file`);
-                    }
-                }
-            }
-        }
-    }
-    return { story, start: start ?? names[0], title };
-}
-/** cuts the source at every line starting with `::`, parsing headers into names */
-function splitPassages(source) {
-    const out = [];
-    let name = null;
-    let body = [];
-    const flush = () => {
-        if (name !== null)
-            out.push({ name, body: body.join('\n') });
-    };
-    for (const line of source.split('\n')) {
-        if (line.startsWith('::')) {
-            flush();
-            name = parseHeader(line);
-            body = [];
-        }
-        else if (name !== null) {
-            body.push(line);
-        }
-    }
-    flush();
-    return out;
-}
-/** `:: Name [tags] {"meta": true}` - only the name survives; tags and position are editor concerns */
-function parseHeader(line) {
-    const rest = line.slice(2).trim();
-    const tagAt = rest.search(/[[{]/);
-    const name = (tagAt === -1 ? rest : rest.slice(0, tagAt)).trim();
-    if (!name)
-        throw new Error(`a twee passage header needs a name, got "${line}"`);
-    return name;
-}
-/** StoryData is JSON; only `start` matters to the runner, the rest is player furniture */
-function readStart(body) {
-    let data;
-    try {
-        data = JSON.parse(body.trim());
-    }
-    catch {
-        throw new Error('StoryData must be JSON - check the braces');
-    }
-    if (typeof data !== 'object' || data === null || Array.isArray(data)) {
-        throw new Error('StoryData must be a JSON object');
-    }
-    const start = data.start;
-    if (start !== undefined && typeof start !== 'string') {
-        throw new Error('StoryData "start" must be a passage name');
-    }
-    return start;
-}
-/** text lines speak in order; the last one doubles as the prompt when links follow it */
-function passageCommands(passage, body) {
-    const lines = [];
-    const choices = [];
-    for (const line of body.split('\n')) {
-        const text = extractLinks(line, choices, passage).replace(/\s+/g, ' ').trim();
-        if (text !== '')
-            lines.push(text);
-    }
-    if (choices.length === 0)
-        return lines.map((say) => ({ say }));
-    const prompt = lines.pop() ?? '';
-    return [...lines.map((say) => ({ say })), { ask: prompt, choices }];
-}
-/**
- * Pulls `[[links]]` out of a line, leaving the surrounding text behind.
- * Returns the line with the links removed.
- */
-function extractLinks(line, choices, passage) {
-    let out = '';
-    let rest = line;
-    for (;;) {
-        const open = rest.indexOf('[[');
-        if (open === -1)
-            return out + rest;
-        const close = rest.indexOf(']]', open);
-        if (close === -1) {
-            throw new Error(`passage "${passage}" has a "[[" with no closing "]]" in "${line.trim()}"`);
-        }
-        out += rest.slice(0, open);
-        choices.push(parseLink(rest.slice(open + 2, close), passage));
-        rest = rest.slice(close + 2);
-    }
-}
-function parseLink(inner, passage) {
-    if (inner.includes('[') || inner.includes(']')) {
-        throw new Error(`passage "${passage}" links with a setter ("${inner.trim()}") - ` +
-            'story-format macros are not imported, so the link is refused rather than half-read');
-    }
-    const forward = inner.indexOf('->');
-    if (forward !== -1) {
-        return { text: inner.slice(0, forward).trim(), goto: inner.slice(forward + 2).trim() };
-    }
-    const backward = inner.indexOf('<-');
-    if (backward !== -1) {
-        return { text: inner.slice(backward + 2).trim(), goto: inner.slice(0, backward).trim() };
-    }
-    const target = inner.trim();
-    return { text: target, goto: target };
-}
-//# sourceMappingURL=Twee.js.map

package/dist/core/Twee.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Twee.js","sourceRoot":"","sources":["../../src/core/Twee.ts"],"names":[],"mappings":"AA+DA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc;IACvC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IAE/G,MAAM,KAAK,GAAkC,EAAE,CAAC;IAChD,IAAI,KAAyB,CAAC;IAC9B,IAAI,KAAyB,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACnC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;YACzC,SAAS;QACV,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClC,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAChC,SAAS;QACV,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,CAAC,IAAI,SAAS,CAAC,CAAC;QACrE,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAC7G,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,wCAAwC,CAAC,CAAC;IACxF,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAChC,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;gBACtB,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACtC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC5F,MAAM,IAAI,KAAK,CACd,YAAY,IAAI,eAAe,MAAM,CAAC,IAAI,wCAAwC,CAClF,CAAC;oBACH,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;AACnD,CAAC;AAOD,mFAAmF;AACnF,SAAS,aAAa,CAAC,MAAc;IACpC,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,IAAI,IAAI,GAAa,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,GAAG,EAAE;QAClB,IAAI,IAAI,KAAK,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,KAAK,EAAE,CAAC;YACR,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,GAAG,EAAE,CAAC;QACX,CAAC;aAAM,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACF,CAAC;IACD,KAAK,EAAE,CAAC;IACR,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,sGAAsG;AACtG,SAAS,WAAW,CAAC,IAAY;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjE,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,GAAG,CAAC,CAAC;IAChF,OAAO,IAAI,CAAC;AACb,CAAC;AAED,0FAA0F;AAC1F,SAAS,SAAS,CAAC,IAAY;IAC9B,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACJ,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,KAAK,GAAI,IAA4B,CAAC,KAAK,CAAC;IAClD,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,yFAAyF;AACzF,SAAS,eAAe,CAAC,OAAe,EAAE,IAAY;IACrD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9E,IAAI,IAAI,KAAK,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IACjC,OAAO,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,IAAY,EAAE,OAAqB,EAAE,OAAe;IACzE,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,SAAS,CAAC;QACT,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,CAAC,CAAC;YAAE,OAAO,GAAG,GAAG,IAAI,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,yCAAyC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7F,CAAC;QACD,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9D,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC;AACF,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,OAAe;IAChD,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACd,YAAY,OAAO,2BAA2B,KAAK,CAAC,IAAI,EAAE,OAAO;YAChE,oFAAoF,CACrF,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IACxF,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC1F,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC"}

package/dist/core/Tween.d.ts

@@ -1,60 +0,0 @@
-/**
- * The one interpolation primitive every dt-driven feature wants: given a duration and a
- * function of progress, run it from 0 to 1 and resolve. `DialogueStage`'s fades and
- * `render.Camera`'s shake decay each used to hand-roll this same shape under a different
- * name; this is that shape, pulled out once.
- */
-import { type MotionIntent } from './Motion.ts';
-export type Easing = (t: number) => number;
-/** a small standard set, named the way CSS and most engines already do */
-export declare const Easing: Record<'linear' | 'easeInQuad' | 'easeOutQuad' | 'easeInOutQuad' | 'easeInCubic' | 'easeOutCubic' | 'easeInOutCubic', Easing>;
-export interface TweenOptions {
-    /** defaults to `Easing.linear` */
-    ease?: Easing;
-    /**
-     * What the motion is for. `decorative` (the default: a slide, spin, zoom or anything
-     * large or peripheral) collapses under reduced motion; `meaningful` is shortened
-     * instead, so state that motion conveys is still readable. See `core.MotionIntent`.
-     */
-    intent?: MotionIntent;
-    /**
-     * A non-vestibular variant to run instead of `apply` under reduced motion, for the case
-     * the preference asks for rather than removal: `(t) => (sprite.alpha = t)` beside an
-     * `apply` that slides and fades. It runs over the shortened duration, not the full one.
-     * Not used when the preference is off.
-     */
-    alternate?: (t: number) => void;
-}
-/**
- * Runs any number of concurrent tweens; a game or a widget drives it from its own `update(dt)`.
- *
- * @example
- * ```ts
- * import { Tweener, Easing } from '@datamoc/mw_games/core';
- *
- * const tweener = new Tweener();
- * const sprite = { alpha: 0 };
- *
- * tweener.tween(0.5, (t) => { sprite.alpha = t; }, Easing.easeOutQuad);
- *
- * // in the game loop:
- * tweener.update(1 / 60);
- * ```
- */
-export declare class Tweener {
-    private tweens;
-    /**
-     * Runs `apply` with progress eased from 0 to 1 over `duration` seconds, resolving once it
-     * reaches 1. A non-positive duration applies the end state at once rather than waiting a
-     * frame for it, and so does a `decorative` motion under reduced motion
-     * (`core.reducedMotion`); a `meaningful` one is shortened instead, and an `alternate`
-     * replaces it outright. See `TweenOptions`.
-     */
-    tween(duration: number, apply: (t: number) => void, options?: Easing | TweenOptions): Promise<void>;
-    update(dt: number): void;
-    /** true while any tween is still running */
-    get isBusy(): boolean;
-    /** drops every running tween without applying its end state or resolving it - a teardown, not a completion */
-    clear(): void;
-}
-//# sourceMappingURL=Tween.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Tween.d.ts","sourceRoot":"","sources":["../../src/core/Tween.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/E,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAE3C,0EAA0E;AAC1E,eAAO,MAAM,MAAM,EAAE,MAAM,CAC1B,QAAQ,GAAG,YAAY,GAAG,aAAa,GAAG,eAAe,GAAG,aAAa,GAAG,cAAc,GAAG,gBAAgB,EAC7G,MAAM,CASN,CAAC;AAEF,MAAM,WAAW,YAAY;IAC5B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAYD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,OAAO;IACnB,OAAO,CAAC,MAAM,CAAqB;IAEnC;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAAE,OAAO,GAAE,MAAM,GAAG,YAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BjH;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAwBvB;IAED,4CAA4C;IAC5C,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,8GAA8G;IAC9G,KAAK,IAAI,IAAI,CAEZ;CACD"}

package/dist/core/Tween.js

@@ -1,98 +0,0 @@
-/**
- * The one interpolation primitive every dt-driven feature wants: given a duration and a
- * function of progress, run it from 0 to 1 and resolve. `DialogueStage`'s fades and
- * `render.Camera`'s shake decay each used to hand-roll this same shape under a different
- * name; this is that shape, pulled out once.
- */
-import { motionDuration, reducedMotion } from './Motion.js';
-/** a small standard set, named the way CSS and most engines already do */
-export const Easing = {
-    linear: (t) => t,
-    easeInQuad: (t) => t * t,
-    easeOutQuad: (t) => t * (2 - t),
-    easeInOutQuad: (t) => (t < 0.5 ? 2 * t * t : 1 - (-2 * t + 2) ** 2 / 2),
-    easeInCubic: (t) => t * t * t,
-    easeOutCubic: (t) => 1 - (1 - t) ** 3,
-    easeInOutCubic: (t) => (t < 0.5 ? 4 * t * t * t : 1 - (-2 * t + 2) ** 3 / 2),
-};
-/**
- * Runs any number of concurrent tweens; a game or a widget drives it from its own `update(dt)`.
- *
- * @example
- * ```ts
- * import { Tweener, Easing } from '@datamoc/mw_games/core';
- *
- * const tweener = new Tweener();
- * const sprite = { alpha: 0 };
- *
- * tweener.tween(0.5, (t) => { sprite.alpha = t; }, Easing.easeOutQuad);
- *
- * // in the game loop:
- * tweener.update(1 / 60);
- * ```
- */
-export class Tweener {
-    constructor() {
-        this.tweens = [];
-    }
-    /**
-     * Runs `apply` with progress eased from 0 to 1 over `duration` seconds, resolving once it
-     * reaches 1. A non-positive duration applies the end state at once rather than waiting a
-     * frame for it, and so does a `decorative` motion under reduced motion
-     * (`core.reducedMotion`); a `meaningful` one is shortened instead, and an `alternate`
-     * replaces it outright. See `TweenOptions`.
-     */
-    tween(duration, apply, options = Easing.linear) {
-        const { ease = Easing.linear, intent = 'decorative', alternate, } = typeof options === 'function' ? { ease: options } : options;
-        //the alternate *replaces* the motion, so it runs even though the original is a trigger
-        const substituting = reducedMotion() && alternate !== undefined;
-        const run = substituting ? alternate : apply;
-        const effective = motionDuration(duration, substituting ? 'meaningful' : intent);
-        if (!(effective > 0)) {
-            run(1);
-            return Promise.resolve();
-        }
-        return new Promise((resolve) => {
-            this.tweens.push({
-                elapsed: 0,
-                duration: effective,
-                ease,
-                apply: run,
-                resolve,
-                finishOnReduced: !substituting && intent === 'decorative',
-            });
-        });
-    }
-    update(dt) {
-        if (this.tweens.length === 0)
-            return;
-        //iterate a copy: a tween's resolve may start another, which must not be advanced
-        //again within this same update
-        for (const tween of [...this.tweens]) {
-            //the preference can arrive while this is running; a decorative motion has no
-            //reason to keep moving once it does
-            if (tween.finishOnReduced && reducedMotion()) {
-                this.tweens.splice(this.tweens.indexOf(tween), 1);
-                tween.apply(1);
-                tween.resolve();
-                continue;
-            }
-            tween.elapsed += dt;
-            const t = Math.min(1, tween.elapsed / tween.duration);
-            tween.apply(tween.ease(t));
-            if (t >= 1) {
-                this.tweens.splice(this.tweens.indexOf(tween), 1);
-                tween.resolve();
-            }
-        }
-    }
-    /** true while any tween is still running */
-    get isBusy() {
-        return this.tweens.length > 0;
-    }
-    /** drops every running tween without applying its end state or resolving it - a teardown, not a completion */
-    clear() {
-        this.tweens = [];
-    }
-}
-//# sourceMappingURL=Tween.js.map

package/dist/core/Tween.js.map

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

package/dist/core/UndoHistory.d.ts

@@ -1,52 +0,0 @@
-/**
- * A bounded, generic back/forward step through recent turns - a mode a game opts into
- * (useless in a permadeath roguelike, useful elsewhere), agnostic about what "a turn's
- * state" actually contains the same way `SaveSystem` is agnostic about what "the save"
- * contains: a game serializes its own turn-scoped state (a `Level`, a `BoardGrid`, whatever
- * it has) and this only ever stores and replays snapshots of it, never interprets them.
- *
- * Distinct from `Recorder`/`Player` (item 42), which replay a whole `Input.onAction` log
- * deterministically for testing, not a bounded, player-facing "undo my last move".
- *
- * @example
- * ```ts
- * import { UndoHistory } from '@datamoc/mw_games/core';
- *
- * interface TurnState { x: number; y: number }
- *
- * const history = new UndoHistory<TurnState>({ limit: 20 });
- * history.push({ x: 0, y: 0 });
- * history.push({ x: 1, y: 0 });
- *
- * if (history.canUndo) {
- *   const previous = history.undo();
- * }
- * ```
- */
-export interface UndoHistoryOptions {
-    /** states retained before the oldest is dropped; defaults to 50 */
-    limit?: number;
-}
-export declare class UndoHistory<T> {
-    private history;
-    private cursor;
-    private readonly limit;
-    constructor(options?: UndoHistoryOptions);
-    /**
-     * Records `state` as the new current point - the normal "a turn was taken" case. Any
-     * redo history beyond the current point is discarded, the same rule undo/redo everywhere
-     * follows: taking a new turn after undoing invalidates whatever future it undid away from.
-     */
-    push(state: T): void;
-    get canUndo(): boolean;
-    get canRedo(): boolean;
-    /** steps back one state and returns it; null when already at the oldest retained state */
-    undo(): T | null;
-    /** steps forward one state and returns it; null when already at the newest state */
-    redo(): T | null;
-    /** the state at the current point, or null before anything has ever been pushed */
-    get current(): T | null;
-    /** drops everything - a new game, a floor transition, anywhere undoing across the boundary makes no sense */
-    clear(): void;
-}
-//# sourceMappingURL=UndoHistory.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"UndoHistory.d.ts","sourceRoot":"","sources":["../../src/core/UndoHistory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,kBAAkB;IAClC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,WAAW,CAAC,CAAC;IACzB,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,YAAY,OAAO,GAAE,kBAAuB,EAE3C;IAED;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAKnB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,0FAA0F;IAC1F,IAAI,IAAI,CAAC,GAAG,IAAI,CAIf;IAED,oFAAoF;IACpF,IAAI,IAAI,CAAC,GAAG,IAAI,CAIf;IAED,mFAAmF;IACnF,IAAI,OAAO,IAAI,CAAC,GAAG,IAAI,CAEtB;IAED,6GAA6G;IAC7G,KAAK,IAAI,IAAI,CAGZ;CACD"}

package/dist/core/UndoHistory.js

@@ -1,49 +0,0 @@
-export class UndoHistory {
-    constructor(options = {}) {
-        this.history = [];
-        this.cursor = -1;
-        this.limit = Math.max(1, options.limit ?? 50);
-    }
-    /**
-     * Records `state` as the new current point - the normal "a turn was taken" case. Any
-     * redo history beyond the current point is discarded, the same rule undo/redo everywhere
-     * follows: taking a new turn after undoing invalidates whatever future it undid away from.
-     */
-    push(state) {
-        this.history.length = this.cursor + 1;
-        this.history.push(state);
-        if (this.history.length > this.limit)
-            this.history.shift();
-        this.cursor = this.history.length - 1;
-    }
-    get canUndo() {
-        return this.cursor > 0;
-    }
-    get canRedo() {
-        return this.cursor < this.history.length - 1;
-    }
-    /** steps back one state and returns it; null when already at the oldest retained state */
-    undo() {
-        if (!this.canUndo)
-            return null;
-        this.cursor--;
-        return this.history[this.cursor];
-    }
-    /** steps forward one state and returns it; null when already at the newest state */
-    redo() {
-        if (!this.canRedo)
-            return null;
-        this.cursor++;
-        return this.history[this.cursor];
-    }
-    /** the state at the current point, or null before anything has ever been pushed */
-    get current() {
-        return this.cursor >= 0 ? this.history[this.cursor] : null;
-    }
-    /** drops everything - a new game, a floor transition, anywhere undoing across the boundary makes no sense */
-    clear() {
-        this.history = [];
-        this.cursor = -1;
-    }
-}
-//# sourceMappingURL=UndoHistory.js.map

package/dist/core/UndoHistory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"UndoHistory.js","sourceRoot":"","sources":["../../src/core/UndoHistory.ts"],"names":[],"mappings":"AA8BA,MAAM,OAAO,WAAW;IAKvB,YAAY,OAAO,GAAuB,EAAE;QAJpC,YAAO,GAAQ,EAAE,CAAC;QAClB,WAAM,GAAG,CAAC,CAAC,CAAC;QAInB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,KAAQ;QACZ,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC3D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,0FAA0F;IAC1F,IAAI;QACH,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,oFAAoF;IACpF,IAAI;QACH,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,mFAAmF;IACnF,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,CAAC;IAED,6GAA6G;IAC7G,KAAK;QACJ,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClB,CAAC;CACD"}