@waveform-playlist/browser 5.0.0-alpha.6 → 5.0.0-alpha.8

package/dist/index.d.ts

@@ -86,6 +86,13 @@ export declare interface AudioClip {
     name?: string;
     /** Optional color for visual distinction */
     color?: string;
+    /**
+     * Pre-computed waveform data from waveform-data.js library.
+     * When provided, the library will use this instead of computing peaks from the audioBuffer.
+     * Supports resampling to different zoom levels and slicing for clip trimming.
+     * Load with: `const waveformData = await loadWaveformData('/path/to/peaks.dat')`
+     */
+    waveformData?: WaveformDataObject;
 }
 
 /**
@@ -114,6 +121,7 @@ export declare interface AudioTrackConfig {
     offset?: number;
     fadeIn?: Fade;
     fadeOut?: Fade;
+    waveformData?: WaveformDataObject;
 }
 
 /**
@@ -589,6 +597,9 @@ declare interface PlaylistControlsContextValue {
     setAnnotations: (annotations: AnnotationData[]) => void;
     setActiveAnnotationId: (id: string | null) => void;
     setLoopEnabled: (enabled: boolean) => void;
+    setLoopRegion: (start: number, end: number) => void;
+    setLoopRegionFromSelection: () => void;
+    clearLoopRegion: () => void;
 }
 
 declare interface PlaylistDataContextValue {
@@ -628,6 +639,8 @@ declare interface PlaylistStateContextValue {
     selectionStart: number;
     selectionEnd: number;
     selectedTrackId: string | null;
+    loopStart: number;
+    loopEnd: number;
 }
 
 /**
@@ -648,6 +661,10 @@ export declare const SelectionTimeInputs: default_2.FC<{
     className?: string;
 }>;
 
+export declare const SetLoopRegionButton: default_2.FC<{
+    className?: string;
+}>;
+
 export declare const SkipBackwardButton: default_2.FC<{
     skipAmount?: number;
     className?: string;
@@ -777,17 +794,6 @@ declare type TrackClipPeaks = ClipPeaks[];
 
 export declare type TrackEffectsFunction = (graphEnd: Gain, masterGainNode: ToneAudioNode, isOffline: boolean) => void | (() => void);
 
-/**
- * Clip-Based Model Types
- *
- * These types support a professional multi-track editing model where:
- * - Each track can contain multiple audio clips
- * - Clips can be positioned anywhere on the timeline
- * - Clips have independent trim points (offset/duration)
- * - Gaps between clips are silent
- * - Clips can overlap (for crossfades)
- */
-
 /**
  * Generic effects function type for track-level audio processing.
  *
@@ -1364,6 +1370,56 @@ export declare const Waveform: default_2.FC<WaveformProps>;
  */
 declare type WaveformColor = string | WaveformGradient;
 
+/**
+ * Clip-Based Model Types
+ *
+ * These types support a professional multi-track editing model where:
+ * - Each track can contain multiple audio clips
+ * - Clips can be positioned anywhere on the timeline
+ * - Clips have independent trim points (offset/duration)
+ * - Gaps between clips are silent
+ * - Clips can overlap (for crossfades)
+ */
+
+/**
+ * WaveformData object from waveform-data.js library.
+ * Supports resample() and slice() for dynamic zoom levels.
+ * See: https://github.com/bbc/waveform-data.js
+ */
+declare interface WaveformDataObject {
+    /** Sample rate of the original audio */
+    readonly sample_rate: number;
+    /** Number of audio samples per pixel */
+    readonly scale: number;
+    /** Length of waveform data in pixels */
+    readonly length: number;
+    /** Bit depth (8 or 16) */
+    readonly bits: number;
+    /** Duration in seconds */
+    readonly duration: number;
+    /** Number of channels */
+    readonly channels: number;
+    /** Get channel data */
+    channel: (index: number) => {
+        min_array: () => number[];
+        max_array: () => number[];
+    };
+    /** Resample to different scale */
+    resample: (options: {
+        scale: number;
+    } | {
+        width: number;
+    }) => WaveformDataObject;
+    /** Slice a portion of the waveform */
+    slice: (options: {
+        startTime: number;
+        endTime: number;
+    } | {
+        startIndex: number;
+        endIndex: number;
+    }) => WaveformDataObject;
+}
+
 /**
  * Convert WaveformData to our internal Peaks format
  *
@@ -1496,6 +1552,8 @@ declare interface WaveformPlaylistTheme {
     timescaleBackgroundColor: string;
     playheadColor: string;
     selectionColor: string;
+    loopRegionColor: string;
+    loopMarkerColor: string;
     clipHeaderBackgroundColor: string;
     clipHeaderBorderColor: string;
     clipHeaderTextColor: string;