@viji-dev/core 0.11.6 → 0.11.7

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.7",
+  "generatedAt": "2026-07-24T15:25:39.379Z",
   "navigation": [
     {
       "id": "getting-started",

package/dist/{essentia-wasm.web-B5WvSGTX.js → essentia-wasm.web-QxZd-8n4.js}

@@ -1,4 +1,4 @@
-import { g as kn } from "./index-BKvsDqj0.js";
+import { g as kn } from "./index-zKfpXJhf.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-QxZd-8n4.js.map

package/dist/{index-BKvsDqj0.js → index-zKfpXJhf.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-BKg5vsqf.js", import.meta.url).href;
 class dB {
   constructor(A, B, I) {
     this.iframeManager = A, this.sceneCode = B, this.init = I;
@@ -1518,7 +1518,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-QxZd-8n4.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 +9834,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 +9863,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 +11631,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.7";
 export {
   eA as A,
   LI as C,
@@ -11635,4 +11642,4 @@ export {
   J as c,
   gI as g
 };
-//# sourceMappingURL=index-BKvsDqj0.js.map
+//# sourceMappingURL=index-zKfpXJhf.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.7";
 
 /**
  * Real-time video API: drawable frame, dimensions, and the source-side
@@ -3291,9 +3301,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-zKfpXJhf.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.7",
   "description": "Universal execution engine for Viji Creative scenes",
   "type": "module",
   "main": "./dist/index.js",