@volter/editor-threejs 0.5.67 → 0.5.69

package/src/kit/projection/three.ts

@@ -61,7 +61,7 @@ export type ThreeNode = ProjectedNode<THREE.Object3D>;
 
 /**
  * Reflection stats for one walk. Surfaced by the adapters' `refresh()` for
- * proof/telemetry (the ingest console line, the `__vgaiIngest.reflected` hook) —
+ * proof/telemetry (the ingest console line, the `__volterIngest.reflected` hook) —
  * deliberately a fresh measurement each walk rather than a mount-time snapshot,
  * because a running world keeps streaming objects in.
  */
@@ -76,7 +76,7 @@ export interface ThreeWalkStats {
    * object drawing N units — so `count`/`meshes` (and the hierarchy rows built
    * from the same nodes) report 1 where a reader sees N, with no error
    * anywhere, because both numbers are individually correct. These two fields
-   * are the only place the shortfall is expressible; `vgai doctor`'s
+   * are the only place the shortfall is expressible; a probe's
    * instanced-content check reads exactly this pair
    * (`packages/editor/src/doctor/detection-gaps.ts`).
    */
@@ -254,7 +254,7 @@ export function threeEntityId(worldId: string, oid: string): string {
 }
 
 /**
- * The LIVE OID scheme. A node stamped by the served TSX's `__vgaiOid` transform
+ * The LIVE OID scheme. A node stamped by the served TSX's `__volterOid` transform
  * keeps `r3f:<worldId>:<oid>`, so selection survives Edit→Play; anything a
  * source location cannot claim gets a session-stable `live:<worldId>:<n>`.
  */

package/src/kit/three-viewport/selection-outline.ts

@@ -73,7 +73,7 @@ export function createThreeSelectionOutline(
   // A CRISP LINE NEEDS ITS COLOUR UNSCALED. postprocessing's composite multiplies the edge colour
   // by the edge value and uses that value again as alpha, so a partial edge darkens (Blender's
   // orange read brown) and a strength above one pushes the colour past itself (it read white).
-  // Under `vgaiCrisp` the colour is divided back out of the edge value, leaving only the alpha
+  // Under `volterCrisp` the colour is divided back out of the edge value, leaving only the alpha
   // to follow the edge; the editor's own halo keeps the library's composite. And the library
   // draws an edge only OUTSIDE the silhouette (it scales the edge by the mask, which is zero on
   // the selection); Blender's detect marks the pixels on both sides of it, so a crisp line keeps
@@ -84,15 +84,15 @@ export function createThreeSelectionOutline(
   if (shader.includes(stock) && shader.includes(outsideOnly)) {
     (effect as unknown as { setFragmentShader(source: string): void }).setFragmentShader(
       shader
-        .replace('uniform float edgeStrength;', 'uniform float edgeStrength;uniform float vgaiCrisp;')
-        .replace(outsideOnly, 'edge*=(edgeStrength*(vgaiCrisp>0.5?1.0:mask.x)*pulse);')
+        .replace('uniform float edgeStrength;', 'uniform float edgeStrength;uniform float volterCrisp;')
+        .replace(outsideOnly, 'edge*=(edgeStrength*(volterCrisp>0.5?1.0:mask.x)*pulse);')
         .replace(
           stock,
-          `${stock}if(vgaiCrisp>0.5){float vgaiSum=edge.x+edge.y;if(vgaiSum>0.0)color/=vgaiSum;edge=min(edge,vec2(1.0));}`,
+          `${stock}if(volterCrisp>0.5){float volterSum=edge.x+edge.y;if(volterSum>0.0)color/=volterSum;edge=min(edge,vec2(1.0));}`,
         ),
     );
     // Any `{ value }` is a uniform to three; no runtime three import in this module.
-    effect.uniforms.set('vgaiCrisp', { value: 0 } as THREE.Uniform<number>);
+    effect.uniforms.set('volterCrisp', { value: 0 } as THREE.Uniform<number>);
   }
   // THE EDITOR'S OWN OVERLAYS DO NOT HIDE THE SELECTION. The effect measures what stands in
   // front of the selected object with a depth pass under an override material, which writes
@@ -199,14 +199,14 @@ type OutlineColors = {
  * step where its are smoothed. Visibility is the stock material's: the least visible of the
  * pixels looked at.
  */
-const BLENDER_OUTLINE_DETECT = /* glsl */ `uniform lowp sampler2D inputBuffer;uniform vec2 texelSize;uniform float vgaiReach;
+const BLENDER_OUTLINE_DETECT = /* glsl */ `uniform lowp sampler2D inputBuffer;uniform vec2 texelSize;uniform float volterReach;
 varying vec2 vUv0;varying vec2 vUv1;varying vec2 vUv2;varying vec2 vUv3;
 void main(){
   vec2 uv=(vUv0+vUv1)*0.5;
   vec2 c=texture2D(inputBuffer,uv).rg;
   float edge=0.0;float visibility=1.0;
   for(int i=1;i<=2;i++){
-    if(float(i)>vgaiReach||edge>0.0)break;
+    if(float(i)>volterReach||edge>0.0)break;
     vec2 o=texelSize*float(i);
     vec2 s0=texture2D(inputBuffer,uv+vec2(o.x,0.0)).rg;vec2 s1=texture2D(inputBuffer,uv-vec2(o.x,0.0)).rg;
     vec2 s2=texture2D(inputBuffer,uv+vec2(0.0,o.y)).rg;vec2 s3=texture2D(inputBuffer,uv-vec2(0.0,o.y)).rg;
@@ -256,9 +256,9 @@ function paintOutline(effect: OutlineEffect): void {
   }
   // Half the width on each side of the silhouette's edge: Blender's 4 device px is its
   // `do_thick_outlines` reach of 2.
-  detect.uniforms['vgaiReach'] = { value: Math.max(1, Math.round(width / 2)) } as THREE.IUniform<number>;
+  detect.uniforms['volterReach'] = { value: Math.max(1, Math.round(width / 2)) } as THREE.IUniform<number>;
   effect.edgeStrength = crisp ? 8 : 5;
-  const crispUniform = effect.uniforms.get('vgaiCrisp');
+  const crispUniform = effect.uniforms.get('volterCrisp');
   if (crispUniform) crispUniform.value = crisp ? 1 : 0;
   effect.xRay = form?.hidden ?? true;
 }

package/src/kit/three-viewport/skeleton-helper.ts

@@ -9,7 +9,7 @@ const SKELETON_CHILD_COLOR = new THREE.Color(0xffb000);
 export function styleEditorSkeletonHelper(helper: THREE.SkeletonHelper): void {
   const colors = helper.geometry.getAttribute('color');
   // SkeletonHelper emits two vertices per bone link. Three's stock pure
-  // blue/green endpoints disappear against vgai's dark viewport, especially
+  // blue/green endpoints disappear against volter's dark viewport, especially
   // in captures. Keep the native helper geometry, but use editor-contrast
   // colors so the inspection affordance is actually visible.
   for (let i = 0; i < colors.count; i += 2) {

package/src/kit/three-viewport/studio-environment.ts

@@ -1,7 +1,7 @@
 /**
  * The LOOK LANES' neutral studio IBL — `scene.environment` for every surface
  * that photographs an asset instead of displaying it: the Asset Lab capture
- * path (`asset-preview.ts`: the model-file lane, `vgai screenshot <module>`
+ * path (`asset-preview.ts`: the model-file lane, the editor's `screenshot <module>` command
  * through `project.bake.preview`, labeled shot sets, source-review sheets,
  * splats) and the asset-browser thumbnails (`model-thumbnail.ts`).
  *

package/src/kit/viewport-hotkeys.ts

@@ -4,7 +4,7 @@
  * stage binds these while it is mounted (`components/stage-keyboard.tsx`). They
  * reach the keyboard through the host door (`host.keyboard`): the viewport says
  * what each action does, and the active KEYMAP decides which keys land on it —
- * W/E/R under `vgai`, G/R/S under `blender`.
+ * W/E/R under `volter`, G/R/S under `blender`.
  */
 import { editorHost } from '@volter/editor-sdk/host';
 import { getActiveScope, installHotkeys, setActiveScope } from '@volter/editor-sdk/kit/hotkeys';
@@ -91,7 +91,7 @@ export function registerViewportHotkeys(
     if (isVertexSnapKey(e) && !e.metaKey && !e.ctrlKey && !e.repeat) {
       // THE STAGE'S OWN SCOPE, which is what keeps this from being a second
       // keyboard owner: it fires only while the viewport holds the editor's
-      // scope, the same fact the frame publishes as `vgai.stage.focused`.
+      // scope, the same fact the frame publishes as `volter.stage.focused`.
       if (getActiveScope() !== 'viewport') return;
       if (e.target instanceof HTMLInputElement || e.target instanceof HTMLTextAreaElement) return;
       store.setVertexSnapActive(true);

package/src/viewport/content-bounds.ts

@@ -35,7 +35,7 @@
  *
  * Editor furniture is deliberately still measured. `isEditorOwnedObject`
  * matches `userData.engineInternal`, and the splat bounds proxy
- * (`@volter/editor-threejs-runtime/asset-loaders`, `__vgai_splat_bounds`) is engine-internal
+ * (`@volter/editor-threejs-runtime/asset-loaders`, `__volter_splat_bounds`) is engine-internal
  * geometry that exists PRECISELY so generic focus/selection bounds can frame a
  * Gaussian splat — a splat renders no `BufferGeometry` of its own. Excluding
  * editor-owned nodes here would silently un-frame every splat. Consumers that