/**
 * Hook para manejar un contenedor global para popovers cuando se requiere que el anchorElement
 * mantenga el foco mientras el popover está abierto.
 *
 * PROPÓSITO:
 * Este hook crea y gestiona un contenedor DOM personalizado para popovers. Es especialmente útil
 * cuando necesitas que el elemento ancla (anchorElement) mantenga el foco mientras el popover
 * está visible, evitando que el foco se mueva automáticamente al popover.
 *
 * FUNCIONAMIENTO:
 * 1. Busca un contenedor existente en el DOM con el ID especificado
 * 2. Si no existe y `createContainer` es `true`, crea un nuevo contenedor y lo añade al body
 * 3. Retorna una referencia al contenedor que debe pasarse a la prop `container` del Popover
 *
 * IMPORTANTE - TIMING Y RE-RENDERS:
 * Este hook utiliza un re-render forzado para garantizar que el Popover se renderice con la
 * referencia correcta del contenedor. Ver la documentación dentro del código para más detalles
 * sobre por qué esto es necesario y qué ocurre si no se realiza.
 * @param containerId ID único para el contenedor. Si no se proporciona, usa POPOVER_CONTAINER_ID por defecto
 * @param createContainer Si es `true`, crea el contenedor si no existe. Si es `false`, solo busca uno existente
 * @returns Referencia (ref) al contenedor del popover que debe pasarse a la prop `container` del Popover
 * @example
 * ```tsx
 * const containerId = useId();
 * const popoverContainerRef = usePopoverContainer(containerId, !!isOpen);
 *
 * return (
 *   <Popover
 *     open={isOpen}
 *     container={popoverContainerRef.current} // Pasa la referencia aquí
 *   >
 *     {/* contenido del popover *\/}
 *   </Popover>
 * );
 * ```
 */
export declare function usePopoverContainer(createContainer: boolean): HTMLDivElement | null;
//# sourceMappingURL=usePopoverContainer.d.ts.map