@datamoc/mw_games 0.43.0 → 0.45.0

package/dist/rpg/Quest.js

@@ -1,221 +0,0 @@
-import { conditionHolds } from './Event.js';
-/**
- * Tracks which stage every known quest is on, against `GameState`'s existing switches and
- * variables - not a storage mechanism of its own. A quest's *definition* (its stages, its
- * prerequisites) is static game content, supplied once, the same way the dungeon example's
- * `ITEMS` table is; only which stage each quest has reached is what gets saved.
- *
- * @example
- * ```ts
- * import { QuestLog, GameState } from '@datamoc/mw_games/rpg';
- *
- * const state = new GameState();
- * const quests = new QuestLog();
- * quests.define({ id: 'rats', stages: [{ counter: { variable: 'ratsKilled', target: 5 } }] });
- *
- * quests.track('rats');
- * state.setVariable('ratsKilled', 5);
- * quests.advanceStage('rats', state); // true - the counter stage is satisfied
- *
- * console.log(quests.status('rats')); // 'complete'
- * ```
- */
-export class QuestLog {
-    constructor() {
-        this.definitions = new Map();
-        /** the stage index a started quest is on; absent means not yet started */
-        this.stageIndex = new Map();
-        /** the one active quest a game currently points the player towards, if any */
-        this.tracked = null;
-    }
-    define(quest) {
-        this.definitions.set(quest.id, quest);
-    }
-    /** marks `id` as the quest a game currently guides the player towards; `null` to clear it */
-    track(id) {
-        if (id !== null)
-            this.require(id);
-        this.tracked = id;
-    }
-    /** the currently tracked quest id, or `null` if none is tracked or it is no longer active */
-    trackedQuest() {
-        return this.tracked !== null && this.status(this.tracked) === 'active' ? this.tracked : null;
-    }
-    /** where the tracked quest's current stage is satisfied, if it says anywhere at all */
-    trackedLocation() {
-        const id = this.trackedQuest();
-        return id ? (this.currentStage(id)?.location ?? null) : null;
-    }
-    /**
-     * Derives what an NPC tied to `ids` currently has to offer - see `QuestMarker`. Checking
-     * several ids at once covers an NPC that gives one quest and takes in another.
-     */
-    markerFor(ids, state) {
-        if (ids.some((id) => this.status(id) === 'active' && this.stageSatisfied(id, state)))
-            return 'turnIn';
-        if (ids.some((id) => this.status(id) === 'available'))
-            return 'offer';
-        return 'none';
-    }
-    /** whether every prerequisite is already complete, so the quest could be started */
-    canStart(id) {
-        const quest = this.require(id);
-        return (quest.requires ?? []).every((r) => this.status(r) === 'complete');
-    }
-    /** begins a quest; throws if a prerequisite is not yet complete */
-    start(id) {
-        if (!this.canStart(id))
-            throw new Error(`quest "${id}" cannot start yet - a prerequisite is incomplete`);
-        this.stageIndex.set(id, 0);
-    }
-    status(id) {
-        const quest = this.require(id);
-        const index = this.stageIndex.get(id);
-        if (index === undefined)
-            return this.canStart(id) ? 'available' : 'unavailable';
-        return index >= quest.stages.length ? 'complete' : 'active';
-    }
-    /** the stage a quest is currently on; `null` once complete or before it has started */
-    currentStage(id) {
-        if (this.status(id) !== 'active')
-            return null;
-        return this.require(id).stages[this.stageIndex.get(id)];
-    }
-    /** progress, 0 to 1, towards the current stage's counter; `null` for a condition stage */
-    progress(id, state) {
-        const stage = this.currentStage(id);
-        if (!stage?.counter)
-            return null;
-        return Math.min(1, state.variable(stage.counter.variable) / stage.counter.target);
-    }
-    /**
-     * Moves a quest on if its current stage's condition or counter is now satisfied.
-     *
-     * A game calls this after anything that might have finished a stage - an event, a kill,
-     * picking up an item - the same way `EventRunner` re-checks `activePage` rather than
-     * being told directly when to move on. A single call advances at most one stage, even if
-     * the next one would also already be satisfied; call it again (a fresh turn, a fresh
-     * check) to walk through several at once.
-     *
-     * Named `advanceStage` rather than `advance`, because everything else called `advance` in
-     * this framework ticks a clock forward by whole turns (`TurnClock`, `Charges`, `Field`,
-     * `Barrier`, `AbilityCycle`). This advances a quest through its stage list, which is not
-     * time passing at all, and sharing the word made both harder to read.
-     *
-     * @returns true if a stage (or the whole quest) completed this call
-     */
-    advanceStage(id, state) {
-        if (!this.stageSatisfied(id, state))
-            return false;
-        this.stageIndex.set(id, this.stageIndex.get(id) + 1);
-        return true;
-    }
-    /** whether the current stage's condition or counter already holds, without advancing it */
-    stageSatisfied(id, state) {
-        const stage = this.currentStage(id);
-        if (!stage)
-            return false;
-        return stage.condition
-            ? conditionHolds(stage.condition, state)
-            : stage.counter
-                ? state.variable(stage.counter.variable) >= stage.counter.target
-                : true;
-    }
-    require(id) {
-        const quest = this.definitions.get(id);
-        if (!quest)
-            throw new Error(`no such quest: "${id}"`);
-        return quest;
-    }
-    toJSON() {
-        return { stageIndex: [...this.stageIndex], tracked: this.tracked };
-    }
-    /** rebuilds a log from save data - `definitions` are supplied fresh, the same as `ITEMS` */
-    static fromJSON(definitions, data) {
-        const log = new QuestLog();
-        for (const quest of definitions)
-            log.define(quest);
-        for (const [id, index] of data.stageIndex)
-            log.stageIndex.set(id, index);
-        if (data.tracked)
-            log.tracked = data.tracked;
-        return log;
-    }
-}
-/**
- * Groups a flat table of stage rows into `QuestDefinition`s a `QuestLog` can `define` - the
- * same relational shape `core.parseCSV` already models for a flat table (`actors.AffixTable`,
- * `actors.buildEntities`): a content designer edits two spreadsheet columns (which quest,
- * which stage) instead of a hand-written `.ts` object literal nesting every quest's stage
- * array. Row order is preserved as stage order within a quest, and first-seen order across
- * the table as quest order.
- *
- * `requires` is only read off a quest's first row - a quest cannot require something
- * different depending on which of its own stage rows a spreadsheet author happened to fill
- * it in on, so only the first counts and a later row's `requires` is ignored.
- *
- * @example
- * ```ts
- * import { parseCSV } from '@datamoc/mw_games/core';
- * import { questsFromRows, QuestLog, type QuestStageRow } from '@datamoc/mw_games/rpg';
- *
- * const csv = `questId,counterVariable,counterTarget,description
- * rats,ratsKilled,5,Kill 5 rats
- * rats,,,Report back to the innkeeper`;
- *
- * const rows = parseCSV<QuestStageRow>(csv, { columns: { counterTarget: 'number' } });
- * const quests = questsFromRows(rows);
- *
- * const log = new QuestLog();
- * for (const quest of quests) log.define(quest);
- * ```
- */
-export function questsFromRows(rows) {
-    const order = [];
-    const byId = new Map();
-    for (const row of rows) {
-        let quest = byId.get(row.questId);
-        if (!quest) {
-            quest = { id: row.questId, stages: [] };
-            if (row.requires !== undefined)
-                quest.requires = row.requires;
-            byId.set(row.questId, quest);
-            order.push(row.questId);
-        }
-        quest.stages.push(stageFromRow(quest.id, row));
-    }
-    return order.map((id) => byId.get(id));
-}
-function stageFromRow(questId, row) {
-    if (row.conditionSwitch !== undefined && row.conditionVariable !== undefined) {
-        throw new Error(`quest "${questId}": a stage row cannot name both a condition switch and a condition variable`);
-    }
-    const stage = {};
-    if (row.conditionSwitch !== undefined) {
-        if (row.conditionEquals === undefined)
-            throw new Error(`quest "${questId}": conditionSwitch needs a conditionEquals`);
-        stage.condition = { switch: row.conditionSwitch, equals: row.conditionEquals };
-    }
-    else if (row.conditionVariable !== undefined) {
-        if (row.conditionAtLeast === undefined)
-            throw new Error(`quest "${questId}": conditionVariable needs a conditionAtLeast`);
-        stage.condition = { variable: row.conditionVariable, atLeast: row.conditionAtLeast };
-    }
-    if (row.counterVariable !== undefined) {
-        if (row.counterTarget === undefined)
-            throw new Error(`quest "${questId}": counterVariable needs a counterTarget`);
-        stage.counter = { variable: row.counterVariable, target: row.counterTarget };
-    }
-    if (row.description !== undefined)
-        stage.description = row.description;
-    if (row.locationMap !== undefined || row.locationX !== undefined || row.locationY !== undefined) {
-        if (row.locationX === undefined || row.locationY === undefined) {
-            throw new Error(`quest "${questId}": a stage location needs both locationX and locationY`);
-        }
-        stage.location = { x: row.locationX, y: row.locationY };
-        if (row.locationMap !== undefined)
-            stage.location.map = row.locationMap;
-    }
-    return stage;
-}
-//# sourceMappingURL=Quest.js.map

package/dist/rpg/Quest.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Quest.js","sourceRoot":"","sources":["../../src/rpg/Quest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAuB,MAAM,YAAY,CAAC;AA6CjE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,QAAQ;IAArB;QACS,gBAAW,GAAG,IAAI,GAAG,EAA2B,CAAC;QAEzD,0EAA0E;QAClE,eAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;QAE/C,8EAA8E;QACtE,YAAO,GAAkB,IAAI,CAAC;IAyHvC,CAAC;IAvHA,MAAM,CAAC,KAAsB;QAC5B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,6FAA6F;IAC7F,KAAK,CAAC,EAAiB;QACtB,IAAI,EAAE,KAAK,IAAI;YAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,6FAA6F;IAC7F,YAAY;QACX,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9F,CAAC;IAED,uFAAuF;IACvF,eAAe;QACd,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,GAAsB,EAAE,KAAgB;QACjD,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAAE,OAAO,QAAQ,CAAC;QACtG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,WAAW,CAAC;YAAE,OAAO,OAAO,CAAC;QACtE,OAAO,MAAM,CAAC;IACf,CAAC;IAED,oFAAoF;IACpF,QAAQ,CAAC,EAAU;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC;IAC3E,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,EAAU;QACf,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,mDAAmD,CAAC,CAAC;QACzG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,EAAU;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC;QAChF,OAAO,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7D,CAAC;IAED,uFAAuF;IACvF,YAAY,CAAC,EAAU;QACtB,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,CAAC;IAC1D,CAAC;IAED,0FAA0F;IAC1F,QAAQ,CAAC,EAAU,EAAE,KAAgB;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,OAAO;YAAE,OAAO,IAAI,CAAC;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,EAAU,EAAE,KAAgB;QACxC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAElD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAE,GAAG,CAAC,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,2FAA2F;IACnF,cAAc,CAAC,EAAU,EAAE,KAAgB;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QAEzB,OAAO,KAAK,CAAC,SAAS;YACrB,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC;YACxC,CAAC,CAAC,KAAK,CAAC,OAAO;gBACd,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM;gBAChE,CAAC,CAAC,IAAI,CAAC;IACV,CAAC;IAEO,OAAO,CAAC,EAAU;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;QACtD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM;QACL,OAAO,EAAE,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IACpE,CAAC;IAED,4FAA4F;IAC5F,MAAM,CAAC,QAAQ,CACd,WAA8B,EAC9B,IAAiE;QAEjE,MAAM,GAAG,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,WAAW;YAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnD,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU;YAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACzE,IAAI,IAAI,CAAC,OAAO;YAAE,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7C,OAAO,GAAG,CAAC;IACZ,CAAC;CACD;AAuBD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,cAAc,CAAC,IAA8B;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEhD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,KAAK,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YACxC,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS;gBAAE,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;YAC9D,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,GAAkB;IACxD,IAAI,GAAG,CAAC,eAAe,KAAK,SAAS,IAAI,GAAG,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,6EAA6E,CAAC,CAAC;IACjH,CAAC;IAED,MAAM,KAAK,GAAe,EAAE,CAAC;IAE7B,IAAI,GAAG,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACvC,IAAI,GAAG,CAAC,eAAe,KAAK,SAAS;YACpC,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,4CAA4C,CAAC,CAAC;QAChF,KAAK,CAAC,SAAS,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC;IAChF,CAAC;SAAM,IAAI,GAAG,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAChD,IAAI,GAAG,CAAC,gBAAgB,KAAK,SAAS;YACrC,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,+CAA+C,CAAC,CAAC;QACnF,KAAK,CAAC,SAAS,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,iBAAiB,EAAE,OAAO,EAAE,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACtF,CAAC;IAED,IAAI,GAAG,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACvC,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS;YAClC,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,0CAA0C,CAAC,CAAC;QAC9E,KAAK,CAAC,OAAO,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,CAAC,aAAa,EAAE,CAAC;IAC9E,CAAC;IAED,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IAEvE,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjG,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,wDAAwD,CAAC,CAAC;QAC5F,CAAC;QACD,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;QACxD,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS;YAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC;IACzE,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/rpg/automap.d.ts

@@ -1,81 +0,0 @@
-/**
- * The slice of a tile map automapping reads and writes, named rather than imported.
- *
- * Automapping is a grid transform: it matches patterns of tile indices and writes tile
- * indices back. Naming `render.TileMap` for that pulled a whole 2D renderer into `mwg/rpg`
- * for two method signatures, which is why this is an interface instead - a real `TileMap`
- * satisfies it structurally, and so does any other grid a game keeps its own way.
- */
-export interface AutomapTarget {
-    readonly widthInTiles: number;
-    readonly heightInTiles: number;
-    /** optional topology, used to reject a rule authored for the other map shape */
-    readonly shape?: 'square' | 'hex' | 'isometric' | 'staggered';
-    getTile(layer: string | number, x: number, y: number): number;
-    setTile(layer: string | number, x: number, y: number, value: number): void;
-}
-/**
- * The wildcard: an `input` cell holding it constrains nothing, an `output` cell holding it
- * leaves the target alone.
- *
- * Deliberately the same value as `two-d/render`'s own `EMPTY`, declared here rather than
- * imported so this module needs no renderer. `tests/automap.test.ts` asserts the two stay
- * equal, the same way the version test pins `version.ts` to `package.json`.
- *
- * @example
- * ```ts
- * import { automap, AUTOMAP_EMPTY, type AutomapTarget, type AutomapRule } from '@datamoc/mw_games/rpg';
- *
- * declare const map: AutomapTarget; // a real two-d/render.TileMap satisfies this structurally
- *
- * const cornerRule: AutomapRule = {
- *   width: 2, height: 2,
- *   input: { ground: [1, AUTOMAP_EMPTY, AUTOMAP_EMPTY, AUTOMAP_EMPTY] },
- *   outputs: [{ ground: [2, AUTOMAP_EMPTY, AUTOMAP_EMPTY, AUTOMAP_EMPTY] }],
- * };
- *
- * const changed = automap(map, [cornerRule]); // how many cells the rules actually wrote
- * ```
- */
-export declare const EMPTY = -1;
-/**
- * One automapping rule: a 2D pattern to find, and what to write where it matches.
- *
- * This is Tiled's automapping, minus the editor: `input_*` layers are arbitrary
- * 2D patterns (not just one cell's 8 neighbours, unlike blob autotiling) matched
- * anywhere against the map, and the paired `output_*` layers replace what matched.
- * `EMPTY` is the wildcard on the way in (an empty input tile constrains nothing)
- * and a no-op on the way out (an empty output tile leaves the cell alone).
- */
-export interface AutomapRule {
-    /** only used to name the rule in errors */
-    name?: string;
-    /** defaults to the target's topology; hex patterns use the same odd-q x/y addresses as Level */
-    topology?: 'square' | 'hex';
-    /** the pattern size, in cells; every input and output grid must hold exactly this many */
-    width: number;
-    height: number;
-    /** layer name to pattern cells, row-major - all have to match at an origin for the rule to fire */
-    input: Record<string, ArrayLike<number>>;
-    /**
-     * Possible replacements, each a layer name to replacement cells. One variant is
-     * picked per match, so several numbered outputs are random variation and one is
-     * a plain deterministic write.
-     */
-    outputs: Array<Record<string, ArrayLike<number>>>;
-}
-export interface AutomapOptions {
-    /** picks the winning variant per match; defaults to the shared seeded generator */
-    pick?: (variants: number) => number;
-}
-/**
- * Applies automapping rules to a `TileMap`, in order.
- *
- * Rules read the live map but each rule collects all of its matches before writing
- * any of them: a later rule sees - and can override - what an earlier one wrote,
- * while a rule never trips over its own writes. Patterns must fit entirely; origins
- * where they would hang past the map edge are skipped. Returns how many times rules
- * matched (origins times rules), for tests and debug overlays.
- */
-export declare function automap(map: AutomapTarget, rules: readonly AutomapRule[], options?: AutomapOptions): number;
-//# sourceMappingURL=automap.d.ts.map

package/dist/rpg/automap.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"automap.d.ts","sourceRoot":"","sources":["../../src/rpg/automap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC;IAC9D,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9D,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3E;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,KAAK,KAAK,CAAC;AAGxB;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC3B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC5B,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,mGAAmG;IACnG,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC;;;;OAIG;IACH,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,cAAc;IAC9B,mFAAmF;IACnF,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAwB/G"}

package/dist/rpg/automap.js

@@ -1,107 +0,0 @@
-/**
- * The wildcard: an `input` cell holding it constrains nothing, an `output` cell holding it
- * leaves the target alone.
- *
- * Deliberately the same value as `two-d/render`'s own `EMPTY`, declared here rather than
- * imported so this module needs no renderer. `tests/automap.test.ts` asserts the two stay
- * equal, the same way the version test pins `version.ts` to `package.json`.
- *
- * @example
- * ```ts
- * import { automap, AUTOMAP_EMPTY, type AutomapTarget, type AutomapRule } from '@datamoc/mw_games/rpg';
- *
- * declare const map: AutomapTarget; // a real two-d/render.TileMap satisfies this structurally
- *
- * const cornerRule: AutomapRule = {
- *   width: 2, height: 2,
- *   input: { ground: [1, AUTOMAP_EMPTY, AUTOMAP_EMPTY, AUTOMAP_EMPTY] },
- *   outputs: [{ ground: [2, AUTOMAP_EMPTY, AUTOMAP_EMPTY, AUTOMAP_EMPTY] }],
- * };
- *
- * const changed = automap(map, [cornerRule]); // how many cells the rules actually wrote
- * ```
- */
-export const EMPTY = -1;
-import { int } from '../core/Random.js';
-/**
- * Applies automapping rules to a `TileMap`, in order.
- *
- * Rules read the live map but each rule collects all of its matches before writing
- * any of them: a later rule sees - and can override - what an earlier one wrote,
- * while a rule never trips over its own writes. Patterns must fit entirely; origins
- * where they would hang past the map edge are skipped. Returns how many times rules
- * matched (origins times rules), for tests and debug overlays.
- */
-export function automap(map, rules, options = {}) {
-    const pick = options.pick ?? int;
-    let matches = 0;
-    rules.forEach((rule, index) => {
-        const label = rule.name ?? `#${index + 1}`;
-        checkRule(rule, label, map.shape);
-        const origins = findMatches(map, rule);
-        matches += origins.length;
-        if (origins.length === 0)
-            return;
-        for (const [ox, oy] of origins) {
-            const output = rule.outputs[pick(rule.outputs.length)];
-            for (const [layer, cells] of Object.entries(output)) {
-                for (let dy = 0; dy < rule.height; dy++) {
-                    for (let dx = 0; dx < rule.width; dx++) {
-                        const value = cells[dy * rule.width + dx];
-                        if (value !== EMPTY)
-                            map.setTile(layer, ox + dx, oy + dy, value);
-                    }
-                }
-            }
-        }
-    });
-    return matches;
-}
-function checkRule(rule, label, mapShape) {
-    if (rule.topology && (mapShape === 'square' || mapShape === 'hex') && rule.topology !== mapShape) {
-        throw new Error(`automap rule "${label}" targets ${rule.topology} cells, but the map is ${mapShape}`);
-    }
-    if (!Number.isInteger(rule.width) || rule.width <= 0 || !Number.isInteger(rule.height) || rule.height <= 0) {
-        throw new Error(`automap rule "${label}" needs a positive width and height`);
-    }
-    if (rule.outputs.length === 0) {
-        throw new Error(`automap rule "${label}" has no outputs - a rule that matches and writes nothing is a mistake`);
-    }
-    const size = rule.width * rule.height;
-    for (const [layer, cells] of Object.entries(rule.input)) {
-        if (cells.length !== size) {
-            throw new Error(`automap rule "${label}" input "${layer}" has ${cells.length} cells, but the pattern is ${size}`);
-        }
-    }
-    rule.outputs.forEach((output, i) => {
-        for (const [layer, cells] of Object.entries(output)) {
-            if (cells.length !== size) {
-                throw new Error(`automap rule "${label}" output ${i + 1} "${layer}" has ${cells.length} cells, but the pattern is ${size}`);
-            }
-        }
-    });
-}
-/** every origin where the whole pattern fits and every constrained cell agrees */
-function findMatches(map, rule) {
-    const out = [];
-    for (let oy = 0; oy + rule.height <= map.heightInTiles; oy++) {
-        for (let ox = 0; ox + rule.width <= map.widthInTiles; ox++) {
-            if (matchesAt(map, rule, ox, oy))
-                out.push([ox, oy]);
-        }
-    }
-    return out;
-}
-function matchesAt(map, rule, ox, oy) {
-    for (const [layer, cells] of Object.entries(rule.input)) {
-        for (let dy = 0; dy < rule.height; dy++) {
-            for (let dx = 0; dx < rule.width; dx++) {
-                const want = cells[dy * rule.width + dx];
-                if (want !== EMPTY && map.getTile(layer, ox + dx, oy + dy) !== want)
-                    return false;
-            }
-        }
-    }
-    return true;
-}
-//# sourceMappingURL=automap.js.map

package/dist/rpg/automap.js.map

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

package/dist/rpg/dialogue-text.d.ts

@@ -1,81 +0,0 @@
-import type { Catalog, Direction } from '../i18n/index.ts';
-import type { EventCommand } from './EventRunner.ts';
-/**
- * A terse, line-based text format for straight (non-branching) dialogue - the format a
- * text-only RPG (`core` plus `rpg`, no renderer at all) can use for its own `EventCommand`
- * scripts without depending on `two-d` for anything. `two-d/stage` has its own wrapper
- * around the same parsing engine (`core.parseDialogueLines`) targeting `StageCommand`
- * instead - declared separately for the same reason `EventChoice` is declared separately
- * from `two-d/ui`'s `Choice`: a Pixi-based visual novel that never touches `rpg`'s map
- * events should not have to pull the whole module in just to parse dialogue text, and a
- * text-only RPG should not have to pull in Pixi either. The actual `@id`/`-` parsing logic
- * lives once in `core.parseDialogueLines`, not copied between the two - only the final
- * command shape (`speaker` here, `as` in `two-d/stage`) differs.
- *
- * Three kinds of line:
- *
- * - `@id text` names who is speaking and says `text`; `@id` alone (no text) just registers
- *   the speaker, without saying anything yet.
- * - `- text` continues the two-speaker exchange the first two `@id` lines opened,
- *   alternating speaker on every line: the first `-` after the two openers goes to
- *   whichever of them did not speak last, and so on.
- * - any other non-blank line narrates, with no speaker.
- *
- * ```
- * @alice Hello.
- * @bob Hi!
- * - How are you?
- * - Fine, and you?
- * ```
- *
- * The `-` shorthand is deliberately capped at two speakers: it exists for the two-character
- * back-and-forth, not as a guess at which of three or more people talks next. A third
- * distinct `@id` anywhere in the source is a parse error rather than a silent guess; a scene
- * with more than two speakers writes `@id` on every line instead, same as it does today.
- *
- * Lines reach `EventCommand.say` as plain, untranslated text - a game's own translation step
- * decides how that text reaches a player, the same seam MWL's own `_("...")`-marked strings
- * use (the source text doubles as the catalog key). `extractDialogueCatalog` builds that
- * catalog the same way MWL's `extractCatalog` does, for a game that wants a translator-ready
- * file to start from.
- *
- * @example
- * ```ts
- * import { parseDialogueText, EventRunner, GameState } from '@datamoc/mw_games/rpg';
- *
- * declare const game: GameState;
- *
- * const runner = new EventRunner({
- *   game,
- *   present: async (request) => {
- *     console.log(request.speaker ? `${request.speaker}: ${request.text}` : request.text);
- *   },
- * });
- * const commands = parseDialogueText(`
- * @alice Hello.
- * @bob Hi!
- * - How are you?
- * - Fine, and you?
- * `);
- * await runner.run(commands);
- * ```
- */
-export declare function parseDialogueText(source: string): EventCommand[];
-/**
- * Collects every `say`/`ask` line's text into an identity catalog - each key mapping to
- * itself, the same shape MWL's own `extractCatalog` builds from `_("...")`-marked strings -
- * so a translator has real entries to work from instead of a wall of untranslated dialogue.
- *
- * @example
- * ```ts
- * import { parseDialogueText, extractDialogueCatalog } from '@datamoc/mw_games/rpg';
- *
- * const commands = parseDialogueText('@alice Hello.\n');
- * console.log(extractDialogueCatalog(commands).messages); // { 'Hello.': 'Hello.' }
- * ```
- */
-export declare function extractDialogueCatalog(commands: readonly EventCommand[], options?: {
-    locale?: string;
-    direction?: Direction;
-}): Catalog;
-//# sourceMappingURL=dialogue-text.d.ts.map

package/dist/rpg/dialogue-text.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dialogue-text.d.ts","sourceRoot":"","sources":["../../src/rpg/dialogue-text.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAIhE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAO,GACtD,OAAO,CAOT"}

package/dist/rpg/dialogue-text.js

@@ -1,88 +0,0 @@
-import { parseDialogueLines } from '../core/DialogueText.js';
-/**
- * A terse, line-based text format for straight (non-branching) dialogue - the format a
- * text-only RPG (`core` plus `rpg`, no renderer at all) can use for its own `EventCommand`
- * scripts without depending on `two-d` for anything. `two-d/stage` has its own wrapper
- * around the same parsing engine (`core.parseDialogueLines`) targeting `StageCommand`
- * instead - declared separately for the same reason `EventChoice` is declared separately
- * from `two-d/ui`'s `Choice`: a Pixi-based visual novel that never touches `rpg`'s map
- * events should not have to pull the whole module in just to parse dialogue text, and a
- * text-only RPG should not have to pull in Pixi either. The actual `@id`/`-` parsing logic
- * lives once in `core.parseDialogueLines`, not copied between the two - only the final
- * command shape (`speaker` here, `as` in `two-d/stage`) differs.
- *
- * Three kinds of line:
- *
- * - `@id text` names who is speaking and says `text`; `@id` alone (no text) just registers
- *   the speaker, without saying anything yet.
- * - `- text` continues the two-speaker exchange the first two `@id` lines opened,
- *   alternating speaker on every line: the first `-` after the two openers goes to
- *   whichever of them did not speak last, and so on.
- * - any other non-blank line narrates, with no speaker.
- *
- * ```
- * @alice Hello.
- * @bob Hi!
- * - How are you?
- * - Fine, and you?
- * ```
- *
- * The `-` shorthand is deliberately capped at two speakers: it exists for the two-character
- * back-and-forth, not as a guess at which of three or more people talks next. A third
- * distinct `@id` anywhere in the source is a parse error rather than a silent guess; a scene
- * with more than two speakers writes `@id` on every line instead, same as it does today.
- *
- * Lines reach `EventCommand.say` as plain, untranslated text - a game's own translation step
- * decides how that text reaches a player, the same seam MWL's own `_("...")`-marked strings
- * use (the source text doubles as the catalog key). `extractDialogueCatalog` builds that
- * catalog the same way MWL's `extractCatalog` does, for a game that wants a translator-ready
- * file to start from.
- *
- * @example
- * ```ts
- * import { parseDialogueText, EventRunner, GameState } from '@datamoc/mw_games/rpg';
- *
- * declare const game: GameState;
- *
- * const runner = new EventRunner({
- *   game,
- *   present: async (request) => {
- *     console.log(request.speaker ? `${request.speaker}: ${request.text}` : request.text);
- *   },
- * });
- * const commands = parseDialogueText(`
- * @alice Hello.
- * @bob Hi!
- * - How are you?
- * - Fine, and you?
- * `);
- * await runner.run(commands);
- * ```
- */
-export function parseDialogueText(source) {
-    return parseDialogueLines(source).map((line) => line.speaker === undefined ? { say: line.text } : { say: line.text, speaker: line.speaker });
-}
-/**
- * Collects every `say`/`ask` line's text into an identity catalog - each key mapping to
- * itself, the same shape MWL's own `extractCatalog` builds from `_("...")`-marked strings -
- * so a translator has real entries to work from instead of a wall of untranslated dialogue.
- *
- * @example
- * ```ts
- * import { parseDialogueText, extractDialogueCatalog } from '@datamoc/mw_games/rpg';
- *
- * const commands = parseDialogueText('@alice Hello.\n');
- * console.log(extractDialogueCatalog(commands).messages); // { 'Hello.': 'Hello.' }
- * ```
- */
-export function extractDialogueCatalog(commands, options = {}) {
-    const messages = {};
-    for (const command of commands) {
-        if ('say' in command)
-            messages[command.say] = command.say;
-        else if ('ask' in command)
-            messages[command.ask] = command.ask;
-    }
-    return { locale: options.locale ?? 'en', direction: options.direction ?? 'ltr', messages };
-}
-//# sourceMappingURL=dialogue-text.js.map

package/dist/rpg/dialogue-text.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dialogue-text.js","sourceRoot":"","sources":["../../src/rpg/dialogue-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAI7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC/C,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC9C,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAC3F,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CACrC,QAAiC,EACjC,OAAO,GAA+C,EAAE;IAExD,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,KAAK,IAAI,OAAO;YAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;aACrD,IAAI,KAAK,IAAI,OAAO;YAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAChE,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC5F,CAAC"}

package/dist/rpg/index.d.ts

@@ -1,25 +0,0 @@
-export { automap } from './automap.ts';
-export type { AutomapRule, AutomapOptions, AutomapTarget } from './automap.ts';
-export { EMPTY as AUTOMAP_EMPTY } from './automap.ts';
-export type { MovableSprite } from './MovableSprite.ts';
-export { GameState } from './GameState.ts';
-export { activePage, conditionHolds } from './Event.ts';
-export type { EventTrigger, EventCondition, EventPage, MapEvent } from './Event.ts';
-export { EventRunner } from './EventRunner.ts';
-export type { EventCommand, EventStoryScript, EventRunnerState, EventRunnerOptions, MoveStep, DialoguePresenter, DialogueRequest, EventChoice, } from './EventRunner.ts';
-export { GridMover } from './GridMover.ts';
-export type { GridMoverOptions, Direction4 } from './GridMover.ts';
-export { MoveRouteRunner } from './MoveRoute.ts';
-export type { MoveRoute, MoveRouteStep, MoveRouteOptions, RouteTarget } from './MoveRoute.ts';
-export { FreeMover } from './FreeMover.ts';
-export type { FreeMoverOptions } from './FreeMover.ts';
-export { aabbOverlap, circleOverlap, circleAabbOverlap, resolveAabbAgainstTiles } from './Collision.ts';
-export type { AABB, Circle, SolidTile, ResolveTileMoveOptions } from './Collision.ts';
-export { QuestLog, questsFromRows } from './Quest.ts';
-export type { QuestStage, QuestDefinition, QuestStatus, QuestMarker, QuestStageRow } from './Quest.ts';
-export { decodeMarshal, encodeMarshal, RubySymbol, hashDefaultOf, withHashDefault } from './Marshal.ts';
-export type { RubyObject, RubyUserDefined } from './Marshal.ts';
-export { parseDialogueText, extractDialogueCatalog } from './dialogue-text.ts';
-export { importTwee } from './twee-events.ts';
-export type { EventTwineStory } from './twee-events.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/rpg/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rpg/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,KAAK,IAAI,aAAa,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACX,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,WAAW,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACxG,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxG,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}