@volter/editor-threejs 0.5.141 → 0.5.143

package/package.json

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

@@ -175,6 +175,7 @@ export class Object3DDocumentSession {
   /** The host's mirror of the document scene onto the rendered scene — see
    *  {@link Object3DDocumentSession.setBeforeRender}. */
   private beforeRender: ((interactive: boolean) => void | (() => void)) | null = null;
+  private beforeDepthRender: ((camera: THREE.Camera, material: THREE.MeshDepthMaterial) => void | (() => void)) | null = null;
   private state = INITIAL_PRESENTATION;
   private version = 0;
   private readonly listeners = new Set<() => void>();
@@ -1253,8 +1254,10 @@ export class Object3DDocumentSession {
    * The host owns the step and clears it in its own teardown; the session only
    * holds the reference.
    */
-  setBeforeRender(step: ((interactive: boolean) => void | (() => void)) | null): void {
+  setBeforeRender(step: ((interactive: boolean) => void | (() => void)) | null,
+    depth: ((camera: THREE.Camera, material: THREE.MeshDepthMaterial) => void | (() => void)) | null = null): void {
     this.beforeRender = step;
+    this.beforeDepthRender = step ? depth : null;
   }
 
   /**
@@ -1340,6 +1343,22 @@ export class Object3DDocumentSession {
 
   render(renderSolid: (camera: THREE.Camera) => void, interactive = false): void {
     const finishDraw = this.beforeRender?.(interactive);
+    const before = this.scene.onBeforeRender;
+    const after = this.scene.onAfterRender;
+    const passCleanups: (void | (() => void))[] = [];
+    // Public Scene hooks bracket each actual renderer pass, after matrices are
+    // current and before its render list is built. A composer may render this
+    // scene repeatedly with different cameras and override materials.
+    this.scene.onBeforeRender = (...args) => {
+      before.apply(this.scene, args);
+      const material = this.scene.overrideMaterial as THREE.MeshDepthMaterial | null;
+      passCleanups.push(material?.isMeshDepthMaterial
+        ? this.beforeDepthRender?.(args[2], material) : undefined);
+    };
+    this.scene.onAfterRender = (...args) => {
+      try { after.apply(this.scene, args); }
+      finally { passCleanups.pop()?.(); }
+    };
     try {
       this.boneSelectionHighlight?.update();
       const camera = this.camera();
@@ -1386,7 +1405,10 @@ export class Object3DDocumentSession {
       }
       this.shading.render(this.scene, mode, () => renderSolid(camera), isEditorViewportShadingTarget);
     } finally {
-      finishDraw?.();
+      this.scene.onBeforeRender = before;
+      this.scene.onAfterRender = after;
+      try { while (passCleanups.length) passCleanups.pop()?.(); }
+      finally { finishDraw?.(); }
     }
   }
 

package/src/kit/components/StageHost.tsx

@@ -1909,7 +1909,7 @@ export function Object3DDocumentViewport({
           const mode = documentSession.presentation().mode;
           const navigation = interactive && ['solid', 'preview', 'clay', 'unlit', 'matcap'].includes(mode);
           return source.prepareDraw?.(documentSession.camera(), {interactive: navigation, height: renderer.domElement.height, multiDraw: renderer.extensions.has('WEBGL_multi_draw')});
-        });
+        }, (camera, material) => source.prepareDepthDraw?.(camera, material));
         // 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

@@ -20,6 +20,7 @@ import type {
   ColorRepresentation,
   Group,
   Intersection,
+  MeshDepthMaterial,
   Object3D,
   Ray,
   Scene,
@@ -58,6 +59,9 @@ export interface ToolObject3DPreviewSource {
    * Interactive draws may use disposable navigation geometry; omitted/false
    * always means full detail (captures and default frame-cost readings). */
   prepareDraw?(camera: Camera, options?: {interactive: boolean; height: number; multiDraw?: boolean}): void | (() => void);
+  /** Optional pass-local depth draws. The host restores them before the next
+   * pass, including after a render error. Authored objects remain authoritative. */
+  prepareDepthDraw?(camera: Camera, material: MeshDepthMaterial): void | (() => void);
   /**
    * EVERY CHANGE TO WHAT THE SOURCE DRAWS, announced: the host calls
    * `listener` whenever the source's graph, materials, textures or poses may