@datamoc/mw_games 0.7.4 → 0.7.7

package/CHANGELOG.md

@@ -5,6 +5,293 @@ 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.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.
+
+### Changed
+
+- 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
+
+- `Blob.spread` returns the cells it just emptied, in reading order, so a game can turn the ground
+  under a fire to embers at the moment the flames leave it instead of diffing `cellsAbove` between
+  two steps to notice. Cells emptied before the step (a doused one) are not reported.
+
+### Changed
+
+- `pixi.js` moved from `dependencies` to an optional peer dependency, the treatment
+  `@babylonjs/core` already had (item 175's 1.0 decision). The install line now names it:
+  `npm install @datamoc/mw_games pixi.js vite`. A game that only uses the renderer-free modules
+  never downloads it. Verified from an empty directory on all three documented paths: the
+  registry install, the `npm pack` tarball installed by path, and the no-install
+  `mw_games.global.js` script tag.
+
 ## [0.7.4] - 2026-09-11
 
 ### Added
@@ -55,8 +342,6 @@ the public API may still change between minor versions.
 - The standalone bundle baseline, API report, documentation, and roadmap were updated.
 - Release checks now isolate npm audit and package-smoke caches from user-level npm settings.
 
-## [Unreleased]
-
 ## [0.7.1] - 2026-09-10
 
 ### Added

package/README.md

@@ -28,6 +28,14 @@ and the [mwg Pixel Dungeon study](https://datamoc.github.io/mwg-pixel-dungeon/).
 > Each future major version is meant to carry a name, one per letter of the alphabet: 1.0 takes
 > 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
+> 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
+> `@deprecated` naming the replacement, and the release notes list it. 1.0 is the last release
+> where either can move silently.
 
 ## What it is for
 
@@ -86,19 +94,24 @@ for free: a finished game is still a folder you double-click.
 **With a toolchain**, if you already use a bundler:
 
 ```
-npm install @datamoc/mw_games
+npm install @datamoc/mw_games pixi.js
 ```
 ```ts
 import { Game, Scene } from '@datamoc/mw_games/core';
 import { Sprite } from '@datamoc/mw_games/two-d/render';
 ```
 
+`pixi.js` is the 2D renderer, and it is an optional peer dependency rather than an installed
+one: a game that only uses `mwg/core`, `mwg/roguelike`, `mwg/actors`, `mwg/i18n` or the other
+logic modules never downloads it. Name it on the install line when a game draws, exactly as
+`@babylonjs/core` is named for 3D.
+
 No npm registry access (an offline machine, a pinned artifact for reproducible builds)?
 `npm pack @datamoc/mw_games` downloads the exact published tarball; install it by path
 instead of by name:
 
 ```
-npm install ./datamoc-mw_games-0.1.1.tgz
+npm install ./datamoc-mw_games-<version>.tgz pixi.js
 ```
 
 **Without either.** Drop one file next to your page and open it: this path exists because

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

package/dist/actors/craft.js

@@ -1,3 +1,15 @@
+function matchesIngredient(item, ingredient) {
+    if (ingredient.matches)
+        return ingredient.matches(item);
+    if (ingredient.category !== undefined)
+        return item.category === ingredient.category;
+    if (typeof ingredient.id === 'string')
+        return item.id === ingredient.id;
+    return (ingredient.id ?? []).includes(item.id);
+}
+function ingredientHasMatcher(ingredient) {
+    return ingredient.matches !== undefined || ingredient.category !== undefined || ingredient.id !== undefined;
+}
 /**
  * Resolves a recipe against an inventory: every ingredient checked, consumed, and the
  * result added, all in one call - the same small-focused-function shape `skillCheck`
@@ -5,10 +17,15 @@
  * 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
  *
@@ -17,38 +34,53 @@
  * 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 function craft(inventory, recipe) {
-    const needed = new Map();
+    //a working copy of every stack's quantity, so an earlier ingredient consumes this allocation
+    //even when a later one matches the same category or predicate
+    const available = new Map();
+    for (const item of inventory.items)
+        available.set(item, item.quantity);
+    const taken = new Map();
     for (const ingredient of recipe.ingredients) {
-        needed.set(ingredient.id, (needed.get(ingredient.id) ?? 0) + ingredient.quantity);
-    }
-    for (const [id, quantity] of needed) {
-        const held = inventory.find(id);
-        if (!held || held.quantity < quantity)
+        if (!ingredientHasMatcher(ingredient))
+            throw new Error('recipe ingredient must name an id, a category, or a matches predicate');
+        if (!Number.isFinite(ingredient.quantity) || ingredient.quantity <= 0)
+            throw new Error('recipe ingredient quantity must be a positive number');
+        let needed = ingredient.quantity;
+        for (const item of inventory.items) {
+            if (needed <= 0)
+                break;
+            const held = available.get(item) ?? 0;
+            if (held <= 0 || !matchesIngredient(item, ingredient))
+                continue;
+            const take = Math.min(held, needed);
+            available.set(item, held - take);
+            needed -= take;
+            taken.set(item, (taken.get(item) ?? 0) + take);
+        }
+        if (needed > 0)
             return false;
     }
-    //captured before anything is removed, so a failed add below can restore exactly this
-    const consumed = recipe.ingredients.map((ingredient) => ({
-        ...inventory.find(ingredient.id),
-        quantity: ingredient.quantity,
-    }));
-    for (const ingredient of recipe.ingredients)
-        inventory.remove(ingredient.id, ingredient.quantity);
+    for (const [item, quantity] of taken)
+        inventory.remove(item.id, quantity, item.instanceId);
     if (inventory.add(recipe.result))
         return true;
-    for (const item of consumed)
-        inventory.add(item);
+    for (const [item, quantity] of taken)
+        inventory.add({ ...item, quantity });
     return false;
 }
 //# sourceMappingURL=craft.js.map

package/dist/actors/craft.js.map

@@ -1 +1 @@
-{"version":3,"file":"craft.js","sourceRoot":"","sources":["../../src/actors/craft.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,KAAK,CAAC,SAAoB,EAAE,MAAc;IACzD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACnF,CAAC;IACD,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,GAAG,QAAQ;YAAE,OAAO,KAAK,CAAC;IACrD,CAAC;IAED,qFAAqF;IACrF,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACxD,GAAG,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAE;QACjC,QAAQ,EAAE,UAAU,CAAC,QAAQ;KAC7B,CAAC,CAAC,CAAC;IAEJ,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW;QAAE,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClG,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9C,KAAK,MAAM,IAAI,IAAI,QAAQ;QAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC;AACd,CAAC"}
+{"version":3,"file":"craft.js","sourceRoot":"","sources":["../../src/actors/craft.ts"],"names":[],"mappings":"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"}

package/dist/actors/index.d.ts

@@ -10,7 +10,7 @@ export type { EquippableItem, EquipmentOptions, SavedEquipment } from './Equipme
 export { Inventory } from './Inventory.ts';
 export type { InventoryItem, InventoryOptions, ItemDefinition, SavedInventory, SavedInventoryItem, } from './Inventory.ts';
 export { craft } from './craft.ts';
-export type { Recipe } from './craft.ts';
+export type { Ingredient, Recipe } from './craft.ts';
 export { applyStatusEffect } from './StatusEffect.ts';
 export type { EffectClock, StatusEffectOptions, StatusEffectHandle } from './StatusEffect.ts';
 export { identify, enchant, damageItem, repairItem } from './ItemState.ts';