@vgai/engine 0.5.21 → 0.5.23

package/dist/manifest/filename.js

@@ -1,17 +1,13 @@
 // The project manifest's FILENAME. There is exactly ONE.
 //
-// The manifest is `vgai.project.json`. It used to be `vgai.game.json`, and for
-// a while both names were read — WO-9 #62 recorded that dual-read as
-// permanent, on the presumption of an EXTERNAL constituency of projects
-// already on disk. The owner reversed that on 2026-08-02 (the legacy-removal
-// doctrine, `docs/ARCHITECTURE-CORE.md` §Vocabulary): this is pre-release
-// software, no such constituency exists, and a second way to spell the
-// manifest is the defect — two accepted names meant both kept being written,
-// and copies of the "try both" probe grew in five modules that agreed with the
-// real resolver only by coincidence.
+// The manifest is `vgai.project.json`, and NOTHING reads a second spelling
+// (the legacy-removal doctrine, `docs/ARCHITECTURE-CORE.md` §Vocabulary). Two
+// accepted names is the defect, not the convenience: both get written, and
+// copies of the "try both" probe spread into modules that agree with the real
+// resolver only by coincidence.
 //
-// So the old name is REMOVED, and removed means it REJECTS LOUDLY naming the
-// exact one-line fix — never silently ignored, never redirected. A directory
+// The removed name REJECTS LOUDLY, naming the exact one-line fix — never
+// silently ignored, never redirected. A directory
 // carrying only `vgai.game.json` is an error with a `git mv` in the message,
 // not a project that quietly fails to open.
 //
@@ -35,7 +31,7 @@ export function isManifestFilename(name) {
  */
 export function removedManifestFilenameMessage(where) {
     return (`${where}: found \`${REMOVED_MANIFEST_FILENAME}\` and no \`${MANIFEST_FILENAME}\`. ` +
-        `\`${REMOVED_MANIFEST_FILENAME}\` was REMOVED (WO-LR1; the legacy-removal doctrine, ` +
+        `\`${REMOVED_MANIFEST_FILENAME}\` was REMOVED (the legacy-removal doctrine, ` +
         'docs/ARCHITECTURE-CORE.md §Vocabulary) — nothing reads it any more, and it is ' +
         'deliberately NOT read as a fallback, because a second accepted name is the defect.\n' +
         `Fix: rename it — \`git mv ${REMOVED_MANIFEST_FILENAME} ${MANIFEST_FILENAME}\`. ` +

package/dist/manifest/load.d.ts

@@ -31,16 +31,6 @@ export type ResolvedAdapter = {
     readonly assets: Record<string, string> | undefined;
     readonly domStubs: string[] | undefined;
     readonly captureTimeoutMs: number | undefined;
-    /**
-     * The component this root'''s WORLD is, in the game'''s own source (see the
-     * field'''s schema description). Present ⇒ Edit mounts THAT component
-     * alone as a still design-time document and Play mounts the game
-     * through `entry`; absent ⇒ `entry` is what both modes mount.
-     */
-    readonly world?: {
-        readonly entry: string;
-        readonly export?: string | undefined;
-    } | undefined;
 };
 export interface ResolvedAdapterRoot {
     readonly id: string;
@@ -48,6 +38,16 @@ export interface ResolvedAdapterRoot {
     readonly description: string | undefined;
     readonly adapter: ResolvedAdapter;
     readonly entry: string | undefined;
+    /**
+     * The component this root's WORLD is, in the game's own source (see the
+     * field's schema description). Present ⇒ Edit mounts THAT component alone as
+     * its design-time document and Play mounts the game through `entry`;
+     * absent ⇒ `entry` is what both modes mount.
+     */
+    readonly world?: {
+        readonly entry: string;
+        readonly export: string | undefined;
+    } | undefined;
     readonly zOrder: number;
     readonly pausable: boolean;
     readonly loop: 'gated' | 'self-driven';

package/dist/manifest/load.d.ts.map

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

package/dist/manifest/load.js

@@ -79,7 +79,6 @@ function resolveAdapter(root) {
         assets: ingest.assets,
         domStubs: ingest.domStubs,
         captureTimeoutMs: ingest.captureTimeoutMs,
-        world: ingest.world,
     };
 }
 function checkEngineVersionPin(version) {
@@ -95,11 +94,14 @@ function checkEngineVersionPin(version) {
  * `id` drives uniqueness; `adapter` (incl. its surface and
  * `module`/`ingest.*` sub-fields) drives adapter identity
  * resolution; `entry` drives the entry cross-field rule and is
- * carried through; `zOrder` drives the final sort; `pausable`/`loop` are
+ * carried through; `world` is carried through for the ONE reader that mounts a
+ * design-time document (the editor's design session) and is deliberately not
+ * cross-checked against `entry` — the two name different modules on purpose;
+ * `zOrder` drives the final sort; `pausable`/`loop` are
  * carried through as-is (their consumers are the runtime/CLI, T3.2/T3.3);
  * `description` (T3.3
  * slice 3) is carried through as-is — its consumer today is
- * `resolveIngestDescriptor` (packages/editor/src/adapter-resolver.ts), which
+ * `resolveIngestDescriptor` (packages/editor/src/ingest/resolve-three.ts), which
  * threads an ingest-three root's description into `IngestGame.description`.
  */
 function resolveRoot(root) {
@@ -111,6 +113,7 @@ function resolveRoot(root) {
         description: root.description,
         adapter,
         entry: root.entry,
+        world: root.world === undefined ? undefined : { entry: root.world.entry, export: root.world.export },
         zOrder: root.zOrder,
         pausable: root.pausable,
         loop: root.loop,
@@ -126,9 +129,9 @@ function resolveRoot(root) {
  * any Zod validation failure or cross-field rule violation.
  */
 export function loadGameManifest(raw) {
-    // Removed-format guard FIRST, on the raw value: a legacy `.vscn.json` root
-    // would otherwise fail Zod's `roots` discriminated union with a confusing
-    // shape error instead of a migration message (WO-8).
+    // Removed-format guard FIRST, on the raw value: a root declaring a removed
+    // content field would otherwise fail Zod's `roots` discriminated union with
+    // a confusing shape error instead of the named migration message.
     const parsed = GameManifestSchema.safeParse(raw);
     if (!parsed.success) {
         // D-V6: the `roots` `superRefine`'s composition issues — a duplicate root

package/dist/manifest/schema.d.ts

@@ -28,10 +28,6 @@ export declare const RootAdapterSchema: z.ZodPipe<z.ZodTransform<unknown, unknow
         moduleAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         domStubs: z.ZodOptional<z.ZodArray<z.ZodString>>;
         captureTimeoutMs: z.ZodOptional<z.ZodNumber>;
-        world: z.ZodOptional<z.ZodObject<{
-            entry: z.ZodString;
-            export: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>>;
     }, z.core.$strict>;
 }, z.core.$strict>]>>;
 export type RootAdapter = z.infer<typeof RootAdapterSchema>;
@@ -62,14 +58,14 @@ export declare const AdapterRootSchema: z.ZodObject<{
             moduleAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             domStubs: z.ZodOptional<z.ZodArray<z.ZodString>>;
             captureTimeoutMs: z.ZodOptional<z.ZodNumber>;
-            world: z.ZodOptional<z.ZodObject<{
-                entry: z.ZodString;
-                export: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict>>;
         }, z.core.$strict>;
     }, z.core.$strict>]>>;
     entry: z.ZodOptional<z.ZodString>;
     styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    world: z.ZodOptional<z.ZodObject<{
+        entry: z.ZodString;
+        export: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
     zOrder: z.ZodDefault<z.ZodNumber>;
     pausable: z.ZodDefault<z.ZodBoolean>;
     loop: z.ZodDefault<z.ZodEnum<{
@@ -119,7 +115,7 @@ export declare const GameManifestSchema: z.ZodObject<{
     version: z.ZodString;
     engine: z.ZodObject<{
         version: z.ZodString;
-    }, z.core.$strip>;
+    }, z.core.$strict>;
     roots: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
@@ -147,14 +143,14 @@ export declare const GameManifestSchema: z.ZodObject<{
                 moduleAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 domStubs: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 captureTimeoutMs: z.ZodOptional<z.ZodNumber>;
-                world: z.ZodOptional<z.ZodObject<{
-                    entry: z.ZodString;
-                    export: z.ZodOptional<z.ZodString>;
-                }, z.core.$strict>>;
             }, z.core.$strict>;
         }, z.core.$strict>]>>;
         entry: z.ZodOptional<z.ZodString>;
         styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        world: z.ZodOptional<z.ZodObject<{
+            entry: z.ZodString;
+            export: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
         zOrder: z.ZodDefault<z.ZodNumber>;
         pausable: z.ZodDefault<z.ZodBoolean>;
         loop: z.ZodDefault<z.ZodEnum<{
@@ -169,9 +165,9 @@ export declare const GameManifestSchema: z.ZodObject<{
                 id: z.ZodString;
                 label: z.ZodString;
                 roots: z.ZodArray<z.ZodString>;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
     server: z.ZodOptional<z.ZodObject<{
         room: z.ZodString;
         endpoint: z.ZodOptional<z.ZodString>;
@@ -181,28 +177,28 @@ export declare const GameManifestSchema: z.ZodObject<{
             accessToken: z.ZodString;
             expiresAt: z.ZodNumber;
         }, z.core.$strict>>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     resolution: z.ZodOptional<z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     rendering: z.ZodOptional<z.ZodObject<{
         antialias: z.ZodBoolean;
     }, z.core.$strict>>;
     debug: z.ZodOptional<z.ZodObject<{
         allowInProduction: z.ZodBoolean;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     determinism: z.ZodOptional<z.ZodObject<{
         seededRandom: z.ZodBoolean;
         defaultSeed: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     budget: z.ZodOptional<z.ZodObject<{
         frameCpuMsP95: z.ZodOptional<z.ZodNumber>;
         physicsMsP95: z.ZodOptional<z.ZodNumber>;
         maxEntities: z.ZodOptional<z.ZodNumber>;
         maxDrawCalls: z.ZodOptional<z.ZodNumber>;
         maxTriangles: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     learn: z.ZodOptional<z.ZodObject<{
         kind: z.ZodEnum<{
             starter: "starter";

package/dist/manifest/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/manifest/schema.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAG,CAAU,CAAC;AAsFhD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAsJ3B,CAAC;AACJ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsDnB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAkB5D,eAAO,MAAM,eAAe;;;;;EAMzB,CAAC;AACJ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,qBAAqB;;;;EAEa,CAAC;AAChD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;kBAqC7B,CAAC;AACJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAoTyD,CAAC;AAEzF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/manifest/schema.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAG,CAAU,CAAC;AAsFhD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;qBA0H3B,CAAC;AACJ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqFnB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAkB5D,eAAO,MAAM,eAAe;;;;;EAMzB,CAAC;AACJ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,qBAAqB;;;;EAEa,CAAC;AAChD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;kBAqC7B,CAAC;AACJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA8TyD,CAAC;AAEzF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/manifest/schema.js

@@ -7,14 +7,9 @@
 // has a `.describe()` (repo policy — powers `scripts/generate-schema.ts` and
 // the T4.1 schema-walk coverage test).
 //
-// Naming: this file follows the repo's `XxxSchema` (Zod schema) / `Xxx`
-// (inferred type) convention used throughout `scene/schema/` — the design
-// doc's §3 sketch names the bare consts (`AdapterRoot`) without the
-// `Schema` suffix; that sketch is explicitly a
-// "Zod sketch" the doc tells implementers to adapt to real code style
-// ("mirror the style in scene/schema/scene-file.ts" per CLAUDE.md), so the
-// schema consts here are suffixed and the bare names are reserved for the
-// inferred types, matching every other schema file in the repo.
+// Naming: `XxxSchema` is the Zod schema, `Xxx` the inferred type. Every schema
+// file in this repo reads that way, so the bare names stay reserved for the
+// types.
 //
 // Adapter surface values mirror `AdapterSurface` in
 // `packages/engine/src/runtime/game.ts` (`'three' | 'canvas' | 'dom'`)
@@ -53,7 +48,7 @@ export const GAME_MANIFEST_VERSION = 2;
 // which is exactly why react is a `dom` root rather than its own kind.
 //
 // The pre-rename spellings `threejs`/`pixijs`/`react` are REMOVED, not
-// normalized (WO-LR1 item 2, the legacy-removal doctrine at
+// normalized (the legacy-removal doctrine at
 // ARCHITECTURE-CORE §Vocabulary). Normalization was a second way to say the
 // same thing: two spellings both parsed, so both kept being written, and
 // SECOND readers grew (the dev server's surface probe, the hosted-editor
@@ -75,8 +70,8 @@ const REMOVED_BARE_ADAPTER_SPELLING = {
 };
 function removedSpellingMessage(bad, where) {
     const canonical = where === 'adapter' ? REMOVED_BARE_ADAPTER_SPELLING[bad] : REMOVED_SURFACE_SPELLING[bad];
-    return (`Game manifest: \`${where}\`: "${bad}" — that spelling was REMOVED (WO-LR1; ` +
-        'ARCHITECTURE-CORE §Vocabulary). The surface vocabulary is ' +
+    return (`Game manifest: \`${where}\`: "${bad}" — that spelling was REMOVED ` +
+        '(ARCHITECTURE-CORE §Vocabulary). The surface vocabulary is ' +
         "'three' | 'canvas' | 'dom' — what the HOST HANDS the root, never which " +
         `library it uses.\nFix: change \`${where}\` to "${canonical}".`);
 }
@@ -194,28 +189,6 @@ export const RootAdapterSchema = z
                 .describe("How long the host waits for this game's first captured frame before the mount " +
                 'FAILS by name. A game that needs a long boot (streamed world assets, a menu ' +
                 'the player must clear) raises it; the default is 10s.'),
-            world: z
-                .object({
-                entry: z
-                    .string()
-                    .describe("Project-relative path to the game's OWN module exporting that component"),
-                export: z
-                    .string()
-                    .optional()
-                    .describe('Named export to read from that module; omit when the module default-exports it'),
-            })
-                .strict()
-                .optional()
-                .describe("The component this root's WORLD is, in the game's own source — a three root " +
-                'whose scene is a React/R3F component tree names it here. Two readers, and ' +
-                'they mount different things: the editor mounts THIS component alone as the ' +
-                "root's design-time document (a still scene — its frameloop runs ONE bounded " +
-                'settle at mount, so physics-owned bodies rest at their authored spawn, and ' +
-                'is then frozen forever; nothing moves in Edit), while `entry` ' +
-                'above stays what PLAY mounts (the whole game, its own composition, its own ' +
-                'HUD and loop). Declaring it is what lets a scene be a scene in Edit rather ' +
-                "than the running game's mount surfaces. A game whose world is not a " +
-                'component omits it and keeps mounting through `entry` in both modes.'),
         })
             .strict()
             .describe('Ingest adapter configuration for an unmodified game (a repo-vendored game or your ' +
@@ -257,6 +230,33 @@ export const AdapterRootSchema = z
         "mounts the root's DOM in (`@scope`; packages/editor/server/scoped-game-css.ts), so " +
         "the HUD is styled on the UI board's story cards and on the game surface without the " +
         'editor seeing a single one of those rules. The files themselves are never modified.'),
+    world: z
+        .object({
+        entry: z
+            .string()
+            .describe("Project-relative path to the game's OWN module exporting that component"),
+        export: z
+            .string()
+            .optional()
+            .describe('Named export to read from that module; omit when the module default-exports it'),
+    })
+        .strict()
+        .optional()
+        .describe("The component this root's WORLD is, in the game's own source. Two readers, and they " +
+        "mount different things: the EDITOR mounts THIS component alone as the root's " +
+        'design-time document, while `entry` above stays what PLAY mounts (the whole game — ' +
+        'its own composition, its own HUD, its own loop). It sits on the ROOT rather than ' +
+        'inside any one adapter because the split it names is not about ingest: a game whose ' +
+        'runtime entry is a SHELL over the thing an author actually edits has this shape ' +
+        'whether the source is vendored or first-party. Two shipped cases, one field: an ' +
+        'ingested game whose `entry` mounts game+HUD+loop while the named export is the world ' +
+        'alone; and a translated Unity/Godot port, whose `entry` is a scene HOST that mounts ' +
+        'the scene the built player starts on (`EditorBuildSettings` index 0 — routinely a ' +
+        'menu with no 3D content at all) while the named export opens the scene an author ' +
+        "edits. That is Unity's own split: build settings say where the PLAYER starts; the " +
+        'Scene view opens a scene, and Unity keeps that fact somewhere else entirely. A game ' +
+        'whose world is not a separate component omits this and keeps mounting through ' +
+        '`entry` in both modes.'),
     zOrder: z
         .number()
         .int()
@@ -350,6 +350,7 @@ export const GameManifestSchema = z
             .describe('Exact @vgai/engine semver this game was scaffolded/last upgraded against — an ' +
             'identity pin, not a range'),
     })
+        .strict()
         .describe('Engine version pin'),
     roots: z
         .array(AdapterRootSchema)
@@ -422,20 +423,24 @@ export const GameManifestSchema = z
                 .optional()
                 .describe('Optional editor labels keyed by adapter-root id'),
             groups: z
-                .array(z.object({
+                .array(z
+                .object({
                 id: z.string().describe('Unique editor-only group id'),
                 label: z.string().describe('Editor-only group label'),
                 roots: z
                     .array(z.string())
                     .min(1)
                     .describe('Adapter-root ids shown under this editor-only group'),
-            }))
+            })
+                .strict())
                 .optional()
                 .describe('Optional editor-only hierarchy groups'),
         })
+            .strict()
             .optional()
             .describe('Editor projection for native adapter roots'),
     })
+        .strict()
         .optional()
         .describe('Editor-only authoring metadata; never runtime ownership'),
     server: z
@@ -469,6 +474,7 @@ export const GameManifestSchema = z
             .optional()
             .describe('Deploy-baked managed-relay credentials. NEVER hand-authored in source — written only into the staged manifest by `vgai deploy` and fetched at runtime by the standalone client'),
     })
+        .strict()
         .optional()
         .describe('Multiplayer server config (Colyseus), if this game registers a room'),
     resolution: z
@@ -476,6 +482,7 @@ export const GameManifestSchema = z
         width: z.number().describe('Canvas width in pixels'),
         height: z.number().describe('Canvas height in pixels'),
     })
+        .strict()
         .optional()
         .describe('Canvas resolution'),
     rendering: z
@@ -504,6 +511,7 @@ export const GameManifestSchema = z
             'production builds. Default false: the bridge only installs in dev builds. The ' +
             'runtime reader is the debug-bridge installer (D18).'),
     })
+        .strict()
         .optional()
         .describe('Debug-bridge production gating (D18) — governs whether ?vgai-debug=1 installs ' +
         'window.__vgai outside dev builds.'),
@@ -530,6 +538,7 @@ export const GameManifestSchema = z
             'even higher-precedence explicit config value a host passes directly. Optional — ' +
             "omit to fall back to the runtime's own fixed default seed."),
     })
+        .strict()
         .optional()
         .describe('Seeded-RNG determinism contract (D15) — governs ' +
         'whether ctx.random is boot-seeded from a reproducible seed and whether the ' +
@@ -576,6 +585,7 @@ export const GameManifestSchema = z
             "(the profiler's per-frame render.triangles, from renderer.info). Exact and " +
             'deterministic under a seed.'),
     })
+        .strict()
         .refine((budget) => Object.values(budget).some((value) => value !== undefined), {
         message: 'Game manifest: `budget` must set at least one metric (frameCpuMsP95, physicsMsP95, ' +
             'maxEntities, maxDrawCalls, maxTriangles) — an empty budget block gates nothing ' +

package/dist/physics/collider-dimensions.d.ts

@@ -5,17 +5,13 @@
  * shape is defined in absolute world units at creation time. Three.js meshes,
  * by contrast, scale visually for free via the normal Object3D hierarchy. To
  * keep the physical collider matching what's on screen, the LOADER must bake
- * the entity's composed WORLD scale (self × every transformed ancestor — see
- * T1.1's world-transform composition) into the collider's dimensions at
- * creation time.
+ * the entity's composed WORLD scale (self × every transformed ancestor) into
+ * the collider's dimensions at creation time.
  *
- * This is the ONE place that does that math, so both the runtime loader
- * (scene-loader.ts `createPhysicsBody`) and the editor's collider gizmo
- * (gizmo-registry.ts) agree on exactly the same numbers — previously the
- * editor gizmo only rendered the entity's own live Object3D scale (via normal
- * Three.js parenting) while the Rapier body ignored scale entirely, so the
- * two silently agreed by coincidence for uniform scale and disagreed for
- * everything else.
+ * This is the ONE place that does that math, so every caller — the physics
+ * body creation path and the editor's collider gizmo alike — agrees on
+ * exactly the same numbers. Two copies silently agree by coincidence for
+ * uniform scale and disagree for everything else.
  *
  * Round colliders (ball/capsule) can only represent a uniform radius — Rapier
  * has no ellipsoid/elliptical-capsule shape. A non-uniform world scale on a
@@ -33,8 +29,8 @@ export interface ColliderWorldDimensions {
 }
 /**
  * Compute a collider's WORLD-space dimensions given the entity's composed
- * world scale (self × ancestors, per-axis, in the entity's own local frame —
- * X/Y/Z order matches `SceneEntity.transform.scale`).
+ * world scale (self × ancestors, per-axis, in the entity's own local frame,
+ * in X/Y/Z order).
  *
  * @param collider - the entity's authored (unscaled) collider definition.
  * @param worldScale - composed world scale `[x, y, z]`.

package/dist/physics/collider-dimensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collider-dimensions.d.ts","sourceRoot":"","sources":["../../src/physics/collider-dimensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAMpE,MAAM,WAAW,uBAAuB;IACtC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,kBAAkB,EAC5B,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC7C,WAAW,EAAE,MAAM,GAClB,uBAAuB,CA4CzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACrD,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC5C,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAItC"}
+{"version":3,"file":"collider-dimensions.d.ts","sourceRoot":"","sources":["../../src/physics/collider-dimensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAMpE,MAAM,WAAW,uBAAuB;IACtC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,kBAAkB,EAC5B,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC7C,WAAW,EAAE,MAAM,GAClB,uBAAuB,CA4CzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACrD,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC5C,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAItC"}

package/dist/physics/collider-dimensions.js

@@ -5,17 +5,13 @@
  * shape is defined in absolute world units at creation time. Three.js meshes,
  * by contrast, scale visually for free via the normal Object3D hierarchy. To
  * keep the physical collider matching what's on screen, the LOADER must bake
- * the entity's composed WORLD scale (self × every transformed ancestor — see
- * T1.1's world-transform composition) into the collider's dimensions at
- * creation time.
+ * the entity's composed WORLD scale (self × every transformed ancestor) into
+ * the collider's dimensions at creation time.
  *
- * This is the ONE place that does that math, so both the runtime loader
- * (scene-loader.ts `createPhysicsBody`) and the editor's collider gizmo
- * (gizmo-registry.ts) agree on exactly the same numbers — previously the
- * editor gizmo only rendered the entity's own live Object3D scale (via normal
- * Three.js parenting) while the Rapier body ignored scale entirely, so the
- * two silently agreed by coincidence for uniform scale and disagreed for
- * everything else.
+ * This is the ONE place that does that math, so every caller — the physics
+ * body creation path and the editor's collider gizmo alike — agrees on
+ * exactly the same numbers. Two copies silently agree by coincidence for
+ * uniform scale and disagree for everything else.
  *
  * Round colliders (ball/capsule) can only represent a uniform radius — Rapier
  * has no ellipsoid/elliptical-capsule shape. A non-uniform world scale on a
@@ -27,8 +23,8 @@ import { DEFAULTS } from '../defaults';
 const UNIFORM_SCALE_EPSILON = 1e-4;
 /**
  * Compute a collider's WORLD-space dimensions given the entity's composed
- * world scale (self × ancestors, per-axis, in the entity's own local frame —
- * X/Y/Z order matches `SceneEntity.transform.scale`).
+ * world scale (self × ancestors, per-axis, in the entity's own local frame,
+ * in X/Y/Z order).
  *
  * @param collider - the entity's authored (unscaled) collider definition.
  * @param worldScale - composed world scale `[x, y, z]`.

package/dist/pixi/scene-capture.d.ts

@@ -17,20 +17,18 @@
  * instance, so it is trapped; a game bundling its own pixi cannot be captured at
  * all, and its mount fails by name.
  */
-import { type VisibilityClock, type VisibleCaptureWindow } from '../adapter/ingest/visible-capture-window';
+import { type CaptureWaitOptions } from '../adapter/ingest/visible-capture-window';
 /**
- * Options for {@link SceneCapture2DHandle.waitForCapture} — the same shape the
- * three lane's `CaptureWaitOptions` has, because it is the same wait. Passing a
- * bare number is `{ timeoutMs }`, which is what every existing caller does.
+ * Options for {@link SceneCapture2DHandle.waitForCapture} — the WAIT's options,
+ * not this lane's, so they carry no `2D` suffix and are not declared here.
+ * They configure `visible-capture-window.ts`'s window, which both surfaces
+ * share; this lane used to restate them field-for-field under a `2D` name.
+ * The suffix marks what a surface genuinely owns
+ * ({@link CapturedRuntime2D} is a Pixi stage/renderer/app, and stays), and a
+ * budget of visible milliseconds is not that. Passing a bare number is
+ * `{ timeoutMs }`, which is what every existing caller does.
  */
-export interface CaptureWait2DOptions {
-    /** The capture window, in VISIBLE milliseconds (default 10s). */
-    timeoutMs?: number | undefined;
-    /** Injected in tests; defaults to the document's own visibility. */
-    visibility?: VisibilityClock | undefined;
-    /** Live view of the wait while it runs, `null` the moment it ends. */
-    onWait?: ((wait: VisibleCaptureWindow | null) => void) | undefined;
-}
+export type { CaptureWaitOptions };
 /** A live Pixi runtime captured from an external PixiJS game. */
 export interface CapturedRuntime2D {
     /** The game's root stage Container. */
@@ -59,7 +57,7 @@ export interface SceneCapture2DHandle {
      * frame the tab draws after it comes forward is trapped exactly as it would
      * have been at boot. Rejects only when the window is spent while VISIBLE.
      */
-    waitForCapture(options?: number | CaptureWait2DOptions): Promise<CapturedRuntime2D>;
+    waitForCapture(options?: number | CaptureWaitOptions): Promise<CapturedRuntime2D>;
     getDrawCount(): number;
     /** Pause/resume the captured game's own ticker (loop-host gating). */
     setPaused(paused: boolean): void;

package/dist/pixi/scene-capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-capture.d.ts","sourceRoot":"","sources":["../../src/pixi/scene-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAC1B,MAAM,0CAA0C,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,oEAAoE;IACpE,UAAU,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACzC,sEAAsE;IACtE,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACpE;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpF,YAAY,IAAI,MAAM,CAAC;IACvB,sEAAsE;IACtE,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,SAAS,IAAI,IAAI,CAAC;CACnB;AAMD,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;CAChE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,OAAO,EACtB,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CAmFtB"}
+{"version":3,"file":"scene-capture.d.ts","sourceRoot":"","sources":["../../src/pixi/scene-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,KAAK,kBAAkB,EAGxB,MAAM,0CAA0C,CAAC;AAElD;;;;;;;;;GASG;AACH,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClF,YAAY,IAAI,MAAM,CAAC;IACvB,sEAAsE;IACtE,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,SAAS,IAAI,IAAI,CAAC;CACnB;AAMD,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;CAChE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,OAAO,EACtB,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CAmFtB"}

package/dist/react/world-state.d.ts

@@ -18,9 +18,9 @@
 import { type PropsWithChildren } from 'react';
 import type { z } from 'zod';
 import type { RootStateObserver } from '../adapter';
+import type { DebugCommandArgs } from '../runtime/debug-registry';
 import { type Equals, shallow } from '../runtime/frame-selector-cache';
 import type { Game } from '../runtime/game';
-import type { DebugCommandArgs } from '../runtime/types';
 /** Re-exported for convenience — the opt-in equality for selectors that
  *  return a fresh object/array/tuple every call (default is `Object.is`). */
 export { shallow };

package/dist/react/world-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"world-state.d.ts","sourceRoot":"","sources":["../../src/react/world-state.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EAMvB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAA4B,KAAK,MAAM,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AACjG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;6EAC6E;AAC7E,OAAO,EAAE,OAAO,EAAE,CAAC;AAInB;;;;;;;;;;;;;;oFAcoF;AACpF,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,iBAAiB,CAAC;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,+BAElF;AAED;;mDAEmD;AACnD,wBAAgB,OAAO,IAAI,IAAI,CAQ9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,IAAI,GAAG,IAAI,CAE7C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,EAAE,MAAM,GAAE,MAAM,CAAC,CAAC,CAAa,GAAG,CAAC,CAW9F;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAiBlF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,CAAC,EAClC,MAAM,GAAE,MAAM,CAAC,CAAC,CAAa,GAC5B,CAAC,CAoBH;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,EACjB,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;CAAE,GAC1C,IAAI,CAaN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,GAAG,SAAS,GAAG,SAAS,EAC1E,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAAE,EACrE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAC/D,IAAI,CAeN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CASxE"}
+{"version":3,"file":"world-state.d.ts","sourceRoot":"","sources":["../../src/react/world-state.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EAMvB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,EAA4B,KAAK,MAAM,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AACjG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C;6EAC6E;AAC7E,OAAO,EAAE,OAAO,EAAE,CAAC;AAInB;;;;;;;;;;;;;;oFAcoF;AACpF,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,iBAAiB,CAAC;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,+BAElF;AAED;;mDAEmD;AACnD,wBAAgB,OAAO,IAAI,IAAI,CAQ9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,IAAI,GAAG,IAAI,CAE7C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,EAAE,MAAM,GAAE,MAAM,CAAC,CAAC,CAAa,GAAG,CAAC,CAW9F;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAiBlF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,CAAC,EAClC,MAAM,GAAE,MAAM,CAAC,CAAC,CAAa,GAC5B,CAAC,CAoBH;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,EACjB,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;CAAE,GAC1C,IAAI,CAaN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,GAAG,SAAS,GAAG,SAAS,EAC1E,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAAE,EACrE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAC/D,IAAI,CAeN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CASxE"}