import type { Ref } from '@stacksjs/stx';
/**
 * Promise-based utility to wait for a ref to meet a condition.
 *
 * @param r - The reactive ref to watch
 * @returns A chainable instance with condition methods
 *
 * @example
 * ```ts
 * const ready = ref(false)
 * await until(ready).toBe(true)
 * ```
 */
export declare function until<T>(r: Ref<T>): UntilBaseInstance<T>;
export declare interface UntilToMatchOptions {
  timeout?: number
  throwOnTimeout?: boolean
}
export declare interface UntilBaseInstance<T> {
  toMatch: (condition: (v: T) => boolean, options?: UntilToMatchOptions) => Promise<T>
  toBe: (value: T, options?: UntilToMatchOptions) => Promise<T>
  toBeTruthy: (options?: UntilToMatchOptions) => Promise<T>
  toBeNull: (options?: UntilToMatchOptions) => Promise<T>
  toBeUndefined: (options?: UntilToMatchOptions) => Promise<T>
  toBeNaN: (options?: UntilToMatchOptions) => Promise<T>
  changed: (options?: UntilToMatchOptions) => Promise<T>
  not: {
    toBe: (value: T, options?: UntilToMatchOptions) => Promise<T>
    toBeTruthy: (options?: UntilToMatchOptions) => Promise<T>
    toBeNull: (options?: UntilToMatchOptions) => Promise<T>
    toBeUndefined: (options?: UntilToMatchOptions) => Promise<T>
    toBeNaN: (options?: UntilToMatchOptions) => Promise<T>
  }
}