@volter/editor-blender 0.1.9 → 0.1.11

package/contributions/blender-header-menus.tsx

@@ -26,8 +26,7 @@
  * WHAT IS DRAWN IS WHAT ACTS. A row Blender draws that this unit does not act
  * on is simply not here — never a row that opens a dialog we do not have, and
  * never one that no-ops. Where a row exists in Blender and is REFUSED here it
- * is drawn disabled with the refusal as its reason: Set Origin ▸ Origin to 3D
- * Cursor (there is no 3D cursor yet) and the four Add rows that want a FILE
+ * is drawn disabled with the refusal as its reason: the four Add rows that want a FILE
  * (Image ▸ Reference…/Background…/Mesh Plane…, Volume ▸ Import OpenVDB… —
  * `BlenderCreatableKind.refusal` carries each sentence). Add is the whole of
  * `VIEW3D_MT_add` now, so "not here" means Blender's menu-search row and
@@ -95,13 +94,9 @@ const ORIGIN_ROWS: readonly {
   // `type` enum's own UI names.
   { label: 'Geometry to Origin', type: 'GEOMETRY_ORIGIN' },
   { label: 'Origin to Geometry', type: 'ORIGIN_GEOMETRY' },
-  {
-    label: 'Origin to 3D Cursor',
-    type: 'ORIGIN_CURSOR',
-    refusal:
-      'There is no 3D cursor in this editor yet, so there is no point to move the origin to. ' +
-      'Blender places it with Shift+Right-click; that gesture is not built here.',
-  },
+  // The cursor is `Scene.cursor`, placed with Shift+Right-click on the model
+  // (`blender-runtime.document.tsx`).
+  { label: 'Origin to 3D Cursor', type: 'ORIGIN_CURSOR' },
 ];
 
 /**

package/contributions/blender-icons.source.mjs

@@ -147,6 +147,13 @@ const OUTLINER_ICON_NAMES = [
   // under names of OURS for the same reason the render pair has them.
   ['outliner-exclude-on', 'checkbox_hlt'],
   ['outliner-exclude-off', 'checkbox_dehlt'],
+  // The navigation cluster's camera button (`view3d_gizmo_navigate.cc`): `VIEW_CAMERA_UNSELECTED`
+  // outside the camera view and `VIEW_CAMERA` in it, under names of OURS for the same reason.
+  ['viewport-camera', 'view_camera_unselected'],
+  ['viewport-camera-view', 'view_camera'],
+  // And, in a camera view, the lock to it: `VIEW_LOCKED` / `VIEW_UNLOCKED`.
+  ['viewport-camera-locked', 'view_locked'],
+  ['viewport-camera-unlocked', 'view_unlocked'],
 ];
 
 const TRACED = new URL('./blender.icons.traced.json', import.meta.url);
@@ -693,11 +700,30 @@ g('magnifying-glass', ring(7.1, 7.1, 3.7, 1.3) + cap(9.9, 9.9, 13.2, 13.2, 1.4))
 // and the round cap floated off as a separate lozenge at 16px — measured in
 // round 1's frame, where the navigation cluster showed a disc and a diamond.
 const zoomLens = (sign) => dot(7.1, 7.1, 4.25) + sign + cap(9.3, 9.3, 13.4, 13.4, 2);
-g(
-  'magnifying-glass-plus',
-  zoomLens(holeBar(7.1, 5.2, 7.1, 9, 1.1) + holeBar(5.2, 7.1, 9, 7.1, 1.1)),
-);
-g('magnifying-glass-minus', zoomLens(holeBar(5.2, 7.1, 9, 7.1, 1.1)));
+// THE PLUS IS ONE HOLE, a cross outline: two crossing hole bars wind the crossing twice, and
+// under nonzero fill that square paints lens-coloured again (the frame showed a pale centre).
+// Its arms are Blender's on `gizmo-select-box.png`'s cluster: 14 device px across a 26 px
+// lens, 2.2 px thick.
+const plusHole = (cx, cy, a, t) =>
+  poly(
+    [
+      [cx - t, cy - a],
+      [cx + t, cy - a],
+      [cx + t, cy - t],
+      [cx + a, cy - t],
+      [cx + a, cy + t],
+      [cx + t, cy + t],
+      [cx + t, cy + a],
+      [cx - t, cy + a],
+      [cx - t, cy + t],
+      [cx - a, cy + t],
+      [cx - a, cy - t],
+      [cx - t, cy - t],
+    ],
+    true,
+  );
+g('magnifying-glass-plus', zoomLens(plusHole(7.1, 7.1, 2.3, 0.36)));
+g('magnifying-glass-minus', zoomLens(holeBar(4.8, 7.1, 9.4, 7.1, 0.72)));
 g('ellipsis', dot(3.6, 8, 1.15) + dot(8, 8, 1.15) + dot(12.4, 8, 1.15));
 g('grip-lines', cap(3, 6.3, 13, 6.3, 1.2) + cap(3, 9.7, 13, 9.7, 1.2));
 g('grip-lines-vertical', cap(6.3, 3, 6.3, 13, 1.2) + cap(9.7, 3, 9.7, 13, 1.2));
@@ -1011,6 +1037,19 @@ const perspectiveGrid = () => {
   );
 };
 g('viewport-projection', perspectiveGrid());
+/*
+ * VIEW_ORTHO, the same toggle in an orthographic view: a flat square grid of three by three
+ * cells, as wide as the perspective trapezoid (32 device px on `gizmo-select-box.png`'s
+ * navigation capsule at 2x) and centred with it, its rules the trapezoid's weight.
+ */
+const orthographicGrid = () => {
+  const lo = 2.61;
+  const hi = 13.41;
+  const w = 0.74;
+  const at = [0, 1, 2, 3].map((i) => lo + ((hi - lo) * i) / 3);
+  return at.map((v) => cap(lo, v, hi, v, w) + cap(v, lo, v, hi, w)).join('');
+};
+g('viewport-orthographic', orthographicGrid());
 g(
   'list',
   dot(3.2, 4.4, 1) +
@@ -1487,6 +1526,35 @@ g(
       [9.3, 4],
     ]),
 );
+/*
+ * SELECT BOX. Measured on `gizmo-select-box.png` (the lit first button, native 2x) and mapped onto
+ * the 16-unit grid with the marquee spanning 1..15: a dashed square, 0.7 units thick, dashes about
+ * 2.3 units with 1.1-unit gaps and an L at each corner, in the selection tools' orange (the
+ * `select` tone, `tonedPath`); inside it a pointer from its tip (6.1, 4.5) down to (6.2, 11.5),
+ * notched at (8.2, 9.4), to (11.2, 9.4).
+ */
+const MARQUEE_T = 0.7;
+const marquee =
+  // corners: an L each
+  rrect(1, 1, 2.7, MARQUEE_T) + rrect(1, 1, MARQUEE_T, 2.5) +
+  rrect(12.3, 1, 2.7, MARQUEE_T) + rrect(14.3, 1, MARQUEE_T, 2.4) +
+  rrect(1, 14.3, 2.5, MARQUEE_T) + rrect(1, 12.4, MARQUEE_T, 2.6) +
+  rrect(12.3, 14.3, 2.7, MARQUEE_T) + rrect(14.3, 12.4, MARQUEE_T, 2.6) +
+  // the dashes between
+  rrect(5, 1, 2.2, MARQUEE_T) + rrect(8.4, 1, 2.3, MARQUEE_T) +
+  rrect(5.5, 14.3, 2.4, MARQUEE_T) + rrect(9, 14.3, 2.4, MARQUEE_T) +
+  rrect(1, 4.6, MARQUEE_T, 2.1) + rrect(1, 8, MARQUEE_T, 2.1) +
+  rrect(14.3, 4.6, MARQUEE_T, 2.1) + rrect(14.3, 8, MARQUEE_T, 2.1);
+g(
+  'tool-select-box',
+  poly([
+    [6.1, 4.5],
+    [11.2, 9.4],
+    [8.2, 9.4],
+    [6.2, 11.5],
+  ]),
+  { tone: 'select', tonedPath: marquee },
+);
 g(
   /**
    * TRANSFORM (all handles). Blender's (button 6): a solid square from
@@ -2442,7 +2510,7 @@ g(
 /** The union `IconCategoryTone` declares (`@vgai/editor-sdk/looks`), and the
  *  reason `blender.style.ts` may narrow this JSON with an assertion: a tone
  *  outside it never reaches the artifact. */
-const TONES = ['object', 'modifier', 'material', 'tool', 'operator', 'data', 'scene', 'collection'];
+const TONES = ['object', 'modifier', 'material', 'tool', 'operator', 'data', 'scene', 'collection', 'select'];
 
 // The outliner's three names, aliased onto the drawings they share with the
 // generic glyphs. Same picture, its own name, so only the outliner is tinted.

package/contributions/blender-outliner-authoring.ts

@@ -57,7 +57,7 @@
  */
 
 import type { BlenderOutlinerRow } from '@volter/blender-engine/browser/rna';
-import type { ToolObject3DDocumentAuthoringFactory } from '@volter/editor-sdk/contributions';
+import type { ToolObject3DDocumentAuthoringFactory } from '@volter/editor-threejs/object3d-contributions';
 import { editorHost } from '@volter/editor-sdk/host';
 import type {
   AuthoringAdapter,
@@ -75,6 +75,7 @@ import type {
   WriteAck,
 } from '@volter/editor-project/adapter';
 import type * as THREE from 'three';
+import { threeObject } from '@volter/editor-threejs/adapter/three-contract';
 import { blenderExecute, blenderRnaSet, beginBlenderGesture, endBlenderGesture } from '../host/blender-runtime-host';
 import {
   blenderEngineSelection,
@@ -302,13 +303,10 @@ function blenderWorldMatrixRows(object: THREE.Object3D, root: THREE.Object3D): n
  * implementation of a primitive's defaults, its vertex count or its shading
  * here; the kind names the operator and the engine does the rest.
  *
- * `location=(0, 0, 0)` IS STATED RATHER THAN DEFAULTED, because Blender's own
- * answer is different: `VIEW3D_MT_add` runs every one of these with
- * `operator_context = 'EXEC_REGION_WIN'` and each `*_add` operator's `invoke`
- * places the new object at the 3D CURSOR. There is no 3D cursor in this editor
- * yet — it is not this unit's (WORK.md §B6) — so the origin is what the rows
- * below ask for explicitly instead of inheriting whatever `scene.cursor`
- * happens to hold. When a cursor arrives, these lose the argument.
+ * A NEW OBJECT LANDS AT THE 3D CURSOR, as in Blender: no row states a
+ * `location`, and an unset one is `scene->cursor.location`
+ * (`editors/object/object_add.cc`, `location_from_view`). The cursor is drawn
+ * and placed on the Model document (`blender-runtime-cursor.ts`).
  *
  * A ROW THAT NEEDS A FILE IS DRAWN DISABLED WITH THE REASON, never as a
  * gesture that cannot complete (the shape B6 set for Set Origin ▸ Origin to 3D
@@ -343,12 +341,6 @@ export interface BlenderCreatableKind {
   readonly group: string | null;
   /** The call, complete. */
   readonly call: string;
-  /** `false` where Blender's operator has NO `location` property to place with:
-   *  the generic add options come from `add_generic_props`
-   *  (`editors/object/object_add.cc:431`), and the two rows here whose operator
-   *  never calls it are `object.quick_fur` and `image.import_as_mesh_planes`.
-   *  Passing one anyway is a `TypeError` from Blender, not a placement. */
-  readonly placesAtOrigin?: boolean;
   /** This editor cannot run the row, and this is the sentence saying why — the
    *  row is drawn DISABLED with it as its reason and the operator is never
    *  called. */
@@ -444,7 +436,6 @@ export const CREATABLE_KINDS: readonly BlenderCreatableKind[] = [
     label: 'Fur',
     group: 'Curve',
     call: 'object.quick_fur',
-    placesAtOrigin: false,
   },
   // `VIEW3D_MT_surface_add`, `space_view3d.py:2484-2492`.
   {
@@ -656,7 +647,6 @@ export const CREATABLE_KINDS: readonly BlenderCreatableKind[] = [
     label: 'Mesh Plane...',
     group: 'Image',
     call: 'image.import_as_mesh_planes',
-    placesAtOrigin: false,
     refusal: needsAFilePicker('An image as a mesh plane', 'CANCELLED, with nothing created'),
   },
   {
@@ -825,11 +815,10 @@ export function blenderCreatableKinds(): readonly BlenderCreatableKind[] {
   return [...CREATABLE_KINDS, ...liveCollectionKinds()];
 }
 
-/** The complete `bpy.ops` expression a kind runs, origin included. */
+/** The complete `bpy.ops` expression a kind runs. */
 function addCall(kind: BlenderCreatableKind): string {
   const [call, ...args] = kind.call.split(', ');
-  const all = kind.placesAtOrigin === false ? args : [...args, 'location=(0, 0, 0)'];
-  return `bpy.ops.${call}(${all.join(', ')})`;
+  return `bpy.ops.${call}(${args.join(', ')})`;
 }
 
 /** A Python string literal for one Blender name. JSON's own escaping is a
@@ -1059,7 +1048,7 @@ export const createBlenderOutlinerAuthoring: ToolObject3DDocumentAuthoringFactor
    */
   const rowIdFor = (id: string): string | null => {
     if (rows().has(id)) return id;
-    const object = defaultAdapter.hierarchy.object3D?.(id) ?? null;
+    const object = threeObject(defaultAdapter.hierarchy, id);
     return object === null ? null : rowIdForObject(object);
   };
 
@@ -1096,7 +1085,7 @@ export const createBlenderOutlinerAuthoring: ToolObject3DDocumentAuthoringFactor
       return row === undefined ? null : nodeFor(row, state.parentOf.get(row.id) ?? null);
     },
     object3D: (id) => objectFor(id),
-    idForObject3D: (object) => rowIdForObject(object),
+    idForObject3D: (object: THREE.Object3D) => rowIdForObject(object),
   };
 
   /** The Blender object NAMES our selection covers — what the door wants. */

package/contributions/blender-palette.source.mjs

@@ -193,17 +193,13 @@ const MAPPING = {
   'viewport.active': rgb('space_view3d.active'),
 
   // The transform gizmo draws the theme's axis colours as they are
-  // (`transform_gizmo_3d.cc`, `gizmo_get_axis_color`).
+  // (`transform_gizmo_3d.cc`, `gizmo_get_axis_color`), and so does the navigation gizmo, mixed
+  // toward the viewport by each ball's depth as it draws (`view3d_gizmo_navigate_type.cc`; the
+  // stage computes the mix, so the measured (245,54,81) of `modeling-object-none.png` is `.tui.xaxis`
+  // at that ball's depth, not a colour of its own).
   'gizmo.x': rgb('tui.xaxis'),
   'gizmo.y': rgb('tui.yaxis'),
   'gizmo.z': rgb('tui.zaxis'),
-  'gizmo.navigationX': held(
-    '#f53651',
-    "the navigation gizmo's X ball as Blender draws it, read off `modeling-object-none.png` " +
-      '(245,54,81): drawn from `.tui.xaxis` but not equal to it — measured.',
-  ),
-  'gizmo.navigationY': held('#6fa41b', 'the same ball for Y (111,164,27) — measured, see navigationX.'),
-  'gizmo.navigationZ': held('#2e83e3', 'the same ball for Z (46,131,227) — measured, see navigationX.'),
 
   'region.outliner': rgb('space_outliner.back'),
   'region.properties': rgb('space_properties.back'),
@@ -224,6 +220,11 @@ const MAPPING = {
       '`DEF_ICON`, drawn in `.text`. Measured on the reference frames, and a level below ' +
       '`.tui.icon_scene` #cccccc, which is what it sits beside.',
   ),
+  'category.select': held(
+    '#ffaf2a',
+    "Blender's Select Box marquee, baked into the tool icon's geometry (`ops.generic.select_box`), " +
+      'not a theme member. Measured on `gizmo-select-box.png`: (255,175,42).',
+  ),
   'category.operator': held(
     '#95dab2',
     "Blender's edit-mode tool column tints its creating operators green; no theme member carries " +

package/contributions/blender-runtime-skin.ts

@@ -207,6 +207,12 @@ export class BlenderSkinDirector {
     };
   }
 
+  /** The frame on screen, or null before the clip door has been read (when `frame()` can only
+   *  say 1). */
+  playhead(): number | null {
+    return this.#clip ? this.frame() : null;
+  }
+
   /** The mixer's time as a Blender frame. With no clip the scene's own current
    *  frame stands, which is Blender's answer for a file with no animation. */
   frame(): number {

package/contributions/blender-runtime.document.tsx

@@ -25,16 +25,30 @@
  */
 
 // How the `model` stage this document builds behaves (its starting presentation).
-import '../src/presentation';
+import { blenderViewFieldOfView } from '../src/presentation';
 import { blenderModelView } from '@volter/blender-engine/browser/three/blender-runtime-view';
 import type { ToolContributionProps, ToolDocumentToolbar } from '@volter/editor-sdk/contributions';
 import { editorHost } from '@volter/editor-sdk/host';
-import { useCallback, useEffect, useRef, useState } from 'react';
+import {
+  DOCUMENT_STUDIO_PRESET,
+  subscribeViewportPresentation,
+  viewPresentation,
+} from '@volter/editor-sdk/kit/viewport-presentation';
+import {
+  type MouseEvent as ReactMouseEvent,
+  type PointerEvent as ReactPointerEvent,
+  useCallback,
+  useEffect,
+  useRef,
+  useState,
+  useSyncExternalStore,
+} from 'react';
 import * as THREE from 'three';
-import { bindModelDocument, openModelDocumentBlend } from '../host/blender-runtime-host';
+import { bindModelDocument, blenderExecute, openModelDocumentBlend } from '../host/blender-runtime-host';
 import { BlenderObjectModeHeader } from './blender-header-menus';
 import { createBlenderOutlinerAuthoring } from './blender-outliner-authoring';
 import { blenderSkin } from './blender-runtime-skin';
+import { onViewportStages, viewportStages } from '@volter/editor-threejs/viewport-door';
 
 export const point = 'workspace.document';
 export const title = 'Blender Model';
@@ -80,6 +94,51 @@ export const inspectorBuiltins: readonly string[] = [];
 // Timeline binds a skeleton into the same presented graph and there is exactly
 // one set of presented objects (`blender-runtime-skin.ts`).
 const view = blenderModelView;
+/** THE SUBJECT LINE'S FRAME IS THE ONE ON SCREEN: the skin's playhead, which during playback
+ *  runs ahead of `frame_current` (written once, on pause), as Blender's own `(frame)` does. */
+const subjectOfView = () => {
+  const playhead = blenderSkin.playhead();
+  return view.subjectLine(playhead === null ? null : Math.floor(playhead));
+};
+const gridScale = (worldPerDevicePixel: number) => view.gridUnitName(worldPerDevicePixel);
+/** BLENDER'S CAMERA VIEW (`blender-runtime-camera-view.ts`): which camera, and how it fits. */
+const cameraView = {
+  camera: () => view.cameraViewCamera(),
+  zoom: view.cameraViewZoom,
+  pan: view.cameraViewPan,
+  showing: (camera: string | null) => view.setCameraViewShowing(camera),
+  // A LOCKED camera view moves the camera (`ED_view3d_camera_lock_sync`: its scale kept); the
+  // navigation's end is the one step Blender's history records.
+  setPose: (
+    camera: string,
+    position: readonly [number, number, number],
+    quaternion: readonly [number, number, number, number],
+    final: boolean,
+  ) => {
+    const { location, rotation } = view.blenderPose(position, quaternion);
+    return blenderExecute(
+      'from mathutils import Matrix, Quaternion, Vector\n' +
+        `import bpy\nobject = bpy.data.objects[${JSON.stringify(camera)}]\n` +
+        `object.matrix_world = Matrix.LocRotScale(Vector((${location.join(', ')})), ` +
+        `Quaternion((${rotation.join(', ')})), object.matrix_world.to_scale())`,
+      final,
+      'Lock Camera to View',
+    ).then(
+      (answer) => {
+        if (answer.error !== null)
+          editorHost().console.error(`Blender refused the camera's pose: ${answer.error}`, 'blender-camera');
+      },
+      (error: unknown) =>
+        editorHost().console.error(`The camera's pose was not written to Blender: ${String(error)}`, 'blender-camera'),
+    );
+  },
+  view: (
+    camera: string,
+    region: { readonly width: number; readonly height: number },
+    zoom: number,
+    offset: readonly [number, number],
+  ) => view.cameraView(camera, region, zoom, offset),
+};
 
 export default function BlenderModelDocument(props: ToolContributionProps) {
   const { active, document, documentId, notify, publishContext } = props;
@@ -153,6 +212,30 @@ function BlenderModelViewport({
     [],
   );
   const blend = document?.source?.path;
+  // Re-read on the engine's frames, the skin's publications and every drawn frame of this stage
+  // (playback moves the playhead with no publication); the snapshot is a string, so only a
+  // changed line re-renders.
+  const subscribeSubject = useCallback(
+    (listener: () => void) => {
+      const stopView = view.onChange(listener);
+      const stopSkin = blenderSkin.subscribe(listener);
+      let stopFrame: (() => void) | null = null;
+      const bind = (): void => {
+        stopFrame?.();
+        stopFrame = viewportStages().find((one) => one.documentId === documentId)?.onFrame(listener) ?? null;
+      };
+      bind();
+      const stopStages = onViewportStages(bind);
+      return () => {
+        stopView();
+        stopSkin();
+        stopStages();
+        stopFrame?.();
+      };
+    },
+    [documentId],
+  );
+  const subject = useSyncExternalStore(subscribeSubject, subjectOfView);
   /**
    * THE INSPECTION OVERLAYS ARE HELPERS, and the Helpers menu owns them
    * (WORK.md §Blender in the tab is Blender, "Inspection parity", I4).
@@ -169,18 +252,17 @@ function BlenderModelViewport({
    */
   useEffect(() => {
     if (!documentId) return;
-    const { viewport } = editorHost();
     const groups = view.overlayGroups();
     const apply = (): void => {
-      const stage = viewport.stages().find((one) => one.documentId === documentId);
+      const stage = viewportStages().find((one) => one.documentId === documentId);
       if (!stage) return;
       for (const { kind, object } of groups) stage.setHelper(kind, object);
     };
     apply();
-    const stop = viewport.onStages(apply);
+    const stop = onViewportStages(apply);
     return () => {
       stop();
-      const stage = viewport.stages().find((one) => one.documentId === documentId);
+      const stage = viewportStages().find((one) => one.documentId === documentId);
       for (const { kind } of groups) stage?.setHelper(kind, null);
     };
   }, [documentId]);
@@ -212,14 +294,125 @@ function BlenderModelViewport({
       detach?.();
     };
   }, [documentId]);
+  /**
+   * BLENDER'S RENDERED SHADING IS THE SCENE'S OWN LIGHT. When this stage's view lights by the
+   * `scene` (the Rendered shading cell, or the Lighting row's Scene), the presenter holds the viewport
+   * in the lighting its render photographs with (`BlenderRuntimeView.holdRendered`): the
+   * scene's lights, its World, `hide_render` and shadows, through the camera the stage draws
+   * with, re-applied from the stage's frame loop when that camera or the World changes. Any
+   * other source returns it to modeling. The stage itself draws a `scene` source unlit
+   * (`standard-viewport-dressing.ts`), because Blender's lights live in the presenter.
+   */
+  useEffect(() => {
+    if (!documentId) return;
+    const stageOf = () => viewportStages().find((one) => one.documentId === documentId);
+    let framed: ReturnType<typeof stageOf> = undefined;
+    let stopFrame: (() => void) | null = null;
+    // One getter for the life of the effect, so holding again is not a change; the stand-in is
+    // for the moment a stage has left and `onStages` has not yet released the hold.
+    const standIn = new THREE.PerspectiveCamera();
+    const drawCamera = (): THREE.Camera => stageOf()?.rig().drawCamera() ?? standIn;
+    const apply = (): void => {
+      const stage = stageOf();
+      if (stage !== framed) {
+        stopFrame?.();
+        stopFrame = stage ? stage.onFrame(() => view.refreshRendered()) : null;
+        framed = stage;
+      }
+      const { lighting } = viewPresentation(documentId);
+      view.holdRendered(lighting.source === 'scene' && stage ? drawCamera : null);
+      // BLENDER'S SOLID IS BLENDER'S OWN FUNCTION: while the stage lights by Blender's studio, the
+      // presenter draws every surface by it (`blender-workbench-material.ts`).
+      view.setWorkbench(lighting.source === 'studio' && lighting.studioPreset === DOCUMENT_STUDIO_PRESET.id);
+    };
+    apply();
+    const stopPresentation = subscribeViewportPresentation(apply);
+    const stopStages = onViewportStages(apply);
+    return () => {
+      stopPresentation();
+      stopStages();
+      stopFrame?.();
+      view.holdRendered(null);
+      view.setWorkbench(false);
+    };
+  }, [documentId]);
+  /**
+   * SHIFT+RIGHT-CLICK PLACES THE 3D CURSOR, Blender's own chord for
+   * `view3d.cursor3d` (`blender_default.py`, `params.cursor_set_event`). The
+   * press is taken before the stage's orbit sees it, and a press that moves
+   * is not a click. A press that never came back (released outside the page,
+   * cancelled) is dropped by the next press or the cancel, so it can never
+   * swallow a later orbit's release. The drawn cursor moves at once (`placeCursor`); Blender
+   * then writes `Scene.cursor` with no history step, as its operator pushes
+   * no undo.
+   */
+  const cursorPress = useRef<{ id: number; x: number; y: number } | null>(null);
+  const cursorChord = (event: ReactPointerEvent | ReactMouseEvent): boolean =>
+    event.button === 2 && event.shiftKey && event.target instanceof HTMLCanvasElement;
+  const onPointerDownCapture = (event: ReactPointerEvent): void => {
+    if (!cursorChord(event)) {
+      cursorPress.current = null;
+      return;
+    }
+    event.preventDefault();
+    event.stopPropagation();
+    cursorPress.current = { id: event.pointerId, x: event.clientX, y: event.clientY };
+    // A real pointer is captured so its release comes back here; a synthetic one cannot be.
+    if (event.isTrusted) (event.target as Element).setPointerCapture(event.pointerId);
+  };
+  const dropCursorPress = (): void => {
+    cursorPress.current = null;
+  };
+  const onPointerUpCapture = (event: ReactPointerEvent): void => {
+    const press = cursorPress.current;
+    if (press === null || event.pointerId !== press.id || event.button !== 2) return;
+    cursorPress.current = null;
+    event.preventDefault();
+    event.stopPropagation();
+    if (Math.hypot(event.clientX - press.x, event.clientY - press.y) > 3) return;
+    const placed = view.placeCursor(event.clientX, event.clientY, event.target);
+    if (placed === null) return;
+    const [x, y, z] = placed.location;
+    const [qw, qx, qy, qz] = placed.rotation;
+    void blenderExecute(
+      'from mathutils import Matrix, Quaternion, Vector\n' +
+        `bpy.context.scene.cursor.matrix = Matrix.LocRotScale(Vector((${x}, ${y}, ${z})), ` +
+        `Quaternion((${qw}, ${qx}, ${qy}, ${qz})), None)`,
+      false,
+      'Set 3D Cursor',
+    ).then(
+      (answer) => {
+        if (answer.error !== null)
+          editorHost().console.error(`Blender refused the 3D cursor: ${answer.error}`, 'blender-cursor');
+      },
+      (error: unknown) =>
+        editorHost().console.error(`The 3D cursor was not written to Blender: ${String(error)}`, 'blender-cursor'),
+    );
+  };
+  const onContextMenuCapture = (event: ReactMouseEvent): void => {
+    if (cursorChord(event)) event.preventDefault();
+  };
   if (!documentId) return null;
   const Surface = surfaces.Object3DAuthoring;
   return (
+    <div
+      style={{ display: 'contents' }}
+      onPointerDownCapture={onPointerDownCapture}
+      onPointerUpCapture={onPointerUpCapture}
+      onPointerCancelCapture={dropCursorPress}
+      onLostPointerCaptureCapture={dropCursorPress}
+      onContextMenuCapture={onContextMenuCapture}
+    >
     <Surface
       active={active ?? true}
       documentId={documentId}
       sourcePath={blend ?? 'blender:runtime'}
       displayName={document?.label ?? 'Model'}
+      // THE OVERLAY'S SUBJECT AND GRID LINES ARE BLENDER'S: the engine composes the subject from
+      // the scene (`session.py` `_subject_line`) and names the grid's step in the scene's units.
+      {...(subject === null ? {} : { subject })}
+      gridScale={gridScale}
+      cameraView={cameraView}
       build={build}
       audit={false}
       // ON A MODEL DOCUMENT THE HIERARCHY IS BLENDER'S OUTLINER, for the same
@@ -232,12 +425,17 @@ function BlenderModelViewport({
       // "Inspection parity", I3).
       authoring={createBlenderOutlinerAuthoring}
       cameraDirection={[0.8187, 0.4458, 0.3617]}
-      // AND AS FAR BACK AS BLENDER'S STARTUP VIEW STANDS. The direction alone
-      // put the cube where Blender's is but FILLING the frame: the factory
-      // view is 18.39 units from a 2 m cube (`region_3d.view_distance` at
-      // `--factory-startup`), about a third of the size a bare fit gives, which
-      // is the number `openingFit` was written for and nothing was passing.
+      // FOR A FILE THAT SAVED NO 3D VIEW: Blender's factory Modeling direction, standing back
+      // three fits.
       openingFit={3}
+      // 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).
+      presentation={(() => {
+        const saved = view.savedView();
+        return saved ? { camera: { fov: blenderViewFieldOfView(saved.lens) } } : null;
+      })()}
       // Every entry this document opens is a `model` stage, the standing `blender:runtime`
       // address included (its id carries no `model:` prefix).
       stageKind={documentKind}
@@ -254,22 +452,15 @@ function BlenderModelViewport({
       // The BACKGROUND stays the dressing's, because the Blender palette
       // already paints the viewport its own flat grey.
       //
-      // AND THE VIEW TRANSFORM IS BLENDER'S. Blender's factory scene is AgX
-      // (`view_settings.view_transform`), and this document's own RENDER path
-      // already photographs through `THREE.AgXToneMapping` (`presenter.ts`),
-      // so the viewport was the one surface in the chain running a different
-      // curve from the thing it frames. MEASURED on the factory cube, our own
-      // radiance through each operator against Blender's (141,143,145)/
-      // (129,131,131)/(111,112,113): ACES lands the three faces within 6
-      // levels with a spread of 40 where Blender's is 30 — the curve, not the
-      // lights, is what was left of row 1's spread — and AgX within 3 at a
-      // spread of 26.
+      // THE VIEW TRANSFORM IS EACH SHADING MODE'S OWN (`src/presentation.ts`: Standard for Solid,
+      // AgX for Material Preview and Rendered), so the dressing states none: a document mapper
+      // would outrank every mode's.
       dressing={{
         environment: false,
         keyLight: false,
-        toneMapping: THREE.AgXToneMapping,
         viewLocked: view.studioLights(),
       }}
     />
+    </div>
   );
 }

package/contributions/blender.icons.json

@@ -911,10 +911,10 @@
       "path": "M1.5 6.9A5.4 5.4 0 1 0 12.3 6.9A5.4 5.4 0 1 0 1.5 6.9ZM3.28 6.9A3.63 3.63 0 1 1 10.53 6.9A3.63 3.63 0 1 1 3.28 6.9ZM9.64 10.99L13.67 15.02A0.96 0.96 0 0 0 15.02 13.67L10.99 9.64A0.96 0.96 0 0 0 9.64 10.99Z"
     },
     "magnifying-glass-minus": {
-      "path": "M1.72 6.9A5.19 5.19 0 1 0 12.09 6.9A5.19 5.19 0 1 0 1.72 6.9ZM4.58 7.57L4.58 6.23L9.22 6.23L9.22 7.57ZM8.62 10.55L13.62 15.55A1.37 1.37 0 0 0 15.55 13.62L10.55 8.62A1.37 1.37 0 0 0 8.62 10.55Z"
+      "path": "M1.72 6.9A5.19 5.19 0 1 0 12.09 6.9A5.19 5.19 0 1 0 1.72 6.9ZM4.1 7.34L4.1 6.46L9.71 6.46L9.71 7.34ZM8.62 10.55L13.62 15.55A1.37 1.37 0 0 0 15.55 13.62L10.55 8.62A1.37 1.37 0 0 0 8.62 10.55Z"
     },
     "magnifying-glass-plus": {
-      "path": "M1.72 6.9A5.19 5.19 0 1 0 12.09 6.9A5.19 5.19 0 1 0 1.72 6.9ZM6.23 4.58L7.57 4.58L7.57 9.22L6.23 9.22ZM4.58 7.57L4.58 6.23L9.22 6.23L9.22 7.57ZM8.62 10.55L13.62 15.55A1.37 1.37 0 0 0 15.55 13.62L10.55 8.62A1.37 1.37 0 0 0 8.62 10.55Z"
+      "path": "M1.72 6.9A5.19 5.19 0 1 0 12.09 6.9A5.19 5.19 0 1 0 1.72 6.9ZM6.46 4.1L7.34 4.1L7.34 6.46L9.71 6.46L9.71 7.34L7.34 7.34L7.34 9.71L6.46 9.71L6.46 7.34L4.1 7.34L4.1 6.46L6.46 6.46ZM8.62 10.55L13.62 15.55A1.37 1.37 0 0 0 15.55 13.62L10.55 8.62A1.37 1.37 0 0 0 8.62 10.55Z"
     },
     "maximize": {
       "path": "M5.8 0.28L1.17 0.28A0.89 0.89 0 0 0 1.17 2.06L5.8 2.06A0.89 0.89 0 0 0 5.8 0.28ZM0.28 1.17L0.28 5.8A0.89 0.89 0 0 0 2.06 5.8L2.06 1.17A0.89 0.89 0 0 0 0.28 1.17ZM10.2 2.06L14.83 2.06A0.89 0.89 0 0 0 14.83 0.28L10.2 0.28A0.89 0.89 0 0 0 10.2 2.06ZM13.94 1.17L13.94 5.8A0.89 0.89 0 0 0 15.72 5.8L15.72 1.17A0.89 0.89 0 0 0 13.94 1.17ZM5.8 13.94L1.17 13.94A0.89 0.89 0 0 0 1.17 15.72L5.8 15.72A0.89 0.89 0 0 0 5.8 13.94ZM2.06 14.83L2.06 10.2A0.89 0.89 0 0 0 0.28 10.2L0.28 14.83A0.89 0.89 0 0 0 2.06 14.83ZM10.2 15.72L14.83 15.72A0.89 0.89 0 0 0 14.83 13.94L10.2 13.94A0.89 0.89 0 0 0 10.2 15.72ZM15.72 14.83L15.72 10.2A0.89 0.89 0 0 0 13.94 10.2L13.94 14.83A0.89 0.89 0 0 0 15.72 14.83Z"
@@ -1207,6 +1207,11 @@
     "tool-scale": {
       "path": "M1.17 1.1L14.83 1.1A0.55 0.55 0 0 0 14.83 0.01L1.17 0.01A0.55 0.55 0 0 0 1.17 1.1ZM14.29 0.56L14.29 14.22A0.55 0.55 0 0 0 15.38 14.22L15.38 0.56A0.55 0.55 0 0 0 14.29 0.56ZM14.83 13.68L1.17 13.68A0.55 0.55 0 0 0 1.17 14.77L14.83 14.77A0.55 0.55 0 0 0 14.83 13.68ZM1.71 14.22L1.71 0.56A0.55 0.55 0 0 0 0.62 0.56L0.62 14.22A0.55 0.55 0 0 0 1.71 14.22ZM0.31 7.51A0.24 0.24 0 0 0 0.07 7.76L0.07 14.95A0.24 0.24 0 0 0 0.31 15.2L7.51 15.2A0.24 0.24 0 0 0 7.76 14.95L7.76 7.76A0.24 0.24 0 0 0 7.51 7.51ZM9.19 7.12L11.75 4.55A0.65 0.65 0 0 0 10.84 3.64L8.27 6.2A0.65 0.65 0 0 0 9.19 7.12ZM9.59 3.12L12.27 5.8L13.37 2.02Z"
     },
+    "tool-select-box": {
+      "path": "M5.8 12.27L8.24 9.71L11.9 9.71L5.68 3.73Z",
+      "tone": "select",
+      "tonedPath": "M-0.54 0.31L2.75 0.31L2.75 -0.54L-0.54 -0.54ZM-0.54 2.51L0.31 2.51L0.31 -0.54L-0.54 -0.54ZM13.25 0.31L16.54 0.31L16.54 -0.54L13.25 -0.54ZM15.69 2.39L16.54 2.39L16.54 -0.54L15.69 -0.54ZM-0.54 16.54L2.51 16.54L2.51 15.69L-0.54 15.69ZM-0.54 16.54L0.31 16.54L0.31 13.37L-0.54 13.37ZM13.25 16.54L16.54 16.54L16.54 15.69L13.25 15.69ZM15.69 16.54L16.54 16.54L16.54 13.37L15.69 13.37ZM4.34 0.31L7.02 0.31L7.02 -0.54L4.34 -0.54ZM8.49 0.31L11.29 0.31L11.29 -0.54L8.49 -0.54ZM4.95 16.54L7.88 16.54L7.88 15.69L4.95 15.69ZM9.22 16.54L12.15 16.54L12.15 15.69L9.22 15.69ZM-0.54 6.41L0.31 6.41L0.31 3.85L-0.54 3.85ZM-0.54 10.56L0.31 10.56L0.31 8L-0.54 8ZM15.69 6.41L16.54 6.41L16.54 3.85L15.69 3.85ZM15.69 10.56L16.54 10.56L16.54 8L15.69 8Z"
+    },
     "tool-transform": {
       "path": "M4.83 4.52A0.31 0.31 0 0 0 4.52 4.83L4.52 11.17A0.31 0.31 0 0 0 4.83 11.48L11.17 11.48A0.31 0.31 0 0 0 11.48 11.17L11.48 4.83A0.31 0.31 0 0 0 11.17 4.52ZM8 -1.64L5.93 1.41L10.07 1.41ZM8 17.64L10.07 14.59L5.93 14.59ZM-1.64 8L1.41 10.07L1.41 5.93ZM17.64 8L14.59 5.93L14.59 10.07ZM15.55 10.75L15.09 11.77L14.5 12.72L13.78 13.58L12.95 14.33L12.02 14.96L11.01 15.45L11.48 16.61L12.65 16.05L13.72 15.32L14.68 14.45L15.52 13.46L16.2 12.36L16.73 11.18ZM15.51 10.96A0.63 0.63 0 1 0 16.77 10.96A0.63 0.63 0 1 0 15.51 10.96ZM10.62 16.03A0.63 0.63 0 1 0 11.87 16.03A0.63 0.63 0 1 0 10.62 16.03ZM5.25 15.55L4.23 15.09L3.28 14.5L2.42 13.78L1.67 12.95L1.04 12.02L0.55 11.01L-0.61 11.48L-0.05 12.65L0.68 13.72L1.55 14.68L2.54 15.52L3.64 16.2L4.82 16.73ZM4.41 16.14A0.63 0.63 0 1 0 5.67 16.14A0.63 0.63 0 1 0 4.41 16.14ZM-0.66 11.24A0.63 0.63 0 1 0 0.6 11.24A0.63 0.63 0 1 0 -0.66 11.24ZM0.45 5.25L0.91 4.23L1.5 3.28L2.22 2.42L3.05 1.67L3.98 1.04L4.99 0.55L4.52 -0.61L3.35 -0.05L2.28 0.68L1.32 1.55L0.48 2.54L-0.2 3.64L-0.73 4.82ZM-0.77 5.04A0.63 0.63 0 1 0 0.49 5.04A0.63 0.63 0 1 0 -0.77 5.04ZM4.13 -0.03A0.63 0.63 0 1 0 5.38 -0.03A0.63 0.63 0 1 0 4.13 -0.03ZM10.75 0.45L11.77 0.91L12.72 1.5L13.58 2.22L14.33 3.05L14.96 3.98L15.45 4.99L16.61 4.52L16.05 3.35L15.32 2.28L14.45 1.32L13.46 0.48L12.36 -0.2L11.18 -0.73ZM10.33 -0.14A0.63 0.63 0 1 0 11.59 -0.14A0.63 0.63 0 1 0 10.33 -0.14ZM15.4 4.76A0.63 0.63 0 1 0 16.66 4.76A0.63 0.63 0 1 0 15.4 4.76Z"
     },
@@ -1225,6 +1230,21 @@
     "users": {
       "path": "M1.78 4.34A3.05 3.05 0 1 0 7.88 4.34A3.05 3.05 0 1 0 1.78 4.34ZM0.31 13.61L0.37 12.91L0.53 12.22L0.81 11.56L1.18 10.96L1.64 10.42L2.17 9.96L2.78 9.59L3.43 9.32L4.12 9.15L4.83 9.1L5.53 9.15L6.22 9.32L6.88 9.59L7.48 9.96L8.02 10.42L8.48 10.96L8.85 11.56L9.12 12.22L9.29 12.91L9.34 13.61L11.05 13.61L10.97 12.64L10.75 11.69L10.37 10.79L9.86 9.95L9.23 9.21L8.49 8.58L7.65 8.07L6.75 7.69L5.8 7.47L4.83 7.39L3.85 7.47L2.91 7.69L2 8.07L1.17 8.58L0.43 9.21L-0.21 9.95L-0.72 10.79L-1.09 11.69L-1.32 12.64L-1.39 13.61ZM-1.39 13.61A0.85 0.85 0 1 0 0.31 13.61A0.85 0.85 0 1 0 -1.39 13.61ZM9.34 13.61A0.85 0.85 0 1 0 11.05 13.61A0.85 0.85 0 1 0 9.34 13.61ZM11.54 3.16L11.8 3.09L12.07 3.05L12.35 3.06L12.61 3.11L12.87 3.21L13.11 3.33L13.33 3.5L13.52 3.7L13.67 3.92L13.79 4.16L13.88 4.42L13.92 4.69L13.92 4.96L13.88 5.23L13.79 5.49L13.67 5.74L13.52 5.96L13.33 6.16L13.11 6.32L12.87 6.45L12.61 6.54L12.35 6.59L12.07 6.6L11.8 6.57L11.54 6.5L11 7.97L11.5 8.11L12.01 8.17L12.52 8.15L13.03 8.06L13.51 7.89L13.96 7.64L14.37 7.33L14.73 6.96L15.02 6.54L15.25 6.08L15.41 5.59L15.49 5.08L15.49 4.57L15.41 4.06L15.25 3.57L15.02 3.11L14.73 2.69L14.37 2.32L13.96 2.01L13.51 1.77L13.03 1.6L12.52 1.5L12.01 1.48L11.5 1.54L11 1.68ZM10.49 2.42A0.79 0.79 0 1 0 12.06 2.42A0.79 0.79 0 1 0 10.49 2.42ZM10.49 7.24A0.79 0.79 0 1 0 12.06 7.24A0.79 0.79 0 1 0 10.49 7.24ZM9.04 11.66L9.26 11.16L9.56 10.71L9.92 10.3L10.34 9.95L10.81 9.68L11.32 9.47L11.85 9.35L12.39 9.31L12.94 9.35L13.47 9.47L13.97 9.68L14.44 9.95L14.86 10.3L15.23 10.71L15.52 11.16L15.75 11.66L17.29 11.1L16.96 10.37L16.53 9.71L16 9.12L15.38 8.61L14.7 8.21L13.96 7.91L13.18 7.73L12.39 7.67L11.6 7.73L10.82 7.91L10.09 8.21L9.4 8.61L8.79 9.12L8.26 9.71L7.82 10.37L7.49 11.1ZM7.45 11.38A0.82 0.82 0 1 0 9.08 11.38A0.82 0.82 0 1 0 7.45 11.38ZM15.7 11.38A0.82 0.82 0 1 0 17.34 11.38A0.82 0.82 0 1 0 15.7 11.38Z"
     },
+    "viewport-camera": {
+      "path": "M4 12L4 10.5C4 10.22 4.22 10 4.5 10L10.5 10C10.78 10 11 10.22 11 10.5L11 15.5C11 15.78 10.78 16 10.5 16L5.71 16C5.57 16 5.45 15.95 5.35 15.85L4.15 14.65C4.05 14.55 4 14.43 4 14.29L4 13L3 13L3 13.5C3 13.78 2.78 14 2.5 14C2.22 14 2 13.78 2 13.5L2 11.5C2 11.22 2.22 11 2.5 11C2.78 11 3 11.22 3 11.5L3 12ZM5.91 15L5 14.09L5 11L10 11L10 15ZM13.22 13.5L15 14.59L15 12.41ZM15.15 15.85C15.24 15.94 15.36 16 15.5 16C15.78 16 16 15.78 16 15.5L16 11.5C16 11.22 15.78 11 15.5 11C15.36 11 15.24 11.06 15.15 11.15L12.04 13.04C11.87 13.12 11.75 13.3 11.75 13.5C11.75 13.7 11.87 13.88 12.04 13.96ZM6.38 4.22C6.02 4.3 5.65 4.17 5.41 3.89C4.95 3.34 4.27 3 3.5 3C2.12 3 1 4.12 1 5.5C1 6.88 2.12 8 3.5 8L10.5 8C12.43 8 14 6.43 14 4.5C14 2.57 12.43 1 10.5 1C8.91 1 7.56 2.06 7.14 3.52C7.04 3.88 6.75 4.15 6.38 4.22ZM6.61 2.24C6.42 2.56 6.28 2.89 6.18 3.25C5.94 2.97 5.67 2.73 5.36 2.54C4.82 2.2 4.18 2 3.5 2C1.57 2 0 3.57 0 5.5C0 7.43 1.57 9 3.5 9L10.5 9C12.99 9 15 6.99 15 4.5C15 2.01 12.99 0 10.5 0C8.84 0 7.38 0.9 6.61 2.24ZM10.5 5C10.78 5 11 4.78 11 4.5C11 4.22 10.78 4 10.5 4C10.22 4 10 4.22 10 4.5C10 4.78 10.22 5 10.5 5ZM10.5 6C11.33 6 12 5.33 12 4.5C12 3.67 11.33 3 10.5 3C9.67 3 9 3.67 9 4.5C9 5.33 9.67 6 10.5 6ZM4.5 5.5C4.5 6.05 4.05 6.5 3.5 6.5C2.95 6.5 2.5 6.05 2.5 5.5C2.5 4.95 2.95 4.5 3.5 4.5C4.05 4.5 4.5 4.95 4.5 5.5Z"
+    },
+    "viewport-camera-locked": {
+      "path": "M3 7L3 5C3 2.24 5.24 0 8 0C10.76 0 13 2.24 13 5L13 7L13.5 7C13.78 7 14 7.22 14 7.5L14 15.5C14 15.78 13.78 16 13.5 16L2.5 16C2.22 16 2 15.78 2 15.5L2 7.5C2 7.22 2.22 7 2.5 7ZM4 5C4 2.79 5.79 1 8 1C10.21 1 12 2.79 12 5L12 7L4 7ZM8 10C7.45 10 7 10.45 7 11C7 11.37 7.2 11.69 7.5 11.87L7.5 13C7.5 13.28 7.72 13.5 8 13.5C8.28 13.5 8.5 13.28 8.5 13L8.5 11.87C8.8 11.69 9 11.37 9 11C9 10.45 8.55 10 8 10Z"
+    },
+    "viewport-camera-unlocked": {
+      "path": "M8 10C7.45 10 7 10.45 7 11C7 11.37 7.2 11.69 7.5 11.87L7.5 13C7.5 13.28 7.72 13.5 8 13.5C8.28 13.5 8.5 13.28 8.5 13L8.5 11.87C8.8 11.69 9 11.37 9 11C9 10.45 8.55 10 8 10ZM8 1C5.79 1 4 2.79 4 5L4 7L13.5 7C13.78 7 14 7.22 14 7.5L14 15.5C14 15.78 13.78 16 13.5 16L2.5 16C2.22 16 2 15.78 2 15.5L2 7.5C2 7.22 2.22 7 2.5 7L3 7L3 5C3 2.24 5.24 0 8 0C10.22 0 12.1 1.44 12.75 3.44C12.83 3.69 12.69 3.94 12.45 4.02C12.17 4.11 11.87 3.94 11.77 3.66C11.22 2.11 9.74 1 8 1ZM3 8L3 15L13 15L13 8Z"
+    },
+    "viewport-camera-view": {
+      "path": "M10.5 0C8.36 0 6.69 1.47 6.17 3.24C5.52 2.5 4.66 2 3.5 2C1.57 2 0 3.57 0 5.5C0 7.43 1.57 9 3.5 9L10.5 9C12.98 9 15 6.98 15 4.5C15 2.02 12.98 0 10.5 0ZM10.5 3C11.32 3 12 3.68 12 4.5C12 5.32 11.32 6 10.5 6C9.68 6 9 5.32 9 4.5C9 3.68 9.68 3 10.5 3ZM3.5 4C4.32 4 5 4.68 5 5.5C5 6.32 4.32 7 3.5 7C2.68 7 2 6.32 2 5.5C2 4.68 2.68 4 3.5 4ZM10.5 4C10.22 4 10 4.22 10 4.5C10 4.78 10.22 5 10.5 5C10.78 5 11 4.78 11 4.5C11 4.22 10.78 4 10.5 4ZM3.5 5C3.22 5 3 5.22 3 5.5C3 5.78 3.22 6 3.5 6C3.78 6 4 5.78 4 5.5C4 5.22 3.78 5 3.5 5ZM4.5 10C4.22 10 4 10.22 4 10.5L4 11.5L4 12L3 12L3 11.5C3 11.22 2.77 10.99 2.49 10.99C2.22 10.99 2 11.22 2 11.5L2 12.5L2 13.5C2.01 14.16 2.99 14.16 3 13.5L3 13L4 13L4 13.5L4 14.5C4 14.63 4.05 14.76 4.15 14.85L5.15 15.85C5.24 15.95 5.37 16 5.5 16L10.5 16C10.78 16 11 15.78 11 15.5L11 10.5C11 10.22 10.78 10 10.5 10ZM15.48 11C15.4 11 15.31 11.03 15.24 11.07L11.99 13.07C11.67 13.27 11.67 13.73 11.99 13.93L15.24 15.93C15.57 16.13 16 15.89 16 15.5L16 11.5C16 11.22 15.77 10.99 15.48 11Z"
+    },
+    "viewport-orthographic": {
+      "path": "M1.42 1.93L14.6 1.93A0.51 0.51 0 0 0 14.6 0.92L1.42 0.92A0.51 0.51 0 0 0 1.42 1.93ZM0.92 1.42L0.92 14.6A0.51 0.51 0 0 0 1.93 14.6L1.93 1.42A0.51 0.51 0 0 0 0.92 1.42ZM1.42 6.32L14.6 6.32A0.51 0.51 0 0 0 14.6 5.31L1.42 5.31A0.51 0.51 0 0 0 1.42 6.32ZM5.31 1.42L5.31 14.6A0.51 0.51 0 0 0 6.32 14.6L6.32 1.42A0.51 0.51 0 0 0 5.31 1.42ZM1.42 10.71L14.6 10.71A0.51 0.51 0 0 0 14.6 9.7L1.42 9.7A0.51 0.51 0 0 0 1.42 10.71ZM9.7 1.42L9.7 14.6A0.51 0.51 0 0 0 10.71 14.6L10.71 1.42A0.51 0.51 0 0 0 9.7 1.42ZM1.42 15.11L14.6 15.11A0.51 0.51 0 0 0 14.6 14.09L1.42 14.09A0.51 0.51 0 0 0 1.42 15.11ZM14.09 1.42L14.09 14.6A0.51 0.51 0 0 0 15.11 14.6L15.11 1.42A0.51 0.51 0 0 0 14.09 1.42Z"
+    },
     "viewport-projection": {
       "path": "M4.14 3.27L11.88 3.27A0.51 0.51 0 0 0 11.88 2.26L4.14 2.26A0.51 0.51 0 0 0 4.14 3.27ZM3.5 5.8L12.53 5.8A0.51 0.51 0 0 0 12.53 4.79L3.5 4.79A0.51 0.51 0 0 0 3.5 5.8ZM2.57 9.4L13.45 9.4A0.51 0.51 0 0 0 13.45 8.39L2.57 8.39A0.51 0.51 0 0 0 2.57 9.4ZM1.42 13.85L14.6 13.85A0.51 0.51 0 0 0 14.6 12.84L1.42 12.84A0.51 0.51 0 0 0 1.42 13.85ZM3.66 2.64L0.93 13.22A0.51 0.51 0 0 0 1.91 13.47L4.63 2.89A0.51 0.51 0 0 0 3.66 2.64ZM11.39 2.89L14.11 13.47A0.51 0.51 0 0 0 15.09 13.22L12.37 2.64A0.51 0.51 0 0 0 11.39 2.89ZM6.42 2.71L5.24 13.29A0.51 0.51 0 0 0 6.25 13.4L7.43 2.82A0.51 0.51 0 0 0 6.42 2.71ZM8.6 2.82L9.78 13.4A0.51 0.51 0 0 0 10.78 13.29L9.6 2.71A0.51 0.51 0 0 0 8.6 2.82Z"
     },

package/contributions/blender.icons.traced.json

@@ -1557,5 +1557,33 @@
     "sha256": "5fcacba19714529d2283550eeff5c052cf59b190aa32403d2e692dc1ca424b07",
     "box": [3, 3, 13, 13],
     "path": "M4.03 3C3.47 3 3 3.47 3 4.03L3 11.97C3 12.53 3.47 13 4.03 13L11.97 13C12.53 13 13 12.53 13 11.97L13 4.03C13 3.47 12.53 3 11.97 3ZM4.03 4L11.97 4C11.99 4 12 4 12 4.03L12 11.97C12 11.99 11.99 12 11.97 12L4.03 12C4.01 12 4 11.99 4 11.97L4 4.03C4 4.01 4.01 4 4.03 4Z"
+  },
+  "viewport-camera": {
+    "icon": "ICON_VIEW_CAMERA_UNSELECTED",
+    "source": "release/datafiles/icons_svg/view_camera_unselected.svg",
+    "sha256": "a286ff50999057585a5b45714bf98d2a6706f60be114b7b1386fb33d63a2cef3",
+    "box": [0, 0, 16, 16],
+    "path": "M4 12L4 10.5C4 10.22 4.22 10 4.5 10L10.5 10C10.78 10 11 10.22 11 10.5L11 15.5C11 15.78 10.78 16 10.5 16L5.71 16C5.57 16 5.45 15.95 5.35 15.85L4.15 14.65C4.05 14.55 4 14.43 4 14.29L4 13L3 13L3 13.5C3 13.78 2.78 14 2.5 14C2.22 14 2 13.78 2 13.5L2 11.5C2 11.22 2.22 11 2.5 11C2.78 11 3 11.22 3 11.5L3 12ZM5.91 15L5 14.09L5 11L10 11L10 15ZM13.22 13.5L15 14.59L15 12.41ZM15.15 15.85C15.24 15.94 15.36 16 15.5 16C15.78 16 16 15.78 16 15.5L16 11.5C16 11.22 15.78 11 15.5 11C15.36 11 15.24 11.06 15.15 11.15L12.04 13.04C11.87 13.12 11.75 13.3 11.75 13.5C11.75 13.7 11.87 13.88 12.04 13.96ZM6.38 4.22C6.02 4.3 5.65 4.17 5.41 3.89C4.95 3.34 4.27 3 3.5 3C2.12 3 1 4.12 1 5.5C1 6.88 2.12 8 3.5 8L10.5 8C12.43 8 14 6.43 14 4.5C14 2.57 12.43 1 10.5 1C8.91 1 7.56 2.06 7.14 3.52C7.04 3.88 6.75 4.15 6.38 4.22ZM6.61 2.24C6.42 2.56 6.28 2.89 6.18 3.25C5.94 2.97 5.67 2.73 5.36 2.54C4.82 2.2 4.18 2 3.5 2C1.57 2 0 3.57 0 5.5C0 7.43 1.57 9 3.5 9L10.5 9C12.99 9 15 6.99 15 4.5C15 2.01 12.99 0 10.5 0C8.84 0 7.38 0.9 6.61 2.24ZM10.5 5C10.78 5 11 4.78 11 4.5C11 4.22 10.78 4 10.5 4C10.22 4 10 4.22 10 4.5C10 4.78 10.22 5 10.5 5ZM10.5 6C11.33 6 12 5.33 12 4.5C12 3.67 11.33 3 10.5 3C9.67 3 9 3.67 9 4.5C9 5.33 9.67 6 10.5 6ZM4.5 5.5C4.5 6.05 4.05 6.5 3.5 6.5C2.95 6.5 2.5 6.05 2.5 5.5C2.5 4.95 2.95 4.5 3.5 4.5C4.05 4.5 4.5 4.95 4.5 5.5Z"
+  },
+  "viewport-camera-view": {
+    "icon": "ICON_VIEW_CAMERA",
+    "source": "release/datafiles/icons_svg/view_camera.svg",
+    "sha256": "17fd5360f46a00bcf2c3d72f115f017ee693775dd3af44fab89e1a939a879e07",
+    "box": [0, 0, 16, 16.13],
+    "path": "M10.5 0C8.36 0 6.69 1.47 6.17 3.24C5.52 2.5 4.66 2 3.5 2C1.57 2 0 3.57 0 5.5C0 7.43 1.57 9 3.5 9L10.5 9C12.98 9 15 6.98 15 4.5C15 2.02 12.98 0 10.5 0ZM10.5 3C11.32 3 12 3.68 12 4.5C12 5.32 11.32 6 10.5 6C9.68 6 9 5.32 9 4.5C9 3.68 9.68 3 10.5 3ZM3.5 4C4.32 4 5 4.68 5 5.5C5 6.32 4.32 7 3.5 7C2.68 7 2 6.32 2 5.5C2 4.68 2.68 4 3.5 4ZM10.5 4C10.22 4 10 4.22 10 4.5C10 4.78 10.22 5 10.5 5C10.78 5 11 4.78 11 4.5C11 4.22 10.78 4 10.5 4ZM3.5 5C3.22 5 3 5.22 3 5.5C3 5.78 3.22 6 3.5 6C3.78 6 4 5.78 4 5.5C4 5.22 3.78 5 3.5 5ZM4.5 10C4.22 10 4 10.22 4 10.5L4 11.5L4 12L3 12L3 11.5C3 11.22 2.77 10.99 2.49 10.99C2.22 10.99 2 11.22 2 11.5L2 12.5L2 13.5C2.01 14.16 2.99 14.16 3 13.5L3 13L4 13L4 13.5L4 14.5C4 14.63 4.05 14.76 4.15 14.85L5.15 15.85C5.24 15.95 5.37 16 5.5 16L10.5 16C10.78 16 11 15.78 11 15.5L11 10.5C11 10.22 10.78 10 10.5 10ZM15.48 11C15.4 11 15.31 11.03 15.24 11.07L11.99 13.07C11.67 13.27 11.67 13.73 11.99 13.93L15.24 15.93C15.57 16.13 16 15.89 16 15.5L16 11.5C16 11.22 15.77 10.99 15.48 11Z"
+  },
+  "viewport-camera-locked": {
+    "icon": "ICON_VIEW_LOCKED",
+    "source": "release/datafiles/icons_svg/view_locked.svg",
+    "sha256": "8b84ee3bb6920f48eebc0e43116321977e18a09931879081550c9c4564fe4ec1",
+    "box": [2, 0, 14, 16],
+    "path": "M3 7L3 5C3 2.24 5.24 0 8 0C10.76 0 13 2.24 13 5L13 7L13.5 7C13.78 7 14 7.22 14 7.5L14 15.5C14 15.78 13.78 16 13.5 16L2.5 16C2.22 16 2 15.78 2 15.5L2 7.5C2 7.22 2.22 7 2.5 7ZM4 5C4 2.79 5.79 1 8 1C10.21 1 12 2.79 12 5L12 7L4 7ZM8 10C7.45 10 7 10.45 7 11C7 11.37 7.2 11.69 7.5 11.87L7.5 13C7.5 13.28 7.72 13.5 8 13.5C8.28 13.5 8.5 13.28 8.5 13L8.5 11.87C8.8 11.69 9 11.37 9 11C9 10.45 8.55 10 8 10Z"
+  },
+  "viewport-camera-unlocked": {
+    "icon": "ICON_VIEW_UNLOCKED",
+    "source": "release/datafiles/icons_svg/view_unlocked.svg",
+    "sha256": "1a70d7dfe4a77e6a628426f6400b0e273e2b543bda53d967f7d4c0da3268bd52",
+    "box": [2, 0, 14, 16],
+    "path": "M8 10C7.45 10 7 10.45 7 11C7 11.37 7.2 11.69 7.5 11.87L7.5 13C7.5 13.28 7.72 13.5 8 13.5C8.28 13.5 8.5 13.28 8.5 13L8.5 11.87C8.8 11.69 9 11.37 9 11C9 10.45 8.55 10 8 10ZM8 1C5.79 1 4 2.79 4 5L4 7L13.5 7C13.78 7 14 7.22 14 7.5L14 15.5C14 15.78 13.78 16 13.5 16L2.5 16C2.22 16 2 15.78 2 15.5L2 7.5C2 7.22 2.22 7 2.5 7L3 7L3 5C3 2.24 5.24 0 8 0C10.22 0 12.1 1.44 12.75 3.44C12.83 3.69 12.69 3.94 12.45 4.02C12.17 4.11 11.87 3.94 11.77 3.66C11.22 2.11 9.74 1 8 1ZM3 8L3 15L13 15L13 8Z"
   }
 }

package/contributions/blender.keymap.ts

@@ -35,5 +35,42 @@ export const keymap: KeymapContribution = {
     'edit.deselectAll': [{ key: 'a', alt: true }],
     'viewport.frameSelection': [{ key: '.' }, { key: '', code: 'NumpadDecimal' }],
     'viewport.cyclePivot': [{ key: ',' }],
+    // Blender's G is Grab (`transform.translate` above); a 2D view's modes keep their buttons.
+    'canvas.panMode': [],
+    'canvas.rulerMode': [],
+    'canvas.toggleGrid': [],
+    // `km_view3d` — `view3d.view_persportho` on NUMPAD_5; Blender has no isometric preset key.
+    'view.perspective': [],
+    'view.projection': [{ key: '', code: 'Numpad5' }],
+    // `km_view3d` — `view3d.view_axis` with Ctrl for the opposite side, `view3d.view_orbit` on
+    // NUMPAD_2/4/6/8 (15°, `pad_rot_angle`) and NUMPAD_9 (π), `view3d.view_roll` on Shift+4/6.
+    // Blender's Ctrl is the Control key on every platform, macOS included (`ctrl`, not `mod`).
+    'view.back': [{ key: '', code: 'Numpad1', ctrl: true }],
+    'view.left': [{ key: '', code: 'Numpad3', ctrl: true }],
+    'view.bottom': [{ key: '', code: 'Numpad7', ctrl: true }],
+    'view.orbitLeft': [{ key: '', code: 'Numpad4' }],
+    'view.orbitRight': [{ key: '', code: 'Numpad6' }],
+    'view.orbitUp': [{ key: '', code: 'Numpad8' }],
+    'view.orbitDown': [{ key: '', code: 'Numpad2' }],
+    'view.opposite': [{ key: '', code: 'Numpad9' }],
+    'view.rollLeft': [{ key: '', code: 'Numpad4', shift: true }],
+    'view.rollRight': [{ key: '', code: 'Numpad6', shift: true }],
+    // `view3d.view_all` on HOME; `view3d.zoom` on NUMPAD_PLUS/NUMPAD_MINUS and Ctrl+=/Ctrl+-.
+    'view.all': [{ key: '', code: 'Home' }],
+    'view.zoomIn': [{ key: '', code: 'NumpadAdd' }, { key: '', code: 'Equal', ctrl: true }],
+    'view.zoomOut': [{ key: '', code: 'NumpadSubtract' }, { key: '', code: 'Minus', ctrl: true }],
+  },
+  // `km_view3d` — `view3d.rotate` on MIDDLEMOUSE and `view3d.move` on Shift+MIDDLEMOUSE; the
+  // right button is the context menu's, and Shift+Right places the 3D cursor. The factory
+  // rotation is Turntable at 0.4° a pixel (`view_rotate_method`,
+  // `view_rotate_sensitivity_turntable`, read back from Blender 5.2; a pixel over `UI_SCALE_FAC`,
+  // so one CSS pixel on any display), with Auto Perspective on (`use_auto_perspective`).
+  // Zoom: a key steps the distance by 1.2 (`view_zoom_apply_step`), and Ctrl+middle drags in the
+  // factory Dolly style (`U.viewzoom`, `viewzoom_scale_value`).
+  navigation: {
+    orbit: 'middle',
+    turntable: { degreesPerPixel: 0.4 },
+    autoPerspective: true,
+    zoom: { step: 1.2, drag: 'dolly' },
   },
 };

package/contributions/blender.palette.json

@@ -56,10 +56,7 @@
       "gizmo": {
         "x": "#ff3352",
         "y": "#8bdc00",
-        "z": "#2890ff",
-        "navigationX": "#f53651",
-        "navigationY": "#6fa41b",
-        "navigationZ": "#2e83e3"
+        "z": "#2890ff"
       },
       "region": {
         "outliner": "#282828",
@@ -73,6 +70,7 @@
         "scene": "#cccccc",
         "collection": "#ffffff",
         "tool": "#cbcbcb",
+        "select": "#ffaf2a",
         "operator": "#95dab2"
       },
       "semantic": {

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.9",
+  "version": "0.1.11",
   "publishConfig": {
     "access": "public"
   },
@@ -42,7 +42,6 @@
       "./contributions/blender.keymap.ts",
       "./contributions/blender.status.tsx",
       "./contributions/blender.style.ts",
-      "./contributions/material-preview.view.ts",
       "./contributions/model.layout.ts",
       "./contributions/models.finder.ts",
       "./contributions/properties-bone-constraints.inspector.tsx",
@@ -70,14 +69,14 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.30.0",
-    "@volter/blender-engine": "0.1.8",
-    "@volter/editor-threejs": "0.5.66",
+    "@volter/blender-engine": "0.1.9",
+    "@volter/editor-threejs": "0.5.68",
     "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "@volter/editor-sdk": "0.5.66",
-    "@volter/editor-live": "0.5.66",
-    "@volter/editor-project": "0.5.66",
+    "@volter/editor-sdk": "0.5.68",
+    "@volter/editor-live": "0.5.68",
+    "@volter/editor-project": "0.5.68",
     "react": "^19.0.0",
     "three": "^0.180.0",
     "vite": "^6.4.3"

package/src/presentation.ts

@@ -3,9 +3,31 @@
  * viewport-presentation`): this package builds the `model` stage, so it states the stage's
  * function there, beneath every person's choice and never in the look (ARCHITECTURE.md rule 7).
  */
-import { registerStartingPresentation } from '@volter/editor-sdk/kit/viewport-presentation';
+import {
+  DOCUMENT_STUDIO_PRESET,
+  registerStartingPresentation,
+  type ViewportCamera,
+} from '@volter/editor-sdk/kit/viewport-presentation';
+
+/**
+ * A 3D View's field of view for its lens, as Blender computes it (`BKE_camera_params_from_view3d`,
+ * `BKE_camera_params_compute_viewplane`): the 36 mm sensor over the lens, times the viewport's
+ * `CAMERA_PARAM_ZOOM_INIT_PERSP` of 2, held on the region's LARGER side (sensor fit AUTO) — so a
+ * wider panel sees no more world sideways and a shorter one sees less vertically. The same zoom
+ * scales an orthographic view's `dist * sensor / lens`, so the two projections agree at the pivot.
+ */
+export function blenderViewFieldOfView(lens: number): ViewportCamera['fov'] {
+  const safeLens = Number.isFinite(lens) && lens > 0 ? lens : 50;
+  return { degrees: (2 * Math.atan((36 * 2) / (2 * safeLens)) * 180) / Math.PI, axis: 'larger' };
+}
 
 const release = registerStartingPresentation('model', {
+  // BLENDER'S VIEW: the factory `View3D.lens` of 50 mm (read back from Blender 5.2), a 71.5°
+  // angle on the larger side; and its default user perspective, elevation 26.5° and azimuth
+  // −23.8° about the up axis, SOLVED from the reference's two floor axes (projected slopes
+  // +1.0093 for X and −0.1969 for Y in `modeling-edit-none.png`), in three's Y-up frame. A file's
+  // own saved view and lens are its document's (`blender-runtime.document.tsx`).
+  camera: { fov: blenderViewFieldOfView(50), opening: [0.8187, 0.4458, 0.3617] },
   interaction: {
     // BLENDER'S SHELF OPENS ON SELECT BOX, so a selected object carries no transform gizmo until
     // one of the four transform tools is armed (`space_toolsystem_toolbar.py`:
@@ -18,6 +40,63 @@ const release = registerStartingPresentation('model', {
     // under the rectangle, so any drawn part of an object inside it selects that object.
     boxSelect: 'touch',
   },
+  // BLENDER'S SHADING TYPES EACH KEEP THEIR OWN LIGHTING, and switching the header's shading cell
+  // switches to that type's (`View3DShading` keeps `studio_light` for Solid, `studio_light` /
+  // `studiolight_*` for Material Preview, and Rendered lights by the scene). So they are stated per
+  // draw mode, and a person's Lighting choice is the current mode's (`stageLightsPerMode`).
+  // SOLID (`clay`, and Wireframe with it) is lit by Blender's four studio lights, the document's
+  // view-locked studio, and drawn under STANDARD: Blender gives Solid the display's default view
+  // and none of the scene's settings (`draw_color_management.cc`, `ViewTransform`), and the sRGB
+  // display's default is Standard (`config.ocio`). Blender 5.2's Workbench under Standard gives
+  // the factory cube 142 / 131 / 112 in the default view and 162 on the front face, agreeing with
+  // the viewport's own frames (141 / 129 / 111, 161). The scene's AgX is the two modes' below.
+  all: {
+    lighting: {
+      source: 'studio',
+      studioPreset: DOCUMENT_STUDIO_PRESET.id,
+      auto: null,
+      tone: { mapper: 'none', exposure: 1 },
+    },
+    // X-Ray per shading type, read back from Blender 5.2's factory View3DShading: Solid's off at
+    // 0.5 (`show_xray`, `xray_alpha`), Wireframe's on at 0 (`show_xray_wireframe`,
+    // `xray_alpha_wireframe`) — a wireframe with no surface.
+    xray: { enabled: false, alpha: 0.5 },
+  },
+  modes: {
+    wireframe: { xray: { enabled: true, alpha: 0 } },
+    // MATERIAL PREVIEW: the scene lit by a world studio light alone, Forest at strength 1 and
+    // rotation 0, fixed in the world, drawn over the viewport's own colour, in AgX. Read from
+    // Blender 5.2's factory View3DShading: `studio_light` Default (forest.exr),
+    // `studiolight_intensity` 1, `studiolight_rotate_z` 0, `studiolight_background_alpha` 0,
+    // `use_studiolight_view_rotation` (World Space Lighting) on, `use_scene_lights` off
+    // (`docs/reference-probes/blender-view3d-shading.py`). The images are `blender.environment.ts`'s.
+    // Blender's viewport never changes its shading on its own: a lamp does not take it over.
+    preview: {
+      lighting: {
+        source: 'preview',
+        auto: null,
+        preview: {
+          sceneLights: false,
+          sun: { enabled: false },
+          environment: { enabled: true, image: 'blender:forest', energy: 1, rotation: 0 },
+        },
+        tone: { mapper: 'agx', exposure: 1 },
+      },
+      backdrop: { source: 'fill' },
+    },
+    // RENDERED: the scene's own lights and World, drawn behind the model, in AgX — the lighting the
+    // document's render photographs with (`BlenderRuntimeView.holdRendered`). Not a path tracer:
+    // the viewport and a render agree because they are one drawing.
+    rendered: {
+      lighting: { source: 'scene', auto: null, tone: { mapper: 'agx', exposure: 1 } },
+      backdrop: { source: 'scene' },
+    },
+  },
+  overlays: {
+    // BLENDER DRAWS THE SELECTED OBJECTS' ORIGINS (Overlays › Origins, on by default): the dot at
+    // the default cube's centre in every reference frame (`gizmo-select-box.png`).
+    selection: { origins: true },
+  },
   world: {
     // BLENDER'S WORLD IS Z-UP, and the stage presents it through the signed permutation
     // `(x, y, z) → (x, z, −y)` the presented root carries (`blender-runtime-view.ts`'s

package/contributions/material-preview.view.ts

@@ -1,35 +0,0 @@
-/**
- * BLENDER'S MATERIAL PREVIEW: the scene lit by a world studio light alone, Forest at strength 1
- * and rotation 0, fixed in the world, drawn over the viewport's own colour, in AgX. Read from
- * Blender 5.2's factory View3DShading: `studio_light` Default (forest.exr),
- * `studiolight_intensity` 1, `studiolight_rotate_z` 0, `studiolight_background_alpha` 0,
- * `use_studiolight_view_rotation` (World Space Lighting) on, `use_scene_lights` off.
- * Measured against Blender 5.2's own EEVEE render of the default cube under the same world
- * with its lamp removed.
- * A named view (`@volter/editor-sdk/kit/viewport-presentation` `ViewPreset`); the images are
- * `blender.environment.ts`'s.
- */
-import type { ViewPreset } from '@volter/editor-sdk/kit/viewport-presentation';
-
-export const point = 'workspace.view';
-export const view: ViewPreset = {
-  id: 'blender-material-preview',
-  title: 'Material Preview',
-  layer: {
-    all: {
-      lighting: {
-        source: 'preview',
-        // Blender's viewport never changes its shading on its own: a lamp in the scene does not
-        // take Material Preview over.
-        auto: null,
-        preview: {
-          sceneLights: false,
-          sun: { enabled: false },
-          environment: { enabled: true, image: 'blender:forest', energy: 1, rotation: 0 },
-        },
-        tone: { mapper: 'agx', exposure: 1 },
-      },
-      backdrop: { source: 'fill' },
-    },
-  },
-};