@viji-dev/core 0.5.2 → 0.5.3

package/dist/{index-B8LJ9m47.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-DE6gem4m.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) {
@@ -6179,16 +6179,13 @@ class OnsetTapManager {
   modeChangeListeners = /* @__PURE__ */ new Set();
   sessionEndListeners = /* @__PURE__ */ new Set();
   muteChangeListeners = /* @__PURE__ */ new Set();
-  suppressEmissions = false;
   tap(instrument) {
     const s = this.state[instrument];
     const now = performance.now();
     if (s.muted) {
       s.muted = false;
       s.mutedAt = 0;
-      if (!this.suppressEmissions) {
-        this.fireMuteChange({ instrument, prevMuted: true, muted: false });
-      }
+      this.fireMuteChange({ instrument, prevMuted: true, muted: false });
     }
     let ioi = -1;
     if (s.lastTapTime > 0) {
@@ -6241,7 +6238,7 @@ class OnsetTapManager {
     s.pendingTapEvents = [];
     s.envelope.reset();
     s.envelopeSmoothed.reset();
-    if (prevMuted && !this.suppressEmissions) {
+    if (prevMuted) {
       this.fireMuteChange({ instrument, prevMuted: true, muted: false });
     }
   }
@@ -6273,9 +6270,7 @@ class OnsetTapManager {
         s.lastTapTime += pauseDuration;
       }
     }
-    if (!this.suppressEmissions) {
-      this.fireMuteChange({ instrument, prevMuted, muted: s.muted });
-    }
+    this.fireMuteChange({ instrument, prevMuted, muted: s.muted });
   }
   isMuted(instrument) {
     return this.state[instrument].muted;
@@ -6330,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);
     }
   }
   /**
@@ -6482,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) {
@@ -6612,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;
@@ -6628,7 +6623,6 @@ class OnsetTapManager {
         }
       }
     }
-    s.mode;
     s.mode = payload.mode;
     s.muted = payload.muted;
     s.mutedAt = translatedMutedAt;
@@ -6642,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.
@@ -10671,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.
@@ -11148,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.
        */
@@ -11160,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.
        */
@@ -11178,14 +11192,15 @@ class VijiCore {
       },
       /**
        * Listen for instrument mute-state transitions (`true ↔ false`). Fires
-       * whenever the underlying mute state actually changes, regardless of
-       * which method 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
+       * 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. Imported state does NOT fire either.
+       * do not fire.
        *
        * @returns Unsubscribe function. Call to remove the listener.
        */
@@ -11212,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
@@ -11629,7 +11649,7 @@ function validateCoreStatePayload(state) {
   }
   return null;
 }
-const VERSION = "0.5.2";
+const VERSION = "0.5.3";
 export {
   AudioSystem as A,
   VERSION as V,
@@ -11637,4 +11657,4 @@ export {
   VijiCoreError as b,
   getDefaultExportFromCjs as g
 };
-//# sourceMappingURL=index-B8LJ9m47.js.map
+//# sourceMappingURL=index-Bhq4eJe_.js.map