@viji-dev/core 0.11.6 → 0.11.8

package/dist/docs-api.js

@@ -1,7 +1,7 @@
 export const docsApi = {
   "version": "1.1.0",
-  "coreVersion": "0.11.6",
-  "generatedAt": "2026-07-24T10:51:17.968Z",
+  "coreVersion": "0.11.8",
+  "generatedAt": "2026-08-06T16:39:30.974Z",
   "navigation": [
     {
       "id": "getting-started",

package/dist/{essentia-wasm.web-B5WvSGTX.js → essentia-wasm.web-B48G7Mzk.js}

@@ -1,4 +1,4 @@
-import { g as kn } from "./index-BKvsDqj0.js";
+import { g as kn } from "./index-fdus0y3o.js";
 function jn(Oe, ot) {
   for (var ve = 0; ve < ot.length; ve++) {
     const Z = ot[ve];
@@ -3374,4 +3374,4 @@ const xn = /* @__PURE__ */ kn(yi), Ln = /* @__PURE__ */ jn({
 export {
   Ln as e
 };
-//# sourceMappingURL=essentia-wasm.web-B5WvSGTX.js.map
+//# sourceMappingURL=essentia-wasm.web-B48G7Mzk.js.map

package/dist/{index-BKvsDqj0.js → index-fdus0y3o.js}

@@ -547,7 +547,7 @@ class lB {
       }
   }
 }
-const nB = "" + new URL("assets/viji.worker-Bu5UOGpW.js", import.meta.url).href;
+const nB = "" + new URL("assets/viji.worker-B1ltcEP7.js", import.meta.url).href;
 class dB {
   constructor(A, B, I) {
     this.iframeManager = A, this.sceneCode = B, this.init = I;
@@ -792,6 +792,7 @@ class dB {
             Q
           );
         }
+      else B.data?.bitmap instanceof ImageBitmap && B.data.bitmap.close();
     }, this.iframeManager.onWorkerMessage(this.onWorkerMessageBound);
   }
 }
@@ -1518,7 +1519,7 @@ class HB {
     if (!this.isInitialized)
       return this.initPromise ? this.initPromise : (this.initPromise = (async () => {
         try {
-          const A = await import("./essentia.js-core.es-CC_3Ap1i.js"), B = await import("./essentia-wasm.web-B5WvSGTX.js").then((g) => g.e), I = A.Essentia || A.default?.Essentia || A.default;
+          const A = await import("./essentia.js-core.es-CC_3Ap1i.js"), B = await import("./essentia-wasm.web-B48G7Mzk.js").then((g) => g.e), I = A.Essentia || A.default?.Essentia || A.default;
           let Q = B.default || B.EssentiaWASM || B.default?.EssentiaWASM;
           if (!Q)
             throw new Error("WASM module not found - check essentia-wasm.web.js export");
@@ -9834,7 +9835,8 @@ class rA {
       format: B,
       type: B === "blob" ? A.type : void 0,
       quality: B === "blob" ? A.quality : void 0,
-      resolution: A.resolution
+      resolution: A.resolution,
+      frame: A.frame
     }, 1e4);
     return B === "bitmap" ? I.bitmap : I.blob;
   }
@@ -9862,11 +9864,17 @@ class rA {
   /**
    * Enable auto-capture. Captured frames are retrieved via getLatestFrame().
    * @param format.flipY — true for WebGL texture consumers, false for 2D canvas drawImage.
+   * @param format.frame — frame role: `'plate'` (default) captures the clean
+   * pre-overlay frame (thumbnails, VJ sources); `'display'` captures the
+   * composited frame the viewer sees, including the branding overlay when the
+   * session applies it. Headless cores degrade `'display'` to `'plate'`.
+   * Omitting the field on a re-enable keeps the previously set role.
    */
   enableAutoCapture(A) {
     this.autoCaptureEnabled = !0, this.workerManager && this.workerManager.postMessage("enable-auto-capture", {
       enabled: !0,
-      flipY: A?.flipY
+      flipY: A?.flipY,
+      frame: A?.frame
     });
     const B = A ? ` with flipY=${A.flipY}` : "";
     this.debugLog(`[AutoCapture] ENABLED${B}`);
@@ -11624,7 +11632,7 @@ function HI(D) {
     expectedVersion: 1
   } : typeof A.senderTime != "number" ? { code: "invalid-field", details: "senderTime must be a number", field: "senderTime" } : null;
 }
-const mI = "0.11.6";
+const mI = "0.11.8";
 export {
   eA as A,
   LI as C,
@@ -11635,4 +11643,4 @@ export {
   J as c,
   gI as g
 };
-//# sourceMappingURL=index-BKvsDqj0.js.map
+//# sourceMappingURL=index-fdus0y3o.js.map

package/dist/index.d.ts

@@ -930,6 +930,16 @@ export declare interface CaptureFrameOptions {
      *   canvas, the source is center-cropped before scaling.
      */
     resolution?: number | Resolution;
+    /**
+     * Frame role to capture. `'plate'` (default) captures the clean pre-overlay
+     * frame — thumbnails and VJ source frames, identical to previous behavior.
+     * `'display'` captures the composited frame the viewer sees, including the
+     * branding overlay when the session applies it. On headless cores no
+     * overlay is ever drawn, so `'display'` degrades to `'plate'`. Note:
+     * center-cropping via `resolution` can crop the edge-anchored overlay out
+     * of a `'display'` capture — display captures are intended at canvas aspect.
+     */
+    frame?: 'plate' | 'display';
 }
 
 /**
@@ -2861,7 +2871,7 @@ declare type TrackingState = 'TRACKING' | 'LOCKED' | 'BREAKDOWN' | 'LOST';
 /** Returned by `on*` listener registration calls; invoke to unsubscribe. */
 export declare type Unsubscribe = () => void;
 
-export declare const VERSION = "0.11.6";
+export declare const VERSION = "0.11.8";
 
 /**
  * Real-time video API: drawable frame, dimensions, and the source-side
@@ -3269,6 +3279,21 @@ export declare class VijiCore {
     /**
      * Capture current scene frame
      * @param options.format 'blob' = encoded image, 'bitmap' = GPU-friendly ImageBitmap
+     *
+     * Readiness: the request queues in the worker and drains in the
+     * post-render slot of the first tick where artist drawing code dispatched
+     * cleanly against a canvas with a rendering context. Ticks where the scene
+     * is still in async setup, a shader is compiling, p5 is initializing, or
+     * the render threw are skipped — so `captureFrame` right after
+     * `initialize()` waits for the scene's first real frame instead of
+     * snapshotting a pre-first-paint canvas. The gate is per-tick, not
+     * latched: on a live scene whose render is transiently throwing, the
+     * capture holds until the next clean tick. This is an engine-readiness
+     * gate, not a content guarantee — pixel output is never inspected, so a
+     * scene whose render runs but draws nothing (or draws black) captures
+     * exactly that. A scene that never reaches a clean painted tick (broken
+     * code, render throwing persistently) rejects with `MESSAGE_TIMEOUT`
+     * after 10s.
      */
     captureFrame(options: {
         format: 'bitmap';
@@ -3291,9 +3316,15 @@ export declare class VijiCore {
     /**
      * Enable auto-capture. Captured frames are retrieved via getLatestFrame().
      * @param format.flipY — true for WebGL texture consumers, false for 2D canvas drawImage.
+     * @param format.frame — frame role: `'plate'` (default) captures the clean
+     * pre-overlay frame (thumbnails, VJ sources); `'display'` captures the
+     * composited frame the viewer sees, including the branding overlay when the
+     * session applies it. Headless cores degrade `'display'` to `'plate'`.
+     * Omitting the field on a re-enable keeps the previously set role.
      */
     enableAutoCapture(format?: {
         flipY: boolean;
+        frame?: 'plate' | 'display';
     }): void;
     /**
      * Disable auto-capture and release any pending frame buffer.

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as e, C as i, I as r, V as o, a as C, c as E, b as A } from "./index-BKvsDqj0.js";
+import { A as e, C as i, I as r, V as o, a as C, c as E, b as A } from "./index-fdus0y3o.js";
 export {
   e as AudioSystem,
   i as CV_FEATURE_KEYS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viji-dev/core",
-  "version": "0.11.6",
+  "version": "0.11.8",
   "description": "Universal execution engine for Viji Creative scenes",
   "type": "module",
   "main": "./dist/index.js",