@ariakit/react-core 0.4.4 → 0.4.5

package/cjs/tag/tag.d.ts

@@ -0,0 +1,74 @@
+import type { ElementType, KeyboardEvent } from "react";
+import type { BooleanOrCallback } from "@ariakit/core/utils/types";
+import type { CompositeItemOptions } from "../composite/composite-item.js";
+import type { Props } from "../utils/types.js";
+import type { TagStore } from "./tag-store.js";
+declare const TagName = "div";
+type TagName = typeof TagName;
+type HTMLType = HTMLElementTagNameMap[TagName];
+/**
+ * Returns props to create a `Tag` component.
+ * @see https://ariakit.org/components/tag
+ * @example
+ * ```jsx
+ * const props = useTag();
+ * <Role.div {...props} />
+ * ```
+ */
+export declare const useTag: import("../utils/types.js").Hook<"div", TagOptions<"div">>;
+/**
+ * Renders a tag element inside a
+ * [`TagList`](https://ariakit.org/reference/tag-list) wrapper.
+ *
+ * The user can remove the tag by pressing `Backspace` or `Delete` keys when the
+ * tag is focused. The
+ * [`removeOnKeyPress`](https://ariakit.org/reference/tag#removeonkeypress) prop
+ * can be used to disable this behavior.
+ *
+ * When a printable key is pressed, the focus is automatically moved to the
+ * input element.
+ * @see https://ariakit.org/components/tag
+ * @example
+ * ```jsx {7-10}
+ * <TagProvider>
+ *   <TagListLabel>Invitees</TagListLabel>
+ *   <TagList>
+ *     <TagValues>
+ *       {(values) =>
+ *         values.map((value) => (
+ *           <Tag key={value} value={value}>
+ *             {value}
+ *             <TagRemove />
+ *           </Tag>
+ *         ))
+ *       }
+ *     </TagValues>
+ *     <TagInput />
+ *   </TagList>
+ * </TagProvider>
+ * ```
+ */
+export declare const Tag: (props: TagProps) => import("react").ReactElement<any, string | import("react").JSXElementConstructor<any>>;
+export interface TagOptions<T extends ElementType = TagName> extends CompositeItemOptions<T> {
+    /**
+     * Object returned by the
+     * [`useTagStore`](https://ariakit.org/reference/use-tag-store) hook. If not
+     * provided, the closest [`TagList`](https://ariakit.org/reference/tag-list)
+     * component's context will be used.
+     */
+    store?: TagStore;
+    /**
+     * The unique value of the tag. This is automatically rendered as the tag's
+     * content if no children are provided.
+     */
+    value: string;
+    /**
+     * Defines the behavior of the `Backspace` and `Delete` keys when the tag is
+     * focused. If `true`, the tag is removed. If it's a function, it's invoked
+     * with the key event and should return a boolean.
+     * @default true
+     */
+    removeOnKeyPress?: BooleanOrCallback<KeyboardEvent<HTMLType>>;
+}
+export type TagProps<T extends ElementType = TagName> = Props<T, TagOptions<T>>;
+export {};

package/cjs/tag/utils.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+
+
+var _ISJGSS4Scjs = require('../__chunks/ISJGSS4S.cjs');
+require('../__chunks/AV6KTKLE.cjs');
+
+
+exports.useTouchDevice = _ISJGSS4Scjs.useTouchDevice;

package/cjs/tag/utils.d.cts

@@ -0,0 +1 @@
+export declare function useTouchDevice(): boolean;

package/cjs/tag/utils.d.ts

@@ -0,0 +1 @@
+export declare function useTouchDevice(): boolean;

package/cjs/toolbar/toolbar-container.cjs

@@ -4,10 +4,10 @@
 var _MJP4XPFZcjs = require('../__chunks/MJP4XPFZ.cjs');
 
 
-var _YO7LLGVAcjs = require('../__chunks/YO7LLGVA.cjs');
-require('../__chunks/QUHFOHHT.cjs');
-require('../__chunks/U4NXCMZ3.cjs');
+var _AY5J25V7cjs = require('../__chunks/AY5J25V7.cjs');
+require('../__chunks/3HMQOCLF.cjs');
 require('../__chunks/HD5AHCRI.cjs');
+require('../__chunks/U4NXCMZ3.cjs');
 require('../__chunks/6ZZYUFPW.cjs');
 
 
@@ -38,7 +38,7 @@ var useToolbarContainer = _NGD3IQDBcjs.createHook.call(void 0,
     const context = _MVDQWSSVcjs.useToolbarContext.call(void 0, );
     store = store || context;
     props = _MJP4XPFZcjs.useCompositeContainer.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
-    props = _YO7LLGVAcjs.useToolbarItem.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
+    props = _AY5J25V7cjs.useToolbarItem.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
     return props;
   }
 );

package/cjs/toolbar/toolbar-input.cjs

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _YO7LLGVAcjs = require('../__chunks/YO7LLGVA.cjs');
-require('../__chunks/QUHFOHHT.cjs');
-require('../__chunks/U4NXCMZ3.cjs');
+var _AY5J25V7cjs = require('../__chunks/AY5J25V7.cjs');
+require('../__chunks/3HMQOCLF.cjs');
 require('../__chunks/HD5AHCRI.cjs');
+require('../__chunks/U4NXCMZ3.cjs');
 require('../__chunks/6ZZYUFPW.cjs');
 
 
@@ -34,7 +34,7 @@ var useToolbarInput = _NGD3IQDBcjs.createHook.call(void 0,
     var _b = _a, { store } = _b, props = _AV6KTKLEcjs.__objRest.call(void 0, _b, ["store"]);
     const context = _MVDQWSSVcjs.useToolbarContext.call(void 0, );
     store = store || context;
-    props = _YO7LLGVAcjs.useToolbarItem.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
+    props = _AY5J25V7cjs.useToolbarItem.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
     return props;
   }
 );

package/cjs/toolbar/toolbar-item.cjs

@@ -2,10 +2,10 @@
 
 
 
-var _YO7LLGVAcjs = require('../__chunks/YO7LLGVA.cjs');
-require('../__chunks/QUHFOHHT.cjs');
-require('../__chunks/U4NXCMZ3.cjs');
+var _AY5J25V7cjs = require('../__chunks/AY5J25V7.cjs');
+require('../__chunks/3HMQOCLF.cjs');
 require('../__chunks/HD5AHCRI.cjs');
+require('../__chunks/U4NXCMZ3.cjs');
 require('../__chunks/6ZZYUFPW.cjs');
 require('../__chunks/MVDQWSSV.cjs');
 require('../__chunks/VPI3EKVY.cjs');
@@ -20,4 +20,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.ToolbarItem = _YO7LLGVAcjs.ToolbarItem; exports.useToolbarItem = _YO7LLGVAcjs.useToolbarItem;
+exports.ToolbarItem = _AY5J25V7cjs.ToolbarItem; exports.useToolbarItem = _AY5J25V7cjs.useToolbarItem;

package/cjs/tooltip/tooltip.cjs

@@ -1,34 +1,34 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _HPNCFYQJcjs = require('../__chunks/HPNCFYQJ.cjs');
+var _GZ2NNSLVcjs = require('../__chunks/GZ2NNSLV.cjs');
 require('../__chunks/KXQOQQ5B.cjs');
-require('../__chunks/COWKMNMZ.cjs');
+require('../__chunks/N43E53E6.cjs');
 
 
-var _ZTAE5B6Wcjs = require('../__chunks/ZTAE5B6W.cjs');
-require('../__chunks/TSEXNK3K.cjs');
-require('../__chunks/JF225FQ5.cjs');
-require('../__chunks/37BRXQN7.cjs');
-require('../__chunks/MU7F4QWJ.cjs');
-require('../__chunks/PVYTX5U5.cjs');
-require('../__chunks/DLIQLPX4.cjs');
+var _QJDA4LG6cjs = require('../__chunks/QJDA4LG6.cjs');
+require('../__chunks/VR6GCLOV.cjs');
 require('../__chunks/UUJ5Q6IA.cjs');
 require('../__chunks/4H7FYXWQ.cjs');
+require('../__chunks/JF225FQ5.cjs');
 require('../__chunks/JKERATCG.cjs');
+require('../__chunks/BX2QEIBH.cjs');
+require('../__chunks/MU7F4QWJ.cjs');
+require('../__chunks/6IUEXB4L.cjs');
 require('../__chunks/7YLCVXZ7.cjs');
 require('../__chunks/CXZMA435.cjs');
 require('../__chunks/7TN63K2T.cjs');
+require('../__chunks/SL55T4ZB.cjs');
 require('../__chunks/3ND7K6FF.cjs');
-require('../__chunks/6IUEXB4L.cjs');
+require('../__chunks/DLIQLPX4.cjs');
 require('../__chunks/AFPGTIIH.cjs');
 require('../__chunks/J3OG6T3B.cjs');
+require('../__chunks/2BIO7R5N.cjs');
 require('../__chunks/PE3KUHN6.cjs');
 require('../__chunks/AXNMZ6L6.cjs');
 require('../__chunks/CVD2AZE2.cjs');
-require('../__chunks/2BIO7R5N.cjs');
-require('../__chunks/R6M66EKZ.cjs');
 require('../__chunks/7CYY7U2A.cjs');
+require('../__chunks/R6M66EKZ.cjs');
 
 
 
@@ -95,7 +95,7 @@ var useTooltip = _NGD3IQDBcjs.createHook.call(void 0,
       (state) => state.type === "description" ? "tooltip" : "none"
     );
     props = _AV6KTKLEcjs.__spreadValues.call(void 0, { role }, props);
-    props = _HPNCFYQJcjs.useHovercard.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+    props = _GZ2NNSLVcjs.useHovercard.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
       store,
       portal,
       gutter,
@@ -124,7 +124,7 @@ var useTooltip = _NGD3IQDBcjs.createHook.call(void 0,
     return props;
   }
 );
-var Tooltip = _ZTAE5B6Wcjs.createDialogComponent.call(void 0, 
+var Tooltip = _QJDA4LG6cjs.createDialogComponent.call(void 0, 
   _NGD3IQDBcjs.forwardRef.call(void 0, function Tooltip2(props) {
     const htmlProps = useTooltip(props);
     return _NGD3IQDBcjs.createElement.call(void 0, TagName, htmlProps);

package/combobox/combobox-value/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "@ariakit/react-core/combobox/combobox-value",
+  "private": true,
+  "sideEffects": false,
+  "main": "../../cjs/combobox/combobox-value.cjs",
+  "module": "../../esm/combobox/combobox-value.js",
+  "types": "../../cjs/combobox/combobox-value.d.ts"
+}

package/esm/__chunks/{XEJ23EM6.js → 65LF6MEO.js}

@@ -6,10 +6,10 @@ import {
 } from "./YMV43K4F.js";
 import {
   usePopover
-} from "./LTYEFENI.js";
+} from "./6YVAEELE.js";
 import {
   createDialogComponent
-} from "./IOUGWXY5.js";
+} from "./FGHVVLPU.js";
 import {
   HovercardScopedContextProvider,
   useHovercardProviderContext

package/esm/__chunks/{LTYEFENI.js → 6YVAEELE.js}

@@ -2,7 +2,7 @@
 import {
   createDialogComponent,
   useDialog
-} from "./IOUGWXY5.js";
+} from "./FGHVVLPU.js";
 import {
   PopoverScopedContextProvider,
   usePopoverProviderContext

package/esm/__chunks/{ZFEEEZVE.js → DLLQM6DZ.js}

@@ -1,4 +1,7 @@
 "use client";
+import {
+  useTagContext
+} from "./WYDDZRWN.js";
 import {
   useCompositeStoreProps
 } from "./ZR5N62ZV.js";
@@ -9,21 +12,36 @@ import {
   useStore,
   useStoreProps
 } from "./PWUXK5IM.js";
+import {
+  useUpdateEffect
+} from "./WOWUAP42.js";
+import {
+  __spreadProps,
+  __spreadValues
+} from "./4R3V3JGP.js";
 
 // src/combobox/combobox-store.ts
 import * as Core from "@ariakit/core/combobox/combobox-store";
 function useComboboxStoreProps(store, update, props) {
+  useUpdateEffect(update, [props.tag]);
   useStoreProps(store, props, "value", "setValue");
   useStoreProps(store, props, "selectedValue", "setSelectedValue");
   useStoreProps(store, props, "resetValueOnHide");
   useStoreProps(store, props, "resetValueOnSelect");
-  return useCompositeStoreProps(
-    usePopoverStoreProps(store, update, props),
-    update,
-    props
+  return Object.assign(
+    useCompositeStoreProps(
+      usePopoverStoreProps(store, update, props),
+      update,
+      props
+    ),
+    { tag: props.tag }
   );
 }
 function useComboboxStore(props = {}) {
+  const tag = useTagContext();
+  props = __spreadProps(__spreadValues({}, props), {
+    tag: props.tag !== void 0 ? props.tag : tag
+  });
   const [store, update] = useStore(Core.createComboboxStore, props);
   return useComboboxStoreProps(store, update, props);
 }

package/esm/__chunks/{IOUGWXY5.js → FGHVVLPU.js}

@@ -1,33 +1,33 @@
 "use client";
 import {
   DialogBackdrop
-} from "./GOXKZAQI.js";
-import {
-  prependHiddenDismiss
-} from "./6GXEOXGT.js";
-import {
-  disableTree,
-  disableTreeOutside
-} from "./PTPUIM7N.js";
-import {
-  usePreventBodyScroll
-} from "./U2L67A6K.js";
+} from "./CMFBAHKI.js";
 import {
   useNestedDialogs
 } from "./HSFE2URL.js";
 import {
   useHideOnInteractOutside
 } from "./H2NVVTJB.js";
+import {
+  prependHiddenDismiss
+} from "./6GXEOXGT.js";
 import {
   isElementMarked,
   markTreeOutside
 } from "./YNKDLCEK.js";
 import {
-  createWalkTreeSnapshot
-} from "./5QL6BP6J.js";
+  disableTree,
+  disableTreeOutside
+} from "./3TEK3C5Q.js";
 import {
   supportsInert
 } from "./677M2CI3.js";
+import {
+  createWalkTreeSnapshot
+} from "./5QL6BP6J.js";
+import {
+  usePreventBodyScroll
+} from "./BC72XE6E.js";
 import {
   useFocusableContainer
 } from "./UHSH3H5I.js";
@@ -136,7 +136,8 @@ var useDialog = createHook(function useDialog2(_a) {
     autoFocusOnHide = true,
     initialFocus,
     finalFocus,
-    unmountOnHide
+    unmountOnHide,
+    unstable_treeSnapshotKey
   } = _b, props = __objRest(_b, [
     "store",
     "open",
@@ -153,7 +154,8 @@ var useDialog = createHook(function useDialog2(_a) {
     "autoFocusOnHide",
     "initialFocus",
     "finalFocus",
-    "unmountOnHide"
+    "unmountOnHide",
+    "unstable_treeSnapshotKey"
   ]);
   const context = useDialogProviderContext();
   const ref = useRef(null);
@@ -269,7 +271,7 @@ var useDialog = createHook(function useDialog2(_a) {
       return;
     const dialog = ref.current;
     return createWalkTreeSnapshot(id, [dialog]);
-  }, [id, canTakeTreeSnapshot]);
+  }, [id, canTakeTreeSnapshot, unstable_treeSnapshotKey]);
   const getPersistentElementsProp = useEvent(getPersistentElements);
   useSafeLayoutEffect(() => {
     if (!id)
@@ -297,7 +299,8 @@ var useDialog = createHook(function useDialog2(_a) {
     canTakeTreeSnapshot,
     getPersistentElementsProp,
     nestedDialogs,
-    modal
+    modal,
+    unstable_treeSnapshotKey
   ]);
   const mayAutoFocusOnShow = !!autoFocusOnShow;
   const autoFocusOnShowProp = useBooleanEvent(autoFocusOnShow);

package/esm/__chunks/L7IM35RU.js

@@ -0,0 +1,16 @@
+"use client";
+
+// src/tag/utils.ts
+import { useEffect, useState } from "react";
+import { isTouchDevice } from "@ariakit/core/utils/platform";
+function useTouchDevice() {
+  const [touchDevice, setTouchDevice] = useState(false);
+  useEffect(() => {
+    setTouchDevice(isTouchDevice());
+  }, []);
+  return touchDevice;
+}
+
+export {
+  useTouchDevice
+};

package/esm/__chunks/{NFPDVAAW.js → M354SEUF.js}

@@ -10,7 +10,7 @@ import {
 } from "./VXKKJNIF.js";
 import {
   useCompositeItem
-} from "./R33ISPJY.js";
+} from "./VGORKDMQ.js";
 import {
   createElement,
   createHook,

package/esm/__chunks/QNNHZL3W.js

@@ -0,0 +1,25 @@
+"use client";
+import {
+  useCompositeStoreProps
+} from "./ZR5N62ZV.js";
+import {
+  useStore,
+  useStoreProps
+} from "./PWUXK5IM.js";
+
+// src/tag/tag-store.ts
+import * as Core from "@ariakit/core/tag/tag-store";
+function useTagStoreProps(store, update, props) {
+  useStoreProps(store, props, "value", "setValue");
+  useStoreProps(store, props, "values", "setValues");
+  return useCompositeStoreProps(store, update, props);
+}
+function useTagStore(props = {}) {
+  const [store, update] = useStore(Core.createTagStore, props);
+  return useTagStoreProps(store, update, props);
+}
+
+export {
+  useTagStoreProps,
+  useTagStore
+};

package/esm/__chunks/{DSUHLHLE.js → QZJOXZKA.js}

@@ -4,7 +4,7 @@ import {
 } from "./MIIHBIKN.js";
 import {
   useCompositeItem
-} from "./R33ISPJY.js";
+} from "./VGORKDMQ.js";
 import {
   createElement,
   createHook,

package/esm/__chunks/{NHVUMSP7.js → UKDZLPKH.js}

@@ -1,7 +1,7 @@
 "use client";
 import {
   useCompositeItem
-} from "./R33ISPJY.js";
+} from "./VGORKDMQ.js";
 import {
   useToolbarContext
 } from "./766APSLG.js";

package/esm/__chunks/{R33ISPJY.js → VGORKDMQ.js}

@@ -1,10 +1,10 @@
 "use client";
-import {
-  useCommand
-} from "./PJ7ERAIM.js";
 import {
   useCollectionItem
 } from "./IFMAUEA7.js";
+import {
+  useCommand
+} from "./PJ7ERAIM.js";
 import {
   focusSilently,
   getEnabledItem,
@@ -42,11 +42,12 @@ import {
 // src/composite/composite-item.tsx
 import { useCallback, useContext, useMemo, useRef, useState } from "react";
 import {
-  getDocument,
   getScrollingElement,
   getTextboxSelection,
+  getTextboxValue,
   isButton,
-  isTextField
+  isTextField,
+  isTextbox
 } from "@ariakit/core/utils/dom";
 import { isPortalEvent, isSelfTarget } from "@ariakit/core/utils/events";
 import {
@@ -55,26 +56,11 @@ import {
 } from "@ariakit/core/utils/misc";
 import { jsx } from "react/jsx-runtime";
 var TagName = "button";
-function isTextbox(element) {
-  return element.isContentEditable || isTextField(element);
-}
 function isEditableElement(element) {
-  if (element.isContentEditable)
-    return true;
-  if (isTextField(element))
+  if (isTextbox(element))
     return true;
   return element.tagName === "INPUT" && !isButton(element);
 }
-function getValueLength(element) {
-  if (isTextField(element)) {
-    return element.value.length;
-  } else if (element.isContentEditable) {
-    const range = getDocument(element).createRange();
-    range.selectNodeContents(element);
-    return range.toString().length;
-  }
-  return 0;
-}
 function getNextPageOffset(scrollingElement, pageUp = false) {
   const height = scrollingElement.clientHeight;
   const { top } = scrollingElement.getBoundingClientRect();
@@ -329,14 +315,11 @@ var useCompositeItem = createHook(
           const isUp = isVertical && event.key === "ArrowUp";
           const isDown = isVertical && event.key === "ArrowDown";
           if (isRight || isDown) {
-            if (selection.end !== getValueLength(currentTarget)) {
+            const { length: valueLength } = getTextboxValue(currentTarget);
+            if (selection.end !== valueLength)
               return;
-            }
-          } else if (isLeft || isUp) {
-            if (selection.start !== 0) {
-              return;
-            }
-          }
+          } else if ((isLeft || isUp) && selection.start !== 0)
+            return;
         }
         const nextId = action();
         if (preventScrollOnKeyDownProp(event) || nextId !== void 0) {

package/esm/__chunks/WYDDZRWN.js

@@ -0,0 +1,34 @@
+"use client";
+import {
+  CompositeContextProvider,
+  CompositeScopedContextProvider
+} from "./QFI3MCMR.js";
+import {
+  createStoreContext
+} from "./GUCZNEAD.js";
+
+// src/tag/tag-context.tsx
+import { createContext } from "react";
+var TagValueContext = createContext(null);
+var TagRemoveIdContext = createContext(
+  null
+);
+var ctx = createStoreContext(
+  [CompositeContextProvider],
+  [CompositeScopedContextProvider]
+);
+var useTagContext = ctx.useContext;
+var useTagScopedContext = ctx.useScopedContext;
+var useTagProviderContext = ctx.useProviderContext;
+var TagContextProvider = ctx.ContextProvider;
+var TagScopedContextProvider = ctx.ScopedContextProvider;
+
+export {
+  TagValueContext,
+  TagRemoveIdContext,
+  useTagContext,
+  useTagScopedContext,
+  useTagProviderContext,
+  TagContextProvider,
+  TagScopedContextProvider
+};

package/esm/combobox/combobox-cancel.js

@@ -1,11 +1,11 @@
 "use client";
+import {
+  useComboboxProviderContext
+} from "../__chunks/N4X7J4OQ.js";
 import {
   useButton
 } from "../__chunks/CKAOM5LG.js";
 import "../__chunks/PJ7ERAIM.js";
-import {
-  useComboboxProviderContext
-} from "../__chunks/N4X7J4OQ.js";
 import "../__chunks/QFI3MCMR.js";
 import "../__chunks/6LTHW2TQ.js";
 import "../__chunks/5B3U64HV.js";

package/esm/combobox/combobox-disclosure.js

@@ -1,13 +1,13 @@
 "use client";
+import {
+  useComboboxProviderContext
+} from "../__chunks/N4X7J4OQ.js";
 import {
   useDialogDisclosure
 } from "../__chunks/LTYBQEWX.js";
 import "../__chunks/R6SM2O47.js";
 import "../__chunks/CKAOM5LG.js";
 import "../__chunks/PJ7ERAIM.js";
-import {
-  useComboboxProviderContext
-} from "../__chunks/N4X7J4OQ.js";
 import "../__chunks/QFI3MCMR.js";
 import "../__chunks/6LTHW2TQ.js";
 import "../__chunks/5B3U64HV.js";

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

@@ -93,6 +93,20 @@ export interface ComboboxItemOptions<T extends ElementType = TagName> extends Co
      * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      */
     hideOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
+    /**
+     * Whether to set the combobox
+     * [`value`](https://ariakit.org/reference/combobox-provider#value) state
+     * using this item's
+     * [`value`](https://ariakit.org/reference/combobox-item#value) when the item
+     * is clicked. The default is `true`, unless the combobox is
+     * [multi-selectable](https://ariakit.org/examples/combobox-multiple).
+     *
+     * Live examples:
+     * - [Menu with Combobox](https://ariakit.org/examples/menu-combobox)
+     * - [Submenu with
+     *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
+     */
+    setValueOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**
      * Whether to set the
      * [`selectedValue`](https://ariakit.org/reference/combobox-provider#selectedvalue)
@@ -108,19 +122,15 @@ export interface ComboboxItemOptions<T extends ElementType = TagName> extends Co
      */
     selectValueOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**
-     * Whether to set the combobox
-     * [`value`](https://ariakit.org/reference/combobox-provider#value) state
-     * using this item's
-     * [`value`](https://ariakit.org/reference/combobox-item#value) when the item
-     * is clicked. The default is `true`, unless the combobox is
-     * [multi-selectable](https://ariakit.org/examples/combobox-multiple).
-     *
-     * Live examples:
-     * - [Menu with Combobox](https://ariakit.org/examples/menu-combobox)
-     * - [Submenu with
-     *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
+     * Whether to reset the the combobox input value when this item is selected or
+     * unselected by click. This prop is set to `true` by default if
+     * the combobox supports multiple selections. In other words, if the
+     * [`selectedValue`](https://ariakit.org/reference/combobox-provider#selectedvalue)
+     * or
+     * [`defaultSelectedValue`](https://ariakit.org/reference/combobox-provider#defaultselectedvalue)
+     * props are arrays.
      */
-    setValueOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
+    resetValueOnSelect?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**
      * @default false
      */