@waveform-playlist/recording 9.5.2 → 10.1.0

package/dist/index.d.mts

@@ -1,5 +1,4 @@
 import { ClipTrack } from '@waveform-playlist/core';
-import React from 'react';
 
 /**
  * Types for the recording package
@@ -89,7 +88,8 @@ declare function useMicrophoneAccess(): UseMicrophoneAccessReturn;
 /**
  * Hook for monitoring microphone input levels
  *
- * Uses Tone.js Meter for real-time audio level monitoring.
+ * Uses an AudioWorklet-based meter processor for sample-accurate
+ * peak and RMS metering without requestAnimationFrame overhead.
  */
 interface UseMicrophoneLevelOptions {
     /**
@@ -98,45 +98,61 @@ interface UseMicrophoneLevelOptions {
      */
     updateRate?: number;
     /**
-     * FFT size for the analyser
-     * Default: 256
+     * Number of channels to meter (1 = mono, 2 = stereo)
+     * Default: 1
      */
-    fftSize?: number;
-    /**
-     * Smoothing time constant (0-1)
-     * Higher values = smoother but slower response
-     * Default: 0.8
-     */
-    smoothingTimeConstant?: number;
+    channelCount?: number;
 }
 interface UseMicrophoneLevelReturn {
     /**
-     * Current audio level (0-1)
-     * 0 = silence, 1 = maximum level
+     * Current peak audio level (0-1)
+     * For single channel: channel 0 level
+     * For multi-channel: max across all channels
      */
     level: number;
     /**
-     * Peak level since last reset (0-1)
+     * Held peak level since last reset (0-1)
+     * For single channel: channel 0 peak
+     * For multi-channel: max across all channels
      */
     peakLevel: number;
     /**
-     * Reset the peak level
+     * Reset the held peak level
      */
     resetPeak: () => void;
+    /**
+     * Per-channel peak levels (0-1). Array length matches channelCount.
+     * True peak: max absolute sample value per analysis frame.
+     */
+    levels: number[];
+    /**
+     * Per-channel held peak levels (0-1). Array length matches channelCount.
+     */
+    peakLevels: number[];
+    /**
+     * Per-channel RMS levels (0-1). Array length matches channelCount.
+     * RMS: root mean square of samples per analysis frame.
+     */
+    rmsLevels: number[];
+    /**
+     * Error from meter setup (worklet load failure, context issues, etc.)
+     * Null when metering is working normally.
+     */
+    error: Error | null;
 }
 /**
  * Monitor microphone input levels in real-time
  *
  * @param stream - MediaStream from getUserMedia
  * @param options - Configuration options
- * @returns Object with current level and peak level
+ * @returns Object with current peak level, RMS level, and held peak level
  *
  * @example
  * ```typescript
  * const { stream } = useMicrophoneAccess();
- * const { level, peakLevel, resetPeak } = useMicrophoneLevel(stream);
+ * const { levels, rmsLevels, peakLevels } = useMicrophoneLevel(stream, { channelCount: 2 });
  *
- * return <VUMeter level={level} peakLevel={peakLevel} />;
+ * return <SegmentedVUMeter levels={levels} peakLevels={peakLevels} />;
  * ```
  */
 declare function useMicrophoneLevel(stream: MediaStream | null, options?: UseMicrophoneLevelOptions): UseMicrophoneLevelReturn;
@@ -174,6 +190,12 @@ interface UseIntegratedRecordingReturn {
     duration: number;
     level: number;
     peakLevel: number;
+    /** Per-channel peak levels (0-1). Array length matches channelCount. */
+    levels: number[];
+    /** Per-channel held peak levels (0-1). Array length matches channelCount. */
+    peakLevels: number[];
+    /** Per-channel RMS levels (0-1). Array length matches channelCount. */
+    rmsLevels: number[];
     error: Error | null;
     stream: MediaStream | null;
     devices: MicrophoneDevice[];
@@ -189,78 +211,6 @@ interface UseIntegratedRecordingReturn {
 }
 declare function useIntegratedRecording(tracks: ClipTrack[], setTracks: (tracks: ClipTrack[]) => void, selectedTrackId: string | null, options?: IntegratedRecordingOptions): UseIntegratedRecordingReturn;
 
-/**
- * RecordButton - Control button for starting/stopping recording
- */
-
-interface RecordButtonProps {
-    isRecording: boolean;
-    onClick: () => void;
-    disabled?: boolean;
-    className?: string;
-}
-declare const RecordButton: React.FC<RecordButtonProps>;
-
-/**
- * MicrophoneSelector - Dropdown for selecting microphone input device
- */
-
-interface MicrophoneSelectorProps {
-    devices: MicrophoneDevice[];
-    selectedDeviceId?: string;
-    onDeviceChange: (deviceId: string) => void;
-    disabled?: boolean;
-    className?: string;
-}
-declare const MicrophoneSelector: React.FC<MicrophoneSelectorProps>;
-
-/**
- * RecordingIndicator - Shows recording status, duration, and visual indicator
- */
-
-interface RecordingIndicatorProps {
-    isRecording: boolean;
-    isPaused?: boolean;
-    duration: number;
-    formatTime?: (seconds: number) => string;
-    className?: string;
-}
-declare const RecordingIndicator: React.FC<RecordingIndicatorProps>;
-
-/**
- * VU Meter Component
- *
- * Displays real-time audio input levels with color-coded zones
- * and peak indicator.
- */
-
-interface VUMeterProps {
-    /**
-     * Current audio level (0-1)
-     */
-    level: number;
-    /**
-     * Peak level (0-1)
-     * Optional - if provided, shows peak indicator
-     */
-    peakLevel?: number;
-    /**
-     * Width of the meter in pixels
-     * Default: 200
-     */
-    width?: number;
-    /**
-     * Height of the meter in pixels
-     * Default: 20
-     */
-    height?: number;
-    /**
-     * Additional CSS class name
-     */
-    className?: string;
-}
-declare const VUMeter: React.NamedExoticComponent<VUMeterProps>;
-
 /**
  * Peak generation for real-time waveform visualization during recording
  * Matches the format used by webaudio-peaks: min/max pairs with bit depth
@@ -288,4 +238,4 @@ declare function concatenateAudioData(chunks: Float32Array[]): Float32Array;
  */
 declare function createAudioBuffer(audioContext: AudioContext, channelData: Float32Array[] | Float32Array, sampleRate: number, channelCount?: number): AudioBuffer;
 
-export { type IntegratedRecordingOptions, type MicrophoneDevice, MicrophoneSelector, type MicrophoneSelectorProps, RecordButton, type RecordButtonProps, type RecordingData, RecordingIndicator, type RecordingIndicatorProps, type RecordingOptions, type RecordingState, type UseIntegratedRecordingReturn, type UseMicrophoneAccessReturn, type UseMicrophoneLevelOptions, type UseMicrophoneLevelReturn, type UseRecordingReturn, VUMeter, type VUMeterProps, concatenateAudioData, createAudioBuffer, generatePeaks, useIntegratedRecording, useMicrophoneAccess, useMicrophoneLevel, useRecording };
+export { type IntegratedRecordingOptions, type MicrophoneDevice, type RecordingData, type RecordingOptions, type RecordingState, type UseIntegratedRecordingReturn, type UseMicrophoneAccessReturn, type UseMicrophoneLevelOptions, type UseMicrophoneLevelReturn, type UseRecordingReturn, concatenateAudioData, createAudioBuffer, generatePeaks, useIntegratedRecording, useMicrophoneAccess, useMicrophoneLevel, useRecording };

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 import { ClipTrack } from '@waveform-playlist/core';
-import React from 'react';
 
 /**
  * Types for the recording package
@@ -89,7 +88,8 @@ declare function useMicrophoneAccess(): UseMicrophoneAccessReturn;
 /**
  * Hook for monitoring microphone input levels
  *
- * Uses Tone.js Meter for real-time audio level monitoring.
+ * Uses an AudioWorklet-based meter processor for sample-accurate
+ * peak and RMS metering without requestAnimationFrame overhead.
  */
 interface UseMicrophoneLevelOptions {
     /**
@@ -98,45 +98,61 @@ interface UseMicrophoneLevelOptions {
      */
     updateRate?: number;
     /**
-     * FFT size for the analyser
-     * Default: 256
+     * Number of channels to meter (1 = mono, 2 = stereo)
+     * Default: 1
      */
-    fftSize?: number;
-    /**
-     * Smoothing time constant (0-1)
-     * Higher values = smoother but slower response
-     * Default: 0.8
-     */
-    smoothingTimeConstant?: number;
+    channelCount?: number;
 }
 interface UseMicrophoneLevelReturn {
     /**
-     * Current audio level (0-1)
-     * 0 = silence, 1 = maximum level
+     * Current peak audio level (0-1)
+     * For single channel: channel 0 level
+     * For multi-channel: max across all channels
      */
     level: number;
     /**
-     * Peak level since last reset (0-1)
+     * Held peak level since last reset (0-1)
+     * For single channel: channel 0 peak
+     * For multi-channel: max across all channels
      */
     peakLevel: number;
     /**
-     * Reset the peak level
+     * Reset the held peak level
      */
     resetPeak: () => void;
+    /**
+     * Per-channel peak levels (0-1). Array length matches channelCount.
+     * True peak: max absolute sample value per analysis frame.
+     */
+    levels: number[];
+    /**
+     * Per-channel held peak levels (0-1). Array length matches channelCount.
+     */
+    peakLevels: number[];
+    /**
+     * Per-channel RMS levels (0-1). Array length matches channelCount.
+     * RMS: root mean square of samples per analysis frame.
+     */
+    rmsLevels: number[];
+    /**
+     * Error from meter setup (worklet load failure, context issues, etc.)
+     * Null when metering is working normally.
+     */
+    error: Error | null;
 }
 /**
  * Monitor microphone input levels in real-time
  *
  * @param stream - MediaStream from getUserMedia
  * @param options - Configuration options
- * @returns Object with current level and peak level
+ * @returns Object with current peak level, RMS level, and held peak level
  *
  * @example
  * ```typescript
  * const { stream } = useMicrophoneAccess();
- * const { level, peakLevel, resetPeak } = useMicrophoneLevel(stream);
+ * const { levels, rmsLevels, peakLevels } = useMicrophoneLevel(stream, { channelCount: 2 });
  *
- * return <VUMeter level={level} peakLevel={peakLevel} />;
+ * return <SegmentedVUMeter levels={levels} peakLevels={peakLevels} />;
  * ```
  */
 declare function useMicrophoneLevel(stream: MediaStream | null, options?: UseMicrophoneLevelOptions): UseMicrophoneLevelReturn;
@@ -174,6 +190,12 @@ interface UseIntegratedRecordingReturn {
     duration: number;
     level: number;
     peakLevel: number;
+    /** Per-channel peak levels (0-1). Array length matches channelCount. */
+    levels: number[];
+    /** Per-channel held peak levels (0-1). Array length matches channelCount. */
+    peakLevels: number[];
+    /** Per-channel RMS levels (0-1). Array length matches channelCount. */
+    rmsLevels: number[];
     error: Error | null;
     stream: MediaStream | null;
     devices: MicrophoneDevice[];
@@ -189,78 +211,6 @@ interface UseIntegratedRecordingReturn {
 }
 declare function useIntegratedRecording(tracks: ClipTrack[], setTracks: (tracks: ClipTrack[]) => void, selectedTrackId: string | null, options?: IntegratedRecordingOptions): UseIntegratedRecordingReturn;
 
-/**
- * RecordButton - Control button for starting/stopping recording
- */
-
-interface RecordButtonProps {
-    isRecording: boolean;
-    onClick: () => void;
-    disabled?: boolean;
-    className?: string;
-}
-declare const RecordButton: React.FC<RecordButtonProps>;
-
-/**
- * MicrophoneSelector - Dropdown for selecting microphone input device
- */
-
-interface MicrophoneSelectorProps {
-    devices: MicrophoneDevice[];
-    selectedDeviceId?: string;
-    onDeviceChange: (deviceId: string) => void;
-    disabled?: boolean;
-    className?: string;
-}
-declare const MicrophoneSelector: React.FC<MicrophoneSelectorProps>;
-
-/**
- * RecordingIndicator - Shows recording status, duration, and visual indicator
- */
-
-interface RecordingIndicatorProps {
-    isRecording: boolean;
-    isPaused?: boolean;
-    duration: number;
-    formatTime?: (seconds: number) => string;
-    className?: string;
-}
-declare const RecordingIndicator: React.FC<RecordingIndicatorProps>;
-
-/**
- * VU Meter Component
- *
- * Displays real-time audio input levels with color-coded zones
- * and peak indicator.
- */
-
-interface VUMeterProps {
-    /**
-     * Current audio level (0-1)
-     */
-    level: number;
-    /**
-     * Peak level (0-1)
-     * Optional - if provided, shows peak indicator
-     */
-    peakLevel?: number;
-    /**
-     * Width of the meter in pixels
-     * Default: 200
-     */
-    width?: number;
-    /**
-     * Height of the meter in pixels
-     * Default: 20
-     */
-    height?: number;
-    /**
-     * Additional CSS class name
-     */
-    className?: string;
-}
-declare const VUMeter: React.NamedExoticComponent<VUMeterProps>;
-
 /**
  * Peak generation for real-time waveform visualization during recording
  * Matches the format used by webaudio-peaks: min/max pairs with bit depth
@@ -288,4 +238,4 @@ declare function concatenateAudioData(chunks: Float32Array[]): Float32Array;
  */
 declare function createAudioBuffer(audioContext: AudioContext, channelData: Float32Array[] | Float32Array, sampleRate: number, channelCount?: number): AudioBuffer;
 
-export { type IntegratedRecordingOptions, type MicrophoneDevice, MicrophoneSelector, type MicrophoneSelectorProps, RecordButton, type RecordButtonProps, type RecordingData, RecordingIndicator, type RecordingIndicatorProps, type RecordingOptions, type RecordingState, type UseIntegratedRecordingReturn, type UseMicrophoneAccessReturn, type UseMicrophoneLevelOptions, type UseMicrophoneLevelReturn, type UseRecordingReturn, VUMeter, type VUMeterProps, concatenateAudioData, createAudioBuffer, generatePeaks, useIntegratedRecording, useMicrophoneAccess, useMicrophoneLevel, useRecording };
+export { type IntegratedRecordingOptions, type MicrophoneDevice, type RecordingData, type RecordingOptions, type RecordingState, type UseIntegratedRecordingReturn, type UseMicrophoneAccessReturn, type UseMicrophoneLevelOptions, type UseMicrophoneLevelReturn, type UseRecordingReturn, concatenateAudioData, createAudioBuffer, generatePeaks, useIntegratedRecording, useMicrophoneAccess, useMicrophoneLevel, useRecording };