@waveform-playlist/browser 7.1.1 → 7.1.2

package/dist/index.d.ts

@@ -1374,12 +1374,26 @@ export declare interface TrackEffectsState {
     activeEffects: TrackActiveEffect[];
 }
 
+/** Info about a track that failed to load. */
+export declare interface TrackLoadError {
+    /** Display name of the source that failed. */
+    name: string;
+    /** The underlying error. */
+    error: Error;
+}
+
 declare interface TrackMenuItem {
     id: string;
     label?: string;
     content: ReactNode;
 }
 
+/** A source that can be decoded into a track. */
+export declare type TrackSource = File | Blob | string | {
+    src: string;
+    name?: string;
+};
+
 /** Per-track overrides for spectrogram rendering (render mode, config, color map) */
 declare interface TrackSpectrogramOverrides {
     renderMode: RenderMode;
@@ -1710,6 +1724,26 @@ export declare interface UseDynamicEffectsReturn {
     analyserRef: React.RefObject<Analyser | null>;
 }
 
+export declare function useDynamicTracks(): UseDynamicTracksReturn;
+
+export declare 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[];
+}
+
 /**
  * Hook for exporting the waveform playlist to WAV format
  * Uses OfflineAudioContext for fast, non-real-time rendering