@volter/editor-blender 0.1.127 → 0.1.129

package/contributions/blender-runtime.document.tsx

@@ -30,6 +30,7 @@ import {
   type BlenderRuntimeView,
   blenderModelView,
 } from '@volter/blender-engine/browser/three/blender-runtime-view';
+import { ownedSurfaceMaterial } from '@volter/blender-engine/browser/three/blender-physical-material';
 import type { ToolContributionProps, ToolDocumentToolbar } from '@volter/editor-sdk/contributions';
 import { editorHost } from '@volter/editor-sdk/host';
 import {
@@ -328,7 +329,7 @@ export default function BlenderModelDocument(props: ToolContributionProps) {
     const requestOpen = () => {
       if (cancelled || queued) return;
       queued = true;
-      queueMicrotask(() => { queued = false; void open(); });
+      setTimeout(() => { queued = false; void open(); }, 0);
     };
     const unsubscribe = documents.subscribe(requestOpen);
     requestOpen();
@@ -432,6 +433,11 @@ function BlenderModelViewport(props: ToolContributionProps) {
     () => false,
   );
   const [played, setPlayed] = useState<ReturnType<AreaView['detach']> | null>(null);
+  const playAspect = useSyncExternalStore(
+    subscribeDocumentPlayExtensions,
+    () => (documentId ? documentPlayExtension('model')?.aspectRatio?.(documentId) ?? null : null),
+    () => null,
+  );
   const [playedReady, setPlayedReady] = useState(false);
   useEffect(() => {
     if (!playing || !documentId) return;
@@ -482,8 +488,14 @@ function BlenderModelViewport(props: ToolContributionProps) {
         <BlenderViewportArea {...props} view={view} main />
       </div>
       {game && (
-        <div key="play" style={{ position: 'absolute', inset: 12 }} data-testid="blender-play-area">
+        <div key="play" style={{ position: 'absolute', inset: 12, containerType: 'size' }} data-testid="blender-play-area">
+          <div data-volter-play-frame style={playAspect === null ? { position: 'absolute', inset: 0 } : {
+            position: 'absolute', left: '50%', top: '50%', transform: 'translate(-50%, -50%)',
+            width: `min(100cqw, calc(100cqh * ${playAspect}))`,
+            height: `min(100cqh, calc(100cqw / ${playAspect}))`,
+          }}>
           <BlenderViewportArea {...props} documentId={`${documentId}#play`} view={game.view} main={false} playing onPlayReady={() => setPlayedReady(true)} onPlayReturn={() => setPlayedReady(false)} />
+          </div>
         </div>
       )}
       {second && (
@@ -694,7 +706,7 @@ function BlenderViewportArea({
       preparing = true;
       orbit = stage.rig().orbit;
       orbit.enabled = false;
-      void view.prepareRendered(stage.rig().drawCamera()).then(() => {
+      void view.prepareRendered(stage.rig().drawCamera(), 'render').then(() => {
         if (stopped) return;
         stopScript = documentPlayExtension('model')?.run({
           documentId: modelId,
@@ -706,6 +718,7 @@ function BlenderViewportArea({
           camera: () => stage.rig().drawCamera(),
           editingCamera: () => viewportStages().find(one => one.documentId === modelId)?.rig().drawCamera() ?? stage.rig().drawCamera(),
           onFrame: (fn) => stage.onFrame(fn),
+          ownMaterial: (material) => ownedSurfaceMaterial(material as THREE.Material),
           report: (title, detail) => {
             editorHost().console.error(`${title}: ${detail}`, 'blender-play');
             notifyRef.current?.({ tone: 'error', title, detail });
@@ -864,7 +877,7 @@ function BlenderViewportArea({
    * 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
+   * scene's lights, its World 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.
@@ -889,7 +902,9 @@ function BlenderViewportArea({
       const preview = drawMode === 'preview';
       const sceneLighting = preview ? { world: lighting.source === 'scene', lights: lighting.preview.sceneLights } : undefined;
       const needsScene = lighting.source === 'scene' || (preview && lighting.preview.sceneLights);
-      view.holdRendered(needsScene && stage ? drawCamera : null, sceneLighting, preview ? 'viewport' : 'render');
+      // Shading changes lighting, not which objects an editing viewport shows.
+      // Only the detached game uses render visibility, as a clean capture does.
+      view.holdRendered(needsScene && stage ? drawCamera : null, sceneLighting, playing ? 'render' : 'viewport');
       // 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);
@@ -904,7 +919,7 @@ function BlenderViewportArea({
       view.holdRendered(null);
       view.setWorkbench(false);
     };
-  }, [documentId, view]);
+  }, [documentId, view, playing]);
   /**
    * SHIFT+RIGHT-CLICK PLACES THE 3D CURSOR, Blender's own chord for
    * `view3d.cursor3d` (`blender_default.py`, `params.cursor_set_event`). The
@@ -976,6 +991,7 @@ function BlenderViewportArea({
     >
     <Surface
       active={active ?? true}
+      fillContainer={playing}
       documentId={documentId}
       sourcePath={blend ?? 'blender:runtime'}
       displayName={document?.label ?? 'Model'}

package/dist-node/serving.mjs

@@ -560,8 +560,12 @@ function blenderRoutesPlugin(services) {
         }
         res.setHeader("content-type", "application/octet-stream");
         res.setHeader("content-length", String(size));
+        if (size === 0) {
+          res.end();
+          return;
+        }
         await new Promise((resolve) => {
-          const stream = createReadStream2(absolute);
+          const stream = createReadStream2(absolute, { start: 0, end: size - 1 });
           stream.once("error", () => {
             res.destroy();
             resolve();

package/host/blender-runtime-host.ts

@@ -901,16 +901,26 @@ async function runtimeView(): Promise<RuntimeView> {
   // command (3 s of boot, then the full wait).
   const deadline = Date.now() + 15_000;
   let id = presentationDocumentId();
+  let publication = 'no context';
   for (;;) {
     id = presentationDocumentId();
     const published = await documents.waitForContext(id, Math.max(0, Math.min(250, deadline - Date.now())));
     if (isRuntimeView(published)) return published;
+    if (published !== undefined) {
+      const required = ['applyFrame', 'stageFrame', 'snapshot', 'captureSnapshot', 'recordPresentation', 'recordPhotograph'];
+      const handle = published as Record<string, unknown> | null;
+      publication = `${typeof published} context missing ${required.filter(method => typeof handle?.[method] !== 'function').join(', ')}`;
+      // An incompatible published context resolves waitForContext immediately.
+      // Yield so a pending document commit can replace it; a microtask loop
+      // otherwise prevents that publication for the whole timeout window.
+      await new Promise<void>(resolve => setTimeout(resolve, Math.max(0, Math.min(25, deadline - Date.now()))));
+    }
     if (Date.now() >= deadline) break;
   }
   throw new Error(
     `The Blender Model document is not open, or the open one is not a Model this engine can present ` +
       `to (it must answer stageFrame, applyFrame, captureSnapshot, recordPresentation and recordPhotograph): nothing ` +
-      `published a presentable view as ${id} within 15 s (bound model: ${boundModel?.documentId ?? 'none'}). ` +
+      `published a presentable view as ${id} within 15 s (bound model: ${boundModel?.documentId ?? 'none'}; last publication: ${publication}). ` +
       'Open the Model document first (`volter blender-mcp` opens it before its first call).',
   );
 }

package/node/blender-mcp.ts

@@ -304,7 +304,8 @@ export async function serveBlenderMcp(
   // it goes rendered one, wrote it into the project and ran the OS `open` on it: Preview started
   // outside the editor. The editor already shows a picture as one of its documents.
   const photographs = `A photograph is shown to the person in the editor, never in another app: get_viewport_screenshot returns one, and an image file written inside the project opens as an editor document with \`npx ${command} eval 'editor.openAsset("<project-relative path>")'\`. Do not run the OS \`open\` on it.`;
-  const instructions = `${runtimeIdentity}\n${photographs}`;
+  const filesystem = `Project files are mounted in Blender at the project's actual absolute path: ${project}. Use that root for image loads, saves and exports; /project is not an alias.`;
+  const instructions = `${runtimeIdentity}\n${filesystem}\n${photographs}`;
   const tools = (blenderTools as ToolShape[]).map((tool) =>
     tool.name === 'execute_blender_code'
       ? { ...tool, description: `${instructions}\n${tool.description}` }

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.127",
+  "version": "0.1.129",
   "publishConfig": {
     "access": "public"
   },
@@ -70,14 +70,14 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.32.1",
-    "@volter/blender-engine": "0.1.125",
-    "@volter/editor-threejs": "0.5.188",
+    "@volter/blender-engine": "0.1.127",
+    "@volter/editor-threejs": "0.5.190",
     "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "@volter/editor-live": "0.5.188",
-    "@volter/editor-project": "0.5.188",
-    "@volter/editor-sdk": "0.5.188",
+    "@volter/editor-live": "0.5.190",
+    "@volter/editor-project": "0.5.190",
+    "@volter/editor-sdk": "0.5.190",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "three": "^0.180.0",

package/serving/blender-routes.ts

@@ -333,8 +333,10 @@ export function blenderRoutesPlugin(services: ProjectServingServices): Plugin {
         }
         res.setHeader('content-type', 'application/octet-stream');
         res.setHeader('content-length', String(size));
+        if (size === 0) { res.end(); return; }
         await new Promise<void>((resolve) => {
-          const stream = createReadStream(absolute);
+          // Bound an append-only file to the exact response length advertised above.
+          const stream = createReadStream(absolute, { start: 0, end: size - 1 });
           stream.once('error', () => {
             res.destroy();
             resolve();