@viji-dev/core 0.5.1 → 0.5.3

package/dist/{index-Cqh1k_49.js → index-Bhq4eJe_.js}

@@ -1897,7 +1897,7 @@ class EssentiaOnsetDetection {
     this.initPromise = (async () => {
       try {
         const essentiaModule = await import("./essentia.js-core.es-DnrJE0uR.js");
-        const wasmModule = await import("./essentia-wasm.web-x6zu4Vib.js").then((n) => n.e);
+        const wasmModule = await import("./essentia-wasm.web-CPrFAj59.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) {
@@ -6178,13 +6178,14 @@ class OnsetTapManager {
   };
   modeChangeListeners = /* @__PURE__ */ new Set();
   sessionEndListeners = /* @__PURE__ */ new Set();
-  suppressEmissions = false;
+  muteChangeListeners = /* @__PURE__ */ new Set();
   tap(instrument) {
     const s = this.state[instrument];
     const now = performance.now();
     if (s.muted) {
       s.muted = false;
       s.mutedAt = 0;
+      this.fireMuteChange({ instrument, prevMuted: true, muted: false });
     }
     let ioi = -1;
     if (s.lastTapTime > 0) {
@@ -6221,6 +6222,7 @@ class OnsetTapManager {
   }
   clear(instrument) {
     const s = this.state[instrument];
+    const prevMuted = s.muted;
     this.cancelSessionTimers(s);
     s.sessionActive = false;
     this.setMode(instrument, "auto");
@@ -6236,6 +6238,9 @@ class OnsetTapManager {
     s.pendingTapEvents = [];
     s.envelope.reset();
     s.envelopeSmoothed.reset();
+    if (prevMuted) {
+      this.fireMuteChange({ instrument, prevMuted: true, muted: false });
+    }
   }
   getMode(instrument) {
     return this.state[instrument].mode;
@@ -6252,6 +6257,7 @@ class OnsetTapManager {
   setMuted(instrument, muted) {
     const s = this.state[instrument];
     if (s.muted === muted) return;
+    const prevMuted = s.muted;
     const now = performance.now();
     if (muted) {
       s.muted = true;
@@ -6264,6 +6270,7 @@ class OnsetTapManager {
         s.lastTapTime += pauseDuration;
       }
     }
+    this.fireMuteChange({ instrument, prevMuted, muted: s.muted });
   }
   isMuted(instrument) {
     return this.state[instrument].muted;
@@ -6283,6 +6290,12 @@ class OnsetTapManager {
       this.sessionEndListeners.delete(listener);
     };
   }
+  onMuteChange(listener) {
+    this.muteChangeListeners.add(listener);
+    return () => {
+      this.muteChangeListeners.delete(listener);
+    };
+  }
   // ─────────────────────────────────────────────────────────────────────────
   // State serialization
   // ─────────────────────────────────────────────────────────────────────────
@@ -6312,22 +6325,22 @@ class OnsetTapManager {
    * is older than one pattern period (phase-preserving — events still land on
    * the original beat positions modulo `patternSum`).
    *
-   * Mutation is synchronous; no events are emitted (state replacement is not
-   * a transition). Throws nothing — malformed payloads should be filtered by
-   * the caller via the `version` field.
+   * Mutation is synchronous. Field-level events (`onModeChange`,
+   * `onMuteChange`) fire when an imported value differs from the current one
+   * — consumer-visible state is consistent with what polling would have
+   * observed. Session-boundary events (`onSessionEnd`) do NOT fire on
+   * import; imports are state replacement, not session boundaries.
+   *
+   * Throws nothing — malformed payloads should be filtered by the caller
+   * via the `version` field.
    */
   importSessionState(state, clockOffset) {
     if (state.version !== STATE_SCHEMA_VERSION) return;
-    this.suppressEmissions = true;
-    try {
-      const now = performance.now();
-      for (const inst of INSTRUMENTS) {
-        const payload = state.instruments[inst];
-        if (!payload) continue;
-        this.applyInstrumentPayload(inst, payload, clockOffset, now);
-      }
-    } finally {
-      this.suppressEmissions = false;
+    const now = performance.now();
+    for (const inst of INSTRUMENTS) {
+      const payload = state.instruments[inst];
+      if (!payload) continue;
+      this.applyInstrumentPayload(inst, payload, clockOffset, now);
     }
   }
   /**
@@ -6464,18 +6477,16 @@ class OnsetTapManager {
   // Private helpers
   // ---------------------------------------------------------------------------
   /**
-   * Single mutation point for `s.mode`. Fires `onModeChange` (when not
-   * suppressed) so listeners stay consistent regardless of which code path
-   * triggered the transition.
+   * Single mutation point for `s.mode`. Fires `onModeChange` so listeners
+   * stay consistent regardless of which code path triggered the transition
+   * (including imports, which fire via `applyInstrumentPayload` directly).
    */
   setMode(instrument, newMode) {
     const s = this.state[instrument];
     const prevMode = s.mode;
     if (prevMode === newMode) return;
     s.mode = newMode;
-    if (!this.suppressEmissions) {
-      this.fireModeChange({ instrument, prevMode, newMode });
-    }
+    this.fireModeChange({ instrument, prevMode, newMode });
   }
   fireModeChange(ev) {
     for (const listener of this.modeChangeListeners) {
@@ -6495,6 +6506,15 @@ class OnsetTapManager {
       }
     }
   }
+  fireMuteChange(ev) {
+    for (const listener of this.muteChangeListeners) {
+      try {
+        listener(ev);
+      } catch (err) {
+        console.error("Error in onMuteChange listener:", err);
+      }
+    }
+  }
   /**
    * Schedule (or reschedule) the per-instrument session timers on every tap.
    * 500ms timer fires `'pattern'` outcome if instrument is in pattern mode at
@@ -6585,6 +6605,8 @@ class OnsetTapManager {
   }
   applyInstrumentPayload(instrument, payload, clockOffset, now) {
     const s = this.state[instrument];
+    const prevMode = s.mode;
+    const prevMuted = s.muted;
     this.cancelSessionTimers(s);
     s.sessionActive = false;
     const translatedReplayLast = payload.replayLastEventTime !== null ? payload.replayLastEventTime + clockOffset : 0;
@@ -6601,7 +6623,6 @@ class OnsetTapManager {
         }
       }
     }
-    s.mode;
     s.mode = payload.mode;
     s.muted = payload.muted;
     s.mutedAt = translatedMutedAt;
@@ -6615,6 +6636,12 @@ class OnsetTapManager {
     s.pendingTapEvents = [];
     s.envelope.reset();
     s.envelopeSmoothed.reset();
+    if (s.mode !== prevMode) {
+      this.fireModeChange({ instrument, prevMode, newMode: s.mode });
+    }
+    if (s.muted !== prevMuted) {
+      this.fireMuteChange({ instrument, prevMuted, muted: s.muted });
+    }
   }
   /**
    * Handle a tap that arrives while already in pattern mode.
@@ -8515,6 +8542,9 @@ class AudioSystem {
   onOnsetSessionEnd(listener) {
     return this.onsetTapManager.onSessionEnd(listener);
   }
+  onOnsetMuteChange(listener) {
+    return this.onsetTapManager.onMuteChange(listener);
+  }
   // ─────────────────────────────────────────────────────────────────────────
   // State serialization. Onset-only export is cross-device-safe; the full
   // audio block is for same-process scene-switch transfer (sender's audio
@@ -10641,8 +10671,12 @@ class VijiCore {
   /**
    * Replace the audio analysis + onset state from a serialized payload.
    * `clockOffset` is added to all sender-clocked fields (`0` for same-process,
-   * NTP-derived for cross-device). Mutation is synchronous; no `onModeChange`
-   * or `onSessionEnd` events are emitted (state replacement is not a transition).
+   * NTP-derived for cross-device). Mutation is synchronous.
+   *
+   * Field-level events (`onModeChange`, `onMuteChange`) fire when imported
+   * values differ from current — consumer-visible state stays consistent
+   * with what polling would have observed. Session-boundary events
+   * (`onSessionEnd`) do NOT fire on import.
    *
    * Validates `version`; on mismatch, fires `onStateImportError` and leaves
    * existing state intact.
@@ -11118,9 +11152,13 @@ class VijiCore {
       },
       /**
        * Listen for instrument mode transitions (`'auto' | 'tapping' | 'pattern'`).
-       * Fires on every transition including the first tap (`'auto' → 'tapping'`)
-       * and pattern recognition (`'tapping' → 'pattern'`). Imported state does
-       * NOT fire mode-change events — state replacement is not a transition.
+       * Fires whenever the underlying mode field actually changes, regardless
+       * of which code path triggered it — first tap (`'auto' → 'tapping'`),
+       * pattern recognition (`'tapping' → 'pattern'`), the 5s tap timeout
+       * (`'tapping' → 'auto'`), explicit `clear()`, or `importSessionState`
+       * landing a different mode value.
+       *
+       * Idempotent transitions (already in target mode) do not fire.
        *
        * @returns Unsubscribe function. Call to remove the listener.
        */
@@ -11130,14 +11168,20 @@ class VijiCore {
         });
       },
       /**
-       * Listen for natural session-end events. Fires when:
+       * Listen for natural session-end events. Fires only on natural session
+       * boundaries:
        * - 500ms elapse since last tap with instrument in `'pattern'` mode
        *   (outcome `'pattern'`), or
        * - 5s elapse in `'tapping'` mode without a recognized pattern
        *   (outcome `'cleared'`; instrument transitions to `'auto'`).
        *
-       * Explicit `clear()` calls do NOT fire this event (caller-initiated;
-       * caller already knows). Imported state does NOT fire either.
+       * Does NOT fire on:
+       * - Explicit `clear()` calls (caller-initiated; not a natural boundary).
+       * - `importSessionState` (state replacement; not a session boundary).
+       *
+       * Field-change events (`onModeChange`, `onMuteChange`) fire on imports
+       * when fields differ; this event does not because session-end is a
+       * different category — about session lifecycle, not field state.
        *
        * @returns Unsubscribe function. Call to remove the listener.
        */
@@ -11146,6 +11190,25 @@ class VijiCore {
         return this.audioSystem?.onOnsetSessionEnd(listener) ?? (() => {
         });
       },
+      /**
+       * Listen for instrument mute-state transitions (`true ↔ false`). Fires
+       * whenever the underlying mute field actually changes, regardless of
+       * which code path triggered it:
+       * - `setMuted(instrument, muted)` when `prev !== next`.
+       * - `tap(instrument)` auto-unmute on first tap of a muted instrument.
+       * - `clear(instrument)` when the instrument was muted at call time.
+       * - `importSessionState` landing a different muted value.
+       *
+       * Idempotent calls (e.g. `setMuted(true)` on an already-muted instrument)
+       * do not fire.
+       *
+       * @returns Unsubscribe function. Call to remove the listener.
+       */
+      onMuteChange: (listener) => {
+        this.validateReady();
+        return this.audioSystem?.onOnsetMuteChange(listener) ?? (() => {
+        });
+      },
       /**
        * Snapshot per-instrument onset state for cross-instance transfer.
        * Cross-device-safe (no audio analysis state included). Pair with
@@ -11164,7 +11227,12 @@ class VijiCore {
        * Replace per-instrument onset state from a serialized payload.
        * `clockOffset` is added to all sender-clocked fields during import
        * (use `0` for same-process transfer; NTP-derived offset for cross-device).
-       * Mutation is synchronous; no events are emitted.
+       * Mutation is synchronous.
+       *
+       * Field-level events fire when imported values differ from current:
+       * `onModeChange` if the imported mode is different, `onMuteChange` if
+       * the imported muted state is different. Session-boundary events
+       * (`onSessionEnd`) do NOT fire — imports aren't session boundaries.
        *
        * Patterns are rebased forward by whole pattern cycles to eliminate
        * the catch-up burst that would otherwise occur on stale payloads
@@ -11581,7 +11649,7 @@ function validateCoreStatePayload(state) {
   }
   return null;
 }
-const VERSION = "0.5.1";
+const VERSION = "0.5.3";
 export {
   AudioSystem as A,
   VERSION as V,
@@ -11589,4 +11657,4 @@ export {
   VijiCoreError as b,
   getDefaultExportFromCjs as g
 };
-//# sourceMappingURL=index-Cqh1k_49.js.map
+//# sourceMappingURL=index-Bhq4eJe_.js.map