@bitmagic/cli 0.1.83-dev.1 → 0.1.83-dev.3

package/dist/verify/classify.js

@@ -94,14 +94,26 @@ const BLACK_FRAME_MAX_LIT_FRACTION = 0.005;
  * measures in the thousands.
  */
 const MIN_DISTINCT_COLORS = 3;
+const RESPAWN_LINE_PATTERN = /Fell below -?\d/;
 /**
- * The engine's line when the player has fallen out of the world and is being put back.
+ * The engine's line when the player has fallen out of the world and is being put back
+ * ("Fell below -100, respawning..."), whatever the kill plane's height: a game may move it
+ * (`fallRescue.killPlaneY`) and the engine prints its own. "Vehicle fell below" (a vehicle put
+ * back, the player still in it) is a different line.
  *
  * A game the player cannot stand up in is not verified, however cleanly it renders. This was not
  * theoretical: a forged level whose terrain never loaded rendered a perfect frame, threw nothing,
  * and reported PASSED, while the player fell and respawned 14 times in a 45s settle.
  */
-export const RESPAWN_LINE = 'Fell below -100';
+export function isRespawnLine(line) {
+    return RESPAWN_LINE_PATTERN.test(line);
+}
+/**
+ * The event the engine's fall rescue logs for each respawn — the same signal as the line, but
+ * readable without matching console text. Engines that predate it only print the line, so the
+ * count is the larger of the two and a respawn seen both ways is still one.
+ */
+export const PLAYER_RESPAWN_EVENT = 'player-respawn';
 /**
  * One or two falls can be the spawn beating the chunk colliders — the controller says as much
  * ("waiting for colliders…") and recovers, so those warn. Three is no longer a settle; it is a
@@ -118,7 +130,7 @@ const CORS_BLOCK = 'has been blocked by CORS policy';
 /**
  * A player below this and still falling when the run ends is out of the world, not exploring a
  * deep cave: the engine's own kill plane respawns at -100, so a sustained fall past -50 means
- * the respawn keeps landing on nothing. Complements the `RESPAWN_LINE` count — this one fires
+ * the respawn keeps landing on nothing. Complements the respawn count — this one fires
  * even when a game's custom controller never prints that line.
  */
 const FREEFALL_FAILURE_Y = -50;
@@ -163,6 +175,13 @@ export function classifyVerifyRun(observations, context = {}) {
                     + `${start.selectionsPicked === 1 ? '' : 's'} but the Play button never appeared and no `
                     + 'game start was detected — the picked level or option most likely never finished loading.');
             }
+            else if (start.customStartScreen) {
+                // The commonest way a custom start screen fails verify: it renders its own Play control
+                // that verify has no way to recognise, so a healthy game reads as one that never started.
+                failures.push('The game installs its own start screen (setUIComponent(\'start\', …)) but never '
+                    + 'started — no element marked data-bitmagic-play appeared to press, and no game start '
+                    + 'was detected. Add the data-bitmagic-play attribute to the custom Play button.');
+            }
             else {
                 failures.push('The game never started — no Play button appeared and no game start was detected.');
             }
@@ -297,7 +316,7 @@ export function classifyVerifyRun(observations, context = {}) {
     if (blocked.length > 0) {
         failures.push(`A game asset could not be fetched — the browser blocked it as cross-origin: ${blocked[0]}`);
     }
-    const respawns = observations.consoleLines.filter((line) => line.includes(RESPAWN_LINE)).length;
+    const respawns = Math.max(observations.consoleLines.filter(isRespawnLine).length, observations.events?.totalByType[PLAYER_RESPAWN_EVENT] ?? 0);
     if (respawns > MAX_TOLERATED_RESPAWNS) {
         failures.push(`The player fell out of the world ${respawns} times and was still falling when the run ended `
             + '— the level renders but cannot be stood on. Its terrain most likely never loaded.');

package/dist/verify/classify.js.map

@@ -1 +1 @@
-{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/verify/classify.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/verify/classify.ts"],"names":[],"mappings":"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"}

package/dist/verify/hud-theme.d.ts

@@ -9,25 +9,30 @@
  * it survives for as long as nobody diffs the intended look against the shipped one.
  *
  * The hosted agent is protected from this by `write-hud-theme`, which validates before it writes
- * and answers with a closest-match suggestion. `bitmagic theme set|patch` now gives the CLI lane the
- * same write-time guard over a gate-enforced mirror of that validator — but only for edits made
- * THROUGH it. A hand edit to world.json, a vendored engine older than the CLI's copy, or a theme
- * that validates yet still fails in the browser all land here, which is why this check stays: it is
- * the only one that reads what the engine itself said.
+ * and answers with a closest-match suggestion. `bitmagic theme set|patch` gives the CLI lane the
+ * same write-time guard with the same validator (the bundled `@bitmagic/hud-theme` kernel) — but
+ * only for edits made THROUGH it. A hand edit to world.json, a vendored engine older than the CLI's
+ * kernel, or a theme that validates yet still fails in the browser all land here, which is why this
+ * check stays: it is the only one that reads what the engine itself said.
  *
- * WHY PARSE THE CONSOLE rather than validate statically here. The obvious alternative is to read
- * world.json and check it against the engine's own validator, and it is not available: the vendored
- * engine emits with its path-mapped specifiers intact (`from 'engine/hud/ThemeTokens.js'`), which
- * resolve only through the browser import map, so `validateAndResolveTheme` cannot be imported from
- * Node. The remaining static option is a hand-mirrored preset list in the CLI, i.e. a third copy of
- * the same list to keep in sync. Parsing what the engine already said costs no mirror, cannot drift,
- * and inherits the engine's own error text — including the field paths from an invalid inline theme
- * and the live list of known presets, neither of which a mirror would have.
+ * WHY PARSE THE CONSOLE rather than validate statically here. The CLI's bundled kernel is the
+ * validator of the engine the CLI was BUILT with, while the project runs the engine it VENDORED —
+ * the project's own `engine/` cannot be imported from Node (its specifiers are path-mapped
+ * `engine/...` aliases that resolve only through the browser import map). Parsing what the
+ * project's engine actually said needs no assumption about which version that is, and inherits the
+ * engine's own error text — including the field paths from an invalid inline theme and the live
+ * list of known presets.
  *
  * The cost is honest and worth naming: this only sees a theme on a game that actually booted. A
  * project whose game fails to load has bigger findings in the same run.
  */
-/** The engine's marker on every theme-resolution warning. Also what a reader greps for. */
+/**
+ * The engine's marker on every theme-resolution warning. Also what a reader greps for.
+ *
+ * The marker and the two phrases below are the engine's own constants (`resolveWorldTheme`),
+ * taken from the bundled theme kernel, so the parser and the emitter cannot drift. They are frozen
+ * engine-side because this parser reads warnings from engines of every vendored version.
+ */
 export declare const HUD_THEME_MARKER = "[HUD]";
 export interface HudThemeProblem {
     /**

package/dist/verify/hud-theme.js

@@ -9,30 +9,36 @@
  * it survives for as long as nobody diffs the intended look against the shipped one.
  *
  * The hosted agent is protected from this by `write-hud-theme`, which validates before it writes
- * and answers with a closest-match suggestion. `bitmagic theme set|patch` now gives the CLI lane the
- * same write-time guard over a gate-enforced mirror of that validator — but only for edits made
- * THROUGH it. A hand edit to world.json, a vendored engine older than the CLI's copy, or a theme
- * that validates yet still fails in the browser all land here, which is why this check stays: it is
- * the only one that reads what the engine itself said.
+ * and answers with a closest-match suggestion. `bitmagic theme set|patch` gives the CLI lane the
+ * same write-time guard with the same validator (the bundled `@bitmagic/hud-theme` kernel) — but
+ * only for edits made THROUGH it. A hand edit to world.json, a vendored engine older than the CLI's
+ * kernel, or a theme that validates yet still fails in the browser all land here, which is why this
+ * check stays: it is the only one that reads what the engine itself said.
  *
- * WHY PARSE THE CONSOLE rather than validate statically here. The obvious alternative is to read
- * world.json and check it against the engine's own validator, and it is not available: the vendored
- * engine emits with its path-mapped specifiers intact (`from 'engine/hud/ThemeTokens.js'`), which
- * resolve only through the browser import map, so `validateAndResolveTheme` cannot be imported from
- * Node. The remaining static option is a hand-mirrored preset list in the CLI, i.e. a third copy of
- * the same list to keep in sync. Parsing what the engine already said costs no mirror, cannot drift,
- * and inherits the engine's own error text — including the field paths from an invalid inline theme
- * and the live list of known presets, neither of which a mirror would have.
+ * WHY PARSE THE CONSOLE rather than validate statically here. The CLI's bundled kernel is the
+ * validator of the engine the CLI was BUILT with, while the project runs the engine it VENDORED —
+ * the project's own `engine/` cannot be imported from Node (its specifiers are path-mapped
+ * `engine/...` aliases that resolve only through the browser import map). Parsing what the
+ * project's engine actually said needs no assumption about which version that is, and inherits the
+ * engine's own error text — including the field paths from an invalid inline theme and the live
+ * list of known presets.
  *
  * The cost is honest and worth naming: this only sees a theme on a game that actually booted. A
  * project whose game fails to load has bigger findings in the same run.
  */
-/** The engine's marker on every theme-resolution warning. Also what a reader greps for. */
-export const HUD_THEME_MARKER = '[HUD]';
+import { HUD_INVALID_THEME_PHRASE, HUD_THEME_LOG_MARKER, HUD_UNKNOWN_PRESET_PHRASE, } from '../theme/kernel.js';
+/**
+ * The engine's marker on every theme-resolution warning. Also what a reader greps for.
+ *
+ * The marker and the two phrases below are the engine's own constants (`resolveWorldTheme`),
+ * taken from the bundled theme kernel, so the parser and the emitter cannot drift. They are frozen
+ * engine-side because this parser reads warnings from engines of every vendored version.
+ */
+export const HUD_THEME_MARKER = HUD_THEME_LOG_MARKER;
 /** `resolveWorldTheme`'s wording when `hud.theme` is a string that names no preset. */
-const UNKNOWN_PRESET = 'Unknown theme preset';
+const UNKNOWN_PRESET = HUD_UNKNOWN_PRESET_PHRASE;
 /** …and when it is an object the validator rejected. */
-const INVALID_THEME = 'Custom theme failed validation';
+const INVALID_THEME = HUD_INVALID_THEME_PHRASE;
 /**
  * The theme problem the engine reported during this run, or null when it reported none.
  *

package/dist/verify/hud-theme.js.map

@@ -1 +1 @@
-{"version":3,"file":"hud-theme.js","sourceRoot":"","sources":["../../src/verify/hud-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,2FAA2F;AAC3F,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAExC,uFAAuF;AACvF,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAE9C,wDAAwD;AACxD,MAAM,aAAa,GAAG,gCAAgC,CAAC;AAgBvD;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAsB;IACzD,KAAK,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9C,IAAI,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/B,mFAAmF;IACnF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAErC,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACvE,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEtE,6FAA6F;IAC7F,0FAA0F;IAC1F,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"hud-theme.js","sourceRoot":"","sources":["../../src/verify/hud-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAErD,uFAAuF;AACvF,MAAM,cAAc,GAAG,yBAAyB,CAAC;AAEjD,wDAAwD;AACxD,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAgB/C;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAsB;IACzD,KAAK,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9C,IAAI,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/B,mFAAmF;IACnF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAErC,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACvE,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEtE,6FAA6F;IAC7F,0FAA0F;IAC1F,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/verify/mobile-parity.d.ts

@@ -7,7 +7,7 @@
  * `game/agent-docs/control-system.md`). Nothing consumed it, so a game with actions no phone can
  * reach passed verify silently.
  *
- * Parsing that line rather than listening for the `aitopia:mobile-parity-gap` postMessage the
+ * Parsing that line rather than listening for the `MOBILE_PARITY_GAP` postMessage the
  * same check also fires is deliberate on two counts: the console is already captured, so this
  * needs no new browser plumbing; and only the console line carries the `(source)` annotation
  * naming which system registered an orphan key, which is the difference between "KeyF is

package/dist/verify/mobile-parity.js

@@ -7,7 +7,7 @@
  * `game/agent-docs/control-system.md`). Nothing consumed it, so a game with actions no phone can
  * reach passed verify silently.
  *
- * Parsing that line rather than listening for the `aitopia:mobile-parity-gap` postMessage the
+ * Parsing that line rather than listening for the `MOBILE_PARITY_GAP` postMessage the
  * same check also fires is deliberate on two counts: the console is already captured, so this
  * needs no new browser plumbing; and only the console line carries the `(source)` annotation
  * naming which system registered an orphan key, which is the difference between "KeyF is

package/dist/verify/start.d.ts

@@ -16,8 +16,9 @@
  * not meaningfully begun; `loadingGraceMs` bounds how long that credit can last.
  */
 export interface StartInteractionOptions {
-    /** Selector for the engine Play button. Its label is localizable and per-game overridable, so
-     *  never match by text. */
+    /** Selector for the Play button: the engine's own, or the control a custom start screen
+     *  (`engine.setUIComponent('start', …)`) marks with `data-bitmagic-play`. Its label is
+     *  localizable and per-game overridable, so never match by text. */
     playButtonSelector: string;
     /**
      * Selector for one option of a pre-play selection step (level chooser, difficulty, …), as

package/dist/verify/start.js

@@ -16,7 +16,7 @@
  * not meaningfully begun; `loadingGraceMs` bounds how long that credit can last.
  */
 export const DEFAULT_START_INTERACTION = {
-    playButtonSelector: '#play-button, .hud-play-button',
+    playButtonSelector: '#play-button, .hud-play-button, [data-bitmagic-play]',
     selectionOptionSelector: '.start-screen-selection__option',
     startedConsoleMarker: '🎮 Starting game...',
     buttonTimeoutMs: 30_000,

package/dist/verify/start.js.map

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/verify/start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAoCH,MAAM,CAAC,MAAM,yBAAyB,GAA4B;IAChE,kBAAkB,EAAE,gCAAgC;IACpD,uBAAuB,EAAE,iCAAiC;IAC1D,oBAAoB,EAAE,qBAAqB;IAC3C,eAAe,EAAE,MAAM;IACvB,cAAc,EAAE,OAAO;IACvB,uBAAuB,EAAE,MAAM;IAC/B,iBAAiB,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC,MAAM,UAAU,cAAc,CAAC,YAAsB,EAAE,MAAc;IACnE,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5D,CAAC;AAwBD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAuB,EACvB,OAAgC;IAEhC,IAAI,MAAM,CAAC,eAAe;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,MAAM,CAAC,sBAAsB,IAAI,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAClF,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,gBAAgB,IAAI,kBAAkB,EAAE,CAAC;QAC9E,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QACpE,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC"}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/verify/start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAqCH,MAAM,CAAC,MAAM,yBAAyB,GAA4B;IAChE,kBAAkB,EAAE,sDAAsD;IAC1E,uBAAuB,EAAE,iCAAiC;IAC1D,oBAAoB,EAAE,qBAAqB;IAC3C,eAAe,EAAE,MAAM;IACvB,cAAc,EAAE,OAAO;IACvB,uBAAuB,EAAE,MAAM;IAC/B,iBAAiB,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC,MAAM,UAAU,cAAc,CAAC,YAAsB,EAAE,MAAc;IACnE,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5D,CAAC;AAwBD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAuB,EACvB,OAAgC;IAEhC,IAAI,MAAM,CAAC,eAAe;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,MAAM,CAAC,sBAAsB,IAAI,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAClF,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,gBAAgB,IAAI,kBAAkB,EAAE,CAAC;QAC9E,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QACpE,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitmagic/cli",
-  "version": "0.1.83-dev.1",
+  "version": "0.1.83-dev.3",
   "description": "Build Bitmagic games from your own agent tool",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Bitmagic Oy",
@@ -23,11 +23,12 @@
     "citty": "^0.2.2",
     "fflate": "^0.8.2",
     "playwright-core": "^1.59.1",
+    "resedit": "3.0.2",
     "tar": "^7.4.3",
     "ws": "^8.21.3",
-    "@bitmagic/animation-forger": "0.1.38-dev.1",
-    "@bitmagic/world-forger": "0.1.43-dev.1",
-    "@bitmagic/asset-core": "0.2.38-dev.1"
+    "@bitmagic/animation-forger": "0.1.38-dev.3",
+    "@bitmagic/asset-core": "0.2.38-dev.3",
+    "@bitmagic/world-forger": "0.1.43-dev.3"
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",
@@ -43,7 +44,8 @@
     "eslint-plugin-import": "^2.32.0",
     "jest": "^29.7.0",
     "ts-jest": "^29.4.12",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.3",
+    "@bitmagic/hud-theme": "0.1.0"
   },
   "jest": {
     "preset": "ts-jest/presets/default-esm",
@@ -76,7 +78,7 @@
     ]
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/bundle-hud-theme.mjs",
     "check": "pnpm run lint && pnpm run build && pnpm run check:lab",
     "check:lab": "tsc -p tsconfig.lab.json --noEmit",
     "lint": "eslint src lab",

package/dist/theme/hud-theme-catalog.d.ts

@@ -1,235 +0,0 @@
-export declare const HUD_PRESETS: readonly ["rift-raider", "village-keep", "nexus", "simulator", "racing"];
-export type HudPresetName = (typeof HUD_PRESETS)[number];
-/**
- * The five presets' ACTUAL token values, mirrored from `game/src/engine/hud/themes/*.ts`.
- *
- * This exists because the promoted customization flow — "preset X but with
- * orange accents" — was unimplementable without it. `read-hud-theme` returns a
- * preset's NAME, `write-hud-theme` does a full replace rather than a merge, and
- * the engine source that holds the values is not readable from the hosted agent.
- * So an agent asked to tweak an active preset had nothing to patch and had to
- * invent a whole theme "in that preset's spirit", which is how a tweak request
- * silently became a redesign.
- *
- * Each entry is the RAW preset data, which is the same shape as an inline theme
- * — so it can be spread, edited and written straight back through
- * `write-hud-theme`. Use `presetTheme(name)` rather than reading this directly:
- * it strips `evokes`, which is authoring metadata and not a theme token.
- *
- * Hand-mirrored and drift-checked by `scripts/check-hud-catalog.ts`, which deep
- * compares every value against the engine modules.
- */
-export declare const HUD_PRESET_THEMES: Readonly<Record<HudPresetName, Readonly<Record<string, unknown>>>>;
-/**
- * A preset's tokens as a writable inline theme — the mirror entry minus the
- * `evokes` label, which describes the style rather than rendering it.
- *
- * The intended patch flow: `const base = presetTheme('nexus')`, apply the user's
- * change, then `write-hud-theme` the result.
- */
-export declare function presetTheme(name: HudPresetName): Record<string, unknown>;
-/**
- * The one-line mood label per preset, DERIVED from the mirrored preset data
- * above rather than kept as a second hand-written list.
- *
- * It used to be an independent map explicitly excluded from the drift gate, on
- * the grounds that the engine had no counterpart. It then rotted: three of five
- * labels described styles that had since been retuned, and this is the field an
- * agent picks a preset BY. The engine presets carry `evokes` beside their tokens
- * now, so the description and the style are one edit and one check.
- */
-export declare const HUD_PRESET_INFO: Readonly<Record<HudPresetName, {
-    evokes: string;
-}>>;
-export declare const HUD_FONTS: {
-    readonly 'red-hat-display': {
-        readonly family: "Red Hat Display";
-        readonly weights: readonly [300, 400, 500, 700];
-        readonly suitsCase: readonly ["upper", "normal"];
-        readonly evokes: "Default Bitmagic — warm, technical, modern sans";
-    };
-    readonly 'chakra-petch': {
-        readonly family: "Chakra Petch";
-        readonly weights: readonly [300, 400, 500, 600, 700];
-        readonly suitsCase: readonly ["upper", "normal"];
-        readonly evokes: "Chamfered techno sans — holographic HUD, sci-fi console, cut corners";
-    };
-    readonly 'ibm-plex-sans': {
-        readonly family: "IBM Plex Sans";
-        readonly weights: readonly [300, 400, 500, 600, 700];
-        readonly suitsCase: readonly ["upper", "normal"];
-        readonly evokes: "Engineered humanist sans — instrument panel, operator console, tabular data";
-    };
-    readonly 'archivo-narrow': {
-        readonly family: "Archivo Narrow";
-        readonly weights: readonly [400, 500, 600, 700];
-        readonly suitsCase: readonly ["upper", "normal"];
-        readonly evokes: "Narrow gothic that keeps its ink — motorsport telemetry, broadcast overlay";
-    };
-    readonly 'bebas-neue': {
-        readonly family: "Bebas Neue";
-        readonly weights: readonly [400];
-        readonly suitsCase: readonly ["upper", "normal"];
-        readonly evokes: "Tall, bold display — sports, action, news ticker";
-    };
-    readonly 'press-start-2p': {
-        readonly family: "Press Start 2P";
-        readonly weights: readonly [400];
-        readonly suitsCase: readonly ["upper", "normal"];
-        readonly evokes: "Retro arcade pixel — 8-bit, NES, chiptune";
-    };
-    readonly creepster: {
-        readonly family: "Creepster";
-        readonly weights: readonly [400];
-        readonly suitsCase: readonly ["normal"];
-        readonly evokes: "Horror, halloween, dripping — already display-styled";
-    };
-    readonly pacifico: {
-        readonly family: "Pacifico";
-        readonly weights: readonly [400];
-        readonly suitsCase: readonly ["normal"];
-        readonly evokes: "Handwritten cursive — tropical, beachy, casual";
-    };
-    readonly 'space-grotesk': {
-        readonly family: "Space Grotesk";
-        readonly weights: readonly [400, 500, 700];
-        readonly suitsCase: readonly ["upper", "normal"];
-        readonly evokes: "Geometric sans — sci-fi, technical, modern";
-    };
-    readonly 'rubik-mono-one': {
-        readonly family: "Rubik Mono One";
-        readonly weights: readonly [400];
-        readonly suitsCase: readonly ["upper", "normal"];
-        readonly evokes: "Heavy, slabby display — bold, blocky, attention-grabbing";
-    };
-    readonly vt323: {
-        readonly family: "VT323";
-        readonly weights: readonly [400];
-        readonly suitsCase: readonly ["upper", "normal"];
-        readonly evokes: "CRT terminal monospace — retro computer, hacker, glitch";
-    };
-    readonly orbitron: {
-        readonly family: "Orbitron";
-        readonly weights: readonly [400, 500, 700, 900];
-        readonly suitsCase: readonly ["upper", "normal"];
-        readonly evokes: "Futuristic geometric — sci-fi, cyber, racing HUD";
-    };
-    readonly shrikhand: {
-        readonly family: "Shrikhand";
-        readonly weights: readonly [400];
-        readonly suitsCase: readonly ["normal"];
-        readonly evokes: "Italic display — celebratory, party, energetic";
-    };
-    readonly 'baloo-2': {
-        readonly family: "Baloo 2";
-        readonly weights: readonly [400, 500, 600, 700, 800];
-        readonly suitsCase: readonly ["upper", "normal"];
-        readonly evokes: "Rounded chunky sans with a real weight range — mobile action-RPG chrome";
-    };
-    readonly 'lilita-one': {
-        readonly family: "Lilita One";
-        readonly weights: readonly [400];
-        readonly suitsCase: readonly ["upper", "normal"];
-        readonly evokes: "Chunky rounded comic display — cartoon battler, toon town";
-    };
-    readonly fredoka: {
-        readonly family: "Fredoka";
-        readonly weights: readonly [300, 400, 500, 700];
-        readonly suitsCase: readonly ["upper", "normal"];
-        readonly evokes: "Soft rounded bubble sans — candy, casual mobile, sweet";
-    };
-    readonly 'grenze-gotisch': {
-        readonly family: "Grenze Gotisch";
-        readonly weights: readonly [400, 500, 700, 900];
-        readonly suitsCase: readonly ["normal"];
-        readonly evokes: "Readable blackletter — dark fantasy, gothic dungeon";
-    };
-    readonly cinzel: {
-        readonly family: "Cinzel";
-        readonly weights: readonly [400, 500, 700, 900];
-        readonly suitsCase: readonly ["upper", "normal"];
-        readonly evokes: "Carved Roman caps — epic fantasy, ancient temple";
-    };
-};
-export declare const HUD_DECORATIONS: {
-    readonly 'drip-border': {
-        readonly suitsSlots: readonly ["borderImage", "decorationAfter"];
-        readonly evokes: "Horror drips on edges";
-    };
-    readonly 'pixel-corners': {
-        readonly suitsSlots: readonly ["borderImage"];
-        readonly evokes: "8-bit pixel corner brackets";
-    };
-    readonly scanline: {
-        readonly suitsSlots: readonly ["backdrop"];
-        readonly evokes: "CRT scanlines tiled across the surface";
-    };
-    readonly 'vine-corner': {
-        readonly suitsSlots: readonly ["borderImage", "decorationBefore"];
-        readonly evokes: "Tropical vines / leaves in corners";
-    };
-    readonly 'glow-aura': {
-        readonly suitsSlots: readonly ["backdrop", "decorationBefore", "decorationAfter"];
-        readonly evokes: "Soft radial glow halo behind the element";
-    };
-    readonly 'bracket-frame': {
-        readonly suitsSlots: readonly ["borderImage"];
-        readonly evokes: "Sci-fi targeting brackets on each corner";
-    };
-    readonly 'ribbon-edge': {
-        readonly suitsSlots: readonly ["decorationAfter", "decorationBefore"];
-        readonly evokes: "Bunting / banner saw-tooth edge";
-    };
-    readonly 'circuit-trace': {
-        readonly suitsSlots: readonly ["backdrop"];
-        readonly evokes: "PCB / circuit board trace pattern";
-    };
-    readonly 'candy-gloss': {
-        readonly suitsSlots: readonly ["backdrop", "decorationBefore"];
-        readonly evokes: "Glossy sugar highlight across the top — candy button shine";
-    };
-    readonly 'ornate-corner': {
-        readonly suitsSlots: readonly ["borderImage"];
-        readonly evokes: "Gothic filigree corner frame — dark fantasy, dungeon";
-    };
-    readonly 'royal-frame': {
-        readonly suitsSlots: readonly ["borderImage"];
-        readonly evokes: "Double gold-trim picture frame with corner studs — epic fantasy";
-    };
-    readonly 'hazard-stripes': {
-        readonly suitsSlots: readonly ["backdrop"];
-        readonly evokes: "Faint diagonal caution stripes — military / sci-fi warning panel";
-    };
-    readonly 'pixel-frame': {
-        readonly suitsSlots: readonly ["borderImage"];
-        readonly evokes: "NES dialog double-ring pixel border";
-    };
-    readonly 'grain-texture': {
-        readonly suitsSlots: readonly ["backdrop"];
-        readonly evokes: "Subtle parchment / leather grain tooth";
-    };
-};
-export declare const DEFAULT_THEME_TOKENS: Readonly<Record<string, unknown>>;
-export declare const HUD_DECORATION_SVGS: Readonly<Record<string, string>>;
-export declare const HUD_GLOW_KEYS: readonly ["aqua", "pink", "warm", "horror-red", "gold", "cyan", "none"];
-export declare const HUD_ELEMENT_CLASSES: readonly ["progressBar", "healthBar", "counter", "iconText", "timer", "toast", "controls", "reticle", "mobileControls"];
-export declare const HUD_SHAPE_TOKENS: readonly ["radiusPill", "radiusCard", "glow", "imageRendering", "borderWidth", "bevel", "gloss", "glowColor"];
-export declare const HUD_COLOR_TOKENS: readonly ["primary", "danger", "warning", "success", "background", "surface", "text", "textMuted", "outline"];
-export declare const HUD_REQUIRED_COLORS: readonly ["primary", "danger", "background", "surface", "text"];
-export declare const HUD_DECORATION_SLOTS: readonly ["borderImage", "backdrop", "decorationBefore", "decorationAfter"];
-export declare const HUD_ICON_SLOTS: readonly [{
-    readonly key: "heart";
-    readonly description: "Health label icon (shown next to \"HP\" on the player health bar). Default: filled heart.";
-}, {
-    readonly key: "mouse";
-    readonly description: "Pointer-lock overlay icon (\"Click to play\" screen). Default: outlined mouse.";
-}, {
-    readonly key: "arrow";
-    readonly description: "Movement-key arrow used in the controls overlay. ONE SVG — CSS rotates it for down/left/right. Default: thin chevron pointing up.";
-}];
-export declare const HUD_ICON_KEYS: ReadonlyArray<(typeof HUD_ICON_SLOTS)[number]["key"]>;
-export interface CatalogValidationIssue {
-    path: string;
-    message: string;
-    suggestion?: string;
-}