@volter/editor-game 0.5.65 → 0.5.66

package/src/host/components/world-root-stage-binding.tsx

@@ -5,7 +5,7 @@
  *
  * `Overlays` is the world-root half of vgai's `stage-overlay-set.tsx` — every
  * part it rendered only when `worldRoot` held (the root selection layer, the
- * camera-authoring pin, the controls hint while the world mounts, the scene's
+ * camera-authoring pin, the scene's
  * surface-state card). The rest of that overlay set is the kit's
  * `StageOverlays`, which the host renders beside this.
  */
@@ -14,26 +14,25 @@ import { activeAuthoringVersion, subscribeActiveAuthoring } from '@volter/editor
 import {
   getMountFailureReports,
   subscribeToMountFailures,
-} from '@volter/editor-core/authoring/mount-failure-report';
+} from '@volter/editor-sdk/kit/mount-failure-report';
 import {
   object3DDocumentSessionsVersion,
   subscribeObject3DDocumentSessions,
 } from '@volter/editor-core/authoring/object3d-document-session-registry';
 import { RootSelectionOverlay } from '@volter/editor-core/components/RootSelectionOverlay';
 import { SurfaceStateOverlay } from '@volter/editor-core/components/SurfaceStateOverlay';
-import { ViewportControlsHint } from '@volter/editor-core/components/ViewportControlsHint';
 import type {
   WorldRootOverlayProps,
   WorldRootStageBinding,
 } from '@volter/editor-core/components/world-root-binding';
 import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { readinessFacet, subscribeRootReadiness } from '@volter/editor-core/readiness';
-import { documentStageContext, threeSelectionToolsApply } from '@volter/editor-core/stage-context';
-import { explainSurface } from '@volter/editor-core/surface-state';
+import { readinessFacet, subscribeRootReadiness } from '@volter/editor-sdk/kit/readiness';
+import { documentStageContext } from '@volter/editor-core/stage-context';
+import { explainSurface } from '@volter/editor-sdk/kit/surface-state';
 import {
   subscribeWorkspaceDocuments,
   workspaceDocumentRegistryVersion,
-} from '@volter/editor-core/workspace-document-registry';
+} from '@volter/editor-sdk/kit/workspace-document-registry';
 import { useMemo, useSyncExternalStore } from 'react';
 import type * as THREE from 'three';
 import { threeSceneHasRenderableContent } from '../surface-content';
@@ -101,7 +100,6 @@ function WorldRootOverlays({
   // The world root's stage is the Scene document's: the kit's overlay props
   // carry no document id, and the Scene document is the one world-root stage.
   const ctx = documentStageContext(store, documentId, 'document');
-  const showsSelectionTools = threeSelectionToolsApply(ctx);
   return (
     <>
       {/* Three-scene selection overlay. React/Pixi documents mount their own
@@ -114,13 +112,6 @@ function WorldRootOverlays({
           (`world-root-stage.ts`), so the pin belongs to the stage that
           installed it. */}
       {ctx.surface === 'three' ? <CameraAuthoringOverlay previewRef={cameraPreviewRef} /> : null}
-      {/* The hint also shows WHILE the world is still mounting: a new user
-          reads the screen during those boot seconds and looks for the camera
-          controls exactly then. The kit's overlay set shows it on a three
-          surface; this adds only the mounting case it does not cover. */}
-      {!showsSelectionTools && ctx.surface !== 'three' && mountStatus === 'mounting' ? (
-        <ViewportControlsHint />
-      ) : null}
       <SceneViewportStateOverlay store={store} rootIds={rootIds} mountStatus={mountStatus} />
     </>
   );

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

@@ -21,6 +21,11 @@
  * LOAD too.
  */
 
+import {
+  registerStartingPresentation,
+  registerStudioPreset,
+  type StudioPreset,
+} from '@volter/editor-sdk/kit/viewport-presentation';
 import type { ViewportPresentation, ViewportRoot } from '@volter/editor-sdk/host';
 import { themeVars } from '@volter/editor-sdk/widgets';
 import { createPerformanceProfiler } from '@volter/game-runtime/dev/performance-profiler';
@@ -69,8 +74,8 @@ import {
 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 { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+import { isEditorPresentationActive } from '@volter/editor-sdk/kit/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';
@@ -79,14 +84,15 @@ import {
   nativeSelectionColors,
   nativeViewportLook,
   subscribeNativeSelectionTheme,
-} from '@volter/editor-core/native-selection-style';
+} from '@volter/editor-sdk/kit/native-selection-style';
 import { registerPerformanceSource } from '@volter/editor-core/performance-sources';
 import { drawSceneUnlessRefused } from '../scene-view-drawability';
 import { withSceneFogNeutralized } from '@volter/editor-core/scene-view-fog';
 import { connectServerLogs } from '../server-log-bridge';
 import { focusedStageStore } from '@volter/editor-core/stage-context';
 import {
-  createThreeSelectionOutline,
+  acquireThreeSelectionOutline,
+  releaseThreeSelectionOutline,
   setThreeSelectionOutlineColors,
   syncThreeSelectionOutline,
 } from '@volter/editor-core/three-viewport/selection-outline';
@@ -95,13 +101,36 @@ import {
   subscribeThreeViewportPresentation,
   threeViewportPresentation,
 } from '@volter/editor-core/three-viewport-presentation';
-import { recordViewportFirstFrame } from '@volter/editor-core/viewport-activation-timings';
+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';
 
+/**
+ * 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 —
  * opaque, high-performance, PCF soft shadows, KTX2 support taught to the
@@ -339,9 +368,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 +394,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 +455,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 => {
@@ -459,10 +502,10 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
     // 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 +528,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),
@@ -1038,6 +1082,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

@@ -53,7 +53,7 @@ import {
   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. */

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

@@ -11,7 +11,7 @@ import {
   setWorkspaceUtilityTabs,
   workspaceUtilityTabs,
 } from '@volter/editor-core/workspace-host-commands';
-import { availableWorkspaceUtilities } from '@volter/editor-core/workspace-utility-registry';
+import { availableWorkspaceUtilities } from '@volter/editor-sdk/kit/workspace-utility-registry';
 
 const ZERO_STATS: EditorStats = {
   fps: 60,
@@ -22,6 +22,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 {
+  if (!(runtime.store instanceof EditorShellStore)) {
+    throw new Error('This runtime was not made by createStoryEditorRuntime: it has no Three store.');
+  }
+  return runtime.store;
+}
+
 /** A real, bounded editor runtime for production component stories. */
 export function createStoryEditorRuntime(): EditorRuntime {
   const store = new EditorShellStore();

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

@@ -2,7 +2,7 @@ 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 type { DocumentPreviewCaptureRequest } from '@volter/editor-sdk/kit/document-preview-source';
 import { frameableContentBounds } from '@volter/editor-core/scene-framing';
 
 function authoredCameras(root: THREE.Object3D): THREE.Camera[] {

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.

package/src/host/game-realm-page.ts

@@ -42,16 +42,24 @@
  */
 
 /**
- * What the host stamps on an adopted surface so a game's `position:fixed`
- * overlay is contained to the pane.
+ * What the host stamps on an adopted surface so it behaves as the game's own page.
  *
  * `contain: layout` makes the element a containing block for absolutely AND
- * fixed positioned descendants — the one CSS primitive that does this without
- * the side effects of the alternatives (`transform`/`filter` also create the
- * containing block but force a compositing layer and, on the ADOPTED element
- * itself, are exactly the stamp {@link claimHostSurfaceBox} exists to clear).
+ * fixed positioned descendants, so a game's `position:fixed` overlay is contained to the
+ * pane — the one CSS primitive that does this without the side effects of the alternatives
+ * (`transform`/`filter` also create the containing block but force a compositing layer and,
+ * on the ADOPTED element itself, are exactly the stamp {@link claimHostSurfaceBox} exists to
+ * clear).
+ *
+ * The inherited text properties start from a page's defaults, as the game's `<body>` does
+ * when it ships: otherwise the editor's own typography (11px, its line height and colour)
+ * inherited into the game's DOM, and a game's text rendered smaller in the editor than in
+ * its build.
  */
-export const GAME_SURFACE_CONTAINMENT_CSS = 'contain: layout;';
+export const GAME_SURFACE_CONTAINMENT_CSS =
+  'contain: layout; font: initial; color: initial; letter-spacing: normal; word-spacing: normal;' +
+  ' text-align: start; text-indent: 0; text-transform: none; white-space: normal;' +
+  ' direction: ltr; cursor: auto; visibility: visible;';
 
 /** `EventTarget`'s own listener identity is (type, callback, capture) — read
  *  the capture flag out of either options form so the page's registration

package/src/host/game-realm-reclaim.ts

@@ -14,7 +14,7 @@
  * attached AND ungated.
  */
 
-import { editorConsole } from '@volter/editor-core/editor-console';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import { disposeGameRealm } from './gated-globals';
 
 /**

package/src/host/gated-globals.ts

@@ -28,8 +28,8 @@
  *  callers that already reach for it alongside the proxies. */
 export { GAME_GLOBALS_PRELUDE } from '@volter/editor-core/game-globals-prelude';
 
-import { installCreationSiteRecorder } from '@volter/editor-core/creation-site-registry';
-import { setConsoleRealmAttribution } from '@volter/editor-core/editor-console';
+import { installCreationSiteRecorder } from '@volter/editor-sdk/kit/creation-site-registry';
+import { setConsoleRealmAttribution } from '@volter/editor-sdk/kit/editor-console';
 import { guardedGameLocation, refusedNavigationMessage } from './game-location-guard';
 import { GameRealmPage } from './game-realm-page';
 import {
@@ -44,7 +44,7 @@ import {
   type SameRealmLoopGate,
   type SameRealmLoopGateStats,
 } from './same-realm-loop-gate';
-import { surfaceHoldsKeyboard } from '@volter/editor-core/surface-keyboard';
+import { surfaceHoldsKeyboard } from '@volter/editor-sdk/kit/surface-keyboard';
 
 /**
  * The SAME-REALM LOOP GATE (S-5) — the scheduling half of the same idea.
@@ -94,7 +94,7 @@ const INPUT_EVENT_TYPES = new Set<string>([
  * way — so a key pressed while the gate was open and released after it closed
  * (Stop with W still held) left the game's OWN input manager holding KeyW for
  * good: the editor flushes only the session's InputManager, never a
- * project-owned copy (`src/lib/input`). With both vertical keys stuck the hero
+ * project-owned one. With both vertical keys stuck the hero
  * could not move up or down while A/D worked (runhuman pass 129; Opus
  * reproduction 2026-09-03 — forcing KeyW+KeyS into `keysDown` reproduced the
  * report verbatim, a single stuck key does not). Each proxy remembers the

package/src/host/history/json-history-resource.ts

@@ -1,6 +1,6 @@
-import { sha256Hex } from '@volter/editor-core/bytes-codec';
+import { sha256Hex } from '@volter/editor-sdk/kit/bytes-codec';
 import { HistoryOperationError, type HistoryService } from '@volter/editor-core/history/history-service';
-import type { ResourceDescriptor, ResourceDriver, ResourceKind } from '@volter/editor-core/history/types';
+import type { ResourceDescriptor, ResourceDriver, ResourceKind } from '@volter/editor-sdk/kit/history-types';
 
 const encoder = new TextEncoder();
 const decoder = new TextDecoder();

package/src/host/instance-extract-actions.ts

@@ -20,7 +20,7 @@
  * action that writes NEW FILES — this one writes two.
  */
 
-import type { InstanceSourceLocator } from '@volter/editor-core/instance-source-actions';
+import type { InstanceSourceLocator } from '@volter/editor-sdk/kit/instance-source-actions';
 
 export const EXTRACT_COMPONENT_LABEL = 'Extract Component…';
 

package/src/host/instance-fork-actions.ts

@@ -19,7 +19,7 @@
  * FILE, which no other hierarchy item does.
  */
 
-import type { InstanceSourceLocator } from '@volter/editor-core/instance-source-actions';
+import type { InstanceSourceLocator } from '@volter/editor-sdk/kit/instance-source-actions';
 
 export const FORK_COMPONENT_LABEL = 'Fork Component…';
 

package/src/host/projection/dom.ts

@@ -28,9 +28,9 @@
  * raycast the projector can own the way {@link ThreeProjector.pick} does.
  */
 
-import type { ProjectedNode, Projection } from '@volter/editor-core/projection/types';
+import type { ProjectedNode, Projection } from '@volter/editor-sdk/kit/projection-types';
 
-export type { ProjectedNode, Projection } from '@volter/editor-core/projection/types';
+export type { ProjectedNode, Projection } from '@volter/editor-sdk/kit/projection-types';
 
 /**
  * The minimum shape a live DOM walk needs. Deliberately not `Element` so a

package/src/host/projection/pixi.ts

@@ -12,7 +12,7 @@
 import type { AuthoringAdapter2D, EditorNode2D } from '@volter/game-runtime/pixi/authoring';
 import type { DOMRectLike } from '@volter/editor-project/adapter';
 import type { Container, PointData } from 'pixi.js';
-import type { ProjectedNode, Projection } from '@volter/editor-core/projection/types';
+import type { ProjectedNode, Projection } from '@volter/editor-sdk/kit/projection-types';
 
 export type PixiNode = ProjectedNode<Container>;
 

package/src/host/r3f-entry-runtime.ts

@@ -13,7 +13,7 @@ import {
   R3F_ENTRY_RUNTIME_PATH,
   R3F_RUNTIME_PATH,
 } from '@volter/editor-sdk/host';
-import { isPackagedRuntime } from '@volter/editor-core/packaged-runtime';
+import { isPackagedRuntime } from '@volter/editor-sdk/kit/packaged-runtime';
 
 type R3FEntryResolver = typeof resolveR3FEntryAdapter;
 

package/src/host/react-mount-runtime.ts

@@ -27,7 +27,7 @@ import {
 import { flushSync } from 'react-dom';
 import { createRoot } from 'react-dom/client';
 import { REACT_WORLD_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 pieces of "react itself" a react-world mount needs:

package/src/host/realm-services.ts

@@ -50,7 +50,7 @@ import {
 } from '@volter/editor-sdk/session/project-module-url';
 import type { AdapterSurface } from '@volter/editor-project/adapter/adapter-surface';
 import { resolveCanvasEntryAdapterForEditor } from './canvas-entry-runtime';
-import { isPackagedRuntime } from '@volter/editor-core/packaged-runtime';
+import { isPackagedRuntime } from '@volter/editor-sdk/kit/packaged-runtime';
 import { type ReactRootMountRuntime, resolveReactRootMountRuntime } from './react-mount-runtime';
 import {
   resolveThreeIngestRuntimeForEditor,

package/src/host/roots/module-root.ts

@@ -131,7 +131,7 @@ function withCapabilityWarning<K extends AdapterSurface>(
         mounted.kind,
       );
       if (warning) {
-        const { editorConsole } = await import('@volter/editor-core/editor-console');
+        const { editorConsole } = await import('@volter/editor-sdk/kit/editor-console');
         editorConsole.warn(warning, 'adapter');
       }
       return mounted;

package/src/host/scene-view-drawability.ts

@@ -26,8 +26,8 @@
  * which is exactly what the message says.
  */
 
-import { commandLine } from '@volter/editor-core/product-command';
-import { editorConsole } from '@volter/editor-core/editor-console';
+import { commandLine } from '@volter/editor-sdk/kit/product-command';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 
 const undrawable = new WeakMap<object, string>();
 

package/src/host/server-log-bridge.ts

@@ -7,7 +7,7 @@
  * session's viewport panel.
  */
 import { getServerValidationLog } from '@volter/editor-core/api/project-state';
-import { emitServerLogEntry } from '@volter/editor-core/editor-console';
+import { emitServerLogEntry } from '@volter/editor-sdk/kit/editor-console';
 import { connectEvents } from '@volter/editor-core/editor-presence';
 
 /**

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

@@ -26,7 +26,7 @@ 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/ingest/active-ingest.ts

@@ -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-root-adapter.ts

@@ -19,14 +19,14 @@
 
 import { authoringOidOf } from '@volter/editor-core/authoring/component-instance-root';
 import { setIngestDataWriter } from '../../host/authoring/ingest-data-writer';
-import { editorConsole } from '@volter/editor-core/editor-console';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import type { EditorShellStore } from '@volter/editor-core/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 { clearPresentationSurface, recordPresentationSurface } from '@volter/editor-sdk/kit/presentation-surface';
 import { getCurrentProject } from '@volter/editor-core/project-manager';
-import { clearRootReadiness, recordRootReadiness } from '@volter/editor-core/readiness';
+import { clearRootReadiness, recordRootReadiness } from '@volter/editor-sdk/kit/readiness';
 import {
   type SameRealmLoopGate,
   type SameRealmLoopVerdict,
@@ -34,7 +34,7 @@ import {
 } from '../../host/same-realm-loop-gate';
 import { ensureScopedGameStyles } from '@volter/editor-core/scoped-game-css';
 import { resolveThreeIngestRuntimeForEditor } from '../../host/three-ingest-runtime';
-import type { OidEntry } from '@volter/editor-core/ui-source/oid-transform';
+import type { OidEntry } from '@volter/editor-react/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';
@@ -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

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. */