react-aria 3.50.0 → 3.51.0

package/dist/private/tooltip/usePreviewTrigger.mjs

@@ -0,0 +1,207 @@
+import {focusWithoutScrolling as $1969ac565cfec8d0$export$de79e2c695e052f3} from "../utils/focusWithoutScrolling.mjs";
+import {getActiveElement as $23f2114a1b82827e$export$cd4e5573fbe2b576, nodeContains as $23f2114a1b82827e$export$4282f70798064fe0} from "../utils/shadowdom/DOMFunctions.mjs";
+import {getFocusableTreeWalker as $535772f9d2c1f38d$export$2d6ec8fc375ceafa} from "../focus/FocusScope.mjs";
+import {getInteractionModality as $8f5a2122b0992be3$export$630ff653c5ada6a9, useFocusVisibleListener as $8f5a2122b0992be3$export$ec71b4b83ac08ec3, useInteractionModality as $8f5a2122b0992be3$export$98e20ec92f614cfe} from "../interactions/useFocusVisible.mjs";
+import {getOwnerDocument as $d447af545b77c9f1$export$b204af158042fbac} from "../utils/domHelpers.mjs";
+import $cuAD7$intlStringsmjs from "./intlStrings.mjs";
+import {mergeProps as $bbaa08b3cd72f041$export$9d1611c77c2fe928} from "../utils/mergeProps.mjs";
+import {useEffectEvent as $fe16bffc7a557bf0$export$7f54fc3180508a52} from "../utils/useEffectEvent.mjs";
+import {useEvent as $600b3cf69ae46262$export$90fc3a17d93f704c} from "../utils/useEvent.mjs";
+import {useHover as $e969f22b6713ca4a$export$ae780daf29e6d456} from "../interactions/useHover.mjs";
+import {useId as $390e54f620492c70$export$f680877a34711e37} from "../utils/useId.mjs";
+import {useLocalizedStringFormatter as $cf2482eff2eeeec2$export$f12b703ca79dfbb1} from "../i18n/useLocalizedStringFormatter.mjs";
+import {useLongPress as $7b01448eaad0fe7c$export$c24ed0104d07eab9} from "../interactions/useLongPress.mjs";
+import {useSafeArea as $80d0af5af0c3b3bd$export$c7bf694416f38471} from "./useSafeArea.mjs";
+import {useRef as $cuAD7$useRef, useEffect as $cuAD7$useEffect} from "react";
+
+
+function $parcel$interopDefault(a) {
+  return a && a.__esModule ? a.default : a;
+}
+/*
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+function $dab43360cbeb70e5$export$cfc4af0616336448(props, state) {
+    let { triggerRef: triggerRef, popoverRef: popoverRef, isDisabled: isDisabled } = props;
+    let stringFormatter = (0, $cf2482eff2eeeec2$export$f12b703ca79dfbb1)((0, ($parcel$interopDefault($cuAD7$intlStringsmjs))), '@react-aria/link-preview');
+    let popoverId = (0, $390e54f620492c70$export$f680877a34711e37)();
+    // Suppresses the next focus from reopening the preview (e.g. when restoring focus on Escape).
+    let ignoreFocus = (0, $cuAD7$useRef)(false);
+    // When opened via long press, move focus into the popover once it opens so touch screen readers
+    // (e.g. VoiceOver) move their virtual cursor into the preview.
+    let shouldFocusOnOpen = (0, $cuAD7$useRef)(false);
+    // Whether the pointer is currently within the safe area (the trigger, the popover, or the region
+    // between them). Tracked by useSafeArea below so the preview stays open while the pointer travels
+    // from the link to the popover, even with closeDelay of 0.
+    let pointerInSafeArea = (0, $cuAD7$useRef)(false);
+    let isFocusVisible = (0, $cuAD7$useRef)(false);
+    (0, $8f5a2122b0992be3$export$ec71b4b83ac08ec3)((visible)=>{
+        isFocusVisible.current = visible;
+    }, []);
+    // Cancel a pending close and keep the preview open.
+    let keepOpen = (0, $fe16bffc7a557bf0$export$7f54fc3180508a52)(()=>state.open(true));
+    // Close the preview unless something is still keeping it open: the pointer is within the safe
+    // area, or focus is within the trigger or popover. During focus transitions the active element
+    // may briefly be the body; the popover's focusin handler re-opens in that case (focus moving in).
+    let checkClose = (0, $fe16bffc7a557bf0$export$7f54fc3180508a52)(()=>{
+        if (pointerInSafeArea.current) return;
+        let active = triggerRef.current ? (0, $23f2114a1b82827e$export$cd4e5573fbe2b576)((0, $d447af545b77c9f1$export$b204af158042fbac)(triggerRef.current)) : null;
+        if (isFocusVisible.current && (triggerRef.current && (0, $23f2114a1b82827e$export$4282f70798064fe0)(triggerRef.current, active) || popoverRef.current && (0, $23f2114a1b82827e$export$4282f70798064fe0)(popoverRef.current, active))) return;
+        state.close();
+    });
+    (0, $cuAD7$useEffect)(()=>{
+        let popover = popoverRef.current;
+        if (!state.isOpen || !popover || !shouldFocusOnOpen.current) return;
+        // When opened via long press, move focus to the popover itself so touch screen readers move
+        // their virtual cursor into the preview.
+        shouldFocusOnOpen.current = false;
+        (0, $1969ac565cfec8d0$export$de79e2c695e052f3)(popover);
+    }, [
+        state.isOpen,
+        popoverRef
+    ]);
+    let onHoverStart = ()=>{
+        // Match useTooltipTrigger: only treat as hovered when the modality is actually a pointer.
+        if ((0, $8f5a2122b0992be3$export$630ff653c5ada6a9)() === 'pointer') {
+            pointerInSafeArea.current = true;
+            state.open();
+        }
+    };
+    let onHoverEnd = ()=>{
+        // Before the preview opens, cancel a pending warmup if the pointer leaves the trigger. Once
+        // open, the safe-area polygon (useSafeArea) governs closing as the pointer moves to the popover.
+        if (!state.isOpen) {
+            pointerInSafeArea.current = false;
+            state.close();
+        }
+    };
+    let onTriggerFocus = (e)=>{
+        if (ignoreFocus.current) {
+            ignoreFocus.current = false;
+            return;
+        }
+        // Prevent browser focusing the link on long press when focus is already in the popover.
+        if (state.isOpen && e.relatedTarget === popoverRef.current) {
+            (0, $1969ac565cfec8d0$export$de79e2c695e052f3)(popoverRef.current);
+            return;
+        }
+        if (isFocusVisible.current) // Open after the warmup delay on keyboard focus, not immediately like a tooltip. This way
+        // tabbing quickly through the page doesn't open previews (and add their tab stops); the
+        // delay ensures the user is actually interested in the link's details.
+        state.open();
+    };
+    (0, $600b3cf69ae46262$export$90fc3a17d93f704c)(triggerRef, 'react-aria-focus-scope-restore', (e)=>{
+        e.preventDefault();
+        ignoreFocus.current = true;
+        triggerRef.current?.focus();
+    });
+    // Move focus from the link into the preview when the user presses Tab while it is open.
+    // Tabbing back out of the popover is handled by the popover's own FocusScope.
+    let onTriggerKeyDown = (e)=>{
+        if (e.key === 'Tab' && !e.shiftKey && state.isOpen && popoverRef.current) {
+            let walker = (0, $535772f9d2c1f38d$export$2d6ec8fc375ceafa)(popoverRef.current, {
+                tabbable: true
+            });
+            let first = walker.nextNode();
+            if (first) {
+                e.preventDefault();
+                first.focus();
+            }
+        } else if (e.key === 'Escape') {
+            e.preventDefault();
+            state.close(true);
+        }
+    };
+    let { hoverProps: hoverProps } = (0, $e969f22b6713ca4a$export$ae780daf29e6d456)({
+        isDisabled: isDisabled,
+        onHoverStart: onHoverStart,
+        onHoverEnd: onHoverEnd
+    });
+    let focusableProps = {
+        onFocus: onTriggerFocus,
+        onBlur: checkClose,
+        onKeyDown: onTriggerKeyDown
+    };
+    // Only describe the long press interaction when the user is actually using touch, otherwise it
+    // is confusing (e.g. a screen reader announcing "long press" while navigating with a keyboard).
+    // null is the default before the user has interacted with anything.
+    let modality = (0, $8f5a2122b0992be3$export$98e20ec92f614cfe)();
+    let shouldLongPress = (modality === 'pointer' || modality === 'virtual' || modality == null) && typeof window !== 'undefined' && 'ontouchstart' in window;
+    // Open the preview on long press on touch devices, since there is no hover. Move focus into the
+    // popover once it opens so touch screen readers (e.g. VoiceOver) move their virtual cursor in.
+    let { longPressProps: longPressProps } = (0, $7b01448eaad0fe7c$export$c24ed0104d07eab9)({
+        isDisabled: isDisabled,
+        pointerType: 'touch',
+        accessibilityDescription: shouldLongPress ? stringFormatter.format('longPressMessage') : undefined,
+        onLongPress () {
+            shouldFocusOnOpen.current = true;
+            state.open(true);
+        }
+    });
+    // Keep the preview open while the pointer is anywhere within the safe area connecting the link
+    // and the popover, so moving the pointer between them (even diagonally) doesn't close it. This
+    // works for any popover placement and even when closeDelay is 0.
+    (0, $80d0af5af0c3b3bd$export$c7bf694416f38471)({
+        triggerRef: triggerRef,
+        overlayRef: popoverRef,
+        isOpen: state.isOpen,
+        isDisabled: isDisabled,
+        onSafeAreaChange: (isInSafeArea)=>{
+            if (isInSafeArea === pointerInSafeArea.current) return;
+            pointerInSafeArea.current = isInSafeArea;
+            if (isInSafeArea) keepOpen();
+            else checkClose();
+        }
+    });
+    // oxlint-disable-next-line react/react-compiler
+    let triggerProps = (0, $bbaa08b3cd72f041$export$9d1611c77c2fe928)(focusableProps, hoverProps, longPressProps);
+    let describedBy = [
+        triggerProps['aria-describedby'],
+        state.isOpen ? popoverId : null
+    ].filter(Boolean).join(' ');
+    return {
+        triggerProps: {
+            ...triggerProps,
+            'aria-haspopup': 'dialog',
+            'aria-expanded': state.isOpen,
+            'aria-controls': state.isOpen ? popoverId : undefined,
+            'aria-describedby': describedBy || undefined,
+            style: {
+                WebkitTouchCallout: 'none',
+                // @ts-ignore
+                WebkitUserDrag: 'none'
+            }
+        },
+        popoverProps: {
+            id: popoverId,
+            onFocusWithin: keepOpen,
+            onBlurWithin: checkClose
+        }
+    };
+}
+
+
+export {$dab43360cbeb70e5$export$cfc4af0616336448 as usePreviewTrigger};
+//# sourceMappingURL=usePreviewTrigger.mjs.map

package/dist/private/tooltip/usePreviewTrigger.mjs.map

@@ -0,0 +1 @@
+{"mappings":"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","sources":["packages/react-aria/src/tooltip/usePreviewTrigger.ts"],"sourcesContent":["/*\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {\n  KeyboardEvent as AriaKeyboardEvent,\n  DOMAttributes,\n  FocusableElement,\n  RefObject\n} from '@react-types/shared';\nimport {AriaPopoverProps} from '../overlays/usePopover';\nimport {focusWithoutScrolling} from '../utils/focusWithoutScrolling';\nimport {getActiveElement} from '../utils/shadowdom/DOMFunctions';\nimport {getFocusableTreeWalker} from '../focus/FocusScope';\nimport {\n  getInteractionModality,\n  useFocusVisibleListener,\n  useInteractionModality\n} from '../interactions/useFocusVisible';\nimport {getOwnerDocument} from '../utils/domHelpers';\nimport intlMessages from '../../intl/previewtrigger/*.json';\nimport {mergeProps} from '../utils/mergeProps';\nimport {nodeContains} from '../utils/shadowdom/DOMFunctions';\nimport {TooltipTriggerProps, TooltipTriggerState} from 'react-stately/useTooltipTriggerState';\nimport {useEffect, useRef} from 'react';\nimport {useEffectEvent} from '../utils/useEffectEvent';\nimport {useEvent} from '../utils/useEvent';\nimport {useHover} from '../interactions/useHover';\nimport {useId} from '../utils/useId';\nimport {useLocalizedStringFormatter} from '../i18n/useLocalizedStringFormatter';\nimport {useLongPress} from '../interactions/useLongPress';\nimport {useSafeArea} from './useSafeArea';\n\nexport interface AriaPreviewTriggerProps extends Omit<\n  TooltipTriggerProps,\n  'trigger' | 'shouldCloseOnPress'\n> {}\n\nexport interface AriaPreviewTriggerOptions extends AriaPreviewTriggerProps {\n  /** A ref to the trigger element (e.g. a Link). */\n  triggerRef: RefObject<FocusableElement | null>;\n  /** A ref to the popover element. */\n  popoverRef: RefObject<Element | null>;\n}\n\nexport interface PreviewTriggerTriggerAria {\n  /**\n   * Props for the trigger element (e.g. a Link).\n   */\n  triggerProps: DOMAttributes;\n  /**\n   * Props for the popover overlay element.\n   */\n  popoverProps: Omit<AriaPopoverProps, 'triggerRef' | 'popoverRef'> & DOMAttributes;\n}\n\n/**\n * Provides the behavior and accessibility implementation for a preview trigger.\n * A preview trigger displays a popover on hover, focus, or long press. Unlike a\n * tooltip, the popover may contain interactive content.\n */\nexport function usePreviewTrigger(\n  props: AriaPreviewTriggerOptions,\n  state: TooltipTriggerState\n): PreviewTriggerTriggerAria {\n  let {triggerRef, popoverRef, isDisabled} = props;\n  let stringFormatter = useLocalizedStringFormatter(intlMessages, '@react-aria/link-preview');\n  let popoverId = useId();\n\n  // Suppresses the next focus from reopening the preview (e.g. when restoring focus on Escape).\n  let ignoreFocus = useRef(false);\n  // When opened via long press, move focus into the popover once it opens so touch screen readers\n  // (e.g. VoiceOver) move their virtual cursor into the preview.\n  let shouldFocusOnOpen = useRef(false);\n  // Whether the pointer is currently within the safe area (the trigger, the popover, or the region\n  // between them). Tracked by useSafeArea below so the preview stays open while the pointer travels\n  // from the link to the popover, even with closeDelay of 0.\n  let pointerInSafeArea = useRef(false);\n\n  let isFocusVisible = useRef(false);\n  useFocusVisibleListener(visible => {\n    isFocusVisible.current = visible;\n  }, []);\n\n  // Cancel a pending close and keep the preview open.\n  let keepOpen = useEffectEvent(() => state.open(true));\n\n  // Close the preview unless something is still keeping it open: the pointer is within the safe\n  // area, or focus is within the trigger or popover. During focus transitions the active element\n  // may briefly be the body; the popover's focusin handler re-opens in that case (focus moving in).\n  let checkClose = useEffectEvent(() => {\n    if (pointerInSafeArea.current) {\n      return;\n    }\n    let active = triggerRef.current ? getActiveElement(getOwnerDocument(triggerRef.current)) : null;\n    if (\n      isFocusVisible.current &&\n      ((triggerRef.current && nodeContains(triggerRef.current, active)) ||\n        (popoverRef.current && nodeContains(popoverRef.current, active)))\n    ) {\n      return;\n    }\n    state.close();\n  });\n\n  useEffect(() => {\n    let popover = popoverRef.current;\n    if (!state.isOpen || !popover || !shouldFocusOnOpen.current) {\n      return;\n    }\n\n    // When opened via long press, move focus to the popover itself so touch screen readers move\n    // their virtual cursor into the preview.\n    shouldFocusOnOpen.current = false;\n    focusWithoutScrolling(popover as FocusableElement);\n  }, [state.isOpen, popoverRef]);\n\n  let onHoverStart = () => {\n    // Match useTooltipTrigger: only treat as hovered when the modality is actually a pointer.\n    if (getInteractionModality() === 'pointer') {\n      pointerInSafeArea.current = true;\n      state.open();\n    }\n  };\n\n  let onHoverEnd = () => {\n    // Before the preview opens, cancel a pending warmup if the pointer leaves the trigger. Once\n    // open, the safe-area polygon (useSafeArea) governs closing as the pointer moves to the popover.\n    if (!state.isOpen) {\n      pointerInSafeArea.current = false;\n      state.close();\n    }\n  };\n\n  let onTriggerFocus = e => {\n    if (ignoreFocus.current) {\n      ignoreFocus.current = false;\n      return;\n    }\n\n    // Prevent browser focusing the link on long press when focus is already in the popover.\n    if (state.isOpen && e.relatedTarget === popoverRef.current) {\n      focusWithoutScrolling(popoverRef.current as FocusableElement);\n      return;\n    }\n\n    if (isFocusVisible.current) {\n      // Open after the warmup delay on keyboard focus, not immediately like a tooltip. This way\n      // tabbing quickly through the page doesn't open previews (and add their tab stops); the\n      // delay ensures the user is actually interested in the link's details.\n      state.open();\n    }\n  };\n\n  useEvent(triggerRef, 'react-aria-focus-scope-restore', e => {\n    e.preventDefault();\n    ignoreFocus.current = true;\n    triggerRef.current?.focus();\n  });\n\n  // Move focus from the link into the preview when the user presses Tab while it is open.\n  // Tabbing back out of the popover is handled by the popover's own FocusScope.\n  let onTriggerKeyDown = (e: AriaKeyboardEvent) => {\n    if (e.key === 'Tab' && !e.shiftKey && state.isOpen && popoverRef.current) {\n      let walker = getFocusableTreeWalker(popoverRef.current, {tabbable: true});\n      let first = walker.nextNode() as FocusableElement | null;\n      if (first) {\n        e.preventDefault();\n        first.focus();\n      }\n    } else if (e.key === 'Escape') {\n      e.preventDefault();\n      state.close(true);\n    }\n  };\n\n  let {hoverProps} = useHover({isDisabled, onHoverStart, onHoverEnd});\n  let focusableProps = {\n    onFocus: onTriggerFocus,\n    onBlur: checkClose,\n    onKeyDown: onTriggerKeyDown\n  };\n\n  // Only describe the long press interaction when the user is actually using touch, otherwise it\n  // is confusing (e.g. a screen reader announcing \"long press\" while navigating with a keyboard).\n  // null is the default before the user has interacted with anything.\n  let modality = useInteractionModality();\n  let shouldLongPress =\n    (modality === 'pointer' || modality === 'virtual' || modality == null) &&\n    typeof window !== 'undefined' &&\n    'ontouchstart' in window;\n\n  // Open the preview on long press on touch devices, since there is no hover. Move focus into the\n  // popover once it opens so touch screen readers (e.g. VoiceOver) move their virtual cursor in.\n  let {longPressProps} = useLongPress({\n    isDisabled,\n    pointerType: 'touch',\n    accessibilityDescription: shouldLongPress\n      ? stringFormatter.format('longPressMessage')\n      : undefined,\n    onLongPress() {\n      shouldFocusOnOpen.current = true;\n      state.open(true);\n    }\n  });\n\n  // Keep the preview open while the pointer is anywhere within the safe area connecting the link\n  // and the popover, so moving the pointer between them (even diagonally) doesn't close it. This\n  // works for any popover placement and even when closeDelay is 0.\n  useSafeArea({\n    triggerRef,\n    overlayRef: popoverRef,\n    isOpen: state.isOpen,\n    isDisabled,\n    onSafeAreaChange: isInSafeArea => {\n      if (isInSafeArea === pointerInSafeArea.current) {\n        return;\n      }\n      pointerInSafeArea.current = isInSafeArea;\n      if (isInSafeArea) {\n        keepOpen();\n      } else {\n        checkClose();\n      }\n    }\n  });\n\n  // oxlint-disable-next-line react/react-compiler\n  let triggerProps = mergeProps(focusableProps, hoverProps, longPressProps);\n  let describedBy = [triggerProps['aria-describedby'], state.isOpen ? popoverId : null]\n    .filter(Boolean)\n    .join(' ');\n\n  return {\n    triggerProps: {\n      ...triggerProps,\n      'aria-haspopup': 'dialog',\n      'aria-expanded': state.isOpen,\n      'aria-controls': state.isOpen ? popoverId : undefined,\n      'aria-describedby': describedBy || undefined,\n      style: {\n        WebkitTouchCallout: 'none',\n        // @ts-ignore\n        WebkitUserDrag: 'none'\n      }\n    },\n    popoverProps: {\n      id: popoverId,\n      onFocusWithin: keepOpen,\n      onBlurWithin: checkClose\n    }\n  };\n}\n"],"names":[],"version":3,"file":"usePreviewTrigger.mjs.map"}

package/dist/private/tooltip/useSafeArea.cjs

@@ -0,0 +1,134 @@
+var $49582955cc364b1c$exports = require("../utils/domHelpers.cjs");
+var $d6e22460ce4d6b26$exports = require("../utils/useEffectEvent.cjs");
+var $ipEYR$react = require("react");
+
+
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+
+$parcel$export(module.exports, "useSafeArea", function () { return $410abcf732b250aa$export$c7bf694416f38471; });
+/*
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+
+
+// A small amount of padding (in pixels) added around the trigger and overlay so the safe area is
+// slightly forgiving of sub-pixel jitter and the gap between the elements.
+const $410abcf732b250aa$var$PADDING = 8;
+function $410abcf732b250aa$export$c7bf694416f38471(options) {
+    let { triggerRef: triggerRef, overlayRef: overlayRef, isOpen: isOpen, isDisabled: isDisabled } = options;
+    let onSafeAreaChange = (0, $d6e22460ce4d6b26$exports.useEffectEvent)(options.onSafeAreaChange);
+    (0, $ipEYR$react.useEffect)(()=>{
+        let trigger = triggerRef.current;
+        if (isDisabled || !isOpen || !trigger) return;
+        let onPointerMove = (e)=>{
+            if (e.pointerType === 'touch') return;
+            let point = {
+                x: e.clientX,
+                y: e.clientY
+            };
+            let triggerRect = trigger.getBoundingClientRect();
+            let overlayRect = overlayRef.current?.getBoundingClientRect();
+            onSafeAreaChange($410abcf732b250aa$var$isPointInSafeArea(point, triggerRect, overlayRect));
+        };
+        // If the pointer leaves the document entirely, it is no longer in the safe area.
+        let onPointerLeave = ()=>onSafeAreaChange(false);
+        let win = (0, $49582955cc364b1c$exports.getOwnerWindow)(trigger);
+        let doc = (0, $49582955cc364b1c$exports.getOwnerDocument)(trigger);
+        win.addEventListener('pointermove', onPointerMove);
+        doc.documentElement.addEventListener('pointerleave', onPointerLeave);
+        return ()=>{
+            win.removeEventListener('pointermove', onPointerMove);
+            doc.documentElement.removeEventListener('pointerleave', onPointerLeave);
+        };
+    }, [
+        isDisabled,
+        isOpen,
+        triggerRef,
+        overlayRef
+    ]);
+}
+function $410abcf732b250aa$var$isPointInSafeArea(point, triggerRect, overlayRect) {
+    if ($410abcf732b250aa$var$rectContains(triggerRect, point)) return true;
+    if (!overlayRect) return false;
+    if ($410abcf732b250aa$var$rectContains(overlayRect, point)) return true;
+    // Otherwise, check whether the point is within the convex hull connecting the two rects.
+    let hull = $410abcf732b250aa$var$convexHull([
+        ...$410abcf732b250aa$var$rectCorners(triggerRect),
+        ...$410abcf732b250aa$var$rectCorners(overlayRect)
+    ]);
+    return hull.length >= 3 && $410abcf732b250aa$var$isPointInPolygon(point, hull);
+}
+function $410abcf732b250aa$var$rectContains(rect, point) {
+    return point.x >= rect.left - $410abcf732b250aa$var$PADDING && point.x <= rect.right + $410abcf732b250aa$var$PADDING && point.y >= rect.top - $410abcf732b250aa$var$PADDING && point.y <= rect.bottom + $410abcf732b250aa$var$PADDING;
+}
+function $410abcf732b250aa$var$rectCorners(rect) {
+    let left = rect.left - $410abcf732b250aa$var$PADDING;
+    let right = rect.right + $410abcf732b250aa$var$PADDING;
+    let top = rect.top - $410abcf732b250aa$var$PADDING;
+    let bottom = rect.bottom + $410abcf732b250aa$var$PADDING;
+    return [
+        {
+            x: left,
+            y: top
+        },
+        {
+            x: right,
+            y: top
+        },
+        {
+            x: right,
+            y: bottom
+        },
+        {
+            x: left,
+            y: bottom
+        }
+    ];
+}
+// Computes the convex hull of a set of points using the monotone chain algorithm.
+function $410abcf732b250aa$var$convexHull(points) {
+    let sorted = points.slice().sort((a, b)=>a.x - b.x || a.y - b.y);
+    if (sorted.length < 3) return sorted;
+    let cross = (o, a, b)=>(a.x - o.x) * (b.y - o.y) - (a.y - o.y) * (b.x - o.x);
+    let lower = [];
+    for (let p of sorted){
+        while(lower.length >= 2 && cross(lower[lower.length - 2], lower[lower.length - 1], p) <= 0)lower.pop();
+        lower.push(p);
+    }
+    let upper = [];
+    for(let i = sorted.length - 1; i >= 0; i--){
+        let p = sorted[i];
+        while(upper.length >= 2 && cross(upper[upper.length - 2], upper[upper.length - 1], p) <= 0)upper.pop();
+        upper.push(p);
+    }
+    lower.pop();
+    upper.pop();
+    return lower.concat(upper);
+}
+// Ray casting point-in-polygon test.
+function $410abcf732b250aa$var$isPointInPolygon(point, polygon) {
+    let { x: x, y: y } = point;
+    let inside = false;
+    for(let i = 0, j = polygon.length - 1; i < polygon.length; j = i++){
+        let xi = polygon[i].x;
+        let yi = polygon[i].y;
+        let xj = polygon[j].x;
+        let yj = polygon[j].y;
+        let intersect = yi > y !== yj > y && x < (xj - xi) * (y - yi) / (yj - yi) + xi;
+        if (intersect) inside = !inside;
+    }
+    return inside;
+}
+
+
+//# sourceMappingURL=useSafeArea.cjs.map

package/dist/private/tooltip/useSafeArea.cjs.map

@@ -0,0 +1 @@
+{"mappings":"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","sources":["packages/react-aria/src/tooltip/useSafeArea.ts"],"sourcesContent":["/*\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {getOwnerDocument, getOwnerWindow} from '../utils/domHelpers';\nimport {RefObject} from '@react-types/shared';\nimport {useEffect} from 'react';\nimport {useEffectEvent} from '../utils/useEffectEvent';\n\ninterface Point {\n  x: number;\n  y: number;\n}\n\ninterface SafeAreaOptions {\n  /** Ref for the trigger element. */\n  triggerRef: RefObject<Element | null>;\n  /** Ref for the overlay element. */\n  overlayRef: RefObject<Element | null>;\n  /** Whether the overlay is open. */\n  isOpen: boolean;\n  /** Whether this feature is disabled. */\n  isDisabled?: boolean;\n  /**\n   * Called on pointer move (and when the pointer leaves the document) with whether the pointer is\n   * currently within the \"safe area\" — the trigger, the overlay, or the region between them. This\n   * lets an overlay stay open while the pointer travels from the trigger to the overlay, even\n   * diagonally and regardless of placement.\n   */\n  onSafeAreaChange: (isInSafeArea: boolean) => void;\n}\n\n// A small amount of padding (in pixels) added around the trigger and overlay so the safe area is\n// slightly forgiving of sub-pixel jitter and the gap between the elements.\nconst PADDING = 8;\n\n/**\n * Tracks whether the pointer is within a \"safe area\" connecting a trigger and its overlay, so the\n * overlay can stay open while the pointer moves between them. The safe area is the union of the\n * trigger rect, the overlay rect, and the convex hull connecting the two (a polygon), which works\n * for any placement of the overlay relative to the trigger.\n */\nexport function useSafeArea(options: SafeAreaOptions): void {\n  let {triggerRef, overlayRef, isOpen, isDisabled} = options;\n  let onSafeAreaChange = useEffectEvent(options.onSafeAreaChange);\n\n  useEffect(() => {\n    let trigger = triggerRef.current;\n    if (isDisabled || !isOpen || !trigger) {\n      return;\n    }\n\n    let onPointerMove = (e: PointerEvent) => {\n      if (e.pointerType === 'touch') {\n        return;\n      }\n      let point = {x: e.clientX, y: e.clientY};\n      let triggerRect = trigger!.getBoundingClientRect();\n      let overlayRect = overlayRef.current?.getBoundingClientRect();\n      onSafeAreaChange(isPointInSafeArea(point, triggerRect, overlayRect));\n    };\n\n    // If the pointer leaves the document entirely, it is no longer in the safe area.\n    let onPointerLeave = () => onSafeAreaChange(false);\n\n    let win = getOwnerWindow(trigger);\n    let doc = getOwnerDocument(trigger);\n    win.addEventListener('pointermove', onPointerMove);\n    doc.documentElement.addEventListener('pointerleave', onPointerLeave);\n    return () => {\n      win.removeEventListener('pointermove', onPointerMove);\n      doc.documentElement.removeEventListener('pointerleave', onPointerLeave);\n    };\n  }, [isDisabled, isOpen, triggerRef, overlayRef]);\n}\n\nfunction isPointInSafeArea(point: Point, triggerRect: DOMRect, overlayRect?: DOMRect): boolean {\n  if (rectContains(triggerRect, point)) {\n    return true;\n  }\n  if (!overlayRect) {\n    return false;\n  }\n  if (rectContains(overlayRect, point)) {\n    return true;\n  }\n  // Otherwise, check whether the point is within the convex hull connecting the two rects.\n  let hull = convexHull([...rectCorners(triggerRect), ...rectCorners(overlayRect)]);\n  return hull.length >= 3 && isPointInPolygon(point, hull);\n}\n\nfunction rectContains(rect: DOMRect, point: Point): boolean {\n  return (\n    point.x >= rect.left - PADDING &&\n    point.x <= rect.right + PADDING &&\n    point.y >= rect.top - PADDING &&\n    point.y <= rect.bottom + PADDING\n  );\n}\n\nfunction rectCorners(rect: DOMRect): Point[] {\n  let left = rect.left - PADDING;\n  let right = rect.right + PADDING;\n  let top = rect.top - PADDING;\n  let bottom = rect.bottom + PADDING;\n  return [\n    {x: left, y: top},\n    {x: right, y: top},\n    {x: right, y: bottom},\n    {x: left, y: bottom}\n  ];\n}\n\n// Computes the convex hull of a set of points using the monotone chain algorithm.\nfunction convexHull(points: Point[]): Point[] {\n  let sorted = points.slice().sort((a, b) => a.x - b.x || a.y - b.y);\n  if (sorted.length < 3) {\n    return sorted;\n  }\n\n  let cross = (o: Point, a: Point, b: Point) =>\n    (a.x - o.x) * (b.y - o.y) - (a.y - o.y) * (b.x - o.x);\n\n  let lower: Point[] = [];\n  for (let p of sorted) {\n    while (lower.length >= 2 && cross(lower[lower.length - 2], lower[lower.length - 1], p) <= 0) {\n      lower.pop();\n    }\n    lower.push(p);\n  }\n\n  let upper: Point[] = [];\n  for (let i = sorted.length - 1; i >= 0; i--) {\n    let p = sorted[i];\n    while (upper.length >= 2 && cross(upper[upper.length - 2], upper[upper.length - 1], p) <= 0) {\n      upper.pop();\n    }\n    upper.push(p);\n  }\n\n  lower.pop();\n  upper.pop();\n  return lower.concat(upper);\n}\n\n// Ray casting point-in-polygon test.\nfunction isPointInPolygon(point: Point, polygon: Point[]): boolean {\n  let {x, y} = point;\n  let inside = false;\n  for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {\n    let xi = polygon[i].x;\n    let yi = polygon[i].y;\n    let xj = polygon[j].x;\n    let yj = polygon[j].y;\n    let intersect = yi > y !== yj > y && x < ((xj - xi) * (y - yi)) / (yj - yi) + xi;\n    if (intersect) {\n      inside = !inside;\n    }\n  }\n  return inside;\n}\n"],"names":[],"version":3,"file":"useSafeArea.cjs.map"}

package/dist/private/tooltip/useSafeArea.js

@@ -0,0 +1,130 @@
+import {getOwnerDocument as $cc3c3666b64debad$export$b204af158042fbac, getOwnerWindow as $cc3c3666b64debad$export$f21a1ffae260145a} from "../utils/domHelpers.js";
+import {useEffectEvent as $85567ef950781b7d$export$7f54fc3180508a52} from "../utils/useEffectEvent.js";
+import {useEffect as $lMuEN$useEffect} from "react";
+
+/*
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+
+
+// A small amount of padding (in pixels) added around the trigger and overlay so the safe area is
+// slightly forgiving of sub-pixel jitter and the gap between the elements.
+const $4ffb93780cd64f2c$var$PADDING = 8;
+function $4ffb93780cd64f2c$export$c7bf694416f38471(options) {
+    let { triggerRef: triggerRef, overlayRef: overlayRef, isOpen: isOpen, isDisabled: isDisabled } = options;
+    let onSafeAreaChange = (0, $85567ef950781b7d$export$7f54fc3180508a52)(options.onSafeAreaChange);
+    (0, $lMuEN$useEffect)(()=>{
+        let trigger = triggerRef.current;
+        if (isDisabled || !isOpen || !trigger) return;
+        let onPointerMove = (e)=>{
+            var _overlayRef_current;
+            if (e.pointerType === 'touch') return;
+            let point = {
+                x: e.clientX,
+                y: e.clientY
+            };
+            let triggerRect = trigger.getBoundingClientRect();
+            let overlayRect = (_overlayRef_current = overlayRef.current) === null || _overlayRef_current === void 0 ? void 0 : _overlayRef_current.getBoundingClientRect();
+            onSafeAreaChange($4ffb93780cd64f2c$var$isPointInSafeArea(point, triggerRect, overlayRect));
+        };
+        // If the pointer leaves the document entirely, it is no longer in the safe area.
+        let onPointerLeave = ()=>onSafeAreaChange(false);
+        let win = (0, $cc3c3666b64debad$export$f21a1ffae260145a)(trigger);
+        let doc = (0, $cc3c3666b64debad$export$b204af158042fbac)(trigger);
+        win.addEventListener('pointermove', onPointerMove);
+        doc.documentElement.addEventListener('pointerleave', onPointerLeave);
+        return ()=>{
+            win.removeEventListener('pointermove', onPointerMove);
+            doc.documentElement.removeEventListener('pointerleave', onPointerLeave);
+        };
+    }, [
+        isDisabled,
+        isOpen,
+        triggerRef,
+        overlayRef
+    ]);
+}
+function $4ffb93780cd64f2c$var$isPointInSafeArea(point, triggerRect, overlayRect) {
+    if ($4ffb93780cd64f2c$var$rectContains(triggerRect, point)) return true;
+    if (!overlayRect) return false;
+    if ($4ffb93780cd64f2c$var$rectContains(overlayRect, point)) return true;
+    // Otherwise, check whether the point is within the convex hull connecting the two rects.
+    let hull = $4ffb93780cd64f2c$var$convexHull([
+        ...$4ffb93780cd64f2c$var$rectCorners(triggerRect),
+        ...$4ffb93780cd64f2c$var$rectCorners(overlayRect)
+    ]);
+    return hull.length >= 3 && $4ffb93780cd64f2c$var$isPointInPolygon(point, hull);
+}
+function $4ffb93780cd64f2c$var$rectContains(rect, point) {
+    return point.x >= rect.left - $4ffb93780cd64f2c$var$PADDING && point.x <= rect.right + $4ffb93780cd64f2c$var$PADDING && point.y >= rect.top - $4ffb93780cd64f2c$var$PADDING && point.y <= rect.bottom + $4ffb93780cd64f2c$var$PADDING;
+}
+function $4ffb93780cd64f2c$var$rectCorners(rect) {
+    let left = rect.left - $4ffb93780cd64f2c$var$PADDING;
+    let right = rect.right + $4ffb93780cd64f2c$var$PADDING;
+    let top = rect.top - $4ffb93780cd64f2c$var$PADDING;
+    let bottom = rect.bottom + $4ffb93780cd64f2c$var$PADDING;
+    return [
+        {
+            x: left,
+            y: top
+        },
+        {
+            x: right,
+            y: top
+        },
+        {
+            x: right,
+            y: bottom
+        },
+        {
+            x: left,
+            y: bottom
+        }
+    ];
+}
+// Computes the convex hull of a set of points using the monotone chain algorithm.
+function $4ffb93780cd64f2c$var$convexHull(points) {
+    let sorted = points.slice().sort((a, b)=>a.x - b.x || a.y - b.y);
+    if (sorted.length < 3) return sorted;
+    let cross = (o, a, b)=>(a.x - o.x) * (b.y - o.y) - (a.y - o.y) * (b.x - o.x);
+    let lower = [];
+    for (let p of sorted){
+        while(lower.length >= 2 && cross(lower[lower.length - 2], lower[lower.length - 1], p) <= 0)lower.pop();
+        lower.push(p);
+    }
+    let upper = [];
+    for(let i = sorted.length - 1; i >= 0; i--){
+        let p = sorted[i];
+        while(upper.length >= 2 && cross(upper[upper.length - 2], upper[upper.length - 1], p) <= 0)upper.pop();
+        upper.push(p);
+    }
+    lower.pop();
+    upper.pop();
+    return lower.concat(upper);
+}
+// Ray casting point-in-polygon test.
+function $4ffb93780cd64f2c$var$isPointInPolygon(point, polygon) {
+    let { x: x, y: y } = point;
+    let inside = false;
+    for(let i = 0, j = polygon.length - 1; i < polygon.length; j = i++){
+        let xi = polygon[i].x;
+        let yi = polygon[i].y;
+        let xj = polygon[j].x;
+        let yj = polygon[j].y;
+        let intersect = yi > y !== yj > y && x < (xj - xi) * (y - yi) / (yj - yi) + xi;
+        if (intersect) inside = !inside;
+    }
+    return inside;
+}
+
+
+export {$4ffb93780cd64f2c$export$c7bf694416f38471 as useSafeArea};
+//# sourceMappingURL=useSafeArea.js.map

package/dist/private/tooltip/useSafeArea.js.map

@@ -0,0 +1 @@
+{"mappings":"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","sources":["packages/react-aria/src/tooltip/useSafeArea.ts"],"sourcesContent":["/*\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {getOwnerDocument, getOwnerWindow} from '../utils/domHelpers';\nimport {RefObject} from '@react-types/shared';\nimport {useEffect} from 'react';\nimport {useEffectEvent} from '../utils/useEffectEvent';\n\ninterface Point {\n  x: number;\n  y: number;\n}\n\ninterface SafeAreaOptions {\n  /** Ref for the trigger element. */\n  triggerRef: RefObject<Element | null>;\n  /** Ref for the overlay element. */\n  overlayRef: RefObject<Element | null>;\n  /** Whether the overlay is open. */\n  isOpen: boolean;\n  /** Whether this feature is disabled. */\n  isDisabled?: boolean;\n  /**\n   * Called on pointer move (and when the pointer leaves the document) with whether the pointer is\n   * currently within the \"safe area\" — the trigger, the overlay, or the region between them. This\n   * lets an overlay stay open while the pointer travels from the trigger to the overlay, even\n   * diagonally and regardless of placement.\n   */\n  onSafeAreaChange: (isInSafeArea: boolean) => void;\n}\n\n// A small amount of padding (in pixels) added around the trigger and overlay so the safe area is\n// slightly forgiving of sub-pixel jitter and the gap between the elements.\nconst PADDING = 8;\n\n/**\n * Tracks whether the pointer is within a \"safe area\" connecting a trigger and its overlay, so the\n * overlay can stay open while the pointer moves between them. The safe area is the union of the\n * trigger rect, the overlay rect, and the convex hull connecting the two (a polygon), which works\n * for any placement of the overlay relative to the trigger.\n */\nexport function useSafeArea(options: SafeAreaOptions): void {\n  let {triggerRef, overlayRef, isOpen, isDisabled} = options;\n  let onSafeAreaChange = useEffectEvent(options.onSafeAreaChange);\n\n  useEffect(() => {\n    let trigger = triggerRef.current;\n    if (isDisabled || !isOpen || !trigger) {\n      return;\n    }\n\n    let onPointerMove = (e: PointerEvent) => {\n      if (e.pointerType === 'touch') {\n        return;\n      }\n      let point = {x: e.clientX, y: e.clientY};\n      let triggerRect = trigger!.getBoundingClientRect();\n      let overlayRect = overlayRef.current?.getBoundingClientRect();\n      onSafeAreaChange(isPointInSafeArea(point, triggerRect, overlayRect));\n    };\n\n    // If the pointer leaves the document entirely, it is no longer in the safe area.\n    let onPointerLeave = () => onSafeAreaChange(false);\n\n    let win = getOwnerWindow(trigger);\n    let doc = getOwnerDocument(trigger);\n    win.addEventListener('pointermove', onPointerMove);\n    doc.documentElement.addEventListener('pointerleave', onPointerLeave);\n    return () => {\n      win.removeEventListener('pointermove', onPointerMove);\n      doc.documentElement.removeEventListener('pointerleave', onPointerLeave);\n    };\n  }, [isDisabled, isOpen, triggerRef, overlayRef]);\n}\n\nfunction isPointInSafeArea(point: Point, triggerRect: DOMRect, overlayRect?: DOMRect): boolean {\n  if (rectContains(triggerRect, point)) {\n    return true;\n  }\n  if (!overlayRect) {\n    return false;\n  }\n  if (rectContains(overlayRect, point)) {\n    return true;\n  }\n  // Otherwise, check whether the point is within the convex hull connecting the two rects.\n  let hull = convexHull([...rectCorners(triggerRect), ...rectCorners(overlayRect)]);\n  return hull.length >= 3 && isPointInPolygon(point, hull);\n}\n\nfunction rectContains(rect: DOMRect, point: Point): boolean {\n  return (\n    point.x >= rect.left - PADDING &&\n    point.x <= rect.right + PADDING &&\n    point.y >= rect.top - PADDING &&\n    point.y <= rect.bottom + PADDING\n  );\n}\n\nfunction rectCorners(rect: DOMRect): Point[] {\n  let left = rect.left - PADDING;\n  let right = rect.right + PADDING;\n  let top = rect.top - PADDING;\n  let bottom = rect.bottom + PADDING;\n  return [\n    {x: left, y: top},\n    {x: right, y: top},\n    {x: right, y: bottom},\n    {x: left, y: bottom}\n  ];\n}\n\n// Computes the convex hull of a set of points using the monotone chain algorithm.\nfunction convexHull(points: Point[]): Point[] {\n  let sorted = points.slice().sort((a, b) => a.x - b.x || a.y - b.y);\n  if (sorted.length < 3) {\n    return sorted;\n  }\n\n  let cross = (o: Point, a: Point, b: Point) =>\n    (a.x - o.x) * (b.y - o.y) - (a.y - o.y) * (b.x - o.x);\n\n  let lower: Point[] = [];\n  for (let p of sorted) {\n    while (lower.length >= 2 && cross(lower[lower.length - 2], lower[lower.length - 1], p) <= 0) {\n      lower.pop();\n    }\n    lower.push(p);\n  }\n\n  let upper: Point[] = [];\n  for (let i = sorted.length - 1; i >= 0; i--) {\n    let p = sorted[i];\n    while (upper.length >= 2 && cross(upper[upper.length - 2], upper[upper.length - 1], p) <= 0) {\n      upper.pop();\n    }\n    upper.push(p);\n  }\n\n  lower.pop();\n  upper.pop();\n  return lower.concat(upper);\n}\n\n// Ray casting point-in-polygon test.\nfunction isPointInPolygon(point: Point, polygon: Point[]): boolean {\n  let {x, y} = point;\n  let inside = false;\n  for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {\n    let xi = polygon[i].x;\n    let yi = polygon[i].y;\n    let xj = polygon[j].x;\n    let yj = polygon[j].y;\n    let intersect = yi > y !== yj > y && x < ((xj - xi) * (y - yi)) / (yj - yi) + xi;\n    if (intersect) {\n      inside = !inside;\n    }\n  }\n  return inside;\n}\n"],"names":[],"version":3,"file":"useSafeArea.js.map"}