@datamoc/mw_games 0.37.0 → 0.38.0

package/CHANGELOG.md

@@ -7,6 +7,30 @@ the public API may still change between minor versions.
 
 ## [Unreleased]
 
+## [0.38.0] - 2026-10-14
+
+Optional MWL scene and UI composition with its bridge-editor example, the
+all-scenarios browser verifier, instance palette setters, and a powered-by badge
+games can carry on their login screen. Roadmap 393 and 394 move to parked: no
+fixture files for the proprietary groove formats, and the neural humanizer costs
+more than the game use case justifies.
+
+### Added
+
+- Optional MWL presentation compiler (`mwl/presentation`) and Pixi runtime
+  (`two-d/presentation`): scene layers, camera, reusable UI, responsive layouts, keyed
+  collections, typed bindings and biome-selected palette/scenery overrides. The local-file
+  bridge-editor example checks keyboard/pointer focus, modal input, cleanup and update cost.
+- `Button.setColors`, `Window.setColors` and `Bar.setBackground` update instance palettes
+  without rebuilding widgets.
+
+- `mwg-scenarios`: verifies every scenario in one local-file browser page through game-owned
+  `SceneControls` steps for entry, bot turns, assertions and cleanup, with bounded execution
+  and per-scenario failures.
+- `webpage/assets/powered-by-mwg.svg`: a badge games can copy onto their login screen,
+  linked to the framework site, with the snippet in the README's new "Powered by mwg"
+  section and the badge itself in the website footer.
+
 ## [0.37.0] - 2026-10-14
 
 Fixes and additions from the first outside game built on mwg (Pontifex, on 0.36.0): sounds compose with synthesized tones, two physics modules (matter-js rigid bodies and a deterministic XPBD structure solver), pointer and dropdown widgets, a project scaffold, and the `@datamoc/mwg` short-name package.

package/README.md

@@ -496,6 +496,13 @@ real numbers and booleans for scalar values and `_("...")` marking translatable
 strings. It describes game data and commands while `mwg` remains responsible for
 execution, rendering, input, audio, and saves. MWL is a new language, not a WML
 compatibility layer.
+Optional scene and UI composition is available through `@datamoc/mw_games/mwl/presentation`
+(build-time compiler) and `@datamoc/mw_games/two-d/presentation` (Pixi runtime). Compile
+reusable widgets, responsive layouts, keyed lists, semantic palettes and context overrides
+against a TypeScript binding manifest. The game supplies actions, physics and procedural
+adapters. See [the presentation contract](REFERENCE.md#mwl-presentation) and
+`examples/mwl-presentation`; `npm run visual:smoke:presentation` verifies the compiled
+`file://` page, keyboard/pointer input, modal windows, cleanup and update cost.
 The Wesnoth port can nevertheless use its native `.cfg` files as build inputs:
 the port-owned WML front end parses them, the adapter converts the supported
 nodes to MWL, and the normal MWL compiler emits the runtime module.
@@ -592,6 +599,25 @@ The generated data is plain TypeScript and works with the same local-file build
 pipeline as the rest of the framework. Wesnoth-specific MWL source belongs in
 the Wesnoth port, not in this framework package.
 
+## Powered by mwg
+
+Games built with mwg are welcome to carry the badge on their login screen:
+
+[![powered by mwg](webpage/assets/powered-by-mwg.svg)](https://datamoc.github.io/mwg/)
+
+Copy `webpage/assets/powered-by-mwg.svg` into your own project (a shipped game
+cannot fetch it from here; local-file pages only load their own assets) and link
+it to the framework site. In plain HTML that is:
+
+```html
+<a href="https://datamoc.github.io/mwg/">
+  <img src="./powered-by-mwg.svg" alt="powered by mwg" width="196" height="38">
+</a>
+```
+
+A canvas-drawn login screen loads the same file through the asset pipeline and
+opens the URL on click with `window.open('https://datamoc.github.io/mwg/', '_blank')`.
+
 ## Licence and provenance
 
 `mwg` is MPL-2.0. Its dependencies are permissive and compatible: PixiJS and Babylon.js are

package/api-surface.json

@@ -311,6 +311,12 @@
 		"subpath": ".",
 		"declaringModule": "two-d/ui/Button.d.ts"
 	},
+	{
+		"name": "ButtonColors",
+		"kind": "interface",
+		"subpath": ".",
+		"declaringModule": "two-d/ui/Button.d.ts"
+	},
 	{
 		"name": "ButtonOptions",
 		"kind": "interface",
@@ -3485,6 +3491,12 @@
 		"subpath": ".",
 		"declaringModule": "two-d/ui/Window.d.ts"
 	},
+	{
+		"name": "WindowColors",
+		"kind": "interface",
+		"subpath": ".",
+		"declaringModule": "two-d/ui/Window.d.ts"
+	},
 	{
 		"name": "WindowOptions",
 		"kind": "interface",
@@ -9041,6 +9053,84 @@
 		"subpath": "./mwl",
 		"declaringModule": "mwl/schema.d.ts"
 	},
+	{
+		"name": "CompiledPresentation",
+		"kind": "interface",
+		"subpath": "./mwl/presentation",
+		"declaringModule": "mwl/presentation.d.ts"
+	},
+	{
+		"name": "compilePresentation",
+		"kind": "function",
+		"subpath": "./mwl/presentation",
+		"declaringModule": "mwl/presentation.d.ts"
+	},
+	{
+		"name": "emitPresentationModule",
+		"kind": "function",
+		"subpath": "./mwl/presentation",
+		"declaringModule": "mwl/presentation.d.ts"
+	},
+	{
+		"name": "PresentationCollection",
+		"kind": "interface",
+		"subpath": "./mwl/presentation",
+		"declaringModule": "mwl/presentation.d.ts"
+	},
+	{
+		"name": "PresentationContext",
+		"kind": "interface",
+		"subpath": "./mwl/presentation",
+		"declaringModule": "mwl/presentation.d.ts"
+	},
+	{
+		"name": "PresentationItem",
+		"kind": "type",
+		"subpath": "./mwl/presentation",
+		"declaringModule": "mwl/presentation.d.ts"
+	},
+	{
+		"name": "PresentationManifest",
+		"kind": "interface",
+		"subpath": "./mwl/presentation",
+		"declaringModule": "mwl/presentation.d.ts"
+	},
+	{
+		"name": "PresentationNode",
+		"kind": "interface",
+		"subpath": "./mwl/presentation",
+		"declaringModule": "mwl/presentation.d.ts"
+	},
+	{
+		"name": "PresentationProperties",
+		"kind": "type",
+		"subpath": "./mwl/presentation",
+		"declaringModule": "mwl/presentation.d.ts"
+	},
+	{
+		"name": "PresentationScalarType",
+		"kind": "type",
+		"subpath": "./mwl/presentation",
+		"declaringModule": "mwl/presentation.d.ts"
+	},
+	{
+		"name": "PresentationScene",
+		"kind": "interface",
+		"subpath": "./mwl/presentation",
+		"declaringModule": "mwl/presentation.d.ts"
+	},
+	{
+		"name": "PresentationTheme",
+		"kind": "interface",
+		"subpath": "./mwl/presentation",
+		"declaringModule": "mwl/presentation.d.ts"
+	},
+	{
+		"name": "PresentationValue",
+		"kind": "type",
+		"subpath": "./mwl/presentation",
+		"declaringModule": "mwl/presentation.d.ts"
+	},
 	{
 		"name": "createPyroeisRuntime",
 		"kind": "function",
@@ -10829,6 +10919,12 @@
 		"subpath": "./tools/single-file",
 		"declaringModule": "tools/single-file.mjs"
 	},
+	{
+		"name": "./tools/verify-scenarios",
+		"kind": "tool",
+		"subpath": "./tools/verify-scenarios",
+		"declaringModule": "tools/verify-scenarios.mjs"
+	},
 	{
 		"name": "./tools/vite",
 		"kind": "tool",
@@ -11087,6 +11183,12 @@
 		"subpath": "./two-d",
 		"declaringModule": "two-d/ui/Button.d.ts"
 	},
+	{
+		"name": "ButtonColors",
+		"kind": "interface",
+		"subpath": "./two-d",
+		"declaringModule": "two-d/ui/Button.d.ts"
+	},
 	{
 		"name": "ButtonOptions",
 		"kind": "interface",
@@ -13145,6 +13247,12 @@
 		"subpath": "./two-d",
 		"declaringModule": "two-d/ui/Window.d.ts"
 	},
+	{
+		"name": "WindowColors",
+		"kind": "interface",
+		"subpath": "./two-d",
+		"declaringModule": "two-d/ui/Window.d.ts"
+	},
 	{
 		"name": "WindowOptions",
 		"kind": "interface",
@@ -13271,6 +13379,36 @@
 		"subpath": "./two-d/pixi-interop",
 		"declaringModule": "two-d/pixi-interop.d.ts"
 	},
+	{
+		"name": "MwlPresentation",
+		"kind": "class",
+		"subpath": "./two-d/presentation",
+		"declaringModule": "two-d/presentation/MwlPresentation.d.ts"
+	},
+	{
+		"name": "PresentationAdapter",
+		"kind": "interface",
+		"subpath": "./two-d/presentation",
+		"declaringModule": "two-d/presentation/MwlPresentation.d.ts"
+	},
+	{
+		"name": "PresentationAdapterContext",
+		"kind": "interface",
+		"subpath": "./two-d/presentation",
+		"declaringModule": "two-d/presentation/MwlPresentation.d.ts"
+	},
+	{
+		"name": "PresentationRuntimeOptions",
+		"kind": "interface",
+		"subpath": "./two-d/presentation",
+		"declaringModule": "two-d/presentation/MwlPresentation.d.ts"
+	},
+	{
+		"name": "PresentationState",
+		"kind": "type",
+		"subpath": "./two-d/presentation",
+		"declaringModule": "two-d/presentation/MwlPresentation.d.ts"
+	},
 	{
 		"name": "ActorAnimationState",
 		"kind": "type",
@@ -14639,6 +14777,12 @@
 		"subpath": "./two-d/ui",
 		"declaringModule": "two-d/ui/Button.d.ts"
 	},
+	{
+		"name": "ButtonColors",
+		"kind": "interface",
+		"subpath": "./two-d/ui",
+		"declaringModule": "two-d/ui/Button.d.ts"
+	},
 	{
 		"name": "ButtonOptions",
 		"kind": "interface",
@@ -15575,6 +15719,12 @@
 		"subpath": "./two-d/ui",
 		"declaringModule": "two-d/ui/Window.d.ts"
 	},
+	{
+		"name": "WindowColors",
+		"kind": "interface",
+		"subpath": "./two-d/ui",
+		"declaringModule": "two-d/ui/Window.d.ts"
+	},
 	{
 		"name": "WindowOptions",
 		"kind": "interface",