@volter/editor-threejs 0.5.68 → 0.5.69

package/NOTICE

@@ -1,13 +1,13 @@
 Copyright 2026 Volter AI, Inc.
 
 Modules under src/viewport and src/capture were imported from the
-AGPL-3.0-only @vgai/threejs package; LICENSE contains that license.
+AGPL-3.0-only threejs package of volter-ai/volter-engine; LICENSE contains that license.
 serving/model-import-conversion.ts was imported from the AGPL-3.0-only
-@vgai/editor package's server and retains that license.
+editor package's server in volter-ai/volter-engine and retains that license.
 
 Modules under src/adapter, src/animation, src/ecs and src/render, together
 with src/asset-loaders.ts, src/asset-parse-error.ts and src/loader.ts, were
-imported from the Apache-2.0 @vgai/threejs-runtime package. They retain that
+imported from the Apache-2.0 @volter/threejs-runtime package. They retain that
 license; LICENSE-APACHE contains its text.
 
 Source revisions and original file hashes are recorded in the repository's

package/contributions/animation-mixers.service.ts

@@ -1,6 +1,6 @@
 /**
  * The animation stamp's status facet (`@volter/editor-sdk/services`, a `workspace.service`
- * contribution): `vgai status` reports the mixers the running world's own code made, with the
+ * contribution): the editor's `status` command reports the mixers the running world's own code made, with the
  * clips it has played through each and the objects each animates, so "the timeline found
  * nothing" is answerable from the session.
  */

package/contributions/animation-timeline.utility.tsx

@@ -32,7 +32,7 @@ export default function AnimationTimeline() {
         data-testid="animation-timeline-empty"
         data-document={activeId ?? ''}
         data-transport={handle ? 'yes' : 'no'}
-        style={{ padding: 'var(--vgai-space-2) var(--vgai-space-3)' }}
+        style={{ padding: 'var(--volter-space-2) var(--volter-space-3)' }}
       >
         {handle
           ? 'Nothing in the active document plays an animation.'

package/dist-node/serving.mjs

@@ -3,7 +3,7 @@ import { relative, sep } from "node:path";
 import ts from "typescript";
 
 // serving/animation-live-module.ts
-var ANIMATION_LIVE_MODULE_ID = "virtual:vgai-three-animation-live";
+var ANIMATION_LIVE_MODULE_ID = "virtual:volter-three-animation-live";
 var animationLiveModuleSource = `
 const live = (globalThis[Symbol.for('volter.three.animation.live')] ??= {
   mixers: new Map(),
@@ -16,10 +16,10 @@ function notify() {
     try { listener(); } catch (error) { console.error(error); }
   }
 }
-export function __vgaiMixer(mixer, key) {
+export function __volterMixer(mixer, key) {
   if (!mixer || typeof mixer.clipAction !== 'function') return mixer;
-  if (mixer.__vgaiMixerKey) return mixer;
-  Object.defineProperty(mixer, '__vgaiMixerKey', { value: key });
+  if (mixer.__volterMixerKey) return mixer;
+  Object.defineProperty(mixer, '__volterMixerKey', { value: key });
   const entry = { key, mixer, clips: new Map(), roots: new Set() };
   live.mixers.set(mixer, entry);
   const clipAction = mixer.clipAction;
@@ -47,9 +47,9 @@ export function __vgaiMixer(mixer, key) {
   return mixer;
 }
 /** drei's \`useAnimations\` result: its mixer, and the clips it was handed. */
-export function __vgaiAnimations(result, key) {
+export function __volterAnimations(result, key) {
   if (!result || !result.mixer) return result;
-  __vgaiMixer(result.mixer, key);
+  __volterMixer(result.mixer, key);
   const entry = live.mixers.get(result.mixer);
   if (entry && Array.isArray(result.clips)) {
     let changed = false;
@@ -81,8 +81,8 @@ function stampAnimation(code, file, relativeFile) {
   const source = ts.createSourceFile(file, code, ts.ScriptTarget.Latest, true, kind);
   const sites = [];
   const visit = (node) => {
-    if (isMixerConstruction(node)) sites.push({ start: node.getStart(source), end: node.getEnd(), wrapper: "__vgaiMixer" });
-    else if (isUseAnimations(node)) sites.push({ start: node.getStart(source), end: node.getEnd(), wrapper: "__vgaiAnimations" });
+    if (isMixerConstruction(node)) sites.push({ start: node.getStart(source), end: node.getEnd(), wrapper: "__volterMixer" });
+    else if (isUseAnimations(node)) sites.push({ start: node.getStart(source), end: node.getEnd(), wrapper: "__volterAnimations" });
     ts.forEachChild(node, visit);
   };
   visit(source);
@@ -93,7 +93,7 @@ function stampAnimation(code, file, relativeFile) {
     const key = `${relativeFile}:${line + 1}:${character + 1}`;
     out = `${out.slice(0, site.start)}${site.wrapper}(${out.slice(site.start, site.end)}, ${JSON.stringify(key)})${out.slice(site.end)}`;
   }
-  return `import { __vgaiMixer, __vgaiAnimations } from ${JSON.stringify(ANIMATION_LIVE_MODULE_ID)};
+  return `import { __volterMixer, __volterAnimations } from ${JSON.stringify(ANIMATION_LIVE_MODULE_ID)};
 ${out}`;
 }
 function animationStampPlugin(services) {
@@ -104,7 +104,7 @@ function animationStampPlugin(services) {
     return roots.some((root) => file.startsWith(root + sep) || file.startsWith(root + "/"));
   };
   return {
-    name: "vgai-three-animation",
+    name: "volter-three-animation",
     enforce: "pre",
     resolveId(id) {
       return id === ANIMATION_LIVE_MODULE_ID ? VIRTUAL_ID : null;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/editor-threejs",
   "author": "Volter AI, Inc.",
-  "version": "0.5.68",
+  "version": "0.5.69",
   "publishConfig": {
     "access": "public"
   },
@@ -126,7 +126,7 @@
     "prepack": "npm run build",
     "typecheck": "tsc -p tsconfig.json"
   },
-  "vgai": {
+  "volter": {
     "contributions": [
       "./contributions/three-integration.service.ts",
       "./contributions/animation-mixers.service.ts",
@@ -135,12 +135,12 @@
     "serving": "./dist-node/serving.mjs"
   },
   "dependencies": {
-    "@volter/editor-project": "0.5.68",
+    "@volter/editor-project": "0.5.69",
     "@sparkjsdev/spark": "^2.1.0",
     "three.quarks": "^0.16.0",
     "zod": "^4.3.6",
     "typescript": "5.9.3",
-    "@volter/editor-sdk": "0.5.68",
+    "@volter/editor-sdk": "0.5.69",
     "postprocessing": "6.38.3",
     "quarks.core": "0.16.0",
     "@fortawesome/free-solid-svg-icons": "^7.2.0"

package/serving/animation-live-module.ts

@@ -9,7 +9,7 @@
  * the editor's bundle reads it (`src/animation/live-mixers.ts`).
  */
 
-export const ANIMATION_LIVE_MODULE_ID = 'virtual:vgai-three-animation-live';
+export const ANIMATION_LIVE_MODULE_ID = 'virtual:volter-three-animation-live';
 
 export const animationLiveModuleSource = `
 const live = (globalThis[Symbol.for('volter.three.animation.live')] ??= {
@@ -23,10 +23,10 @@ function notify() {
     try { listener(); } catch (error) { console.error(error); }
   }
 }
-export function __vgaiMixer(mixer, key) {
+export function __volterMixer(mixer, key) {
   if (!mixer || typeof mixer.clipAction !== 'function') return mixer;
-  if (mixer.__vgaiMixerKey) return mixer;
-  Object.defineProperty(mixer, '__vgaiMixerKey', { value: key });
+  if (mixer.__volterMixerKey) return mixer;
+  Object.defineProperty(mixer, '__volterMixerKey', { value: key });
   const entry = { key, mixer, clips: new Map(), roots: new Set() };
   live.mixers.set(mixer, entry);
   const clipAction = mixer.clipAction;
@@ -54,9 +54,9 @@ export function __vgaiMixer(mixer, key) {
   return mixer;
 }
 /** drei's \`useAnimations\` result: its mixer, and the clips it was handed. */
-export function __vgaiAnimations(result, key) {
+export function __volterAnimations(result, key) {
   if (!result || !result.mixer) return result;
-  __vgaiMixer(result.mixer, key);
+  __volterMixer(result.mixer, key);
   const entry = live.mixers.get(result.mixer);
   if (entry && Array.isArray(result.clips)) {
     let changed = false;

package/serving/animation-stamp.ts

@@ -40,10 +40,10 @@ export function stampAnimation(code: string, file: string, relativeFile: string)
   if (!code.includes('AnimationMixer') && !code.includes('useAnimations')) return null;
   const kind = file.endsWith('.tsx') ? ts.ScriptKind.TSX : file.endsWith('.jsx') ? ts.ScriptKind.JSX : ts.ScriptKind.TS;
   const source = ts.createSourceFile(file, code, ts.ScriptTarget.Latest, true, kind);
-  const sites: { start: number; end: number; wrapper: '__vgaiMixer' | '__vgaiAnimations' }[] = [];
+  const sites: { start: number; end: number; wrapper: '__volterMixer' | '__volterAnimations' }[] = [];
   const visit = (node: ts.Node): void => {
-    if (isMixerConstruction(node)) sites.push({ start: node.getStart(source), end: node.getEnd(), wrapper: '__vgaiMixer' });
-    else if (isUseAnimations(node)) sites.push({ start: node.getStart(source), end: node.getEnd(), wrapper: '__vgaiAnimations' });
+    if (isMixerConstruction(node)) sites.push({ start: node.getStart(source), end: node.getEnd(), wrapper: '__volterMixer' });
+    else if (isUseAnimations(node)) sites.push({ start: node.getStart(source), end: node.getEnd(), wrapper: '__volterAnimations' });
     ts.forEachChild(node, visit);
   };
   visit(source);
@@ -54,7 +54,7 @@ export function stampAnimation(code: string, file: string, relativeFile: string)
     const key = `${relativeFile}:${line + 1}:${character + 1}`;
     out = `${out.slice(0, site.start)}${site.wrapper}(${out.slice(site.start, site.end)}, ${JSON.stringify(key)})${out.slice(site.end)}`;
   }
-  return `import { __vgaiMixer, __vgaiAnimations } from ${JSON.stringify(ANIMATION_LIVE_MODULE_ID)};\n${out}`;
+  return `import { __volterMixer, __volterAnimations } from ${JSON.stringify(ANIMATION_LIVE_MODULE_ID)};\n${out}`;
 }
 
 export function animationStampPlugin(services: AnimationServingServices): Plugin {
@@ -65,7 +65,7 @@ export function animationStampPlugin(services: AnimationServingServices): Plugin
     return roots.some((root) => file.startsWith(root + sep) || file.startsWith(root + '/'));
   };
   return {
-    name: 'vgai-three-animation',
+    name: 'volter-three-animation',
     enforce: 'pre',
     resolveId(id) {
       return id === ANIMATION_LIVE_MODULE_ID ? VIRTUAL_ID : null;

package/serving/index.ts

@@ -1,5 +1,5 @@
 /**
- * `@volter/editor-threejs`'s server half (`package.json#vgai.serving`): the animation stamp that
+ * `@volter/editor-threejs`'s server half (`package.json#volter.serving`): the animation stamp that
  * lets the editor drive the mixers a project's own code makes, and the conversion of source model
  * formats to runtime GLB for the asset library's imports.
  */

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
@@ -112,12 +112,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).
    *
@@ -136,7 +136,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 the editor's `status` command).
    *
    * Post-processing games legitimately render several (scene, camera) pairs per
    * frame, so alternates are INFORMATION, never an error. Host renders are
@@ -411,7 +411,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;
@@ -439,7 +439,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. */
@@ -788,7 +788,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 the editor's `play` command 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 — the editor's `edit` command 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 the editor's `status` command'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 the editor's `status` command so the answer is
    * "waiting for the first visible frame — the tab is hidden", not a countdown
    * that is not running.
    */

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,13 +78,13 @@
  *
  * 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.

package/src/kit/asset-compare.ts

@@ -1,6 +1,6 @@
 /**
- * B8.4 — the Asset Lab COMPARE surface (`vgai screenshot <model.glb>
- * --compare <ref.glb>`): renders the project asset AND a caller-supplied reference GLB
+ * B8.4 — the Asset Lab COMPARE surface (the editor's `screenshot <model.glb>
+ * --compare <ref.glb>` command): renders the project asset AND a caller-supplied reference GLB
  * with matched orthographic front + side framing, then scores their
  * silhouettes (IoU) and composes review overlays, so an agent can
  * numerically converge a procedural character toward a reference.

package/src/kit/asset-preview-command.ts

@@ -118,7 +118,7 @@ export async function handleAssetPreviewCommand(
     };
   }
   if (compare !== undefined) {
-    // B8.4 — the compare mode (`vgai screenshot <model.glb> --compare <ref.glb>`).
+    // B8.4 — the compare mode (the editor's `screenshot <model.glb> --compare <ref.glb>` command).
     // Validated here at the relay boundary so a malformed payload fails with
     // a named reason instead of a deep three.js error.
     if (shots !== undefined || shotSetDefinition !== undefined) {
@@ -142,7 +142,7 @@ export async function handleAssetPreviewCommand(
   // Wire-carried GLB bytes stand NOWHERE, so they take no scene stage and no
   // compare (whose reference is named some other way). An explicit `shotSet`
   // definition is a different matter and is served: a shot set stages the
-  // subject itself, which is what lets `vgai screenshot <module> --orbit <n>`
+  // subject itself, which is what lets the editor's `screenshot <module> --orbit <n>` command
   // circle a model that only ever existed as bytes. `shots: 'source'` stays
   // out — it is the asset-path review set, keyed to a stored forward vector.
   if (typeof glbBase64 === 'string') {

package/src/kit/asset-preview.ts

@@ -2587,7 +2587,7 @@ export async function captureGlbBytesAssetPreview(
 
 /**
  * The same bytes, photographed as a LABELED SHOT SET instead of the four
- * views — what `vgai screenshot <module> --orbit <n>` renders. A shot set
+ * views — what the editor's `screenshot <module> --orbit <n>` command renders. A shot set
  * stages the subject itself, exactly the way the asset-path lane's
  * {@link captureShotSetModelPreview} does, so bytes are no less valid a
  * subject here than a project GLB is.

package/src/kit/authoring/component-instance-root.ts

@@ -90,8 +90,8 @@ function instanceCallsiteOid(object: THREE.Object3D | null | undefined): string
  * Object3D (Drei cameras are the canonical example). It is a callsite address,
  * not the object's definition-side `userData.oid`. */
 function forwardedCallsiteOid(object: THREE.Object3D | null | undefined): string | undefined {
-  const forwarded = (object as (THREE.Object3D & { __vgaiOid?: unknown }) | null | undefined)
-    ?.__vgaiOid;
+  const forwarded = (object as (THREE.Object3D & { __volterOid?: unknown }) | null | undefined)
+    ?.__volterOid;
   return typeof forwarded === 'string' && forwarded ? forwarded : undefined;
 }
 

package/src/kit/authoring/object3d-document-session.ts

@@ -1920,7 +1920,7 @@ class SelectionOrigins extends THREE.Points<THREE.BufferGeometry, THREE.PointsMa
         toneMapped: false,
       }),
     );
-    this.name = 'vgai:selection-origins';
+    this.name = 'volter:selection-origins';
     this.userData['editorHelper'] = true;
     this.renderOrder = 1000;
     this.frustumCulled = false;

package/src/kit/authoring/three-projection-core.ts

@@ -138,7 +138,7 @@ export function isTransparentWrapper(object: THREE.Object3D): boolean {
     object.userData['oid'] === undefined &&
     getUserData(object, 'authoringInstance') === undefined &&
     getUserData(object, 'authoringRoot') !== true &&
-    getUserData(object, 'vgaiComponentRoot') === undefined
+    getUserData(object, 'volterComponentRoot') === undefined
   );
 }
 

package/src/kit/authoring/viewport-pick-context.ts

@@ -1,6 +1,6 @@
 /**
  * Viewport pick context (B4, D12) — the camera/canvas seam that
- * `VgaiSceneAuthoringAdapter.pickable.pick` needs but cannot own itself: both
+ * `VolterSceneAuthoringAdapter.pickable.pick` needs but cannot own itself: both
  * live on `EditorViewport`, not on the adapter (the adapter only ever held a
  * `store` — see its own doc comment). A tiny module-level slot, same shape as
  * `./active-systems.ts`: `EditorViewport`'s constructor sets it once its

package/src/kit/authoring/viewport-raycast.ts

@@ -4,7 +4,7 @@
  * `editor-viewport.ts`'s former `_raycastEntity` so EVERY threejs-backed
  * authoring adapter whose live objects sit in `store.objectMap` reuses the
  * exact same logic:
- *   - first-party `VgaiSceneAuthoringAdapter` (edit mode's focused world),
+ *   - first-party `VolterSceneAuthoringAdapter` (edit mode's focused world),
  *   - `ThreeAuthoringAdapter` (any live three tree — bare ingest
  *     mode AND the three child of a multi-world PLAY composite).
  *

package/src/kit/components/CameraInfo.tsx

@@ -40,7 +40,7 @@ export function CameraInfo() {
     <EditorSurface
       variant="overlay"
       border
-      className="vgai-camera-info vgai-chrome-island vgai-glass-island"
+      className="volter-camera-info volter-chrome-island volter-glass-island"
       data-island-scale="compact"
     >
       <Inline gap={8} align="center" style={{ whiteSpace: 'nowrap' }}>

package/src/kit/components/InspectorObjectPreview.tsx

@@ -39,7 +39,7 @@ export function InspectorObjectPreview({
               width: '100%',
               height: 220,
               minHeight: 220,
-              borderBottom: '1px solid var(--vgai-structural-divider)',
+              borderBottom: '1px solid var(--volter-structural-divider)',
               overflow: 'hidden',
               position: 'relative',
             }

package/src/kit/components/Object3DDocumentToolbar.tsx

@@ -203,7 +203,7 @@ export function Object3DDocumentToolbar({
     if (!assetPath) return;
     setError(null);
     try {
-      // The shell owns where a framing is RECORDED (`.vgai/thumbnails.json`,
+      // The shell owns where a framing is RECORDED (`.volter/thumbnails.json`,
       // written through the project-file route); this surface only knows the
       // asset and the pose. See `object3d-document-write-policy.ts`.
       await object3DDocumentWritePolicy().saveThumbnailFraming(
@@ -230,11 +230,11 @@ export function Object3DDocumentToolbar({
 
   const frameLabel = session.selection().length > 0 ? 'Frame selection' : 'Frame all';
   return (
-    <div className="vgai-model-document-header">
+    <div className="volter-model-document-header">
       <EditorToolbar
         compact
         label="Viewport view controls"
-        className="vgai-model-viewport-toolbar vgai-model-viewport-toolbar--view"
+        className="volter-model-viewport-toolbar volter-model-viewport-toolbar--view"
       >
         {/* THE BUTTON SAYS WHAT IT DOES. `session.frame()` frames the
             selection when there is one and the whole subject when there is
@@ -248,7 +248,7 @@ export function Object3DDocumentToolbar({
             <EditorIcon icon={faExpand} size="md" />
           </IconButton>
         </Tooltip>
-        <div className="vgai-viewport-popover-anchor">
+        <div className="volter-viewport-popover-anchor">
           <Tooltip text="Camera orientation and projection">
             <Button
               ref={viewRef}
@@ -264,7 +264,7 @@ export function Object3DDocumentToolbar({
               aria-haspopup="menu"
               aria-expanded={viewOpen}
               onClick={() => setViewOpen((open) => !open)}
-              className="vgai-model-toolbar-labelled-control"
+              className="volter-model-toolbar-labelled-control"
             >
               <EditorIcon icon={faCube} size="sm" />
               <span>
@@ -306,7 +306,7 @@ export function Object3DDocumentToolbar({
                     setViewOpen(false);
                   }}
                 >
-                  <span className="vgai-menu-check">
+                  <span className="volter-menu-check">
                     {presentation.projection === projection && (
                       <EditorIcon icon={faCheck} size="xs" />
                     )}
@@ -338,7 +338,7 @@ export function Object3DDocumentToolbar({
       <EditorToolbar
         compact
         label="Viewport preview controls"
-        className="vgai-model-viewport-toolbar vgai-model-viewport-toolbar--preview"
+        className="volter-model-viewport-toolbar volter-model-viewport-toolbar--preview"
       >
         {/* THE DISPLAY CONTROLS SIT AT THE TRAILING EDGE, which is where
             Blender's are: its 3D View header packs Visibility, Gizmo,
@@ -463,7 +463,7 @@ export function Object3DDocumentToolbar({
                 }))),
           ]}
         />
-        <div className="vgai-viewport-popover-anchor">
+        <div className="volter-viewport-popover-anchor">
           <Tooltip text="Asset preview actions">
             <IconButton
               ref={moreRef}
@@ -527,7 +527,7 @@ export function Object3DDocumentToolbar({
         </div>
       </EditorToolbar>
       {capture ? (
-        <EditorPopover className="vgai-model-capture-preview">
+        <EditorPopover className="volter-model-capture-preview">
           <div>
             <Text as="strong" variant="label">
               Deterministic views
@@ -540,7 +540,7 @@ export function Object3DDocumentToolbar({
         </EditorPopover>
       ) : null}
       {error ? (
-        <EditorBanner className="vgai-model-toolbar-error" tone="error">
+        <EditorBanner className="volter-model-toolbar-error" tone="error">
           {error}
         </EditorBanner>
       ) : null}