@volter/editor-game 0.5.65 → 0.5.66

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

@@ -30,7 +30,8 @@
  * ingest keeps its own lifecycle).
  */
 
-import { commandLine } from '@volter/editor-core/product-command';
+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';
@@ -188,8 +189,9 @@ export async function mountDeferredIngestForPlay(store: EditorShellStore): Promi
   // the Scene tab because, until now, that mount WAS edit mode; a play-time
   // mount belongs on the play surface — which is also what opens the input
   // gate (`mount-three-ingest-root.ts`'s `ingestInputActive` requires the play
-  // tab), so the game is drivable rather than merely visible.
-  store.setActiveViewportTab('play');
+  // tab, which is the Game document having focus), so the game is drivable rather than
+  // merely visible.
+  activateLiveDocument();
   getIngestPlayControl()?.play();
   return true;
 }
@@ -207,7 +209,6 @@ export function exitDeferredIngestPlay(store: EditorShellStore): boolean {
   // the adopted scene, and resets the play surface.
   exitActiveIngest();
   store.setPlayState('stopped');
-  store.setActiveViewportTab('edit');
   // 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/ingest-boot-viewport.ts

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

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

@@ -17,9 +17,9 @@
 import {
   getMountFailureReports,
   subscribeToMountFailures,
-} from '@volter/editor-core/authoring/mount-failure-report';
+} from '@volter/editor-sdk/kit/mount-failure-report';
 import { installCanvasSceneNavigation } from '@volter/editor-core/authoring/react-canvas-navigation';
-import { createRootViewController } from '@volter/editor-core/authoring/world-pan-state';
+import { createRootViewController } from '@volter/editor-sdk/kit/world-pan-state';
 import {
   CANVAS_SCENE_BACKGROUND,
   CanvasSceneBackdrop,
@@ -28,14 +28,14 @@ import {
 import { RootSelectionOverlay } from '@volter/editor-core/components/RootSelectionOverlay';
 import { SurfaceStateOverlay } from '@volter/editor-core/components/SurfaceStateOverlay';
 import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { liveDocumentContainer } from '@volter/editor-core/live-document';
+import { liveDocumentContainer } from '@volter/editor-sdk/kit/live-document';
 import { projectAdapterFacet } from '@volter/editor-core/project-adapter';
-import { readinessFacet, subscribeRootReadiness } from '@volter/editor-core/readiness';
-import { explainSurface } from '@volter/editor-core/surface-state';
+import { readinessFacet, subscribeRootReadiness } from '@volter/editor-sdk/kit/readiness';
+import { explainSurface } from '@volter/editor-sdk/kit/surface-state';
 import {
   registerWorkspaceDocumentSelection,
   type WorkspaceDocumentContentProps,
-} from '@volter/editor-core/workspace-document-registry';
+} from '@volter/editor-sdk/kit/workspace-document-registry';
 import type { AuthoringAdapter } from '@volter/editor-project/adapter';
 import { useEffect, useRef, useSyncExternalStore } from 'react';
 import { activeIngest } from './active-ingest';
@@ -147,7 +147,7 @@ export function IngestCanvasSceneContent({
         touchAction: 'none',
       }}
     >
-      <CanvasSceneBackdrop view={view} />
+      <CanvasSceneBackdrop view={view} documentId={documentId} />
       <RootSelectionOverlay adapter={adapter} view={view} transformModeAware />
       <SurfaceStateOverlay
         explanation={surfaceExplanation}
@@ -159,6 +159,7 @@ export function IngestCanvasSceneContent({
         adapter={adapter}
         containerRef={containerRef}
         view={view}
+        documentId={documentId}
       />
     </div>
   );
@@ -173,5 +174,5 @@ export function installIngestCanvasScene(store: EditorShellStore): () => void {
   const Content = (props: WorkspaceDocumentContentProps) => (
     <IngestCanvasSceneContent {...props} adapter={adapter} store={store} worldId={worldId} />
   );
-  return installIngestCanvasSceneDocument(store, Content);
+  return installIngestCanvasSceneDocument(Content);
 }

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

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

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

@@ -9,9 +9,9 @@
  */
 
 import { gameContractEpoch } from '../host/coverage/game-contract-seam-evidence';
-import { recordLiveSeamEvidence } from '@volter/editor-core/coverage/live-seam-evidence';
-import { editorConsole } from '@volter/editor-core/editor-console';
-import { activateLiveDocument } from '@volter/editor-core/live-document';
+import { recordLiveSeamEvidence } from '@volter/editor-sdk/kit/live-seam-evidence';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+import { activateLiveDocument } from '@volter/editor-sdk/kit/live-document';
 import type { VgaiGameContract } from '@volter/editor-project/adapter/ingest/game-contract';
 import { activeIngest, type IngestLifecycleControl } from './active-ingest';
 import { readIngestGameContract } from './game-contract-realm';

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

@@ -55,7 +55,7 @@
  * notice.
  */
 
-import { adapterObservations } from '@volter/editor-core/adapter-observation';
+import { adapterObservations } from '@volter/editor-sdk/kit/adapter-observation';
 import { createContractDebugAdapter } from '@volter/game-runtime/adapter/ingest/contract-debug-adapter';
 import {
   type ContractSurface,

package/src/ingest/ingest-siblings.ts

@@ -46,14 +46,14 @@
 import {
   addMountFailureReport,
   formatMountFailureMessage,
-} from '@volter/editor-core/authoring/mount-failure-report';
+} 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 { 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-core/crash-null-boundary';
-import { editorConsole } from '@volter/editor-core/editor-console';
+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 { authoringJournal } from '../host/history/json-history-resource';
 import { activeRealmServices } from '../host/realm-services';

package/src/ingest/module-mode.ts

@@ -12,10 +12,10 @@ import {
   addMountFailureReport,
   clearMountFailureReports,
   formatMountFailureMessage,
-} from '@volter/editor-core/authoring/mount-failure-report';
+} from '@volter/editor-sdk/kit/mount-failure-report';
 import { makeNoAuthoringAdapter } from '@volter/editor-core/authoring/no-authoring-adapter';
 import { resolveAllRoots } from '../host/binding-resolver';
-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 { fetchGameManifest } from '@volter/editor-core/manifest-project';
 import { getCurrentProject } from '@volter/editor-core/project-manager';
@@ -146,7 +146,6 @@ export async function enterModuleModeFromManifestRoot(
   }
   setActiveAuthoring(activeAuthoring);
   setActiveSystems(mounted.systems ?? {});
-  store.setActiveViewportTab('play');
   store.notifyIngestEdit();
   clearMountFailureReports(); // D-W3: mount succeeded
 
@@ -215,9 +214,9 @@ export async function tryManifestModuleRoute(store: EditorShellStore): Promise<b
   return true;
 }
 
-import { acquireLiveDocument, liveDocumentContainer } from '@volter/editor-core/live-document';
+import { acquireLiveDocument, liveDocumentContainer } from '@volter/editor-sdk/kit/live-document';
 // THE MODULE LANE, as the host sees it (`live-session-registry.ts`).
-import { registerLiveSession } from '@volter/editor-core/live-session-registry';
+import { registerLiveSession } from '@volter/editor-sdk/kit/live-session-registry';
 
 registerLiveSession({
   id: 'module',

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

@@ -35,7 +35,7 @@ import {
   type ContractScenesStories,
   createContractScenesStories,
 } from '../host/authoring/contract-scenes-stories';
-import { clearMountFailureReports } from '@volter/editor-core/authoring/mount-failure-report';
+import { clearMountFailureReports } from '@volter/editor-sdk/kit/mount-failure-report';
 import { PhaserLiveAuthoringAdapter } from '../host/authoring/phaser-live-authoring-adapter';
 import { PixiAuthoringAdapter } from '../host/authoring/pixi-authoring-adapter';
 import { createCreationSiteCanvasWriteTarget } from '../host/authoring/pixi-creation-site-write-target';
@@ -44,7 +44,7 @@ import {
   capturePixiDisplayObjectThumbnail,
   registerPresentedPixiApps,
 } from '@volter/editor-core/canvas-preview-frames';
-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 {
@@ -54,9 +54,9 @@ import {
   setGameSurface,
 } from '../host/gated-globals';
 import { authoringJournal } from '../host/history/json-history-resource';
-import { acquireLiveDocument, liveDocumentContainer } from '@volter/editor-core/live-document';
+import { acquireLiveDocument, liveDocumentContainer } from '@volter/editor-sdk/kit/live-document';
 import { getCurrentProject } from '@volter/editor-core/project-manager';
-import { recordRootReadiness } from '@volter/editor-core/readiness';
+import { recordRootReadiness } from '@volter/editor-sdk/kit/readiness';
 import type { MeasuredLoop } from '../host/same-realm-loop-gate';
 import { projectContractSystemAdapters } from '@volter/game-runtime/adapter/ingest/contract-system-adapters';
 import type { RenderDebugWiring } from '@volter/game-runtime/dev/render-debug-adapter';
@@ -346,7 +346,7 @@ function publishStructuralCanvasRuntime(
   // host-owned registry carrier to compose with either: what the game itself
   // declared is the only physics this route can have.
   publishCanvasIngestSystems(game.name, undefined, declaredCanvasPhysics());
-  landIngestBootInEdit(store);
+  landIngestBootInEdit();
   store.notifyIngestEdit();
   clearMountFailureReports();
 
@@ -770,7 +770,7 @@ async function mountCanvasIngestRootInner(
     mount.capture.captured?.renderer,
     declaredPhysics ? physicsAdapter : null,
   );
-  landIngestBootInEdit(store);
+  landIngestBootInEdit();
   store.notifyIngestEdit();
   clearMountFailureReports(); // D-W3: mount succeeded
   // PD-3: the mount stood — but `contract-ready` may only be recorded when the

package/src/ingest/mount-coverage.ts

@@ -26,8 +26,8 @@ import {
   type SystemAdapterMeasurement,
   type WriteReachFacts,
 } from '../host/coverage/capability-coverage';
-import { inspectSystemAdapterSeam } from '@volter/editor-core/coverage/system-seam-evidence';
-import { editorConsole } from '@volter/editor-core/editor-console';
+import { inspectSystemAdapterSeam } from '@volter/editor-sdk/kit/system-seam-evidence';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import {
   type MeasuredLoop,
   measuredLoop,

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

@@ -8,13 +8,13 @@
 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 { clearMountFailureReports } from '@volter/editor-core/authoring/mount-failure-report';
+import { clearMountFailureReports } from '@volter/editor-sdk/kit/mount-failure-report';
 import { resolveAllRoots } from '../host/binding-resolver';
-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 { setGameInputGate } from '../host/gated-globals';
 import { authoringJournal } from '../host/history/json-history-resource';
-import { acquireLiveDocument, liveDocumentContainer } from '@volter/editor-core/live-document';
+import { acquireLiveDocument, liveDocumentContainer } from '@volter/editor-sdk/kit/live-document';
 import { DomAuthoringAdapter } from '../react/dom-authoring-adapter';
 import type { ResolvedAdapterRoot, ResolvedGameManifest } from '@volter/editor-project/manifest/load';
 import { serializeEntry, setActiveIngest } from './active-ingest';
@@ -148,7 +148,7 @@ async function mountDomIngestRootInner(store: EditorShellStore, folderId: string
 
   setActiveAuthoring(adapter);
   setActiveSystems({});
-  landIngestBootInEdit(store);
+  landIngestBootInEdit();
   store.notifyIngestEdit();
   clearMountFailureReports(); // D-W3: mount succeeded
 
@@ -253,7 +253,7 @@ export async function mountDomIngestRootFromManifest(
 
   setActiveAuthoring(adapter);
   setActiveSystems({});
-  landIngestBootInEdit(store);
+  landIngestBootInEdit();
   store.notifyIngestEdit();
   clearMountFailureReports(); // D-W3: mount succeeded
 

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

@@ -34,14 +34,14 @@ import {
   formatMountFailureMessage,
   getMountFailureReports,
   type MountFailureReport,
-} from '@volter/editor-core/authoring/mount-failure-report';
-import { editorConsole } from '@volter/editor-core/editor-console';
+} from '@volter/editor-sdk/kit/mount-failure-report';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { registerEditorStateFacet } from '@volter/editor-core/editor-state-facets';
-import { liveDocumentContainer } from '@volter/editor-core/live-document';
+import { registerEditorStateFacet } from '@volter/editor-sdk/kit/editor-state-facets';
+import { liveDocumentContainer } from '@volter/editor-sdk/kit/live-document';
 import { fetchGameManifest, isManifestAbsence } from '@volter/editor-core/manifest-project';
 import { getCurrentProject } from '@volter/editor-core/project-manager';
-import { onShellStore } from '@volter/editor-core/shell-store-door';
+import { onThreeStore } from '@volter/editor-core/shell-store-door';
 import { ingestRoots, rootById } from '@volter/editor-project/adapter/manifest-interpreter';
 import { MANIFEST_FILENAME } from '@volter/editor-project/manifest/filename';
 import type { ResolvedAdapterRoot, ResolvedGameManifest } from '@volter/editor-project/manifest/load';
@@ -149,7 +149,7 @@ let _boundStore: EditorShellStore | null = null;
  * `project-session-reset.ts`, fired by `project-manager.ts`'s
  * `onProjectSessionEnd`.
  */
-onShellStore((store) => {
+onThreeStore((store) => {
   _boundStore = store;
   clearMountFailureReports();
 });
@@ -677,7 +677,7 @@ async function autoLaunchIngestInner(store: EditorShellStore): Promise<void> {
     // never let an old bootstrap override it.
     if (deferredIngestPlayActive()) return;
     const { landIngestBootInEdit } = await import('./ingest-boot-viewport');
-    landIngestBootInEdit(store);
+    landIngestBootInEdit();
     return;
   }
   await launchIngestRoutes(store);

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

@@ -22,11 +22,11 @@ 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 { withContractHierarchy } from '../host/authoring/contract-hierarchy-authoring';
-import { clearMountFailureReports } from '@volter/editor-core/authoring/mount-failure-report';
-import { editorConsole } from '@volter/editor-core/editor-console';
+import { clearMountFailureReports } from '@volter/editor-sdk/kit/mount-failure-report';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
 import { gameLoopGate, setGameInputGate } from '../host/gated-globals';
-import { acquireLiveDocument, liveDocumentContainer } from '@volter/editor-core/live-document';
+import { acquireLiveDocument, liveDocumentContainer } from '@volter/editor-sdk/kit/live-document';
 import { pickGameCamera } from '@volter/editor-core/scene-framing';
 import type { ResolvedAdapterRoot } from '@volter/editor-project/manifest/load';
 import type { CaptureMechanism } from '@volter/threejs-runtime/adapter/ingest/scene-capture';
@@ -164,7 +164,7 @@ function activateCapturedThreeIngest(args: {
   // level-streaming game captures on its first drawn frame and then parses its
   // world in for several seconds afterwards.
   store.focusOnScene(() => pickGameCamera(mount.capture.captured?.camera, liveScene));
-  landIngestBootInEdit(store);
+  landIngestBootInEdit();
   store.notifyIngestEdit(); // ensure panels re-render against the override
   clearMountFailureReports(); // D-W3: mount succeeded
 

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

@@ -18,8 +18,8 @@
 
 import { setActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
 import { setActiveSystems } from '@volter/editor-core/authoring/active-systems';
-import { clearMountFailureReports } from '@volter/editor-core/authoring/mount-failure-report';
-import { editorConsole } from '@volter/editor-core/editor-console';
+import { clearMountFailureReports } from '@volter/editor-sdk/kit/mount-failure-report';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import { reclaimGameRealm } from '../host/game-realm-reclaim';
 import { setGameRealmReloadHandler } from '../host/gated-globals';
 import {

package/src/play/play-mode.ts

@@ -1,4 +1,5 @@
-import { onAssetReload } from '@volter/editor-core/project-asset-refresh';
+import { onAssetReload } from '@volter/editor-sdk/kit/project-asset-refresh';
+import { evictDreiCaches } from '../three/drei-asset-caches';
 import { editorHost } from '@volter/editor-sdk/host';
 
 /**
@@ -33,22 +34,22 @@ import {
   resolvesLiveOnly,
   runWritePipe,
   type WriteAck,
-} from '@volter/editor-core/authoring/write-pipe';
+} from '@volter/editor-sdk/kit/write-pipe';
 import { resolveAllRootEntries } from '../host/binding-resolver';
 import type { LogEntry } from '@volter/editor-core/editor-api';
 import { endLogSession, flushLogEntries, startLogSession } from '@volter/editor-core/editor-api';
-import type { ConsoleEntry } from '@volter/editor-core/editor-console';
+import type { ConsoleEntry } from '@volter/editor-sdk/kit/editor-console';
 import {
   editorConsole,
   formatConsoleArgs,
   resumeEditorConsoleCapture,
   suspendEditorConsoleCapture,
-} from '@volter/editor-core/editor-console';
+} from '@volter/editor-sdk/kit/editor-console';
 import { EDITOR_PARTICIPANT_ID, sendControl } from '@volter/editor-core/editor-presence';
 import {
   isEditorPresentationActive,
   subscribeEditorPresentationActivity,
-} from '@volter/editor-core/editor-presentation-activity';
+} from '@volter/editor-sdk/kit/editor-presentation-activity';
 import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
 import { GAME_SURFACE_CONTAINMENT_CSS } from '../host/game-realm-page';
 import { reclaimGameRealm } from '../host/game-realm-reclaim';
@@ -60,9 +61,9 @@ import {
   setGameInputGate,
   setGameSurface,
 } from '../host/gated-globals';
-import { hierarchyProjectionFromProjectConfig } from '@volter/editor-core/hierarchy-projection';
+import { hierarchyProjectionFromProjectConfig } from '@volter/editor-sdk/kit/hierarchy-projection';
 import { type JournalSubject, playJournal } from '../host/history/json-history-resource';
-import { isEditableTarget, setActiveScope } from '@volter/editor-core/hotkeys';
+import { isEditableTarget, setActiveScope } from '@volter/editor-sdk/kit/hotkeys';
 import { projectBootstrapSettled } from '@volter/editor-core/initial-project';
 import { registerGameNullSubject } from '@volter/editor-core/inspection/game-subject';
 import { fetchGameManifest } from '@volter/editor-core/manifest-project';
@@ -73,21 +74,21 @@ import {
   markPlayBootPhase,
   type PlayBootPhase,
 } from '@volter/editor-core/play-boot-phase';
-import { presentationSurface } from '@volter/editor-core/presentation-surface';
+import { presentationSurface } from '@volter/editor-sdk/kit/presentation-surface';
 import { getCurrentProject } from '@volter/editor-core/project-manager';
 import {
   beginProjectModuleSplitWatch,
   clearProjectModuleSplitReports,
   endProjectModuleSplitWatch,
   formatProjectModuleSplitMessage,
-} from '@volter/editor-core/project-module-split';
-import { clearRootReadiness, recordRootReadiness } from '@volter/editor-core/readiness';
-import { onShellStore } from '@volter/editor-core/shell-store-door';
+} from '@volter/editor-sdk/kit/project-module-split';
+import { clearRootReadiness, recordRootReadiness } from '@volter/editor-sdk/kit/readiness';
+import { onThreeStore } from '@volter/editor-core/shell-store-door';
 import { mountedStoryHasPixiContent } from '@volter/editor-core/stories/pixi-story-model';
 import { domHasRenderableContent, threeSceneHasRenderableContent } from '../host/surface-content';
-import { subscribeSurfaceKeyboard, surfaceHoldsKeyboard } from '@volter/editor-core/surface-keyboard';
+import { subscribeSurfaceKeyboard, surfaceHoldsKeyboard } from '@volter/editor-sdk/kit/surface-keyboard';
 import { publishToolContributionPlay } from '@volter/editor-core/tool-contribution-play';
-import { liveWorldId } from '../host/viewport-root-presentation';
+import { liveWorldId, presentThreeRoots } from '../host/viewport-root-presentation';
 import {
   cancelPendingWorkspacePlayUtilities,
   revealWorkspacePlayUtilities,
@@ -945,7 +946,9 @@ function drainDebugEventsToPlayLog(): void {
 }
 
 // Asset bytes have changed, but a running game retains its own instances.
-const stopAssetReload = onAssetReload(() => {
+const stopAssetReload = onAssetReload((paths) => {
+  // Cleared whether or not a run is live, so the next run loads the new bytes.
+  void evictDreiCaches(paths);
   if (!_instance.session) return;
   markRestartRequired(
     'Project assets changed — restart play to load the revised models or textures.',
@@ -1036,7 +1039,7 @@ function focusGameSurface(): void {
  * workspace panel names Play to hand it the store; the authored viewport is
  * read through `viewport-door.ts` when a session presents its roots.
  */
-onShellStore((store) => bindPlayMode(store));
+onThreeStore((store) => bindPlayMode(store));
 
 export function bindPlayMode(store: EditorShellStore): void {
   _ctx = { store, gameContainer: null! }; // set dynamically from the live document's container
@@ -1821,7 +1824,12 @@ async function enterPlayModeInner(
     // liveHierarchy: first-party play mode is the ONLY adoption path that may
     // synthesize descriptors for untagged runtime objects (anti-shim rule —
     // ingest/module mounts adopt foreign scenes and must never fabricate).
-    _instance.presentation = editorHost().viewport.presentRoots(session.game.roots);
+    // With no stage bound to present them (no Scene tab open: the Game tab and a model document
+    // are the whole layout), Play still adopts its roots, so the hierarchy door and every
+    // inspector reach the live objects exactly as they do beside a Scene tab.
+    _instance.presentation =
+      editorHost().viewport.presentRoots(session.game.roots) ??
+      presentThreeRoots(store, session.game.roots);
     markPlayBootPhase('installing play authoring for each root');
     await installPlayRootAuthoring(
       store,
@@ -1883,6 +1891,12 @@ async function enterPlayModeInner(
     // baked into their own urls, so the gate has to be registered under it or
     // the modules find the default realm's gate instead of their own.
     setGameInputGate(() => instanceInputActive(mountId), mountId);
+    // THE DEFAULT REALM follows the focused instance too. Module-lifetime code
+    // that no mount id reaches lives there — a game's own `InputManager`
+    // (`@volter/game-runtime`'s input, served through the realm shadow) — and
+    // the stop path leaves it open, so a key aimed at a Model document while
+    // the game played still reached it.
+    setGameInputGate(() => instanceInputActive(focusedInstanceId()));
     // Sync EVERY live instance's first-party InputManager from the play/tab/
     // focus predicate whenever the store changes (a tab switch flips the active
     // viewport for all of them). `resyncInstanceInputs` resolves each

package/src/play/play-recording.ts

@@ -38,7 +38,7 @@
  */
 
 import { isRootCanvas } from '@volter/editor-core/composite-screenshot';
-import { editorConsole } from '@volter/editor-core/editor-console';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import {
   type GameplayRecordingCapture,
   type GameplayRecordingStarted,

package/src/profiler/PerformancePanel.tsx

@@ -17,7 +17,7 @@ import {
   type TimeSpentRow,
   timeSpentRows,
 } from '../host/components/frame-debugger-model';
-import { isJsHeapReading, readJsHeap } from '@volter/editor-core/js-heap';
+import { isJsHeapReading, readJsHeap } from '@volter/editor-sdk/kit/js-heap';
 import { useActivePerformanceSource } from '../host/use-active-performance-source';
 import { editorHost, useHostAvailabilitySelector } from '@volter/editor-sdk/host';
 import {

package/src/react/design-time-react-mount.ts

@@ -4,8 +4,8 @@
  * composed story of the project laid out as an isolated, labeled frame, with
  * the root entry's own story (derived, never labeled — the story whose CSF
  * `meta.component` is the entry's default export) as the frame it opens on.
- * A project with no stories, and the pasteboard document's `entryOnly`
- * descriptor, fall back to mounting the entry once against an inert Game.
+ * A project with no stories falls back to mounting the entry once against an
+ * inert Game.
  *
  * ## Why this is a package and not the host's
  *
@@ -38,8 +38,7 @@
  *    them as `@volter/editor-game/react/…` and declares the dependency.
  *  - `@editor/authoring/react-story-board.ts` (the board geometry) —
  *    `@editor/components/RootSelectionOverlay.tsx:98`,
- *    `@editor/components/ReactCanvasControls.tsx:15`,
- *    `@editor/pasteboard-materialize.ts:20` and
+ *    `@editor/components/ReactCanvasControls.tsx:15` and
  *    `@editor/canvas-board/CanvasBoardDocument.tsx:57` read its frame
  *    placements. Host chrome drawn OVER the board, which is a different
  *    question from how the board mounts.
@@ -65,17 +64,17 @@ import {
   rememberPortableStory,
 } from '@volter/editor-core/authoring/design-time-layers';
 import type { DesignTimeMountContext } from '@volter/editor-core/authoring/design-time-mount-registry';
-import { formatMountFailureMessage } from '@volter/editor-core/authoring/mount-failure-report';
+import { formatMountFailureMessage } from '@volter/editor-sdk/kit/mount-failure-report';
 import type { ReactStoryBoardSelectionIntent } from '@volter/editor-core/authoring/react-story-board';
 import { createReactStoryBoard } from '@volter/editor-core/authoring/react-story-board';
 import {
   getRootCanvasViewport,
   setRootCanvasViewport,
-} from '@volter/editor-core/authoring/world-canvas-viewport-state';
-import { recordAuthoringConsumerUse } from '@volter/editor-core/coverage/authoring-seam-evidence';
-import { CrashNullBoundary } from '@volter/editor-core/crash-null-boundary';
+} from '@volter/editor-sdk/kit/world-canvas-viewport-state';
+import { recordAuthoringConsumerUse } from '@volter/editor-sdk/kit/authoring-seam-evidence';
+import { CrashNullBoundary } from '@volter/editor-sdk/kit/crash-null-boundary';
 import { readProjectTextFile } from '@volter/editor-core/editor-api';
-import { editorConsole } from '@volter/editor-core/editor-console';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import {
   resolveReactRootMountRuntime,
   resolveWorldProviderForProject,
@@ -101,7 +100,7 @@ import {
 import { domStoryBoardMembers } from '@volter/editor-core/stories/three-story-model';
 import { getDesignTokens } from '@volter/editor-core/ui-source/inspect';
 import { tierSourceWriteBackend } from '@volter/editor-core/ui-source/tier-source-write-backend';
-import { recordViewportFirstFrame } from '@volter/editor-core/viewport-activation-timings';
+import { recordViewportFirstFrame } from '@volter/editor-sdk/kit/viewport-activation-timings';
 import { createAssetCache } from '@volter/threejs-runtime/assets';
 import { createGameLoop } from '@volter/game-runtime/core/game-loop';
 import type { ResolvedAdapterRoot } from '@volter/editor-project/manifest/load';
@@ -352,7 +351,7 @@ export async function mountReactDesignLayer(
   // is only what picks the INITIAL frame). Without this the derivation would
   // silently gate the entire design surface — a broken entry would take every
   // story down with it.
-  if (portableStories.length > 0 && !candidate.entryOnly) {
+  if (portableStories.length > 0) {
     const rememberedStoryId = rememberedPortableStory(projectRoot, candidate.worldId);
     // Remembered choice, else the derived default, else discovery order —
     // the same "no explicit default falls back to first" rule the registry
@@ -612,18 +611,13 @@ export async function mountReactDesignLayer(
   // (the caller degrades it to a #18 disclosure node).
   if (!entry.ok) throw entry.error instanceof Error ? entry.error : new Error(String(entry.error));
 
-  // An entryOnly mount (the pasteboard document) ASKED for exactly this
-  // branch — the file is the canvas and its default export the one subject —
-  // so "no CSF preview, falling back" would be noise about working-as-designed.
-  if (!candidate.entryOnly) {
-    editorConsole.warn(
-      `[design-time-layers] React root "${candidate.worldId}" has no portable CSF preview — the ` +
-        'project declares no UI stories. Add a *.stories.tsx; give it a `meta.component` of ' +
-        `this root's entry component${entryComponentName ? ` (${entryComponentName}, ${candidate.path})` : ''} ` +
-        'to make it this root’s default preview. Falling back to the inert-Game preview.',
-      'authoring',
-    );
-  }
+  editorConsole.warn(
+    `[design-time-layers] React root "${candidate.worldId}" has no portable CSF preview — the ` +
+      'project declares no UI stories. Add a *.stories.tsx; give it a `meta.component` of ' +
+      `this root's entry component${entryComponentName ? ` (${entryComponentName}, ${candidate.path})` : ''} ` +
+      'to make it this root’s default preview. Falling back to the inert-Game preview.',
+    'authoring',
+  );
 
   const Entry = entry.Entry;
   const WorldProvider = await resolveWorldProviderForProject();