@vgai/engine 0.5.25 → 0.5.26

package/dist/pixi/authoring.js

@@ -583,7 +583,7 @@ export class AuthoringAdapter2D {
      * it into the in-memory overlay so a later `serializeOverlay()`/save preserves it
      * and a later `refresh()` re-applies it again. Ids absent from the current tree
      * are skipped (orphaned, not an error) — the 2D analog of
-     * `LiveThreeAuthoringAdapter.applyOverlay` (T3.2 slice 3). Used both for the initial
+     * `ThreeAuthoringAdapter.applyOverlay` (T3.2 slice 3). Used both for the initial
      * reload (constructor `opts.overlay`) and for `PersistenceProvider.applyExternal`
      * (re-apply a changed overlay file without a full remount).
      */
@@ -614,7 +614,7 @@ export class AuthoringAdapter2D {
             this.applyOverride(id, ov);
         this.dirty = true;
     }
-    /** Clear the dirty flag after a successful save (mirrors LiveThreeAuthoringAdapter). */
+    /** Clear the dirty flag after a successful save (mirrors ThreeAuthoringAdapter). */
     markClean() {
         this.dirty = false;
     }

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

@@ -1,6 +1,6 @@
 import { type RootDeclaration } from '../adapter/binding';
 import type { DomHostContext } from '../adapter/host-context';
-import type { MountedPixiRoot, MountedReactRoot, MountedThreeRoot, RootAdapter } from '../adapter/root-adapter';
+import type { MountedCanvasRoot, MountedReactRoot, MountedThreeRoot, RootAdapter } from '../adapter/root-adapter';
 import { type Game, type GameInternal, type RootInstance } from './game';
 import type { PlaytestContext } from './playtest';
 /**
@@ -23,22 +23,23 @@ export interface RegisterRootOptions {
     readonly declaration?: RootDeclaration | undefined;
 }
 /**
- * Register a canvas world onto the Game shell — the pixi analog of
+ * Register a canvas world onto the Game shell — the canvas analog of
  * {@link registerThreeRoot}. `adapter` is the seam's own
  * `RootAdapter<'canvas'>`; `RootInstance.adapter` itself only needs `.id`
  * (`AdapterHandle`, `runtime/game.ts`), so this passes through with zero cast.
- * `stage` is the one field every `MountedPixiRoot` actually carries.
+ * The substrate root remains opaque here; the editor dispatches from the
+ * mount's explicit `substrate.name` declaration.
  */
-export declare function registerPixiRoot(game: GameInternal, adapter: RootAdapter<'canvas'>, mounted: MountedPixiRoot, opts?: RegisterRootOptions): RootInstance;
+export declare function registerCanvasRoot(game: GameInternal, adapter: RootAdapter<'canvas'>, mounted: MountedCanvasRoot, opts?: RegisterRootOptions): RootInstance;
 /**
  * Register a React world onto the Game shell — the DOM
- * analog of {@link registerThreeRoot}/{@link registerPixiRoot}. A react
+ * analog of {@link registerThreeRoot}/{@link registerCanvasRoot}. A react
  * world has no `frame` hooks (react's own
  * `createRoot` schedules its commits; `GameInternal.runFrame` correctly
  * leaves a world with no `frame` untouched by its opaque-`update` fallback
  * too, since `MountedReactGame` declares no `update`). `adapter` is typed
  * as the real {@link ReactRootAdapter} shape (same reasoning as
- * `registerPixiRoot`'s doc comment above) — `RootInstance.adapter` only
+ * `registerCanvasRoot`'s doc comment above) — `RootInstance.adapter` only
  * needs `.id`, so this passes through with zero cast.
  */
 export declare function registerReactRoot(game: GameInternal, adapter: RootAdapter<'dom'>, mounted: MountedReactRoot, container: HTMLElement, opts?: RegisterRootOptions): RootInstance;
@@ -83,10 +84,10 @@ export interface ThreeRootMountSpec extends RootMountSpecBase {
 }
 /**
  * `adapter` is the SEAM's `RootAdapter<'canvas'>` — a canvas root's mount
- * honestly returns only a `MountedPixiRoot`, and naming the real contract
+ * honestly returns a `MountedCanvasRoot`, and naming the real contract
  * here is what keeps the resolver cast-free.
  */
-export interface PixiRootMountSpec extends RootMountSpecBase {
+export interface CanvasRootMountSpec extends RootMountSpecBase {
     readonly kind: 'canvas';
     readonly adapter: RootAdapter<'canvas'>;
 }
@@ -114,7 +115,7 @@ export interface PixiRootMountSpec extends RootMountSpecBase {
  * `kind`/`container` satisfy `MountedReactRoot` (`adapter/
  * root-adapter.ts`) — `container` is the SAME `DomHostContext.container` the
  * adapter's `mount` was handed (identity matters, mirroring `threeScene()`/
- * `pixiStage()`'s "same instance the adapter mounted" contract); every
+ * `canvasRoot()`'s "same instance the adapter mounted" contract); every
  * `ReactRootAdapter` implementer echoes it back here so `mounted` alone
  * (with no separately-threaded `container`) satisfies the union
  * `RootInstanceInit.mounted`/`RootInstance.mounted` with zero cast.
@@ -137,13 +138,13 @@ export interface ReactRootAdapter extends RootAdapter<'dom'> {
     readonly id: string;
     mount(host: DomHostContext): Promise<MountedReactGame>;
 }
-/** Same reasoning as {@link PixiRootMountSpec} above: the seam's
+/** Same reasoning as {@link CanvasRootMountSpec} above: the seam's
  *  `RootAdapter<'dom'>` is what a DOM root actually guarantees. */
 export interface ReactRootMountSpec extends RootMountSpecBase {
     readonly kind: 'dom';
     readonly adapter: RootAdapter<'dom'>;
 }
-export type RootMountSpec = ThreeRootMountSpec | PixiRootMountSpec | ReactRootMountSpec;
+export type RootMountSpec = ThreeRootMountSpec | CanvasRootMountSpec | ReactRootMountSpec;
 /**
  * Mount N adapter roots (three + canvas + react)
  * on ONE `Game`, stacked in `container` per D5 §1.

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

@@ -51,13 +51,14 @@ function bindRoot(game, declaration, adapter, mounted, pausable) {
     });
 }
 /**
- * Register a canvas world onto the Game shell — the pixi analog of
+ * Register a canvas world onto the Game shell — the canvas analog of
  * {@link registerThreeRoot}. `adapter` is the seam's own
  * `RootAdapter<'canvas'>`; `RootInstance.adapter` itself only needs `.id`
  * (`AdapterHandle`, `runtime/game.ts`), so this passes through with zero cast.
- * `stage` is the one field every `MountedPixiRoot` actually carries.
+ * The substrate root remains opaque here; the editor dispatches from the
+ * mount's explicit `substrate.name` declaration.
  */
-export function registerPixiRoot(game, adapter, mounted, opts) {
+export function registerCanvasRoot(game, adapter, mounted, opts) {
     const id = opts?.id ?? 'main';
     const pausable = opts?.pausable ?? true;
     const world = createRootInstance({
@@ -66,7 +67,7 @@ export function registerPixiRoot(game, adapter, mounted, opts) {
         pausable,
         adapter,
         mounted,
-        stage: mounted.stage,
+        canvasRoot: mounted.substrate.root,
         binding: bindRoot(game, opts?.declaration, { surface: 'canvas', adapter }, mounted, pausable),
     });
     game.registerRoot(world);
@@ -74,13 +75,13 @@ export function registerPixiRoot(game, adapter, mounted, opts) {
 }
 /**
  * Register a React world onto the Game shell — the DOM
- * analog of {@link registerThreeRoot}/{@link registerPixiRoot}. A react
+ * analog of {@link registerThreeRoot}/{@link registerCanvasRoot}. A react
  * world has no `frame` hooks (react's own
  * `createRoot` schedules its commits; `GameInternal.runFrame` correctly
  * leaves a world with no `frame` untouched by its opaque-`update` fallback
  * too, since `MountedReactGame` declares no `update`). `adapter` is typed
  * as the real {@link ReactRootAdapter} shape (same reasoning as
- * `registerPixiRoot`'s doc comment above) — `RootInstance.adapter` only
+ * `registerCanvasRoot`'s doc comment above) — `RootInstance.adapter` only
  * needs `.id`, so this passes through with zero cast.
  */
 export function registerReactRoot(game, adapter, mounted, container, opts) {
@@ -169,7 +170,7 @@ function disposeMountedRoot(entry, container) {
 /** 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
- *  simple — see `mountOnePixiRoot` for the canvas sibling. */
+ *  simple — see `mountOneCanvasRoot` for the canvas sibling. */
 async function mountOneThreeRoot(spec, ctx) {
     const { game, canvas, w, h, dpr, isBottom, headless, assets, antialias } = ctx;
     const renderer = headless
@@ -230,7 +231,7 @@ async function mountOneThreeRoot(spec, ctx) {
     };
 }
 /** Mount one canvas `RootMountSpec` (via its own `CanvasHostContext`, per D5
- *  §1/§3/§4, then `registerPixiRoot`) — the pixi sibling of
+ *  §1/§3/§4, then `registerCanvasRoot`) — the canvas sibling of
  *  `mountOneThreeRoot` above.
  *
  *  Unlike `mountOneThreeRoot`, this needs no explicit `canvas.style.width`/
@@ -247,7 +248,7 @@ async function mountOneThreeRoot(spec, ctx) {
  *  already calls `session.resize()` unconditionally right after mount, so
  *  this never surfaces as a lasting bug the way three' buffer-only resize
  *  did (never self-healing, by design — see above). */
-async function mountOnePixiRoot(spec, ctx) {
+async function mountOneCanvasRoot(spec, ctx) {
     const { game, canvas, w, h, dpr, headless, isBottom } = ctx;
     const pixiHost = {
         canvas,
@@ -260,7 +261,7 @@ async function mountOnePixiRoot(spec, ctx) {
         preserveDrawingBuffer: true,
     };
     const mounted = await spec.adapter.mount(pixiHost);
-    registerPixiRoot(game, spec.adapter, mounted, {
+    registerCanvasRoot(game, spec.adapter, mounted, {
         id: spec.id,
         pausable: spec.pausable,
         declaration: spec.declaration,
@@ -283,7 +284,7 @@ async function mountOnePixiRoot(spec, ctx) {
 }
 /**
  * Mount one React `RootMountSpec` — the DOM sibling of
- * `mountOneThreeRoot`/`mountOnePixiRoot`. Unlike its canvas-backed siblings
+ * `mountOneThreeRoot`/`mountOneCanvasRoot`. Unlike its canvas-backed siblings
  * this returns NO `routerEntry`: a react world's DOM-root layer participates in
  * D5's z-order/box stacking (the caller still creates and positions its `<div>`
  * exactly like a canvas — see `createRootsGameRuntime`'s stack-building loop)
@@ -338,7 +339,7 @@ layer) {
  * canvas for three/canvas, a DOM-root `<div>` layer for react — stacked
  * per D5 §1, z-order/ties exactly matching
  * `manifest/load.ts`'s sort, ONE `Game`, and registers every world onto it
- * via `registerThreeRoot`/`registerPixiRoot`/`registerReactRoot` — the
+ * via `registerThreeRoot`/`registerCanvasRoot`/`registerReactRoot` — the
  * 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
@@ -387,7 +388,7 @@ function installDefaultRootDevGlobals(game) {
  * Mount + register every world spec, in ARRAY (declaration) order — split
  * out of `createRootsGameRuntime` purely to keep that function's own
  * cyclomatic complexity down (E4, same reason `mountOneThreeRoot`/
- * `mountOnePixiRoot` are already split out). React roots contribute NO
+ * `mountOneCanvasRoot` are already split out). React roots contribute NO
  * router entry ("DOM layers need no entry in the router's hit-test loop"):
  * their layer's own `pointer-events` discipline handles claim/fall-through
  * natively, with zero router involvement (see `mountOneReactRoot`'s doc
@@ -414,7 +415,7 @@ async function mountAllRootSpecs(mountSpecs, bottomId, inputs) {
                 ({ mountedEntry, routerEntry } = await mountOneThreeRoot(spec, oneCtx));
             }
             else if (spec.kind === 'canvas') {
-                ({ mountedEntry, routerEntry } = await mountOnePixiRoot(spec, oneCtx));
+                ({ mountedEntry, routerEntry } = await mountOneCanvasRoot(spec, oneCtx));
             }
             else {
                 // Exhaustiveness guard (§7.4-2): 'react' was already handled by the
@@ -636,7 +637,7 @@ async function createRootsGameRuntime(config) {
     // --- Mount + register every world, in ARRAY (declaration) order. ---
     // Split out into its own top-level function purely to keep
     // `createRootsGameRuntime`'s own cyclomatic complexity down (E4) — same
-    // reason `mountOneThreeRoot`/`mountOnePixiRoot` are already split out
+    // reason `mountOneThreeRoot`/`mountOneCanvasRoot` are already split out
     // below.
     let mounted;
     try {

package/dist/runtime/game.d.ts

@@ -4,7 +4,6 @@
  * system runner, state bridge, debug registry, clock, and seeded RNG. Each
  * RootInstance retains its own mounted surface and optional capabilities.
  */
-import type * as PIXI from 'pixi.js';
 import type * as THREE from 'three';
 import type { AdapterSurface as AdapterSurfaceLeaf } from '../adapter/adapter-surface';
 import type { RootBinding } from '../adapter/binding';
@@ -141,21 +140,20 @@ export interface RootInstance {
      *  gain — see `AdapterHandle` below. */
     readonly adapter: AdapterHandle;
     /** The live mounted surface — one of `MountedRoot`'s kind-tagged shapes
-     *  (T7.5; `MountedThreeRoot` for a three world, `MountedPixiRoot` for
+     *  (T7.5; `MountedThreeRoot` for a three world, `MountedCanvasRoot` for
      *  canvas, `MountedReactRoot` for react). */
     readonly mounted: MountedRoot;
     /** Kind-narrowed accessor: throws a descriptive error when this world is
      *  not a three world. */
     threeScene(): THREE.Scene;
-    /** Kind-narrowed accessor for canvas roots (T7.3): returns the stage
-     *  passed to `createRootInstance` for a `'canvas'`-kind world. Throws
-     *  descriptively for a non-pixijs world, or a canvas world built without
-     *  a `stage` (see `RootInstanceInit.stage`). */
-    pixiStage(): PIXI.Container;
+    /** Kind-narrowed accessor for canvas roots: returns the native substrate
+     * root the adapter mounted. The host keeps it opaque; a substrate adapter
+     * that declared the matching name narrows `T`. */
+    canvasRoot<T = unknown>(): T;
     /** Kind-narrowed accessor for DOM roots: returns the
      *  DOM-root layer `<div>` the host mounted this world's react tree into
      *  (the SAME element passed as `container` to `createRootInstance` —
-     *  identity matters, mirroring `threeScene()`/`pixiStage()`'s "same
+     *  identity matters, mirroring `threeScene()`/`canvasRoot()`'s "same
      *  instance the adapter mounted" contract). Throws descriptively for a
      *  non-react world, or a react world built without a `container` (see
      *  `RootInstanceInit.container`). */
@@ -234,9 +232,9 @@ export interface RootInstanceInit {
     readonly mounted: MountedRoot;
     /** Required when `kind === 'three'` — backs `threeScene()`. */
     readonly scene?: THREE.Scene | undefined;
-    /** Required when `kind === 'canvas'` — backs `pixiStage()` (T7.3 slice 2,
-     *  symmetric with `scene` for three above). */
-    readonly stage?: PIXI.Container | undefined;
+    /** Required when `kind === 'canvas'` — backs `canvasRoot()`, symmetric with
+     * `scene` for three above. */
+    readonly canvasRoot?: unknown;
     /** Required when `kind === 'dom'` — backs `reactRoot()` (T6.2 slice 1,
      *  symmetric with `scene`/`stage` above): the DOM-root layer `<div>` this
      *  world's react tree is mounted into. */
@@ -253,7 +251,7 @@ export interface RootInstanceInit {
 /**
  * Build a `RootInstance` whose kind-narrowed accessors throw descriptively
  * on kind mismatch. This is the one place that builds
- * `threeScene`/`pixiStage`, so every world (however it's constructed, in this
+ * `threeScene`/`canvasRoot`, so every world (however it's constructed, in this
  * slice or later ones) gets identical throw behavior.
  */
 export declare function createRootInstance(init: RootInstanceInit): RootInstance;

package/dist/runtime/game.d.ts.map

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

package/dist/runtime/game.js

@@ -27,11 +27,11 @@ const DISPLAY_RATE_PHASES = PHASE_ORDER.filter((phase) => phase === SystemPhase.
 /**
  * Build a `RootInstance` whose kind-narrowed accessors throw descriptively
  * on kind mismatch. This is the one place that builds
- * `threeScene`/`pixiStage`, so every world (however it's constructed, in this
+ * `threeScene`/`canvasRoot`, so every world (however it's constructed, in this
  * slice or later ones) gets identical throw behavior.
  */
 export function createRootInstance(init) {
-    const { id, kind, pausable = true, adapter, mounted, scene, stage, container, physics, collisions, physics2d, camera, frame, binding = null, } = init;
+    const { id, kind, pausable = true, adapter, mounted, scene, canvasRoot, container, physics, collisions, physics2d, camera, frame, binding = null, } = init;
     // A three world with no scene has nothing for `threeScene()` to return —
     // fail loudly HERE, at construction, rather than letting `threeScene()`
     // throw its generic "not a three world" message later for a world whose
@@ -40,12 +40,12 @@ export function createRootInstance(init) {
         throw new Error(`RootInstance "${id}" (kind: three): a three world requires a scene — ` +
             'pass `scene` in RootInstanceInit.');
     }
-    // Symmetric check for canvas (T7.3 slice 2) — a canvas world with no stage
-    // has nothing for `pixiStage()` to return; fail loudly here, at
+    // Symmetric check for canvas — a canvas world with no native substrate root
+    // has nothing for `canvasRoot()` to return; fail loudly here, at
     // construction, same as the three/scene check above.
-    if (kind === 'canvas' && !stage) {
-        throw new Error(`RootInstance "${id}" (kind: canvas): a canvas world requires a stage — ` +
-            'pass `stage` in RootInstanceInit.');
+    if (kind === 'canvas' && (canvasRoot === undefined || canvasRoot === null)) {
+        throw new Error(`RootInstance "${id}" (kind: canvas): a canvas world requires a native substrate root — ` +
+            'pass `canvasRoot` in RootInstanceInit.');
     }
     // Symmetric check for react (T6.2 slice 1) — a react world with no
     // container has nothing for `reactRoot()` to return; fail loudly here,
@@ -111,21 +111,18 @@ export function createRootInstance(init) {
             }
             return scene;
         },
-        pixiStage() {
-            // The `!stage` branch a canvas world could hit here is now unreachable
-            // (T7.3 slice 2): construction above throws for `kind === 'canvas'`
-            // with no `stage`, symmetric with `threeScene()`'s `scene` guard.
-            if (kind !== 'canvas' || !stage) {
-                throw new Error(`RootInstance "${id}" (kind: ${kind}): pixiStage() requested but this world is not ` +
+        canvasRoot() {
+            if (kind !== 'canvas' || canvasRoot === undefined || canvasRoot === null) {
+                throw new Error(`RootInstance "${id}" (kind: ${kind}): canvasRoot() requested but this world is not ` +
                     'a canvas world');
             }
-            return stage;
+            return canvasRoot;
         },
         reactRoot() {
             // The `!container` branch a react world could hit here is now
             // unreachable (T6.2 slice 1): construction above throws for
             // `kind === 'dom'` with no `container`, symmetric with
-            // `threeScene()`/`pixiStage()`'s guards.
+            // `threeScene()`/`canvasRoot()`'s guards.
             if (kind !== 'dom' || !container) {
                 throw new Error(`RootInstance "${id}" (kind: ${kind}): reactRoot() requested but this world is not ` +
                     'a react world');

package/dist/runtime/render-control.d.ts.map

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

package/dist/runtime/render-control.js

@@ -159,7 +159,12 @@ function countRoots(game) {
             counts.push({ id: world.id, kind: world.kind, ...countRootGraph(world.threeScene()) });
         }
         else if (world.kind === 'canvas') {
-            counts.push({ id: world.id, kind: world.kind, ...countRootGraph(world.pixiStage()) });
+            // Node counting is a substrate projection, not a surface fact. Pixi's
+            // native tree exposes `children`; other canvas substrates are omitted
+            // until their adapter declares an honest counter.
+            if (world.mounted.kind === 'canvas' && world.mounted.substrate.name === 'pixi') {
+                counts.push({ id: world.id, kind: world.kind, ...countRootGraph(world.canvasRoot()) });
+            }
         }
     }
     return counts;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/engine",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.25",
+  "version": "0.5.26",
   "description": "Readable TypeScript game engine and universal host for Three.js, PixiJS, and React games.",
   "keywords": [
     "game-engine",

package/src/adapter/adapter-module.ts

@@ -51,13 +51,12 @@ import { WRITE_ANCHOR_KINDS, type WriteAnchorKind } from './authoring';
 // ---------------------------------------------------------------------------
 
 /**
- * The projector serving a surface — one per surface, host-owned
- * (ARCHITECTURE-CORE: "Projection — nodes, stable identity, bounds, picking …
- * one projector per surface"). Named, never imported: the adapter states WHICH
- * library serves the region; the host binds the implementation.
+ * The native substrate serving a region. A surface is only the host-provided
+ * medium (`canvas`); this declaration is what distinguishes Pixi, Babylon and
+ * Phaser without runtime sniffing.
  */
-export const PROJECTOR_NAMES = ['three', 'pixi', 'dom'] as const;
-export type ProjectorName = (typeof PROJECTOR_NAMES)[number];
+export const SUBSTRATE_NAMES = ['three', 'pixi', 'dom', 'babylon', 'phaser'] as const;
+export type SubstrateName = (typeof SUBSTRATE_NAMES)[number];
 
 /**
  * A region's WORLD BASIS — which axis points up, and where its ground sits.
@@ -100,8 +99,8 @@ export interface AdapterRegion {
   readonly id: string;
   /** What the host hands this root. */
   readonly surface: AdapterSurface;
-  /** Projection library, by name. */
-  readonly projector: ProjectorName;
+  /** Native substrate, by name. */
+  readonly substrate: SubstrateName;
   /**
    * Dialect writer, by name (`r3f`, `jsx`, `pixi-react`, …) — the truth
    * family's source writer for this region. `null` states outright that the
@@ -223,7 +222,7 @@ const AdapterRegionSchema = z
   .object({
     id: z.string().min(1).describe('Manifest root id this region grades'),
     surface: z.enum(['three', 'canvas', 'dom']).describe('Render surface the host hands this root'),
-    projector: z.enum(PROJECTOR_NAMES).describe('Projection library serving this surface, by name'),
+    substrate: z.enum(SUBSTRATE_NAMES).describe('Native substrate serving this region, by name'),
     dialect: z
       .string()
       .min(1)
@@ -412,13 +411,13 @@ export function unmatchedRegionIncludeIds(
 function derivedRegion(root: ResolvedAdapterRoot): AdapterRegion {
   const surface = root.surface;
   const firstParty = root.adapter.type === 'builtin';
-  const projector: ProjectorName = surface === 'canvas' ? 'pixi' : surface;
+  const substrate: SubstrateName = surface === 'canvas' ? 'pixi' : surface;
   const basis = NATIVE_REGION_BASIS;
   if (!firstParty) {
     return {
       id: root.id,
       surface,
-      projector,
+      substrate,
       dialect: null,
       anchors: ['live-only'] as const,
       basis,
@@ -428,7 +427,7 @@ function derivedRegion(root: ResolvedAdapterRoot): AdapterRegion {
     return {
       id: root.id,
       surface,
-      projector,
+      substrate,
       dialect: 'jsx',
       anchors: ['source-prop', 'source-structure'] as const,
       basis,
@@ -437,7 +436,7 @@ function derivedRegion(root: ResolvedAdapterRoot): AdapterRegion {
   return {
     id: root.id,
     surface,
-    projector,
+    substrate,
     dialect: surface === 'three' ? 'r3f' : 'pixi-react',
     anchors: ['source-prop', 'source-structure', 'construction-literal'] as const,
     basis,

package/src/adapter/binding.ts

@@ -226,7 +226,9 @@ export type EntryStaticSurface =
 /** Everything the hosted build's bundle map carries for one root. */
 export interface BundledEntrySubset {
   /** The entry's default-exported world component. */
-  readonly default: unknown;
+  readonly default?: unknown;
+  /** An imperative canvas entry's explicit root adapter. */
+  readonly adapter?: unknown;
   readonly debug?: unknown;
   readonly systems?: unknown;
   readonly components?: unknown;
@@ -361,7 +363,7 @@ export interface RootDeclaration {
  *
  * 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
+ * (`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

package/src/adapter/index.ts

@@ -2,7 +2,7 @@
  * Adapter interfaces — the seams the engine host and the editor DEPEND ON.
  *
  *   host    → RootAdapter ← { r3fRootFactory-built adapters, IngestRootAdapter, … }
- *   editor  → AuthoringAdapter ← { LiveThreeAuthoringAdapter, ReactRootAuthoringAdapter, … }
+ *   editor  → AuthoringAdapter ← { ThreeAuthoringAdapter, ReactRootAuthoringAdapter, … }
  *   game    → SystemAdapters (physics/networking/navigation/audio/camera/debug)
  *
  * The first-party Rapier/Colyseus stack is ONE implementer of these
@@ -111,6 +111,8 @@ export type {
   ThreeHostContext,
 } from './host-context';
 export type {
+  MountedCanvasRoot,
+  MountedCanvasSubstrate,
   MountedPixiRoot,
   MountedReactRoot,
   MountedRoot,

package/src/adapter/ingest/structural-ids.ts

@@ -1,6 +1,6 @@
 /**
  * Structural identity — the deterministic id scheme (and the small material
- * reflection helper that rides along with it) the editor's live-three authoring
+ * reflection helper that rides along with it) the editor's three authoring
  * adapter uses to address the objects of a world whose source carries no
  * serve-time identity stamps
  * (`packages/editor/src/projection/three.ts`, `structuralIdentity`).

package/src/adapter/root-adapter.ts

@@ -48,7 +48,7 @@ export interface RootStateObserver {
 /**
  * Everything a mounted world provides except its render surface. Tagged
  * mounted-root variants carry their native surface fields: a Three scene and
- * camera, a Pixi stage, or a DOM container.
+ * camera, a declared canvas substrate root, or a DOM container.
  */
 export interface MountedRootBase {
   /**
@@ -116,12 +116,34 @@ export interface MountedThreeRoot extends MountedRootBase {
   readonly rendererConfig?: WorldRendererConfig | undefined;
 }
 
-/** A live, mounted canvas world (T7.3) — the pixi analog of
- *  {@link MountedThreeRoot}. `stage` is the pixi world container the host
- *  renders/authors, the surface `RootInstance.pixiStage()` returns. */
-export interface MountedPixiRoot extends MountedRootBase {
+/**
+ * A canvas substrate's native root, carried without teaching the universal
+ * host that substrate's API. The declaration is explicit — editor substrate
+ * adapters dispatch on `name`; they never infer a library from object shape.
+ */
+export interface MountedCanvasSubstrate<T = unknown> {
+  readonly name: string;
+  readonly root: T;
+  /** The substrate's own module namespace when authoring needs constructors
+   * (for example Babylon's native GizmoManager). Omitted when the projection
+   * only needs the root itself, as Pixi's does. */
+  readonly api?: unknown;
+}
+
+/** A live, mounted canvas world. The host owns the canvas and lifecycle; the
+ * mounted root states which native substrate inhabits it and hands that
+ * substrate's root through opaquely. */
+export interface MountedCanvasRoot extends MountedRootBase {
   readonly kind: 'canvas';
-  readonly stage: Container;
+  /** The same host-owned canvas passed to `mount`. */
+  readonly canvas: HTMLCanvasElement;
+  readonly substrate: MountedCanvasSubstrate;
+}
+
+/** Pixi's substrate-narrowed mounted shape. This is an implementer type, not
+ * the host contract: generic canvas hosts depend on {@link MountedCanvasRoot}. */
+export interface MountedPixiRoot extends MountedCanvasRoot {
+  readonly substrate: MountedCanvasSubstrate<Container> & { readonly name: 'pixi' };
 }
 
 /** A live, mounted react world (T6.2) — the react analog of
@@ -134,7 +156,7 @@ export interface MountedReactRoot extends MountedRootBase {
 }
 
 /** Every kind of live, mounted world. */
-export type MountedRoot = MountedThreeRoot | MountedPixiRoot | MountedReactRoot;
+export type MountedRoot = MountedThreeRoot | MountedCanvasRoot | MountedReactRoot;
 
 /** Map a {@link AdapterSurface} to its mounted-world shape — lets generic
  *  code over
@@ -142,7 +164,7 @@ export type MountedRoot = MountedThreeRoot | MountedPixiRoot | MountedReactRoot;
 export type MountedRootFor<K extends AdapterSurface> = K extends 'three'
   ? MountedThreeRoot
   : K extends 'canvas'
-    ? MountedPixiRoot
+    ? MountedCanvasRoot
     : K extends 'dom'
       ? MountedReactRoot
       : never;
@@ -162,7 +184,7 @@ export type MountedRootFor<K extends AdapterSurface> = K extends 'three'
  * The `= 'three'` default is type-level only: an author who writes bare
  * `RootAdapter` for
  * a pixi root gets a compile error on `mount`'s return type, because
- * `MountedRootFor<'three'>` demands `scene`/`camera` a `MountedPixiRoot` has
+ * `MountedRootFor<'three'>` demands `scene`/`camera` a `MountedCanvasRoot` has
  * not got.
  */
 export interface RootAdapter<K extends AdapterSurface = 'three'> {