@waveform-playlist/browser 5.0.0-alpha.11 → 5.0.0-alpha.13

package/dist/index.d.ts

@@ -50,7 +50,7 @@ declare interface AnnotationActionOptions {
     [key: string]: unknown;
 }
 
-declare interface AnnotationData {
+export declare interface AnnotationData {
     id: string;
     start: number;
     end: number;
@@ -673,6 +673,17 @@ declare interface PlaylistStateContextValue {
     loopEnd: number;
 }
 
+/**
+ * Props passed to the renderAnnotationItem function for custom rendering
+ */
+export declare interface RenderAnnotationItemProps {
+    annotation: AnnotationData;
+    index: number;
+    isActive: boolean;
+    onClick: () => void;
+    formatTime: (seconds: number) => string;
+}
+
 /**
  * Type for custom playhead render functions.
  * Receives position, color, and animation refs for smooth 60fps animation.
@@ -1653,6 +1664,22 @@ export declare interface WaveformProps {
     annotationControls?: AnnotationAction[];
     annotationListConfig?: AnnotationActionOptions;
     annotationTextHeight?: number;
+    /**
+     * Custom render function for annotation items in the text list.
+     * Use this to completely customize how each annotation is displayed.
+     */
+    renderAnnotationItem?: (props: RenderAnnotationItemProps) => ReactNode;
+    /**
+     * Custom function to generate the label shown on annotation boxes in the waveform.
+     * Receives the annotation data and should return a string label.
+     * Default: annotation.id
+     */
+    getAnnotationBoxLabel?: (annotation: {
+        id: string;
+        start: number;
+        end: number;
+        lines: string[];
+    }) => string;
     className?: string;
     showClipHeaders?: boolean;
     interactiveClips?: boolean;