@nice2dev/ui-audio 0.1.0 → 1.0.2

package/dist/utils/undoRedoUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"undoRedoUtils.d.ts","sourceRoot":"","sources":["../../src/utils/undoRedoUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,wBAAgB,kBAAkB,CAC9B,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,EAClE,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,EAClE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,QAKxE;AAED,wBAAgB,UAAU,CACtB,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,EAClE,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,EAClE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,QASxE;AAED,wBAAgB,UAAU,CACtB,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,EAClE,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,EAClE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,QASxE"}
+{"version":3,"file":"undoRedoUtils.d.ts","sourceRoot":"","sources":["../../src/utils/undoRedoUtils.ts"],"names":[],"mappings":"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"}

package/dist/workers/audioWorkletProcessor.d.ts

@@ -0,0 +1,92 @@
+/**
+ * AudioWorklet Processor — Replaces deprecated ScriptProcessorNode.
+ *
+ * This file contains the AudioWorkletProcessor classes that run in the
+ * audio rendering thread for low-latency, glitch-free audio processing.
+ *
+ * Usage:
+ * 1. Register processor: audioContext.audioWorklet.addModule('audioWorkletProcessor.js')
+ * 2. Create node: new AudioWorkletNode(audioContext, 'nice-processor')
+ *
+ * Note: This code runs in AudioWorkletGlobalScope, not the main thread.
+ */
+export interface AudioWorkletMessage {
+    type: string;
+    payload?: unknown;
+}
+export interface ProcessorOptions {
+    /** FFT size for frequency analysis. */
+    fftSize?: number;
+    /** Smoothing factor for frequency data (0-1). */
+    smoothingTimeConstant?: number;
+    /** Enable pitch detection. */
+    enablePitchDetection?: boolean;
+    /** Enable beat detection. */
+    enableBeatDetection?: boolean;
+    /** Enable RMS level metering. */
+    enableLevelMeter?: boolean;
+    /** Threshold for beat detection (0-1). */
+    beatThreshold?: number;
+}
+export interface AudioAnalysisResult {
+    /** RMS level (0-1). */
+    rms: number;
+    /** Peak level (0-1). */
+    peak: number;
+    /** Detected pitch in Hz (0 if not detected). */
+    pitch: number;
+    /** Pitch confidence (0-1). */
+    pitchConfidence: number;
+    /** Beat detected this frame. */
+    beatDetected: boolean;
+    /** Frequency data (Uint8Array as regular array for transfer). */
+    frequencyData?: number[];
+    /** Time domain data. */
+    timeDomainData?: number[];
+}
+/**
+ * Returns the AudioWorkletProcessor code as a string that can be loaded
+ * via Blob URL when audioWorklet.addModule() is called.
+ */
+export declare function getAudioWorkletProcessorCode(): string;
+/**
+ * Load AudioWorklet module into AudioContext.
+ * Call this once before creating AudioWorkletNodes.
+ */
+export declare function loadAudioWorkletModule(audioContext: AudioContext): Promise<void>;
+/**
+ * Create NiceAudioProcessor node for audio analysis.
+ */
+export declare function createAnalyserNode(audioContext: AudioContext, options?: ProcessorOptions, onAnalysis?: (result: AudioAnalysisResult) => void): AudioWorkletNode;
+/**
+ * Create NiceGainProcessor node for volume control.
+ */
+export declare function createGainNode(audioContext: AudioContext, initialGain?: number): AudioWorkletNode;
+/**
+ * Create NiceCompressorProcessor node for dynamics.
+ */
+export declare function createCompressorNode(audioContext: AudioContext, options?: {
+    threshold?: number;
+    ratio?: number;
+    attack?: number;
+    release?: number;
+    makeupGain?: number;
+}): AudioWorkletNode;
+/**
+ * Create NiceVocoderProcessor node for voice effects.
+ */
+export declare function createVocoderNode(audioContext: AudioContext, options?: {
+    pitchShift?: number;
+    formantShift?: number;
+    mix?: number;
+}): AudioWorkletNode;
+declare const _default: {
+    loadAudioWorkletModule: typeof loadAudioWorkletModule;
+    createAnalyserNode: typeof createAnalyserNode;
+    createGainNode: typeof createGainNode;
+    createCompressorNode: typeof createCompressorNode;
+    createVocoderNode: typeof createVocoderNode;
+    getAudioWorkletProcessorCode: typeof getAudioWorkletProcessorCode;
+};
+export default _default;
+//# sourceMappingURL=audioWorkletProcessor.d.ts.map

package/dist/workers/audioWorkletProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioWorkletProcessor.d.ts","sourceRoot":"","sources":["../../src/workers/audioWorkletProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,8BAA8B;IAC9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,6BAA6B;IAC7B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAChC,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,wBAAwB;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAmBD;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAkVrD;AASD;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBtF;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE,gBAAgB,EAC1B,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,GACnD,gBAAgB,CAclB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,SAAM,GAAG,gBAAgB,CAI9F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE;IACN,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GACF,gBAAgB,CAQlB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE;IACN,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,GACF,gBAAgB,CAMlB;;;;;;;;;AAED,wBAOE"}

package/dist/workers/useAudioWorklet.d.ts

@@ -0,0 +1,82 @@
+import { ProcessorOptions, AudioAnalysisResult } from './audioWorkletProcessor';
+export interface UseAudioWorkletOptions {
+    /** Enable audio analysis (pitch, beat, levels). */
+    enableAnalysis?: boolean;
+    /** Analysis processor options. */
+    analysisOptions?: ProcessorOptions;
+    /** Enable gain control. */
+    enableGain?: boolean;
+    /** Initial gain value (0-2). */
+    initialGain?: number;
+    /** Enable compressor. */
+    enableCompressor?: boolean;
+    /** Compressor settings. */
+    compressorOptions?: {
+        threshold?: number;
+        ratio?: number;
+        attack?: number;
+        release?: number;
+        makeupGain?: number;
+    };
+    /** Enable vocoder/pitch shift. */
+    enableVocoder?: boolean;
+    /** Vocoder settings. */
+    vocoderOptions?: {
+        pitchShift?: number;
+        formantShift?: number;
+        mix?: number;
+    };
+    /** Callback for analysis results. */
+    onAnalysis?: (result: AudioAnalysisResult) => void;
+}
+export interface UseAudioWorkletReturn {
+    /** Whether the worklet module is loaded and ready. */
+    isReady: boolean;
+    /** Error if worklet failed to load. */
+    error: Error | null;
+    /** Current audio analysis results. */
+    analysis: AudioAnalysisResult | null;
+    /** Connect source to worklet chain. */
+    connectSource: (source: AudioNode) => void;
+    /** Disconnect source from worklet chain. */
+    disconnectSource: () => void;
+    /** Get the final output node to connect to destination. */
+    getOutputNode: () => AudioNode | null;
+    /** Set gain value (if enableGain is true). */
+    setGain: (value: number) => void;
+    /** Set compressor parameter (if enableCompressor is true). */
+    setCompressorParam: (param: 'threshold' | 'ratio' | 'attack' | 'release' | 'makeupGain', value: number) => void;
+    /** Set vocoder parameter (if enableVocoder is true). */
+    setVocoderParam: (param: 'pitchShift' | 'formantShift' | 'mix', value: number) => void;
+    /** Audio context being used. */
+    audioContext: AudioContext | null;
+}
+/**
+ * React hook for AudioWorklet-based audio processing.
+ *
+ * @example
+ * ```tsx
+ * function AudioProcessor() {
+ *   const { isReady, analysis, connectSource, setGain } = useAudioWorklet({
+ *     enableAnalysis: true,
+ *     enableGain: true,
+ *     onAnalysis: (result) => console.log('RMS:', result.rms),
+ *   });
+ *
+ *   // Connect microphone
+ *   useEffect(() => {
+ *     if (!isReady) return;
+ *     navigator.mediaDevices.getUserMedia({ audio: true })
+ *       .then(stream => {
+ *         const source = audioContext.createMediaStreamSource(stream);
+ *         connectSource(source);
+ *       });
+ *   }, [isReady]);
+ *
+ *   return <div>RMS: {analysis?.rms.toFixed(3)}</div>;
+ * }
+ * ```
+ */
+export declare function useAudioWorklet(options?: UseAudioWorkletOptions): UseAudioWorkletReturn;
+export default useAudioWorklet;
+//# sourceMappingURL=useAudioWorklet.d.ts.map

package/dist/workers/useAudioWorklet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAudioWorklet.d.ts","sourceRoot":"","sources":["../../src/workers/useAudioWorklet.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAMH,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EAC3B,MAAM,yBAAyB,CAAC;AAMjC,MAAM,WAAW,sBAAsB;IACnC,mDAAmD;IACnD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kCAAkC;IAClC,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,2BAA2B;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2BAA2B;IAC3B,iBAAiB,CAAC,EAAE;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,kCAAkC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wBAAwB;IACxB,cAAc,CAAC,EAAE;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,GAAG,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,qCAAqC;IACrC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,qBAAqB;IAClC,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,sCAAsC;IACtC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrC,uCAAuC;IACvC,aAAa,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAC3C,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,2DAA2D;IAC3D,aAAa,EAAE,MAAM,SAAS,GAAG,IAAI,CAAC;IACtC,8CAA8C;IAC9C,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,8DAA8D;IAC9D,kBAAkB,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChH,wDAAwD;IACxD,eAAe,EAAE,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvF,gCAAgC;IAChC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACrC;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,qBAAqB,CA+K3F;AAED,eAAe,eAAe,CAAC"}

package/dist/workers/useWorker.d.ts

@@ -3,6 +3,7 @@
  * - Lazily creates the worker on first call
  * - Auto-terminates on unmount
  * - Returns an `invoke(data)` function that returns a promise
+ * - Graceful error recovery: rejects pending promises and recreates the worker
  */
 export declare function useWorker<Req extends {
     id: number;

package/dist/workers/useWorker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWorker.d.ts","sourceRoot":"","sources":["../../src/workers/useWorker.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAC9E,OAAO,EAAE,MAAM,MAAM,UA+BZ,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,kBAAkB,YAAY,EAAE,KAAG,OAAO,CAAC,GAAG,CAAC,CAYxE"}
+{"version":3,"file":"useWorker.d.ts","sourceRoot":"","sources":["../../src/workers/useWorker.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAC9E,OAAO,EAAE,MAAM,MAAM,UA6CZ,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,kBAAkB,YAAY,EAAE,KAAG,OAAO,CAAC,GAAG,CAAC,CAYxE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nice2dev/ui-audio",
-  "version": "0.1.0",
+  "version": "1.0.2",
   "description": "Nice2Dev Audio UI — DAW editor, karaoke engine, player, playlist, DMX, music visualizers for React",
   "type": "module",
   "main": "dist/index.cjs",