/**
 * @fileoverview Detect clicks outside a referenced element.
 * @author Saasflare™
 * @module packages/ui/hooks/use-click-outside
 * @package ui
 *
 * @example
 * const ref = useRef<HTMLDivElement>(null);
 * useClickOutside(ref, () => setOpen(false));
 * return <div ref={ref}>Dropdown content</div>;
 */
import { type RefObject } from 'react';
/**
 * Calls the handler when a click or touch occurs outside the referenced element.
 *
 * @param {RefObject<HTMLElement | null>} ref - The element to detect outside clicks for
 * @param {(event: MouseEvent | TouchEvent) => void} handler - Called on outside click
 * @param {boolean} [enabled=true] - Whether the listener is active
 *
 * @example
 * const menuRef = useRef<HTMLDivElement>(null);
 * useClickOutside(menuRef, handleClose, isMenuOpen);
 */
export declare function useClickOutside(ref: RefObject<HTMLElement | null>, handler: (event: MouseEvent | TouchEvent) => void, enabled?: boolean): void;