@volter/editor-blender 0.1.37 → 0.1.39

package/contributions/blender-runtime.document.tsx

@@ -56,7 +56,12 @@ import {
   useSyncExternalStore,
 } from 'react';
 import * as THREE from 'three';
-import { bindModelDocument, blenderExecute, openModelDocumentBlend } from '../host/blender-runtime-host';
+import {
+  bindModelDocument,
+  blenderExecute,
+  blenderViewShading,
+  openModelDocumentBlend,
+} from '../host/blender-runtime-host';
 import { BlenderObjectModeHeader } from './blender-header-menus';
 import { blenderOutlinerAuthoringFor, createBlenderOutlinerAuthoring } from './blender-outliner-authoring';
 import { blenderSkin } from './blender-runtime-skin';
@@ -124,6 +129,14 @@ export const inspectorBuiltins: readonly string[] = [];
 const view = blenderModelView;
 type AreaView = BlenderRuntimeView;
 
+/** A stage draw mode as the `View3DShading.type` Blender saves it under. */
+const BLENDER_SHADING = {
+  wireframe: 'WIREFRAME',
+  solid: 'SOLID',
+  preview: 'MATERIAL',
+  rendered: 'RENDERED',
+} as const;
+
 /** What an area's stage reads from the view it draws, made once per view. */
 interface AreaReads {
   readonly subject: () => string | null;
@@ -431,6 +444,24 @@ function BlenderViewportArea({
       stopFrames();
     };
   }, [main, documentId, view]);
+  /**
+   * A SHADING PICK IS KEPT WHERE BLENDER KEEPS IT: in the file's own 3D View, the one it reopens
+   * on (`blenderViewShading`), so the next save carries it and a reopen starts from it. Noted on
+   * the view at once, so a remount before the next frame reads the pick and not the file's old
+   * shading. Modes Blender's four cells do not name (Clay, Matcap…) stay the editor's.
+   */
+  useEffect(() => {
+    if (!main || !documentId) return;
+    const keep = (): void => {
+      const saved = view.savedView();
+      const mode = viewPresentation(documentId).drawMode;
+      const shading = BLENDER_SHADING[mode as keyof typeof BLENDER_SHADING];
+      if (!saved || shading === undefined || saved.drawMode === mode) return;
+      view.noteSavedShading(shading);
+      void blenderViewShading(shading);
+    };
+    return subscribeViewportPresentation(keep);
+  }, [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
@@ -646,10 +677,15 @@ function BlenderViewportArea({
       // WHERE BLENDER OPENS THE FILE: its own saved 3D View, when it holds one; the direction and
       // fit above are the fallback for a file that saved none.
       openingView={view.savedView()}
-      // The file's own lens, as the document's presentation (Blender's arithmetic in degrees).
+      // The file's own lens (Blender's arithmetic in degrees) and, for the main area, the shading
+      // its view was saved in, as the document's presentation: Blender reopens a file saved in
+      // Material Preview in Material Preview, so a textured scene saved that way does not open
+      // grey. The second area is the render preview and opens Rendered.
       presentation={(() => {
         const saved = view.savedView();
-        return saved ? { camera: { fov: blenderViewFieldOfView(saved.lens) } } : null;
+        if (!saved) return null;
+        const camera = { fov: blenderViewFieldOfView(saved.lens) };
+        return main && saved.drawMode ? { camera, drawMode: saved.drawMode } : { camera };
       })()}
       // Every entry this document opens is a `model` stage, the standing `blender:runtime`
       // address included (its id carries no `model:` prefix).

package/host/blender-runtime-host.ts

@@ -444,6 +444,12 @@ export async function blenderRnaSet(
   return written;
 }
 
+/** Keep a person's shading pick in the file's own 3D View (`runtime.viewShading`). */
+export async function blenderViewShading(shading: 'WIREFRAME' | 'SOLID' | 'MATERIAL' | 'RENDERED'): Promise<void> {
+  if (!blenderSessionStarted()) return;
+  await blenderRuntime().viewShading(shading);
+}
+
 /**
  * THE SCRIPT DOOR, in-page — one bpy script, run the way the MCP add-on runs
  * one (`session.py::execute`: a namespace of its own, output captured, and a

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.37",
+  "version": "0.1.39",
   "publishConfig": {
     "access": "public"
   },
@@ -70,14 +70,14 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.30.0",
-    "@volter/blender-engine": "0.1.35",
-    "@volter/editor-threejs": "0.5.97",
+    "@volter/blender-engine": "0.1.37",
+    "@volter/editor-threejs": "0.5.99",
     "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "@volter/editor-live": "0.5.97",
-    "@volter/editor-project": "0.5.97",
-    "@volter/editor-sdk": "0.5.97",
+    "@volter/editor-live": "0.5.99",
+    "@volter/editor-project": "0.5.99",
+    "@volter/editor-sdk": "0.5.99",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "three": "^0.180.0",