@volter/blender-engine 0.1.19 → 0.1.21

package/browser/blender-emscripten-engine.mts

@@ -37,6 +37,7 @@ import {
   PAGE_OWNED_DIRECTORIES,
   SESSION_ROOT,
   SESSION_SCRIPT,
+  sessionLevel,
   sleep,
 } from './blender-engine.mts';
 import sessionPython from './session.py?raw';
@@ -195,10 +196,7 @@ export async function startEmscriptenBlenderEngine(
   // session's OWN named conditions go there.
   const say = (_level: 'log' | 'error', text: string) => {
     if (text.startsWith('@@VOLTER-READY ')) readyLine = text.slice('@@VOLTER-READY '.length);
-    options.log(
-      text.startsWith('@@VOLTER-WARN') || text.startsWith('@@VOLTER-ERROR') ? 'error' : 'log',
-      text,
-    );
+    options.log(sessionLevel(text), text);
   };
   const module = await factory({
     arguments: ['--background', '--factory-startup', '--python', SESSION_SCRIPT],

package/browser/blender-engine.mts

@@ -107,7 +107,7 @@ export interface BlenderFiles {
 export interface BlenderEngineOptions {
   /** The project's absolute path; the engine's filesystem mirrors it there. */
   project: string;
-  log(level: 'log' | 'error', text: string): void;
+  log(level: 'log' | 'warn' | 'error', text: string): void;
   /** What the session asks the TAB for, mid-call: a frame, and sometimes a
    *  photograph of it. Whatever this resolves to is what Python receives.
    *
@@ -161,6 +161,14 @@ export interface BlenderEngine {
 
 export const ARTIFACT_BASE = '/__editor/blender-wasm';
 
+/** The console level of one line the session printed. Only the session's own named conditions
+ *  reach the editor's console, each at the severity it names; Blender's streams stay page output. */
+export function sessionLevel(line: string): 'log' | 'warn' | 'error' {
+  if (line.startsWith('@@VOLTER-ERROR')) return 'error';
+  if (line.startsWith('@@VOLTER-WARN')) return 'warn';
+  return 'log';
+}
+
 /**
  * An artifact URL, resolved against THE MODULE — never against `self.location`.
  *

package/browser/blender-wali-engine.mts

@@ -52,6 +52,7 @@ import {
   PAGE_OWNED_DIRECTORIES,
   SESSION_ROOT,
   SESSION_SCRIPT,
+  sessionLevel,
   sleep,
 } from './blender-engine.mts';
 import sessionPython from './session.py?raw';
@@ -381,10 +382,7 @@ export async function startWaliBlenderEngine(
       // -- the same rule as the standalone engine, and for the same measured
       // reason: only the session's own named conditions belong in the set an
       // agent must drive to zero.
-      options.log(
-        line.startsWith('@@VOLTER-WARN') || line.startsWith('@@VOLTER-ERROR') ? 'error' : 'log',
-        line,
-      );
+      options.log(sessionLevel(line), line);
     }
   };
   // THE PROGRAM DOES NOT RETURN. `session.py` loops forever, so `run` settles

package/browser/protocol.ts

@@ -109,7 +109,7 @@ export type WorkerReply =
    *  as the record of what the session submitted — the second side a
    *  displayed-versus-submitted comparison otherwise does not have. */
   | { op: 'present'; id: number; frame: unknown; description: unknown; capture?: CaptureRequest }
-  | { op: 'log'; level: 'log' | 'error'; text: string }
+  | { op: 'log'; level: 'log' | 'warn' | 'error'; text: string }
   /**
    * HOW BIG THE MODULE'S LINEAR MEMORY IS, posted after every call.
    *

package/browser/runtime.ts

@@ -44,7 +44,7 @@ export interface BlenderRuntimeOptions {
     description: unknown,
     capture?: CaptureRequest,
   ): Promise<PresentAnswer> | PresentAnswer;
-  log?(level: 'log' | 'error', text: string): void;
+  log?(level: 'log' | 'warn' | 'error', text: string): void;
 }
 
 /**

package/browser/three/blender-runtime-view.ts

@@ -744,6 +744,8 @@ export class BlenderRuntimeView {
    *  showing". Fired after the frame is applied, so a listener that reads
    *  the graph sees the new one. */
   private readonly frameListeners = new Set<() => void>();
+  /** The views drawing this one's frames in a second area ({@link follow}). */
+  private readonly followers = new Set<BlenderRuntimeView>();
 
   /** Subscribe to frames. Returns the unsubscribe. */
   subscribeFrames(listener: () => void): () => void {
@@ -1867,6 +1869,15 @@ export class BlenderRuntimeView {
     // The model moved: whoever is READING the engine (the Properties sections
     // through the RNA door) re-reads now, with the new graph already standing.
     for (const listener of [...this.frameListeners]) listener();
+    // EVERY FOLLOWER TAKES THE SAME FRAME, and one that cannot (it lacks geometry the frame only
+    // references) is rebuilt from everything this view now holds.
+    for (const follower of this.followers) {
+      try {
+        follower.applyFrame(input);
+      } catch {
+        follower.applyFrame(this.fullFrame());
+      }
+    }
     return { ...this.inspect(), held };
   }
 
@@ -1898,7 +1909,10 @@ export class BlenderRuntimeView {
    * disposable geometry cross this boundary; delta-only frames are sufficient.
    * The caller owns this snapshot and must dispose it on every outcome.
    */
-  captureSnapshot() {
+  /** Everything this view holds, as ONE self-contained frame another view can be built from:
+   *  every mesh's resident geometry and every resident image, with no reference to what a
+   *  receiver already holds. */
+  private fullFrame(): Frame {
     const source = this.frame;
     if (!source) throw new Error('Blender capture requires a presented frame');
     // Inspection overlays are not render content. In particular weight-paint
@@ -1976,6 +1990,37 @@ export class BlenderRuntimeView {
         };
       }
     }
+    return frame;
+  }
+
+  /**
+   * A SECOND VIEW OF THE SAME MODEL, for a second area drawing it (Blender's split 3D viewport):
+   * its own graph, because a three.js object has one parent and each area's stage holds its own
+   * root, built from everything this view holds and then handed every frame this one applies, so
+   * the two show one revision. Each view keeps its own shading (Solid in one, Rendered in the
+   * other), its own camera view and its own overlays. Inspection overlays (bones, weights) and a
+   * Timeline pose stay this view's: they are not in a frame another view can be built from.
+   */
+  follow(): { readonly view: BlenderRuntimeView; dispose(): void } {
+    const follower = new BlenderRuntimeView();
+    if (this.frame) follower.applyFrame(this.fullFrame());
+    this.followers.add(follower);
+    let disposed = false;
+    return {
+      view: follower,
+      dispose: () => {
+        if (disposed) return;
+        disposed = true;
+        this.followers.delete(follower);
+        follower.dispose();
+        follower.root.removeFromParent();
+      },
+    };
+  }
+
+  captureSnapshot() {
+    const frame = this.fullFrame();
+    const source = this.frame!;
     const effect = this.createWorldVolumePass();
     const detached = new BlenderRuntimeView();
     detached.photograph = true;

package/browser/worker.ts

@@ -41,7 +41,7 @@ import type { CaptureRequest, FileEntry, WorkerReply, WorkerRequest } from './pr
 import { columnsToTypedArrays, describeFrame } from './session-frame.mts';
 
 const post = (reply: WorkerReply) => (self as unknown as Worker).postMessage(reply);
-const log = (level: 'log' | 'error', text: string) => post({ op: 'log', level, text });
+const log = (level: 'log' | 'warn' | 'error', text: string) => post({ op: 'log', level, text });
 
 interface Session {
   start(project: string): Promise<unknown>;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@volter/blender-engine",
   "author": "Volter AI, Inc.",
   "license": "GPL-3.0-or-later",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "publishConfig": {
     "access": "public"
   },