/**
 * useKeyboardNavigation Hook
 *
 * Shared focus management for navigable component lists.
 * Handles arrow keys, Enter/Space, Escape, Home/End.
 * Provides visible focus indicators via CSS variables.
 */
export interface KeyboardNavigationOptions {
    /** Total number of items in the list */
    itemCount: number;
    /** Orientation: 'vertical' for up/down, 'horizontal' for left/right */
    orientation?: 'vertical' | 'horizontal';
    /** Whether navigation wraps around at boundaries */
    wrap?: boolean;
    /** Callback when an item is selected (Enter/Space) */
    onSelect?: (index: number) => void;
    /** Callback when Escape is pressed */
    onEscape?: () => void;
    /** Callback when Delete/Backspace is pressed on focused item */
    onDelete?: (index: number) => void;
    /** Whether keyboard navigation is enabled */
    enabled?: boolean;
}
export interface UseKeyboardNavigationReturn {
    /** Currently focused item index (-1 = none) */
    activeIndex: number;
    /** Set active index programmatically */
    setActiveIndex: (index: number) => void;
    /** Props to spread onto the container element */
    containerProps: {
        tabIndex: number;
        role: string;
        'aria-activedescendant': string | undefined;
        onKeyDown: (e: React.KeyboardEvent) => void;
        onBlur: () => void;
    };
    /** Get props for an individual item */
    getItemProps: (index: number) => {
        id: string;
        role: string;
        tabIndex: number;
        'aria-selected': boolean;
        onMouseEnter: () => void;
        onFocus: () => void;
        style: React.CSSProperties;
    };
    /** Whether any item is currently focused */
    hasFocus: boolean;
}
export declare const useKeyboardNavigation: (options: KeyboardNavigationOptions) => UseKeyboardNavigationReturn;
//# sourceMappingURL=useKeyboardNavigation.d.ts.map