@volter/editor-live 0.5.93 → 0.5.95

package/BUNDLED_NOTICES

@@ -3,9 +3,9 @@ Bundled license notices
 These notices accompany code incorporated into this package. Separate npm dependencies retain their own licenses.
 
 
-@volter/editor-project@0.5.93
+@volter/editor-project@0.5.95
 Declared license: Apache-2.0
-Source: the unmodified npm package @volter/editor-project@0.5.93, from https://github.com/volter-ai/editor.git
+Source: the unmodified npm package @volter/editor-project@0.5.95, from https://github.com/volter-ai/editor.git
 
 --- packages/editor-project/LICENSE ---
 
@@ -213,9 +213,9 @@ Source: the unmodified npm package @volter/editor-project@0.5.93, from https://g
    limitations under the License.
 
 
-@volter/editor-sdk@0.5.93
+@volter/editor-sdk@0.5.95
 Declared license: Apache-2.0
-Source: the unmodified npm package @volter/editor-sdk@0.5.93, from https://github.com/volter-ai/editor.git
+Source: the unmodified npm package @volter/editor-sdk@0.5.95, from https://github.com/volter-ai/editor.git
 
 --- packages/editor-sdk/LICENSE ---
 

package/dist/editor.d.ts

@@ -1,6 +1,6 @@
 /** Editor and document automation over the shared session command wire.
  * Modeling executes in the editor tab; this client owns no model state. */
-import type { ActiveDocumentCapture, AssetKind, AssetPreviewCapture, AssetPreviewOptions, AssetPreviewShotSetDefinition, AssetPreviewSource, CaptureDimensions, DocumentLookOutcome, EditorChromeCapture, EditorChromeCaptureOptions, EditorClient, EditorState, EditorView, EditorWorkspaceName, HistoryStep, InspectedFieldWrite, InspectedHierarchy, InspectedInspection, LabeledShotSetCapture, OpenedDocument, PresentedEditorView, ShadingMode, StructureOp, StructureOpOptions, StructureOpResult, ViewPreset, ViewportCapture } from '@volter/editor-sdk';
+import type { ActiveDocumentCapture, AssetKind, AssetPreviewCapture, AssetPreviewOptions, AssetPreviewShotSetDefinition, AssetPreviewSource, CaptureDimensions, DocumentLookOutcome, StageFrameCostReading, EditorChromeCapture, EditorChromeCaptureOptions, EditorClient, EditorState, EditorView, EditorWorkspaceName, HistoryStep, InspectedFieldWrite, InspectedHierarchy, InspectedInspection, LabeledShotSetCapture, OpenedDocument, PresentedEditorView, ShadingMode, StructureOp, StructureOpOptions, StructureOpResult, ViewPreset, ViewportCapture } from '@volter/editor-sdk';
 import { LiveEditorDocument } from './editor-document.js';
 /** A panel `showPanel` can focus: the viewport tabs, the console, the build
  *  surface, or any key the editor's own static-panel registry holds
@@ -144,6 +144,17 @@ export declare class LiveEditor {
         readonly seconds?: number;
         readonly revolutions?: number;
     }): Promise<DocumentLookOutcome>;
+    /**
+     * What a frame of the open 3D document's stage costs when nothing caps it: `frames` of the
+     * stage's own frame back to back, each waited out on the GPU (median, p95, min ms), the canvas
+     * with its device pixel ratio, what was drawn after culling against what the scene holds, and
+     * the draw mode. `stage` names another stage by its id (a split's second area,
+     * `<documentId>#area-2`).
+     */
+    frameCost(options?: {
+        readonly frames?: number;
+        readonly stage?: string;
+    }): Promise<StageFrameCostReading>;
     view(preset: ViewPreset): Promise<void>;
     /**
      * Switch the editor's NAMED WORKSPACE — `await editor.workspace('model')`.

package/dist/index.js

@@ -291,6 +291,10 @@ var EditorClient = class {
   async orbitDocument(options) {
     return this.command({ type: "document-orbit", ...options });
   }
+  /** What a frame of a 3D document's stage costs, uncapped (`document-frame-cost`). */
+  async frameCostDocument(options) {
+    return this.command({ type: "document-frame-cost", ...options });
+  }
   /** A slow full revolution around the open document's subject, at a constant rate. */
   async turntableDocument(options) {
     return this.command({ type: "document-turntable", ...options });
@@ -1472,6 +1476,16 @@ var LiveEditor = class {
   async turntable(options) {
     return this.#client.turntableDocument(options);
   }
+  /**
+   * What a frame of the open 3D document's stage costs when nothing caps it: `frames` of the
+   * stage's own frame back to back, each waited out on the GPU (median, p95, min ms), the canvas
+   * with its device pixel ratio, what was drawn after culling against what the scene holds, and
+   * the draw mode. `stage` names another stage by its id (a split's second area,
+   * `<documentId>#area-2`).
+   */
+  async frameCost(options) {
+    return this.#client.frameCostDocument(options);
+  }
   async view(preset) {
     await this.#client.viewPreset(preset);
   }
@@ -1542,6 +1556,10 @@ var LiveEditor = class {
   }
   /** `kind` inferred from `path`'s extension when omitted (`inferAssetKind`) — pass it explicitly to override. */
   async openAsset(path, kind) {
+    if (kind === void 0 && path.toLowerCase().endsWith(".blend"))
+      throw new Error(
+        `${path} is a Blender Model document, not an asset: open it with editor.open("document:model:${path}").`
+      );
     await this.#client.openAsset(path, kind ?? inferAssetKind(path));
   }
   /**