/**
 * Utilities for determining visual stacking order of DOM elements
 */
/**
 * Checks if a target element is visually stacked above a reference element.
 *
 * This function uses `document.elementsFromPoint()` to get the actual visual
 * stacking order at a specific coordinate, which accounts for all CSS properties
 * (z-index, stacking contexts, position, transform, opacity, etc.).
 *
 * @param targetElement - The element to check (e.g., the clicked element)
 * @param referenceElement - The element to compare against (e.g., modal overlay)
 * @param clientX - X coordinate of the interaction
 * @param clientY - Y coordinate of the interaction
 * @returns true if target is above reference in the visual stacking order
 *
 * @example
 * ```tsx
 * const isAboveModal = isElementStackedAbove(
 *   clickedElement,
 *   modalOverlay,
 *   event.clientX,
 *   event.clientY
 * )
 * if (isAboveModal) {
 *   // Don't close modal - user clicked on something above it
 *   event.preventDefault()
 * }
 * ```
 */
export declare function isElementStackedAbove(targetElement: Element | null, referenceElement: Element | null, clientX: number, clientY: number): boolean;