@volter/editor-threejs 0.5.92 → 0.5.93

package/package.json

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

package/src/kit/components/Object3DDocumentToolbar.tsx

@@ -13,6 +13,7 @@ import {
   Button,
   EditorBanner,
   EditorIcon,
+  editorIcons,
   EditorPopover,
   EditorToolbar,
   IconButton,
@@ -430,6 +431,20 @@ export function Object3DDocumentToolbar({
             </Text>
           </label>
         </ViewportDisplayModeMenu>
+        {/* BLENDER'S SHOW GIZMO (`View3D.show_gizmo`), beside Show Overlays as Blender's header
+            has them: this stage's transform and navigation gizmos, apart from its overlays. */}
+        {stage === null ? null : (
+          <Tooltip text={`Gizmos: ${stage.showGizmos ? 'On' : 'Off'}`}>
+            <IconButton
+              aria-label="Toggle gizmos"
+              aria-pressed={stage.showGizmos}
+              size="comfortable"
+              onClick={() => stage.toggleGizmos()}
+            >
+              <EditorIcon icon={editorIcons.viewport.gizmos} size="md" />
+            </IconButton>
+          </Tooltip>
+        )}
         {/* 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, and Blender's split toggle+chevron:

package/src/kit/components/ViewportFurniture.tsx

@@ -472,7 +472,7 @@ export function ViewportFurniture({
           header's view control and the Home and numpad-period keys, as Blender's is its View
           menu. The Camera button is not drawn yet: looking through a scene camera is not a
           view this stage has. */}
-      {navigationControls ? (
+      {navigationControls && store.showGizmos ? (
       <div
         data-testid="viewport-navigation"
         role="toolbar"

package/src/kit/editor-viewport.ts

@@ -3165,7 +3165,7 @@ export class EditorViewport {
     // same rationale as the per-notify `applyRootHiddenVisibility` above.
     if (hidden) policy.suppressRootEnvironment(this._scene);
     const gizmoEpoch = this._store.gizmoEpoch;
-    const gizmoSig = `${this._store.shell.showHelpers}|${JSON.stringify(vis)}|${hiddenRootId ?? ''}|${hidden}|${this._threejsToolContextActive}`;
+    const gizmoSig = `${this._store.shell.showHelpers}|${this._store.shell.showGizmos}|${JSON.stringify(vis)}|${hiddenRootId ?? ''}|${hidden}|${this._threejsToolContextActive}`;
     const mapChanged = this._objectMap !== this._lastGizmoObjectMap;
     const settingsChanged = gizmoSig !== this._lastGizmoSig;
     const membershipChanges = mapChanged
@@ -3261,7 +3261,8 @@ export class EditorViewport {
         ? anyChannelWritable(selectedId)
         : (authoring.transforms?.editability?.(selectedId, activeTransformChannel).writable ?? true)
       : false;
-    if (selectedId && selectedTransformWritable) {
+    // Blender's Show Gizmo off draws no transform gizmo, and the selection stays as it is.
+    if (selectedId && selectedTransformWritable && this._store.shell.showGizmos) {
       if (!this._anyGizmoDragging()) {
         if (this._store.shell.pivotMode === 'median-point' && this._store.shell.selectedEntityIds.size > 1) {
           const median = new THREE.Vector3();
@@ -3982,6 +3983,7 @@ export class EditorViewport {
   renderViewCube(renderer: THREE.WebGLRenderer): void {
     if (!this._threeSurfaceShowing) return; // no three stage, no compass (Blender's is persistent on one)
     if (this._navigation === 'hidden') return;
+    if (!this._store.shell.showGizmos) return; // the stage's Show Gizmo is off
     if (this._cameraView) return; // exact camera view owns the viewport
     const w = renderer.domElement.clientWidth;
     const h = renderer.domElement.clientHeight;
@@ -4859,6 +4861,7 @@ export class EditorViewport {
   private _isOverViewCube(clientX: number, clientY: number): boolean {
     // An indicator is only drawn, and a triad has nothing to click: clicks pass to the stage.
     if (this._navigation !== 'interactive' || this._gizmoLook.navigationForm === 'triad') return false;
+    if (!this._store.shell.showGizmos) return false;
     const rect = this._canvas.getBoundingClientRect();
     const x = clientX - rect.left;
     const y = clientY - rect.top;