@vgai/engine 0.5.21 → 0.5.23

package/dist/adapter/binding.d.ts.map

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

package/dist/adapter/binding.js

@@ -0,0 +1,148 @@
+/**
+ * THE ROOT BINDING — a game's declaration of itself, bound, as ONE host-side
+ * value.
+ *
+ * A game is a native program plus a declaration of itself; the editor is a
+ * universal client of that declaration; the host must not know what it is
+ * hosting. Today that declaration arrives at the host as a scatter — a
+ * `RootInstance`, a `MountedRoot`, an `AuthoringAdapter` provider bag, a
+ * `SystemAdapters` slot map, a `ResolvedAdapterRoot`, a parsed
+ * `AdapterDefinition` — and every consumer re-assembles its own subset by
+ * hand. `RootBinding` is that same material REGROUPED under one name, by the
+ * FIVE protocol families a host actually talks in.
+ *
+ * ## This file declares the vocabulary AND performs the regrouping
+ *
+ * {@link createRootBinding} is the one place the five families are assembled,
+ * and it is a pure re-address of values it is HANDED — it loads nothing,
+ * fetches nothing, and constructs no provider. The editor's
+ * `binding-resolver.ts` (`resolveRootBinding(root, realm, adapterDef)`) is what
+ * gathers those values per realm and calls this; `RootInstance.binding`
+ * (`runtime/game.ts`) is where the result lives for the life of the mount.
+ * Keeping the assembly here rather than in the resolver is what makes the
+ * reference-equality rule below checkable in ONE function instead of once per
+ * realm.
+ *
+ * ## The one rule that makes this a regrouping and not an abstraction
+ *
+ * **Every member is a REFERENCE to the thing that already exists — never a
+ * facade, never a copy, never a wrapper.** `substrate.mounted` IS the
+ * `MountedRoot` the adapter returned. `observation.debugRegistry` IS the ONE
+ * game-scoped registry every root of that game shares (this binding neither
+ * owns it nor tears it down). And the providers that are read AND written
+ * through — `selection`, `transforms`, `inspector`, `instances`,
+ * `spatialHandles`, `boxEdit`, `text` — appear in BOTH
+ * {@link ProjectionBinding} and {@link TruthBinding} as literally the same
+ * object, so `binding.projection.selection === binding.truth.selection`. A
+ * facade at either address would make the two views disagree the first time
+ * anything stateful moved through one of them; reference equality is what
+ * makes "regrouping" a checkable claim instead of a promise.
+ */
+/**
+ * REGROUP the parts into the five families. No loading, no defaulting, no
+ * fabrication: every member of the result is one of `parts`' own values or one
+ * of `parts.mounted.authoring`'s own provider objects, read straight off it.
+ *
+ * The straddlers are read ONCE into locals and written to both bindings, which
+ * is what makes `binding.projection.selection === binding.truth.selection` true
+ * by construction rather than by care —
+ * `adapter-binding-protocol-families.test.ts` asserts it over a value this
+ * function built.
+ *
+ * The two callback members are the one exception to "the same reference", and
+ * deliberately: `subscribe`/`observeTransforms` are METHODS on their adapter
+ * (`live-three-authoring-adapter` reads `this.store` inside `subscribe`), so a
+ * bare property read would hand the caller a function whose `this` is the
+ * observation binding. They are bound to the authoring adapter that owns them —
+ * the same function over the same receiver, with nothing interposed. They are
+ * not straddlers and carry no equality claim.
+ *
+ * An absent `mounted.authoring` costs this root its `projection` and `truth`
+ * and NOTHING ELSE. There is no such thing as an empty `ProjectionBinding` —
+ * `capabilities`/`hierarchy` are required — so those two families are simply
+ * not there, which is the honest report. The other three are built from the
+ * declaration and the mount, neither of which the authoring adapter has
+ * anything to do with; refusing them as well would answer "which root is
+ * this, what did the project declare, what can be watched" with silence, and
+ * that is what made `binding` unreadable for every native TSX root the editor
+ * plays (the editor supplies their authoring itself — see
+ * {@link RootBinding.projection}).
+ */
+export function createRootBinding(parts) {
+    const authoring = parts.mounted.authoring;
+    // Read each straddler ONCE — the two bindings below then hold these exact
+    // objects, not two reads of the same key.
+    const { selection, transforms, inspector, instances, spatialHandles, boxEdit, text } = authoring ?? {};
+    return {
+        substrate: {
+            adapter: parts.adapter,
+            mounted: parts.mounted,
+            pausable: parts.pausable,
+            loop: parts.root.loop,
+        },
+        ...(authoring === undefined
+            ? {}
+            : projectionAndTruth(authoring, {
+                selection,
+                transforms,
+                inspector,
+                instances,
+                spatialHandles,
+                boxEdit,
+                text,
+            })),
+        observation: {
+            systems: parts.mounted.systems,
+            debugRegistry: parts.debugRegistry,
+            observe: parts.mounted.observe,
+            subscribe: authoring?.subscribe?.bind(authoring),
+            observeTransforms: authoring?.observeTransforms?.bind(authoring),
+            entryDebug: parts.entryDebug,
+            entrySystems: parts.entrySystems,
+        },
+        project: {
+            root: parts.root,
+            definition: parts.definition,
+            entry: parts.entry,
+        },
+    };
+}
+/** The two authoring-dependent families, built together from the ONE adapter
+ *  and the straddlers already read off it — so the reference-equality rule is
+ *  still decided in a single place. */
+function projectionAndTruth(authoring, straddlers) {
+    const { selection, transforms, inspector, instances, spatialHandles, boxEdit, text } = straddlers;
+    return {
+        projection: {
+            capabilities: authoring.capabilities,
+            hierarchy: authoring.hierarchy,
+            provenance: authoring.provenance,
+            selection,
+            transforms,
+            inspector,
+            instances,
+            spatialHandles,
+            boxEdit,
+            text,
+            assetSubject: authoring.assetSubject,
+            related: authoring.related,
+            rects: authoring.rects,
+            pickable: authoring.pickable,
+            stories: authoring.stories,
+            colorSample: authoring.colorSample,
+        },
+        truth: {
+            structure: authoring.structure,
+            persistence: authoring.persistence,
+            truth: authoring.truth,
+            assetDrop: authoring.assetDrop,
+            selection,
+            transforms,
+            inspector,
+            instances,
+            spatialHandles,
+            boxEdit,
+            text,
+        },
+    };
+}

package/dist/adapter/colyseus-networking-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"colyseus-networking-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/colyseus-networking-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,OAAO,EACP,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,cAAc,IAAI,MAAM,GAAG,IAAI,CAAC;IAChC,mCAAmC;IACnC,KAAK,IAAI,OAAO,EAAE,CAAC;IACnB;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC/C,oFAAoF;IACpF,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5C,4EAA4E;IAC5E,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,6EAA6E;IAC7E,mBAAmB,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;IACjD;;yEAEqE;IACrE,eAAe,CAAC,IAAI,eAAe,CAAC;IACpC;yCACqC;IACrC,QAAQ,CAAC,IAAI,QAAQ,GAAG,IAAI,CAAC;IAC7B;iDAC6C;IAC7C,gBAAgB,CAAC,IAAI,gBAAgB,CAAC;IACtC;uDACmD;IACnD,SAAS,CAAC,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;IACxC;;;;;kEAK8D;IAC9D,aAAa,CAAC,IAAI,OAAO,CAAC;IAC1B,qEAAqE;IACrE,aAAa,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IACrD,0EAA0E;IAC1E,KAAK,CAAC,IAAI,QAAQ,CAAC;IACnB;4EACwE;IACxE,eAAe,CAAC,IAAI,eAAe,CAAC;IACpC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C;;qEAEiE;IACjE,cAAc,CAAC,IAAI,iBAAiB,GAAG,SAAS,CAAC;IACjD;;;mEAG+D;IAC/D,iBAAiB,CAAC,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,wBAAwB,GAAG,iBAAiB,CAuDhG"}
+{"version":3,"file":"colyseus-networking-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/colyseus-networking-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,OAAO,EACP,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,cAAc,IAAI,MAAM,GAAG,IAAI,CAAC;IAChC,mCAAmC;IACnC,KAAK,IAAI,OAAO,EAAE,CAAC;IACnB;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC/C,oFAAoF;IACpF,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5C,4EAA4E;IAC5E,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,6EAA6E;IAC7E,mBAAmB,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;IACjD;;yEAEqE;IACrE,eAAe,CAAC,IAAI,eAAe,CAAC;IACpC;yCACqC;IACrC,QAAQ,CAAC,IAAI,QAAQ,GAAG,IAAI,CAAC;IAC7B;iDAC6C;IAC7C,gBAAgB,CAAC,IAAI,gBAAgB,CAAC;IACtC;uDACmD;IACnD,SAAS,CAAC,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;IACxC;;;;;kEAK8D;IAC9D,aAAa,CAAC,IAAI,OAAO,CAAC;IAC1B,qEAAqE;IACrE,aAAa,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IACrD,0EAA0E;IAC1E,KAAK,CAAC,IAAI,QAAQ,CAAC;IACnB;4EACwE;IACxE,eAAe,CAAC,IAAI,eAAe,CAAC;IACpC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C;;qEAEiE;IACjE,cAAc,CAAC,IAAI,iBAAiB,GAAG,SAAS,CAAC;IACjD;;;mEAG+D;IAC/D,iBAAiB,CAAC,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,wBAAwB,GAAG,iBAAiB,CAsEhG"}

package/dist/adapter/colyseus-networking-adapter.js

@@ -38,11 +38,26 @@ export function createColyseusNetworkingAdapter(cfg) {
                 return false; // server owns it → inspect-only
             return cfg.ownerId(o) === cfg.localSessionId(); // only your own peer's objects
         },
-        getConnectionState: () => cfg.connectionState?.() ?? 'disconnected',
-        getRoomInfo: () => cfg.roomInfo?.() ?? null,
-        getReplicationStats: () => cfg.replicationStats?.() ?? { entities: 0, msgsInPerSec: 0, msgsOutPerSec: 0 },
+        // `subscribe` is the one member that still defaults, and honestly: an
+        // adapter with nothing to notify about has a real no-op subscription, and
+        // the caller's contract ("you will hear about changes") is kept — there are
+        // none. Every accessor below ANSWERS A QUESTION, and a default answer to a
+        // question nobody implemented is a fabricated measurement.
         subscribe: (cb) => cfg.subscribe?.(cb) ?? (() => { }),
     };
+    // The link-state accessors attach ONLY when supplied, exactly like the W3b
+    // capabilities below. They used to default — `'disconnected'`, `null`, and
+    // all-zero stats — which read as "we looked, and the game is idle and
+    // unconnected" for a config that had simply never been taught to look.
+    const connectionState = cfg.connectionState?.bind(cfg);
+    if (connectionState)
+        adapter.getConnectionState = () => connectionState();
+    const roomInfo = cfg.roomInfo?.bind(cfg);
+    if (roomInfo)
+        adapter.getRoomInfo = () => roomInfo();
+    const replicationStats = cfg.replicationStats?.bind(cfg);
+    if (replicationStats)
+        adapter.getReplicationStats = () => replicationStats();
     // The W3b inspector capabilities attach ONLY when supplied: their absence
     // is the editor's degradation signal (`getStateSnapshot` in adapter ⇒ tree,
     // missing ⇒ "not provided by this adapter" — never a fabricated empty).
@@ -66,7 +81,11 @@ export function createColyseusNetworkingAdapter(cfg) {
     // editor shows an editable field only when `setPlayerIdentity` is present.
     const playerIdentity = cfg.playerIdentity?.bind(cfg);
     if (playerIdentity) {
-        adapter.getPlayerIdentity = () => playerIdentity() ?? {};
+        // `cfg.playerIdentity` may answer `undefined` — "I read the game's state
+        // and it has no seat for this client yet". That is not `{}`, an identity
+        // that exists and happens to be blank; it is the reader's real answer, and
+        // the seam passes it through.
+        adapter.getPlayerIdentity = () => playerIdentity();
     }
     const setPlayerIdentity = cfg.setPlayerIdentity?.bind(cfg);
     if (setPlayerIdentity) {

package/dist/adapter/entrypoint-selection-readers.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pure TS-AST readers over an entrypoint's SELECTION TABLE — shared by the
+ * write side (`entrypoint-selection-source.ts`) and the read side
+ * (`finders/scenes-from-entrypoint-selection.ts`). These two must agree on
+ * what a selection table IS, or play remounts a key the finder never
+ * discovered; one spelling here is what makes that agreement structural.
+ * (The finder-import boundary bans importing from `finders/` — this sibling
+ * sits outside that directory precisely so both sides can share it.)
+ */
+import ts from 'typescript';
+/** The object literal a module-level `const <name> = { … }` binds. */
+export declare function selectionTable(sf: ts.SourceFile, name: string): ts.ObjectLiteralExpression | undefined;
+/** A property's key when it is a plain identifier or string literal. */
+export declare function propertyKey(property: ts.ObjectLiteralElementLike): string | undefined;
+/**
+ * The identifier the entrypoint INDEXES the selection table with — the
+ * `activeScene` in `scenes[activeScene]`.
+ *
+ * `undefined` when the module never indexes the table; `null` when it does
+ * but not readably (several identifiers, or a non-identifier index). Both
+ * are honest "cannot be read" answers the callers turn into their own notes.
+ */
+export declare function indexingIdentifier(sf: ts.SourceFile, selection: string): string | undefined | null;
+//# sourceMappingURL=entrypoint-selection-readers.d.ts.map

package/dist/adapter/entrypoint-selection-readers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entrypoint-selection-readers.d.ts","sourceRoot":"","sources":["../../src/adapter/entrypoint-selection-readers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,sEAAsE;AACtE,wBAAgB,cAAc,CAC5B,EAAE,EAAE,EAAE,CAAC,UAAU,EACjB,IAAI,EAAE,MAAM,GACX,EAAE,CAAC,uBAAuB,GAAG,SAAS,CAUxC;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,wBAAwB,GAAG,MAAM,GAAG,SAAS,CAKrF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,EAAE,CAAC,UAAU,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,GAAG,IAAI,CAkB3B"}

package/dist/adapter/entrypoint-selection-readers.js

@@ -0,0 +1,63 @@
+/**
+ * Pure TS-AST readers over an entrypoint's SELECTION TABLE — shared by the
+ * write side (`entrypoint-selection-source.ts`) and the read side
+ * (`finders/scenes-from-entrypoint-selection.ts`). These two must agree on
+ * what a selection table IS, or play remounts a key the finder never
+ * discovered; one spelling here is what makes that agreement structural.
+ * (The finder-import boundary bans importing from `finders/` — this sibling
+ * sits outside that directory precisely so both sides can share it.)
+ */
+import ts from 'typescript';
+/** The object literal a module-level `const <name> = { … }` binds. */
+export function selectionTable(sf, name) {
+    for (const statement of sf.statements) {
+        if (!ts.isVariableStatement(statement))
+            continue;
+        for (const declaration of statement.declarationList.declarations) {
+            if (!ts.isIdentifier(declaration.name) || declaration.name.text !== name)
+                continue;
+            const initializer = declaration.initializer;
+            if (initializer && ts.isObjectLiteralExpression(initializer))
+                return initializer;
+        }
+    }
+    return undefined;
+}
+/** A property's key when it is a plain identifier or string literal. */
+export function propertyKey(property) {
+    const name = property.name;
+    if (!name)
+        return undefined;
+    if (ts.isIdentifier(name) || ts.isStringLiteral(name))
+        return name.text;
+    return undefined;
+}
+/**
+ * The identifier the entrypoint INDEXES the selection table with — the
+ * `activeScene` in `scenes[activeScene]`.
+ *
+ * `undefined` when the module never indexes the table; `null` when it does
+ * but not readably (several identifiers, or a non-identifier index). Both
+ * are honest "cannot be read" answers the callers turn into their own notes.
+ */
+export function indexingIdentifier(sf, selection) {
+    const names = new Set();
+    let unreadable = false;
+    const visit = (node) => {
+        if (ts.isElementAccessExpression(node) &&
+            ts.isIdentifier(node.expression) &&
+            node.expression.text === selection) {
+            if (ts.isIdentifier(node.argumentExpression))
+                names.add(node.argumentExpression.text);
+            else
+                unreadable = true;
+        }
+        ts.forEachChild(node, visit);
+    };
+    ts.forEachChild(sf, visit);
+    if (names.size === 0 && !unreadable)
+        return undefined;
+    if (names.size !== 1 || unreadable)
+        return null;
+    return [...names][0];
+}

package/dist/adapter/entrypoint-selection-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoint-selection-source.d.ts","sourceRoot":"","sources":["../../src/adapter/entrypoint-selection-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,MAAM,0BAA0B,GAClC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACzE;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAqEpD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,0BAA0B,CAsD5B"}
+{"version":3,"file":"entrypoint-selection-source.d.ts","sourceRoot":"","sources":["../../src/adapter/entrypoint-selection-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,MAAM,MAAM,0BAA0B,GAClC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACzE;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AA6BpD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,0BAA0B,CAsD5B"}

package/dist/adapter/entrypoint-selection-source.js

@@ -15,31 +15,10 @@
  * host-side only — a game's `vgai.adapter.ts` must not import it.
  */
 import ts from 'typescript';
+import { indexingIdentifier, propertyKey, selectionTable } from './entrypoint-selection-readers';
 function parse(path, source) {
     return ts.createSourceFile(path, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
 }
-function selectionTable(sf, name) {
-    for (const statement of sf.statements) {
-        if (!ts.isVariableStatement(statement))
-            continue;
-        for (const declaration of statement.declarationList.declarations) {
-            if (!ts.isIdentifier(declaration.name) || declaration.name.text !== name)
-                continue;
-            const initializer = declaration.initializer;
-            if (initializer && ts.isObjectLiteralExpression(initializer))
-                return initializer;
-        }
-    }
-    return undefined;
-}
-function propertyKey(property) {
-    const name = property.name;
-    if (!name)
-        return undefined;
-    if (ts.isIdentifier(name) || ts.isStringLiteral(name))
-        return name.text;
-    return undefined;
-}
 function tableKeys(table) {
     const keys = [];
     for (const property of table.properties) {
@@ -49,28 +28,6 @@ function tableKeys(table) {
     }
     return keys;
 }
-/** The identifier in `scenes[activeScene]`, or a failure to read one. */
-function indexingIdentifier(sf, selection) {
-    const names = new Set();
-    let unreadable = false;
-    const visit = (node) => {
-        if (ts.isElementAccessExpression(node) &&
-            ts.isIdentifier(node.expression) &&
-            node.expression.text === selection) {
-            if (ts.isIdentifier(node.argumentExpression))
-                names.add(node.argumentExpression.text);
-            else
-                unreadable = true;
-        }
-        ts.forEachChild(node, visit);
-    };
-    ts.forEachChild(sf, visit);
-    if (names.size === 0 && !unreadable)
-        return undefined;
-    if (names.size !== 1 || unreadable)
-        return null;
-    return [...names][0];
-}
 function moduleLevelStringLiteral(sf, name) {
     for (const statement of sf.statements) {
         if (!ts.isVariableStatement(statement))

package/dist/adapter/finders/scenes-from-entrypoint-selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scenes-from-entrypoint-selection.d.ts","sourceRoot":"","sources":["../../../src/adapter/finders/scenes-from-entrypoint-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAGH,OAAO,KAAK,EAGV,mCAAmC,EACpC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACjF;AA+TD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,mCAAmC,EAC3C,KAAK,EAAE,kCAAkC,GACxC,YAAY,CA8Bd"}
+{"version":3,"file":"scenes-from-entrypoint-selection.d.ts","sourceRoot":"","sources":["../../../src/adapter/finders/scenes-from-entrypoint-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAGH,OAAO,KAAK,EAGV,mCAAmC,EACpC,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACjF;AA+QD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,mCAAmC,EAC3C,KAAK,EAAE,kCAAkC,GACxC,YAAY,CA8Bd"}

package/dist/adapter/finders/scenes-from-entrypoint-selection.js

@@ -37,6 +37,7 @@
  */
 import ts from 'typescript';
 import { EXPORTED_COMPOSITION_REGIONS } from '../adapter-module';
+import { indexingIdentifier, propertyKey, selectionTable } from '../entrypoint-selection-readers';
 /** Strip the directory and extension from a project-relative path. */
 function basename(path) {
     const file = path.replaceAll('\\', '/').split('/').pop() ?? path;
@@ -92,58 +93,6 @@ function importedBindings(sf) {
     }
     return bindings;
 }
-/** The module-level `const <name> = { … }` initializer, if there is one. */
-function selectionTable(sf, name) {
-    for (const statement of sf.statements) {
-        if (!ts.isVariableStatement(statement))
-            continue;
-        for (const declaration of statement.declarationList.declarations) {
-            if (!ts.isIdentifier(declaration.name) || declaration.name.text !== name)
-                continue;
-            const initializer = declaration.initializer;
-            if (initializer && ts.isObjectLiteralExpression(initializer))
-                return initializer;
-        }
-    }
-    return undefined;
-}
-function propertyKey(property) {
-    const name = property.name;
-    if (!name)
-        return undefined;
-    if (ts.isIdentifier(name) || ts.isStringLiteral(name))
-        return name.text;
-    return undefined;
-}
-/**
- * The identifier the entrypoint INDEXES the selection table with — the
- * `activeScene` in `scenes[activeScene]`.
- *
- * `undefined` when the module never indexes the table, or indexes it with
- * anything other than one single identifier: both are honest "cannot be read",
- * and the caller turns each into its own note.
- */
-function indexingIdentifier(sf, selection) {
-    const names = new Set();
-    let unreadable = false;
-    const visit = (node) => {
-        if (ts.isElementAccessExpression(node) &&
-            ts.isIdentifier(node.expression) &&
-            node.expression.text === selection) {
-            if (ts.isIdentifier(node.argumentExpression))
-                names.add(node.argumentExpression.text);
-            else
-                unreadable = true;
-        }
-        ts.forEachChild(node, visit);
-    };
-    ts.forEachChild(sf, visit);
-    if (names.size === 0 && !unreadable)
-        return undefined; // never indexed at all
-    if (names.size !== 1 || unreadable)
-        return null; // indexed, but not readably
-    return [...names][0];
-}
 /**
  * The string a module-level `const <name> = '…'` binds, or `undefined`.
  *

package/dist/adapter/host-context.d.ts

@@ -1,10 +1,8 @@
 /**
  * Host contexts — what the host hands a root when it mounts it, PER SURFACE.
  *
- * This generalizes the old `GameContext`, which baked in first-party system
- * choices (a Rapier world, the postprocessing composer, the InputManager, …).
- * The host never assumes Rapier/Colyseus; those live behind `SystemAdapters`
- * owned by the first-party implementer.
+ * The host never assumes Rapier/Colyseus; system choices live behind
+ * `SystemAdapters` owned by each root's own implementation.
  *
  * ## Why this file is a family, not one interface (P-8)
  *
@@ -71,16 +69,49 @@
  * hosts, with no caller anywhere, and its only real effect would have been to
  * re-open the door this interface exists to close: the host handing a game a
  * subsystem it did not build. Deleted rather than kept as a promise.
- *
- * Migration note: `SetupThreeRootAdapter.mount` builds today's `GameContext`
- * (Rapier world, composer, …) internally from a `ThreeHostContext`. New code
- * targets these contexts; `GameContext` is now a first-party implementation
- * detail.
  */
 import type * as THREE from 'three';
 import type { AssetCache } from '../assets';
-import type { Game, GameInternal } from '../runtime/game';
+import type { Game } from '../runtime/game';
 import type { AdapterSurface } from './adapter-surface';
+/**
+ * THE FOUR DOORS a mounting root actually opens on the Game — and the whole
+ * reason `three`/`canvas` host contexts no longer name `GameInternal`.
+ *
+ * `GameInternal` is the HOST's own control surface: `runFrame`,
+ * `runRenderFrame`, `runTicks`, `registerRoot`, `notifySystemAdaptersChanged`,
+ * `dispose`. Handing it to an adapter's `mount()` published the loop driver to
+ * the thing being driven — nothing read those members through `host.game`, but
+ * the type said they could, so "what may a root do to its Game?" had no
+ * answer short of "everything".
+ *
+ * The four doors, each with its verified consumer:
+ *
+ *  1. **Input-map load** — `runtime/game-input-seams.ts` calls
+ *     `game.loadInputMap(path)` (and reads `game.input`/`game.loop.fixedDt`)
+ *     from every three and canvas mount.
+ *  2. **Debug-registry access** — `getDebugRegistry(host.game)`
+ *     (`r3f-root-factory`, `pixi-react-root-factory`); the registry is keyed by
+ *     Game IDENTITY, which is why this handle is the Game and not a projection
+ *     of it.
+ *  3. **The Game handed to `<WorldProvider>`** — the react world-state seam
+ *     (`r3f-root-factory`, `pixi-react-root-factory`, and both react mounts in
+ *     the editor's resolver). `WorldProvider`'s prop is `Game`.
+ *  4. **The profiler toggle** — `host.game.profiler` (`r3f-root-factory`).
+ *
+ * Doors 2–4 are already on the PUBLIC {@link Game}. `loadInputMap` is the one
+ * member that was only on `GameInternal`, and it is explicitly an adapter-mount
+ * door (see its own doc comment in `runtime/game.ts`). So this handle is
+ * `Game` plus that one method — and a `GameInternal` satisfies it, so every
+ * host that already passes one keeps compiling unchanged.
+ */
+export interface HostGameHandle extends Game {
+    /** Load the game-owned input map ONCE, however many roots ask. See
+     *  `GameInternal.loadInputMap` for the load-once/competing-paths contract. */
+    loadInputMap(path: string, options?: {
+        optional?: boolean;
+    }): Promise<void>;
+}
 /** The canvas/container the game renders into, plus its size. */
 export interface HostSurface {
     readonly canvas: HTMLCanvasElement;
@@ -104,8 +135,8 @@ export interface HostContextBase {
      * zero-break guarantee for this slice). Typed as the PUBLIC `Game` shell
      * here because that is the weakest promise any surface makes (a react
      * root's host has always carried a plain `Game`); the three and canvas
-     * contexts narrow it to `GameInternal`, which is what their hosts really
-     * pass.
+     * contexts narrow it to {@link HostGameHandle} — the four doors a mounting
+     * root actually opens, which is what their hosts really pass.
      */
     readonly game?: Game | undefined;
     /**
@@ -130,7 +161,7 @@ export interface ThreeHostContext extends HostContextBase {
     readonly renderer: THREE.WebGLRenderer;
     /** Shared GLTF/texture cache — three-flavored today; see the header. */
     readonly assets: AssetCache;
-    readonly game?: GameInternal | undefined;
+    readonly game?: HostGameHandle | undefined;
 }
 /**
  * What a `canvas`-surface root is handed: a raw canvas + its
@@ -144,7 +175,7 @@ export interface CanvasHostContext extends HostContextBase {
     readonly width: number;
     readonly height: number;
     /** Shared Game root when mounted by the universal multi-root host. */
-    readonly game?: GameInternal | undefined;
+    readonly game?: HostGameHandle | undefined;
     /** DPR override (T6.1 slice 1, D5 §3 — "one DPR
      *  everywhere"): the roots-path host computes ONE dpr for every stacked
      *  surface and passes it here; omitted -> the canvas adapter's own
@@ -170,7 +201,7 @@ export interface CanvasHostContext extends HostContextBase {
  * `game` (inherited, and deliberately still optional): a
  * `default-react` sibling mounted BESIDE an ingest root (`packages/editor/src/
  * ingest-siblings.ts`) has no native `Game` to hand it — there is no
- * first-party `GameContext`/loop for the sibling to join, only the ingested
+ * first-party loop for the sibling to join, only the ingested
  * root's own foreign runtime — so its host carries no `game` at all rather than
  * fabricating an empty one (anti-shim rule); the sibling mounts its entry
  * component bare, with no `<WorldProvider>` wrap. `mountOneReactRoot`

package/dist/adapter/host-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-context.d.ts","sourceRoot":"","sources":["../../src/adapter/host-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACzC;;;yDAGqD;IACrD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;4EACwE;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,cAAc,IAAI,CAAC,SAAS,OAAO,GACpE,gBAAgB,GAChB,CAAC,SAAS,QAAQ,GAChB,iBAAiB,GACjB,CAAC,SAAS,KAAK,GACb,cAAc,GACd,KAAK,CAAC"}
+{"version":3,"file":"host-context.d.ts","sourceRoot":"","sources":["../../src/adapter/host-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,cAAe,SAAQ,IAAI;IAC1C;kFAC8E;IAC9E,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E;AAED,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CAC5C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C;;;yDAGqD;IACrD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;4EACwE;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,cAAc,IAAI,CAAC,SAAS,OAAO,GACpE,gBAAgB,GAChB,CAAC,SAAS,QAAQ,GAChB,iBAAiB,GACjB,CAAC,SAAS,KAAK,GACb,cAAc,GACd,KAAK,CAAC"}

package/dist/adapter/host-context.js

@@ -1,10 +1,8 @@
 /**
  * Host contexts — what the host hands a root when it mounts it, PER SURFACE.
  *
- * This generalizes the old `GameContext`, which baked in first-party system
- * choices (a Rapier world, the postprocessing composer, the InputManager, …).
- * The host never assumes Rapier/Colyseus; those live behind `SystemAdapters`
- * owned by the first-party implementer.
+ * The host never assumes Rapier/Colyseus; system choices live behind
+ * `SystemAdapters` owned by each root's own implementation.
  *
  * ## Why this file is a family, not one interface (P-8)
  *
@@ -71,10 +69,5 @@
  * hosts, with no caller anywhere, and its only real effect would have been to
  * re-open the door this interface exists to close: the host handing a game a
  * subsystem it did not build. Deleted rather than kept as a promise.
- *
- * Migration note: `SetupThreeRootAdapter.mount` builds today's `GameContext`
- * (Rapier world, composer, …) internally from a `ThreeHostContext`. New code
- * targets these contexts; `GameContext` is now a first-party implementation
- * detail.
  */
 export {};

package/dist/adapter/index.d.ts

@@ -1,23 +1,21 @@
 /**
  * Adapter interfaces — the seams the engine host and the editor DEPEND ON.
  *
- *   host    → RootAdapter ← { SetupThreeRootAdapter, IngestRootAdapter, … }
+ *   host    → RootAdapter ← { r3fRootFactory-built adapters, IngestRootAdapter, … }
  *   editor  → AuthoringAdapter ← { LiveThreeAuthoringAdapter, ReactRootAuthoringAdapter, … }
  *   game    → SystemAdapters (physics/networking/navigation/audio/camera/debug)
  *
  * The first-party Rapier/Colyseus stack is ONE implementer of these
- * interfaces, not the engine's vocabulary..
+ * interfaces, not the engine's vocabulary.
  *
  * **This module is TYPE-ONLY, and must stay that way (P-6).** It used to
- * value-export its own implementers — `SetupThreeRootAdapter`/`fromSetup`,
- * `createRapierPhysicsAdapter`, `createColyseusNetworkingAdapter`,
- * `createNavigationAdapter` — so `import type { AuthoringAdapter } from
- * '@engine/adapter'` was the only thing keeping the three/Rapier/Colyseus/
- * `.vscn` stack out of a Pixi or React consumer's module graph. A seam that
- * ships its implementers is not a seam. Import an implementer from its OWN
- * path instead:
+ * value-export its own implementers — `createRapierPhysicsAdapter`,
+ * `createColyseusNetworkingAdapter`, `createNavigationAdapter` — so
+ * `import type { AuthoringAdapter } from '@engine/adapter'` was the only
+ * thing keeping the three/Rapier/Colyseus stack out of a Pixi or React
+ * consumer's module graph. A seam that ships its implementers is not a
+ * seam. Import an implementer from its OWN path instead:
  *
- *   `@engine/adapter/setup-three-root-adapter`   SetupThreeRootAdapter, fromSetup
  *   `@engine/adapter/rapier-physics-adapter`    createRapierPhysicsAdapter
  *   `@engine/adapter/colyseus-networking-adapter` createColyseusNetworkingAdapter
  *   `@engine/adapter/first-party-systems`       createNavigationAdapter
@@ -26,13 +24,14 @@ export type { AdapterSurface } from './adapter-surface';
 export type { AssetDropContext, AssetDropProvider, AssetSubjectProvider, AuthoringAdapter, AuthoringAssetSubject, AuthoringCapabilities, AuthoringProvenance, AuthoringProviderKey, AuthoringTruth, BoxEditProvider, BoxEditReferencePoint, ColorSampleProvider, ComponentInstanceApplyResult, ComponentInstanceDescription, ComponentInstanceOverride, ComponentInstancesProvider, DOMRectLike, EditorNode, EditorNodeRole, HierarchyProvider, InspectorProvider, NodeCreationSite, PersistenceProvider, PickProvider, PropertyDescriptor, RectProvider, RelatedSubjectLink, RelatedSubjectsProvider, SelectionProvider, SelectionResolution, SpatialDragHandle, SpatialHandleGuide, SpatialHandleLayer, SpatialHandlesProvider, SpatialPoint3, StoriesProvider, StoryRef, StructuralClipboardOutcome, StructuralIdsWrite, StructuralIdWrite, StructuralWriteOutcome, StructureProvider, TextProvider, TransformChannel, TransformEditability, TransformObservation, TransformProvider, TransformSourceCommitProvider, TruthProvider, WriteAck, WriteAnchorKind, } from './authoring';
 export { AUTHORING_PROVIDER_KEYS, emptyWriteAnchorKindCounts, measureAuthoringProviders, WRITE_ANCHOR_KINDS, } from './authoring';
 export { AUTHORING_ADAPTER_SHAPE, AUTHORING_PROVIDER_SHAPES, HIERARCHY_PROVIDER_SHAPE, } from './authoring-seam-contract';
+export type { BundledEntrySubset, EntryStaticSurface, ObservationBinding, ProjectBinding, ProjectionBinding, ProtocolFamily, RootBinding, RootBindingParts, RootDeclaration, SubstrateBinding, TruthBinding, } from './binding';
+export { createRootBinding } from './binding';
 export type { ColyseusNetworkingConfig } from './colyseus-networking-adapter';
-export type { CanvasHostContext, DomHostContext, HostContextBase, HostContextFor, HostSurface, ThreeHostContext, } from './host-context';
+export type { CanvasHostContext, DomHostContext, HostContextBase, HostContextFor, HostGameHandle, HostSurface, ThreeHostContext, } from './host-context';
 export type { MountedPixiRoot, MountedReactRoot, MountedRoot, MountedRootBase, MountedThreeRoot, RootAdapter, RootStateObserver, SurfaceAdapter, SurfaceAdapterFor, } from './root-adapter';
 export { MOUNTED_CANVAS_SURFACE_SHAPE, MOUNTED_DOM_SURFACE_SHAPE, MOUNTED_ROOT_BASE_SHAPE, MOUNTED_THREE_SURFACE_SHAPE, ROOT_ADAPTER_SHAPE, ROOT_STATE_OBSERVER_SHAPE, } from './root-seam-contract';
 export type { SeamEvidenceOutcome, SeamEvidenceReceipt, SeamEvidenceSource, SeamEvidenceState, SeamEvidenceVerdict, SeamProofStage, SeamShape, } from './seam-evidence';
 export { defineSeamShape, gradeSeamCarrier, gradeSeamEvidence, inspectSeamShape, SEAM_PROOF_STAGES, SeamEvidenceLedger, seamStageAtLeast, } from './seam-evidence';
-export type { MountedSetupThreeRoot, SetupThreeRootConfig } from './setup-three-root-adapter';
 export type { AudioAdapter, AudioDebugEvent, AudioGraphNode, AudioMeterFrame, AudioMeterHandle, AudioRecordingHandle, AudioTransportState, CameraAdapter, CameraRuntimeCamera, CameraRuntimeSnapshot, CameraRuntimeTransition, ConnectionState, DebugAdapter, NavCrowdAgentState, NavigationAdapter, NavPoint, NetConditioning, NetMessageEvent, NetPeer, NetPlayerIdentity, NetRates, NetServerConfig, NetworkingAdapter, PhysicsAdapter, PhysicsCarrier, PhysicsColliderShape, PhysicsColliderSnapshot, PhysicsJointSnapshot, PhysicsJointType, RenderDebugAdapter, ReplicationStats, RoomInfo, SystemAdapters, Unsubscribe, } from './system-adapter';
 /** The two narrowings of the tagged `SystemAdapters['physics']` union — see
  *  `PhysicsAdapter`'s comment for why it is tagged at all. */