@viji-dev/core 0.11.1 → 0.11.3

package/dist/{index-D7BA9Ry-.js → index-BzkVQgrq.js}

@@ -1518,7 +1518,7 @@ class YB {
     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-D1B5j3cM.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-D54RUgg3.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");
@@ -8825,7 +8825,12 @@ class QA {
   }
   /** Remove an external device and drop its remote-analysis state. */
   removeExternalDevice(A) {
-    this.clearDeviceAudio(A), this.clearDeviceVideo(A), this.lastAnalysisSeq.delete(`${A}:cv`), this.deviceRegistry.remove(A);
+    this.beginConnectivityEdge();
+    try {
+      this.clearDeviceAudio(A), this.clearDeviceVideo(A), this.lastAnalysisSeq.delete(`${A}:cv`), this.deviceRegistry.remove(A);
+    } finally {
+      this.endConnectivityEdge();
+    }
   }
   /** Host-UI device list (id/name/index). */
   getConnectedDevices() {
@@ -8982,13 +8987,23 @@ class QA {
    * deviceId. Returns the stream index.
    */
   setDeviceVideo(A, B) {
-    const I = this.ensureVideo().setDeviceStream(A, B);
-    return this.deviceVideoIndexToId.set(I, A), this.deviceIdToVideoIndex.set(A, I), I;
+    this.beginConnectivityEdge();
+    try {
+      const I = this.ensureVideo().setDeviceStream(A, B);
+      return this.deviceVideoIndexToId.set(I, A), this.deviceIdToVideoIndex.set(A, I), I;
+    } finally {
+      this.endConnectivityEdge();
+    }
   }
   /** Clear a device video stream and drop its device-CV routing state. */
   clearDeviceVideo(A) {
-    const B = this.deviceIdToVideoIndex.get(A);
-    this.videoEngine?.clearDeviceStream(A), B !== void 0 && (this.deviceVideoIndexToId.delete(B), this.deviceIdToVideoIndex.delete(A), this.deviceCVDesired.delete(B), this.deviceCVApplied.delete(B), this.deviceCVResults.delete(B));
+    this.beginConnectivityEdge();
+    try {
+      const B = this.deviceIdToVideoIndex.get(A);
+      this.videoEngine?.clearDeviceStream(A), B !== void 0 && (this.deviceVideoIndexToId.delete(B), this.deviceIdToVideoIndex.delete(A), this.deviceCVDesired.delete(B), this.deviceCVApplied.delete(B), this.deviceCVResults.delete(B));
+    } finally {
+      this.endConnectivityEdge();
+    }
   }
   hasDeviceVideo(A) {
     return this.videoEngine?.hasDeviceStream(A) ?? !1;
@@ -9054,12 +9069,17 @@ class QA {
     if (I === void 0) {
       if (this.deviceRemoteAudioIndices.size >= QA.MAX_DEVICE_AUDIO_CHANNELS)
         return;
-      const Q = /* @__PURE__ */ new Set([
-        ...this.deviceAudioStreamIndices.values(),
-        ...this.deviceRemoteAudioIndices.values()
-      ]);
-      for (I = QA.AUDIO_DEVICE_BASE; Q.has(I); ) I++;
-      this.deviceRemoteAudioIndices.set(A, I), this.ensureAudio().addDeviceAnalysisChannel(I, A);
+      this.beginConnectivityEdge();
+      try {
+        const Q = /* @__PURE__ */ new Set([
+          ...this.deviceAudioStreamIndices.values(),
+          ...this.deviceRemoteAudioIndices.values()
+        ]);
+        for (I = QA.AUDIO_DEVICE_BASE; Q.has(I); ) I++;
+        this.deviceRemoteAudioIndices.set(A, I), this.ensureAudio().addDeviceAnalysisChannel(I, A);
+      } finally {
+        this.endConnectivityEdge();
+      }
     }
     this.ensureAudio().feedDeviceAnalysis(I, B);
   }
@@ -9094,11 +9114,15 @@ class QA {
   }
   // ── Audio stream state (engine-scoped, connectivity-wrapped) ────────────
   setMainAudioStream(A) {
-    const B = this.hasMainAudio;
-    this.mainAudioStream = A, (A || this.audioSystem) && this.ensureAudio().handleAudioStreamUpdate({
-      audioStream: A,
-      timestamp: performance.now()
-    }), B !== this.hasMainAudio && this.notifyConnectivityChange();
+    this.beginConnectivityEdge();
+    try {
+      this.mainAudioStream = A, (A || this.audioSystem) && this.ensureAudio().handleAudioStreamUpdate({
+        audioStream: A,
+        timestamp: performance.now()
+      });
+    } finally {
+      this.endConnectivityEdge();
+    }
   }
   getMainAudioStream() {
     return this.mainAudioStream;
@@ -9106,6 +9130,15 @@ class QA {
   get hasMainAudio() {
     return this.mainAudioStream !== null;
   }
+  /**
+   * Whether ANY audio source is connected — main, additional, device stream,
+   * or remote device analysis. Backs `CoreCapabilities.hasAudio` (parameter
+   * visibility) and the connectivity-edge detection. Distinct from
+   * `hasMainAudio`, which is main-only.
+   */
+  get hasAnyAudio() {
+    return this.mainAudioStream !== null || this.additionalAudioStreams.length > 0 || this.deviceAudioStreamIndices.size > 0 || this.deviceRemoteAudioIndices.size > 0;
+  }
   async addAdditionalAudioStream(A) {
     const B = this.additionalAudioStreams.indexOf(A);
     if (B !== -1) return B;
@@ -9114,34 +9147,54 @@ class QA {
         `Maximum additional audio streams reached (${QA.MAX_ADDITIONAL_AUDIO_STREAMS})`,
         "STREAM_LIMIT_REACHED"
       );
-    this.additionalAudioStreams.push(A);
-    const I = this.additionalAudioStreams.length - 1, Q = QA.AUDIO_ADDITIONAL_BASE + I;
-    return await this.ensureAudio().addStream(Q, A, { streamType: "additional" }), I;
+    this.beginConnectivityEdge();
+    try {
+      this.additionalAudioStreams.push(A);
+      const I = this.additionalAudioStreams.length - 1, Q = QA.AUDIO_ADDITIONAL_BASE + I;
+      return await this.ensureAudio().addStream(Q, A, { streamType: "additional" }), I;
+    } finally {
+      this.endConnectivityEdge();
+    }
   }
   async removeAdditionalAudioStream(A) {
     if (A < 0 || A >= this.additionalAudioStreams.length)
       throw new J(`Invalid audio stream index: ${A}`, "INVALID_INDEX");
-    this.additionalAudioStreams[A].getTracks().forEach((B) => B.stop()), this.additionalAudioStreams.splice(A, 1), this.audioSystem && await this.audioSystem.reinitializeAdditionalChannels(
-      this.additionalAudioStreams,
-      QA.AUDIO_ADDITIONAL_BASE
-    );
+    this.beginConnectivityEdge();
+    try {
+      this.additionalAudioStreams[A].getTracks().forEach((B) => B.stop()), this.additionalAudioStreams.splice(A, 1), this.audioSystem && await this.audioSystem.reinitializeAdditionalChannels(
+        this.additionalAudioStreams,
+        QA.AUDIO_ADDITIONAL_BASE
+      );
+    } finally {
+      this.endConnectivityEdge();
+    }
   }
   getAdditionalAudioStreamCount() {
     return this.additionalAudioStreams.length;
   }
   async setDeviceAudio(A, B) {
-    this.clearDeviceAudio(A);
-    const I = new Set(this.deviceAudioStreamIndices.values());
-    let Q = QA.AUDIO_DEVICE_BASE;
-    for (; I.has(Q); )
-      Q++;
-    return this.deviceAudioStreamIndices.set(A, Q), await this.ensureAudio().addStream(Q, B, { streamType: "device", deviceId: A }), Q;
+    this.beginConnectivityEdge();
+    try {
+      this.clearDeviceAudio(A);
+      const I = new Set(this.deviceAudioStreamIndices.values());
+      let Q = QA.AUDIO_DEVICE_BASE;
+      for (; I.has(Q); )
+        Q++;
+      return this.deviceAudioStreamIndices.set(A, Q), await this.ensureAudio().addStream(Q, B, { streamType: "device", deviceId: A }), Q;
+    } finally {
+      this.endConnectivityEdge();
+    }
   }
   clearDeviceAudio(A) {
-    const B = this.deviceAudioStreamIndices.get(A);
-    B !== void 0 && (this.deviceAudioStreamIndices.delete(A), this.audioSystem?.removeStream(B));
-    const I = this.deviceRemoteAudioIndices.get(A);
-    I !== void 0 && (this.deviceRemoteAudioIndices.delete(A), this.audioSystem?.removeDeviceAnalysisChannel(I)), this.lastAnalysisSeq.delete(`${A}:audio`);
+    this.beginConnectivityEdge();
+    try {
+      const B = this.deviceAudioStreamIndices.get(A);
+      B !== void 0 && (this.deviceAudioStreamIndices.delete(A), this.audioSystem?.removeStream(B));
+      const I = this.deviceRemoteAudioIndices.get(A);
+      I !== void 0 && (this.deviceRemoteAudioIndices.delete(A), this.audioSystem?.removeDeviceAnalysisChannel(I)), this.lastAnalysisSeq.delete(`${A}:audio`);
+    } finally {
+      this.endConnectivityEdge();
+    }
   }
   hasDeviceAudio(A) {
     return this.deviceAudioStreamIndices.has(A) || this.deviceRemoteAudioIndices.has(A);
@@ -9151,8 +9204,34 @@ class QA {
   }
   // ── Video stream state (connectivity-wrapped; mechanics in the engine) ──
   setMainVideoStream(A) {
-    const B = this.hasMainVideo;
-    (A || this.videoEngine) && this.ensureVideo().setMainStream(A), B !== this.hasMainVideo && this.notifyConnectivityChange();
+    this.beginConnectivityEdge();
+    try {
+      (A || this.videoEngine) && this.ensureVideo().setMainStream(A);
+    } finally {
+      this.endConnectivityEdge();
+    }
+  }
+  /**
+   * Add an additional (non-main, non-device) video stream. Routed through the
+   * group (not straight to the engine) so it participates in connectivity-edge
+   * detection, mirroring `addAdditionalAudioStream`. Returns its index.
+   */
+  addAdditionalVideoStream(A) {
+    this.beginConnectivityEdge();
+    try {
+      return this.ensureVideo().addAdditionalStream(A);
+    } finally {
+      this.endConnectivityEdge();
+    }
+  }
+  /** Remove an additional video stream by index (re-indexes the remainder). */
+  removeAdditionalVideoStream(A) {
+    this.beginConnectivityEdge();
+    try {
+      this.ensureVideo().removeAdditionalStream(A);
+    } finally {
+      this.endConnectivityEdge();
+    }
   }
   getMainVideoStream() {
     return this.videoEngine?.getMainStream() ?? null;
@@ -9160,11 +9239,36 @@ class QA {
   get hasMainVideo() {
     return (this.videoEngine?.getMainStream() ?? null) !== null;
   }
+  /**
+   * Whether ANY video source is connected — main, additional, or device
+   * stream. Device CV analysis rides a device video stream (its results are
+   * dropped without one), so `deviceVideoIndexToId` covers it. Backs
+   * `CoreCapabilities.hasVideo` and connectivity-edge detection; distinct from
+   * `hasMainVideo` (main-only).
+   */
+  get hasAnyVideo() {
+    return (this.videoEngine?.getMainStream() ?? null) !== null || (this.videoEngine?.getAdditionalStreamCount() ?? 0) > 0 || this.deviceVideoIndexToId.size > 0;
+  }
   // ── Capability fan-out ──────────────────────────────────────────────────
+  // Aggregate-edge detection. Stream mutators bracket their body with
+  // begin/end; a single fan-out fires only when the OUTERMOST bracket closes
+  // AND an aggregate predicate flipped. The depth counter collapses nested
+  // mutations (e.g. setDeviceAudio → clearDeviceAudio, removeExternalDevice →
+  // both clears) into one notification, and the snapshot/compare suppresses
+  // churn when a 2nd same-kind source connects (aggregate unchanged).
+  connectivityEdgeDepth = 0;
+  edgeAudioBefore = !1;
+  edgeVideoBefore = !1;
+  beginConnectivityEdge() {
+    this.connectivityEdgeDepth++ === 0 && (this.edgeAudioBefore = this.hasAnyAudio, this.edgeVideoBefore = this.hasAnyVideo);
+  }
+  endConnectivityEdge() {
+    --this.connectivityEdgeDepth === 0 && (this.edgeAudioBefore !== this.hasAnyAudio || this.edgeVideoBefore !== this.hasAnyVideo) && this.notifyConnectivityChange();
+  }
   /**
    * Engine connectivity changed: notify ALL attached cores (each fires its
    * own `capabilitiesChangeListeners`). The engine is the single origin —
-   * mutators do not self-notify.
+   * mutators signal aggregate edges via begin/endConnectivityEdge.
    */
   notifyConnectivityChange() {
     for (const A of this.members)
@@ -9687,7 +9791,7 @@ class mA {
       allowUserInteraction: A.allowUserInteraction ?? !this.isHeadless
     }, this.sceneRenderer = tA.detectRendererType(A.sceneCode), this.sceneCapabilities = tA.detectCapabilities(A.sceneCode, this.sceneRenderer), this.sceneRenderer === "p5" && (this.sceneP5CanvasMode = tA.detectP5CanvasMode(A.sceneCode)), this.sceneConsumesAnalysedFrame = tA.detectAnalysedFrameUse(A.sceneCode), A.videoStream && this.engineGroup.setMainVideoStream(A.videoStream);
     for (const Q of A.videoStreams ?? [])
-      this.engineGroup.ensureVideo().addAdditionalStream(Q);
+      this.engineGroup.addAdditionalVideoStream(Q);
     this.currentInteractionEnabled = this.config.allowUserInteraction, A.allowDeviceInteraction && (this.deviceSensorManager = new sI()), this.debugLog(`VijiCore created: ${this.instanceId} (headless: ${this.isHeadless}, sharedEngines: ${!!A.mediaSource})`);
   }
   async captureFrame(A = {}) {
@@ -10096,9 +10200,12 @@ class mA {
   getCapabilities() {
     return {
       // Connectivity lives on the shared engine group: identical for every
-      // attached core, change notifications fan out to all of them.
-      hasAudio: this.engineGroup.hasMainAudio,
-      hasVideo: this.engineGroup.hasMainVideo,
+      // attached core, change notifications fan out to all of them. "Any
+      // source" (main / additional / device stream / remote analysis) so the
+      // audio/video parameter categories light up for controller-fed media,
+      // not just the main stream.
+      hasAudio: this.engineGroup.hasAnyAudio,
+      hasVideo: this.engineGroup.hasAnyVideo,
       hasInteraction: this.currentInteractionEnabled,
       hasGeneral: !0
       // General parameters are always available
@@ -10702,7 +10809,7 @@ class mA {
    * core sharing this core's media engines.
    */
   async addVideoStream(A) {
-    return this.validateReady(), this.engineGroup.ensureVideo().addAdditionalStream(A);
+    return this.validateReady(), this.engineGroup.addAdditionalVideoStream(A);
   }
   /**
    * Removes an additional video stream by index. Stops the stream's tracks.
@@ -10711,7 +10818,7 @@ class mA {
    * ALL cores sharing this core's media engines.
    */
   async removeVideoStream(A) {
-    this.validateReady(), this.engineGroup.ensureVideo().removeAdditionalStream(A);
+    this.validateReady(), this.engineGroup.removeAdditionalVideoStream(A);
   }
   /**
    * Gets the number of additional video streams (engine-scoped).
@@ -11451,7 +11558,7 @@ function JI(D) {
     expectedVersion: 1
   } : typeof A.senderTime != "number" ? { code: "invalid-field", details: "senderTime must be a number", field: "senderTime" } : null;
 }
-const SI = "0.11.1";
+const SI = "0.11.3";
 export {
   yA as A,
   UI as C,
@@ -11461,4 +11568,4 @@ export {
   J as b,
   $B as g
 };
-//# sourceMappingURL=index-D7BA9Ry-.js.map
+//# sourceMappingURL=index-BzkVQgrq.js.map

package/dist/index.d.ts

@@ -993,9 +993,17 @@ export declare type CoordinateValue = {
 };
 
 declare interface CoreCapabilities {
-    /** Audio input is active and connected */
+    /**
+     * Any audio source is connected — main, additional, an external device
+     * stream, or remote device analysis. Drives audio parameter-category
+     * visibility, so controller-fed audio activates it, not just the main stream.
+     */
     hasAudio: boolean;
-    /** Video input is active and connected */
+    /**
+     * Any video source is connected — main, additional, or an external device
+     * stream (device CV analysis rides a device stream). Drives video
+     * parameter-category visibility, not just the main stream.
+     */
     hasVideo: boolean;
     /** User interactions (mouse, touch, keyboard) are enabled */
     hasInteraction: boolean;
@@ -2790,7 +2798,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.1";
+export declare const VERSION = "0.11.3";
 
 /**
  * Real-time video API: drawable frame, dimensions, and the source-side

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as s, C as o, I as E, V as i, a as A, b as C } from "./index-D7BA9Ry-.js";
+import { A as s, C as o, I as E, V as i, a as A, b as C } from "./index-BzkVQgrq.js";
 export {
   s as AudioSystem,
   o as CV_FEATURE_KEYS,

package/package.json

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