Listening on pointerdown (capture phase) catches the press before any click handler inside the popover runs, which avoids race conditions with stopPropagation. The hook bails out early if the target lives inside ref.current, which uses the DOM Node.contains check. Capture phase plus pointerdown also handles touch correctly without a separate listener. This is the right shape for popovers, autocomplete dropdowns, and any UI that should dismiss on a click anywhere else.

When the trigger button lives outside the panel (a portal-rendered popover, a tooltip with a separate target), clicking the trigger should reopen rather than dismiss. The ignore list is a list of refs that count as 'still inside' for dismissal purposes. The order of checks matters: bail out for the panel first (cheap), then walk the ignore list. This is the same shape Radix and Headless UI use under the hood, just compressed into a few lines for cases where you do not want a full library.

Outside-click and Escape-key dismissal almost always go together: a user expects either gesture to close the same UI. Wrapping both into one useDismiss hook keeps consumers from forgetting one. Listening on keydown (not keypress, which is deprecated) catches the modifier even when an input inside the popover has focus. Together with the focus-trap pattern, this trio is the basic accessibility contract for any dismissable overlay.