@volter/editor-threejs 0.5.187 → 0.5.189

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/editor-threejs",
   "author": "Volter AI, Inc.",
-  "version": "0.5.187",
+  "version": "0.5.189",
   "publishConfig": {
     "access": "public"
   },
@@ -135,12 +135,12 @@
     "serving": "./dist-node/serving.mjs"
   },
   "dependencies": {
-    "@volter/editor-project": "0.5.187",
+    "@volter/editor-project": "0.5.189",
     "@sparkjsdev/spark": "^2.1.0",
     "three.quarks": "^0.16.0",
     "zod": "^4.3.6",
     "typescript": "5.9.3",
-    "@volter/editor-sdk": "0.5.187",
+    "@volter/editor-sdk": "0.5.189",
     "postprocessing": "6.38.3",
     "quarks.core": "0.16.0",
     "@fortawesome/free-solid-svg-icons": "^7.2.0"

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

@@ -1,5 +1,5 @@
 import { createPerformanceProfiler } from '@volter/editor-sdk/kit/performance-profiler';
-import { resetViewPresentation, type ViewportXray } from '@volter/editor-sdk/kit/viewport-presentation';
+import { resetViewPresentation, setViewPresentation, type ViewportXray } from '@volter/editor-sdk/kit/viewport-presentation';
 import { invalidateStages } from '@volter/editor-sdk/kit/stage-invalidation';
 import type { AuthoringAdapter } from '@volter/editor-project/adapter';
 import { viewportCaptureOutputPass } from '@volter/editor-threejs/capture/output-pass';
@@ -7,6 +7,7 @@ import { contentWorldBounds } from '@volter/editor-threejs/viewport/content-boun
 import { setUserData } from '@volter/editor-threejs/ecs/user-data';
 import {
   type ViewportShadingMode,
+  VIEWPORT_SHADING_MODES,
   ViewportShadingRenderer,
 } from '@volter/editor-threejs/render/viewport-shading';
 import type { EffectComposer, EffectPass, RenderPass } from 'postprocessing';
@@ -630,6 +631,9 @@ export class Object3DDocumentSession {
     invalidateStages();
     this.leaveCameraView(false);
     this.settleFlight('superseded');
+    if (fov !== undefined && Number.isFinite(fov) && fov > 0 && fov < 180) {
+      setViewPresentation(this.documentId, { camera: { fov: { degrees: fov, axis: 'vertical' } } });
+    }
     this.viewport.setPose(position, target, fov);
   }
 
@@ -1062,6 +1066,10 @@ export class Object3DDocumentSession {
   }
 
   setMode(mode: Object3DDocumentViewMode): void {
+    if (mode !== 'uv' && mode !== 'vertex-colors' &&
+      !(VIEWPORT_SHADING_MODES as readonly string[]).includes(mode)) {
+      throw new Error(`Unknown document shading mode "${mode}".`);
+    }
     invalidateStages();
     if (this.state.mode === mode) return;
     this.clearDiagnosticPresentation();

package/src/kit/components/StageHost.tsx

@@ -394,6 +394,10 @@ function mountViewportSurface(
   );
   const { canvas, renderer } = lease;
   canvas.setAttribute('aria-label', `${displayName} authoring viewport`);
+  // This is the document's main renderer, rather than a canvas embedded in UI.
+  // Capture draws it once beneath the document overlays; encoding it again in
+  // the DOM clone duplicates megapixel PNG work and can hide the React HUD.
+  canvas.setAttribute('data-volter-root-surface', 'true');
   canvasHost.appendChild(canvas);
   return { canvas, renderer, lease };
 }
@@ -532,6 +536,7 @@ class Object3DDocumentHost {
       () => this.viewport?.dispose(),
       () => this.rendererSession.dispose(),
       () => this.dressing?.dispose(),
+      () => canvas.removeAttribute('data-volter-root-surface'),
       ...(lease
         ? [() => lease.release()]
         : [() => renderer.dispose(), () => renderer.forceContextLoss(), () => canvas.remove()]),
@@ -590,6 +595,7 @@ export function Object3DDocumentViewport({
   active = true,
   audit = true,
   chromeless = false,
+  fillContainer = false,
   modelSource,
   assetType,
   sourceAuthoring,
@@ -1375,7 +1381,7 @@ export function Object3DDocumentViewport({
             onProjectionChange: setProjection,
             // The same expression that places the DOM furniture, for the one
             // piece of furniture that is drawn on the canvas instead.
-            chromeInsetPx: chromeless || hasShell ? 0 : STAGE_BLEED_PX,
+            chromeInsetPx: chromeless || hasShell || fillContainer ? 0 : STAGE_BLEED_PX,
             // A document that turns the dressing's key light off has said it
             // lights itself, and the editor's design-time rig answers exactly
             // the same question. MEASURED on the Model stage before this
@@ -2350,7 +2356,8 @@ export function Object3DDocumentViewport({
                   break;
                 }
                 case 'set-camera-pose':
-                  viewport.setPose(action.position, action.target, action.fov);
+                  if (host.session) host.session.setCameraPose(action.position, action.target, action.fov);
+                  else viewport.setPose(action.position, action.target, action.fov);
                   break;
               }
             }),
@@ -2434,6 +2441,7 @@ export function Object3DDocumentViewport({
     dressingViewLocked,
     dressingToneMapping,
     chromeless,
+    fillContainer,
     modelSourceEntityId,
     modelSourceKind,
     modelSourcePath,
@@ -2495,7 +2503,7 @@ export function Object3DDocumentViewport({
           ? { width: '100%', height: '100%' }
           : hasShell
             ? { flex: 1, minHeight: 0 }
-            : { inset: -STAGE_BLEED_PX }),
+            : { inset: fillContainer ? 0 : -STAGE_BLEED_PX }),
         overflow: 'hidden',
         // Asset documents paint the shared studio stage through their class.
         // An inline background here would win the cascade and hide it.
@@ -2604,7 +2612,7 @@ export function Object3DDocumentViewport({
         <div
           style={{
             position: 'absolute',
-            inset: chromeless || hasShell ? 0 : STAGE_BLEED_PX,
+            inset: chromeless || hasShell || fillContainer ? 0 : STAGE_BLEED_PX,
             pointerEvents: 'none',
           }}
         >

package/src/kit/editor-viewport.ts

@@ -3820,8 +3820,10 @@ export class EditorViewport {
     this.orbitControls.target.set(target.x, target.y, target.z);
     this.camera.lookAt(this.orbitControls.target);
     if (fov !== undefined) {
-      this.camera.fov = fov;
-      this.camera.updateProjectionMatrix();
+      // A free pose states three's vertical angle. Keep the resize source in
+      // sync; writing only camera.fov lets the next layout change restore the
+      // previous lens, even when the camera position and target were retained.
+      this.setFieldOfView({ degrees: fov, axis: 'vertical' });
     }
     this.orbitControls.update();
   }

package/src/object3d-contributions.ts

@@ -207,6 +207,8 @@ export interface ToolObject3DAuthoringProps {
    * Object Data tab is the mesh's own, not an importer's report.
    */
   readonly audit?: boolean;
+  /** Fill the supplied container exactly, without the bare dock panel's padding bleed. */
+  readonly fillContainer?: boolean;
   readonly cameraDirection?: readonly [number, number, number];
   /** Per-document overrides of the standard viewport dressing. */
   readonly dressing?: ToolViewportDressing;