@ariakit/react-core 0.3.4 → 0.3.6

package/cjs/popover/popover-disclosure.d.cts

@@ -0,0 +1,30 @@
+import type { DialogDisclosureOptions } from "../dialog/dialog-disclosure.js";
+import type { As, Props } from "../utils/types.js";
+import type { PopoverAnchorOptions } from "./popover-anchor.js";
+/**
+ * Returns props to create a `PopoverDisclosure` component.
+ * @see https://ariakit.org/components/popover
+ * @example
+ * ```jsx
+ * const store = usePopoverStore();
+ * const props = usePopoverDisclosure({ store });
+ * <Role {...props}>Disclosure</Role>
+ * <Popover store={store}>Popover</Popover>
+ * ```
+ */
+export declare const usePopoverDisclosure: import("../utils/types.js").Hook<PopoverDisclosureOptions<"button">>;
+/**
+ * Renders a button that controls the visibility of the popover when clicked.
+ * @see https://ariakit.org/components/popover
+ * @example
+ * ```jsx
+ * <PopoverProvider>
+ *   <PopoverDisclosure>Disclosure</PopoverDisclosure>
+ *   <Popover>Popover</Popover>
+ * </PopoverProvider>
+ * ```
+ */
+export declare const PopoverDisclosure: import("../utils/types.js").Component<PopoverDisclosureOptions<"button">>;
+export interface PopoverDisclosureOptions<T extends As = "button"> extends PopoverAnchorOptions<T>, Omit<DialogDisclosureOptions<T>, "store"> {
+}
+export type PopoverDisclosureProps<T extends As = "button"> = Props<PopoverDisclosureOptions<T>>;

package/cjs/popover/popover-dismiss.cjs

@@ -1,20 +1,21 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _GZMKQINIcjs = require('../__chunks/GZMKQINI.cjs');
-require('../__chunks/EMNY7J2W.cjs');
-require('../__chunks/EZKYHQVF.cjs');
-require('../__chunks/HWZH54NB.cjs');
-require('../__chunks/AKOG5S2T.cjs');
-require('../__chunks/W6ZRSMO5.cjs');
-require('../__chunks/A2NMYLCG.cjs');
-require('../__chunks/GQAB4M3B.cjs');
-require('../__chunks/LHHW5ZQP.cjs');
-require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/5WLTMVVQ.cjs');
-require('../__chunks/7WUTS26Y.cjs');
-require('../__chunks/72I2GWXF.cjs');
 
+var _UXFBTIBYcjs = require('../__chunks/UXFBTIBY.cjs');
+require('../__chunks/7ZVTEFD7.cjs');
+require('../__chunks/5UTRYT6E.cjs');
+require('../__chunks/DAJUUBUI.cjs');
+require('../__chunks/UVBBMANL.cjs');
+require('../__chunks/F2A2ZQDB.cjs');
+require('../__chunks/S6UU7NA4.cjs');
+require('../__chunks/Z3GCTNW4.cjs');
+require('../__chunks/75KXQZJX.cjs');
+require('../__chunks/RNZNGEL4.cjs');
+require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/CJDHQUBR.cjs');
+require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.PopoverDismiss = _GZMKQINIcjs.PopoverDismiss; exports.usePopoverDismiss = _GZMKQINIcjs.usePopoverDismiss;
+
+exports.PopoverDismiss = _UXFBTIBYcjs.PopoverDismiss; exports.usePopoverDismiss = _UXFBTIBYcjs.usePopoverDismiss;

package/cjs/popover/popover-dismiss.d.cts

@@ -0,0 +1,42 @@
+import type { DialogDismissOptions } from "../dialog/dialog-dismiss.js";
+import type { As, Props } from "../utils/types.js";
+import type { PopoverStore } from "./popover-store.js";
+/**
+ * Returns props to create a `PopoverDismiss` component.
+ * @see https://ariakit.org/components/popover
+ * @example
+ * ```jsx
+ * const store = usePopoverStore();
+ * const props = usePopoverDismiss({ store });
+ * <Popover store={store}>
+ *   <Role {...props} />
+ * </Popover>
+ * ```
+ */
+export declare const usePopoverDismiss: import("../utils/types.js").Hook<PopoverDismissOptions<"button">>;
+/**
+ * Renders a button that hides a
+ * [`Popover`](https://ariakit.org/reference/popover) component when clicked.
+ * @see https://ariakit.org/components/popover
+ * @example
+ * ```jsx
+ * <PopoverProvider>
+ *   <Popover>
+ *     <PopoverDismiss />
+ *   </Popover>
+ * </PopoverProvider>
+ * ```
+ */
+export declare const PopoverDismiss: import("../utils/types.js").Component<PopoverDismissOptions<"button">>;
+export interface PopoverDismissOptions<T extends As = "button"> extends DialogDismissOptions<T> {
+    /**
+     * Object returned by the
+     * [`usePopoverStore`](https://ariakit.org/reference/use-popover-store) hook.
+     * If not provided, the closest
+     * [`Popover`](https://ariakit.org/reference/popover) or
+     * [`PopoverProvider`](https://ariakit.org/reference/popover-provider)
+     * components' context will be used.
+     */
+    store?: PopoverStore;
+}
+export type PopoverDismissProps<T extends As = "button"> = Props<PopoverDismissOptions<T>>;

package/cjs/popover/popover-heading.cjs

@@ -1,17 +1,18 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _4YBHDRLGcjs = require('../__chunks/4YBHDRLG.cjs');
-require('../__chunks/SW2AH2YO.cjs');
-require('../__chunks/FGAN5BEK.cjs');
-require('../__chunks/CQSUIL2D.cjs');
-require('../__chunks/W6ZRSMO5.cjs');
-require('../__chunks/A2NMYLCG.cjs');
-require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/5WLTMVVQ.cjs');
-require('../__chunks/7WUTS26Y.cjs');
-require('../__chunks/72I2GWXF.cjs');
 
+var _VIUIA2WFcjs = require('../__chunks/VIUIA2WF.cjs');
+require('../__chunks/DTEFSZZZ.cjs');
+require('../__chunks/TK6GOI2V.cjs');
+require('../__chunks/2BIO7R5N.cjs');
+require('../__chunks/F2A2ZQDB.cjs');
+require('../__chunks/S6UU7NA4.cjs');
+require('../__chunks/RNZNGEL4.cjs');
+require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/CJDHQUBR.cjs');
+require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.PopoverHeading = _4YBHDRLGcjs.PopoverHeading; exports.usePopoverHeading = _4YBHDRLGcjs.usePopoverHeading;
+
+exports.PopoverHeading = _VIUIA2WFcjs.PopoverHeading; exports.usePopoverHeading = _VIUIA2WFcjs.usePopoverHeading;

package/cjs/popover/popover-heading.d.cts

@@ -0,0 +1,43 @@
+import type { DialogHeadingOptions } from "../dialog/dialog-heading.js";
+import type { As, Props } from "../utils/types.js";
+import type { PopoverStore } from "./popover-store.js";
+/**
+ * Returns props to create a `PopoverHeading` component. This hook must be used
+ * in a component that's wrapped with `Popover` so the `aria-labelledby` prop is
+ * properly set on the popover element.
+ * @see https://ariakit.org/components/popover
+ * @example
+ * ```jsx
+ * // This component must be wrapped with Popover
+ * const props = usePopoverHeading();
+ * <Role {...props}>Heading</Role>
+ * ```
+ */
+export declare const usePopoverHeading: import("../utils/types.js").Hook<PopoverHeadingOptions<"h1">>;
+/**
+ * Renders a heading in a popover. This component must be wrapped with
+ * [`Popover`](https://ariakit.org/reference/popover) so the `aria-labelledby`
+ * prop is properly set on the popover element.
+ * @see https://ariakit.org/components/popover
+ * @example
+ * ```jsx
+ * <PopoverProvider>
+ *   <Popover>
+ *     <PopoverHeading>Heading</PopoverHeading>
+ *   </Popover>
+ * </PopoverProvider>
+ * ```
+ */
+export declare const PopoverHeading: import("../utils/types.js").Component<PopoverHeadingOptions<"h1">>;
+export interface PopoverHeadingOptions<T extends As = "h1"> extends DialogHeadingOptions<T> {
+    /**
+     * Object returned by the
+     * [`usePopoverStore`](https://ariakit.org/reference/use-popover-store) hook.
+     * If not provided, the closest
+     * [`Popover`](https://ariakit.org/reference/popover) or
+     * [`PopoverProvider`](https://ariakit.org/reference/popover-provider)
+     * components' context will be used.
+     */
+    store?: PopoverStore;
+}
+export type PopoverHeadingProps<T extends As = "h1"> = Props<PopoverHeadingOptions<T>>;

package/cjs/popover/popover-provider.cjs

@@ -1,24 +1,25 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
-var _AKOG5S2Tcjs = require('../__chunks/AKOG5S2T.cjs');
-require('../__chunks/W6ZRSMO5.cjs');
-require('../__chunks/A2NMYLCG.cjs');
-require('../__chunks/Z5PUIG6A.cjs');
 
+var _UVBBMANLcjs = require('../__chunks/UVBBMANL.cjs');
+require('../__chunks/F2A2ZQDB.cjs');
+require('../__chunks/S6UU7NA4.cjs');
+require('../__chunks/RNZNGEL4.cjs');
 
-var _O6SYRTZHcjs = require('../__chunks/O6SYRTZH.cjs');
-require('../__chunks/ZZZ5MQHA.cjs');
-require('../__chunks/HSOKUBYY.cjs');
-require('../__chunks/EVNF7KMT.cjs');
-require('../__chunks/5WLTMVVQ.cjs');
-require('../__chunks/7WUTS26Y.cjs');
-require('../__chunks/72I2GWXF.cjs');
+
+var _65GJIQK5cjs = require('../__chunks/65GJIQK5.cjs');
+require('../__chunks/X3I2WFGC.cjs');
+require('../__chunks/FQNGCFYY.cjs');
+require('../__chunks/OALXXRFM.cjs');
+require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/CJDHQUBR.cjs');
+require('../__chunks/AV6KTKLE.cjs');
 
 // src/popover/popover-provider.tsx
 var _jsxruntime = require('react/jsx-runtime');
 function PopoverProvider(props = {}) {
-  const store = _O6SYRTZHcjs.usePopoverStore.call(void 0, props);
-  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _AKOG5S2Tcjs.PopoverContextProvider, { value: store, children: props.children });
+  const store = _65GJIQK5cjs.usePopoverStore.call(void 0, props);
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _UVBBMANLcjs.PopoverContextProvider, { value: store, children: props.children });
 }
 
 

package/cjs/popover/popover-provider.d.cts

@@ -0,0 +1,17 @@
+import type { ReactNode } from "react";
+import type { PopoverStoreProps } from "./popover-store.js";
+/**
+ * Provides a popover store to Popover components.
+ * @see https://ariakit.org/components/popover
+ * @example
+ * ```jsx
+ * <PopoverProvider>
+ *   <PopoverDisclosure />
+ *   <Popover />
+ * </PopoverProvider>
+ * ```
+ */
+export declare function PopoverProvider(props?: PopoverProviderProps): import("react/jsx-runtime").JSX.Element;
+export interface PopoverProviderProps extends PopoverStoreProps {
+    children?: ReactNode;
+}

package/cjs/popover/popover-store.cjs

@@ -1,14 +1,15 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _O6SYRTZHcjs = require('../__chunks/O6SYRTZH.cjs');
-require('../__chunks/ZZZ5MQHA.cjs');
-require('../__chunks/HSOKUBYY.cjs');
-require('../__chunks/EVNF7KMT.cjs');
-require('../__chunks/5WLTMVVQ.cjs');
-require('../__chunks/7WUTS26Y.cjs');
-require('../__chunks/72I2GWXF.cjs');
 
+var _65GJIQK5cjs = require('../__chunks/65GJIQK5.cjs');
+require('../__chunks/X3I2WFGC.cjs');
+require('../__chunks/FQNGCFYY.cjs');
+require('../__chunks/OALXXRFM.cjs');
+require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/CJDHQUBR.cjs');
+require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.usePopoverStore = _O6SYRTZHcjs.usePopoverStore; exports.usePopoverStoreProps = _O6SYRTZHcjs.usePopoverStoreProps;
+
+exports.usePopoverStore = _65GJIQK5cjs.usePopoverStore; exports.usePopoverStoreProps = _65GJIQK5cjs.usePopoverStoreProps;

package/cjs/popover/popover-store.d.cts

@@ -0,0 +1,23 @@
+import * as Core from "@ariakit/core/popover/popover-store";
+import type { DialogStoreFunctions, DialogStoreOptions, DialogStoreState } from "../dialog/dialog-store.js";
+import type { Store } from "../utils/store.js";
+export declare function usePopoverStoreProps<T extends Core.PopoverStore>(store: T, update: () => void, props: PopoverStoreProps): T;
+/**
+ * Creates a popover store.
+ * @see https://ariakit.org/components/popover
+ * @example
+ * ```jsx
+ * const popover = usePopoverStore();
+ * <PopoverDisclosure store={popover}>Disclosure</PopoverDisclosure>
+ * <Popover store={popover}>Popover</Popover>
+ * ```
+ */
+export declare function usePopoverStore(props?: PopoverStoreProps): PopoverStore;
+export interface PopoverStoreState extends Core.PopoverStoreState, DialogStoreState {
+}
+export interface PopoverStoreFunctions extends Core.PopoverStoreFunctions, DialogStoreFunctions {
+}
+export interface PopoverStoreOptions extends Core.PopoverStoreOptions, DialogStoreOptions {
+}
+export type PopoverStoreProps = PopoverStoreOptions & Core.PopoverStoreProps;
+export type PopoverStore = PopoverStoreFunctions & Store<Core.PopoverStore>;

package/cjs/popover/popover.cjs

@@ -1,44 +1,45 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _VAY4A33Acjs = require('../__chunks/VAY4A33A.cjs');
-require('../__chunks/QFGI3BJE.cjs');
-require('../__chunks/R7CSCUVW.cjs');
-require('../__chunks/RWS2MAR2.cjs');
-require('../__chunks/DFFFHQVQ.cjs');
-require('../__chunks/W32FX7DM.cjs');
-require('../__chunks/QK4GI6B3.cjs');
-require('../__chunks/COHI5HTS.cjs');
-require('../__chunks/F4RJLWZG.cjs');
-require('../__chunks/56NPFF7P.cjs');
-require('../__chunks/Z3TLXRS7.cjs');
-require('../__chunks/TLA46MN6.cjs');
-require('../__chunks/X2GXTE3P.cjs');
-require('../__chunks/VTRMALP6.cjs');
-require('../__chunks/BWQVQDGC.cjs');
-require('../__chunks/ELOQI33M.cjs');
-require('../__chunks/A6H7IIHJ.cjs');
-require('../__chunks/SOPRUU56.cjs');
-require('../__chunks/MNZPRWGC.cjs');
-require('../__chunks/CKEXTQ2S.cjs');
-require('../__chunks/NS56XHXG.cjs');
-require('../__chunks/CQSUIL2D.cjs');
-require('../__chunks/OAEUR56W.cjs');
-require('../__chunks/L2VQ4YLN.cjs');
-require('../__chunks/AKOG5S2T.cjs');
-require('../__chunks/W6ZRSMO5.cjs');
-require('../__chunks/A2NMYLCG.cjs');
-require('../__chunks/GQAB4M3B.cjs');
-require('../__chunks/LHHW5ZQP.cjs');
-require('../__chunks/KSFAO77E.cjs');
-require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/ZZZ5MQHA.cjs');
-require('../__chunks/HSOKUBYY.cjs');
-require('../__chunks/EVNF7KMT.cjs');
-require('../__chunks/5WLTMVVQ.cjs');
-require('../__chunks/7WUTS26Y.cjs');
-require('../__chunks/72I2GWXF.cjs');
 
+var _ISGOCBDCcjs = require('../__chunks/ISGOCBDC.cjs');
+require('../__chunks/XFPRAS3J.cjs');
+require('../__chunks/SHOS7XOU.cjs');
+require('../__chunks/NKR65BKC.cjs');
+require('../__chunks/PZL34OVO.cjs');
+require('../__chunks/344F3DYO.cjs');
+require('../__chunks/KREY6HXD.cjs');
+require('../__chunks/5ZOCN23X.cjs');
+require('../__chunks/JVDUGICD.cjs');
+require('../__chunks/VV6WA3I6.cjs');
+require('../__chunks/7YLCVXZ7.cjs');
+require('../__chunks/7TN63K2T.cjs');
+require('../__chunks/6IUEXB4L.cjs');
+require('../__chunks/JF225FQ5.cjs');
+require('../__chunks/5GTNIPQ6.cjs');
+require('../__chunks/V24PR4PW.cjs');
+require('../__chunks/7566TIRW.cjs');
+require('../__chunks/J3OG6T3B.cjs');
+require('../__chunks/S6WUBPBB.cjs');
+require('../__chunks/XB3G2EO2.cjs');
+require('../__chunks/CVD2AZE2.cjs');
+require('../__chunks/2BIO7R5N.cjs');
+require('../__chunks/LAUATD5O.cjs');
+require('../__chunks/7BSMGTGR.cjs');
+require('../__chunks/UVBBMANL.cjs');
+require('../__chunks/F2A2ZQDB.cjs');
+require('../__chunks/S6UU7NA4.cjs');
+require('../__chunks/Z3GCTNW4.cjs');
+require('../__chunks/75KXQZJX.cjs');
+require('../__chunks/R66IWXK6.cjs');
+require('../__chunks/RNZNGEL4.cjs');
+require('../__chunks/X3I2WFGC.cjs');
+require('../__chunks/FQNGCFYY.cjs');
+require('../__chunks/OALXXRFM.cjs');
+require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/CJDHQUBR.cjs');
+require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.Popover = _VAY4A33Acjs.Popover; exports.usePopover = _VAY4A33Acjs.usePopover;
+
+exports.Popover = _ISGOCBDCcjs.Popover; exports.usePopover = _ISGOCBDCcjs.usePopover;

package/cjs/popover/popover.d.cts

@@ -0,0 +1,162 @@
+import type { HTMLAttributes } from "react";
+import type { DialogOptions } from "../dialog/dialog.js";
+import type { As, Props } from "../utils/types.js";
+import type { PopoverStore } from "./popover-store.js";
+type AnchorRect = {
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+};
+/**
+ * Returns props to create a `Popover` component.
+ * @see https://ariakit.org/components/popover
+ * @example
+ * ```jsx
+ * const store = usePopoverStore();
+ * const props = usePopover({ store });
+ * <Role {...props}>Popover</Role>
+ * ```
+ */
+export declare const usePopover: import("../utils/types.js").Hook<PopoverOptions<"div">>;
+/**
+ * Renders a popover element.
+ * @see https://ariakit.org/components/popover
+ * @example
+ * ```jsx
+ * <PopoverProvider>
+ *   <PopoverDisclosure>Disclosure</PopoverDisclosure>
+ *   <Popover>Popover</Popover>
+ * </PopoverProvider>
+ * ```
+ */
+export declare const Popover: import("../utils/types.js").Component<PopoverOptions<"div">>;
+export interface PopoverOptions<T extends As = "div"> extends DialogOptions<T> {
+    /**
+     * Object returned by the
+     * [`usePopoverStore`](https://ariakit.org/reference/use-popover-store) hook.
+     * If not provided, the closest
+     * [`PopoverProvider`](https://ariakit.org/reference/popover-provider)
+     * component's context will be used.
+     */
+    store?: PopoverStore;
+    /**
+     * Props that will be passed to the popover wrapper element. This element will
+     * be used to position the popover.
+     */
+    wrapperProps?: HTMLAttributes<HTMLDivElement>;
+    /**
+     * Whether the popover has `position: fixed` or not.
+     * @default false
+     */
+    fixed?: boolean;
+    /**
+     * The distance between the popover and the anchor element.
+     *
+     * Live examples:
+     * - [Combobox filtering](https://ariakit.org/examples/combobox-filtering)
+     * - [Form with Select](https://ariakit.org/examples/form-select)
+     * - [Hovercard with keyboard support](https://ariakit.org/examples/hovercard-disclosure)
+     * - [MenuItemRadio](https://ariakit.org/examples/menu-item-radio)
+     * - [Submenu](https://ariakit.org/examples/menu-nested)
+     * - [Toolbar with Select](https://ariakit.org/examples/toolbar-select)
+     * @default 0
+     */
+    gutter?: number;
+    /**
+     * The skidding of the popover along the anchor element. Can be set to
+     * negative values to make the popover shift to the opposite side.
+     *
+     * Live examples:
+     * - [Submenu](https://ariakit.org/examples/menu-nested)
+     * - [Menubar](https://ariakit.org/components/menubar)
+     * @default 0
+     */
+    shift?: number;
+    /**
+     * Controls the behavior of the popover when it overflows the viewport:
+     * - If a `boolean`, specifies whether the popover should flip to the opposite
+     *   side when it overflows.
+     * - If a `string`, indicates the preferred fallback placements when it
+     *   overflows. The placements must be spaced-delimited, e.g. "top left".
+     *
+     * Live examples:
+     * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
+     * - [Menubar](https://ariakit.org/components/menubar)
+     * @default true
+     */
+    flip?: boolean | string;
+    /**
+     * Whether the popover should slide when it overflows.
+     * @default true
+     */
+    slide?: boolean;
+    /**
+     * Whether the popover can overlap the anchor element when it overflows.
+     *
+     * Live examples:
+     * - [Menubar](https://ariakit.org/components/menubar)
+     * @default false
+     */
+    overlap?: boolean;
+    /**
+     * Whether the popover should have the same width as the anchor element. This
+     * will be exposed to CSS as
+     * [`--popover-anchor-width`](https://ariakit.org/guide/styling#--popover-anchor-width).
+     * @default false
+     */
+    sameWidth?: boolean;
+    /**
+     * Whether the popover should fit the viewport. If this is set to true, the
+     * popover wrapper will have `maxWidth` and `maxHeight` set to the viewport
+     * size. This will be exposed to CSS as
+     * [`--popover-available-width`](https://ariakit.org/guide/styling#--popover-available-width)
+     * and
+     * [`--popover-available-height`](https://ariakit.org/guide/styling#--popover-available-height).
+     *
+     * Live examples:
+     * - [Textarea with inline
+     *   Combobox](https://ariakit.org/examples/combobox-textarea)
+     * - [Menubar](https://ariakit.org/components/menubar)
+     * @default false
+     */
+    fitViewport?: boolean;
+    /**
+     * The minimum padding between the arrow and the popover corner.
+     * @default 4
+     */
+    arrowPadding?: number;
+    /**
+     * The minimum padding between the popover and the viewport edge. This will be
+     * exposed to CSS as
+     * [`--popover-overflow-padding`](https://ariakit.org/guide/styling#--popover-overflow-padding).
+     * @default 8
+     */
+    overflowPadding?: number;
+    /**
+     * Function that returns the anchor element's DOMRect. If this is explicitly
+     * passed, it will override the anchor `getBoundingClientRect` method.
+     *
+     * Live examples:
+     *  - [Textarea with inline combobox](https://ariakit.org/examples/combobox-textarea)
+     *  - [Standalone Popover](https://ariakit.org/examples/popover-standalone)
+     *  - [Context menu](https://ariakit.org/examples/menu-context-menu)
+     *  - [Selection Popover](https://ariakit.org/examples/popover-selection)
+     * @param anchor The anchor element.
+     */
+    getAnchorRect?: (anchor: HTMLElement | null) => AnchorRect | null;
+    /**
+     * A callback that will be called when the popover needs to calculate its
+     * position. This will override the internal `updatePosition` function. The
+     * original `updatePosition` function will be passed as an argument, so it can
+     * be called inside the callback to apply the default behavior.
+     *
+     * Live examples:
+     *  - [Responsive Popover](https://ariakit.org/examples/popover-responsive)
+     */
+    updatePosition?: (props: {
+        updatePosition: () => Promise<void>;
+    }) => void | Promise<void>;
+}
+export type PopoverProps<T extends As = "div"> = Props<PopoverOptions<T>>;
+export {};

package/cjs/popover/popover.d.ts

@@ -52,12 +52,24 @@ export interface PopoverOptions<T extends As = "div"> extends DialogOptions<T> {
     fixed?: boolean;
     /**
      * The distance between the popover and the anchor element.
+     *
+     * Live examples:
+     * - [Combobox filtering](https://ariakit.org/examples/combobox-filtering)
+     * - [Form with Select](https://ariakit.org/examples/form-select)
+     * - [Hovercard with keyboard support](https://ariakit.org/examples/hovercard-disclosure)
+     * - [MenuItemRadio](https://ariakit.org/examples/menu-item-radio)
+     * - [Submenu](https://ariakit.org/examples/menu-nested)
+     * - [Toolbar with Select](https://ariakit.org/examples/toolbar-select)
      * @default 0
      */
     gutter?: number;
     /**
      * The skidding of the popover along the anchor element. Can be set to
      * negative values to make the popover shift to the opposite side.
+     *
+     * Live examples:
+     * - [Submenu](https://ariakit.org/examples/menu-nested)
+     * - [Menubar](https://ariakit.org/components/menubar)
      * @default 0
      */
     shift?: number;
@@ -67,6 +79,10 @@ export interface PopoverOptions<T extends As = "div"> extends DialogOptions<T> {
      *   side when it overflows.
      * - If a `string`, indicates the preferred fallback placements when it
      *   overflows. The placements must be spaced-delimited, e.g. "top left".
+     *
+     * Live examples:
+     * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
+     * - [Menubar](https://ariakit.org/components/menubar)
      * @default true
      */
     flip?: boolean | string;
@@ -77,6 +93,9 @@ export interface PopoverOptions<T extends As = "div"> extends DialogOptions<T> {
     slide?: boolean;
     /**
      * Whether the popover can overlap the anchor element when it overflows.
+     *
+     * Live examples:
+     * - [Menubar](https://ariakit.org/components/menubar)
      * @default false
      */
     overlap?: boolean;
@@ -94,6 +113,11 @@ export interface PopoverOptions<T extends As = "div"> extends DialogOptions<T> {
      * [`--popover-available-width`](https://ariakit.org/guide/styling#--popover-available-width)
      * and
      * [`--popover-available-height`](https://ariakit.org/guide/styling#--popover-available-height).
+     *
+     * Live examples:
+     * - [Textarea with inline
+     *   Combobox](https://ariakit.org/examples/combobox-textarea)
+     * - [Menubar](https://ariakit.org/components/menubar)
      * @default false
      */
     fitViewport?: boolean;

package/cjs/portal/portal-context.cjs

@@ -1,7 +1,8 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
-var _NS56XHXGcjs = require('../__chunks/NS56XHXG.cjs');
-require('../__chunks/72I2GWXF.cjs');
 
+var _CVD2AZE2cjs = require('../__chunks/CVD2AZE2.cjs');
+require('../__chunks/AV6KTKLE.cjs');
 
-exports.PortalContext = _NS56XHXGcjs.PortalContext;
+
+exports.PortalContext = _CVD2AZE2cjs.PortalContext;

package/cjs/portal/portal-context.d.cts

@@ -0,0 +1,17 @@
+/**
+ * Stores the element that will contain the portal. By default, it will be the
+ * body of the document.
+ * @example
+ * ```jsx
+ * const container = document.getElementById("container");
+ *
+ * function App() {
+ *   return (
+ *     <PortalContext.Provider value={container}>
+ *       <Portal />
+ *     </PortalContext.Provider>
+ *   );
+ * }
+ * ```
+ */
+export declare const PortalContext: import("react").Context<HTMLElement | null>;

package/cjs/portal/portal.cjs

@@ -1,15 +1,16 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _MNZPRWGCcjs = require('../__chunks/MNZPRWGC.cjs');
-require('../__chunks/CKEXTQ2S.cjs');
-require('../__chunks/NS56XHXG.cjs');
-require('../__chunks/KSFAO77E.cjs');
-require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/5WLTMVVQ.cjs');
-require('../__chunks/7WUTS26Y.cjs');
-require('../__chunks/72I2GWXF.cjs');
 
+var _S6WUBPBBcjs = require('../__chunks/S6WUBPBB.cjs');
+require('../__chunks/XB3G2EO2.cjs');
+require('../__chunks/CVD2AZE2.cjs');
+require('../__chunks/R66IWXK6.cjs');
+require('../__chunks/RNZNGEL4.cjs');
+require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/CJDHQUBR.cjs');
+require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.Portal = _MNZPRWGCcjs.Portal; exports.usePortal = _MNZPRWGCcjs.usePortal;
+
+exports.Portal = _S6WUBPBBcjs.Portal; exports.usePortal = _S6WUBPBBcjs.usePortal;