@ariakit/react-core 0.3.2 → 0.3.4

package/esm/composite/composite-item.js

@@ -1,16 +1,16 @@
 import {
   CompositeItem,
   useCompositeItem
-} from "../__chunks/72OJKUSZ.js";
-import "../__chunks/LND6SMHN.js";
+} from "../__chunks/IQXVWBXC.js";
+import "../__chunks/CAIAWNDV.js";
 import "../__chunks/XIA3HAXM.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 "../__chunks/CFEUKV6C.js";
-import "../__chunks/XXO3VVQU.js";
+import "../__chunks/WHAB4XD6.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/composite/composite-overflow-disclosure.js

@@ -1,14 +1,14 @@
 import {
   usePopoverDisclosure
-} from "../__chunks/MXSIXS3C.js";
-import "../__chunks/TQ2YQL6O.js";
-import "../__chunks/7AFOF5E7.js";
+} from "../__chunks/HXYXHHNW.js";
+import "../__chunks/5EAW3TWZ.js";
+import "../__chunks/LRDCOOWL.js";
 import "../__chunks/4FNI7F6H.js";
-import "../__chunks/QPWEKAWF.js";
+import "../__chunks/TONP6TZ5.js";
 import {
   useCompositeItem
-} from "../__chunks/72OJKUSZ.js";
-import "../__chunks/LND6SMHN.js";
+} from "../__chunks/IQXVWBXC.js";
+import "../__chunks/CAIAWNDV.js";
 import "../__chunks/XIA3HAXM.js";
 import "../__chunks/OXPV2NBK.js";
 import "../__chunks/5C7J4IAS.js";
@@ -16,14 +16,14 @@ import "../__chunks/74KKBFVP.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 {
   createComponent,
   createElement,
   createHook
 } from "../__chunks/CFEUKV6C.js";
-import "../__chunks/XXO3VVQU.js";
+import "../__chunks/WHAB4XD6.js";
 import {
   useEvent,
   useMergeRefs

package/esm/composite/composite-overflow-store.js

@@ -1,11 +1,11 @@
 import {
   usePopoverStoreProps
-} from "../__chunks/H2BG4QDT.js";
-import "../__chunks/UY3UQ4QI.js";
-import "../__chunks/A2ONBKVT.js";
+} from "../__chunks/QTZ67ALK.js";
+import "../__chunks/IZFXPXHG.js";
+import "../__chunks/OD3JT64N.js";
 import {
   useStore
-} from "../__chunks/XXO3VVQU.js";
+} from "../__chunks/WHAB4XD6.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/composite/composite-overflow.js

@@ -1,17 +1,17 @@
 import {
   usePopover
-} from "../__chunks/GP4UGJIZ.js";
-import "../__chunks/4RP654JS.js";
-import "../__chunks/W575AF63.js";
-import "../__chunks/PLOINBVB.js";
-import "../__chunks/HAVCR65N.js";
+} from "../__chunks/H3CXUGYG.js";
+import "../__chunks/UXIMR4AS.js";
+import "../__chunks/NXB7YL3C.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";
@@ -23,11 +23,11 @@ import "../__chunks/QW4PFVNF.js";
 import "../__chunks/LDDPB3PY.js";
 import "../__chunks/COQHFAEN.js";
 import "../__chunks/PGK6S5NC.js";
-import "../__chunks/3D7ZB3CS.js";
+import "../__chunks/KK6NPMOP.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 {
@@ -35,8 +35,9 @@ import {
   createElement,
   createHook
 } from "../__chunks/CFEUKV6C.js";
-import "../__chunks/A2ONBKVT.js";
-import "../__chunks/XXO3VVQU.js";
+import "../__chunks/IZFXPXHG.js";
+import "../__chunks/OD3JT64N.js";
+import "../__chunks/WHAB4XD6.js";
 import {
   useEvent
 } from "../__chunks/J7Q2EO23.js";

package/esm/composite/composite-provider.js

@@ -1,13 +1,13 @@
 import {
   useCompositeStore
-} from "../__chunks/WGAKICTY.js";
-import "../__chunks/NWDF5QDV.js";
+} from "../__chunks/WRZGD4DH.js";
+import "../__chunks/YS46MLTR.js";
 import {
   CompositeContextProvider
 } from "../__chunks/5C7J4IAS.js";
 import "../__chunks/74KKBFVP.js";
 import "../__chunks/CFEUKV6C.js";
-import "../__chunks/XXO3VVQU.js";
+import "../__chunks/WHAB4XD6.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/composite/composite-renderer.d.ts

@@ -64,59 +64,59 @@ export declare function useCompositeRenderer<T extends Item = any>({ store, orie
     unselectable?: "on" | "off" | undefined;
     inputMode?: "search" | "none" | "text" | "email" | "tel" | "url" | "numeric" | "decimal" | undefined;
     is?: string | undefined;
-    'aria-activedescendant'?: string | undefined;
-    'aria-atomic'?: (boolean | "false" | "true") | undefined;
-    'aria-autocomplete'?: "both" | "none" | "inline" | "list" | undefined;
-    'aria-braillelabel'?: string | undefined;
-    'aria-brailleroledescription'?: string | undefined;
-    'aria-busy'?: (boolean | "false" | "true") | undefined;
-    'aria-checked'?: boolean | "mixed" | "false" | "true" | undefined;
-    'aria-colcount'?: number | undefined;
-    'aria-colindex'?: number | undefined;
-    'aria-colindextext'?: string | undefined;
-    'aria-colspan'?: number | undefined;
-    'aria-controls'?: string | undefined;
-    'aria-current'?: boolean | "page" | "false" | "true" | "time" | "date" | "step" | "location" | undefined;
-    'aria-describedby'?: string | undefined;
-    'aria-description'?: string | undefined;
-    'aria-details'?: string | undefined;
-    'aria-disabled'?: (boolean | "false" | "true") | undefined;
-    'aria-dropeffect'?: "link" | "none" | "copy" | "move" | "execute" | "popup" | undefined;
-    'aria-errormessage'?: string | undefined;
-    'aria-expanded'?: (boolean | "false" | "true") | undefined;
-    'aria-flowto'?: string | undefined;
-    'aria-grabbed'?: (boolean | "false" | "true") | undefined;
-    'aria-haspopup'?: boolean | "listbox" | "grid" | "menu" | "false" | "true" | "dialog" | "tree" | undefined;
-    'aria-hidden'?: (boolean | "false" | "true") | undefined;
-    'aria-invalid'?: boolean | "false" | "true" | "grammar" | "spelling" | undefined;
-    'aria-keyshortcuts'?: string | undefined;
-    'aria-label'?: string | undefined;
-    'aria-labelledby'?: string | undefined;
-    'aria-level'?: number | undefined;
-    'aria-live'?: "off" | "assertive" | "polite" | undefined;
-    'aria-modal'?: (boolean | "false" | "true") | undefined;
-    'aria-multiline'?: (boolean | "false" | "true") | undefined;
-    'aria-multiselectable'?: (boolean | "false" | "true") | undefined;
-    'aria-orientation'?: "horizontal" | "vertical" | undefined;
-    'aria-owns'?: string | undefined;
-    'aria-placeholder'?: string | undefined;
-    'aria-posinset'?: number | undefined;
-    'aria-pressed'?: boolean | "mixed" | "false" | "true" | undefined;
-    'aria-readonly'?: (boolean | "false" | "true") | undefined;
-    'aria-relevant'?: "all" | "text" | "additions" | "additions removals" | "additions text" | "removals" | "removals additions" | "removals text" | "text additions" | "text removals" | undefined;
-    'aria-required'?: (boolean | "false" | "true") | undefined;
-    'aria-roledescription'?: string | undefined;
-    'aria-rowcount'?: number | undefined;
-    'aria-rowindex'?: number | undefined;
-    'aria-rowindextext'?: string | undefined;
-    'aria-rowspan'?: number | undefined;
-    'aria-selected'?: (boolean | "false" | "true") | undefined;
-    'aria-setsize'?: number | undefined;
-    'aria-sort'?: "none" | "ascending" | "descending" | "other" | undefined;
-    'aria-valuemax'?: number | undefined;
-    'aria-valuemin'?: number | undefined;
-    'aria-valuenow'?: number | undefined;
-    'aria-valuetext'?: string | undefined;
+    "aria-activedescendant"?: string | undefined;
+    "aria-atomic"?: (boolean | "false" | "true") | undefined;
+    "aria-autocomplete"?: "both" | "none" | "inline" | "list" | undefined;
+    "aria-braillelabel"?: string | undefined;
+    "aria-brailleroledescription"?: string | undefined;
+    "aria-busy"?: (boolean | "false" | "true") | undefined;
+    "aria-checked"?: boolean | "mixed" | "false" | "true" | undefined;
+    "aria-colcount"?: number | undefined;
+    "aria-colindex"?: number | undefined;
+    "aria-colindextext"?: string | undefined;
+    "aria-colspan"?: number | undefined;
+    "aria-controls"?: string | undefined;
+    "aria-current"?: boolean | "page" | "false" | "true" | "time" | "date" | "step" | "location" | undefined;
+    "aria-describedby"?: string | undefined;
+    "aria-description"?: string | undefined;
+    "aria-details"?: string | undefined;
+    "aria-disabled"?: (boolean | "false" | "true") | undefined;
+    "aria-dropeffect"?: "link" | "none" | "copy" | "move" | "execute" | "popup" | undefined;
+    "aria-errormessage"?: string | undefined;
+    "aria-expanded"?: (boolean | "false" | "true") | undefined;
+    "aria-flowto"?: string | undefined;
+    "aria-grabbed"?: (boolean | "false" | "true") | undefined;
+    "aria-haspopup"?: boolean | "listbox" | "grid" | "menu" | "false" | "true" | "dialog" | "tree" | undefined;
+    "aria-hidden"?: (boolean | "false" | "true") | undefined;
+    "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined;
+    "aria-keyshortcuts"?: string | undefined;
+    "aria-label"?: string | undefined;
+    "aria-labelledby"?: string | undefined;
+    "aria-level"?: number | undefined;
+    "aria-live"?: "off" | "assertive" | "polite" | undefined;
+    "aria-modal"?: (boolean | "false" | "true") | undefined;
+    "aria-multiline"?: (boolean | "false" | "true") | undefined;
+    "aria-multiselectable"?: (boolean | "false" | "true") | undefined;
+    "aria-orientation"?: "horizontal" | "vertical" | undefined;
+    "aria-owns"?: string | undefined;
+    "aria-placeholder"?: string | undefined;
+    "aria-posinset"?: number | undefined;
+    "aria-pressed"?: boolean | "mixed" | "false" | "true" | undefined;
+    "aria-readonly"?: (boolean | "false" | "true") | undefined;
+    "aria-relevant"?: "all" | "text" | "additions" | "additions removals" | "additions text" | "removals" | "removals additions" | "removals text" | "text additions" | "text removals" | undefined;
+    "aria-required"?: (boolean | "false" | "true") | undefined;
+    "aria-roledescription"?: string | undefined;
+    "aria-rowcount"?: number | undefined;
+    "aria-rowindex"?: number | undefined;
+    "aria-rowindextext"?: string | undefined;
+    "aria-rowspan"?: number | undefined;
+    "aria-selected"?: (boolean | "false" | "true") | undefined;
+    "aria-setsize"?: number | undefined;
+    "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined;
+    "aria-valuemax"?: number | undefined;
+    "aria-valuemin"?: number | undefined;
+    "aria-valuenow"?: number | undefined;
+    "aria-valuetext"?: string | undefined;
     dangerouslySetInnerHTML?: {
         __html: string | TrustedHTML;
     } | undefined;

package/esm/composite/composite-renderer.js

@@ -1,15 +1,15 @@
 import {
   CompositeRenderer,
   useCompositeRenderer
-} from "../__chunks/C5JX5C3O.js";
+} from "../__chunks/DCODCZJS.js";
 import {
   getCollectionRendererItem,
   getCollectionRendererItemId
-} from "../__chunks/3HFOFZP4.js";
+} from "../__chunks/2FIUKXIM.js";
 import "../__chunks/5C7J4IAS.js";
 import "../__chunks/74KKBFVP.js";
 import "../__chunks/CFEUKV6C.js";
-import "../__chunks/XXO3VVQU.js";
+import "../__chunks/WHAB4XD6.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/composite/composite-store.js

@@ -1,9 +1,9 @@
 import {
   useCompositeStore,
   useCompositeStoreProps
-} from "../__chunks/WGAKICTY.js";
-import "../__chunks/NWDF5QDV.js";
-import "../__chunks/XXO3VVQU.js";
+} from "../__chunks/WRZGD4DH.js";
+import "../__chunks/YS46MLTR.js";
+import "../__chunks/WHAB4XD6.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/composite/composite-typeahead.d.ts

@@ -36,10 +36,6 @@ export interface CompositeTypeaheadOptions<T extends As = "div"> extends Options
     store?: CompositeStore;
     /**
      * Determines whether the typeahead behavior is enabled.
-     *
-     * Live examples:
-     * - [Multi-selectable
-     *   Combobox](https://ariakit.org/examples/combobox-multiple)
      * @default true
      */
     typeahead?: boolean;

package/esm/composite/composite.js

@@ -1,11 +1,11 @@
 import {
   Composite,
   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 "../__chunks/CFEUKV6C.js";
 import "../__chunks/J7Q2EO23.js";

package/esm/dialog/dialog-backdrop.js

@@ -1,17 +1,17 @@
 import {
   DialogBackdrop
-} from "../__chunks/W575AF63.js";
-import "../__chunks/KGDYSCOM.js";
+} from "../__chunks/NXB7YL3C.js";
+import "../__chunks/FRKOFFMT.js";
 import "../__chunks/IXXFVVA2.js";
-import "../__chunks/5M4ITSXL.js";
+import "../__chunks/VRCYQ6JX.js";
 import "../__chunks/FW6QFGFT.js";
 import "../__chunks/PGK6S5NC.js";
-import "../__chunks/3D7ZB3CS.js";
+import "../__chunks/KK6NPMOP.js";
 import "../__chunks/5YYGDU4E.js";
 import "../__chunks/56KWVYDN.js";
 import "../__chunks/CFEUKV6C.js";
-import "../__chunks/A2ONBKVT.js";
-import "../__chunks/XXO3VVQU.js";
+import "../__chunks/OD3JT64N.js";
+import "../__chunks/WHAB4XD6.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/dialog/dialog-disclosure.js

@@ -1,13 +1,13 @@
 import {
   DialogDisclosure,
   useDialogDisclosure
-} from "../__chunks/TQ2YQL6O.js";
-import "../__chunks/7AFOF5E7.js";
-import "../__chunks/QPWEKAWF.js";
-import "../__chunks/LND6SMHN.js";
+} from "../__chunks/5EAW3TWZ.js";
+import "../__chunks/LRDCOOWL.js";
+import "../__chunks/TONP6TZ5.js";
+import "../__chunks/CAIAWNDV.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/dialog/dialog-dismiss.js

@@ -1,12 +1,12 @@
 import {
   DialogDismiss,
   useDialogDismiss
-} from "../__chunks/HMYMEP6U.js";
-import "../__chunks/QPWEKAWF.js";
-import "../__chunks/LND6SMHN.js";
+} from "../__chunks/3KBWC7LF.js";
+import "../__chunks/TONP6TZ5.js";
+import "../__chunks/CAIAWNDV.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/dialog/dialog-provider.js

@@ -5,9 +5,9 @@ import "../__chunks/56KWVYDN.js";
 import "../__chunks/CFEUKV6C.js";
 import {
   useDialogStore
-} from "../__chunks/UY3UQ4QI.js";
-import "../__chunks/A2ONBKVT.js";
-import "../__chunks/XXO3VVQU.js";
+} from "../__chunks/IZFXPXHG.js";
+import "../__chunks/OD3JT64N.js";
+import "../__chunks/WHAB4XD6.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/dialog/dialog-store.js

@@ -1,9 +1,9 @@
 import {
   useDialogStore,
   useDialogStoreProps
-} from "../__chunks/UY3UQ4QI.js";
-import "../__chunks/A2ONBKVT.js";
-import "../__chunks/XXO3VVQU.js";
+} from "../__chunks/IZFXPXHG.js";
+import "../__chunks/OD3JT64N.js";
+import "../__chunks/WHAB4XD6.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/dialog/dialog.d.ts

@@ -3,7 +3,7 @@ import type { BooleanOrCallback } from "@ariakit/core/utils/types";
 import type { DisclosureContentOptions } from "../disclosure/disclosure-content.js";
 import type { FocusableOptions } from "../focusable/focusable.js";
 import type { PortalOptions } from "../portal/portal.js";
-import type { As, Props } from "../utils/types.js";
+import type { As, Component, Props } from "../utils/types.js";
 import type { DialogStore } from "./dialog-store.js";
 /**
  * Returns props to create a `Dialog` component.
@@ -16,6 +16,7 @@ import type { DialogStore } from "./dialog-store.js";
  * ```
  */
 export declare const useDialog: import("../utils/types.js").Hook<DialogOptions<"div">>;
+export declare function createDialogComponent<T extends DialogOptions>(Component: Component<T>, useProviderContext?: () => DialogStore | undefined): Component<T>;
 /**
  * Renders a dialog element.
  * @see https://ariakit.org/components/dialog
@@ -26,23 +27,78 @@ export declare const useDialog: import("../utils/types.js").Hook<DialogOptions<"
  * <Dialog store={dialog}>Dialog</Dialog>
  * ```
  */
-export declare const Dialog: import("../utils/types.js").Component<DialogOptions<"div">>;
+export declare const Dialog: Component<DialogOptions<"div">>;
 export interface DialogOptions<T extends As = "div"> extends FocusableOptions<T>, PortalOptions<T>, DisclosureContentOptions<T> {
     /**
-     * Object returned by the `useDialogStore` hook.
+     * Object returned by the
+     * [`useDialogStore`](https://ariakit.org/reference/use-dialog-store) hook. If
+     * not provided, the closest
+     * [`DialogProvider`](https://ariakit.org/reference/dialog-provider)
+     * component's context will be used. Otherwise, an internal store will be
+     * created.
      */
     store?: DialogStore;
+    /**
+     * Controls the open state of the dialog. This is similar to the
+     * [`open`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLDialogElement/open)
+     * attribute on native dialog elements.
+     *
+     * Live examples:
+     * - [Dialog with scrollable
+     *   backdrop](https://ariakit.org/examples/dialog-backdrop-scrollable)
+     * - [Dialog with details &
+     *   summary](https://ariakit.org/examples/dialog-details)
+     * - [Warning on Dialog
+     *   hide](https://ariakit.org/examples/dialog-hide-warning)
+     * - [Dialog with Menu](https://ariakit.org/examples/dialog-menu)
+     */
+    open?: boolean;
+    /**
+     * This is an event handler prop triggered when the dialog's `close` event is
+     * dispatched. The `close` event is similar to the native dialog
+     * [`close`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLDialogElement/close_event)
+     * event. The only difference is that this event can be cancelled with
+     * `event.preventDefault()`, which will prevent the dialog from hiding.
+     *
+     * It's important to note that this event only fires when the dialog store's
+     * [`open`](https://ariakit.org/reference/use-dialog-store#open) state is set
+     * to `false`. If the controlled
+     * [`open`](https://ariakit.org/reference/dialog#open) prop value changes, or
+     * if the dialog's visibility is altered in any other way (such as unmounting
+     * the dialog without adjusting the open state), this event won't be
+     * triggered.
+     *
+     * Live examples:
+     * - [Dialog with scrollable
+     *   backdrop](https://ariakit.org/examples/dialog-backdrop-scrollable)
+     * - [Dialog with details &
+     *   summary](https://ariakit.org/examples/dialog-details)
+     * - [Warning on Dialog
+     *   hide](https://ariakit.org/examples/dialog-hide-warning)
+     * - [Dialog with Menu](https://ariakit.org/examples/dialog-menu)
+     */
+    onClose?: (event: Event) => void;
     /**
      * Determines whether the dialog is modal. Modal dialogs have distinct states
      * and behaviors:
-     * - The `portal` and `preventBodyScroll` props are set to `true`. They can
-     *   still be manually set to `false`.
-     * - A visually hidden dismiss button will be rendered if the `DialogDismiss`
-     *   component hasn't been used. This allows screen reader users to close the
-     *   dialog.
+     * - The [`portal`](https://ariakit.org/reference/dialog#portal) and
+     *   [`preventBodyScroll`](https://ariakit.org/reference/dialog#preventbodyscroll)
+     *   props are set to `true`. They can still be manually set to `false`.
+     * - A visually hidden dismiss button will be rendered if the
+     *   [`DialogDismiss`](https://ariakit.org/reference/dialog-dismiss) component
+     *   hasn't been used. This allows screen reader users to close the dialog.
      * - When the dialog is open, element tree outside it will be disabled.
-     * - When using the `Heading` or `DialogHeading` components within the dialog,
-     *   their level will be reset so they start with `h1`.
+     * - When using the [`Heading`](https://ariakit.org/reference/heading) or
+     *   [`DialogHeading`](https://ariakit.org/reference/dialog-heading)
+     *   components within the dialog, their level will be reset so they start
+     *   with `h1`.
+     *
+     * Live examples:
+     * - [Dialog with details &
+     *   summary](https://ariakit.org/examples/dialog-details)
+     * - [Form with Select](https://ariakit.org/examples/form-select)
+     * - [Context menu](https://ariakit.org/examples/menu-context-menu)
+     * - [Responsive Popover](https://ariakit.org/examples/popover-responsive)
      * @default true
      */
     modal?: boolean;
@@ -86,6 +142,9 @@ export interface DialogOptions<T extends As = "div"> extends FocusableOptions<T>
     /**
      * Determines whether the dialog will be hidden when the user clicks or focus
      * on an element outside of the dialog.
+     *
+     * Live examples:
+     * - [Selection Popover](https://ariakit.org/examples/popover-selection)
      * @default true
      */
     hideOnInteractOutside?: BooleanOrCallback<Event | SyntheticEvent>;
@@ -111,6 +170,12 @@ export interface DialogOptions<T extends As = "div"> extends FocusableOptions<T>
      * dialog is shown. By default, this is usually the first tabbable element in
      * the dialog or the dialog itself. The `initialFocus` prop can be used to set
      * a different element to receive focus.
+     *
+     * Live examples:
+     * - [Warning on Dialog
+     *   hide](https://ariakit.org/examples/dialog-hide-warning)
+     * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
+     * - [Selection Popover](https://ariakit.org/examples/popover-selection)
      * @default true
      */
     autoFocusOnShow?: BooleanOrCallback<HTMLElement | null>;
@@ -127,10 +192,14 @@ export interface DialogOptions<T extends As = "div"> extends FocusableOptions<T>
     /**
      * Specifies the element that will receive focus when the dialog is first
      * opened. It can be an `HTMLElement` or a `React.RefObject` with an
-     * `HTMLElement`. However, if `autoFocusOnShow` is set to `false`, this prop
-     * will have no effect. If left unset, the dialog will attempt to determine
-     * the initial focus element in the following order:
-     * 1. An element with an `autoFocus` prop.
+     * `HTMLElement`.
+     *
+     * If
+     * [`autoFocusOnShow`](https://ariakit.org/reference/dialog#autofocusonshow)
+     * is set to `false`, this prop will have no effect. If left unset, the dialog
+     * will attempt to determine the initial focus element in the following order:
+     * 1. A [Focusable](https://ariakit.org/components/focusable) element with an
+     *    [`autoFocus`](https://ariakit.org/reference/focusable#autofocus) prop.
      * 2. The first tabbable element inside the dialog.
      * 3. The first focusable element inside the dialog.
      * 4. The dialog element itself.

package/esm/dialog/dialog.js

@@ -1,17 +1,18 @@
 import {
   Dialog,
+  createDialogComponent,
   useDialog
-} from "../__chunks/4RP654JS.js";
-import "../__chunks/W575AF63.js";
-import "../__chunks/PLOINBVB.js";
-import "../__chunks/HAVCR65N.js";
+} from "../__chunks/UXIMR4AS.js";
+import "../__chunks/NXB7YL3C.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";
@@ -23,19 +24,21 @@ import "../__chunks/QW4PFVNF.js";
 import "../__chunks/LDDPB3PY.js";
 import "../__chunks/COQHFAEN.js";
 import "../__chunks/PGK6S5NC.js";
-import "../__chunks/3D7ZB3CS.js";
+import "../__chunks/KK6NPMOP.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/IZFXPXHG.js";
+import "../__chunks/OD3JT64N.js";
+import "../__chunks/WHAB4XD6.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";
 export {
   Dialog,
+  createDialogComponent,
   useDialog
 };

package/esm/dialog/utils/disable-accessibility-tree-outside.d.ts

@@ -1,4 +1,4 @@
 type Elements = Array<Element | null>;
 export declare function hideElementFromAccessibilityTree(element: Element): () => void;
-export declare function disableAccessibilityTreeOutside(...elements: Elements): () => void;
+export declare function disableAccessibilityTreeOutside(id: string, elements: Elements): () => void;
 export {};