@volter/editor-blender 0.1.141 → 0.1.142

package/contributions/blender.style.ts

@@ -2,14 +2,14 @@
  * The BLENDER style bundle — Blender's greys and widget blue as a palette
  * document (`blender.palette.json`, the same v3 shape a person imports), its
  * own opaque material, and Blender's chrome regions
- * (`@volter/editor-sdk/looks`, a `workspace.style` contribution).
+ * (`@volter/sdk/looks`, a `workspace.style` contribution).
  *
  * The material transcribes Blender's default theme: widgets round at 0.2 of
  * their height (4px on a 20px widget), areas and panels are flat with no
  * shadow, and only menus and popovers cast one (`menu_shadow_fac` 0.5 over
  * `menu_shadow_width` 4). The `large` radius is our reading — Blender rounds
  * its popovers the same as its menus. The density is measured from Blender
- * 5.2's own frames at 1x (`/Volumes/PeakSSD/volter-work/blender-reference`):
+ * 5.2's own frames at 1x:
  * 26px top bar and area headers, 24px status bar, and — re-measured against
  * the frames widget by widget — EVERY widget 20px tall, button/field/toggle
  * alike, so all three control sizes are 20 rather than a 18/20/24 ramp
@@ -37,7 +37,7 @@
  * A glyph is EDITED in `blender-icons.source.mjs` and the JSON re-emitted by
  * running it; a path `d` is not a thing a person edits by hand.
  */
-import type { IconSetContribution, StyleContribution } from '@volter/editor-sdk/looks';
+import type { IconSetContribution, StyleContribution } from '@volter/sdk/looks';
 import iconsJson from './blender.icons.json';
 import palette from './blender.palette.json';
 

package/contributions/model.layout.ts

@@ -1,12 +1,12 @@
 /**
  * The MODEL workspace — Blender-shaped modeling: a dominant document, outliner
- * above properties (`@volter/editor-sdk/looks`, a `workspace.layout`
+ * above properties (`@volter/sdk/looks`, a `workspace.layout`
  * contribution). Its arrangement carries Blender 5.2's own MODELING-workspace
  * proportions; `../src/layouts.tsx` states the measurement and the host's
  * fixed-pane clamp that bounds it.
  */
 
-import type { WorkspaceLayoutContribution } from '@volter/editor-sdk/looks';
+import type { WorkspaceLayoutContribution } from '@volter/sdk/looks';
 import { BLENDER_REGIONS } from '../src/regions';
 
 export const point = 'workspace.layout';

package/contributions/models.finder.ts

@@ -12,7 +12,7 @@
  * the TypeScript mesh kit was the modeling engine while Blender could not run
  * in the tab; it now does, and a model is Blender data).
  *
- * Select it in `volter.adapter.ts`:
+ * Select it in `editor/volter.adapter.ts`:
  *
  *   documents: { find: [{ finder: 'modelsFromBlendFiles', include: ['src/models/**\/*.blend'] }] }
  *

package/contributions/properties-data.inspector.tsx

@@ -31,7 +31,7 @@
  * It stands when: `buttons_context_path_data` — the object HAS data (an Empty
  * usually has none).
  */
-import type { ToolContributionNode } from '@volter/editor-sdk/contributions';
+import type { ToolContributionNode } from '@volter/sdk/contributions';
 import { blenderPropertiesState, resolveBlenderSubject } from './blender-properties-model';
 import { blenderPropertiesTabMatch, blenderPropertiesTabSection } from './blender-properties-tab';
 import type { BlenderCuratedPanel } from './blender-properties-view';

package/contributions/properties-scene.inspector.tsx

@@ -36,7 +36,7 @@
 import { blenderPropertiesTabMatch, blenderPropertiesTabSection } from './blender-properties-tab';
 import type { BlenderCuratedPanel } from './blender-properties-view';
 import { resolveBlenderSubject } from './blender-properties-model';
-import type { ToolContributionNode } from '@volter/editor-sdk/contributions';
+import type { ToolContributionNode } from '@volter/sdk/contributions';
 
 /** `properties_scene.py`, panel by panel. Line numbers are that file's. */
 const CURATED: readonly BlenderCuratedPanel[] = [

package/contributions/sculpt.layout.ts

@@ -5,7 +5,7 @@
  * chrome); it keeps its OWN persisted layout the moment a person touches it.
  */
 
-import type { WorkspaceLayoutContribution } from '@volter/editor-sdk/looks';
+import type { WorkspaceLayoutContribution } from '@volter/sdk/looks';
 import { BLENDER_REGIONS } from '../src/regions';
 
 export const point = 'workspace.layout';

package/contributions/shading.layout.ts

@@ -52,7 +52,7 @@
  * contribution exists because the node view does.
  */
 
-import type { WorkspaceLayoutContribution } from '@volter/editor-sdk/looks';
+import type { WorkspaceLayoutContribution } from '@volter/sdk/looks';
 import { BLENDER_REGIONS } from '../src/regions';
 
 export const point = 'workspace.layout';

package/contributions/texture.layout.ts

@@ -4,7 +4,7 @@
  * layer stack (see `sculpt.layout.ts` for why).
  */
 
-import type { WorkspaceLayoutContribution } from '@volter/editor-sdk/looks';
+import type { WorkspaceLayoutContribution } from '@volter/sdk/looks';
 
 export const point = 'workspace.layout';
 export const layout: WorkspaceLayoutContribution = {

package/contributions/uv-editing.layout.ts

@@ -45,7 +45,7 @@
  * this contribution exists because the UV view does.
  */
 
-import type { WorkspaceLayoutContribution } from '@volter/editor-sdk/looks';
+import type { WorkspaceLayoutContribution } from '@volter/sdk/looks';
 import { BLENDER_REGIONS } from '../src/regions';
 
 export const point = 'workspace.layout';

package/dist-node/serving.mjs

@@ -6,7 +6,7 @@ import { tmpdir as tmpdir2 } from "node:os";
 import { dirname as dirname2, join as join2 } from "node:path";
 import { createBrotliDecompress } from "node:zlib";
 
-// ../editor-sdk/src/project/output-roots.ts
+// ../sdk/src/project/output-roots.ts
 var PROJECT_OUTPUT_ROOTS = ["public", "references"];
 function normalizeSlashes(path) {
   const slashed = path.replaceAll("\\", "/");
@@ -24,7 +24,7 @@ function projectOutputRootOf(path) {
   );
 }
 
-// ../editor-sdk/src/session/relative-path-guard.ts
+// ../sdk/src/session/relative-path-guard.ts
 function relativePathRejection(path) {
   if (!path || path.trim() === "") return "empty";
   if (path.includes("\0")) return "nul";

package/host/blender-runtime-host.ts

@@ -4,7 +4,7 @@
  * the Code-OSS frame, item 6). Its thirteen verbs are
  * `../contributions/blender.command.ts`, a `workspace.command` contribution;
  * what it needs of the running editor it asks THROUGH THE DOOR,
- * `@volter/editor-sdk/host` — the document context it
+ * `@volter/sdk/host` — the document context it
  * presents into, the session it lives and dies with. It imports no host module
  * (WORKBENCH.md §The invariants, "Direction": a package imports only the SDK
  * and other packages' exports), which is what lets this lane ship against a
@@ -43,9 +43,9 @@ import type {
 } from '@volter/blender-engine/browser/rna';
 import { createBlenderDisplayTransform, blenderDisplaySettingsForRender } from '@volter/blender-engine/browser/three/blender-display-transform';
 import { BlenderRuntimeView } from '@volter/blender-engine/browser/three/blender-runtime-view';
-import type { EditorCommandResult } from '@volter/editor-sdk/commands';
-import { editorHost } from '@volter/editor-sdk/host';
-import { invokeViewVerb, type ViewVerbContribution } from '@volter/editor-sdk/views';
+import type { EditorCommandResult } from '@volter/sdk/commands';
+import { editorHost } from '@volter/sdk/host';
+import { invokeViewVerb, type ViewVerbContribution } from '@volter/sdk/views';
 import {
   captureSceneImage,
   captureSceneLinear,

package/node/blender-mcp.ts

@@ -22,9 +22,9 @@ import {
   ListPromptsRequestSchema,
   ListToolsRequestSchema,
 } from '@modelcontextprotocol/sdk/types.js';
-import { EditorClient, type EditorView } from '@volter/editor-sdk';
+import { EditorClient, type EditorView } from '@volter/sdk';
 import blenderBundle from '@volter/blender-engine/wasm/BUNDLE.json';
-import { projectOutputRootOf } from '@volter/editor-sdk/project/output-roots';
+import { projectOutputRootOf } from '@volter/sdk/project/output-roots';
 import blenderDefaults from './blender-mcp-defaults.json';
 import blenderTools from './blender-mcp-tools.json';
 
@@ -266,7 +266,7 @@ class TabSession {
     if (!this.#connecting) {
       this.#connecting = (async () => {
         await this.ensureEditor();
-        const { resolveSession } = await import('@volter/editor-live');
+        const { resolveSession } = await import('@volter/live');
         const session = await resolveSession(this.project);
         this.#port = session.port;
         this.#origin = `http://127.0.0.1:${session.port}`;

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

package/serving/blender-routes.ts

@@ -5,7 +5,7 @@
  * bytes it produced reach the project (a shipped output, the session's `.blend`). They were
  * the kit's own routes; the kit now names no Blender, and reaches these only because the
  * product that composes this package declares its serving module. Writes go through the kit's
- * services (`@volter/editor-sdk/session/project-serving`), so they are attributed and recorded
+ * services (`@volter/sdk/session/project-serving`), so they are attributed and recorded
  * like every other project write.
  */
 
@@ -16,9 +16,9 @@ import type { IncomingMessage, ServerResponse } from 'node:http';
 import { tmpdir } from 'node:os';
 import { dirname, join } from 'node:path';
 import { createBrotliDecompress } from 'node:zlib';
-import { projectOutputRootOf } from '@volter/editor-sdk/project/output-roots';
-import { isContainedRelativePath } from '@volter/editor-sdk/session/relative-path-guard';
-import type { ProjectServingServices } from '@volter/editor-sdk/session/project-serving';
+import { projectOutputRootOf } from '@volter/sdk/project/output-roots';
+import { isContainedRelativePath } from '@volter/sdk/session/relative-path-guard';
+import type { ProjectServingServices } from '@volter/sdk/session/project-serving';
 import type { Plugin } from 'vite';
 import {
   BLENDER_WALI_ARTIFACT,

package/serving/index.ts

@@ -1,10 +1,10 @@
 /**
  * `@volter/editor-blender`'s server half (`package.json#volter.serving`, the project-serving door in
- * `@volter/editor-sdk/session/project-serving`): the routes the Blender in the tab reads and
+ * `@volter/sdk/session/project-serving`): the routes the Blender in the tab reads and
  * writes through.
  */
 
-import type { ProjectServingModule } from '@volter/editor-sdk/session/project-serving';
+import type { ProjectServingModule } from '@volter/sdk/session/project-serving';
 import { blenderRoutesPlugin } from './blender-routes';
 import { BLENDER_WALI_ARTIFACT, BLENDER_WASM_FILES, blenderWasmStatus } from './blender-wasm-artifact';
 

package/src/layouts.tsx

@@ -1,7 +1,7 @@
 /**
  * The BLENDER layout — the composition a models project's adapter declares
- * (`volter.adapter.ts`: `editor: { Layout: ModelLayout }`, the door
- * `@volter/editor-sdk/layouts` documents). `ModelArrangement` names the Model
+ * (`editor/volter.adapter.ts`: `editor: { Layout: ModelLayout }`, the door
+ * `@volter/sdk/layouts` documents). `ModelArrangement` names the Model
  * workspace and the chrome regions it shows; Sculpt and Texture open on it too
  * — their reserved panels (the brush rail, the layer stack) ship WITH their
  * programs, never as empty chrome, and until then nothing about a sculpt
@@ -21,7 +21,7 @@ import {
   EditorHeader,
   Workspace,
   type WorkspaceArrangement,
-} from '@volter/editor-sdk/layouts';
+} from '@volter/sdk/layouts';
 import { BLENDER_REGIONS } from './regions';
 
 export const ModelArrangement: WorkspaceArrangement = {

package/src/looks.ts

@@ -1,6 +1,6 @@
 /**
  * The Blender skew's LOOK and BINDINGS as importable values — `@volter/editor-blender/looks`,
- * the public surface a project's `volter.adapter.ts` declares them from
+ * the public surface a project's `editor/volter.adapter.ts` declares them from
  * (ARCHITECTURE-CORE §Adapters and contributions are code, not configs):
  *
  *     editor: { Layout: ModelLayout, style: blenderStyle, keymap: blenderKeymap }

package/src/play-live.ts

@@ -0,0 +1,27 @@
+/**
+ * THE RUNNING GAME'S ANIMATION, for the animation editors. A game poses its copy of the model
+ * (`../contributions/blender-play-skin.ts`); while it runs, the Action Editor and the NLA editor
+ * show what it is playing, read-only, the way a game engine's animator view highlights the live
+ * state. The run sets the slot when its animation starts and clears it when it ends.
+ */
+import type { PlayAnimation } from '../contributions/blender-play-skin';
+
+let current: PlayAnimation | null = null;
+const listeners = new Set<() => void>();
+
+export function setLiveAnimation(animation: PlayAnimation | null): void {
+  if (current === animation) return;
+  current = animation;
+  for (const listener of [...listeners]) listener();
+}
+
+/** The running game's animation, or null when no game runs. */
+export function liveAnimation(): PlayAnimation | null {
+  return current;
+}
+
+/** Fires when a game's animation starts or ends (not on each frame: readers poll while it runs). */
+export function subscribeLiveAnimation(listener: () => void): () => void {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}

package/src/play-mode.ts

@@ -1,18 +1,21 @@
 /**
- * GAME OR MOVIE — what a model document's bottom area and transport are for (owner, 2026-10-06:
- * "it's very confusing that the timeline at the bottom has a play button AND there's a play
- * button at the top … allow the user to flip between game and movie mode").
+ * GAME OR ANIMATION — what a model document's bottom area shows. It is not mutually exclusive:
+ * animation is used by games too.
  *
- * - **Movie** is Blender's own Layout screen: the Timeline at the bottom, its transport playing
- *   the file's animation, and no game Play anywhere.
- * - **Game** replaces the Timeline with the Game panel (`../contributions/blender-game-panel.tsx`):
- *   the ONE Play, and the run's pause, step, speed, restart and clock.
+ * - **Animation** is Blender's animation editors: the Timeline, the Dope Sheet's Action Editor and
+ *   the NLA editor (`../contributions/blender-animation-editors.tsx`). While a game runs they show
+ *   what the game is animating, read-only.
+ * - **Game** is the Game panel (`../contributions/blender-game-panel.tsx`): the ONE Play, and the
+ *   run's pause, step, speed, restart and clock.
+ *
+ * They are two views of one bottom area, not two exclusive states: switching to Animation leaves a
+ * running game running.
  *
  * The switch is the bottom area's own, at the leading edge of its header row in the Game panel
  * and the Timeline alike (`PlayModeSwitch`, `blender-game-panel.tsx`); this module is the state
  * both sides read. A document opens as a
  * Game when its model has a play script (`*.play.ts` beside the `.blend`, as the Play tool finds
- * it — `DocumentPlayExtension.hasScript`) and as a Movie otherwise, and the person's own pick
+ * it — `DocumentPlayExtension.hasScript`) and in Animation otherwise, and the person's own pick
  * then stands for that document for the browser session, kept the way `area-split.ts` keeps the
  * split, per document id — in session storage rather than local, because the default is what a
  * fresh session should start from.
@@ -26,9 +29,14 @@
 import {
   documentPlayExtension,
   subscribeDocumentPlayExtensions,
-} from '@volter/editor-sdk/kit/document-play-extension';
+} from '@volter/sdk/kit/document-play-extension';
+
+export type ModelPlayMode = 'game' | 'animation';
 
-export type ModelPlayMode = 'game' | 'movie';
+/** A mode as asked for, or null for anything else. */
+export function playModeOf(value: unknown): ModelPlayMode | null {
+  return value === 'game' || value === 'animation' ? value : null;
+}
 
 const STORAGE_PREFIX = 'volter.blender.play-mode:';
 const listeners = new Set<() => void>();
@@ -47,7 +55,7 @@ function publish(): void {
 function stored(documentId: string): ModelPlayMode | null {
   try {
     const value = globalThis.sessionStorage?.getItem(STORAGE_PREFIX + documentId);
-    return value === 'game' || value === 'movie' ? value : null;
+    return playModeOf(value);
   } catch {
     return null;
   }
@@ -103,18 +111,18 @@ export function modelDocumentSource(documentId: string): string | undefined {
 }
 
 /**
- * THE MODE A DOCUMENT IS IN: Movie whenever no Play tool is installed (there is no game to
+ * THE MODE A DOCUMENT IS IN: Animation whenever no Play tool is installed (there is no game to
  * switch to), else the person's pick, else Game exactly when the model has a play script. A
  * script not yet looked for counts as none, so a document opens on the Timeline and turns to
  * the Game panel when the answer arrives.
  */
 export function modelPlayMode(documentId: string): ModelPlayMode {
   const extension = documentPlayExtension('model');
-  if (extension === null) return 'movie';
+  if (extension === null) return 'animation';
   const pick = chosenPlayMode(documentId);
   if (pick !== null) return pick;
   const blend = sources.get(documentId);
-  return blend !== undefined && extension.hasScript?.(blend) === true ? 'game' : 'movie';
+  return blend !== undefined && extension.hasScript?.(blend) === true ? 'game' : 'animation';
 }
 
 export function playModeVersion(): number {
@@ -128,7 +136,7 @@ export function playModeVersion(): number {
  * takes (`useSyncExternalStore(subscribePlayMode, playModeVersion)`): a script found after the
  * first render, a run starting or stopping, a restart. Handing the tool's publications straight to
  * the reader's listener re-ran a snapshot that had not changed, so React kept the old render — a
- * document with a play script stayed in Movie, and the Game panel kept showing Stop after the game
+ * document with a play script stayed in Animation, and the Game panel kept showing Stop after the game
  * had stopped. One subscription to the tool's registry, held while anything reads this store,
  * bumps the version and then tells the readers.
  */

package/src/presentation.ts

@@ -1,5 +1,5 @@
 /**
- * HOW THE BLENDER STAGE BEHAVES, as its starting presentation (`@volter/editor-sdk/kit/
+ * HOW THE BLENDER STAGE BEHAVES, as its starting presentation (`@volter/sdk/kit/
  * viewport-presentation`): this package builds the `model` stage, so it states the stage's
  * function there, beneath every person's choice and never in the look (ARCHITECTURE.md rule 7).
  */
@@ -7,7 +7,7 @@ import {
   DOCUMENT_STUDIO_PRESET,
   registerStartingPresentation,
   type ViewportCamera,
-} from '@volter/editor-sdk/kit/viewport-presentation';
+} from '@volter/sdk/kit/viewport-presentation';
 
 /**
  * A 3D View's field of view for its lens, as Blender computes it (`BKE_camera_params_from_view3d`,

package/src/regions.ts

@@ -3,7 +3,7 @@
  * which regions exist and what a hierarchy row spells are function, the workspace's, never the
  * look's). Each of this package's layouts spreads these beneath its own.
  */
-import type { WorkspaceLayoutContribution } from '@volter/editor-sdk/looks';
+import type { WorkspaceLayoutContribution } from '@volter/sdk/looks';
 
 export const BLENDER_REGIONS: NonNullable<WorkspaceLayoutContribution['regions']> = {
   workspaceTabs: 'shown',

package/src/timeline-view-state.ts

@@ -10,7 +10,7 @@
  * is about the DRAWING.
  *
  * WHAT DRIVES IT IS NOT A SESSION VERB. U8's ruling 1 (2026-09-19): every view
- * publishes `volter.<view>.<verb>` commands through `@volter/editor-sdk/views`, one
+ * publishes `volter.<view>.<verb>` commands through `@volter/sdk/views`, one
  * table behind the frame's command service and standalone `cyclotron edit`'s
  * session verb — so this view adds no `blender-*` verb of its own.
  *
@@ -90,8 +90,13 @@ export interface TimelineViewState {
    * object regardless, in Blender and here.
    */
   readonly onlySelected: boolean;
+  /** Which of Blender's animation editors the bottom area shows in Animation mode: the
+   *  Timeline, the Dope Sheet's Action Editor, or the NLA editor (Blender's editor-type menu). */
+  readonly editor: AnimationEditor;
 }
 
+export type AnimationEditor = 'timeline' | 'action' | 'nla';
+
 const INITIAL: TimelineViewState = {
   transform: { startFrame: -5, pixelsPerFrame: 8 },
   refusal: null,
@@ -99,6 +104,7 @@ const INITIAL: TimelineViewState = {
   framedAt: 0,
   drawn: null,
   onlySelected: true,
+  editor: 'timeline',
 };
 
 let state: TimelineViewState = INITIAL;

package/src/uv-view-state.ts

@@ -6,7 +6,7 @@
  * surface nothing in the product could read or drive.
  *
  * WHAT DRIVES IT IS NOT A SESSION VERB. U8's ruling 1 (2026-09-19): every view
- * publishes `volter.<view>.<verb>` commands through `@volter/editor-sdk/views`,
+ * publishes `volter.<view>.<verb>` commands through `@volter/sdk/views`,
  * one table behind the frame's command service and standalone `cyclotron edit`'s
  * session verb — so this view adds NO `blender-*` verb of its own, which is
  * exactly what the ruling asked the remaining I5 views to stop paying for.

package/view/blender-view-routes.ts

@@ -1,6 +1,6 @@
 /**
  * `@volter/editor-blender`'s routes in a LIMITED VIEW (`package.json#volter.viewServing`,
- * `@volter/editor-sdk/session/limited-view`): the same requests the Blender in the tab makes of
+ * `@volter/sdk/session/limited-view`): the same requests the Blender in the tab makes of
  * its session (`serving/blender-routes.ts`), answered in the page against the project's files in
  * memory. The engine's own bytes are not here: they are fixed for a build, so the serving module
  * declares them (`viewSnapshotRoutes`) and the view ships what the session answered.
@@ -10,7 +10,7 @@
  * memory, readable by the editor and the workbench like any other file, gone on reload.
  */
 
-import type { ViewRoute, ViewServingModule, ViewServingServices } from '@volter/editor-sdk/session/limited-view';
+import type { ViewRoute, ViewServingModule, ViewServingServices } from '@volter/sdk/session/limited-view';
 
 /** The largest chunk a document save sends (`document-chunks.mts`'s cut bound). */
 const DOCUMENT_CHUNK_MAX = 4 * 1024 * 1024;