@waveform-playlist/browser 9.2.1 → 9.3.0

package/dist/index.d.ts

@@ -296,6 +296,18 @@ declare interface ClipCollisionOptions {
     samplesPerPixel: number;
 }
 
+export declare const ClipInteractionProvider: default_2.FC<ClipInteractionProviderProps>;
+
+export declare interface ClipInteractionProviderProps {
+    /** Enable snap-to-grid for clip moves and boundary trims. When true,
+     *  auto-detects beats snapping from BeatsAndBarsProvider context
+     *  (if present with scaleMode="beats" and snapTo!="off"), otherwise
+     *  falls back to timescale-based snapping. Default: false. */
+    snap?: boolean;
+    touchOptimized?: boolean;
+    children: default_2.ReactNode;
+}
+
 declare interface ClipPeaks {
     clipId: string;
     trackName: string;
@@ -1081,6 +1093,7 @@ declare interface PlaylistDataContextValue {
     /** Ref set by useClipDragHandlers during boundary trim drags.
      *  When true, loadAudio skips engine rebuild — visual updates flow via React state only. */
     isDraggingRef: default_2.MutableRefObject<boolean>;
+    onTracksChange: ((tracks: ClipTrack[]) => void) | undefined;
 }
 
 declare interface PlaylistStateContextValue {
@@ -1205,7 +1218,7 @@ declare interface SnapToGridBeatsOptions {
  *
  * Two modes:
  * - "beats": Snaps to beat/bar grid using PPQN tick space for exact musical timing.
- * - "temporal": Snaps to a sample-based grid derived from timescale markers.
+ * - "timescale": Snaps to a sample-based grid derived from timescale markers.
  *
  * Designed to compose with ClipCollisionModifier — snap first,
  * then collision constrains the snapped position.
@@ -1215,13 +1228,13 @@ export declare class SnapToGridModifier extends Modifier<DragDropManager<any, an
         x: number;
         y: number;
     };
-    static configure: (options: SnapToGridBeatsOptions | SnapToGridTemporalOptions) => PluginDescriptor<any, any, typeof SnapToGridModifier>;
+    static configure: (options: SnapToGridBeatsOptions | SnapToGridTimescaleOptions) => PluginDescriptor<any, any, typeof SnapToGridModifier>;
 }
 
-declare type SnapToGridOptions = SnapToGridBeatsOptions | SnapToGridTemporalOptions;
+declare type SnapToGridOptions = SnapToGridBeatsOptions | SnapToGridTimescaleOptions;
 
-declare interface SnapToGridTemporalOptions {
-    mode: 'temporal';
+declare interface SnapToGridTimescaleOptions {
+    mode: 'timescale';
     gridSamples: number;
     samplesPerPixel: number;
 }
@@ -1756,6 +1769,8 @@ declare interface UseClipDragHandlersOptions {
     snapSamplePosition?: (samplePosition: number) => number;
 }
 
+export declare function useClipInteractionEnabled(): boolean;
+
 /**
  * Hook for splitting clips at the playhead or at a specific time
  *