@cdx-ui/primitives 0.0.1-beta.99 → 0.1.0

package/lib/commonjs/overlay/index.js

@@ -3,6 +3,24 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+Object.defineProperty(exports, "MODAL_OVERLAY_Z_INDEX", {
+  enumerable: true,
+  get: function () {
+    return _constants.MODAL_OVERLAY_Z_INDEX;
+  }
+});
+Object.defineProperty(exports, "NOTIFICATION_OVERLAY_Z_INDEX", {
+  enumerable: true,
+  get: function () {
+    return _constants.NOTIFICATION_OVERLAY_Z_INDEX;
+  }
+});
+Object.defineProperty(exports, "OVERLAY_PLACEMENTS", {
+  enumerable: true,
+  get: function () {
+    return _getAnchoredOverlayPosition.OVERLAY_PLACEMENTS;
+  }
+});
 Object.defineProperty(exports, "OverlayContainer", {
   enumerable: true,
   get: function () {
@@ -15,12 +33,30 @@ Object.defineProperty(exports, "OverlayInsetsProvider", {
     return _useOverlayPosition.OverlayInsetsProvider;
   }
 });
+Object.defineProperty(exports, "OverlayStackProvider", {
+  enumerable: true,
+  get: function () {
+    return _OverlayStack.OverlayStackProvider;
+  }
+});
+Object.defineProperty(exports, "getAnchoredOverlayPosition", {
+  enumerable: true,
+  get: function () {
+    return _getAnchoredOverlayPosition.getAnchoredOverlayPosition;
+  }
+});
 Object.defineProperty(exports, "useAnchorPosition", {
   enumerable: true,
   get: function () {
     return _useAnchorPosition.useAnchorPosition;
   }
 });
+Object.defineProperty(exports, "useAnchoredOverlay", {
+  enumerable: true,
+  get: function () {
+    return _useAnchoredOverlay.useAnchoredOverlay;
+  }
+});
 Object.defineProperty(exports, "useDismissOverlay", {
   enumerable: true,
   get: function () {
@@ -39,9 +75,19 @@ Object.defineProperty(exports, "useOverlayPosition", {
     return _useOverlayPosition.useOverlayPosition;
   }
 });
+Object.defineProperty(exports, "useOverlayStackRegistration", {
+  enumerable: true,
+  get: function () {
+    return _OverlayStack.useOverlayStackRegistration;
+  }
+});
+var _constants = require("./constants");
 var _OverlayContainer = require("./OverlayContainer");
+var _OverlayStack = require("./OverlayStack");
 var _useAnchorPosition = require("./useAnchorPosition");
 var _useDismissOverlay = require("./useDismissOverlay");
 var _useEscapeKey = require("./useEscapeKey");
+var _getAnchoredOverlayPosition = require("./getAnchoredOverlayPosition");
+var _useAnchoredOverlay = require("./useAnchoredOverlay");
 var _useOverlayPosition = require("./useOverlayPosition");
 //# sourceMappingURL=index.js.map

package/lib/commonjs/overlay/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_OverlayContainer","require","_useAnchorPosition","_useDismissOverlay","_useEscapeKey","_useOverlayPosition"],"sourceRoot":"../../../src","sources":["overlay/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,iBAAA,GAAAC,OAAA;AAEA,IAAAC,kBAAA,GAAAD,OAAA;AACA,IAAAE,kBAAA,GAAAF,OAAA;AACA,IAAAG,aAAA,GAAAH,OAAA;AACA,IAAAI,mBAAA,GAAAJ,OAAA","ignoreList":[]}
+{"version":3,"names":["_constants","require","_OverlayContainer","_OverlayStack","_useAnchorPosition","_useDismissOverlay","_useEscapeKey","_getAnchoredOverlayPosition","_useAnchoredOverlay","_useOverlayPosition"],"sourceRoot":"../../../src","sources":["overlay/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,UAAA,GAAAC,OAAA;AACA,IAAAC,iBAAA,GAAAD,OAAA;AAEA,IAAAE,aAAA,GAAAF,OAAA;AASA,IAAAG,kBAAA,GAAAH,OAAA;AACA,IAAAI,kBAAA,GAAAJ,OAAA;AACA,IAAAK,aAAA,GAAAL,OAAA;AACA,IAAAM,2BAAA,GAAAN,OAAA;AAaA,IAAAO,mBAAA,GAAAP,OAAA;AAKA,IAAAQ,mBAAA,GAAAR,OAAA","ignoreList":[]}

package/lib/commonjs/overlay/useAnchorPosition.js

@@ -16,53 +16,103 @@ function measureWeb(element) {
     height: rect.height
   };
 }
-
+function setLayoutIfChanged(setLayout, next) {
+  setLayout(prev => {
+    if (prev?.x === next.x && prev.y === next.y && prev.width === next.width && prev.height === next.height) {
+      return prev;
+    }
+    return next;
+  });
+}
 /**
  * Measures an anchor element's position and size, re-measuring on scroll/resize
  * (web) so a positioned overlay can track its anchor across layout changes.
  *
  * Returns `null` until the first measurement completes.
  */
-function useAnchorPosition(anchorRef, open) {
+function useAnchorPosition(anchorRef, open, options) {
+  const {
+    remeasureKey,
+    trackWhileOpen = false
+  } = options ?? {};
   const [layout, setLayout] = (0, _react.useState)(null);
+  const measureAnchor = () => {
+    const anchor = anchorRef.current;
+    if (!anchor) {
+      return;
+    }
+    if (_reactNative.Platform.OS === 'web') {
+      setLayoutIfChanged(setLayout, measureWeb(anchor));
+      return;
+    }
+    anchor.measureInWindow((x, y, width, height) => {
+      setLayoutIfChanged(setLayout, {
+        x,
+        y,
+        width,
+        height
+      });
+    });
+  };
   useIsomorphicLayoutEffect(() => {
     if (!open) {
       setLayout(null);
       return;
     }
-    const anchor = anchorRef.current;
-    if (!anchor) return;
     let cancelled = false;
+    let retryFrameId = 0;
+    let webFrameId = 0;
+    const runMeasure = () => {
+      if (cancelled) {
+        return;
+      }
+      const anchor = anchorRef.current;
+      if (!anchor) {
+        retryFrameId = requestAnimationFrame(runMeasure);
+        return;
+      }
+      measureAnchor();
+    };
+    runMeasure();
     if (_reactNative.Platform.OS === 'web') {
-      setLayout(measureWeb(anchor));
-    } else {
-      anchor.measureInWindow((x, y, width, height) => {
-        if (!cancelled) {
-          setLayout({
-            x,
-            y,
-            width,
-            height
-          });
-        }
-      });
+      webFrameId = requestAnimationFrame(runMeasure);
     }
     return () => {
       cancelled = true;
+      cancelAnimationFrame(retryFrameId);
+      cancelAnimationFrame(webFrameId);
+    };
+  }, [open, anchorRef, remeasureKey]);
+  (0, _react.useEffect)(() => {
+    if (!open || !trackWhileOpen) {
+      return;
+    }
+    let frameId = 0;
+    const tick = () => {
+      measureAnchor();
+      frameId = requestAnimationFrame(tick);
     };
-  }, [open, anchorRef]);
+    frameId = requestAnimationFrame(tick);
+    return () => {
+      cancelAnimationFrame(frameId);
+    };
+  }, [open, anchorRef, remeasureKey, trackWhileOpen]);
   (0, _react.useEffect)(() => {
-    if (!open || _reactNative.Platform.OS !== 'web') return;
+    if (!open || _reactNative.Platform.OS !== 'web' || trackWhileOpen) {
+      return;
+    }
     const anchor = anchorRef.current;
-    if (!anchor) return;
-    const update = () => setLayout(measureWeb(anchor));
+    if (!anchor) {
+      return;
+    }
+    const update = () => setLayoutIfChanged(setLayout, measureWeb(anchor));
     window.addEventListener('scroll', update, true);
     window.addEventListener('resize', update);
     return () => {
       window.removeEventListener('scroll', update, true);
       window.removeEventListener('resize', update);
     };
-  }, [open, anchorRef]);
+  }, [open, anchorRef, remeasureKey, trackWhileOpen]);
   return layout;
 }
 //# sourceMappingURL=useAnchorPosition.js.map

package/lib/commonjs/overlay/useAnchorPosition.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","_reactNative","useIsomorphicLayoutEffect","Platform","OS","useLayoutEffect","useEffect","measureWeb","element","rect","getBoundingClientRect","x","left","y","top","width","height","useAnchorPosition","anchorRef","open","layout","setLayout","useState","anchor","current","cancelled","measureInWindow","update","window","addEventListener","removeEventListener"],"sourceRoot":"../../../src","sources":["overlay/useAnchorPosition.ts"],"mappings":";;;;;;AACA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AAEA,MAAME,yBAAyB,GAAGC,qBAAQ,CAACC,EAAE,KAAK,KAAK,GAAGC,sBAAe,GAAGC,gBAAS;AASrF,SAASC,UAAUA,CAACC,OAAY,EAAgB;EAC9C,MAAMC,IAAI,GAAID,OAAO,CAA4BE,qBAAqB,CAAC,CAAC;EACxE,OAAO;IAAEC,CAAC,EAAEF,IAAI,CAACG,IAAI;IAAEC,CAAC,EAAEJ,IAAI,CAACK,GAAG;IAAEC,KAAK,EAAEN,IAAI,CAACM,KAAK;IAAEC,MAAM,EAAEP,IAAI,CAACO;EAAO,CAAC;AAC9E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,iBAAiBA,CAACC,SAAyB,EAAEC,IAAa,EAAuB;EAC/F,MAAM,CAACC,MAAM,EAAEC,SAAS,CAAC,GAAG,IAAAC,eAAQ,EAAsB,IAAI,CAAC;EAE/DpB,yBAAyB,CAAC,MAAM;IAC9B,IAAI,CAACiB,IAAI,EAAE;MACTE,SAAS,CAAC,IAAI,CAAC;MACf;IACF;IAEA,MAAME,MAAM,GAAGL,SAAS,CAACM,OAAO;IAChC,IAAI,CAACD,MAAM,EAAE;IAEb,IAAIE,SAAS,GAAG,KAAK;IAErB,IAAItB,qBAAQ,CAACC,EAAE,KAAK,KAAK,EAAE;MACzBiB,SAAS,CAACd,UAAU,CAACgB,MAAM,CAAC,CAAC;IAC/B,CAAC,MAAM;MACLA,MAAM,CAACG,eAAe,CAAC,CAACf,CAAS,EAAEE,CAAS,EAAEE,KAAa,EAAEC,MAAc,KAAK;QAC9E,IAAI,CAACS,SAAS,EAAE;UACdJ,SAAS,CAAC;YAAEV,CAAC;YAAEE,CAAC;YAAEE,KAAK;YAAEC;UAAO,CAAC,CAAC;QACpC;MACF,CAAC,CAAC;IACJ;IAEA,OAAO,MAAM;MACXS,SAAS,GAAG,IAAI;IAClB,CAAC;EACH,CAAC,EAAE,CAACN,IAAI,EAAED,SAAS,CAAC,CAAC;EAErB,IAAAZ,gBAAS,EAAC,MAAM;IACd,IAAI,CAACa,IAAI,IAAIhB,qBAAQ,CAACC,EAAE,KAAK,KAAK,EAAE;IAEpC,MAAMmB,MAAM,GAAGL,SAAS,CAACM,OAAO;IAChC,IAAI,CAACD,MAAM,EAAE;IAEb,MAAMI,MAAM,GAAGA,CAAA,KAAMN,SAAS,CAACd,UAAU,CAACgB,MAAM,CAAC,CAAC;IAElDK,MAAM,CAACC,gBAAgB,CAAC,QAAQ,EAAEF,MAAM,EAAE,IAAI,CAAC;IAC/CC,MAAM,CAACC,gBAAgB,CAAC,QAAQ,EAAEF,MAAM,CAAC;IAEzC,OAAO,MAAM;MACXC,MAAM,CAACE,mBAAmB,CAAC,QAAQ,EAAEH,MAAM,EAAE,IAAI,CAAC;MAClDC,MAAM,CAACE,mBAAmB,CAAC,QAAQ,EAAEH,MAAM,CAAC;IAC9C,CAAC;EACH,CAAC,EAAE,CAACR,IAAI,EAAED,SAAS,CAAC,CAAC;EAErB,OAAOE,MAAM;AACf","ignoreList":[]}
+{"version":3,"names":["_react","require","_reactNative","useIsomorphicLayoutEffect","Platform","OS","useLayoutEffect","useEffect","measureWeb","element","rect","getBoundingClientRect","x","left","y","top","width","height","setLayoutIfChanged","setLayout","next","prev","useAnchorPosition","anchorRef","open","options","remeasureKey","trackWhileOpen","layout","useState","measureAnchor","anchor","current","measureInWindow","cancelled","retryFrameId","webFrameId","runMeasure","requestAnimationFrame","cancelAnimationFrame","frameId","tick","update","window","addEventListener","removeEventListener"],"sourceRoot":"../../../src","sources":["overlay/useAnchorPosition.ts"],"mappings":";;;;;;AACA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AAEA,MAAME,yBAAyB,GAAGC,qBAAQ,CAACC,EAAE,KAAK,KAAK,GAAGC,sBAAe,GAAGC,gBAAS;AASrF,SAASC,UAAUA,CAACC,OAAY,EAAgB;EAC9C,MAAMC,IAAI,GAAID,OAAO,CAA4BE,qBAAqB,CAAC,CAAC;EACxE,OAAO;IAAEC,CAAC,EAAEF,IAAI,CAACG,IAAI;IAAEC,CAAC,EAAEJ,IAAI,CAACK,GAAG;IAAEC,KAAK,EAAEN,IAAI,CAACM,KAAK;IAAEC,MAAM,EAAEP,IAAI,CAACO;EAAO,CAAC;AAC9E;AAEA,SAASC,kBAAkBA,CACzBC,SAAoE,EACpEC,IAAkB,EAClB;EACAD,SAAS,CAAEE,IAAI,IAAK;IAClB,IACEA,IAAI,EAAET,CAAC,KAAKQ,IAAI,CAACR,CAAC,IAClBS,IAAI,CAACP,CAAC,KAAKM,IAAI,CAACN,CAAC,IACjBO,IAAI,CAACL,KAAK,KAAKI,IAAI,CAACJ,KAAK,IACzBK,IAAI,CAACJ,MAAM,KAAKG,IAAI,CAACH,MAAM,EAC3B;MACA,OAAOI,IAAI;IACb;IACA,OAAOD,IAAI;EACb,CAAC,CAAC;AACJ;AASA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,iBAAiBA,CAC/BC,SAAyB,EACzBC,IAAa,EACbC,OAAkC,EACb;EACrB,MAAM;IAAEC,YAAY;IAAEC,cAAc,GAAG;EAAM,CAAC,GAAGF,OAAO,IAAI,CAAC,CAAC;EAC9D,MAAM,CAACG,MAAM,EAAET,SAAS,CAAC,GAAG,IAAAU,eAAQ,EAAsB,IAAI,CAAC;EAE/D,MAAMC,aAAa,GAAGA,CAAA,KAAM;IAC1B,MAAMC,MAAM,GAAGR,SAAS,CAACS,OAAO;IAChC,IAAI,CAACD,MAAM,EAAE;MACX;IACF;IAEA,IAAI3B,qBAAQ,CAACC,EAAE,KAAK,KAAK,EAAE;MACzBa,kBAAkB,CAACC,SAAS,EAAEX,UAAU,CAACuB,MAAM,CAAC,CAAC;MACjD;IACF;IAEAA,MAAM,CAACE,eAAe,CAAC,CAACrB,CAAS,EAAEE,CAAS,EAAEE,KAAa,EAAEC,MAAc,KAAK;MAC9EC,kBAAkB,CAACC,SAAS,EAAE;QAAEP,CAAC;QAAEE,CAAC;QAAEE,KAAK;QAAEC;MAAO,CAAC,CAAC;IACxD,CAAC,CAAC;EACJ,CAAC;EAEDd,yBAAyB,CAAC,MAAM;IAC9B,IAAI,CAACqB,IAAI,EAAE;MACTL,SAAS,CAAC,IAAI,CAAC;MACf;IACF;IAEA,IAAIe,SAAS,GAAG,KAAK;IACrB,IAAIC,YAAY,GAAG,CAAC;IACpB,IAAIC,UAAU,GAAG,CAAC;IAElB,MAAMC,UAAU,GAAGA,CAAA,KAAM;MACvB,IAAIH,SAAS,EAAE;QACb;MACF;MAEA,MAAMH,MAAM,GAAGR,SAAS,CAACS,OAAO;MAChC,IAAI,CAACD,MAAM,EAAE;QACXI,YAAY,GAAGG,qBAAqB,CAACD,UAAU,CAAC;QAChD;MACF;MAEAP,aAAa,CAAC,CAAC;IACjB,CAAC;IAEDO,UAAU,CAAC,CAAC;IAEZ,IAAIjC,qBAAQ,CAACC,EAAE,KAAK,KAAK,EAAE;MACzB+B,UAAU,GAAGE,qBAAqB,CAACD,UAAU,CAAC;IAChD;IAEA,OAAO,MAAM;MACXH,SAAS,GAAG,IAAI;MAChBK,oBAAoB,CAACJ,YAAY,CAAC;MAClCI,oBAAoB,CAACH,UAAU,CAAC;IAClC,CAAC;EACH,CAAC,EAAE,CAACZ,IAAI,EAAED,SAAS,EAAEG,YAAY,CAAC,CAAC;EAEnC,IAAAnB,gBAAS,EAAC,MAAM;IACd,IAAI,CAACiB,IAAI,IAAI,CAACG,cAAc,EAAE;MAC5B;IACF;IAEA,IAAIa,OAAO,GAAG,CAAC;IACf,MAAMC,IAAI,GAAGA,CAAA,KAAM;MACjBX,aAAa,CAAC,CAAC;MACfU,OAAO,GAAGF,qBAAqB,CAACG,IAAI,CAAC;IACvC,CAAC;IACDD,OAAO,GAAGF,qBAAqB,CAACG,IAAI,CAAC;IAErC,OAAO,MAAM;MACXF,oBAAoB,CAACC,OAAO,CAAC;IAC/B,CAAC;EACH,CAAC,EAAE,CAAChB,IAAI,EAAED,SAAS,EAAEG,YAAY,EAAEC,cAAc,CAAC,CAAC;EAEnD,IAAApB,gBAAS,EAAC,MAAM;IACd,IAAI,CAACiB,IAAI,IAAIpB,qBAAQ,CAACC,EAAE,KAAK,KAAK,IAAIsB,cAAc,EAAE;MACpD;IACF;IAEA,MAAMI,MAAM,GAAGR,SAAS,CAACS,OAAO;IAChC,IAAI,CAACD,MAAM,EAAE;MACX;IACF;IAEA,MAAMW,MAAM,GAAGA,CAAA,KAAMxB,kBAAkB,CAACC,SAAS,EAAEX,UAAU,CAACuB,MAAM,CAAC,CAAC;IAEtEY,MAAM,CAACC,gBAAgB,CAAC,QAAQ,EAAEF,MAAM,EAAE,IAAI,CAAC;IAC/CC,MAAM,CAACC,gBAAgB,CAAC,QAAQ,EAAEF,MAAM,CAAC;IAEzC,OAAO,MAAM;MACXC,MAAM,CAACE,mBAAmB,CAAC,QAAQ,EAAEH,MAAM,EAAE,IAAI,CAAC;MAClDC,MAAM,CAACE,mBAAmB,CAAC,QAAQ,EAAEH,MAAM,CAAC;IAC9C,CAAC;EACH,CAAC,EAAE,CAAClB,IAAI,EAAED,SAAS,EAAEG,YAAY,EAAEC,cAAc,CAAC,CAAC;EAEnD,OAAOC,MAAM;AACf","ignoreList":[]}

package/lib/commonjs/overlay/useAnchoredOverlay.js

@@ -0,0 +1,121 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useAnchoredOverlay = useAnchoredOverlay;
+var _react = require("react");
+var _reactNative = require("react-native");
+var _getAnchoredOverlayPosition = require("./getAnchoredOverlayPosition");
+var _useAnchorPosition = require("./useAnchorPosition");
+var _useOverlayPosition = require("./useOverlayPosition");
+const STAGING_STYLE = {
+  left: -10000,
+  opacity: 0,
+  pointerEvents: 'none',
+  position: 'absolute',
+  top: -10000
+};
+function setLayoutIfChanged(setLayout, next) {
+  setLayout(previous => {
+    if (previous?.width === next.width && previous.height === next.height) {
+      return previous;
+    }
+    return next;
+  });
+}
+function useAnchoredOverlay(anchorRef, open, options = {}) {
+  const {
+    remeasureKey: externalRemeasureKey,
+    trackWhileOpen,
+    ...positionOptions
+  } = options;
+  const [revision, update] = (0, _react.useReducer)(value => value + 1, 0);
+  const remeasureKey = (0, _react.useMemo)(() => ({
+    externalRemeasureKey,
+    revision
+  }), [externalRemeasureKey, revision]);
+  const anchorLayout = (0, _useAnchorPosition.useAnchorPosition)(anchorRef, open, {
+    remeasureKey,
+    trackWhileOpen
+  });
+  const floatingRef = (0, _react.useRef)(null);
+  const [floatingLayout, setFloatingLayout] = (0, _react.useState)(null);
+  const viewport = (0, _reactNative.useWindowDimensions)();
+  const insets = (0, _react.useContext)(_useOverlayPosition.OverlayInsetsContext);
+  const measureFloating = (0, _react.useCallback)(() => {
+    // Native measure callbacks can resolve after onLayout and replace the rendered size
+    // with stale staging geometry. Native layout changes are already reported by onLayout.
+    if (_reactNative.Platform.OS !== 'web') return;
+    const floating = floatingRef.current;
+    if (!floating) return;
+    if (typeof floating.getBoundingClientRect === 'function') {
+      const rect = floating.getBoundingClientRect();
+      setLayoutIfChanged(setFloatingLayout, {
+        width: rect.width,
+        height: rect.height
+      });
+    }
+  }, []);
+  const onFloatingLayout = (0, _react.useCallback)(event => {
+    const {
+      width,
+      height
+    } = event.nativeEvent.layout;
+    setLayoutIfChanged(setFloatingLayout, {
+      width,
+      height
+    });
+  }, []);
+  const requestUpdate = (0, _react.useCallback)(() => {
+    update();
+    measureFloating();
+  }, [measureFloating]);
+  (0, _react.useEffect)(() => {
+    if (!open) {
+      setFloatingLayout(null);
+      return;
+    }
+    measureFloating();
+  }, [measureFloating, open, revision]);
+  (0, _react.useEffect)(() => {
+    if (!open || _reactNative.Platform.OS !== 'web') return;
+    const floating = floatingRef.current;
+    const anchor = anchorRef.current;
+    const resizeObserver = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(() => {
+      requestUpdate();
+    });
+    if (floating) resizeObserver?.observe(floating);
+    if (anchor) resizeObserver?.observe(anchor);
+    const visualViewport = window.visualViewport;
+    visualViewport?.addEventListener('resize', requestUpdate);
+    visualViewport?.addEventListener('scroll', requestUpdate);
+    return () => {
+      resizeObserver?.disconnect();
+      visualViewport?.removeEventListener('resize', requestUpdate);
+      visualViewport?.removeEventListener('scroll', requestUpdate);
+    };
+  }, [anchorRef, open, requestUpdate]);
+  const position = (0, _react.useMemo)(() => {
+    if (!anchorLayout || !floatingLayout) return null;
+    return (0, _getAnchoredOverlayPosition.getAnchoredOverlayPosition)(anchorLayout, floatingLayout, viewport, {
+      ...positionOptions,
+      insets: positionOptions.insets ?? insets,
+      isRTL: positionOptions.isRTL ?? _reactNative.I18nManager.isRTL
+    });
+  }, [anchorLayout, floatingLayout, viewport, positionOptions, insets]);
+  const ready = position !== null;
+  const positionStyle = _reactNative.Platform.OS === 'web' ? 'fixed' : 'absolute';
+  return {
+    floatingRef,
+    onFloatingLayout,
+    style: ready ? {
+      position: positionStyle,
+      ...position.style
+    } : STAGING_STYLE,
+    position,
+    ready,
+    update: requestUpdate
+  };
+}
+//# sourceMappingURL=useAnchoredOverlay.js.map

package/lib/commonjs/overlay/useAnchoredOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_reactNative","_getAnchoredOverlayPosition","_useAnchorPosition","_useOverlayPosition","STAGING_STYLE","left","opacity","pointerEvents","position","top","setLayoutIfChanged","setLayout","next","previous","width","height","useAnchoredOverlay","anchorRef","open","options","remeasureKey","externalRemeasureKey","trackWhileOpen","positionOptions","revision","update","useReducer","value","useMemo","anchorLayout","useAnchorPosition","floatingRef","useRef","floatingLayout","setFloatingLayout","useState","viewport","useWindowDimensions","insets","useContext","OverlayInsetsContext","measureFloating","useCallback","Platform","OS","floating","current","getBoundingClientRect","rect","onFloatingLayout","event","nativeEvent","layout","requestUpdate","useEffect","anchor","resizeObserver","ResizeObserver","observe","visualViewport","window","addEventListener","disconnect","removeEventListener","getAnchoredOverlayPosition","isRTL","I18nManager","ready","positionStyle","style"],"sourceRoot":"../../../src","sources":["overlay/useAnchoredOverlay.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/overlay/useDismissOverlay.js

@@ -4,9 +4,16 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useDismissOverlay = useDismissOverlay;
+var _OverlayStack = require("./OverlayStack");
 /**
  * No-op on native — overlay dismissal is handled by backdrop press
  * or the system back gesture / hardware button via Modal.
  */
-function useDismissOverlay(_open, _contentRef, _excludeRefs, _onDismiss) {}
+function useDismissOverlay(open, _contentRef, _excludeRefs, _onDismiss, options = {}) {
+  (0, _OverlayStack.useOverlayStackRegistration)({
+    active: open,
+    capabilities: ['outside'],
+    ...options
+  });
+}
 //# sourceMappingURL=useDismissOverlay.js.map

package/lib/commonjs/overlay/useDismissOverlay.js.map

@@ -1 +1 @@
-{"version":3,"names":["useDismissOverlay","_open","_contentRef","_excludeRefs","_onDismiss"],"sourceRoot":"../../../src","sources":["overlay/useDismissOverlay.ts"],"mappings":";;;;;;AAEA;AACA;AACA;AACA;AACO,SAASA,iBAAiBA,CAC/BC,KAAc,EACdC,WAA2B,EAC3BC,YAA8B,EAC9BC,UAAsB,EACtB,CAAC","ignoreList":[]}
+{"version":3,"names":["_OverlayStack","require","useDismissOverlay","open","_contentRef","_excludeRefs","_onDismiss","options","useOverlayStackRegistration","active","capabilities"],"sourceRoot":"../../../src","sources":["overlay/useDismissOverlay.ts"],"mappings":";;;;;;AACA,IAAAA,aAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACO,SAASC,iBAAiBA,CAC/BC,IAAa,EACbC,WAA2B,EAC3BC,YAA8B,EAC9BC,UAAsB,EACtBC,OAA6B,GAAG,CAAC,CAAC,EAClC;EACA,IAAAC,yCAA2B,EAAC;IAC1BC,MAAM,EAAEN,IAAI;IACZO,YAAY,EAAE,CAAC,SAAS,CAAC;IACzB,GAAGH;EACL,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/commonjs/overlay/useDismissOverlay.web.js

@@ -5,33 +5,49 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.useDismissOverlay = useDismissOverlay;
 var _react = require("react");
+var _OverlayStack = require("./OverlayStack");
+function refContainsNode(ref, target) {
+  const current = ref.current;
+  if (!current || typeof current.contains !== 'function') {
+    return false;
+  }
+  return current.contains(target);
+}
+
 /**
  * Dismisses an overlay when the user clicks/presses outside of it or when
  * focus moves to an element outside the overlay via keyboard.
  * Events targeting `contentRef` or any of `excludeRefs` are ignored.
  */
-function useDismissOverlay(open, contentRef, excludeRefs, onDismiss) {
+function useDismissOverlay(open, contentRef, excludeRefs, onDismiss, options = {}) {
   const onDismissRef = (0, _react.useRef)(onDismiss);
   onDismissRef.current = onDismiss;
   const excludeRefsRef = (0, _react.useRef)(excludeRefs);
   excludeRefsRef.current = excludeRefs;
+  const {
+    isTopmost
+  } = (0, _OverlayStack.useOverlayStackRegistration)({
+    active: open,
+    capabilities: ['outside'],
+    ...options
+  });
   (0, _react.useEffect)(() => {
     if (!open) {
       return;
     }
     const isInsideOverlay = target => {
-      if (contentRef.current?.contains?.(target)) {
+      if (refContainsNode(contentRef, target)) {
         return true;
       }
       for (const ref of excludeRefsRef.current) {
-        if (ref.current?.contains?.(target)) {
+        if (refContainsNode(ref, target)) {
           return true;
         }
       }
       return false;
     };
     const dismissIfOutside = e => {
-      if (!isInsideOverlay(e.target)) {
+      if (isTopmost('outside') && !isInsideOverlay(e.target)) {
         onDismissRef.current();
       }
     };
@@ -41,6 +57,6 @@ function useDismissOverlay(open, contentRef, excludeRefs, onDismiss) {
       document.removeEventListener('pointerdown', dismissIfOutside);
       document.removeEventListener('focusin', dismissIfOutside);
     };
-  }, [open, contentRef]);
+  }, [open, contentRef, isTopmost]);
 }
 //# sourceMappingURL=useDismissOverlay.web.js.map

package/lib/commonjs/overlay/useDismissOverlay.web.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","useDismissOverlay","open","contentRef","excludeRefs","onDismiss","onDismissRef","useRef","current","excludeRefsRef","useEffect","isInsideOverlay","target","contains","ref","dismissIfOutside","e","document","addEventListener","removeEventListener"],"sourceRoot":"../../../src","sources":["overlay/useDismissOverlay.web.ts"],"mappings":";;;;;;AACA,IAAAA,MAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACO,SAASC,iBAAiBA,CAC/BC,IAAa,EACbC,UAA0B,EAC1BC,WAA6B,EAC7BC,SAAqB,EACrB;EACA,MAAMC,YAAY,GAAG,IAAAC,aAAM,EAACF,SAAS,CAAC;EACtCC,YAAY,CAACE,OAAO,GAAGH,SAAS;EAEhC,MAAMI,cAAc,GAAG,IAAAF,aAAM,EAACH,WAAW,CAAC;EAC1CK,cAAc,CAACD,OAAO,GAAGJ,WAAW;EAEpC,IAAAM,gBAAS,EAAC,MAAM;IACd,IAAI,CAACR,IAAI,EAAE;MACT;IACF;IAEA,MAAMS,eAAe,GAAIC,MAAY,IAAK;MACxC,IAAIT,UAAU,CAACK,OAAO,EAAEK,QAAQ,GAAGD,MAAM,CAAC,EAAE;QAC1C,OAAO,IAAI;MACb;MACA,KAAK,MAAME,GAAG,IAAIL,cAAc,CAACD,OAAO,EAAE;QACxC,IAAIM,GAAG,CAACN,OAAO,EAAEK,QAAQ,GAAGD,MAAM,CAAC,EAAE;UACnC,OAAO,IAAI;QACb;MACF;MACA,OAAO,KAAK;IACd,CAAC;IAED,MAAMG,gBAAgB,GAAIC,CAAQ,IAAK;MACrC,IAAI,CAACL,eAAe,CAACK,CAAC,CAACJ,MAAc,CAAC,EAAE;QACtCN,YAAY,CAACE,OAAO,CAAC,CAAC;MACxB;IACF,CAAC;IAEDS,QAAQ,CAACC,gBAAgB,CAAC,aAAa,EAAEH,gBAAgB,CAAC;IAC1DE,QAAQ,CAACC,gBAAgB,CAAC,SAAS,EAAEH,gBAAgB,CAAC;IACtD,OAAO,MAAM;MACXE,QAAQ,CAACE,mBAAmB,CAAC,aAAa,EAAEJ,gBAAgB,CAAC;MAC7DE,QAAQ,CAACE,mBAAmB,CAAC,SAAS,EAAEJ,gBAAgB,CAAC;IAC3D,CAAC;EACH,CAAC,EAAE,CAACb,IAAI,EAAEC,UAAU,CAAC,CAAC;AACxB","ignoreList":[]}
+{"version":3,"names":["_react","require","_OverlayStack","refContainsNode","ref","target","current","contains","useDismissOverlay","open","contentRef","excludeRefs","onDismiss","options","onDismissRef","useRef","excludeRefsRef","isTopmost","useOverlayStackRegistration","active","capabilities","useEffect","isInsideOverlay","dismissIfOutside","e","document","addEventListener","removeEventListener"],"sourceRoot":"../../../src","sources":["overlay/useDismissOverlay.web.ts"],"mappings":";;;;;;AACA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,aAAA,GAAAD,OAAA;AAEA,SAASE,eAAeA,CAACC,GAAuB,EAAEC,MAAY,EAAW;EACvE,MAAMC,OAAO,GAAGF,GAAG,CAACE,OAAwD;EAC5E,IAAI,CAACA,OAAO,IAAI,OAAOA,OAAO,CAACC,QAAQ,KAAK,UAAU,EAAE;IACtD,OAAO,KAAK;EACd;EACA,OAAOD,OAAO,CAACC,QAAQ,CAACF,MAAM,CAAC;AACjC;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASG,iBAAiBA,CAC/BC,IAAa,EACbC,UAA0B,EAC1BC,WAA6B,EAC7BC,SAAqB,EACrBC,OAA6B,GAAG,CAAC,CAAC,EAClC;EACA,MAAMC,YAAY,GAAG,IAAAC,aAAM,EAACH,SAAS,CAAC;EACtCE,YAAY,CAACR,OAAO,GAAGM,SAAS;EAEhC,MAAMI,cAAc,GAAG,IAAAD,aAAM,EAACJ,WAAW,CAAC;EAC1CK,cAAc,CAACV,OAAO,GAAGK,WAAW;EACpC,MAAM;IAAEM;EAAU,CAAC,GAAG,IAAAC,yCAA2B,EAAC;IAChDC,MAAM,EAAEV,IAAI;IACZW,YAAY,EAAE,CAAC,SAAS,CAAC;IACzB,GAAGP;EACL,CAAC,CAAC;EAEF,IAAAQ,gBAAS,EAAC,MAAM;IACd,IAAI,CAACZ,IAAI,EAAE;MACT;IACF;IAEA,MAAMa,eAAe,GAAIjB,MAAY,IAAK;MACxC,IAAIF,eAAe,CAACO,UAAU,EAAEL,MAAM,CAAC,EAAE;QACvC,OAAO,IAAI;MACb;MACA,KAAK,MAAMD,GAAG,IAAIY,cAAc,CAACV,OAAO,EAAE;QACxC,IAAIH,eAAe,CAACC,GAAG,EAAEC,MAAM,CAAC,EAAE;UAChC,OAAO,IAAI;QACb;MACF;MACA,OAAO,KAAK;IACd,CAAC;IAED,MAAMkB,gBAAgB,GAAIC,CAAQ,IAAK;MACrC,IAAIP,SAAS,CAAC,SAAS,CAAC,IAAI,CAACK,eAAe,CAACE,CAAC,CAACnB,MAAc,CAAC,EAAE;QAC9DS,YAAY,CAACR,OAAO,CAAC,CAAC;MACxB;IACF,CAAC;IAEDmB,QAAQ,CAACC,gBAAgB,CAAC,aAAa,EAAEH,gBAAgB,CAAC;IAC1DE,QAAQ,CAACC,gBAAgB,CAAC,SAAS,EAAEH,gBAAgB,CAAC;IACtD,OAAO,MAAM;MACXE,QAAQ,CAACE,mBAAmB,CAAC,aAAa,EAAEJ,gBAAgB,CAAC;MAC7DE,QAAQ,CAACE,mBAAmB,CAAC,SAAS,EAAEJ,gBAAgB,CAAC;IAC3D,CAAC;EACH,CAAC,EAAE,CAACd,IAAI,EAAEC,UAAU,EAAEO,SAAS,CAAC,CAAC;AACnC","ignoreList":[]}

package/lib/commonjs/overlay/useEscapeKey.js

@@ -4,9 +4,16 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useEscapeKey = useEscapeKey;
+var _OverlayStack = require("./OverlayStack");
 /**
  * No-op on native — Escape key dismissal is not applicable.
  * Native uses the system back gesture / hardware button via Modal.
  */
-function useEscapeKey(_open, _onEscape) {}
+function useEscapeKey(open, _onEscape, options = {}) {
+  (0, _OverlayStack.useOverlayStackRegistration)({
+    active: open,
+    capabilities: ['escape'],
+    ...options
+  });
+}
 //# sourceMappingURL=useEscapeKey.js.map

package/lib/commonjs/overlay/useEscapeKey.js.map

@@ -1 +1 @@
-{"version":3,"names":["useEscapeKey","_open","_onEscape"],"sourceRoot":"../../../src","sources":["overlay/useEscapeKey.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACO,SAASA,YAAYA,CAACC,KAAc,EAAEC,SAAqB,EAAE,CAAC","ignoreList":[]}
+{"version":3,"names":["_OverlayStack","require","useEscapeKey","open","_onEscape","options","useOverlayStackRegistration","active","capabilities"],"sourceRoot":"../../../src","sources":["overlay/useEscapeKey.ts"],"mappings":";;;;;;AAAA,IAAAA,aAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACO,SAASC,YAAYA,CAC1BC,IAAa,EACbC,SAAqB,EACrBC,OAA6B,GAAG,CAAC,CAAC,EAClC;EACA,IAAAC,yCAA2B,EAAC;IAC1BC,MAAM,EAAEJ,IAAI;IACZK,YAAY,EAAE,CAAC,QAAQ,CAAC;IACxB,GAAGH;EACL,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/commonjs/overlay/useEscapeKey.web.js

@@ -5,19 +5,27 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.useEscapeKey = useEscapeKey;
 var _react = require("react");
+var _OverlayStack = require("./OverlayStack");
 /**
  * Closes an overlay when the user presses the Escape key.
  * Web-only — native platforms use Modal's `onRequestClose` for back/dismiss.
  */
-function useEscapeKey(open, onEscape) {
+function useEscapeKey(open, onEscape, options = {}) {
   const onEscapeRef = (0, _react.useRef)(onEscape);
   onEscapeRef.current = onEscape;
+  const {
+    isTopmost
+  } = (0, _OverlayStack.useOverlayStackRegistration)({
+    active: open,
+    capabilities: ['escape'],
+    ...options
+  });
   (0, _react.useEffect)(() => {
     if (!open) {
       return;
     }
     const handleKeyDown = e => {
-      if (e.key === 'Escape') {
+      if (e.key === 'Escape' && isTopmost('escape')) {
         onEscapeRef.current();
       }
     };
@@ -25,6 +33,6 @@ function useEscapeKey(open, onEscape) {
     return () => {
       document.removeEventListener('keydown', handleKeyDown);
     };
-  }, [open]);
+  }, [isTopmost, open]);
 }
 //# sourceMappingURL=useEscapeKey.web.js.map

package/lib/commonjs/overlay/useEscapeKey.web.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","useEscapeKey","open","onEscape","onEscapeRef","useRef","current","useEffect","handleKeyDown","e","key","document","addEventListener","removeEventListener"],"sourceRoot":"../../../src","sources":["overlay/useEscapeKey.web.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACO,SAASC,YAAYA,CAACC,IAAa,EAAEC,QAAoB,EAAE;EAChE,MAAMC,WAAW,GAAG,IAAAC,aAAM,EAACF,QAAQ,CAAC;EACpCC,WAAW,CAACE,OAAO,GAAGH,QAAQ;EAE9B,IAAAI,gBAAS,EAAC,MAAM;IACd,IAAI,CAACL,IAAI,EAAE;MACT;IACF;IAEA,MAAMM,aAAa,GAAIC,CAAgB,IAAK;MAC1C,IAAIA,CAAC,CAACC,GAAG,KAAK,QAAQ,EAAE;QACtBN,WAAW,CAACE,OAAO,CAAC,CAAC;MACvB;IACF,CAAC;IAEDK,QAAQ,CAACC,gBAAgB,CAAC,SAAS,EAAEJ,aAAa,CAAC;IACnD,OAAO,MAAM;MACXG,QAAQ,CAACE,mBAAmB,CAAC,SAAS,EAAEL,aAAa,CAAC;IACxD,CAAC;EACH,CAAC,EAAE,CAACN,IAAI,CAAC,CAAC;AACZ","ignoreList":[]}
+{"version":3,"names":["_react","require","_OverlayStack","useEscapeKey","open","onEscape","options","onEscapeRef","useRef","current","isTopmost","useOverlayStackRegistration","active","capabilities","useEffect","handleKeyDown","e","key","document","addEventListener","removeEventListener"],"sourceRoot":"../../../src","sources":["overlay/useEscapeKey.web.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,aAAA,GAAAD,OAAA;AAEA;AACA;AACA;AACA;AACO,SAASE,YAAYA,CAC1BC,IAAa,EACbC,QAAoB,EACpBC,OAA6B,GAAG,CAAC,CAAC,EAClC;EACA,MAAMC,WAAW,GAAG,IAAAC,aAAM,EAACH,QAAQ,CAAC;EACpCE,WAAW,CAACE,OAAO,GAAGJ,QAAQ;EAC9B,MAAM;IAAEK;EAAU,CAAC,GAAG,IAAAC,yCAA2B,EAAC;IAChDC,MAAM,EAAER,IAAI;IACZS,YAAY,EAAE,CAAC,QAAQ,CAAC;IACxB,GAAGP;EACL,CAAC,CAAC;EAEF,IAAAQ,gBAAS,EAAC,MAAM;IACd,IAAI,CAACV,IAAI,EAAE;MACT;IACF;IAEA,MAAMW,aAAa,GAAIC,CAAgB,IAAK;MAC1C,IAAIA,CAAC,CAACC,GAAG,KAAK,QAAQ,IAAIP,SAAS,CAAC,QAAQ,CAAC,EAAE;QAC7CH,WAAW,CAACE,OAAO,CAAC,CAAC;MACvB;IACF,CAAC;IAEDS,QAAQ,CAACC,gBAAgB,CAAC,SAAS,EAAEJ,aAAa,CAAC;IACnD,OAAO,MAAM;MACXG,QAAQ,CAACE,mBAAmB,CAAC,SAAS,EAAEL,aAAa,CAAC;IACxD,CAAC;EACH,CAAC,EAAE,CAACL,SAAS,EAAEN,IAAI,CAAC,CAAC;AACvB","ignoreList":[]}

package/lib/commonjs/overlay/useOverlayPosition.js

@@ -40,6 +40,9 @@ const OverlayInsetsProvider = exports.OverlayInsetsProvider = OverlayInsetsConte
 /** Minimum gap (px) between the overlay edge and the viewport/safe-area boundary. */
 const SCREEN_EDGE_PADDING = 8;
 
+/** Gap between anchor and popover content. */
+const POPOVER_GAP = 4;
+
 /** Minimum usable space (px) below the anchor before the overlay flips above. */
 const MIN_CONTENT_HEIGHT = 200;
 /**
@@ -50,27 +53,37 @@ const MIN_CONTENT_HEIGHT = 200;
  *
  * Respects safe-area insets provided via `OverlayInsetsProvider`.
  */
-function useOverlayPosition(anchorLayout) {
+function useOverlayPosition(anchorLayout, options) {
   const {
+    width: viewportWidth,
     height: viewportHeight
   } = (0, _reactNative.useWindowDimensions)();
   const {
     top: insetTop,
-    bottom: insetBottom
+    bottom: insetBottom,
+    right: insetRight
   } = (0, _react.useContext)(OverlayInsetsContext);
+  const matchAnchorWidth = options?.matchAnchorWidth ?? true;
   return (0, _react.useMemo)(() => {
     if (!anchorLayout) return null;
     const anchorBottom = anchorLayout.y + anchorLayout.height;
     const spaceBelow = viewportHeight - anchorBottom - insetBottom - SCREEN_EDGE_PADDING;
     const spaceAbove = anchorLayout.y - insetTop - SCREEN_EDGE_PADDING;
     const preferBelow = spaceBelow >= MIN_CONTENT_HEIGHT || spaceBelow >= spaceAbove;
+    const horizontalStyle = matchAnchorWidth ? {
+      left: anchorLayout.x,
+      width: anchorLayout.width
+    } : {
+      left: anchorLayout.x,
+      alignItems: 'flex-start',
+      maxWidth: Math.max(0, viewportWidth - anchorLayout.x - insetRight - SCREEN_EDGE_PADDING)
+    };
     if (preferBelow) {
       const maxHeight = Math.max(0, spaceBelow);
       return {
         style: {
-          top: anchorBottom,
-          left: anchorLayout.x,
-          width: anchorLayout.width,
+          ...horizontalStyle,
+          top: anchorBottom + POPOVER_GAP,
           maxHeight
         },
         maxHeight,
@@ -80,14 +93,13 @@ function useOverlayPosition(anchorLayout) {
     const maxHeight = Math.max(0, spaceAbove);
     return {
       style: {
-        bottom: viewportHeight - anchorLayout.y,
-        left: anchorLayout.x,
-        width: anchorLayout.width,
+        ...horizontalStyle,
+        bottom: viewportHeight - anchorLayout.y + POPOVER_GAP,
         maxHeight
       },
       maxHeight,
       placement: 'top'
     };
-  }, [anchorLayout, viewportHeight, insetTop, insetBottom]);
+  }, [anchorLayout, viewportWidth, viewportHeight, insetTop, insetBottom, insetRight, matchAnchorWidth]);
 }
 //# sourceMappingURL=useOverlayPosition.js.map

package/lib/commonjs/overlay/useOverlayPosition.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","_reactNative","DEFAULT_INSETS","top","right","bottom","left","OverlayInsetsContext","exports","createContext","OverlayInsetsProvider","Provider","SCREEN_EDGE_PADDING","MIN_CONTENT_HEIGHT","useOverlayPosition","anchorLayout","height","viewportHeight","useWindowDimensions","insetTop","insetBottom","useContext","useMemo","anchorBottom","y","spaceBelow","spaceAbove","preferBelow","maxHeight","Math","max","style","x","width","placement"],"sourceRoot":"../../../src","sources":["overlay/useOverlayPosition.ts"],"mappings":";;;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AAUA,MAAME,cAA0B,GAAG;EAAEC,GAAG,EAAE,CAAC;EAAEC,KAAK,EAAE,CAAC;EAAEC,MAAM,EAAE,CAAC;EAAEC,IAAI,EAAE;AAAE,CAAC;;AAE3E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,oBAAoB,GAAAC,OAAA,CAAAD,oBAAA,gBAAG,IAAAE,oBAAa,EAAaP,cAAc,CAAC;AACtE,MAAMQ,qBAAqB,GAAAF,OAAA,CAAAE,qBAAA,GAAGH,oBAAoB,CAACI,QAAQ;;AAElE;AACA,MAAMC,mBAAmB,GAAG,CAAC;;AAE7B;AACA,MAAMC,kBAAkB,GAAG,GAAG;AAQ9B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,kBAAkBA,CAACC,YAAiC,EAA0B;EAC5F,MAAM;IAAEC,MAAM,EAAEC;EAAe,CAAC,GAAG,IAAAC,gCAAmB,EAAC,CAAC;EACxD,MAAM;IAAEf,GAAG,EAAEgB,QAAQ;IAAEd,MAAM,EAAEe;EAAY,CAAC,GAAG,IAAAC,iBAAU,EAACd,oBAAoB,CAAC;EAE/E,OAAO,IAAAe,cAAO,EAAC,MAAM;IACnB,IAAI,CAACP,YAAY,EAAE,OAAO,IAAI;IAE9B,MAAMQ,YAAY,GAAGR,YAAY,CAACS,CAAC,GAAGT,YAAY,CAACC,MAAM;IACzD,MAAMS,UAAU,GAAGR,cAAc,GAAGM,YAAY,GAAGH,WAAW,GAAGR,mBAAmB;IACpF,MAAMc,UAAU,GAAGX,YAAY,CAACS,CAAC,GAAGL,QAAQ,GAAGP,mBAAmB;IAElE,MAAMe,WAAW,GAAGF,UAAU,IAAIZ,kBAAkB,IAAIY,UAAU,IAAIC,UAAU;IAEhF,IAAIC,WAAW,EAAE;MACf,MAAMC,SAAS,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEL,UAAU,CAAC;MACzC,OAAO;QACLM,KAAK,EAAE;UACL5B,GAAG,EAAEoB,YAAY;UACjBjB,IAAI,EAAES,YAAY,CAACiB,CAAC;UACpBC,KAAK,EAAElB,YAAY,CAACkB,KAAK;UACzBL;QACF,CAAC;QACDA,SAAS;QACTM,SAAS,EAAE;MACb,CAAC;IACH;IAEA,MAAMN,SAAS,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEJ,UAAU,CAAC;IACzC,OAAO;MACLK,KAAK,EAAE;QACL1B,MAAM,EAAEY,cAAc,GAAGF,YAAY,CAACS,CAAC;QACvClB,IAAI,EAAES,YAAY,CAACiB,CAAC;QACpBC,KAAK,EAAElB,YAAY,CAACkB,KAAK;QACzBL;MACF,CAAC;MACDA,SAAS;MACTM,SAAS,EAAE;IACb,CAAC;EACH,CAAC,EAAE,CAACnB,YAAY,EAAEE,cAAc,EAAEE,QAAQ,EAAEC,WAAW,CAAC,CAAC;AAC3D","ignoreList":[]}
+{"version":3,"names":["_react","require","_reactNative","DEFAULT_INSETS","top","right","bottom","left","OverlayInsetsContext","exports","createContext","OverlayInsetsProvider","Provider","SCREEN_EDGE_PADDING","POPOVER_GAP","MIN_CONTENT_HEIGHT","useOverlayPosition","anchorLayout","options","width","viewportWidth","height","viewportHeight","useWindowDimensions","insetTop","insetBottom","insetRight","useContext","matchAnchorWidth","useMemo","anchorBottom","y","spaceBelow","spaceAbove","preferBelow","horizontalStyle","x","alignItems","maxWidth","Math","max","maxHeight","style","placement"],"sourceRoot":"../../../src","sources":["overlay/useOverlayPosition.ts"],"mappings":"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","ignoreList":[]}