@vgai/engine 0.5.21 → 0.5.23

package/dist/defaults.js

@@ -1,20 +1,12 @@
 /**
  * Single source of truth for default values the engine's factories read.
  *
- * WO-8 deleted SEVEN groups — `transform`, `entity`, `audio`, `shadow`,
- * `animation`, `fog`, `environment` — because every one of their readers was a
- * `.vscn.json` consumer (`entity-factory.ts`, `scene-loader.ts`,
- * `scene-sync.ts`, `scene-serializer.ts`, the per-section inspectors) and
- * `defaults-source-scan.test.ts` reported them with ZERO `DEFAULTS.<group>`
- * readers anywhere in engine/editor src or tests. That guard offers two remedies
- * — wire the group to the factory that reads it, or delete it if truly unused —
- * and there is no surviving factory to wire these to: `transform` restated
- * THREE's own Object3D constructor values, `entity.locked`/ `pivot` were
- * descriptor-only fields, and `fog`/`environment.envMapIntensity`/ `shadow` were
- * the `.vscn` `environment` block that `render-env.ts` explicitly did NOT carry
- * forward. Keeping them would have been exactly the dead documentation T1.13
- * created this guard to prevent.
- *
+ * A group belongs here only while a FACTORY reads it. A default with no
+ * reader is dead documentation: it looks authoritative, nothing consults it,
+ * and it drifts from the value the code actually uses. Restating a library's
+ * own constructor values (THREE's `Object3D` transform, say) is the same
+ * mistake in a different shape — the library is already the source of truth.
+ * So when a factory goes, its group goes with it.
  */
 export const DEFAULTS = {
     material: {

package/dist/dev/instruments.d.ts

@@ -25,13 +25,13 @@
  * game registry.
  *
  * ── THE DOOR ────────────────────────────────────────────────────────────────
- * This module is IMPLEMENTATION ONLY. It publishes nothing itself: the dev-tools
- * capability's own registry adopts this list (`installDevToolsInstruments`) and
- * publishes each instrument through the SAME door every declaration in that
- * capability uses — one provider per reading (`instrument.timescale`), one
- * command per action (`instrument.timescale.set`), plus the `dev-tools` index
- * provider. That is deliberate and load-bearing: the registry IS the product,
- * so every reader of an instrument reaches the SAME registration.
+ * The HOST publishes these itself ({@link publishDevInstruments}, called by
+ * the mount install paths): one provider per reading
+ * (`instrument.timescale`), one command per action
+ * (`instrument.timescale.set`), plus the `instruments` index provider. The
+ * registry IS the product, so every reader of an instrument reaches the SAME
+ * registration — and a game writes zero lines and mounts nothing to have
+ * them.
  *
  * ── DEGRADING ───────────────────────────────────────────────────────────────
  * An instrument whose subject this game does not have (no physics adapter ⇒ no
@@ -42,10 +42,10 @@
  *
  * ── RESOURCE OWNERSHIP, STATED ONCE ─────────────────────────────────────────
  * {@link createDevInstruments} owns everything it allocates: the frame-time
- * ring buffer and its ONE `game.onRenderStep` subscription. SHARER: the
- * dev-tools capability's `DevToolsBridge`, which creates one set per mounted
- * game. TEARDOWN: the returned {@link DevInstrumentSet.dispose} — the ONE path
- * that ends it. Nothing else here holds a resource; the time-scale, pause and
+ * ring buffer and its ONE `game.onRenderStep` subscription. SHARER: the host
+ * install path ({@link publishDevInstruments}), which creates one set per
+ * mounted game. TEARDOWN: the returned {@link DevInstrumentSet.dispose} — the
+ * ONE path that ends it. Nothing else here holds a resource; the time-scale, pause and
  * collider instruments only drive state that `Game` already owns.
  */
 import { z } from 'zod';
@@ -130,4 +130,31 @@ export declare function summarizeFrameTimes(samples: readonly number[]): FrameTi
  * caller owns the returned {@link DevInstrumentSet.dispose}.
  */
 export declare function createDevInstruments(game: Game): DevInstrumentSet;
+/** The index provider's name. */
+export declare const INSTRUMENTS_PROVIDER = "instruments";
+/** One instrument in the index: descriptor plus this instant's value. A
+ *  throwing read is reported as itself, never swallowed. */
+export interface PublishedInstrumentReading {
+    readonly name: string;
+    readonly id: string;
+    readonly label: string;
+    readonly hint: string;
+    readonly unit?: string;
+    readonly control: DevInstrumentControl;
+    readonly actions: readonly {
+        readonly name: string;
+        readonly id: string;
+        readonly label: string;
+        readonly hint: string;
+    }[];
+    readonly value: unknown;
+    readonly error?: string;
+}
+/**
+ * Create this game's instrument set and register every door on its debug
+ * registry. Called once per mounted Game by the host install path; the
+ * returned disposer ends the set's one resource (the frame-time
+ * subscription) — the registrations die with the Game itself.
+ */
+export declare function publishDevInstruments(game: Game): () => void;
 //# sourceMappingURL=instruments.d.ts.map

package/dist/dev/instruments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instruments.d.ts","sourceRoot":"","sources":["../../src/dev/instruments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;sCAEsC;AACtC,MAAM,MAAM,oBAAoB;AAC9B,oBAAoB;AAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE;AAC9B,0CAA0C;GACxC;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACtD,6EAA6E;GAC3E;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AACH,sEAAsE;GACpE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9B;;;kBAGkB;AAClB,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC;IAC1B,GAAG,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,0EAA0E;IAC1E,IAAI,IAAI,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,aAAa,EAAE,CAAC;IAC/C,4DAA4D;IAC5D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;mCAEmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,CAehF;AAcD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB,CA2IjE"}
+{"version":3,"file":"instruments.d.ts","sourceRoot":"","sources":["../../src/dev/instruments.ts"],"names":[],"mappings":"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"}

package/dist/dev/instruments.js

@@ -25,13 +25,13 @@
  * game registry.
  *
  * ── THE DOOR ────────────────────────────────────────────────────────────────
- * This module is IMPLEMENTATION ONLY. It publishes nothing itself: the dev-tools
- * capability's own registry adopts this list (`installDevToolsInstruments`) and
- * publishes each instrument through the SAME door every declaration in that
- * capability uses — one provider per reading (`instrument.timescale`), one
- * command per action (`instrument.timescale.set`), plus the `dev-tools` index
- * provider. That is deliberate and load-bearing: the registry IS the product,
- * so every reader of an instrument reaches the SAME registration.
+ * The HOST publishes these itself ({@link publishDevInstruments}, called by
+ * the mount install paths): one provider per reading
+ * (`instrument.timescale`), one command per action
+ * (`instrument.timescale.set`), plus the `instruments` index provider. The
+ * registry IS the product, so every reader of an instrument reaches the SAME
+ * registration — and a game writes zero lines and mounts nothing to have
+ * them.
  *
  * ── DEGRADING ───────────────────────────────────────────────────────────────
  * An instrument whose subject this game does not have (no physics adapter ⇒ no
@@ -42,15 +42,16 @@
  *
  * ── RESOURCE OWNERSHIP, STATED ONCE ─────────────────────────────────────────
  * {@link createDevInstruments} owns everything it allocates: the frame-time
- * ring buffer and its ONE `game.onRenderStep` subscription. SHARER: the
- * dev-tools capability's `DevToolsBridge`, which creates one set per mounted
- * game. TEARDOWN: the returned {@link DevInstrumentSet.dispose} — the ONE path
- * that ends it. Nothing else here holds a resource; the time-scale, pause and
+ * ring buffer and its ONE `game.onRenderStep` subscription. SHARER: the host
+ * install path ({@link publishDevInstruments}), which creates one set per
+ * mounted game. TEARDOWN: the returned {@link DevInstrumentSet.dispose} — the
+ * ONE path that ends it. Nothing else here holds a resource; the time-scale, pause and
  * collider instruments only drive state that `Game` already owns.
  */
 import { z } from 'zod';
 import { nodeKeyedPhysics } from '../adapter/system-adapter';
 import { clampTimeScale, TIME_SCALE_RANGE } from '../core/frame-pacing';
+import { getDebugRegistry } from '../runtime/debug-registry';
 /**
  * How many display frames the frame-time reading keeps. ~1 second at 60 Hz —
  * long enough that a hitch is still in the window when you look, short enough
@@ -233,3 +234,72 @@ export function createDevInstruments(game) {
 function now() {
     return typeof performance === 'undefined' ? Date.now() : performance.now();
 }
+// ---------------------------------------------------------------------------
+// Host publication — the instruments' OWN door
+// ---------------------------------------------------------------------------
+//
+// The HOST publishes these (the editor's mount install path), so every game
+// gets them for literally zero lines — no capability, no bridge component, no
+// mount. One provider per reading (`instrument.timescale`), one command per
+// action (`instrument.timescale.set`), plus ONE index provider
+// (`instruments`) carrying every descriptor with this instant's values, so an
+// outside reader gets the whole panel in one round trip. Naming is unchanged
+// from when the dev-tools capability published them, so every existing reader
+// keeps working; only the publisher moved realms.
+/** The index provider's name. */
+export const INSTRUMENTS_PROVIDER = 'instruments';
+/** The registry scope the host publishes under. Not a mounted world —
+ *  instruments are game-scoped host furniture, like the hooks' `__react__`. */
+const INSTRUMENTS_WORLD_ID = '__instruments__';
+function readingOf(instrument) {
+    const base = {
+        name: `instrument.${instrument.id}`,
+        id: instrument.id,
+        label: instrument.label,
+        hint: instrument.hint,
+        ...(instrument.unit === undefined ? {} : { unit: instrument.unit }),
+        control: instrument.control,
+        actions: instrument.actions.map((action) => ({
+            name: `instrument.${instrument.id}.${action.id}`,
+            id: action.id,
+            label: action.label,
+            hint: action.hint,
+        })),
+    };
+    try {
+        return { ...base, value: instrument.read() };
+    }
+    catch (error) {
+        return { ...base, value: null, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+/**
+ * Create this game's instrument set and register every door on its debug
+ * registry. Called once per mounted Game by the host install path; the
+ * returned disposer ends the set's one resource (the frame-time
+ * subscription) — the registrations die with the Game itself.
+ */
+export function publishDevInstruments(game) {
+    const registry = getDebugRegistry(game);
+    if (!registry) {
+        throw new Error('Cannot publish dev instruments: mounted Game has no debug registry.');
+    }
+    const set = createDevInstruments(game);
+    const scope = registry.forRoot(INSTRUMENTS_WORLD_ID);
+    for (const instrument of set.instruments) {
+        scope.registerStateProvider(`instrument.${instrument.id}`, () => instrument.read(), {
+            tier: 'assisted',
+        });
+        for (const action of instrument.actions) {
+            scope.registerCommand(`instrument.${instrument.id}.${action.id}`, {
+                description: `${instrument.label}: ${action.label} — ${action.hint}`,
+                locus: 'client',
+                args: action.args,
+            }, (...values) => action.run(values));
+        }
+    }
+    scope.registerStateProvider(INSTRUMENTS_PROVIDER, () => set.instruments.map(readingOf), {
+        tier: 'assisted',
+    });
+    return () => set.dispose();
+}

package/dist/dev/register-render-vitals.d.ts

@@ -8,10 +8,7 @@
  *
  * Engine-owned and first-party, seeded by BOTH three-root mount paths — a game
  * writes nothing to get these, and there is no capability to install:
- *  - `adapter/setup-three-root-adapter.ts` (the classic imperative
- *    `setup(ctx)` world), at the same spot it seeds
- *    `systemAdapters.renderDebug`;
- *  - `world3d-react/r3f-adapter.tsx` (a TSX/R3F world — the shape EVERY
+ *  - `world3d-react/r3f-root-factory.tsx` (a TSX/R3F world — the shape EVERY
  *    scaffolded project's three root has), right after fiber's first commit
  *    resolves the scene.
  * Both is the whole point and not redundancy: they are two independent mounts

package/dist/dev/register-render-vitals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-render-vitals.d.ts","sourceRoot":"","sources":["../../src/dev/register-render-vitals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAOxE,wEAAwE;AACxE,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AACtD,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AACrD,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AACzD,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AACrD,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAE/C;0EAC0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACpE,aAAa,IAAI,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1E;AAED,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,kEAAkE;IAClE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC;uEACmE;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC;IAC/B;uCACmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAChD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,wBAAwB,GAC7B,wBAAwB,GAAG,IAAI,CA8JjC"}
+{"version":3,"file":"register-render-vitals.d.ts","sourceRoot":"","sources":["../../src/dev/register-render-vitals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAOxE,wEAAwE;AACxE,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AACtD,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AACrD,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AACzD,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AACrD,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAE/C;0EAC0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACpE,aAAa,IAAI,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1E;AAED,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,kEAAkE;IAClE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC;uEACmE;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC;IAC/B;uCACmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAChD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,wBAAwB,GAC7B,wBAAwB,GAAG,IAAI,CA8JjC"}

package/dist/dev/register-render-vitals.js

@@ -8,10 +8,7 @@
  *
  * Engine-owned and first-party, seeded by BOTH three-root mount paths — a game
  * writes nothing to get these, and there is no capability to install:
- *  - `adapter/setup-three-root-adapter.ts` (the classic imperative
- *    `setup(ctx)` world), at the same spot it seeds
- *    `systemAdapters.renderDebug`;
- *  - `world3d-react/r3f-adapter.tsx` (a TSX/R3F world — the shape EVERY
+ *  - `world3d-react/r3f-root-factory.tsx` (a TSX/R3F world — the shape EVERY
  *    scaffolded project's three root has), right after fiber's first commit
  *    resolves the scene.
  * Both is the whole point and not redundancy: they are two independent mounts

package/dist/dev/render-debug-adapter.d.ts

@@ -3,11 +3,10 @@
  * the WebGL2 frame capture (`webgl-frame-capture.ts`), a live three.js scene,
  * and the render adapter's per-frame render pass.
  *
- * Split OUT of `setup-three-root-adapter.ts` so the capture/attribution/restore
+ * Split OUT of `world3d-react/r3f-root-factory.tsx` so the capture/attribution/restore
  * flow is unit-testable in a headless Node test with a mock GL context and a
  * plain scene — a real non-headless GPU mount (EffectComposer + WebGLRenderer)
- * cannot run under vitest here, the same reason the adapter suite drives
- * `setup(ctx)` only through hotReload on a data scene. `mount()` owns the
+ * cannot run under vitest here. `mount()` owns the
  * DECISION to construct this (only under a real WebGL2 context, never
  * headless — see `frameCaptureContextFor`); this module owns the BEHAVIOR.
  *

package/dist/dev/render-debug-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-debug-adapter.d.ts","sourceRoot":"","sources":["../../src/dev/render-debug-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAgC,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE7F;;;2DAG2D;AAC3D,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,OAAO,EACjB,eAAe,EAAE,OAAO,GACvB,sBAAsB,GAAG,IAAI,CAO/B;AAED,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,OAAO,EAAE,iBAAiB,CAAC;IAC3B;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC;IACvB;gFAC4E;IAC5E,MAAM,CAAC,EAAE,MAAM,oBAAoB,CAAC;IACpC;yDACqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;0BACsB;IACtB,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACvD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,+DAA+D;IAC/D,YAAY,IAAI,IAAI,CAAC;IACrB,6EAA6E;IAC7E,WAAW,IAAI,IAAI,CAAC;IACpB,6EAA6E;IAC7E,OAAO,IAAI,IAAI,CAAC;CACjB;AAkDD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,sBAAsB,GAAG,iBAAiB,CAmFxF"}
+{"version":3,"file":"render-debug-adapter.d.ts","sourceRoot":"","sources":["../../src/dev/render-debug-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAgC,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE7F;;;2DAG2D;AAC3D,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,OAAO,EACjB,eAAe,EAAE,OAAO,GACvB,sBAAsB,GAAG,IAAI,CAO/B;AAED,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,OAAO,EAAE,iBAAiB,CAAC;IAC3B;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC;IACvB;gFAC4E;IAC5E,MAAM,CAAC,EAAE,MAAM,oBAAoB,CAAC;IACpC;yDACqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;0BACsB;IACtB,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACvD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,+DAA+D;IAC/D,YAAY,IAAI,IAAI,CAAC;IACrB,6EAA6E;IAC7E,WAAW,IAAI,IAAI,CAAC;IACpB,6EAA6E;IAC7E,OAAO,IAAI,IAAI,CAAC;CACjB;AAkDD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,sBAAsB,GAAG,iBAAiB,CAmFxF"}

package/dist/dev/render-debug-adapter.js

@@ -3,11 +3,10 @@
  * the WebGL2 frame capture (`webgl-frame-capture.ts`), a live three.js scene,
  * and the render adapter's per-frame render pass.
  *
- * Split OUT of `setup-three-root-adapter.ts` so the capture/attribution/restore
+ * Split OUT of `world3d-react/r3f-root-factory.tsx` so the capture/attribution/restore
  * flow is unit-testable in a headless Node test with a mock GL context and a
  * plain scene — a real non-headless GPU mount (EffectComposer + WebGLRenderer)
- * cannot run under vitest here, the same reason the adapter suite drives
- * `setup(ctx)` only through hotReload on a data scene. `mount()` owns the
+ * cannot run under vitest here. `mount()` owns the
  * DECISION to construct this (only under a real WebGL2 context, never
  * headless — see `frameCaptureContextFor`); this module owns the BEHAVIOR.
  *

package/dist/dev/render-vitals.d.ts

@@ -43,14 +43,14 @@
  * OWNER: the caller of {@link createRenderVitals}, which allocates one state
  * object and one `profiler.subscribe` registration. SHARER: none — the state
  * is private to that call. TEARDOWN: the returned `dispose()`, the ONE path
- * that ends the subscription (`setup-three-root-adapter.ts` calls it from
- * `disposeGame`).
+ * that ends the subscription (`world3d-react/r3f-root-factory.tsx` calls it
+ * from the mounted root's own `dispose()`).
  */
 import type { PerformanceFrame, PerformanceProfiler } from './performance-profiler';
 /**
  * The profiler phase name the three adapter brackets its CPU render
  * submission with — spelled HERE and nowhere else, so the producer
- * (`setup-three-root-adapter.ts`) and the consumer ({@link foldProfilerFrame})
+ * (`world3d-react/r3f-root-factory.tsx`) and the consumer ({@link foldProfilerFrame})
  * cannot drift apart. Dotted, so it reads as a decomposition of the enclosing
  * `render` phase rather than a ninth peer of `SystemPhase`.
  */

package/dist/dev/render-vitals.js

@@ -43,13 +43,13 @@
  * OWNER: the caller of {@link createRenderVitals}, which allocates one state
  * object and one `profiler.subscribe` registration. SHARER: none — the state
  * is private to that call. TEARDOWN: the returned `dispose()`, the ONE path
- * that ends the subscription (`setup-three-root-adapter.ts` calls it from
- * `disposeGame`).
+ * that ends the subscription (`world3d-react/r3f-root-factory.tsx` calls it
+ * from the mounted root's own `dispose()`).
  */
 /**
  * The profiler phase name the three adapter brackets its CPU render
  * submission with — spelled HERE and nowhere else, so the producer
- * (`setup-three-root-adapter.ts`) and the consumer ({@link foldProfilerFrame})
+ * (`world3d-react/r3f-root-factory.tsx`) and the consumer ({@link foldProfilerFrame})
  * cannot drift apart. Dotted, so it reads as a decomposition of the enclosing
  * `render` phase rather than a ninth peer of `SystemPhase`.
  */

package/dist/dev/webgl-frame-capture.d.ts

@@ -4,7 +4,7 @@
  * WHY FIRST-PARTY, NOT spectorjs (recorded per the "use libraries directly, no
  * wrappers" rule): the capture seam we need is the WebGL2 context this engine
  * ALREADY owns end-to-end (`renderer.getContext()` in
- * `setup-three-root-adapter.ts`). spectorjs is absent from node_modules, and its
+ * `world3d-react/r3f-root-factory.tsx`). spectorjs is absent from node_modules, and its
  * actual value is a bundled inspector UI we would discard — adopting it imports
  * ~2MB of library to keep ~10% of it, and it wraps the context with its own
  * global patching model rather than the instance-shadow-and-restore discipline

package/dist/dev/webgl-frame-capture.js

@@ -4,7 +4,7 @@
  * WHY FIRST-PARTY, NOT spectorjs (recorded per the "use libraries directly, no
  * wrappers" rule): the capture seam we need is the WebGL2 context this engine
  * ALREADY owns end-to-end (`renderer.getContext()` in
- * `setup-three-root-adapter.ts`). spectorjs is absent from node_modules, and its
+ * `world3d-react/r3f-root-factory.tsx`). spectorjs is absent from node_modules, and its
  * actual value is a bundled inspector UI we would discard — adopting it imports
  * ~2MB of library to keep ~10% of it, and it wraps the context with its own
  * global patching model rather than the instance-shadow-and-restore discipline

package/dist/index.d.ts

@@ -10,25 +10,22 @@
  * remain the primary way to reach engine internals — reach for a subpath
  * first. This barrel exists only so the package's bare-name entry point is
  * HONEST (resolves to something real and useful) instead of dangling; it
- * covers just the handful of symbols a game/consumer needs to author a
- * first-party `setup()` and mount it, plus the scene/manifest file
+ * covers just the handful of symbols a consumer needs to mount a game
+ * from its manifest, plus the manifest file
  * entry points. Keep it small when extending it — prefer a new subpath
  * export over growing this file into a firehose.
  *
  * Groups (import order below is alphabetical-by-specifier, per the repo's
  * biome `organizeImports` rule, not by group — see this list instead):
- *   - game setup contract: `GameContext`/`GameCleanup`/`GameSetupFn`, `fromSetup`
  *   - surface vocabulary: `AdapterSurface`
  *   - manifest-driven mount: `mountManifestRoots` + its option/result types
  *   - game manifest (vgai.project.json) entry point: `loadGameManifest`
  */
 export type { AdapterSurface } from './adapter/adapter-surface';
-export { fromSetup } from './adapter/setup-three-root-adapter';
 export { AssetParseError } from './asset-parse-error';
 export type { AdapterRoot, GameManifest, ResolvedAdapter, ResolvedAdapterRoot, ResolvedGameManifest, RootAdapter, } from './manifest';
 export { DEFAULT_SERVER_MODULE, loadGameManifest } from './manifest';
 export type { GameSession } from './runtime/create-runtime';
 export type { MountEntry, MountedManifestSession, MountManifestOptions, } from './runtime/mount-manifest';
 export { mountManifestRoots } from './runtime/mount-manifest';
-export type { GameCleanup, GameContext, GameSetupFn } from './runtime/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,YAAY,EACV,UAAU,EACV,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,YAAY,EACV,UAAU,EACV,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -10,19 +10,17 @@
  * remain the primary way to reach engine internals — reach for a subpath
  * first. This barrel exists only so the package's bare-name entry point is
  * HONEST (resolves to something real and useful) instead of dangling; it
- * covers just the handful of symbols a game/consumer needs to author a
- * first-party `setup()` and mount it, plus the scene/manifest file
+ * covers just the handful of symbols a consumer needs to mount a game
+ * from its manifest, plus the manifest file
  * entry points. Keep it small when extending it — prefer a new subpath
  * export over growing this file into a firehose.
  *
  * Groups (import order below is alphabetical-by-specifier, per the repo's
  * biome `organizeImports` rule, not by group — see this list instead):
- *   - game setup contract: `GameContext`/`GameCleanup`/`GameSetupFn`, `fromSetup`
  *   - surface vocabulary: `AdapterSurface`
  *   - manifest-driven mount: `mountManifestRoots` + its option/result types
  *   - game manifest (vgai.project.json) entry point: `loadGameManifest`
  */
-export { fromSetup } from './adapter/setup-three-root-adapter';
 export { AssetParseError } from './asset-parse-error';
 export { DEFAULT_SERVER_MODULE, loadGameManifest } from './manifest';
 export { mountManifestRoots } from './runtime/mount-manifest';

package/dist/input/host-pointer.d.ts

@@ -0,0 +1,122 @@
+/**
+ * The host POINTER stream, in the game's own coordinate space — the DOM edge
+ * `InputManager`'s touch backends (`setTouchButton` / `setTouchStick`) and any
+ * pointer-position read need, and which the manager itself deliberately does
+ * not own.
+ *
+ * `InputManager` listens on `window` for keyboard, mouse and focus, in CLIENT
+ * pixels, because an action map is surface-agnostic. A pointer is not: a tap is
+ * only meaningful relative to the surface it landed on, and a game's own
+ * coordinate space is usually NOT that surface's CSS pixels — a fixed design
+ * resolution presented by uniformly scaling and letterboxing is the common
+ * case, and a hit-test against a UI rect authored in design pixels has to
+ * happen in one space with the pointer. That mapping needs a surface and a
+ * design size the manager has no way to know, so it lives here, beside it.
+ *
+ * What this owns, and nothing more:
+ *
+ * - **Position** — the last pointer position over the surface, mapped into the
+ *   design space. `setPosition` is the headless door (a harness or a game
+ *   command driving the game with no DOM), the same shape as
+ *   `InputManager.addMouseDelta`: inject through the accumulator the reader
+ *   already reads, never a synthetic `pointermove`.
+ * - **Touches** — a per-frame queue of {@link HostPointerTouch} records with
+ *   DENSE finger indices, drained by the game's own frame. `pointerId` is the
+ *   browser's opaque, monotonically growing handle; a touch API that reports
+ *   "finger 0 and finger 1" wants the lowest free slot, reused the moment a
+ *   finger lifts, which is what {@link HostPointerTouch.index} is.
+ * - **Cursor** — the CSS cursor applied to the surface, because the surface is
+ *   resolved here and nowhere else.
+ *
+ * **Gating.** Every listener returns early unless
+ * `InputManager.isInputActive()` — the SAME predicate the manager's own
+ * `keydown`/`mousemove` listeners pass, so play-mode isolation and window
+ * blur suppress pointer position and touches exactly as they suppress a key.
+ * The predicate is read from the manager rather than recomposed here
+ * (`isEnabled() && isFocused()` written out a second time is how a looser gate
+ * drifts in: a blurred or typing tab kept updating a pointer position under
+ * exactly that duplication). Text-entry focus is deliberately NOT part of it,
+ * matching `onMouseMove` rather than `onKeyDown` — moving a finger is not
+ * typing.
+ *
+ * **Ownership.** Owns its four pointer listeners on the resolved owner, the
+ * touch queue and the finger-index table. Shares the `InputManager`, which is
+ * the game's and is never mutated here — this reports; what a control DOES
+ * with a finger (which rect owns it, whether that becomes a `setTouchButton`)
+ * belongs to the UI that draws the control. Teardown is {@link
+ * HostPointer.dispose}, and only that: `InputManager.dispose` does not reach
+ * these listeners.
+ *
+ * Headless (no `window`): construction succeeds and binds nothing. Position is
+ * whatever {@link HostPointer.setPosition} last wrote, and the touch queue
+ * stays empty.
+ */
+import type { InputManager } from './input-manager';
+import type { Vector2 } from './input-types';
+/** One finger edge the host pointer stream produced. */
+export interface HostPointerTouch {
+    /**
+     * `'start'` when the finger went down on the surface, `'move'` while it
+     * drags, `'end'` when it lifted or the browser cancelled it. A cancel is an
+     * end: the finger is gone either way, and a control that treats them
+     * differently is holding a button nothing will ever release.
+     */
+    readonly phase: 'start' | 'move' | 'end';
+    /**
+     * DENSE finger index — the lowest slot free when this finger went down, and
+     * free again the moment it lifts. NOT the browser's `pointerId`, which never
+     * reuses a value and is therefore useless as "which finger is this".
+     */
+    readonly index: number;
+    /** Position in the design space (see {@link HostPointerOptions.designSize}). */
+    readonly position: Vector2;
+}
+/** What {@link createHostPointer} needs. */
+export interface HostPointerOptions {
+    /** The game's own manager — read for its gate, never written. */
+    readonly input: InputManager;
+    /**
+     * The render surface pointer positions are relative to.
+     *
+     * A GETTER rather than an element because a renderer usually mints its
+     * canvas after the game's services exist. Absent (or returning `null`) falls
+     * back to the event's own target element, and listening falls back to
+     * `window` — which is what makes a finger that starts on the canvas and
+     * drags over a DOM overlay keep reporting.
+     */
+    readonly surface?: (() => HTMLElement | null) | undefined;
+    /**
+     * The game's own logical resolution, if it has one. Surface CSS pixels are
+     * mapped into it, so a pointer and a UI rect authored at this size share one
+     * space regardless of how the host scaled and letterboxed the surface.
+     *
+     * Absent: positions are reported in the surface's own CSS pixels, and the
+     * position before any event is `{x: 0, y: 0}`. Present: the position before
+     * any event is the CENTRE of the design space — a pointer that has never
+     * moved is better described as the middle of the view than as a corner it
+     * was never at.
+     */
+    readonly designSize?: Vector2 | undefined;
+}
+/** The host pointer stream bound to one surface. One per mounted game. */
+export interface HostPointer {
+    /** The last pointer position, in the design space. */
+    getPosition(): Vector2;
+    /** Headless / harness door onto {@link getPosition}'s value. */
+    setPosition(position: Vector2): void;
+    /**
+     * Drain the touch records queued since the last call. Returns them in
+     * arrival order and empties the queue, so a frame that drains sees each
+     * finger edge exactly once.
+     */
+    takeTouches(): readonly HostPointerTouch[];
+    /**
+     * Set the CSS `cursor` applied to the surface. Applied on the next pointer
+     * move over it, which is also when the surface is known.
+     */
+    setCursor(cursor: string): void;
+    /** Remove the listeners this owns. */
+    dispose(): void;
+}
+export declare function createHostPointer(options: HostPointerOptions): HostPointer;
+//# sourceMappingURL=host-pointer.d.ts.map

package/dist/input/host-pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-pointer.d.ts","sourceRoot":"","sources":["../../src/input/host-pointer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAU7C,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IAC1D;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3C;AAED,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,WAAW,IAAI,OAAO,CAAC;IACvB,gEAAgE;IAChE,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACrC;;;;OAIG;IACH,WAAW,IAAI,SAAS,gBAAgB,EAAE,CAAC;IAC3C;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sCAAsC;IACtC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAgG1E"}