@ariakit/react-core 0.3.12 → 0.3.14

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

@@ -3,11 +3,13 @@ import type { BivariantCallback, PickRequired } from "@ariakit/core/utils/types"
 import type { Store } from "../utils/store.js";
 export declare function useCollectionStoreProps<T extends Core.CollectionStore>(store: T, update: () => void, props: CollectionStoreProps): T;
 /**
- * Creates a collection store.
+ * Creates a collection store to control
+ * [Collection](https://ariakit.org/components/collection) components.
  * @see https://ariakit.org/components/collection
  * @example
  * ```jsx
  * const collection = useCollectionStore();
+ *
  * <Collection store={collection}>
  *   <CollectionItem>Item</CollectionItem>
  *   <CollectionItem>Item</CollectionItem>
@@ -25,8 +27,9 @@ export interface CollectionStoreFunctions<T extends CollectionStoreItem = Collec
 }
 export interface CollectionStoreOptions<T extends CollectionStoreItem = CollectionStoreItem> extends Core.CollectionStoreOptions<T> {
     /**
-     * A callback that gets called when the `items` state changes.
-     * @param items The new items.
+     * A callback that gets called when the
+     * [`items`](https://ariakit.org/reference/collection-provider#items) state
+     * changes.
      * @example
      * const [items, setItems] = useState([]);
      * const collection = useCollectionStore({ items, setItems });

package/cjs/collection/collection-store.d.ts

@@ -3,11 +3,13 @@ import type { BivariantCallback, PickRequired } from "@ariakit/core/utils/types"
 import type { Store } from "../utils/store.js";
 export declare function useCollectionStoreProps<T extends Core.CollectionStore>(store: T, update: () => void, props: CollectionStoreProps): T;
 /**
- * Creates a collection store.
+ * Creates a collection store to control
+ * [Collection](https://ariakit.org/components/collection) components.
  * @see https://ariakit.org/components/collection
  * @example
  * ```jsx
  * const collection = useCollectionStore();
+ *
  * <Collection store={collection}>
  *   <CollectionItem>Item</CollectionItem>
  *   <CollectionItem>Item</CollectionItem>
@@ -25,8 +27,9 @@ export interface CollectionStoreFunctions<T extends CollectionStoreItem = Collec
 }
 export interface CollectionStoreOptions<T extends CollectionStoreItem = CollectionStoreItem> extends Core.CollectionStoreOptions<T> {
     /**
-     * A callback that gets called when the `items` state changes.
-     * @param items The new items.
+     * A callback that gets called when the
+     * [`items`](https://ariakit.org/reference/collection-provider#items) state
+     * changes.
      * @example
      * const [items, setItems] = useState([]);
      * const collection = useCollectionStore({ items, setItems });

package/cjs/collection/collection.d.cts

@@ -18,9 +18,10 @@ import type { CollectionStore } from "./collection-store.js";
  */
 export declare const useCollection: import("../utils/types.js").Hook<CollectionOptions<"div">>;
 /**
- * Renders a simple wrapper for collection items. It receives the collection
- * store through the `store` prop and provides context for `CollectionItem`
- * components.
+ * Renders a simple wrapper for collection items. It accepts a collection store
+ * through the [`store`](https://ariakit.org/reference/collection#store) prop
+ * and provides context for
+ * [`CollectionItem`](https://ariakit.org/reference/collection-item) components.
  * @see https://ariakit.org/components/collection
  * @example
  * ```jsx

package/cjs/collection/collection.d.ts

@@ -18,9 +18,10 @@ import type { CollectionStore } from "./collection-store.js";
  */
 export declare const useCollection: import("../utils/types.js").Hook<CollectionOptions<"div">>;
 /**
- * Renders a simple wrapper for collection items. It receives the collection
- * store through the `store` prop and provides context for `CollectionItem`
- * components.
+ * Renders a simple wrapper for collection items. It accepts a collection store
+ * through the [`store`](https://ariakit.org/reference/collection#store) prop
+ * and provides context for
+ * [`CollectionItem`](https://ariakit.org/reference/collection-item) components.
  * @see https://ariakit.org/components/collection
  * @example
  * ```jsx

package/cjs/combobox/combobox-cancel.d.cts

@@ -15,10 +15,11 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxCancel: import("../utils/types.js").Hook<ComboboxCancelOptions<"button">>;
 /**
- * Renders a combobox cancel button that clears the combobox input when clicked.
+ * Renders a combobox cancel button that clears the combobox input value when
+ * clicked.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxCancel />

package/cjs/combobox/combobox-cancel.d.ts

@@ -15,10 +15,11 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxCancel: import("../utils/types.js").Hook<ComboboxCancelOptions<"button">>;
 /**
- * Renders a combobox cancel button that clears the combobox input when clicked.
+ * Renders a combobox cancel button that clears the combobox input value when
+ * clicked.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxCancel />

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

@@ -20,11 +20,16 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxDisclosure: import("../utils/types.js").Hook<ComboboxDisclosureOptions<"button">>;
 /**
- * Renders a combobox disclosure button that toggles the combobox popover
+ * Renders a combobox disclosure button that toggles the
+ * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover) element's
  * visibility when clicked.
+ *
+ * Although this button is not tabbable, it remains accessible to screen reader
+ * users. On clicking, it automatically shifts focus to the
+ * [`Combobox`](https://ariakit.org/reference/combobox) element.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxDisclosure />

package/cjs/combobox/combobox-disclosure.d.ts

@@ -20,11 +20,16 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxDisclosure: import("../utils/types.js").Hook<ComboboxDisclosureOptions<"button">>;
 /**
- * Renders a combobox disclosure button that toggles the combobox popover
+ * Renders a combobox disclosure button that toggles the
+ * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover) element's
  * visibility when clicked.
+ *
+ * Although this button is not tabbable, it remains accessible to screen reader
+ * users. On clicking, it automatically shifts focus to the
+ * [`Combobox`](https://ariakit.org/reference/combobox) element.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxDisclosure />

package/cjs/combobox/combobox-group-label.d.cts

@@ -16,11 +16,11 @@ import type { ComboboxStore } from "./combobox-store.js";
 export declare const useComboboxGroupLabel: import("../utils/types.js").Hook<ComboboxGroupLabelOptions<"div">>;
 /**
  * Renders a label in a combobox group. This component should be wrapped with
- * `ComboboxGroup` so the `aria-labelledby` is correctly set on the combobox
- * group element.
+ * [`ComboboxGroup`](https://ariakit.org/reference/combobox-group) so the
+ * `aria-labelledby` is correctly set on the group element.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {5}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>
@@ -38,7 +38,7 @@ export interface ComboboxGroupLabelOptions<T extends As = "div"> extends Composi
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.

package/cjs/combobox/combobox-group-label.d.ts

@@ -16,11 +16,11 @@ import type { ComboboxStore } from "./combobox-store.js";
 export declare const useComboboxGroupLabel: import("../utils/types.js").Hook<ComboboxGroupLabelOptions<"div">>;
 /**
  * Renders a label in a combobox group. This component should be wrapped with
- * `ComboboxGroup` so the `aria-labelledby` is correctly set on the combobox
- * group element.
+ * [`ComboboxGroup`](https://ariakit.org/reference/combobox-group) so the
+ * `aria-labelledby` is correctly set on the group element.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {5}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>
@@ -38,7 +38,7 @@ export interface ComboboxGroupLabelOptions<T extends As = "div"> extends Composi
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.

package/cjs/combobox/combobox-group.d.cts

@@ -20,10 +20,14 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxGroup: import("../utils/types.js").Hook<ComboboxGroupOptions<"div">>;
 /**
- * Renders a combobox group.
+ * Renders a group for
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) elements.
+ * Optionally, a
+ * [`ComboboxGroupLabel`](https://ariakit.org/reference/combobox-group-label)
+ * can be rendered as a child to provide a label for the group.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {4-8}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>
@@ -41,7 +45,7 @@ export interface ComboboxGroupOptions<T extends As = "div"> extends CompositeGro
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.

package/cjs/combobox/combobox-group.d.ts

@@ -20,10 +20,14 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxGroup: import("../utils/types.js").Hook<ComboboxGroupOptions<"div">>;
 /**
- * Renders a combobox group.
+ * Renders a group for
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) elements.
+ * Optionally, a
+ * [`ComboboxGroupLabel`](https://ariakit.org/reference/combobox-group-label)
+ * can be rendered as a child to provide a label for the group.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {4-8}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>
@@ -41,7 +45,7 @@ export interface ComboboxGroupOptions<T extends As = "div"> extends CompositeGro
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.

package/cjs/combobox/combobox-item-check.d.cts

@@ -14,12 +14,15 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxItemCheck: import("../utils/types.js").Hook<ComboboxItemCheckOptions<"span">>;
 /**
- * Renders a checkmark inside a
- * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component. This
- * component must be wrapped with
- * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) or the
+ * Renders a checkmark icon when the
  * [`checked`](https://ariakit.org/reference/combobox-item-check#checked) prop
- * must be explicitly passed to the component.
+ * is `true`. The icon can be overridden by providing a different one as
+ * children.
+ *
+ * When rendered inside a
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component, the
+ * [`checked`](https://ariakit.org/reference/combobox-item-check#checked) prop
+ * is automatically derived from the context.
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx {5,9}
@@ -43,18 +46,8 @@ export interface ComboboxItemCheckOptions<T extends As = "span"> extends Checkbo
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
-     * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
-     * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
-     * components' context will be used.
+     * hook.
      */
     store?: ComboboxStore;
-    /**
-     * Whether the check mark should be shown. This value is automatically
-     * inferred from the parent
-     * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component.
-     * Manually setting this prop will override the inferred value.
-     */
-    checked?: boolean;
 }
 export type ComboboxItemCheckProps<T extends As = "span"> = Props<ComboboxItemCheckOptions<T>>;

package/cjs/combobox/combobox-item-check.d.ts

@@ -14,12 +14,15 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxItemCheck: import("../utils/types.js").Hook<ComboboxItemCheckOptions<"span">>;
 /**
- * Renders a checkmark inside a
- * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component. This
- * component must be wrapped with
- * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) or the
+ * Renders a checkmark icon when the
  * [`checked`](https://ariakit.org/reference/combobox-item-check#checked) prop
- * must be explicitly passed to the component.
+ * is `true`. The icon can be overridden by providing a different one as
+ * children.
+ *
+ * When rendered inside a
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component, the
+ * [`checked`](https://ariakit.org/reference/combobox-item-check#checked) prop
+ * is automatically derived from the context.
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx {5,9}
@@ -43,18 +46,8 @@ export interface ComboboxItemCheckOptions<T extends As = "span"> extends Checkbo
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
-     * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
-     * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
-     * components' context will be used.
+     * hook.
      */
     store?: ComboboxStore;
-    /**
-     * Whether the check mark should be shown. This value is automatically
-     * inferred from the parent
-     * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component.
-     * Manually setting this prop will override the inferred value.
-     */
-    checked?: boolean;
 }
 export type ComboboxItemCheckProps<T extends As = "span"> = Props<ComboboxItemCheckOptions<T>>;

package/cjs/combobox/combobox-item-value.d.cts

@@ -23,13 +23,16 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxItemValue: import("../utils/types.js").Hook<ComboboxItemValueOptions<"span">>;
 /**
- * Renders a value element inside a combobox item. The value will be split into
- * span elements. The portions of the value that correspond to the store value
- * will have a `data-user-value` attribute. The other portions will have a
- * `data-autocomplete-value` attribute.
+ * Renders a value element inside a
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item). The value will
+ * be split into span elements. The portions of the value that correspond to the
+ * combobox value will have a
+ * [`data-user-value`](https://ariakit.org/guide/styling#data-user-value)
+ * attribute. The other portions will have a [`data-autocomplete-value`](https://ariakit.org/guide/styling#data-autocomplete-value)
+ * attribute.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {5} "value"
  * <ComboboxProvider value="p">
  *   <Combobox />
  *   <ComboboxPopover>
@@ -53,15 +56,17 @@ export interface ComboboxItemValueOptions<T extends As = "span"> extends Options
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.
      */
     store?: ComboboxStore;
     /**
-     * The current combobox item value. If not provided, the parent `ComboboxItem`
-     * component's `value` prop will be used.
+     * The current combobox item value. If not provided, the parent
+     * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component's
+     * [`value`](https://ariakit.org/reference/combobox-item#value) prop will be
+     * used.
      */
     value?: string;
 }

package/cjs/combobox/combobox-item-value.d.ts

@@ -23,13 +23,16 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxItemValue: import("../utils/types.js").Hook<ComboboxItemValueOptions<"span">>;
 /**
- * Renders a value element inside a combobox item. The value will be split into
- * span elements. The portions of the value that correspond to the store value
- * will have a `data-user-value` attribute. The other portions will have a
- * `data-autocomplete-value` attribute.
+ * Renders a value element inside a
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item). The value will
+ * be split into span elements. The portions of the value that correspond to the
+ * combobox value will have a
+ * [`data-user-value`](https://ariakit.org/guide/styling#data-user-value)
+ * attribute. The other portions will have a [`data-autocomplete-value`](https://ariakit.org/guide/styling#data-autocomplete-value)
+ * attribute.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {5} "value"
  * <ComboboxProvider value="p">
  *   <Combobox />
  *   <ComboboxPopover>
@@ -53,15 +56,17 @@ export interface ComboboxItemValueOptions<T extends As = "span"> extends Options
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.
      */
     store?: ComboboxStore;
     /**
-     * The current combobox item value. If not provided, the parent `ComboboxItem`
-     * component's `value` prop will be used.
+     * The current combobox item value. If not provided, the parent
+     * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component's
+     * [`value`](https://ariakit.org/reference/combobox-item#value) prop will be
+     * used.
      */
     value?: string;
 }

package/cjs/combobox/combobox-item.d.cts

@@ -16,19 +16,16 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxItem: import("../utils/types.js").Hook<ComboboxItemOptions<"div">>;
 /**
- * Renders a combobox item inside a
+ * Renders a combobox item inside
  * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
  * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
- * components. The `role` prop will be automatically set based on the list's own
- * `role` prop. For example, if the list `role` is set to `listbox` (default),
- * the `ComboboxItem` `role` will be set to `option`.
+ * components.
  *
- * By default, the
- * [`value`](https://ariakit.org/reference/combobox-item#value) prop will be
- * rendered as the children, but this can be overriden.
+ * By default, the [`value`](https://ariakit.org/reference/combobox-item#value)
+ * prop will be rendered as the children, but this can be overriden.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {4-6}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>
@@ -44,10 +41,13 @@ export interface ComboboxItemOptions<T extends As = "div"> extends CompositeItem
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.
+     *
+     * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      */
     store?: ComboboxStore;
     /**
@@ -86,6 +86,8 @@ export interface ComboboxItemOptions<T extends As = "div"> extends CompositeItem
      *
      * Live examples:
      * - [Combobox with links](https://ariakit.org/examples/combobox-links)
+     * - [Submenu with
+     *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      */
     hideOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**

package/cjs/combobox/combobox-item.d.ts

@@ -16,19 +16,16 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxItem: import("../utils/types.js").Hook<ComboboxItemOptions<"div">>;
 /**
- * Renders a combobox item inside a
+ * Renders a combobox item inside
  * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
  * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
- * components. The `role` prop will be automatically set based on the list's own
- * `role` prop. For example, if the list `role` is set to `listbox` (default),
- * the `ComboboxItem` `role` will be set to `option`.
+ * components.
  *
- * By default, the
- * [`value`](https://ariakit.org/reference/combobox-item#value) prop will be
- * rendered as the children, but this can be overriden.
+ * By default, the [`value`](https://ariakit.org/reference/combobox-item#value)
+ * prop will be rendered as the children, but this can be overriden.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {4-6}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>
@@ -44,10 +41,13 @@ export interface ComboboxItemOptions<T extends As = "div"> extends CompositeItem
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.
+     *
+     * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      */
     store?: ComboboxStore;
     /**
@@ -86,6 +86,8 @@ export interface ComboboxItemOptions<T extends As = "div"> extends CompositeItem
      *
      * Live examples:
      * - [Combobox with links](https://ariakit.org/examples/combobox-links)
+     * - [Submenu with
+     *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      */
     hideOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**

package/cjs/combobox/combobox-list.d.cts

@@ -21,12 +21,9 @@ export declare const useComboboxList: import("../utils/types.js").Hook<ComboboxL
  * Renders a combobox list. The `role` prop is set to `listbox` by default, but
  * can be overriden by any other valid combobox popup role (`listbox`, `menu`,
  * `tree`, `grid` or `dialog`).
- *
- * The `aria-labelledby` prop is set to the combobox input element's `id` by
- * default.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3-7}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxList>

package/cjs/combobox/combobox-list.d.ts

@@ -21,12 +21,9 @@ export declare const useComboboxList: import("../utils/types.js").Hook<ComboboxL
  * Renders a combobox list. The `role` prop is set to `listbox` by default, but
  * can be overriden by any other valid combobox popup role (`listbox`, `menu`,
  * `tree`, `grid` or `dialog`).
- *
- * The `aria-labelledby` prop is set to the combobox input element's `id` by
- * default.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3-7}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxList>

package/cjs/combobox/combobox-popover.cjs

@@ -9,12 +9,12 @@ require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
 
 
-var _KDG57VZVcjs = require('../__chunks/KDG57VZV.cjs');
+var _OUEE5HOScjs = require('../__chunks/OUEE5HOS.cjs');
 
 
-var _EKB76T2Ucjs = require('../__chunks/EKB76T2U.cjs');
+var _ZL5DC555cjs = require('../__chunks/ZL5DC555.cjs');
 require('../__chunks/WZ3DRKGP.cjs');
-require('../__chunks/NKR65BKC.cjs');
+require('../__chunks/KSPMHEYZ.cjs');
 require('../__chunks/PZL34OVO.cjs');
 require('../__chunks/344F3DYO.cjs');
 require('../__chunks/KREY6HXD.cjs');
@@ -22,11 +22,11 @@ require('../__chunks/5ZOCN23X.cjs');
 require('../__chunks/JVDUGICD.cjs');
 require('../__chunks/VV6WA3I6.cjs');
 require('../__chunks/7YLCVXZ7.cjs');
+require('../__chunks/5GTNIPQ6.cjs');
 require('../__chunks/7TN63K2T.cjs');
+require('../__chunks/V24PR4PW.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/65LGW5LY.cjs');
@@ -94,7 +94,7 @@ var useComboboxPopover = _RNZNGEL4cjs.createHook.call(void 0,
     );
     const baseElement = store.useState("baseElement");
     props = _D4TG5DM4cjs.useComboboxList.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
-    props = _KDG57VZVcjs.usePopover.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
+    props = _OUEE5HOScjs.usePopover.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store,
       modal,
       alwaysVisible,
@@ -150,7 +150,7 @@ var useComboboxPopover = _RNZNGEL4cjs.createHook.call(void 0,
     return props;
   }
 );
-var ComboboxPopover = _EKB76T2Ucjs.createDialogComponent.call(void 0, 
+var ComboboxPopover = _ZL5DC555cjs.createDialogComponent.call(void 0, 
   _RNZNGEL4cjs.createComponent.call(void 0, (props) => {
     const htmlProps = useComboboxPopover(props);
     return _RNZNGEL4cjs.createElement.call(void 0, "div", htmlProps);

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

@@ -19,11 +19,10 @@ export declare const useComboboxPopover: import("../utils/types.js").Hook<Combob
 /**
  * Renders a combobox popover. The `role` prop is set to `listbox` by default,
  * but can be overriden by any other valid combobox popup role (`listbox`,
- * `menu`, `tree`, `grid` or `dialog`). The `aria-labelledby` prop is set to the
- * combobox input element's `id` by default.
+ * `menu`, `tree`, `grid` or `dialog`).
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3-7}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>

package/cjs/combobox/combobox-popover.d.ts

@@ -19,11 +19,10 @@ export declare const useComboboxPopover: import("../utils/types.js").Hook<Combob
 /**
  * Renders a combobox popover. The `role` prop is set to `listbox` by default,
  * but can be overriden by any other valid combobox popup role (`listbox`,
- * `menu`, `tree`, `grid` or `dialog`). The `aria-labelledby` prop is set to the
- * combobox input element's `id` by default.
+ * `menu`, `tree`, `grid` or `dialog`).
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3-7}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>