@volter/editor-game 0.5.66 → 0.5.68

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/build-player.document.tsx

@@ -0,0 +1,95 @@
+/**
+ * BUILD PLAYER (`workspace.document`) — the project's last build, run as a
+ * player runs it: its own `dist/`, served by the editor server, in a frame
+ * with nothing of the editor inside it. Build Profiles' Build And Run opens
+ * it, as Unity's Build And Run launches the player and Godot's Web export
+ * runs in a browser; each run reloads the frame.
+ *
+ * What the build prints reaches the editor's console, prefixed
+ * `[Build Player]`, as a Godot export run with remote debug reports into the
+ * editor's debugger: its console calls, and its uncaught errors. The capture
+ * door photographs the build itself (`framed-document-capture.ts`).
+ */
+
+import type { ToolContributionProps } from '@volter/editor-sdk/contributions';
+import { registerFramedCapture } from '@volter/editor-sdk/kit/framed-document-capture';
+import { useSyncExternalStore } from 'react';
+import { BUILD_PLAYER_URL, buildRunCount, subscribeBuildRuns } from '../src/build/build-session';
+
+export const point = 'workspace.document';
+export const title = 'Build Player';
+
+const FORWARDED = ['log', 'info', 'warn', 'error'] as const;
+
+const HOOKED = Symbol('build-player-output');
+
+/** Hook the player's document once it exists: the build's module scripts run
+ *  before `load`, after its HTML is parsed and while their bundle is fetched,
+ *  so the frame is watched from insertion until its document is the build's. */
+function watchFrame(frame: HTMLIFrameElement | null): void {
+  if (!frame) return;
+  const tick = () => {
+    if (!frame.isConnected) return;
+    const player = frame.contentWindow as (Window & typeof globalThis & { [HOOKED]?: true }) | null;
+    if (player?.location.pathname === new URL(BUILD_PLAYER_URL, location.href).pathname) {
+      if (!player[HOOKED]) {
+        forwardOutput(player);
+        registerFramedCapture(frame, {
+          container: () => player.document.getElementById('game-canvas') ?? player.document.body,
+          canvasFrame: (canvas) => copyAfterRender(player, canvas),
+        });
+      }
+      if (player.document.readyState === 'complete') return;
+    }
+    setTimeout(tick, 0);
+  };
+  tick();
+}
+
+/** A copy of `canvas` taken in the player's next frame, after the game's own
+ *  frame callbacks (registered a frame earlier) have drawn it. */
+function copyAfterRender(player: Window & typeof globalThis, canvas: HTMLCanvasElement): Promise<CanvasImageSource | null> {
+  return new Promise((resolve) => {
+    player.requestAnimationFrame(() => {
+      const copy = player.document.createElement('canvas');
+      copy.width = canvas.width;
+      copy.height = canvas.height;
+      const context = copy.getContext('2d');
+      if (!context) return resolve(null);
+      context.drawImage(canvas, 0, 0);
+      resolve(copy);
+    });
+  });
+}
+
+function forwardOutput(player: Window & typeof globalThis & { [HOOKED]?: true }): void {
+  player[HOOKED] = true;
+  for (const level of FORWARDED) {
+    const own = player.console[level].bind(player.console);
+    player.console[level] = (...args: unknown[]) => {
+      own(...args);
+      console[level]('[Build Player]', ...args);
+    };
+  }
+  player.addEventListener('error', (event) => {
+    console.error('[Build Player] Uncaught', event.error ?? event.message);
+  });
+  player.addEventListener('unhandledrejection', (event) => {
+    console.error('[Build Player] Unhandled rejection', event.reason);
+  });
+  console.info(`[Build Player] Running ${player.document.title || 'the build'}`);
+}
+
+export default function BuildPlayerDocument(_props: ToolContributionProps) {
+  const run = useSyncExternalStore(subscribeBuildRuns, buildRunCount);
+  return (
+    <iframe
+      key={run}
+      title="Build Player"
+      data-build-player={run}
+      src={`${BUILD_PLAYER_URL}?run=${run}`}
+      ref={watchFrame}
+      style={{ width: '100%', height: '100%', border: 0, display: 'block', background: '#000' }}
+    />
+  );
+}

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);
     },