@viji-dev/core 0.5.3 → 0.5.5

package/dist/index.d.ts

@@ -441,9 +441,17 @@ export declare class AudioSystem {
      */
     getChannelCount(): number;
     /**
-     * Record a tap for the specified instrument onset
-     */
-    tapOnset(instrument: InstrumentType): void;
+     * Record a tap for the specified instrument onset.
+     * `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: InstrumentType, options?: {
+        skipRecognition?: boolean;
+    }): void;
     /**
      * Clear tap pattern for an instrument, restoring auto-detection
      */
@@ -467,7 +475,9 @@ export declare class AudioSystem {
     onOnsetModeChange(listener: (ev: OnsetModeChangeEvent) => void): Unsubscribe;
     onOnsetSessionEnd(listener: (ev: OnsetSessionEndEvent) => void): Unsubscribe;
     onOnsetMuteChange(listener: (ev: OnsetMuteChangeEvent) => void): Unsubscribe;
-    exportOnsetSessionState(): SerializedOnsetState;
+    exportOnsetSessionState(options?: {
+        instruments?: ReadonlyArray<InstrumentType>;
+    }): SerializedOnsetState;
     importOnsetSessionState(state: SerializedOnsetState, clockOffset: number): void;
     exportAudioAnalysisState(): SerializedAudioAnalysisState;
     importAudioAnalysisState(state: SerializedAudioAnalysisState, clockOffset: number): void;
@@ -2244,7 +2254,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.5.3";
+export declare const VERSION = "0.5.5";
 
 /**
  * Real-time video API: drawable frame, dimensions, and the source-side
@@ -3015,8 +3025,25 @@ export declare class VijiCore {
              * Tap an onset for a specific instrument.
              * First tap switches the instrument from auto to tapping mode.
              * If a repeating pattern is recognized, it continues after tapping stops.
+             *
+             * `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.
              */
-            tap: (instrument: "kick" | "snare" | "hat") => void;
+            tap: (instrument: "kick" | "snare" | "hat", options?: {
+                skipRecognition?: boolean;
+            }) => void;
             /**
              * Clear the tap pattern for an instrument, restoring auto-detection
              */
@@ -3095,8 +3122,22 @@ export declare class VijiCore {
              * Cross-device-safe (no audio analysis state included). Pair with
              * `importSessionState` on a receiver. Wall-clock fields are in this
              * instance's `performance.now()` clock space.
+             *
+             * `options.instruments` scopes the snapshot to the listed instruments
+             * only; omitted instruments are absent from the payload. The receiver
+             * leaves its existing state for those instruments untouched (the
+             * receiver's `applyInstrumentPayload` skips missing keys). Default =
+             * all three.
+             *
+             * Cross-device commits should typically scope to the just-completed
+             * instrument (e.g. `exportSessionState({ instruments: [ev.instrument] })`
+             * inside an `onSessionEnd` handler) so the receiver's unrelated
+             * instrument state isn't inadvertently overwritten by the sender's
+             * default values.
              */
-            exportSessionState: () => SerializedOnsetState;
+            exportSessionState: (options?: {
+                instruments?: ReadonlyArray<"kick" | "snare" | "hat">;
+            }) => SerializedOnsetState;
             /**
              * Replace per-instrument onset state from a serialized payload.
              * `clockOffset` is added to all sender-clocked fields during import

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A, V, a, b } from "./index-Bhq4eJe_.js";
+import { A, V, a, b } from "./index-DsJxKERc.js";
 export {
   A as AudioSystem,
   V as VERSION,

package/package.json

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