import { RefObject } from 'react';
/**
 * Options for the useFocusTrap hook.
 *
 * @category Hooks
 */
export interface UseFocusTrapOptions {
    /** Root element used as focus boundary. */
    ref: RefObject<HTMLElement | null>;
    /** Enables or disables the focus trap. */
    enabled?: boolean;
    /** Moves focus inside on mount when not already inside. */
    autoFocus?: boolean;
}
/**
 * Focus trap for modal containers.
 *
 * Keeps keyboard focus inside the given element.
 * Handles Tab loop and restores focus on unmount.
 * Also redirects focus back when returning from outside the document.
 *
 * Behavior:
 * - traps Tab navigation within the root element
 * - moves focus to element with data-autofocus or first focusable on mount
 * - restores previous focus on cleanup
 *
 * @function
 * @param options
 *
 * @category Hooks
 */
export declare const useFocusTrap: ({ ref, enabled, autoFocus }: UseFocusTrapOptions) => void;