@volter/editor-game 0.5.65 → 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,9 +30,9 @@
  * routes over HTTP exactly as it did when it lived in the host.
  */
 
-import { registerDocumentOpener } from '@volter/editor-core/document-open-registry';
-import { CONTRIBUTED_WORKSPACE_UTILITIES } from '@volter/editor-core/workspace-core-utilities';
-import { registerWorkspaceUtility } from '@volter/editor-core/workspace-utility-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';
 import {
   openGenerationCreateDocument,

package/contributions/generations.status.tsx

@@ -9,7 +9,7 @@
  * concern).
  */
 
-import { CONTRIBUTED_WORKSPACE_UTILITIES } from '@volter/editor-core/workspace-core-utilities';
+import { CONTRIBUTED_WORKSPACE_UTILITIES } from '@volter/editor-sdk/kit/workspace-core-utilities';
 import { editorHost } from '@volter/editor-sdk/host';
 import { Button } from '@volter/editor-sdk/widgets';
 import { useSyncExternalStore } from 'react';

package/contributions/godot.palette.json

@@ -0,0 +1,99 @@
+{
+  "schemaVersion": 3,
+  "name": "Godot",
+  "theme": {
+    "id": "godot",
+    "color": {
+      "surface": {
+        "shell": "#1d2229",
+        "panel": "#21262e",
+        "chrome": "#252b34",
+        "raised": "#363d4a",
+        "inset": "#1d2229",
+        "overlay": "rgba(33,38,46,0.96)"
+      },
+      "boundary": {
+        "default": "#363d4a",
+        "strong": "#4a5263",
+        "area": "#1d2229",
+        "indent": "#4a5263",
+        "divider": "#2c323c"
+      },
+      "content": {
+        "primary": "#e0e0e0",
+        "muted": "#c0c3c8",
+        "dim": "#8a8e96",
+        "onAccent": "#ffffff",
+        "menu": "#e0e0e0",
+        "status": "#9a9ea6",
+        "placeholder": "#6a6d73",
+        "active": "#70bafa",
+        "selected": "#70bafa",
+        "onBright": {
+          "primary": "#1d2229",
+          "muted": "rgba(29,34,41,0.82)",
+          "dim": "rgba(29,34,41,0.7)"
+        }
+      },
+      "accent": {
+        "default": "#70bafa",
+        "muted": "#374f66"
+      },
+      "widget": {
+        "regular": "#363d4a",
+        "menu": "#21262e",
+        "field": "#1d2229",
+        "emboss": "rgba(0,0,0,0.12)"
+      },
+      "viewport": {
+        "background": "#4d4d4d",
+        "grid": "#6e6964",
+        "axisX": "#f53352",
+        "axisY": "#87d603",
+        "axisZ": "#298cf5",
+        "selection": "#ff8000",
+        "active": "#ff8000"
+      },
+      "gizmo": {
+        "x": "#f53352",
+        "y": "#87d603",
+        "z": "#298cf5"
+      },
+      "region": {
+        "outliner": "#21262e",
+        "properties": "#21262e"
+      },
+      "category": {
+        "object": "#fc7f7f",
+        "modifier": "#8da5f3",
+        "material": "#ff5d5d",
+        "data": "#8eef97",
+        "scene": "#e0e0e0",
+        "collection": "#e0e0e0",
+        "tool": "#e0e0e0",
+        "operator": "#8eef97"
+      },
+      "semantic": {
+        "danger": "#ff786b",
+        "dangerMuted": "rgba(255,120,107,0.28)",
+        "dangerFaint": "rgba(255,120,107,0.12)",
+        "warning": "#ffdd65",
+        "warningMuted": "rgba(255,221,101,0.28)",
+        "success": "#45ff8b",
+        "successMuted": "rgba(69,255,139,0.28)",
+        "dynamic": "#ffdd65",
+        "dynamicMuted": "rgba(255,221,101,0.18)",
+        "instance": "#70bafa"
+      },
+      "neutralOverlay": {
+        "hover": "rgba(255,255,255,0.07)",
+        "active": "rgba(255,255,255,0.13)"
+      },
+      "scrim": "rgba(0,0,0,0.6)"
+    },
+    "typography": {
+      "sans": "'Noto Sans', 'Inter', system-ui, sans-serif",
+      "mono": "'JetBrains Mono', 'Hack', Menlo, monospace"
+    }
+  }
+}

package/contributions/godot.style.ts

@@ -0,0 +1,82 @@
+/**
+ * THE GODOT LOOK — Godot 4.4's default editor theme and its 3D viewport's
+ * colours, made only of values (`docs/VIEWPORT-STAGE.md`, the Godot column).
+ *
+ * The viewport group transcribes Godot's axis colours (`theme_modern.cpp`): X (0.96, 0.20,
+ * 0.32), Y (0.53, 0.84, 0.01) and Z (0.16, 0.55, 0.96), named by the world's axes; and the selection
+ * box (1.0, 0.5, 0). The fill is Godot's `default_clear_color` (0.3, 0.3, 0.3),
+ * what shows with the preview environment off. The grid's minor and major
+ * levels are the primary/secondary grid colours at alpha 0.5, fitted against
+ * `engine-reference/godot/tuto_3d3.png` over the preview sky's ground: a line
+ * there peaks near (95, 91, 87) over a (62, 51, 40) floor.
+ * Light, sky and overlays are the VIEW's presentation, not this look's.
+ */
+import type { StyleContribution } from '@volter/editor-sdk/looks';
+import palette from './godot.palette.json';
+
+export const point = 'workspace.style';
+export const style: StyleContribution = {
+  id: 'godot',
+  title: 'Godot',
+  paletteId: 'godot',
+  materialId: 'godot',
+  material: {
+    id: 'godot',
+    title: 'Godot',
+    description: 'Flat blue-grey panels, three-pixel corners, a soft shadow under popups.',
+    shape: { small: '3px', medium: '3px', large: '4px', full: '9999px' },
+    elevation: {
+      small: 'none',
+      medium: '0 3px 10px rgba(0,0,0,0.45)',
+      large: '0 6px 18px rgba(0,0,0,0.5)',
+    },
+    stage: {
+      // 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`).
+      gizmoRingWidth: 2,
+      // `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.
+      gridLineWidth: 1,
+      gridMajorWidth: 1,
+      gridMajorContrast: 1.3,
+      // Godot's selection is the whole AABB. Its edge is one solid pixel at 1x
+      // (`tuto_3d5.png`); our screen-space line needs 2 to cover one captured pixel.
+      selectionBox: 'edges',
+      // Godot's box turns with the object: its AABB in the object's own frame.
+      selectionBoxFrame: 'object',
+      selectionBoxWidth: 2,
+    },
+  },
+  palette,
+};

package/contributions/godot.view.ts

@@ -0,0 +1,75 @@
+/**
+ * GODOT'S DEFAULT 3D VIEWPORT: its preview sun and procedural sky (the kit's sky, which is
+ * Godot's own `ProceduralSkyMaterial` default) under its Filmic curve, the sky as backdrop, an
+ * 8-cell grid, all three axis lines with Y vertical, the full selection box, and its Select
+ * gizmo's arrows and rings without the extra handles. Judged against `tuto_3d3.png`/`tuto_3d5.png`.
+ * A named view (`@volter/editor-sdk/kit/viewport-presentation` `ViewPreset`): what the view does
+ * and how it is lit, never its look — pair it with the Godot style for the whole target.
+ */
+import type { ViewPreset } from '@volter/editor-sdk/kit/viewport-presentation';
+
+export const point = 'workspace.view';
+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',
+        preview: {
+          sun: {
+            enabled: true,
+            color: '#ffffff',
+            energy: 1,
+            altitude: 60,
+            azimuth: 150,
+            shadowDistance: 100,
+          },
+          environment: {
+            enabled: true,
+            energy: 1,
+            rotation: 0,
+          },
+        },
+        tone: {
+          mapper: 'filmic',
+          exposure: 1,
+        },
+      },
+      backdrop: {
+        source: 'environment',
+        opacity: 1,
+        blur: 0,
+      },
+    },
+    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,
+      },
+      selection: {
+        outline: false,
+        wire: false,
+        box: true,
+      },
+      axes: {
+        x: true,
+        y: true,
+        z: true,
+      },
+    },
+    interaction: {
+      transformHandles: {
+        scale: false,
+        viewRotate: false,
+        freeMove: false,
+      },
+    },
+  },
+};

package/contributions/ingest.service.ts

@@ -40,12 +40,12 @@
  * `mount-ingest-root.ts` binds itself on — read at launch time rather than
  * captured, so neither ordering can leave the launch holding `null`.
  */
-import { editorConsole } from '@volter/editor-core/editor-console';
+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 { shellStoreForHost } 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';
 
@@ -60,7 +60,7 @@ export function start(): () => void {
     importModule: async (rootId) => await importIngestAdapterModule(rootId),
   });
   const stopReady = editorHost().project.onReady(async () => {
-    const store = shellStoreForHost();
+    const store = threeStoreForHost();
     if (!store) {
       // The store arrives with `AppRoot`, long before any boot chain reaches
       // ready, so this cannot happen quietly — say so rather than skipping an

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,10 +28,10 @@
  * 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-core/live-session-registry';
+import { liveInstanceContainer } from '@volter/editor-sdk/kit/live-session-registry';
 import type { CommandContribution } from '@volter/editor-sdk/commands';
 import { editorHost } from '@volter/editor-sdk/host';
 import type { OfflineAudioRenderer } from '@volter/editor-project/adapter';
@@ -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/react/react-inspector.service.ts

@@ -64,9 +64,9 @@
  * structural write pipe (`authoring/r3f-source-authoring-adapter.ts`,
  * `@vgai/canvas/pixi-source-write-target.ts`); the breakpoint state
  * (`components/BoardRulers.tsx`); `authoring/react-story-board.ts`, the
- * board's geometry, which four host surfaces read
+ * board's geometry, which three host surfaces read
  * (`components/RootSelectionOverlay.tsx:98`,
- * `components/ReactCanvasControls.tsx:15`, `pasteboard-materialize.ts:20`,
+ * `components/ReactCanvasControls.tsx:15`,
  * `canvas-board/CanvasBoardDocument.tsx:57`) because they draw chrome OVER
  * the board. Each is its own unit with its own seam; none of them is in the
  * host's EAGER closure, which is what these cuts buy.

package/contributions/scene-document.service.ts

@@ -7,19 +7,19 @@
  *
  * 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 { onShellStore } from '@volter/editor-core/shell-store-door';
-import { unregisterAvailableWorkspaceDocument } from '@volter/editor-core/workspace-available-documents';
-import { SCENE_DOCUMENT_ID } from '@volter/editor-core/workspace-document-ids';
+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';
 
 export function start(): () => void {
   let unbind: (() => void) | null = null;
-  const stopStore = onShellStore((store) => {
+  const stopStore = onThreeStore((store) => {
     unbind?.();
     unbind = bindSceneDocument(store);
   });