@volter/editor-live 0.5.93 → 0.5.95

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/editor-live",
   "author": "Volter AI, Inc.",
-  "version": "0.5.93",
+  "version": "0.5.95",
   "publishConfig": {
     "access": "public"
   },
@@ -30,8 +30,8 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@volter/editor-sdk": "0.5.93",
-    "@volter/editor-project": "0.5.93",
+    "@volter/editor-sdk": "0.5.95",
+    "@volter/editor-project": "0.5.95",
     "undici": "^7.28.0"
   },
   "devDependencies": {

package/src/editor.ts

@@ -10,6 +10,7 @@ import type {
   AssetPreviewSource,
   CaptureDimensions,
   DocumentLookOutcome,
+  StageFrameCostReading,
   EditorChromeCapture,
   EditorChromeCaptureOptions,
   EditorClient,
@@ -304,6 +305,17 @@ export class LiveEditor {
     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?: { readonly frames?: number; readonly stage?: string }): Promise<StageFrameCostReading> {
+    return this.#client.frameCostDocument(options);
+  }
+
   async view(preset: ViewPreset): Promise<void> {
     await this.#client.viewPreset(preset);
   }
@@ -387,6 +399,12 @@ export class LiveEditor {
 
   /** `kind` inferred from `path`'s extension when omitted (`inferAssetKind`) — pass it explicitly to override. */
   async openAsset(path: string, kind?: AssetKind): Promise<void> {
+    // A `.blend` is not an asset but a Model document the project's finder lists; opened as an
+    // asset it fell to the extension guess's `json` and showed its bytes.
+    if (kind === undefined && 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));
   }