@waveform-playlist/browser 6.0.1 → 7.0.0

package/dist/index.d.ts

@@ -1,10 +1,15 @@
+import { Analyser } from 'tone';
 import { BaseContext } from 'tone';
 import { default as default_2 } from 'react';
 import { default as default_3 } from 'waveform-data';
 import { DragEndEvent } from '@dnd-kit/core';
+import { DragMoveEvent } from '@dnd-kit/core';
+import { DragStartEvent } from '@dnd-kit/core';
 import { Fade as Fade_2 } from '@waveform-playlist/core';
 import { Gain } from 'tone';
+import { InputNode } from 'tone';
 import { MediaElementPlayout } from '@waveform-playlist/media-element-playout';
+import { Modifier } from '@dnd-kit/core';
 import { MutableRefObject } from 'react';
 import { Provider } from 'react';
 import react__default from 'react';
@@ -48,6 +53,32 @@ declare interface AnnotationActionOptions {
     [key: string]: unknown;
 }
 
+/**
+ * Props the browser package passes to the AnnotationBoxesWrapper component.
+ * Mirrors what PlaylistVisualization and MediaElementPlaylist actually use.
+ */
+declare interface AnnotationBoxesWrapperIntegrationProps {
+    children?: React.ReactNode;
+    height?: number;
+    width?: number;
+}
+
+/**
+ * Props the browser package passes to the AnnotationBox component.
+ * Mirrors what PlaylistVisualization and MediaElementPlaylist actually use.
+ */
+declare interface AnnotationBoxIntegrationProps {
+    annotationId: string;
+    annotationIndex: number;
+    startPosition: number;
+    endPosition: number;
+    label?: string;
+    color?: string;
+    isActive?: boolean;
+    onClick?: () => void;
+    editable?: boolean;
+}
+
 /**
  * Shared annotation types used across waveform-playlist packages
  */
@@ -71,9 +102,9 @@ export declare interface AnnotationData {
 export declare interface AnnotationIntegration {
     parseAeneas: (data: unknown) => AnnotationData;
     serializeAeneas: (annotation: AnnotationData) => unknown;
-    AnnotationText: React.ComponentType<any>;
-    AnnotationBox: React.ComponentType<any>;
-    AnnotationBoxesWrapper: React.ComponentType<any>;
+    AnnotationText: React.ComponentType<AnnotationTextIntegrationProps>;
+    AnnotationBox: React.ComponentType<AnnotationBoxIntegrationProps>;
+    AnnotationBoxesWrapper: React.ComponentType<AnnotationBoxesWrapperIntegrationProps>;
     ContinuousPlayCheckbox: React.ComponentType<{
         checked: boolean;
         onChange: (checked: boolean) => void;
@@ -98,6 +129,24 @@ export declare interface AnnotationIntegration {
 
 export declare const AnnotationIntegrationProvider: Provider<AnnotationIntegration | null>;
 
+/**
+ * Props the browser package passes to the AnnotationText component.
+ * Mirrors what PlaylistAnnotationList and MediaElementAnnotationList actually use.
+ */
+declare interface AnnotationTextIntegrationProps {
+    annotations: AnnotationData[];
+    activeAnnotationId?: string;
+    shouldScrollToActive?: boolean;
+    scrollActivePosition?: ScrollLogicalPosition;
+    scrollActiveContainer?: 'nearest' | 'all';
+    editable?: boolean;
+    controls?: AnnotationAction[];
+    annotationListConfig?: AnnotationActionOptions;
+    height?: number;
+    onAnnotationUpdate?: (updatedAnnotations: AnnotationData[]) => void;
+    renderAnnotationItem?: (props: RenderAnnotationItemProps) => React.ReactNode;
+}
+
 /**
  * Represents a single audio clip on the timeline
  *
@@ -286,8 +335,8 @@ export declare const ContinuousPlayCheckbox: default_2.FC<{
  * Create a chain of effects connected in series
  */
 export declare function createEffectChain(effects: EffectInstance[]): {
-    input: any;
-    output: any;
+    input: ToneAudioNode;
+    output: ToneAudioNode;
     dispose: () => void;
 };
 
@@ -360,13 +409,13 @@ export declare interface EffectDefinition {
 export declare const effectDefinitions: EffectDefinition[];
 
 export declare interface EffectInstance {
-    effect: any;
+    effect: ToneAudioNode;
     id: string;
     instanceId: string;
     dispose: () => void;
     setParameter: (name: string, value: number | string | boolean) => void;
     getParameter: (name: string) => number | string | boolean | undefined;
-    connect: (destination: any) => void;
+    connect: (destination: InputNode) => void;
     disconnect: () => void;
 }
 
@@ -728,7 +777,7 @@ declare interface MediaElementPlaylistProviderProps {
     };
     /** Annotations */
     annotationList?: {
-        annotations?: any[];
+        annotations?: AnnotationData[];
         isContinuousPlay?: boolean;
     };
     /** Width of waveform bars */
@@ -957,7 +1006,7 @@ declare interface PlaylistDataContextValue {
     };
     playoutRef: default_2.RefObject<TonePlayout | null>;
     samplesPerPixel: number;
-    timeFormat: string;
+    timeFormat: TimeFormat;
     masterVolume: number;
     canZoomIn: boolean;
     canZoomOut: boolean;
@@ -1383,16 +1432,8 @@ declare interface TrackState_2 {
  * ```
  */
 export declare function useAnnotationDragHandlers({ annotations, onAnnotationsChange, samplesPerPixel, sampleRate, duration, linkEndpoints, }: UseAnnotationDragHandlersOptions): {
-    onDragStart: (event: {
-        active: any;
-    }) => void;
-    onDragMove: (event: {
-        active: any;
-        delta: {
-            x: number;
-            y: number;
-        };
-    }) => void;
+    onDragStart: (event: DragStartEvent) => void;
+    onDragMove: (event: DragMoveEvent) => void;
     onDragEnd: () => void;
 };
 
@@ -1568,24 +1609,10 @@ declare interface UseAudioTracksOptions {
  * ```
  */
 export declare function useClipDragHandlers({ tracks, onTracksChange, samplesPerPixel, sampleRate, }: UseClipDragHandlersOptions): {
-    onDragStart: (event: {
-        active: any;
-    }) => void;
-    onDragMove: (event: {
-        active: any;
-        delta: {
-            x: number;
-            y: number;
-        };
-    }) => void;
+    onDragStart: (event: DragStartEvent) => void;
+    onDragMove: (event: DragMoveEvent) => void;
     onDragEnd: (event: DragEndEvent) => void;
-    collisionModifier: (args: {
-        transform: {
-            x: number;
-            y: number;
-        };
-        active: any;
-    }) => {
+    collisionModifier: (args: Parameters<Modifier>[0]) => {
         scaleX: number;
         scaleY: number;
         x: number;
@@ -1680,7 +1707,7 @@ export declare interface UseDynamicEffectsReturn {
      * This creates new effect instances that work in the offline AudioContext.
      */
     createOfflineEffectsFunction: () => EffectsFunction | undefined;
-    analyserRef: React.RefObject<any>;
+    analyserRef: React.RefObject<Analyser | null>;
 }
 
 /**
@@ -1742,7 +1769,7 @@ declare interface UseKeyboardShortcutsOptions {
  * For more advanced effects (reverb, delay, filters, etc.), use useDynamicEffects instead.
  */
 export declare const useMasterAnalyser: (fftSize?: number) => {
-    analyserRef: MutableRefObject<any>;
+    analyserRef: MutableRefObject<Analyser | null>;
     masterEffects: EffectsFunction;
 };
 
@@ -1889,8 +1916,6 @@ export declare interface UseTrackDynamicEffectsReturn {
     availableEffects: EffectDefinition[];
 }
 
-export declare const useWaveformPlaylist: () => WaveformPlaylistContextValue;
-
 export declare function useZoomControls({ initialSamplesPerPixel, zoomLevels, }: UseZoomControlsProps): ZoomControls;
 
 declare interface UseZoomControlsProps {
@@ -1994,59 +2019,6 @@ declare interface WaveformGradient {
     stops: GradientStop[];
 }
 
-export declare interface WaveformPlaylistContextValue {
-    isPlaying: boolean;
-    currentTime: number;
-    duration: number;
-    audioBuffers: AudioBuffer[];
-    peaksDataArray: TrackClipPeaks[];
-    trackStates: TrackState[];
-    annotations: AnnotationData[];
-    activeAnnotationId: string | null;
-    selectionStart: number;
-    selectionEnd: number;
-    isAutomaticScroll: boolean;
-    continuousPlay: boolean;
-    linkEndpoints: boolean;
-    annotationsEditable: boolean;
-    play: (startTime?: number, playDuration?: number) => Promise<void>;
-    pause: () => void;
-    stop: () => void;
-    setCurrentTime: (time: number) => void;
-    setTrackMute: (trackIndex: number, muted: boolean) => void;
-    setTrackSolo: (trackIndex: number, soloed: boolean) => void;
-    setTrackVolume: (trackIndex: number, volume: number) => void;
-    setTrackPan: (trackIndex: number, pan: number) => void;
-    setSelection: (start: number, end: number) => void;
-    timeFormat: string;
-    setTimeFormat: (format: TimeFormat) => void;
-    formatTime: (seconds: number) => string;
-    samplesPerPixel: number;
-    zoomIn: () => void;
-    zoomOut: () => void;
-    canZoomIn: boolean;
-    canZoomOut: boolean;
-    masterVolume: number;
-    setMasterVolume: (volume: number) => void;
-    setAutomaticScroll: (enabled: boolean) => void;
-    setScrollContainer: (element: HTMLDivElement | null) => void;
-    setContinuousPlay: (enabled: boolean) => void;
-    setLinkEndpoints: (enabled: boolean) => void;
-    setAnnotationsEditable: (enabled: boolean) => void;
-    setAnnotations: default_2.Dispatch<default_2.SetStateAction<AnnotationData[]>>;
-    setActiveAnnotationId: (id: string | null) => void;
-    playoutRef: default_2.RefObject<TonePlayout | null>;
-    currentTimeRef: default_2.RefObject<number>;
-    sampleRate: number;
-    waveHeight: number;
-    timeScaleHeight: number;
-    minimumPlaylistHeight: number;
-    controls: {
-        show: boolean;
-        width: number;
-    };
-}
-
 export declare const WaveformPlaylistProvider: default_2.FC<WaveformPlaylistProviderProps>;
 
 declare interface WaveformPlaylistProviderProps {
@@ -2063,11 +2035,11 @@ declare interface WaveformPlaylistProviderProps {
         width: number;
     };
     annotationList?: {
-        annotations?: any[];
+        annotations?: AnnotationData[];
         editable?: boolean;
         isContinuousPlay?: boolean;
         linkEndpoints?: boolean;
-        controls?: any[];
+        controls?: AnnotationAction[];
     };
     effects?: EffectsFunction;
     onReady?: () => void;