@volter/editor-threejs 0.5.87 → 0.5.89

package/package.json

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

@@ -1540,6 +1540,11 @@ export class Object3DDocumentSession {
       this.composer?.setSize(this.renderWidth, this.renderHeight, false);
       target.dispose();
       sceneTarget.dispose();
+      // AND THE VIEW IS DRAWN AGAIN. Sizing the composer clears what the view showed, and a stage
+      // that draws on demand had nothing asking it to: on the browser-substrate page every photograph
+      // (Save Screenshot, an agent's get_viewport_screenshot) left the viewport a flat grey until the
+      // pointer next moved over it (measured 2026-09-28: stddev 0 across the view, restored on hover).
+      invalidateStages();
     }
   }
 

package/src/kit/components/Object3DDocumentToolbar.tsx

@@ -432,13 +432,15 @@ export function Object3DDocumentToolbar({
         </ViewportDisplayModeMenu>
         {/* THE EYE WAS THE OVERLAYS CONTROL ALL ALONG — measured by what it
             toggles, which is Grid and Bounds, exactly Blender's Show Overlays
-            subject. It takes Blender's mark. It does NOT take Blender's split
-            toggle+chevron: that toggle binds to a MASTER overlays flag this
-            document's session does not have, and deriving one from "any
-            overlay is on" would silently drop the per-overlay state on the
-            first click. One button, one job, until the session has the flag. */}
+            subject. It takes Blender's mark, and Blender's split toggle+chevron:
+            the toggle is the MASTER flag, this stage's own helpers switch
+            (`StageHost` takes the grid, axis lines and selection marks down
+            with it), and each overlay below keeps its own choice under it. */}
         <ViewportOverlaysMenu
           glyph={<ViewportOverlaysGlyph />}
+          {...(stage === null
+            ? {}
+            : { master: { enabled: stage.showHelpers, onToggle: () => stage.toggleHelpers() } })}
           choices={[
             {
               id: 'grid',

package/src/kit/components/StageHost.tsx

@@ -1244,8 +1244,14 @@ export function Object3DDocumentViewport({
             const rig = new StagePresentationRig(host.scene, invalidateStages);
             host.presentationRig = rig;
             bindViewPresentation(documentId, viewStageKind);
+            // THE STAGE'S SHOW OVERLAYS is its store's helpers switch (Blender's
+            // `View3DOverlay.show_overlays`, one per area): off, the grid, the axis lines and the
+            // selection's outline and origins go with the helpers, and each keeps its own choice
+            // for when it comes back on.
+            let overlaysShown = host.store.shell.showHelpers;
             const applyPresentation = () => {
               const presentation = viewPresentation(documentId);
+              overlaysShown = host.store.shell.showHelpers;
               rig.apply(presentation, renderer, dressingToneMapping);
               // The view's overlays: its selection marks and its grid's major step. The native
               // outline is also the stage's own switch (a shared preview draws none).
@@ -1255,7 +1261,7 @@ export function Object3DDocumentViewport({
               host.viewport?.setGridMajorEvery(presentation.overlays.grid.majorEvery);
               host.viewport?.setAxisLines(presentation.overlays.axes);
               host.viewport?.setNavigation(presentation.overlays.navigation);
-              host.viewport?.setGridVisible(presentation.overlays.grid.visible);
+              host.viewport?.setGridVisible(presentation.overlays.grid.visible && overlaysShown);
               if (host.session) {
                 // An X-ray with no surface draws no outline: the selection is its wires' colour.
                 const surfaceless =
@@ -1263,8 +1269,12 @@ export function Object3DDocumentViewport({
                   presentation.xray.enabled &&
                   presentation.xray.alpha <= 0;
                 host.session.selectionOutlineEnabled =
-                  !shared && selectionOutlineRef.current && presentation.overlays.selection.outline && !surfaceless;
-                host.session.selectionOriginsEnabled = !shared && presentation.overlays.selection.origins;
+                  !shared &&
+                  overlaysShown &&
+                  selectionOutlineRef.current &&
+                  presentation.overlays.selection.outline &&
+                  !surfaceless;
+                host.session.selectionOriginsEnabled = !shared && overlaysShown && presentation.overlays.selection.origins;
                 host.session.setXray(presentation.xray);
               }
               invalidateStages();
@@ -1272,6 +1282,11 @@ export function Object3DDocumentViewport({
             host.applyPresentation = applyPresentation;
             applyPresentation();
             host.cleanups.push(subscribeViewportPresentation(applyPresentation));
+            host.cleanups.push(
+              host.store.shell.subscribe(() => {
+                if (host.store.shell.showHelpers !== overlaysShown) applyPresentation();
+              }),
+            );
             // A view may name an environment image its integration registers later.
             host.cleanups.push(
               subscribeEnvironmentImages(() => {

package/src/kit/components/ViewportFurniture.tsx

@@ -363,7 +363,10 @@ export function ViewportFurniture({
 
   return (
     <>
-      {chrome.viewName === 'text' ? (
+      {/* The view text is an overlay (Blender's `show_text`), gone with the stage's Show Overlays;
+          the camera's frame below is not (`drawviewborder`: "When overlays are disabled, only
+          show camera outline & passepartout"). */}
+      {chrome.viewName === 'text' && store.showHelpers ? (
       <div
         data-testid="viewport-view-text"
         aria-hidden="true"