@volter/editor-blender 0.1.8 → 0.1.10

package/contributions/blender.style.ts

@@ -175,97 +175,38 @@ export const style: StyleContribution = {
         // applied TWICE; see `theme.ts`'s `areaEmbossValue`.
         areaEmboss: 8.2,
       },
-      viewport: {
-        // BLENDER'S GIZMO IS A CONSTANT SCREEN SIZE (owner, 2026-09-21: "is
-        // gizmo perhaps the wrong size?"). `U.gizmo_size` is 75
-        // (`DNA_userdef_types.h:1095`; Preferences > Viewport > Gizmos > Size,
-        // `rna_userdef.cc:5415-5419`, range 10..200), and it is px PER GIZMO
-        // UNIT: `wm_gizmo.cc:450-474` sets `scale_final = scale_basis *
-        // UI_SCALE_FAC * U.gizmo_size * ED_view3d_pixel_size_no_ui_scale(...)`,
-        // whose last term is world units per DEVICE px against a
-        // `UI_SCALE_FAC` of device px per UI px — so one gizmo unit is 75 CSS
-        // px whatever the display scale (read back from the engine's own pin
-        // on this box: `ui_scale=2.0 pixel_size=2.0 gizmo_size=75`).
-        gizmoSize: 75,
-        // 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`: `_defs_view3d_generic.select_box` is
-        // the first entry of the Object Mode `_tools_default` tuple).
-        // Photographed at the engine's pin rather than remembered:
-        // `gizmo-select-box.png` has Select Box lit in the shelf, the default
-        // cube selected and outlined orange, and nothing at its origin but the
-        // 3D cursor and the object dot; `gizmo-move.png` has Move lit in the
-        // same frame. Ours opened on the COMBINED gizmo — Unity's shape, three
-        // tools' handles at once, on something merely selected.
-        shelfTool: 'select',
-        // BLENDER'S WORLD IS Z-UP, and the stage presents it through the exact
-        // signed permutation `(x, y, z) → (x, z, −y)` the presented root
-        // carries (`blender-runtime-view.ts`'s constructor). So three's Y is
-        // Blender's Z and three's Z is Blender's −Y, and the transform gizmo's
-        // colours, the side each arm is drawn on, the plane squares and the
-        // navigation gizmo's six labels all say so: the arm that points up is
-        // Z and it is blue, Y is green and points away.
-        upAxis: 'z',
-        // BLENDER'S SELECT BOX IS A TOUCH TEST — its object-mode box select
-        // reads the object-id buffer under the rectangle, so any drawn part of
-        // an object inside it selects that object. The editor's own answer is
-        // containment, for its own measured reason; see the field.
-        boxSelect: 'touch',
-      },
+    },
+    stage: {
+      // BLENDER'S GIZMO IS A CONSTANT SCREEN SIZE (owner, 2026-09-21: "is
+      // gizmo perhaps the wrong size?"). `U.gizmo_size` is 75
+      // (`DNA_userdef_types.h:1095`; Preferences > Viewport > Gizmos > Size,
+      // `rna_userdef.cc:5415-5419`, range 10..200), and it is px PER GIZMO
+      // UNIT: `wm_gizmo.cc:450-474` sets `scale_final = scale_basis *
+      // UI_SCALE_FAC * U.gizmo_size * ED_view3d_pixel_size_no_ui_scale(...)`,
+      // whose last term is world units per DEVICE px against a
+      // `UI_SCALE_FAC` of device px per UI px — so one gizmo unit is 75 CSS
+      // px whatever the display scale (read back from the engine's own pin
+      // on this box: `ui_scale=2.0 pixel_size=2.0 gizmo_size=75`).
+      gizmoSize: 75,
+      // A resting handle at 0.6 opacity, a highlighted one opaque in its own colour
+      // (`transform_gizmo_3d.cc`, `gizmo_get_axis_color`).
+      gizmoOpacity: 0.6,
+      // BLENDER'S OUTLINE IS A HARD LINE, and hidden parts are not drawn: four device pixels
+      // of orange around the cube in `modeling-object-selected.png` (at 2x), no halo.
+      outlineStyle: 'crisp',
+      outlineWidth: 4,
+      outlineHidden: false,
+      // BLENDER'S FLOOR LINES, in device pixels, measured across one scanline of
+      // `modeling-object-none.png` at device resolution: the 1 m line is 4 px at half rise and
+      // plateaus at 83, the 10 m line is 6 px and plateaus at 101 — so the major line is wider
+      // (2.25 against 1.5) and carried (102 − 63) / (84 − 63) past the minor's colour from the
+      // background they share. Stated here, the look's, since the editor's own floor is a
+      // single hairline level.
+      gridLineWidth: 1.5,
+      gridMajorWidth: 2.25,
+      gridMajorContrast: 39 / 21,
     },
   },
   icons,
-  regions: {
-    workspaceTabs: 'shown',
-    // Blender has no document tab strip over its areas (the host's own note
-    // in `workspace-presets.ts` says so; the bundle contradicted it).
-    header: 'shown',
-    shelf: 'shown',
-    inspector: 'properties',
-    // Measured on `modeling.png`: Blender's top-right corner carries two quiet
-    // wells (Scene, ViewLayer) and nothing brighter than the 216 its labels
-    // ink at. Ours drew a yellow FPS/ms readout, an orange sparkline and a lit
-    // audio meter there — the brightest, highest-chroma thing in the frame and
-    // the first place the eye lands. The numbers keep their door (the Profiler
-    // utility, which the readout's own tooltip names).
-    telemetry: 'hidden',
-    // Measured on `outliner.png`: Scene Collection, Collection, Camera, Cube
-    // and Light each carry their NAME and nothing after it — no type text
-    // anywhere in the frame. The type is the GLYPH, which is why the glyph is
-    // coloured by category in the first place; a row that also spelled the
-    // type would say it twice. Ours printed `Hero Box ·HeroBox` at
-    // `content.dim` in a 10px face, one `space-2` past the name.
-    hierarchyTypeSuffix: 'hidden',
-    // Measured across all three Outliner frames — `outliner.png` (edit mode),
-    // `modeling-object-none.png` (object mode, nothing selected) and
-    // `modeling-object-selected.png` (object mode, everything selected):
-    // Blender draws NO rule, dotted or solid, under any name in that panel, in
-    // any selection state. Ours drew an orange dotted rule under every
-    // component-instance name — six of this scaffold's eleven rows — which is a
-    // mark with no counterpart in the frame at all. The instance fact keeps its
-    // doors (the label's tooltip, Go to Callsite / Open Component Source, the
-    // inspector's component sections); only the paint yields.
-    hierarchyInstanceRule: 'hidden',
-    // Measured on `outliner.png`: every object row carries an EYE (CSS ink
-    // 257.5-270.5, 32 px in from the area's right edge) and a render CAMERA
-    // (277.5-290.5, 12 px in) on a 20 px column pitch, and no lock glyph
-    // anywhere — Blender's Disable Selection column is off by default. Ours
-    // drew a lock 29-41 px in and the eye 6-18 px in, so the LOCK was sitting
-    // in Blender's eye column and the eye outboard of its camera column. The
-    // lock goes, and the render column is reserved blank so the eye lands on
-    // Blender's own; `workspace-regions.ts` carries why it stays blank.
-    hierarchyRestrictions: 'viewport+render',
-    // Measured at native 2x on `outliner.png` AND on the Properties area of
-    // `modeling-edit-none.png` — device x relative to each area's own left
-    // edge, and the two agree to half a pixel: every Blender area begins with
-    // an EDITOR-TYPE WELL at x 17..80, i.e. 8.5 CSS in and 32 CSS wide, 20
-    // tall, its glyph and a chevron inside a 1 px `#3c3c3c` outline over a
-    // `#272727` inner. It is there whether the area holds one editor or a
-    // dozen, and its dropdown is how an area changes editor. Ours began with
-    // a 203 px strip of WORDS, which is what squeezed the Outliner's search
-    // to 64 px against Blender's 115, truncated the third tab to `Libr`, and
-    // left the Properties area — a lone panel declaring no header controls —
-    // with no header band at all.
-  },
   palette,
 };

package/contributions/model.layout.ts

@@ -7,20 +7,20 @@
  */
 
 import type { WorkspaceLayoutContribution } from '@volter/editor-sdk/looks';
+import { BLENDER_REGIONS } from '../src/regions';
 
 export const point = 'workspace.layout';
 export const layout: WorkspaceLayoutContribution = {
   id: 'model',
   title: 'Model',
   description: 'Blender-shaped modeling: a dominant document, outliner above properties.',
-  // No `tabs` here ON PURPOSE. The host's default is already `shown`, so
-  // stating it changed nothing for a bare host — but the WORKSPACE layer wins
-  // over the style bundle (`workspace-regions.ts`), so restating the default
-  // silently shadowed `blender.style.ts`'s `tabs: 'hidden'` and the Model
-  // document still painted a 25px tab row (measured against Blender 5.2, which
-  // has none). Leave a region unstated unless this workspace genuinely needs
-  // it different from the host default.
+  // No `tabs` here: the workspace layer sits above the person's own choice
+  // (`workspace-regions.ts`), so a stated region shadows it. Leave a region
+  // unstated unless this workspace genuinely needs it different from the host
+  // default.
+  // Blender's areas beneath this workspace's own (`../src/regions.ts`).
   regions: {
+    ...BLENDER_REGIONS,
     header: 'shown',
     shelf: 'shown',
     inspector: 'properties',

package/contributions/models.finder.ts

@@ -16,6 +16,12 @@
  *
  *   documents: { find: [{ finder: 'modelsFromBlendFiles', include: ['src/models/**\/*.blend'] }] }
  *
+ * THE SESSION'S OWN MODEL. A project that holds no `.blend` of its own still
+ * needs ONE model — it is what `blender-start` presents into and what a first
+ * bpy call models in, saved to the session's default `models/model.blend` — so
+ * when the selection finds no file, the finder lists the standing
+ * `blender:runtime` entry instead. Never beside a real model.
+ *
  * This module is a plain object the HOST registers; it mounts no UI. It reads
  * the project only through `input.files` — the PATHS matching those globs.
  * Deliberately not `input.sources`: a `.blend` is binary, there is nothing in
@@ -54,6 +60,16 @@ export const finder = {
         source: { path },
       });
     }
+    if (entries.length === 0) {
+      entries.push({
+        id: 'blender:runtime',
+        label: 'Model',
+        kind: 'model',
+        region: null,
+        authorable: true,
+        reach: { kind: 'root-mount' as const },
+      });
+    }
     return { entries, notes };
   },
 } as const;

package/contributions/sculpt.layout.ts

@@ -6,6 +6,7 @@
  */
 
 import type { WorkspaceLayoutContribution } from '@volter/editor-sdk/looks';
+import { BLENDER_REGIONS } from '../src/regions';
 
 export const point = 'workspace.layout';
 export const layout: WorkspaceLayoutContribution = {
@@ -16,7 +17,9 @@ export const layout: WorkspaceLayoutContribution = {
   requires: { documentKind: 'model' },
   // `tabs` unstated — see `model.layout.ts`: the workspace layer wins over the
   // style bundle, so restating the host default shadows it.
+  // Blender's areas beneath this workspace's own (`../src/regions.ts`).
   regions: {
+    ...BLENDER_REGIONS,
     header: 'shown',
     shelf: 'shown',
     inspector: 'properties',

package/contributions/shading.layout.ts

@@ -53,6 +53,7 @@
  */
 
 import type { WorkspaceLayoutContribution } from '@volter/editor-sdk/looks';
+import { BLENDER_REGIONS } from '../src/regions';
 
 export const point = 'workspace.layout';
 export const layout: WorkspaceLayoutContribution = {
@@ -64,7 +65,9 @@ export const layout: WorkspaceLayoutContribution = {
   // layer wins over the style bundle, so restating the host default would
   // silently shadow `blender.style.ts`'s `tabs: 'hidden'` and paint a tab row
   // Blender does not have.
+  // Blender's areas beneath this workspace's own (`../src/regions.ts`).
   regions: {
+    ...BLENDER_REGIONS,
     header: 'shown',
     shelf: 'shown',
     inspector: 'properties',

package/contributions/studiolights/world/license.txt

@@ -0,0 +1,15 @@
+All HDRIs are licensed as CC0.
+
+These were created by Greg Zaal (Poly Haven https://polyhaven.com).
+Originals used for each HDRI:
+- City: https://polyhaven.com/a/portland_landing_pad
+- Courtyard: https://polyhaven.com/a/courtyard
+- Forest: https://polyhaven.com/a/ninomaru_teien
+- Interior: https://polyhaven.com/a/hotel_room
+- Night: Probably https://polyhaven.com/a/moonless_golf
+- Studio: Probably https://polyhaven.com/a/studio_small_01
+- Sunrise: https://polyhaven.com/a/spruit_sunrise
+- Sunset: https://polyhaven.com/a/venice_sunset
+
+1K resolution of each was taken, and compressed with oiiotool:
+oiiotool input.exr --ch R,G,B -d float --compression dwab:300 --clamp:min=0.0:max=32000.0 -o output.exr

package/contributions/uv-editing.layout.ts

@@ -46,6 +46,7 @@
  */
 
 import type { WorkspaceLayoutContribution } from '@volter/editor-sdk/looks';
+import { BLENDER_REGIONS } from '../src/regions';
 
 export const point = 'workspace.layout';
 export const layout: WorkspaceLayoutContribution = {
@@ -57,7 +58,9 @@ export const layout: WorkspaceLayoutContribution = {
   // layer wins over the style bundle, so restating the host default would
   // silently shadow `blender.style.ts`'s `tabs: 'hidden'` and paint a tab row
   // Blender does not have.
+  // Blender's areas beneath this workspace's own (`../src/regions.ts`).
   regions: {
+    ...BLENDER_REGIONS,
     header: 'shown',
     shelf: 'shown',
     inspector: 'properties',