@volter/editor-core 0.5.57 → 0.5.58

package/BUNDLED_NOTICES

@@ -31,7 +31,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 
-@volter/editor-project@0.5.57
+@volter/editor-project@0.5.58
 Declared license: Apache-2.0
 
 --- packages/editor-project/LICENSE ---
@@ -240,7 +240,7 @@ Declared license: Apache-2.0
    limitations under the License.
 
 
-@volter/editor-sdk@0.5.57
+@volter/editor-sdk@0.5.58
 Declared license: Apache-2.0
 
 --- packages/editor-sdk/LICENSE ---
@@ -461,7 +461,7 @@ The project output-root policy is Apache-2.0, transferred from the original
 SDK; its exact source is recorded in provenance/editor-server.json.
 
 
-@volter/editor-threejs@0.5.57
+@volter/editor-threejs@0.5.58
 Declared license: AGPL-3.0-only AND Apache-2.0
 
 --- packages/editor-threejs/LICENSE ---

package/dist-server/packaged.mjs

@@ -80769,7 +80769,9 @@ import { brotliDecompressSync } from "node:zlib";
 var BLENDER_WASM_FILES = [
   "blender_browser.js",
   "blender_browser.wasm",
-  "blender_browser.data"
+  "blender_browser.data",
+  "essentials.json",
+  "essentials.bin"
 ];
 var BLENDER_WALI_ARTIFACT = "blender.wasm";
 var BLENDER_WALI_RUNTIME = "runtime";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/editor-core",
   "author": "Volter AI, Inc.",
-  "version": "0.5.57",
+  "version": "0.5.58",
   "publishConfig": {
     "access": "public"
   },
@@ -82,9 +82,9 @@
     "three.quarks": "0.16.0",
     "typescript": "5.9.3",
     "zod": "4.3.6",
-    "@volter/editor-project": "0.5.57",
-    "@volter/editor-sdk": "0.5.57",
-    "@volter/editor-threejs": "0.5.57",
+    "@volter/editor-project": "0.5.58",
+    "@volter/editor-sdk": "0.5.58",
+    "@volter/editor-threejs": "0.5.58",
     "vite": "^6.4.3",
     "express": "^5.2.1",
     "chokidar": "^5.0.0",

package/server/blender-wasm-artifact.ts

@@ -61,11 +61,13 @@ import { brotliDecompressSync } from 'node:zlib';
 
 export type BlenderSkew = 'emscripten' | 'wali';
 
-/** The three files the Emscripten runtime asks for, by the names the glue uses. */
+/** Engine artifacts plus the separately packaged Essentials asset payload. */
 export const BLENDER_WASM_FILES = [
   'blender_browser.js',
   'blender_browser.wasm',
   'blender_browser.data',
+  'essentials.json',
+  'essentials.bin',
 ] as const;
 
 export type BlenderWasmFile = (typeof BLENDER_WASM_FILES)[number];

package/src/action-registry.ts

@@ -211,14 +211,14 @@ export function buildStaticActions(
       label: 'Duplicate',
       category: 'action',
       shortcut: shortcutFor('edit.duplicate'),
-      execute: () => void duplicateSelection(store),
+      execute: () => duplicateSelection(store),
     },
     {
       id: 'editor.delete',
       label: 'Delete Selected',
       category: 'action',
       shortcut: shortcutFor('edit.delete'),
-      execute: () => void deleteSelection(store),
+      execute: () => deleteSelection(store),
     },
     {
       id: 'editor.select-all',

package/src/authoring/consumer-actions.ts

@@ -320,6 +320,17 @@ export function duplicateAuthoringNode(
   );
 }
 
+export function duplicateManyAuthoringNodes(
+  adapter: AuthoringAdapter,
+  nodeIds: readonly string[],
+): StructuralWriteOutcome {
+  const provider = adapter.structure;
+  if (!provider?.duplicateMany) return;
+  return structureWrite(adapter, 'duplicateMany',
+    `the editor duplicated ${nodeIds.length} selected node(s) as one operation`,
+    () => provider.duplicateMany?.(nodeIds));
+}
+
 export function reparentAuthoringNode(
   adapter: AuthoringAdapter,
   nodeId: string,

package/src/command-listener.ts

@@ -139,6 +139,7 @@ import {
   createAuthoringNode,
   cutAuthoringNodes,
   duplicateAuthoringNode,
+  duplicateManyAuthoringNodes,
   groupAuthoringNodes,
   pasteAuthoringNodes,
   removeAuthoringNode,
@@ -1943,6 +1944,10 @@ export async function handleCommand(
             return { ok: true, data: { write } };
           }
           case 'duplicate': {
+            if (ids.length > 1 && structure.duplicateMany) {
+              const write = await duplicateManyAuthoringNodes(adapter, ids);
+              return { ok: true, data: { write } };
+            }
             const copy = duplicateAuthoringNode(adapter, needsId());
             return { ok: true, data: { id: copy.id, write: await copy.ack } };
           }

package/src/editor-host-door.ts

@@ -38,6 +38,10 @@ import { setFilesProvider } from './files/file-provider';
 import { projectFiles } from './files/project-files';
 import {
   onHistoryElement,
+  invalidateHistoryResources,
+  onHistoryInvalidated,
+  notifyHistoryDelegateChanged,
+  emitHistoryElement,
   recordedHistoryElements,
   setHistoryDelegate,
   setHistoryDocumentResolver,
@@ -332,8 +336,12 @@ export function installEditorHostDoor(): void {
     // keyed by the document's own file; `history-service.ts` stays the
     // RECORDER and stops deciding which entry is next.
     history: {
+      record: emitHistoryElement,
       setDelegate: setHistoryDelegate,
       onElement: onHistoryElement,
+      invalidate: invalidateHistoryResources,
+      onInvalidated: onHistoryInvalidated,
+      changed: notifyHistoryDelegateChanged,
       elements: recordedHistoryElements,
       focusedResource: () => {
         const document = activeWorkspaceDocument();

package/src/editor-hotkeys.ts

@@ -3,6 +3,7 @@ import {
   copyAuthoringNodes,
   cutAuthoringNodes,
   duplicateAuthoringNode,
+  duplicateManyAuthoringNodes,
   groupAuthoringNodes,
   pasteAuthoringNodes,
   removeAuthoringNode,
@@ -216,7 +217,21 @@ async function runDuplicateSelection(store: EditorShellStore): Promise<void> {
       ? (adapter.hierarchy.node(selection[0] as string)?.label ?? 'selection')
       : `${selection.length} objects`;
   showTransientHint(`Duplicating ${label}…`);
-  for (const id of selection) await duplicateAuthoringNode(adapter, id).ack;
+  if (structure.duplicateMany) {
+    const ack = await duplicateManyAuthoringNodes(adapter, selection);
+    if (ack && !ack.persisted) {
+      showTransientHint(ack.destination);
+      return;
+    }
+  } else {
+    for (const id of selection) {
+      const ack = await duplicateAuthoringNode(adapter, id).ack;
+      if (ack && !ack.persisted) {
+        showTransientHint(ack.destination);
+        return;
+      }
+    }
+  }
   showTransientHint(`Duplicated ${label}`);
 }
 

package/src/frame/bridge.tsx

@@ -200,15 +200,19 @@ export interface VgaiKeyboardHandle {
 export interface VgaiHistoryHandle {
   elements(): readonly VgaiHistoryElementHandle[];
   onElement(listener: (element: VgaiHistoryElementHandle) => void): () => void;
+  onInvalidated(listener: (resources: readonly string[]) => void): () => void;
+  changed(): void;
   focusedResource(): string | null;
   focusedDocument(): { id: string; label: string } | null;
   /** Hand the frame's OWN undo to the editor, so its Edit menu, palette and
    *  `vgai eval` reach the one stack instead of a cursor nobody drives. */
   setDelegate(delegate: {
-    undo(): void;
-    redo(): void;
+    undo(): void | boolean | Promise<void | boolean>;
+    redo(): void | boolean | Promise<void | boolean>;
     canUndo(): boolean;
     canRedo(): boolean;
+    undoLabel?(): string | null;
+    redoLabel?(): string | null;
   }): void;
   report(level: 'warn' | 'error', message: string): void;
 }
@@ -1181,6 +1185,8 @@ export async function mountEditor(next: VscodeParts): Promise<{
   const history: VgaiHistoryHandle = {
     elements: () => editorHost().history.elements(),
     onElement: (listener) => editorHost().history.onElement(listener),
+    onInvalidated: (listener) => editorHost().history.onInvalidated(listener),
+    changed: () => editorHost().history.changed(),
     focusedResource: () => editorHost().history.focusedResource(),
     // The document's TITLE is what a refusal should say ("Nothing to undo in
     // MainScene"), and the id is what scopes the stack; both come from the

package/src/history/history-delegate.ts

@@ -80,10 +80,12 @@ export interface HistoryElement {
  * is worse than one that is absent.
  */
 export interface HistoryDelegate {
-  undo(): void;
-  redo(): void;
+  undo(): void | boolean | Promise<void | boolean>;
+  redo(): void | boolean | Promise<void | boolean>;
   canUndo(): boolean;
   canRedo(): boolean;
+  undoLabel?(): string | null;
+  redoLabel?(): string | null;
 }
 
 let delegate: HistoryDelegate | null = null;
@@ -93,6 +95,7 @@ let delegate: HistoryDelegate | null = null;
 let documentResolver: (() => string | null) | null = null;
 const ownerListeners = new Set<() => void>();
 const elementListeners = new Set<(element: HistoryElement) => void>();
+const invalidationListeners = new Set<(resources: readonly string[]) => void>();
 /** Everything recorded while a delegate was installed, so a LATE subscriber
  *  (the bridge mounts after the editor's first edits are possible) can catch
  *  up rather than start with a stack that is missing its beginning. */
@@ -131,16 +134,24 @@ export function subscribeHistoryDelegate(listener: () => void): () => void {
   return () => ownerListeners.delete(listener);
 }
 
+export function notifyHistoryDelegateChanged(): void {
+  for (const listener of ownerListeners) listener();
+}
+
 /**
  * Offer one committed transaction to the frame. Recorded even before the
  * delegate arrives — that buffer is what lets a frame that mounts after the
  * editor's first edits push what it missed, in order, rather than start with a
  * stack missing its beginning.
  */
-export function emitHistoryElement(element: Omit<HistoryElement, 'document'>): void {
-  const stamped: HistoryElement = { ...element, document: documentResolver?.() ?? null };
+export function emitHistoryElement(element: Omit<HistoryElement, 'document'> & { document?: string | null }): void {
+  const stamped: HistoryElement = {
+    ...element,
+    document: element.document === undefined ? documentResolver?.() ?? null : element.document,
+  };
   recorded.push(stamped);
   for (const listener of elementListeners) listener(stamped);
+  for (const listener of ownerListeners) listener();
 }
 
 /** Install the reader of "which document is active". Called once by the host
@@ -161,3 +172,16 @@ export function onHistoryElement(listener: (element: HistoryElement) => void): (
   elementListeners.add(listener);
   return () => elementListeners.delete(listener);
 }
+
+/** A native document was replaced or its snapshot owner was closed. */
+export function invalidateHistoryResources(resources: readonly string[]): void {
+  const expired = new Set(resources);
+  recorded = recorded.filter(element => !element.resources.some(path => expired.has(path)));
+  for (const listener of invalidationListeners) listener(resources);
+  for (const listener of ownerListeners) listener();
+}
+
+export function onHistoryInvalidated(listener: (resources: readonly string[]) => void): () => void {
+  invalidationListeners.add(listener);
+  return () => invalidationListeners.delete(listener);
+}

package/src/history/history-service.ts

@@ -1,4 +1,4 @@
-import { emitHistoryElement, historyDelegate, historyDelegateInstalled } from './history-delegate';
+import { emitHistoryElement, historyDelegate, historyDelegateInstalled, subscribeHistoryDelegate } from './history-delegate';
 import { PersistenceCoordinator } from './persistence-coordinator';
 import { ResourceRegistry } from './resource-registry';
 import { SnapshotStore } from './snapshot-store';
@@ -236,6 +236,7 @@ export class HistoryService {
   private droppedTotal = 0;
   private executionTail: Promise<void> = Promise.resolve();
   private publicSnapshot: HistorySnapshot;
+  private readonly unsubscribeOwner: () => void;
 
   constructor(options: HistoryServiceOptions = {}) {
     this.registry = options.registry ?? new ResourceRegistry();
@@ -257,6 +258,7 @@ export class HistoryService {
       throw new Error('History limits must be positive.');
     }
     this.publicSnapshot = this.buildSnapshot();
+    this.unsubscribeOwner = subscribeHistoryDelegate(() => this.notify());
   }
 
   subscribe = (listener: () => void): (() => void) => {
@@ -265,7 +267,17 @@ export class HistoryService {
     return () => this.listeners.delete(listener);
   };
 
-  getSnapshot = (): HistorySnapshot => this.publicSnapshot;
+  getSnapshot = (): HistorySnapshot => {
+    // Focus may move between documents without changing any history entry.
+    // Keep the external-store snapshot stable unless the native answer changes.
+    if (historyDelegateInstalled()) {
+      const next = this.buildSnapshot();
+      if (next.canUndo !== this.publicSnapshot.canUndo || next.canRedo !== this.publicSnapshot.canRedo ||
+          next.undoLabel !== this.publicSnapshot.undoLabel || next.redoLabel !== this.publicSnapshot.redoLabel)
+        this.publicSnapshot = next;
+    }
+    return this.publicSnapshot;
+  };
 
   subscribeCommits(listener: (transaction: HistoryTransaction) => void): () => void {
     this.assertNotDisposed();
@@ -447,15 +459,18 @@ export class HistoryService {
    * ONE stack instead of walking a cursor nobody is driving. A frame that has
    * not installed its undo yet gets a named refusal rather than silence.
    */
-  private delegateOrRefuse(direction: 'undo' | 'redo'): boolean {
+  private async delegateOrRefuse(direction: 'undo' | 'redo'): Promise<boolean> {
     const delegate = historyDelegate();
     if (delegate) {
       // A handled keyboard command is not evidence that history moved. In
       // particular, a native document may have no entry on Code-OSS's stack.
       if (!(direction === 'undo' ? delegate.canUndo() : delegate.canRedo())) return false;
-      if (direction === 'undo') delegate.undo();
-      else delegate.redo();
-      return true;
+      try {
+        const moved = direction === 'undo' ? await delegate.undo() : await delegate.redo();
+        return moved !== false;
+      } finally {
+        this.notify();
+      }
     }
     this.lastErrorValue = historyError(
       'busy',
@@ -634,6 +649,7 @@ export class HistoryService {
   dispose(): void {
     if (this.disposeRequested) return;
     this.disposeRequested = true;
+    this.unsubscribeOwner();
     this.listeners.clear();
     this.commitListeners.clear();
     this.finishDisposeIfIdle();
@@ -1162,8 +1178,8 @@ export class HistoryService {
       canRedo: historyDelegateInstalled()
         ? (historyDelegate()?.canRedo() ?? false)
         : idle && !!redo && redo.status !== 'expired' && !this.blockedValue,
-      undoLabel: undo?.label ?? null,
-      redoLabel: redo?.label ?? null,
+      undoLabel: historyDelegateInstalled() ? historyDelegate()?.undoLabel?.() ?? null : undo?.label ?? null,
+      redoLabel: historyDelegateInstalled() ? historyDelegate()?.redoLabel?.() ?? null : redo?.label ?? null,
       uniqueSnapshotBytes: this.snapshots.uniqueByteLength,
       lastError: this.lastErrorValue,
       limitWarning: this.limitWarningValue,