export type KeyboardModifiers = {
    /** Whether the Alt key is pressed */
    alt?: boolean;
    /** Whether the Ctrl key is pressed */
    ctrl?: boolean;
    /** Whether the Meta (Cmd) key is pressed */
    meta?: boolean;
    /** Whether the Shift key is pressed */
    shift?: boolean;
};
export type HotkeyItem = [
    /** key combination like 'mod+k', 'escape', 'ctrl+j' */
    string,
    /** handler function */
    (event: KeyboardEvent) => void,
    /** optional modifiers override */
    KeyboardModifiers?,
    /** optional description */
    string[]?
];
export declare function useHotkeys(hotkeys: HotkeyItem[], dependencies?: React.DependencyList): void;
declare class GlobalHotkeyManager {
    private hotkeys;
    private isListening;
    private currentAppState;
    private appStateSubscription?;
    private visibilityCleanup?;
    constructor();
    register(id: string, hotkey: HotkeyItem): void;
    unregister(id: string): void;
    private handleAppStateChange;
    private isForeground;
    private syncListening;
    private handleKeyDown;
    dispose(): void;
}
export declare const globalHotkeys: GlobalHotkeyManager;
export declare function useGlobalHotkeys(id: string, hotkey: HotkeyItem): void;
export declare function useEscapeKey(handler: () => void, enabled?: boolean): void;
export declare function useToggleColorScheme(handler: () => void, enabled?: boolean): void;
export declare function useSpotlightToggle(handler: () => void, enabled?: boolean): void;
export {};