@datamoc/mw_games 0.11.0 → 0.12.0

package/CHANGELOG.md

@@ -7,6 +7,58 @@ the public API may still change between minor versions.
 
 ## [Unreleased]
 
+## [0.12.0] - 2026-09-14
+
+### Added
+
+- `rpg.EventRunner`'s `DialogueRequest` (and `EventCommand`'s `say`/`ask`) gained an optional
+  `portrait` field, threaded through to `two-d/ui.messageBoxPresenter` and `MessageBox`'s own
+  pre-existing `portrait` support - a portrait-bearing line no longer has to bypass `present`
+  and build its own `MessageBox` directly (item 352).
+- `rpg.GridMover.jumpBy` - an instant reposition with no tween and no walk animation, for a
+  "jump" move-route step over terrain `moveBy`'s glide has no way to skip.
+- `rpg.MoveRouteRunner`/`MoveRoute`/`MoveRouteStep`/`MoveRouteOptions` - drives any `GridMover`
+  through a scripted route (fixed/random/toward/away steps, turn, jump, wait) with `repeat` and
+  `skippable` policies, built entirely on `GridMover`'s existing primitives (item 353).
+- `audio.Sound.play(gain, pitch)` - an optional pitch parameter as `HTMLAudioElement.
+  playbackRate`. No matching `pan`: a plain `<audio>` element has none to set, the same reason
+  `Positional.audioPan` only ever reported a number rather than owning a panner node (item 354).
+
+### Fixed
+
+- `mobile:build` (and everything built on it: `cap:sync`, `cap:add:android`, `desktop:build`,
+  `desktop:run`) now passes `--no-compress` to `emit-page.mjs`. Item 349/350's `.gz`/`.br`
+  sidecar files, written by default into every build since those items shipped, broke the
+  Android/Capacitor asset merge (`Duplicate resources` from AAPT, which treats `game.js` and
+  `game.js.gz` as colliding) the first time the full pipeline was actually built and run
+  end to end (item 351) - those sidecars were always dead weight for a packaged native app
+  with no server to negotiate `Content-Encoding` for, so this drops them at the source rather
+  than special-casing the generated `android/` project.
+
+### Changed
+
+- `android/` is no longer `.gitignore`d (item 110's original choice, kept since). The
+  Capacitor-scaffolded project's own generated `.gitignore` already excludes build output,
+  `local.properties`, and the copied web assets/config that `cap sync` regenerates every
+  build - the 53 files it leaves are ordinary scaffold source (manifest, Java, gradle files,
+  launcher/splash resources), the same kind of thing worth tracking as any other native
+  wrapper customization: this session's own `ignoreAssetsPattern` fix (above) would otherwise
+  have been silently lost the next time someone ran `cap add android` fresh.
+- `webpage/assets/0c_framework_architecture.svg` regenerated - it had gone stale since the
+  `ai` and `mwl` modules were added to `src/`, so the "generated, never hand-drawn" diagram
+  was quietly wrong about the current module list until `npm run webpage:diagrams` was
+  actually re-run (item 351's Android/Windows verification pass turned this up while
+  double-checking related documentation).
+- `webpage/design/architecture-explorer.html`, the interactive module-graph explorer, was
+  regenerated via the archify skill for the same reason: authored once at release 0.4.3, it
+  had never been updated and was missing `ai`/`mwl` entirely despite linking to itself as
+  "generated straight from src/'s own import graph". Rebuilt with real, verified import-graph
+  data for all 15 current modules and a fourth guided view ("mwl as data-authoring backbone").
+- `desktop/README.md` documented only the older, unwired `desktop/webview2` host and never
+  mentioned `desktop/MwgDesktopHost` - the one `desktop:build`/`desktop:run` actually build -
+  or its `SetVirtualHostNameToFolderMapping` capability. Rewritten to cover both hosts and
+  which job each is for.
+
 ## [0.11.0] - 2026-09-14
 
 ### Added

package/dist/audio/Playable.d.ts

@@ -10,6 +10,8 @@ export interface Playable {
     currentTime: number;
     volume: number;
     loop: boolean;
+    /** speed and pitch together, matching `HTMLAudioElement.playbackRate`; 1 is unchanged */
+    playbackRate?: number;
     /** Optional completion hook, matching HTMLAudioElement.onended. Backends without an
      * end event can omit it; single-track Music remains fully usable there. */
     onended?: ((event: Event) => unknown) | null;

package/dist/audio/Playable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Playable.d.ts","sourceRoot":"","sources":["../../src/audio/Playable.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACxB,IAAI,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd;+EAC2E;IAC3E,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;CAC7C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAElD"}
+{"version":3,"file":"Playable.d.ts","sourceRoot":"","sources":["../../src/audio/Playable.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACxB,IAAI,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;+EAC2E;IAC3E,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;CAC7C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAElD"}

package/dist/audio/Playable.js.map

@@ -1 +1 @@
-{"version":3,"file":"Playable.js","sourceRoot":"","sources":["../../src/audio/Playable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAmBhD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,OAAO,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"Playable.js","sourceRoot":"","sources":["../../src/audio/Playable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAqBhD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,OAAO,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/dist/audio/Sound.d.ts

@@ -33,8 +33,14 @@ export declare class Sound {
      *
      * @param gain multiplied into the sound's own volume, for a distance-attenuated one-shot
      * (`Positional.SoundSource.playFor`); 1 leaves it at `volume`.
+     * @param pitch played back at this rate, matching `HTMLAudioElement.playbackRate` (1 is
+     * unchanged, above 1 higher and faster, below 1 lower and slower) - a footstep or a hit
+     * that always sounds identical reads as a loop faster than one with a little variance.
+     * There is no matching `pan` parameter: a plain `<audio>` element has no pan of its own to
+     * set, and `Positional.audioPan` already made the deliberate call to report a number rather
+     * than own a panner node a game does not necessarily want - the same reasoning applies here.
      */
-    play(gain?: number): void;
+    play(gain?: number, pitch?: number): void;
     stopAll(): void;
 }
 //# sourceMappingURL=Sound.d.ts.map

package/dist/audio/Sound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sound.d.ts","sourceRoot":"","sources":["../../src/audio/Sound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG3D,MAAM,WAAW,YAAY;IAC5B,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC;IAEpC,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,KAAK;IACjB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,MAAM,EAAE,MAAM,CAAC;IAEf,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,EAMnD;IAED;;;;;OAKG;IACH,IAAI,CAAC,IAAI,SAAI,GAAG,IAAI,CAYnB;IAED,OAAO,IAAI,IAAI,CAKd;CACD"}
+{"version":3,"file":"Sound.d.ts","sourceRoot":"","sources":["../../src/audio/Sound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG3D,MAAM,WAAW,YAAY;IAC5B,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC;IAEpC,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,KAAK;IACjB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,MAAM,EAAE,MAAM,CAAC;IAEf,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,EAMnD;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,IAAI,SAAI,EAAE,KAAK,SAAI,GAAG,IAAI,CAa9B;IAED,OAAO,IAAI,IAAI,CAKd;CACD"}

package/dist/audio/Sound.js

@@ -28,11 +28,18 @@ export class Sound {
      *
      * @param gain multiplied into the sound's own volume, for a distance-attenuated one-shot
      * (`Positional.SoundSource.playFor`); 1 leaves it at `volume`.
+     * @param pitch played back at this rate, matching `HTMLAudioElement.playbackRate` (1 is
+     * unchanged, above 1 higher and faster, below 1 lower and slower) - a footstep or a hit
+     * that always sounds identical reads as a loop faster than one with a little variance.
+     * There is no matching `pan` parameter: a plain `<audio>` element has no pan of its own to
+     * set, and `Positional.audioPan` already made the deliberate call to report a number rather
+     * than own a panner node a game does not necessarily want - the same reasoning applies here.
      */
-    play(gain = 1) {
+    play(gain = 1, pitch = 1) {
         const audio = this.pool[this.next];
         this.next = (this.next + 1) % this.pool.length;
         audio.volume = this.volume * gain;
+        audio.playbackRate = pitch;
         audio.currentTime = 0;
         // play() can return a Promise that rejects if this reuse interrupts its own prior,
         // still-loading play() (a real browser, not the fakes tests supply) - swallow it the

package/dist/audio/Sound.js.map

@@ -1 +1 @@
-{"version":3,"file":"Sound.js","sourceRoot":"","sources":["../../src/audio/Sound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiB,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAc1C;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,KAAK;IAMjB,YAAY,IAAY,EAAE,OAAO,GAAiB,EAAE;QAJ5C,SAAI,GAAG,CAAC,CAAC;QAKhB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,IAAI,GAAG,CAAC;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAE/C,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QAClC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;QACtB,mFAAmF;QACnF,qFAAqF;QACrF,wFAAwF;QACxF,KAAK,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEnD,IAAI,IAAI,CAAC,OAAO;YAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO;QACN,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC/B,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;QACvB,CAAC;IACF,CAAC;CACD"}
+{"version":3,"file":"Sound.js","sourceRoot":"","sources":["../../src/audio/Sound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiB,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAc1C;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,KAAK;IAMjB,YAAY,IAAY,EAAE,OAAO,GAAiB,EAAE;QAJ5C,SAAI,GAAG,CAAC,CAAC;QAKhB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAE/C,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QAClC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC;QAC3B,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;QACtB,mFAAmF;QACnF,qFAAqF;QACrF,wFAAwF;QACxF,KAAK,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEnD,IAAI,IAAI,CAAC,OAAO;YAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO;QACN,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC/B,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;QACvB,CAAC;IACF,CAAC;CACD"}