@vgai/engine 0.5.14 → 0.5.16

package/dist/pixi/scene-capture.js

@@ -23,7 +23,7 @@ import { documentVisibilityClock, startVisibleCaptureWindow, } from '../adapter/
  * host's `pixi.js` namespace so a shared-instance game is trapped. Install once per
  * ingest session; `uninstall()` on teardown.
  */
-export function installSceneCapture2D(pixiNamespace) {
+export function installSceneCapture2D(pixiNamespace, options = {}) {
     const PIXI = pixiNamespace;
     const proto = PIXI.Application.prototype;
     let captured = null;
@@ -38,9 +38,12 @@ export function installSceneCapture2D(pixiNamespace) {
             drawCount++;
             const stage = this['stage'];
             if (!captured && stage) {
-                captured = { stage, renderer: this['renderer'], app: this };
-                for (const resolve of waiters.splice(0))
-                    resolve(captured);
+                const candidate = { stage, renderer: this['renderer'], app: this };
+                if (options.accept?.(candidate) ?? true) {
+                    captured = candidate;
+                    for (const resolve of waiters.splice(0))
+                        resolve(captured);
+                }
             }
             return realRender?.apply(this, args);
         },
@@ -76,8 +79,8 @@ export function installSceneCapture2D(pixiNamespace) {
                             waiters.splice(i, 1);
                         opts.onWait?.(null);
                         reject(new Error(`pixi scene capture timed out after ${timeoutMs}ms of VISIBLE time ` +
-                            `(${Math.round(captureWindow.elapsedHiddenMs())}ms hidden, which is not counted — ` +
-                            'a hidden tab cannot render) — the game never rendered, or it bundles its own ' +
+                            `(${Math.round(captureWindow.elapsedHiddenMs())}ms browser-suspended, which is ` +
+                            'not counted because no frame can be presented) — the game never rendered, or it bundles its own ' +
                             '(un-shared) copy of pixi.js.'));
                     },
                 });

package/dist/render/particles-factory.d.ts

@@ -7,7 +7,7 @@
  * The schema mirrors quarks' native JSON format, so most fields pass through
  * directly to quarks' fromJSON or constructor methods.
  */
-import { type EmitterShape } from 'quarks.core';
+import { type ColorGenerator, type EmitterShape, type FunctionColorGenerator } from 'quarks.core';
 import * as THREE from 'three';
 import { type BatchedRenderer, ParticleSystem } from 'three.quarks';
 import type { ParticlesDescriptor } from '../asset-formats/particles';
@@ -26,9 +26,9 @@ export interface ParticleSystemResult {
  * This is how a caller with fidelity a plain descriptor cannot express reaches
  * the SAME factory instead of hand-building its own `new ParticleSystem(...)`:
  * a foreign-engine carry (e.g. Godot CPUParticles) supplies its own
- * `EmitterShape` and an instancing geometry here, and expresses everything
- * else — lifecycle, start values, emission, behaviors, material — as descriptor
- * JSON.
+ * `EmitterShape`, start-colour generator, and instancing geometry here, and
+ * expresses everything else — lifecycle, scalar start values, emission,
+ * behaviors, material — as descriptor JSON.
  */
 export interface ParticleSystemObjects {
     /**
@@ -37,6 +37,12 @@ export interface ParticleSystemObjects {
      * present it REPLACES `data.shape`.
      */
     shape?: EmitterShape;
+    /**
+     * A pre-built start-colour generator for a per-particle draw the descriptor's
+     * JSON generator vocabulary cannot express. When present it REPLACES
+     * `data.startColor`.
+     */
+    startColor?: ColorGenerator | FunctionColorGenerator;
     /**
      * The geometry instanced per particle in `RenderMode.Mesh`. A
      * `BufferGeometry` is not JSON-serializable, so `renderMode: 'mesh'` requires
@@ -57,8 +63,9 @@ export interface ParticleSystemObjects {
  * Create a three.quarks ParticleSystem from ParticlesDescriptor JSON data.
  *
  * `objects` carries the pieces a JSON descriptor cannot: a plugin emitter
- * shape, a mesh-mode instancing geometry, and the default-sprite toggle. It is
- * optional and additive — a call with only `data` behaves exactly as before.
+ * shape, a start-colour generator, a mesh-mode instancing geometry, and the
+ * default-sprite toggle. It is optional and additive — a call with only `data`
+ * behaves exactly as before.
  */
 export declare function createParticleSystemFromData(data: ParticlesDescriptor, objects?: ParticleSystemObjects): ParticleSystemResult;
 /**

package/dist/render/particles-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"particles-factory.d.ts","sourceRoot":"","sources":["../../src/render/particles-factory.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAEH,OAAO,EAQL,KAAK,YAAY,EAmBlB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,eAAe,EAAE,cAAc,EAAc,MAAM,cAAc,CAAC;AAChF,OAAO,KAAK,EAIV,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AA4RpC,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC;IACxB,kEAAkE;IAClE,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC;IAC1C;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;GAMG;AAEH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,mBAAmB,EACzB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,oBAAoB,CA6DtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAsB9F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,SAAS,GAAG,IAAI,CAU/F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,cAAc,GACrB,IAAI,CAGN;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,cAAc,GACrB,IAAI,CAGN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,mBAAmB,CA6B1D"}
+{"version":3,"file":"particles-factory.d.ts","sourceRoot":"","sources":["../../src/render/particles-factory.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAEH,OAAO,EAIL,KAAK,cAAc,EAKnB,KAAK,YAAY,EAGjB,KAAK,sBAAsB,EAiB5B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,eAAe,EAAE,cAAc,EAAc,MAAM,cAAc,CAAC;AAChF,OAAO,KAAK,EAIV,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AA4RpC,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC;IACxB,kEAAkE;IAClE,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,cAAc,GAAG,sBAAsB,CAAC;IACrD;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC;IAC1C;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AAEH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,mBAAmB,EACzB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,oBAAoB,CA8DtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAsB9F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,SAAS,GAAG,IAAI,CAU/F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,cAAc,GACrB,IAAI,CAGN;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,cAAc,GACrB,IAAI,CAGN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,mBAAmB,CA6B1D"}

package/dist/render/particles-factory.js

@@ -232,8 +232,9 @@ function getDefaultSpriteTex() {
  * Create a three.quarks ParticleSystem from ParticlesDescriptor JSON data.
  *
  * `objects` carries the pieces a JSON descriptor cannot: a plugin emitter
- * shape, a mesh-mode instancing geometry, and the default-sprite toggle. It is
- * optional and additive — a call with only `data` behaves exactly as before.
+ * shape, a start-colour generator, a mesh-mode instancing geometry, and the
+ * default-sprite toggle. It is optional and additive — a call with only `data`
+ * behaves exactly as before.
  */
 // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: straightforward field-by-field mapping
 export function createParticleSystemFromData(data, objects) {
@@ -269,7 +270,9 @@ export function createParticleSystemFromData(data, objects) {
         params['startSize'] = valueGen(data.startSize);
     if (data.startRotation)
         params['startRotation'] = valueGen(data.startRotation);
-    if (data.startColor)
+    if (objects?.startColor)
+        params['startColor'] = objects.startColor;
+    else if (data.startColor)
         params['startColor'] = colorGen(data.startColor);
     if (data.startTileIndex)
         params['startTileIndex'] = valueGen(data.startTileIndex);

package/dist/runtime/create-runtime.d.ts

@@ -1,14 +1,11 @@
-import * as THREE from 'three';
 import type { DomHostContext } from '../adapter/host-context';
-import type { MountedPixiRoot, MountedReactRoot, MountedRoot, MountedThreeRoot, RootAdapter } from '../adapter/root-adapter';
+import type { MountedPixiRoot, MountedReactRoot, MountedThreeRoot, RootAdapter } from '../adapter/root-adapter';
 import { type Game, type GameInternal, type RootInstance } from './game';
 import type { PlaytestContext } from './types';
 /**
  * Register a three world onto the Game shell. `opts.id` defaults to
- * `'main'` — the single-world callers (`createGameRuntime`, slice-1/2 tests)
- * are unaffected; a second/third world (T7.1 slice 3's two-world proof, and
- * real multi-world manifests later) pass an explicit id. This is the ONE
- * registration code path for a three world, whatever its id.
+ * `'main'`; multi-root callers pass an explicit id. This is the one
+ * registration path for a three world, whatever its id.
  */
 export declare function registerThreeRoot(game: GameInternal, adapter: RootAdapter, mounted: MountedThreeRoot, opts?: {
     id?: string | undefined;
@@ -26,13 +23,13 @@ export declare function registerPixiRoot(game: GameInternal, adapter: RootAdapte
     pausable?: boolean | undefined;
 }): RootInstance;
 /**
- * Register a react world onto the Game shell (T6.2 slice 1) — the react
+ * Register a React world onto the Game shell — the DOM
  * analog of {@link registerThreeRoot}/{@link registerPixiRoot}. A react
  * world has no `frame` hooks (react's own
  * `createRoot` schedules its commits; `GameInternal.runFrame` correctly
  * leaves a world with no `frame` untouched by its opaque-`update` fallback
  * too, since `MountedReactGame` declares no `update`). `adapter` is typed
- * as the real {@link ReactRootAdapter} shape (T7.5, same reasoning as
+ * as the real {@link ReactRootAdapter} shape (same reasoning as
  * `registerPixiRoot`'s doc comment above) — `RootInstance.adapter` only
  * needs `.id`, so this passes through with zero cast.
  */
@@ -41,12 +38,12 @@ export declare function registerReactRoot(game: GameInternal, adapter: RootAdapt
     pausable?: boolean | undefined;
 }): RootInstance;
 /**
- * One world to mount in the {@link RootsRuntimeConfig} roots path (T6.1
- * slice 1) — the host-facing mirror of `manifest/load.ts`'s
- * `ResolvedAdapterRoot` (same `id`/`zOrder`/`pausable`/`loop` fields; the
+ * One world to mount in the universal host — the host-facing mirror of
+ * `manifest/load.ts`'s `ResolvedAdapterRoot` (same identity and presentation
+ * fields; the
  * manifest-to-host translation itself is the editor's job, not this file's).
  *
- * `react` (T6.2 slice 1) mounts as a DOM-root layer `<div>` in the SAME
+ * A `dom` root mounts as a DOM layer `<div>` in the same
  * stack instead of a canvas — see {@link ReactRootMountSpec}/{@link
  * ReactRootAdapter} below.
  */
@@ -75,12 +72,6 @@ export interface RootMountSpecBase {
      * never sees DOM roots at all.
      */
     readonly dev?: boolean | undefined;
-    /** `'gated'` (host-driven, default) or `'self-driven'` (this world drives
-     *  its own loop — D5's "composited, unsynchronized" tier). Carried through
-     *  for parity with `ResolvedAdapterRoot`; T6.1 slice 1 does not yet
-     *  validate it against the mounted adapter's actual `drivesOwnLoop` (that
-     *  cross-check, if ever needed, is T7.6's loop-gate surface). */
-    readonly loop?: 'gated' | 'self-driven' | undefined;
     /**
      * Optional claim predicate for the delegating input router (D5 §2a), over
      * a point RELATIVE TO THE CONTAINER. Absent means: this world claims only
@@ -103,8 +94,8 @@ export interface PixiRootMountSpec extends RootMountSpecBase {
     readonly adapter: RootAdapter<'canvas'>;
 }
 /**
- * A live, mounted react world (T6.2 slice 1) — the react analog of a mounted
- * canvas world. React roots render from game state via the T7.4 bridge
+ * A live, mounted React world — the DOM analog of a mounted canvas world.
+ * React roots render from game state
  * instead of a per-frame `update`, so this shape carries no `update`/`fixedUpdate`/
  * `ctx`/`frame` — `drivesOwnLoop` is always `false` (react's `createRoot`
  * schedules its OWN commits; the host's fixed-step loop never drives it,
@@ -121,10 +112,10 @@ export interface PixiRootMountSpec extends RootMountSpecBase {
  * `kind: 'dom'` (§7.1-15): a react world has no `observe` BY DESIGN — that
  * hook is scoped to `useRootObservation` (the ingested/foreign-world case),
  * not `useWorldState` (`ui/game-state.tsx`), which a react world's own
- * mounted tree uses instead — it reads `Game.state` directly (T7.4's actual
- * bridge for first-party-observable state), never a per-world `observe`.
+ * mounted tree uses instead — it reads `Game.state` directly, never a
+ * per-world `observe`.
  *
- * `kind`/`container` (T7.5) satisfy `MountedReactRoot` (`adapter/
+ * `kind`/`container` satisfy `MountedReactRoot` (`adapter/
  * root-adapter.ts`) — `container` is the SAME `DomHostContext.container` the
  * adapter's `mount` was handed (identity matters, mirroring `threeScene()`/
  * `pixiStage()`'s "same instance the adapter mounted" contract); every
@@ -139,7 +130,7 @@ export interface MountedReactGame extends MountedReactRoot {
  * A react-shaped adapter — the structural contract `RootMountSpec`'s
  * `react` variant requires. Deliberately
  * NOT tied to a concrete implementer here so an editor-resolved adapter (the
- * `default-react` resolver branch, T6.2's editor-side follow-up) can satisfy
+ * `default-react` resolver branch) can satisfy
  * this shape without this file importing react-dom or any editor code.
  *
  * A genuine `RootAdapter<'dom'>` refinement (`HostContextFor<'dom'>` =
@@ -227,37 +218,23 @@ export interface RootsRuntimeConfig {
  *
  * This is the GENERIC host handle — it has no first-party concepts (no
  * `GameContext`, no `GameSetupFn`). First-party features (the live `GameContext`,
- * warm-restart hot reload) are reached by casting `mounted` to `MountedSetupThreeRoot`
+ * warm-restart hot reload) are reached through `game.defaultRoot.mounted`
+ * and narrowed to `MountedSetupThreeRoot`
  * (the editor does this for HMR/physics-sync — those are inherently first-party).
  *
- * `scene`/`camera`/`mounted` alias the Game's `defaultRoot`: it is the first
- * three root (else the first
- * world) by DECLARATION order, per `Game.defaultRoot`'s existing rule —
- * independent of `zOrder`/canvas stacking, which is a rendering-only concern.
+ * Root access is explicit through `game.roots`, `game.world(id)`, and
+ * `game.defaultRoot`; the session does not project a surface-specific alias.
  */
 export interface GameSession {
     stop(): void;
     pause(): void;
     resume(): void;
     step(): void;
-    /** Resize every world's render buffer. `pixelRatio` (W2c device preview)
-     *  optionally re-pins the three renderers' DPR in the same pass; omitted,
-     *  the mount-time ratio is left untouched (legacy behavior). */
+    /** Resize every world's render buffer. `pixelRatio` optionally re-pins the
+     * three renderers' DPR in the same pass. */
     resize(width: number, height: number, pixelRatio?: number): void;
-    readonly scene: THREE.Scene;
-    readonly camera: THREE.PerspectiveCamera;
-    /** The default world's mounted root, as the honest `MountedRoot` union —
-     *  narrow on `.kind` before reaching for a surface's own members (the same
-     *  discriminant `scene`/`camera` above use). This deliberately does NOT
-     *  claim `MountedThreeRoot`: a roots-path session whose default world is
-     *  canvas or dom returns that world's mount, and the old
-     *  `as MountedThreeRoot` cast made every such value a type-level lie. For a
-     *  first-party three mount, narrow to `'three'` and cast to
-     *  `MountedSetupThreeRoot` for the first-party extras. */
-    readonly mounted: MountedRoot;
-    /** The Game root (T6.1 slice 1) — the multi-world entry point
-     *  (`game.roots`/`game.world(id)`/`game.queryByComponent`) for callers
-     *  that need more than the default-world aliases above. */
+    /** The multi-root entry point. Root access stays explicit through
+     * `game.roots`, `game.world(id)`, and `game.defaultRoot`. */
     readonly game: Game;
 }
 /**

package/dist/runtime/create-runtime.d.ts.map

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

package/dist/runtime/create-runtime.js

@@ -14,12 +14,11 @@ import { installRenderControlHarness, isRenderModeRequested } from './render-con
  * by `createGameRuntime` and every headless test harness
  * (`test/game-root.test.ts`, `test/frame-order.test.ts`,
  * `test/game-two-roots.test.ts`) so there is exactly one code path for this
- * wiring (T7.1 slice 1, id-generalized in slice 3 for the two-world proof — stage
- * 3) — `physics`/`collisions`/`camera`/ `frame` are populated from the mount's
+ * wiring. `physics`/`collisions`/`camera`/`frame` are populated from the mount's
  * first-party `GameContext`/ `MountedSetupThreeRoot` when available, left
  * `undefined` otherwise (an external adapter's mount has none of these
  * first-party handles — `frame` in particular is what makes
- * `GameInternal.runFrame` (T7.1 slice 2) fall back to a single opaque
+ * `GameInternal.runFrame` fall back to a single opaque
  * `mounted.update` call per substep for such a world).
  */
 function firstPartyExtras(mounted) {
@@ -34,10 +33,8 @@ function firstPartyExtras(mounted) {
 }
 /**
  * Register a three world onto the Game shell. `opts.id` defaults to
- * `'main'` — the single-world callers (`createGameRuntime`, slice-1/2 tests)
- * are unaffected; a second/third world (T7.1 slice 3's two-world proof, and
- * real multi-world manifests later) pass an explicit id. This is the ONE
- * registration code path for a three world, whatever its id.
+ * `'main'`; multi-root callers pass an explicit id. This is the one
+ * registration path for a three world, whatever its id.
  */
 export function registerThreeRoot(game, adapter, mounted, opts) {
     const world = createRootInstance({
@@ -73,13 +70,13 @@ export function registerPixiRoot(game, adapter, mounted, opts) {
     return world;
 }
 /**
- * Register a react world onto the Game shell (T6.2 slice 1) — the react
+ * Register a React world onto the Game shell — the DOM
  * analog of {@link registerThreeRoot}/{@link registerPixiRoot}. A react
  * world has no `frame` hooks (react's own
  * `createRoot` schedules its commits; `GameInternal.runFrame` correctly
  * leaves a world with no `frame` untouched by its opaque-`update` fallback
  * too, since `MountedReactGame` declares no `update`). `adapter` is typed
- * as the real {@link ReactRootAdapter} shape (T7.5, same reasoning as
+ * as the real {@link ReactRootAdapter} shape (same reasoning as
  * `registerPixiRoot`'s doc comment above) — `RootInstance.adapter` only
  * needs `.id`, so this passes through with zero cast.
  */
@@ -106,7 +103,7 @@ export async function createGameRuntime(config) {
     return createRootsGameRuntime(config);
 }
 // ---------------------------------------------------------------------------
-// Worlds path (T6.1 slice 1)
+// Universal root host
 // ---------------------------------------------------------------------------
 /** A stand-in `THREE.WebGLRenderer` for headless (`headless:true`) three
  *  roots — mirrors `SetupThreeRootAdapter.mount`'s own `headlessComposer`
@@ -162,11 +159,8 @@ async function mountOneThreeRoot(spec, ctx) {
     // resize-staleness (the roots-path `resize()` below always calls
     // `setSize(rw, rh, false)`, so nothing else was ever going to update this
     // canvas' CSS after mount). `createHostRenderer`'s own default
-    // (`updateStyle:true`) is intentionally left alone — the LEGACY
-    // single-canvas path (editor play-mode's non-multi-world branch) still
-    // relies on that construction-time stamp + its own later `updateStyle:true`
-    // resizes for byte-identical behavior; this fix touches only the
-    // roots-path canvas, after the fact.
+    // (`updateStyle:true`) is intentionally left alone; the host owns CSS layout
+    // and reasserts the container-relative size after renderer construction.
     canvas.style.width = '100%';
     canvas.style.height = '100%';
     renderer.setPixelRatio(dpr);
@@ -239,7 +233,7 @@ async function mountOnePixiRoot(spec, ctx) {
     };
 }
 /**
- * Mount one react `RootMountSpec` (T6.2 slice 1) — the react sibling of
+ * Mount one React `RootMountSpec` — the DOM sibling of
  * `mountOneThreeRoot`/`mountOnePixiRoot`. Unlike its canvas-backed siblings
  * this returns NO `routerEntry`: a react world's DOM-root layer participates in
  * D5's z-order/box stacking (the caller still creates and positions its `<div>`
@@ -269,7 +263,7 @@ layer) {
     // An absolutely-positioned layer with no width/height collapses to zero
     // content size, so a child's
     // own position:absolute offsets resolve against a degenerate containing
-    // block (found by the T6.2 slice-3 e2e — clicks landed outside the game).
+    // block; otherwise clicks land outside the game.
     layer.style.width = '100%';
     layer.style.height = '100%';
     const reactHost = { container: layer, game };
@@ -289,8 +283,8 @@ layer) {
     };
 }
 /**
- * The roots-path implementer behind {@link createGameRuntime} (T6.1 slice
- * 1; react roots added T6.2 slice 1). Builds ONE surface per world — a
+ * The universal host implementer behind {@link createGameRuntime}. It builds
+ * one surface per world — a
  * canvas for three/canvas, a DOM-root `<div>` layer for react — stacked
  * per D5 §1, z-order/ties exactly matching
  * `manifest/load.ts`'s sort, ONE `Game`, and registers every world onto it
@@ -303,16 +297,11 @@ layer) {
  */
 /**
  * Dev/e2e-only `window.__vgaiScene`/`__vgaiCamera` exposure for the roots
- * path's DEFAULT world (E4) — split out of `createRootsGameRuntime` purely
- * to keep that function's own cyclomatic complexity down. Mirrors the
- * legacy single-world path's identical exposure (above, in this same file),
- * using the SAME "first three world, else none" default-world rule the
- * `GameSession.scene`/`.camera` getters alias (`Game.defaultRoot`): a
- * non-threejs default world (or none at all) publishes neither global,
- * exactly like those getters return `undefined` in that case. Returns a
- * retraction callback — identity-guarded (a newer session's globals must
- * never be clobbered by an older session's stop, same reason the legacy
- * path's own cleanup guards it) — that is a no-op when nothing was
+ * path's default world — split out of `createRootsGameRuntime` purely
+ * to keep that function's own cyclomatic complexity down. It uses the
+ * "first three world, else none" rule: a non-Three default world publishes
+ * neither global. Returns an identity-guarded retraction callback so an
+ * older session's stop cannot clobber a newer session's globals. It is a no-op when nothing was
  * published (non-DEV build, or non-threejs default world).
  */
 function installDefaultRootDevGlobals(game) {
@@ -451,8 +440,7 @@ async function createRootsGameRuntime(config) {
     // --- Surface stack (D5 §1): DOM/z-order follows zOrder, ties -> array order
     // — computed FIRST (bottom -> top) so both the z-index assignment below and
     // the router's default-claim rule share one definition. A react world's
-    // DOM-root layer shares this SAME stacking pass (T6.2 slice 1 — "one
-    // stacking model, no special case") even though it is a `<div>`, not a
+    // DOM-root layer shares this SAME stacking pass even though it is a `<div>`, not a
     // canvas, and carries no `hitTest` (the router never sees react entries at
     // all — see the dispatch loop below). ---
     // Dev layers sit TOPMOST, above every non-dev root, whatever zOrder either
@@ -509,7 +497,7 @@ async function createRootsGameRuntime(config) {
         // too (not just in `mountOneThreeRoot`) means every surface, whatever
         // kind, starts container-relative from its very first paint, before any
         // per-kind mount work has even run.
-        // `contain:layout paint` makes each surface the CONTAINING BLOCK for
+        // `contain:layout paint` makes each surface the containing block for
         // `position:fixed` descendants (and clips overflow to the world's
         // rectangle): full-screen game UI written the natural way (`fixed;
         // inset:0`) then fills the WORLD, not the page. Without it, `fixed` UI
@@ -579,17 +567,7 @@ async function createRootsGameRuntime(config) {
     const router = createInputRouter(container, routerEntries);
     started = true;
     loop.start();
-    // Expose scene & camera for dev tools / e2e tests — mirrors the legacy
-    // single-world path's identical dev-only exposure above, generalized to
-    // the roots path's DEFAULT world (E4): `mountGameFromManifest`/
-    // `mountManifestRoots` route every caller (including a
-    // single-threejs-world scaffold project) through THIS path, so a caller
-    // migrating off the legacy `{canvas, adapter}` call must not silently
-    // lose `window.__vgaiScene`/`__vgaiCamera` — real e2e/dev tooling
-    // depends on them
-    // (`packages/editor/e2e/tests/04-standalone-game.spec.ts`). Split into
-    // its own top-level helper (with its retraction counterpart below)
-    // purely to keep this function's own cyclomatic complexity down.
+    // Expose the default Three root's scene and camera for dev/e2e tooling.
     const retractDevGlobals = installDefaultRootDevGlobals(game);
     // G3/FT-11 — publish `window.__vgaiRender` for the deterministic capture
     // host. Installed at the TAIL of the mount (same position as
@@ -626,12 +604,7 @@ async function createRootsGameRuntime(config) {
     }
     return {
         stop: fullCleanup,
-        // D10/T7.6: `Game.play` fans out per-world pausable/loop-gate/audio-gate
-        // semantics itself now (see the legacy path's identical comment above) —
-        // a `pausable: false` world (a menu/HUD world) keeps ticking while every
-        // other world freezes, which the old blind `for (const entry of
-        // mountedEntries) entry.mounted.setPaused?.(true)` fan-out (with no
-        // `pausable` check at all) could never express.
+        // `Game.play` owns per-world pause, loop-gate, and audio-gate semantics.
         pause() {
             game.play.pause();
         },
@@ -655,24 +628,6 @@ async function createRootsGameRuntime(config) {
                 entry.mounted.resize?.(safeWidth, safeHeight);
             }
         },
-        // `GameSession.scene`/`.camera`/`.mounted` alias `Game.defaultRoot` (T6.1
-        // slice 1's "first three world, else first world" rule) — a legacy
-        // convenience shaped for the threejs-only past. T7.5 narrows the read via
-        // the `kind` discriminant instead of a blind `.scene`/`.camera` cast
-        // through a nonexistent property (identical behavior to before: still
-        // `undefined` for a roots-path session whose default world isn't
-        // three — real per-world surface routing for that case is T7.6's).
-        get scene() {
-            const m = game.defaultRoot.mounted;
-            return (m.kind === 'three' ? m.scene : undefined);
-        },
-        get camera() {
-            const m = game.defaultRoot.mounted;
-            return (m.kind === 'three' ? m.camera : undefined);
-        },
-        get mounted() {
-            return game.defaultRoot.mounted;
-        },
         game,
     };
 }