@volter/editor-blender 0.1.150 → 0.1.152

package/contributions/uv-editing.layout.ts

@@ -1,49 +1,4 @@
-/**
- * The UV EDITING workspace — Blender's own: the UV editor BESIDE the 3D
- * viewport, with the Outliner over the Properties editor on the right.
- *
- * THE PROPORTIONS ARE BLENDER'S, MEASURED THROUGH bpy on the engine in the tab
- * (2026-09-19), not eyeballed from a screenshot:
- * `bpy.data.workspaces['UV Editing'].screens[0].areas` answers, in a 1920-wide
- * window, PROPERTIES `x1579 y23 w339 h839`, OUTLINER `x1579 y865 w339 h189`,
- * IMAGE_EDITOR `x2 y23 w786 h1031` with `SpaceImage.mode == 'UV'`, and VIEW_3D
- * `x791 y23 w785 h1031`.
- *
- * Three readings out of that:
- *  - the right column is the SAME column Modeling and Shading have — 339/1920
- *    = 0.177 of the window, the Outliner taking 189/1028 = 0.184 of it — which
- *    is why this arrangement is Model's with one change;
- *  - the centre is split SIDE BY SIDE, not top-and-bottom: 786 and 785 of the
- *    1571 px left of the right column, an exact 50/50 to within the 1-px
- *    splitter. This is the FIRST I5 workspace whose editor is not Blender's
- *    bottom area — Shading's node editor is (`workspace-regions.ts` says so
- *    where it explains why Model hides the bottom strip), and the UV editor is
- *    a left half of the centre;
- *  - the UV editor opens in UV mode, which is what makes its title "UV Editor"
- *    rather than "Image Editor".
- *
- * WHICH REGION THE UV EDITOR IS — and the deviation this file used to record
- * is GONE, because the ruling removed its cause. It said: this host has ONE
- * utility region, the bottom area, so a utility could not claim a leaf beside
- * the centre and the UV editor took the bottom at the height Blender gives
- * its width. **RULED 2026-09-19 (orchestrator): a Blender editor AREA is an
- * editor group; the drawer holds utilities.** The UV editor is not a utility
- * at all now — it is a `workspace.document` this workspace opens into
- * `volter:area:uv`, LEFT of the model document at Blender's own 786/1571, and
- * under the frame the layout host puts the same document in a second VS Code
- * editor group. Nothing is deviating and nothing is owed to U10 here.
- *
- * WHAT IS NOT REPRODUCED, also named: Blender's UV editor shows the IMAGE
- * behind the tile. Measured on both probe files — `arena-weapons.blend` has
- * four materials, all `use_nodes`, and NOT ONE image texture node; the whole
- * file has zero images, as does `arena-vanguard.blend` — so there is nothing
- * for a backdrop to show and the view says so in its own warning rather than
- * implying an empty tile is a drawn one.
- *
- * THE STRIP GROWS ONLY AS A VIEW LANDS (§Editor chrome; WORK.md I5). UV
- * Editing appears in the workspace strip because this contribution exists, and
- * this contribution exists because the UV view does.
- */
+/** UV Editing places the UV Editor left of the 3D view, with Outliner over Properties at right. The UV view opens in UV mode and names a missing image backdrop in its warning. */
 
 import type { WorkspaceLayoutContribution } from '@volter/sdk/looks';
 import { BLENDER_REGIONS } from '../src/regions';
@@ -68,29 +23,7 @@ export const layout: WorkspaceLayoutContribution = {
     // is a utility strip. The UV editor is an AREA — an editor GROUP — below.
     drawer: 'hidden',
   },
-  // THE UV EDITOR IS AN EDITOR GROUP TO THE LEFT OF THE MODEL DOCUMENT.
-  //
-  // RULED 2026-09-19 (orchestrator): "A Blender editor AREA is an editor
-  // group; the drawer holds utilities." Blender's UV Editing screen splits the
-  // centre SIDE BY SIDE, with the image editor on the LEFT: IMAGE_EDITOR
-  // `x2 y23 w786 h1031` (mode `UV`) and VIEW_3D `x791 y23 w785 h1031`,
-  // measured through bpy on the engine in a 1920-wide window.
-  //
-  // THE RATIO IS 786 of the 1571 px left of the 339-px right column — 0.5003,
-  // an exact half to within the 1-px splitter. It is stated to four places
-  // because it is a measurement, not a preference; the dock uses it once, to
-  // size the group the first time this workspace stands up, and a capture of
-  // the settled grid wins afterwards.
+  // Open the UV Editor in the left editor group at 786/1571 ≈ 0.5003 of the centre width.
   areas: [{ id: 'uv', document: 'blender-uv-editor.document', place: 'left', ratio: 0.5003 }],
-  // THE ARRANGEMENT IS A LIVE CAPTURE, re-taken 2026-09-19 after the areas
-  // ruling. The one it replaced was Shading's capture with the node view's
-  // utility id substituted by hand — and that substitution MISSED TWO of the
-  // seven occurrences: the panel record's `params.utilityId` and its `title`
-  // both still said `blender-node-editor.utility` / "Shader Editor", so the
-  // leaf keyed by the UV panel's id rendered the NODE editor. That is the
-  // whole of the "switching to UV Editing opens the Shader Editor" defect the
-  // previous landing recorded as a dock ordering race; it was a bad derived
-  // blob, which is exactly what `workspace-preset-layouts.ts` forbids
-  // ("shipped defaults are authored by arranging live and snapshotting
-  // `toJSON` — never hand-written JSON"). This one is captured.
+  // The arrangement is a captured dock layout for these UV editor documents.
 };

package/dist-node/serving.mjs

@@ -24,7 +24,7 @@ function projectOutputRootOf(path) {
   );
 }
 
-// ../sdk/src/session/relative-path-guard.ts
+// ../sdk/src/relative-path-guard.ts
 function relativePathRejection(path) {
   if (!path || path.trim() === "") return "empty";
   if (path.includes("\0")) return "nul";
@@ -65,8 +65,8 @@ var SHIPPED_BLENDER_WASM_DIR = (() => {
   const candidate = fileURLToPath(new URL("../../blender-engine/wasm/", import.meta.url));
   return existsSync(candidate) ? candidate.replace(/\/$/, "") : null;
 })();
-function blenderWasmDir(env = process.env) {
-  const named = env[BLENDER_WASM_DIR_VARIABLE];
+function blenderWasmDir() {
+  const named = process.env[BLENDER_WASM_DIR_VARIABLE];
   if (typeof named === "string" && named.trim() !== "") {
     const dir = named.trim();
     return isAbsolute(dir) ? dir : null;
@@ -92,8 +92,8 @@ async function skewOf(dir) {
   if (existsSync(join(dir, BLENDER_WALI_ARTIFACT))) return "wali";
   return null;
 }
-async function blenderWasmStatus(env = process.env) {
-  const dir = blenderWasmDir(env);
+async function blenderWasmStatus() {
+  const dir = blenderWasmDir();
   if (dir === null)
     return {
       available: false,
@@ -117,13 +117,13 @@ async function blenderWasmStatus(env = process.env) {
         `${dir} holds neither ${BLENDER_WASM_FILES.join(", ")} (the standalone skew) nor ${BLENDER_WALI_ARTIFACT} (the substrate skew)`
       ]
     };
-  return skew === "wali" ? waliStatus(dir) : emscriptenStatus(dir, env);
+  return skew === "wali" ? waliStatus(dir) : emscriptenStatus(dir);
 }
 var BROWSER_SUBSTRATE_VARIABLE = "BROWSER_SUBSTRATE_URL";
-function servedFromTab(env = process.env) {
-  return (env[BROWSER_SUBSTRATE_VARIABLE] ?? "").trim() !== "";
+function servedFromTab() {
+  return (process.env[BROWSER_SUBSTRATE_VARIABLE] ?? "").trim() !== "";
 }
-async function emscriptenStatus(dir, env) {
+async function emscriptenStatus(dir) {
   const sizes = {};
   const encoded = {};
   const missing = [];
@@ -136,7 +136,7 @@ async function emscriptenStatus(dir, env) {
     sizes[file] = found.size;
     if (found.encoding) encoded[file] = found.encoding;
   }
-  return { available: missing.length === 0, skew: "emscripten", dir, sizes, encoded, missing, digests: await emscriptenDigests(dir), inTab: servedFromTab(env) };
+  return { available: missing.length === 0, skew: "emscripten", dir, sizes, encoded, missing, digests: await emscriptenDigests(dir), inTab: servedFromTab() };
 }
 async function emscriptenDigests(dir) {
   const digests = {};
@@ -217,7 +217,6 @@ async function runtimeIndex(dir) {
   if (cachedRuntimeIndex?.dir === dir) return cachedRuntimeIndex.index;
   const root = join(dir, BLENDER_WALI_RUNTIME);
   const files = [];
-  let newest = 0;
   const walk = async (where) => {
     for (const entry of (await readdir(where, { withFileTypes: true })).sort(
       (left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0
@@ -235,12 +234,11 @@ async function runtimeIndex(dir) {
         mode: info.mode & 4095,
         sha256: createHash("sha256").update(await readFile(path)).digest("hex")
       });
-      newest = Math.max(newest, info.mtimeMs);
     }
   };
   await walk(root);
   if (files.length === 0) throw new Error(`${root} is empty`);
-  const index = { files, newestMtimeMs: newest };
+  const index = { files };
   cachedRuntimeIndex = { dir, index };
   return index;
 }
@@ -354,13 +352,10 @@ function blenderRoutesPlugin(services) {
       method: "GET",
       match: /^\/__editor\/blender-wasm\/status$/,
       handle: async (_req, res) => {
-        services.allowCrossOriginFrameEmbedding(res);
         json(res, await blenderWasmStatus());
       }
     },
-    // The substrate skew's own doors beside the standalone bundle's: Blender's runtime tree as
-    // one index and one blob (a request per file would be ~2,300 round trips), and the
-    // substrate's browser ESM with its bare specifiers rewritten.
+    // Serve the substrate runtime tree as one index and blob, plus browser ESM with rewritten bare specifiers.
     {
       method: "GET",
       match: /^\/__editor\/blender-wasm\/runtime\.idx$/,
@@ -430,7 +425,6 @@ function blenderRoutesPlugin(services) {
       match: /^\/__editor\/blender-wasm\/([^/]+)$/,
       handle: async (req, res, url) => {
         const file = decodeURIComponent(url.pathname.slice("/__editor/blender-wasm/".length));
-        services.allowCrossOriginFrameEmbedding(res);
         const bundled = BLENDER_WASM_FILES.includes(file);
         if (!bundled && file !== BLENDER_WALI_ARTIFACT) {
           json(res, { error: `The Blender build has no ${file}.` }, 404);
@@ -657,20 +651,7 @@ function blenderRoutesPlugin(services) {
         }
       }
     },
-    // ---- The session's DOCUMENT, written back OUT into the project. A Blender session holds one
-    // `.blend`; its `save_as_mainfile` writes it into the engine's filesystem, and this is how
-    // those bytes reach the disk the project lives on. Unlike the spool, the destination shape is
-    // pinned BY THIS SERVER, and the write is the project's one attributed, conflict-checked
-    // transaction: a `.blend` is the project's file like any other.
-    //
-    // IT ARRIVES AS A DELTA. The page cuts each save into content-defined chunks
-    // (`blender-engine/browser/document-chunks.mts`) and posts their manifest; this answers with
-    // the chunks it does not already hold, the page posts those, and the manifest again commits.
-    // MEASURED 2026-09-29, native Blender 5.2 on the Stoneguard bridge: a 497 MB save, one object
-    // moved, changed 1 of 475 one-MiB chunks, so an edit carries about a megabyte instead of the
-    // whole file. Chunks this server reuses come from the document as it lies on disk, and each
-    // is hashed again against the manifest before the commit: a file changed underneath (another
-    // writer, a restore) is not drift but a missing chunk, re-sent.
+    // Save the session .blend through the attributed, conflict-checked project transaction. A chunk manifest requests only missing bytes. Rehash reused disk chunks at commit so an external file change requests replacement chunks.
     {
       method: "POST",
       match: /^\/__editor\/blender-document-chunk$/,