@volter/editor-sdk 0.5.57 → 0.5.59

package/package.json

@@ -2,7 +2,7 @@
   "name": "@volter/editor-sdk",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.57",
+  "version": "0.5.59",
   "publishConfig": {
     "access": "public"
   },
@@ -70,7 +70,7 @@
     "typescript": "^5.6.0",
     "undici": "^7.28.0",
     "zod": "^4.3.6",
-    "@volter/editor-project": "0.5.57",
+    "@volter/editor-project": "0.5.59",
     "@types/node": "^22.0.0"
   },
   "peerDependencies": {

package/src/client.ts

@@ -471,6 +471,11 @@ export class EditorClient {
     await this.command({ type: 'play' });
   }
 
+  /** Refuse shutdown if a document cannot be saved. Does not stop the server. */
+  async prepareClose(): Promise<void> {
+    await this.command({ type: 'session-prepare-close' });
+  }
+
   /** Stops play, and finalizes this run's recording before the surface it was
    *  photographing is torn down. The capture is absent when nothing recorded. */
   async stop(): Promise<{ recording?: GameplayRecordingCapture }> {

package/src/host.ts

@@ -563,6 +563,9 @@ export interface EditorHostSession {
    * A lane that owns a worker, a socket or a device ends it here.
    */
   onEnded(fn: () => void): () => void;
+  /** Save before an explicit session close, while HTTP and the relay are live.
+   * Rejection cancels close; onEnded remains forced resource teardown. */
+  onBeforeClose(fn: () => Promise<void>): () => void;
   /**
    * PUBLISH (or retract, with null) THIS LANE'S OUT-OF-PROCESS WORKER METER, so
    * the tab census carries it out on the heartbeat — the one channel that still
@@ -894,13 +897,18 @@ export interface EditorHostHistoryElement {
  */
 /** The frame's own undo, for every editor affordance that is not a chord. */
 export interface EditorHostHistoryDelegate {
-  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;
 }
 
 export interface EditorHostHistory {
+  /** Record a native document edit in the workbench's existing history.
+   * The document owns restoration; the frame owns ordering and shortcuts. */
+  record(element: EditorHostHistoryElement): void;
   /**
    * Install the frame's own undo as the one stack. Called once its service
    * exists, which is AFTER the editor mounts.
@@ -919,6 +927,11 @@ export interface EditorHostHistory {
    * already possible, so it pushes what it missed first, in order.
    */
   onElement(listener: (element: EditorHostHistoryElement) => void): () => void;
+  /** Discard history for replaced/closed native documents, never ordinary edits. */
+  invalidate(resources: readonly string[]): void;
+  onInvalidated(listener: (resources: readonly string[]) => void): () => void;
+  /** The workbench finished moving its own stack (including keyboard commands). */
+  changed(): void;
   /** Everything recorded so far, oldest first. */
   elements(): readonly EditorHostHistoryElement[];
   /**

package/src/session/command-table.ts

@@ -114,6 +114,7 @@ const alwaysRefresh = (timeoutMs = DEFAULT_RELAY_COMMAND_TIMEOUT_MS): RelayComma
  * Rows without an explicit budget take {@link DEFAULT_RELAY_COMMAND_TIMEOUT_MS}.
  */
 export const RELAY_COMMANDS = {
+  'session-prepare-close': noDerivedRefresh(120_000),
   // ---- Selection and framing ---------------------------------------------
   select: noDerivedRefresh(30_000),
   'select-multiple': noDerivedRefresh(),