import { type RefObject } from "react";
/**
 * Traps focus within a container element when active.
 * - On Tab at the last focusable element, focus wraps to the first.
 * - On Shift+Tab at the first focusable element, focus wraps to the last.
 * - Auto-focuses the first focusable element when activated.
 */
export declare function useFocusTrap(containerRef: RefObject<HTMLElement | null>, active: boolean): void;