@volter/editor-game 0.5.66 → 0.5.67

package/contributions/audio-unlock.service.ts

@@ -7,11 +7,11 @@
  * neither matters to a project that plays nothing.
  */
 import { installAudioPoseGuard } from '../src/services/audio-pose-guard';
-import { installGameAudioUnlock } from '../src/services/game-audio-unlock';
+import { installGameAudio } from '../src/services/game-audio';
 
 export const point = 'workspace.service';
 
 export function start(): void {
-  installGameAudioUnlock();
+  installGameAudio();
   installAudioPoseGuard();
 }

package/contributions/autoplay.service.ts

@@ -15,7 +15,7 @@
  * It reports its failure to the editor console — `vgai console` is what reads
  * it — rather than leaving a stopped surface with no reason on it.
  */
-import { onShellStore } from '@volter/editor-core/shell-store-door';
+import { onShellStore } from '@volter/editor-sdk/kit/shell-store-door';
 import { editorHost } from '@volter/editor-sdk/host';
 import { enterPlayMode } from '../src/play/play-mode';
 

package/contributions/bridge.command.ts

@@ -21,13 +21,13 @@
  * imports when they move. Nothing here is host API.
  */
 
-import { getActiveSystems } from '@volter/editor-core/authoring/active-systems';
+import { getActiveSystems } from '@volter/editor-sdk/kit/authoring/active-systems';
 import {
   activeGameplayRecordingTimeline,
   startGameplayRecording,
   stopGameplayRecording,
 } from '../src/host/gameplay-recording';
-import { captureGameplayReplay, exportGameplayReplay } from '@volter/editor-core/gameplay-replay';
+import { captureGameplayReplay, exportGameplayReplay } from '@volter/editor-sdk/kit/gameplay-replay';
 import type { CommandContribution } from '@volter/editor-sdk/commands';
 import { handleBridgeCall } from '../src/bridge/call';
 import { hasLiveDebugPlane } from '../src/bridge/dispatch';
@@ -140,7 +140,7 @@ export const commands: CommandContribution['commands'] = {
           appendGameplayRecordingChunk,
           finishGameplayRecordingSink,
           abortGameplayRecordingSink,
-        } = await import('@volter/editor-core/editor-api');
+        } = await import('@volter/editor-sdk/kit/editor-api');
         const sink = await beginGameplayRecordingSink({
           startedAt: new Date().toISOString(),
           mimeType: 'video/webm',

package/contributions/canvas/component-board.service.ts

@@ -0,0 +1,16 @@
+/**
+ * THE CANVAS MEDIUM'S COMPONENT BOARD (`@volter/editor-sdk/services`, a
+ * `workspace.service` contribution): `@volter/editor-game`'s canvas medium tells the host's component
+ * board registry that this project's `canvas` stories have a `2D` board.
+ *
+ * The same shape as `contributions/react/component-board.service.ts`.
+ */
+
+import { registerComponentBoard } from '@volter/editor-sdk/kit/component-board-registry';
+import { canvasComponentBoard } from '../../src/canvas/canvas-board/canvas-component-board';
+
+export const point = 'workspace.service';
+
+export function start(): () => void {
+  return registerComponentBoard(canvasComponentBoard);
+}

package/contributions/canvas/design-time-mount.service.ts

@@ -0,0 +1,45 @@
+/**
+ * THE CANVAS MEDIUM'S DESIGN-TIME MOUNT (a `workspace.service` contribution):
+ * tells the SDK's design-time mount registry how a `canvas` world mounts in
+ * Edit. The same shape as `contributions/react/design-time-mount.service.ts`;
+ * the mount itself stays behind a dynamic `import()` so `pixi.js` and
+ * `@pixi/react` load only for a project that declares a canvas root.
+ */
+
+import { registerDesignTimeMount } from '@volter/editor-sdk/kit/authoring/design-time-mount-registry';
+
+export const point = 'workspace.service';
+
+export function start(): () => void {
+  return registerDesignTimeMount({
+    kind: 'canvas',
+    owner: '@volter/editor-game/canvas/design-time-mount',
+    // The `ResolvedAdapter['identity']` a mount failure is reported under —
+    // the literal the host's own catch block used to spell.
+    identity: 'default-pixi',
+    // A canvas layer is always interactive: its content IS the document's
+    // whole subject (the game's 2D scene), and a click on it is how you
+    // select in it. The dom medium declares the opposite, because its
+    // design-time hover/press testing competes with authoring gestures.
+    alwaysInteractive: true,
+    mount: async (candidate, layer, context) => {
+      const { mountCanvasDesignTimeLayer } = await import('../../src/canvas/design-time-canvas-mount');
+      return mountCanvasDesignTimeLayer(candidate, layer, context);
+    },
+    remountWhen: (invalidate) => {
+      let stopped = false;
+      let stop: (() => void) | null = null;
+      // Loaded here for the same reason the mount is: the host calls this only when a canvas
+      // candidate exists.
+      void import('../../src/canvas/design-time-canvas-mount').then((module) => {
+        if (stopped) return;
+        stop = module.remountWhenSourceIsWritten(invalidate);
+      });
+      return () => {
+        stopped = true;
+        stop?.();
+        stop = null;
+      };
+    },
+  });
+}

package/contributions/canvas-story-capture.service.ts

@@ -0,0 +1,12 @@
+/**
+ * The canvas medium's captures, installed at boot (`workspace.service`): story thumbnails for a
+ * canvas story in an offscreen Pixi application, and Pixi's same-frame canvas pixels
+ * (`src/host/stories/story-media-captures.ts`). They are the game's, because Pixi is.
+ */
+import { registerStoryMediaCaptures } from '../src/host/stories/story-media-captures';
+
+export const point = 'workspace.service';
+
+export function start(): () => void {
+  return registerStoryMediaCaptures();
+}

package/contributions/edit-mode-audio.service.ts

@@ -10,8 +10,8 @@
  *
  * It was `components/EditModeAudioBootstrap.tsx`, a component that rendered
  * `null` so the shell's layout could run an effect, and through it the host
- * imported `@volter/game-runtime/setup/setup-audio`, `@volter/game-runtime/audio/bus-mixer` and
- * `@volter/game-runtime/audio/pose-guard` — the engine's audio RUNTIME — into every editor
+ * imported `@volter/editor-game/runtime/setup/setup-audio`, `@volter/editor-game/runtime/audio/bus-mixer` and
+ * `@volter/editor-game/runtime/audio/pose-guard` — the engine's audio RUNTIME — into every editor
  * boot (WORK.md §The open-source launch, phase 1 unit 7).
  */
 import { installEditModeAudio } from '../src/edit-mode/edit-mode-audio';

package/contributions/edit-mode-networking.service.ts

@@ -12,7 +12,7 @@
  * that always was, and the shell no longer names it (WORK.md §The workbench,
  * P3b).
  */
-import { onProjectChange } from '@volter/editor-core/project-manager';
+import { onProjectChange } from '@volter/editor-sdk/kit/active-project';
 import { installEditModeNetworking } from '../src/edit-mode/edit-mode-networking';
 
 export const point = 'workspace.service';

package/contributions/gameplay.command.ts

@@ -5,7 +5,7 @@
  *
  * All eight read/actuate the LIVE play session's game-scoped debug registry
  * (`SystemAdapters.debug`, installed by `setActiveSystems` on play enter) or
- * its InputManager/GameLoop (via `getPlayRuntimeAccess`). A stopped session
+ * its input door/GameLoop (via `getPlayRuntimeAccess`). A stopped session
  * answers with a structured failure, never a fabricated success; a running
  * game that exposes NO debug adapter (a non-first-party mount) degrades to
  * the honest empty/null shape.
@@ -17,7 +17,7 @@
  * when they move. Nothing here is host API.
  */
 
-import { getActiveSystems } from '@volter/editor-core/authoring/active-systems';
+import { getActiveSystems } from '@volter/editor-sdk/kit/authoring/active-systems';
 import type { CommandContribution } from '@volter/editor-sdk/commands';
 import { notPlayingResult, structuredErrorResult } from '../src/command-results';
 import { getPlayRuntimeAccess, isPlayModeActive } from '../src/play/play-mode';
@@ -111,7 +111,7 @@ export const commands: CommandContribution['commands'] = {
       if (!input) {
         return {
           ok: false,
-          error: 'this play session has no first-party InputManager to inject into',
+          error: 'this play session has no input door: no root entry exports `debug.input`',
         };
       }
       try {
@@ -122,7 +122,7 @@ export const commands: CommandContribution['commands'] = {
         // bindings, so `delivered` here means "the source was written").
         if (cmd['kind'] === 'action') {
           const atTick = cmd['atTick'];
-          // D15/T-D15.5 — `atTick` defers to InputManager.scheduleActionAtTick
+          // D15/T-D15.5 — `atTick` defers to the target's scheduleActionAtTick
           // instead of an immediate setVirtualAction. scheduleActionAtTick
           // throws InputActionError/a valueType mismatch (same as
           // setVirtualAction) or InputTickError ('TICK_ALREADY_PASSED',

package/contributions/generation.service.ts

@@ -30,7 +30,7 @@
  * routes over HTTP exactly as it did when it lived in the host.
  */
 
-import { registerDocumentOpener } from '@volter/editor-core/document-open-registry';
+import { registerDocumentOpener } from '@volter/editor-sdk/kit/document-open-registry';
 import { CONTRIBUTED_WORKSPACE_UTILITIES } from '@volter/editor-sdk/kit/workspace-core-utilities';
 import { registerWorkspaceUtility } from '@volter/editor-sdk/kit/workspace-utility-registry';
 import { GenerationActivity } from '../src/generation/GenerationActivity';

package/contributions/godot.style.ts

@@ -31,12 +31,29 @@ export const style: StyleContribution = {
       large: '0 6px 18px rgba(0,0,0,0.5)',
     },
     stage: {
-      // Godot's `manipulator_gizmo_size` is 80, but its unit is not ours: the stage's px per
-      // gizmo unit is fitted, not transcribed. At 128 the rotation rings measure ~80 px in
-      // radius on a 1x capture, against ~85 px in `engine-reference/godot/tuto_3d5.png`.
-      gizmoSize: 128,
-      // The move arrows reach 1.6 ring radii with a head about half again three's
-      // (`tuto_3d5.png`: a 142 px tip against a 90 px ring, a 25 px head).
+      // THE VIEWPORT'S OWN CHROME (`tuto_3d3.png`): the 3D editor's toolbar is a flush band
+      // over the view, the tools at its start and the view's controls after them; inside the
+      // view only the "⋮ Perspective" pill at the top-left, which opens the view menu.
+      // The transform controls (local space, snap) follow the tools on the band, as Godot's do.
+      chrome: { bar: 'strip', viewName: 'menu', tools: 'bar-start', display: 'bar-end', transformControls: 'bar' },
+      // Godot's display modes and its View menu, where the gizmos are switched.
+      words: {
+        shading: {
+          solid: 'Display Normal',
+          wireframe: 'Display Wireframe',
+          overdraw: 'Display Overdraw',
+          unlit: 'Display Unshaded',
+        },
+        helpers: 'View',
+      },
+      // The stage's ring radius in CSS px. Godot's gizmo unit is `manipulator_gizmo_size` (80)
+      // px on screen (`gizmo_scale = gizmo_size / dd`, `node_3d_editor_plugin.cpp`, at EDSCALE 1
+      // in a viewport at least 400 px tall) and its ring stands at `GIZMO_CIRCLE_SIZE` 1.1 of
+      // it: 88 px, as `engine-reference/godot/tuto_3d5.png`'s ~90 px ring.
+      gizmoSize: 88,
+      // The move arrows' tips stand at `GIZMO_ARROW_OFFSET` + `GIZMO_ARROW_SIZE` (1.4 + 0.35)
+      // units, 1.6 ring radii, with a head about half again three's (`tuto_3d5.png`: a 142 px
+      // tip against a 90 px ring, a 25 px head).
       gizmoArrowLength: 1.6,
       gizmoArrowHead: 1.5,
       // Its rotation rings are about twice three's thickness (`tuto_3d5.png`).
@@ -44,6 +61,9 @@ export const style: StyleContribution = {
       // `manipulator_gizmo_opacity` 0.9; the highlight is the axis colour at a quarter of its
       // saturation and full value (`node_3d_editor_plugin.cpp`).
       gizmoOpacity: 0.9,
+      // Its orientation gizmo is its own (`ViewportRotationControl::_draw_axis`): opacity by
+      // depth, darkened negatives, no mix toward the viewport (the editor's `godot` form).
+      navigationGizmo: 'godot',
       gizmoHighlightSaturation: 0.25,
       gizmoHighlightValue: 1,
       // Godot's grid lines are hairlines at both levels.

package/contributions/godot.view.ts

@@ -13,6 +13,9 @@ export const view: ViewPreset = {
   id: 'godot',
   title: 'Godot',
   layer: {
+    // Godot's editor camera: `editors/3d/default_fov` 70 (`editor_settings.cpp`), vertical — the
+    // editor's Camera3D keeps its height.
+    camera: { fov: { degrees: 70, axis: 'vertical' } },
     all: {
       lighting: {
         source: 'preview',
@@ -43,6 +46,9 @@ export const view: ViewPreset = {
       },
     },
     overlays: {
+      // No zoom and pan buttons under the gizmo and no camera readout: the engine draws neither.
+      navigationControls: false,
+      cameraReadout: false,
       grid: {
         visible: true,
         majorEvery: 8,

package/contributions/ingest.service.ts

@@ -42,10 +42,10 @@
  */
 import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import { importIngestAdapterModule, ingestAdapterModulePath } from '../src/host/ingest/registry';
-import { registerAdapterDefinitionSource } from '@volter/editor-core/project-adapter';
-import { threeStoreForHost } from '@volter/editor-core/shell-store-door';
+import { registerAdapterDefinitionSource } from '@volter/editor-sdk/kit/project-adapter';
 import { editorHost } from '@volter/editor-sdk/host';
 import { autoLaunchIngest } from '../src/ingest/mount-ingest-root';
+import { threeStoreForHost } from '@volter/editor-threejs/kit/three-state';
 
 export const point = 'workspace.service';
 

package/contributions/instances.command.ts

@@ -10,7 +10,7 @@
  * when they move. Nothing here is host API.
  */
 
-import { liveInstanceIds } from '@volter/editor-core/authoring/active-systems';
+import { liveInstanceIds } from '@volter/editor-sdk/kit/authoring/active-systems';
 import type { CommandContribution } from '@volter/editor-sdk/commands';
 import {
   instanceEntries,

package/contributions/navmesh.menu.ts

@@ -11,7 +11,7 @@
  * on its availability tick while a menu is open, so they follow the mounted
  * game's `NavigationAdapter` and a bake in flight.
  */
-import { getActiveSystems } from '@volter/editor-core/authoring/active-systems';
+import { getActiveSystems } from '@volter/editor-sdk/kit/authoring/active-systems';
 import type { MenuContribution } from '@volter/editor-sdk/chrome';
 import { dispatchNavMeshBake, dispatchNavMeshClear } from '../src/navmesh/navmesh-actions';
 import { navBakeBusy, navMeshBaked } from '../src/navmesh/navmesh-workflow-store';

package/contributions/network-observer.service.ts

@@ -0,0 +1,14 @@
+/**
+ * The page-level observer of a RUNNING game's Colyseus rooms (`@volter/editor-sdk/services`, a
+ * `workspace.service` contribution): wraps the page's WebSocket and fetch once, before any game
+ * joins a room, so the Network inspector reads a game that declares no networking adapter
+ * (`src/services/game-network.ts`). Page-wide and idempotent; a game that joins nothing is not
+ * affected.
+ */
+import { installGameNetwork } from '../src/services/game-network';
+
+export const point = 'workspace.service';
+
+export function start(): void {
+  installGameNetwork();
+}

package/contributions/play.command.ts

@@ -28,8 +28,8 @@
  * it, and no contribution point injects a panel's header component.
  */
 
-import { getActiveSystems } from '@volter/editor-core/authoring/active-systems';
-import { setGameplayExportActive } from '@volter/editor-core/gameplay-export-state';
+import { getActiveSystems } from '@volter/editor-sdk/kit/authoring/active-systems';
+import { setGameplayExportActive } from '@volter/editor-sdk/kit/gameplay-export-state';
 import { stopGameplayRecording } from '../src/host/gameplay-recording';
 import { liveInstanceContainer } from '@volter/editor-sdk/kit/live-session-registry';
 import type { CommandContribution } from '@volter/editor-sdk/commands';
@@ -46,6 +46,7 @@ import {
   stepPlayMode,
 } from '../src/play/play-mode';
 import { beginPlayRecording, endPlayRecording, notePlayActivity } from '../src/play/play-recording';
+import { startSelectedRunConfiguration, stopStartedRunConfiguration } from '../src/play/run-selection';
 
 export const point = 'workspace.command';
 
@@ -55,7 +56,7 @@ export const point = 'workspace.command';
 async function captureLiveCanvasFrame(
   canvas: HTMLCanvasElement,
 ): Promise<CanvasImageSource | null> {
-  const { liveCanvasFrame } = await import('@volter/editor-core/live-canvas-frame');
+  const { liveCanvasFrame } = await import('@volter/editor-sdk/kit/live-canvas-frame');
   return liveCanvasFrame(canvas);
 }
 
@@ -134,6 +135,10 @@ export const commands: CommandContribution['commands'] = {
         // field on the relayed command, slugified server-side into this run's
         // log filename and journal line. Absent, everything is unchanged.
         const runName = cmd['name'];
+        // What Play runs beside the host starts first, exactly as the Play button starts it: a
+        // `play + server` project's room server is up before its game joins.
+        const start = await startSelectedRunConfiguration();
+        if (!start.ok) return { ok: false, error: `${start.title}: ${start.detail}` };
         await enterPlayMode(
           typeof seed === 'number' ? seed : undefined,
           undefined,
@@ -208,6 +213,7 @@ export const commands: CommandContribution['commands'] = {
       // someone stopping the run wanted to look at.
       const capture = await endPlayRecording('stop');
       exitPlayMode();
+      await stopStartedRunConfiguration();
       return { ok: true, ...(capture ? { data: { recording: capture } } : {}) };
     },
   },
@@ -303,7 +309,7 @@ export const commands: CommandContribution['commands'] = {
           appendGameplayRecordingChunk,
           finishGameplayRecordingSink,
           abortGameplayRecordingSink,
-        } = await import('@volter/editor-core/editor-api');
+        } = await import('@volter/editor-sdk/kit/editor-api');
         controller.signal.throwIfAborted();
         const sink = await beginGameplayRecordingSink(
           {

package/contributions/react/component-board.service.ts

@@ -11,7 +11,7 @@
  * candidate appears: a promise cannot answer a verdict thunk.
  */
 
-import { registerComponentBoard } from '@volter/editor-core/component-board-registry';
+import { registerComponentBoard } from '@volter/editor-sdk/kit/component-board-registry';
 import { uiComponentBoard } from '../../src/react/ui-component-board';
 
 export const point = 'workspace.service';

package/contributions/react/design-time-mount.service.ts

@@ -21,7 +21,7 @@
  * the build's eager graph.
  */
 
-import { registerDesignTimeMount } from '@volter/editor-core/authoring/design-time-mount-registry';
+import { registerDesignTimeMount } from '@volter/editor-sdk/kit/authoring/design-time-mount-registry';
 
 export const point = 'workspace.service';
 

package/contributions/scene-document.service.ts

@@ -7,13 +7,13 @@
  *
  * The session store arrives after the contribution pass, and a project switch
  * brings a new one, so the document binds on each store's ARRIVAL
- * (`@volter/editor-core/shell-store-door`'s `onShellStore`, as Play's
+ * (`@volter/editor-sdk/kit/shell-store-door`'s `onShellStore`, as Play's
  * autoplay entry does) and unbinds the previous store's binding first.
  */
-import { onThreeStore } from '@volter/editor-core/shell-store-door';
-import { unregisterAvailableWorkspaceDocument } from '@volter/editor-core/workspace-available-documents';
+import { unregisterAvailableWorkspaceDocument } from '@volter/editor-sdk/kit/workspace-available-documents';
 import { SCENE_DOCUMENT_ID } from '@volter/editor-sdk/kit/workspace-document-ids';
 import { bindSceneDocument } from '../src/host/components/scene-document';
+import { onThreeStore } from '@volter/editor-threejs/kit/three-state';
 
 export const point = 'workspace.service';
 

package/contributions/state-watch.menu.ts

@@ -3,7 +3,7 @@
  * same predicate the drawer tab's own `available` gate reads. `disabled` is
  * asked at render, so it follows the session.
  */
-import { getActiveDebug } from '@volter/editor-core/authoring/active-systems';
+import { getActiveDebug } from '@volter/editor-sdk/kit/authoring/active-systems';
 import type { MenuContribution } from '@volter/editor-sdk/chrome';
 import { editorHost } from '@volter/editor-sdk/host';
 

package/contributions/state-watch.utility.tsx

@@ -7,7 +7,7 @@
  * `available` reads the PRIMARY authoring mount's debug adapter, exactly what
  * the panel itself reads, so the gate and the content can never disagree.
  */
-import { getActiveDebug } from '@volter/editor-core/authoring/active-systems';
+import { getActiveDebug } from '@volter/editor-sdk/kit/authoring/active-systems';
 import { StateWatchPanel } from '../src/state-watch/StateWatchPanel';
 
 export const point = 'workspace.utility';

package/contributions/team-playtest.service.ts

@@ -11,10 +11,10 @@
  * through the `@editor/*` alias.
  */
 
-import { getActiveNetworking, subscribeActiveNetworking } from '@volter/editor-core/authoring/active-systems';
-import { connectCollaboration } from '@volter/editor-core/collaboration-client';
-import { reportCollaborationPresence } from '@volter/editor-core/collaboration-presence';
-import { EDITOR_PARTICIPANT_ID } from '@volter/editor-core/editor-presence';
+import { getActiveNetworking, subscribeActiveNetworking } from '@volter/editor-sdk/kit/authoring/active-systems';
+import { connectCollaboration } from '@volter/editor-sdk/kit/collaboration-client';
+import { reportCollaborationPresence } from '@volter/editor-sdk/kit/collaboration-presence';
+import { EDITOR_PARTICIPANT_ID } from '@volter/editor-sdk/kit/editor-presence';
 import { activePlaytest, enterPlayMode, exitPlayMode } from '../src/play/play-mode';
 
 export const point = 'workspace.service';

package/contributions/three/component-board.service.ts

@@ -14,7 +14,7 @@
  * the same question as "do you want three?".
  */
 
-import { registerComponentBoard } from '@volter/editor-core/component-board-registry';
+import { registerComponentBoard } from '@volter/editor-sdk/kit/component-board-registry';
 import { threeComponentBoard } from '../../src/three/three-board/three-component-board';
 
 export const point = 'workspace.service';

package/contributions/three/component-verbs.command.ts

@@ -24,14 +24,14 @@
  * the two cannot drift.
  */
 
-import { getActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import { getActiveAuthoring } from '@volter/editor-sdk/kit/authoring/active-adapter';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import { canExtractNode, isExtractedHint } from '../../src/host/instance-extract-actions';
 import { canForkInstance, isForkedHint } from '../../src/host/instance-fork-actions';
-import { threeStoreForHost } from '@volter/editor-core/shell-store-door';
 import type { CommandContribution } from '@volter/editor-sdk/commands';
 import { instanceExtractSourceFor } from '../../src/three/component-verbs/extract-menu';
 import { instanceForkSourceFor } from '../../src/three/component-verbs/fork-menu';
+import { threeStoreForHost } from '@volter/editor-threejs/kit/three-state';
 
 /** The shell store, or the refusal that says the page has not installed one —
  *  the same shape `bridge.command.ts` takes it in, made explicit because both
@@ -42,7 +42,7 @@ const NO_STORE = { ok: false as const, error: 'the editor shell has not started
 function subjectId(cmd: Record<string, unknown>, store: EditorShellStore): string | undefined {
   const given = cmd['id'];
   if (typeof given === 'string' && given.trim() !== '') return given;
-  return [...store.selectedEntityIds][0];
+  return [...store.shell.selectedEntityIds][0];
 }
 
 export const commands: CommandContribution['commands'] = {
@@ -55,7 +55,7 @@ export const commands: CommandContribution['commands'] = {
         if (!store) return NO_STORE;
         const id = subjectId(cmd, store);
         if (!id) return { ok: false, error: 'extract-component needs an id or a selected row.' };
-        const adapter = getActiveAuthoring(store);
+        const adapter = getActiveAuthoring(store.shell);
         const source = instanceExtractSourceFor(adapter, id);
         if (!canExtractNode(adapter.hierarchy.node(id), source, id)) {
           return {
@@ -86,7 +86,7 @@ export const commands: CommandContribution['commands'] = {
         if (!store) return NO_STORE;
         const id = subjectId(cmd, store);
         if (!id) return { ok: false, error: 'fork-component needs an id or a selected row.' };
-        const adapter = getActiveAuthoring(store);
+        const adapter = getActiveAuthoring(store.shell);
         const source = instanceForkSourceFor(adapter, id);
         if (!canForkInstance(adapter.hierarchy.node(id), source, id)) {
           return {

package/contributions/three/three-authoring.service.ts

@@ -25,11 +25,13 @@
  * product that composes this package pays for it.
  */
 
-import { setBaseAuthoringFactory } from '@volter/editor-core/authoring/active-adapter';
-import { registerDesignTimeMount } from '@volter/editor-core/authoring/design-time-mount-registry';
-import { queueEditModeRebuild } from '@volter/editor-core/authoring/edit-mode-authoring';
+import { setBaseAuthoringFactory } from '@volter/editor-sdk/kit/authoring/active-adapter';
+import { registerDesignTimeMount } from '@volter/editor-sdk/kit/authoring/design-time-mount-registry';
+import { queueEditModeRebuild } from '@volter/editor-sdk/kit/authoring/edit-mode-authoring';
 import { authoringJournal } from '../../src/host/history/json-history-resource';
 import { oidThree } from '../../src/three/authoring/three-authoring-adapter';
+import type { WorldRootSessionContext } from '../../src/host/components/world-root-stage';
+import { threeStateOf } from '@volter/editor-threejs/kit/three-state';
 
 export const point = 'workspace.service';
 
@@ -45,12 +47,13 @@ export function start(): () => void {
     // R3F design session's fiber scene, once it adopts) is what the hierarchy
     // shows, and an unmounted world honestly shows nothing rather than a
     // fabricated document.
-    oidThree(store, () => store.scene, worldId, authoringJournal(worldId)),
+    oidThree(threeStateOf(store), () => threeStateOf(store).scene, worldId, authoringJournal(worldId)),
   );
   const stopMount = registerDesignTimeMount({
     kind: 'three',
     owner: '@volter/editor-game/three/three-authoring',
-    mountWorldRootSession: async (context) => {
+    async mountWorldRootSession(stage) {
+      const context = stage as WorldRootSessionContext;
       const { mountR3FDesignSession } = await session;
       return mountR3FDesignSession(context.store, context.composite, context.renderer);
     },

package/contributions/three-story-capture.service.ts

@@ -0,0 +1,12 @@
+/**
+ * The three.js story thumbnail capture (`@volter/editor-sdk/kit/story-thumbnails`), installed at
+ * boot (`workspace.service`): a prefab story renders in an offscreen React Three Fiber stage
+ * (`src/host/stories/three-story-captures.ts`). It is the game's, because prefab stories are R3F.
+ */
+import { registerThreeStoryCapture } from '../src/host/stories/three-story-captures';
+
+export const point = 'workspace.service';
+
+export function start(): () => void {
+  return registerThreeStoryCapture();
+}

package/contributions/unity.style.ts

@@ -31,16 +31,26 @@ export const style: StyleContribution = {
       large: '0 6px 18px rgba(0,0,0,0.55)',
     },
     stage: {
-      // `HandleUtility.GetHandleSize` keeps a handle a constant size on screen; the stage's
-      // px per gizmo unit is fitted, not transcribed: at 128 the move arrows reach ~95 px on
-      // a 1x capture, as in `engine-reference/unity/PrimitiveCube.png`.
-      gizmoSize: 128,
+      // THE SCENE VIEW'S OWN CHROME (`NewEmptyScene_01.png`, `PrimitiveCube.png`): the Scene
+      // view's toolbar is a flush band with the draw mode first ("Shaded"); the tools are
+      // Unity's Tools overlay at the view's left; the view's name is the label under the scene
+      // gizmo ("Persp"), which toggles the projection.
+      chrome: { bar: 'strip', viewName: 'gizmo', tools: 'shelf', display: 'bar-start' },
+      // Unity's draw modes and its Gizmos menu (`NewEmptyScene_01.png`: `Shaded`, `Gizmos`).
+      words: { shading: { solid: 'Shaded', wireframe: 'Wireframe' }, helpers: 'Gizmos' },
+      // A handle is 80 points on screen whatever the distance (`HandleUtility.GetHandleSize`,
+      // `k_KHandleSize`), the radius of the rotate disc; the stage's ring radius is this many
+      // CSS px. The documentation's frames are small Scene views at about half scale, so their
+      // arrows look long beside the object; on screen they are these points.
+      gizmoSize: 80,
       // Unity's scene gizmo: cones round a grey cube (`Editor-SceneGizmo.png`).
       navigationGizmo: 'cones',
-      // Unity's move arrow is a thin shaft ending at the rotate ring, with a long cone head
-      // (`TransformGizmo35.png`, `game-objects-transform-modes.png`).
+      // `Handles.ArrowHandleCap`: a shaft to 0.9 of the handle and a cone centred at 1.0, scaled
+      // 0.2 of it. The cone mesh's own proportions are the editor's resource, so they are read
+      // off `TransformGizmo35.png` at 1x: a tip at about 1.1 handles and a cone about 0.25 of
+      // the handle long, 1.25 of three's head.
       gizmoArrowLength: 1.1,
-      gizmoArrowHead: 1.2,
+      gizmoArrowHead: 1.25,
       // The axis colours' alpha (`Handles.cs`); hover and drag are fixed colours (the palette).
       gizmoOpacity: 0.93,
       // `SceneViewGrid`: one-pixel lines at both levels, the ten-cell level a little stronger.

package/contributions/unity.view.ts

@@ -12,6 +12,9 @@ export const view: ViewPreset = {
   id: 'unity',
   title: 'Unity',
   layer: {
+    // Unity's Scene camera: `kDefaultPerspectiveFov` 60, vertical when the view is wider than tall
+    // and horizontal otherwise (`SceneView.GetVerticalFOV`) — on its smaller side.
+    camera: { fov: { degrees: 60, axis: 'smaller' } },
     all: {
       lighting: {
         source: 'preview',
@@ -49,6 +52,9 @@ export const view: ViewPreset = {
       },
     },
     overlays: {
+      // No zoom and pan buttons under the gizmo and no camera readout: the engine draws neither.
+      navigationControls: false,
+      cameraReadout: false,
       grid: {
         visible: true,
         majorEvery: 10,

package/contributions/unreal.style.ts

@@ -31,9 +31,17 @@ export const style: StyleContribution = {
       large: '0 6px 18px rgba(0,0,0,0.6)',
     },
     stage: {
+      // THE LEVEL VIEWPORT'S OWN CHROME (`level-editor.png`): one row of rounded pills over the
+      // view that runs on from its start: the view's name ("Perspective") and the view mode
+      // ("Lit"), then the transform tools, then the transform controls with the snap steps
+      // (`10`, `10°`, `0.5`).
+      chrome: { bar: 'pills', viewName: 'bar', tools: 'bar-start', display: 'bar-start', transformControls: 'bar' },
+      // Unreal's words for the view modes and the Show menu (`level-editor.png`: `Lit`, `Show`).
+      words: { shading: { solid: 'Lit', unlit: 'Unlit', wireframe: 'Wireframe' }, helpers: 'Show' },
       // Unreal keeps its widget a constant size on screen; in `level-editor.png` the Move
-      // arrows reach 85 to 100 px from the centre sphere. Fitted, not transcribed.
-      gizmoSize: 128,
+      // arrows reach 85 to 100 px from the centre sphere. Fitted, not transcribed: the stage's
+      // ring radius is this many CSS px, so the 0.85 tip below stands at 94 px.
+      gizmoSize: 110,
       // The axis triad in the viewport's bottom-left corner (`level-editor.png`).
       navigationGizmo: 'triad',
       navigationCorner: 'bottom-left',