import { type RefObject } from 'react';
/**
 * Hook that manages focus trapping within a container.
 *
 * @remarks
 * This hook ensures keyboard navigation stays within the container
 * while it's active, improving accessibility for modal dialogs.
 *
 * @param shouldTrap - Boolean indicating whether focus should be trapped
 * @param containerRef - Reference to the container element
 *
 * @public
 */
export declare function useFocusTrap(shouldTrap: boolean, containerRef: RefObject<HTMLElement | null> | null): void;