@vgai/engine 0.5.22 → 0.5.24

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

@@ -1,54 +1,55 @@
 import * as THREE from 'three';
 import { assertNever } from '../adapter/adapter-surface';
+import { createRootBinding } from '../adapter/binding';
 import { createAssetCache } from '../assets';
 import { createGameLoop } from '../core/game-loop';
 import { createHostRenderer } from '../setup/setup-renderer';
+import { getDebugRegistry } from './debug-registry';
 // TYPE-ONLY: `create-runtime.ts` must never value-import `pixi.js` — a canvas
 // `RootMountSpec`'s `adapter` is supplied ALREADY-CONSTRUCTED by the caller, so
 // the host only ever needs the seam's types.
-import { createGame, createRootInstance, isFirstPartyMounted, } from './game';
+import { createGame, createRootInstance, } from './game';
 import { createInputRouter, stackOrder } from './input-router';
 import { installRenderControlHarness, isRenderModeRequested } from './render-control';
-/**
- * Register a three world for a freshly-mounted game onto the Game shell. Shared
- * 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. `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` fall back to a single opaque
- * `mounted.update` call per substep for such a world).
- */
-function firstPartyExtras(mounted) {
-    if (!isFirstPartyMounted(mounted))
-        return {};
-    return {
-        physics: mounted.ctx.physics,
-        collisions: mounted.ctx.collisions,
-        camera: mounted.ctx.camera,
-        frame: mounted.frame,
-    };
-}
 /**
  * Register a three world onto the Game shell. `opts.id` defaults to
  * `'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 pausable = opts?.pausable ?? true;
     const world = createRootInstance({
         id: opts?.id ?? 'main',
         kind: 'three',
-        pausable: opts?.pausable ?? true,
+        pausable,
         adapter,
         mounted,
         scene: mounted.scene,
-        ...firstPartyExtras(mounted),
+        binding: bindRoot(game, opts?.declaration, {
+            surface: 'three',
+            adapter: adapter,
+        }, mounted, pausable),
     });
     game.registerRoot(world);
     return world;
 }
+/**
+ * Complete the root's binding at the first moment it CAN be completed: the
+ * declaration is what the resolver knew, `mounted`/`adapter`/`pausable` are
+ * what mounting produced, and the debug registry is the game's own. Nothing
+ * here loads or fabricates — see `createRootBinding`.
+ */
+function bindRoot(game, declaration, adapter, mounted, pausable) {
+    if (!declaration)
+        return null;
+    return createRootBinding({
+        ...declaration,
+        adapter,
+        mounted,
+        pausable,
+        debugRegistry: getDebugRegistry(game),
+    });
+}
 /**
  * Register a canvas world onto the Game shell — the pixi analog of
  * {@link registerThreeRoot}. `adapter` is the seam's own
@@ -58,13 +59,15 @@ export function registerThreeRoot(game, adapter, mounted, opts) {
  */
 export function registerPixiRoot(game, adapter, mounted, opts) {
     const id = opts?.id ?? 'main';
+    const pausable = opts?.pausable ?? true;
     const world = createRootInstance({
         id,
         kind: 'canvas',
-        pausable: opts?.pausable ?? true,
+        pausable,
         adapter,
         mounted,
         stage: mounted.stage,
+        binding: bindRoot(game, opts?.declaration, { surface: 'canvas', adapter }, mounted, pausable),
     });
     game.registerRoot(world);
     return world;
@@ -81,13 +84,15 @@ export function registerPixiRoot(game, adapter, mounted, opts) {
  * needs `.id`, so this passes through with zero cast.
  */
 export function registerReactRoot(game, adapter, mounted, container, opts) {
+    const pausable = opts?.pausable ?? true;
     const world = createRootInstance({
         id: opts?.id ?? 'main',
         kind: 'dom',
-        pausable: opts?.pausable ?? true,
+        pausable,
         adapter,
         mounted,
         container,
+        binding: bindRoot(game, opts?.declaration, { surface: 'dom', adapter }, mounted, pausable),
     });
     game.registerRoot(world);
     return world;
@@ -106,9 +111,8 @@ export async function createGameRuntime(config) {
 // Universal root host
 // ---------------------------------------------------------------------------
 /** A stand-in `THREE.WebGLRenderer` for headless (`headless:true`) three
- *  roots — mirrors `SetupThreeRootAdapter.mount`'s own `headlessComposer`
- *  pattern (`adapter/setup-three-root-adapter.ts`): a headless first-party
- *  mount never calls a render-phase method on `host.renderer` at all, so
+ *  roots: a headless mount never calls a render-phase method on
+ *  `host.renderer` at all, so
  *  this only needs to satisfy the handful of calls THIS file itself makes
  *  (`setPixelRatio`/`setClearColor`/`setSize` at mount, `dispose`/
  *  `forceContextLoss` at teardown) — never a real GL call. Node conformance
@@ -122,6 +126,46 @@ function createHeadlessRendererStub() {
         forceContextLoss() { },
     };
 }
+/**
+ * Reclaim ONE mounted root: its adapter, the renderer this file constructed for
+ * it (including the WebGL context — a browser keeps only a handful alive, so
+ * `dispose()` alone is not enough), and its stacked surface element.
+ *
+ * ONE body, TWO callers, deliberately: the session's `fullCleanup` (a normal
+ * stop) and `mountAllRootSpecs`'s partial-mount ROLLBACK (a later root's mount
+ * rejected, so the roots that already mounted must not survive the rejection).
+ * Those two must never drift — a rollback that reclaims less than a stop is how
+ * a failed play leaves a live renderer and a lost GL context behind with no
+ * handle anywhere able to reach it.
+ *
+ * Throws only what the adapter's own `dispose()` throws; every caller wraps it
+ * per entry so one bad root cannot abort the rest of the teardown.
+ */
+function disposeMountedRoot(entry, container) {
+    try {
+        entry.mounted.dispose();
+    }
+    finally {
+        // Renderer + surface release run even when the adapter's dispose threw:
+        // the GL context is the scarce resource, and the caller still sees the
+        // error (this rethrows through the `finally`).
+        entry.renderer?.dispose();
+        entry.renderer?.forceContextLoss();
+        // Remove from the element's CURRENT parent, not the mount-time
+        // `container`: the editor's Game panel re-parents the live surfaces
+        // when its mount element swaps (fill <-> device preset, W2c), and
+        // `container.removeChild` would throw NotFoundError after such a move.
+        // `container` remains the fallback for hosts whose element stand-ins
+        // never wire `parentNode` (headless unit fixtures); an element already
+        // detached by such a host is a no-op via the catch.
+        try {
+            (entry.element.parentNode ?? container).removeChild(entry.element);
+        }
+        catch {
+            /* already detached — nothing to remove */
+        }
+    }
+}
 /** Mount one three `RootMountSpec` (canvas + renderer construction, per
  *  D5 §1/§4, then `registerThreeRoot`). Split out of
  *  `createRootsGameRuntime` purely to keep that function's own branching
@@ -175,7 +219,11 @@ async function mountOneThreeRoot(spec, ctx) {
         game,
     };
     const mounted = await spec.adapter.mount(host);
-    registerThreeRoot(game, spec.adapter, mounted, { id: spec.id, pausable: spec.pausable });
+    registerThreeRoot(game, spec.adapter, mounted, {
+        id: spec.id,
+        pausable: spec.pausable,
+        declaration: spec.declaration,
+    });
     return {
         mountedEntry: { id: spec.id, kind: 'three', element: canvas, mounted, renderer },
         routerEntry: { id: spec.id, zOrder: spec.zOrder ?? 0, canvas, hitTest: spec.hitTest },
@@ -186,7 +234,7 @@ async function mountOneThreeRoot(spec, ctx) {
  *  `mountOneThreeRoot` above.
  *
  *  Unlike `mountOneThreeRoot`, this needs no explicit `canvas.style.width`/
- *  `.height` re-assertion (E4.R1). `pixi-surface.ts` constructs its
+ *  `.height` re-assertion. The canvas surface constructs its
  *  `Application` with `autoDensity: true`, which makes PIXI ITSELF re-stamp
  *  `canvas.style.width`/`.height` (real CSS px, matching the LOGICAL
  *  width/height passed to `resize()`) on every `app.renderer.resize()` call —
@@ -215,6 +263,7 @@ async function mountOnePixiRoot(spec, ctx) {
     registerPixiRoot(game, spec.adapter, mounted, {
         id: spec.id,
         pausable: spec.pausable,
+        declaration: spec.declaration,
     });
     return {
         mountedEntry: {
@@ -271,6 +320,7 @@ layer) {
     registerReactRoot(game, spec.adapter, mounted, layer, {
         id: spec.id,
         pausable: spec.pausable,
+        declaration: spec.declaration,
     });
     return {
         mountedEntry: {
@@ -289,8 +339,8 @@ layer) {
  * per D5 §1, z-order/ties exactly matching
  * `manifest/load.ts`'s sort, ONE `Game`, and registers every world onto it
  * via `registerThreeRoot`/`registerPixiRoot`/`registerReactRoot` — the
- * SAME wiring `test/game-three-plus-pixi.test.ts` proves by hand for the
- * three/pixi pair. Worlds MOUNT in `roots` ARRAY order ("manifest
+ * SAME wiring `test/create-runtime-worlds.test.ts` proves for the
+ * three/canvas pair. Worlds MOUNT in `roots` ARRAY order ("manifest
  * declaration order" — the frame/registration axis), independent of
  * `zOrder` (the canvas-stacking/rendering axis) — the two orders can differ
  * and both are honored correctly.
@@ -344,37 +394,60 @@ function installDefaultRootDevGlobals(game) {
  * comment).
  */
 async function mountAllRootSpecs(mountSpecs, bottomId, inputs) {
-    const { surfacesById, ...shared } = inputs;
+    const { surfacesById, container, ...shared } = inputs;
     const mountedEntries = [];
     const routerEntries = [];
-    for (const spec of mountSpecs) {
-        const isBottom = spec.id === bottomId;
-        if (spec.kind === 'dom') {
-            const layer = surfacesById.get(spec.id);
-            const { mountedEntry } = await mountOneReactRoot(spec, shared.game, layer);
+    try {
+        for (const spec of mountSpecs) {
+            const isBottom = spec.id === bottomId;
+            if (spec.kind === 'dom') {
+                const layer = surfacesById.get(spec.id);
+                const { mountedEntry } = await mountOneReactRoot(spec, shared.game, layer);
+                mountedEntries.push(mountedEntry);
+                continue;
+            }
+            const canvas = surfacesById.get(spec.id);
+            const oneCtx = { ...shared, canvas, isBottom };
+            let mountedEntry;
+            let routerEntry;
+            if (spec.kind === 'three') {
+                ({ mountedEntry, routerEntry } = await mountOneThreeRoot(spec, oneCtx));
+            }
+            else if (spec.kind === 'canvas') {
+                ({ mountedEntry, routerEntry } = await mountOnePixiRoot(spec, oneCtx));
+            }
+            else {
+                // Exhaustiveness guard (§7.4-2): 'react' was already handled by the
+                // early `continue` above, so only a hypothetical 4th `AdapterSurface` can
+                // reach here — fail loudly rather than silently defaulting. `spec`
+                // itself (not `spec.kind`) is what TS has narrowed to `never`, since
+                // `RootMountSpec` is a discriminated union at the object level.
+                assertNever(spec, 'create-runtime mount loop');
+            }
             mountedEntries.push(mountedEntry);
-            continue;
-        }
-        const canvas = surfacesById.get(spec.id);
-        const oneCtx = { ...shared, canvas, isBottom };
-        let mountedEntry;
-        let routerEntry;
-        if (spec.kind === 'three') {
-            ({ mountedEntry, routerEntry } = await mountOneThreeRoot(spec, oneCtx));
+            routerEntries.push(routerEntry);
         }
-        else if (spec.kind === 'canvas') {
-            ({ mountedEntry, routerEntry } = await mountOnePixiRoot(spec, oneCtx));
-        }
-        else {
-            // Exhaustiveness guard (§7.4-2): 'react' was already handled by the
-            // early `continue` above, so only a hypothetical 4th `AdapterSurface` can
-            // reach here — fail loudly rather than silently defaulting. `spec`
-            // itself (not `spec.kind`) is what TS has narrowed to `never`, since
-            // `RootMountSpec` is a discriminated union at the object level.
-            assertNever(spec, 'create-runtime mount loop');
+    }
+    catch (err) {
+        // PARTIAL MOUNT ROLLBACK. Roots mount sequentially, so a rejection from
+        // root N leaves roots 1..N-1 fully live — renderer, WebGL context, R3F
+        // tree, adapter registrations — and NOTHING ever gets a handle to them:
+        // this function throws instead of returning, so no `GameSession` (and
+        // therefore no `stop()`) is ever constructed. Reclaim them here, in
+        // REVERSE mount order (the inverse of the order they were built in), then
+        // rethrow the ORIGINAL error — the mount failure is what the caller must
+        // see, never a teardown error raised while cleaning up after it.
+        for (let i = mountedEntries.length - 1; i >= 0; i--) {
+            const entry = mountedEntries[i];
+            try {
+                disposeMountedRoot(entry, container);
+            }
+            catch (disposeErr) {
+                // biome-ignore lint/suspicious/noConsole: a rollback failure must be visible; the original mount error is still what we rethrow
+                console.error(`createGameRuntime: rolling back root "${entry.id}" after a mount failure threw:`, disposeErr);
+            }
         }
-        mountedEntries.push(mountedEntry);
-        routerEntries.push(routerEntry);
+        throw err;
     }
     return { mountedEntries, routerEntries };
 }
@@ -424,6 +497,34 @@ function installSessionRenderHarness(game, location, targetOverride) {
         delete target['__vgaiRender'];
     };
 }
+/**
+ * Reclaim what `createRootsGameRuntime` built for ITSELF when the mount
+ * rejects. `mountAllRootSpecs` has already rolled back every root that DID
+ * mount, so what is left is the Game shell (holding whatever registrations
+ * those roots made into it) and the stacked surface elements of the roots that
+ * never got to mount. Neither is reachable afterwards: the mount throws instead
+ * of returning, so no `GameSession` — and therefore no `stop()` — ever exists.
+ *
+ * Never throws: the MOUNT error is what the caller must see, so a failure while
+ * cleaning up after it is reported and swallowed.
+ */
+function reclaimAfterMountFailure(game, surfaces, container) {
+    try {
+        game.dispose();
+    }
+    catch (disposeErr) {
+        // biome-ignore lint/suspicious/noConsole: a failed rollback must be visible; the original mount error is what the caller gets
+        console.error('createGameRuntime: disposing the game after a mount failure threw:', disposeErr);
+    }
+    for (const surface of surfaces) {
+        try {
+            (surface.parentNode ?? container).removeChild(surface);
+        }
+        catch {
+            /* already detached by the per-root rollback */
+        }
+    }
+}
 async function createRootsGameRuntime(config) {
     const { container, roots: specs, width, height, headless = false, seed, playtest } = config;
     if (specs.length === 0) {
@@ -514,14 +615,14 @@ async function createRootsGameRuntime(config) {
         // host's explicit `simulateSubsteps`/`renderOnce` calls — wall-clock time
         // passing while a screenshot is taken must not move the world.
         externalDrive: renderMode,
-        // WO-P13 — sim and presentation are wired to different callbacks here:
+        // Sim and presentation are wired to different callbacks here:
         // `update` runs the gameplay phases once per consumed fixed substep with
         // `preRender`/`render` withheld, and `render` runs those two once per real
         // display frame with the interpolation alpha. Both closures are invoked
         // only from the loop's own rAF arm, which `externalDrive` never arms — so
         // a capture/offline-export page (`renderMode`) reaches neither, and its
         // `simulateSubsteps` → `game.runFrame(fixedDt)` path stays frame-exact,
-        // rendering inside the substep exactly as it did before this flip.
+        // rendering inside the substep.
         update: (dt) => {
             if (started)
                 game.runFrame(dt, { skipRenderPhases: true });
@@ -537,16 +638,25 @@ async function createRootsGameRuntime(config) {
     // `createRootsGameRuntime`'s own cyclomatic complexity down (E4) — same
     // reason `mountOneThreeRoot`/`mountOnePixiRoot` are already split out
     // below.
-    const { mountedEntries, routerEntries } = await mountAllRootSpecs(mountSpecs, bottomId, {
-        game,
-        surfacesById,
-        w,
-        h,
-        dpr,
-        headless,
-        assets,
-        antialias: config.antialias,
-    });
+    let mounted;
+    try {
+        mounted = await mountAllRootSpecs(mountSpecs, bottomId, {
+            game,
+            surfacesById,
+            container,
+            w,
+            h,
+            dpr,
+            headless,
+            assets,
+            antialias: config.antialias,
+        });
+    }
+    catch (err) {
+        reclaimAfterMountFailure(game, surfacesById.values(), container);
+        throw err;
+    }
+    const { mountedEntries, routerEntries } = mounted;
     // --- Delegating input router (D5 §2a) ---
     const router = createInputRouter(container, routerEntries);
     started = true;
@@ -566,38 +676,53 @@ async function createRootsGameRuntime(config) {
         resolveStopComplete = resolve;
     });
     let stopping = false;
+    /**
+     * Reclaim EVERYTHING this session owns, and let no single failure stop that.
+     *
+     * Teardown used to be one `try` over the whole body, so a throwing
+     * `entry.mounted.dispose()` on root 1 skipped root 2's disposal, both
+     * renderers' `forceContextLoss`, `game.dispose()` and the two global
+     * retractions — while `stopComplete` still resolved and the editor still
+     * reported the instance reclaimed. Every step is now isolated: a failure is
+     * COLLECTED and reported, never allowed to abort the steps after it.
+     */
     function fullCleanup() {
         if (stopping)
             return;
         stopping = true;
+        const failures = [];
+        /** Run one teardown step; record its failure and keep going. */
+        const step = (name, run) => {
+            try {
+                run();
+            }
+            catch (error) {
+                failures.push({ step: name, error });
+            }
+        };
         try {
-            loop.stop();
-            router.dispose();
+            step('loop.stop', () => loop.stop());
+            step('router.dispose', () => router.dispose());
             for (const entry of mountedEntries) {
-                entry.mounted.dispose();
-                entry.renderer?.dispose();
-                entry.renderer?.forceContextLoss();
-                // Remove from the element's CURRENT parent, not the mount-time
-                // `container`: the editor's Game panel re-parents the live surfaces
-                // when its mount element swaps (fill <-> device preset, W2c), and
-                // `container.removeChild` would throw NotFoundError after such a move.
-                // `container` remains the fallback for hosts whose element stand-ins
-                // never wire `parentNode` (headless unit fixtures); an element already
-                // detached by such a host is a no-op via the catch.
-                try {
-                    (entry.element.parentNode ?? container).removeChild(entry.element);
-                }
-                catch {
-                    /* already detached — nothing to remove */
-                }
+                step(`root "${entry.id}"`, () => disposeMountedRoot(entry, container));
             }
-            game.dispose();
-            retractDevGlobals();
-            retractRenderHarness?.();
+            step('game.dispose', () => game.dispose());
+            step('dev globals', () => retractDevGlobals());
+            step('render harness', () => retractRenderHarness?.());
         }
         finally {
             void Promise.allSettled(mountedEntries.map((entry) => entry.mounted.disposeComplete ?? Promise.resolve())).then(() => resolveStopComplete());
         }
+        if (failures.length > 0) {
+            // LOUD, and after everything else has been reclaimed. `stop()` is called
+            // from hosts that must not be left half-torn-down by an early throw, so
+            // the report comes last — but it IS a report: a silent partial teardown
+            // is the failure this whole restructure exists to end. The editor's
+            // `exitPlayMode` catches it and prints it to the editor console.
+            throw new AggregateError(failures.map((f) => f.error), `Game session teardown failed in ${failures.length} step(s): ${failures
+                .map((f) => f.step)
+                .join(', ')}. Every other step still ran.`);
+        }
     }
     return {
         stop: fullCleanup,

package/dist/runtime/debug-bridge.d.ts

@@ -152,6 +152,18 @@ export interface VgaiDebugHandle {
      * silent no-op.
      */
     runTicks(n: number, opts?: RunTicksOptions): void;
+    /**
+     * The SETTLED-AWARE variant of {@link runTicks} (`runtime/run-ticks-settled.ts` — one
+     * implementation with the editor relay's `run-ticks` case, D17): drives the budget one tick
+     * at a time and, before each tick, waits for every registered world-settled probe
+     * (`DebugRegistry.registerWorldSettledProbe`, declared by the game's `debug.settled` entry
+     * export) — so a tick never races a scene remount's async commit, and WHICH tick first runs
+     * a freshly reloaded world is a function of the sim rather than wall timing. Session tick
+     * drivers (`@vgai/live`'s fastForward) prefer this door; with no probe registered it behaves
+     * exactly like {@link runTicks}. Bounded: throws `WORLD_UNSETTLED_TIMEOUT` if a probe never
+     * settles.
+     */
+    runTicksSettled(n: number, opts?: RunTicksOptions): Promise<void>;
     /**
      * Collapses `input.setVirtualAction(action, true)` → wait `simSeconds` of
      * REAL sim time (real ticks — deliberately NOT `runTicks`/fast-forward;

package/dist/runtime/debug-bridge.d.ts.map

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

package/dist/runtime/debug-bridge.js

@@ -15,6 +15,7 @@
  * field whose runtime reader THIS module is).
  */
 import { DebugError } from './debug-registry';
+import { runTicksWhenSettled } from './run-ticks-settled';
 /** Query-param name that opts a standalone page into the debug bridge (D18) —
  *  mirrors `render-seed.ts`'s `RENDER_MODE_QUERY_PARAM` naming/shape, own
  *  const because this is a different call site with a different flag. */
@@ -216,6 +217,9 @@ function buildDebugHandle(opts) {
             }
             target.runTicks(n, runTicksOpts);
         },
+        runTicksSettled(n, runTicksOpts) {
+            return runTicksWhenSettled(registry, n, runTicksOpts);
+        },
         async holdFor(action, simSeconds, worldId) {
             const target = requireInputTarget('holdFor', worldId);
             const setResult = target.setVirtualAction(action, true);