@volter/editor-game 0.5.66 → 0.5.68

package/src/ingest/mount-canvas-ingest-root.ts

@@ -22,8 +22,8 @@
 
 import { measureAdapterReach } from '../host/adapter-reach';
 import { nextPaint } from '../host/after-paint';
-import { setActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
-import { setActiveSystems } from '@volter/editor-core/authoring/active-systems';
+import { setActiveAuthoring } from '@volter/editor-sdk/kit/authoring/active-adapter';
+import { setActiveSystems } from '@volter/editor-sdk/kit/authoring/active-systems';
 import { BabylonAuthoringAdapter } from '../host/authoring/babylon-authoring-adapter';
 import {
   type BabylonRealmLike,
@@ -43,9 +43,9 @@ import { resolveCanvasPixiForEditor } from '../host/canvas-entry-runtime';
 import {
   capturePixiDisplayObjectThumbnail,
   registerPresentedPixiApps,
-} from '@volter/editor-core/canvas-preview-frames';
+} from '../host/canvas-preview-frames';
 import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import { GAME_SURFACE_CONTAINMENT_CSS } from '../host/game-realm-page';
 import {
   clearGameSurface,
@@ -55,20 +55,20 @@ import {
 } from '../host/gated-globals';
 import { authoringJournal } from '../host/history/json-history-resource';
 import { acquireLiveDocument, liveDocumentContainer } from '@volter/editor-sdk/kit/live-document';
-import { getCurrentProject } from '@volter/editor-core/project-manager';
+import { getCurrentProject } from '@volter/editor-sdk/kit/active-project';
 import { recordRootReadiness } from '@volter/editor-sdk/kit/readiness';
 import type { MeasuredLoop } from '../host/same-realm-loop-gate';
-import { projectContractSystemAdapters } from '@volter/game-runtime/adapter/ingest/contract-system-adapters';
-import type { RenderDebugWiring } from '@volter/game-runtime/dev/render-debug-adapter';
-import type { IngestGame2D } from '@volter/game-runtime/pixi/ingest';
-import { INGEST_GAME_2D_LOAD_ERROR_NAME, mountIngestGame2D } from '@volter/game-runtime/pixi/ingest';
-import { createPhysics2DRegistry } from '@volter/game-runtime/pixi/physics-registry';
-import { installPixiRenderPassBracket } from '@volter/game-runtime/pixi/render-pass-bracket';
+import { projectContractSystemAdapters } from '../runtime/adapter/ingest/contract-system-adapters';
+import type { RenderDebugWiring } from '../runtime/dev/render-debug-adapter';
+import type { IngestGame2D } from '../runtime/pixi/ingest';
+import { INGEST_GAME_2D_LOAD_ERROR_NAME, mountIngestGame2D } from '../runtime/pixi/ingest';
+import { createPhysics2DRegistry } from '../runtime/pixi/physics-registry';
+import { installPixiRenderPassBracket } from '../runtime/pixi/render-pass-bracket';
 import {
   composePhysicsAdapters2D,
   createPhysicsAdapter2D,
   type PhysicsAdapter2D,
-} from '@volter/game-runtime/pixi/system-adapters';
+} from '../runtime/pixi/system-adapters';
 import type { AuthoringAdapter } from '@volter/editor-project/adapter/authoring';
 import { readGameReady } from '@volter/editor-project/adapter/ingest/game-contract';
 import { displayKeyedPhysics } from '@volter/editor-project/adapter/system-adapter';
@@ -214,7 +214,7 @@ function rendererCanvasBelongsToHost(renderer: unknown, hostEl: HTMLElement): bo
  * The projection is the ONE validator: presence + typeof for the four members,
  * plus the keying check that makes a node-id-keyed declaration on this surface
  * `malformed` by name instead of a bound shape nothing here can call
- * (`@volter/game-runtime/adapter/ingest/contract-system-adapters`). Both verdicts reach
+ * (`@volter/editor-game/runtime/adapter/ingest/contract-system-adapters`). Both verdicts reach
  * the reader through the coverage row for `system.physics`, so a refusal here
  * is never silent.
  */
@@ -339,7 +339,7 @@ function publishStructuralCanvasRuntime(
   });
   disposeScene = installIngestCanvasScene(store);
 
-  setGameInputGate(() => store.playState === 'playing' && store.activeViewportTab === 'play');
+  setGameInputGate(() => store.shell.playState === 'playing' && store.shell.activeViewportTab === 'play');
   setActiveAuthoring(adapter);
   // No captured Pixi renderer on this branch — the host's pixi drew nothing, so
   // there is no context to instrument, no runner pair to bracket, and no
@@ -347,7 +347,7 @@ function publishStructuralCanvasRuntime(
   // declared is the only physics this route can have.
   publishCanvasIngestSystems(game.name, undefined, declaredCanvasPhysics());
   landIngestBootInEdit();
-  store.notifyIngestEdit();
+  store.shell.notifyIngestEdit();
   clearMountFailureReports();
 
   recordMountCoverage({
@@ -395,7 +395,7 @@ async function mountCanvasIngestRootInner(
     return;
   }
 
-  store.setPlayState('playing');
+  store.shell.setPlayState('playing');
   editorConsole.log(`Ingesting unmodified PixiJS game: ${game.name}`, 'ingest');
 
   // PD-3: READINESS, RECORDED. The three lane's self-booting mount has always
@@ -473,7 +473,7 @@ async function mountCanvasIngestRootInner(
     markGameCssScope(hostEl);
     const scopedCssProject = getCurrentProject();
     if (scopedCssProject) {
-      const { ensureScopedGameStyles } = await import('@volter/editor-core/scoped-game-css');
+      const { ensureScopedGameStyles } = await import('@volter/editor-sdk/kit/scoped-game-css');
       await ensureScopedGameStyles(scopedCssProject.rootPath);
     }
   }
@@ -587,7 +587,7 @@ async function mountCanvasIngestRootInner(
   }
 
   // The captured `Application` — the game's own, trapped on its first render
-  // (`@volter/game-runtime/pixi/scene-capture`). Two things hang off it, and neither is
+  // (`@volter/editor-game/runtime/pixi/scene-capture`). Two things hang off it, and neither is
   // available anywhere else.
   const app = mount.capture.captured?.app as Application | undefined;
 
@@ -685,7 +685,7 @@ async function mountCanvasIngestRootInner(
     journal: authoringJournal(sessionId),
     target: createCreationSiteCanvasWriteTarget({
       physics: physicsAdapter,
-      history: store.projectHistory,
+      history: store.shell.projectHistory,
     }),
     ...(stories ? { stories } : {}),
     // The captured game canvas is the screen↔stage mapping `pickable`/`rects`
@@ -755,7 +755,7 @@ async function mountCanvasIngestRootInner(
   // R2c: PixiJS ingest fixtures (`ingest/games/**`) are just as
   // unshadowed-by-default as the three.js ones — drive the same gate as
   // {@link mountThreeIngestRoot} (see that function's doc comment).
-  setGameInputGate(() => store.playState === 'playing' && store.activeViewportTab === 'play');
+  setGameInputGate(() => store.shell.playState === 'playing' && store.shell.activeViewportTab === 'play');
 
   setActiveAuthoring(adapter);
   // The captured game's OWN renderer — the one object that carries both halves
@@ -771,7 +771,7 @@ async function mountCanvasIngestRootInner(
     declaredPhysics ? physicsAdapter : null,
   );
   landIngestBootInEdit();
-  store.notifyIngestEdit();
+  store.shell.notifyIngestEdit();
   clearMountFailureReports(); // D-W3: mount succeeded
   // PD-3: the mount stood — but `contract-ready` may only be recorded when the
   // declared promise actually ANSWERED. The three lane's `awaitWorldReady`

package/src/ingest/mount-coverage.ts

@@ -13,7 +13,7 @@
  */
 
 import type { AdapterReach } from '../host/adapter-reach';
-import { getActiveSystems } from '@volter/editor-core/authoring/active-systems';
+import { getActiveSystems } from '@volter/editor-sdk/kit/authoring/active-systems';
 import { ingestDataWriterNow } from '../host/authoring/ingest-data-writer';
 import { ingestOwnershipNow } from '../host/authoring/ingest-source-persistence';
 import {
@@ -36,7 +36,7 @@ import {
 import {
   type ContractSurface,
   projectContractSystemAdapters,
-} from '@volter/game-runtime/adapter/ingest/contract-system-adapters';
+} from '../runtime/adapter/ingest/contract-system-adapters';
 import type { VgaiGameContract } from '@volter/editor-project/adapter/ingest/game-contract';
 import type { SystemAdapters } from '@volter/editor-project/adapter/system-adapter';
 import { activeIngest } from './active-ingest';

package/src/ingest/mount-dom-ingest-root.ts

@@ -6,12 +6,12 @@
  */
 
 import { measureAdapterReach } from '../host/adapter-reach';
-import { setActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
-import { setActiveSystems } from '@volter/editor-core/authoring/active-systems';
+import { setActiveAuthoring } from '@volter/editor-sdk/kit/authoring/active-adapter';
+import { setActiveSystems } from '@volter/editor-sdk/kit/authoring/active-systems';
 import { clearMountFailureReports } from '@volter/editor-sdk/kit/mount-failure-report';
 import { resolveAllRoots } from '../host/binding-resolver';
 import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import { setGameInputGate } from '../host/gated-globals';
 import { authoringJournal } from '../host/history/json-history-resource';
 import { acquireLiveDocument, liveDocumentContainer } from '@volter/editor-sdk/kit/live-document';
@@ -89,14 +89,14 @@ async function mountDomIngestRootInner(store: EditorShellStore, folderId: string
   // react session — closes the cross-kind leak (F26 residual).
   exitActiveIngest();
 
-  store.setPlayState('playing');
+  store.shell.setPlayState('playing');
   editorConsole.log(`Ingesting unmodified native-React game: ${game.manifest.name}`, 'ingest');
 
   // F26: same cold-mount announcement as the other ingest routes — the react
   // world's entry executes in the editor realm and may declare the game
   // contract to defer its session until ▶. Opt-in, never demanded.
   (window as unknown as { __vgaiMountCold?: boolean }).__vgaiMountCold = true;
-  const { createGameRuntime } = await import('@volter/game-runtime/runtime/create-runtime');
+  const { createGameRuntime } = await import('../runtime/create-runtime');
   const specs = await resolveAllRoots(game.manifest, projectRoot);
   const w = gameContainer.clientWidth;
   const h = gameContainer.clientHeight;
@@ -144,12 +144,12 @@ async function mountDomIngestRootInner(store: EditorShellStore, folderId: string
   // `game-globals-shadow.ts` roots its shadow at — so a native-React fixture's
   // own listeners are shadowed on the same terms as every other surface's now
   // (this comment used to record the opposite, from the R-N6 residual).
-  setGameInputGate(() => store.playState === 'playing' && store.activeViewportTab === 'play');
+  setGameInputGate(() => store.shell.playState === 'playing' && store.shell.activeViewportTab === 'play');
 
   setActiveAuthoring(adapter);
   setActiveSystems({});
   landIngestBootInEdit();
-  store.notifyIngestEdit();
+  store.shell.notifyIngestEdit();
   clearMountFailureReports(); // D-W3: mount succeeded
 
   const coverage = domMountCoverage(adapter);
@@ -207,7 +207,7 @@ export async function mountDomIngestRootFromManifest(
   // react session — closes the cross-kind leak (F26 residual).
   exitActiveIngest();
 
-  store.setPlayState('playing');
+  store.shell.setPlayState('playing');
   editorConsole.log(
     `Ingesting unmodified native-React game (external folder): ${world.id}`,
     'ingest',
@@ -216,7 +216,7 @@ export async function mountDomIngestRootFromManifest(
   // F26: same cold-mount announcement the vendored route makes — an
   // external-folder game may declare the game contract too.
   (window as unknown as { __vgaiMountCold?: boolean }).__vgaiMountCold = true;
-  const { createGameRuntime } = await import('@volter/game-runtime/runtime/create-runtime');
+  const { createGameRuntime } = await import('../runtime/create-runtime');
   const specs = await resolveAllRoots({ ...manifest, roots: [world] }, projectRoot);
   const w = gameContainer.clientWidth;
   const h = gameContainer.clientHeight;
@@ -249,12 +249,12 @@ export async function mountDomIngestRootFromManifest(
     siblings: [],
     worldId: world.id,
   });
-  setGameInputGate(() => store.playState === 'playing' && store.activeViewportTab === 'play');
+  setGameInputGate(() => store.shell.playState === 'playing' && store.shell.activeViewportTab === 'play');
 
   setActiveAuthoring(adapter);
   setActiveSystems({});
   landIngestBootInEdit();
-  store.notifyIngestEdit();
+  store.shell.notifyIngestEdit();
   clearMountFailureReports(); // D-W3: mount succeeded
 
   const coverage = domMountCoverage(adapter);

package/src/ingest/mount-ingest-root.ts

@@ -23,11 +23,11 @@
  * path is therefore its catch block.
  */
 
-import { getAuthoringOverride, setActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
+import { getAuthoringOverride, setActiveAuthoring } from '@volter/editor-sdk/kit/authoring/active-adapter';
 import {
   CompositeAuthoringAdapter,
   type CompositeChild,
-} from '@volter/editor-core/authoring/composite-authoring-adapter';
+} from '@volter/editor-sdk/kit/authoring/composite-authoring-adapter';
 import {
   addMountFailureReport,
   clearMountFailureReports,
@@ -36,12 +36,11 @@ import {
   type MountFailureReport,
 } from '@volter/editor-sdk/kit/mount-failure-report';
 import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import { registerEditorStateFacet } from '@volter/editor-sdk/kit/editor-state-facets';
 import { liveDocumentContainer } from '@volter/editor-sdk/kit/live-document';
-import { fetchGameManifest, isManifestAbsence } from '@volter/editor-core/manifest-project';
-import { getCurrentProject } from '@volter/editor-core/project-manager';
-import { onThreeStore } from '@volter/editor-core/shell-store-door';
+import { fetchGameManifest, isManifestAbsence } from '@volter/editor-sdk/kit/manifest-project';
+import { getCurrentProject } from '@volter/editor-sdk/kit/active-project';
 import { ingestRoots, rootById } from '@volter/editor-project/adapter/manifest-interpreter';
 import { MANIFEST_FILENAME } from '@volter/editor-project/manifest/filename';
 import type { ResolvedAdapterRoot, ResolvedGameManifest } from '@volter/editor-project/manifest/load';
@@ -76,6 +75,7 @@ export {
   unmountDomIngestRoot,
   unmountThreeIngestRoot,
 } from './unmount-ingest-root';
+import { onThreeStore } from '@volter/editor-threejs/kit/three-state';
 
 type CanvasMounts = typeof import('./mount-canvas-ingest-root');
 type DomMounts = typeof import('./mount-dom-ingest-root');
@@ -197,13 +197,13 @@ function reportFailedIngestMount(store: EditorShellStore, report: MountFailureRe
   resetIngestPlaySurface();
   // The prologue's `setPlayState('playing')` must never outlive a failed mount
   // — that flag is what `collectState` reported as a live game (S-1).
-  store.setPlayState('stopped');
+  store.shell.setPlayState('stopped');
   addMountFailureReport(report);
   // `addMountFailureReport` notifies the status item through the slot's own
   // subscribe; this broadcast is for the STORE-subscribed panels (hierarchy,
   // play controls) that must re-render off the teardown above — a failed
   // mount never reaches the success path's `notifyIngestEdit()`.
-  store.notifyIngestEdit();
+  store.shell.notifyIngestEdit();
 }
 
 /**

package/src/ingest/mount-three-ingest-root.ts

@@ -19,15 +19,15 @@
  */
 
 import { measureAdapterReach } from '../host/adapter-reach';
-import { setActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
-import { setActiveSystems } from '@volter/editor-core/authoring/active-systems';
+import { setActiveAuthoring } from '@volter/editor-sdk/kit/authoring/active-adapter';
+import { setActiveSystems } from '@volter/editor-sdk/kit/authoring/active-systems';
 import { withContractHierarchy } from '../host/authoring/contract-hierarchy-authoring';
 import { clearMountFailureReports } from '@volter/editor-sdk/kit/mount-failure-report';
 import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import { gameLoopGate, setGameInputGate } from '../host/gated-globals';
 import { acquireLiveDocument, liveDocumentContainer } from '@volter/editor-sdk/kit/live-document';
-import { pickGameCamera } from '@volter/editor-core/scene-framing';
+import { pickGameCamera } from '@volter/editor-threejs/kit/scene-framing';
 import type { ResolvedAdapterRoot } from '@volter/editor-project/manifest/load';
 import type { CaptureMechanism } from '@volter/threejs-runtime/adapter/ingest/scene-capture';
 import { type IngestSession, serializeEntry, setActiveIngest } from './active-ingest';
@@ -165,7 +165,7 @@ function activateCapturedThreeIngest(args: {
   // world in for several seconds afterwards.
   store.focusOnScene(() => pickGameCamera(mount.capture.captured?.camera, liveScene));
   landIngestBootInEdit();
-  store.notifyIngestEdit(); // ensure panels re-render against the override
+  store.shell.notifyIngestEdit(); // ensure panels re-render against the override
   clearMountFailureReports(); // D-W3: mount succeeded
 
   // What this editor CANNOT do with this game, said out loud once, right where
@@ -241,7 +241,7 @@ async function mountThreeIngestRootInner(
   // own persistence provider, which is what EditorShellStore's autosave/saveNow
   // now consult (design). Still switch into the guarded "playing" state so the
   // viewport swaps onto the live scene.
-  store.setPlayState('playing');
+  store.shell.setPlayState('playing');
   editorConsole.log(`Ingesting unmodified game: ${game.name}`, 'ingest');
 
   // Drive the SAME input gate play-mode uses (play-mode.ts's
@@ -252,7 +252,7 @@ async function mountThreeIngestRootInner(
   // tab is the active viewport surface, exactly like a first-party play
   // session.
   const ingestInputActive = () =>
-    store.playState === 'playing' && store.activeViewportTab === 'play';
+    store.shell.playState === 'playing' && store.shell.activeViewportTab === 'play';
 
   try {
     const mountOpts: MountIngestOptions = { captureTimeoutMs: game.captureTimeoutMs };
@@ -285,7 +285,7 @@ async function mountThreeIngestRootInner(
     // holds when the gate CLOSES — leaving play, or switching to the Edit tab
     // mid-flight — must be released, or the editor is left with a captured,
     // invisible cursor over a game that is no longer receiving input.
-    session.inputGateUnsubscribe = store.subscribe(() => {
+    session.inputGateUnsubscribe = store.shell.subscribe(() => {
       if (!ingestInputActive()) releaseGamePointerLock();
     });
     // The realm gate only just became reachable, so push the play state we

package/src/ingest/resolve-canvas.ts

@@ -4,7 +4,7 @@
  * is a per-PROJECT property, not a per-realm one.
  */
 
-import type { IngestGame2D } from '@volter/game-runtime/pixi/ingest';
+import type { IngestGame2D } from '../runtime/pixi/ingest';
 import type { ResolvedAdapterRoot } from '@volter/editor-project/manifest/load';
 import { composeIngestLoad } from './entry-load';
 import { ingestModuleLoaders } from './resolve-three';

package/src/ingest/served-html-boot.ts

@@ -27,7 +27,7 @@
  *    `document.body` (`setGameSurface`), absolutely positioned and full-size,
  *    so the transplanted body lands in a real box.
  *  - STYLE it. The root's `styles` manifest field serves the bundle's own
- *    stylesheet rewritten into `@scope` (`server/scoped-game-css.ts`), which is
+ *    stylesheet rewritten into `@scope` (`@volter/editor-sdk/session/scoped-game-css`), which is
  *    what turns `#root,body,html{width:100%;height:100%}` into a sized root
  *    without the editor seeing one of those rules. A `<link rel=stylesheet>` in
  *    the document is NOT auto-loaded here: an unscoped page sheet restyles the

package/src/ingest/surface-canvas.ts

@@ -19,7 +19,7 @@ import {
   type IngestEntry,
   ingestEntriesOnSurface,
 } from '../host/ingest/registry';
-import type { IngestGame2D } from '@volter/game-runtime/pixi/ingest';
+import type { IngestGame2D } from '../runtime/pixi/ingest';
 import { composeIngestLoad } from './entry-load';
 
 type BaseFields2D = Pick<IngestGame2D, 'id' | 'name' | 'description' | 'captureTimeoutMs'>;

package/src/ingest/unmount-ingest-root.ts

@@ -16,8 +16,8 @@
  * resetting the gate is no longer a separate step.
  */
 
-import { setActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
-import { setActiveSystems } from '@volter/editor-core/authoring/active-systems';
+import { setActiveAuthoring } from '@volter/editor-sdk/kit/authoring/active-adapter';
+import { setActiveSystems } from '@volter/editor-sdk/kit/authoring/active-systems';
 import { clearMountFailureReports } from '@volter/editor-sdk/kit/mount-failure-report';
 import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import { reclaimGameRealm } from '../host/game-realm-reclaim';
@@ -121,7 +121,7 @@ function disposeThreejsSession(s: IngestSession): void {
       /* scene may not have been swapped if capture failed */
     }
   }
-  s.store.setPlayState('stopped');
+  s.store.shell.setPlayState('stopped');
 
   // Tear down the mounted game (stops its loop, frees renderer, uninstalls trap).
   try {
@@ -153,7 +153,7 @@ function disposePixiSession(s: IngestSession2D): void {
   setActiveAuthoring(null);
   setActiveSystems(null);
   clearMountFailureReports(); // D-W3: no session -> nothing left to report
-  s.store.setPlayState('stopped');
+  s.store.shell.setPlayState('stopped');
   try {
     s.dispose();
   } catch {
@@ -177,7 +177,7 @@ function disposeReactSession(s: IngestSessionReact): void {
   setActiveAuthoring(null);
   setActiveSystems(null);
   clearMountFailureReports(); // D-W3: no session -> nothing left to report (mirrors disposeThreejsSession's identical call)
-  s.store.setPlayState('stopped');
+  s.store.shell.setPlayState('stopped');
   try {
     s.stop();
   } catch {

package/src/navmesh/navmesh-handler.ts

@@ -1,4 +1,4 @@
-import { getActiveSystems } from '@volter/editor-core/authoring/active-systems';
+import { getActiveSystems } from '@volter/editor-sdk/kit/authoring/active-systems';
 import { editorHost } from '@volter/editor-sdk/host';
 import type { NavigationAdapter } from '@volter/editor-project/adapter';
 import { getUserData } from '@volter/threejs-runtime/ecs/user-data';
@@ -11,18 +11,21 @@ import {
   navBakeBusy,
   resetNavMeshBaked,
 } from './navmesh-workflow-store';
+import { threeNavigation } from '@volter/editor-threejs/adapter/three-contract';
+import { hostHierarchyObjects } from '@volter/editor-threejs/host-hierarchy-objects';
+import { setViewportHelper, viewportRig } from '@volter/editor-threejs/viewport-door';
 
 /**
  * The game skew's side of the Navigation verbs: bake/clear and the walkable
- * overlay tint, shown through the viewport door (`host.viewport.setHelper`,
+ * overlay tint, shown through the viewport door (`viewport-door`'s `setViewportHelper`,
  * kind `navmesh` — the Helpers menu's own toggle).
  *
  * Started by `contributions/navmesh.service.ts`, so its lifetime is the
  * contribution pass; it used to be a mount effect in the editor's scene panel,
  * which made a host panel the owner of a game-skew tool.
  *
- * It reads the authoring scene through `host.hierarchy.objects()` and the
- * viewport through `host.viewport.setHelper` / `.rig()`, but keeps the
+ * It reads the authoring scene through `host-hierarchy-objects` and the
+ * viewport through `viewport-door`'s `setViewportHelper` / `.rig()`, but keeps the
  * `@editor/authoring/active-systems` import for the adapter itself: the bake
  * collects the PRIMARY AUTHORING mount's walkable meshes, so the adapter it
  * bakes into must be that same mount's — `getActiveSystems()`. The door's
@@ -63,20 +66,21 @@ export function setupNavMeshHandlers(): () => void {
    */
   function collectNavigationIds(role: 'walkable' | 'obstacle'): Set<string> {
     const ids = new Set<string>();
-    for (const [id, obj] of editorHost().hierarchy.objects()) {
+    for (const [id, obj] of (hostHierarchyObjects()?.objects() ?? new Map<string, THREE.Object3D>())) {
       if (getUserData(obj, 'navRole') === role) ids.add(id);
     }
     return ids;
   }
 
   function clearPresentation(): void {
-    editorHost().viewport.setHelper('navmesh', null);
+    setViewportHelper('navmesh', null);
   }
 
   /** Follow late registration/replacement of the primary mounted adapter. A
    * root may register navigation only after its async WASM setup completes. */
   function syncMountedNavigation(): void {
-    const nav = getActiveSystems().navigation ?? null;
+    const active = getActiveSystems().navigation;
+    const nav = active ? threeNavigation(active) : null;
     if (nav !== boundNavigation) {
       boundNavigation = nav;
       clearPresentation();
@@ -101,7 +105,7 @@ export function setupNavMeshHandlers(): () => void {
     markNavMeshBaked();
     // The adapter builds its debug mesh against the editor's scene; without
     // a mounted viewport there is nothing to show it in.
-    const scene = editorHost().viewport.rig()?.scene;
+    const scene = viewportRig()?.scene;
     if (!scene) return;
     let debugMesh: THREE.Object3D | null = null;
     try {
@@ -114,7 +118,7 @@ export function setupNavMeshHandlers(): () => void {
     }
     if (debugMesh) {
       applyWalkableTint(debugMesh);
-      editorHost().viewport.setHelper('navmesh', debugMesh);
+      setViewportHelper('navmesh', debugMesh);
     }
   }
 
@@ -124,7 +128,8 @@ export function setupNavMeshHandlers(): () => void {
     // Recast's solo bake is synchronous WASM — yield a frame so the Bake
     // button visibly paints its busy state before the build blocks the thread.
     await new Promise((r) => requestAnimationFrame(() => r(null)));
-    const nav = getActiveSystems().navigation;
+    const active = getActiveSystems().navigation;
+    const nav = active ? threeNavigation(active) : undefined;
     if (!nav) {
       const reason = 'The mounted game has no NavigationAdapter';
       editorHost().console.warn(`${reason} — nothing can be baked`, 'navigation');
@@ -141,7 +146,9 @@ export function setupNavMeshHandlers(): () => void {
     const walkableIds = collectNavigationIds('walkable');
     if (walkableIds.size === 0) {
       editorHost().console.warn(
-        'No walkable entities found — tag meshes as "walkable" in the Navigation section',
+        // The role is the object's own `userData.navRole` (see `collectNavigationIds`); a source
+        // world tags it where the mesh is written.
+        'No walkable meshes found — give the floors `userData={{ navRole: \'walkable\' }}` (and blockers `\'obstacle\'`) where they are written',
         'navigation',
       );
       endNavBake('No walkable-tagged entities in the scene');
@@ -155,7 +162,7 @@ export function setupNavMeshHandlers(): () => void {
     // the bake; obstacles alone can't produce a mesh.
     const meshes: THREE.Mesh[] = [];
     for (const id of [...walkableIds, ...collectNavigationIds('obstacle')]) {
-      const obj = editorHost().hierarchy.objects().get(id);
+      const obj = (hostHierarchyObjects()?.objects() ?? new Map<string, THREE.Object3D>()).get(id);
       if (!obj) continue;
       obj.traverse((child) => {
         if ((child as THREE.Mesh).isMesh) meshes.push(child as THREE.Mesh);
@@ -186,11 +193,11 @@ export function setupNavMeshHandlers(): () => void {
     }
 
     boundNavigation = nav;
-    const scene = editorHost().viewport.rig()?.scene;
+    const scene = viewportRig()?.scene;
     const debugMesh = scene ? nav.debugMesh(scene) : null;
     if (debugMesh) {
       applyWalkableTint(debugMesh);
-      editorHost().viewport.setHelper('navmesh', debugMesh);
+      setViewportHelper('navmesh', debugMesh);
     }
 
     endNavBake(null);
@@ -200,7 +207,8 @@ export function setupNavMeshHandlers(): () => void {
   };
 
   const onClear = () => {
-    const nav = getActiveSystems().navigation;
+    const active = getActiveSystems().navigation;
+    const nav = active ? threeNavigation(active) : undefined;
     if (!nav) {
       editorHost().console.warn('The mounted game has no NavigationAdapter to clear', 'navigation');
       return;
@@ -213,7 +221,7 @@ export function setupNavMeshHandlers(): () => void {
       return;
     }
     try {
-      nav.clear(editorHost().viewport.rig()?.scene ?? new THREE.Scene());
+      nav.clear(viewportRig()?.scene ?? new THREE.Scene());
     } catch (error) {
       editorHost().console.error(`NavMesh clear failed: ${error}`, 'navigation');
       return;