@volter/editor-game 0.5.66 → 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/use-active-performance-source.ts

@@ -14,14 +14,14 @@ 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,

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';

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-sdk/kit/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import { GAME_SURFACE_CONTAINMENT_CSS } from '../../host/game-realm-page';
 import { clearGameSurface, gameLoopGate, setGameSurface } from '../../host/gated-globals';
 import { authoringJournal } from '../../host/history/json-history-resource';
 import { clearPresentationSurface, recordPresentationSurface } from '@volter/editor-sdk/kit/presentation-surface';
-import { getCurrentProject } from '@volter/editor-core/project-manager';
+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-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';
+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 {
@@ -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/deferred-ingest-play.ts

@@ -32,15 +32,15 @@
 
 import { activateLiveDocument } from '@volter/editor-sdk/kit/live-document';
 import { commandLine } from '@volter/editor-sdk/kit/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 { 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 {
@@ -208,7 +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.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

@@ -16,8 +16,8 @@
  */
 
 import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
-import { projectAdapterFacet } from '@volter/editor-core/project-adapter';
-import { sceneDocumentId } from '@volter/editor-core/scene-document-plan';
+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,

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

@@ -18,18 +18,18 @@ import {
   getMountFailureReports,
   subscribeToMountFailures,
 } from '@volter/editor-sdk/kit/mount-failure-report';
-import { installCanvasSceneNavigation } from '@volter/editor-core/authoring/react-canvas-navigation';
+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';
+} 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-core/project-adapter';
+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 {
@@ -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]);
 

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

@@ -4,8 +4,8 @@
  * installer can be unit-tested without pulling Pixi/Three into jsdom.
  */
 
-import { projectAdapterFacet } from '@volter/editor-core/project-adapter';
-import { isolationTabsReplaceGenericScene } from '@volter/editor-core/scene-document-plan';
+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,
@@ -13,7 +13,7 @@ import {
   openWorkspaceDocument,
   type WorkspaceDocumentContentProps,
 } from '@volter/editor-sdk/kit/workspace-document-registry';
-import { registerRootDocumentRoute } from '@volter/editor-core/world-document-routing';
+import { registerRootDocumentRoute } from '@volter/editor-sdk/kit/world-document-routing';
 import type { ReactNode } from 'react';
 import { activeIngest } from './active-ingest';
 

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

@@ -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
@@ -56,21 +56,21 @@
  */
 
 import { adapterObservations } from '@volter/editor-sdk/kit/adapter-observation';
-import { createContractDebugAdapter } from '@volter/game-runtime/adapter/ingest/contract-debug-adapter';
+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;

package/src/ingest/ingest-siblings.ts

@@ -8,11 +8,8 @@
  * degrading loudly per world rather than silently ignoring them (the F24/F9
  * anti-pattern this closes):
  *
- *  - a builtin `dom` world — a bare (no `<WorldProvider>`) DOM layer, D-V3.
- *    There is no native `Game` beside an ingest world, so wrapping one would
- *    fabricate first-party data (anti-shim) — the sibling's own `useWorldState`/
- *    `useGame` calls are simply unavailable, and this says so once per world.
- *    Has no loop at all, so its `SiblingMount.setPaused` stays `undefined`
+ *  - a builtin `dom` world — a bare DOM layer, D-V3, rendered like every `dom`
+ *    root. Has no loop at all, so its `SiblingMount.setPaused` stays `undefined`
  *    (D-B1) — never a fabricated no-op.
  *  - `{ module }` (any kind) OR a builtin `three`/`canvas` world
  *  (D-B3 — the residual this closes: a second `{ ingest }` world is
@@ -48,22 +45,22 @@ import {
   formatMountFailureMessage,
 } from '@volter/editor-sdk/kit/mount-failure-report';
 import { withStoreSelection } from '../host/authoring/mounted-authoring';
-import { makeNoAuthoringAdapter } from '@volter/editor-core/authoring/no-authoring-adapter';
+import { makeNoAuthoringAdapter } from '@volter/editor-sdk/kit/authoring/no-authoring-adapter';
 import { PixiAuthoringAdapter } from '../host/authoring/pixi-authoring-adapter';
 import { createLiveCanvasWriteTarget } from '../host/authoring/pixi-live-write-target';
 import { resolveCanvasPixiForEditor } from '../host/canvas-entry-runtime';
 import { CrashNullBoundary } from '@volter/editor-sdk/kit/crash-null-boundary';
 import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import { authoringJournal } from '../host/history/json-history-resource';
 import { activeRealmServices } from '../host/realm-services';
 import { resolveReactAdapterRootComponent } from '../host/roots/react-root';
-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 } from '../react/dom-authoring-adapter';
 import { ReactRootAuthoringAdapter, walkOidTree } from '../react/react-world-authoring-adapter';
 import { beginProjectMountEpoch } from '@volter/editor-sdk/session/project-module-url';
-import { createPhysics2DRegistry } from '@volter/game-runtime/pixi/physics-registry';
-import { createPhysicsAdapter2D } from '@volter/game-runtime/pixi/system-adapters';
+import { createPhysics2DRegistry } from '../runtime/pixi/physics-registry';
+import { createPhysicsAdapter2D } from '../runtime/pixi/system-adapters';
 import type { AuthoringAdapter } from '@volter/editor-project/adapter';
 import { declaredRoots } from '@volter/editor-project/adapter/manifest-interpreter';
 import type { ResolvedAdapterRoot, ResolvedGameManifest } from '@volter/editor-project/manifest/load';
@@ -136,15 +133,13 @@ function styleSiblingLayer(
 }
 
 /**
- * D-V3: mount a `default-react` sibling as a bare DOM layer — no
- * `<WorldProvider>` wrap (anti-shim: there is no native `Game` to hand it).
- * Reuses `binding-resolver.ts`'s exact entry-loading step
+ * D-V3: mount a `default-react` sibling as a bare DOM layer, the way every
+ * `dom` root renders. Reuses `binding-resolver.ts`'s exact entry-loading step
  * (`resolveReactAdapterRootComponent` — the same D4 `scene`-forbidden/
  * `entry`-required checks and default-export validation
  * `resolveDefaultReactAdapter` itself uses) rather than duplicating it.
  *
- * If the entry component throws at mount/first render (most commonly: it
- * calls `useGame`/`useWorldState` with no provider in the tree), the error
+ * If the entry component throws at mount/first render, the error
  * boundary above catches it, this function removes the layer it just
  * created, and RETHROWS so the caller's uniform per-sibling catch
  * (`mountOneIngestSibling`'s caller, {@link mountIngestSiblings}) can turn it
@@ -168,13 +163,6 @@ async function mountDefaultReactSibling(
   styleSiblingLayer(layer, world, 'none');
   gameContainer.appendChild(layer);
 
-  // D-V3: one structured note per world naming the degrade — never silent
-  // about the missing bridge.
-  editorConsole.log(
-    `react sibling "${world.id}": no native Game beside an ingest world — useWorldState unavailable`,
-    'ingest',
-  );
-
   const root = createRoot(layer);
   let caught: unknown = null;
   // `flushSync` forces the initial mount (render + commit + error-boundary
@@ -227,7 +215,7 @@ async function mountDefaultReactSibling(
       // built — `ui-source/tier-source-write-backend.ts`, and the packaged-
       // editor bug the old `import.meta.env.DEV` gate carried here.
       const writeBackend = sourceWriteBackendIfPrimed('An ingest sibling’s react layer');
-      authoring = new ReactRootAuthoringAdapter(layer, store, {
+      authoring = new ReactRootAuthoringAdapter(layer, store.shell, {
         ...(writeBackend ? { writeBackend } : {}),
       });
     } else {
@@ -348,7 +336,7 @@ async function mountScopedRuntimeSibling(
           authoring =
             worldInstance.mounted.authoring ??
             makeNoAuthoringAdapter(
-              store,
+              store.shell,
               `${world.id} (${worldInstance.mounted.kind === 'canvas' ? worldInstance.mounted.substrate.name : 'unknown'} authoring unavailable)`,
             );
         } else {
@@ -368,7 +356,7 @@ async function mountScopedRuntimeSibling(
           });
         }
       } else {
-        authoring = makeNoAuthoringAdapter(store, `${world.id} (no authoring surface)`);
+        authoring = makeNoAuthoringAdapter(store.shell, `${world.id} (no authoring surface)`);
       }
     }
     return {

package/src/ingest/module-mode.ts

@@ -6,20 +6,20 @@
  */
 
 import { measureAdapterReach } from '../host/adapter-reach';
-import { setActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
-import { setActiveSystems } from '@volter/editor-core/authoring/active-systems';
+import { setActiveAuthoring } from '@volter/editor-sdk/kit/authoring/active-adapter';
+import { setActiveSystems } from '@volter/editor-sdk/kit/authoring/active-systems';
 import {
   addMountFailureReport,
   clearMountFailureReports,
   formatMountFailureMessage,
 } from '@volter/editor-sdk/kit/mount-failure-report';
-import { makeNoAuthoringAdapter } from '@volter/editor-core/authoring/no-authoring-adapter';
+import { makeNoAuthoringAdapter } from '@volter/editor-sdk/kit/authoring/no-authoring-adapter';
 import { resolveAllRoots } from '../host/binding-resolver';
 import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { fetchGameManifest } from '@volter/editor-core/manifest-project';
-import { getCurrentProject } from '@volter/editor-core/project-manager';
-import type { GameSession, RootMountSpec } from '@volter/game-runtime/runtime/create-runtime';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
+import { fetchGameManifest } from '@volter/editor-sdk/kit/manifest-project';
+import { getCurrentProject } from '@volter/editor-sdk/kit/active-project';
+import type { GameSession, RootMountSpec } from '../runtime/create-runtime';
 import type { AuthoringAdapter } from '@volter/editor-project/adapter';
 import { declaredRoots, ingestRoots } from '@volter/editor-project/adapter/manifest-interpreter';
 import type { ResolvedAdapterRoot, ResolvedGameManifest } from '@volter/editor-project/manifest/load';
@@ -54,8 +54,8 @@ export function withStoreSelection(
   return {
     ...authoring,
     selection: {
-      get: () => [...store.selectedEntityIds],
-      set: (ids) => store.selectMultiple(ids),
+      get: () => [...store.shell.selectedEntityIds],
+      set: (ids) => store.shell.selectMultiple(ids),
     },
   };
 }
@@ -68,7 +68,7 @@ export function exitModuleMode(): void {
   setActiveAuthoring(null);
   setActiveSystems(null);
   clearMountFailureReports(); // D-W3: no session -> nothing left to report (mirrors ingest/mount-ingest-root.ts's unmountThreeIngestRoot)
-  s.store.setPlayState('stopped');
+  s.store.shell.setPlayState('stopped');
   try {
     s.stop();
   } catch {
@@ -93,7 +93,7 @@ export async function mountModuleRootRuntime(
   width: number,
   height: number,
 ): Promise<{ session: GameSession; specs: RootMountSpec[] }> {
-  const { createGameRuntime } = await import('@volter/game-runtime/runtime/create-runtime');
+  const { createGameRuntime } = await import('../runtime/create-runtime');
   const specs = await resolveAllRoots({ ...manifest, roots: [world] }, projectRoot);
   const session = await createGameRuntime({ container, roots: specs, width, height });
   return { session, specs };
@@ -114,7 +114,7 @@ export async function enterModuleModeFromManifestRoot(
     return;
   }
 
-  store.setPlayState('playing');
+  store.shell.setPlayState('playing');
   editorConsole.log(
     `Mounting custom adapter module for world "${world.id}" (kind: ${world.surface})`,
     'adapter',
@@ -142,11 +142,11 @@ export async function enterModuleModeFromManifestRoot(
     activeAuthoring = withStoreSelection(mounted.authoring, store);
   } else {
     // Honest answer for a module adapter that declares no authoring surface.
-    activeAuthoring = makeNoAuthoringAdapter(store, `${adapterId} (no authoring surface)`);
+    activeAuthoring = makeNoAuthoringAdapter(store.shell, `${adapterId} (no authoring surface)`);
   }
   setActiveAuthoring(activeAuthoring);
   setActiveSystems(mounted.systems ?? {});
-  store.notifyIngestEdit();
+  store.shell.notifyIngestEdit();
   clearMountFailureReports(); // D-W3: mount succeeded
 
   // Measured from the mounted adapter rather than declared by the route.