@waveform-playlist/browser 6.0.0 → 6.0.2

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;
 };
 
@@ -2018,7 +2045,7 @@ export declare interface WaveformPlaylistContextValue {
     setTrackVolume: (trackIndex: number, volume: number) => void;
     setTrackPan: (trackIndex: number, pan: number) => void;
     setSelection: (start: number, end: number) => void;
-    timeFormat: string;
+    timeFormat: TimeFormat;
     setTimeFormat: (format: TimeFormat) => void;
     formatTime: (seconds: number) => string;
     samplesPerPixel: number;
@@ -2063,11 +2090,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;