@volter/editor-game 0.5.66 → 0.5.68

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',

package/contributions/unreal.view.ts

@@ -15,6 +15,8 @@ export const view: ViewPreset = {
   id: 'unreal',
   title: 'Unreal',
   layer: {
+    // Unreal's level viewport: a 90° horizontal field of view, its viewport setting's default.
+    camera: { fov: { degrees: 90, axis: 'horizontal' } },
     all: {
       lighting: {
         source: 'preview',
@@ -53,6 +55,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,
       navigation: 'indicator',
       grid: {
         visible: false,

package/package.json

@@ -2,7 +2,7 @@
   "name": "@volter/editor-game",
   "author": "Volter AI, Inc.",
   "license": "AGPL-3.0-only",
-  "version": "0.5.66",
+  "version": "0.5.68",
   "publishConfig": {
     "access": "public"
   },
@@ -24,7 +24,11 @@
   "exports": {
     "./contributions/*": "./contributions/*",
     "./*": "./src/*",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./host/canvas-preview-frames": "./src/host/canvas-preview-frames.ts",
+    "./host/stories/pixi-story-model": "./src/host/stories/pixi-story-model.ts",
+    "./host/stories/story-pixi-preview": "./src/host/stories/story-pixi-preview.ts",
+    "./host/stories/story-media-captures": "./src/host/stories/story-media-captures.ts"
   },
   "vgai": {
     "contributions": [
@@ -33,10 +37,12 @@
       "./contributions/asset-budget.document.tsx",
       "./contributions/asset-budget.menu.ts",
       "./contributions/audio-unlock.service.ts",
+      "./contributions/network-observer.service.ts",
       "./contributions/audio.utility.tsx",
       "./contributions/autoplay.service.ts",
       "./contributions/bridge.command.ts",
       "./contributions/build-profiles.document.tsx",
+      "./contributions/build-player.document.tsx",
       "./contributions/build-progress.status.tsx",
       "./contributions/build.action.ts",
       "./contributions/build.command.ts",
@@ -74,6 +80,8 @@
       "./contributions/unity.view.ts",
       "./contributions/unreal.style.ts",
       "./contributions/unreal.view.ts",
+      "./contributions/canvas/component-board.service.ts",
+      "./contributions/canvas/design-time-mount.service.ts",
       "./contributions/react/component-board.service.ts",
       "./contributions/react/design-time-mount.service.ts",
       "./contributions/react/react-inspector.service.ts",
@@ -86,17 +94,19 @@
       "./contributions/three/model-asset-sections.service.ts",
       "./contributions/three/reflection-probe-capture.inspector.tsx",
       "./contributions/three/story-documents.service.ts",
-      "./contributions/three/three-authoring.service.ts"
+      "./contributions/three/three-authoring.service.ts",
+      "./contributions/three-story-capture.service.ts",
+      "./contributions/canvas-story-capture.service.ts"
     ],
     "serving": "./dist-node/serving.mjs"
   },
   "dependencies": {
-    "@volter/editor-core": "0.5.66",
-    "@volter/editor-sdk": "0.5.66",
-    "@volter/editor-project": "0.5.66",
-    "@volter/editor-threejs": "0.5.66",
-    "@volter/threejs-runtime": "0.5.66",
-    "@volter/game-runtime": "0.5.66",
+    "@volter/editor-sdk": "0.5.68",
+    "@volter/editor-project": "0.5.68",
+    "@volter/editor-threejs": "0.5.68",
+    "@volter/threejs-runtime": "0.5.68",
+    "@volter/game-runtime": "0.5.68",
+    "@colyseus/msgpackr": "^1.11.3",
     "@colyseus/schema": "^4.0.14",
     "@colyseus/sdk": "^0.17.34",
     "@fortawesome/free-solid-svg-icons": "^7.2.0",
@@ -110,6 +120,7 @@
     "draco3d": "^1.5.7",
     "esbuild-wasm": "0.25.12",
     "fastnoise-lite": "^1.1.1",
+    "loglayer": "^9.1.0",
     "mediabunny": "1.56.2",
     "meshoptimizer": "^1.2.0",
     "three": "^0.180.0",
@@ -127,7 +138,7 @@
     "xstate": "^5.32.4",
     "zod": "^4.3.6",
     "@fortawesome/fontawesome-svg-core": "^7.2.0",
-    "@volter/editor-react": "0.5.66"
+    "@volter/editor-react": "0.5.68"
   },
   "peerDependencies": {
     "@sparkjsdev/spark": "^2.1.0",

package/src/asset-budget/AssetBudgetPanel.tsx

@@ -12,7 +12,7 @@
  * rendered with an explicit `≥`, inspection failures with their reason).
  */
 
-import { getStorageBackend } from '@volter/editor-core/storage/index';
+import { getStorageBackend } from '@volter/editor-sdk/kit/storage/index';
 import { editorHost } from '@volter/editor-sdk/host';
 import {
   accent,

package/src/asset-budget/asset-budget-model.ts

@@ -288,7 +288,7 @@ const MANIFEST_NAME = 'vgai.project.json';
  * The manifest is the ONLY JSON document that owns asset references. An
  * `.inputmap.json` was scanned as one too, and could not be. `collectStringPaths`
  * below yields string VALUES only (action names are record KEYS — never
- * candidates), and every string value `InputMapFileSchema` admits is a binding
+ * candidates), and every string value an input map carries is a binding
  * `type` literal, a `KeyboardEvent.code`, a `direction`/`valueType` enum, or an
  * injected/touch `sourceId`; button/axis indexes are numbers. None of them is a
  * path, so the only value that could ever have resolved to an asset was a

package/src/audio/AudioDebuggerPanel.tsx

@@ -23,7 +23,7 @@
 
 import { editorHost } from '@volter/editor-sdk/host';
 import { Button, fontSizeVar, spaceVar, themeVars } from '@volter/editor-sdk/widgets';
-import { meterPercent } from '@volter/game-runtime/adapter/audio-meter';
+import { meterPercent } from '../runtime/adapter/audio-meter';
 import type { AudioAdapter, AudioDebugEvent, AudioMeterFrame } from '@volter/editor-project/adapter';
 import { useEffect, useReducer, useRef, useState } from 'react';
 import {

package/src/bridge/dispatch.ts

@@ -13,15 +13,15 @@ import {
   getActiveSystems,
   InstanceResolutionError,
   systemsForInstance,
-} from '@volter/editor-core/authoring/active-systems';
-import { collectPlayRunPageErrors } from '@volter/editor-core/command-listener';
+} from '@volter/editor-sdk/kit/authoring/active-systems';
+import { collectPlayRunPageErrors } from '@volter/editor-sdk/kit/command-listener';
 import { gameContractEpoch } from '../host/coverage/game-contract-seam-evidence';
 import { recordLiveSeamEvidence } from '@volter/editor-sdk/kit/live-seam-evidence';
 import { systemAdapterEpoch } from '@volter/editor-sdk/kit/system-seam-evidence';
 import {
   HOLD_STARVED_NO_DRIVER_REASON,
   waitForHoldBudget,
-} from '@volter/game-runtime/runtime/debug-bridge';
+} from '../runtime/debug-bridge';
 import type { SystemAdapters } from '@volter/editor-project/adapter';
 import { activeIngestContract } from '../ingest/ingest-play-control';
 import { getPlayRuntimeAccess } from '../play/play-mode';
@@ -39,7 +39,7 @@ import { getPlayRuntimeAccess } from '../play/play-mode';
  *  game, so it never creates a play session at all, and what it publishes
  *  through `setActiveSystems` is the debug adapter projected from its own
  *  declared contract (`ingest-root-adapter.ts` →
- *  `@volter/game-runtime/adapter/ingest/contract-debug-adapter`). The question asked here is
+ *  `@volter/editor-game/runtime/adapter/ingest/contract-debug-adapter`). The question asked here is
  *  only ever "has a live mount published a plane", never who mounted it.
  *  `notPlayingResult()` stays the answer for the genuinely-no-world case. */
 export const hasLiveDebugPlane = (): boolean => getActiveSystems().debug != null;
@@ -48,7 +48,7 @@ export const hasLiveDebugPlane = (): boolean => getActiveSystems().debug != null
  *  `Error` carrying a machine-readable `code` (and optional `data`), the same
  *  shape `DebugError`/`InputActionError` already throw. Used by
  *  `dispatchBridgeMethod` below for its OWN precondition failures (no debug
- *  adapter installed, no InputManager wired) so they survive
+ *  adapter installed, no input door wired) so they survive
  *  `structuredErrorResult` exactly like an engine-thrown error would. */
 export function bridgeError(code: string, message: string, data?: Record<string, unknown>): Error {
   const err = new Error(message) as Error & { code: string; data?: unknown };
@@ -109,7 +109,7 @@ function recordContractSystemUse(member: string, value: unknown, name?: string):
 
 /**
  * #140 — the generic session-wire dispatch table: the SAME method-name
- * surface `window.__vgai` exposes (`@volter/game-runtime/runtime/debug-bridge`'s
+ * surface `window.__vgai` exposes (`@volter/editor-game/runtime/debug-bridge`'s
  * `VgaiDebugHandle` — `state`/`stateAll`/`providers`/`commands`/`events`/
  * `snapshot`/`invoke`/`runTicks`/`input.*`), built from the SAME
  * registry-backed accessors the sibling
@@ -337,8 +337,8 @@ export async function dispatchBridgeMethod(
       if (!inputTarget) {
         throw bridgeError(
           'DEBUG_INPUT_UNAVAILABLE',
-          `session wire: ${method}() has no virtual-input target wired — no default three ` +
-            "world has mounted yet, or this project's mount path never wired one",
+          `session wire: ${method}() has no virtual-input target wired — no root ` +
+            "entry exports `debug.input` (the game's own input door), or none has mounted yet",
         );
       }
       if (method === 'input.setVirtualAction') {
@@ -382,8 +382,8 @@ export async function dispatchBridgeMethod(
       if (!inputTarget) {
         throw bridgeError(
           'DEBUG_INPUT_UNAVAILABLE',
-          'session wire: input.scheduleActionAtTick() has no virtual-input target wired — no ' +
-            "default three world has mounted yet, or this project's mount path never wired one",
+          'session wire: input.scheduleActionAtTick() has no virtual-input target wired — no root ' +
+            "entry exports `debug.input` (the game's own input door), or none has mounted yet",
         );
       }
       return inputTarget.scheduleActionAtTick(tick, action, value);
@@ -405,8 +405,8 @@ export async function dispatchBridgeMethod(
       if (!inputTarget) {
         throw bridgeError(
           'DEBUG_INPUT_UNAVAILABLE',
-          `session wire: ${method}() has no virtual-input target wired — no default three ` +
-            "world has mounted yet, or this project's mount path never wired one",
+          `session wire: ${method}() has no virtual-input target wired — no root ` +
+            "entry exports `debug.input` (the game's own input door), or none has mounted yet",
         );
       }
       if (method === 'input.injectPointerDelta') {
@@ -430,8 +430,8 @@ export async function dispatchBridgeMethod(
       if (!inputTarget) {
         throw bridgeError(
           'DEBUG_INPUT_UNAVAILABLE',
-          'session wire: holdFor() has no virtual-input target wired — no default three ' +
-            "world has mounted yet, or this project's mount path never wired one",
+          'session wire: holdFor() has no virtual-input target wired — no root ' +
+            "entry exports `debug.input` (the game's own input door), or none has mounted yet",
         );
       }
       const action = callArgs[0] as string;

package/src/bridge/live-frames.ts

@@ -14,7 +14,7 @@ import { getPlayRuntimeAccess } from '../play/play-mode';
 export 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);
 }
 

package/src/bridge/screenshot.ts

@@ -12,7 +12,7 @@ import {
   CaptureLayerError,
   capturePlayComposite,
   sampleFlatness,
-} from '@volter/editor-core/composite-screenshot';
+} from '@volter/editor-sdk/kit/composite-screenshot';
 import { editorConsole } from '@volter/editor-sdk/kit/editor-console';
 import { presentationSurface } from '@volter/editor-sdk/kit/presentation-surface';
 import type { EditorCommandMessage, EditorCommandResult } from '@volter/editor-sdk/commands';
@@ -51,7 +51,7 @@ import { captureLiveCanvasFrame } from './live-frames';
  *
  *  BOTH legs read a canvas, and a canvas is only readable after its frame when
  *  its WebGL context was created with `preserveDrawingBuffer: true`. Every
- *  canvas the vgai RUNTIME mounts sets it (`@volter/game-runtime/runtime/create-runtime`,
+ *  canvas the vgai RUNTIME mounts sets it (`@volter/editor-game/runtime/create-runtime`,
  *  D5 §1/§4); a canvas an INGESTED game created is the game's own and usually
  *  does not, which read as a silently BLACK screenshot over a perfectly
  *  healthy running game. {@link liveCanvasFrame} is the answer for that
@@ -279,7 +279,7 @@ export async function handleBridgeScreenshot(
     // Same seam as the composite leg, for the same reason: a game's own canvas
     // is unreadable this late, so ask for a same-frame copy first and fall back
     // to reading the canvas itself.
-    const frameModule = await import('@volter/editor-core/live-canvas-frame');
+    const frameModule = await import('@volter/editor-sdk/kit/live-canvas-frame');
     const readable =
       frameModule.readablePngSource(await frameModule.liveCanvasFrame(canvas)) ?? canvas;
     const dataUrl = readable.toDataURL('image/png');

package/src/build/BuildProfilesPanel.tsx

@@ -8,9 +8,9 @@
  * build takes real seconds and a modal would block the viewport.
  */
 
-import { workspaceHistoryService } from '@volter/editor-core/components/workspace-history';
-import { getDownloadUrl, readProjectTextFile, saveFile } from '@volter/editor-core/editor-api';
-import { getProjectFileHistory } from '@volter/editor-core/history/project-file-history';
+import { workspaceHistoryService } from '@volter/editor-sdk/kit/components/workspace-history';
+import { getDownloadUrl, readProjectTextFile, saveFile } from '@volter/editor-sdk/kit/editor-api';
+import { getProjectFileHistory } from '@volter/editor-sdk/kit/history/project-file-history';
 import { faGlobe } from '@fortawesome/free-solid-svg-icons';
 import type { BuildReport } from '@volter/editor-sdk/session/build-report';
 import {
@@ -32,6 +32,7 @@ import {
 import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from 'react';
 import {
   type BuildTarget,
+  buildAndRun,
   buildSessionVersion,
   cancelBuild,
   getBuildSession,
@@ -331,6 +332,16 @@ export function BuildProfilesPanel() {
               >
                 {phase === 'done' ? 'Build Again' : 'Build'}
               </Button>
+              <Button
+                data-testid="build-profiles-build-and-run"
+                onClick={() => {
+                  if (!selected) return;
+                  if (phase === 'done') resetBuildSession();
+                  void buildAndRun(selected);
+                }}
+              >
+                Build And Run
+              </Button>
             </>
           )}
         </div>

package/src/build/build-session.ts

@@ -17,6 +17,7 @@ import {
 } from '../host/api/configurations';
 import type { EditorHostOutputDiagnostic } from '@volter/editor-sdk/host';
 import { editorHost } from '@volter/editor-sdk/host';
+import { BASE } from '@volter/editor-sdk/kit/api-base';
 import type { BuildReport } from '@volter/editor-sdk/session/build-report';
 import { useEffect, useState } from 'react';
 import { formatBytes } from './format-bytes';
@@ -34,6 +35,40 @@ export function openBuildProfilesDocument(): boolean {
   return editorHost().workspace.openContributedDocument(BUILD_PROFILES_DOCUMENT_ID);
 }
 
+/** The Build Player document's contribution id (`build-player.document.tsx`). */
+export const BUILD_PLAYER_DOCUMENT_ID = 'build-player.document';
+
+/** Where the editor server serves the project's built `dist/` (`routes/configurations.ts`). */
+export const BUILD_PLAYER_URL = `${BASE}/build/web/index.html`;
+
+let _runs = 0;
+const _runListeners = new Set<() => void>();
+
+/** How many times the build has been run: the player reloads on each. */
+export function buildRunCount(): number {
+  return _runs;
+}
+
+export function subscribeBuildRuns(fn: () => void): () => void {
+  _runListeners.add(fn);
+  return () => {
+    _runListeners.delete(fn);
+  };
+}
+
+/** Run the last build in the Build Player document, fresh. */
+export function runBuild(): boolean {
+  _runs++;
+  for (const fn of _runListeners) fn();
+  return editorHost().workspace.openContributedDocument(BUILD_PLAYER_DOCUMENT_ID);
+}
+
+/** Unity's Build And Run: build, and run the result when the build succeeds. */
+export async function buildAndRun(target: BuildTarget): Promise<void> {
+  await startBuild(target);
+  if (_session.phase === 'done' && _session.result?.ok) runBuild();
+}
+
 /** A build-role configuration's id (ARCHITECTURE-CORE §The project model). */
 export type BuildTarget = string;
 export type BuildPhase = 'idle' | 'building' | 'done';