import { default as React } from 'react';
/**
 * Defines the directional axis used for keyboard focus navigation.
 *
 * @category Hooks
 */
export type FocusOrientation = 'vertical' | 'horizontal';
/**
 * Moves DOM focus between registered elements of a group.
 *
 * Enables Arrow, Home, and End key navigation across registered items
 * using vertical or horizontal orientation. Skips disabled items and
 * follows the real DOM order.
 *
 * @remarks
 * Does not manage `tabIndex` — the consuming component owns it.
 *
 * @param orientation Navigation direction. Default: 'vertical'.
 * @param loop Whether focus should wrap around. Default: true.
 *
 * @returns Object containing register, unregister, and onKeyDown handlers.
 *
 * @example
 * const nav = useFocusNavigation('vertical');
 *
 * <button ref={nav.register} onKeyDown={nav.onKeyDown} />
 *
 * @category Hooks
 */
export declare function useFocusNavigation(orientation?: FocusOrientation, loop?: boolean): {
    register: (el: HTMLElement | null) => void;
    unregister: (el: HTMLElement | null) => void;
    onKeyDown: (e: React.KeyboardEvent<HTMLElement>) => void;
};