@volter/editor-game 0.5.65 → 0.5.67

package/src/three/authoring/reflection-probe-inspector-section.tsx

@@ -1,9 +1,10 @@
-import { useEditorStore } from '@volter/editor-core/editor-runtime';
-import type { InspectorSectionProps } from '@volter/editor-core/inspector-section-registry';
+import { threeObject } from '@volter/editor-threejs/adapter/three-contract';
+import type { InspectorSectionProps } from '@volter/editor-sdk/kit/inspector-section-registry';
 import type { AuthoringAdapter, EditorNode } from '@volter/editor-project/adapter';
 import { type ReflectionProbeSnapshot, reflectionProbeOf } from '@volter/threejs-runtime/adapter/reflection-probe';
 import { Button, EditorBanner, FieldGroup, FieldRow, Text } from '@volter/editor-sdk/widgets';
 import { useSyncExternalStore } from 'react';
+import { useThreeEditorStore } from '@volter/editor-threejs/kit/three-state';
 
 export function matches(node: EditorNode | null, adapter: AuthoringAdapter): boolean {
   void adapter;
@@ -20,9 +21,9 @@ const STATUS_LABEL: Record<ReflectionProbeSnapshot['status'], string> = {
 const EMPTY_SNAPSHOT: ReflectionProbeSnapshot = { status: 'idle', lastCapturedAt: null };
 
 export function ReflectionProbeCaptureSection({ adapter, nodeId }: InspectorSectionProps) {
-  const store = useEditorStore();
+  const store = useThreeEditorStore();
   const object = nodeId
-    ? (store.objectMap.get(nodeId) ?? adapter.hierarchy.object3D?.(nodeId))
+    ? (store.objectMap.get(nodeId) ?? threeObject(adapter.hierarchy, nodeId))
     : null;
   const probe = reflectionProbeOf(object);
   const snapshot = useSyncExternalStore(

package/src/three/authoring/spatial-joint-handles.ts

@@ -1,6 +1,6 @@
 /** Native Rapier impulse-joint anchors projected onto generic viewport guides. */
 
-import type { R3fJointBinding, R3fJointLiteral } from '@volter/editor-core/ui-source/r3f-joint-binding';
+import type { R3fJointBinding, R3fJointLiteral } from '@volter/editor-react/source/r3f-joint-binding';
 import type { PhysicsJointSnapshot, SpatialHandleLayer, SpatialPoint3 } from '@volter/editor-project/adapter';
 import * as THREE from 'three';
 

package/src/three/authoring/spatial-lod-handles.ts

@@ -1,6 +1,6 @@
 /** Native THREE.LOD distance thresholds projected onto generic viewport guides. */
 
-import type { R3fLodBinding } from '@volter/editor-core/ui-source/r3f-lod-binding';
+import type { R3fLodBinding } from '@volter/editor-react/source/r3f-lod-binding';
 import type { SpatialHandleLayer, SpatialPoint3 } from '@volter/editor-project/adapter';
 import * as THREE from 'three';
 

package/src/three/authoring/spatial-particle-handles.ts

@@ -3,7 +3,7 @@
 import type {
   QuarksEmitterShape,
   R3fParticleBinding,
-} from '@volter/editor-core/ui-source/r3f-particle-binding';
+} from '@volter/editor-react/source/r3f-particle-binding';
 import type { SpatialHandleLayer, SpatialPoint3 } from '@volter/editor-project/adapter';
 import * as THREE from 'three';
 

package/src/three/authoring/three-authoring-adapter.ts

@@ -51,12 +51,12 @@
  * create/delete/reparent is not meaningfully re-expressible against it.
  */
 
-import { getActiveNetworking, getActivePhysics } from '@volter/editor-core/authoring/active-systems';
+import { getActiveNetworking, getActivePhysics } from '@volter/editor-sdk/kit/authoring/active-systems';
 import {
   authoringOidOf,
   isComponentInstanceRoot,
   ownOidOf,
-} from '@volter/editor-core/authoring/component-instance-root';
+} from '@volter/editor-threejs/kit/authoring/component-instance-root';
 import { creationSiteRelated } from '../../host/authoring/creation-site-related';
 import { createEphemeralPersistence } from '../../host/authoring/ephemeral-persistence';
 import { multiChannelRefusal, persistChannelWrite } from '../../host/authoring/gesture-persist';
@@ -67,7 +67,7 @@ import {
   type SourcePersistenceBackend,
   type SourceWriteSubject,
 } from '../../host/authoring/source-persistence-backend';
-import { readLocalTransform } from '@volter/editor-core/authoring/three-projection-core';
+import { readLocalTransform } from '@volter/editor-threejs/kit/authoring/three-projection-core';
 import {
   LIVE_ONLY_ACK,
   LIVE_ONLY_DESTINATION,
@@ -76,20 +76,20 @@ import {
   runWritePipe,
   type WriteAck,
   type WriteResolution,
-} from '@volter/editor-core/authoring/write-pipe';
-import { componentStatesProvider } from '@volter/editor-core/component-states-registry';
+} from '@volter/editor-sdk/kit/write-pipe';
+import { componentStatesProvider } from '@volter/editor-sdk/kit/component-states-registry';
 import {
   type ChannelValue,
   type CreationSiteLiteralReport,
   channelFor,
-} from '@volter/editor-core/creation-site-edit';
+} from '@volter/editor-sdk/kit/creation-site-edit';
 import {
   creationSiteAnchor,
   instancesAtSite,
   NO_OBJECT_REASON,
-} from '@volter/editor-core/creation-site-registry';
-import { editorConsole } from '@volter/editor-core/editor-console';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+} from '@volter/editor-sdk/kit/creation-site-registry';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import { type JournalSubject, JsonHistoryResource } from '../../host/history/json-history-resource';
 import {
   nativeKindOf,
@@ -100,8 +100,8 @@ import {
   type ThreeProjectionDelta,
   ThreeProjector,
   type ThreeWalkStats,
-} from '@volter/editor-core/projection/three';
-import type { SourceWriteBackend } from '@volter/editor-core/ui-source/source-write-backend';
+} from '@volter/editor-threejs/kit/projection/three';
+import type { SourceWriteBackend } from '@volter/editor-sdk/kit/ui-source/source-write-backend';
 import type {
   AuthoringAdapter,
   AuthoringCapabilities,
@@ -498,7 +498,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
           const object = this.objectOf(id);
           const values = this.captureChannelBaseline(id) ?? {};
           const ack = await options.sourceCommit!.commit(authoringOidOf(object), values);
-          if (ack.persisted) this.store.notifyIngestEdit();
+          if (ack.persisted) this.store.shell.notifyIngestEdit();
           return ack;
         },
       };
@@ -509,7 +509,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
       // scene object honestly returns none. `typeLabel` is the component name
       // the OID stamp put there (`toEditorNode`), which is exactly what
       // `meta.component` names.
-      this.stories = componentStatesProvider('three', store, (nodeId) => {
+      this.stories = componentStatesProvider('three', store.shell, (nodeId) => {
         const node = this.hierarchy.node(nodeId);
         if (node?.role !== 'component') return null;
         return { name: node.typeLabel ?? node.label };
@@ -522,7 +522,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
     // entries; one with a backend needs them, because
     // a running world does not re-derive its scene from source and undoing only
     // a file would leave the world showing the edit it just undid.
-    const history = store.projectHistory;
+    const history = store.shell.projectHistory;
     this.historyResource =
       this.persist && history
         ? new JsonHistoryResource({
@@ -714,9 +714,9 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
         if (object !== null) map.set(id, object);
       }
     }
-    const retainedSelection = [...this.store.selectedEntityIds].filter((id) => map.has(id));
-    if (retainedSelection.length !== this.store.selectedEntityIds.size) {
-      this.store.selectMultiple(retainedSelection);
+    const retainedSelection = [...this.store.shell.selectedEntityIds].filter((id) => map.has(id));
+    if (retainedSelection.length !== this.store.shell.selectedEntityIds.size) {
+      this.store.shell.selectMultiple(retainedSelection);
     }
   }
 
@@ -801,12 +801,12 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
       return node ? this.toEditorNode(node) : null;
     },
     object3D: (id) => this.objectOf(id),
-    idForObject3D: (object) => this.projector.idOf(object),
+    idForObject3D: (object: THREE.Object3D) => this.projector.idOf(object),
   };
 
   readonly selection: SelectionProvider = {
-    get: () => [...this.store.selectedEntityIds],
-    set: (ids) => this.store.selectMultiple(ids),
+    get: () => [...this.store.shell.selectedEntityIds],
+    set: (ids) => this.store.shell.selectMultiple(ids),
     // Component boundaries are closed by default: a normal pick resolves to the
     // outermost component owner, a scoped pick to the next nested one, and a
     // deep pick advances one further. Deliberately the same contract the source
@@ -916,7 +916,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
           ...this.removableFlag(id, channel),
         };
       }
-      if (this.frameControl === 'host' && this.store.playState === 'playing') {
+      if (this.frameControl === 'host' && this.store.shell.playState === 'playing') {
         return { writable: true, reason: LIVE_FRAME_REASON, ...this.removableFlag(id, channel) };
       }
       if (!this.persist) return { writable: true };
@@ -964,7 +964,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
       // adapter cannot pause, which is the whole play-mode case.
       this.physicsFor(id)?.commit(id, transform);
       this.markedBodies.commit(id, transform);
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
     },
     endEdit: (id) => {
       this.loop?.resume();
@@ -977,7 +977,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
       if (object) {
         this.physicsFor(id)?.unfreeze(id);
         this.markedBodies.unfreeze(id);
-        this.store.notifyIngestEdit();
+        this.store.shell.notifyIngestEdit();
       }
       // The gesture's own ack — awaited by whoever closed it, so a caller that
       // has the ack has the byte. `undefined` when this surface has no backend
@@ -1223,7 +1223,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
   };
 
   subscribe(listener: () => void): () => void {
-    return this.store.subscribe(listener);
+    return this.store.shell.subscribe(listener);
   }
 
   dispose(): void {
@@ -1268,7 +1268,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
       this.writeProp(id, property, value);
       return;
     }
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
   }
 
   /** Write a transform to the live object + record it in the session edit map
@@ -1314,7 +1314,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
       }
     } else if (path === 'shadow.cast') object.castShadow = Boolean(value);
     else if (path === 'shadow.receive') object.receiveShadow = Boolean(value);
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
   }
 
   // ───────────────────────────────────────────── creation-site anchoring
@@ -1337,7 +1337,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
     // world constructs every object inside `node_modules`, so the creation-site
     // registry below answers "constructed outside project source" for all of
     // them — while the game's own JSX says exactly where each one is written,
-    // and `vite-plugin-ui-oid.ts` stamped that callsite onto the object. The
+    // and `@volter/editor-react`'s `serving/ui-oid-plugin.ts` stamped that callsite onto the object. The
     // stamped answer is the SAME KIND of fact as a `new` site (a source
     // file:line an edit can be written at), so it belongs in the same slot
     // rather than beside it.
@@ -1570,7 +1570,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
       properties,
     }).then((answer) => {
       this.instanceLiterals.set(key, answer);
-      this.store.notifyIngestEdit();
+      this.store.shell.notifyIngestEdit();
       return answer;
     });
     this.instanceLiteralRequests.set(key, request);
@@ -1666,7 +1666,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
     }
     this.instanceLiterals.delete(key);
     this.instanceLiteralRequests.delete(key);
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
     const destination = subject.anchor.anchored ? subject.anchor.display : 'this source site';
     return {
       changed: true,
@@ -1810,7 +1810,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
       object.receiveShadow = value.receiveShadow;
     }
     this.edits = structuredClone(state.edits);
-    this.store.notifyIngestEdit();
+    this.store.shell.notifyIngestEdit();
   }
 }
 
@@ -1855,7 +1855,7 @@ export function structuralThree(
     identity: structuralIdentity({ camera: options.camera }),
     journal: options.journal,
     persistence: createCreationSitePersistence({
-      history: store.projectHistory,
+      history: store.shell.projectHistory,
       writer: options.sourceWriter,
     }),
     loop: options.loop,
@@ -1896,7 +1896,7 @@ export function oidSourceThree(
     identity: oidIdentity(options.worldId, { camera: options.camera }),
     journal: options.journal,
     persistence: createOidSourcePersistence({
-      history: store.projectHistory,
+      history: store.shell.projectHistory,
       backend: options.backend,
     }),
     loop: options.loop,
@@ -1944,7 +1944,7 @@ export function oidThree(
     ...(options.explicitSourceCommit
       ? {
           sourceCommit: createOidTransformSourceCommitter({
-            history: store.projectHistory,
+            history: store.shell.projectHistory,
             ...(options.backend ? { backend: options.backend } : {}),
           }),
         }

package/src/three/component-verbs/extract-menu.ts

@@ -11,17 +11,18 @@
  * and lives server-side in the host's `ui-source/plan-extract-component.ts`.
  */
 
-import { getActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
-import { instanceSourceLocatorFor } from '@volter/editor-core/authoring/instance-source-menu';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { registerHierarchyMenuItems } from '@volter/editor-core/hierarchy-menu-registry';
+import { getActiveAuthoring } from '@volter/editor-sdk/kit/authoring/active-adapter';
+import { instanceSourceLocatorFor } from '@volter/editor-sdk/kit/authoring/instance-source-menu';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
+import { registerHierarchyMenuItems } from '@volter/editor-sdk/kit/hierarchy-menu-registry';
 import {
   canExtractNode,
   EXTRACT_COMPONENT_LABEL,
   type InstanceExtractSource,
 } from '../../host/instance-extract-actions';
-import { showTransientHint } from '@volter/editor-core/transient-hint';
+import { showTransientHint } from '@volter/editor-sdk/kit/transient-hint';
 import type { AuthoringAdapter } from '@volter/editor-project/adapter';
+import { threeStateOf } from '@volter/editor-threejs/kit/three-state';
 
 /** The extract surface for `nodeId`, or `null` — the host's own owner walk. */
 export function instanceExtractSourceFor(
@@ -32,7 +33,7 @@ export function instanceExtractSourceFor(
 }
 
 function extractable(store: EditorShellStore, nodeId: string): boolean {
-  const adapter = getActiveAuthoring(store);
+  const adapter = getActiveAuthoring(store.shell);
   return canExtractNode(
     adapter.hierarchy.node(nodeId),
     instanceExtractSourceFor(adapter, nodeId),
@@ -46,7 +47,7 @@ let unregister: (() => void) | null = null;
 export function ensureInstanceExtractMenuRegistered(): void {
   if (unregister) return;
   unregister = registerHierarchyMenuItems(
-    ({ nodeId, store }) => extractable(store, nodeId),
+    ({ nodeId, store }) => extractable(threeStateOf(store), nodeId),
     ({ nodeId, store }) => {
       const source = instanceExtractSourceFor(getActiveAuthoring(store), nodeId);
       return [

package/src/three/component-verbs/fork-menu.ts

@@ -17,17 +17,18 @@
  * asking the composite directly would ask the wrong object.
  */
 
-import { getActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
-import { instanceSourceLocatorFor } from '@volter/editor-core/authoring/instance-source-menu';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { registerHierarchyMenuItems } from '@volter/editor-core/hierarchy-menu-registry';
+import { getActiveAuthoring } from '@volter/editor-sdk/kit/authoring/active-adapter';
+import { instanceSourceLocatorFor } from '@volter/editor-sdk/kit/authoring/instance-source-menu';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
+import { registerHierarchyMenuItems } from '@volter/editor-sdk/kit/hierarchy-menu-registry';
 import {
   canForkInstance,
   FORK_COMPONENT_LABEL,
   type InstanceForkSource,
 } from '../../host/instance-fork-actions';
-import { showTransientHint } from '@volter/editor-core/transient-hint';
+import { showTransientHint } from '@volter/editor-sdk/kit/transient-hint';
 import type { AuthoringAdapter } from '@volter/editor-project/adapter';
+import { threeStateOf } from '@volter/editor-threejs/kit/three-state';
 
 /** The fork surface for `nodeId`, or `null` — the host's own owner walk. */
 export function instanceForkSourceFor(
@@ -38,7 +39,7 @@ export function instanceForkSourceFor(
 }
 
 function forkable(store: EditorShellStore, nodeId: string): boolean {
-  const adapter = getActiveAuthoring(store);
+  const adapter = getActiveAuthoring(store.shell);
   return canForkInstance(
     adapter.hierarchy.node(nodeId),
     instanceForkSourceFor(adapter, nodeId),
@@ -52,7 +53,7 @@ let unregister: (() => void) | null = null;
 export function ensureInstanceForkMenuRegistered(): void {
   if (unregister) return;
   unregister = registerHierarchyMenuItems(
-    ({ nodeId, store }) => forkable(store, nodeId),
+    ({ nodeId, store }) => forkable(threeStateOf(store), nodeId),
     ({ nodeId, store }) => {
       const source = instanceForkSourceFor(getActiveAuthoring(store), nodeId);
       return [

package/src/three/component-verbs/internals-menu.ts

@@ -18,15 +18,15 @@
  * probing the active adapter is already asking the right one.
  */
 
-import { getActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
+import { getActiveAuthoring } from '@volter/editor-sdk/kit/authoring/active-adapter';
 import {
   type InternalsSource,
   internalsProjection,
   isInternalsRevealed,
   revealedInternalsIds,
   toggleInternalsRevealed,
-} from '@volter/editor-core/hierarchy-internals';
-import { registerHierarchyMenuItems } from '@volter/editor-core/hierarchy-menu-registry';
+} from '@volter/editor-sdk/kit/hierarchy-internals';
+import { registerHierarchyMenuItems } from '@volter/editor-sdk/kit/hierarchy-menu-registry';
 import type { AuthoringAdapter } from '@volter/editor-project/adapter';
 
 /** Menu capitalization follows the panel's Title Case idiom (`Rename`,

package/src/three/drei-asset-caches.ts

@@ -0,0 +1,13 @@
+/**
+ * drei's parsed-asset caches (`useGLTF`, `useTexture`) outlive a mount. A lane
+ * that reloads after project asset bytes change clears the changed paths
+ * first, or the next mount is handed the old bytes.
+ */
+export async function evictDreiCaches(paths: readonly string[]): Promise<void> {
+  if (paths.length === 0) return;
+  const { useGLTF, useTexture } = await import('@react-three/drei');
+  for (const path of paths) {
+    useGLTF.clear(path);
+    useTexture.clear(path);
+  }
+}

package/src/three/story-documents/three-story-documents.tsx

@@ -25,50 +25,49 @@
  * it.
  */
 
-import { Object3DDocumentViewport } from '@volter/editor-core/components/Object3DDocumentViewport';
-import type { SourceDocumentAuthoringFactory } from '@volter/editor-core/components/StageHost';
-import { SurfaceStateOverlay } from '@volter/editor-core/components/SurfaceStateOverlay';
-import { STANDARD_COMPONENT_CAMERA_DIRECTION } from '@volter/editor-core/components/standard-viewport-dressing';
-import { registerDocumentOpener } from '@volter/editor-core/document-open-registry';
-import type { ViewportTab } from '@volter/editor-core/editor-shell-store';
-import { createHmrRegistrationGroup } from '@volter/editor-core/hmr-registration-group';
+import { Object3DDocumentViewport } from '@volter/editor-threejs/kit/components/Object3DDocumentViewport';
+import type { SourceDocumentAuthoringFactory } from '@volter/editor-threejs/kit/components/StageHost';
+import { SurfaceStateOverlay } from '@volter/editor-sdk/kit/components/SurfaceStateOverlay';
+import { STANDARD_COMPONENT_CAMERA_DIRECTION } from '@volter/editor-threejs/kit/components/standard-viewport-dressing';
+import { registerDocumentOpener } from '@volter/editor-sdk/kit/document-open-registry';
+import { createHmrRegistrationGroup } from '@volter/editor-sdk/kit/hmr-registration-group';
 import {
   CONTRIBUTED_SECTION_ORDER,
   STORY_ARGS_SECTION_ID,
   STORY_ARGS_SECTION_TITLE,
-} from '@volter/editor-core/inspection/model';
-import { registerInspectorSections } from '@volter/editor-core/inspector-section-registry';
-import type { ComposedProjectStory } from '@volter/editor-core/stories/compose-project-stories';
+} from '@volter/editor-sdk/kit/inspection-model';
+import { registerInspectorSections } from '@volter/editor-sdk/kit/inspector-section-registry';
+import type { ComposedProjectStory } from '@volter/editor-sdk/kit/stories/compose-project-stories';
 import {
   type MountedStoryViewportSource,
   mountedStoryViewportSource,
 } from '../../host/stories/mounted-story-viewport-source';
-import { getProjectStoryRegions } from '@volter/editor-core/stories/project-story-regions';
+import { getProjectStoryRegions } from '@volter/editor-sdk/kit/stories/project-story-regions';
 import { storyArgPropertyDescriptors } from '../../host/stories/story-arg-descriptors';
-import { declaredStoryMedium } from '@volter/editor-core/stories/story-declared-medium';
+import { declaredStoryMedium } from '@volter/editor-sdk/kit/stories/story-declared-medium';
 import {
   type StoryDocumentOpenRequest,
   THREE_STORY_DOCUMENT_OPENER,
-} from '@volter/editor-core/stories/story-document-openers';
+} from '@volter/editor-sdk/kit/story-document-openers';
 import {
   getProjectStoryModules,
   subscribeProjectStoryModules,
-} from '@volter/editor-core/stories/story-registry';
+} from '@volter/editor-sdk/kit/stories/story-registry';
 import {
   disposeStoryObject3D,
   mountStoryObject3D,
   type StoryPreviewComponent,
-} from '@volter/editor-core/stories/story-three-preview';
-import { mountedStoryHasThreeContent } from '@volter/editor-core/stories/three-story-model';
-import { explainSurface } from '@volter/editor-core/surface-state';
-import { sourceWriteBackendIfPrimed } from '@volter/editor-core/ui-source/tier-source-write-backend';
+} from '../../host/stories/story-three-preview';
+import { mountedStoryHasThreeContent } from '@volter/editor-threejs/kit/stories/three-story-model';
+import { explainSurface } from '@volter/editor-sdk/kit/surface-state';
+import { sourceWriteBackendIfPrimed } from '@volter/editor-sdk/kit/ui-source/tier-source-write-backend';
 import {
   activeWorkspaceDocument,
   closeWorkspaceDocument,
   openWorkspaceDocument,
   type WorkspaceDocumentContentProps,
-} from '@volter/editor-core/workspace-document-registry';
-import { registerWorkspaceDocumentRestorer } from '@volter/editor-core/workspace-document-restore';
+} from '@volter/editor-sdk/kit/workspace-document-registry';
+import { registerWorkspaceDocumentRestorer } from '@volter/editor-sdk/kit/workspace-document-restore';
 import { STORY_ARGS_SECTION_ICON } from '../../react/story-documents/story-args-section';
 import {
   prepareStoryDocumentRestore,
@@ -84,10 +83,6 @@ const THREE_STORY_ARG_PATH_PREFIX = 'threeStory.arg.';
 
 /** The narrow store surface a three-story document needs — the T6.3 input-gate
  *  hand-off, identical to `story-documents.tsx`'s `StoryDocumentStore`. */
-export interface ThreeStoryDocumentStore {
-  setActiveViewportTab(tab: ViewportTab): void;
-}
-
 interface ThreeStoryDocumentState {
   readonly modulePath: string;
   readonly storyName: string;
@@ -149,7 +144,6 @@ export function setThreeStoryArgOverride(id: string, key: string, value: unknown
  * exhibit click-through target.
  */
 export function openThreeStoryDocument(
-  store: ThreeStoryDocumentStore,
   modulePath: string,
   storyName: string,
   title = storyName,
@@ -187,7 +181,6 @@ export function openThreeStoryDocument(
       // a board-scoped rule (`board-scene.ts`) that one story cannot
       // re-derive.
       persist: ({ title: liveTitle }) => ({ modulePath, storyName, title: liveTitle }),
-      onActivate: () => store.setActiveViewportTab('edit'),
       onDispose: (documentId) => {
         if (_states.delete(documentId)) notifyChanged();
       },
@@ -217,7 +210,6 @@ export function threeStoryDocumentState(
  * story registry (`refreshProjectStories`) first — this reads it synchronously.
  */
 export function restoreThreeStoryDocument(
-  store: ThreeStoryDocumentStore,
   modulePath: string,
   storyName: string,
   title?: string,
@@ -233,7 +225,7 @@ export function restoreThreeStoryDocument(
   // which no single story can re-derive — so the tab is restored with the text
   // it had, falling back to the registry's own label for a record that
   // predates this or came from another opener.
-  openThreeStoryDocument(store, modulePath, storyName, title ?? story.label);
+  openThreeStoryDocument(modulePath, storyName, title ?? story.label);
   return true;
 }
 
@@ -242,10 +234,8 @@ export function restoreThreeStoryDocument(
 registerDocumentOpener<StoryDocumentOpenRequest>({
   id: THREE_STORY_DOCUMENT_OPENER,
   owner: 'three-story-documents',
-  open: (store, request) =>
-    openThreeStoryDocument(
-      store,
-      request.modulePath,
+  open: (_store, request) =>
+    openThreeStoryDocument(request.modulePath,
       request.storyName,
       request.title ?? request.storyName,
       request.activate === undefined ? {} : { activate: request.activate },
@@ -259,7 +249,7 @@ registerWorkspaceDocumentRestorer({
   kind: 'world',
   owner: 'three-story-documents',
   prepare: prepareStoryDocumentRestore,
-  restore: ({ state, store }) => {
+  restore: ({ state }) => {
     const record = state as
       | { modulePath?: unknown; storyName?: unknown; title?: unknown }
       | null
@@ -268,7 +258,7 @@ registerWorkspaceDocumentRestorer({
     const storyName = typeof record?.storyName === 'string' ? record.storyName : null;
     if (!modulePath || !storyName) return false;
     const title = typeof record?.title === 'string' ? record.title : undefined;
-    return restoreThreeStoryDocument(store, modulePath, storyName, title);
+    return restoreThreeStoryDocument(modulePath, storyName, title);
   },
 });