@volter/editor-threejs 0.5.129 → 0.5.130

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/editor-threejs",
   "author": "Volter AI, Inc.",
-  "version": "0.5.129",
+  "version": "0.5.130",
   "publishConfig": {
     "access": "public"
   },
@@ -135,12 +135,12 @@
     "serving": "./dist-node/serving.mjs"
   },
   "dependencies": {
-    "@volter/editor-project": "0.5.129",
+    "@volter/editor-project": "0.5.130",
     "@sparkjsdev/spark": "^2.1.0",
     "three.quarks": "^0.16.0",
     "zod": "^4.3.6",
     "typescript": "5.9.3",
-    "@volter/editor-sdk": "0.5.129",
+    "@volter/editor-sdk": "0.5.130",
     "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

@@ -174,7 +174,7 @@ export class Object3DDocumentSession {
   private readonly throughOrthographic = new THREE.OrthographicCamera();
   /** The host's mirror of the document scene onto the rendered scene — see
    *  {@link Object3DDocumentSession.setBeforeRender}. */
-  private beforeRender: (() => void) | null = null;
+  private beforeRender: (() => void | (() => void)) | null = null;
   private state = INITIAL_PRESENTATION;
   private version = 0;
   private readonly listeners = new Set<() => void>();
@@ -1253,7 +1253,7 @@ export class Object3DDocumentSession {
    * The host owns the step and clears it in its own teardown; the session only
    * holds the reference.
    */
-  setBeforeRender(step: (() => void) | null): void {
+  setBeforeRender(step: (() => void | (() => void)) | null): void {
     this.beforeRender = step;
   }
 
@@ -1339,51 +1339,55 @@ export class Object3DDocumentSession {
   }
 
   render(renderSolid: (camera: THREE.Camera) => void): void {
-    this.beforeRender?.();
-    this.boneSelectionHighlight?.update();
-    const camera = this.camera();
-    const mode = this.state.mode;
-    this.boundsHelper?.update();
-    this.selectionOrigins?.place();
-    if (mode === 'uv' || mode === 'vertex-colors') {
-      renderSolid(camera);
-      return;
-    }
-    if (mode === 'wireframe' && this.topologyOverlay) {
-      this.syncTopologyOverlay();
-      if (this.xray.enabled && this.xray.alpha <= 0) {
-        // X-RAY AT NO ALPHA: the wires alone, every surface left out of the draw. The surfaces'
-        // MATERIALS stand down, not the meshes, whose children (lines, points, other objects)
-        // still draw, as every wire does in Blender's.
-        const hidden = new Set<THREE.Material>();
-        this.root.traverse((object) => {
-          const mesh = object as THREE.Mesh;
-          if (!mesh.isMesh) return;
-          for (const material of Array.isArray(mesh.material) ? mesh.material : [mesh.material]) {
-            if (material?.visible) {
-              material.visible = false;
-              hidden.add(material);
+    const finishDraw = this.beforeRender?.();
+    try {
+      this.boneSelectionHighlight?.update();
+      const camera = this.camera();
+      const mode = this.state.mode;
+      this.boundsHelper?.update();
+      this.selectionOrigins?.place();
+      if (mode === 'uv' || mode === 'vertex-colors') {
+        renderSolid(camera);
+        return;
+      }
+      if (mode === 'wireframe' && this.topologyOverlay) {
+        this.syncTopologyOverlay();
+        if (this.xray.enabled && this.xray.alpha <= 0) {
+          // X-RAY AT NO ALPHA: the wires alone, every surface left out of the draw. The surfaces'
+          // MATERIALS stand down, not the meshes, whose children (lines, points, other objects)
+          // still draw, as every wire does in Blender's.
+          const hidden = new Set<THREE.Material>();
+          this.root.traverse((object) => {
+            const mesh = object as THREE.Mesh;
+            if (!mesh.isMesh) return;
+            for (const material of Array.isArray(mesh.material) ? mesh.material : [mesh.material]) {
+              if (material?.visible) {
+                material.visible = false;
+                hidden.add(material);
+              }
             }
+          });
+          try {
+            renderSolid(camera);
+          } finally {
+            for (const material of hidden) material.visible = true;
           }
-        });
-        try {
-          renderSolid(camera);
-        } finally {
-          for (const material of hidden) material.visible = true;
+          return;
         }
+        // Clay bodies, not the triangle-wireframe swap: the overlay IS the wire,
+        // and the solid form behind it is what occludes the far side.
+        this.shading.render(
+          this.scene,
+          'clay',
+          () => renderSolid(camera),
+          isEditorViewportShadingTarget,
+        );
         return;
       }
-      // Clay bodies, not the triangle-wireframe swap: the overlay IS the wire,
-      // and the solid form behind it is what occludes the far side.
-      this.shading.render(
-        this.scene,
-        'clay',
-        () => renderSolid(camera),
-        isEditorViewportShadingTarget,
-      );
-      return;
+      this.shading.render(this.scene, mode, () => renderSolid(camera), isEditorViewportShadingTarget);
+    } finally {
+      finishDraw?.();
     }
-    this.shading.render(this.scene, mode, () => renderSolid(camera), isEditorViewportShadingTarget);
   }
 
   /** Visible authoring draw with the editor-only native selection silhouette. */

package/src/kit/components/StageHost.tsx

@@ -1904,7 +1904,10 @@ export function Object3DDocumentViewport({
           }
         };
         host.syncHostScene = syncHostScene;
-        documentSession.setBeforeRender(() => host.syncHostScene?.());
+        documentSession.setBeforeRender(() => {
+          host.syncHostScene?.();
+          return source.prepareDraw?.(documentSession.camera());
+        });
         // This loop draws the compass and every other overlay pass over the
         // document's own render, so it — and only it — can serve the chrome
         // door a frame that matches the screen.

package/src/object3d-contributions.ts

@@ -52,6 +52,10 @@ export interface ToolObject3DPreviewSource {
    * where a world runs.
    */
   update?(deltaSeconds: number): void;
+  /** Prepare camera-dependent draw buffers immediately before rendering.
+   * Does not advance content time or mutate the authored document. An optional
+   * returned function restores temporary draw state, including after errors. */
+  prepareDraw?(camera: Camera): void | (() => void);
   /**
    * EVERY CHANGE TO WHAT THE SOURCE DRAWS, announced: the host calls
    * `listener` whenever the source's graph, materials, textures or poses may