@viji-dev/core 0.3.16 → 0.3.18

package/dist/{index-CcPOjcNA.js → index-BSQyI1F-.js}

@@ -7,9 +7,10 @@ class VijiCoreError extends Error {
   }
 }
 class IFrameManager {
-  constructor(hostContainer, initialResolution) {
+  constructor(hostContainer, initialResolution, visible = true) {
     this.hostContainer = hostContainer;
     this.isHeadless = !hostContainer;
+    this.initiallyVisible = visible;
     if (typeof initialResolution === "object") {
       this.explicitResolution = initialResolution;
     } else if (typeof initialResolution === "number") {
@@ -49,6 +50,7 @@ class IFrameManager {
   activeTouchIds = /* @__PURE__ */ new Set();
   // Device sensor support
   deviceSensorCallback = null;
+  initiallyVisible;
   /**
    * Creates a secure IFrame with proper sandbox attributes
    */
@@ -71,7 +73,8 @@ class IFrameManager {
         document.body.appendChild(hiddenContainer);
         hiddenContainer.appendChild(iframe);
       } else {
-        iframe.style.cssText = "width:100%;height:100%;border:none;display:block;";
+        const visibility = this.initiallyVisible ? "" : "visibility:hidden;";
+        iframe.style.cssText = `width:100%;height:100%;border:none;display:block;${visibility}`;
         this.hostContainer.appendChild(iframe);
       }
       const iframeContent = this.generateIFrameHTML();
@@ -286,6 +289,16 @@ class IFrameManager {
   get element() {
     return this.iframe;
   }
+  show() {
+    if (this.iframe && !this.isHeadless) {
+      this.iframe.style.visibility = "visible";
+    }
+  }
+  hide() {
+    if (this.iframe && !this.isHeadless) {
+      this.iframe.style.visibility = "hidden";
+    }
+  }
   /**
    * Generates the HTML content for the secure IFrame
    */
@@ -551,7 +564,7 @@ class IFrameManager {
 }
 function WorkerWrapper(options) {
   return new Worker(
-    "" + new URL("assets/viji.worker-Cu6zt4AH.js", import.meta.url).href,
+    "" + new URL("assets/viji.worker-BnDb6mPh.js", import.meta.url).href,
     {
       type: "module",
       name: options?.name
@@ -1900,7 +1913,7 @@ class EssentiaOnsetDetection {
     this.initPromise = (async () => {
       try {
         const essentiaModule = await import("./essentia.js-core.es-DnrJE0uR.js");
-        const wasmModule = await import("./essentia-wasm.web-BfRYq8Vx.js").then((n) => n.e);
+        const wasmModule = await import("./essentia-wasm.web-yEo8eq6n.js").then((n) => n.e);
         const EssentiaClass = essentiaModule.Essentia || essentiaModule.default?.Essentia || essentiaModule.default;
         let WASMModule = wasmModule.default || wasmModule.EssentiaWASM || wasmModule.default?.EssentiaWASM;
         if (!WASMModule) {
@@ -14636,7 +14649,6 @@ class VijiCore {
    * Enable auto-capture with optional format (internal, called by linkFrameSources)
    */
   enableAutoCapture(format) {
-    if (this.autoCaptureEnabled) return;
     this.autoCaptureEnabled = true;
     if (this.workerManager) {
       this.workerManager.postMessage("enable-auto-capture", {
@@ -14695,6 +14707,21 @@ class VijiCore {
   getDebugMode() {
     return this.debugMode;
   }
+  /**
+   * Show the core's iframe (make it visible in the host container).
+   * No-op for headless cores.
+   */
+  show() {
+    this.iframeManager?.show();
+  }
+  /**
+   * Hide the core's iframe (keep rendering but invisible).
+   * Useful for create-in-background, reveal-when-ready patterns.
+   * No-op for headless cores.
+   */
+  hide() {
+    this.iframeManager?.hide();
+  }
   /**
    * Select audio analysis backend
    */
@@ -14725,7 +14752,8 @@ class VijiCore {
       }
       this.iframeManager = new IFrameManager(
         this.config.hostContainer || null,
-        this.config.resolution
+        this.config.resolution,
+        this.config.visible ?? true
       );
       await this.iframeManager.createSecureIFrame();
       const offscreenCanvas = await this.createCanvasWithRetry();
@@ -15181,26 +15209,59 @@ class VijiCore {
       timestamp: performance.now()
     });
   }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // Direct Frame Injection API (Compositor Pipeline)
+  // ═══════════════════════════════════════════════════════════════════════════
   /**
-   * Inject frames directly (compositor pipeline)
+   * Worker-side stream index offset for direct frame slots.
+   * Accounts for main video stream and additional media streams.
    */
-  injectFrames(bitmaps) {
+  get directFrameStartIndex() {
+    return (this.videoStream ? 1 : 0) + this.videoStreams.length;
+  }
+  /**
+   * Ensure the worker has enough direct frame slots prepared.
+   * Auto-grows as needed; skips if already sufficient.
+   */
+  ensureDirectFrameSlots(count) {
+    if (count <= this.directFrameSlots) return;
+    this.directFrameSlots = count;
+    this.workerManager.postMessage("video-streams-prepare", {
+      mainStream: !!this.videoStream,
+      mediaStreamCount: this.videoStreams.length,
+      directFrameCount: count
+    });
+    this.debugLog(`[Compositor] Prepared ${count} direct frame slot(s)`);
+  }
+  /**
+   * Inject a single frame into a specific direct-frame stream slot.
+   * Allows independent per-stream updates (e.g. during source hot-swap).
+   * Auto-prepares slots as needed. Transfers ownership of the bitmap (zero-copy).
+   */
+  injectFrame(bitmap, streamIndex) {
     if (!this.workerManager?.ready) {
       throw new VijiCoreError("Core not ready", "NOT_READY");
     }
-    const directFrameStartIndex = (this.videoStream ? 1 : 0) + this.videoStreams.length;
-    if (this.directFrameSlots === 0) {
-      this.directFrameSlots = bitmaps.length;
-      this.workerManager.postMessage("video-streams-prepare", {
-        mainStream: !!this.videoStream,
-        mediaStreamCount: this.videoStreams.length,
-        directFrameCount: bitmaps.length
-      });
+    this.ensureDirectFrameSlots(streamIndex + 1);
+    this.workerManager.postMessage("video-frame-direct", {
+      imageBitmap: bitmap,
+      streamIndex: this.directFrameStartIndex + streamIndex,
+      timestamp: performance.now()
+    }, [bitmap]);
+  }
+  /**
+   * Inject frames for all direct-frame stream slots at once (compositor pipeline).
+   * Auto-prepares slots on first call. Transfers ownership of all bitmaps (zero-copy).
+   */
+  injectFrames(bitmaps) {
+    if (!this.workerManager?.ready) {
+      throw new VijiCoreError("Core not ready", "NOT_READY");
     }
+    this.ensureDirectFrameSlots(bitmaps.length);
     bitmaps.forEach((bitmap, index) => {
       this.workerManager.postMessage("video-frame-direct", {
         imageBitmap: bitmap,
-        streamIndex: directFrameStartIndex + index,
+        streamIndex: this.directFrameStartIndex + index,
         timestamp: performance.now()
       }, [bitmap]);
     });
@@ -16191,6 +16252,7 @@ class VijiCore {
       this.latestFrameBuffer.close();
       this.latestFrameBuffer = null;
     }
+    this.directFrameSlots = 0;
     this.videoStream = null;
     this.videoStreams = [];
     await this.cleanup();
@@ -16258,4 +16320,4 @@ export {
   VijiCoreError as b,
   getDefaultExportFromCjs as g
 };
-//# sourceMappingURL=index-CcPOjcNA.js.map
+//# sourceMappingURL=index-BSQyI1F-.js.map