@volter/editor-game 0.5.65 → 0.5.67

package/dist-node/serving.mjs

@@ -0,0 +1,16 @@
+// serving/index.ts
+import { fileURLToPath } from "node:url";
+var GAME_MODULE_ACCESS = "@editor/game-module-access";
+var ALIASED_GAME_MODULE_ACCESS = /\/editor-core\/src\/game-module-access$/;
+var servingPlugins = (_services) => [
+  {
+    name: "volter-editor-game:game-module-access",
+    enforce: "pre",
+    resolveId(id) {
+      return id === GAME_MODULE_ACCESS || ALIASED_GAME_MODULE_ACCESS.test(id) ? fileURLToPath(new URL("../src/host/game-module-access.ts", import.meta.url)) : null;
+    }
+  }
+];
+export {
+  servingPlugins
+};

package/package.json

@@ -2,7 +2,7 @@
   "name": "@volter/editor-game",
   "author": "Volter AI, Inc.",
   "license": "AGPL-3.0-only",
-  "version": "0.5.65",
+  "version": "0.5.67",
   "publishConfig": {
     "access": "public"
   },
@@ -15,14 +15,20 @@
   },
   "files": [
     "src",
+    "serving",
     "contributions",
+    "dist-node",
     "LICENSE",
     "NOTICE"
   ],
   "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": [
@@ -31,6 +37,7 @@
       "./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",
@@ -51,6 +58,8 @@
       "./contributions/gameplay.command.ts",
       "./contributions/generation.service.ts",
       "./contributions/generations.status.tsx",
+      "./contributions/godot.style.ts",
+      "./contributions/godot.view.ts",
       "./contributions/ingest.service.ts",
       "./contributions/instances.command.ts",
       "./contributions/navmesh.menu.ts",
@@ -66,13 +75,14 @@
       "./contributions/state-watch.utility.tsx",
       "./contributions/team-playtest.service.ts",
       "./contributions/transport.header.tsx",
-      "./contributions/xstate-behavior.action.ts",
-      "./contributions/xstate-behavior.document.tsx",
-      "./contributions/xstate-behavior.inspector.tsx",
-      "./contributions/xstate-behavior.menu.ts",
+      "./contributions/unity.style.ts",
+      "./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/pasteboard.action.ts",
       "./contributions/react/react-inspector.service.ts",
       "./contributions/react/story-documents.service.ts",
       "./contributions/three/camera-runtime.inspector.tsx",
@@ -83,16 +93,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.65",
-    "@volter/editor-sdk": "0.5.65",
-    "@volter/editor-project": "0.5.65",
-    "@volter/editor-threejs": "0.5.65",
-    "@volter/threejs-runtime": "0.5.65",
-    "@volter/game-runtime": "0.5.65",
+    "@volter/editor-sdk": "0.5.67",
+    "@volter/editor-project": "0.5.67",
+    "@volter/editor-threejs": "0.5.67",
+    "@volter/threejs-runtime": "0.5.67",
+    "@volter/game-runtime": "0.5.67",
+    "@colyseus/msgpackr": "^1.11.3",
     "@colyseus/schema": "^4.0.14",
     "@colyseus/sdk": "^0.17.34",
     "@fortawesome/free-solid-svg-icons": "^7.2.0",
@@ -106,6 +119,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",
@@ -122,7 +136,8 @@
     "recast-navigation": "^0.43.0",
     "xstate": "^5.32.4",
     "zod": "^4.3.6",
-    "@fortawesome/fontawesome-svg-core": "^7.2.0"
+    "@fortawesome/fontawesome-svg-core": "^7.2.0",
+    "@volter/editor-react": "0.5.67"
   },
   "peerDependencies": {
     "@sparkjsdev/spark": "^2.1.0",
@@ -134,6 +149,8 @@
     "@playwright/test": "^1.58.2"
   },
   "scripts": {
+    "build": "node scripts/build-serving.mjs",
+    "prepack": "npm run build",
     "typecheck": "tsc -p tsconfig.json"
   },
   "peerDependenciesMeta": {

package/serving/index.ts

@@ -0,0 +1,27 @@
+/**
+ * `@volter/editor-game`'s server half (`package.json#vgai.serving`): the one deep specifier a
+ * game's own contributions name, `@editor/game-module-access` (the template's
+ * `src/contributions/use-game-modules.ts`), resolved to this package's module. The page
+ * bundle maps the same specifier for its own copy (`src/host/served-bundle-runtime-modules.ts`);
+ * a contribution the session's Vite serves needs the file.
+ */
+
+import { fileURLToPath } from 'node:url';
+import type { ProjectServingServices } from '@volter/editor-sdk/session/project-serving';
+
+const GAME_MODULE_ACCESS = '@editor/game-module-access';
+/** The kit's `@editor/*` alias runs before any plugin and rewrites the specifier to the kit's
+ *  own `src/`, where this module no longer lives; that form is this package's too. */
+const ALIASED_GAME_MODULE_ACCESS = /\/editor-core\/src\/game-module-access$/;
+
+export const servingPlugins = (_services: ProjectServingServices): readonly unknown[] => [
+  {
+    name: 'volter-editor-game:game-module-access',
+    enforce: 'pre',
+    resolveId(id: string): string | null {
+      return id === GAME_MODULE_ACCESS || ALIASED_GAME_MODULE_ACCESS.test(id)
+        ? fileURLToPath(new URL('../src/host/game-module-access.ts', import.meta.url))
+        : null;
+    },
+  },
+];

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

@@ -21,8 +21,8 @@
  * raw attribute/index bytes for geometry.
  */
 
-import { sha256Hex } from '@volter/editor-core/bytes-codec';
-import type { StorageBackend } from '@volter/editor-core/storage/types';
+import { sha256Hex } from '@volter/editor-sdk/kit/bytes-codec';
+import { isPublicRootedBackend, type StorageBackend } from '@volter/editor-sdk/kit/storage-types';
 import type { Document } from '@gltf-transform/core';
 import { inspect } from '@gltf-transform/functions';
 import { getGltfIO } from './gltf-io';
@@ -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
@@ -482,7 +482,7 @@ export async function collectProjectBudgetSource(
   // `/vgai.project.json` (`manifest-project.ts`) and the `.vgai/`-scoped
   // `/__editor/vgai-file` route (`project-provenance.ts`). Anything
   // unavailable stays honestly absent — no fabricated owners or stamps.
-  if (backend.id === 'http') {
+  if (isPublicRootedBackend(backend)) {
     const ownerFiles: AssetBudgetFile[] = [];
     const virtualTexts = new Map<string, string>();
     try {

package/src/asset-budget/optimize-apply.ts

@@ -20,11 +20,11 @@
  * happened, so the failure is returned for the UI to surface.
  */
 
-import { sha256Hex } from '@volter/editor-core/bytes-codec';
-import { assertEditorServerAnswered } from '@volter/editor-core/editor-server-response';
-import { sourceMutationAttribution } from '@volter/editor-core/editor-session-attribution';
-import { handleProjectMutationFailure } from '@volter/editor-core/source-conflict';
-import type { StorageBackend } from '@volter/editor-core/storage/types';
+import { sha256Hex } from '@volter/editor-sdk/kit/bytes-codec';
+import { assertEditorServerAnswered } from '@volter/editor-sdk/kit/editor-server-response';
+import { sourceMutationAttribution } from '@volter/editor-sdk/kit/editor-session-attribution';
+import { handleProjectMutationFailure } from '@volter/editor-sdk/kit/source-conflict';
+import { isPublicRootedBackend, type StorageBackend } from '@volter/editor-sdk/kit/storage-types';
 import { invalidateCachedAsset } from '@volter/threejs-runtime/asset-loaders';
 
 const PROVENANCE_PATH = '.vgai/provenance.json';
@@ -82,7 +82,7 @@ function ledgerAssetPath(storagePath: string): string {
  * backend reaches the project root directly.
  */
 async function readLedgerText(backend: StorageBackend): Promise<string | null> {
-  if (backend.id === 'http') {
+  if (isPublicRootedBackend(backend)) {
     // NOT read through `editor-server-response.ts`: the GET half of this route
     // answers `text/plain` (routes/project-source.ts) because it serves raw
     // file bytes, and that reader's whole rule is "the editor server answers
@@ -99,7 +99,7 @@ async function readLedgerText(backend: StorageBackend): Promise<string | null> {
 }
 
 async function writeLedgerText(backend: StorageBackend, content: string): Promise<void> {
-  if (backend.id === 'http') {
+  if (isPublicRootedBackend(backend)) {
     const write = async () => {
       const res = await fetch('/__editor/vgai-file', {
         method: 'POST',

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-core/coverage/live-seam-evidence';
-import { systemAdapterEpoch } from '@volter/editor-core/coverage/system-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

@@ -6,15 +6,15 @@
  * `@editor/*` alias until those modules move too. Nothing here is host API.
  */
 
-import { commandLine } from '@volter/editor-core/product-command';
+import { commandLine } from '@volter/editor-sdk/kit/product-command';
 import {
   type CaptureFlatness,
   CaptureLayerError,
   capturePlayComposite,
   sampleFlatness,
-} from '@volter/editor-core/composite-screenshot';
-import { editorConsole } from '@volter/editor-core/editor-console';
-import { presentationSurface } from '@volter/editor-core/presentation-surface';
+} 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';
 import { notPlayingResult, structuredErrorResult } from '../command-results';
 import { isIngestActive } from '../ingest/active-ingest';
@@ -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 {