interface ShortcutProps {
    /** Key combination (e.g., ['Ctrl', 'K'] or ['Meta', 'Shift', 'P']) */
    keys: string[];
    /** Callback when the shortcut is triggered */
    onTrigger: () => void;
    /** Whether the shortcut is enabled */
    enabled?: boolean;
    /** Prevent default browser behavior */
    preventDefault?: boolean;
}
interface KeyboardShortcutAPI {
    /** Handle a keyboard event (returns true if it matched) */
    handler(event: KeyboardEvent): boolean;
    /** Human-readable display of the shortcut */
    display: string;
    /** Platform-aware display (uses command symbol on Mac) */
    platformDisplay: string;
    /** Whether the shortcut is currently enabled */
    enabled: boolean;
    /** The key combination */
    keys: string[];
    /** ARIA props for a visual shortcut badge */
    badgeAriaProps: Record<string, unknown>;
}
declare function formatShortcut(keys: string[], mac?: boolean): string;
declare function createKeyboardShortcut(props: ShortcutProps): KeyboardShortcutAPI;
declare const SANE_DEFAULTS: Record<string, string[]>;
declare class ShortcutRegistry {
    private shortcuts;
    register(keys: string[], handler: () => void): void;
    unregister(keys: string[]): void;
}
declare const globalShortcutRegistry: ShortcutRegistry;
declare class AltHintState {
    private showHints;
    private listeners;
    private initialized;
    init(): void;
    private setShowHints;
    subscribe(listener: (show: boolean) => void): () => void;
    get snapshot(): boolean;
}
declare const altHintState: AltHintState;

declare const shortcutBadgeStyles = "inline-flex items-center gap-0.5 rounded border bg-muted px-1.5 py-0.5 text-xs font-mono text-muted-foreground";
declare const shortcutKeyStyles = "inline-flex items-center justify-center min-w-[1.25rem] rounded bg-background px-1 py-0.5 text-xs font-mono border shadow-sm";
declare const shortcutSeparatorStyles = "text-muted-foreground text-xs";

export { AltHintState, type KeyboardShortcutAPI, SANE_DEFAULTS, type ShortcutProps, ShortcutRegistry, altHintState, createKeyboardShortcut, formatShortcut, globalShortcutRegistry, shortcutBadgeStyles, shortcutKeyStyles, shortcutSeparatorStyles };
