@datamoc/mw_games 0.44.2 → 0.45.0

package/dist/core/Blob.js

@@ -1,140 +0,0 @@
-import { NEIGHBOURS4 } from './Grid.js';
-/**
- * A spreading volume field over a grid: a number per cell that creeps into its open
- * neighbours and thins out over time. Fire, gas, caustic ooze, flood water - anything
- * with a volume per cell.
- *
- * Deliberately dumber than a simulation: `mwg` holds the volumes and diffuses them, and
- * the game decides what a volume *means* (reading `cellsAbove` each turn to burn, poison
- * or corrode whoever stands there, or to drown whoever wades in). Per-creature timers
- * (`applyStatusEffect`) already cover "this victim burns for 3 turns"; this covers the
- * other half, "this *place* burns until it burns out".
- *
- * Renderer-free and module-free, so a game can lay volumes over any grid without pulling in
- * a terrain or combat module.
- *
- * @example
- * ```ts
- * import { Blob } from '@datamoc/mw_games/core';
- *
- * const fire = new Blob(20, 20);
- * fire.seed(5, 5, 10); // a fireball lands
- *
- * // one turn of spreading; it hands back whatever it just burned out, so the ground under
- * // the fire can turn to embers at the moment the flames leave it
- * const burntOut = fire.spread((x, y) => x >= 0 && y >= 0 && x < 20 && y < 20, 0.25, 0.9);
- * for (const cell of burntOut) console.log('burned out at', cell.x, cell.y);
- *
- * for (const cell of fire.cellsAbove(0.5)) console.log('burning at', cell.x, cell.y);
- *
- * fire.clear(5, 5); // someone douses that one tile
- * ```
- */
-export class Blob {
-    constructor(width, height) {
-        this.width = width;
-        this.height = height;
-        this.volume = new Float32Array(width * height);
-    }
-    /** the array index of `(x, y)`, or -1 when it lies off the grid */
-    index(x, y) {
-        if (x < 0 || y < 0 || x >= this.width || y >= this.height)
-            return -1;
-        return y * this.width + x;
-    }
-    /** how much effect sits on `(x, y)` right now; 0 off-map */
-    volumeAt(x, y) {
-        const i = this.index(x, y);
-        return i < 0 ? 0 : this.volume[i];
-    }
-    /** the total volume across the whole map - useful for "has it burned out yet" */
-    total() {
-        let sum = 0;
-        for (let i = 0; i < this.volume.length; i++)
-            sum += this.volume[i];
-        return sum;
-    }
-    /** adds `amount` to whatever is already on `(x, y)`; off-map is a no-op */
-    seed(x, y, amount) {
-        const i = this.index(x, y);
-        if (i >= 0)
-            this.volume[i] += amount;
-    }
-    /** zeroes whatever sits on `(x, y)`, leaving its neighbours alone; off-map is a no-op */
-    clear(x, y) {
-        const i = this.index(x, y);
-        if (i >= 0)
-            this.volume[i] = 0;
-    }
-    /**
-     * One diffusion step: every cell shares `spread` of its volume equally among its open
-     * 4-neighbours (a cell with no open neighbour keeps it all), then every cell keeps only
-     * `decay` of what it ends up with. `decay: 1` conserves volume and only moves it around;
-     * anything lower thins the effect out over time. `open(x, y)` decides whether the effect
-     * may cross into a cell, so the caller chooses what blocks it.
-     *
-     * Returns the cells this step emptied, in reading order: those holding a volume before the
-     * step and none after it. That is the moment a game turns the grass under a fire to embers,
-     * and reporting it here saves the game diffing `cellsAbove` between two steps to notice.
-     */
-    spread(open, spread = 0.25, decay = 0.9) {
-        const next = new Float32Array(this.volume.length);
-        for (let y = 0; y < this.height; y++) {
-            for (let x = 0; x < this.width; x++) {
-                const here = y * this.width + x;
-                const amount = this.volume[here];
-                if (amount <= 0)
-                    continue;
-                const neighbours = [];
-                for (const [dx, dy] of NEIGHBOURS4) {
-                    const nx = x + dx;
-                    const ny = y + dy;
-                    const i = this.index(nx, ny);
-                    if (i >= 0 && open(nx, ny))
-                        neighbours.push(i);
-                }
-                if (neighbours.length === 0) {
-                    next[here] += amount;
-                }
-                else {
-                    const share = (amount * spread) / neighbours.length;
-                    next[here] += amount - share * neighbours.length;
-                    for (const cell of neighbours)
-                        next[cell] += share;
-                }
-            }
-        }
-        const emptied = [];
-        for (let i = 0; i < next.length; i++) {
-            const kept = next[i] * decay;
-            //snap float dust to zero so a burned-out effect actually reads as gone
-            const volume = kept < 0.001 ? 0 : kept;
-            if (volume === 0 && this.volume[i] > 0) {
-                emptied.push({ x: i % this.width, y: Math.floor(i / this.width) });
-            }
-            this.volume[i] = volume;
-        }
-        return emptied;
-    }
-    /** every cell holding at least `minimum` - the cells a game applies its effect on */
-    cellsAbove(minimum) {
-        const out = [];
-        for (let y = 0; y < this.height; y++) {
-            for (let x = 0; x < this.width; x++) {
-                const volume = this.volume[y * this.width + x];
-                if (volume >= minimum)
-                    out.push({ x, y, volume });
-            }
-        }
-        return out;
-    }
-    toJSON() {
-        return { width: this.width, height: this.height, volume: [...this.volume] };
-    }
-    static fromJSON(data) {
-        const blob = new Blob(data.width, data.height);
-        blob.volume.set(data.volume.slice(0, blob.volume.length));
-        return blob;
-    }
-}
-//# sourceMappingURL=Blob.js.map

package/dist/core/Blob.js.map

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

package/dist/core/Clone.d.ts

@@ -1,31 +0,0 @@
-/**
- * Where `structuredClone` would fail inside `value`, as a readable path (`command.attacker.
- * reactions.rules[0].when`), or null when the whole value clones. A function, a symbol, a
- * `WeakMap`/`WeakSet`, a `Promise` or a DOM node all fail; a class instance on its own does
- * not (its own fields are copied and its prototype dropped), so the path points at the first
- * field that actually cannot be copied rather than at the object holding it.
- *
- * @example
- * ```ts
- * import { uncloneablePath } from '@datamoc/mw_games/core';
- *
- * uncloneablePath({ target: { id: 'king', onHit: () => {} } }, 'command'); // 'command.target.onHit'
- * uncloneablePath({ targetId: 'king' }, 'command'); // null
- * ```
- */
-export declare function uncloneablePath(value: unknown, root?: string): string | null;
-/**
- * `structuredClone`, with a failure that names what could not be copied and where, instead of
- * the bare `DataCloneError` a journal or undo checkpoint would otherwise surface far from the
- * code that put a live object there.
- *
- * @example
- * ```ts
- * import { cloneData } from '@datamoc/mw_games/core';
- *
- * const checkpoint = cloneData({ turn: 3, hp: { king: 12 } }, 'state');
- * cloneData({ onHit: () => {} }, 'command'); // throws: command.onHit cannot be structured-cloned ...
- * ```
- */
-export declare function cloneData<T>(value: T, label: string): T;
-//# sourceMappingURL=Clone.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Clone.d.ts","sourceRoot":"","sources":["../../src/core/Clone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,SAAU,GAAG,MAAM,GAAG,IAAI,CAE7E;AAiCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAavD"}

package/dist/core/Clone.js

@@ -1,84 +0,0 @@
-/**
- * Where `structuredClone` would fail inside `value`, as a readable path (`command.attacker.
- * reactions.rules[0].when`), or null when the whole value clones. A function, a symbol, a
- * `WeakMap`/`WeakSet`, a `Promise` or a DOM node all fail; a class instance on its own does
- * not (its own fields are copied and its prototype dropped), so the path points at the first
- * field that actually cannot be copied rather than at the object holding it.
- *
- * @example
- * ```ts
- * import { uncloneablePath } from '@datamoc/mw_games/core';
- *
- * uncloneablePath({ target: { id: 'king', onHit: () => {} } }, 'command'); // 'command.target.onHit'
- * uncloneablePath({ targetId: 'king' }, 'command'); // null
- * ```
- */
-export function uncloneablePath(value, root = 'value') {
-    return find(value, root, new Set());
-}
-function find(value, path, seen) {
-    if (typeof value === 'function' || typeof value === 'symbol')
-        return path;
-    if (value === null || typeof value !== 'object' || seen.has(value))
-        return null;
-    seen.add(value);
-    if (clones(value))
-        return null;
-    const children = [];
-    if (value instanceof Map) {
-        for (const [key, item] of value)
-            children.push([`${path}.get(${JSON.stringify(key) ?? String(key)})`, item]);
-    }
-    else if (value instanceof Set) {
-        for (const item of value)
-            children.push([`${path}.item`, item]);
-    }
-    else if (Array.isArray(value)) {
-        value.forEach((item, index) => children.push([`${path}[${index}]`, item]));
-    }
-    else {
-        for (const [key, item] of Object.entries(value))
-            children.push([`${path}.${key}`, item]);
-    }
-    for (const [childPath, child] of children) {
-        const found = find(child, childPath, seen);
-        if (found)
-            return found;
-    }
-    return path;
-}
-function clones(value) {
-    try {
-        structuredClone(value);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * `structuredClone`, with a failure that names what could not be copied and where, instead of
- * the bare `DataCloneError` a journal or undo checkpoint would otherwise surface far from the
- * code that put a live object there.
- *
- * @example
- * ```ts
- * import { cloneData } from '@datamoc/mw_games/core';
- *
- * const checkpoint = cloneData({ turn: 3, hp: { king: 12 } }, 'state');
- * cloneData({ onHit: () => {} }, 'command'); // throws: command.onHit cannot be structured-cloned ...
- * ```
- */
-export function cloneData(value, label) {
-    try {
-        return structuredClone(value);
-    }
-    catch (error) {
-        const path = uncloneablePath(value, label) ?? label;
-        throw new TypeError(`${path} cannot be structured-cloned (${error instanceof Error ? error.message : String(error)}). ` +
-            'Journals, snapshots and undo checkpoints copy their contents with structuredClone, so they ' +
-            'must hold plain data: refer to a live object (an actor, anything carrying callbacks such as ' +
-            'a ReactionTable) by its id and resolve it inside the rule.', { cause: error });
-    }
-}
-//# sourceMappingURL=Clone.js.map

package/dist/core/Clone.js.map

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

package/dist/core/Collection.d.ts

@@ -1,59 +0,0 @@
-import { type SaveStorage } from './Save.ts';
-/**
- * One JSON record in a `Collection`: a string id plus whatever fields the game
- * keeps - quest stages, bestiary sightings, achievements.
- */
-export interface DbRecord {
-    id: string;
-    [field: string]: unknown;
-}
-export interface CollectionOptions {
-    /** key prefix, so two games sharing a browser never meet; defaults to the game's name */
-    namespace?: string;
-    /** defaults to `localStorage`, falling back to memory where it is unavailable */
-    storage?: SaveStorage;
-}
-/**
- * A named collection of records, queried and filtered - the shape `SaveSystem`
- * does not cover. A save slot is one blob loaded wholesale; a collection is many
- * small records asked questions: `where((q) => !q.done)` is "everything not yet
- * completed".
- *
- * Every call hits the storage directly - nothing is cached, so there is no copy
- * to go stale, and two `Collection` objects over the same name agree trivially.
- * Records come back in insertion order. Built for logs and bestiaries (hundreds
- * of records), not for anything scanned per frame.
- *
- * @example
- * ```ts
- * import { Collection } from '@datamoc/mw_games/core';
- *
- * const quests = new Collection('quests');
- * quests.put({ id: 'rats', stage: 1, done: false });
- * quests.put({ id: 'shopkeeper', stage: 3, done: true });
- *
- * const active = quests.where((q) => !q.done);
- * console.log(quests.size, active.length); // 2 1
- * ```
- */
-export declare class Collection {
-    private readonly prefix;
-    private readonly storage;
-    constructor(name: string, options?: CollectionOptions);
-    /** how many records the collection holds */
-    get size(): number;
-    /** every record, in insertion order */
-    all(): DbRecord[];
-    get(id: string): DbRecord | undefined;
-    /** inserts or replaces the record with the same id */
-    put(record: DbRecord): void;
-    remove(id: string): void;
-    /** the records a predicate keeps - "everything not yet completed" reads exactly like that */
-    where(predicate: (record: DbRecord) => boolean): DbRecord[];
-    /** empties this collection, and nothing else sharing the storage */
-    clear(): void;
-    private keys;
-    private read;
-    private parse;
-}
-//# sourceMappingURL=Collection.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Collection.d.ts","sourceRoot":"","sources":["../../src/core/Collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7D;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IACjC,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,OAAO,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IAEtC,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,EAIxD;IAED,4CAA4C;IAC5C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,uCAAuC;IACvC,GAAG,IAAI,QAAQ,EAAE,CAEhB;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAGpC;IAED,sDAAsD;IACtD,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAQ1B;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEvB;IAED,6FAA6F;IAC7F,KAAK,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,OAAO,GAAG,QAAQ,EAAE,CAE1D;IAED,oEAAoE;IACpE,KAAK,IAAI,IAAI,CAEZ;IAED,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,KAAK;CAGb"}

package/dist/core/Collection.js

@@ -1,77 +0,0 @@
-import { defaultStorage } from './Save.js';
-import { parseInbound } from './Sanitize.js';
-/**
- * A named collection of records, queried and filtered - the shape `SaveSystem`
- * does not cover. A save slot is one blob loaded wholesale; a collection is many
- * small records asked questions: `where((q) => !q.done)` is "everything not yet
- * completed".
- *
- * Every call hits the storage directly - nothing is cached, so there is no copy
- * to go stale, and two `Collection` objects over the same name agree trivially.
- * Records come back in insertion order. Built for logs and bestiaries (hundreds
- * of records), not for anything scanned per frame.
- *
- * @example
- * ```ts
- * import { Collection } from '@datamoc/mw_games/core';
- *
- * const quests = new Collection('quests');
- * quests.put({ id: 'rats', stage: 1, done: false });
- * quests.put({ id: 'shopkeeper', stage: 3, done: true });
- *
- * const active = quests.where((q) => !q.done);
- * console.log(quests.size, active.length); // 2 1
- * ```
- */
-export class Collection {
-    constructor(name, options = {}) {
-        if (!name)
-            throw new Error('a collection needs a name');
-        this.prefix = `mwg-db:${options.namespace ?? 'default'}:${name}:`;
-        this.storage = options.storage ?? defaultStorage();
-    }
-    /** how many records the collection holds */
-    get size() {
-        return this.keys().length;
-    }
-    /** every record, in insertion order */
-    all() {
-        return this.keys().map((key) => this.read(key));
-    }
-    get(id) {
-        const raw = this.storage.read(this.prefix + id);
-        return raw === null ? undefined : this.parse(raw, this.prefix + id);
-    }
-    /** inserts or replaces the record with the same id */
-    put(record) {
-        if (typeof record !== 'object' || record === null || Array.isArray(record)) {
-            throw new Error('a record must be an object with a string id');
-        }
-        if (typeof record.id !== 'string' || record.id === '') {
-            throw new Error('a record must be an object with a string id');
-        }
-        this.storage.write(this.prefix + record.id, JSON.stringify(record));
-    }
-    remove(id) {
-        this.storage.remove(this.prefix + id);
-    }
-    /** the records a predicate keeps - "everything not yet completed" reads exactly like that */
-    where(predicate) {
-        return this.all().filter(predicate);
-    }
-    /** empties this collection, and nothing else sharing the storage */
-    clear() {
-        for (const key of this.keys())
-            this.storage.remove(key);
-    }
-    keys() {
-        return this.storage.keys().filter((key) => key.startsWith(this.prefix));
-    }
-    read(key) {
-        return this.parse(this.storage.read(key), key);
-    }
-    parse(raw, key) {
-        return parseInbound(raw, { label: `record "${key}"` });
-    }
-}
-//# sourceMappingURL=Collection.js.map

package/dist/core/Collection.js.map

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

package/dist/core/Csv.d.ts

@@ -1,74 +0,0 @@
-/**
- * A header-row CSV into an array of typed row objects - so a content designer edits a
- * spreadsheet instead of a `.ts` object literal for a table shaped like `actors.AffixTable`,
- * `actors.LootTable`, or any other array-of-records a game defines. The same precedent
- * `i18n`'s `parseFTL` already set: this takes a raw string and has no opinion on how that
- * string reached the game (a small table can sit in a `.ts` template literal; a larger one
- * loads through a bundler's raw-text import - Vite resolves a `?raw`-suffixed path to its
- * file's contents as a plain string - or through a game's own asset pipeline) - `mwg`
- * supplies the parsing, not the loading.
- *
- * Every cell is a string until a column says otherwise: `columns` names which fields are
- * `'number'`/`'boolean'`/`'list'` (semicolon-separated by default, for a field shaped like
- * `AffixDef.kinds`) /`'map'` (semicolon-separated `key=value` pairs, for a per-row property
- * bag such as `{ str: '2', dex: '-1' }` a game reads its own way) - and an undeclared column
- * stays a plain string. An **empty cell omits that field from the row entirely**, the same as
- * never setting an optional property - so a blank `curse` column reads exactly like the
- * `curse?: boolean` it fills never being set.
- *
- * Follows RFC 4180 far enough for real game-data text: a quoted field may contain the
- * delimiter, a newline, or an escaped `""` for a literal quote, which a naive `split(',')`
- * cannot survive the moment a description contains a comma.
- *
- * What this cannot hold: a `core.ReactionTable` rule's `when`/`action` are executable code,
- * not data, so no cell format expresses them - the same boundary `AffixDef.id` already draws
- * (a string the game interprets, `mwg` never does). A CSV row can drive *which* reactions a
- * game builds at startup (an id, a comparison string like `'hp<=0.25'`, a threshold number a
- * `'number'` column already coerces) with the game's own code turning each row into a real
- * `ReactionRule`; it cannot hold the rule's logic itself.
- *
- * @example
- * ```ts
- * import { parseCSV } from '@datamoc/mw_games/core';
- * import type { AffixDef, AffixTable } from '@datamoc/mw_games/actors';
- *
- * const csv = `id,trigger,weight,curse,description
- * blazing,strike,3,,Ignites the victim
- * wayward,strike,1,true,"Cursed: -3 accuracy"`;
- *
- * const table: AffixTable = {
- *   entries: parseCSV<AffixDef>(csv, { columns: { weight: 'number', curse: 'boolean' } }),
- * };
- * console.log(table.entries[1]); // { id: 'wayward', trigger: 'strike', weight: 1, curse: true, description: 'Cursed: -3 accuracy' }
- * ```
- */
-export type CsvColumnType = 'string' | 'number' | 'boolean' | 'list' | 'map';
-export interface CsvOptions {
-    /** how to interpret each named column beyond a plain string; an undeclared column stays one */
-    columns?: Record<string, CsvColumnType>;
-    /** splits a `'list'`/`'map'` column's cell into individual entries; default `;` */
-    listDelimiter?: string;
-    /** splits a `'map'` entry into its key and value; default `=` */
-    mapDelimiter?: string;
-}
-/**
- * @example
- * ```ts
- * import { parseCSV } from '@datamoc/mw_games/core';
- *
- * const rows = parseCSV('id,weight\nblazing,3\nchilling,3', { columns: { weight: 'number' } });
- * console.log(rows); // [{ id: 'blazing', weight: 3 }, { id: 'chilling', weight: 3 }]
- * ```
- */
-export declare function parseCSV<T = Record<string, string>>(source: string, options?: CsvOptions): T[];
-export interface CsvCoercionOptions {
-    readonly column?: string;
-    readonly rowIndex?: number;
-    readonly listDelimiter?: string;
-    readonly mapDelimiter?: string;
-    readonly acceptYesNo?: boolean;
-    readonly error?: (message: string) => string;
-}
-/** Coerce one typed cell, shared by CSV and declarative content readers. */
-export declare function coerceCsvValue(raw: string, type: CsvColumnType, options?: CsvCoercionOptions): unknown;
-//# sourceMappingURL=Csv.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Csv.d.ts","sourceRoot":"","sources":["../../src/core/Csv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7E,MAAM,WAAW,UAAU;IAC1B,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAExC,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,CAAC,EAAE,CAwBlG;AA+BD,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CAC7C;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAyC1G"}