@ariakit/core 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # @ariakit/core
 
+## 0.4.1
+
+- Added [`disclosure`](https://ariakit.org/reference/use-disclosure-store#disclosure-1) property to disclosure stores.
+- Improved JSDocs.
+
 ## 0.4.0
 
 ### Improved animation support

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

@@ -13,10 +13,16 @@ export interface ComboboxStoreItem extends CompositeStoreItem {
     value?: string;
 }
 export interface ComboboxStoreState<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends CompositeStoreState<ComboboxStoreItem>, PopoverStoreState {
-    /**
-     * @default true
-     */
-    includesBaseElement: boolean;
+    /** @default true */
+    includesBaseElement: CompositeStoreState<ComboboxStoreItem>["includesBaseElement"];
+    /** @default true */
+    focusLoop: CompositeStoreState<ComboboxStoreItem>["focusLoop"];
+    /** @default true */
+    focusWrap: CompositeStoreState<ComboboxStoreItem>["focusWrap"];
+    /** @default "vertical" */
+    orientation: CompositeStoreState<ComboboxStoreItem>["orientation"];
+    /** @default true */
+    virtualFocus: CompositeStoreState<ComboboxStoreItem>["virtualFocus"];
     /**
      * The combobox input value.
      *
@@ -63,6 +69,7 @@ export interface ComboboxStoreState<T extends ComboboxStoreSelectedValue = Combo
      * - [Select with Combobox](https://ariakit.org/examples/select-combobox)
      * - [Submenu with
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      */
     resetValueOnHide: boolean;
     /**
@@ -100,10 +107,8 @@ export interface ComboboxStoreFunctions<T extends ComboboxStoreSelectedValue = C
      */
     setSelectedValue: SetState<ComboboxStoreState<T>["selectedValue"]>;
 }
-export interface ComboboxStoreOptions<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends CompositeStoreOptions<ComboboxStoreItem>, PopoverStoreOptions, StoreOptions<ComboboxStoreState<T>, "includesBaseElement" | "value" | "selectedValue" | "resetValueOnHide" | "resetValueOnSelect"> {
-    /**
-     * @default null
-     */
+export interface ComboboxStoreOptions<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends StoreOptions<ComboboxStoreState<T>, "includesBaseElement" | "focusLoop" | "focusWrap" | "orientation" | "virtualFocus" | "value" | "selectedValue" | "resetValueOnHide" | "resetValueOnSelect">, CompositeStoreOptions<ComboboxStoreItem>, PopoverStoreOptions {
+    /** @default null */
     defaultActiveId?: CompositeStoreOptions<ComboboxStoreItem>["activeId"];
     /**
      * The initial value of the combobox input.

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

@@ -13,10 +13,16 @@ export interface ComboboxStoreItem extends CompositeStoreItem {
     value?: string;
 }
 export interface ComboboxStoreState<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends CompositeStoreState<ComboboxStoreItem>, PopoverStoreState {
-    /**
-     * @default true
-     */
-    includesBaseElement: boolean;
+    /** @default true */
+    includesBaseElement: CompositeStoreState<ComboboxStoreItem>["includesBaseElement"];
+    /** @default true */
+    focusLoop: CompositeStoreState<ComboboxStoreItem>["focusLoop"];
+    /** @default true */
+    focusWrap: CompositeStoreState<ComboboxStoreItem>["focusWrap"];
+    /** @default "vertical" */
+    orientation: CompositeStoreState<ComboboxStoreItem>["orientation"];
+    /** @default true */
+    virtualFocus: CompositeStoreState<ComboboxStoreItem>["virtualFocus"];
     /**
      * The combobox input value.
      *
@@ -63,6 +69,7 @@ export interface ComboboxStoreState<T extends ComboboxStoreSelectedValue = Combo
      * - [Select with Combobox](https://ariakit.org/examples/select-combobox)
      * - [Submenu with
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      */
     resetValueOnHide: boolean;
     /**
@@ -100,10 +107,8 @@ export interface ComboboxStoreFunctions<T extends ComboboxStoreSelectedValue = C
      */
     setSelectedValue: SetState<ComboboxStoreState<T>["selectedValue"]>;
 }
-export interface ComboboxStoreOptions<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends CompositeStoreOptions<ComboboxStoreItem>, PopoverStoreOptions, StoreOptions<ComboboxStoreState<T>, "includesBaseElement" | "value" | "selectedValue" | "resetValueOnHide" | "resetValueOnSelect"> {
-    /**
-     * @default null
-     */
+export interface ComboboxStoreOptions<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends StoreOptions<ComboboxStoreState<T>, "includesBaseElement" | "focusLoop" | "focusWrap" | "orientation" | "virtualFocus" | "value" | "selectedValue" | "resetValueOnHide" | "resetValueOnSelect">, CompositeStoreOptions<ComboboxStoreItem>, PopoverStoreOptions {
+    /** @default null */
     defaultActiveId?: CompositeStoreOptions<ComboboxStoreItem>["activeId"];
     /**
      * The initial value of the combobox input.

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

@@ -112,6 +112,9 @@ export interface CompositeStoreState<T extends CompositeStoreItem = CompositeSto
      *   matches the value of `focusLoop`, it'll wrap between the last item in the
      *   last row or column and the first item in the first row or column and
      *   vice-versa.
+     *
+     * Live examples:
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      * @default false
      */
     focusLoop: boolean | Orientation;
@@ -157,6 +160,7 @@ export interface CompositeStoreState<T extends CompositeStoreItem = CompositeSto
      * - [Submenu with
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      * @default false
      */
     includesBaseElement: boolean;

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

@@ -112,6 +112,9 @@ export interface CompositeStoreState<T extends CompositeStoreItem = CompositeSto
      *   matches the value of `focusLoop`, it'll wrap between the last item in the
      *   last row or column and the first item in the first row or column and
      *   vice-versa.
+     *
+     * Live examples:
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      * @default false
      */
     focusLoop: boolean | Orientation;
@@ -157,6 +160,7 @@ export interface CompositeStoreState<T extends CompositeStoreItem = CompositeSto
      * - [Submenu with
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      * @default false
      */
     includesBaseElement: boolean;

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

@@ -6,9 +6,7 @@ import type { SetState } from "../utils/types.js";
  */
 export declare function createHovercardStore(props?: HovercardStoreProps): HovercardStore;
 export interface HovercardStoreState extends PopoverStoreState {
-    /**
-     * @default "bottom"
-     */
+    /** @default "bottom" */
     placement: PopoverStoreState["placement"];
     /**
      * The amount of time in milliseconds to wait before showing and hiding the
@@ -57,7 +55,7 @@ export interface HovercardStoreFunctions extends PopoverStoreFunctions {
      */
     setAutoFocusOnShow: SetState<HovercardStoreState["autoFocusOnShow"]>;
 }
-export interface HovercardStoreOptions extends PopoverStoreOptions, StoreOptions<HovercardStoreState, "placement" | "timeout" | "showTimeout" | "hideTimeout"> {
+export interface HovercardStoreOptions extends StoreOptions<HovercardStoreState, "placement" | "timeout" | "showTimeout" | "hideTimeout">, PopoverStoreOptions {
 }
 export interface HovercardStoreProps extends HovercardStoreOptions, StoreProps<HovercardStoreState> {
 }

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

@@ -6,9 +6,7 @@ import type { SetState } from "../utils/types.js";
  */
 export declare function createHovercardStore(props?: HovercardStoreProps): HovercardStore;
 export interface HovercardStoreState extends PopoverStoreState {
-    /**
-     * @default "bottom"
-     */
+    /** @default "bottom" */
     placement: PopoverStoreState["placement"];
     /**
      * The amount of time in milliseconds to wait before showing and hiding the
@@ -57,7 +55,7 @@ export interface HovercardStoreFunctions extends PopoverStoreFunctions {
      */
     setAutoFocusOnShow: SetState<HovercardStoreState["autoFocusOnShow"]>;
 }
-export interface HovercardStoreOptions extends PopoverStoreOptions, StoreOptions<HovercardStoreState, "placement" | "timeout" | "showTimeout" | "hideTimeout"> {
+export interface HovercardStoreOptions extends StoreOptions<HovercardStoreState, "placement" | "timeout" | "showTimeout" | "hideTimeout">, PopoverStoreOptions {
 }
 export interface HovercardStoreProps extends HovercardStoreOptions, StoreProps<HovercardStoreState> {
 }

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

@@ -8,6 +8,12 @@ export declare function createMenuStore<T extends MenuStoreValues = MenuStoreVal
 export declare function createMenuStore(props?: MenuStoreProps): MenuStore;
 export type MenuStoreValues = Record<string, string | boolean | number | Array<string | number>>;
 export interface MenuStoreState<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreState, HovercardStoreState {
+    /** @default "vertical" */
+    orientation: CompositeStoreState["orientation"];
+    /** @default "bottom-start" */
+    placement: HovercardStoreState["placement"];
+    /** @default 0 */
+    hideTimeout?: HovercardStoreState["hideTimeout"];
     /**
      * Determines the element that should be focused when the menu is opened.
      */
@@ -24,12 +30,6 @@ export interface MenuStoreState<T extends MenuStoreValues = MenuStoreValues> ext
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      */
     values: T;
-    /** @default "vertical" */
-    orientation: CompositeStoreState["orientation"];
-    /** @default "bottom-start" */
-    placement: HovercardStoreState["placement"];
-    /** @default 0 */
-    hideTimeout?: HovercardStoreState["hideTimeout"];
 }
 export interface MenuStoreFunctions<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreFunctions, HovercardStoreFunctions, Pick<MenuStoreOptions, "combobox" | "parent" | "menubar"> {
     /**
@@ -64,7 +64,7 @@ export interface MenuStoreFunctions<T extends MenuStoreValues = MenuStoreValues>
      */
     setValue: BivariantCallback<(name: string, value: SetStateAction<MenuStoreState<T>["values"][string]>) => void>;
 }
-export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreOptions, HovercardStoreOptions, StoreOptions<MenuStoreState<T>, "orientation" | "placement" | "hideTimeout" | "values"> {
+export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> extends StoreOptions<MenuStoreState<T>, "orientation" | "placement" | "hideTimeout" | "values">, CompositeStoreOptions, HovercardStoreOptions {
     /**
      * A reference to a combobox store. This is used when combining the combobox
      * with a menu (e.g., dropdown menu with a search input). The stores will

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

@@ -8,6 +8,12 @@ export declare function createMenuStore<T extends MenuStoreValues = MenuStoreVal
 export declare function createMenuStore(props?: MenuStoreProps): MenuStore;
 export type MenuStoreValues = Record<string, string | boolean | number | Array<string | number>>;
 export interface MenuStoreState<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreState, HovercardStoreState {
+    /** @default "vertical" */
+    orientation: CompositeStoreState["orientation"];
+    /** @default "bottom-start" */
+    placement: HovercardStoreState["placement"];
+    /** @default 0 */
+    hideTimeout?: HovercardStoreState["hideTimeout"];
     /**
      * Determines the element that should be focused when the menu is opened.
      */
@@ -24,12 +30,6 @@ export interface MenuStoreState<T extends MenuStoreValues = MenuStoreValues> ext
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      */
     values: T;
-    /** @default "vertical" */
-    orientation: CompositeStoreState["orientation"];
-    /** @default "bottom-start" */
-    placement: HovercardStoreState["placement"];
-    /** @default 0 */
-    hideTimeout?: HovercardStoreState["hideTimeout"];
 }
 export interface MenuStoreFunctions<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreFunctions, HovercardStoreFunctions, Pick<MenuStoreOptions, "combobox" | "parent" | "menubar"> {
     /**
@@ -64,7 +64,7 @@ export interface MenuStoreFunctions<T extends MenuStoreValues = MenuStoreValues>
      */
     setValue: BivariantCallback<(name: string, value: SetStateAction<MenuStoreState<T>["values"][string]>) => void>;
 }
-export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreOptions, HovercardStoreOptions, StoreOptions<MenuStoreState<T>, "orientation" | "placement" | "hideTimeout" | "values"> {
+export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> extends StoreOptions<MenuStoreState<T>, "orientation" | "placement" | "hideTimeout" | "values">, CompositeStoreOptions, HovercardStoreOptions {
     /**
      * A reference to a combobox store. This is used when combining the combobox
      * with a menu (e.g., dropdown menu with a search input). The stores will

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

@@ -6,9 +6,7 @@ import type { SetState } from "../utils/types.js";
  */
 export declare function createRadioStore({ ...props }?: RadioStoreProps): RadioStore;
 export interface RadioStoreState extends CompositeStoreState {
-    /**
-     * @default true
-     */
+    /** @default true */
     focusLoop: CompositeStoreState["focusLoop"];
     /**
      * The value of the radio group.
@@ -26,7 +24,7 @@ export interface RadioStoreFunctions extends CompositeStoreFunctions {
      */
     setValue: SetState<RadioStoreState["value"]>;
 }
-export interface RadioStoreOptions extends CompositeStoreOptions, StoreOptions<RadioStoreState, "focusLoop" | "value"> {
+export interface RadioStoreOptions extends StoreOptions<RadioStoreState, "focusLoop" | "value">, CompositeStoreOptions {
     /**
      * The default value of the radio group.
      * @default null

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

@@ -6,9 +6,7 @@ import type { SetState } from "../utils/types.js";
  */
 export declare function createRadioStore({ ...props }?: RadioStoreProps): RadioStore;
 export interface RadioStoreState extends CompositeStoreState {
-    /**
-     * @default true
-     */
+    /** @default true */
     focusLoop: CompositeStoreState["focusLoop"];
     /**
      * The value of the radio group.
@@ -26,7 +24,7 @@ export interface RadioStoreFunctions extends CompositeStoreFunctions {
      */
     setValue: SetState<RadioStoreState["value"]>;
 }
-export interface RadioStoreOptions extends CompositeStoreOptions, StoreOptions<RadioStoreState, "focusLoop" | "value"> {
+export interface RadioStoreOptions extends StoreOptions<RadioStoreState, "focusLoop" | "value">, CompositeStoreOptions {
     /**
      * The default value of the radio group.
      * @default null

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

@@ -13,8 +13,6 @@ export interface SelectStoreItem extends CompositeStoreItem {
 export interface SelectStoreState<T extends SelectStoreValue = SelectStoreValue> extends CompositeStoreState<SelectStoreItem>, PopoverStoreState {
     /** @default true */
     virtualFocus: CompositeStoreState<SelectStoreItem>["virtualFocus"];
-    /** @default false */
-    includesBaseElement: CompositeStoreState<SelectStoreItem>["includesBaseElement"];
     /** @default null */
     activeId: CompositeStoreState<SelectStoreItem>["activeId"];
     /** @default "vertical" */
@@ -77,7 +75,7 @@ export interface SelectStoreFunctions<T extends SelectStoreValue = SelectStoreVa
      */
     setLabelElement: SetState<SelectStoreState<T>["labelElement"]>;
 }
-export interface SelectStoreOptions<T extends SelectStoreValue = SelectStoreValue> extends CompositeStoreOptions<SelectStoreItem>, PopoverStoreOptions, StoreOptions<SelectStoreState<T>, "virtualFocus" | "includesBaseElement" | "activeId" | "orientation" | "placement" | "value" | "setValueOnMove"> {
+export interface SelectStoreOptions<T extends SelectStoreValue = SelectStoreValue> extends StoreOptions<SelectStoreState<T>, "virtualFocus" | "activeId" | "orientation" | "placement" | "value" | "setValueOnMove">, CompositeStoreOptions<SelectStoreItem>, PopoverStoreOptions {
     /**
      * A reference to a combobox store. This is used when combining the combobox
      * with a select (e.g., select with a search input). The stores will share the

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

@@ -13,8 +13,6 @@ export interface SelectStoreItem extends CompositeStoreItem {
 export interface SelectStoreState<T extends SelectStoreValue = SelectStoreValue> extends CompositeStoreState<SelectStoreItem>, PopoverStoreState {
     /** @default true */
     virtualFocus: CompositeStoreState<SelectStoreItem>["virtualFocus"];
-    /** @default false */
-    includesBaseElement: CompositeStoreState<SelectStoreItem>["includesBaseElement"];
     /** @default null */
     activeId: CompositeStoreState<SelectStoreItem>["activeId"];
     /** @default "vertical" */
@@ -77,7 +75,7 @@ export interface SelectStoreFunctions<T extends SelectStoreValue = SelectStoreVa
      */
     setLabelElement: SetState<SelectStoreState<T>["labelElement"]>;
 }
-export interface SelectStoreOptions<T extends SelectStoreValue = SelectStoreValue> extends CompositeStoreOptions<SelectStoreItem>, PopoverStoreOptions, StoreOptions<SelectStoreState<T>, "virtualFocus" | "includesBaseElement" | "activeId" | "orientation" | "placement" | "value" | "setValueOnMove"> {
+export interface SelectStoreOptions<T extends SelectStoreValue = SelectStoreValue> extends StoreOptions<SelectStoreState<T>, "virtualFocus" | "activeId" | "orientation" | "placement" | "value" | "setValueOnMove">, CompositeStoreOptions<SelectStoreItem>, PopoverStoreOptions {
     /**
      * A reference to a combobox store. This is used when combining the combobox
      * with a select (e.g., select with a search input). The stores will share the

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

@@ -12,7 +12,7 @@ export interface ToolbarStoreState extends CompositeStoreState {
 }
 export interface ToolbarStoreFunctions extends CompositeStoreFunctions {
 }
-export interface ToolbarStoreOptions extends CompositeStoreOptions, StoreOptions<ToolbarStoreState, "orientation" | "focusLoop"> {
+export interface ToolbarStoreOptions extends StoreOptions<ToolbarStoreState, "orientation" | "focusLoop">, CompositeStoreOptions {
 }
 export interface ToolbarStoreProps extends ToolbarStoreOptions, StoreProps<ToolbarStoreState> {
 }

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

@@ -12,7 +12,7 @@ export interface ToolbarStoreState extends CompositeStoreState {
 }
 export interface ToolbarStoreFunctions extends CompositeStoreFunctions {
 }
-export interface ToolbarStoreOptions extends CompositeStoreOptions, StoreOptions<ToolbarStoreState, "orientation" | "focusLoop"> {
+export interface ToolbarStoreOptions extends StoreOptions<ToolbarStoreState, "orientation" | "focusLoop">, CompositeStoreOptions {
 }
 export interface ToolbarStoreProps extends ToolbarStoreOptions, StoreProps<ToolbarStoreState> {
 }

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

@@ -25,7 +25,7 @@ export interface TooltipStoreState extends HovercardStoreState {
     skipTimeout: number;
 }
 export type TooltipStoreFunctions = HovercardStoreFunctions;
-export interface TooltipStoreOptions extends HovercardStoreOptions, StoreOptions<TooltipStoreState, "type" | "placement" | "timeout" | "showTimeout" | "hideTimeout" | "skipTimeout"> {
+export interface TooltipStoreOptions extends StoreOptions<TooltipStoreState, "type" | "placement" | "timeout" | "showTimeout" | "hideTimeout" | "skipTimeout">, HovercardStoreOptions {
 }
 export interface TooltipStoreProps extends TooltipStoreOptions, StoreProps<TooltipStoreState> {
 }

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

@@ -25,7 +25,7 @@ export interface TooltipStoreState extends HovercardStoreState {
     skipTimeout: number;
 }
 export type TooltipStoreFunctions = HovercardStoreFunctions;
-export interface TooltipStoreOptions extends HovercardStoreOptions, StoreOptions<TooltipStoreState, "type" | "placement" | "timeout" | "showTimeout" | "hideTimeout" | "skipTimeout"> {
+export interface TooltipStoreOptions extends StoreOptions<TooltipStoreState, "type" | "placement" | "timeout" | "showTimeout" | "hideTimeout" | "skipTimeout">, HovercardStoreOptions {
 }
 export interface TooltipStoreProps extends TooltipStoreOptions, StoreProps<TooltipStoreState> {
 }

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

@@ -13,10 +13,16 @@ export interface ComboboxStoreItem extends CompositeStoreItem {
     value?: string;
 }
 export interface ComboboxStoreState<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends CompositeStoreState<ComboboxStoreItem>, PopoverStoreState {
-    /**
-     * @default true
-     */
-    includesBaseElement: boolean;
+    /** @default true */
+    includesBaseElement: CompositeStoreState<ComboboxStoreItem>["includesBaseElement"];
+    /** @default true */
+    focusLoop: CompositeStoreState<ComboboxStoreItem>["focusLoop"];
+    /** @default true */
+    focusWrap: CompositeStoreState<ComboboxStoreItem>["focusWrap"];
+    /** @default "vertical" */
+    orientation: CompositeStoreState<ComboboxStoreItem>["orientation"];
+    /** @default true */
+    virtualFocus: CompositeStoreState<ComboboxStoreItem>["virtualFocus"];
     /**
      * The combobox input value.
      *
@@ -63,6 +69,7 @@ export interface ComboboxStoreState<T extends ComboboxStoreSelectedValue = Combo
      * - [Select with Combobox](https://ariakit.org/examples/select-combobox)
      * - [Submenu with
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      */
     resetValueOnHide: boolean;
     /**
@@ -100,10 +107,8 @@ export interface ComboboxStoreFunctions<T extends ComboboxStoreSelectedValue = C
      */
     setSelectedValue: SetState<ComboboxStoreState<T>["selectedValue"]>;
 }
-export interface ComboboxStoreOptions<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends CompositeStoreOptions<ComboboxStoreItem>, PopoverStoreOptions, StoreOptions<ComboboxStoreState<T>, "includesBaseElement" | "value" | "selectedValue" | "resetValueOnHide" | "resetValueOnSelect"> {
-    /**
-     * @default null
-     */
+export interface ComboboxStoreOptions<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends StoreOptions<ComboboxStoreState<T>, "includesBaseElement" | "focusLoop" | "focusWrap" | "orientation" | "virtualFocus" | "value" | "selectedValue" | "resetValueOnHide" | "resetValueOnSelect">, CompositeStoreOptions<ComboboxStoreItem>, PopoverStoreOptions {
+    /** @default null */
     defaultActiveId?: CompositeStoreOptions<ComboboxStoreItem>["activeId"];
     /**
      * The initial value of the combobox input.

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

@@ -112,6 +112,9 @@ export interface CompositeStoreState<T extends CompositeStoreItem = CompositeSto
      *   matches the value of `focusLoop`, it'll wrap between the last item in the
      *   last row or column and the first item in the first row or column and
      *   vice-versa.
+     *
+     * Live examples:
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      * @default false
      */
     focusLoop: boolean | Orientation;
@@ -157,6 +160,7 @@ export interface CompositeStoreState<T extends CompositeStoreItem = CompositeSto
      * - [Submenu with
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      * @default false
      */
     includesBaseElement: boolean;

package/esm/hovercard/hovercard-store.d.ts

@@ -6,9 +6,7 @@ import type { SetState } from "../utils/types.js";
  */
 export declare function createHovercardStore(props?: HovercardStoreProps): HovercardStore;
 export interface HovercardStoreState extends PopoverStoreState {
-    /**
-     * @default "bottom"
-     */
+    /** @default "bottom" */
     placement: PopoverStoreState["placement"];
     /**
      * The amount of time in milliseconds to wait before showing and hiding the
@@ -57,7 +55,7 @@ export interface HovercardStoreFunctions extends PopoverStoreFunctions {
      */
     setAutoFocusOnShow: SetState<HovercardStoreState["autoFocusOnShow"]>;
 }
-export interface HovercardStoreOptions extends PopoverStoreOptions, StoreOptions<HovercardStoreState, "placement" | "timeout" | "showTimeout" | "hideTimeout"> {
+export interface HovercardStoreOptions extends StoreOptions<HovercardStoreState, "placement" | "timeout" | "showTimeout" | "hideTimeout">, PopoverStoreOptions {
 }
 export interface HovercardStoreProps extends HovercardStoreOptions, StoreProps<HovercardStoreState> {
 }

package/esm/menu/menu-store.d.ts

@@ -8,6 +8,12 @@ export declare function createMenuStore<T extends MenuStoreValues = MenuStoreVal
 export declare function createMenuStore(props?: MenuStoreProps): MenuStore;
 export type MenuStoreValues = Record<string, string | boolean | number | Array<string | number>>;
 export interface MenuStoreState<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreState, HovercardStoreState {
+    /** @default "vertical" */
+    orientation: CompositeStoreState["orientation"];
+    /** @default "bottom-start" */
+    placement: HovercardStoreState["placement"];
+    /** @default 0 */
+    hideTimeout?: HovercardStoreState["hideTimeout"];
     /**
      * Determines the element that should be focused when the menu is opened.
      */
@@ -24,12 +30,6 @@ export interface MenuStoreState<T extends MenuStoreValues = MenuStoreValues> ext
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      */
     values: T;
-    /** @default "vertical" */
-    orientation: CompositeStoreState["orientation"];
-    /** @default "bottom-start" */
-    placement: HovercardStoreState["placement"];
-    /** @default 0 */
-    hideTimeout?: HovercardStoreState["hideTimeout"];
 }
 export interface MenuStoreFunctions<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreFunctions, HovercardStoreFunctions, Pick<MenuStoreOptions, "combobox" | "parent" | "menubar"> {
     /**
@@ -64,7 +64,7 @@ export interface MenuStoreFunctions<T extends MenuStoreValues = MenuStoreValues>
      */
     setValue: BivariantCallback<(name: string, value: SetStateAction<MenuStoreState<T>["values"][string]>) => void>;
 }
-export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreOptions, HovercardStoreOptions, StoreOptions<MenuStoreState<T>, "orientation" | "placement" | "hideTimeout" | "values"> {
+export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> extends StoreOptions<MenuStoreState<T>, "orientation" | "placement" | "hideTimeout" | "values">, CompositeStoreOptions, HovercardStoreOptions {
     /**
      * A reference to a combobox store. This is used when combining the combobox
      * with a menu (e.g., dropdown menu with a search input). The stores will

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

@@ -6,9 +6,7 @@ import type { SetState } from "../utils/types.js";
  */
 export declare function createRadioStore({ ...props }?: RadioStoreProps): RadioStore;
 export interface RadioStoreState extends CompositeStoreState {
-    /**
-     * @default true
-     */
+    /** @default true */
     focusLoop: CompositeStoreState["focusLoop"];
     /**
      * The value of the radio group.
@@ -26,7 +24,7 @@ export interface RadioStoreFunctions extends CompositeStoreFunctions {
      */
     setValue: SetState<RadioStoreState["value"]>;
 }
-export interface RadioStoreOptions extends CompositeStoreOptions, StoreOptions<RadioStoreState, "focusLoop" | "value"> {
+export interface RadioStoreOptions extends StoreOptions<RadioStoreState, "focusLoop" | "value">, CompositeStoreOptions {
     /**
      * The default value of the radio group.
      * @default null

package/esm/select/select-store.d.ts

@@ -13,8 +13,6 @@ export interface SelectStoreItem extends CompositeStoreItem {
 export interface SelectStoreState<T extends SelectStoreValue = SelectStoreValue> extends CompositeStoreState<SelectStoreItem>, PopoverStoreState {
     /** @default true */
     virtualFocus: CompositeStoreState<SelectStoreItem>["virtualFocus"];
-    /** @default false */
-    includesBaseElement: CompositeStoreState<SelectStoreItem>["includesBaseElement"];
     /** @default null */
     activeId: CompositeStoreState<SelectStoreItem>["activeId"];
     /** @default "vertical" */
@@ -77,7 +75,7 @@ export interface SelectStoreFunctions<T extends SelectStoreValue = SelectStoreVa
      */
     setLabelElement: SetState<SelectStoreState<T>["labelElement"]>;
 }
-export interface SelectStoreOptions<T extends SelectStoreValue = SelectStoreValue> extends CompositeStoreOptions<SelectStoreItem>, PopoverStoreOptions, StoreOptions<SelectStoreState<T>, "virtualFocus" | "includesBaseElement" | "activeId" | "orientation" | "placement" | "value" | "setValueOnMove"> {
+export interface SelectStoreOptions<T extends SelectStoreValue = SelectStoreValue> extends StoreOptions<SelectStoreState<T>, "virtualFocus" | "activeId" | "orientation" | "placement" | "value" | "setValueOnMove">, CompositeStoreOptions<SelectStoreItem>, PopoverStoreOptions {
     /**
      * A reference to a combobox store. This is used when combining the combobox
      * with a select (e.g., select with a search input). The stores will share the

package/esm/toolbar/toolbar-store.d.ts

@@ -12,7 +12,7 @@ export interface ToolbarStoreState extends CompositeStoreState {
 }
 export interface ToolbarStoreFunctions extends CompositeStoreFunctions {
 }
-export interface ToolbarStoreOptions extends CompositeStoreOptions, StoreOptions<ToolbarStoreState, "orientation" | "focusLoop"> {
+export interface ToolbarStoreOptions extends StoreOptions<ToolbarStoreState, "orientation" | "focusLoop">, CompositeStoreOptions {
 }
 export interface ToolbarStoreProps extends ToolbarStoreOptions, StoreProps<ToolbarStoreState> {
 }

package/esm/tooltip/tooltip-store.d.ts

@@ -25,7 +25,7 @@ export interface TooltipStoreState extends HovercardStoreState {
     skipTimeout: number;
 }
 export type TooltipStoreFunctions = HovercardStoreFunctions;
-export interface TooltipStoreOptions extends HovercardStoreOptions, StoreOptions<TooltipStoreState, "type" | "placement" | "timeout" | "showTimeout" | "hideTimeout" | "skipTimeout"> {
+export interface TooltipStoreOptions extends StoreOptions<TooltipStoreState, "type" | "placement" | "timeout" | "showTimeout" | "hideTimeout" | "skipTimeout">, HovercardStoreOptions {
 }
 export interface TooltipStoreProps extends TooltipStoreOptions, StoreProps<TooltipStoreState> {
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ariakit/core",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Ariakit core",
   "sideEffects": false,
   "license": "MIT",