@ariakit/react-core 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ariakit/react-core
 
+## 0.3.2
+
+### Patch Changes
+
+- [`#2811`](https://github.com/ariakit/ariakit/pull/2811) **TypeScript**: Fixed missing `null` type on props from [`useMenuStore`](https://ariakit.org/reference/use-menu-store) ([`combobox`](https://ariakit.org/reference/use-menu-store#combobox), [`parent`](https://ariakit.org/reference/use-menu-store#parent), [`menubar`](https://ariakit.org/reference/use-menu-store#menubar)), and [`useSelectStore`](https://ariakit.org/reference/use-select-store) ([`combobox`](https://ariakit.org/reference/use-select-store#combobox)).
+
+- [`#2812`](https://github.com/ariakit/ariakit/pull/2812) Fixed an infinite loop issue when using [`MenuButton`](https://ariakit.org/reference/menu-buton) with a [`store`](https://ariakit.org/reference/menu-button#store) that is synchronized with another store.
+
+- Improved JSDocs.
+
+- Updated dependencies: `@ariakit/core@0.3.2`.
+
 ## 0.3.1
 
 ### Patch Changes

package/cjs/__chunks/{6MLKTO2T.cjs → 3ULNMLN7.cjs}

@@ -8,8 +8,8 @@ var _5WLTMVVQcjs = require('./5WLTMVVQ.cjs');
 
 // src/disclosure/disclosure-store.ts
 var _disclosurestore = require('@ariakit/core/disclosure/disclosure-store'); var Core = _interopRequireWildcard(_disclosurestore);
-function useDisclosureStoreProps(store, update, props, deps = []) {
-  _5WLTMVVQcjs.useUpdateEffect.call(void 0, update, [props.store, props.disclosure, ...deps]);
+function useDisclosureStoreProps(store, update, props) {
+  _5WLTMVVQcjs.useUpdateEffect.call(void 0, update, [props.store, props.disclosure]);
   _I63PYP2Ucjs.useStoreProps.call(void 0, store, props, "open", "setOpen");
   _I63PYP2Ucjs.useStoreProps.call(void 0, store, props, "mounted", "setMounted");
   _I63PYP2Ucjs.useStoreProps.call(void 0, store, props, "animated");

package/cjs/__chunks/{SL7OXEFQ.cjs → 4ULJINEP.cjs}

@@ -3,7 +3,7 @@
 var _FWCQCCG3cjs = require('./FWCQCCG3.cjs');
 
 
-var _P2EILHN6cjs = require('./P2EILHN6.cjs');
+var _E4C2KZA5cjs = require('./E4C2KZA5.cjs');
 
 
 
@@ -12,7 +12,7 @@ var _I63PYP2Ucjs = require('./I63PYP2U.cjs');
 // src/combobox/combobox-store.ts
 var _comboboxstore = require('@ariakit/core/combobox/combobox-store'); var Core = _interopRequireWildcard(_comboboxstore);
 function useComboboxStoreProps(store, update, props) {
-  store = _P2EILHN6cjs.usePopoverStoreProps.call(void 0, store, update, props);
+  store = _E4C2KZA5cjs.usePopoverStoreProps.call(void 0, store, update, props);
   store = _FWCQCCG3cjs.useCompositeStoreProps.call(void 0, store, update, props);
   _I63PYP2Ucjs.useStoreProps.call(void 0, store, props, "value", "setValue");
   _I63PYP2Ucjs.useStoreProps.call(void 0, store, props, "resetValueOnHide");

package/cjs/__chunks/{C47ZNHA6.cjs → 6UXB6PRK.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } }
 
-var _P2EILHN6cjs = require('./P2EILHN6.cjs');
+var _E4C2KZA5cjs = require('./E4C2KZA5.cjs');
 
 
 
@@ -9,7 +9,7 @@ var _I63PYP2Ucjs = require('./I63PYP2U.cjs');
 // src/hovercard/hovercard-store.ts
 var _hovercardstore = require('@ariakit/core/hovercard/hovercard-store'); var Core = _interopRequireWildcard(_hovercardstore);
 function useHovercardStoreProps(store, update, props) {
-  store = _P2EILHN6cjs.usePopoverStoreProps.call(void 0, store, update, props);
+  store = _E4C2KZA5cjs.usePopoverStoreProps.call(void 0, store, update, props);
   _I63PYP2Ucjs.useStoreProps.call(void 0, store, props, "timeout");
   _I63PYP2Ucjs.useStoreProps.call(void 0, store, props, "showTimeout");
   _I63PYP2Ucjs.useStoreProps.call(void 0, store, props, "hideTimeout");

package/cjs/__chunks/{OAQQQ7LS.cjs → DMTOMUIM.cjs}

@@ -6,7 +6,7 @@ var _ZBG4TGVLcjs = require('./ZBG4TGVL.cjs');
 var _FWCQCCG3cjs = require('./FWCQCCG3.cjs');
 
 
-var _P2EILHN6cjs = require('./P2EILHN6.cjs');
+var _E4C2KZA5cjs = require('./E4C2KZA5.cjs');
 
 
 
@@ -24,7 +24,7 @@ var _selectstore = require('@ariakit/core/select/select-store'); var Core = _int
 function useSelectStoreProps(store, update, props) {
   _5WLTMVVQcjs.useUpdateEffect.call(void 0, update, [props.combobox]);
   store = _FWCQCCG3cjs.useCompositeStoreProps.call(void 0, store, update, props);
-  store = _P2EILHN6cjs.usePopoverStoreProps.call(void 0, store, update, props);
+  store = _E4C2KZA5cjs.usePopoverStoreProps.call(void 0, store, update, props);
   _I63PYP2Ucjs.useStoreProps.call(void 0, store, props, "value", "setValue");
   return Object.assign(store, { combobox: props.combobox });
 }

package/cjs/__chunks/{P2EILHN6.cjs → E4C2KZA5.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } }
 
-var _BPMML63Mcjs = require('./BPMML63M.cjs');
+var _NATUYKIWcjs = require('./NATUYKIW.cjs');
 
 
 
@@ -13,7 +13,7 @@ var _5WLTMVVQcjs = require('./5WLTMVVQ.cjs');
 var _popoverstore = require('@ariakit/core/popover/popover-store'); var Core = _interopRequireWildcard(_popoverstore);
 function usePopoverStoreProps(store, update, props) {
   _5WLTMVVQcjs.useUpdateEffect.call(void 0, update, [props.popover]);
-  store = _BPMML63Mcjs.useDialogStoreProps.call(void 0, store, update, props);
+  store = _NATUYKIWcjs.useDialogStoreProps.call(void 0, store, update, props);
   _I63PYP2Ucjs.useStoreProps.call(void 0, store, props, "placement");
   return store;
 }

package/cjs/__chunks/{J63NAJOO.cjs → HCQYEOCO.cjs}

@@ -9,7 +9,7 @@ var _OAEUR56Wcjs = require('./OAEUR56W.cjs');
 var _5E5FKYEOcjs = require('./5E5FKYEO.cjs');
 
 
-var _6MLKTO2Tcjs = require('./6MLKTO2T.cjs');
+var _3ULNMLN7cjs = require('./3ULNMLN7.cjs');
 
 
 
@@ -30,7 +30,7 @@ function DialogBackdrop({
   hidden
 }) {
   const ref = _react.useRef.call(void 0, null);
-  const disclosure = _6MLKTO2Tcjs.useDisclosureStore.call(void 0, { disclosure: store });
+  const disclosure = _3ULNMLN7cjs.useDisclosureStore.call(void 0, { disclosure: store });
   const contentElement = store.useState("contentElement");
   _5WLTMVVQcjs.useSafeLayoutEffect.call(void 0, () => {
     const backdrop2 = ref.current;

package/cjs/__chunks/{WRVKUV4V.cjs → HFISYIKE.cjs}

@@ -10,7 +10,7 @@ var _ZBG4TGVLcjs = require('./ZBG4TGVL.cjs');
 var _FWCQCCG3cjs = require('./FWCQCCG3.cjs');
 
 
-var _C47ZNHA6cjs = require('./C47ZNHA6.cjs');
+var _6UXB6PRKcjs = require('./6UXB6PRK.cjs');
 
 
 
@@ -28,7 +28,7 @@ var _menustore = require('@ariakit/core/menu/menu-store'); var Core = _interopRe
 function useMenuStoreProps(store, update, props) {
   _5WLTMVVQcjs.useUpdateEffect.call(void 0, update, [props.combobox, props.parent, props.menubar]);
   store = _FWCQCCG3cjs.useCompositeStoreProps.call(void 0, store, update, props);
-  store = _C47ZNHA6cjs.useHovercardStoreProps.call(void 0, store, update, props);
+  store = _6UXB6PRKcjs.useHovercardStoreProps.call(void 0, store, update, props);
   _I63PYP2Ucjs.useStoreProps.call(void 0, store, props, "values", "setValues");
   return Object.assign(store, {
     combobox: props.combobox,

package/cjs/__chunks/{U33H4JTD.cjs → LJBXMHCD.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } }
 
-var _C47ZNHA6cjs = require('./C47ZNHA6.cjs');
+var _6UXB6PRKcjs = require('./6UXB6PRK.cjs');
 
 
 
@@ -9,7 +9,7 @@ var _I63PYP2Ucjs = require('./I63PYP2U.cjs');
 // src/tooltip/tooltip-store.ts
 var _tooltipstore = require('@ariakit/core/tooltip/tooltip-store'); var Core = _interopRequireWildcard(_tooltipstore);
 function useTooltipStoreProps(store, update, props) {
-  store = _C47ZNHA6cjs.useHovercardStoreProps.call(void 0, store, update, props);
+  store = _6UXB6PRKcjs.useHovercardStoreProps.call(void 0, store, update, props);
   _I63PYP2Ucjs.useStoreProps.call(void 0, store, props, "type");
   _I63PYP2Ucjs.useStoreProps.call(void 0, store, props, "skipTimeout");
   return store;

package/cjs/__chunks/{BPMML63M.cjs → NATUYKIW.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } }
 
-var _6MLKTO2Tcjs = require('./6MLKTO2T.cjs');
+var _3ULNMLN7cjs = require('./3ULNMLN7.cjs');
 
 
 var _I63PYP2Ucjs = require('./I63PYP2U.cjs');
@@ -8,7 +8,7 @@ var _I63PYP2Ucjs = require('./I63PYP2U.cjs');
 // src/dialog/dialog-store.ts
 var _dialogstore = require('@ariakit/core/dialog/dialog-store'); var Core = _interopRequireWildcard(_dialogstore);
 function useDialogStoreProps(store, update, props) {
-  return _6MLKTO2Tcjs.useDisclosureStoreProps.call(void 0, store, update, props);
+  return _3ULNMLN7cjs.useDisclosureStoreProps.call(void 0, store, update, props);
 }
 function useDialogStore(props = {}) {
   const [store, update] = _I63PYP2Ucjs.useStore.call(void 0, Core.createDialogStore, props);

package/cjs/__chunks/{ZEASCR4B.cjs → QEG5AJH6.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _J63NAJOOcjs = require('./J63NAJOO.cjs');
+var _HCQYEOCOcjs = require('./HCQYEOCO.cjs');
 
 
 var _6BAHKJ5Kcjs = require('./6BAHKJ5K.cjs');
@@ -451,7 +451,7 @@ var useDialog = _Z5PUIG6Acjs.createHook.call(void 0,
           return element;
         return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _jsxruntime.Fragment, { children: [
           /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-            _J63NAJOOcjs.DialogBackdrop,
+            _HCQYEOCOcjs.DialogBackdrop,
             {
               store,
               backdrop,

package/cjs/__chunks/{B4KDFSF3.cjs → WBPFHFAX.cjs}

@@ -5,7 +5,7 @@
 var _OLGMV24Ucjs = require('./OLGMV24U.cjs');
 
 
-var _PHDU6PLMcjs = require('./PHDU6PLM.cjs');
+var _XOHN6PERcjs = require('./XOHN6PER.cjs');
 
 
 
@@ -286,7 +286,7 @@ var useHovercard = _Z5PUIG6Acjs.createHook.call(void 0,
     });
     props = useAutoFocusOnHide(_72I2GWXFcjs.__spreadValues.call(void 0, { store }, props));
     props = useAutoFocusOnShow(_72I2GWXFcjs.__spreadValues.call(void 0, { store, modal }, props));
-    props = _PHDU6PLMcjs.usePopover.call(void 0, _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
+    props = _XOHN6PERcjs.usePopover.call(void 0, _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
       store,
       modal,
       portal

package/cjs/__chunks/{PHDU6PLM.cjs → XOHN6PER.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _ZEASCR4Bcjs = require('./ZEASCR4B.cjs');
+var _QEG5AJH6cjs = require('./QEG5AJH6.cjs');
 
 
 
@@ -351,7 +351,7 @@ var usePopover = _Z5PUIG6Acjs.createHook.call(void 0,
         position: "relative"
       }, props.style)
     });
-    props = _ZEASCR4Bcjs.useDialog.call(void 0, _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
+    props = _QEG5AJH6cjs.useDialog.call(void 0, _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
       store,
       modal,
       preserveTabOrder,

package/cjs/checkbox/checkbox.d.ts

@@ -27,12 +27,15 @@ export declare const useCheckbox: import("../utils/types.js").Hook<CheckboxOptio
 export declare const Checkbox: import("../utils/types.js").Component<CheckboxOptions<"input">>;
 export interface CheckboxOptions<T extends As = "input"> extends CommandOptions<T> {
     /**
-     * Object returned by the `useCheckboxStore` hook. If not provided, the
-     * internal store will be used.
+     * Object returned by the
+     * [`useCheckboxStore`](https://ariakit.org/reference/use-checkbox-store)
+     * hook. If not provided, the closest
+     * [`CheckboxProvider`](https://ariakit.org/reference/checkbox-provider)
+     * component's context will be used. Otherwise, the component will fall back
+     * to an internal store.
      *
      * Live examples:
      * - [Checkbox as button](https://ariakit.org/examples/checkbox-as-button)
-     * - [Custom Checkbox](https://ariakit.org/examples/checkbox-custom)
      */
     store?: CheckboxStore;
     /**
@@ -42,14 +45,14 @@ export interface CheckboxOptions<T extends As = "input"> extends CommandOptions<
      *
      * Live examples:
      * - [Checkbox group](https://ariakit.org/examples/checkbox-group)
+     * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
      * @example
      * ```jsx
-     * const checkbox = useCheckboxStore({
-     *   defaultValue: ["Apple", "Orange"],
-     * });
-     * <Checkbox store={checkbox} value="Apple" />
-     * <Checkbox store={checkbox} value="Orange" />
-     * <Checkbox store={checkbox} value="Watermelon" />
+     * <CheckboxProvider defaultValue={["Apple", "Orange"]}>
+     *   <Checkbox value="Apple" />
+     *   <Checkbox value="Orange" />
+     *   <Checkbox value="Watermelon" />
+     * </CheckboxProvider>
      * ```
      */
     value?: InputHTMLAttributes<HTMLInputElement>["value"];

package/cjs/collection/collection.d.ts

@@ -35,7 +35,11 @@ export declare const useCollection: import("../utils/types.js").Hook<CollectionO
 export declare const Collection: import("../utils/types.js").Component<CollectionOptions<"div">>;
 export interface CollectionOptions<T extends As = "div"> extends Options<T> {
     /**
-     * Object returned by the `useCollectionStore` hook.
+     * Object returned by the
+     * [`useCollectionStore`](https://ariakit.org/reference/use-collection-store)
+     * hook. If not provided, the closest
+     * [`CollectionProvider`](https://ariakit.org/reference/collection-provider)
+     * component's context will be used.
      */
     store?: CollectionStore;
 }

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

@@ -19,20 +19,25 @@ export declare const useComboboxCancel: import("../utils/types.js").Hook<Combobo
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx
- * const combobox = useComboboxStore();
- * <Combobox store={combobox} />
- * <ComboboxCancel store={combobox} />
- * <ComboboxPopover store={combobox}>
- *   <ComboboxItem value="Item 1" />
- *   <ComboboxItem value="Item 2" />
- *   <ComboboxItem value="Item 3" />
- * </ComboboxPopover>
+ * <ComboboxProvider>
+ *   <Combobox />
+ *   <ComboboxCancel />
+ *   <ComboboxPopover>
+ *     <ComboboxItem value="Apple" />
+ *     <ComboboxItem value="Banana" />
+ *     <ComboboxItem value="Orange" />
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
  * ```
  */
 export declare const ComboboxCancel: import("../utils/types.js").Component<ComboboxCancelOptions<"button">>;
 export interface ComboboxCancelOptions<T extends As = "button"> extends ButtonOptions<T> {
     /**
-     * Object returned by the `useComboboxStore` hook.
+     * Object returned by the
+     * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
+     * hook. If not provided, the closest
+     * [`ComboboxProvider`](https://ariakit.org/reference/combobox-provider)
+     * component's context will be used.
      */
     store?: ComboboxStore;
 }

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

@@ -25,20 +25,25 @@ export declare const useComboboxDisclosure: import("../utils/types.js").Hook<Com
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx
- * const combobox = useComboboxStore();
- * <Combobox store={combobox} />
- * <ComboboxDisclosure store={combobox} />
- * <ComboboxPopover store={combobox}>
- *   <ComboboxItem value="Item 1" />
- *   <ComboboxItem value="Item 2" />
- *   <ComboboxItem value="Item 3" />
- * </ComboboxPopover>
+ * <ComboboxProvider>
+ *   <Combobox />
+ *   <ComboboxDisclosure />
+ *   <ComboboxPopover>
+ *     <ComboboxItem value="Apple" />
+ *     <ComboboxItem value="Banana" />
+ *     <ComboboxItem value="Orange" />
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
  * ```
  */
 export declare const ComboboxDisclosure: import("../utils/types.js").Component<ComboboxDisclosureOptions<"button">>;
 export interface ComboboxDisclosureOptions<T extends As = "button"> extends DialogDisclosureOptions<T> {
     /**
-     * Object returned by the `useComboboxStore` hook.
+     * Object returned by the
+     * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
+     * hook. If not provided, the closest
+     * [`ComboboxProvider`](https://ariakit.org/reference/combobox-provider)
+     * component's context will be used.
      */
     store?: ComboboxStore;
 }

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

@@ -21,22 +21,27 @@ export declare const useComboboxGroupLabel: import("../utils/types.js").Hook<Com
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx
- * const combobox = useComboboxStore();
- * <Combobox store={combobox} />
- * <ComboboxPopover store={combobox}>
- *   <ComboboxGroup>
- *     <ComboboxGroupLabel>Label</ComboboxGroupLabel>
- *     <ComboboxItem value="Item 1" />
- *     <ComboboxItem value="Item 2" />
- *   </ComboboxGroup>
- * </ComboboxPopover>
+ * <ComboboxProvider>
+ *   <Combobox />
+ *   <ComboboxPopover>
+ *     <ComboboxGroup>
+ *       <ComboboxGroupLabel>Fruits</ComboboxGroupLabel>
+ *       <ComboboxItem value="Apple" />
+ *       <ComboboxItem value="Banana" />
+ *     </ComboboxGroup>
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
  * ```
  */
 export declare const ComboboxGroupLabel: import("../utils/types.js").Component<ComboboxGroupLabelOptions<"div">>;
 export interface ComboboxGroupLabelOptions<T extends As = "div"> extends CompositeGroupLabelOptions<T> {
     /**
-     * Object returned by the `useComboboxStore` hook. If not provided, the parent
-     * `ComboboxList` or `ComboboxPopover` components' context will be used.
+     * 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.
      */
     store?: ComboboxStore;
 }

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

@@ -24,22 +24,27 @@ export declare const useComboboxGroup: import("../utils/types.js").Hook<Combobox
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx
- * const combobox = useComboboxStore();
- * <Combobox store={store} />
- * <ComboboxPopover store={store}>
- *   <ComboboxGroup>
- *     <ComboboxGroupLabel>Label</ComboboxGroupLabel>
- *     <ComboboxItem value="Item 1" />
- *     <ComboboxItem value="Item 2" />
- *   </ComboboxGroup>
- * </ComboboxPopover>
+ * <ComboboxProvider>
+ *   <Combobox />
+ *   <ComboboxPopover>
+ *     <ComboboxGroup>
+ *       <ComboboxGroupLabel>Fruits</ComboboxGroupLabel>
+ *       <ComboboxItem value="Apple" />
+ *       <ComboboxItem value="Banana" />
+ *     </ComboboxGroup>
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
  * ```
  */
 export declare const ComboboxGroup: import("../utils/types.js").Component<ComboboxGroupOptions<"div">>;
 export interface ComboboxGroupOptions<T extends As = "div"> extends CompositeGroupOptions<T> {
     /**
-     * Object returned by the `useComboboxStore` hook. If not provided, the parent
-     * `ComboboxList` or `ComboboxPopover` components' context will be used.
+     * 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.
      */
     store?: ComboboxStore;
 }

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

@@ -30,14 +30,14 @@ export declare const useComboboxItemValue: import("../utils/types.js").Hook<Comb
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx
- * const combobox = useComboboxStore({ value: "p" });
- *
- * <Combobox store={combobox} />
- * <ComboboxPopover store={combobox}>
- *   <ComboboxItem value="Apple">
- *     <ComboboxItemValue />
- *   </ComboboxItem>
- * </ComboboxPopover>
+ * <ComboboxProvider value="p">
+ *   <Combobox />
+ *   <ComboboxPopover>
+ *     <ComboboxItem value="Apple">
+ *       <ComboboxItemValue />
+ *     </ComboboxItem>
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
  *
  * // The Apple item will have a value element that looks like this:
  * <span>
@@ -51,8 +51,12 @@ export declare const useComboboxItemValue: import("../utils/types.js").Hook<Comb
 export declare const ComboboxItemValue: import("../utils/types.js").Component<ComboboxItemValueOptions<"span">>;
 export interface ComboboxItemValueOptions<T extends As = "span"> extends Options<T> {
     /**
-     * Object returned by the `useComboboxStore` hook. If not provided, the parent
-     * `ComboboxList` or `ComboboxPopover` components' context will be used.
+     * 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.
      */
     store?: ComboboxStore;
     /**

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

@@ -16,42 +16,67 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxItem: import("../utils/types.js").Hook<ComboboxItemOptions<"div">>;
 /**
- * Renders a combobox item inside a combobox list or popover. The `role` prop
- * will be automatically set based on the `ComboboxList` or `ComboboxPopover`
- * own `role` prop. For example, if the `ComboboxPopover` component's `role`
- * prop is set to `listbox` (default), the `ComboboxItem` `role` will be set to
- * `option`. By default, the `value` prop will be rendered as the children, but
- * this can be overriden.
+ * Renders a combobox item inside a
+ * [`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`.
+ *
+ * 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
- * const combobox = useComboboxStore();
- * <Combobox store={combobox} />
- * <ComboboxPopover store={combobox}>
- *   <ComboboxItem value="Item 1" />
- *   <ComboboxItem value="Item 2" />
- *   <ComboboxItem value="Item 3" />
- * </ComboboxPopover>
+ * <ComboboxProvider>
+ *   <Combobox />
+ *   <ComboboxPopover>
+ *     <ComboboxItem value="Apple" />
+ *     <ComboboxItem value="Banana" />
+ *     <ComboboxItem value="Orange" />
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
  * ```
  */
 export declare const ComboboxItem: import("../utils/types.js").Component<ComboboxItemOptions<"div">>;
 export interface ComboboxItemOptions<T extends As = "div"> extends CompositeItemOptions<T>, CompositeHoverOptions<T> {
     /**
-     * Object returned by the `useComboboxStore` hook. If not provided, the parent
-     * `ComboboxList` or `ComboboxPopover` components' context will be used.
+     * 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.
      */
     store?: ComboboxStore;
     /**
      * The value of the item. This will be rendered as the children by default.
-     *   - If `setValueOnClick` is set to `true`, this will be the value of the
-     *     combobox input when the user clicks on this item.
-     *   - If the `autoComplete` prop on the `Combobox` component is set to `both`
-     *     or `inline`, this will be the value of the combobox input when the
-     *     combobox loses focus.
+     *   - If
+     *     [`setValueOnClick`](https://ariakit.org/reference/combobox-item#setvalueonclick)
+     *     is set to `true`, this will be the value of the combobox input when the
+     *     user clicks on this item.
+     *   - If the
+     *     [`autoComplete`](https://ariakit.org/reference/combobox#autocomplete)
+     *     prop on the [`Combobox`](https://ariakit.org/reference/combobox)
+     *     component is set to `both` or `inline`, this will be the value of the
+     *     combobox input when the combobox loses focus.
+     *
+     * Live examples:
+     * - [Animated Combobox](https://ariakit.org/examples/combobox-animated)
+     * - [ComboboxCancel](https://ariakit.org/examples/combobox-cancel)
+     * - [ComboboxDisclosure](https://ariakit.org/examples/combobox-disclosure)
+     * - [Combobox filtering](https://ariakit.org/examples/combobox-filtering)
+     * - [ComboboxGroup](https://ariakit.org/examples/combobox-group)
+     * - [Textarea with inline
+     *   Combobox](https://ariakit.org/examples/combobox-textarea)
      */
     value?: string;
     /**
      * Whether to hide the combobox when this item is clicked.
+     *
+     * Live examples:
+     * - [Combobox with links](https://ariakit.org/examples/combobox-links)
      * @default true
      */
     hideOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;

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

@@ -20,24 +20,31 @@ 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.
+ * `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
- * const combobox = useComboboxStore();
- * <Combobox store={combobox} />
- * <ComboboxList store={combobox}>
- *   <ComboboxItem value="Item 1" />
- *   <ComboboxItem value="Item 2" />
- *   <ComboboxItem value="Item 3" />
- * </ComboboxList>
+ * <ComboboxProvider>
+ *   <Combobox />
+ *   <ComboboxList>
+ *     <ComboboxItem value="Apple" />
+ *     <ComboboxItem value="Banana" />
+ *     <ComboboxItem value="Orange" />
+ *   </ComboboxList>
+ * </ComboboxProvider>
  * ```
  */
 export declare const ComboboxList: import("../utils/types.js").Component<ComboboxListOptions<"div">>;
 export interface ComboboxListOptions<T extends As = "div"> extends FocusableOptions<T>, Pick<DisclosureContentOptions, "alwaysVisible"> {
     /**
-     * Object returned by the `useComboboxStore` hook.
+     * Object returned by the
+     * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
+     * hook. If not provided, the closest
+     * [`ComboboxProvider`](https://ariakit.org/reference/combobox-provider)
+     * component's context will be used.
      */
     store?: ComboboxStore;
 }