@waveform-playlist/ui-components 7.1.3 → 8.1.0

package/dist/index.d.mts

@@ -322,9 +322,9 @@ 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;
@@ -334,6 +334,8 @@ 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;
 }
 /**
  * Type for custom playhead render functions.

package/dist/index.d.ts

@@ -322,9 +322,9 @@ 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;
@@ -334,6 +334,8 @@ 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;
 }
 /**
  * Type for custom playhead render functions.

package/dist/index.js

@@ -1420,7 +1420,8 @@ var PlayheadWithMarker = ({
   samplesPerPixel,
   sampleRate,
   controlsOffset,
-  getAudioContextTime
+  getAudioContextTime,
+  getPlaybackTime
 }) => {
   const containerRef = (0, import_react7.useRef)(null);
   const animationFrameRef = (0, import_react7.useRef)(null);
@@ -1428,9 +1429,15 @@ var PlayheadWithMarker = ({
     const updatePosition = () => {
       if (containerRef.current) {
         let time;
-        if (isPlaying && getAudioContextTime) {
-          const elapsed = getAudioContextTime() - (playbackStartTimeRef.current ?? 0);
-          time = (audioStartPositionRef.current ?? 0) + elapsed;
+        if (isPlaying) {
+          if (getPlaybackTime) {
+            time = getPlaybackTime();
+          } else if (getAudioContextTime) {
+            const elapsed = getAudioContextTime() - (playbackStartTimeRef.current ?? 0);
+            time = (audioStartPositionRef.current ?? 0) + elapsed;
+          } else {
+            time = currentTimeRef.current ?? 0;
+          }
         } else {
           time = currentTimeRef.current ?? 0;
         }
@@ -1460,7 +1467,8 @@ var PlayheadWithMarker = ({
     currentTimeRef,
     playbackStartTimeRef,
     audioStartPositionRef,
-    getAudioContextTime
+    getAudioContextTime,
+    getPlaybackTime
   ]);
   (0, import_react7.useEffect)(() => {
     if (!isPlaying && containerRef.current) {