@volter/editor-game 0.5.65 → 0.5.67

package/src/host/components/header-telemetry-model.ts

@@ -1,5 +1,5 @@
-import { meterPercent } from '@volter/game-runtime/adapter/audio-meter';
-import type { PerformanceFrame } from '@volter/game-runtime/dev/performance-profiler';
+import { meterPercent } from '../../runtime/adapter/audio-meter';
+import type { PerformanceFrame } from '../../runtime/dev/performance-profiler';
 
 export const AUDIO_METER_SEGMENTS = 8;
 export const PERFORMANCE_SPARKLINE_SAMPLES = 24;

package/src/host/components/scene-document.tsx

@@ -8,43 +8,38 @@
  * `useCenterDocuments`): it binds the Game document's tab, reports the
  * live/stopped edge and closes every document on session teardown. What moved
  * here is only what the kit no longer does — synthesize the Scene document
- * the kit still routes every three root's edit document to, and mirror the
- * store's `activeViewportTab` into registry activation for the Scene/Game pair.
+ * the kit still routes every three root's edit document to.
  *
- * THE INPUT-GATE CONTRACT (CLAUDE.md T6.3): `store.activeViewportTab`
- * remains the single source of truth that `play-mode.ts`/`ingest/mount-ingest-root.ts`
- * read (`playState === 'playing' && activeViewportTab === 'play'`) — this
- * module NEVER replaces that predicate, it mirrors registry activation into
- * it (descriptor `onActivate` → `setActiveViewportTab`) and store changes
- * back into registry activation (`syncSceneDocument`, run on every store
- * notify).
- */
+ * THE INPUT-GATE CONTRACT (CLAUDE.md T6.3): `play-mode.ts` and the ingest
+ * lanes gate game input on `playState === 'playing' && activeViewportTab ===
+ * 'play'`. The tab is derived from workspace focus (the Game document is
+ * active), so this module never writes it and never mirrors it back into
+ * activation. */
 
 import {
   activeDocumentSourcePath,
   activeSaveDestination,
   activeSaveState,
-} from '@volter/editor-core/authoring/shell-document-ops';
-import { Object3DDocumentViewport } from '@volter/editor-core/components/Object3DDocumentViewport';
-import type { DocumentPreviewSource } from '@volter/editor-core/document-preview-source';
-import { editorConsole } from '@volter/editor-core/editor-console';
-import type { EditorShellStore, ViewportTab } from '@volter/editor-core/editor-shell-store';
-import { projectAdapterFacet, subscribeProjectAdapter } from '@volter/editor-core/project-adapter';
-import { getCurrentProject } from '@volter/editor-core/project-manager';
-import { isolationTabsReplaceGenericScene, sceneTabRow } from '@volter/editor-core/scene-document-plan';
+} from '@volter/editor-sdk/kit/authoring/shell-document-ops';
+import { Object3DDocumentViewport } from '@volter/editor-threejs/kit/components/Object3DDocumentViewport';
+import type { DocumentPreviewSource } from '@volter/editor-sdk/kit/document-preview-source';
+import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
+import type { EditorShellStore, ViewportTab } from '@volter/editor-threejs/kit/editor-shell-store';
+import { projectAdapterFacet, subscribeProjectAdapter } from '@volter/editor-sdk/kit/project-adapter';
+import { getCurrentProject } from '@volter/editor-sdk/kit/active-project';
+import { isolationTabsReplaceGenericScene, sceneTabRow } from '@volter/editor-sdk/kit/scene-document-plan';
 import {
   registerAvailableWorkspaceDocument,
   unregisterAvailableWorkspaceDocument,
-} from '@volter/editor-core/workspace-available-documents';
-import { GAME_DOCUMENT_ID, SCENE_DOCUMENT_ID } from '@volter/editor-core/workspace-document-ids';
+} from '@volter/editor-sdk/kit/workspace-available-documents';
+import { SCENE_DOCUMENT_ID } from '@volter/editor-sdk/kit/workspace-document-ids';
 import {
   activateWorkspaceDocument,
   activeWorkspaceDocumentId,
-  openWorkspaceDocuments,
   setWorkspaceDocumentDirty,
   type WorkspaceDocumentContentProps,
   type WorkspaceDocumentDescriptor,
-} from '@volter/editor-core/workspace-document-registry';
+} from '@volter/editor-sdk/kit/workspace-document-registry';
 import { Button, themeVars } from '@volter/editor-sdk/widgets';
 import { Component, type ErrorInfo, type ReactNode, useEffect, useState } from 'react';
 import { scheduleAfterPaint } from '../after-paint';
@@ -74,7 +69,6 @@ export interface CenterDocumentsStore {
   readonly sourcePath?: string | null;
   /** Whether the active authoring adapter has unsaved edits. */
   readonly isDirty: boolean;
-  setActiveViewportTab(tab: ViewportTab): void;
 }
 
 /** The root Scene's preview stays available after its tab closes. Its source
@@ -322,35 +316,24 @@ export function createCenterDocumentDescriptors(store: CenterDocumentsStore): {
       store.savePath
         ? { kind: 'scene', path: store.savePath }
         : { kind: 'workspace', id: SCENE_DOCUMENT_ID },
-    onActivate: () => store.setActiveViewportTab('edit'),
   };
   return { scene };
 }
 
 /**
- * The store→registry half of the bridge for the Scene/Game pair. Idempotent —
- * safe (and designed) to run on EVERY store notify; re-entrant calls triggered
- * by its own `onActivate` → `setActiveViewportTab` → notify chain settle as
- * no-ops. The Game document's live/stopped edge is the kit's
- * (`useCenterDocuments`), not repeated here.
+ * Keeps the Scene document in step with the session. Idempotent — safe (and
+ * designed) to run on EVERY store notify. The Game document's live/stopped edge
+ * is the kit's (`useCenterDocuments`), not repeated here.
  *
  *  1. the scene document is available when the manifest has a Three root;
  *  2. its tab's dirty dot tracks `isDirty` live (the title is fixed);
- *  3. the active document mirrors `activeViewportTab` (auto-switch on
- *     play/stop, `set-viewport-tab` control commands, the ingest mount lane's
- *     direct writes). A `play` tab value with no Game document open (stopped,
- *     or a transient store state) activates the scene if its tab is open.
+ *  3. with no document active at all (a first run), the scene document is.
  */
 export function syncCenterDocuments(
   store: CenterDocumentsStore,
   docs: { scene: WorkspaceDocumentDescriptor },
   hasThreeRoot = true,
 ): void {
-  const isOpen = (id: string) => openWorkspaceDocuments().some((d) => d.descriptor.id === id);
-  // Opening a registry document activates it. Capture the caller's requested
-  // viewport before touching the open set, then restore that intent below.
-  const requestedViewportTab = store.activeViewportTab;
-
   const table = projectAdapterFacet()?.scenes;
   if (hasThreeRoot && !(table && isolationTabsReplaceGenericScene(table))) {
     const row = table
@@ -377,21 +360,7 @@ export function syncCenterDocuments(
     unregisterAvailableWorkspaceDocument(SCENE_DOCUMENT_ID);
   }
 
-  // Mirror the store tab into registry activation. A THIRD-party document
-  // being active is a legitimate state (its own onActivate already asserted
-  // the store's tab, so the T6.3 gate is off). The mirror therefore only
-  // corrects genuine disagreements about the SCENE/GAME pair:
-  //   - tab says 'play' (play auto-switch, `set-viewport-tab play`) → the
-  //     Game document must be active;
-  //   - tab says 'edit' while the GAME document is active (external
-  //     `set-viewport-tab edit` during play) → back to the scene document;
-  //   - no active document at all (first run) → the scene document.
-  // An 'edit' tab with an asset/story document active is CONSISTENT and must
-  // not be "corrected".
-  const activeId = activeWorkspaceDocumentId();
-  if (requestedViewportTab === 'play' && isOpen(GAME_DOCUMENT_ID)) {
-    if (activeId !== GAME_DOCUMENT_ID) activateWorkspaceDocument(GAME_DOCUMENT_ID);
-  } else if (hasThreeRoot && (activeId === GAME_DOCUMENT_ID || activeId === null)) {
+  if (hasThreeRoot && activeWorkspaceDocumentId() === null) {
     activateWorkspaceDocument(SCENE_DOCUMENT_ID);
   }
 }
@@ -409,25 +378,24 @@ export function bindSceneDocument(store: EditorShellStore): () => void {
   // tab still represents the same authored TSX document.
   let lastSourcePath: string | null = null;
   const view: CenterDocumentsStore = {
-    subscribe: (listener) => store.subscribe(listener),
+    subscribe: (listener) => store.shell.subscribe(listener),
     get playState() {
-      return store.playState;
+      return store.shell.playState;
     },
     get activeViewportTab() {
-      return store.activeViewportTab;
+      return store.shell.activeViewportTab;
     },
     get savePath() {
-      return activeSaveDestination(store);
+      return activeSaveDestination(store.shell);
     },
     get sourcePath() {
-      const current = activeDocumentSourcePath(store);
+      const current = activeDocumentSourcePath(store.shell);
       if (current) lastSourcePath = current;
       return lastSourcePath;
     },
     get isDirty() {
-      return activeSaveState(store) === 'unsaved';
+      return activeSaveState(store.shell) === 'unsaved';
     },
-    setActiveViewportTab: (tab) => store.setActiveViewportTab(tab),
   };
   const docs = createCenterDocumentDescriptors(view);
   // Missing is the legacy-safe default: manifests read by current editor
@@ -435,7 +403,7 @@ export function bindSceneDocument(store: EditorShellStore): () => void {
   const run = () =>
     syncCenterDocuments(view, docs, getCurrentProject()?.config.hasThreeRoot !== false);
   run();
-  const unsubscribe = store.subscribe(run);
+  const unsubscribe = store.shell.subscribe(run);
   const unsubscribeAdapter = subscribeProjectAdapter(run);
   // Unbinding follows the session's store and leaves the document registered:
   // a store arriving again at boot must not close a restored Scene tab. The

package/src/host/components/utility-view-state.ts

@@ -16,7 +16,7 @@
  * button both select a view of a bench that now ships in `@volter/editor-game`.
  */
 
-import { showWorkspaceUtility } from '@volter/editor-core/workspace-host-commands';
+import { showWorkspaceUtility } from '@volter/editor-sdk/kit/workspace-host-commands';
 
 export type ProfilerViewId = 'profiler' | 'frame';
 

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

@@ -1,39 +1,38 @@
 /**
  * THE GAME'S WORLD-ROOT BINDING for the kit's stage host
- * (`@volter/editor-core/components/world-root-binding`): the world's surface,
+ * (`@volter/editor-threejs/kit/components/world-root-binding`): the world's surface,
  * its stage, and the overlays the stage shows only over a world.
  *
  * `Overlays` is the world-root half of vgai's `stage-overlay-set.tsx` — every
  * part it rendered only when `worldRoot` held (the root selection layer, the
- * camera-authoring pin, the controls hint while the world mounts, the scene's
+ * camera-authoring pin, the scene's
  * surface-state card). The rest of that overlay set is the kit's
  * `StageOverlays`, which the host renders beside this.
  */
 import { EDITOR_LAYER } from '@volter/editor-threejs/viewport/editor-layers';
-import { activeAuthoringVersion, subscribeActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
+import { activeAuthoringVersion, subscribeActiveAuthoring } from '@volter/editor-sdk/kit/authoring/active-adapter';
 import {
   getMountFailureReports,
   subscribeToMountFailures,
-} from '@volter/editor-core/authoring/mount-failure-report';
+} from '@volter/editor-sdk/kit/mount-failure-report';
 import {
   object3DDocumentSessionsVersion,
   subscribeObject3DDocumentSessions,
-} from '@volter/editor-core/authoring/object3d-document-session-registry';
-import { RootSelectionOverlay } from '@volter/editor-core/components/RootSelectionOverlay';
-import { SurfaceStateOverlay } from '@volter/editor-core/components/SurfaceStateOverlay';
-import { ViewportControlsHint } from '@volter/editor-core/components/ViewportControlsHint';
+} from '@volter/editor-threejs/kit/authoring/object3d-document-session-registry';
+import { RootSelectionOverlay } from '@volter/editor-sdk/kit/components/RootSelectionOverlay';
+import { SurfaceStateOverlay } from '@volter/editor-sdk/kit/components/SurfaceStateOverlay';
 import type {
   WorldRootOverlayProps,
   WorldRootStageBinding,
-} from '@volter/editor-core/components/world-root-binding';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { readinessFacet, subscribeRootReadiness } from '@volter/editor-core/readiness';
-import { documentStageContext, threeSelectionToolsApply } from '@volter/editor-core/stage-context';
-import { explainSurface } from '@volter/editor-core/surface-state';
+} from '@volter/editor-threejs/kit/components/world-root-binding';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
+import { readinessFacet, subscribeRootReadiness } from '@volter/editor-sdk/kit/readiness';
+import { documentStageContext } from '@volter/editor-sdk/kit/stage-context';
+import { explainSurface } from '@volter/editor-sdk/kit/surface-state';
 import {
   subscribeWorkspaceDocuments,
   workspaceDocumentRegistryVersion,
-} from '@volter/editor-core/workspace-document-registry';
+} from '@volter/editor-sdk/kit/workspace-document-registry';
 import { useMemo, useSyncExternalStore } from 'react';
 import type * as THREE from 'three';
 import { threeSceneHasRenderableContent } from '../surface-content';
@@ -55,7 +54,7 @@ function SceneViewportStateOverlay({
   rootIds: readonly string[];
   mountStatus: 'mounting' | 'ready';
 }) {
-  useSyncExternalStore(store.subscribe, store.getSnapshot);
+  useSyncExternalStore(store.shell.subscribe, store.shell.getSnapshot);
   const rootReadiness = useSyncExternalStore(subscribeRootReadiness, readinessFacet);
   const mountFailures = useSyncExternalStore(subscribeToMountFailures, getMountFailureReports);
   const sceneBackground = store.scene?.background as THREE.Color | null | undefined;
@@ -71,7 +70,7 @@ function SceneViewportStateOverlay({
             ignoredLayer: EDITOR_LAYER,
           }),
       ),
-    [store.scene, store.contentVersion],
+    [store.scene, store.shell.contentVersion],
   );
   const sceneHasContent = Boolean(
     store.scene && (sceneBackgroundIsAuthored || sceneHasRenderableObjects),
@@ -94,14 +93,13 @@ function WorldRootOverlays({
   mountStatus,
   rootIds,
 }: WorldRootOverlayProps) {
-  useSyncExternalStore(store.subscribe, store.getShellSnapshot ?? store.getSnapshot);
+  useSyncExternalStore(store.shell.subscribe, store.shell.getShellSnapshot ?? store.shell.getSnapshot);
   useSyncExternalStore(subscribeActiveAuthoring, activeAuthoringVersion);
   useSyncExternalStore(subscribeObject3DDocumentSessions, object3DDocumentSessionsVersion);
   useSyncExternalStore(subscribeWorkspaceDocuments, workspaceDocumentRegistryVersion);
   // The world root's stage is the Scene document's: the kit's overlay props
   // carry no document id, and the Scene document is the one world-root stage.
-  const ctx = documentStageContext(store, documentId, 'document');
-  const showsSelectionTools = threeSelectionToolsApply(ctx);
+  const ctx = documentStageContext(store.shell, documentId, 'document');
   return (
     <>
       {/* Three-scene selection overlay. React/Pixi documents mount their own
@@ -114,13 +112,6 @@ function WorldRootOverlays({
           (`world-root-stage.ts`), so the pin belongs to the stage that
           installed it. */}
       {ctx.surface === 'three' ? <CameraAuthoringOverlay previewRef={cameraPreviewRef} /> : null}
-      {/* The hint also shows WHILE the world is still mounting: a new user
-          reads the screen during those boot seconds and looks for the camera
-          controls exactly then. The kit's overlay set shows it on a three
-          surface; this adds only the mounting case it does not cover. */}
-      {!showsSelectionTools && ctx.surface !== 'three' && mountStatus === 'mounting' ? (
-        <ViewportControlsHint />
-      ) : null}
       <SceneViewportStateOverlay store={store} rootIds={rootIds} mountStatus={mountStatus} />
     </>
   );