@datamoc/mw_games 0.8.2 → 0.9.0-alpha

package/CHANGELOG.md

@@ -7,6 +7,21 @@ the public API may still change between minor versions.
 
 ## [Unreleased]
 
+## [0.9.0-alpha] - 2026-09-13
+
+### Changed
+
+- MWL authoring syntax is now JSON5 instead of the WML-inspired tag/`key=value`
+  form: every `.mwl` file is a top-level array of `{ tag, ...attributes, children }`
+  nodes, values are real JSON5 numbers, booleans and strings (stringified back to
+  the `Record<string, string>` the schema, compiler and runtime already see), and
+  translatable strings are marked `_("...")` via a preprocessor rewrite. The
+  `#define`/`#include`/`#ifdef` textual pass is unchanged. The `"""..."""` block
+  form (item 317) is superseded by JSON5 `\n` escapes and backslash line
+  continuations. Clean cutover: all fixtures, examples, tests and doc examples
+  are migrated, the old tag parser is deleted, and `json5` (pure JS, no native
+  build) is a runtime dependency.
+
 ## [0.8.2] - 2026-09-13
 
 ### Added

package/README.md

@@ -402,9 +402,12 @@ The optional 3D group is now implemented without changing the existing 2D entry
 
 ## MWL
 
-MWL is the framework's declarative, WML-inspired authoring layer. 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.
+MWL is the framework's declarative, WML-inspired authoring layer. Content files
+are JSON5: a top-level array of `{ tag, ...attributes, children }` nodes, with
+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.
 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.
@@ -461,7 +464,7 @@ reported as warnings. The output directory is safe to regenerate: its extracted
 CSS `url(data:...)` values and HTML `srcset` candidates are handled too, including
 their density descriptors.
 
-Translation messages are the values marked `_ "..."` in the source; the
+Translation messages are the values marked `_("...")` in the source; the
 extracted catalog matches `@datamoc/mw_games/i18n`. Hooks are referenced as
 `type:name`, declared in a manifest, and bundled with esbuild, which a game
 project installs itself (`npm install --save-dev esbuild`). The framework does