@volter/editor-threejs 0.5.156 → 0.5.158

package/package.json

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

package/src/kit/components/StageHost.tsx

@@ -1836,6 +1836,12 @@ export function Object3DDocumentViewport({
         // leave behind. The session runs this before it renders; nothing else may
         // hold a second copy of this field list.
         const syncHostScene = () => {
+          // A document's World is its neutral backdrop. Transfer it when it
+          // changes, before the view's explicit backdrop override is applied.
+          if (nativeBackground !== scene.background) {
+            nativeBackground = scene.background;
+            documentSession.setNeutralBackground(nativeBackground ?? host.defaultBackground);
+          }
           // A document draws through its session's camera, which the viewport's own frame
           // does not know is orthographic.
           host.viewport?.alignGridToView(documentSession.camera(), renderer.domElement.width);
@@ -1899,17 +1905,13 @@ export function Object3DDocumentViewport({
               toneMapping: String(renderer.toneMapping),
             });
           }
-          if (nativeBackground !== scene.background) {
-            nativeBackground = scene.background;
-            documentSession.setNeutralBackground(nativeBackground ?? host.defaultBackground);
-          }
         };
         host.syncHostScene = syncHostScene;
         documentSession.setBeforeRender((interactive) => {
           host.syncHostScene?.();
           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')});
+          return source.prepareDraw?.(documentSession.camera(), {interactive: navigation, height: renderer.domElement.height, multiDraw: renderer.extensions.has('WEBGL_multi_draw'), renderer});
         });
         // 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

package/src/object3d-contributions.ts

@@ -57,7 +57,7 @@ export interface ToolObject3DPreviewSource {
    * returned function restores temporary draw state, including after errors.
    * 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);
+  prepareDraw?(camera: Camera, options?: {interactive: boolean; height: number; multiDraw?: boolean; renderer?: WebGLRenderer}): void | (() => void);
   /**
    * EVERY CHANGE TO WHAT THE SOURCE DRAWS, announced: the host calls
    * `listener` whenever the source's graph, materials, textures or poses may