@volter/editor-blender 0.1.71 → 0.1.73

package/contributions/blender-runtime-skin.ts

@@ -217,6 +217,7 @@ export class BlenderSkinDirector {
    *  frame stands, which is Blender's answer for a file with no animation. */
   frame(): number {
     const clip = this.#clip;
+    if (this.#seeked !== null) return this.#seeked;
     if (!clip || !this.#action || clip.clipStart === undefined) return clip?.frameCurrent ?? 1;
     // A SEEK'S OWN ANSWER, while one is standing. `LoopRepeat` wraps
     // `action.time` into `[0, duration)`, so a seek to the LAST frame lands on
@@ -224,7 +225,6 @@ export class BlenderSkinDirector {
     // walk, where `jump-end` answered frame 1 over a frame-48 pose. The
     // wrapping is right for playback and wrong for a question, so a standing
     // seek answers with the frame it was given and the play tick clears it.
-    if (this.#seeked !== null) return this.#seeked;
     // THE ACTION'S TIME, NOT THE MIXER'S, and the difference is the whole of
     // looping: `AnimationMixer.time` is monotonic and never wraps, while
     // `AnimationAction.time` is wrapped into `[0, duration]` by `LoopRepeat`.
@@ -234,10 +234,9 @@ export class BlenderSkinDirector {
     return clip.clipStart + this.#action.time * clip.fps;
   }
 
-  /** Whether anything is actually playable — a Timeline over a file with no
-   *  action still draws its ruler and its range. */
+  /** Blender's scene clock exists even when the scene has no action. */
   get playable(): boolean {
-    return this.#action !== null;
+    return this.#clip !== null && this.#transport !== null;
   }
 
   // ------------------------------------------------------------ the binding
@@ -289,20 +288,27 @@ export class BlenderSkinDirector {
     this.#engineCalls++;
     const clip = await read.clip();
     const previous = this.#clip;
+    const rangeChanged = clip?.frameStart !== previous?.frameStart ||
+      clip?.frameEnd !== previous?.frameEnd || clip?.fps !== previous?.fps;
     const movedAction =
       clip?.action !== previous?.action ||
       clip?.tracks.length !== previous?.tracks.length ||
       clip?.clipStart !== previous?.clipStart ||
       clip?.clipEnd !== previous?.clipEnd;
     this.#clip = clip ?? null;
+    if (!clip || clip.scene !== previous?.scene) this.#seeked = null;
     if (clip?.reason) warnings.push(clip.reason);
     if (clip && (movedAction || changed)) this.#loadClip(presentation, clip, warnings);
+    // The subject can attach before the asynchronous scene read arrives.
+    // Refresh its clock range through the transport's own subject door.
+    const activeSubject = this.#transport?.snapshot().activeSubject;
+    if (rangeChanged && activeSubject) this.#transport?.setActiveSubject(activeSubject);
     // BLENDER'S OWN FRAME RE-SYNCS THE PLAYHEAD. An agent that set
     // `scene.frame_current` in bpy has said where it wants to be, and a
     // present is how we hear about it; while the transport is PLAYING it would
     // be the Timeline arguing with itself, so it is honoured only at rest.
     const playing = this.#transport?.snapshot().playbackState === 'playing';
-    if (clip && !playing && previous?.frameCurrent !== clip.frameCurrent) {
+    if (clip && !playing && (rangeChanged || previous?.frameCurrent !== clip.frameCurrent)) {
       this.#seek(clip.frameCurrent);
       // THE BOOKMARK READ, once per bind: the file says where it was left, and
       // the transport is what everything else now asks.
@@ -482,14 +488,17 @@ export class BlenderSkinDirector {
 
   #seek(frame: number): void {
     const clip = this.#clip;
-    if (!clip || !this.#mixer || clip.clipStart === undefined || clip.clipEnd === undefined) return;
-    const clamped = Math.min(clip.clipEnd, Math.max(clip.clipStart, frame));
+    if (!clip) return;
+    const clamped = Math.min(clip.frameEnd, Math.max(clip.frameStart, frame));
     this.#seeked = clamped;
+    // An action supplies a pose at this scene time; it does not own whether
+    // the scene clock can move. Empty/static scenes still play and scrub.
+    if (!this.#mixer || clip.clipStart === undefined || clip.clipEnd === undefined) return;
     // The TIME is nudged inside the clip so the last frame evaluates as the
     // last frame rather than wrapping to the first; the number REPORTED is the
     // one asked for (see `frame`).
     const duration = (clip.clipEnd - clip.clipStart) / clip.fps;
-    this.#mixer.setTime(Math.min(duration - 1e-4, (clamped - clip.clipStart) / clip.fps));
+    this.#mixer.setTime(Math.max(0, Math.min(duration - 1e-4, (clamped - clip.clipStart) / clip.fps)));
     this.#refresh();
   }
 
@@ -601,6 +610,8 @@ export class BlenderSkinDirector {
     this.#mixer?.stopAllAction();
     this.#mixer = null;
     this.#action = null;
+    this.#clip = null;
+    this.#seeked = null;
     for (const rig of this.#rigs.values()) {
       rig.skeleton.dispose();
       rig.boneRoot.removeFromParent();

package/contributions/blender-timeline.document.tsx

@@ -112,22 +112,10 @@ const REFUSALS = {
     'Selecting a keyframe writes `Keyframe.select_control_point`. The view draws the flags the data carries — a selected key takes `.common.anim.keyframe_selected` — and changes none of them.',
 } as const;
 
-/**
- * WHY A TRANSPORT GESTURE DOES NOTHING OVER A FILE WITH NO ACTION, in one
- * sentence, with ONE author: the `play` verb throws it and the header's
- * controls wear it as their title while they are disabled.
- *
- * It exists because the two halves disagreed. `volter.timeline.play` refused by
- * name while the BUTTON called `transport()?.play()` straight through — the
- * clock went to `playing`, both glyphs flipped to Pause, and the playhead
- * stayed on frame 1 forever, because `#seek`/the play tick return early with
- * no mixer to move (`blender-runtime-skin.ts`). Measured on U8's walk 3
- * (2026-09-20) over a `--template models` scaffold: `volter.timeline.state`
- * answered `action: null` with that warning while the header showed a running
- * transport. A control whose success can be invisible must say so.
- */
+/** The scene clock is available with or without an action. Only a missing
+ * scene/transport prevents timeline navigation. */
 const NOT_PLAYABLE =
-  'Nothing here is playable: no object in the scene carries an action this view could bind a mixer to.';
+  'No scene transport is attached yet; open the model document first.';
 
 /**
  * THE TRANSPORT THIS LOOK DRIVES — the Model document's, attached by
@@ -235,7 +223,7 @@ function report(): unknown {
  *  stage's own render loop draws the next frame from them. Blender is not
  *  called — `state().engineCalls` is how that is checked.
  *
- *  IT REFUSES OVER A FILE WITH NO ACTION, for the reason {@link NOT_PLAYABLE}
+ *  IT REFUSES WITHOUT A SCENE TRANSPORT, for the reason {@link NOT_PLAYABLE}
  *  states and with that one sentence: `#seek` returns at its first line with
  *  no mixer (`blender-runtime-skin.ts`), so the seek was a no-op and
  *  `report()` then answered `frame: 1` — the playhead's honest position and a
@@ -886,11 +874,8 @@ function TimelineHeader() {
   useSyncExternalStore(subscribeTimelineView, timelineViewVersion, timelineViewVersion);
   const play = blenderSkin.state();
   const unit = TIMELINE_CHROME.unit;
-  // THE TRANSPORT IS ONLY AS TRUE AS THE FILE. With no action there is no
-  // mixer, so every seek and the play tick return early; a control that still
-  // accepted the click reported a state the picture never took (see
-  // NOT_PLAYABLE). Disabled, wearing the reason as its title, is what the
-  // `play` verb already answers.
+  // Static scenes have a timeline too. Disable only while its scene/transport
+  // is unavailable, using the same condition as the command door.
   const playable = blenderSkin.playable;
   const button = (key: string, glyph: ReactNode, onClick: () => void, label: string) => (
     <button

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.71",
+  "version": "0.1.73",
   "publishConfig": {
     "access": "public"
   },
@@ -70,14 +70,14 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.30.0",
-    "@volter/blender-engine": "0.1.69",
-    "@volter/editor-threejs": "0.5.131",
+    "@volter/blender-engine": "0.1.71",
+    "@volter/editor-threejs": "0.5.133",
     "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "@volter/editor-live": "0.5.131",
-    "@volter/editor-project": "0.5.131",
-    "@volter/editor-sdk": "0.5.131",
+    "@volter/editor-live": "0.5.133",
+    "@volter/editor-project": "0.5.133",
+    "@volter/editor-sdk": "0.5.133",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "three": "^0.180.0",