@datamoc/mw_games 0.24.1 → 0.26.1

package/CHANGELOG.md

@@ -7,6 +7,146 @@ the public API may still change between minor versions.
 
 ## [Unreleased]
 
+## [0.26.1] - 2026-10-07
+
+The 0.26.0 follow-up: its Chrome end-to-end test failed on every CI run, so the
+`tools/browser-driver` Chrome engine never actually worked on a CI machine (a cold
+Windows runner never reached the debugging endpoint in the old budget; an Ubuntu
+runner crashed in Chrome's sandbox). Chrome now launches against its own profile,
+the endpoint is watched on both output streams with a cold-start budget and a
+diagnostic that names what the browser printed, `close` releases the profile and
+the stdio pipes only after the child exits, and the CI workflows pass
+`--no-sandbox` on Linux through the driver's own `MWG_DRIVER_CHROME_ARGS` channel.
+0.26.0 was tagged before this was known and its npm publish never ran.
+
+### Fixed
+
+- `tools/browser-driver`'s Chrome engine launches against its own profile
+  (`options.profileDir`, or a temp dir the driver creates and removes on `close`)
+  instead of the machine's default one, watches both stdout and stderr for the
+  debugging endpoint (which stream a build prints it on is not something to bet
+  on), waits up to 30 s instead of 15 (a cold CI machine's first Chrome start can
+  outrun the old budget), and names what the browser printed when the endpoint
+  never arrives. This is the fix for the Chrome end-to-end test failing on every
+  CI run since the driver landed: the default profile on a fresh runner never
+  reached the endpoint in time. `close` now also destroys the child's stdio
+  pipes (surviving browser helper processes could hold a suite open past the
+  browser's own death) and releases the profile only after the child exits.
+  The failing configuration is now diagnosed, not just reported: the timeout
+  names what the browser printed. CI's Linux jobs pass `--no-sandbox` through
+  the driver's `MWG_DRIVER_CHROME_ARGS` channel, since an Ubuntu 23.10+ runner
+  that disables unprivileged user namespaces is a property of that machine,
+  not of the tool.
+
+## [0.26.0] - 2026-10-07
+
+The machine-readable surface and the audit tooling around it: `api-surface.json` ships as the
+`./api-manifest` subpath (one `{ name, kind, subpath, declaringModule }` row per export), the
+blessed `mwg/headless` entry imports every renderer-free module in one line, `tools/audit-adoptions`
+checks a consumer's imports and local definitions against that manifest, and the dependency-free
+`tools/browser-driver` harness drives real Chrome and Firefox. `core` gained injectable `RandomSource`
+streams for every derived helper and the shared square-grid rulers (`chebyshev`, `manhattan`,
+`euclidean`, `distance` by `DistanceMetric`), the coverage gate now enforces `two-d/ui` instead of
+excluding the whole tree, and the bundle-size baseline is refreshed for the growth those brought.
+
+### Added
+
+- Exported the types a public signature already names: `mwl` move/evolution/matchup
+  definitions, `core` achievement criteria and hex shape types, particle curve and spawn
+  area types, screen effect steps, `rpg` route targets, asset loader options, and the
+  `core.HttpTransport` base class its four clients already extend.
+
+- `core.NEIGHBOURS4`/`NEIGHBOURS8`/`CIRCLE8` share one frozen square-grid offset table
+  instead of each module keeping its own: axial, row-major eight, and the clockwise ring
+  (`roguelike`'s `neighbourOffsets` returns these now); `core.euclidean` is the
+  straight-line ruler beside `roguelike`'s `chebyshevDistance`.
+
+- `core.chebyshev` is the king-move ruler beside `euclidean` (a diagonal costs one
+  step) and `core.manhattan` the orthogonal-step count; `core.distance` measures with
+  the ruler a `DistanceMetric` names, so a data-authored rule picks its geometry by
+  name. `roguelike`'s `chebyshevDistance` delegates to `chebyshev` instead of spelling
+  the arithmetic out again.
+
+- `api-surface.json` is the machine-readable API surface: one
+  `{ name, kind, subpath, declaringModule }` entry per export per subpath,
+  generated by the same `tools/api-report.mjs` pass that maintains
+  `API_REPORT.md`, shipped in the package behind the `./api-manifest` subpath,
+  and pinned by `tests/api-manifest.test.ts` (shape and coverage) plus the
+  existing `--check` (agreement with the declarations). `node
+  tools/api-report.mjs --diff OLD NEW` diffs two releases' surfaces, and the
+  report parser no longer drops `export type { ... }` re-export lists.
+
+- `core.RandomSource` lets every derived helper (`chance`, `element`,
+  `weighted`, `weightedKey`, `shuffle`, `int`, `range`, `normalRange`) draw
+  from an injected stream: pass a rule-local `Generator` (or any
+  `float`/`int` pair) as the trailing `source` and the ambient stream is left
+  untouched, with identical draws and the same `null` reporting.
+
+- `node tools/api-report.mjs --diff OLD NEW` lists added, removed and
+  kind-changed exports between two `api-surface.json` manifests, so a version
+  bump yields a one-command surface diff.
+
+- `mwg/headless` is the blessed renderer-free entry: `core`, `simulation`,
+  `mwl`, `i18n`, `actors`, `world`, `battle`, `roguelike`, `board`, `audio`,
+  `rpg`, `ai`, `testing` and the two renderer-free asset halves, in one import
+  with no DOM or WebGL globals. `tests/headless-smoke.test.ts` imports it in
+  plain Node, walks the reachable graph for a renderer leak, and replays a
+  seeded scenario through it.
+
+- `tools/audit-adoptions` (also `mwg-audit-adoptions`) is the shipped consumer
+  adoption auditor: manifest plus reasons file plus config (type-only
+  directories, subpath deny-lists, per-pattern import budgets), reporting
+  unadopted exports, stale reasons, shadowing collisions and config violations
+  with `file:line` and a non-zero exit.
+
+- `two-d/pixi-interop` now states the interop-only rationale on each
+  re-exported primitive's own declaration: every histogram symbol
+  (`Rectangle`, `Texture`, `Container`, `Sprite`, `Graphics`, `FillGradient`,
+  `TilingSprite`) already has a facade family, so the note names the
+  Pixi-typed seam that keeps the raw export, and `tests/pixi-interop-coverage`
+  pins both halves.
+
+- `tools/browser-driver` is the dependency-free browser harness: a self-served
+  static directory on an OS-chosen free port, Chrome over CDP and Firefox over
+  WebDriver BiDi behind one surface (`goto`/`waitReady`/`tap` at canvas
+  fractions/`evaluate`/`script`/`screenshot`/`consoleErrors`/`close`), reusing
+  the `browser-smoke` readiness contract. Verified live on both engines.
+
+### Changed
+
+- The coverage gate now enforces `two-d/ui` instead of excluding the whole tree:
+  the widget tests the suite already ran carry it (97.3/92.6/94.3 against the
+  88/89/82 floors), so the exclusion was stale, and a wildcard also left every
+  new UI file silently ungated. `EventDialogue` stays excluded as intended, under
+  its real path (`two-d/ui`, where the old flag pointed at a nonexistent
+  `two-d/stage` copy), and `SelectionModel` gained a direct contract test that
+  covers it fully, where before only its embedding widgets exercised it.
+
+## [0.25.0] - 2026-10-05
+
+Framework support for the Pixel Dungeon port's simulation and content proposals: numeric
+handle leases for clone-safe commands, journal-free dispatch, one shared random stream for
+scene and simulation draws, MWL node-namespace references, and type-safe table rows with a
+type-emission helper for game build scripts.
+
+### Added
+
+- `core.Random.active()` returns the ambient generator the free functions draw from, so a
+  `SimulationRuntime` constructed with it shares one stream with scene code; `snapshot`/
+  `restore` of that generator replay identical continuations.
+- `SimulationRuntime.restore()` accepts `random` to adopt an externally-owned generator
+  (such as the global one), keeping scene and command draws in lockstep across restore.
+- `core.createHandles()`/`Handles` - numeric leases for values a plain-data command cannot
+  carry, with a scoped `with(value, body)` lease that drops even when the body throws.
+- `SimulationRuntime` accepts `journal: null` for a journal-free dispatch facade: no append
+  cost, an empty journal in `snapshot()`, and plainly documented replay/undo semantics.
+- `mwl.MwlTableReference` accepts a node-id namespace target (`references: { node: 'monster' }`),
+  checking table cells against authored node ids with the same table/row/value report.
+- `mwl.typedRows()`/`MwlTypedRow`/`MwlColumnValueType` read table rows through their declared
+  columns (every field optional, an absent cell omits the key), and `mwl.emitTableTypes()`
+  emits one named row interface plus one typed accessor per table for a game's build script,
+  so a changed column type or a removed column fails type-checking at every use.
+
 ## [0.24.1] - 2026-10-02
 
 Dependency refresh: Babylon.js 9.29, `@capacitor/cli` held at 8.5.2 so it matches the other Capacitor

package/README.md

@@ -336,6 +336,21 @@ edited in a proper editor, without any of those options requiring changes to the
 It also keeps the content out of the bundle: `tools/compile-resources` treats a map file
 exactly like a sprite sheet, so adding a hundred maps does not touch the build at all.
 
+### Objects for behavior, data for content
+
+Content is data (above), but a game's *behavior* belongs in classes. A monster kept as
+loose scene fields works for one tutorial room and collapses for a dungeon: give it a
+class holding its state and the methods that change it, built on the framework's own
+bricks (`core.Scene` scenes, `actors.StatBlock` stats, `battle.Creature` opponents,
+`roguelike.Level` maps, `rpg.GridMover` movement, `core.EntityRegistry` identity).
+Subclass the brick that already owns the concern instead of reimplementing it beside an
+interface; no new base class is needed for ordinary actors.
+
+The boundary is where serialization starts. `simulation` commands survive
+`structuredClone`, `core.SaveSystem` stores JSON-serialisable state, and MWL rows are
+records by design, so classes stop where those begin: flatten at the boundary the way
+`rpg.GameState` does, and rebuild objects on load rather than storing them.
+
 ### On writing direction
 
 Supporting more than one language is mostly bookkeeping. Supporting more than one writing