@volter/editor-game 0.5.65

package/contributions/three/three-authoring.service.ts

@@ -0,0 +1,66 @@
+/**
+ * THE THREE SURFACE'S DESIGN-TIME AUTHORING (`@volter/editor-sdk/services`, a
+ * `workspace.service` contribution): the two registrations that make a `three`
+ * root editable, and the reason the kit names no medium.
+ *
+ *  1. THE LIVE ADAPTER for a declared `three` world
+ *     (`@editor/authoring/active-adapter`'s `setBaseAuthoringFactory`). The
+ *     edit-mode installer used to build this one adapter itself, by picking
+ *     the project's three root by name; it asks by SURFACE now, and a world
+ *     whose surface nobody claims keeps its honest Boundary disclosure.
+ *  2. THE DESIGN SESSION on the world root's 3D stage
+ *     (`@editor/authoring/design-time-mount-registry`'s `kind: 'three'`),
+ *     beside `@volter/editor-game`'s `kind: 'dom'` and the canvas medium's. Those two
+ *     mount into a LAYER over the artboard; this one adopts the stage's own
+ *     renderer and scene, which is why the registry carries two mount shapes.
+ *
+ * ARRIVING LATE IS ORDINARY. The contribution pass is deferred behind the
+ * first viewport frame, so the edit-mode composite is routinely installed
+ * before this runs. `queueEditModeRebuild()` is the kit's own door for that —
+ * the same one a source change uses — so the adapter seam needs no
+ * notification of its own, and the stage's mount is re-asked on the rebuild.
+ *
+ * THE SESSION CHUNK IS WARMED HERE, at registration, because the stage used
+ * to warm it when it began building and the wait it hides is real. Only a
+ * 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 { authoringJournal } from '../../src/host/history/json-history-resource';
+import { oidThree } from '../../src/three/authoring/three-authoring-adapter';
+
+export const point = 'workspace.service';
+
+export function start(): () => void {
+  // Warm the session chunk with the pass, not with the first mount.
+  const session = import('../../src/three/authoring/r3f-design-session');
+  void session.catch(() => {
+    // The mount below awaits the same promise and reports its own failure;
+    // this early start must not create a second unhandled rejection.
+  });
+  const stopFactory = setBaseAuthoringFactory('three', (store, worldId) =>
+    // The store's scene is the subject: whatever has been mounted into it (the
+    // 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)),
+  );
+  const stopMount = registerDesignTimeMount({
+    kind: 'three',
+    owner: '@volter/editor-game/three/three-authoring',
+    mountWorldRootSession: async (context) => {
+      const { mountR3FDesignSession } = await session;
+      return mountR3FDesignSession(context.store, context.composite, context.renderer);
+    },
+  });
+  // The composite that is already installed was built before this package's
+  // factory existed, so its three world is a Boundary node. Ask for the one
+  // rebuild that turns it live.
+  queueEditModeRebuild();
+  return () => {
+    stopMount();
+    stopFactory();
+  };
+}

package/contributions/transport.header.tsx

@@ -0,0 +1,19 @@
+/**
+ * The Play TRANSPORT in the project header (`@volter/editor-sdk/chrome`, a
+ * `workspace.header` contribution): play, pause, step, restart, stop, the
+ * run-configuration picker and the instance count. Only for a project that
+ * declares something to run (ARCHITECTURE-CORE §Roots); a folder of models
+ * renders nothing here.
+ */
+import { editorHost } from '@volter/editor-sdk/host';
+import { useSyncExternalStore } from 'react';
+import { PlayBar } from '../src/play-bar/PlayBar';
+
+export const point = 'workspace.header';
+export const order = 0;
+
+export default function TransportHeader() {
+  const { project } = editorHost();
+  const mounts = useSyncExternalStore(project.subscribe, project.mounts, project.mounts);
+  return mounts ? <PlayBar /> : null;
+}

package/contributions/xstate-behavior.action.ts

@@ -0,0 +1,42 @@
+/**
+ * The Behavior debugger's palette actions (`@volter/editor-sdk/chrome`, a
+ * `workspace.action` contribution) — a LIVE set: `Inspect Behavior` (the
+ * first truthful live actor, the same reveal as Debug ▸ Inspect Behavior)
+ * plus one `Inspect Behavior: <machine>` per running XState actor. The host
+ * asks `actions` when the palette opens and re-lists on `subscribe`: an
+ * actor registering or a hierarchy change (any shell-store notification, so
+ * the listing walks the object map only while a palette is open).
+ */
+
+import type { ActionContribution } from '@volter/editor-sdk/chrome';
+import { editorHost } from '@volter/editor-sdk/host';
+import { subscribeXStateBehaviorInspections } from '@volter/threejs-runtime/behavior/xstate-inspection';
+import {
+  listLiveBehaviors,
+  openBehaviorDocument,
+  openFirstBehaviorDocument,
+} from '../src/xstate/live-behaviors';
+
+export const point = 'workspace.action';
+
+export const actions: ActionContribution['actions'] = () => [
+  {
+    id: 'inspect-behavior',
+    label: 'Inspect Behavior',
+    execute: () => void openFirstBehaviorDocument(),
+  },
+  ...listLiveBehaviors().map((entry) => ({
+    id: `xstate-machine:${entry.machineId}:${entry.nodeId}`,
+    label: `Inspect Behavior: ${entry.machineId}`,
+    execute: () => void openBehaviorDocument(entry.nodeId),
+  })),
+];
+
+export const subscribe: ActionContribution['subscribe'] = (listener) => {
+  const stopInspections = subscribeXStateBehaviorInspections(listener);
+  const stopHierarchy = editorHost().hierarchy.subscribe(listener);
+  return () => {
+    stopInspections();
+    stopHierarchy();
+  };
+};

package/contributions/xstate-behavior.document.tsx

@@ -0,0 +1,73 @@
+/**
+ * THE BEHAVIOR DOCUMENT (`workspace.document`): the REAL live actor of the
+ * machine you asked to inspect, drawn as its graph — the same asset-document
+ * pattern the animation and model editors use, inspect-only.
+ *
+ * Its subject is `live-behaviors.ts`'s (`openBehaviorDocument(nodeId)` sets it
+ * and opens this tab, from the section's button, the Debug menu and each
+ * `Inspect Behavior: <id>` palette action). With no live actor for that node —
+ * the game stopped, the actor detached — the document says so rather than
+ * drawing a machine nothing is running.
+ *
+ * No `tool`: it drives no registered callable.
+ */
+
+import type { ToolContributionProps, ToolDocumentToolbar } from '@volter/editor-sdk/contributions';
+import {
+  subscribeXStateBehaviorInspections,
+  xstateBehaviorInspectionsVersion,
+} from '@volter/threejs-runtime/behavior/xstate-inspection';
+import { useSyncExternalStore } from 'react';
+import {
+  behaviorSubject,
+  behaviorSubjectVersion,
+  liveBehaviorFor,
+  subscribeBehaviorSubject,
+} from '../src/xstate/live-behaviors';
+import { XStateMachineInspector } from '../src/xstate/XStateMachineInspector';
+
+export const point = 'workspace.document';
+export const title = 'Behavior';
+
+/** Re-render on both live facts this document draws: which node it is on, and
+ *  whether that node still carries an inspection. */
+function useSubjectBehavior() {
+  useSyncExternalStore(subscribeBehaviorSubject, behaviorSubjectVersion, behaviorSubjectVersion);
+  useSyncExternalStore(
+    subscribeXStateBehaviorInspections,
+    xstateBehaviorInspectionsVersion,
+    xstateBehaviorInspectionsVersion,
+  );
+  const nodeId = behaviorSubject();
+  return nodeId ? liveBehaviorFor(nodeId) : undefined;
+}
+
+/** The document's header, in the host's own strip: which machine, and that it
+ *  is a live actor you may read but not edit. */
+export const Toolbar: ToolDocumentToolbar = () => {
+  const behavior = useSubjectBehavior();
+  return (
+    <span data-testid="xstate-behavior-toolbar" style={{ fontSize: 11 }}>
+      {behavior ? `${behavior.machine.id} · Live actor · inspect-only` : 'Behavior unavailable'}
+    </span>
+  );
+};
+
+export default function XStateBehaviorDocument(_props: ToolContributionProps) {
+  const behavior = useSubjectBehavior();
+  return (
+    <div className="vgai-behavior-document" data-testid="xstate-behavior-document">
+      {behavior ? (
+        <XStateMachineInspector
+          machine={behavior.machine}
+          actor={behavior.actor}
+          title={behavior.machine.id}
+        />
+      ) : (
+        <div className="vgai-behavior-document__empty">
+          This live behavior is no longer registered.
+        </div>
+      )}
+    </div>
+  );
+}

package/contributions/xstate-behavior.inspector.tsx

@@ -0,0 +1,28 @@
+/**
+ * The Behavior Inspector section (`selection.inspector`, §4.3): the machine a
+ * selected entity is actually running.
+ *
+ * `match` reads the hierarchy door for the node's own live inspection mark, so
+ * it matches ONLY a real live actor — a template entity (no machine) never
+ * matches, and the section cannot render for it.
+ */
+import type {
+  ToolContributionNode,
+  ToolInspectorContributionProps,
+} from '@volter/editor-sdk/contributions';
+import { liveBehaviorFor } from '../src/xstate/live-behaviors';
+import { XStateMachineSection } from '../src/xstate/XStateBehaviorSection';
+
+export const point = 'selection.inspector';
+export const title = 'Behavior';
+/** Where the host registered it before the move: the contributed band's own
+ *  base, ahead of modules that claim no place. */
+export const order = 0;
+
+export function match(node: ToolContributionNode | null): boolean {
+  return node !== null && liveBehaviorFor(node.id) !== undefined;
+}
+
+export default function XStateBehaviorInspector({ nodeId }: ToolInspectorContributionProps) {
+  return <XStateMachineSection nodeId={nodeId} />;
+}

package/contributions/xstate-behavior.menu.ts

@@ -0,0 +1,23 @@
+/**
+ * Debug ▸ Inspect Behavior — opens the first truthful live actor as the
+ * Behavior document. Disabled while no live actor is registered, which is the
+ * same predicate the open path itself refuses on; `disabled` is asked at
+ * render, so it follows the session.
+ */
+import type { MenuContribution } from '@volter/editor-sdk/chrome';
+import { listLiveBehaviors, openFirstBehaviorDocument } from '../src/xstate/live-behaviors';
+
+export const point = 'workspace.menu';
+
+export const menu: MenuContribution = {
+  menu: 'debug',
+  items: [
+    {
+      id: 'inspect-behavior',
+      label: 'Inspect Behavior',
+      testId: 'menu-inspect-behavior',
+      disabled: () => listLiveBehaviors().length === 0,
+      execute: () => void openFirstBehaviorDocument(),
+    },
+  ],
+};

package/package.json

@@ -0,0 +1,144 @@
+{
+  "name": "@volter/editor-game",
+  "author": "Volter AI, Inc.",
+  "license": "AGPL-3.0-only",
+  "version": "0.5.65",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "The game side of Volter Editor: play, the game document, build, ingest, instruments over a running game, and the three.js and React/DOM authoring surfaces.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/volter-ai/editor.git",
+    "directory": "packages/editor-game"
+  },
+  "files": [
+    "src",
+    "contributions",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "exports": {
+    "./contributions/*": "./contributions/*",
+    "./*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "vgai": {
+    "contributions": [
+      "./contributions/asset-budget-asset.menu.ts",
+      "./contributions/asset-budget.action.ts",
+      "./contributions/asset-budget.document.tsx",
+      "./contributions/asset-budget.menu.ts",
+      "./contributions/audio-unlock.service.ts",
+      "./contributions/audio.utility.tsx",
+      "./contributions/autoplay.service.ts",
+      "./contributions/bridge.command.ts",
+      "./contributions/build-profiles.document.tsx",
+      "./contributions/build-progress.status.tsx",
+      "./contributions/build.action.ts",
+      "./contributions/build.command.ts",
+      "./contributions/build.header.tsx",
+      "./contributions/build.menu.ts",
+      "./contributions/build.service.ts",
+      "./contributions/connection.status.tsx",
+      "./contributions/coverage.service.ts",
+      "./contributions/edit-mode-audio.service.ts",
+      "./contributions/edit-mode-networking.service.ts",
+      "./contributions/game-document.service.ts",
+      "./contributions/game-eval.command.ts",
+      "./contributions/game.layout.ts",
+      "./contributions/gameplay.command.ts",
+      "./contributions/generation.service.ts",
+      "./contributions/generations.status.tsx",
+      "./contributions/ingest.service.ts",
+      "./contributions/instances.command.ts",
+      "./contributions/navmesh.menu.ts",
+      "./contributions/navmesh.service.ts",
+      "./contributions/network.utility.tsx",
+      "./contributions/play.command.ts",
+      "./contributions/profiler.action.ts",
+      "./contributions/profiler.menu.ts",
+      "./contributions/profiler.utility.tsx",
+      "./contributions/scene-document.service.ts",
+      "./contributions/state-watch.action.ts",
+      "./contributions/state-watch.menu.ts",
+      "./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/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",
+      "./contributions/three/component-board.service.ts",
+      "./contributions/three/component-verbs.command.ts",
+      "./contributions/three/component-verbs.service.ts",
+      "./contributions/three/constraints.inspector.tsx",
+      "./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"
+    ]
+  },
+  "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",
+    "@colyseus/schema": "^4.0.14",
+    "@colyseus/sdk": "^0.17.34",
+    "@fortawesome/free-solid-svg-icons": "^7.2.0",
+    "@gltf-transform/core": "^4.4.1",
+    "@gltf-transform/extensions": "^4.4.1",
+    "@gltf-transform/functions": "^4.4.2",
+    "@react-three/drei": "^10.7.7",
+    "@react-three/fiber": "^9.6.1",
+    "@storybook/react": "10.6.0",
+    "axe-core": "^4.12.1",
+    "draco3d": "^1.5.7",
+    "esbuild-wasm": "0.25.12",
+    "fastnoise-lite": "^1.1.1",
+    "mediabunny": "1.56.2",
+    "meshoptimizer": "^1.2.0",
+    "three": "^0.180.0",
+    "three-bvh-csg": "^0.0.18",
+    "three-mesh-bvh": "^0.9.12",
+    "troika-three-text": "^0.52.4",
+    "pixi.js": "^8.6.0",
+    "es-module-lexer": "^1.7.0",
+    "postprocessing": "6.38.3",
+    "@dimforge/rapier2d-compat": "^0.14.0",
+    "@dimforge/rapier3d-compat": "^0.14.0",
+    "@pixi/react": "8.0.5",
+    "@react-three/rapier": "2.2.0",
+    "recast-navigation": "^0.43.0",
+    "xstate": "^5.32.4",
+    "zod": "^4.3.6",
+    "@fortawesome/fontawesome-svg-core": "^7.2.0"
+  },
+  "peerDependencies": {
+    "@sparkjsdev/spark": "^2.1.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@playwright/test": ">=1.58"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.58.2"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json"
+  },
+  "peerDependenciesMeta": {
+    "@playwright/test": {
+      "optional": true
+    }
+  }
+}