@waveform-playlist/browser 13.1.2 → 14.0.0

package/dist/index.d.ts

@@ -1,12 +1,9 @@
-import { Analyser, ToneAudioNode, InputNode } from 'tone';
-import * as tone from 'tone';
-export { tone as Tone };
-import { EffectsFunction, SoundFontCache, TrackEffectsFunction as TrackEffectsFunction$1 } from '@waveform-playlist/playout';
+import { EffectsFunction, SoundFontCache, TrackEffectsFunction } from '@waveform-playlist/playout';
 export { EffectsFunction, TrackEffectsFunction } from '@waveform-playlist/playout';
 import * as React$1 from 'react';
 import React__default, { ReactNode, RefObject } from 'react';
-import { PlaylistEngine, EngineState } from '@waveform-playlist/engine';
-import { PeakData, Fade, MidiNoteData, ClipTrack, AnnotationData, AnnotationAction, WaveformDataObject, TrackEffectsFunction as TrackEffectsFunction$2, RenderMode, SpectrogramConfig, ColorMapValue, KeyboardShortcut, AnnotationActionOptions, RenderAnnotationItemProps, TrackSpectrogramOverrides } from '@waveform-playlist/core';
+import { PlayoutAdapter, PlaylistEngine, EngineState } from '@waveform-playlist/engine';
+import { PeakData, Fade, MidiNoteData, ClipTrack, AnnotationData, AnnotationAction, WaveformDataObject, KeyboardShortcut, AnnotationActionOptions, RenderAnnotationItemProps, TrackSpectrogramOverrides, SpectrogramConfig, ColorMapValue, RenderMode } from '@waveform-playlist/core';
 export { AnnotationData, AudioClip, ClipTrack, Fade, getShortcutLabel } from '@waveform-playlist/core';
 import { WaveformPlaylistTheme, TimeFormat, RenderPlayheadFunction, TrackMenuItem, SnapTo } from '@waveform-playlist/ui-components';
 export { TimeFormat } from '@waveform-playlist/ui-components';
@@ -32,9 +29,9 @@ type TrackClipPeaks = ClipPeaks[];
 interface WaveformTrack {
     src: string | AudioBuffer;
     name?: string;
-    effects?: TrackEffectsFunction$1;
+    effects?: TrackEffectsFunction;
 }
-interface TrackState$1 {
+interface TrackState {
     name: string;
     muted: boolean;
     soloed: boolean;
@@ -66,12 +63,19 @@ interface PlaybackAnimationContextValue {
     audioStartPositionRef: React__default.RefObject<number>;
     /** Returns raw playback time from engine (auto-wraps at loop boundaries). */
     getPlaybackTime: () => number;
+    /** Current time of the adapter's AudioContext, in seconds. */
+    getAudioContextTime: () => number;
     /**
      * Returns the current adapter scheduler lookahead (Tone ~0.1s, native 0).
      * Use this for any audible-latency calculation that must match the playhead
      * (e.g., recording live-preview peak slicing).
      */
     getLookAhead: () => number;
+    /**
+     * Returns the adapter AudioContext's output latency in seconds.
+     * Use this for audible-latency calculations (e.g., recording live-preview peak slicing).
+     */
+    getOutputLatency: () => number;
     /** Register a per-frame callback driven by the single animation loop. */
     registerFrameCallback: (id: string, cb: (data: FrameData) => void) => void;
     /** Unregister a per-frame callback. */
@@ -133,7 +137,7 @@ interface PlaylistDataContextValue {
     duration: number;
     audioBuffers: AudioBuffer[];
     peaksDataArray: TrackClipPeaks[];
-    trackStates: TrackState$1[];
+    trackStates: TrackState[];
     tracks: ClipTrack[];
     sampleRate: number;
     waveHeight: number;
@@ -184,6 +188,10 @@ interface WaveformPlaylistProviderProps {
     };
     effects?: EffectsFunction;
     onReady?: () => void;
+    /** Called when audio/engine initialization fails (e.g. a missing optional peer,
+     *  a throwing `createAdapter`, or an invalid `zoomLevels`/`samplesPerPixel`). The
+     *  provider already logs the error; use this to surface it in your UI. */
+    onError?: (err: Error) => void;
     /** @deprecated Use onAnnotationsChange instead */
     onAnnotationUpdate?: (annotations: AnnotationData[]) => void;
     /** Callback when annotations are changed (drag, edit, etc.) */
@@ -217,6 +225,13 @@ interface WaveformPlaylistProviderProps {
      *  this rate via standardized-audio-context. Pre-computed peaks (.dat files)
      *  render instantly when they match. On mismatch, falls back to worker. */
     sampleRate?: number;
+    /** Factory for a custom PlayoutAdapter. When omitted, the Tone.js engine
+     *  (@waveform-playlist/playout) is dynamically imported — so a custom adapter
+     *  lets a consumer use neither @waveform-playlist/playout nor tone. Called once
+     *  per engine rebuild; the provider owns and disposes the returned instance.
+     *  Pass a stable reference (module-level or useCallback) — it is read directly
+     *  inside the curated `loadAudio` effect, not via its dependency array. */
+    createAdapter?: () => PlayoutAdapter;
     children: ReactNode;
 }
 declare const WaveformPlaylistProvider: React__default.FC<WaveformPlaylistProviderProps>;
@@ -224,6 +239,13 @@ declare const usePlaybackAnimation: () => PlaybackAnimationContextValue;
 declare const usePlaylistState: () => PlaylistStateContextValue;
 declare const usePlaylistControls: () => PlaylistControlsContextValue;
 declare const usePlaylistData: () => PlaylistDataContextValue;
+/**
+ * Like {@link usePlaylistData} but returns `null` instead of throwing when there
+ * is no WaveformPlaylistProvider ancestor. Use this in hooks/components that may
+ * also run in the MediaElement path (MediaElementPlaylistProvider), where the
+ * WebAudio playlist context is absent.
+ */
+declare const usePlaylistDataOptional: () => PlaylistDataContextValue | null;
 
 interface MediaElementTrackConfig {
     /** Audio source URL or Blob URL */
@@ -328,6 +350,13 @@ interface MediaElementPlaylistProviderProps {
     audioContext?: AudioContext;
     /** Callback when audio is ready */
     onReady?: () => void;
+    /** Called when playout initialization fails (e.g. a missing optional peer,
+     *  a throwing `createPlayout`, or an `addTrack` error). The provider already
+     *  logs the error; use this to surface it in your UI. */
+    onError?: (err: Error) => void;
+    /** Factory for a custom MediaElement playout. When omitted, the bundled engine
+     *  (@waveform-playlist/media-element-playout) is dynamically imported. */
+    createPlayout?: () => MediaElementPlayout;
     children: ReactNode;
 }
 /**
@@ -422,122 +451,6 @@ declare function useMasterVolume({ engineRef, initialVolume, }: UseMasterVolumeP
     onEngineState: (state: EngineState) => void;
 };
 
-/**
- * Hook for master effects with frequency analyzer
- * Returns the analyser ref and the effects function to pass to WaveformPlaylistProvider
- *
- * For more advanced effects (reverb, delay, filters, etc.), use useDynamicEffects instead.
- */
-declare const useMasterAnalyser: (fftSize?: number) => {
-    analyserRef: React$1.MutableRefObject<Analyser | null>;
-    masterEffects: EffectsFunction;
-};
-
-/**
- * Configuration for a single audio track to load
- *
- * Audio can be provided in three ways:
- * 1. `src` - URL to fetch and decode (standard loading)
- * 2. `audioBuffer` - Pre-loaded AudioBuffer (skip fetch/decode)
- * 3. `waveformData` only - Peaks-first rendering (audio loads later)
- *
- * For peaks-first rendering, just provide `waveformData` - the sample rate
- * and duration are derived from the waveform data automatically.
- */
-interface AudioTrackConfig {
-    /** URL to audio file - used if audioBuffer not provided */
-    src?: string;
-    /** Pre-loaded AudioBuffer - skips fetch/decode if provided */
-    audioBuffer?: AudioBuffer;
-    name?: string;
-    muted?: boolean;
-    soloed?: boolean;
-    volume?: number;
-    pan?: number;
-    color?: string;
-    effects?: TrackEffectsFunction$2;
-    startTime?: number;
-    duration?: number;
-    offset?: number;
-    fadeIn?: Fade;
-    fadeOut?: Fade;
-    waveformData?: WaveformDataObject;
-    /** Visualization render mode: 'waveform' | 'spectrogram' | 'both'. Default: 'waveform' */
-    renderMode?: RenderMode;
-    /** Spectrogram configuration (FFT size, window, frequency scale, etc.) */
-    spectrogramConfig?: SpectrogramConfig;
-    /** Spectrogram color map name or custom color array */
-    spectrogramColorMap?: ColorMapValue;
-}
-/**
- * Options for useAudioTracks hook
- */
-interface UseAudioTracksOptions {
-    /**
-     * When true, all tracks render immediately as placeholders with clip geometry
-     * from the config. Audio fills in progressively as files decode, and peaks
-     * render as each buffer becomes available. Use with `deferEngineRebuild={loading}`
-     * on the provider for a single engine build when all tracks are ready.
-     *
-     * Requires `duration` or `waveformData` in each config so clip dimensions are known upfront.
-     * Default: false
-     */
-    immediate?: boolean;
-    /** @deprecated Use `immediate` instead. */
-    progressive?: boolean;
-}
-/**
- * Hook to load audio from URLs and convert to ClipTrack format
- *
- * This hook fetches audio files, decodes them, and creates ClipTrack objects
- * with a single clip per track. Supports custom positioning for multi-clip arrangements.
- *
- * @param configs - Array of audio track configurations
- * @param options - Optional configuration for loading behavior
- * @returns Object with tracks array, loading state, and progress info
- *
- * @example
- * ```typescript
- * // Basic usage (clips positioned at start)
- * const { tracks, loading, error } = useAudioTracks([
- *   { src: 'audio/vocals.mp3', name: 'Vocals' },
- *   { src: 'audio/drums.mp3', name: 'Drums' },
- * ]);
- *
- * // Immediate rendering with deferred engine build (recommended for multi-track)
- * const { tracks, loading } = useAudioTracks(
- *   [
- *     { src: 'audio/vocals.mp3', name: 'Vocals', duration: 30 },
- *     { src: 'audio/drums.mp3', name: 'Drums', duration: 30 },
- *   ],
- *   { immediate: true }
- * );
- * // All tracks render instantly as placeholders, peaks fill in as files load
- * return (
- *   <WaveformPlaylistProvider tracks={tracks} deferEngineRebuild={loading}>
- *     ...
- *   </WaveformPlaylistProvider>
- * );
- *
- * // Pre-loaded AudioBuffer (skip fetch/decode)
- * const { tracks } = useAudioTracks([
- *   { audioBuffer: myPreloadedBuffer, name: 'Pre-loaded' },
- * ]);
- *
- * // Peaks-first rendering (instant visual, audio loads later)
- * const { tracks } = useAudioTracks([
- *   { waveformData: preloadedPeaks, name: 'Peaks Only' },  // Renders immediately
- * ]);
- * ```
- */
-declare function useAudioTracks(configs: AudioTrackConfig[], options?: UseAudioTracksOptions): {
-    tracks: ClipTrack[];
-    loading: boolean;
-    error: string | null;
-    loadedCount: number;
-    totalCount: number;
-};
-
 interface UseClipDragHandlersOptions {
     tracks: ClipTrack[];
     onTracksChange: (tracks: ClipTrack[]) => void;
@@ -598,7 +511,8 @@ interface UseAnnotationDragHandlersOptions {
     annotations: AnnotationData[];
     onAnnotationsChange: (annotations: AnnotationData[]) => void;
     samplesPerPixel: number;
-    /** Sample rate for pixel-to-time conversion. Defaults to AudioContext.sampleRate. */
+    /** Sample rate for pixel-to-time conversion. Providers pass the real rate from
+     *  context; defaults to 48000 (the engine default) for out-of-provider usage. */
     sampleRate?: number;
     duration: number;
     linkEndpoints: boolean;
@@ -824,6 +738,14 @@ interface UseAnnotationKeyboardControlsOptions {
     scrollContainerRef?: React.RefObject<HTMLDivElement | null>;
     /** Optional: callback to start playback at a time with optional duration */
     onPlay?: (startTime: number, duration?: number) => void;
+    /**
+     * Pixels-per-sample for auto-scroll positioning. Falls back to the
+     * WaveformPlaylistProvider context when omitted (WebAudio path). Pass
+     * explicitly when used outside that provider (e.g. the MediaElement path).
+     */
+    samplesPerPixel?: number;
+    /** Sample rate for auto-scroll positioning. Falls back to context. */
+    sampleRate?: number;
 }
 /**
  * Hook for keyboard-based annotation navigation and boundary editing
@@ -856,7 +778,7 @@ interface UseAnnotationKeyboardControlsOptions {
  * });
  * ```
  */
-declare function useAnnotationKeyboardControls({ annotations, activeAnnotationId, onAnnotationsChange, onActiveAnnotationChange, duration, linkEndpoints, continuousPlay, enabled, scrollContainerRef, onPlay, }: UseAnnotationKeyboardControlsOptions): {
+declare function useAnnotationKeyboardControls({ annotations, activeAnnotationId, onAnnotationsChange, onActiveAnnotationChange, duration, linkEndpoints, continuousPlay, enabled, scrollContainerRef, onPlay, samplesPerPixel: samplesPerPixelProp, sampleRate: sampleRateProp, }: UseAnnotationKeyboardControlsOptions): {
     moveStartBoundary: (delta: number) => void;
     moveEndBoundary: (delta: number) => void;
     selectPrevious: () => void;
@@ -868,280 +790,6 @@ declare function useAnnotationKeyboardControls({ annotations, activeAnnotationId
     playActiveAnnotation: () => void;
 };
 
-/**
- * Effect definitions for all available Tone.js effects
- * Each effect has parameters with min/max/default values for UI controls
- */
-type ParameterType = 'number' | 'select' | 'boolean';
-interface EffectParameter {
-    name: string;
-    label: string;
-    type: ParameterType;
-    min?: number;
-    max?: number;
-    step?: number;
-    default: number | string | boolean;
-    unit?: string;
-    options?: {
-        value: string | number;
-        label: string;
-    }[];
-}
-interface EffectDefinition {
-    id: string;
-    name: string;
-    category: 'delay' | 'reverb' | 'modulation' | 'distortion' | 'filter' | 'dynamics' | 'spatial';
-    description: string;
-    parameters: EffectParameter[];
-}
-declare const effectDefinitions: EffectDefinition[];
-declare const getEffectDefinition: (id: string) => EffectDefinition | undefined;
-declare const getEffectsByCategory: (category: EffectDefinition["category"]) => EffectDefinition[];
-declare const effectCategories: {
-    id: EffectDefinition['category'];
-    name: string;
-}[];
-
-interface ActiveEffect {
-    instanceId: string;
-    effectId: string;
-    definition: EffectDefinition;
-    params: Record<string, number | string | boolean>;
-    bypassed: boolean;
-}
-interface UseDynamicEffectsReturn {
-    activeEffects: ActiveEffect[];
-    availableEffects: EffectDefinition[];
-    addEffect: (effectId: string) => void;
-    removeEffect: (instanceId: string) => void;
-    updateParameter: (instanceId: string, paramName: string, value: number | string | boolean) => void;
-    toggleBypass: (instanceId: string) => void;
-    reorderEffects: (fromIndex: number, toIndex: number) => void;
-    clearAllEffects: () => void;
-    masterEffects: EffectsFunction;
-    /**
-     * Creates a fresh effects function for offline rendering.
-     * This creates new effect instances that work in the offline AudioContext.
-     */
-    createOfflineEffectsFunction: () => EffectsFunction | undefined;
-    analyserRef: React.RefObject<Analyser | null>;
-}
-/**
- * Hook for managing a dynamic chain of audio effects with real-time parameter updates
- */
-declare function useDynamicEffects(fftSize?: number): UseDynamicEffectsReturn;
-
-interface TrackActiveEffect {
-    instanceId: string;
-    effectId: string;
-    definition: EffectDefinition;
-    params: Record<string, number | string | boolean>;
-    bypassed: boolean;
-}
-interface TrackEffectsState {
-    trackId: string;
-    activeEffects: TrackActiveEffect[];
-}
-interface UseTrackDynamicEffectsReturn {
-    trackEffectsState: Map<string, TrackActiveEffect[]>;
-    addEffectToTrack: (trackId: string, effectId: string) => void;
-    removeEffectFromTrack: (trackId: string, instanceId: string) => void;
-    updateTrackEffectParameter: (trackId: string, instanceId: string, paramName: string, value: number | string | boolean) => void;
-    toggleBypass: (trackId: string, instanceId: string) => void;
-    clearTrackEffects: (trackId: string) => void;
-    getTrackEffectsFunction: (trackId: string) => TrackEffectsFunction$1 | undefined;
-    /**
-     * Creates a fresh effects function for a track for offline rendering.
-     * This creates new effect instances that work in the offline AudioContext.
-     */
-    createOfflineTrackEffectsFunction: (trackId: string) => TrackEffectsFunction$1 | undefined;
-    availableEffects: EffectDefinition[];
-}
-/**
- * Hook for managing dynamic effects per track with real-time parameter updates
- */
-declare function useTrackDynamicEffects(): UseTrackDynamicEffectsReturn;
-
-/**
- * WAV file encoder
- * Converts AudioBuffer to WAV format Blob
- */
-interface WavEncoderOptions {
-    /** Bit depth: 16 or 32. Default: 16 */
-    bitDepth?: 16 | 32;
-}
-
-/** Function type for per-track effects (same as in @waveform-playlist/core) */
-type TrackEffectsFunction = (graphEnd: unknown, destination: unknown, isOffline: boolean) => void | (() => void);
-interface ExportOptions extends WavEncoderOptions {
-    /** Filename for download (without extension) */
-    filename?: string;
-    /** Export mode: 'master' for full mixdown, 'individual' for single track */
-    mode?: 'master' | 'individual';
-    /** Track index for individual export (only used when mode is 'individual') */
-    trackIndex?: number;
-    /** Whether to trigger automatic download */
-    autoDownload?: boolean;
-    /** Whether to apply effects (fades, etc.) - defaults to true */
-    applyEffects?: boolean;
-    /**
-     * Optional Tone.js effects function for master effects. When provided, export renders
-     * through the effects chain. The function receives isOffline=true.
-     */
-    effectsFunction?: EffectsFunction;
-    /**
-     * Optional function to create offline track effects.
-     * Takes a trackId and returns a TrackEffectsFunction for offline rendering.
-     * This is used instead of track.effects to avoid AudioContext mismatch issues.
-     */
-    createOfflineTrackEffects?: (trackId: string) => TrackEffectsFunction | undefined;
-    /** Progress callback (0-1) */
-    onProgress?: (progress: number) => void;
-}
-interface ExportResult {
-    /** The rendered audio buffer */
-    audioBuffer: AudioBuffer;
-    /** The WAV file as a Blob */
-    blob: Blob;
-    /** Duration in seconds */
-    duration: number;
-}
-interface UseExportWavReturn {
-    /** Export the playlist to WAV */
-    exportWav: (tracks: ClipTrack[], trackStates: TrackState[], options?: ExportOptions) => Promise<ExportResult>;
-    /** Whether export is in progress */
-    isExporting: boolean;
-    /** Export progress (0-1) */
-    progress: number;
-    /** Error message if export failed */
-    error: string | null;
-}
-interface TrackState {
-    muted: boolean;
-    soloed: boolean;
-    volume: number;
-    pan: number;
-}
-/**
- * Hook for exporting the waveform playlist to WAV format.
- * Uses Tone.Offline for non-real-time rendering, mirroring the live playback graph.
- */
-declare function useExportWav(): UseExportWavReturn;
-
-/**
- * useDynamicTracks — imperative hook for runtime track additions.
- *
- * Complements `useAudioTracks` (declarative, configs-driven) with an
- * imperative `addTracks()` API for dynamic loading (drag-and-drop, file pickers).
- *
- * Placeholder tracks appear instantly while audio decodes in parallel.
- */
-
-/** A source that can be decoded into a track. */
-type TrackSource = File | Blob | string | {
-    src: string;
-    name?: string;
-};
-/** Info about a track that failed to load. */
-interface TrackLoadError {
-    /** Display name of the source that failed. */
-    name: string;
-    /** The underlying error. */
-    error: Error;
-}
-interface UseDynamicTracksReturn {
-    /**
-     * Current tracks array (placeholders + loaded). Pass to WaveformPlaylistProvider.
-     * Placeholder tracks have `clips: []` and names ending with " (loading...)".
-     */
-    tracks: ClipTrack[];
-    /** Add one or more sources — creates placeholder tracks immediately. */
-    addTracks: (sources: TrackSource[]) => void;
-    /** Remove a track by its id. Aborts in-flight fetch/decode if still loading. */
-    removeTrack: (trackId: string) => void;
-    /** Number of sources currently decoding. */
-    loadingCount: number;
-    /** True when any source is still decoding. */
-    isLoading: boolean;
-    /** Tracks that failed to load (removed from `tracks` automatically). */
-    errors: TrackLoadError[];
-}
-declare function useDynamicTracks(): UseDynamicTracksReturn;
-
-/**
- * Hook for monitoring master output levels
- *
- * Connects an AudioWorklet meter processor to the Destination node for
- * real-time output level monitoring. Computes sample-accurate peak and
- * RMS via the meter worklet — no transient is missed.
- *
- * IMPORTANT: Uses getGlobalContext() from playout to ensure the meter
- * is created on the same AudioContext as the audio engine. Tone.js's
- * getContext()/getDestination() return the DEFAULT context, which is
- * replaced when getGlobalContext() calls setContext() on first audio init.
- */
-interface UseOutputMeterOptions {
-    /**
-     * Number of channels to meter.
-     * Default: 2 (stereo output)
-     */
-    channelCount?: number;
-    /**
-     * How often to update the levels (in Hz).
-     * Default: 60 (60fps)
-     */
-    updateRate?: number;
-    /**
-     * Whether audio is currently playing. When this transitions to false,
-     * all levels (current, peak, RMS) and smoothed state are reset to zero.
-     * Without this, the browser's tail-time optimization stops calling the
-     * worklet's process() when no audio flows, leaving the last non-zero
-     * levels frozen in state.
-     * Default: false
-     */
-    isPlaying?: boolean;
-}
-interface UseOutputMeterReturn {
-    /** Per-channel peak output levels (0-1) */
-    levels: number[];
-    /** Per-channel held peak levels (0-1) */
-    peakLevels: number[];
-    /** Per-channel RMS output levels (0-1) */
-    rmsLevels: number[];
-    /** Reset all held peak levels to 0 */
-    resetPeak: () => void;
-    /** Error from meter setup (worklet load failure, context issues, etc.) */
-    error: Error | null;
-}
-declare function useOutputMeter(options?: UseOutputMeterOptions): UseOutputMeterReturn;
-
-/**
- * Factory for creating Tone.js effect instances from effect definitions
- */
-
-interface EffectInstance {
-    effect: ToneAudioNode;
-    id: string;
-    instanceId: string;
-    dispose: () => void;
-    setParameter: (name: string, value: number | string | boolean) => void;
-    getParameter: (name: string) => number | string | boolean | undefined;
-    connect: (destination: InputNode) => void;
-    disconnect: () => void;
-}
-/**
- * Create an effect instance from a definition with initial parameter values
- */
-declare function createEffectInstance(definition: EffectDefinition, initialParams?: Record<string, number | string | boolean>): EffectInstance;
-/**
- * Create a chain of effects connected in series
- */
-declare function createEffectChain(effects: EffectInstance[]): {
-    input: ToneAudioNode;
-    output: ToneAudioNode;
-    dispose: () => void;
-};
-
 declare const PlayButton: React__default.FC<{
     className?: string;
 }>;
@@ -1251,38 +899,6 @@ declare const DownloadAnnotationsButton: React__default.FC<{
     className?: string;
 }>;
 
-interface ExportWavButtonProps {
-    /** Button label */
-    label?: string;
-    /** Filename for the downloaded file (without extension) */
-    filename?: string;
-    /** Export mode: 'master' for stereo mix, 'individual' for single track */
-    mode?: 'master' | 'individual';
-    /** Track index for individual export */
-    trackIndex?: number;
-    /** Bit depth: 16 or 32 */
-    bitDepth?: 16 | 32;
-    /** Whether to apply effects (fades, etc.) - defaults to true */
-    applyEffects?: boolean;
-    /**
-     * Optional Tone.js effects function for master effects. When provided, export will use Tone.Offline
-     * to render through the effects chain. The function receives isOffline=true.
-     */
-    effectsFunction?: EffectsFunction;
-    /**
-     * Optional function to create offline track effects.
-     * Takes a trackId and returns a TrackEffectsFunction for offline rendering.
-     */
-    createOfflineTrackEffects?: (trackId: string) => TrackEffectsFunction | undefined;
-    /** CSS class name */
-    className?: string;
-    /** Callback when export completes */
-    onExportComplete?: (blob: Blob) => void;
-    /** Callback when export fails */
-    onExportError?: (error: Error) => void;
-}
-declare const ExportWavButton: React__default.FC<ExportWavButtonProps>;
-
 /**
  * Shared annotation types used across Waveform components
  */
@@ -1850,4 +1466,4 @@ declare function getWaveformDataMetadata(src: string): Promise<{
     bits: 8 | 16;
 }>;
 
-export { type ActiveEffect, type AnnotationIntegration, AnnotationIntegrationProvider, AudioPosition, type AudioTrackConfig, AutomaticScrollCheckbox, ClearAllButton, type ClearAllButtonProps, ClipCollisionModifier, ClipInteractionProvider, type ClipInteractionProviderProps, ContinuousPlayCheckbox, DownloadAnnotationsButton, EditableCheckbox, type EffectDefinition, type EffectInstance, type EffectParameter, type ExportOptions, type ExportResult, ExportWavButton, type ExportWavButtonProps, FastForwardButton, type FrameData, type GetAnnotationBoxLabelFn, KeyboardShortcuts, type KeyboardShortcutsProps, LinkEndpointsCheckbox, LoopButton, MasterVolumeControl, type MasterVolumeControls, type MediaElementAnimationContextValue, MediaElementAnnotationList, type MediaElementAnnotationListProps, type MediaElementControlsContextValue, type MediaElementDataContextValue, MediaElementPlaylist, type MediaElementPlaylistProps, MediaElementPlaylistProvider, type MediaElementStateContextValue, type MediaElementTrackConfig, MediaElementWaveform, type MediaElementWaveformProps, type OnAnnotationUpdateFn, type ParameterType, PauseButton, PlayButton, PlaylistAnnotationList, type PlaylistAnnotationListProps, PlaylistVisualization, type PlaylistVisualizationProps, RewindButton, SelectionTimeInputs, SetLoopRegionButton, SkipBackwardButton, SkipForwardButton, SnapToGridModifier, type SpectrogramCanvasRegistration, type SpectrogramIntegration, SpectrogramIntegrationProvider, StopButton, type TimeFormatControls, TimeFormatSelect, type TrackActiveEffect, type TrackEffectsState, type TrackLoadError, type TrackSource, type TrackState$1 as TrackState, type UseDynamicEffectsReturn, type UseDynamicTracksReturn, type UseExportWavReturn, type UseOutputMeterOptions, type UseOutputMeterReturn, type UsePlaybackShortcutsOptions, type UsePlaybackShortcutsReturn, type UseTrackDynamicEffectsReturn, Waveform, WaveformPlaylistProvider, type WaveformProps, type WaveformTrack, type ZoomControls, ZoomInButton, ZoomOutButton, createEffectChain, createEffectInstance, effectCategories, effectDefinitions, getEffectDefinition, getEffectsByCategory, getWaveformDataMetadata, loadPeaksFromWaveformData, loadWaveformData, noDropAnimationPlugins, useAnnotationDragHandlers, useAnnotationIntegration, useAnnotationKeyboardControls, useAudioTracks, useClipDragHandlers, useClipInteractionEnabled, useClipSplitting, useDragSensors, useDynamicEffects, useDynamicTracks, useExportWav, useKeyboardShortcuts, useMasterAnalyser, useMasterVolume, useMediaElementAnimation, useMediaElementControls, useMediaElementData, useMediaElementState, useOutputMeter, usePlaybackAnimation, usePlaybackShortcuts, usePlaylistControls, usePlaylistData, usePlaylistState, useSpectrogramIntegration, useTimeFormat, useTrackDynamicEffects, useZoomControls, waveformDataToPeaks };
+export { type AnnotationIntegration, AnnotationIntegrationProvider, AudioPosition, AutomaticScrollCheckbox, ClearAllButton, type ClearAllButtonProps, ClipCollisionModifier, ClipInteractionProvider, type ClipInteractionProviderProps, ContinuousPlayCheckbox, DownloadAnnotationsButton, EditableCheckbox, FastForwardButton, type FrameData, type GetAnnotationBoxLabelFn, KeyboardShortcuts, type KeyboardShortcutsProps, LinkEndpointsCheckbox, LoopButton, MasterVolumeControl, type MasterVolumeControls, type MediaElementAnimationContextValue, MediaElementAnnotationList, type MediaElementAnnotationListProps, type MediaElementControlsContextValue, type MediaElementDataContextValue, MediaElementPlaylist, type MediaElementPlaylistProps, MediaElementPlaylistProvider, type MediaElementStateContextValue, type MediaElementTrackConfig, MediaElementWaveform, type MediaElementWaveformProps, type OnAnnotationUpdateFn, PauseButton, PlayButton, PlaylistAnnotationList, type PlaylistAnnotationListProps, PlaylistVisualization, type PlaylistVisualizationProps, RewindButton, SelectionTimeInputs, SetLoopRegionButton, SkipBackwardButton, SkipForwardButton, SnapToGridModifier, type SpectrogramCanvasRegistration, type SpectrogramIntegration, SpectrogramIntegrationProvider, StopButton, type TimeFormatControls, TimeFormatSelect, type TrackState, type UsePlaybackShortcutsOptions, type UsePlaybackShortcutsReturn, Waveform, WaveformPlaylistProvider, type WaveformProps, type WaveformTrack, type ZoomControls, ZoomInButton, ZoomOutButton, getWaveformDataMetadata, loadPeaksFromWaveformData, loadWaveformData, noDropAnimationPlugins, useAnnotationDragHandlers, useAnnotationIntegration, useAnnotationKeyboardControls, useClipDragHandlers, useClipInteractionEnabled, useClipSplitting, useDragSensors, useKeyboardShortcuts, useMasterVolume, useMediaElementAnimation, useMediaElementControls, useMediaElementData, useMediaElementState, usePlaybackAnimation, usePlaybackShortcuts, usePlaylistControls, usePlaylistData, usePlaylistDataOptional, usePlaylistState, useSpectrogramIntegration, useTimeFormat, useZoomControls, waveformDataToPeaks };