import type { Ref } from 'vue';
/**
 * Result returned by the useFocusTrap composable.
 */
export interface UseFocusTrapReturn {
    /** Initializes and activates the focus trap on the referenced element */
    initializeFocusTrap: () => void;
    /** Disables and cleans the focus trap */
    cleanupFocusTrap: () => void;
}
/**
 * Vue composable to manage a focus trap on a DOM element.
 *
 * This composable uses the [focus-trap](https://github.com/focus-trap/focus-trap) library
 * to enclose keyboard navigation within a given element (e.g., a modal).
 *
 * @param elementRef Reference to the DOM element to trap (focus trap)
 * @param onClose Callback function called when the focus trap is disabled (e.g., closing)
 *
 * @returns {UseFocusTrapReturn} Object containing the functions to manage the focus trap:
 *  - `initializeFocusTrap`: Enables the focus trap,
 *  - `cleanupFocusTrap`: Disables and cleans the focus trap.
 *
 */
export declare function useFocusTrap(elementRef: Ref<HTMLElement | null>, onClose: () => void): UseFocusTrapReturn;