@volter/editor-game 0.5.65 → 0.5.67

package/src/host/components/world-root-stage.ts

@@ -21,10 +21,14 @@
  * LOAD too.
  */
 
-import type { ViewportPresentation, ViewportRoot } from '@volter/editor-sdk/host';
+import {
+  registerStartingPresentation,
+  registerStudioPreset,
+  type StudioPreset,
+} from '@volter/editor-sdk/kit/viewport-presentation';
 import { themeVars } from '@volter/editor-sdk/widgets';
-import { createPerformanceProfiler } from '@volter/game-runtime/dev/performance-profiler';
-import { createWebGLGpuTimer } from '@volter/game-runtime/dev/webgl-gpu-timer';
+import { createPerformanceProfiler } from '../../runtime/dev/performance-profiler';
+import { createWebGLGpuTimer } from '../../runtime/dev/webgl-gpu-timer';
 import type { AuthoringAdapter, Transform } from '@volter/editor-project/adapter';
 import { markHostRenderer } from '@volter/editor-threejs/viewport/renderer-ownership';
 import { applyWorldRendererConfig } from '@volter/threejs-runtime/adapter/renderer-config';
@@ -46,61 +50,98 @@ import {
   type Pass,
 } from 'postprocessing';
 import * as THREE from 'three';
-import { getActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
-import type { CompositeAuthoringAdapter } from '@volter/editor-core/authoring/composite-authoring-adapter';
+import { getActiveAuthoring } from '@volter/editor-sdk/kit/authoring/active-adapter';
+import type { CompositeAuthoringAdapter } from '@volter/editor-sdk/kit/authoring/composite-authoring-adapter';
 import {
   applyAuthoringTransform,
   beginAuthoringTransformEdit,
   endAuthoringTransformEdit,
-} from '@volter/editor-core/authoring/consumer-actions';
-import { designTimeMountFor } from '@volter/editor-core/authoring/design-time-mount-registry';
-import { attachProjectAuthoringStage } from '@volter/editor-core/authoring/project-authoring-session';
+} from '@volter/editor-sdk/kit/authoring/consumer-actions';
+import { designTimeMountFor } from '@volter/editor-sdk/kit/authoring/design-time-mount-registry';
+import { attachProjectAuthoringStage } from '@volter/editor-sdk/kit/authoring/project-authoring-session';
 import {
   isThreejsSurfaceVisible,
   resolveThreeViewportRootId,
-} from '@volter/editor-core/authoring/world-hidden-viewport';
+} from '@volter/editor-threejs/kit/authoring/world-hidden-viewport';
 import { AutoFrameWindow } from '../auto-frame-window';
 import {
   type CameraAuthoringSubject,
   type CameraViewMode,
   cameraAuthoringPresentation,
   installCameraAuthoringHost,
-} from '@volter/editor-core/camera-authoring';
-import { registerPresentedCanvasFrame } from '@volter/editor-core/canvas-preview-frames';
-import { collectState } from '@volter/editor-core/command-listener';
-import { getDownloadedAssetPath, getOnlineAssetFiles, reportEditorState } from '@volter/editor-core/editor-api';
-import { editorConsole } from '@volter/editor-core/editor-console';
-import { isEditorPresentationActive } from '@volter/editor-core/editor-presentation-activity';
-import type { EditorStats } from '@volter/editor-core/editor-runtime';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { EditorViewport, type OnlineAssetDrop } from '@volter/editor-core/editor-viewport';
-import { entityObject3D } from '@volter/editor-core/entity-object';
+} from '@volter/editor-threejs/kit/camera-authoring';
+import { registerPresentedCanvasFrame } from '../canvas-preview-frames';
+import { collectState } from '@volter/editor-sdk/kit/command-listener';
+import { getDownloadedAssetPath, getOnlineAssetFiles, reportEditorState } from '@volter/editor-sdk/kit/editor-api';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+import { isEditorPresentationActive } from '@volter/editor-sdk/kit/editor-presentation-activity';
+import type { EditorStats } from '@volter/editor-sdk/kit/editor-runtime';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
+import { EditorViewport, type OnlineAssetDrop } from '@volter/editor-threejs/kit/editor-viewport';
+import { entityObject3D } from '@volter/editor-threejs/kit/entity-object';
 import {
   nativeSelectionColors,
   nativeViewportLook,
   subscribeNativeSelectionTheme,
-} from '@volter/editor-core/native-selection-style';
-import { registerPerformanceSource } from '@volter/editor-core/performance-sources';
+} from '@volter/editor-sdk/kit/native-selection-style';
+import { registerPerformanceSource } from '@volter/editor-sdk/kit/performance-sources';
 import { drawSceneUnlessRefused } from '../scene-view-drawability';
-import { withSceneFogNeutralized } from '@volter/editor-core/scene-view-fog';
+import { withSceneFogNeutralized } from '@volter/editor-threejs/kit/scene-view-fog';
 import { connectServerLogs } from '../server-log-bridge';
-import { focusedStageStore } from '@volter/editor-core/stage-context';
+import { focusedStageStore } from '@volter/editor-sdk/kit/stage-context';
 import {
-  createThreeSelectionOutline,
+  acquireThreeSelectionOutline,
+  releaseThreeSelectionOutline,
   setThreeSelectionOutlineColors,
   syncThreeSelectionOutline,
-} from '@volter/editor-core/three-viewport/selection-outline';
+} from '@volter/editor-threejs/kit/three-viewport/selection-outline';
 import {
   setThreeViewportProjection,
   subscribeThreeViewportPresentation,
   threeViewportPresentation,
-} from '@volter/editor-core/three-viewport-presentation';
-import { recordViewportFirstFrame } from '@volter/editor-core/viewport-activation-timings';
+} from '@volter/editor-sdk/kit/three-viewport-presentation';
+import { recordViewportFirstFrame } from '@volter/editor-sdk/kit/viewport-activation-timings';
 import { savedViewportPose, saveViewportPose } from '../viewport-pose-memory';
 import { presentThreeRoots } from '../viewport-root-presentation';
-import { isEditorViewportShadingTarget } from '@volter/editor-core/viewport-shading-boundary';
-import { downloadOnlineAssetWithHistory } from '@volter/editor-core/components/asset-editor-persistence';
-import { bindStagePresenceMarkers } from '@volter/editor-core/components/stage-presence-markers';
+import { isEditorViewportShadingTarget } from '@volter/editor-threejs/kit/viewport-shading-boundary';
+import { downloadOnlineAssetWithHistory } from '@volter/editor-sdk/kit/components/asset-editor-persistence';
+import { bindStagePresenceMarkers } from '@volter/editor-threejs/kit/components/stage-presence-markers';
+import type { ViewportPresentation, ViewportRoot } from '@volter/editor-threejs/viewport-api';
+
+/** Everything the world root's stage hands its medium's design session: the stage's own three
+ *  handles. The stage and the medium that registered for `three` agree on it; the kit's mount
+ *  registry types it `unknown`. */
+export interface WorldRootSessionContext {
+  /** The shell store the session's adapter is built over. */
+  readonly store: EditorShellStore;
+  /** The edit-mode composite the session swaps its own child adapter into. */
+  readonly composite: CompositeAuthoringAdapter;
+  /** The stage's renderer — the session adopts it rather than building one. */
+  readonly renderer: THREE.WebGLRenderer;
+}
+
+/**
+ * THE WORLD STAGE'S STARTING PRESENTATION. Its studio is the light the world has always been
+ * shown by — the viewport's own ambient (0.5) and directional (1.0 from (10, 20, 10)), with no
+ * key and no image-based light of its own (the world's environment is the game's) — and it gives
+ * way to the scene's own whenever a live scene is adopted, as that rig always has.
+ */
+const WORLD_STUDIO: StudioPreset = {
+  id: 'world',
+  title: 'World',
+  lights: [{ color: '#ffffff', intensity: 1, direction: [-10, -20, -10], space: 'world' }],
+  ambient: { color: '#ffffff', intensity: 0.5 },
+  environmentIntensity: 0,
+};
+const releaseWorldPresentation = [
+  registerStudioPreset(WORLD_STUDIO),
+  registerStartingPresentation('world', {
+    all: {
+      lighting: { source: 'studio', studioPreset: WORLD_STUDIO.id, auto: { takeover: ['light'], overridable: true } },
+    },
+  }),
+];
+if (import.meta.hot) import.meta.hot.dispose(() => releaseWorldPresentation.forEach((release) => release()));
 
 /**
  * The world root's renderer, built to the ENGINE's own render settings —
@@ -339,9 +380,20 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
   // --- Scene ---
   const scene = new THREE.Scene();
   // The palette's viewport background when it carries one; the editor's own
-  // grey otherwise. Theme changes follow through the viewport's look
-  // subscription (`EditorViewport`).
-  scene.background = new THREE.Color(nativeViewportLook(canvas).background ?? 0xaaaaaa);
+  // grey otherwise. The viewport's look subscription (`EditorViewport`) paints
+  // a palette's colour over it; this one gives the grey back when the next
+  // palette names none, as long as the scene still wears what was painted (a
+  // game may set its own background).
+  const WORLD_BACKGROUND = 0xaaaaaa;
+  let paintedBackground = nativeViewportLook(canvas).background ?? WORLD_BACKGROUND;
+  scene.background = new THREE.Color(paintedBackground);
+  const unsubscribeWorldBackground = subscribeNativeSelectionTheme(canvas, () => {
+    const next = nativeViewportLook(canvas).background ?? WORLD_BACKGROUND;
+    const current = scene.background;
+    if (current instanceof THREE.Color && current.getHex() === paintedBackground)
+      scene.background = new THREE.Color(next);
+    paintedBackground = next;
+  });
 
   // --- Bind store to scene ---
   store.bindScene(scene, renderer);
@@ -354,6 +406,9 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
     onlineAssetResolver: resolveDroppedOnlineAsset,
     onProjectionChange: setThreeViewportProjection,
   });
+  // The world is lit and dressed by its view's presentation (`kit/viewport-presentation`), as
+  // a `world` stage: this module builds it, so it states how it starts (`WORLD_STUDIO` below).
+  const unbindPresentation = viewport.bindPresentation(documentId, 'world');
   // Bind the REAL viewport camera + orbit target so store.cameraPose (the
   // `editor.viewport.camera.get` facet, see command-listener.ts's
   // collectState) and the thumbnail-capture path read live data instead of
@@ -412,7 +467,7 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
   // declaration) would leave the previous world's colour space on the
   // editor's renderer until page reload.
   let restoreAdoptedImage: (() => void) | null = null;
-  let selectionOutline: ReturnType<typeof createThreeSelectionOutline> | null = null;
+  let selectionOutline: ReturnType<typeof acquireThreeSelectionOutline> | null = null;
   let selectionOutlinePass: EffectPass | null = null;
   let selectionOutlineUnderlayPass: Pass | null = null;
   const syncSelectionTheme = (): void => {
@@ -425,8 +480,8 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
   );
   const syncSelectionOutline = (): void => {
     if (!selectionOutline) return;
-    const adapter = getActiveAuthoring(store);
-    const roots = [...store.selectedEntityIds]
+    const adapter = getActiveAuthoring(store.shell);
+    const roots = [...store.shell.selectedEntityIds]
       // Edit↔Play swaps the active child before its native graph is rebuilt.
       // Do not route a stale outgoing id through the composite during that
       // handoff: it is temporarily absent, not an ownership error.
@@ -452,17 +507,17 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
     // postprocessing). `editor-viewport.ts` bumps `composerVersion` (via
     // `store.reapplyEnvironment()`) on the world hide/show edges, which is
     // what re-runs this rebuild.
-    const hiddenRootId = resolveThreeViewportRootId(store);
+    const hiddenRootId = resolveThreeViewportRootId(store.shell);
     void hiddenRootId;
     // Unwind the previous adoption's config BEFORE re-deriving, so the
     // re-derive below and the (possibly absent) re-apply at the end both
     // start from the editor's own values — see `restoreAdoptedImage`'s decl.
     restoreAdoptedImage?.();
     restoreAdoptedImage = null;
-    // `applySceneRenderPipeline` disposes the previous pass but an
-    // OutlineEffect's Selection owns temporary render-layer bits on the
-    // selected objects. Clear those explicitly before dropping the effect.
-    selectionOutline?.selection.clear();
+    // `applySceneRenderPipeline` disposes the previous passes; the outline
+    // returns to this renderer's pool first, detached from its pass and its
+    // selection cleared, and the rebuilt pipeline takes it back below.
+    if (selectionOutline) releaseThreeSelectionOutline(renderer, selectionOutline, selectionOutlinePass);
     selectionOutline = null;
     selectionOutlinePass = null;
     selectionOutlineUnderlayPass = null;
@@ -485,8 +540,9 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
     // This stage already loaded `postprocessing` for its own composer, so it
     // hands the factory its own bindings — no second module load, and the
     // outline is attached synchronously exactly as before.
-    selectionOutline = createThreeSelectionOutline(
+    selectionOutline = acquireThreeSelectionOutline(
       { BlendFunction, KernelSize, OutlineEffect },
+      renderer,
       store.scene ?? scene,
       viewport.renderCamera,
       nativeSelectionColors(renderer.domElement),
@@ -524,24 +580,24 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
   applyViewportPresentation();
 
   const resolveCameraSubject = (id: string): CameraAuthoringSubject | null =>
-    cameraSubjectFor(getActiveAuthoring(store), store.objectMap, id);
+    cameraSubjectFor(getActiveAuthoring(store.shell), store.objectMap, id);
 
   let pilotGestureId: string | null = null;
   const finishPilotGesture = (): void => {
     if (!pilotGestureId) return;
-    endAuthoringTransformEdit(getActiveAuthoring(store), pilotGestureId);
+    endAuthoringTransformEdit(getActiveAuthoring(store.shell), pilotGestureId);
     pilotGestureId = null;
   };
   const beginPilotGesture = (): void => {
     const view = cameraAuthoringPresentation().view;
     if (view?.mode !== 'pilot' || !view.subject.canAuthorPose) return;
     pilotGestureId = view.subject.id;
-    beginAuthoringTransformEdit(getActiveAuthoring(store), pilotGestureId);
+    beginAuthoringTransformEdit(getActiveAuthoring(store.shell), pilotGestureId);
   };
   const applyPilotGesture = (): void => {
     if (!pilotGestureId || viewport.cameraViewMode !== 'pilot') return;
     const subject = resolveCameraSubject(pilotGestureId);
-    const adapter = getActiveAuthoring(store);
+    const adapter = getActiveAuthoring(store.shell);
     const transforms = adapter.transforms;
     if (!subject || !transforms) return;
     // `transforms.get` REFUSES BY THROWING for a node with no transform truth
@@ -566,16 +622,16 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
       rotation: subject.camera.quaternion.toArray() as [number, number, number, number],
       scale: previous.scale,
     });
-    store.notifyIngestEdit();
+    store.shell.notifyIngestEdit();
   };
   viewport.orbitControls.addEventListener('start', beginPilotGesture);
   viewport.orbitControls.addEventListener('change', applyPilotGesture);
   viewport.orbitControls.addEventListener('end', finishPilotGesture);
 
   const disposeCameraAuthoring = installCameraAuthoringHost({
-    active: () => store.playState === 'stopped' && store.activeViewportTab === 'edit',
+    active: () => store.shell.playState === 'stopped' && store.shell.activeViewportTab === 'edit',
     selected: () => {
-      const id = store.selectedEntityId;
+      const id = store.shell.selectedEntityId;
       return id ? resolveCameraSubject(id) : null;
     },
     resolve: resolveCameraSubject,
@@ -592,7 +648,7 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
       presence.reportCamera();
     },
     alignToViewport: (subject: CameraAuthoringSubject) => {
-      const adapter = getActiveAuthoring(store);
+      const adapter = getActiveAuthoring(store.shell);
       const transforms = adapter.transforms;
       if (!transforms || !subject.canAuthorPose) return;
       const targetObject = store.objectMap.get(subject.id) ?? null;
@@ -627,10 +683,10 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
         rotation: localQuaternion.toArray() as [number, number, number, number],
         scale: previous.scale,
       });
-      store.notifyIngestEdit();
+      store.shell.notifyIngestEdit();
       endAuthoringTransformEdit(adapter, subject.id);
     },
-    subscribe: store.subscribe,
+    subscribe: store.shell.subscribe,
   });
 
   // --- Store subscription → sync viewport ---
@@ -650,7 +706,7 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
   // React never owns it.
   let lastThreejsSurface: boolean | null = null;
   const syncSurfaceVisibility = (): void => {
-    const visible = isThreejsSurfaceVisible(store);
+    const visible = isThreejsSurfaceVisible(store.shell);
     if (visible === lastThreejsSurface) return;
     lastThreejsSurface = visible;
     canvas.style.opacity = visible ? '1' : '0';
@@ -671,7 +727,7 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
   syncSurfaceVisibility();
 
   let lastComposerVersion = store.composerVersion;
-  const unsubStore = store.subscribe(() => {
+  const unsubStore = store.shell.subscribe(() => {
     syncSurfaceVisibility();
     // Swap viewport scene if the store's scene changed (play mode enter/exit)
     const storeScene = store.scene;
@@ -711,14 +767,14 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
   viewport.orbitControls.addEventListener('end', rememberPose);
 
   // --- Viewport action subscription ---
-  const unsubActions = store.onViewportAction((action) => {
+  const unsubActions = store.shell.onViewportAction((action) => {
     switch (action.type) {
       // Resolved through the ACTIVE ADAPTER first, same as selection and the
       // gizmo — an adopted play scene's nodes live in the adapter's walk and
       // never reach `objectMap`, so a store-only lookup silently framed
       // nothing for every entity in a running game (`entity-object.ts`).
       case 'focus-entity': {
-        const obj = entityObject3D(getActiveAuthoring(store), store.objectMap, action.id);
+        const obj = entityObject3D(getActiveAuthoring(store.shell), store.objectMap, action.id);
         if (obj) viewport.focusOn(obj);
         break;
       }
@@ -742,13 +798,13 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
             break;
           }
         }
-        gameCameraLookup = action.gameCamera ?? null;
+        gameCameraLookup = store.sceneCameraLookup;
         autoFrame.begin(performance.now(), gameCameraLookup !== null);
         break;
       }
       case 'focus-selection': {
-        const adapter = getActiveAuthoring(store);
-        const objects = [...store.selectedEntityIds]
+        const adapter = getActiveAuthoring(store.shell);
+        const objects = [...store.shell.selectedEntityIds]
           .map((id) => entityObject3D(adapter, store.objectMap, id))
           .filter((o): o is THREE.Object3D => o !== null);
         viewport.focusOnMultiple(objects);
@@ -760,6 +816,15 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
       case 'set-view-preset':
         viewport.setViewPreset(action.preset);
         break;
+      case 'step-view':
+        viewport.stepView(action.step);
+        break;
+      case 'frame-all':
+        viewport.focusOnScene();
+        break;
+      case 'zoom-view':
+        viewport.zoomStep(action.direction);
+        break;
       case 'set-camera-pose':
         viewport.setPose(action.position, action.target, action.fov);
         break;
@@ -855,7 +920,7 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
 
   /** Whether this stage is the one the shared panels are following, and so the
    *  one that fills the shell's frame/camera readout — see its use below. */
-  const ownsShellReadout = (): boolean => focusedStageStore(store) === store;
+  const ownsShellReadout = (): boolean => focusedStageStore(store.shell) === store.shell;
 
   function frame(now: number, resumed: boolean): void {
     if (disposed) return;
@@ -980,7 +1045,7 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
     const stageMount = designTimeMountFor('three');
     if (disposed || editModeComposite !== composite) return;
     const disposeSession = stageMount
-      ? await stageMount.mountWorldRootSession({ store, composite, renderer })
+      ? await stageMount.mountWorldRootSession({ store, composite, renderer } satisfies WorldRootSessionContext)
       : () => {};
     if (disposed || editModeComposite !== composite) {
       disposeSession();
@@ -990,9 +1055,9 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
     if (!disposed) options.onMountStatus('ready');
   }
 
-  const authoringStage = attachProjectAuthoringStage(store, installStage);
+  const authoringStage = attachProjectAuthoringStage(store.shell, installStage);
   authoringStage.ready
-    .then(() => reportEditorState(collectState(store)))
+    .then(() => reportEditorState(collectState(store.shell)))
     .catch((err) => {
       editorConsole.error(
         `Editor boot failed: ${err instanceof Error ? err.message : String(err)}`,
@@ -1038,6 +1103,8 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
       gpuTimer.dispose();
       unsubscribeViewportPresentation();
       unsubscribeSelectionTheme();
+      unsubscribeWorldBackground();
+      unbindPresentation();
       selectionOutline?.selection.clear();
       softParticleDepth.dispose();
       composer.dispose();

package/src/host/coverage/capability-coverage.ts

@@ -44,7 +44,7 @@
  * `ingest/mount-coverage.ts` assembles the facts from the live singletons.
  */
 
-import { commandLine } from '@volter/editor-core/product-command';
+import { commandLine } from '@volter/editor-sdk/kit/product-command';
 import type {
   AuthoringProviderKey,
   SeamEvidenceVerdict,
@@ -461,6 +461,8 @@ export interface AuthoringSurfaceFacts {
   readonly availableIsolationDocuments: number;
   readonly pieces: number;
   readonly sceneEntries: number;
+  /** Project story modules that did not load or compose (`editor.status().storyFailures`). */
+  readonly storyFailures?: number;
 }
 
 /** Required only inside the row rules. Public callers never manufacture this
@@ -1237,6 +1239,16 @@ function authoringSurfaceRows(facts: ResolvedCoverageFacts): readonly Capability
             'the scene table declares no scenes, so there is no surface to place prefabs on ' +
             '(a models or website project)',
         }
+      : (surface.storyFailures ?? 0) > 0
+        ? {
+            seam: 'authoring.pieces',
+            status: 'gap',
+            detail:
+              `${surface.storyFailures} project story module(s) failed to load, so their prefabs are missing ` +
+              `from the scene table (${surface.pieces} resolved)`,
+            missing: 'the prefabs those stories register are absent from Content and the component board',
+            fix: 'read `editor.status().storyFailures` for each module and its error, and the console line naming the module the load failed on',
+          }
       : surface.pieces === 0
         ? {
             seam: 'authoring.pieces',

package/src/host/coverage/game-contract-seam-evidence.ts

@@ -16,7 +16,7 @@ import {
   GAME_LIFECYCLE_SHAPE,
   GAME_SYSTEMS_SHAPE,
 } from '@volter/editor-project/adapter/ingest/game-contract-seams';
-import { liveSeamEvidence } from '@volter/editor-core/coverage/live-seam-evidence';
+import { liveSeamEvidence } from '@volter/editor-sdk/kit/live-seam-evidence';
 
 const EPOCHS = new WeakMap<object, string>();
 let nextEpoch = 1;

package/src/host/coverage/project-verb-coverage.ts

@@ -34,7 +34,6 @@
  * `coverage/system-adapter-coverage.ts`.
  */
 
-import { commandLine } from '@volter/editor-core/product-command';
 import {
   PROJECT_VERB_SLOTS,
   type ProjectVerbMeasurement,
@@ -104,30 +103,16 @@ function exportVerb(facts: ProjectVerbFacts): ProjectVerbMeasurement {
       missing:
         'this project cannot produce a standalone build, so it runs NOWHERE but the editor — the ' +
         'dev-served standalone page refuses an unexported game outright',
-      fix: "add the scaffold's `build` script (`build: tsc && vite build`), which is what every deploy path runs",
+      fix: "add the scaffold's `build` script (`build: tsc && vite build`), which is what the export path runs",
     };
   }
-  const refused = roots.filter(
-    (root) => root.type !== 'ingest' && (root.type !== 'builtin' || root.identity !== 'three'),
-  );
-  const wallLeg =
-    refused.length > 0
-      ? `; note that the legacy ${commandLine('deploy')} verb additionally refuses ${refused
-          .map((root) => `root "${root.id}" (${root.identity})`)
-          .join(
-            ', ',
-          )} — use the project-owned deploy scripts (${commandLine('add deploy-cloudflare')}/\`deploy-vercel\`, then \`npm run deploy\`)`
-      : '';
-  const deployLeg = scripts.includes('deploy')
-    ? ', and a `deploy` script to ship it'
-    : ` (no \`deploy\` script yet — ${commandLine('add deploy-cloudflare')}/\`deploy-vercel\` adds one)`;
   const ingestLeg = ingestOnly(roots)
     ? '; this ingest project ships the standalone bundle produced by its own build unchanged'
     : '';
   return {
     slot: 'export',
     state: 'present',
-    evidence: `this project declares a \`build\` script, which is what the export path runs to emit the \`dist/\` it stages${deployLeg}${ingestLeg}${wallLeg}`,
+    evidence: `this project declares a \`build\` script, which is what the export path runs to emit the \`dist/\` it stages${ingestLeg}`,
   };
 }
 

package/src/host/coverage/system-adapter-coverage.ts

@@ -46,14 +46,14 @@
  * no live session.
  */
 
-import type { DeclaredSystemAbsence } from '@volter/game-runtime/runtime/game';
+import type { DeclaredSystemAbsence } from '../../runtime/game';
 import type { SystemAdapters } from '@volter/editor-project/adapter/system-adapter';
 import {
   SYSTEM_ADAPTER_SLOTS,
   type SystemAdapterMeasurement,
   type SystemAdapterSlot,
 } from './capability-coverage';
-import { inspectSystemAdapterSeam } from '@volter/editor-core/coverage/system-seam-evidence';
+import { inspectSystemAdapterSeam } from '@volter/editor-sdk/kit/system-seam-evidence';
 
 /** What the native derivation needs to know that the live registry cannot tell
  *  it. Both facts are read off things that already exist; neither is a guess. */
@@ -139,9 +139,8 @@ function shippedLibraries(slot: SystemAdapterSlot, facts: NativeProjectFacts): r
 function contradictionFix(slot: SystemAdapterSlot, libraries: readonly string[]): string {
   return (
     `this project depends on ${libraries.join(' + ')}, so "nothing built a ${slot} world" is not ` +
-    `a settled answer. Reach a terminal state either way: BIND it — declare a ${slot} adapter in ` +
-    `the root entry's \`systems\` table (the engine ships \`rapierPhysicsSystem()\` for the R3F ` +
-    `Rapier bridge; other slots take the game's own adapter) — or DECLARE the absence with ` +
+    `a settled answer. Reach a terminal state either way: BIND it — declare the game's own ${slot} ` +
+    `adapter in the root entry's \`systems\` table — or DECLARE the absence with ` +
     `\`absent(reason)\` in that same table. The reason must NAME the dependency and say why it ` +
     `is there while the subsystem is not (a transitive pull, a leftover, a build-only use); a ` +
     `declared absence blind to the shipped dependency grades malformed, not terminal.`

package/src/host/design-system-stories/fixtures/editor-runtime.tsx

@@ -1,17 +1,18 @@
 import { type ReactNode, useEffect, useLayoutEffect, useState } from 'react';
-import { resetProjectThumbnailManifestCache } from '@volter/editor-core/asset-workflow/thumbnail-system';
-import { type EditorRuntime, EditorRuntimeProvider, type EditorStats } from '@volter/editor-core/editor-runtime';
-import { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { EditorSession } from '@volter/editor-core/history/editor-session';
-import { getStorageBackend, MemStorage, setStorageBackend } from '@volter/editor-core/storage/index';
+import { resetProjectThumbnailManifestCache } from '@volter/editor-sdk/kit/asset-workflow/thumbnail-system';
+import { type EditorRuntime, EditorRuntimeProvider, type EditorStats } from '@volter/editor-sdk/kit/editor-runtime';
+import { type EditorShellStore, threeStateOf } from '@volter/editor-threejs/kit/editor-shell-store';
+import { ShellStore } from '@volter/editor-sdk/kit/shell-store';
+import { EditorSession } from '@volter/editor-sdk/kit/history/editor-session';
+import { getStorageBackend, MemStorage, setStorageBackend } from '@volter/editor-sdk/kit/storage/index';
 import {
   activeWorkspaceUtility,
   installWorkspaceHostCommands,
   setActiveWorkspaceUtility,
   setWorkspaceUtilityTabs,
   workspaceUtilityTabs,
-} from '@volter/editor-core/workspace-host-commands';
-import { availableWorkspaceUtilities } from '@volter/editor-core/workspace-utility-registry';
+} from '@volter/editor-sdk/kit/workspace-host-commands';
+import { availableWorkspaceUtilities } from '@volter/editor-sdk/kit/workspace-utility-registry';
 
 const ZERO_STATS: EditorStats = {
   fps: 60,
@@ -22,9 +23,14 @@ const ZERO_STATS: EditorStats = {
   cameraTarget: { x: 0, y: 1, z: 0 },
 };
 
+/** A story runtime's Three half, for a production component that reads the scene. */
+export function storyThreeStore(runtime: EditorRuntime): EditorShellStore {
+  return threeStateOf(runtime.store);
+}
+
 /** A real, bounded editor runtime for production component stories. */
 export function createStoryEditorRuntime(): EditorRuntime {
-  const store = new EditorShellStore();
+  const store = new ShellStore();
   const session = new EditorSession('storybook-fixture');
   store.attachHistory(session.history);
   return {

package/src/host/document-preview-three.ts

@@ -2,8 +2,8 @@ import { collectContentNodeRecords } from '@volter/editor-threejs/viewport/conte
 import { isEditorOwnedObject } from '@volter/editor-threejs/viewport/editor-layers';
 import { markHostRenderer } from '@volter/editor-threejs/viewport/renderer-ownership';
 import * as THREE from 'three';
-import type { DocumentPreviewCaptureRequest } from '@volter/editor-core/document-preview-source';
-import { frameableContentBounds } from '@volter/editor-core/scene-framing';
+import type { DocumentPreviewCaptureRequest } from '@volter/editor-sdk/kit/document-preview-source';
+import { frameableContentBounds } from '@volter/editor-threejs/kit/scene-framing';
 
 function authoredCameras(root: THREE.Object3D): THREE.Camera[] {
   const cameras: THREE.Camera[] = [];

package/src/host/entry-adjudication.ts

@@ -1,9 +1,9 @@
 /**
  * WHAT DOES THIS ENTRY MODULE MEAN? — the ONE editor-side answer.
  *
- * The engine owns the answer itself (`resolveR3FEntryAdapter`, and the
- * packaged-aware `resolveR3FEntryAdapterForEditor` delegate that routes it
- * through the project's own module graph). The editor's job is to ASK, once.
+ * `roots/r3f-root.tsx` owns the answer itself (`resolveR3FEntryAdapter`), and
+ * `resolveR3FEntryAdapterForEditor` hands it the React and Fiber of the
+ * project's own module graph. The rest of the editor's job is to ASK, once.
  * Before this module there were three askers, and they had already drifted:
  *
  *  - the dev-server lane called the packaged-aware `…ForEditor`;
@@ -20,9 +20,9 @@
  * told which lane and which file, and that is the caller's knowledge, not
  * this function's.
  *
- * `entry-adjudication-single-owner.test.ts` is the tripwire; the canvas lane
- * has its own single owner in the engine (`resolveCanvasEntryAdapter`, reached
- * through `canvas-entry-runtime.ts`) and is not adjudicated here.
+ * The canvas lane has its own single owner (`roots/canvas-root.tsx`'s
+ * `resolveCanvasEntryAdapter`, reached through `canvas-entry-runtime.ts`) and
+ * is not adjudicated here.
  */
 
 import type { RootAdapter } from '@volter/editor-project/adapter';

package/src/host/game-css-scope-transform.ts

@@ -0,0 +1,4 @@
+/** The `@scope` transform the session applies to a game's stylesheets, for a
+ *  page that must scope CSS a game creates at runtime. Its own module so the
+ *  transform's parser loads only where a game's page asks for it. */
+export { scopeGameCss } from '@volter/editor-sdk/session/scoped-game-css';

package/src/host/game-module-access.ts

@@ -1,4 +1,4 @@
-import { commandLine } from '@volter/editor-core/product-command';
+import { commandLine } from '@volter/editor-sdk/kit/product-command';
 /**
  * THE MODULE LANE of `vgai eval` — reach the RUNNING mount's own module
  * instances, by served path, using URLs retained by their owning realm.