export type UseHotKeyTarget = Document | HTMLElement | null | undefined;
export interface UseHotKeyOptions {
    /**
     * Target to listen on. Defaults to `document` when available.
     */
    target?: UseHotKeyTarget;
    /**
     * Keyboard event type.
     * @default 'keydown'
     */
    event?: 'keydown' | 'keyup' | 'keypress';
    /**
     * Enables or disables the listener.
     * @default true
     */
    when?: boolean;
}
/**
 * Runs the provided handler when any of the given keys is pressed.
 *
 * @param keys A single key or an array of keys to listen for (e.g. 'k' or 'ctrl+k').
 * @param handler Callback fired when a matching key event occurs.
 * @param options Optional configuration for target, event type, and enable flag.
 */
export declare function useHotKey(keys: string | string[], handler: (event: KeyboardEvent) => void, options?: UseHotKeyOptions): void;