@volter/editor-blender 0.1.28 → 0.1.30

package/contributions/blender-outliner-authoring.ts

@@ -76,6 +76,7 @@ import type {
 } from '@volter/editor-project/adapter';
 import type * as THREE from 'three';
 import { threeObject } from '@volter/editor-threejs/adapter/three-contract';
+import { viewportStages } from '@volter/editor-threejs/viewport-door';
 import { blenderExecute, blenderRnaSet, beginBlenderGesture, endBlenderGesture } from '../host/blender-runtime-host';
 import {
   blenderEngineSelection,
@@ -1602,6 +1603,29 @@ export function blenderOutlinerAuthoringFor(
    * callback in Code-OSS. These operators are undone by restoring Blender's
    * state, never by constructing an inverse operator or replaying the script.
    */
+  /**
+   * ADD ▸ CAMERA LOOKS THE WAY THE VIEW LOOKS, AND IS THE SCENE'S CAMERA WHEN THERE IS NONE: what
+   * `object_camera_add_exec` does with the 3D View it runs in (`object_add.cc`: `align` forced to
+   * VIEW; `v3d->scenelock && scene->camera == nullptr` gives `scene->camera = ob`). This engine
+   * runs the operator with no View3D, so both come from here: the area's own view, set on the new
+   * camera the way the gizmo writes a pose (`blenderWorldMatrixRows`) with the operator's
+   * location (the 3D cursor) kept, and the scene camera after it.
+   */
+  const cameraAddCall = (): string => {
+    const areaId = (defaultAdapter as { documentId?: string }).documentId?.replace(/^object3d-document:/, '');
+    const camera = viewportStages().find((one) => one.documentId === areaId)?.rig().drawCamera() ?? null;
+    const view = presented();
+    const lines = ['bpy.ops.object.camera_add()', 'added = bpy.context.view_layer.objects.active'];
+    if (camera !== null && view !== null)
+      lines.push(
+        'kept = added.location.copy()',
+        `added.matrix_world = ${JSON.stringify(blenderWorldMatrixRows(camera, view.root))}`,
+        'added.location = kept',
+      );
+    lines.push('if bpy.context.scene.camera is None:', '    bpy.context.scene.camera = added');
+    return lines.join('\n');
+  };
+
   const structure: StructureProvider = {
     /**
      * BLENDER'S ADD MENU, FOR EVERY PARENT — `parentId` is deliberately not
@@ -1633,7 +1657,7 @@ export function blenderOutlinerAuthoringFor(
       // with this same sentence, so this arm is what answers a caller reaching
       // the kind through the door instead of the menu.
       if (entry.refusal !== undefined) return { id: '', ack: refuse(entry.refusal) };
-      const call = addCall(entry);
+      const call = entry.call === 'object.camera_add' ? cameraAddCall() : addCall(entry);
       return {
         id: '',
         ack: (async (): Promise<WriteAck> => {

package/contributions/blender-runtime.document.tsx

@@ -73,6 +73,10 @@ import {
   subscribeObject3DDocumentSessions,
 } from '@volter/editor-threejs/kit/authoring/object3d-document-session-registry';
 import type { ToolObject3DAuthoringProps } from '@volter/editor-threejs/object3d-contributions';
+import { stageStore, subscribeStageStores } from '@volter/editor-sdk/kit/stage-store-registry';
+
+/** The second areas' stage stores whose overlays have been opened off (`BlenderViewportArea`). */
+const overlaysOpened = new WeakSet<object>();
 
 export const point = 'workspace.document';
 export const title = 'Blender Model';
@@ -427,6 +431,24 @@ function BlenderViewportArea({
       stopFrames();
     };
   }, [main, documentId, view]);
+  /**
+   * AND WITH THE AREA'S SHOW OVERLAYS OFF, the switch that makes a camera view read as the render
+   * does: no grid, no camera or light wires, no selection marks, no view text — and still the
+   * camera's outline and passepartout (`drawviewborder`: "When overlays are disabled, only show
+   * camera outline & passepartout"). Set once per stage store, which outlives the area's remounts,
+   * so turning them back on is the person's and stays.
+   */
+  useEffect(() => {
+    if (main || !documentId) return;
+    const opened = (): void => {
+      const store = stageStore(documentId);
+      if (store === null || overlaysOpened.has(store)) return;
+      overlaysOpened.add(store);
+      if (store.showHelpers) store.toggleHelpers();
+    };
+    opened();
+    return subscribeStageStores(opened);
+  }, [main, documentId]);
   /**
    * THE INSPECTION OVERLAYS ARE HELPERS, and the Helpers menu owns them
    * (WORK.md §Blender in the tab is Blender, "Inspection parity", I4).

package/package.json

@@ -2,7 +2,7 @@
   "name": "@volter/editor-blender",
   "author": "Volter AI, Inc.",
   "license": "AGPL-3.0-only AND GPL-3.0-or-later",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "publishConfig": {
     "access": "public"
   },
@@ -70,14 +70,14 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.30.0",
-    "@volter/blender-engine": "0.1.26",
-    "@volter/editor-threejs": "0.5.88",
+    "@volter/blender-engine": "0.1.28",
+    "@volter/editor-threejs": "0.5.90",
     "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "@volter/editor-live": "0.5.88",
-    "@volter/editor-project": "0.5.88",
-    "@volter/editor-sdk": "0.5.88",
+    "@volter/editor-live": "0.5.90",
+    "@volter/editor-project": "0.5.90",
+    "@volter/editor-sdk": "0.5.90",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "three": "^0.180.0",