@viji-dev/core 0.5.3 → 0.5.4

package/dist/index.d.ts

@@ -441,9 +441,14 @@ export declare class AudioSystem {
      */
     getChannelCount(): number;
     /**
-     * Record a tap for the specified instrument onset
+     * 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.
      */
-    tapOnset(instrument: InstrumentType): void;
+    tapOnset(instrument: InstrumentType, options?: {
+        skipRecognition?: boolean;
+    }): void;
     /**
      * Clear tap pattern for an instrument, restoring auto-detection
      */
@@ -467,7 +472,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 +2251,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.4";
 
 /**
  * Real-time video API: drawable frame, dimensions, and the source-side
@@ -3015,8 +3022,21 @@ 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` 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.
+             *
+             * 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 +3115,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-_PbbZgmh.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.4",
   "description": "Universal execution engine for Viji Creative scenes",
   "type": "module",
   "main": "./dist/index.js",