@datamoc/mw_games 0.1.2 → 0.2.0

package/README.md

@@ -1,7 +1,7 @@
 # mwg
 
-A framework for building 2D top-down games that run **from a local file**: no server, no
-install, no runtime to download.
+A framework for building primarily 2D top-down games that run **from a local file**: no
+server, no install, no runtime to download. An optional Babylon.js module supports 3D maps.
 
 Licensed under the [MPL-2.0](LICENSE): games built with `mwg` carry no licence obligation
 of their own; improvements to `mwg`'s own files are shared back.
@@ -9,8 +9,10 @@ of their own; improvements to `mwg`'s own files are shared back.
 **[Live examples and API docs](https://datamoc.github.io/mwg/)**: every example below,
 playable in the browser with no download, plus the generated API reference.
 
-> **Status: early.** The scaffolding, licence and capability spec are in place. The
-> modules below are being built in the order given in [ROADMAP.md](ROADMAP.md).
+> **Status: early release (v0.2.0).** Every module in the shared floor below, plus optional
+> 3D, mobile (Capacitor) and desktop (WebView2) packaging, is built and tested - see
+> [ROADMAP.md](ROADMAP.md) for the full, numbered history. Still `0.y.z`: the "public API"
+> can still change between minor versions, and the wider genre-specific modules keep growing.
 
 ## What it is for
 
@@ -39,7 +41,8 @@ four directions on a square grid and another in six on a hex grid.
 
 `mwg` provides that shared floor plus each specialism, on top of
 [PixiJS](https://pixijs.com) for rendering and [rot.js](https://ondras.github.io/rot.js/)
-for the classic roguelike algorithms. See [Capability spec](#capability-spec).
+for the classic roguelike algorithms. Optional 3D scenes use Babylon.js. See
+[Capability spec](#capability-spec).
 
 These are references for *what a finished game of each kind has to do*, and nothing more.
 No code, asset, data table or file format is taken from any of them: see
@@ -139,6 +142,7 @@ only some do.
 | | pointer, keyboard and gamepad input with rebinding | `mwg/core` |
 | **text** | message tables per language, compiled at build time | `mwg/i18n` |
 | | plurals, gendered forms and interpolation | `mwg/i18n` |
+| | Fluent-style FTL catalogs with locale-aware fallback and variants | `mwg/i18n` |
 | | left-to-right, right-to-left and vertical writing | `mwg/i18n` |
 | | interface mirrored for right-to-left languages | `mwg/ui` |
 | | a missing translation falls back rather than showing a key | `mwg/i18n` |
@@ -173,9 +177,10 @@ The Wesnoth-shaped half: a grid whose shape is a parameter, not a parallel imple
 | --- | --- |
 | hexagonal tile maps, addressed by axial or offset coordinates | `mwg/render` |
 | movement cost and defense bonus by terrain, hex or square alike | `mwg/roguelike` |
-| zone of control: a hex a unit cannot move through, only into | `mwg/roguelike` |
 | field of view and pathfinding over a hex grid, not just square | `mwg/roguelike` |
 | isometric (and staggered) projection, alongside orthogonal and hex | `mwg/render` |
+| zone of control: a hex a unit can only move into, not through, unless already engaged | `mwg/board` |
+| an army economy: recruiting against a currency, recalling from a pool, per-turn upkeep | `mwg/board` |
 
 A game picks a grid shape once; the camera, field of view, pathfinding and turn scheduler
 work the same way over either, rather than a hex game needing its own copy of each. Between
@@ -286,18 +291,34 @@ Message tables are compiled at build time, the same way every other resource is,
 a language costs nothing at runtime and a missing string falls back to the base language
 rather than showing a raw key to the player.
 
+## Optional Babylon.js 3D
+
+`@babylonjs/core`/`@babylonjs/loaders` are peer dependencies, not installed automatically -
+a game that never imports `mwg/3d` never downloads Babylon.js. Add them yourself
+(`npm install @babylonjs/core @babylonjs/loaders`) once a game imports 3D support:
+
+```ts
+import { Engine3D, createTileGrid3D } from '@datamoc/mw_games/3d';
+import { loadModel3D } from '@datamoc/mw_games/3d/models';
+```
+
+`Engine3D` owns a WebGL scene, orbit camera, light, resize handling, and render loop.
+`createTileGrid3D` batches square or flat-top hex tiles and elevation columns with thin
+instances; `createHeightmapTerrain3D` builds continuous terrain from decoded RGBA heightmap
+pixels. `Character3D` moves imported meshes or camera-facing sprites continuously, and can
+play imported animation clips. `parseVox` and `createVoxModel3D` load one MagicaVoxel model;
+`loadModel3D` handles glTF/GLB.
+Run `npm run example:3d` for the live example or `npm run benchmark:3d` for its FPS gate.
+
 ## Roadmap
 
-See [ROADMAP.md](ROADMAP.md) for the full, numbered build order: 85 items, 74 shipped and
-eleven open (3D rendering broken into a nine-step build-up plus an engine choice, all
-logged at low priority; see that file for why). Each module ships in the order given there;
-later ones build on the
-modules before them.
+See [ROADMAP.md](ROADMAP.md) for the full, numbered build order and implementation notes.
+The optional 3D group is now implemented without changing the existing 2D entry point.
 
 ## Licence and provenance
 
-`mwg` is MPL-2.0. Its dependencies are permissive and compatible: PixiJS is MIT, rot.js is
-BSD-3-Clause.
+`mwg` is MPL-2.0. Its dependencies are permissive and compatible: PixiJS and Babylon.js are
+MIT, and rot.js is BSD-3-Clause.
 
 `tools/vendored/rgssad-wasm` is a build of the `rgssad-wasm` crate from
 <https://github.com/nathaniel-daniel/rgssad-rs>, used under its MIT licence
@@ -313,10 +334,14 @@ finished branching dungeon each have to do. None of their code, assets, maps, un
 definitions or text is included here, and `mwg` is not a derivative work of any of them.
 
 ADOM, RPG Maker, Pokémon, Ren'Py and Twine are likewise references for a *shape of game*, not
-sources of anything. `mwg` implements none of their file formats, reads none of their projects or save
-data, and includes none of their runtimes, assets, text or data tables: no type chart, no
-species list, no stat formula. Those are each game's own design work. Where a file format
-is needed, `mwg` uses Tiled's, which is open and documented.
+sources of anything. `mwg` includes none of their runtimes, assets, text or data tables: no
+type chart, no species list, no stat formula, no map, no line of dialogue. Those are each
+game's own design work. A loader or writer for one of their file formats is a different
+matter and is not off limits on its own: a format is a container, understood the same way
+any published format is, by reading real files in it to learn its shape; what stays out is
+the media that container holds, someone else's actual assets, text or data tables. Where a
+format already exists and needs no reverse-engineering, `mwg` uses Tiled's, which is open
+and documented.
 
 Game mechanics are not themselves protected, which is why a framework may offer "a turn
 queue ordered by speed" or "an effectiveness matrix". Particular numbers, names and

package/dist/actors/Aura.d.ts

@@ -0,0 +1,29 @@
+import { StatBlock, type Modifier } from './StatBlock.ts';
+/** "adjacent allies fight better while this unit is nearby" - the modifiers, not the radius */
+export interface AuraDef {
+    name: string;
+    modifiers: readonly Omit<Modifier, 'source'>[];
+}
+/** anyone who might carry or receive an aura; `aura` absent or `null` means "carries none" */
+export interface AuraParticipant {
+    stats: StatBlock;
+    aura?: AuraDef | null;
+}
+/**
+ * Continuously reapplies auras as who is adjacent to whom changes, unlike `battle.BattleHooks`
+ * (triggered once) or `actors.StatusEffect` (expires on a timer) - neither re-checks "is a
+ * qualifying unit still adjacent" on its own, which is exactly what a positional aura needs
+ * every time anyone moves.
+ *
+ * Call `update` once per relevant tick with the full roster and an adjacency test; "adjacent"
+ * is deliberately left to the caller (square grid, hex grid, board-tactics neighbours all mean
+ * something different) rather than assumed here. Each call diffs against who was affected by
+ * each carrier last time: a unit that just became adjacent gets the carrier's modifiers added,
+ * one that just left loses exactly those modifiers, and one that stays adjacent is left alone
+ * rather than having its modifiers reapplied on every tick.
+ */
+export declare class AuraField {
+    private affected;
+    update(participants: readonly AuraParticipant[], isAdjacent: (a: AuraParticipant, b: AuraParticipant) => boolean): void;
+}
+//# sourceMappingURL=Aura.d.ts.map

package/dist/actors/Aura.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Aura.d.ts","sourceRoot":"","sources":["../../src/actors/Aura.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1D,+FAA+F;AAC/F,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;CAC/C;AAED,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,SAAS;IAGrB,OAAO,CAAC,QAAQ,CAA4D;IAE5E,MAAM,CAAC,YAAY,EAAE,SAAS,eAAe,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,KAAK,OAAO,GAAG,IAAI,CA6CtH;CACD"}

package/dist/actors/Aura.js

@@ -0,0 +1,69 @@
+import { StatBlock } from './StatBlock.js';
+/**
+ * Continuously reapplies auras as who is adjacent to whom changes, unlike `battle.BattleHooks`
+ * (triggered once) or `actors.StatusEffect` (expires on a timer) - neither re-checks "is a
+ * qualifying unit still adjacent" on its own, which is exactly what a positional aura needs
+ * every time anyone moves.
+ *
+ * Call `update` once per relevant tick with the full roster and an adjacency test; "adjacent"
+ * is deliberately left to the caller (square grid, hex grid, board-tactics neighbours all mean
+ * something different) rather than assumed here. Each call diffs against who was affected by
+ * each carrier last time: a unit that just became adjacent gets the carrier's modifiers added,
+ * one that just left loses exactly those modifiers, and one that stays adjacent is left alone
+ * rather than having its modifiers reapplied on every tick.
+ */
+export class AuraField {
+    constructor() {
+        //per carrier, which participants currently carry that carrier's modifiers and under
+        //what source symbol - a unit inside two carriers' auras at once tracks both independently
+        this.affected = new Map();
+    }
+    update(participants, isAdjacent) {
+        const roster = new Set(participants);
+        const carriers = participants.filter((p) => !!p.aura);
+        const carrierSet = new Set(carriers);
+        for (const carrier of carriers) {
+            let currentlyAffected = this.affected.get(carrier);
+            if (!currentlyAffected) {
+                currentlyAffected = new Map();
+                this.affected.set(carrier, currentlyAffected);
+            }
+            for (const other of participants) {
+                if (other === carrier)
+                    continue;
+                const adjacent = isAdjacent(carrier, other);
+                const source = currentlyAffected.get(other);
+                if (adjacent && !source) {
+                    const newSource = Symbol(`aura:${carrier.aura.name}`);
+                    for (const modifier of carrier.aura.modifiers)
+                        other.stats.addModifier({ ...modifier, source: newSource });
+                    currentlyAffected.set(other, newSource);
+                }
+                else if (!adjacent && source) {
+                    other.stats.removeModifiersFrom(source);
+                    currentlyAffected.delete(other);
+                }
+            }
+            //a target affected last call but absent from this call's roster entirely (died,
+            //was removed) is never visited by the loop above, since that only walks
+            //`participants` - left alone, its modifiers and its own strong reference here
+            //would both persist forever
+            for (const [other, source] of [...currentlyAffected]) {
+                if (roster.has(other))
+                    continue;
+                other.stats.removeModifiersFrom(source);
+                currentlyAffected.delete(other);
+            }
+        }
+        //a carrier that died, lost its aura, or simply is not in this call's roster any more
+        //stops affecting anyone it was still affecting, rather than leaving stale modifiers
+        for (const [carrier, currentlyAffected] of [...this.affected]) {
+            if (carrierSet.has(carrier))
+                continue;
+            for (const [other, source] of currentlyAffected)
+                other.stats.removeModifiersFrom(source);
+            this.affected.delete(carrier);
+        }
+    }
+}
+//# sourceMappingURL=Aura.js.map

package/dist/actors/Aura.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Aura.js","sourceRoot":"","sources":["../../src/actors/Aura.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,MAAM,gBAAgB,CAAC;AAc1D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,SAAS;IAAtB;QACC,oFAAoF;QACpF,0FAA0F;QAClF,aAAQ,GAAG,IAAI,GAAG,EAAiD,CAAC;IAgD7E,CAAC;IA9CA,MAAM,CAAC,YAAwC,EAAE,UAA+D;QAC/G,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAA4C,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChG,MAAM,UAAU,GAAG,IAAI,GAAG,CAAkB,QAAQ,CAAC,CAAC;QAEtD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAChC,IAAI,iBAAiB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACnD,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACxB,iBAAiB,GAAG,IAAI,GAAG,EAAE,CAAC;gBAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;YAC/C,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;gBAClC,IAAI,KAAK,KAAK,OAAO;oBAAE,SAAS;gBAChC,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC5C,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAE5C,IAAI,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;oBACzB,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;oBACtD,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS;wBAAE,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;oBAC3G,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBACzC,CAAC;qBAAM,IAAI,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAC;oBAChC,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;oBACxC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACjC,CAAC;YACF,CAAC;YAED,gFAAgF;YAChF,wEAAwE;YACxE,8EAA8E;YAC9E,4BAA4B;YAC5B,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,EAAE,CAAC;gBACtD,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;oBAAE,SAAS;gBAChC,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;gBACxC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;QACF,CAAC;QAED,qFAAqF;QACrF,oFAAoF;QACpF,KAAK,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/D,IAAI,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,SAAS;YACtC,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,iBAAiB;gBAAE,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACzF,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;IACF,CAAC;CACD"}

package/dist/actors/ItemStatusEffect.d.ts

@@ -0,0 +1,27 @@
+import type { EffectClock } from './StatusEffect.ts';
+export interface ItemStatusEffectOptions<T> {
+    /** fields applied to the item for the duration, restored to their prior value on expiry */
+    fields: Partial<T>;
+    /** turns until the fields are restored */
+    duration: number;
+    /** called once per turn the effect is active, such as a poison coating's own tick */
+    tick?: (turn: number) => void;
+}
+/** ends an `ItemStatusEffect` early, restoring the item's fields immediately rather than at expiry */
+export interface ItemStatusEffectHandle {
+    cancel(): void;
+}
+/**
+ * A temporary status on an item itself - a weapon coated in poison for a fixed number of
+ * turns, a shield reinforced until it wears off, a ring blessed only "for this floor" - the
+ * item-targeted counterpart to `applyStatusEffect`, which only ever targets a `StatBlock`.
+ * Today's item-level fields (`cursed`, `blessed`, `level`, `affix`) are all permanent until
+ * a game explicitly changes them; this is what expires one instead.
+ *
+ * Applies `fields` onto `item`, remembering each field's prior value (not merely deleting
+ * it), and restores exactly that value once `clock` expires the effect or `cancel()` is
+ * called early - the same "never has to remember to remove what it added" guarantee
+ * `applyStatusEffect` already gives a `StatBlock`.
+ */
+export declare function applyItemStatusEffect<T extends object>(item: T, clock: EffectClock, options: ItemStatusEffectOptions<T>): ItemStatusEffectHandle;
+//# sourceMappingURL=ItemStatusEffect.d.ts.map

package/dist/actors/ItemStatusEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ItemStatusEffect.d.ts","sourceRoot":"","sources":["../../src/actors/ItemStatusEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACzC,2FAA2F;IAC3F,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEnB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IAEjB,qFAAqF;IACrF,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,sGAAsG;AACtG,MAAM,WAAW,sBAAsB;IACtC,MAAM,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EACrD,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GACjC,sBAAsB,CAuBxB"}

package/dist/actors/ItemStatusEffect.js

@@ -0,0 +1,35 @@
+/**
+ * A temporary status on an item itself - a weapon coated in poison for a fixed number of
+ * turns, a shield reinforced until it wears off, a ring blessed only "for this floor" - the
+ * item-targeted counterpart to `applyStatusEffect`, which only ever targets a `StatBlock`.
+ * Today's item-level fields (`cursed`, `blessed`, `level`, `affix`) are all permanent until
+ * a game explicitly changes them; this is what expires one instead.
+ *
+ * Applies `fields` onto `item`, remembering each field's prior value (not merely deleting
+ * it), and restores exactly that value once `clock` expires the effect or `cancel()` is
+ * called early - the same "never has to remember to remove what it added" guarantee
+ * `applyStatusEffect` already gives a `StatBlock`.
+ */
+export function applyItemStatusEffect(item, clock, options) {
+    const previous = new Map();
+    for (const key of Object.keys(options.fields)) {
+        previous.set(key, item[key]);
+        item[key] = options.fields[key];
+    }
+    const restore = () => {
+        for (const [key, value] of previous)
+            item[key] = value;
+    };
+    const id = clock.add({
+        duration: options.duration,
+        tick: (turn) => options.tick?.(turn),
+        onExpire: restore,
+    });
+    return {
+        cancel: () => {
+            clock.remove(id);
+            restore();
+        },
+    };
+}
+//# sourceMappingURL=ItemStatusEffect.js.map

package/dist/actors/ItemStatusEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ItemStatusEffect.js","sourceRoot":"","sources":["../../src/actors/ItemStatusEffect.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACpC,IAAO,EACP,KAAkB,EAClB,OAAmC;IAEnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAgB,EAAE,CAAC;QAC9D,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAe,CAAC;IAC/C,CAAC;IAED,MAAM,OAAO,GAAG,GAAS,EAAE;QAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACxD,CAAC,CAAC;IAEF,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC;QACpC,QAAQ,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,OAAO;QACN,MAAM,EAAE,GAAG,EAAE;YACZ,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACjB,OAAO,EAAE,CAAC;QACX,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/actors/Support.d.ts

@@ -0,0 +1,32 @@
+/** A thresholded bond level between two named units. */
+export interface SupportLevel {
+    id: string;
+    threshold: number;
+    /** Optional game-facing bonus or dialogue key unlocked at this level. */
+    bonus?: string;
+}
+export interface SupportChange {
+    a: string;
+    b: string;
+    points: number;
+    previousLevel: SupportLevel | null;
+    level: SupportLevel | null;
+}
+export interface SupportSave {
+    pairs: Array<[string, string, number]>;
+}
+/**
+ * Stores persistent progress for a relationship between a specific pair of units.
+ * Pair order is ignored, so `add('alice', 'bob', 1)` and the reverse address one bond.
+ */
+export declare class SupportLedger {
+    private levels;
+    private points;
+    constructor(levels: readonly SupportLevel[]);
+    get(a: string, b: string): number;
+    level(a: string, b: string): SupportLevel | null;
+    add(a: string, b: string, amount: number): SupportChange;
+    save(): SupportSave;
+    static restore(levels: readonly SupportLevel[], data: SupportSave): SupportLedger;
+}
+//# sourceMappingURL=Support.d.ts.map

package/dist/actors/Support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Support.d.ts","sourceRoot":"","sources":["../../src/actors/Support.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAA6B;IAE3C,YAAY,MAAM,EAAE,SAAS,YAAY,EAAE,EAK1C;IAED,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhC;IAED,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAQ/C;IAED,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAQvD;IAED,IAAI,IAAI,WAAW,CAMlB;IAED,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,aAAa,CAShF;CACD"}

package/dist/actors/Support.js

@@ -0,0 +1,60 @@
+/**
+ * Stores persistent progress for a relationship between a specific pair of units.
+ * Pair order is ignored, so `add('alice', 'bob', 1)` and the reverse address one bond.
+ */
+export class SupportLedger {
+    constructor(levels) {
+        this.points = new Map();
+        if (levels.some((level) => !level.id || !Number.isFinite(level.threshold) || level.threshold < 0)) {
+            throw new Error('support levels need an id and a non-negative threshold');
+        }
+        this.levels = [...levels].sort((a, b) => a.threshold - b.threshold);
+    }
+    get(a, b) {
+        return this.points.get(pairKey(a, b)) ?? 0;
+    }
+    level(a, b) {
+        const points = this.get(a, b);
+        let found = null;
+        for (const level of this.levels) {
+            if (level.threshold > points)
+                break;
+            found = level;
+        }
+        return found;
+    }
+    add(a, b, amount) {
+        if (!a || !b || a === b)
+            throw new Error('support needs two different named units');
+        if (!Number.isFinite(amount))
+            throw new Error(`support amount must be finite, got ${amount}`);
+        const previousLevel = this.level(a, b);
+        const key = pairKey(a, b);
+        const points = Math.max(0, (this.points.get(key) ?? 0) + amount);
+        this.points.set(key, points);
+        return { a, b, points, previousLevel, level: this.level(a, b) };
+    }
+    save() {
+        const pairs = [...this.points].map(([key, points]) => {
+            const [a, b] = key.split('\u0000');
+            return [a, b, points];
+        });
+        return { pairs };
+    }
+    static restore(levels, data) {
+        const ledger = new SupportLedger(levels);
+        for (const [a, b, points] of data.pairs) {
+            if (!a || !b || a === b || !Number.isFinite(points) || points < 0)
+                throw new Error('invalid support save data');
+            const key = pairKey(a, b);
+            if (ledger.points.has(key))
+                throw new Error(`invalid support save data: duplicate pair "${a}" / "${b}"`);
+            ledger.points.set(key, points);
+        }
+        return ledger;
+    }
+}
+function pairKey(a, b) {
+    return [a, b].sort().join('\u0000');
+}
+//# sourceMappingURL=Support.js.map

package/dist/actors/Support.js.map

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

package/dist/actors/Traits.d.ts

@@ -0,0 +1,29 @@
+import { StatBlock, type Modifier } from './StatBlock.ts';
+/**
+ * One entry in a shared pool a creature or unit can draw from at creation - "born strong",
+ * "nocturnal", "unlucky". Distinct from `actors.Affix` (item-side, one per item, weight-picked
+ * at generation) and `StatusEffect` (temporary, expires): a trait is permanent once assigned,
+ * never chosen by the player, and belongs to the creature rather than anything it carries.
+ */
+export interface TraitDef {
+    name: string;
+    modifiers: readonly Omit<Modifier, 'source'>[];
+    /** shown in a character sheet; `mwg` never reads this itself */
+    description?: string;
+}
+/** an assigned trait's modifiers can be found again later via `removeModifiersFrom` */
+export interface AssignedTrait {
+    trait: TraitDef;
+    source: symbol;
+}
+/**
+ * Draws `count` distinct traits at random from `pool` and applies their modifiers to `stats`
+ * permanently - no clock, no trigger, nothing removes them automatically. Each trait gets its
+ * own `source` symbol so a game that genuinely needs to strip one later still can, via
+ * `StatBlock.removeModifiersFrom`, even though nothing here ever calls that itself.
+ *
+ * @param count clamped to `pool.length` - asking for more traits than exist in the pool
+ * assigns every one of them rather than throwing
+ */
+export declare function assignTraits(stats: StatBlock, pool: readonly TraitDef[], count: number): AssignedTrait[];
+//# sourceMappingURL=Traits.d.ts.map

package/dist/actors/Traits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Traits.d.ts","sourceRoot":"","sources":["../../src/actors/Traits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1D;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;IAE/C,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAOxG"}

package/dist/actors/Traits.js

@@ -0,0 +1,21 @@
+import { StatBlock } from './StatBlock.js';
+import * as Random from '../core/Random.js';
+/**
+ * Draws `count` distinct traits at random from `pool` and applies their modifiers to `stats`
+ * permanently - no clock, no trigger, nothing removes them automatically. Each trait gets its
+ * own `source` symbol so a game that genuinely needs to strip one later still can, via
+ * `StatBlock.removeModifiersFrom`, even though nothing here ever calls that itself.
+ *
+ * @param count clamped to `pool.length` - asking for more traits than exist in the pool
+ * assigns every one of them rather than throwing
+ */
+export function assignTraits(stats, pool, count) {
+    const picked = Random.shuffle([...pool]).slice(0, Math.min(count, pool.length));
+    return picked.map((trait) => {
+        const source = Symbol(`trait:${trait.name}`);
+        for (const modifier of trait.modifiers)
+            stats.addModifier({ ...modifier, source });
+        return { trait, source };
+    });
+}
+//# sourceMappingURL=Traits.js.map

package/dist/actors/Traits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Traits.js","sourceRoot":"","sources":["../../src/actors/Traits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAsB5C;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,KAAgB,EAAE,IAAyB,EAAE,KAAa;IACtF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7C,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS;YAAE,KAAK,CAAC,WAAW,CAAC,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACnF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/actors/index.d.ts

@@ -14,6 +14,8 @@ export type { Recipe } from './craft.ts';
 export { applyStatusEffect } from './StatusEffect.ts';
 export type { EffectClock, StatusEffectOptions, StatusEffectHandle } from './StatusEffect.ts';
 export { identify, enchant, damageItem, repairItem } from './ItemState.ts';
+export { applyItemStatusEffect } from './ItemStatusEffect.ts';
+export type { ItemStatusEffectOptions, ItemStatusEffectHandle } from './ItemStatusEffect.ts';
 export { Charges } from './Charges.ts';
 export type { ChargesOptions } from './Charges.ts';
 export { rollLoot } from './Loot.ts';
@@ -30,4 +32,10 @@ export { buy, sell } from './Shop.ts';
 export type { Price, ShopOptions } from './Shop.ts';
 export { canAfford, spend } from './Resource.ts';
 export type { ResourceCost } from './Resource.ts';
+export { assignTraits } from './Traits.ts';
+export type { TraitDef, AssignedTrait } from './Traits.ts';
+export { AuraField } from './Aura.ts';
+export type { AuraDef, AuraParticipant } from './Aura.ts';
+export { SupportLedger } from './Support.ts';
+export type { SupportLevel, SupportChange, SupportSave } from './Support.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAClH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actors/index.ts"],"names":[],"mappings":"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"}

package/dist/actors/index.js

@@ -7,6 +7,7 @@ export { Inventory } from './Inventory.js';
 export { craft } from './craft.js';
 export { applyStatusEffect } from './StatusEffect.js';
 export { identify, enchant, damageItem, repairItem } from './ItemState.js';
+export { applyItemStatusEffect } from './ItemStatusEffect.js';
 export { Charges } from './Charges.js';
 export { rollLoot } from './Loot.js';
 export { Advancement } from './Advancement.js';
@@ -15,4 +16,7 @@ export { scaledModifiers } from './Scaling.js';
 export { assignAppearances, Appearances } from './Appearances.js';
 export { buy, sell } from './Shop.js';
 export { canAfford, spend } from './Resource.js';
+export { assignTraits } from './Traits.js';
+export { AuraField } from './Aura.js';
+export { SupportLedger } from './Support.js';
 //# sourceMappingURL=index.js.map

package/dist/actors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/actors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/actors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/assets/Streaming.d.ts

@@ -0,0 +1,40 @@
+export interface AssetBundle {
+    id: string;
+    paths: readonly string[];
+    priority?: number;
+    /** caller-supplied estimate, used only for eviction accounting */
+    estimatedBytes?: number;
+}
+export interface AssetStreamOptions {
+    budgetBytes?: number;
+    load?: (paths: string[]) => Promise<void>;
+    release?: (paths: string[]) => Promise<void>;
+}
+/**
+ * Game-directed background asset staging with bounded, least-recently-used eviction.
+ *
+ * It deliberately does not guess a player's next map: the game supplies bundles it considers
+ * likely. This works with compiled data URIs as a decode/GPU warm-up and with server or
+ * desktop hosts as ordinary asynchronous streaming.
+ */
+export declare class AssetStream {
+    private readonly entries;
+    private readonly budgetBytes;
+    private readonly loadAssets;
+    private readonly releaseAssets;
+    private clock;
+    constructor(options?: AssetStreamOptions);
+    /** loads one bundle now, then evicts older ready bundles if its budget requires it */
+    preload(bundle: AssetBundle): Promise<void>;
+    /** preloads bundles in highest-priority-first order; callers may intentionally not await it */
+    preloadLikely(bundles: readonly AssetBundle[]): Promise<void>;
+    /** marks a ready bundle as recently used at the moment a scene adopts it */
+    use(id: string): boolean;
+    isReady(id: string): boolean;
+    /** explicitly unloads one bundle, even when the configured budget has room */
+    unload(id: string): Promise<void>;
+    get estimatedBytes(): number;
+    private enforceBudget;
+    private isRetained;
+}
+//# sourceMappingURL=Streaming.d.ts.map

package/dist/assets/Streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Streaming.d.ts","sourceRoot":"","sources":["../../src/assets/Streaming.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAOD;;;;;;GAMG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqC;IAChE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqC;IACnE,OAAO,CAAC,KAAK,CAAK;IAElB,YAAY,OAAO,GAAE,kBAAuB,EAK3C;IAED,sFAAsF;IAChF,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhD;IAED,+FAA+F;IACzF,aAAa,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE;IAED,4EAA4E;IAC5E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAKvB;IAED,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE3B;IAED,8EAA8E;IACxE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtC;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;YAEa,aAAa;IAU3B,OAAO,CAAC,UAAU;CAGlB"}