import { type HookErrorHandler } from '../utils/errors.js';
/** Controls the deterministic value used when matchMedia is unavailable. @public */
export interface MediaQueryOptions {
    /** The value returned during SSR or when matchMedia is unavailable. */
    readonly defaultMatches?: boolean;
    /** Observes browser API failures after the client subscription is attempted. */
    readonly onError?: HookErrorHandler;
}
/**
 * Subscribes to a CSS media query, sharing one native listener per query and
 * browser realm. `defaultMatches` is used when rendering without matchMedia.
 * @public
 */
export declare function useMediaQuery(query: string, options?: MediaQueryOptions): boolean;