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

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,8 @@ 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;
     className?: string;
 }
 
@@ -1855,6 +1863,8 @@ 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;
     className?: string;
     showClipHeaders?: boolean;
     interactiveClips?: boolean;