@volter/editor-game 0.5.68 → 0.5.70

package/src/three/authoring/model-asset-inspector-section.css

@@ -2,40 +2,40 @@
    action slot — every projection heads a section the same way — so a block's
    verb sits at the top of its BODY, where it reads identically in the card
    and the column. */
-.vgai-model-inspector-actions {
+.volter-model-inspector-actions {
   display: flex;
   justify-content: flex-end;
-  padding: var(--vgai-space-2) var(--vgai-space-3) 0;
+  padding: var(--volter-space-2) var(--volter-space-3) 0;
 }
 
-.vgai-model-inspector-row > div {
+.volter-model-inspector-row > div {
   display: grid;
   min-width: 0;
 }
 
-.vgai-model-inspector-list {
+.volter-model-inspector-list {
   display: grid;
   max-height: 360px;
-  gap: var(--vgai-space-2);
+  gap: var(--volter-space-2);
   overflow: auto;
 }
 
-.vgai-model-inspector-row {
+.volter-model-inspector-row {
   display: grid;
   grid-template-columns: minmax(0, 1fr) auto;
   align-items: center;
-  gap: var(--vgai-space-3);
-  padding: var(--vgai-space-3);
+  gap: var(--volter-space-3);
+  padding: var(--volter-space-3);
 }
 
-.vgai-model-inspector-row:has(.vgai-model-material-swatch) {
+.volter-model-inspector-row:has(.volter-model-material-swatch) {
   grid-template-columns: auto minmax(0, 1fr) auto;
 }
 
-.vgai-model-material-swatch {
-  width: var(--vgai-control-default-height);
-  height: var(--vgai-control-default-height);
-  border: var(--vgai-stroke-resting) solid var(--vgai-boundary-strong);
-  border-radius: var(--vgai-radius-sm);
-  background-color: var(--vgai-surface-inset);
+.volter-model-material-swatch {
+  width: var(--volter-control-default-height);
+  height: var(--volter-control-default-height);
+  border: var(--volter-stroke-resting) solid var(--volter-boundary-strong);
+  border-radius: var(--volter-radius-sm);
+  background-color: var(--volter-surface-inset);
 }

package/src/three/authoring/model-asset-inspector-section.tsx

@@ -329,11 +329,11 @@ function MaterialsBody({
           />
         </FieldRow>
       </FieldGroup>
-      <div className="vgai-model-inspector-list">
+      <div className="volter-model-inspector-list">
         {materials.map(({ material, rowKey }) => (
-          <EditorSurface key={rowKey} variant="raised" border className="vgai-model-inspector-row">
+          <EditorSurface key={rowKey} variant="raised" border className="volter-model-inspector-row">
             <span
-              className="vgai-model-material-swatch"
+              className="volter-model-material-swatch"
               style={{ background: material.color ?? undefined }}
               aria-hidden="true"
             />
@@ -381,7 +381,7 @@ function SourceBody({
   return (
     <>
       {sourceContribution ? (
-        <div className="vgai-model-inspector-actions">
+        <div className="volter-model-inspector-actions">
           <Button
             type="button"
             variant="ghost"
@@ -583,16 +583,16 @@ function NativeMaterialsBody({
   readonly materials: Object3DNodeInspection['materials'];
 }) {
   return (
-    <div className="vgai-model-inspector-list">
+    <div className="volter-model-inspector-list">
       {materials.map((material) => (
         <EditorSurface
           key={material.id}
           variant="raised"
           border
-          className="vgai-model-inspector-row"
+          className="volter-model-inspector-row"
         >
           <span
-            className="vgai-model-material-swatch"
+            className="volter-model-material-swatch"
             style={{ background: material.color ?? undefined }}
             aria-hidden="true"
           />

package/src/three/authoring/r3f-design-session.ts

@@ -43,13 +43,13 @@ import { onAssetReload } from '@volter/editor-sdk/kit/project-asset-refresh';
  *    registered — through the SAME `setActiveSystems` door play/ingest/module
  *    modes use, under the UNNAMED (solo) seat. That is what lets the relay
  *    answer `list-gameplay-state`/`inspect-gameplay-state`/
- *    `list-debug-commands`/`invoke-debug-command` and `vgai eval`'s
+ *    `list-debug-commands`/`invoke-debug-command` and `volter-game-editor eval`'s
  *    `game.state()`/`game.commands()` from the EDIT world. It publishes
  *    declarations, never a run: the loop is still never advanced.
  *  - SHARERS: none, ever, at the same instant. Play mode registers its mount
  *    under its OWN mount id, so a seat held by both would make
  *    `systemsForInstance(undefined)` ambiguous and break every unaddressed
- *    `vgai eval` call. The store subscription below therefore withdraws this
+ *    `volter-game-editor eval` call. The store subscription below therefore withdraws this
  *    seat the moment `playState` leaves 'stopped' — synchronously, at
  *    `store.setPlayState('playing')`, long before play's own
  *    `setActiveSystems` lands — and republishes when play ends without a
@@ -321,7 +321,7 @@ function rebuildWhenPlayStops(store: EditorShellStore): () => void {
  *   - source write-back posted to `/__ui-source/*` →
  *     the session's recorder reads/writes the same files through
  *     storage, running the SAME `planSourceEdit` the server does;
- *   - the remount trigger was Vite's `vgai:r3f-entry-update` HMR event →
+ *   - the remount trigger was Vite's `volter:r3f-entry-update` HMR event →
  *     `StorageBackend.watch`, which in a server-less editor reports the
  *     editor's own writes (exactly the signal absorb-by-remount needs).
  * A hosted EXAMPLE (`?project=<id>`) is still excluded: it is opened read-only
@@ -697,7 +697,7 @@ export async function mountR3FDesignSession(
     clearTimeout(stallTimer);
     // PD-1: report the failure and FALL THROUGH — a first mount that throws
     // must not kill the session. This used to `return`, which skipped the
-    // `vgai:r3f-entry-update` subscription and the play-handoff store
+    // `volter:r3f-entry-update` subscription and the play-handoff store
     // subscription installed below, so the world stayed a Boundary
     // ("Unavailable" in the hierarchy) with a stale error report for the rest
     // of the page's life: fixing the source recovered NOTHING, and the only
@@ -901,7 +901,7 @@ export async function mountR3FDesignSession(
       const alive = restoreIds.filter((id) => adapter?.hierarchy.node(id) !== null);
       if (alive.length > 0) store.shell.selectMultiple(alive);
       // PD-1: this world is mounted again — retract its failure report so the
-      // status item (and `vgai status`) can go back to healthy.
+      // status item (and `volter-game-editor status`) can go back to healthy.
       clearMountFailureReport(worldId);
       // The plane follows the FRESH game (`disposeMounted` withdrew the old
       // one's), so a stat added by the edit that triggered this remount is
@@ -1101,12 +1101,12 @@ export async function mountR3FDesignSession(
       // refreshes still need an inspector/viewport notification.
       store.shell.notifyIngestEdit();
     };
-    hot.on('vgai:r3f-entry-update', onUpdate);
-    hot.on('vgai:r3f-refresh-source', onSource);
+    hot.on('volter:r3f-entry-update', onUpdate);
+    hot.on('volter:r3f-refresh-source', onSource);
     hot.on('vite:afterUpdate', onRefreshed);
     disposeHot = () => {
-      hot.off('vgai:r3f-entry-update', onUpdate);
-      hot.off('vgai:r3f-refresh-source', onSource);
+      hot.off('volter:r3f-entry-update', onUpdate);
+      hot.off('volter:r3f-refresh-source', onSource);
       hot.off('vite:afterUpdate', onRefreshed);
       clearTimeout(revisionFallback);
     };
@@ -1141,7 +1141,7 @@ export async function mountR3FDesignSession(
     if (torndown) return;
     // Seat handover, BEFORE the deferred visual suspend below: play mode
     // registers under its own mount id, so holding both seats would make an
-    // unaddressed `vgai eval` ambiguous. This fires at
+    // unaddressed `volter-game-editor eval` ambiguous. This fires at
     // `store.setPlayState('playing')`, which precedes play's own
     // `setActiveSystems` — so the two never overlap in either direction.
     if (store.shell.playState === 'stopped') publishPlane();

package/src/three/authoring/r3f-source-authoring-adapter.ts

@@ -215,13 +215,13 @@ const isHiddenProp = (name: string): boolean =>
   HIDDEN_PROPS.has(name) ||
   /^on[A-Z]/.test(name) ||
   name.startsWith('userData-') ||
-  // The editor's OWN injected identity props (`__vgaiOid`, `__vgaiLabel` —
+  // The editor's OWN injected identity props (`__volterOid`, `__volterLabel` —
   // `oid-transform.ts`'s callsite stamp). They never reach here today, because
   // attrs are read from the file on disk while the stamp exists only in the
   // transformed module — but they are the one prop family whose removal would
   // break instance identity outright, so the guard is stated rather than
   // inferred from that layering.
-  name.startsWith('__vgai');
+  name.startsWith('__volter');
 
 /** Owned by the Transform section at the top of the panel, and by the Name
  *  field in the header — listing them again showed the same value twice. */
@@ -498,7 +498,7 @@ const R3F_CREATE_PRESETS: Record<string, string> = {
  * no props to configure yet, so the hand-rolled loader component would be a
  * copy of the library's with nothing added — and a component is what an author
  * writes THEMSELVES once the model needs behavior, by editing this callsite.
- * Deliberately NOT a vgai wrapper or a runtime indirection: the inserted line is
+ * Deliberately NOT a volter wrapper or a runtime indirection: the inserted line is
  * the line a human would write, and every later edit is drei's own API.
  */
 const MODEL_EXTENSION_RE = /\.(glb|gltf)$/i;
@@ -958,7 +958,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
       // system, positively. Asking it by ATTEMPTING the read routes an
       // ordinary absence through the source backend's failure path, which
       // ANNOUNCES before it throws — so every project that simply never ran
-      // `vgai add reflections` carried a permanent unresolved console error
+      // `volter-game-editor add reflections` carried a permanent unresolved console error
       // about a file it is not supposed to have (runhuman pass 92, on the
       // strategy example). The catch swallowed the exception; it could not
       // swallow the report.
@@ -1029,7 +1029,7 @@ export class R3fSourceAuthoringAdapter implements AuthoringAdapter {
    * different keys on the SAME object. `@volter/editor-react`'s `serving/ui-oid-plugin.ts`'s transform stamps a
    * host element inside a component definition with BOTH
    * `userData-oid="<this element, in the definition file>"` AND
-   * `userData-authoringInstance={__vgaiOid}` (the callsite oid, passed in as a
+   * `userData-authoringInstance={__volterOid}` (the callsite oid, passed in as a
    * prop). `oidOf` deliberately prefers the callsite — that is what makes an
    * instance select and write as one authoring object — so the definition entry
    * is only reachable by reading the raw `oid` key here.

package/src/three/authoring/three-authoring-adapter.ts

@@ -129,7 +129,7 @@ import type {
   TruthProvider,
   WriteAnchorKind,
 } from '@volter/editor-project/adapter';
-import { emptyWriteAnchorKindCounts } from '@volter/editor-project/adapter';
+import { emptyWriteAnchorKindCounts, physicsOwnerOf } from '@volter/editor-project/adapter';
 import { isEditorOwnedObject } from '@volter/editor-threejs/viewport/editor-layers';
 import { bodyOwningNode } from '@volter/threejs-runtime/adapter/body-marks';
 import { colorMaterialOf } from '@volter/threejs-runtime/adapter/ingest/structural-ids';
@@ -388,7 +388,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
    */
   private physicsFor(id: string): PhysicsAdapter | null {
     const physics = getActivePhysics();
-    return physics && physics.ownerOf(id) !== 'unresolved' ? physics : null;
+    return physics && physicsOwnerOf(physics, id) !== 'unresolved' ? physics : null;
   }
 
   /** This session's edits, keyed by node id. In-memory only. */
@@ -760,7 +760,7 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
     // A custom JSX tag is not necessarily a reusable component boundary. Importer runtimes use a
     // project-local component as the native ENTITY constructor (for example `<UnityNode>` creates
     // one Unity GameObject) and declare that with the existing `authoringRoot` mark. Keep it an
-    // ordinary entity here. A real prefab root can carry the same mark plus `vgaiComponentRoot`;
+    // ordinary entity here. A real prefab root can carry the same mark plus `volterComponentRoot`;
     // the hierarchy mark projection applies that explicit component identity afterwards.
     const instanceRoot =
       isComponentInstanceRoot(object) && getUserData(object, 'authoringRoot') !== true;
@@ -1078,7 +1078,8 @@ export class ThreeAuthoringAdapter implements AuthoringAdapter {
     const cached = this.bodyOwnershipByObject.get(object);
     if (cached !== undefined) return cached;
 
-    const owner = getActivePhysics()?.ownerOf(id);
+    const physics = getActivePhysics();
+    const owner = physics ? physicsOwnerOf(physics, id) : undefined;
     if (owner === 'physics') {
       this.bodyOwnershipByObject.set(object, true);
       return true;

package/src/three/authoring/typed-three-inspector.ts

@@ -128,7 +128,7 @@ function readColor(value: unknown): string | undefined {
  * arrived inside a `.glb` has no URL at all. Stamping the path we were handed
  * is what lets the slot read back the same string the picker offered.
  */
-const ASSET_PATH_KEY = 'vgaiAssetPath';
+const ASSET_PATH_KEY = 'volterAssetPath';
 
 /** Textures THIS module loaded. Only these are disposed on reassign/clear —
  *  a texture that came from a GLB or the game's own code may be shared by

package/src/three/story-documents/three-story-documents.tsx

@@ -520,7 +520,7 @@ function ThreeStoryArgsSection() {
           </span>
           {descriptor.type === 'boolean' ? (
             <Checkbox
-              className="vgai-checkbox"
+              className="volter-checkbox"
               data-testid={`three-story-arg-${descriptor.label}`}
               checked={args[descriptor.label] === true}
               onChange={(e) =>
@@ -530,7 +530,7 @@ function ThreeStoryArgsSection() {
           ) : descriptor.type === 'number' ? (
             <TextInput
               type="number"
-              className="vgai-input"
+              className="volter-input"
               data-testid={`three-story-arg-${descriptor.label}`}
               value={args[descriptor.label] as number}
               onChange={(e) => {
@@ -549,7 +549,7 @@ function ThreeStoryArgsSection() {
           ) : descriptor.type === 'string' ? (
             <TextInput
               type="text"
-              className="vgai-input"
+              className="volter-input"
               data-testid={`three-story-arg-${descriptor.label}`}
               value={args[descriptor.label] as string}
               onChange={(e) =>

package/src/three/three-board/board-scene.ts

@@ -111,16 +111,16 @@ import {
 import type { BoardBounds, BoardDistrictPlacement, BoardItemPlacement } from './board-layout';
 
 /** `userData` key carrying an exhibit's story id, read by the picking path. */
-export const BOARD_STORY_ID_KEY = 'vgaiBoardStoryId';
+export const BOARD_STORY_ID_KEY = 'volterBoardStoryId';
 
 /** `userData` key carrying a ghost slot's component key (`<path>#<name>`),
  *  read by the picking path exactly like {@link BOARD_STORY_ID_KEY}. */
-export const BOARD_COMPONENT_KEY = 'vgaiBoardComponentKey';
+export const BOARD_COMPONENT_KEY = 'volterBoardComponentKey';
 
 /** The district group key ghost slots share. A sentinel outside the story
  *  grouping model's vocabulary, so it can never collide with an authored
  *  group; the scene labels it, the layout only clusters by it. */
-export const BOARD_GHOST_GROUP_KEY = 'vgai:board:no-story';
+export const BOARD_GHOST_GROUP_KEY = 'volter:board:no-story';
 
 /** Who a given exhibit is — everything the Inspector shows for a picked object. */
 export interface BoardStoryIdentity {
@@ -380,7 +380,7 @@ function createDistrictPad(district: BoardDistrictPlacement): THREE.Mesh {
     new THREE.BoxGeometry(width, PAD_THICKNESS, depth),
     new THREE.MeshStandardMaterial(PAD_MATERIAL_PARAMS),
   );
-  pad.name = `vgai:board-pad:${district.groupKey || UNGROUPED_LABEL}`;
+  pad.name = `volter:board-pad:${district.groupKey || UNGROUPED_LABEL}`;
   pad.position.set(
     (district.extent.minX + district.extent.maxX) / 2,
     PAD_TOP_Y - PAD_THICKNESS / 2,
@@ -430,7 +430,7 @@ function dashedFloorRectangle(width: number, depth: number): THREE.LineSegments
  */
 function createGhostSlot(slot: BoardGhostSlot): THREE.Object3D {
   const group = new THREE.Group();
-  group.name = `vgai:board-ghost:${slot.name}`;
+  group.name = `volter:board-ghost:${slot.name}`;
   group.userData[BOARD_COMPONENT_KEY] = slot.key;
 
   const [width, depth] = slot.placement.footprint;
@@ -596,7 +596,7 @@ function createExhibitGroup(
   mounted: MountedStoryObject3D,
 ): THREE.Object3D {
   const exhibit = new THREE.Group();
-  exhibit.name = `vgai:board-exhibit:${identity.label}`;
+  exhibit.name = `volter:board-exhibit:${identity.label}`;
   exhibit.position.set(...(placement.translation as [number, number, number]));
   exhibit.add(mounted.root);
   exhibit.userData[BOARD_STORY_ID_KEY] = identity.id;
@@ -744,9 +744,9 @@ async function assembleThreeBoard(
   const tAssemble = Date.now();
 
   const root = new THREE.Group();
-  root.name = 'vgai:three-board';
+  root.name = 'volter:three-board';
   const chrome = new THREE.Group();
-  chrome.name = 'vgai:board-chrome';
+  chrome.name = 'volter:board-chrome';
   markChrome(chrome);
   root.add(chrome);
 
@@ -761,7 +761,7 @@ async function assembleThreeBoard(
   for (const district of layout.districts) {
     const ghostDistrict = district.groupKey === BOARD_GHOST_GROUP_KEY;
     const districtGroup = new THREE.Group();
-    districtGroup.name = `vgai:board-district:${
+    districtGroup.name = `volter:board-district:${
       ghostDistrict ? GHOST_DISTRICT_LABEL : district.groupKey || UNGROUPED_LABEL
     }`;
     root.add(districtGroup);

package/src/three/three-board/three-component-board.ts

@@ -57,6 +57,6 @@ export const threeComponentBoard: ComponentBoard = {
     `This project has no ${THREE_COMPONENTS_TITLE} board (${THREE_COMPONENTS_DOCUMENT_ID}): ` +
     "board presence keys on STORIES, not on roots, and none of this project's stories declares " +
     'the "three" medium. Declare it — a manifest root entry naming the story\'s module, or a ' +
-    `\`vgai.adapter.ts\` regionInclude that covers it — and the board appears. ${commandLine('console')} ` +
+    `\`volter.adapter.ts\` regionInclude that covers it — and the board appears. ${commandLine('console')} ` +
     'names every story it could not place.',
 };