@waveform-playlist/browser 8.0.0 → 8.1.0

package/dist/index.d.ts

@@ -882,6 +882,8 @@ declare interface PlaybackAnimationContextValue {
     currentTimeRef: default_2.RefObject<number>;
     playbackStartTimeRef: default_2.RefObject<number>;
     audioStartPositionRef: default_2.RefObject<number>;
+    /** Returns current playback time from engine (auto-wraps at loop boundaries). */
+    getPlaybackTime: () => number;
 }
 
 export declare const PlayButton: default_2.FC<{
@@ -900,9 +902,9 @@ declare interface PlayheadProps {
     isPlaying: boolean;
     /** Ref to current time in seconds - use for smooth animation during playback */
     currentTimeRef: react__default.RefObject<number>;
-    /** Audio context start time when playback began - for calculating elapsed time */
+    /** Audio context start time when playback began. Fallback when getPlaybackTime is not provided. */
     playbackStartTimeRef: react__default.RefObject<number>;
-    /** Audio position when playback started - for calculating current position */
+    /** Audio position when playback started. Fallback when getPlaybackTime is not provided. */
     audioStartPositionRef: react__default.RefObject<number>;
     /** Samples per pixel - for converting time to pixels */
     samplesPerPixel: number;
@@ -912,6 +914,8 @@ declare interface PlayheadProps {
     controlsOffset: number;
     /** Function to get current audio context time - required for smooth animation */
     getAudioContextTime?: () => number;
+    /** Returns current playback time (auto-wraps at loop boundaries). Preferred over manual elapsed calculation. */
+    getPlaybackTime?: () => number;
 }
 
 /**