@volter/editor-threejs 0.5.67 → 0.5.69

package/src/kit/components/StageHost.tsx

@@ -1327,17 +1327,17 @@ export function Object3DDocumentViewport({
           }
           // AN OBJECT DRAWN BY A HELPER is picked through it: a document that draws an object's
           // overlay itself (a Blender camera's wire, a light's icon) marks each part with the
-          // object it stands for (`userData.vgaiPicksAs`), and the nearer hit wins, as Blender's
+          // object it stands for (`userData.volterPicksAs`), and the nearer hit wins, as Blender's
           // pick over its whole drawing does.
-          // Only helpers that say they can be picked (`userData.vgaiPickable`) are asked, and a
+          // Only helpers that say they can be picked (`userData.volterPickable`) are asked, and a
           // part is hit only where it is shown (three's raycast reads layers, not `visible`).
-          const pickable = viewport.visibleHelpers().filter((helper) => helper.userData['vgaiPickable'] === true);
+          const pickable = viewport.visibleHelpers().filter((helper) => helper.userData['volterPickable'] === true);
           for (const hit of raycaster.intersectObjects(pickable, true)) {
             let proxy: THREE.Object3D | null = null;
             let shown = true;
             for (let object: THREE.Object3D | null = hit.object; object; object = object.parent) {
               if (!object.visible) shown = false;
-              proxy ??= (object.userData['vgaiPicksAs'] as THREE.Object3D | undefined) ?? null;
+              proxy ??= (object.userData['volterPicksAs'] as THREE.Object3D | undefined) ?? null;
             }
             if (!shown) continue;
             const id = proxy ? idOf(proxy) : null;
@@ -1402,7 +1402,7 @@ export function Object3DDocumentViewport({
           // Under a group of the stage's own, which the view's presentation shows only while it
           // lights by the document's studio; the document keeps its say over what is inside.
           const viewLockedHolder = new THREE.Group();
-          viewLockedHolder.name = 'vgai:document-studio';
+          viewLockedHolder.name = 'volter:document-studio';
           viewLockedHolder.add(dressingViewLocked);
           camera.add(viewLockedHolder);
           host.documentStudio = viewLockedHolder;
@@ -2373,8 +2373,8 @@ export function Object3DDocumentViewport({
   const viewport = (
     <div
       data-testid="tool-object3d-authoring"
-      data-vgai-chromeless={chromeless || undefined}
-      className={studioStage ? 'vgai-object3d-studio-stage' : undefined}
+      data-volter-chromeless={chromeless || undefined}
+      className={studioStage ? 'volter-object3d-studio-stage' : undefined}
       style={{
         position: chromeless || hasShell ? 'relative' : 'absolute',
         // Inside the Asset Editor shell the stage fills its own box exactly;
@@ -2446,20 +2446,20 @@ export function Object3DDocumentViewport({
               top: 0,
               display: 'flex',
               justifyContent: 'center',
-              padding: 'var(--vgai-space-3)',
+              padding: 'var(--volter-space-3)',
               pointerEvents: 'none',
             }}
           >
             <div
-              className="vgai-chrome-island"
+              className="volter-chrome-island"
               style={{
                 display: 'flex',
                 alignItems: 'center',
-                gap: 'var(--vgai-space-3)',
+                gap: 'var(--volter-space-3)',
                 maxWidth: '80%',
-                padding: 'var(--vgai-space-2) var(--vgai-space-3)',
-                borderRadius: 'var(--vgai-radius-md)',
-                border: `var(--vgai-stroke-resting) solid ${themeVars.semantic.danger}`,
+                padding: 'var(--volter-space-2) var(--volter-space-3)',
+                borderRadius: 'var(--volter-radius-md)',
+                border: `var(--volter-stroke-resting) solid ${themeVars.semantic.danger}`,
                 background: themeVars.surface.raised,
                 color: themeVars.semantic.danger,
                 pointerEvents: 'auto',
@@ -2530,7 +2530,7 @@ export function Object3DDocumentViewport({
       selection={readSelection}
       fill
     >
-      <div className="vgai-object3d-asset-workspace">
+      <div className="volter-object3d-asset-workspace">
         {viewport}
         {/* Where the deleted preview strip was. It draws nothing until this
             stage's transport has a subject, so a document with nothing to show

package/src/kit/components/StatsOverlay.tsx

@@ -25,11 +25,11 @@ export function StatsOverlay() {
     // same corner. Given the same border/radius treatment as its siblings so
     // the whole corner reads as one family.
     // P6-U6 (owner taste decision 3: HUD overlays → real islands): the paint
-    // moved to `.vgai-hud-overlay` so islands chrome can promote it to the
+    // moved to `.volter-hud-overlay` so islands chrome can promote it to the
     // shared glass-island material (compact tier); bars chrome paints the
     // exact pre-U6 overlay-whisper recipe from the same class.
     <div
-      className="vgai-hud-overlay vgai-chrome-island vgai-glass-island"
+      className="volter-hud-overlay volter-chrome-island volter-glass-island"
       data-island-scale="compact"
       data-hud-border="strong"
       style={{
@@ -39,11 +39,11 @@ export function StatsOverlay() {
         // floating header-island clearance, scoped in theme.css); the bare
         // fallback is the pre-glass 48px so treatment-less chrome ("bars":
         // graphite/classic/lite/reduced) stays pixel-identical to main.
-        top: 'var(--vgai-viewport-overlay-hud-top, 48px)',
+        top: 'var(--volter-viewport-overlay-hud-top, 48px)',
         right: 8,
         padding: '6px 10px',
         pointerEvents: 'auto',
-        fontSize: 'var(--vgai-font-base)',
+        fontSize: 'var(--volter-font-base)',
         color: themeVars.content.primary,
         fontFamily: themeVars.typography.mono,
         lineHeight: '16px',

package/src/kit/components/ViewportFurniture.tsx

@@ -369,17 +369,17 @@ export function ViewportFurniture({
         aria-hidden="true"
         style={{
           position: 'absolute',
-          top: 'var(--vgai-space-3)',
+          top: 'var(--volter-space-3)',
           // Clear of the tool rail at the stage's left edge (Blender's text
           // starts past its toolbar): the rail is one control wide plus its
           // own inset.
-          left: 'calc(var(--vgai-space-4) + var(--vgai-control-comfortable-height) * 2 + var(--vgai-space-4))',
+          left: 'calc(var(--volter-space-4) + var(--volter-control-comfortable-height) * 2 + var(--volter-space-4))',
           display: 'flex',
           flexDirection: 'column',
-          gap: 'var(--vgai-space-1)',
-          fontSize: 'var(--vgai-font-sm)',
+          gap: 'var(--volter-space-1)',
+          fontSize: 'var(--volter-font-sm)',
           color: overlayInk,
-          textShadow: 'var(--vgai-content-text-shadow, none)',
+          textShadow: 'var(--volter-content-text-shadow, none)',
           pointerEvents: 'none',
           userSelect: 'none',
         }}
@@ -396,7 +396,7 @@ export function ViewportFurniture({
               // The column's own rows keep the block's line step; the block
               // itself stands off the lines above it. See
               // `STATISTICS_BLOCK_OFFSET`.
-              rowGap: 'var(--vgai-space-1)',
+              rowGap: 'var(--volter-space-1)',
               marginTop: spaceVar[STATISTICS_BLOCK_OFFSET],
             }}
           >
@@ -412,15 +412,15 @@ export function ViewportFurniture({
       ) : null}
       {chrome.viewName === 'menu' ? (
         <div
-          className="vgai-viewport-view-pill"
+          className="volter-viewport-view-pill"
           style={{
             position: 'absolute',
-            top: 'var(--vgai-viewport-overlay-top, var(--vgai-space-4))',
+            top: 'var(--volter-viewport-overlay-top, var(--volter-space-4))',
             // Past the shelf rail when it draws anything, as the view text is; at the edge when
-            // it is empty (`data-vgai-stage-rail`, `workspace-surfaces.css`).
+            // it is empty (`data-volter-stage-rail`, `workspace-surfaces.css`).
             left:
-              'var(--vgai-stage-name-left, calc(var(--vgai-space-4) + var(--vgai-control-comfortable-height) * 2 + var(--vgai-space-4)))',
-            zIndex: 'calc(var(--vgai-z-dropdown, 1000) - 1)',
+              'var(--volter-stage-name-left, calc(var(--volter-space-4) + var(--volter-control-comfortable-height) * 2 + var(--volter-space-4)))',
+            zIndex: 'calc(var(--volter-z-dropdown, 1000) - 1)',
             pointerEvents: 'auto',
           }}
         >
@@ -433,7 +433,7 @@ export function ViewportFurniture({
         <button
           type="button"
           data-testid="viewport-view-name"
-          className="vgai-viewport-gizmo-label"
+          className="volter-viewport-gizmo-label"
           aria-label={drawn === 'perspective' ? 'Switch to orthographic' : 'Switch to perspective'}
           onClick={() => {
             const next = drawn === 'perspective' ? 'orthographic' : 'perspective';
@@ -447,13 +447,13 @@ export function ViewportFurniture({
             transform: 'translateX(50%)',
             display: 'inline-flex',
             alignItems: 'center',
-            gap: 'var(--vgai-space-1)',
+            gap: 'var(--volter-space-1)',
             padding: 0,
             border: 0,
             background: 'none',
-            fontSize: 'var(--vgai-font-sm)',
+            fontSize: 'var(--volter-font-sm)',
             color: overlayInk,
-            textShadow: 'var(--vgai-content-text-shadow, none)',
+            textShadow: 'var(--volter-content-text-shadow, none)',
             cursor: 'pointer',
             pointerEvents: 'auto',
           }}
@@ -475,7 +475,7 @@ export function ViewportFurniture({
         role="toolbar"
         aria-label="Navigation"
         aria-orientation="vertical"
-        className="vgai-chrome-island vgai-viewport-navigation"
+        className="volter-chrome-island volter-viewport-navigation"
         style={{
           position: 'absolute',
           top: CLUSTER_TOP,
@@ -487,17 +487,17 @@ export function ViewportFurniture({
           // 2836); at 12 it is 9.0.
           // UNGATED, like every other number this cluster carries: its 28 and
           // 16 are Blender's for every skin already (`theme.css`'s
-          // `.vgai-viewport-navigation` block, no palette selector), and the
+          // `.volter-viewport-navigation` block, no palette selector), and the
           // estate's `css-style-identity-selector` gate forbids one anyway.
-          right: 'var(--vgai-space-6)',
+          right: 'var(--volter-space-6)',
           display: 'flex',
           flexDirection: 'column',
-          gap: 'var(--vgai-space-1)',
+          gap: 'var(--volter-space-1)',
           // Blender's capsule is exactly as wide as its buttons: it insets
           // only along the column.
-          padding: 'var(--vgai-space-1) 0',
-          borderRadius: 'var(--vgai-radius-full)',
-          background: 'var(--vgai-island-surface, var(--vgai-surface-overlay))',
+          padding: 'var(--volter-space-1) 0',
+          borderRadius: 'var(--volter-radius-full)',
+          background: 'var(--volter-island-surface, var(--volter-surface-overlay))',
           pointerEvents: 'auto',
         }}
       >

package/src/kit/components/ViewportOverlay.tsx

@@ -41,7 +41,7 @@ import { stageViewName } from './stage-view-name';
  * GRID is the stage's VIEW's switch (`overlays.grid.visible` in
  * `kit/viewport-presentation`, keyed by `documentId`): the one flag this
  * button, the document's header, the `toggle.grid` action, `set-grid` and
- * `vgai status`'s `showGrid` all read and write.
+ * the editor's `status` command's `showGrid` all read and write.
  */
 export function ViewportOverlay({
   store,
@@ -71,8 +71,8 @@ export function ViewportOverlay({
   const [anchor, setAnchor] = useState<HTMLSpanElement | null>(null);
   const findSlot = (): HTMLElement | null =>
     anchor
-      ?.closest('.vgai-dock-document-content')
-      ?.querySelector<HTMLElement>(':scope > .vgai-stage-bar [data-stage-bar-slot="display"]') ?? null;
+      ?.closest('.volter-dock-document-content')
+      ?.querySelector<HTMLElement>(':scope > .volter-stage-bar [data-stage-bar-slot="display"]') ?? null;
   // ONE OVERLAY PER SLOT: a document hosting two stages has one bar, so the first overlay to
   // claim its slot draws there and any other keeps its own place.
   const owner = useId();
@@ -96,7 +96,7 @@ export function ViewportOverlay({
   const toolbar = (
     <FloatingToolbar
       label="Viewport display"
-      className="vgai-viewport-toolbar vgai-viewport-toolbar-right vgai-stage-display"
+      className="volter-viewport-toolbar volter-viewport-toolbar-right volter-stage-display"
     >
       {chrome.viewName === 'bar' && session ? (
         <ViewportViewMenu

package/src/kit/components/ViewportShadingMenu.tsx

@@ -130,7 +130,7 @@ function ViewportShadingGlyph({
   return (
     <svg
       viewBox="0 0 16 16"
-      className="vgai-viewport-shading-glyph"
+      className="volter-viewport-shading-glyph"
       aria-hidden="true"
       focusable="false"
     >
@@ -148,7 +148,7 @@ function ViewportShadingGlyph({
       ) : null}
       {glyph === 'rendered' ? (
         // Blender's Rendered mark is a lit ball: the filled disc with a highlight up and left.
-        <circle cx="5.6" cy="5.6" r="2.3" fill="var(--vgai-surface-overlay, #ffffff)" fillOpacity="0.7" />
+        <circle cx="5.6" cy="5.6" r="2.3" fill="var(--volter-surface-overlay, #ffffff)" fillOpacity="0.7" />
       ) : null}
       {glyph === 'preview' ? (
         <path
@@ -185,7 +185,7 @@ export function ViewportDisplayModeMenu<T extends string>({
   const menu =
     open && !disabled ? (
       <AnchoredMenu
-        id="vgai-viewport-shading-menu"
+        id="volter-viewport-shading-menu"
         anchorRef={ref}
         aria-label="Viewport shading modes"
         onDismiss={() => setOpen(false)}
@@ -224,7 +224,7 @@ export function ViewportDisplayModeMenu<T extends string>({
         {children ? (
           <>
             <MenuSeparator />
-            <div className="vgai-viewport-shading-options">{children}</div>
+            <div className="volter-viewport-shading-options">{children}</div>
           </>
         ) : null}
       </AnchoredMenu>
@@ -237,8 +237,8 @@ export function ViewportDisplayModeMenu<T extends string>({
     // corners and a shared border — so the five read as one widget with one
     // cell lit, and `aria-pressed` is the only thing that paints the lit one.
     return (
-      <div className="vgai-viewport-popover-anchor">
-        <span className="vgai-viewport-shading-segments" role="group" aria-label="Viewport shading">
+      <div className="volter-viewport-popover-anchor">
+        <span className="volter-viewport-shading-segments" role="group" aria-label="Viewport shading">
           {segments.map((segment) => (
             <Tooltip key={segment.mode} text={`Viewport shading: ${segment.label}`}>
               <IconButton
@@ -263,7 +263,7 @@ export function ViewportDisplayModeMenu<T extends string>({
               aria-label="Shading options"
               aria-haspopup="menu"
               aria-expanded={open}
-              aria-controls={open ? 'vgai-viewport-shading-menu' : undefined}
+              aria-controls={open ? 'volter-viewport-shading-menu' : undefined}
               disabled={disabled}
               onClick={() => setOpen((value) => !value)}
             >
@@ -286,7 +286,7 @@ export function ViewportDisplayModeMenu<T extends string>({
             a bordered well: measured in `modeling-object-none.png`, `Object
             Mode v` is #272727 inside a 1px #3c3c3c border, 20px tall, on a
             #343434 header. `secondary` is this estate's select-like trigger
-            already (FontPicker's `.vgai-field-trigger`), so no new variant. */}
+            already (FontPicker's `.volter-field-trigger`), so no new variant. */}
         <Button
           ref={ref}
           type="button"
@@ -295,7 +295,7 @@ export function ViewportDisplayModeMenu<T extends string>({
           aria-label={`Viewport shading: ${active.label}`}
           aria-haspopup="menu"
           aria-expanded={open}
-          aria-controls={open ? 'vgai-viewport-shading-menu' : undefined}
+          aria-controls={open ? 'volter-viewport-shading-menu' : undefined}
           disabled={disabled}
           onClick={() => setOpen((value) => !value)}
           style={{ display: 'inline-flex', alignItems: 'center', gap: 5, minWidth: 66 }}

package/src/kit/components/ViewportViewMenu.tsx

@@ -86,7 +86,7 @@ export function ViewportViewMenu({
   };
 
   return (
-    <div ref={anchor} className="vgai-viewport-popover-anchor">
+    <div ref={anchor} className="volter-viewport-popover-anchor">
       {label === undefined ? (
         <Tooltip text={projection === 'perspective' ? 'Perspective' : 'Orthographic'}>
           <IconButton

package/src/kit/components/stage-presence-markers.ts

@@ -57,7 +57,7 @@ interface RemoteRayMarker {
 
 /**
  * Remote-camera labels paint into a DETACHED canvas, and a 2D context cannot
- * resolve `var(--vgai-…)` — so the theme's value has to be read off the live
+ * resolve `var(--volter-…)` — so the theme's value has to be read off the live
  * theme root before it reaches `fillStyle`. Before a theme is installed (unit
  * environments), fall back to the default theme's own value rather than a raw
  * literal, so the label never depends on a color the theme contract doesn't own.
@@ -65,7 +65,7 @@ interface RemoteRayMarker {
 function contentOnAccentColor(): string {
   const root = document.querySelector(`.${EDITOR_THEME_CLASS}`);
   const resolved = root
-    ? getComputedStyle(root).getPropertyValue('--vgai-content-on-accent').trim()
+    ? getComputedStyle(root).getPropertyValue('--volter-content-on-accent').trim()
     : '';
   return resolved || graphiteDarkEditorTheme.color.content.onAccent;
 }

package/src/kit/components/standard-viewport-dressing.ts

@@ -78,7 +78,7 @@ export interface BackdropStops {
  */
 export function paletteBackdropStops(): BackdropStops {
   const root =
-    typeof document === 'undefined' ? null : document.querySelector('[data-vgai-palette]');
+    typeof document === 'undefined' ? null : document.querySelector('[data-volter-palette]');
   if (!root) return { bottom: GRADIENT_BOTTOM.clone(), top: GRADIENT_TOP.clone() };
   const style = getComputedStyle(root);
   const canvas = document.createElement('canvas');
@@ -91,15 +91,15 @@ export function paletteBackdropStops(): BackdropStops {
     // their CSS colors over the shell; Three.Color has no alpha channel.
     context.fillStyle = fallback.getStyle();
     context.fillRect(0, 0, 1, 1);
-    context.fillStyle = style.getPropertyValue('--vgai-surface-shell').trim();
+    context.fillStyle = style.getPropertyValue('--volter-surface-shell').trim();
     context.fillRect(0, 0, 1, 1);
     context.fillStyle = value;
     context.fillRect(0, 0, 1, 1);
     const [r, g, b] = context.getImageData(0, 0, 1, 1).data;
     return new THREE.Color().setRGB(r! / 255, g! / 255, b! / 255, THREE.SRGBColorSpace);
   };
-  const panel = read('--vgai-surface-panel', GRADIENT_BOTTOM);
-  const raised = read('--vgai-surface-raised', GRADIENT_TOP);
+  const panel = read('--volter-surface-panel', GRADIENT_BOTTOM);
+  const raised = read('--volter-surface-raised', GRADIENT_TOP);
   // A background texture is not tone-mapped, so what is authored here is
   // what the screen shows. The small lift keeps the ground a step above the
   // panel it sits beside (Blender's viewport is lighter than its editors).
@@ -112,14 +112,14 @@ export function paletteBackdropStops(): BackdropStops {
 
 /**
  * Fires when the palette the backdrop follows changes. The theme installer
- * stamps its root with `data-vgai-palette` / `data-vgai-material` on every
+ * stamps its root with `data-volter-palette` / `data-volter-material` on every
  * switch, so the DOM is the contract here — a document stage never imports
  * the shell's preference store (its closure is pinned,
  * `scripts/validate-editor-closure.mjs`). Returns the unsubscribe.
  */
 export function watchPaletteBackdrop(onChange: () => void): () => void {
   if (typeof document === 'undefined' || typeof MutationObserver === 'undefined') return () => {};
-  const root = document.querySelector('[data-vgai-palette]');
+  const root = document.querySelector('[data-volter-palette]');
   if (!root) return () => {};
   const observer = new MutationObserver(() => {
     onChange();
@@ -127,7 +127,7 @@ export function watchPaletteBackdrop(onChange: () => void): () => void {
   });
   observer.observe(root, {
     attributes: true,
-    attributeFilter: ['data-vgai-palette', 'data-vgai-material'],
+    attributeFilter: ['data-volter-palette', 'data-volter-material'],
   });
   return () => observer.disconnect();
 }
@@ -248,7 +248,7 @@ export function applyGridDistanceFade(material: THREE.Material, gridSize: number
       );
   };
   // Distinct fade bands must not share one cached program.
-  material.customProgramCacheKey = () => `vgai-grid-fade:${fadeStart}:${fadeEnd}`;
+  material.customProgramCacheKey = () => `volter-grid-fade:${fadeStart}:${fadeEnd}`;
 }
 
 export interface StandardViewportDressingOptions {
@@ -302,7 +302,7 @@ export function applyStandardViewportDressing(
     // document stage is lit by its view's presentation instead (`StagePresentationRig`, and
     // `StageHost` turns this key off); a stage without a presentation still gets this one.
     const key = new THREE.DirectionalLight(0xfff3dd, 1.9);
-    key.name = 'vgai:standard-dressing-key';
+    key.name = 'volter:standard-dressing-key';
     key.position.set(6, 10, -4);
     key.castShadow = true;
     // `userData.editorHelper` keeps it out of hierarchy walks and picks;
@@ -336,7 +336,7 @@ export function applyStandardViewportDressing(
     gridMaterial.opacity = 0.35;
     gridMaterial.depthWrite = false;
     applyGridDistanceFade(gridMaterial, size);
-    helper.name = 'vgai:standard-dressing-grid';
+    helper.name = 'volter:standard-dressing-grid';
     // Just below the ground line so content standing exactly on y=0 never
     // z-fights the grid lines; centred on the content's own footprint.
     helper.position.set(centre[0], -0.02, centre[1]);
@@ -402,7 +402,7 @@ const LIGHT_DISTANCE = 12;
  * else on the page fills.
  */
 const GODOT_FILMIC = /* glsl */ `
-vec3 vgaiHable( vec3 x ) {
+vec3 volterHable( vec3 x ) {
 	const float A = 0.22 * 4.0;
 	const float B = 0.30 * 2.0;
 	const float C = 0.10;
@@ -413,7 +413,7 @@ vec3 vgaiHable( vec3 x ) {
 }
 vec3 CustomToneMapping( vec3 color ) {
 	color *= toneMappingExposure;
-	return clamp( vgaiHable( max( vec3( 0.0 ), color ) ) / vgaiHable( vec3( 1.0 ) ), 0.0, 1.0 );
+	return clamp( volterHable( max( vec3( 0.0 ), color ) ) / volterHable( vec3( 1.0 ) ), 0.0, 1.0 );
 }`;
 {
   const chunk = THREE.ShaderChunk.tonemapping_pars_fragment;
@@ -548,7 +548,7 @@ function fadingFloorMaterial(): THREE.MeshStandardMaterial {
         `#include <dithering_fragment>\ngl_FragColor.a *= 1.0 - smoothstep(${(half * 0.3).toFixed(1)}, ${(half * 0.95).toFixed(1)}, length(vFloorPlane));`,
       );
   };
-  material.customProgramCacheKey = () => 'vgai-fading-floor';
+  material.customProgramCacheKey = () => 'volter-fading-floor';
   return material;
 }
 
@@ -595,19 +595,19 @@ export class StagePresentationRig {
 
   /** `onReady`: an environment image arrived after the apply that asked for it; draw again. */
   constructor(scene: THREE.Scene, private readonly onReady?: () => void) {
-    this.group.name = 'vgai:stage-presentation-rig';
+    this.group.name = 'volter:stage-presentation-rig';
     // Kept out of hierarchy walks and picks, like every editor helper.
     this.group.userData['editorHelper'] = true;
     this.group.add(this.ambient);
     scene.add(this.group);
-    this.previewGroup.name = 'vgai:stage-preview-rig';
+    this.previewGroup.name = 'volter:stage-preview-rig';
     this.previewGroup.userData['editorHelper'] = true;
-    this.sun.name = 'vgai:preview-sun';
+    this.sun.name = 'volter:preview-sun';
     this.sun.userData['editorHelper'] = true;
     this.previewGroup.add(this.sun, this.sun.target);
     this.previewGroup.visible = false;
     scene.add(this.previewGroup);
-    this.floor.name = 'vgai:preview-floor';
+    this.floor.name = 'volter:preview-floor';
     this.floor.userData['editorHelper'] = true;
     this.floor.receiveShadow = true;
     // Transparent now (its fade), so it is sorted with the grid: drawn first, under it.
@@ -1013,7 +1013,7 @@ export class StagePresentationRig {
     this.ambient.intensity = preset.ambient.intensity;
     for (const spec of preset.lights) {
       const light = new THREE.DirectionalLight(spec.color, spec.intensity);
-      light.name = `vgai:studio-light:${preset.id}`;
+      light.name = `volter:studio-light:${preset.id}`;
       light.castShadow = spec.castShadow === true;
       light.userData['editorHelper'] = true;
       this.group.add(light);

package/src/kit/editor-shell-store.ts

@@ -612,7 +612,7 @@ export class EditorShellStore {
       renderer.setRenderTarget(sceneTarget);
       // The same view policy the on-screen draw applies (`scene-view-fog.ts`).
       // This capture is the ONLY look anyone gets at the Edit viewport — the
-      // `vgai screenshot` evidence and every project thumbnail — so a capture
+      // the editor's `screenshot` command evidence and every project thumbnail — so a capture
       // that renders the game's fog while the viewport does not would make the
       // one door onto the image disagree with the image.
       withSceneFogNeutralized(this._scene, () =>

package/src/kit/editor-viewport.ts

@@ -611,7 +611,7 @@ export const COMPASS_CLUSTER_TOP_PX =
  * at the same pixels.
  */
 export const GRAZING_FADE_GLSL = /* glsl */ `
-float vgaiGrazingFade(vec3 worldPosition, vec3 eye, vec3 planeNormal, float amount) {
+float volterGrazingFade(vec3 worldPosition, vec3 eye, vec3 planeNormal, float amount) {
   vec3 toEye = eye - worldPosition;
   float toEyeLength = max(length(toEye), 1e-6);
   float graze = 1.0 - abs(dot(toEye / toEyeLength, planeNormal));
@@ -686,10 +686,10 @@ function applyAxisGrazingFade(
       )
       .replace(
         'gl_FragColor = vec4( diffuseColor.rgb, alpha );',
-        'gl_FragColor = vec4( diffuseColor.rgb, alpha * vgaiGrazingFade( vAxisWorld, cameraPosition, uPlaneNormal, uGrazingFade ) );',
+        'gl_FragColor = vec4( diffuseColor.rgb, alpha * volterGrazingFade( vAxisWorld, cameraPosition, uPlaneNormal, uGrazingFade ) );',
       );
   };
-  material.customProgramCacheKey = () => 'vgai-axis-grazing-fade';
+  material.customProgramCacheKey = () => 'volter-axis-grazing-fade';
 }
 
 const _gridView = new THREE.Vector3();
@@ -824,7 +824,7 @@ function createFloorGrid(extent: number): THREE.Mesh<THREE.PlaneGeometry, THREE.
         // Blender's own grazing-angle profile, transcribed from its frames
         // (see GRAZING_FADE_GLSL above). Without it this lattice reads the
         // same ink at the front of the frame and at the horizon.
-        fade *= vgaiGrazingFade(vWorld, cameraPosition, uPlaneNormal, uGrazingFade);
+        fade *= volterGrazingFade(vWorld, cameraPosition, uPlaneNormal, uGrazingFade);
         float alpha = line * fade * uOpacity;
         if (alpha <= 0.002) discard;
         // WHICH level a fragment belongs to is the major's SHARE of the
@@ -1731,7 +1731,7 @@ export class EditorViewport {
       this._vertexSnapIndicator,
     ];
 
-    // D12 (B4) — publish the camera/canvas seam `VgaiSceneAuthoringAdapter.pickable`
+    // D12 (B4) — publish the camera/canvas seam `VolterSceneAuthoringAdapter.pickable`
     // needs (it has no other way to reach them). Cleared in `dispose()`.
     if (this._publishPickContext) {
       this._installPickContext(this.camera);
@@ -2363,8 +2363,8 @@ export class EditorViewport {
       // two competing selection languages and obscures the draggable handle.
       if ([...this._constraintHelpers.values()].some((helper) => helper.presents(obj))) continue;
       // Nor over an object whose document draws its overlay itself, selection colour included
-      // (`userData.vgaiOwnOverlay`: a Blender camera, light or empty).
-      if (obj.userData['vgaiOwnOverlay']) continue;
+      // (`userData.volterOwnOverlay`: a Blender camera, light or empty).
+      if (obj.userData['volterOwnOverlay']) continue;
       add(
         `selection:${id}`,
         new SelectionBrackets(obj, {
@@ -2759,9 +2759,9 @@ export class EditorViewport {
   }
 
   /** A light the editor draws a helper for: not one whose document draws its own overlay
-   *  (`userData.vgaiOwnOverlay`, the way `vgaiOwnMaterial` keeps a material its owner's). */
+   *  (`userData.volterOwnOverlay`, the way `volterOwnMaterial` keeps a material its owner's). */
   private _nativeLight(object: THREE.Object3D): THREE.Light | null {
-    if (object.userData['vgaiOwnOverlay']) return null;
+    if (object.userData['volterOwnOverlay']) return null;
     return (object as THREE.Light).isLight ? (object as THREE.Light) : null;
   }
 
@@ -2939,7 +2939,7 @@ export class EditorViewport {
   }
 
   private _nativeCamera(object: THREE.Object3D): THREE.Camera | null {
-    if (object.userData['vgaiOwnOverlay']) return null;
+    if (object.userData['volterOwnOverlay']) return null;
     if ((object as THREE.Camera).isCamera) return object as THREE.Camera;
     const owned = getUserData(object, '_camera');
     return owned?.isCamera ? owned : null;
@@ -3733,7 +3733,7 @@ export class EditorViewport {
   }
 
   /** The helper groups on screen now (`setHelper`), for a pick that lets a helper stand for the
-   *  object it draws (`userData.vgaiPicksAs`). */
+   *  object it draws (`userData.volterPicksAs`). */
   visibleHelpers(): THREE.Object3D[] {
     return [...this._helpers.values()].filter((helper) => helper.visible && helper.parent !== null);
   }
@@ -5577,10 +5577,10 @@ export class EditorViewport {
           ownMaterial &&
           mesh.material &&
           !Array.isArray(mesh.material) &&
-          !mesh.userData['vgaiOwnMaterial']
+          !mesh.userData['volterOwnMaterial']
         ) {
           mesh.material = (mesh.material as THREE.Material).clone();
-          mesh.userData['vgaiOwnMaterial'] = true;
+          mesh.userData['volterOwnMaterial'] = true;
         }
         const material = mesh.material as
           | (THREE.MeshBasicMaterial & { _color?: THREE.Color | undefined })
@@ -5593,7 +5593,7 @@ export class EditorViewport {
           // translucent); three caches it like the colour, so the cache is dropped too.
           // Handles only: the drag's axis lines (the `helper` family) keep three's own.
           if (handles) {
-            const base = (material.userData['vgaiBaseOpacity'] ??= material.opacity) as number;
+            const base = (material.userData['volterBaseOpacity'] ??= material.opacity) as number;
             material.opacity = base * (this._gizmoLook.opacity ?? 1);
             (material as { _opacity?: number | undefined })._opacity = undefined;
           }
@@ -6159,7 +6159,7 @@ export class EditorViewport {
           pointerEvents: 'none',
           zIndex: zIndex.sticky,
         });
-        // INSIDE the theme scope, never document.body: the `--vgai-*` tokens
+        // INSIDE the theme scope, never document.body: the `--volter-*` tokens
         // live on `#editor-chrome-root` (deliberately not `:root`), so a
         // body-parented div resolves both colors to nothing and the rubber
         // band is INVISIBLE — three human passes marqueed blind, reading the
@@ -6338,7 +6338,7 @@ export class EditorViewport {
 
     // D12 (B4) — topmost-first layered pick: the composite's non-threejs
     // children (react/pixi design-time layers) are tried topmost-first before
-    // falling through to the three raycast (now `VgaiSceneAuthoringAdapter
+    // falling through to the three raycast (now `VolterSceneAuthoringAdapter
     // .pickable`) — see `pickTopmost`'s doc comment. Note: an INTERACTIVE
     // layer (session `interactive` toggle, B1) is mutually exclusive with this
     // walk running at all, by construction — its `pointer-events:auto` DOM
@@ -6489,7 +6489,7 @@ export class EditorViewport {
       background: themeVars.accent.muted,
       zIndex: zIndex.base,
     });
-    // Same class as the marquee band: `--vgai-*` resolves only under
+    // Same class as the marquee band: `--volter-*` resolves only under
     // `#editor-chrome-root`, so a body-parented overlay draws with NO border
     // or fill — the drag-to-viewport highlight has been invisible.
     (document.getElementById('editor-chrome-root') ?? document.body).appendChild(overlay);

package/src/kit/live-module-source.ts

@@ -4,7 +4,7 @@
  * (`catalog/project-source/src/tools/module-source.ts`), and deliberately the
  * SAME contract: a project TypeScript module whose export builds a native
  * `THREE.Object3D`. `project.bake.module` / `project.bake.preview` /
- * `vgai screenshot <module>` already define that contract; the live modeling
+ * the editor's `screenshot <module>` command already define that contract; the live modeling
  * document opens the same thing, so a module that bakes opens, and a module
  * that opens bakes (docs/BLENDER-PARITY.md §The model file).
  *