import * as React$1 from "react";
//#region src/hooks/use-contained-handler.d.ts
type ContainmentRoot = {
  contains: (target: Node) => boolean;
};
/**
 * Wrap a React event handler so it only fires when the event target
 * is a DOM descendant of the given ref.
 *
 * React forwards synthetic events through the parent React tree even
 * when descendants are rendered via createPortal. That makes it unsafe
 * for a parent element to attach `onMouseDown`, `onClick`, `onFocus`,
 * etc. that side-effect (focus steal, preventDefault, selection changes)
 * under the assumption "the target lives inside me" — a portaled popup
 * (Dialog, Combobox, Tooltip) silently bypasses the DOM boundary and
 * triggers the side effect, dismissing itself.
 *
 * Only use for event types whose `target` is the meaningful subject of
 * the event: pointer/mouse/touch/click and `focus`. Do **not** wrap
 * `onBlur`: blur's `target` is the element losing focus, not the new
 * focus destination, so the containment test cannot answer "is focus
 * leaving for a portaled child?". For that case test `relatedTarget`
 * directly inside the handler.
 *
 * The `require-contained-handler` oxlint rule enforces this on any JSX
 * element carrying both `ref={…}` and one of the watched handler props;
 * `containedEventHandler` covers elements that do not otherwise need a ref.
 *
 * @example
 *   const barRef = useRef<HTMLDivElement>(null);
 *   return (
 *     <div
 *       ref={barRef}
 *       onMouseDown={containedHandler(barRef, (e) => {
 *         e.preventDefault();
 *         focusEditor();
 *       })}
 *     >
 *       ...
 *     </div>
 *   );
 */
export declare const containedHandler: <E extends {
  target: unknown;
}>(ref: React$1.RefObject<ContainmentRoot | null> | null | undefined, handler: ((event: E) => void) | undefined) => (event: E) => void;
/**
 * Contain a synchronous JSX handler to its own DOM subtree without a ref.
 * Prefer this form when the element does not otherwise need a ref.
 */
export declare const containedEventHandler: <E extends {
  currentTarget: unknown;
  target: unknown;
}>(handler: (event: E) => void) => (event: E) => void;
//#endregion