import { RefObject } from 'react';
/**
 * Manual Tab-cycling focus trap for a modal-like panel that (unlike `StyledDialog`) can't use the
 * native `<dialog>` `showModal()` trap — e.g. a panel that's only modal in ONE of its states
 * (`MinimizableDialog`'s fullscreen mode), where the rest of the time it's a non-modal floating
 * widget that must NOT trap focus. Moves external focus into the container but retains focus on an
 * in-panel control that activated the trap (such as an Enter Fullscreen button), cycles Tab/Shift+Tab
 * among its focusable descendants while `active`, restores focus to the trigger on deactivation,
 * and calls `onEscape` on the Escape key (mirroring `StyledDialog`'s ESC-to-close).
 */
export declare const useFocusTrap: (active: boolean, containerRef: RefObject<HTMLElement | null>, onEscape?: () => void) => void;