@volter/editor-game 0.5.69 → 0.5.71

package/contributions/react/react-inspector.service.ts

@@ -8,7 +8,7 @@
  *
  * ## Why this is a package and not the host's
  *
- * It was `packages/editor/src/authoring/react-inspector-section.tsx`,
+ * It was the host's `authoring/react-inspector-section.tsx`,
  * registered at module scope and reached by ONE line in the host's entry:
  * `main.tsx:33`, `import './authoring/react-inspector-section';`. A bare
  * side-effect import has no `from`, so the closure gate's walk never followed
@@ -62,7 +62,7 @@
  * the DOM projection and the CSS inspection estate
  * (`components/RootSelectionOverlay.tsx`); the surgical JSX writer and the
  * structural write pipe (`authoring/r3f-source-authoring-adapter.ts`,
- * `@volter/canvas/pixi-source-write-target.ts`); the breakpoint state
+ * `@volter/editor-game`'s `src/host/authoring/pixi-source-write-target.ts`); the breakpoint state
  * (`components/BoardRulers.tsx`); `authoring/react-story-board.ts`, the
  * board's geometry, which three host surfaces read
  * (`components/RootSelectionOverlay.tsx:98`,

package/package.json

@@ -2,7 +2,7 @@
   "name": "@volter/editor-game",
   "author": "Volter AI, Inc.",
   "license": "AGPL-3.0-only",
-  "version": "0.5.69",
+  "version": "0.5.71",
   "publishConfig": {
     "access": "public"
   },
@@ -101,11 +101,11 @@
     "serving": "./dist-node/serving.mjs"
   },
   "dependencies": {
-    "@volter/editor-sdk": "0.5.69",
-    "@volter/editor-project": "0.5.69",
-    "@volter/editor-threejs": "0.5.69",
-    "@volter/threejs-runtime": "0.5.69",
-    "@volter/game-runtime": "0.5.69",
+    "@volter/editor-sdk": "0.5.71",
+    "@volter/editor-project": "0.5.71",
+    "@volter/editor-threejs": "0.5.71",
+    "@volter/threejs-runtime": "0.5.71",
+    "@volter/game-runtime": "0.5.71",
     "@colyseus/msgpackr": "^1.11.3",
     "@colyseus/schema": "^4.0.14",
     "@colyseus/sdk": "^0.17.34",
@@ -138,7 +138,7 @@
     "xstate": "^5.32.4",
     "zod": "^4.3.6",
     "@fortawesome/fontawesome-svg-core": "^7.2.0",
-    "@volter/editor-react": "0.5.69"
+    "@volter/editor-react": "0.5.71"
   },
   "peerDependencies": {
     "@sparkjsdev/spark": "^2.1.0",

package/src/bridge/screenshot.ts

@@ -6,6 +6,7 @@
  * `@editor/*` alias until those modules move too. Nothing here is host API.
  */
 
+import { getCurrentProject } from '@volter/editor-sdk/kit/active-project';
 import { commandLine } from '@volter/editor-sdk/kit/product-command';
 import {
   type CaptureFlatness,
@@ -230,6 +231,7 @@ export async function handleBridgeScreenshot(
     try {
       const composite = await capturePlayComposite(container, {
         canvasFrame: captureLiveCanvasFrame,
+        projectRoot: getCurrentProject()?.rootPath,
         // The DECLARED medium, from the adapter's region table. `undefined`
         // (no table loaded yet) leaves the compositor-settle heuristic on its
         // own canvas count, exactly as before.

package/src/generation/generation-documents.tsx

@@ -49,7 +49,7 @@ function billingLabel(billing: GenerationBilling): string {
   if (billing.route === 'managed') {
     if (billing.settledCredits !== undefined) return `${billing.settledCredits} credits settled`;
     if (billing.estimatedCredits !== undefined) return `Up to ${billing.estimatedCredits} credits`;
-    return 'VOLTER subscription · estimate unavailable';
+    return 'Volter subscription · estimate unavailable';
   }
   if (billing.settledAmount !== undefined) return `$${billing.settledAmount.toFixed(3)} settled`;
   if (billing.estimatedAmount !== undefined) return `Up to $${billing.estimatedAmount.toFixed(3)}`;

package/src/generation/generation-presentation.ts

@@ -219,7 +219,7 @@ export function generationModelLabel(job: GenerationJob): string {
 }
 
 export function generationRouteLabel(job: GenerationJob): string {
-  if (job.mode === 'managed') return 'VOLTER subscription';
+  if (job.mode === 'managed') return 'Volter subscription';
   if (job.mode === 'direct') return 'Your provider key';
   return 'Mock';
 }

package/src/host/browser-transpile.ts

@@ -213,7 +213,7 @@ function unregisteredRuntimeModules(specifiers: readonly string[]): Error {
       'import to a dependency it ships; a package outside that list needs a dev server. Open ' +
       `the project locally with ${commandLine('edit')} (which resolves the project’s own node_modules), ` +
       'or add the package to a capability so it joins the list ' +
-      '(packages/editor/src/served-bundle-runtime-modules.ts, gated by ' +
+      '(packages/editor-game/src/host/served-bundle-runtime-modules.ts, gated by ' +
       '`npm run validate-browser-runtime-modules`).',
   );
 }

package/src/host/canvas-preview-frames.ts

@@ -17,7 +17,7 @@
  * five callers never had a story in hand (`authoring/canvas-design-mount.ts`,
  * `authoring/pixi-still-presentation.ts`, `components/world-root-stage.ts`,
  * `live-canvas-frame.ts`, and the ingest lane's canvas mount); moving it out is
- * the part of the CSF estate's exit to `@volter/game` (WORK.md §The open-source
+ * the part of the CSF estate's exit to `@volter/editor-game` (WORK.md §The open-source
  * launch, phase 1 unit 3) that does not wait on anything else.
  */
 

package/src/host/game-location-guard.ts

@@ -145,6 +145,6 @@ export function refusedNavigationMessage(attempt: string): string {
     `Ingested game attempted to navigate the editor away (${attempt}) — refused. ` +
     "A game running in-realm shares the editor's document, so leaving it would take the " +
     'whole session with it; game code sees a scoped `location` facade whose reads pass ' +
-    'through and whose navigating writes do not (packages/editor/src/game-location-guard.ts).'
+    'through and whose navigating writes do not (packages/editor-game/src/host/game-location-guard.ts).'
   );
 }

package/src/host/playwright-shim.ts

@@ -61,7 +61,7 @@ export class PageShimUnsupportedError extends Error {
       `playwright-shim: ${objectName}.${member} is not supported by the in-page shim. ` +
         `Supported ${objectName} members: ${supported.join(', ')}. ` +
         'This shim is DOM-only — canvas gameplay input must use game.input.*, while React-only ' +
-        'DOM games may use Page keyboard/locator input. See packages/editor/src/playwright-shim.ts for ' +
+        'DOM games may use Page keyboard/locator input. See packages/editor-game/src/host/playwright-shim.ts for ' +
         "the full supported subset and the wire's closure-capture limitation.",
     );
     this.name = 'PageShimUnsupportedError';

package/src/ingest/mount-ingest-root.ts

@@ -719,7 +719,7 @@ if (import.meta.env.DEV && typeof window !== 'undefined') {
     isActive: () => activeIngest()?.kind === 'dom',
   };
   // Headless-readable mount outcomes —
-  // `packages/editor/src/authoring/mount-failure-report.ts`'s multi-entry
+  // `packages/editor-sdk/src/kit/mount-failure-report.ts`'s multi-entry
   // list is otherwise only ever read by the status bar's `mount-failure`
   // contribution (a React component), invisible to `page.evaluate()`. This is
   // a plain function returning the LIVE list — a probe's browser

package/src/play/play-mode.ts

@@ -1306,7 +1306,7 @@ export function resizeGame(width: number, height: number, pixelRatio?: number):
  * size exceeded` — not a hypothetical). In the field this window is entered
  * whenever a caller re-issues `play` before the browser has acked the first
  * (a slow scene boot outliving the relay's/SDK's own `play.start` timeout is
- * the documented trigger — `packages/volter-sdk/src/play/transport.ts`'s
+ * the documented trigger — `packages/editor-sdk/src/transport.ts`'s
  * `PLAY_START_TIMEOUT_MS`/`editor-server.ts`'s `PLAY_COMMAND_TIMEOUT_MS` —
  * and `play.start`'s own contract is explicitly "start (or restart)", so a
  * caller retrying after a timeout is using the API as documented, not

package/src/runtime/adapter/audio-meter.ts

@@ -2,7 +2,7 @@
  * Meter arithmetic over an `AudioAdapter`'s `AudioMeterFrame.level` — the one
  * place a linear RMS level becomes dBFS and a bar fill. Lives beside the
  * adapter because both readers of a level (the editor's header meter and the
- * `@volter/game` audio debugger) are consumers of the adapter, and neither may
+ * `@volter/editor-game` audio debugger) are consumers of the adapter, and neither may
  * import the other.
  */
 

package/src/runtime/create-runtime.ts

@@ -561,7 +561,7 @@ async function mountOneThreeRoot(
  *  pinned to the mount-time `w`/`h` (same as three, until PIXI's own
  *  construction-time resize runs), it self-heals the moment ANY real
  *  `session.resize(rw, rh)` fires — every shipped standalone entry
- *  (`packages/editor/template/src/main.ts`, `examples/tri-world/src/main.ts`)
+ *  (`packages/game-editor/template/src/main.ts`, `examples/tri-world/src/main.ts`)
  *  already calls `session.resize()` unconditionally right after mount, so
  *  this never surfaces as a lasting bug the way three' buffer-only resize
  *  did (never self-healing, by design — see above). */

package/src/runtime/debug-bridge.ts

@@ -7,7 +7,7 @@
  * boot still only ever gets a handle when the gate below actually passes).
  *
  * D17: this is door (a) of the seam's three doors — the SAME `DebugAdapter`
- * names/JSON the editor relay (door b) and `@volter/live` (door c, which
+ * names/JSON the editor relay (door b) and `@volter/game-live` (door c, which
  * drives door (a) itself over Playwright) all read. D18: the bridge installs
  * only when the page opts in (`?volter-debug=1`) AND is either a dev build
  * (`import.meta.env.DEV`) or the project's manifest explicitly opts a
@@ -148,7 +148,7 @@ export interface VolterDebugHandle {
    * (`DebugRegistry.registerWorldSettledProbe`, declared by the game's `debug.settled` entry
    * export) — so a tick never races a scene remount's async commit, and WHICH tick first runs
    * a freshly reloaded world is a function of the sim rather than wall timing. Session tick
-   * drivers (`@volter/live`'s fastForward) prefer this door; with no probe registered it behaves
+   * drivers (`@volter/game-live`'s fastForward) prefer this door; with no probe registered it behaves
    * exactly like {@link runTicks}. Bounded: throws `WORLD_UNSETTLED_TIMEOUT` if a probe never
    * settles.
    */
@@ -159,7 +159,7 @@ export interface VolterDebugHandle {
    * this is the honest human-input-path proof) → `input.clearVirtualActions()`
    * into ONE async bridge call, as a TOP-LEVEL method (not under `input`)
    * because it needs the sim clock, not just the input target. Was 15+
-   * transport round trips over the editor relay (`@volter/live`'s old
+   * transport round trips over the editor relay (`@volter/game-live`'s old
    * `GameInput.hold`: set → a 150ms-interval `waitSimTime` snapshot poll loop
    * → clear); now one `page.evaluate`/relay call that runs the wait
    * in-process on the page.
@@ -231,13 +231,13 @@ export interface MaybeInstallDebugBridgeOptions {
 const PAGE_ERROR_CAP = 100;
 
 /** `holdFor`'s in-process poll interval — this loop never leaves the page
- *  (no transport round trip per poll, unlike `@volter/live`'s old
+ *  (no transport round trip per poll, unlike `@volter/game-live`'s old
  *  `waitSimTime`), so it can afford to be tighter than that loop's 150ms. */
 const HOLD_FOR_POLL_MS = 50;
 
 /** Consecutive `HOLD_FOR_POLL_MS` polls with the tick unchanged before
  *  `holdFor` gives up waiting and treats the game as stopped — mirrors
- *  `@volter/live`'s `WAIT_FOR_STALL_POLL_LIMIT` reasoning (`wait-for.ts`:
+ *  `@volter/game-live`'s `WAIT_FOR_STALL_POLL_LIMIT` reasoning (`wait-for.ts`:
  *  a genuinely frozen sim clock must never poll forever), scaled to this
  *  faster in-process interval so the wall-clock grace period (~5s) lands in
  *  the same neighborhood. */

package/src/runtime/debug-registry.ts

@@ -107,7 +107,7 @@ export interface DebugCtxSurface {
 
 /** Engine-local error for the debug seam — mirrors the `code` + `data` shape
  *  `packages/volter-sdk/src/errors.ts` uses (no import: the engine does not
- *  depend on `@volter/sdk`). `code` is always machine-readable; nothing reading
+ *  depend on the SDK). `code` is always machine-readable; nothing reading
  *  this error may key off `message` prose. */
 export class DebugError extends Error {
   readonly code: string;
@@ -200,7 +200,7 @@ export interface InputTraceSnapshot {
  *  (`runtime/game.ts`, D15/T-D15.3-.4) for full semantics. Named here (not
  *  re-declared per-caller) so the bridge (`runtime/debug-bridge.ts`), the
  *  editor relay (`command-listener.ts`'s `run-ticks` case), and
- *  `play.runTicks` (`@volter/sdk`) all reference the SAME type. */
+ *  `play.runTicks` (the SDK) all reference the SAME type. */
 export interface RunTicksOptions {
   /** `'last'` (default) — skip `preRender`/`render` for every tick except
    *  the final one. `'all'` — render every tick. `'none'` — never render,

package/src/runtime/mount-manifest.ts

@@ -250,7 +250,7 @@ export function resolveManifest(raw: unknown): ResolvedGameManifest {
 
 // ---------------------------------------------------------------------------
 // Per-kind entry -> adapter resolution (mirrors `resolveRootBinding`'s
-// per-identity dispatch, `packages/editor/src/binding-resolver.ts`)
+// per-identity dispatch, `packages/editor-game/src/host/binding-resolver.ts`)
 // ---------------------------------------------------------------------------
 
 function resolveThreeAdapter(