@waveform-playlist/browser 5.0.0-alpha.16 → 5.0.0-alpha.18

package/dist/index.d.ts

@@ -574,6 +574,9 @@ export declare interface MediaElementControlsContextValue {
     setContinuousPlay: (enabled: boolean) => void;
     setAnnotations: (annotations: AnnotationData[]) => void;
     setActiveAnnotationId: (id: string | null) => void;
+    setAutomaticScroll: (enabled: boolean) => void;
+    setScrollContainer: (element: HTMLDivElement | null) => void;
+    scrollContainerRef: default_2.RefObject<HTMLDivElement | null>;
 }
 
 export declare interface MediaElementDataContextValue {
@@ -622,6 +625,8 @@ declare interface MediaElementPlaylistProviderProps {
     timescale?: boolean;
     /** Initial playback rate (0.5 to 2.0) */
     playbackRate?: number;
+    /** Enable automatic scroll to keep playhead centered */
+    automaticScroll?: boolean;
     /** Theme configuration */
     theme?: Partial<WaveformPlaylistTheme>;
     /** Track controls configuration */
@@ -650,6 +655,7 @@ export declare interface MediaElementStateContextValue {
     annotations: AnnotationData[];
     activeAnnotationId: string | null;
     playbackRate: number;
+    isAutomaticScroll: boolean;
 }
 
 export declare interface MediaElementTrackConfig {
@@ -693,6 +699,10 @@ export declare interface MediaElementWaveformProps {
      * Called with the full updated annotations array.
      */
     onAnnotationUpdate?: OnAnnotationUpdateFn;
+    /** Where to position the active annotation when auto-scrolling: 'center', 'start', 'end', or 'nearest'. Defaults to 'center'. */
+    scrollActivePosition?: ScrollLogicalPosition;
+    /** Which scrollable containers to scroll: 'nearest' (only the annotation list) or 'all' (including viewport). Defaults to 'nearest'. */
+    scrollActiveContainer?: 'nearest' | 'all';
     className?: string;
 }
 
@@ -1855,6 +1865,10 @@ export declare interface WaveformProps {
      * Default: annotation.id
      */
     getAnnotationBoxLabel?: GetAnnotationBoxLabelFn;
+    /** Where to position the active annotation when auto-scrolling: 'center', 'start', 'end', or 'nearest'. Defaults to 'center'. */
+    scrollActivePosition?: ScrollLogicalPosition;
+    /** Which scrollable containers to scroll: 'nearest' (only the annotation list) or 'all' (including viewport). Defaults to 'nearest'. */
+    scrollActiveContainer?: 'nearest' | 'all';
     className?: string;
     showClipHeaders?: boolean;
     interactiveClips?: boolean;