@datamoc/mw_games 0.7.6 → 0.7.8

package/CHANGELOG.md

@@ -5,6 +5,365 @@ All notable changes to `mwg` are documented here. Format follows
 [Semantic Versioning](https://semver.org/) as of this first release - a 0.y.z version means
 the public API may still change between minor versions.
 
+## [0.7.8] - 2026-09-12
+
+### Added
+
+- Unit identity usable by the AI. MWL units now carry their own `name`, `role`/function and
+  `can_recruit` leader flag: `[unit]` sets them, a side's own leader is `can_recruit`, `[role]`
+  stamps the role onto the units it matches, `[store_unit]`/save keep them, and `unitMatchesFilter`
+  reads all three - which also wires up the `can_recruit` the `[filter]` schema already allowed but
+  the runtime ignored. On the AI side, `ScoreSubject` and `HeuristicCandidate` carry
+  `type`/`role`/`can_recruit`/`name`, and the new `subjectsWhere`/`ScoreSubjectFilter` select a world
+  on any of them, so a mind can find "the enemy leader" without re-deriving it from ids.
+- Leader identity on the unit (item 296). An autospawned `[side] leader=` unit carries `leader: true`
+  beside its `can_recruit`, `[store_unit]`/unstore and a save keep it, and `unitMatchesFilter` reads
+  it, so `[filter] leader=yes` finds the side's own leader without recomputing
+  `sides[id].leader === id`.
+- One variable-path resolver for every reader (item 295). `$name` resolution, `[condition]`/
+  `[filter_condition]` variable reads, message interpolation and the bare `$name` copy all resolve
+  through the same path walker `set_variable` writes with, so a dotted name like `a.b` reads what
+  `[set_variable] name=a.b` wrote. Array indices are in scope (`a[0].b` reads the node `a.0.b` or
+  `a[0].b` wrote), an index that is not a whole number is refused by name rather than becoming a
+  literal key, and the `id` schema type accepts brackets so such a name compiles.
+- `TerrainGraphicsLayer` (item 257): the renderer half of `[terrain_graphics]`, drawing
+  `resolveTerrainGraphics`'s placements as one `Sprite2D` per placement, in `layer` order (a stable
+  sort, so the rule pass's own row-major walk survives within a layer) at the pixel position a
+  caller-supplied `project` callback reports, with images resolved through the asset resolver.
+  `setPlacements` redraws in place.
+- The canvas backend for inline markup, closing the three pieces item 258's acceptance still
+  named as open: `positionMarkupLines` places `layoutMarkupLines`'s lines into positioned
+  `PositionedMarkupSpan` runs under a `MarkupLayout`'s `direction`/`align`, so an `rtl` line flows
+  right to left and alignment defaults to the direction's own edge, and `MarkupText` draws them as
+  the counterpart to `RichLabel`'s HTML text - one `Text2D` per styled run, one `Sprite2D` per
+  `<img>` span resolved through the asset resolver, so an image is drawn rather than left to the
+  caller to position. An RTL sample is now covered by `tests/markup.test.ts`.
+
+### Fixed
+
+- One rule for the `id` value type, shared by the schema and `mwl.readers`. The schema accepts a
+  bracketed path like `a[0].b` as an `id` (a variable name legitimately carries index brackets),
+  but `readAttributes`' `id` and `id-list` kept a stricter copy of the pattern, so an adapter
+  reading a variable-name attribute raised `MWL_FIELD_TYPE` for a name the compiler had already
+  accepted. Both now call the exported `isMwlId`. One test in `tests/mwl.test.ts`.
+- `actors.sell` is transactional again. It ignored the result of `Inventory.add`, so selling into
+  a shop stock with no room paid the seller and lost the item: two potions sold into a
+  capacity-1 stock produced 10 gold from nothing and left the potions nowhere. It now rolls the
+  bag back and refuses, exactly as `buy` already did for a full bag. One test in
+  `tests/shop.test.ts`.
+- `board.goScore` counts territory again. Its `group` helper returned nothing for an empty
+  square, so the area-scoring loop never saw an enclosed empty region and only stones were
+  scored: four stones ringing a 3x3 board reported 4 instead of 9. `group` now groups connected
+  cells by value with `null` included, which leaves `liberties`/`playGo` unchanged because they
+  only ever pass a stone. One test, plus new coverage for `rollBackgammonDice`, a foundation
+  move from a tableau column, and `DiceCup.clearKept`, in `tests/classics.test.ts`.
+- `board.addTacticalUnit` remembers each unit's own action budget, so `endTacticalTurn` refreshes
+  `actions` to it instead of a hardcoded two. A unit created with `actions: 3` was silently reset
+  to 2 every turn; the per-turn maximum is now `TacticalUnit.maxActions`, filled from the initial
+  `actions` when the caller does not set it. Six tests in `tests/tactics.test.ts`, which also
+  cover the overwatch reaction and attack paths that had none.
+- `board.backgammonMoves` follows the bearing-off rules. It offered a bear-off from any point
+  whose roll reached past the off edge, so at the opening position a 6 came off from point 18
+  while checkers still sat on 0, 11 and 16. A bear-off now needs every checker in the home
+  board with none on the bar; an exact roll still takes any home checker, and an over-roll takes
+  only the checker nearest the off edge, since a checker must never skip past another. Three
+  tests in `tests/classics.test.ts`.
+- An `[if]` branch no longer tries to execute its own `[condition]` child. The schema allows a
+  branch to carry one, but the executor ran every child, so an `[if]` whose condition held threw
+  `unknown MWL command: condition` instead of running its body; a false condition hid it because
+  the body never ran. `[if]`/`[else]` now run their command children only, the same rule
+  `[while]` already followed. Two tests in `tests/mwl-conditions.test.ts`.
+- An `[else]` following an `[if]` is that branch's other half, so only one of the two runs. A
+  taken `[if]` used to run its own body and then fall through to the `[else]` as well, so both
+  branches executed; the `[else]` is now skipped when the `[if]` was taken, and run as the
+  fallback when it was not. Independent pairs still work, and a free-standing `[else]` with no
+  `[if]` before it still runs. Two tests in `tests/mwl-conditions.test.ts`.
+- `[while]` had the same defect as `[if]`, so a loop body carrying a `[condition]` child threw.
+  It now runs its command children too. One test in `tests/mwl-variables.test.ts`.
+- The variable-path readers item 295 named are now complete, closing three that were still flat:
+  a dialogue `[choice]`'s `variable=` gate, `[store_unit]`/`[unstore_unit]`/`[recall]`'s stored
+  list, and the hook host's `setVariable`, plus the public `execute()`'s `set_variable`. An
+  indexed path now builds a real array (`a[0]`, `a[1]`), so a stored list and an indexed write
+  agree on their shape. One test each in `tests/mwl-dialogue.test.ts`, `tests/mwl-actions.test.ts`
+  and `tests/mwl.test.ts`, and the `a[0].b` test now asserts the array.
+
+### Changed
+
+- `board.skirmishMoves` computes every reachable cell from one Dijkstra pass over the map
+  instead of one per candidate cell. The old per-cell search also re-sorted its own frontier
+  every step and `shift()`ed it, so it went quadratic in path length; the pass now uses a
+  binary min-heap. Behaviour is unchanged, verified by a differential run of the old and new
+  implementations over 58 randomised terrain maps. A `[complexity]` test keeps 20 calls on a
+  40x40 map under a ceiling far below the old cost, and a test pins that a cell held by
+  another unit is never offered as a move.
+
+## [0.7.7] - 2026-09-11
+
+### Added
+
+- Heuristic AI (item 269): `Aspects`, `Difficulty`, `Goals`, `RecruitmentPattern`, and a
+  `HeuristicAI` candidate/stage pipeline with `defaultWeigh`/`keepAwayScore`/`goalScore`. Aspects
+  ship no values; the numbers stay content, and `keep_away` is a real penalty.
+- Achievements and battle statistics (item 273): `core.Achievements` gained sub-achievements
+  (multi-criterion unlocks via `AchievementDef.criteria`, read back with `subProgress`), and
+  `battle.BattleStats` tracks recruits/recalls/advances/kills/deaths/damage dealt/damage taken by
+  unit type for a `PlayerStats`/`RunHistory` summary to fold in.
+- Free map rotation (item 286): `Camera.rotateTo`/`animateRotationTo` turn the view to any angle,
+  not only a grid's whole steps, sharing 285's layer-level transform and taking the shorter way
+  around a full turn when animated.
+- Battle UI models (item 265): `AttackPreview` (damage totals and an animated frame timeline from
+  the game's own numbers), `AttackDialog` (the selector plus the preview and its clock),
+  `UnitSelector` (attacker then target), and `Whiteboard` (planned orders with undo/redo). All
+  renderer-free; the dialog's pixels are `Bar`/`Label` a game composes.
+- Story screens (item 264): `StoryScreen` (a full-screen backdrop, title and text advanced by a
+  click) over the renderer-free `StorySequence` (`advance`/`back`/`goTo`/`skip`/`restart`, with the
+  current beat's `music` reported as a signal). `StoryBeat` matches `MwlWorld.story`'s shape.
+- Data-driven shell layout and skins (item 263): `Layout` (`resolveAnchor`/`anchorAlign` over nine
+  named anchors plus `fill`, and a `Grid` of `size`-or-`grow` tracks) and `Skins` (per-widget,
+  per-state looks with a widget-state -> widget-idle -> wildcard fallback chain, and `Skins.from`
+  for plain data). Both renderer-free.
+- The missing UI widgets (item 261): `Slider` (`sliderFraction`/`sliderValueAt`), `Checkbox`,
+  `Spinner` (`spinValue`), `Dropdown`, `TextModel`, `DataTable`, `TreeView` and `ScrollBox`
+  (`scrollOffset`). The rule-bearing parts are pure functions or renderer-free models tested
+  headlessly, the drawing is a thin theme-driven shell, and text fields pair `TextModel` with a
+  `Label` rather than a separate `TextArea`.
+- Fixed-angle view rotation on `Camera` (item 285): `grid: 'square' | 'hex'` sets four quarter turns
+  or six 60-degree steps, `setRotationStep`/`rotate` move through them, `toScreen`/`toWorld` invert
+  the turn, `view` reports the box around the turned viewport for culling, and `uprightRotation`
+  keeps a label drawn into the world upright.
+- WML action vocabulary in `[event]` (item 250): `fire_event`, `store_unit`/`unstore_unit`/`recall`,
+  `modify_unit`/`heal_unit`, `set_terrain`, `capture_village`, `clear_shroud`, and the scenario-level
+  `[role]`/`[object]`/`[story]`, backed by `MwlWorld.villages`/`clearedShroud`/`roles`/`objects`/
+  `story` (all saved). WML's scenario `[item]` is deliberately not added: the tag already means an
+  inventory item definition.
+- `blendPixels`/`rotatePixels` in `ImageModifiers.ts`: `~BLEND` and `~ROTATE` moved from a
+  runtime sprite-property/`ColorMatrixFilter` approximation to an exact, baked-once per-pixel
+  operation in `applyTextureModifiers` (`~ROTATE` in particular now rotates the source pixels
+  and expands the surface, which a sprite's own `rotation` cannot do - needed for terrain and
+  anything else that must keep tiling after the rotation). `blendMatrix` stays available for a
+  caller that explicitly wants the cheaper live approximation instead.
+- `PaletteRemapMode` (`'exact'` | `'nearest'`) on `remapPixels`/`recolorTexture`, defaulting to
+  `'exact'`: a pixel is now repainted only on an exact match to a `from` colour unless
+  `'nearest'` is asked for explicitly. The old always-nearest behaviour silently recoloured an
+  entire image the first time `~RC`/`~PAL` met a short, specific palette instead of a full
+  covering; `paletteRangeMapping`'s own gradient usage opts into `'nearest'` explicitly, since
+  that is the one case it is correct for.
+- `ImageTextureProbe.resolveColor` and the exported `parseColorPairs`/`parsePaletteLists`: `~RC`
+  and `~PAL` now accept a named colour (`~RC(magenta>red)`), not hex only, and `~PAL`'s two
+  comma-separated colour lists parse correctly instead of only the first colour of each list
+  (`parseImagePath`'s own comma split does not respect that list's internal boundary, which
+  `parsePaletteLists` now reconstructs).
+- `~BLIT`/`~MASK` now hand `resolveTexture` the argument exactly as written, nested modifiers
+  included (`~BLIT(unit.png~RC(magenta>red),0,0)` calls it with the full string, not a bare
+  path with the modifier silently dropped).
+- `withTextureCanvas` is now exported from `two-d/render`, so a caller building its own
+  texture-level modifier can reuse the same canvas bookkeeping `recolorTexture`/`~BLIT`/`~MASK`/
+  `~BLEND`/`~ROTATE` all share instead of duplicating it.
+
+- `mwl.parseMapFile`/`MwlMapFile` (item 284): a Wesnoth-shaped `.map` loader. The `key=value`
+  header is split off and kept (keys not interpreted), and the comma-separated grid goes through
+  the same `parseTerrain` an inline `[map] terrain=` uses.
+- `actors.craft` category-shaped ingredients (item 289): `Ingredient` now accepts `id` as a string
+  or a list, a `category` matched against the item definition's new `InventoryItem.category`
+  (kind-level, so it stays out of saves), or a `matches(item)` predicate. `craft` allocates against
+  a working copy so two flexible ingredients cannot count one stack twice.
+- `two-d/render/SpriteAttachment.ts`: `SpriteAttachment` (item 291), ties a second sprite's
+  position to a first one's - `follow(x, y)` applies an offset, an optional `duration` makes
+  `update(dt)` report `done` once it elapses, so a permanent shadow and a temporary status icon
+  are the same class with different options. Renderer-neutral like `Projectile`/`LightningArc`.
+
+- `two-d/render/LightningArc.ts`: `LightningArc` (item 292), the position data for a jittered
+  line between two points - a lightning bolt, a tether, a chain-lightning link - geometry only,
+  drawn by the caller through `Shape2D`'s `Graphics`. `retarget` moves either endpoint for a
+  tether following two moving units; an optional `flickerInterval` re-rolls the jitter on a
+  timer instead of holding one fixed shape.
+- `assets.load`'s `optional`/`onMissing` options (item 287): paths a game can do without load
+  separately from the required batch, so one missing file never aborts the rest; `texture`/`get`
+  take a `fallback` value returned instead of a throw for a path that never loaded.
+
+- `MultiTurnBeam` fronts, `blocker`, `onCell` and saved shape identity (item 278): a beam is now a
+  sequence of per-turn fronts rather than one captured cell per turn, so a game-supplied
+  `fronts(previous, turn)` expresses a cone, burst, fork or moving front. `BeamBlocker` replaces
+  the implicit blocker flags with one policy, `BeamStep.cells` reports every reached cell, and a
+  save carries the shape name so `fromJSON` refuses a mismatched shape; pre-fronts saves still load.
+- `two-d/render/PaletteRemap.ts`: `remapPixels`/`paletteRangeMapping`/`recolorTexture` (item
+  256), a nearest-colour palette remap for team-colour-by-range - `paletteRangeMapping` places a
+  reference palette's own lightest-to-darkest order along a `min -> mid -> max` gradient,
+  `remapPixels` is the renderer-free pixel core, and `recolorTexture` (via the new shared
+  `withTextureCanvas` helper) is the canvas-backed wrapper.
+- Eleven more `image~MOD` suffixes in `ImageModifiers.ts` (item 255): `~O`, `~R`/`~G`/`~B`,
+  `~BLEND` and `~CHAN` join `~FL`/`~SCALE`/`~GS`/`~CS` as sprite-property/`ColorMatrixFilter`
+  operations on `applyImageModifiers`; `~ROTATE` sets the sprite's own rotation. `~RC`, `~PAL`,
+  `~BLIT` and `~MASK` needed real pixel access or a sibling texture, so they are the new
+  `applyTextureModifiers`, built on 256's `withTextureCanvas`. `~GS` no longer replaces a filter
+  already on the sprite (was clobbering, now appends).
+- `two-d/render/TerrainGraphics.ts`: `resolveTerrainGraphics`/`TerrainRule`/`matchTerrainRule`/
+  `squareRotate`/`hexRotate` (item 257), a rule-driven `[terrain_graphics]`-style transition pass
+  generalising `Autotile`'s fixed 47-shape blob table: arbitrary flag conditions at arbitrary
+  offsets, multi-image placement (so a piece bigger than one cell is one rule's own data, not
+  something `TileMap`'s one-sprite-per-cell grid has to hold), rotation and probability. Returns
+  plain placement data; drawing it through a renderer is still open.
+- `markupToHtml` now renders colour and size as an inline style; `markupAccessibilityText` is a
+  proper accessibility projection for markup (an image becomes a caller-described string instead
+  of its raw path); `layoutMarkupLines` wraps already-parsed spans word by word, each word
+  measured under its own span's style, so a bold or larger run wraps where its own wider glyphs
+  actually land (item 258's remaining acceptance, in part - see ROADMAP for what is still open).
+
+- `ParticleEmitter` spawn bounds (item 279): `ParticleSpawnArea` is an optional `spawn` on the
+  emitter's options, a `rect` or `ellipse` in local space so a burst spreads across an extent
+  instead of every particle starting at the emitter's single origin (a forge mouth, a flame
+  column, rain across a room). A point emitter draws nothing extra, so the seeded sequence an
+  existing replay recorded is unchanged.
+- `roguelike.TargetingController` (item 280): the input-facing half of targeting, renderer-free.
+  A cursor moved by `move(dx, dy)` or a caller-resolved `moveTo(cell)`, range and line-of-sight
+  validation with an optional `validate` hook, a `preview()` of the shape's cells and a
+  `confirm()`/`cancel()` result carrying cells only, so damage, legality details and drawing stay
+  with the game. Hex levels step by their own six neighbours and measure in hex distance.
+- `AudioListener`/`SoundSource`/`audioGain`/`audioPan`/`AudioFalloff` (item 271): positional
+  audio, renderer-free. A listener the game moves and turns, a `Sound` placed at a world point,
+  and the distance gain and stereo pan between them. `SoundSource.playFor(listener)` applies the
+  gain through `Sound.play`, which now takes an optional gain argument.
+- `Input.onText`/`Input.onComposition`/`Input.textFromKey`/`Input.dispatchText`/
+  `Input.dispatchComposition` (item 262): the character a key press produces, and the three
+  phases of an input-method composition, so a free text field can be built. `onText` is a
+  stack-mode signal a focused field can consume.
+- `MersenneTwister`/`MersenneTwisterState`/`RandomStreams` (item 266): MT19937 with the reference
+  `mt_rng`'s `seed`/`discard`/`discardCount` bookkeeping (verified against the standard test
+  vector) and named, independent streams derived from one base seed, so per-entity and per-usage
+  draws never shift each other. C++'s `uniform_int_distribution` is implementation-defined, so the
+  int mapping is MWG's own and documented as such.
+- `i18n.parsePo`/`PoOptions` (item 270): a gettext `.po` loader into the same `Catalog` surface
+  as `parseFTL`, with `msgctxt`, `msgstr[N]` mapped onto the locale's CLDR categories,
+  untranslated entries left out for base fallback, and gettext `domain`-prefixed keys.
+- `world.SideTurns`/`SideTurn`/`TimeOfDay`/`TimeArea`/`Alignment`/`alignmentBonus` (item 267): the
+  reference's outer turn model, sides in order with a schedule that steps per round, and a per-hex
+  `lawfulBonusAt` where a `TimeArea` overrides the global time of day.
+- `ui.TabbedList`/`ListTab`/`TabbedListOptions` (item 281): a renderer-free model for a tabbed,
+  filtered, paged list with selection and a detail/close state, over caller-supplied rows and
+  predicates. The page is derived from the selection, so the two cannot disagree.
+- `simulation.EventPresentation`/`EventPresentationOptions` (item 282): the documented recipe
+  tying a `SimulationRuntime` to a `PresentationQueue` - command result, animation lock,
+  scheduled secondary actor, cancellation, and save/load that resumes idle.
+- `MwlWorld.sideStatus` and per-side `[victory]`/`[defeat]` under `[side]` (item 283): a side's
+  own condition is evaluated after the scenario-wide `[objectives]` ones, its result recorded by
+  side id, and `[win]`/`[lose]` record the side they name too. `MwlCommand`'s `win`/`lose` gained an
+  optional `side`.
+- `simulation.CampaignSave`/`CampaignSaveState`/`CampaignSaveParts` (item 249): one `SaveSystem`
+  slot for a whole campaign, holding the campaign, world and simulation snapshots together, with
+  the world payload left opaque.
+- `core.stateChecksum`/`core.SyncGuard` (item 272): a key-order-stable 32-bit checksum of JSON
+  state and a guard comparing the checksums peers compute per tick, so a lockstep run can notice
+  and locate a divergence.
+- `ai.personalScoreView`/`ai.sideScoreView`/`ai.scoreWith`, over `ScoreSubject`/`ScoreView`/
+  `ScorePersonality` (items 274-276): the numbers a mind needs when a search is the wrong tool.
+  The game supplies what anything is worth, the framework assembles the view (own, allies and
+  enemies kept apart, with a `seen` count), and a personality is weights over the three, so a
+  selfish scout and a loyal one are content rather than two AI implementations. A unit's sight and a
+  whole side's read through the same two functions and differ only in the visibility set they are
+  handed, and `board.FactionFog.sees(side)` is that set as a predicate: it reads the shroud as it is
+  when called, not as it was when the predicate was made.
+- `Animation`/`AnimatedSprite` frame timing (item 254): a frame is now a texture or
+  `{ texture, duration, offsetX, offsetY }`, so a frame carries its own time and its own place, as
+  Wesnoth's `image=a.png:120,b.png:80` does, and `AnimationOptions.startTime` is signed the way
+  Wesnoth writes it: positive holds the first frame, negative starts partway in (`start_time=-450`
+  over frames of 100ms opens on the fifth, which is how a swing is lined up with its damage frame).
+  `Animation.frameAt`/`frameIndexAt` are the rule, the sprite advances on its own elapsed time
+  rather than a leftover timer, and a frame's offset is reported through `AnimatedSprite.frameOffset`
+  for the caller to add where it already positions the sprite.
+- `FactionFog.share(factions)` (item 268): factions put on one map, what is lit now and the shroud
+  they remember alike, which is what Wesnoth's `share_vision` means. Nothing shares until asked,
+  growing a group widens it rather than replacing it, and a share declared after a `sync` still
+  counts because the group is read when a cell is asked about. `sees(side)` follows it, so a side's
+  score view reads the team's eyes.
+- `campaignChain` (item 247): a `[campaign]` pointed at `simulation.Campaign`. `first_scenario` opens
+  it, each `[scenario]`'s `next_scenario` is where it goes when it is won, and the chain ends where a
+  scenario has no next one. The order is content and the playing stays the game's, since the runner
+  is a callback; a scenario that decides for itself keeps its decision, which is where a runtime
+  `[endlevel]` will hook in. Malformed chains (no scenarios, one id twice, an unknown
+  `first_scenario`) throw by name. The `[campaign]` schema now accepts `first_scenario`, and
+  `contentCatalog` exposes each campaign's scenario links.
+- `[endlevel]` and carry-over (item 248): a scenario ends with `result=victory|defeat`, and what it
+  hands on is `endLevelCarryover` - `bonus` plus a share of the side's gold (`carryover_percentage`,
+  80% when unset, which is the reference's own default rather than an invented one), the units of
+  that side still standing as the recall list, and `next_scenario` for where the campaign goes (the
+  hook `campaignChain` already honours). `carryoverIntoScenario` is the other half of the rule: the
+  carried share is added to what the next scenario declares when `carryover_add` asks for it, and is
+  otherwise a floor under it. `MWL_DEFAULT_CARRYOVER_PERCENTAGE` names the default.
+- `[kill]` as a filter (item 251): naming a unit that is not there still throws, while a `[kill]`
+  whose attributes are a filter over the world's units is a no-op when it matches nobody, as WML's
+  own `[kill]` is. It reads the same attributes an event filter does, an empty filter matches every
+  unit (there as here), and the schema entry is open on attributes so a filter can say what it
+  means.
+- A scenario turn limit, as a native condition (item 253): `[game] turn_limit=N` makes the runtime
+  set `time_over` as a world variable and fire the `time_over` event once the turn counter passes N.
+  Content tests it like any variable and answers it like any event, `[endlevel]` included, because a
+  limit is usually a defeat and sometimes the whole scenario.
+- An inline-markup contract, first half of item 258: `MarkupSpan` plus `parseMarkup`/`stripMarkup`/
+  `markupToHtml`/`escapeHtml` in `src/two-d/ui/markup.ts`. Nested emphasis, named and hex colours, a
+  size, a line break, an image span carrying a path, `$name` interpolation supplied by the caller,
+  and the five entities as escapes. Unknown or malformed tags and unset variables stay literal
+  rather than vanishing, and output text is escaped so no raw HTML can leak. What the item's
+  acceptance still wants (backend equivalence, wrapping after styling, images through the asset
+  resolver, an accessibility projection) is recorded on the item rather than implied here.
+- The `[side]` surface, and one key of it with behaviour (item 252): the Wesnoth keys `team_name`,
+  `user_team_name`, `share_vision`, `village_gold`, `heal`, `fog`, `shroud`, `hidden` and `flag` are
+  read onto `MwlWorld.sides` as written (`yes`/`no` as booleans), and `sideVisionGroups` turns
+  `team_name` with `share_vision` into the groups `FactionFog.share` takes.
+- Hex projection options, first half of item 259: `hexToPixel`/`pixelToHex` take
+  `HexShape`/`HexOrientation`/`HexOffset`, so a grid can be flat-top or pointy-top with either
+  offset parity, and the default is the flat-top odd-q layout the module always had. The inverse is
+  the nearest cell centre, which cannot disagree with the projection at a hex's edge.
+- `Halo` (item 260): the glow around a unit, an aura, a shrine's light. An `AnimatedSprite` that
+  `follow(x, y)`s a target with its own offset applied once, additive by default, with z-order left
+  to the caller. `[halo_frame]` needed nothing new after 254 gave frames their own timing.
+
+### Fixed
+
+- `FloatingTextStack` stacked the wrong way round: it moved the **newcomer** down by
+  `height + 1`, where Java's `FloatingText.push()` anchors the newcomer on the target and lifts
+  the lines already there to `below.top - height - 4`. A second pop-up on one target in one turn
+  therefore landed *below* the target instead of above the first - found by a consumer measuring
+  it, not by the tests, which asserted the offset's magnitude and never its direction.
+  `floatingTextStackOffset` is replaced by `floatingTextStackLift` (the position the older line
+  must take, rather than an offset the caller adds, so the sign cannot be got wrong quietly) and
+  by `floatingTextStackMoves`, the whole policy: which lines move, newest first, where each one
+  ends up, and what age each is forced to. The loop is arithmetic now, so it is checked as
+  arithmetic rather than through a rendered label. `FLOATING_TEXT_STACK_GAP` names Java's 4px gap.
+- The lift survived exactly one frame. `FloatingText.update` wrote its own `y` from a base captured
+  on the first frame, so a line the stack had just moved snapped back on the next one: measured, a
+  line lifted to 166.6 was back at 194.4 beside the newcomer at 200, still overlapping it. The rise
+  now moves the pop-up's inner layer and never its position, which belongs to the caller and to the
+  stack; `baseY` is gone. A consumer repositioning a pop-up mid-flight no longer loses the position
+  on the next frame either.
+- A pop-up scaled *after* `push` was measured before the scale, because a `FloatingText`'s `height`
+  includes its own scale. A port rasterising at 21px and drawing at 7 therefore spaced lifted lines
+  33.4 world pixels apart for lines 9.8 tall. `push` now takes a `scale`, applied before the pop-up
+  is measured, so the entry records the size the line is actually drawn at.
+
+### Changed
+
+- `FloatingText.shortenLife(seconds)` becomes `FloatingText.ageAtLeast(seconds)`, which does what
+  Java's rule says rather than something close: `above.timeLeft = Math.min(above.timeLeft,
+  LIFESPAN - numBelow / 5f)` caps what is *left*, and a cap on what is left is a floor under the
+  age. A line that has already lived past the floor keeps the age it has, where subtracting the
+  floor shortened it a second time. `floatingTextAgeAtLeast` is that arithmetic as a pure function,
+  so the difference is checked by a test; `floatingTextStackLifePenalty(linesBelow)` stays the
+  floor itself, a fifth of a second per line below.
+- A stack keys on `key` alone, as Java's `stacks.get(key)` does. The old rule wanted the same key
+  *and* the same origin, which this framework had invented. A caller that reused one key for two
+  different targets now sees their lines stacked together, and has to give each target its own key.
+- One side identity in `MwlWorld` (item 277): `unit.side`, `MwlMessage.side`, `MwlMap.starts` keys
+  and every `side`/`side_filter` attribute now hold the string `id` `[side]` declares, so a named
+  side (`id=rebels`) works throughout. `MwlSideRef` is just that id. The `[side] id` and the other
+  side-identifying schema attributes accept a string (numbers still validate), and the map
+  `<side> <code>` keep marker accepts a name.
+
+### Fixed
+
+- `ui.Window` (item 290): `closed` is now a getter to guard a caller's reference after `close()`,
+  `close()` is idempotent, input and layout on a closed window are no-ops rather than throws on
+  freed Pixi internals, and `WindowStack.push` refuses a closed window with a named error.
+
 ## [0.7.6] - 2026-09-11
 
 ### Added

package/README.md

@@ -12,12 +12,12 @@ of their own; improvements to `mwg`'s own files are shared back.
 playable in the browser with no download, plus the generated API reference.
 
 **[AI project prompt](https://datamoc.github.io/mwg/ai-prompt/)**: a copy-ready prompt for
-planning or porting a demanding game with mwg, with links to the [mwg reference](REFERENCE.md)
+planning or porting a demanding game with mwg, with links to the [mwg reference](https://github.com/datamoc/mwg/blob/main/REFERENCE.md)
 and the [mwg Pixel Dungeon study](https://datamoc.github.io/mwg-pixel-dungeon/).
 
-> **Status: pre-alpha (v0.7.4).** Every module in the shared floor below, plus optional
+> **Status: pre-alpha (v0.7.7).** 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.
+> [ROADMAP.md](https://github.com/datamoc/mwg/blob/main/ROADMAP.md) for the full, numbered history.
 >
 > 0.4.0 was the reshaping release: the renderer moved out of `mwg/core`, `render`/`ui`/`stage`
 > became `mwg/two-d`, and a set of names that meant several things each were made to mean one.
@@ -29,8 +29,8 @@ and the [mwg Pixel Dungeon study](https://datamoc.github.io/mwg-pixel-dungeon/).
 > a name beginning with A, 2.0 one beginning with B, and so on. None of the names are chosen
 > yet, and nothing depends on them until they are.
 >
-> **API stability:** everything documented in [REFERENCE.md](REFERENCE.md) and
-> [API_REPORT.md](API_REPORT.md) is meant to be stable from 1.0 on. Anything that is not carries
+> **API stability:** everything documented in [REFERENCE.md](https://github.com/datamoc/mwg/blob/main/REFERENCE.md) and
+> [API_REPORT.md](https://github.com/datamoc/mwg/blob/main/API_REPORT.md) is meant to be stable from 1.0 on. Anything that is not carries
 > an `@experimental` tag in its own doc comment, and is called out as experimental in the release
 > notes that introduce it, so it can still change or disappear without a major version. A rename
 > or a removal is deprecated first: the old name keeps working, its doc comment carries
@@ -143,7 +143,7 @@ them rather than pretending otherwise:
 The practical effect: resources are **compiled at build time**, so at runtime every lookup
 is synchronous. Game code never awaits an asset. The developer-side scripts behind this
 and the other workflows (translation editing, benchmarks, packaging) are listed in
-[tools.md](tools.md).
+[tools.md](https://github.com/datamoc/mwg/blob/main/tools.md).
 
 ## Capability spec
 
@@ -387,7 +387,7 @@ with `advanceToInput`.
 
 ## Roadmap
 
-See [ROADMAP.md](ROADMAP.md) for the full, numbered build order and implementation notes.
+See [ROADMAP.md](https://github.com/datamoc/mwg/blob/main/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.
 
 ## MWL

package/dist/actors/Inventory.d.ts

@@ -24,6 +24,12 @@ export interface InventoryItem {
     quantity: number;
     stackable?: boolean;
     weight?: number;
+    /**
+     * A kind-level grouping - `'herb'`, `'runestone'`, `'potion'` - so a recipe can ask for "any
+     * herb" rather than one exact id. Like `stackable` and `weight` it describes the item's kind,
+     * so it comes from the game's item definitions on load and is not part of a save.
+     */
+    category?: string;
     /**
      * Distinguishes otherwise-identical instances of the same item id - two `"sword"`s, one
      * enchanted and one not, or two enchanted differently - so they never silently merge into
@@ -95,7 +101,7 @@ export declare class Inventory {
     static fromJSON(defs: ReadonlyMap<string, ItemDefinition>, data: SavedInventory): Inventory;
 }
 /** the kind-level fields a game's own item table supplies, rather than the save file */
-export type ItemDefinition = Pick<InventoryItem, 'stackable' | 'weight'>;
+export type ItemDefinition = Pick<InventoryItem, 'stackable' | 'weight' | 'category'>;
 /** one slot as saved: instance state only, no kind-level fields */
 export interface SavedInventoryItem {
     id: string;

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

@@ -1 +1 @@
-{"version":3,"file":"Inventory.d.ts","sourceRoot":"","sources":["../../src/actors/Inventory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,aAAa;IAC7B,mGAAmG;IACnG,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,mFAAmF;IACnF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,SAAS;IACrB,OAAO,CAAC,KAAK,CAAuB;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,YAAY,OAAO,GAAE,gBAAqB,EAEzC;IAED,IAAI,KAAK,IAAI,SAAS,aAAa,EAAE,CAEpC;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,OAAO,CAAC,QAAQ;IAIhB,8FAA8F;IAC9F,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAI/D;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAmBhC;IAED,0FAA0F;IAC1F,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAU/D;IAED;;;OAGG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAc7E;IAED;;;;;;;;;;;OAWG;IACH,MAAM,IAAI,cAAc,CAiBvB;IAED;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,cAAc,GAAG,SAAS,CAsB1F;CACD;AAED,wFAAwF;AACxF,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,QAAQ,CAAC,CAAC;AAEzE,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC5B"}
+{"version":3,"file":"Inventory.d.ts","sourceRoot":"","sources":["../../src/actors/Inventory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,aAAa;IAC7B,mGAAmG;IACnG,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,mFAAmF;IACnF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,SAAS;IACrB,OAAO,CAAC,KAAK,CAAuB;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,YAAY,OAAO,GAAE,gBAAqB,EAEzC;IAED,IAAI,KAAK,IAAI,SAAS,aAAa,EAAE,CAEpC;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,OAAO,CAAC,QAAQ;IAIhB,8FAA8F;IAC9F,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAI/D;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAmBhC;IAED,0FAA0F;IAC1F,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAU/D;IAED;;;OAGG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAc7E;IAED;;;;;;;;;;;OAWG;IACH,MAAM,IAAI,cAAc,CAiBvB;IAED;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,cAAc,GAAG,SAAS,CAsB1F;CACD;AAED,wFAAwF;AACxF,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC,CAAC;AAEtF,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC5B"}

package/dist/actors/Inventory.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"Shop.d.ts","sourceRoot":"","sources":["../../src/actors/Shop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,KAAK;IACrB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC3B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CACnC;AAED,kGAAkG;AAClG,wBAAgB,GAAG,CAClB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GAClB,OAAO,CAkBT;AAED,iGAAiG;AACjG,wBAAgB,IAAI,CACnB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GAClB,OAAO,CAWT"}
+{"version":3,"file":"Shop.d.ts","sourceRoot":"","sources":["../../src/actors/Shop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,KAAK;IACrB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC3B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CACnC;AAED,kGAAkG;AAClG,wBAAgB,GAAG,CAClB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GAClB,OAAO,CAkBT;AAED,iGAAiG;AACjG,wBAAgB,IAAI,CACnB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GAClB,OAAO,CAcT"}

package/dist/actors/Shop.js

@@ -26,7 +26,10 @@ export function sell(wallet, stock, bag, id, quantity, options) {
     if (!item || item.quantity < quantity)
         return false;
     bag.remove(id, quantity);
-    stock.add({ ...item, quantity });
+    if (!stock.add({ ...item, quantity })) {
+        bag.add({ ...item, quantity }); //the shop's stock had no room - put the item back
+        return false;
+    }
     wallet.setBase(options.currency, wallet.base(options.currency) + price.sell * quantity);
     return true;
 }

package/dist/actors/Shop.js.map

@@ -1 +1 @@
-{"version":3,"file":"Shop.js","sourceRoot":"","sources":["../../src/actors/Shop.ts"],"names":[],"mappings":"AAsCA,kGAAkG;AAClG,MAAM,UAAU,GAAG,CAClB,MAAiB,EACjB,KAAgB,EAChB,GAAc,EACd,EAAU,EACV,QAAgB,EAChB,OAAoB;IAEpB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,GAAG,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE1D,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG,QAAQ,CAAC;IAClC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI;QAAE,OAAO,KAAK,CAAC;IAEvD,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,kDAAkD;QACvF,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC;AACb,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,IAAI,CACnB,MAAiB,EACjB,KAAgB,EAChB,GAAc,EACd,EAAU,EACV,QAAgB,EAChB,OAAoB;IAEpB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,GAAG,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEpD,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACzB,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC;IACxF,OAAO,IAAI,CAAC;AACb,CAAC"}
+{"version":3,"file":"Shop.js","sourceRoot":"","sources":["../../src/actors/Shop.ts"],"names":[],"mappings":"AAsCA,kGAAkG;AAClG,MAAM,UAAU,GAAG,CAClB,MAAiB,EACjB,KAAgB,EAChB,GAAc,EACd,EAAU,EACV,QAAgB,EAChB,OAAoB;IAEpB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,GAAG,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE1D,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG,QAAQ,CAAC;IAClC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI;QAAE,OAAO,KAAK,CAAC;IAEvD,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,kDAAkD;QACvF,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC;AACb,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,IAAI,CACnB,MAAiB,EACjB,KAAgB,EAChB,GAAc,EACd,EAAU,EACV,QAAgB,EAChB,OAAoB;IAEpB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,GAAG,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEpD,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACzB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,kDAAkD;QAClF,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC;IACxF,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/actors/craft.d.ts

@@ -1,10 +1,23 @@
 import type { Inventory, InventoryItem } from './Inventory.ts';
+/**
+ * What one recipe ingredient consumes. `id` is the simple case: one exact item, or any of
+ * several. `category` asks for any item of a kind ("any herb plus any runestone"), matching the
+ * `category` an item's definition carries. `matches` is the escape hatch when neither fits.
+ * Give exactly one of the three.
+ */
+export interface Ingredient {
+    /** one exact item id, or any of several */
+    readonly id?: string | readonly string[];
+    /** any item whose `category` is this */
+    readonly category?: string;
+    /** full control: an item this returns true for */
+    readonly matches?: (item: InventoryItem) => boolean;
+    /** how many items matching this the recipe needs */
+    readonly quantity: number;
+}
 export interface Recipe {
-    /** what gets consumed, by id and how much of each */
-    ingredients: Array<{
-        id: string;
-        quantity: number;
-    }>;
+    /** what gets consumed, by exact id, by category, or by predicate */
+    ingredients: Ingredient[];
     /** what one crafting resolves to - a full item, since it needs its own weight/stackable */
     result: InventoryItem;
 }
@@ -15,10 +28,15 @@ export interface Recipe {
  * adds/removes what a game already hands it; nothing there turns one stack of items into a
  * different one, which is the entire gap this closes.
  *
- * All or nothing: if any ingredient is missing or too few, nothing is touched. If every
- * ingredient is present but the result would not fit (`Inventory`'s own capacity, unrelated
- * to crafting itself), the ingredients are put back exactly as they were rather than being
- * spent for nothing.
+ * An ingredient may name an exact `id` (or any of several), a `category` ("any herb", matched
+ * against the item definition's own `category`), or a `matches` predicate, and a quantity is
+ * taken from as many matching stacks as it spans.
+ *
+ * All or nothing: if any ingredient is missing or too few, nothing is touched. The allocation
+ * runs against a working copy of the stacks first, so two ingredients that could both take the
+ * same stack cannot each count it. If every ingredient is present but the result would not fit
+ * (`Inventory`'s own capacity, unrelated to crafting itself), the ingredients are put back
+ * exactly as they were rather than being spent for nothing.
  *
  * @returns whether the recipe resolved
  *
@@ -27,15 +45,18 @@ export interface Recipe {
  * import { craft, Inventory, type Recipe } from '@datamoc/mw_games/actors';
  *
  * const bag = new Inventory();
- * bag.add({ id: 'wood', quantity: 3, stackable: true });
- * bag.add({ id: 'iron', quantity: 1, stackable: true });
+ * bag.add({ id: 'sage', quantity: 2, stackable: true, category: 'herb' });
+ * bag.add({ id: 'ember', quantity: 1, stackable: true, category: 'runestone' });
  *
  * const recipe: Recipe = {
- *   ingredients: [{ id: 'wood', quantity: 2 }, { id: 'iron', quantity: 1 }],
- *   result: { id: 'torch', quantity: 1 },
+ *   ingredients: [
+ *     { category: 'herb', quantity: 2 },
+ *     { category: 'runestone', quantity: 1 },
+ *   ],
+ *   result: { id: 'elixir', quantity: 1 },
  * };
  *
- * const made = craft(bag, recipe); // true - both ingredients present, consumed, torch added
+ * const made = craft(bag, recipe); // true - any herb plus any runestone becomes an elixir
  * ```
  */
 export declare function craft(inventory: Inventory, recipe: Recipe): boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"craft.d.ts","sourceRoot":"","sources":["../../src/actors/craft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,WAAW,MAAM;IACtB,qDAAqD;IACrD,WAAW,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAErD,2FAA2F;IAC3F,MAAM,EAAE,aAAa,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAqBnE"}
+{"version":3,"file":"craft.d.ts","sourceRoot":"","sources":["../../src/actors/craft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACzC,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC;IAEpD,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,MAAM;IACtB,oEAAoE;IACpE,WAAW,EAAE,UAAU,EAAE,CAAC;IAE1B,2FAA2F;IAC3F,MAAM,EAAE,aAAa,CAAC;CACtB;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CA+BnE"}