@datamoc/mw_games 0.1.1 → 0.2.0

package/README.md

@@ -1,16 +1,18 @@
 # 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.
 
-**[Live examples and API docs](https://datamoc.github.io/mwg/)** — every example below,
+**[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
 
@@ -31,7 +33,7 @@ what that has to cover:
 
 Underneath they share almost everything: a grid, a camera following someone across it,
 sprites that need tinting, turn-taking, characters with stats and equipment, an inventory,
-and a great many windows. The differences are narrower than the genre labels suggest — one
+and a great many windows. The differences are narrower than the genre labels suggest: one
 generates its maps and another authors them; one schedules monsters and another schedules
 events; one rolls encounters from the terrain and another places them by hand; one puts its
 conversations in a corner of the map and another gives them the whole screen; one moves in
@@ -39,10 +41,11 @@ 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
+No code, asset, data table or file format is taken from any of them: see
 [Licence and provenance](#licence-and-provenance).
 
 ### On being "like RPG Maker"
@@ -50,13 +53,13 @@ No code, asset, data table or file format is taken from any of them — see
 Worth being precise, because RPG Maker is two things and `mwg` is only aiming at one of
 them for now.
 
-It is a **runtime** — a tile engine, an event interpreter, a battle system, a message box.
+It is a **runtime**: a tile engine, an event interpreter, a battle system, a message box.
 That is what the capability spec below commits to.
 
 It is also an **editor**, and that is what most people actually mean by RPG Maker: drawing
 maps and wiring events without writing code. `mwg` does not have one. What it does instead
 is keep maps, events and dialogue as **plain data** rather than code, so an editor can be
-built against that data later without reworking the runtime — and so that in the meantime
+built against that data later without reworking the runtime, and so that in the meantime
 the data can be written by hand, generated by a script, or exported from
 [Tiled](https://www.mapeditor.org/), which is free and already good at this.
 
@@ -83,7 +86,7 @@ instead of by name:
 npm install ./datamoc-mw_games-0.1.1.tgz
 ```
 
-**Without either.** Drop one file next to your page and open it — this path exists because
+**Without either.** Drop one file next to your page and open it: this path exists because
 the framework's own target is a game you can run by double-clicking it. Download
 `mw_games.global.js` from a [release](https://github.com/datamoc/mwg/releases) (no `npm`,
 no `node_modules`, nothing to install):
@@ -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,14 +177,15 @@ 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
 them, orthogonal, isometric and hex cover every map orientation
-[Tiled](https://www.mapeditor.org/) itself supports — a Tiled map loads and renders through
+[Tiled](https://www.mapeditor.org/) itself supports: a Tiled map loads and renders through
 the same `TileMap`, whichever orientation it was drawn in, rather than mwg reading only the
 one shape it happens to render natively. Flare's Empyrean Campaign is the isometric-shaped
 reference, the same way Wesnoth is the hex-shaped one.
@@ -219,7 +224,7 @@ rather than classes.
 
 That last row is why `tools/make-example-assets.mjs` draws its character in parts. A figure
 assembled from skin, eyes, hair and garments is one palette away from being a second
-character — and one *layer* away from showing the armour it just put on. A single flat
+character, and one *layer* away from showing the armour it just put on. A single flat
 sprite per character can do neither.
 
 ### Creatures and battles
@@ -237,7 +242,7 @@ The Pokémon-shaped half, and the part `mwg` deliberately keeps generic.
 | capture, experience, levelling and evolution as replaceable rules | `mwg/battle` |
 
 `mwg` supplies the *shape*: a stat block, a type matrix, a turn queue. It supplies no
-formulas, no type chart and no species — those are a game's own design, and copying any
+formulas, no type chart and no species: those are a game's own design, and copying any
 particular game's would be both wrong and useless to anyone else.
 
 All of these specialisms share the tile map, the camera, the windows, the turn clock and
@@ -247,7 +252,7 @@ the save system, which is why they sit in one framework rather than four.
 
 The single most load-bearing rendering feature in either genre is the colour transform
 `texel × M + A`. Darkness outside the field of view, tinting a poisoned enemy, flashing
-white on a hit, a room lit by a fireplace, a screen-wide tint for a night scene — all of it
+white on a hit, a room lit by a fireplace, a screen-wide tint for a night scene: all of it
 is that one operation.
 
 Pixi's built-in `tint` is multiply-only, which can only ever darken. The additive term is
@@ -259,7 +264,7 @@ nothing per sprite. See `examples/colour-transform`.
 An RPG's content is enormous and repetitive, and almost none of it deserves to be written
 by hand in TypeScript. Keeping maps, events, dialogue and item tables as data means they
 can be authored in a spreadsheet, generated by a script, exported from Tiled, or eventually
-edited in a proper editor — without any of those options requiring changes to the runtime.
+edited in a proper editor, without any of those options requiring changes to the runtime.
 
 It also keeps the content out of the bundle: `tools/compile-resources` treats a map file
 exactly like a sprite sheet, so adding a hundred maps does not touch the build at all.
@@ -270,14 +275,14 @@ Supporting more than one language is mostly bookkeeping. Supporting more than on
 *direction* is not, and the three cases are genuinely different work:
 
 - **Left-to-right** is what everything assumes by default.
-- **Right-to-left** — Arabic, Hebrew — is two problems at once. The text itself the browser
+- **Right-to-left** (Arabic, Hebrew) is two problems at once. The text itself the browser
   can handle: canvas applies the Unicode bidirectional algorithm and shapes the glyphs, so
   a label mostly comes out right once its direction is declared. The *interface* is the
   harder half, because a right-to-left reader expects it mirrored: lists indent from the
   right, a back arrow points the other way, a progress bar fills the other way. `mwg/ui`
   lays widgets out against a direction rather than against "left" so this can be flipped,
   and a game only has to mark which of its own icons must not be mirrored.
-- **Vertical**, top to bottom — traditional Chinese, Japanese, Mongolian — gets no help at
+- **Vertical**, top to bottom (traditional Chinese, Japanese, Mongolian), gets no help at
   all. Canvas has no vertical writing mode, so the text has to be laid out glyph by glyph,
   with its own rules for which characters rotate and which stand upright. This is real work
   and it is scheduled as such, not assumed to fall out of the other two.
@@ -286,37 +291,57 @@ 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
-option (© 2022 Nathaniel Daniel) — see `tools/vendored/rgssad-wasm/README.md`.
+option (© 2022 Nathaniel Daniel); see `tools/vendored/rgssad-wasm/README.md`.
 It is a developer-side archive tool only, not part of the framework or any game.
 
 Shattered Pixel Dungeon (GPL-3, © Oleg Dolya and Evan Debenham), The Battle for Wesnoth
 (GPL-2.0-or-later, © the Battle for Wesnoth contributors), Flare's Empyrean Campaign
 (GPL-3, © the Flare project), and Dungeon Crawl Stone Soup (GPL-2.0, © the Dungeon Crawl
-Stone Soup development team) are referenced only as design studies — a list of what a
+Stone Soup development team) are referenced only as design studies: a list of what a
 finished roguelike, a finished hex-based tactical game, a finished isometric one, and a
 finished branching dungeon each have to do. None of their code, assets, maps, unit
 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/Appearances.js

@@ -10,7 +10,7 @@ export function assignAppearances(table) {
     const pool = [...table.labels];
     for (let i = pool.length - 1; i > 0; i--) {
         const j = Random.int(0, i + 1);
-        [pool[i], pool[j]] = [pool[i], pool[j]];
+        [pool[i], pool[j]] = [pool[j], pool[i]];
     }
     const out = new Map();
     table.kinds.forEach((kind, index) => out.set(kind, pool[index]));

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/Resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Resource.d.ts","sourceRoot":"","sources":["../../src/actors/Resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf;AAYD,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,OAAO,CAEjG;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,OAAO,CAK7F"}
+{"version":3,"file":"Resource.d.ts","sourceRoot":"","sources":["../../src/actors/Resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf;AAoBD,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,OAAO,CAEjG;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,OAAO,CAK7F"}

package/dist/actors/Resource.js

@@ -7,9 +7,17 @@ function all(cost) {
     }
     return list;
 }
+//several costs on the same stat (two effects both drawing mana, say) must be checked
+//against their combined total, not each independently against the same starting pool
+function totals(cost) {
+    const out = new Map();
+    for (const c of cost)
+        out.set(c.stat, (out.get(c.stat) ?? 0) + c.amount);
+    return out;
+}
 /** True when every cost in `cost` is currently affordable, without spending anything. */
 export function canAfford(stats, cost) {
-    return all(cost).every((c) => stats.base(c.stat) >= c.amount);
+    return [...totals(all(cost))].every(([stat, amount]) => stats.base(stat) >= amount);
 }
 /**
  * Spends every cost in `cost` at once, the way `craft` resolves a recipe.
@@ -18,11 +26,11 @@ export function canAfford(stats, cost) {
  * this returns false. A zero cost is always affordable and deducts nothing.
  */
 export function spend(stats, cost) {
-    const list = all(cost);
-    if (!list.every((c) => stats.base(c.stat) >= c.amount))
+    const combined = totals(all(cost));
+    if (![...combined].every(([stat, amount]) => stats.base(stat) >= amount))
         return false;
-    for (const c of list)
-        stats.setBase(c.stat, stats.base(c.stat) - c.amount);
+    for (const [stat, amount] of combined)
+        stats.setBase(stat, stats.base(stat) - amount);
     return true;
 }
 //# sourceMappingURL=Resource.js.map

package/dist/actors/Resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"Resource.js","sourceRoot":"","sources":["../../src/actors/Resource.ts"],"names":[],"mappings":"AAeA,SAAS,GAAG,CAAC,IAA4C;IACxD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACjG,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,IAA4C;IACvF,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,KAAgB,EAAE,IAA4C;IACnF,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACrE,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IAC3E,OAAO,IAAI,CAAC;AACb,CAAC"}
+{"version":3,"file":"Resource.js","sourceRoot":"","sources":["../../src/actors/Resource.ts"],"names":[],"mappings":"AAeA,SAAS,GAAG,CAAC,IAA4C;IACxD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACjG,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,qFAAqF;AACrF,qFAAqF;AACrF,SAAS,MAAM,CAAC,IAA6B;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,IAA4C;IACvF,OAAO,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC;AACrF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,KAAgB,EAAE,IAA4C;IACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACvF,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,QAAQ;QAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IACtF,OAAO,IAAI,CAAC;AACb,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":"AAoBA;;;GAGG;AACH,MAAM,OAAO,aAAa;IAIzB,YAAY,MAA+B;QAFnC,WAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QAG1C,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;YACnG,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IACrE,CAAC;IAED,GAAG,CAAC,CAAS,EAAE,CAAS;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,CAAS,EAAE,CAAS;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9B,IAAI,KAAK,GAAwB,IAAI,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,SAAS,GAAG,MAAM;gBAAE,MAAM;YACpC,KAAK,GAAG,KAAK,CAAC;QACf,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,MAAc;QACvC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACpF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,EAAE,CAAC,CAAC;QAC9F,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACjE,CAAC;IAED,IAAI;QACH,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE;YACpD,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACnC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAA6B,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,KAAK,EAAE,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,MAA+B,EAAE,IAAiB;QAChE,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACzC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAChH,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1B,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACzG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;CACD;AAED,SAAS,OAAO,CAAC,CAAS,EAAE,CAAS;IACpC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC"}

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"}