@volter/threejs-runtime 0.5.67 → 0.5.69

package/NOTICE

@@ -1,8 +1,8 @@
 Copyright 2026 Volter AI, Inc.
 
-The files in this package were imported from volter-ai/vgai-engine at
+The files in this package were imported from volter-ai/volter-engine at
 commit 09c2749ce (packages/threejs-runtime), where they were published as the
-Apache-2.0 @vgai/threejs-runtime package. They retain that license; LICENSE
+Apache-2.0 @volter/threejs-runtime package. They retain that license; LICENSE
 contains its text.
 
 vendor/realism-effects is a fork of realism-effects 1.1.2

package/package.json

@@ -2,13 +2,13 @@
   "name": "@volter/threejs-runtime",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.67",
+  "version": "0.5.69",
   "publishConfig": {
     "access": "public"
   },
   "description": "THE THREE.JS SHIPPED TWIN: what a shipped game carries because its world is three.js \u2014 the renderer setup and render features, the asset loaders and asset-format descriptors, the Object3D marks the editor reads, Rapier-over-three physics, recast navigation, the three animation mixer and its xstate binding, and the scene-capture the ingest seam mounts through.",
   "keywords": [
-    "vgai",
+    "volter",
     "three",
     "game-engine"
   ],
@@ -43,7 +43,7 @@
     "@dimforge/rapier3d-compat": "^0.14.0",
     "@recast-navigation/three": "^0.43.0",
     "@sparkjsdev/spark": "^2.1.0",
-    "@volter/editor-project": "0.5.67",
+    "@volter/editor-project": "0.5.69",
     "n8ao": "^1.10.1",
     "postprocessing": "^6.38.0",
     "quarks.core": "0.16.0",

package/src/adapter/body-marks.ts

@@ -5,7 +5,7 @@
  * Sibling of `hierarchy-marks.ts`, and the same shape of idea. That module's
  * marks answer "what IS this node" for the panel; this one answers "who WRITES
  * this node's pose" for an edit. Both are written by GAME code at the seam that
- * knows the answer, read generically by the host, and namespaced `vgai*` because
+ * knows the answer, read generically by the host, and namespaced `volter*` because
  * they are the host's namespace on a node the game owns.
  *
  * ## Why it exists
@@ -37,7 +37,7 @@
  * ## What to mark
  *
  * The node whose pose the body writes — normally the body's own root node. Not
- * subtree-scoped (unlike `vgaiBuiltInternal`): a child of a body-driven node
+ * subtree-scoped (unlike `volterBuiltInternal`): a child of a body-driven node
  * inherits its parent's motion through the transform chain, and its own local
  * pose is still the node's to keep. Mark exactly the node the sync writes.
  */
@@ -57,13 +57,13 @@ import type { RapierEditableBody } from './rapier-physics-adapter';
  * `RigidBody` classes are unrelated nominal types.
  */
 export function markBodyOwnedNode(node: THREE.Object3D, body: RapierEditableBody): void {
-  setUserData(node, 'vgaiBodyOwner', body);
+  setUserData(node, 'volterBodyOwner', body);
 }
 
 /** The body that owns `node`'s pose, or `undefined` for a node that owns its own. */
 export function bodyOwningNode(
   node: THREE.Object3D | null | undefined,
 ): RapierEditableBody | undefined {
-  const body = getUserData(node, 'vgaiBodyOwner');
+  const body = getUserData(node, 'volterBodyOwner');
   return body ?? undefined;
 }

package/src/adapter/hierarchy-marks.ts

@@ -102,7 +102,7 @@
  * ## What is NOT built-internal
  *
  * A node your game means as content — even one a class rather than JSX
- * constructs — is content. `vgaiBuiltInternal` is not "the editor cannot write
+ * constructs — is content. `volterBuiltInternal` is not "the editor cannot write
  * this"; that question is `TransformProvider.editability`'s, answered per
  * channel with a sentence. This mark answers "is this implementation", and
  * getting it wrong hides real content.
@@ -124,12 +124,12 @@ import { getObjectMark, setObjectMark } from '../ecs/object-marks';
  * the instance is already named by `node.name`, and the editor prints both.
  */
 export function markComponentRoot(node: THREE.Object3D, name: string): void {
-  setObjectMark(node, 'vgaiComponentRoot', name);
+  setObjectMark(node, 'volterComponentRoot', name);
 }
 
 /** The component name `node` is the root of, or `undefined` for an ordinary node. */
 export function componentRootName(node: THREE.Object3D | null | undefined): string | undefined {
-  const name = getObjectMark(node, 'vgaiComponentRoot');
+  const name = getObjectMark(node, 'volterComponentRoot');
   return typeof name === 'string' && name ? name : undefined;
 }
 
@@ -145,12 +145,12 @@ export function isComponentRoot(node: THREE.Object3D | null | undefined): boolea
  * the seam and not a sweep.
  */
 export function markBuiltInternal(node: THREE.Object3D): void {
-  setObjectMark(node, 'vgaiBuiltInternal', true);
+  setObjectMark(node, 'volterBuiltInternal', true);
 }
 
 /** Whether `node` itself carries the implementation mark. Ancestry is the
  *  CALLER's walk — see this module's header for why the mark is subtree-scoped
  *  but not restamped onto descendants. */
 export function isBuiltInternal(node: THREE.Object3D | null | undefined): boolean {
-  return getObjectMark(node, 'vgaiBuiltInternal') === true;
+  return getObjectMark(node, 'volterBuiltInternal') === true;
 }

package/src/adapter/ingest/scene-capture.ts

@@ -17,7 +17,7 @@
  *     that captures `(scene, camera, renderer)` on the first real frame.
  *
  * This is the hardened, typed form of the `ingest-study` spike
- * (`docs/ingest-study-spike/vgai-ingest-adapter.js`), proven against an
+ * (`docs/ingest-study-spike/volter-ingest-adapter.js`), proven against an
  * unmodified `three.js/examples/games_fps` game.
  *
  * DOM-backed addon renderers use ordinary prototype methods instead. The host
@@ -111,12 +111,12 @@ export interface SceneCaptureOptions {
    * Identity, not shape, is the discriminator: a host renderer and a game
    * renderer are the same class, both built after install, both drawing real
    * scenes. The host is the only party that knows which is which, so it says
-   * so (`@vgai/threejs/viewport/renderer-ownership`).
+   * so (`@volter/threejs/viewport/renderer-ownership`).
    */
   isHostRenderer?: (renderer: unknown) => boolean;
   /**
    * The game's OWN declared world, read from its contract
-   * (`window.vgaiGame` — the host passes a reader, never a cached value, because
+   * (`window.volterGame` — the host passes a reader, never a cached value, because
    * the contract is declared by the game's modules and may not exist yet when
    * the trap installs).
    *
@@ -135,7 +135,7 @@ export interface SceneCaptureOptions {
    * forever, and the real world that renders one frame later reaches no reader
    * at all. This is that reader. It never changes which world is adopted — it
    * makes the ambiguity a recorded fact (`packages/editor/src/world-adoption.ts`
-   * publishes it to `vgai status`).
+   * publishes it to `volter-game-editor status`).
    *
    * Post-processing games legitimately render several (scene, camera) pairs per
    * frame, so alternates are INFORMATION, never an error. Host renders are
@@ -433,7 +433,7 @@ export function installSceneCapture(
 
   // Stash the real render fn per-instance under a unique symbol so multiple
   // renderers (editor's + game's) never collide.
-  const REAL = Symbol('vgai.realRender');
+  const REAL = Symbol('volter.realRender');
 
   let captured: CapturedRuntime | null = null;
   let drawCount = 0;
@@ -461,7 +461,7 @@ export function installSceneCapture(
   // prototype getter/setter. The constructor's `this.setAnimationLoop = realFn` hits
   // our SETTER (the instance has no own property yet) and we stash realFn per-instance;
   // the GETTER returns a wrapper that records each non-null callback before forwarding.
-  const REAL_SAL = Symbol('vgai.realSetAnimationLoop');
+  const REAL_SAL = Symbol('volter.realSetAnimationLoop');
   const loopCallbacks = new WeakMap<object, (time: number) => void>();
   const loopedRenderers = new Set<object>();
   /** Visibility clock of the in-flight `waitForCapture`, if any. */
@@ -810,7 +810,7 @@ export function installSceneCapture(
         waiters.push(wrapped);
         waitingVisibility = opts.visibility ?? documentVisibilityClock();
         opts.onWait?.(captureWindow);
-        // A waiter that starts already-hidden (the normal `vgai play` path
+        // A waiter that starts already-hidden (the normal `volter-game-editor play` path
         // against a backgrounded tab) must not wait for a human to foreground
         // it. Pump any loop the game has already registered.
         queueMicrotask(pumpHiddenLoops);

package/src/adapter/ingest/structural-ids.ts

@@ -28,7 +28,7 @@ export const CAMERA_ID = 'ingest:camera';
 /**
  * The editor parks its OWN objects — grid, its two lights, the particle
  * BatchedRenderer, every TransformControls/gizmo helper — on layer 31
- * (`@vgai/threejs/viewport/editor-layers`'s `EDITOR_LAYER`) so the game camera
+ * (`@volter/threejs/viewport/editor-layers`'s `EDITOR_LAYER`) so the game camera
  * never sees them. On an ingest root those objects are added to the GAME'S OWN
  * scene, which is the same tree this walk indexes.
  */

package/src/adapter/ingest/visible-capture-window.ts

@@ -8,7 +8,7 @@
  * render while its tab is hidden, because the browser parks `requestAnimation
  * Frame` for a backgrounded document. The two facts together make one
  * deterministic failure: a tab that opens in the BACKGROUND (the normal human
- * path — `vgai edit` auto-opens a tab that routinely lands behind the current
+ * path — `volter-game-editor edit` auto-opens a tab that routinely lands behind the current
  * window) burns its whole capture window unable to draw, the deadline fires,
  * the mount dies terminally, and foregrounding the tab later changes nothing.
  * Agents, whose tabs happen to be visible, never saw it.
@@ -26,7 +26,7 @@
  * budget is not a failure — a human returning to the tab is what spends it —
  * and a cap would be exactly the boot-time clock this module exists to
  * remove. The parked wait is reported instead of being silent: see
- * `CaptureWaitObserver` in `scene-capture.ts` and `vgai status`'s
+ * `CaptureWaitObserver` in `scene-capture.ts` and `volter-game-editor status`'s
  * `ingestCaptureWait`.
  *
  * The state machine is a pure function of (banked segments, now, hidden) so
@@ -223,7 +223,7 @@ export interface CaptureWaitOptions {
    *
    * A wait parked on a hidden tab is otherwise indistinguishable from a hung
    * mount: nothing renders, nothing fails, and every door reports silence.
-   * This is the seam the editor publishes to `vgai status` so the answer is
+   * This is the seam the editor publishes to `volter-game-editor status` so the answer is
    * "waiting for the first visible frame — the tab is hidden", not a countdown
    * that is not running.
    */

package/src/animation/animation-clock.ts

@@ -3,7 +3,7 @@ import { PHASE_ORDER, type SystemPhaseName } from '@volter/editor-project/core/s
 /**
  * D1 — the canonical `AnimationClock` (spec §10 D1, §3.2, §4).
  *
- * VGAI owns exactly one clock per cinematic/scene context. It is the single
+ * VOLTER owns exactly one clock per cinematic/scene context. It is the single
  * source of truth for "what time is it" that registered sequences,
  * GSAP timelines, and cinematic cue evaluators are seeked against (D2/D5/D7
  * — NOT implemented here, this unit is the clock only). The render seam

package/src/asset-loaders.ts

@@ -128,7 +128,7 @@ export async function loadSplat(url: string, providedBytes?: Uint8Array): Promis
       const size = bounds.getSize(new THREE.Vector3()).multiplyScalar(1.5);
       const center = bounds.getCenter(new THREE.Vector3());
       const proxy = new THREE.Mesh(new THREE.BoxGeometry(size.x, size.y, size.z));
-      proxy.name = '__vgai_splat_bounds';
+      proxy.name = '__volter_splat_bounds';
       proxy.position.copy(center);
       proxy.visible = false;
       proxy.raycast = () => {};

package/src/ecs/object-marks.ts

@@ -43,8 +43,8 @@ export interface ObjectMarkSchema {
   skeletonEnabled: boolean;
   engineInternal: boolean;
   editorHelper: boolean;
-  vgaiComponentRoot: string;
-  vgaiBuiltInternal: boolean;
+  volterComponentRoot: string;
+  volterBuiltInternal: boolean;
 }
 
 export const ObjectMarkKeys = {
@@ -53,8 +53,8 @@ export const ObjectMarkKeys = {
   skeletonEnabled: 'skeletonEnabled',
   engineInternal: 'engineInternal',
   editorHelper: 'editorHelper',
-  vgaiComponentRoot: 'vgaiComponentRoot',
-  vgaiBuiltInternal: 'vgaiBuiltInternal',
+  volterComponentRoot: 'volterComponentRoot',
+  volterBuiltInternal: 'volterBuiltInternal',
 } as const satisfies Record<keyof ObjectMarkSchema, string>;
 
 export function getObjectMark<K extends keyof ObjectMarkSchema>(

package/src/ecs/user-data.ts

@@ -78,17 +78,17 @@
  *
  * Hierarchy-presentation convention (written by GAME code, read by the editor —
  * see `../adapter/hierarchy-marks.ts`, which is the ONLY place these two are
- * read/written from; the `vgai` prefix marks them as the HOST's namespace on a
+ * read/written from; the `volter` prefix marks them as the HOST's namespace on a
  * node a game owns, unlike every other key above, which the engine/editor also
  * write):
- * - `vgaiComponentRoot`   — display name of the component instance this subtree
+ * - `volterComponentRoot`   — display name of the component instance this subtree
  *                           IS. The node renders as one collapsed, expandable
  *                           row named for it.
- * - `vgaiBuiltInternal`   — `true` on the ROOT of a subtree runtime code
+ * - `volterBuiltInternal`   — `true` on the ROOT of a subtree runtime code
  *                           CONSTRUCTED rather than authored (skeleton bones,
  *                           particle renderers). Subtree-scoped: everything
  *                           below a marked node is built-internal too.
- * - `vgaiBodyOwner`       — the rigid body that OWNS this node's pose, written
+ * - `volterBodyOwner`       — the rigid body that OWNS this node's pose, written
  *                           by the code that attaches the body (see
  *                           `../adapter/body-marks.ts`, the only reader/writer).
  *                           A transform edit on such a node must be applied to
@@ -147,7 +147,7 @@ export interface UserDataSchema extends ObjectMarkSchema {
   authoringRoot: boolean;
   authoringInstance: string;
   authoringLabel: string;
-  vgaiBodyOwner: RapierEditableBody;
+  volterBodyOwner: RapierEditableBody;
   authoringComponent: string;
   authoringDocument: {
     readonly kind: 'project-tool';
@@ -198,7 +198,7 @@ export const UserDataKeys = {
   authoringRoot: 'authoringRoot',
   authoringInstance: 'authoringInstance',
   authoringLabel: 'authoringLabel',
-  vgaiBodyOwner: 'vgaiBodyOwner',
+  volterBodyOwner: 'volterBodyOwner',
   authoringComponent: 'authoringComponent',
   authoringDocument: 'authoringDocument',
   authoringHierarchyId: 'authoringHierarchyId',

package/src/render/ibl-override-material.ts

@@ -50,7 +50,7 @@ export type IblOverrideShader = Parameters<MeshStandardMaterial['onBeforeCompile
  * lives here, so a per-consumer name would be a string two files have to agree
  * on with nothing checking that they do.
  */
-export const IBL_WORLD_POSITION = 'vgaiIblWorldPosition';
+export const IBL_WORLD_POSITION = 'volterIblWorldPosition';
 
 /**
  * Three's own IBL chunk with `getIBLIrradiance`/`getIBLRadiance` renamed to

package/vendor/realism-effects/UPSTREAM.md

@@ -1,11 +1,11 @@
 # realism-effects compatibility fork
 
 This directory vendors the published `realism-effects@1.1.2` distribution
-(MIT license) so `@vgai/threejs-runtime` remains installable as a self-contained source
+(MIT license) so `@volter/threejs-runtime` remains installable as a self-contained source
 package. The upstream package still imports Three's removed
 `WebGLMultipleRenderTargets` API and has no release compatible with Three r180.
 
-VGAI's fork contains only the mechanical r180 MRT migration:
+VOLTER's fork contains only the mechanical r180 MRT migration:
 
 - `WebGLMultipleRenderTargets(width, height, count, options)` becomes
   `WebGLRenderTarget(width, height, { ...options, count })`.

package/vendor/realism-effects/package.json

@@ -1,7 +1,7 @@
 {
   "name": "realism-effects",
-  "version": "1.1.2-vgai.1",
-  "description": "VGAI-maintained Three r180-compatible fork of realism-effects 1.1.2",
+  "version": "1.1.2-volter.1",
+  "description": "VOLTER-maintained Three r180-compatible fork of realism-effects 1.1.2",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",