@volter/editor-blender 0.1.135 → 0.1.137

package/contributions/blender-runtime.document.tsx

@@ -71,14 +71,12 @@ import {
   modelDocumentMayOpen,
   modelDocumentOwnsPresentation,
   blenderActionClip,
-  blenderArmatureActions,
-  blenderRig,
   blenderRnaVersion,
 } from '../host/blender-runtime-host';
 import { BlenderObjectModeHeader } from './blender-header-menus';
 import { blenderOutlinerAuthoringFor, createBlenderOutlinerAuthoring } from './blender-outliner-authoring';
 import { blenderSkin } from './blender-runtime-skin';
-import { bindPlayAnimation, readPlayClipLibrary, type PlayAnimation } from './blender-play-skin';
+import { playAnimation, type PlayAnimation } from './blender-play-skin';
 import { areaSplit, subscribeAreaSplit } from '../src/area-split';
 import { noteModelDocument } from '../src/play-mode';
 import { documentPlayExtension, subscribeDocumentPlayExtensions } from '@volter/editor-sdk/kit/document-play-extension';
@@ -910,19 +908,12 @@ function BlenderViewportArea({
       preparing = true;
       orbit = stage.rig().orbit;
       orbit.enabled = false;
-      // THE COPY'S CHARACTERS ANIMATE: their skins and every clip they can play, read once for
-      // this run and bound to the copy (`blender-play-skin.ts`). A read that fails costs the game its
-      // animation, said in the console, never the game itself.
-      void Promise.all([
-        view.prepareRendered(stage.rig().drawCamera(), 'render'),
-        readPlayClipLibrary().catch((error: unknown) => {
-          editorHost().console.warn(`The game's animation could not be read: ${error instanceof Error ? error.message : String(error)}`, 'blender-play');
-          return null;
-        }),
-      ]).then(([, library]) => {
+      // THE COPY'S CHARACTERS ANIMATE: its view bound their skins from the copied frame, and each
+      // armature plays the action the file assigns it until the game sets another
+      // (`blender-play-skin.ts`). Nothing is read before the game starts.
+      void view.prepareRendered(stage.rig().drawCamera(), 'render').then(() => {
         if (stopped) return;
-        animation = library ? bindPlayAnimation(view, library) : null;
-        for (const warning of animation?.warnings ?? []) editorHost().console.warn(warning, 'blender-play');
+        animation = playAnimation(view, (armature, action) => blenderActionClip({ object: armature, action }));
         stopScript = documentPlayExtension('model')?.run({
           ...(animation ? { animation } : {}),
           documentId: modelId,
@@ -1056,31 +1047,21 @@ function BlenderViewportArea({
     };
   }, [documentId, view]);
   /**
-   * THE MODEL'S SKINS AND ASSIGNED ACTION, AS BLENDER'S VIEWPORT SHOWS THEM: a rigged object is
-   * presented skinned, whatever editors are open, and plays the action assigned to it. Bound on
-   * every change of the file, a moment after it settles, because `rna_rig` walks every vertex of
-   * every rigged mesh; a file with no armature pays only the cheap listing.
+   * THE ASSIGNED ACTION ON THE PRESENTED SKELETONS. The skins themselves come with every frame (the
+   * presenter binds them, `blender-runtime-skeleton.ts`); after each present the director follows
+   * the frame, and reads a clip only when the frame says its action, revision or clock moved.
    */
   const rnaVersion = useSyncExternalStore(subscribeBlenderRna, blenderRnaVersion, blenderRnaVersion);
-  /** The armatures, their actions and what each is assigned, as last bound: an edit that changes
-   *  none of them and replaced no skinned mesh costs no rig read and no bake. */
-  const boundListing = useRef<string | null>(null);
   useEffect(() => {
     if (!documentId || !main) return;
     let live = true;
-    const timer = setTimeout(() => {
-      void (async () => {
-        const listing = await blenderArmatureActions();
-        if (!live || !listing?.armatures.length) return;
-        const key = JSON.stringify([listing.armatures, listing.scene ?? null]);
-        if (key === boundListing.current && !blenderSkin.stale(view)) return;
-        await blenderSkin.bind(view, { rig: () => blenderRig(), clip: () => blenderActionClip() });
-        boundListing.current = key;
-      })().catch((thrown: unknown) => {
-        if (live) editorHost().console.warn(`This file's rig could not be read: ${thrown instanceof Error ? thrown.message : String(thrown)}`, 'blender-skin');
-      });
-    }, 400);
-    return () => { live = false; clearTimeout(timer); };
+    void blenderSkin.sync(view, {
+      clip: (armature) => blenderActionClip({ object: armature }),
+      bake: (armature, action) => blenderActionClip({ object: armature, action }),
+    }).catch((thrown: unknown) => {
+      if (live) editorHost().console.warn(`This file's action could not be read: ${thrown instanceof Error ? thrown.message : String(thrown)}`, 'blender-skin');
+    });
+    return () => { live = false; };
   }, [documentId, main, view, rnaVersion]);
   /**
    * ATTACH THE SKIN TO THIS STAGE'S TRANSPORT.

package/contributions/blender.command.ts

@@ -93,7 +93,6 @@ export const commands: CommandContribution['commands'] = {
   // and the ONE write the Timeline makes (`scene.frame_current`, once on
   // pause and at scrub-end) goes through `blender-rna-set`, which already
   // exists and already presents.
-  'blender-rig': verb('none', 60_000),
   'blender-action-clip': verb('none', 120_000),
   // THE NODE VIEW'S OWN ACTIONS as a session verb — the keyboard ruling's
   // `volter.*`-command-per-action pattern, and the only way the drawer's view

package/host/blender-runtime-host.ts

@@ -36,7 +36,6 @@ import type {
   BlenderNodeTree,
   BlenderOutlinerTree,
   BlenderOutlinerWrite,
-  BlenderRig,
   BlenderRnaContext,
   BlenderRnaView,
   BlenderRnaWrite,
@@ -661,15 +660,6 @@ export async function blenderUvLayout(options?: {
   return blenderRuntime().uvLayout(options);
 }
 
-/** THE RIG DOOR, in-page — one mesh's skin binding, which the presenter turns
- *  into a `THREE.SkinnedMesh` (`../contributions/blender-runtime-skin.ts`).
- *  WE VISUALIZE WITH THREE.JS, NOT BLENDER (owner rule, 2026-09-20): this is
- *  called once per rig, never per played frame. Same rule as the doors above:
- *  it never starts the engine. */
-export async function blenderRig(options?: { object?: string }): Promise<BlenderRig | null> {
-  if (!blenderSessionStarted()) return null;
-  return blenderRuntime().rig(options);
-}
 
 /** THE CLIP DOOR, in-page — one action as three.js keyframe tracks plus the
  *  scene's frame range and the Timeline's summary columns. Called when the
@@ -684,11 +674,6 @@ export async function blenderActionClip(options?: {
   return blenderRuntime().actionClip(options);
 }
 
-/** Every armature and the actions that can play on it, for Play's clip library. Never starts the engine. */
-export async function blenderArmatureActions(): Promise<{ armatures: { armature: string; current: string | null; actions: string[]; keys?: string }[]; scene?: { frameCurrent: number; frameStart: number; frameEnd: number; fps: number } } | null> {
-  if (!blenderSessionStarted()) return null;
-  return blenderRuntime().armatureActions();
-}
 
 export async function blenderOutlinerSet(
   path: string,
@@ -1456,18 +1441,8 @@ export async function handleBlenderCommand(cmd: {
             }),
           },
         };
-      // THE RIG AND CLIP DOORS on the wire, beside the UV one: the skin
-      // binding and the action as three.js tracks, so a `cyclotron eval` reads
-      // exactly what the presenter bound and what the Timeline plays.
-      case 'blender-rig':
-        return {
-          ok: true,
-          data: {
-            result: await session.rig({
-              ...(typeof cmd['object'] === 'string' ? { object: cmd['object'] } : {}),
-            }),
-          },
-        };
+      // THE CLIP DOOR on the wire, beside the UV one: an action as three.js tracks, so a
+      // `cyclotron eval` reads exactly what the Timeline and a game play.
       case 'blender-action-clip':
         return {
           ok: true,

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.135",
+  "version": "0.1.137",
   "publishConfig": {
     "access": "public"
   },
@@ -72,15 +72,15 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.32.1",
-    "@volter/blender-engine": "0.1.133",
-    "@volter/editor-threejs": "0.5.196",
+    "@volter/blender-engine": "0.1.135",
+    "@volter/editor-threejs": "0.5.198",
     "zod": "^4.3.6",
     "@fortawesome/free-solid-svg-icons": "^7.2.0"
   },
   "peerDependencies": {
-    "@volter/editor-live": "0.5.196",
-    "@volter/editor-project": "0.5.196",
-    "@volter/editor-sdk": "0.5.196",
+    "@volter/editor-live": "0.5.198",
+    "@volter/editor-project": "0.5.198",
+    "@volter/editor-sdk": "0.5.198",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "three": "^0.180.0",