@viji-dev/core 0.5.4 → 0.5.5

package/dist/{index-_PbbZgmh.js → index-DsJxKERc.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-aU6UPupF.js").then((n) => n.e);
+        const wasmModule = await import("./essentia-wasm.web-C58CPq4U.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) {
@@ -6181,15 +6181,24 @@ class OnsetTapManager {
   muteChangeListeners = /* @__PURE__ */ new Set();
   /**
    * Record a tap on `instrument`. Drives the visual envelope, advances
-   * `lastTapTime`, and (by default) feeds the pattern-recognition pipeline.
+   * `lastTapTime`, flips mode to reflect activity, and (by default) feeds
+   * the pattern-recognition pipeline.
    *
-   * `options.skipRecognition: true` retains the visual side and session-timer
-   * scheduling but bypasses the recognition pipeline (no `tapIOIs` push,
-   * no `tryRecognizePattern`, no `applyPattern`, no `handlePatternTap`).
-   * Mode stays whatever it was. Useful for host-side relay of forwarded
-   * controller-tap messages where another instance is doing the
-   * authoritative recognition. The `MIN_TAP_INTERVAL_MS` debounce still
-   * applies (visual rate-limit).
+   * `options.skipRecognition: true` opts the tap out of the **recognition
+   * pipeline only** — `tapIOIs` accumulation, `tryRecognizePattern`,
+   * `applyPattern`, and `handlePatternTap` are skipped. Mode still flips
+   * `'auto' → 'tapping'` on the first tap of a session (already-`'tapping'`
+   * stays; already-`'pattern'` stays). This is load-bearing: `processFrame`'s
+   * drain of `pendingTapEvents` and its audio-event filter both gate on
+   * mode being non-`'auto'`, and downstream consumers (`onModeChange`
+   * listeners, `broadcastOnsetState`) read mode as the signal that a tap
+   * session is in progress. Suppressing the mode flip would silently break
+   * all of them.
+   *
+   * Used for host-side relay of forwarded tap messages where another
+   * instance owns the authoritative recognition (e.g. host receiving
+   * controller taps over WebRTC). The `MIN_TAP_INTERVAL_MS` debounce still
+   * applies regardless of `skipRecognition`.
    */
   tap(instrument, options) {
     const s = this.state[instrument];
@@ -6218,7 +6227,12 @@ class OnsetTapManager {
     s.pendingTapEvents.push(now);
     s.sessionActive = true;
     this.scheduleSessionTimers(instrument);
-    if (skipRecognition) return;
+    if (skipRecognition) {
+      if (s.mode === "auto") {
+        this.setMode(instrument, "tapping");
+      }
+      return;
+    }
     if (s.mode === "auto") {
       this.setMode(instrument, "tapping");
       if (ioi > 0) {
@@ -8525,9 +8539,12 @@ class AudioSystem {
   // ═══════════════════════════════════════════════════════════
   /**
    * Record a tap for the specified instrument onset.
-   * `options.skipRecognition` retains visual envelope + session timing but
-   * bypasses the recognition pipeline — used by host-side relay of forwarded
-   * tap messages where another core is doing the authoritative recognition.
+   * `options.skipRecognition` opts the tap out of the recognition pipeline
+   * only (no IOI accumulation, no `tryRecognizePattern`, no `applyPattern`).
+   * Mode still flips `'auto' → 'tapping'` so the visual envelope and
+   * audio-event filter run; only the pattern-detection pipeline is bypassed.
+   * Used by host-side relay of forwarded tap messages where another core
+   * owns the authoritative recognition.
    */
   tapOnset(instrument, options) {
     this.onsetTapManager.tap(instrument, options);
@@ -11139,13 +11156,17 @@ class VijiCore {
        * First tap switches the instrument from auto to tapping mode.
        * If a repeating pattern is recognized, it continues after tapping stops.
        *
-       * `options.skipRecognition: true` keeps the visual envelope and session
-       * timing but bypasses pattern recognition entirely (no IOI accumulation,
-       * no mode transition, no `applyPattern`, no `handlePatternTap`). Use
-       * this when relaying tap messages from another instance that owns the
-       * authoritative recognition (e.g. host receiving forwarded controller
-       * taps over WebRTC). The receiving core's mode is then driven only by
-       * `importSessionState` from the authoritative sender.
+       * `options.skipRecognition: true` opts the tap out of the **recognition
+       * pipeline only** — no `tapIOIs` accumulation, no `tryRecognizePattern`,
+       * no `applyPattern`, no `handlePatternTap`. Mode still flips
+       * `'auto' → 'tapping'` on the first tap of a session (and back to
+       * `'auto'` on the 5s timeout). The mode flip is load-bearing for
+       * `processFrame`'s drain of `pendingTapEvents`, the audio-event filter
+       * that prevents music+tap doubling, and `onModeChange` consumers. Use
+       * `skipRecognition` when relaying tap messages from another instance
+       * that owns the authoritative recognition (e.g. host receiving
+       * controller taps over WebRTC); the receiving core's pattern is then
+       * driven only by `importSessionState` from the authoritative sender.
        *
        * The `MIN_TAP_INTERVAL_MS` debounce still applies regardless of the
        * `skipRecognition` flag.
@@ -11702,7 +11723,7 @@ function validateCoreStatePayload(state) {
   }
   return null;
 }
-const VERSION = "0.5.4";
+const VERSION = "0.5.5";
 export {
   AudioSystem as A,
   VERSION as V,
@@ -11710,4 +11731,4 @@ export {
   VijiCoreError as b,
   getDefaultExportFromCjs as g
 };
-//# sourceMappingURL=index-_PbbZgmh.js.map
+//# sourceMappingURL=index-DsJxKERc.js.map