@volter/editor-game 0.5.65 → 0.5.67

package/src/host/stories/three-story-captures.ts

@@ -0,0 +1,35 @@
+/**
+ * The three.js story thumbnail capture (`@volter/editor-sdk/kit/story-thumbnails`): a prefab
+ * story in an offscreen R3F stage. Loads its renderer on first use.
+ */
+import { registerStoryThumbnailCapture, StoryMediumMismatch } from '@volter/editor-sdk/kit/story-thumbnails';
+
+/** The three.js leg needs WebGL; jsdom (the component tests) has none. */
+function supportsThreeCapture(): boolean {
+  return (
+    typeof WebGLRenderingContext !== 'undefined' &&
+    typeof navigator !== 'undefined' &&
+    !navigator.userAgent.toLowerCase().includes('jsdom')
+  );
+}
+
+export function registerThreeStoryCapture(): () => void {
+  return supportsThreeCapture()
+    ? registerStoryThumbnailCapture('three', async (component, options) => {
+        const preview = await import('./story-three-preview');
+        try {
+          return await preview.captureStoryComponentThumbnail(
+            component as Parameters<typeof preview.captureStoryComponentThumbnail>[0],
+            options,
+          );
+        } catch (error) {
+          // The reconciler's qualification rejection of a DOM story is a
+          // classification, not a failure: the caller tries its next leg.
+          if (preview.isStoryThreeClassificationRefusal(error)) {
+            throw new StoryMediumMismatch('This story is not a three.js story.');
+          }
+          throw error;
+        }
+      })
+    : () => {};
+}

package/src/host/story-three-preview-runtime.ts

@@ -0,0 +1,56 @@
+/** React/Fiber primitives selected from the graph that owns a project story. */
+
+import { createRoot as staticCreateR3FRoot, extend as staticExtendThree } from '@react-three/fiber';
+import { createElement as staticCreateElement } from 'react';
+import * as staticThree from 'three';
+import { R3F_RUNTIME_PATH } from '@volter/editor-sdk/host';
+import { isPackagedRuntime } from '@volter/editor-sdk/kit/packaged-runtime';
+
+export interface StoryThreePreviewRuntime {
+  readonly packaged: boolean;
+  readonly createElement: typeof staticCreateElement;
+  readonly createR3FRoot: typeof staticCreateR3FRoot;
+  readonly extendThree: typeof staticExtendThree;
+  readonly three: typeof staticThree;
+}
+
+const STATIC_RUNTIME: StoryThreePreviewRuntime = {
+  packaged: false,
+  createElement: staticCreateElement,
+  createR3FRoot: staticCreateR3FRoot,
+  extendThree: staticExtendThree,
+  three: staticThree,
+};
+
+let cachedPackagedRuntime: Promise<StoryThreePreviewRuntime> | null = null;
+
+async function loadPackagedRuntime(): Promise<StoryThreePreviewRuntime> {
+  const mod = (await import(/* @vite-ignore */ R3F_RUNTIME_PATH)) as Record<string, unknown>;
+  for (const name of ['createElement', 'createR3FRoot', 'extendThree']) {
+    if (typeof mod[name] !== 'function') {
+      throw new Error(
+        `The packaged R3F preview runtime did not export ${name} as a function — see ` +
+          'vite-plugin-module-doorways.ts.',
+      );
+    }
+  }
+  if (typeof mod['projectThree'] !== 'object' || mod['projectThree'] === null) {
+    throw new Error(
+      'The packaged R3F preview runtime did not export projectThree — see ' +
+        'vite-plugin-module-doorways.ts.',
+    );
+  }
+  return {
+    packaged: true,
+    createElement: mod['createElement'] as typeof staticCreateElement,
+    createR3FRoot: mod['createR3FRoot'] as typeof staticCreateR3FRoot,
+    extendThree: mod['extendThree'] as typeof staticExtendThree,
+    three: mod['projectThree'] as typeof staticThree,
+  };
+}
+
+export async function resolveStoryThreePreviewRuntime(): Promise<StoryThreePreviewRuntime> {
+  if (!(await isPackagedRuntime())) return STATIC_RUNTIME;
+  if (!cachedPackagedRuntime) cachedPackagedRuntime = loadPackagedRuntime();
+  return cachedPackagedRuntime;
+}

package/src/host/three-ingest-runtime.ts

@@ -16,7 +16,7 @@ import * as shellThree from 'three';
 import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
 import { CSS3DRenderer } from 'three/examples/jsm/renderers/CSS3DRenderer.js';
 import { THREE_INGEST_RUNTIME_PATH } from '@volter/editor-sdk/host';
-import { isPackagedRuntime } from '@volter/editor-core/packaged-runtime';
+import { isPackagedRuntime } from '@volter/editor-sdk/kit/packaged-runtime';
 
 /**
  * THE three of the graph an ingested game's modules resolve — the project's

package/src/host/use-active-performance-source.ts

@@ -14,19 +14,19 @@ import {
   inspectedInstanceId,
   inspectedInstanceVersion,
   subscribeInspectedInstance,
-} from '@volter/editor-core/authoring/active-systems';
+} from '@volter/editor-sdk/kit/authoring/active-systems';
 import {
   type EditorPerformanceSource,
   performanceSourceForDocument,
   performanceSourceForGameInstance,
   performanceSourcesVersion,
   subscribePerformanceSources,
-} from '@volter/editor-core/performance-sources';
+} from '@volter/editor-sdk/kit/performance-sources';
 import {
   activeWorkspaceDocumentId,
   subscribeWorkspaceDocuments,
   workspaceDocumentRegistryVersion,
-} from '@volter/editor-core/workspace-document-registry';
+} from '@volter/editor-sdk/kit/workspace-document-registry';
 
 export function useActivePerformanceSource(): EditorPerformanceSource | null {
   useSyncExternalStore(

package/src/host/viewport-pose-memory.ts

@@ -15,7 +15,7 @@
  */
 
 import type * as THREE from 'three';
-import { projectLocalSection, writeProjectLocalSection } from '@volter/editor-core/project-local-state';
+import { projectLocalSection, writeProjectLocalSection } from '@volter/editor-sdk/kit/project-local-state';
 
 /** The section of the project-local document this module owns. */
 const SECTION = 'viewportPose';

package/src/host/viewport-root-presentation.ts

@@ -1,11 +1,12 @@
-import type { ViewportRoot } from '@volter/editor-sdk/host';
 import { stampMountedAuthoringIds } from './authoring/mounted-authoring';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { stampThreeIdentities } from '@volter/editor-core/projection/three';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
+import { stampThreeIdentities } from '@volter/editor-threejs/kit/projection/three';
+import { threeRoot } from '@volter/editor-threejs/adapter/three-contract';
+import type { ViewportRoot } from '@volter/editor-threejs/viewport-api';
 
 /**
  * The Three viewport's PRESENTER — what `the world root's stage` binds as
- * `host.viewport.presentRoots` (`viewport-door.ts`). The lane that mounted
+ * `presentViewportRoots` (`@volter/editor-threejs/viewport-door`). The lane that mounted
  * the roots sees only the returned presentation handle. Native Three scene
  * adoption, identity stamping, and restoration stay here, beside the
  * viewport surface that understands them. A composition with no Three root
@@ -17,7 +18,7 @@ export function presentThreeRoots(
 ): { readonly worldId: string; dispose(): void } | null {
   const world = roots.find((candidate) => candidate.mounted.kind === 'three');
   if (!world || world.mounted.kind !== 'three') return null;
-  const scene = world.mounted.scene;
+  const scene = threeRoot(world.mounted).scene;
   const mountedAuthoring = world.mounted.authoring;
   if (mountedAuthoring) stampMountedAuthoringIds(scene, mountedAuthoring);
   stampThreeIdentities(scene, liveWorldId(world.id));

package/src/ingest/active-ingest.ts

@@ -12,7 +12,7 @@
  * makes that whole graph acyclic.
  */
 
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import type { MeasuredLoop } from '../host/same-realm-loop-gate';
 import type { DomAuthoringAdapter } from '../react/dom-authoring-adapter';
 import type { AuthoringAdapter } from '@volter/editor-project/adapter/authoring';
@@ -192,7 +192,7 @@ export function serializeEntry<T>(run: () => Promise<T>): Promise<T> {
   return result;
 }
 
-import { registerLiveSession } from '@volter/editor-core/live-session-registry';
+import { registerLiveSession } from '@volter/editor-sdk/kit/live-session-registry';
 // THE INGEST LANE, as the host sees it (`live-session-registry.ts`). Playing
 // is the host play-control latch, never an inferred loop
 // (`editor-session-mode.ts` records why); a deferred-ingest play counts.

package/src/ingest/authoring/ingest-dom-surface-authoring.ts

@@ -4,15 +4,15 @@
  * only AuthoringAdapter/CompositeAuthoringAdapter currency.
  */
 
-import { CompositeAuthoringAdapter } from '@volter/editor-core/authoring/composite-authoring-adapter';
+import { CompositeAuthoringAdapter } from '@volter/editor-sdk/kit/authoring/composite-authoring-adapter';
 import {
   findCanvasUiElements,
   findPrimaryCanvas,
   type OverlayElement,
 } from '../../host/coverage/capability-coverage';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import { authoringJournal } from '../../host/history/json-history-resource';
-import { sourceWriteBackendIfPrimed } from '@volter/editor-core/ui-source/tier-source-write-backend';
+import { sourceWriteBackendIfPrimed } from '@volter/editor-sdk/kit/ui-source/tier-source-write-backend';
 import { DomAuthoringAdapter, type DomElementLike } from '../../react/dom-authoring-adapter';
 import {
   type OidElementLike,
@@ -128,7 +128,7 @@ function domSurfaceAdapter(
     });
   }
   const writeBackend = sourceWriteBackendIfPrimed('An ingested game’s DOM UI surface');
-  return new ReactRootAuthoringAdapter(liveUiRoot, store, {
+  return new ReactRootAuthoringAdapter(liveUiRoot, store.shell, {
     ...(writeBackend ? { writeBackend } : {}),
   });
 }

package/src/ingest/authoring/ingest-root-adapter.ts

@@ -17,27 +17,27 @@
  * content uses — no separate editor data model.
  */
 
-import { authoringOidOf } from '@volter/editor-core/authoring/component-instance-root';
+import { authoringOidOf } from '@volter/editor-threejs/kit/authoring/component-instance-root';
 import { setIngestDataWriter } from '../../host/authoring/ingest-data-writer';
-import { editorConsole } from '@volter/editor-core/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import { GAME_SURFACE_CONTAINMENT_CSS } from '../../host/game-realm-page';
 import { clearGameSurface, gameLoopGate, setGameSurface } from '../../host/gated-globals';
 import { authoringJournal } from '../../host/history/json-history-resource';
-import { clearPresentationSurface, recordPresentationSurface } from '@volter/editor-core/presentation-surface';
-import { getCurrentProject } from '@volter/editor-core/project-manager';
-import { clearRootReadiness, recordRootReadiness } from '@volter/editor-core/readiness';
+import { clearPresentationSurface, recordPresentationSurface } from '@volter/editor-sdk/kit/presentation-surface';
+import { getCurrentProject } from '@volter/editor-sdk/kit/active-project';
+import { clearRootReadiness, recordRootReadiness } from '@volter/editor-sdk/kit/readiness';
 import {
   type SameRealmLoopGate,
   type SameRealmLoopVerdict,
   verifySameRealmLoopControl,
 } from '../../host/same-realm-loop-gate';
-import { ensureScopedGameStyles } from '@volter/editor-core/scoped-game-css';
+import { ensureScopedGameStyles } from '@volter/editor-sdk/kit/scoped-game-css';
 import { resolveThreeIngestRuntimeForEditor } from '../../host/three-ingest-runtime';
-import type { OidEntry } from '@volter/editor-core/ui-source/oid-transform';
-import { createHttpSourceWriteBackend } from '@volter/editor-core/ui-source/source-write-backend';
-import { serverRecordsSourceWrites } from '@volter/editor-core/ui-source/tier-source-write-backend';
-import { clearWorldAdoption, worldAdoptionRecorder } from '@volter/editor-core/world-adoption';
+import type { OidEntry } from '@volter/editor-react/source/oid-transform';
+import { createHttpSourceWriteBackend } from '@volter/editor-sdk/kit/ui-source/source-write-backend';
+import { serverRecordsSourceWrites } from '@volter/editor-sdk/kit/ui-source/tier-source-write-backend';
+import { clearWorldAdoption, worldAdoptionRecorder } from '@volter/editor-sdk/kit/world-adoption';
 import { markGameCssScope } from '@volter/editor-sdk/session/game-css-scope';
 import type { MountedThreeRoot } from '@volter/editor-project/adapter';
 import {
@@ -295,7 +295,7 @@ export function ingestSourceRoots(
  * THE SERVE-TIME DOOR: did the OID transform stamp any of THIS root's own
  * source, according to the index the dev server built while serving it?
  *
- * `GET /__ui-source/index` (`vite-plugin-ui-oid.ts`) records exactly what the
+ * `GET /__ui-source/index` (`@volter/editor-react`'s `serving/ui-oid-plugin.ts`) records exactly what the
  * transform stamped, and it is populated at TRANSFORM time — before the module
  * is evaluated, and therefore long before any object exists to carry a stamp.
  * That is precisely the ordering the graph door cannot have: on a project's
@@ -798,7 +798,7 @@ export async function mountIngestGame(
     // `collectState` is push-based — the control API would keep serving a
     // snapshot taken before the measurement existed, reporting `loop: null`
     // forever. Broadcast so `vgai status` sees the verdict it just produced.
-    onVerdict: () => store.notifyIngestEdit(),
+    onVerdict: () => store.shell.notifyIngestEdit(),
   });
   // The game's DECLARED system surface (`window.vgaiGame.systems`), projected
   // onto the host's ordinary `SystemAdapters.debug`. `activateCapturedThreeIngest`

package/src/ingest/capture-wait-report.ts

@@ -24,7 +24,7 @@
  * path. A second mount replaces the first's entry; there is only ever one wait.
  */
 
-import { notifyLiveSessionsChanged } from '@volter/editor-core/live-session-registry';
+import { notifyLiveSessionsChanged } from '@volter/editor-sdk/kit/live-session-registry';
 import type { VisibleCaptureWindow } from '@volter/threejs-runtime/adapter/ingest/visible-capture-window';
 
 /** The wait as `vgai status` reports it. */

package/src/ingest/deferred-ingest-play.ts

@@ -30,16 +30,17 @@
  * ingest keeps its own lifecycle).
  */
 
-import { commandLine } from '@volter/editor-core/product-command';
-import { queueEditModeRebuild } from '@volter/editor-core/authoring/edit-mode-authoring';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { fetchGameManifest } from '@volter/editor-core/manifest-project';
+import { activateLiveDocument } from '@volter/editor-sdk/kit/live-document';
+import { commandLine } from '@volter/editor-sdk/kit/product-command';
+import { queueEditModeRebuild } from '@volter/editor-sdk/kit/authoring/edit-mode-authoring';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
+import { fetchGameManifest } from '@volter/editor-sdk/kit/manifest-project';
 import {
   type ProjectAdapterFacet,
   projectAdapterFacet,
   subscribeProjectAdapter,
-} from '@volter/editor-core/project-adapter';
-import { sceneTabRow } from '@volter/editor-core/scene-document-plan';
+} from '@volter/editor-sdk/kit/project-adapter';
+import { sceneTabRow } from '@volter/editor-sdk/kit/scene-document-plan';
 import { ingestRoots } from '@volter/editor-project/adapter/manifest-interpreter';
 import { activeIngest } from './active-ingest';
 import {
@@ -188,8 +189,9 @@ export async function mountDeferredIngestForPlay(store: EditorShellStore): Promi
   // the Scene tab because, until now, that mount WAS edit mode; a play-time
   // mount belongs on the play surface — which is also what opens the input
   // gate (`mount-three-ingest-root.ts`'s `ingestInputActive` requires the play
-  // tab), so the game is drivable rather than merely visible.
-  store.setActiveViewportTab('play');
+  // tab, which is the Game document having focus), so the game is drivable rather than
+  // merely visible.
+  activateLiveDocument();
   getIngestPlayControl()?.play();
   return true;
 }
@@ -206,8 +208,7 @@ export function exitDeferredIngestPlay(store: EditorShellStore): boolean {
   // ownership note) — it unmounts by kind, clears the authoring override and
   // the adopted scene, and resets the play surface.
   exitActiveIngest();
-  store.setPlayState('stopped');
-  store.setActiveViewportTab('edit');
+  store.shell.setPlayState('stopped');
   // Edit mode is rebuilt through the ONE authoritative reinstall path
   // (`the world root's stage`'s `installAll`), which is what recreates the R3F design
   // session over the world component.

package/src/ingest/discovery-public-ingest.ts

@@ -34,8 +34,8 @@ import {
   PUBLIC_INGEST_BASE,
   publicIngestManifestUrl,
 } from '../host/staged-projects';
-import { extractUpstreamPin } from '@volter/game-runtime/adapter/ingest/upstream-pin';
-import type { IngestGame2D } from '@volter/game-runtime/pixi/ingest';
+import { extractUpstreamPin } from '../runtime/adapter/ingest/upstream-pin';
+import type { IngestGame2D } from '../runtime/pixi/ingest';
 import { declaredRoots } from '@volter/editor-project/adapter/manifest-interpreter';
 import { loadGameManifest } from '@volter/editor-project/manifest/load';
 import { composeIngestLoad, ingestDataWriter } from './entry-load';

package/src/ingest/ingest-boot-viewport.ts

@@ -15,19 +15,18 @@
  * while it constructs, then explicitly releases the hold and flips to Game.
  */
 
-import { editorConsole } from '@volter/editor-core/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { projectAdapterFacet } from '@volter/editor-core/project-adapter';
-import { sceneDocumentId } from '@volter/editor-core/scene-document-plan';
-import { CANVAS_SCENE_DOCUMENT_ID, SCENE_DOCUMENT_ID } from '@volter/editor-core/workspace-document-ids';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+import { projectAdapterFacet } from '@volter/editor-sdk/kit/project-adapter';
+import { sceneDocumentId } from '@volter/editor-sdk/kit/scene-document-plan';
+import { CANVAS_SCENE_DOCUMENT_ID, SCENE_DOCUMENT_ID } from '@volter/editor-sdk/kit/workspace-document-ids';
 import {
   activateWorkspaceDocument,
   openWorkspaceDocuments,
-} from '@volter/editor-core/workspace-document-registry';
+} from '@volter/editor-sdk/kit/workspace-document-registry';
 import { activeIngest } from './active-ingest';
 import { activeIngestPauseGap, holdIngestContentTimeForMode } from './ingest-play-control';
 
-export function landIngestBootInEdit(store: EditorShellStore): void {
+export function landIngestBootInEdit(): void {
   const active = activeIngest();
   if (active) {
     const held = holdIngestContentTimeForMode('edit');
@@ -42,7 +41,6 @@ export function landIngestBootInEdit(store: EditorShellStore): void {
       'ingest',
     );
   }
-  store.setActiveViewportTab('edit');
   const open = openWorkspaceDocuments();
   const defaultId = projectAdapterFacet()?.scenes.default;
   const isolationId = defaultId ? sceneDocumentId(defaultId) : undefined;

package/src/ingest/ingest-canvas-scene-document.tsx

@@ -17,25 +17,25 @@
 import {
   getMountFailureReports,
   subscribeToMountFailures,
-} from '@volter/editor-core/authoring/mount-failure-report';
-import { installCanvasSceneNavigation } from '@volter/editor-core/authoring/react-canvas-navigation';
-import { createRootViewController } from '@volter/editor-core/authoring/world-pan-state';
+} from '@volter/editor-sdk/kit/mount-failure-report';
+import { installCanvasSceneNavigation } from '@volter/editor-sdk/kit/authoring/react-canvas-navigation';
+import { createRootViewController } from '@volter/editor-sdk/kit/world-pan-state';
 import {
   CANVAS_SCENE_BACKGROUND,
   CanvasSceneBackdrop,
   CanvasSceneControls,
-} from '@volter/editor-core/components/CanvasSceneViewport';
-import { RootSelectionOverlay } from '@volter/editor-core/components/RootSelectionOverlay';
-import { SurfaceStateOverlay } from '@volter/editor-core/components/SurfaceStateOverlay';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { liveDocumentContainer } from '@volter/editor-core/live-document';
-import { projectAdapterFacet } from '@volter/editor-core/project-adapter';
-import { readinessFacet, subscribeRootReadiness } from '@volter/editor-core/readiness';
-import { explainSurface } from '@volter/editor-core/surface-state';
+} from '@volter/editor-sdk/kit/components/CanvasSceneViewport';
+import { RootSelectionOverlay } from '@volter/editor-sdk/kit/components/RootSelectionOverlay';
+import { SurfaceStateOverlay } from '@volter/editor-sdk/kit/components/SurfaceStateOverlay';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
+import { liveDocumentContainer } from '@volter/editor-sdk/kit/live-document';
+import { projectAdapterFacet } from '@volter/editor-sdk/kit/project-adapter';
+import { readinessFacet, subscribeRootReadiness } from '@volter/editor-sdk/kit/readiness';
+import { explainSurface } from '@volter/editor-sdk/kit/surface-state';
 import {
   registerWorkspaceDocumentSelection,
   type WorkspaceDocumentContentProps,
-} from '@volter/editor-core/workspace-document-registry';
+} from '@volter/editor-sdk/kit/workspace-document-registry';
 import type { AuthoringAdapter } from '@volter/editor-project/adapter';
 import { useEffect, useRef, useSyncExternalStore } from 'react';
 import { activeIngest } from './active-ingest';
@@ -71,7 +71,7 @@ export function IngestCanvasSceneContent({
   const containerRef = useRef<HTMLDivElement>(null);
   const viewRef = useRef(createRootViewController());
   const view = viewRef.current;
-  useSyncExternalStore(store.subscribe, store.getSnapshot);
+  useSyncExternalStore(store.shell.subscribe, store.shell.getSnapshot);
   const rootReadiness = useSyncExternalStore(subscribeRootReadiness, readinessFacet);
   const mountFailures = useSyncExternalStore(subscribeToMountFailures, getMountFailureReports);
   const live = activeIngest();
@@ -98,7 +98,7 @@ export function IngestCanvasSceneContent({
   useEffect(() => {
     return registerWorkspaceDocumentSelection(documentId, () => ({
       adapter,
-      nodeId: [...store.selectedEntityIds].find((id) => adapter.hierarchy.node(id)) ?? null,
+      nodeId: [...store.shell.selectedEntityIds].find((id) => adapter.hierarchy.node(id)) ?? null,
     }));
   }, [adapter, documentId, store]);
 
@@ -147,7 +147,7 @@ export function IngestCanvasSceneContent({
         touchAction: 'none',
       }}
     >
-      <CanvasSceneBackdrop view={view} />
+      <CanvasSceneBackdrop view={view} documentId={documentId} />
       <RootSelectionOverlay adapter={adapter} view={view} transformModeAware />
       <SurfaceStateOverlay
         explanation={surfaceExplanation}
@@ -159,6 +159,7 @@ export function IngestCanvasSceneContent({
         adapter={adapter}
         containerRef={containerRef}
         view={view}
+        documentId={documentId}
       />
     </div>
   );
@@ -173,5 +174,5 @@ export function installIngestCanvasScene(store: EditorShellStore): () => void {
   const Content = (props: WorkspaceDocumentContentProps) => (
     <IngestCanvasSceneContent {...props} adapter={adapter} store={store} worldId={worldId} />
   );
-  return installIngestCanvasSceneDocument(store, Content);
+  return installIngestCanvasSceneDocument(Content);
 }

package/src/ingest/ingest-canvas-scene.ts

@@ -4,22 +4,20 @@
  * installer can be unit-tested without pulling Pixi/Three into jsdom.
  */
 
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { projectAdapterFacet } from '@volter/editor-core/project-adapter';
-import { isolationTabsReplaceGenericScene } from '@volter/editor-core/scene-document-plan';
-import { CANVAS_SCENE_DOCUMENT_ID } from '@volter/editor-core/workspace-document-ids';
+import { projectAdapterFacet } from '@volter/editor-sdk/kit/project-adapter';
+import { isolationTabsReplaceGenericScene } from '@volter/editor-sdk/kit/scene-document-plan';
+import { CANVAS_SCENE_DOCUMENT_ID } from '@volter/editor-sdk/kit/workspace-document-ids';
 import {
   activateWorkspaceDocument,
   closeWorkspaceDocument,
   openWorkspaceDocument,
   type WorkspaceDocumentContentProps,
-} from '@volter/editor-core/workspace-document-registry';
-import { registerRootDocumentRoute } from '@volter/editor-core/world-document-routing';
+} from '@volter/editor-sdk/kit/workspace-document-registry';
+import { registerRootDocumentRoute } from '@volter/editor-sdk/kit/world-document-routing';
 import type { ReactNode } from 'react';
 import { activeIngest } from './active-ingest';
 
 export function installIngestCanvasSceneDocument(
-  store: EditorShellStore,
   Content: (props: WorkspaceDocumentContentProps) => ReactNode,
 ): () => void {
   const live = activeIngest();
@@ -38,7 +36,6 @@ export function installIngestCanvasSceneDocument(
     Content,
     closeable: false,
     presentation: () => ({ kind: 'world', id: worldId }),
-    onActivate: () => store.setActiveViewportTab('edit'),
   });
   activateWorkspaceDocument(CANVAS_SCENE_DOCUMENT_ID);
   const unregisterRoute = registerRootDocumentRoute(worldId, CANVAS_SCENE_DOCUMENT_ID);

package/src/ingest/ingest-evidence-hook.ts

@@ -9,7 +9,7 @@
  * appears here because the mounted object actually has it.
  */
 
-import { getActiveSystems } from '@volter/editor-core/authoring/active-systems';
+import { getActiveSystems } from '@volter/editor-sdk/kit/authoring/active-systems';
 import { loadIngestOwnership } from '../host/authoring/ingest-source-persistence';
 import { gameLoopGate } from '../host/gated-globals';
 import type { DomAuthoringAdapter } from '../react/dom-authoring-adapter';

package/src/ingest/ingest-frame-snapshot.ts

@@ -7,7 +7,7 @@
  * `composite-screenshot.ts` reads a game's canvas with `drawImage`, and that
  * only works on a WebGL canvas whose context was created with
  * `preserveDrawingBuffer: true`. Every canvas the vgai RUNTIME mounts sets it
- * (`@volter/game-runtime/runtime/create-runtime`), which is why the composite leg has always
+ * (`@volter/editor-game/runtime/create-runtime`), which is why the composite leg has always
  * worked for first-party play. An INGESTED game creates its own canvas: the
  * racing-game's `<Canvas>` passes no `gl` prop, so fiber's default
  * (`preserveDrawingBuffer: false`) applies, the browser discards the drawing

package/src/ingest/ingest-play-control.ts

@@ -9,9 +9,9 @@
  */
 
 import { gameContractEpoch } from '../host/coverage/game-contract-seam-evidence';
-import { recordLiveSeamEvidence } from '@volter/editor-core/coverage/live-seam-evidence';
-import { editorConsole } from '@volter/editor-core/editor-console';
-import { activateLiveDocument } from '@volter/editor-core/live-document';
+import { recordLiveSeamEvidence } from '@volter/editor-sdk/kit/live-seam-evidence';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+import { activateLiveDocument } from '@volter/editor-sdk/kit/live-document';
 import type { VgaiGameContract } from '@volter/editor-project/adapter/ingest/game-contract';
 import { activeIngest, type IngestLifecycleControl } from './active-ingest';
 import { readIngestGameContract } from './game-contract-realm';
@@ -58,7 +58,7 @@ export function ingestPlaying(): boolean {
  * THE one write to the ingest play state.
  *
  * An ingested game's input is gated by the same mechanisms a first-party play
- * session's is (the engine's `InputManager.setEnabled` and `gated-globals.ts`'s
+ * session's is (`gated-globals.ts`'s
  * lexical window/document shadow), driven by the input gate the mount installs.
  */
 export function setIngestPlaying(playing: boolean): void {

package/src/ingest/ingest-render-debug.ts

@@ -34,7 +34,7 @@
  * five WebGL2 draw entry points on whatever real context it is handed and knows
  * nothing about three — so it is reused verbatim over the captured Pixi
  * renderer's own `gl`. The bracket is the renderer's own published seam, its
- * `prerender`/`postrender` runners (`@volter/game-runtime/pixi/render-pass-bracket`).
+ * `prerender`/`postrender` runners (`@volter/editor-game/runtime/pixi/render-pass-bracket`).
  *
  * What is NOT there is per-draw attribution, and it is absent for a structural
  * reason rather than a missing patch point: three calls `onBeforeRender` on the
@@ -55,22 +55,22 @@
  * notice.
  */
 
-import { adapterObservations } from '@volter/editor-core/adapter-observation';
-import { createContractDebugAdapter } from '@volter/game-runtime/adapter/ingest/contract-debug-adapter';
+import { adapterObservations } from '@volter/editor-sdk/kit/adapter-observation';
+import { createContractDebugAdapter } from '../runtime/adapter/ingest/contract-debug-adapter';
 import {
   type ContractSurface,
   projectContractSystemAdapters,
-} from '@volter/game-runtime/adapter/ingest/contract-system-adapters';
-import { mergeDebugAdapters } from '@volter/game-runtime/adapter/ingest/merge-debug-adapters';
-import { createObservationDebugAdapter } from '@volter/game-runtime/adapter/ingest/observation-debug-adapter';
+} from '../runtime/adapter/ingest/contract-system-adapters';
+import { mergeDebugAdapters } from '../runtime/adapter/ingest/merge-debug-adapters';
+import { createObservationDebugAdapter } from '../runtime/adapter/ingest/observation-debug-adapter';
 import {
   createRenderDebugAdapter,
   frameCaptureContextFor,
   type RenderDebugWiring,
-} from '@volter/game-runtime/dev/render-debug-adapter';
-import { collectRenderMemory } from '@volter/game-runtime/dev/render-memory';
-import { createWebGLFrameCapture } from '@volter/game-runtime/dev/webgl-frame-capture';
-import { pixiRenderingContext } from '@volter/game-runtime/pixi/render-pass-bracket';
+} from '../runtime/dev/render-debug-adapter';
+import { collectRenderMemory } from '../runtime/dev/render-memory';
+import { createWebGLFrameCapture } from '../runtime/dev/webgl-frame-capture';
+import { pixiRenderingContext } from '../runtime/pixi/render-pass-bracket';
 import type { ObservationDeclaration } from '@volter/editor-project/adapter/adapter-module';
 import type { VgaiGameSystems } from '@volter/editor-project/adapter/ingest/game-contract';
 import type { SystemAdapters } from '@volter/editor-project/adapter/system-adapter';
@@ -197,7 +197,7 @@ export interface IngestSystemsWiring {
  * Four sources, each with a different provenance:
  *  - `debug` — projected from the contract's own `commands`/`state`;
  *  - `debug`, AGAIN — projected from the loaded ADAPTER's observation
- *    declarations (`@volter/game-runtime/adapter/ingest/observation-debug-adapter`).
+ *    declarations (`@volter/editor-game/runtime/adapter/ingest/observation-debug-adapter`).
  *    These two are peers onto ONE slot, so they are MERGED
  *    (`merge-debug-adapters.ts`) rather than layered: a name declared by both
  *    is refused by a coded error naming both sources, never shadowed;