@waveform-playlist/browser 10.3.0 → 11.0.0

package/dist/index.d.mts

@@ -505,7 +505,6 @@ interface UseClipDragHandlersOptions {
     tracks: ClipTrack[];
     onTracksChange: (tracks: ClipTrack[]) => void;
     samplesPerPixel: number;
-    sampleRate: number;
     engineRef: React__default.RefObject<PlaylistEngine | null>;
     /** Ref toggled during boundary trim drags. When true, the provider's loadAudio
      *  skips engine rebuilds so engine keeps original clip positions. On drag end,
@@ -536,7 +535,6 @@ interface UseClipDragHandlersOptions {
  *   tracks,
  *   onTracksChange: setTracks,
  *   samplesPerPixel,
- *   sampleRate,
  *   engineRef: playoutRef,
  *   isDraggingRef,
  * });
@@ -553,7 +551,7 @@ interface UseClipDragHandlersOptions {
  * );
  * ```
  */
-declare function useClipDragHandlers({ tracks, onTracksChange, samplesPerPixel, sampleRate, engineRef, isDraggingRef, snapSamplePosition, }: UseClipDragHandlersOptions): {
+declare function useClipDragHandlers({ tracks, onTracksChange, samplesPerPixel, engineRef, isDraggingRef, snapSamplePosition, }: UseClipDragHandlersOptions): {
     onDragStart: (event: Parameters<DragStartEvent>[0]) => void;
     onDragMove: (event: Parameters<DragMoveEvent>[0]) => void;
     onDragEnd: (event: Parameters<DragEndEvent>[0]) => void;
@@ -563,7 +561,8 @@ interface UseAnnotationDragHandlersOptions {
     annotations: AnnotationData[];
     onAnnotationsChange: (annotations: AnnotationData[]) => void;
     samplesPerPixel: number;
-    sampleRate: number;
+    /** Sample rate for pixel-to-time conversion. Defaults to AudioContext.sampleRate. */
+    sampleRate?: number;
     duration: number;
     linkEndpoints: boolean;
 }
@@ -579,7 +578,6 @@ interface UseAnnotationDragHandlersOptions {
  *   annotations,
  *   onAnnotationsChange: setAnnotations,
  *   samplesPerPixel,
- *   sampleRate,
  *   duration,
  *   linkEndpoints,
  * });
@@ -654,7 +652,6 @@ declare function useDragSensors(options?: DragSensorOptions): (typeof PointerSen
 
 interface UseClipSplittingOptions {
     tracks: ClipTrack[];
-    sampleRate: number;
     samplesPerPixel: number;
     engineRef: React__default.RefObject<PlaylistEngine | null>;
 }
@@ -676,7 +673,6 @@ interface UseClipSplittingResult {
  * ```tsx
  * const { splitClipAtPlayhead } = useClipSplitting({
  *   tracks,
- *   sampleRate,
  *   samplesPerPixel,
  *   engineRef: playoutRef,
  * });
@@ -806,10 +802,6 @@ interface UseAnnotationKeyboardControlsOptions {
     enabled?: boolean;
     /** Optional: scroll container ref for auto-scrolling to annotation */
     scrollContainerRef?: React.RefObject<HTMLDivElement | null>;
-    /** Optional: samples per pixel for scroll position calculation */
-    samplesPerPixel?: number;
-    /** Optional: sample rate for scroll position calculation */
-    sampleRate?: number;
     /** Optional: callback to start playback at a time with optional duration */
     onPlay?: (startTime: number, duration?: number) => void;
 }
@@ -844,7 +836,7 @@ interface UseAnnotationKeyboardControlsOptions {
  * });
  * ```
  */
-declare function useAnnotationKeyboardControls({ annotations, activeAnnotationId, onAnnotationsChange, onActiveAnnotationChange, duration, linkEndpoints, continuousPlay, enabled, scrollContainerRef, samplesPerPixel, sampleRate, onPlay, }: UseAnnotationKeyboardControlsOptions): {
+declare function useAnnotationKeyboardControls({ annotations, activeAnnotationId, onAnnotationsChange, onActiveAnnotationChange, duration, linkEndpoints, continuousPlay, enabled, scrollContainerRef, onPlay, }: UseAnnotationKeyboardControlsOptions): {
     moveStartBoundary: (delta: number) => void;
     moveEndBoundary: (delta: number) => void;
     selectPrevious: () => void;

package/dist/index.d.ts

@@ -505,7 +505,6 @@ interface UseClipDragHandlersOptions {
     tracks: ClipTrack[];
     onTracksChange: (tracks: ClipTrack[]) => void;
     samplesPerPixel: number;
-    sampleRate: number;
     engineRef: React__default.RefObject<PlaylistEngine | null>;
     /** Ref toggled during boundary trim drags. When true, the provider's loadAudio
      *  skips engine rebuilds so engine keeps original clip positions. On drag end,
@@ -536,7 +535,6 @@ interface UseClipDragHandlersOptions {
  *   tracks,
  *   onTracksChange: setTracks,
  *   samplesPerPixel,
- *   sampleRate,
  *   engineRef: playoutRef,
  *   isDraggingRef,
  * });
@@ -553,7 +551,7 @@ interface UseClipDragHandlersOptions {
  * );
  * ```
  */
-declare function useClipDragHandlers({ tracks, onTracksChange, samplesPerPixel, sampleRate, engineRef, isDraggingRef, snapSamplePosition, }: UseClipDragHandlersOptions): {
+declare function useClipDragHandlers({ tracks, onTracksChange, samplesPerPixel, engineRef, isDraggingRef, snapSamplePosition, }: UseClipDragHandlersOptions): {
     onDragStart: (event: Parameters<DragStartEvent>[0]) => void;
     onDragMove: (event: Parameters<DragMoveEvent>[0]) => void;
     onDragEnd: (event: Parameters<DragEndEvent>[0]) => void;
@@ -563,7 +561,8 @@ interface UseAnnotationDragHandlersOptions {
     annotations: AnnotationData[];
     onAnnotationsChange: (annotations: AnnotationData[]) => void;
     samplesPerPixel: number;
-    sampleRate: number;
+    /** Sample rate for pixel-to-time conversion. Defaults to AudioContext.sampleRate. */
+    sampleRate?: number;
     duration: number;
     linkEndpoints: boolean;
 }
@@ -579,7 +578,6 @@ interface UseAnnotationDragHandlersOptions {
  *   annotations,
  *   onAnnotationsChange: setAnnotations,
  *   samplesPerPixel,
- *   sampleRate,
  *   duration,
  *   linkEndpoints,
  * });
@@ -654,7 +652,6 @@ declare function useDragSensors(options?: DragSensorOptions): (typeof PointerSen
 
 interface UseClipSplittingOptions {
     tracks: ClipTrack[];
-    sampleRate: number;
     samplesPerPixel: number;
     engineRef: React__default.RefObject<PlaylistEngine | null>;
 }
@@ -676,7 +673,6 @@ interface UseClipSplittingResult {
  * ```tsx
  * const { splitClipAtPlayhead } = useClipSplitting({
  *   tracks,
- *   sampleRate,
  *   samplesPerPixel,
  *   engineRef: playoutRef,
  * });
@@ -806,10 +802,6 @@ interface UseAnnotationKeyboardControlsOptions {
     enabled?: boolean;
     /** Optional: scroll container ref for auto-scrolling to annotation */
     scrollContainerRef?: React.RefObject<HTMLDivElement | null>;
-    /** Optional: samples per pixel for scroll position calculation */
-    samplesPerPixel?: number;
-    /** Optional: sample rate for scroll position calculation */
-    sampleRate?: number;
     /** Optional: callback to start playback at a time with optional duration */
     onPlay?: (startTime: number, duration?: number) => void;
 }
@@ -844,7 +836,7 @@ interface UseAnnotationKeyboardControlsOptions {
  * });
  * ```
  */
-declare function useAnnotationKeyboardControls({ annotations, activeAnnotationId, onAnnotationsChange, onActiveAnnotationChange, duration, linkEndpoints, continuousPlay, enabled, scrollContainerRef, samplesPerPixel, sampleRate, onPlay, }: UseAnnotationKeyboardControlsOptions): {
+declare function useAnnotationKeyboardControls({ annotations, activeAnnotationId, onAnnotationsChange, onActiveAnnotationChange, duration, linkEndpoints, continuousPlay, enabled, scrollContainerRef, onPlay, }: UseAnnotationKeyboardControlsOptions): {
     moveStartBoundary: (delta: number) => void;
     moveEndBoundary: (delta: number) => void;
     selectPrevious: () => void;

package/dist/index.js

@@ -163,7 +163,7 @@ var Tone2 = __toESM(require("tone"));
 // src/WaveformPlaylistContext.tsx
 var import_react23 = require("react");
 var import_styled_components = require("styled-components");
-var import_playout4 = require("@waveform-playlist/playout");
+var import_playout5 = require("@waveform-playlist/playout");
 var import_engine3 = require("@waveform-playlist/engine");
 var import_ui_components2 = require("@waveform-playlist/ui-components");
 var import_tone4 = require("tone");
@@ -807,11 +807,11 @@ function useClipDragHandlers({
   tracks,
   onTracksChange,
   samplesPerPixel,
-  sampleRate,
   engineRef,
   isDraggingRef,
   snapSamplePosition
 }) {
+  const { sampleRate } = usePlaylistData();
   const snapSamplePositionRef = import_react9.default.useRef(snapSamplePosition);
   snapSamplePositionRef.current = snapSamplePosition;
   const originalClipStateRef = import_react9.default.useRef(null);
@@ -970,12 +970,13 @@ function useClipDragHandlers({
 
 // src/hooks/useAnnotationDragHandlers.ts
 var import_react10 = __toESM(require("react"));
+var import_playout = require("@waveform-playlist/playout");
 var LINK_THRESHOLD = 0.01;
 function useAnnotationDragHandlers({
   annotations,
   onAnnotationsChange,
   samplesPerPixel,
-  sampleRate,
+  sampleRate = (0, import_playout.getGlobalAudioContext)().sampleRate,
   duration,
   linkEndpoints
 }) {
@@ -1174,7 +1175,8 @@ function useDragSensors(options = {}) {
 var import_react12 = require("react");
 var import_engine2 = require("@waveform-playlist/engine");
 var useClipSplitting = (options) => {
-  const { tracks, sampleRate, engineRef } = options;
+  const { tracks, engineRef } = options;
+  const { sampleRate } = usePlaylistData();
   const { currentTimeRef } = usePlaybackAnimation();
   const { selectedTrackId } = usePlaylistState();
   const splitClipAt = (0, import_react12.useCallback)(
@@ -1199,7 +1201,7 @@ var useClipSplitting = (options) => {
       engine.splitClip(track.id, clip.id, snappedSplitSample);
       return true;
     },
-    [tracks, options, sampleRate, engineRef]
+    [tracks, options, engineRef, sampleRate]
   );
   const splitClipAtPlayhead = (0, import_react12.useCallback)(() => {
     var _a;
@@ -1357,10 +1359,9 @@ function useAnnotationKeyboardControls({
   continuousPlay = false,
   enabled = true,
   scrollContainerRef,
-  samplesPerPixel,
-  sampleRate,
   onPlay
 }) {
+  const { samplesPerPixel, sampleRate } = usePlaylistData();
   const activeIndex = (0, import_react15.useMemo)(() => {
     if (!activeAnnotationId) return -1;
     return annotations.findIndex((a) => a.id === activeAnnotationId);
@@ -2713,7 +2714,7 @@ function useTrackDynamicEffects() {
 
 // src/hooks/useExportWav.ts
 var import_react18 = require("react");
-var import_playout = require("@waveform-playlist/playout");
+var import_playout2 = require("@waveform-playlist/playout");
 
 // src/utils/wavEncoder.ts
 function encodeWav(audioBuffer, options = {}) {
@@ -2812,7 +2813,7 @@ function useExportWav() {
         if (mode === "individual" && (trackIndex === void 0 || trackIndex < 0 || trackIndex >= tracks.length)) {
           throw new Error("Invalid track index for individual export");
         }
-        const sampleRate = (0, import_playout.getGlobalAudioContext)().sampleRate;
+        const sampleRate = (0, import_playout2.getGlobalAudioContext)().sampleRate;
         let totalDurationSamples = 0;
         for (const track of tracks) {
           for (const clip of track.clips) {
@@ -2940,7 +2941,7 @@ function renderWithToneEffects(tracksToRender, _trackStates, hasSolo, duration,
               if (fadeIn) {
                 const fadeInStart = startTime;
                 const fadeInEnd = startTime + fadeIn.duration;
-                const audioParam = (0, import_playout.getUnderlyingAudioParam)(fadeGain.gain);
+                const audioParam = (0, import_playout2.getUnderlyingAudioParam)(fadeGain.gain);
                 if (audioParam) {
                   audioParam.setValueAtTime(0, fadeInStart);
                   audioParam.linearRampToValueAtTime(clipGain, fadeInEnd);
@@ -2949,7 +2950,7 @@ function renderWithToneEffects(tracksToRender, _trackStates, hasSolo, duration,
               if (fadeOut) {
                 const fadeOutStart = startTime + clipDuration - fadeOut.duration;
                 const fadeOutEnd = startTime + clipDuration;
-                const audioParam = (0, import_playout.getUnderlyingAudioParam)(fadeGain.gain);
+                const audioParam = (0, import_playout2.getUnderlyingAudioParam)(fadeGain.gain);
                 if (audioParam) {
                   audioParam.setValueAtTime(clipGain, fadeOutStart);
                   audioParam.linearRampToValueAtTime(0, fadeOutEnd);
@@ -3493,7 +3494,7 @@ function useWaveformDataCache(tracks, baseScale) {
 // src/hooks/useDynamicTracks.ts
 var import_react21 = require("react");
 var import_core2 = require("@waveform-playlist/core");
-var import_playout2 = require("@waveform-playlist/playout");
+var import_playout3 = require("@waveform-playlist/playout");
 function getSourceName(source) {
   var _a, _b, _c, _d, _e;
   if (source instanceof File) {
@@ -3544,7 +3545,7 @@ function useDynamicTracks() {
   }, []);
   const addTracks = (0, import_react21.useCallback)((sources) => {
     if (sources.length === 0) return;
-    const audioContext = (0, import_playout2.getGlobalAudioContext)();
+    const audioContext = (0, import_playout3.getGlobalAudioContext)();
     const placeholders = sources.map((source) => ({
       track: (0, import_core2.createTrack)({ name: `${getSourceName(source)} (loading...)`, clips: [] }),
       source
@@ -3615,7 +3616,7 @@ function useDynamicTracks() {
 
 // src/hooks/useOutputMeter.ts
 var import_react22 = require("react");
-var import_playout3 = require("@waveform-playlist/playout");
+var import_playout4 = require("@waveform-playlist/playout");
 var import_core3 = require("@waveform-playlist/core");
 var import_worklets = require("@waveform-playlist/worklets");
 var PEAK_DECAY = 0.98;
@@ -3643,7 +3644,7 @@ function useOutputMeter(options = {}) {
   (0, import_react22.useEffect)(() => {
     let isMounted = true;
     const setup = () => __async(null, null, function* () {
-      const context = (0, import_playout3.getGlobalContext)();
+      const context = (0, import_playout4.getGlobalContext)();
       const rawCtx = context.rawContext;
       yield rawCtx.audioWorklet.addModule(import_worklets.meterProcessorUrl);
       if (!isMounted) return;
@@ -3692,7 +3693,7 @@ function useOutputMeter(options = {}) {
       isMounted = false;
       if (workletNodeRef.current) {
         try {
-          const context = (0, import_playout3.getGlobalContext)();
+          const context = (0, import_playout4.getGlobalContext)();
           context.destination.chain();
         } catch (err) {
           console.warn("[waveform-playlist] Failed to restore destination chain:", String(err));
@@ -3802,7 +3803,7 @@ var WaveformPlaylistProvider = ({
   const prevTracksRef = (0, import_react23.useRef)([]);
   const samplesPerPixelRef = (0, import_react23.useRef)(initialSamplesPerPixel);
   const sampleRateRef = (0, import_react23.useRef)(
-    typeof AudioContext !== "undefined" ? (0, import_playout4.getGlobalAudioContext)().sampleRate : 48e3
+    typeof AudioContext !== "undefined" ? (0, import_playout5.getGlobalAudioContext)().sampleRate : 48e3
   );
   const { timeFormat, setTimeFormat, formatTime: formatTime2 } = useTimeFormat();
   const zoom = useZoomControls({ engineRef, initialSamplesPerPixel });
@@ -4039,7 +4040,7 @@ var WaveformPlaylistProvider = ({
         lastTracksVersionRef.current = 0;
         engineTracksRef.current = null;
         audioInitializedRef.current = false;
-        const adapter = (0, import_playout4.createToneAdapter)({ effects, soundFontCache: soundFontCacheRef.current });
+        const adapter = (0, import_playout5.createToneAdapter)({ effects, soundFontCache: soundFontCacheRef.current });
         const engine = new import_engine3.PlaylistEngine({
           adapter,
           samplesPerPixel: samplesPerPixelRef.current,
@@ -5436,7 +5437,7 @@ function useClipInteractionEnabled() {
 var import_react32 = require("react");
 var import_react_dom = require("react-dom");
 var import_styled_components6 = __toESM(require("styled-components"));
-var import_playout5 = require("@waveform-playlist/playout");
+var import_playout6 = require("@waveform-playlist/playout");
 var import_ui_components9 = require("@waveform-playlist/ui-components");
 
 // src/components/AnimatedPlayhead.tsx
@@ -5739,7 +5740,7 @@ var CustomPlayhead = ({ renderPlayhead, color, samplesPerPixel, sampleRate }) =>
     samplesPerPixel,
     sampleRate,
     controlsOffset: 0,
-    getAudioContextTime: () => (0, import_playout5.getGlobalContext)().rawContext.currentTime,
+    getAudioContextTime: () => (0, import_playout6.getGlobalContext)().rawContext.currentTime,
     getPlaybackTime
   });
 };
@@ -6726,7 +6727,6 @@ var MediaElementPlaylist = ({
     annotations,
     onAnnotationsChange: handleAnnotationUpdate,
     samplesPerPixel,
-    sampleRate,
     duration,
     linkEndpoints: linkEndpointsProp
   });
@@ -7032,7 +7032,7 @@ var KeyboardShortcuts = ({
   annotations = false,
   additionalShortcuts = []
 }) => {
-  const { tracks, samplesPerPixel, sampleRate, playoutRef, duration } = usePlaylistData();
+  const { tracks, samplesPerPixel, playoutRef, duration } = usePlaylistData();
   const {
     annotations: annotationList,
     linkEndpoints,
@@ -7042,7 +7042,6 @@ var KeyboardShortcuts = ({
   const { setAnnotations, setActiveAnnotationId, scrollContainerRef, play } = usePlaylistControls();
   const { splitClipAtPlayhead } = useClipSplitting({
     tracks,
-    sampleRate,
     samplesPerPixel,
     engineRef: playoutRef
   });
@@ -7070,8 +7069,6 @@ var KeyboardShortcuts = ({
     linkEndpoints,
     continuousPlay,
     scrollContainerRef,
-    samplesPerPixel,
-    sampleRate,
     onPlay: play,
     enabled: annotations && annotationList.length > 0
   });
@@ -7196,7 +7193,6 @@ var ClipInteractionProvider = ({
     tracks,
     onTracksChange: onTracksChange != null ? onTracksChange : NOOP_TRACKS_CHANGE,
     samplesPerPixel,
-    sampleRate,
     engineRef: playoutRef,
     isDraggingRef,
     snapSamplePosition