import type { Ref } from '@stacksjs/stx';
/**
 * Auto-tracked ref history with undo/redo.
 * Automatically commits a snapshot on every change to the source ref.
 *
 * @param source - The reactive source to track
 * @param options - Capacity limit, deep watching, and clone behavior
 */
export declare function useRefHistory<T>(source: Ref<T>, options?: UseRefHistoryOptions): UseRefHistoryReturn<T>;
export declare interface UseRefHistoryRecord<T> {
  snapshot: T
  timestamp: number
}
export declare interface UseRefHistoryOptions {
  capacity?: number
  deep?: boolean
  clone?: boolean
}
export declare interface UseRefHistoryReturn<T> {
  history: Ref<UseRefHistoryRecord<T>[]>
  commit: () => void
  undo: () => void
  redo: () => void
  canUndo: Ref<boolean>
  canRedo: Ref<boolean>
  clear: () => void
  last: Ref<UseRefHistoryRecord<T>>
}