@ariakit/react-core 0.3.2 → 0.3.3

package/esm/menu/menu.js

@@ -1,30 +1,30 @@
 import {
   useMenuList
-} from "../__chunks/VDTDCNMP.js";
+} from "../__chunks/DA5VDN5G.js";
 import {
   useMenuProviderContext
 } from "../__chunks/2GC3IEM7.js";
 import "../__chunks/YVYWIVKG.js";
-import "../__chunks/HYNMOU7J.js";
+import "../__chunks/56TAEBRJ.js";
 import "../__chunks/OXPV2NBK.js";
 import "../__chunks/5C7J4IAS.js";
 import "../__chunks/74KKBFVP.js";
 import {
   useHovercard
-} from "../__chunks/34JEM52B.js";
+} from "../__chunks/4VQSZLZX.js";
 import "../__chunks/X7FKJQME.js";
-import "../__chunks/GP4UGJIZ.js";
-import "../__chunks/4RP654JS.js";
-import "../__chunks/W575AF63.js";
-import "../__chunks/PLOINBVB.js";
-import "../__chunks/HAVCR65N.js";
+import "../__chunks/MNVQ65E5.js";
+import "../__chunks/YGEFENKI.js";
+import "../__chunks/IAA7Y45N.js";
+import "../__chunks/HWJ7DGMR.js";
+import "../__chunks/7LB47D2O.js";
 import "../__chunks/62DFK33R.js";
-import "../__chunks/KGDYSCOM.js";
-import "../__chunks/XASENZA4.js";
-import "../__chunks/X5VV5CBA.js";
+import "../__chunks/FRKOFFMT.js";
+import "../__chunks/EGOOWJGN.js";
+import "../__chunks/7VWXICM7.js";
 import "../__chunks/KOVUJERF.js";
 import "../__chunks/IXXFVVA2.js";
-import "../__chunks/5M4ITSXL.js";
+import "../__chunks/VRCYQ6JX.js";
 import "../__chunks/7JNF6I52.js";
 import "../__chunks/3LGVTTHD.js";
 import "../__chunks/FW6QFGFT.js";
@@ -41,7 +41,7 @@ import "../__chunks/5DA3HK6G.js";
 import "../__chunks/547DFODS.js";
 import "../__chunks/5YYGDU4E.js";
 import "../__chunks/56KWVYDN.js";
-import "../__chunks/M4OAD5XF.js";
+import "../__chunks/YTHH33BK.js";
 import "../__chunks/BMLNRUFQ.js";
 import "../__chunks/6XXSNRNX.js";
 import {
@@ -49,11 +49,9 @@ import {
   createElement,
   createHook
 } from "../__chunks/CFEUKV6C.js";
-import "../__chunks/A2ONBKVT.js";
-import "../__chunks/XXO3VVQU.js";
+import "../__chunks/BWOZSOC7.js";
+import "../__chunks/4LP74VAP.js";
 import {
-  useBooleanEvent,
-  useEvent,
   useMergeRefs
 } from "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
@@ -66,17 +64,21 @@ import {
 // src/menu/menu.ts
 import { createRef, useEffect, useRef, useState } from "react";
 import { hasFocusWithin } from "@ariakit/core/utils/focus";
-import { invariant } from "@ariakit/core/utils/misc";
+import { invariant, isFalsyBooleanCallback } from "@ariakit/core/utils/misc";
 var useMenu = createHook(
   (_a) => {
     var _b = _a, {
       store,
+      modal: modalProp = false,
+      portal = !!modalProp,
       hideOnEscape = true,
       autoFocusOnShow = true,
       hideOnHoverOutside,
       alwaysVisible
     } = _b, props = __objRest(_b, [
       "store",
+      "modal",
+      "portal",
       "hideOnEscape",
       "autoFocusOnShow",
       "hideOnHoverOutside",
@@ -93,24 +95,8 @@ var useMenu = createHook(
     const parentMenuBar = store.menubar;
     const hasParentMenu = !!parentMenu;
     const parentIsMenuBar = !!parentMenuBar && !hasParentMenu;
-    const onKeyDownProp = props.onKeyDown;
-    const hideOnEscapeProp = useBooleanEvent(hideOnEscape);
-    const onKeyDown = useEvent((event) => {
-      onKeyDownProp == null ? void 0 : onKeyDownProp(event);
-      if (event.defaultPrevented)
-        return;
-      if (event.key === "Escape") {
-        if (!hideOnEscapeProp(event))
-          return;
-        if (!hasParentMenu) {
-          event.stopPropagation();
-        }
-        return store == null ? void 0 : store.hide();
-      }
-    });
     props = __spreadProps(__spreadValues({}, props), {
-      ref: useMergeRefs(ref, props.ref),
-      onKeyDown
+      ref: useMergeRefs(ref, props.ref)
     });
     const _a2 = useMenuList(
       __spreadValues({ store, alwaysVisible }, props)
@@ -150,14 +136,21 @@ var useMenu = createHook(
         cleaning = true;
       };
     }, [store, autoFocusOnShowState, initialFocus, items, baseElement]);
+    const modal = hasParentMenu ? false : modalProp;
     const mayAutoFocusOnShow = !!autoFocusOnShow;
-    const canAutoFocusOnShow = !!initialFocusRef || !!props.initialFocus || !!props.modal;
+    const canAutoFocusOnShow = !!initialFocusRef || !!props.initialFocus || !!modal;
     props = useHovercard(__spreadProps(__spreadValues({
       store,
       alwaysVisible,
       initialFocus: initialFocusRef,
-      autoFocusOnShow: mayAutoFocusOnShow ? canAutoFocusOnShow && autoFocusOnShow : autoFocusOnShowState || !!props.modal
+      autoFocusOnShow: mayAutoFocusOnShow ? canAutoFocusOnShow && autoFocusOnShow : autoFocusOnShowState || !!modal
     }, props), {
+      hideOnEscape: (event) => {
+        if (isFalsyBooleanCallback(hideOnEscape, event))
+          return false;
+        store == null ? void 0 : store.hideAll();
+        return true;
+      },
       hideOnHoverOutside: (event) => {
         if (typeof hideOnHoverOutside === "function") {
           return hideOnHoverOutside(event);
@@ -177,14 +170,9 @@ var useMenu = createHook(
           return false;
         return true;
       },
-      // If it's a submenu, it shouldn't behave like a modal dialog, nor display
-      // a backdrop.
-      modal: hasParentMenu ? false : props.modal,
-      backdrop: hasParentMenu ? false : props.backdrop,
-      // If it's a submenu, hide on esc will be handled differently. That is,
-      // event.stopPropagation() won't be called, so the parent menus will also
-      // be closed.
-      hideOnEscape: hasParentMenu ? false : hideOnEscape
+      modal,
+      portal,
+      backdrop: hasParentMenu ? false : props.backdrop
     }));
     props = __spreadValues({
       "aria-labelledby": ariaLabelledBy

package/esm/popover/popover-anchor.d.ts

@@ -18,15 +18,20 @@ export declare const usePopoverAnchor: import("../utils/types.js").Hook<PopoverA
  * @see https://ariakit.org/components/popover
  * @example
  * ```jsx
- * const popover = usePopoverStore();
- * <PopoverAnchor store={popover}>Anchor</PopoverAnchor>
- * <Popover store={popover}>Popover</Popover>
+ * <PopoverProvider>
+ *   <PopoverAnchor>Anchor</PopoverAnchor>
+ *   <Popover>Popover</Popover>
+ * </PopoverProvider>
  * ```
  */
 export declare const PopoverAnchor: import("../utils/types.js").Component<PopoverAnchorOptions<"div">>;
 export interface PopoverAnchorOptions<T extends As = "div"> extends Options<T> {
     /**
-     * Object returned by the `usePopoverStore` hook.
+     * 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;
 }

package/esm/popover/popover-arrow.d.ts

@@ -15,22 +15,28 @@ import type { PopoverStore } from "./popover-store.js";
  */
 export declare const usePopoverArrow: import("../utils/types.js").Hook<PopoverArrowOptions<"div">>;
 /**
- * Renders an arrow inside a `Popover` component.
+ * Renders an arrow inside a [`Popover`](https://ariakit.org/reference/popover)
+ * component.
  * @see https://ariakit.org/components/popover
  * @example
  * ```jsx
- * const popover = usePopoverStore();
- * <Popover store={popover}>
- *   <PopoverArrow />
- *   Popover
- * </Popover>
+ * <PopoverProvider>
+ *   <Popover>
+ *     <PopoverArrow />
+ *     Popover
+ *   </Popover>
+ * </PopoverProvider>
  * ```
  */
 export declare const PopoverArrow: import("../utils/types.js").Component<PopoverArrowOptions<"div">>;
 export interface PopoverArrowOptions<T extends As = "div"> extends Options<T> {
     /**
-     * Object returned by the `usePopoverStore` hook. If not provided, the parent
-     * `Popover` component's context will be used.
+     * 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;
     /**

package/esm/popover/popover-description.d.ts

@@ -16,22 +16,27 @@ import type { PopoverStore } from "./popover-store.js";
 export declare const usePopoverDescription: import("../utils/types.js").Hook<PopoverDescriptionOptions<"p">>;
 /**
  * Renders a description in a popover. This component must be wrapped with
- * `Popover` so the `aria-describedby` prop is properly set on the popover
- * element.
+ * [`Popover`](https://ariakit.org/reference/popover) so the `aria-describedby`
+ * prop is properly set on the popover element.
  * @see https://ariakit.org/components/popover
  * @example
  * ```jsx
- * const popover = usePopoverStore();
- * <Popover store={popover}>
- *   <PopoverDescription>Description</PopoverDescription>
- * </Popover>
+ * <PopoverProvider>
+ *   <Popover>
+ *     <PopoverDescription>Description</PopoverDescription>
+ *   </Popover>
+ * </PopoverProvider>
  * ```
  */
 export declare const PopoverDescription: import("../utils/types.js").Component<PopoverDescriptionOptions<"p">>;
 export interface PopoverDescriptionOptions<T extends As = "p"> extends DialogDescriptionOptions<T> {
     /**
-     * Object returned by the `usePopoverStore` hook. If not provided, the parent
-     * `Popover` component's context will be used.
+     * 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;
 }

package/esm/popover/popover-disclosure-arrow.d.ts

@@ -16,28 +16,36 @@ import type { PopoverStore, PopoverStoreState } from "./popover-store.js";
 export declare const usePopoverDisclosureArrow: import("../utils/types.js").Hook<PopoverDisclosureArrowOptions<"span">>;
 /**
  * Renders an arrow pointing to the popover position. It's usually rendered
- * inside the `PopoverDisclosure` component.
+ * inside the
+ * [`PopoverDisclosure`](https://ariakit.org/reference/popover-disclosure)
+ * component.
  * @see https://ariakit.org/components/popover
  * @example
  * ```jsx
- * const popover = usePopoverStore();
- * <PopoverDisclosure store={popover}>
- *   Disclosure
- *   <PopoverDisclosureArrow />
- * </PopoverDisclosure>
- * <Popover store={popover}>Popover</Popover>
+ * <PopoverProvider>
+ *   <PopoverDisclosure>
+ *     Disclosure
+ *     <PopoverDisclosureArrow />
+ *   </PopoverDisclosure>
+ *   <Popover>Popover</Popover>
+ * </PopoverProvider>
  * ```
  */
 export declare const PopoverDisclosureArrow: import("../utils/types.js").Component<PopoverDisclosureArrowOptions<"span">>;
 export interface PopoverDisclosureArrowOptions<T extends As = "span"> extends Options<T> {
     /**
-     * Object returned by the `usePopoverStore` hook. If not provided, the parent
-     * `PopoverDisclosure` component's context will be used.
+     * Object returned by the
+     * [`usePopoverStore`](https://ariakit.org/reference/use-popover-store) hook.
+     * If not provided, the closest
+     * [`PopoverDisclosure`](https://ariakit.org/reference/popover-disclosure) or
+     * [`PopoverProvider`](https://ariakit.org/reference/popover-provider)
+     * components' context will be used.
      */
     store?: PopoverStore;
     /**
      * Placement to which the arrow should point. If not provided, the parent
-     * `PopoverDisclosure` component's context will be used.
+     * [`PopoverDisclosure`](https://ariakit.org/reference/popover-disclosure)
+     * component's context will be used.
      */
     placement?: PopoverStoreState["placement"];
 }

package/esm/popover/popover-disclosure.d.ts

@@ -18,9 +18,10 @@ export declare const usePopoverDisclosure: import("../utils/types.js").Hook<Popo
  * @see https://ariakit.org/components/popover
  * @example
  * ```jsx
- * const popover = usePopoverStore();
- * <PopoverDisclosure store={popover}>Disclosure</PopoverDisclosure>
- * <Popover store={popover}>Popover</Popover>
+ * <PopoverProvider>
+ *   <PopoverDisclosure>Disclosure</PopoverDisclosure>
+ *   <Popover>Popover</Popover>
+ * </PopoverProvider>
  * ```
  */
 export declare const PopoverDisclosure: import("../utils/types.js").Component<PopoverDisclosureOptions<"button">>;

package/esm/popover/popover-disclosure.js

@@ -1,16 +1,16 @@
 import {
   PopoverDisclosure,
   usePopoverDisclosure
-} from "../__chunks/MXSIXS3C.js";
-import "../__chunks/TQ2YQL6O.js";
-import "../__chunks/7AFOF5E7.js";
+} from "../__chunks/SUD3LBWB.js";
+import "../__chunks/3HY5ZQT3.js";
+import "../__chunks/R6PKH666.js";
 import "../__chunks/4FNI7F6H.js";
-import "../__chunks/QPWEKAWF.js";
-import "../__chunks/LND6SMHN.js";
+import "../__chunks/D2BRO4YW.js";
+import "../__chunks/XBIFFFUN.js";
 import "../__chunks/547DFODS.js";
 import "../__chunks/5YYGDU4E.js";
 import "../__chunks/56KWVYDN.js";
-import "../__chunks/M4OAD5XF.js";
+import "../__chunks/YTHH33BK.js";
 import "../__chunks/BMLNRUFQ.js";
 import "../__chunks/CFEUKV6C.js";
 import "../__chunks/J7Q2EO23.js";

package/esm/popover/popover-dismiss.d.ts

@@ -15,21 +15,27 @@ import type { PopoverStore } from "./popover-store.js";
  */
 export declare const usePopoverDismiss: import("../utils/types.js").Hook<PopoverDismissOptions<"button">>;
 /**
- * Renders a button that hides a popover.
+ * Renders a button that hides a
+ * [`Popover`](https://ariakit.org/reference/popover) component when clicked.
  * @see https://ariakit.org/components/popover
  * @example
  * ```jsx
- * const popover = usePopoverStore();
- * <Popover store={popover}>
- *   <PopoverDismiss />
- * </Popover>
+ * <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` hook. If not provided, the parent
-     * `Popover` component's context will be used.
+     * 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;
 }

package/esm/popover/popover-dismiss.js

@@ -1,14 +1,14 @@
 import {
   PopoverDismiss,
   usePopoverDismiss
-} from "../__chunks/4JNX5L5C.js";
-import "../__chunks/HMYMEP6U.js";
-import "../__chunks/QPWEKAWF.js";
-import "../__chunks/LND6SMHN.js";
+} from "../__chunks/T5VBGHBO.js";
+import "../__chunks/W5ZMSHVN.js";
+import "../__chunks/D2BRO4YW.js";
+import "../__chunks/XBIFFFUN.js";
 import "../__chunks/547DFODS.js";
 import "../__chunks/5YYGDU4E.js";
 import "../__chunks/56KWVYDN.js";
-import "../__chunks/M4OAD5XF.js";
+import "../__chunks/YTHH33BK.js";
 import "../__chunks/BMLNRUFQ.js";
 import "../__chunks/CFEUKV6C.js";
 import "../__chunks/J7Q2EO23.js";

package/esm/popover/popover-heading.d.ts

@@ -15,22 +15,28 @@ import type { PopoverStore } from "./popover-store.js";
  */
 export declare const usePopoverHeading: import("../utils/types.js").Hook<PopoverHeadingOptions<"h1">>;
 /**
- * Renders a heading in a popover. This component must be wrapped with `Popover`
- * so the `aria-labelledby` prop is properly set on the popover element.
+ * 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
- * const popover = usePopoverStore();
- * <Popover store={popover}>
- *   <PopoverHeading>Heading</PopoverHeading>
- * </Popover>
+ * <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` hook. If not provided, the parent
-     * `Popover` component's context will be used.
+     * 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;
 }

package/esm/popover/popover-provider.js

@@ -6,10 +6,10 @@ import "../__chunks/56KWVYDN.js";
 import "../__chunks/CFEUKV6C.js";
 import {
   usePopoverStore
-} from "../__chunks/H2BG4QDT.js";
-import "../__chunks/UY3UQ4QI.js";
-import "../__chunks/A2ONBKVT.js";
-import "../__chunks/XXO3VVQU.js";
+} from "../__chunks/DO6GQUCF.js";
+import "../__chunks/DJUMA466.js";
+import "../__chunks/BWOZSOC7.js";
+import "../__chunks/4LP74VAP.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/popover/popover-store.js

@@ -1,10 +1,10 @@
 import {
   usePopoverStore,
   usePopoverStoreProps
-} from "../__chunks/H2BG4QDT.js";
-import "../__chunks/UY3UQ4QI.js";
-import "../__chunks/A2ONBKVT.js";
-import "../__chunks/XXO3VVQU.js";
+} from "../__chunks/DO6GQUCF.js";
+import "../__chunks/DJUMA466.js";
+import "../__chunks/BWOZSOC7.js";
+import "../__chunks/4LP74VAP.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/popover/popover.d.ts

@@ -24,16 +24,20 @@ export declare const usePopover: import("../utils/types.js").Hook<PopoverOptions
  * @see https://ariakit.org/components/popover
  * @example
  * ```jsx
- * const popover = usePopoverStore();
- * <PopoverDisclosure store={popover}>Disclosure</PopoverDisclosure>
- * <Popover store={popover}>Popover</Popover>
+ * <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` hook.
-     * @see https://ariakit.org/guide/component-stores
+     * 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;
     /**
@@ -59,10 +63,10 @@ export interface PopoverOptions<T extends As = "div"> extends DialogOptions<T> {
     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".
+     * - 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".
      * @default true
      */
     flip?: boolean | string;

package/esm/popover/popover.js

@@ -1,18 +1,18 @@
 import {
   Popover,
   usePopover
-} from "../__chunks/GP4UGJIZ.js";
-import "../__chunks/4RP654JS.js";
-import "../__chunks/W575AF63.js";
-import "../__chunks/PLOINBVB.js";
-import "../__chunks/HAVCR65N.js";
+} from "../__chunks/MNVQ65E5.js";
+import "../__chunks/YGEFENKI.js";
+import "../__chunks/IAA7Y45N.js";
+import "../__chunks/HWJ7DGMR.js";
+import "../__chunks/7LB47D2O.js";
 import "../__chunks/62DFK33R.js";
-import "../__chunks/KGDYSCOM.js";
-import "../__chunks/XASENZA4.js";
-import "../__chunks/X5VV5CBA.js";
+import "../__chunks/FRKOFFMT.js";
+import "../__chunks/EGOOWJGN.js";
+import "../__chunks/7VWXICM7.js";
 import "../__chunks/KOVUJERF.js";
 import "../__chunks/IXXFVVA2.js";
-import "../__chunks/5M4ITSXL.js";
+import "../__chunks/VRCYQ6JX.js";
 import "../__chunks/7JNF6I52.js";
 import "../__chunks/3LGVTTHD.js";
 import "../__chunks/FW6QFGFT.js";
@@ -28,12 +28,12 @@ import "../__chunks/3D7ZB3CS.js";
 import "../__chunks/547DFODS.js";
 import "../__chunks/5YYGDU4E.js";
 import "../__chunks/56KWVYDN.js";
-import "../__chunks/M4OAD5XF.js";
+import "../__chunks/YTHH33BK.js";
 import "../__chunks/BMLNRUFQ.js";
 import "../__chunks/6XXSNRNX.js";
 import "../__chunks/CFEUKV6C.js";
-import "../__chunks/A2ONBKVT.js";
-import "../__chunks/XXO3VVQU.js";
+import "../__chunks/BWOZSOC7.js";
+import "../__chunks/4LP74VAP.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/portal/portal.d.ts

@@ -22,8 +22,9 @@ export declare const Portal: import("../utils/types.js").Component<PortalOptions
 export interface PortalOptions<T extends As = "div"> extends Options<T> {
     /**
      * When enabled, `preserveTabOrder` will keep the DOM element's tab order the
-     * same as the order in which the `Portal` component was mounted in the React
-     * tree.
+     * same as the order in which the underlying
+     * [`Portal`](https://ariakit.org/reference/portal) component was mounted in
+     * the React tree.
      * @default false
      */
     preserveTabOrder?: boolean;
@@ -32,8 +33,11 @@ export interface PortalOptions<T extends As = "div"> extends Options<T> {
      * useful when you need to be informed when the portal element is appended to
      * the DOM or removed from the DOM.
      * @example
+     * ```jsx
      * const [portalElement, setPortalElement] = useState(null);
-     * <Portal portalRef={setPortalElement} />;
+     *
+     * <Portal portalRef={setPortalElement} />
+     * ```
      */
     portalRef?: RefCallback<HTMLElement> | MutableRefObject<HTMLElement | null>;
     /**
@@ -47,17 +51,24 @@ export interface PortalOptions<T extends As = "div"> extends Options<T> {
      * will be a `div` element appended to the `document.body`.
      * @default HTMLDivElement
      * @example
+     * ```jsx
      * const [portal, setPortal] = useState(null);
-     * <Portal portalElement={portal} />;
-     * <div ref={setPortal} />;
+     * <>
+     *   <Portal portalElement={portal} />
+     *   <div ref={setPortal} />
+     * </>
+     * ```
      * @example
+     * ```jsx
      * const getPortalElement = useCallback(() => {
      *   const div = document.createElement("div");
      *   const portalRoot = document.getElementById("portal-root");
      *   portalRoot.appendChild(div);
      *   return div;
      * }, []);
-     * <Portal portalElement={getPortalElement} />;
+     *
+     * <Portal portalElement={getPortalElement} />
+     * ```
      */
     portalElement?: ((element: HTMLElement) => HTMLElement | null) | HTMLElement | null;
 }

package/esm/radio/radio-group.d.ts

@@ -30,7 +30,11 @@ export declare const useRadioGroup: import("../utils/types.js").Hook<RadioGroupO
 export declare const RadioGroup: import("../utils/types.js").Component<RadioGroupOptions<"div">>;
 export interface RadioGroupOptions<T extends As = "div"> extends CompositeOptions<T> {
     /**
-     * Object returned by the `useRadioStore` hook.
+     * Object returned by the
+     * [`useRadioStore`](https://ariakit.org/reference/use-radio-store) hook. If
+     * not provided, the closest
+     * [`RadioProvider`](https://ariakit.org/reference/radio-provider) component's
+     * context will be used.
      */
     store?: RadioStore;
 }

package/esm/radio/radio-group.js

@@ -4,11 +4,11 @@ import {
 } from "../__chunks/NRFPH2ON.js";
 import {
   useComposite
-} from "../__chunks/HYNMOU7J.js";
+} from "../__chunks/56TAEBRJ.js";
 import "../__chunks/OXPV2NBK.js";
 import "../__chunks/5C7J4IAS.js";
 import "../__chunks/74KKBFVP.js";
-import "../__chunks/M4OAD5XF.js";
+import "../__chunks/YTHH33BK.js";
 import "../__chunks/BMLNRUFQ.js";
 import {
   createComponent,