@volter/editor-game 0.5.66 → 0.5.68

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

@@ -20,18 +20,18 @@ import {
   activeDocumentSourcePath,
   activeSaveDestination,
   activeSaveState,
-} from '@volter/editor-core/authoring/shell-document-ops';
-import { Object3DDocumentViewport } from '@volter/editor-core/components/Object3DDocumentViewport';
+} 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-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';
+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';
+} from '@volter/editor-sdk/kit/workspace-available-documents';
 import { SCENE_DOCUMENT_ID } from '@volter/editor-sdk/kit/workspace-document-ids';
 import {
   activateWorkspaceDocument,
@@ -378,23 +378,23 @@ 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';
     },
   };
   const docs = createCenterDocumentDescriptors(view);
@@ -403,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,6 +1,6 @@
 /**
  * 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
@@ -10,7 +10,7 @@
  * `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,
@@ -18,16 +18,16 @@ import {
 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';
+} 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';
+} 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-core/stage-context';
+import { documentStageContext } from '@volter/editor-sdk/kit/stage-context';
 import { explainSurface } from '@volter/editor-sdk/kit/surface-state';
 import {
   subscribeWorkspaceDocuments,
@@ -54,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;
@@ -70,7 +70,7 @@ function SceneViewportStateOverlay({
             ignoredLayer: EDITOR_LAYER,
           }),
       ),
-    [store.scene, store.contentVersion],
+    [store.scene, store.shell.contentVersion],
   );
   const sceneHasContent = Boolean(
     store.scene && (sceneBackgroundIsAuthored || sceneHasRenderableObjects),
@@ -93,13 +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 ctx = documentStageContext(store.shell, documentId, 'document');
   return (
     <>
       {/* Three-scene selection overlay. React/Pixi documents mount their own

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

@@ -26,10 +26,9 @@ import {
   registerStudioPreset,
   type StudioPreset,
 } from '@volter/editor-sdk/kit/viewport-presentation';
-import type { ViewportPresentation, ViewportRoot } from '@volter/editor-sdk/host';
 import { themeVars } from '@volter/editor-sdk/widgets';
-import { createPerformanceProfiler } from '@volter/game-runtime/dev/performance-profiler';
-import { createWebGLGpuTimer } from '@volter/game-runtime/dev/webgl-gpu-timer';
+import { createPerformanceProfiler } from '../../runtime/dev/performance-profiler';
+import { createWebGLGpuTimer } from '../../runtime/dev/webgl-gpu-timer';
 import type { AuthoringAdapter, Transform } from '@volter/editor-project/adapter';
 import { markHostRenderer } from '@volter/editor-threejs/viewport/renderer-ownership';
 import { applyWorldRendererConfig } from '@volter/threejs-runtime/adapter/renderer-config';
@@ -51,62 +50,75 @@ import {
   type Pass,
 } from 'postprocessing';
 import * as THREE from 'three';
-import { getActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
-import type { CompositeAuthoringAdapter } from '@volter/editor-core/authoring/composite-authoring-adapter';
+import { getActiveAuthoring } from '@volter/editor-sdk/kit/authoring/active-adapter';
+import type { CompositeAuthoringAdapter } from '@volter/editor-sdk/kit/authoring/composite-authoring-adapter';
 import {
   applyAuthoringTransform,
   beginAuthoringTransformEdit,
   endAuthoringTransformEdit,
-} from '@volter/editor-core/authoring/consumer-actions';
-import { designTimeMountFor } from '@volter/editor-core/authoring/design-time-mount-registry';
-import { attachProjectAuthoringStage } from '@volter/editor-core/authoring/project-authoring-session';
+} from '@volter/editor-sdk/kit/authoring/consumer-actions';
+import { designTimeMountFor } from '@volter/editor-sdk/kit/authoring/design-time-mount-registry';
+import { attachProjectAuthoringStage } from '@volter/editor-sdk/kit/authoring/project-authoring-session';
 import {
   isThreejsSurfaceVisible,
   resolveThreeViewportRootId,
-} from '@volter/editor-core/authoring/world-hidden-viewport';
+} from '@volter/editor-threejs/kit/authoring/world-hidden-viewport';
 import { AutoFrameWindow } from '../auto-frame-window';
 import {
   type CameraAuthoringSubject,
   type CameraViewMode,
   cameraAuthoringPresentation,
   installCameraAuthoringHost,
-} from '@volter/editor-core/camera-authoring';
-import { registerPresentedCanvasFrame } from '@volter/editor-core/canvas-preview-frames';
-import { collectState } from '@volter/editor-core/command-listener';
-import { getDownloadedAssetPath, getOnlineAssetFiles, reportEditorState } from '@volter/editor-core/editor-api';
+} from '@volter/editor-threejs/kit/camera-authoring';
+import { registerPresentedCanvasFrame } from '../canvas-preview-frames';
+import { collectState } from '@volter/editor-sdk/kit/command-listener';
+import { getDownloadedAssetPath, getOnlineAssetFiles, reportEditorState } from '@volter/editor-sdk/kit/editor-api';
 import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import { isEditorPresentationActive } from '@volter/editor-sdk/kit/editor-presentation-activity';
-import type { EditorStats } from '@volter/editor-core/editor-runtime';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { EditorViewport, type OnlineAssetDrop } from '@volter/editor-core/editor-viewport';
-import { entityObject3D } from '@volter/editor-core/entity-object';
+import type { EditorStats } from '@volter/editor-sdk/kit/editor-runtime';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
+import { EditorViewport, type OnlineAssetDrop } from '@volter/editor-threejs/kit/editor-viewport';
+import { entityObject3D } from '@volter/editor-threejs/kit/entity-object';
 import {
   nativeSelectionColors,
   nativeViewportLook,
   subscribeNativeSelectionTheme,
 } from '@volter/editor-sdk/kit/native-selection-style';
-import { registerPerformanceSource } from '@volter/editor-core/performance-sources';
+import { registerPerformanceSource } from '@volter/editor-sdk/kit/performance-sources';
 import { drawSceneUnlessRefused } from '../scene-view-drawability';
-import { withSceneFogNeutralized } from '@volter/editor-core/scene-view-fog';
+import { withSceneFogNeutralized } from '@volter/editor-threejs/kit/scene-view-fog';
 import { connectServerLogs } from '../server-log-bridge';
-import { focusedStageStore } from '@volter/editor-core/stage-context';
+import { focusedStageStore } from '@volter/editor-sdk/kit/stage-context';
 import {
   acquireThreeSelectionOutline,
   releaseThreeSelectionOutline,
   setThreeSelectionOutlineColors,
   syncThreeSelectionOutline,
-} from '@volter/editor-core/three-viewport/selection-outline';
+} from '@volter/editor-threejs/kit/three-viewport/selection-outline';
 import {
   setThreeViewportProjection,
   subscribeThreeViewportPresentation,
   threeViewportPresentation,
-} from '@volter/editor-core/three-viewport-presentation';
+} from '@volter/editor-sdk/kit/three-viewport-presentation';
 import { recordViewportFirstFrame } from '@volter/editor-sdk/kit/viewport-activation-timings';
 import { savedViewportPose, saveViewportPose } from '../viewport-pose-memory';
 import { presentThreeRoots } from '../viewport-root-presentation';
-import { isEditorViewportShadingTarget } from '@volter/editor-core/viewport-shading-boundary';
-import { downloadOnlineAssetWithHistory } from '@volter/editor-core/components/asset-editor-persistence';
-import { bindStagePresenceMarkers } from '@volter/editor-core/components/stage-presence-markers';
+import { isEditorViewportShadingTarget } from '@volter/editor-threejs/kit/viewport-shading-boundary';
+import { downloadOnlineAssetWithHistory } from '@volter/editor-sdk/kit/components/asset-editor-persistence';
+import { bindStagePresenceMarkers } from '@volter/editor-threejs/kit/components/stage-presence-markers';
+import type { ViewportPresentation, ViewportRoot } from '@volter/editor-threejs/viewport-api';
+
+/** Everything the world root's stage hands its medium's design session: the stage's own three
+ *  handles. The stage and the medium that registered for `three` agree on it; the kit's mount
+ *  registry types it `unknown`. */
+export interface WorldRootSessionContext {
+  /** The shell store the session's adapter is built over. */
+  readonly store: EditorShellStore;
+  /** The edit-mode composite the session swaps its own child adapter into. */
+  readonly composite: CompositeAuthoringAdapter;
+  /** The stage's renderer — the session adopts it rather than building one. */
+  readonly renderer: THREE.WebGLRenderer;
+}
 
 /**
  * THE WORLD STAGE'S STARTING PRESENTATION. Its studio is the light the world has always been
@@ -468,8 +480,8 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
   );
   const syncSelectionOutline = (): void => {
     if (!selectionOutline) return;
-    const adapter = getActiveAuthoring(store);
-    const roots = [...store.selectedEntityIds]
+    const adapter = getActiveAuthoring(store.shell);
+    const roots = [...store.shell.selectedEntityIds]
       // Edit↔Play swaps the active child before its native graph is rebuilt.
       // Do not route a stale outgoing id through the composite during that
       // handoff: it is temporarily absent, not an ownership error.
@@ -495,7 +507,7 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
     // postprocessing). `editor-viewport.ts` bumps `composerVersion` (via
     // `store.reapplyEnvironment()`) on the world hide/show edges, which is
     // what re-runs this rebuild.
-    const hiddenRootId = resolveThreeViewportRootId(store);
+    const hiddenRootId = resolveThreeViewportRootId(store.shell);
     void hiddenRootId;
     // Unwind the previous adoption's config BEFORE re-deriving, so the
     // re-derive below and the (possibly absent) re-apply at the end both
@@ -568,24 +580,24 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
   applyViewportPresentation();
 
   const resolveCameraSubject = (id: string): CameraAuthoringSubject | null =>
-    cameraSubjectFor(getActiveAuthoring(store), store.objectMap, id);
+    cameraSubjectFor(getActiveAuthoring(store.shell), store.objectMap, id);
 
   let pilotGestureId: string | null = null;
   const finishPilotGesture = (): void => {
     if (!pilotGestureId) return;
-    endAuthoringTransformEdit(getActiveAuthoring(store), pilotGestureId);
+    endAuthoringTransformEdit(getActiveAuthoring(store.shell), pilotGestureId);
     pilotGestureId = null;
   };
   const beginPilotGesture = (): void => {
     const view = cameraAuthoringPresentation().view;
     if (view?.mode !== 'pilot' || !view.subject.canAuthorPose) return;
     pilotGestureId = view.subject.id;
-    beginAuthoringTransformEdit(getActiveAuthoring(store), pilotGestureId);
+    beginAuthoringTransformEdit(getActiveAuthoring(store.shell), pilotGestureId);
   };
   const applyPilotGesture = (): void => {
     if (!pilotGestureId || viewport.cameraViewMode !== 'pilot') return;
     const subject = resolveCameraSubject(pilotGestureId);
-    const adapter = getActiveAuthoring(store);
+    const adapter = getActiveAuthoring(store.shell);
     const transforms = adapter.transforms;
     if (!subject || !transforms) return;
     // `transforms.get` REFUSES BY THROWING for a node with no transform truth
@@ -610,16 +622,16 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
       rotation: subject.camera.quaternion.toArray() as [number, number, number, number],
       scale: previous.scale,
     });
-    store.notifyIngestEdit();
+    store.shell.notifyIngestEdit();
   };
   viewport.orbitControls.addEventListener('start', beginPilotGesture);
   viewport.orbitControls.addEventListener('change', applyPilotGesture);
   viewport.orbitControls.addEventListener('end', finishPilotGesture);
 
   const disposeCameraAuthoring = installCameraAuthoringHost({
-    active: () => store.playState === 'stopped' && store.activeViewportTab === 'edit',
+    active: () => store.shell.playState === 'stopped' && store.shell.activeViewportTab === 'edit',
     selected: () => {
-      const id = store.selectedEntityId;
+      const id = store.shell.selectedEntityId;
       return id ? resolveCameraSubject(id) : null;
     },
     resolve: resolveCameraSubject,
@@ -636,7 +648,7 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
       presence.reportCamera();
     },
     alignToViewport: (subject: CameraAuthoringSubject) => {
-      const adapter = getActiveAuthoring(store);
+      const adapter = getActiveAuthoring(store.shell);
       const transforms = adapter.transforms;
       if (!transforms || !subject.canAuthorPose) return;
       const targetObject = store.objectMap.get(subject.id) ?? null;
@@ -671,10 +683,10 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
         rotation: localQuaternion.toArray() as [number, number, number, number],
         scale: previous.scale,
       });
-      store.notifyIngestEdit();
+      store.shell.notifyIngestEdit();
       endAuthoringTransformEdit(adapter, subject.id);
     },
-    subscribe: store.subscribe,
+    subscribe: store.shell.subscribe,
   });
 
   // --- Store subscription → sync viewport ---
@@ -694,7 +706,7 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
   // React never owns it.
   let lastThreejsSurface: boolean | null = null;
   const syncSurfaceVisibility = (): void => {
-    const visible = isThreejsSurfaceVisible(store);
+    const visible = isThreejsSurfaceVisible(store.shell);
     if (visible === lastThreejsSurface) return;
     lastThreejsSurface = visible;
     canvas.style.opacity = visible ? '1' : '0';
@@ -715,7 +727,7 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
   syncSurfaceVisibility();
 
   let lastComposerVersion = store.composerVersion;
-  const unsubStore = store.subscribe(() => {
+  const unsubStore = store.shell.subscribe(() => {
     syncSurfaceVisibility();
     // Swap viewport scene if the store's scene changed (play mode enter/exit)
     const storeScene = store.scene;
@@ -755,14 +767,14 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
   viewport.orbitControls.addEventListener('end', rememberPose);
 
   // --- Viewport action subscription ---
-  const unsubActions = store.onViewportAction((action) => {
+  const unsubActions = store.shell.onViewportAction((action) => {
     switch (action.type) {
       // Resolved through the ACTIVE ADAPTER first, same as selection and the
       // gizmo — an adopted play scene's nodes live in the adapter's walk and
       // never reach `objectMap`, so a store-only lookup silently framed
       // nothing for every entity in a running game (`entity-object.ts`).
       case 'focus-entity': {
-        const obj = entityObject3D(getActiveAuthoring(store), store.objectMap, action.id);
+        const obj = entityObject3D(getActiveAuthoring(store.shell), store.objectMap, action.id);
         if (obj) viewport.focusOn(obj);
         break;
       }
@@ -786,13 +798,13 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
             break;
           }
         }
-        gameCameraLookup = action.gameCamera ?? null;
+        gameCameraLookup = store.sceneCameraLookup;
         autoFrame.begin(performance.now(), gameCameraLookup !== null);
         break;
       }
       case 'focus-selection': {
-        const adapter = getActiveAuthoring(store);
-        const objects = [...store.selectedEntityIds]
+        const adapter = getActiveAuthoring(store.shell);
+        const objects = [...store.shell.selectedEntityIds]
           .map((id) => entityObject3D(adapter, store.objectMap, id))
           .filter((o): o is THREE.Object3D => o !== null);
         viewport.focusOnMultiple(objects);
@@ -804,6 +816,15 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
       case 'set-view-preset':
         viewport.setViewPreset(action.preset);
         break;
+      case 'step-view':
+        viewport.stepView(action.step);
+        break;
+      case 'frame-all':
+        viewport.focusOnScene();
+        break;
+      case 'zoom-view':
+        viewport.zoomStep(action.direction);
+        break;
       case 'set-camera-pose':
         viewport.setPose(action.position, action.target, action.fov);
         break;
@@ -899,7 +920,7 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
 
   /** Whether this stage is the one the shared panels are following, and so the
    *  one that fills the shell's frame/camera readout — see its use below. */
-  const ownsShellReadout = (): boolean => focusedStageStore(store) === store;
+  const ownsShellReadout = (): boolean => focusedStageStore(store.shell) === store.shell;
 
   function frame(now: number, resumed: boolean): void {
     if (disposed) return;
@@ -1024,7 +1045,7 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
     const stageMount = designTimeMountFor('three');
     if (disposed || editModeComposite !== composite) return;
     const disposeSession = stageMount
-      ? await stageMount.mountWorldRootSession({ store, composite, renderer })
+      ? await stageMount.mountWorldRootSession({ store, composite, renderer } satisfies WorldRootSessionContext)
       : () => {};
     if (disposed || editModeComposite !== composite) {
       disposeSession();
@@ -1034,9 +1055,9 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
     if (!disposed) options.onMountStatus('ready');
   }
 
-  const authoringStage = attachProjectAuthoringStage(store, installStage);
+  const authoringStage = attachProjectAuthoringStage(store.shell, installStage);
   authoringStage.ready
-    .then(() => reportEditorState(collectState(store)))
+    .then(() => reportEditorState(collectState(store.shell)))
     .catch((err) => {
       editorConsole.error(
         `Editor boot failed: ${err instanceof Error ? err.message : String(err)}`,

package/src/host/coverage/system-adapter-coverage.ts

@@ -46,7 +46,7 @@
  * no live session.
  */
 
-import type { DeclaredSystemAbsence } from '@volter/game-runtime/runtime/game';
+import type { DeclaredSystemAbsence } from '../../runtime/game';
 import type { SystemAdapters } from '@volter/editor-project/adapter/system-adapter';
 import {
   SYSTEM_ADAPTER_SLOTS,
@@ -139,9 +139,8 @@ function shippedLibraries(slot: SystemAdapterSlot, facts: NativeProjectFacts): r
 function contradictionFix(slot: SystemAdapterSlot, libraries: readonly string[]): string {
   return (
     `this project depends on ${libraries.join(' + ')}, so "nothing built a ${slot} world" is not ` +
-    `a settled answer. Reach a terminal state either way: BIND it — declare a ${slot} adapter in ` +
-    `the root entry's \`systems\` table (the engine ships \`rapierPhysicsSystem()\` for the R3F ` +
-    `Rapier bridge; other slots take the game's own adapter) — or DECLARE the absence with ` +
+    `a settled answer. Reach a terminal state either way: BIND it — declare the game's own ${slot} ` +
+    `adapter in the root entry's \`systems\` table — or DECLARE the absence with ` +
     `\`absent(reason)\` in that same table. The reason must NAME the dependency and say why it ` +
     `is there while the subsystem is not (a transitive pull, a leftover, a build-only use); a ` +
     `declared absence blind to the shipped dependency grades malformed, not terminal.`

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

@@ -1,16 +1,17 @@
 import { type ReactNode, useEffect, useLayoutEffect, useState } from 'react';
-import { resetProjectThumbnailManifestCache } from '@volter/editor-core/asset-workflow/thumbnail-system';
-import { type EditorRuntime, EditorRuntimeProvider, type EditorStats } from '@volter/editor-core/editor-runtime';
-import { EditorShellStore } from '@volter/editor-core/editor-shell-store';
-import { EditorSession } from '@volter/editor-core/history/editor-session';
-import { getStorageBackend, MemStorage, setStorageBackend } from '@volter/editor-core/storage/index';
+import { resetProjectThumbnailManifestCache } from '@volter/editor-sdk/kit/asset-workflow/thumbnail-system';
+import { type EditorRuntime, EditorRuntimeProvider, type EditorStats } from '@volter/editor-sdk/kit/editor-runtime';
+import { type EditorShellStore, threeStateOf } from '@volter/editor-threejs/kit/editor-shell-store';
+import { ShellStore } from '@volter/editor-sdk/kit/shell-store';
+import { EditorSession } from '@volter/editor-sdk/kit/history/editor-session';
+import { getStorageBackend, MemStorage, setStorageBackend } from '@volter/editor-sdk/kit/storage/index';
 import {
   activeWorkspaceUtility,
   installWorkspaceHostCommands,
   setActiveWorkspaceUtility,
   setWorkspaceUtilityTabs,
   workspaceUtilityTabs,
-} from '@volter/editor-core/workspace-host-commands';
+} from '@volter/editor-sdk/kit/workspace-host-commands';
 import { availableWorkspaceUtilities } from '@volter/editor-sdk/kit/workspace-utility-registry';
 
 const ZERO_STATS: EditorStats = {
@@ -24,15 +25,12 @@ const ZERO_STATS: EditorStats = {
 
 /** A story runtime's Three half, for a production component that reads the scene. */
 export function storyThreeStore(runtime: EditorRuntime): EditorShellStore {
-  if (!(runtime.store instanceof EditorShellStore)) {
-    throw new Error('This runtime was not made by createStoryEditorRuntime: it has no Three store.');
-  }
-  return runtime.store;
+  return threeStateOf(runtime.store);
 }
 
 /** A real, bounded editor runtime for production component stories. */
 export function createStoryEditorRuntime(): EditorRuntime {
-  const store = new EditorShellStore();
+  const store = new ShellStore();
   const session = new EditorSession('storybook-fixture');
   store.attachHistory(session.history);
   return {

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

@@ -3,7 +3,7 @@ import { isEditorOwnedObject } from '@volter/editor-threejs/viewport/editor-laye
 import { markHostRenderer } from '@volter/editor-threejs/viewport/renderer-ownership';
 import * as THREE from 'three';
 import type { DocumentPreviewCaptureRequest } from '@volter/editor-sdk/kit/document-preview-source';
-import { frameableContentBounds } from '@volter/editor-core/scene-framing';
+import { frameableContentBounds } from '@volter/editor-threejs/kit/scene-framing';
 
 function authoredCameras(root: THREE.Object3D): THREE.Camera[] {
   const cameras: THREE.Camera[] = [];

package/src/host/entry-adjudication.ts

@@ -1,9 +1,9 @@
 /**
  * WHAT DOES THIS ENTRY MODULE MEAN? — the ONE editor-side answer.
  *
- * The engine owns the answer itself (`resolveR3FEntryAdapter`, and the
- * packaged-aware `resolveR3FEntryAdapterForEditor` delegate that routes it
- * through the project's own module graph). The editor's job is to ASK, once.
+ * `roots/r3f-root.tsx` owns the answer itself (`resolveR3FEntryAdapter`), and
+ * `resolveR3FEntryAdapterForEditor` hands it the React and Fiber of the
+ * project's own module graph. The rest of the editor's job is to ASK, once.
  * Before this module there were three askers, and they had already drifted:
  *
  *  - the dev-server lane called the packaged-aware `…ForEditor`;
@@ -20,9 +20,9 @@
  * told which lane and which file, and that is the caller's knowledge, not
  * this function's.
  *
- * `entry-adjudication-single-owner.test.ts` is the tripwire; the canvas lane
- * has its own single owner in the engine (`resolveCanvasEntryAdapter`, reached
- * through `canvas-entry-runtime.ts`) and is not adjudicated here.
+ * The canvas lane has its own single owner (`roots/canvas-root.tsx`'s
+ * `resolveCanvasEntryAdapter`, reached through `canvas-entry-runtime.ts`) and
+ * is not adjudicated here.
  */
 
 import type { RootAdapter } from '@volter/editor-project/adapter';

package/src/host/game-css-scope-transform.ts

@@ -0,0 +1,4 @@
+/** The `@scope` transform the session applies to a game's stylesheets, for a
+ *  page that must scope CSS a game creates at runtime. Its own module so the
+ *  transform's parser loads only where a game's page asks for it. */
+export { scopeGameCss } from '@volter/editor-sdk/session/scoped-game-css';

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

@@ -90,7 +90,7 @@ export const SCOPED_STYLE_MARK = 'vgaiScopedCss';
 let gameCssScoper: Promise<(css: string) => string> | null = null;
 export function loadGameCssScoper(): Promise<(css: string) => string> {
   gameCssScoper ??= Promise.all([
-    import('@volter/editor-core/game-css-scope-transform'),
+    import('./game-css-scope-transform'),
     import('@volter/editor-sdk/session/game-css-scope'),
   ]).then(
     ([{ scopeGameCss }, { GAME_CSS_SCOPE_SELECTOR }]) =>

package/src/host/gameplay-export.ts

@@ -1,4 +1,3 @@
-import { pcmStats } from '@volter/game-runtime/audio/wav-encode';
 import type { OfflineAudioRenderer } from '@volter/editor-project/adapter';
 import {
   AudioBufferSource,
@@ -10,8 +9,25 @@ import {
   Quality,
   WebMOutputFormat,
 } from 'mediabunny';
-import type { CaptureOptions } from '@volter/editor-core/composite-screenshot';
-import { createImageSnapshotCache, drawPlayCompositeFrame } from '@volter/editor-core/composite-screenshot';
+import type { CaptureOptions } from '@volter/editor-sdk/kit/composite-screenshot';
+import { createImageSnapshotCache, drawPlayCompositeFrame } from '@volter/editor-sdk/kit/composite-screenshot';
+
+/** RMS and peak over all channels and samples: evidence the track is sound, not an all-zero
+ *  buffer. */
+function pcmStats(channelData: readonly Float32Array[]): { rms: number; peak: number } {
+  let sumSquares = 0;
+  let peak = 0;
+  let count = 0;
+  for (const data of channelData) {
+    for (let i = 0; i < data.length; i++) {
+      const v = data[i] ?? 0;
+      sumSquares += v * v;
+      peak = Math.max(peak, Math.abs(v));
+      count++;
+    }
+  }
+  return { rms: count > 0 ? Math.sqrt(sumSquares / count) : 0, peak };
+}
 
 /**
  * Opus in the SAME WebM `Output` the video track already uses — the whole
@@ -25,14 +41,10 @@ import { createImageSnapshotCache, drawPlayCompositeFrame } from '@volter/editor
  * second container pipeline beside the first is how one export's timing,
  * metadata and codec support drift away from the other's.
  *
- * Consequently `audio/wav-encode.ts` is NOT used to make the track.
- * `encodeWav16` exists for the one place that genuinely needs a file on a
- * wire — `runtime/render-audio-control.ts` base64s a complete WAV across
- * `page.evaluate` to a Node capture driver. Here the `AudioBuffer` and the
- * muxer are in the same JS heap, so encoding to 16-bit WAV and handing the
- * bytes back to an encoder would quantize the samples for no reason at all.
- * `pcmStats` from that module IS used, for the non-silence evidence in the
- * result.
+ * The `AudioBuffer` and the muxer are in the same JS heap, so the samples go
+ * to the encoder as they are; encoding to 16-bit WAV on the way would quantize
+ * them for no reason at all. {@link pcmStats} gives the non-silence evidence in
+ * the result.
  *
  * Opus rather than a PCM track (Matroska can carry `A_PCM/INT/LIT`) because
  * WebM's normal audio codec is what every player and every `ffprobe` build
@@ -105,9 +117,8 @@ export interface GameplayExportResult {
 /** How the export gets sound: the world's own audio for the ABSOLUTE sim
  *  window the frame walk covers, rendered offline.
  *
- *  THE OFFSET TRAP, restated at the call site because it is the correctness
- *  argument of this whole path (`runtime/render-audio-control.ts` states it
- *  first): an offline render of `[10, 10.72)` schedules its first event at
+ *  THE OFFSET TRAP, stated at the call site because it is the correctness
+ *  argument of this whole path: an offline render of `[10, 10.72)` schedules its first event at
  *  LOCAL time 0, not absolute 10. `startSeconds` is where the paused run
  *  stands on its own canonical clock when frame 0 is captured; `render` is
  *  asked for `[startSeconds, startSeconds + frames / fps)` and must subtract