@ariakit/react-core 0.3.12 → 0.3.14

package/cjs/select/select.cjs

@@ -192,12 +192,14 @@ var useSelect = _RNZNGEL4cjs.createHook.call(void 0,
     });
     const label = props["aria-label"];
     const labelledBy = props["aria-labelledby"] || labelId;
-    const items = store.useState("items");
-    const values = _react.useMemo.call(void 0, 
-      // Filter out items without value and duplicate values.
-      () => [...new Set(items.map((i) => i.value).filter((v) => v != null))],
-      [items]
-    );
+    const items = store.useState((state) => {
+      if (!name)
+        return;
+      return state.items;
+    });
+    const values = _react.useMemo.call(void 0, () => {
+      return [...new Set(items == null ? void 0 : items.map((i) => i.value).filter((v) => v != null))];
+    }, [items]);
     props = _EO6LS72Hcjs.useWrapElement.call(void 0, 
       props,
       (element) => {

package/cjs/select/select.d.cts

@@ -16,7 +16,15 @@ import type { SelectStore } from "./select-store.js";
  */
 export declare const useSelect: import("../utils/types.js").Hook<SelectOptions<"button">>;
 /**
- * Renders a select button.
+ * Renders a custom select element that controls the visibility of either a
+ * [`SelectList`](https://ariakit.org/reference/select-list) or a
+ * [`SelectPopover`](https://ariakit.org/reference/select-popover) component.
+ *
+ * By default, the
+ * [`value`](https://ariakit.org/reference/select-provider#value) state is
+ * rendered as the children, followed by a
+ * [`SelectArrow`](https://ariakit.org/reference/select-arrow) component. This
+ * can be customized by passing different children to the component.
  * @see https://ariakit.org/components/select
  * @example
  * ```jsx {2}
@@ -40,14 +48,14 @@ export interface SelectOptions<T extends As = "button"> extends PopoverDisclosur
      */
     store?: SelectStore;
     /**
-     * Determines whether the
+     * Determines if the
      * [`SelectList`](https://ariakit.org/reference/select-list) or
      * [`SelectPopover`](https://ariakit.org/reference/select-popover) components
-     * will be shown when the user presses arrow keys while the select element is
-     * focused.
+     * will appear when the user uses arrow keys while the select element is
+     * in focus.
      *
      * Live examples:
-     * - [Select grid](https://ariakit.org/examples/select-grid)
+     * - [Select Grid](https://ariakit.org/examples/select-grid)
      * @default true
      */
     showOnKeyDown?: BooleanOrCallback<KeyboardEvent<HTMLElement>>;
@@ -55,28 +63,30 @@ export interface SelectOptions<T extends As = "button"> extends PopoverDisclosur
      * Determines whether pressing arrow keys will move the active item even when
      * the [`SelectList`](https://ariakit.org/reference/select-list) or
      * [`SelectPopover`](https://ariakit.org/reference/select-popover) components
-     * is hidden.
+     * are hidden.
      * @default false
      */
     moveOnKeyDown?: BooleanOrCallback<KeyboardEvent<HTMLElement>>;
     /**
-     * Determines whether
-     * [`toggle`](https://ariakit.org/reference/use-select-store#toggle) will be
-     * called on click. By default, the
+     * Determines if
+     * [`toggle`](https://ariakit.org/reference/use-select-store#toggle) should be
+     * invoked on click. By default, the
      * [`SelectList`](https://ariakit.org/reference/select-list) or
      * [`SelectPopover`](https://ariakit.org/reference/select-popover) components
-     * will be shown on press (on mouse down and on key down). If this prop is set
-     * to `true`, the [`SelectList`](https://ariakit.org/reference/select-list) or
-     * [`SelectPopover`](https://ariakit.org/reference/select-popover) components
-     * will be shown on click instead.
+     * are displayed on press (on mouse/key down).
+     *
+     * **Note**: When set to `true`, this prop supersedes the
+     * [`toggleOnPress`](https://ariakit.org/reference/select#toggleonpress) prop.
      * @default false
      */
     toggleOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**
-     * Determines whether pressing space, enter or mouse down will toggle the
+     * Determines whether pressing Space, Enter, or a mouse down event will
+     * [`toggle`](https://ariakit.org/reference/use-select-store#toggle) the
      * [`SelectList`](https://ariakit.org/reference/select-list) or
      * [`SelectPopover`](https://ariakit.org/reference/select-popover) components.
-     * This prop will be ignored if
+     *
+     * **Note**: This prop is disregarded if
      * [`toggleOnClick`](https://ariakit.org/reference/select#toggleonclick) is
      * set to `true`.
      * @default true

package/cjs/select/select.d.ts

@@ -16,7 +16,15 @@ import type { SelectStore } from "./select-store.js";
  */
 export declare const useSelect: import("../utils/types.js").Hook<SelectOptions<"button">>;
 /**
- * Renders a select button.
+ * Renders a custom select element that controls the visibility of either a
+ * [`SelectList`](https://ariakit.org/reference/select-list) or a
+ * [`SelectPopover`](https://ariakit.org/reference/select-popover) component.
+ *
+ * By default, the
+ * [`value`](https://ariakit.org/reference/select-provider#value) state is
+ * rendered as the children, followed by a
+ * [`SelectArrow`](https://ariakit.org/reference/select-arrow) component. This
+ * can be customized by passing different children to the component.
  * @see https://ariakit.org/components/select
  * @example
  * ```jsx {2}
@@ -40,14 +48,14 @@ export interface SelectOptions<T extends As = "button"> extends PopoverDisclosur
      */
     store?: SelectStore;
     /**
-     * Determines whether the
+     * Determines if the
      * [`SelectList`](https://ariakit.org/reference/select-list) or
      * [`SelectPopover`](https://ariakit.org/reference/select-popover) components
-     * will be shown when the user presses arrow keys while the select element is
-     * focused.
+     * will appear when the user uses arrow keys while the select element is
+     * in focus.
      *
      * Live examples:
-     * - [Select grid](https://ariakit.org/examples/select-grid)
+     * - [Select Grid](https://ariakit.org/examples/select-grid)
      * @default true
      */
     showOnKeyDown?: BooleanOrCallback<KeyboardEvent<HTMLElement>>;
@@ -55,28 +63,30 @@ export interface SelectOptions<T extends As = "button"> extends PopoverDisclosur
      * Determines whether pressing arrow keys will move the active item even when
      * the [`SelectList`](https://ariakit.org/reference/select-list) or
      * [`SelectPopover`](https://ariakit.org/reference/select-popover) components
-     * is hidden.
+     * are hidden.
      * @default false
      */
     moveOnKeyDown?: BooleanOrCallback<KeyboardEvent<HTMLElement>>;
     /**
-     * Determines whether
-     * [`toggle`](https://ariakit.org/reference/use-select-store#toggle) will be
-     * called on click. By default, the
+     * Determines if
+     * [`toggle`](https://ariakit.org/reference/use-select-store#toggle) should be
+     * invoked on click. By default, the
      * [`SelectList`](https://ariakit.org/reference/select-list) or
      * [`SelectPopover`](https://ariakit.org/reference/select-popover) components
-     * will be shown on press (on mouse down and on key down). If this prop is set
-     * to `true`, the [`SelectList`](https://ariakit.org/reference/select-list) or
-     * [`SelectPopover`](https://ariakit.org/reference/select-popover) components
-     * will be shown on click instead.
+     * are displayed on press (on mouse/key down).
+     *
+     * **Note**: When set to `true`, this prop supersedes the
+     * [`toggleOnPress`](https://ariakit.org/reference/select#toggleonpress) prop.
      * @default false
      */
     toggleOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**
-     * Determines whether pressing space, enter or mouse down will toggle the
+     * Determines whether pressing Space, Enter, or a mouse down event will
+     * [`toggle`](https://ariakit.org/reference/use-select-store#toggle) the
      * [`SelectList`](https://ariakit.org/reference/select-list) or
      * [`SelectPopover`](https://ariakit.org/reference/select-popover) components.
-     * This prop will be ignored if
+     *
+     * **Note**: This prop is disregarded if
      * [`toggleOnClick`](https://ariakit.org/reference/select#toggleonclick) is
      * set to `true`.
      * @default true

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

@@ -18,7 +18,8 @@ import type { TabStore } from "./tab-store.js";
  */
 export declare const useTabList: import("../utils/types.js").Hook<TabListOptions<"div">>;
 /**
- * Renders a tab list element.
+ * Renders a composite tab list wrapper for
+ * [`Tab`](https://ariakit.org/reference/tab) elements.
  * @see https://ariakit.org/components/tab
  * @example
  * ```jsx {2-5}

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

@@ -18,7 +18,8 @@ import type { TabStore } from "./tab-store.js";
  */
 export declare const useTabList: import("../utils/types.js").Hook<TabListOptions<"div">>;
 /**
- * Renders a tab list element.
+ * Renders a composite tab list wrapper for
+ * [`Tab`](https://ariakit.org/reference/tab) elements.
  * @see https://ariakit.org/components/tab
  * @example
  * ```jsx {2-5}

package/cjs/tab/tab-panel.d.cts

@@ -18,7 +18,15 @@ import type { TabStore } from "./tab-store.js";
  */
 export declare const useTabPanel: import("../utils/types.js").Hook<TabPanelOptions<"div">>;
 /**
- * Renders a tab panel element.
+ * Renders a tab panel element that's controlled by a
+ * [`Tab`](https://ariakit.org/reference/tab) component.
+ *
+ * If the [`tabId`](https://ariakit.org/reference/tab-panel#tabid) prop isn't
+ * provided, the tab panel will automatically associate with a
+ * [`Tab`](https://ariakit.org/reference/tab) based on its position in the DOM.
+ * Alternatively, you can render a single tab panel with a dynamic
+ * [`tabId`](https://ariakit.org/reference/tab-panel#tabid) value pointing to
+ * the selected tab.
  * @see https://ariakit.org/components/tab
  * @example
  * ```jsx {6,7}
@@ -43,8 +51,16 @@ export interface TabPanelOptions<T extends As = "div"> extends FocusableOptions<
      */
     store?: TabStore;
     /**
-     * The `id` of the tab controlling this panel is set by default. Typically,
-     * this value is inferred from the sequence of the tabs and panels.
+     * The [`id`](https://ariakit.org/reference/tab#id) of the tab controlling
+     * this panel. This connection is used to assign the `aria-labelledby`
+     * attribute to the tab panel and to determine if the tab panel should be
+     * visible.
+     *
+     * This link is automatically established by matching the order of
+     * [`Tab`](https://ariakit.org/reference/tab) and
+     * [`TabPanel`](https://ariakit.org/reference/tab-panel) elements in the DOM.
+     * If you're rendering a single tab panel, this can be set to a dynamic value
+     * that refers to the selected tab.
      *
      * Live examples:
      * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)

package/cjs/tab/tab-panel.d.ts

@@ -18,7 +18,15 @@ import type { TabStore } from "./tab-store.js";
  */
 export declare const useTabPanel: import("../utils/types.js").Hook<TabPanelOptions<"div">>;
 /**
- * Renders a tab panel element.
+ * Renders a tab panel element that's controlled by a
+ * [`Tab`](https://ariakit.org/reference/tab) component.
+ *
+ * If the [`tabId`](https://ariakit.org/reference/tab-panel#tabid) prop isn't
+ * provided, the tab panel will automatically associate with a
+ * [`Tab`](https://ariakit.org/reference/tab) based on its position in the DOM.
+ * Alternatively, you can render a single tab panel with a dynamic
+ * [`tabId`](https://ariakit.org/reference/tab-panel#tabid) value pointing to
+ * the selected tab.
  * @see https://ariakit.org/components/tab
  * @example
  * ```jsx {6,7}
@@ -43,8 +51,16 @@ export interface TabPanelOptions<T extends As = "div"> extends FocusableOptions<
      */
     store?: TabStore;
     /**
-     * The `id` of the tab controlling this panel is set by default. Typically,
-     * this value is inferred from the sequence of the tabs and panels.
+     * The [`id`](https://ariakit.org/reference/tab#id) of the tab controlling
+     * this panel. This connection is used to assign the `aria-labelledby`
+     * attribute to the tab panel and to determine if the tab panel should be
+     * visible.
+     *
+     * This link is automatically established by matching the order of
+     * [`Tab`](https://ariakit.org/reference/tab) and
+     * [`TabPanel`](https://ariakit.org/reference/tab-panel) elements in the DOM.
+     * If you're rendering a single tab panel, this can be set to a dynamic value
+     * that refers to the selected tab.
      *
      * Live examples:
      * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)

package/cjs/tab/tab-provider.d.cts

@@ -1,7 +1,7 @@
 import type { ReactNode } from "react";
 import type { TabStoreProps } from "./tab-store.js";
 /**
- * Provides a tab store to Tab components.
+ * Provides a tab store to [Tab](https://ariakit.org/components/tab) components.
  * @see https://ariakit.org/components/tab
  * @example
  * ```jsx

package/cjs/tab/tab-provider.d.ts

@@ -1,7 +1,7 @@
 import type { ReactNode } from "react";
 import type { TabStoreProps } from "./tab-store.js";
 /**
- * Provides a tab store to Tab components.
+ * Provides a tab store to [Tab](https://ariakit.org/components/tab) components.
  * @see https://ariakit.org/components/tab
  * @example
  * ```jsx

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

@@ -11,11 +11,13 @@ export declare function useTabStoreProps<T extends Core.TabStore>(store: T, upda
     };
 };
 /**
- * Creates a tab store.
+ * Creates a tab store to control the state of
+ * [Tab](https://ariakit.org/components/tab) components.
  * @see https://ariakit.org/components/tab
  * @example
  * ```jsx
  * const tab = useTabStore();
+ *
  * <TabList store={tab}>
  *   <Tab>Tab 1</Tab>
  *   <Tab>Tab 2</Tab>

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

@@ -11,11 +11,13 @@ export declare function useTabStoreProps<T extends Core.TabStore>(store: T, upda
     };
 };
 /**
- * Creates a tab store.
+ * Creates a tab store to control the state of
+ * [Tab](https://ariakit.org/components/tab) components.
  * @see https://ariakit.org/components/tab
  * @example
  * ```jsx
  * const tab = useTabStore();
+ *
  * <TabList store={tab}>
  *   <Tab>Tab 1</Tab>
  *   <Tab>Tab 2</Tab>

package/cjs/tab/tab.d.cts

@@ -16,8 +16,8 @@ import type { TabStore } from "./tab-store.js";
  */
 export declare const useTab: import("../utils/types.js").Hook<TabOptions<"button">>;
 /**
- * Renders a tab element. The underlying element must be wrapped in a `TabList`
- * component.
+ * Renders a tab element inside a
+ * [`TabList`](https://ariakit.org/reference/tab-list) wrapper.
  * @see https://ariakit.org/components/tab
  * @example
  * ```jsx {3,4}

package/cjs/tab/tab.d.ts

@@ -16,8 +16,8 @@ import type { TabStore } from "./tab-store.js";
  */
 export declare const useTab: import("../utils/types.js").Hook<TabOptions<"button">>;
 /**
- * Renders a tab element. The underlying element must be wrapped in a `TabList`
- * component.
+ * Renders a tab element inside a
+ * [`TabList`](https://ariakit.org/reference/tab-list) wrapper.
  * @see https://ariakit.org/components/tab
  * @example
  * ```jsx {3,4}

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

@@ -17,7 +17,7 @@ import type { ToolbarItemOptions } from "./toolbar-item.js";
  */
 export declare const useToolbarContainer: import("../utils/types.js").Hook<ToolbarContainerOptions<"div">>;
 /**
- * Renders a container for interactive widgets inside toolbar items.
+ * Renders a toolbar item that may contain interactive widgets inside.
  * @see https://ariakit.org/components/toolbar
  * @example
  * ```jsx {2-4}

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

@@ -17,7 +17,7 @@ import type { ToolbarItemOptions } from "./toolbar-item.js";
  */
 export declare const useToolbarContainer: import("../utils/types.js").Hook<ToolbarContainerOptions<"div">>;
 /**
- * Renders a container for interactive widgets inside toolbar items.
+ * Renders a toolbar item that may contain interactive widgets inside.
  * @see https://ariakit.org/components/toolbar
  * @example
  * ```jsx {2-4}

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

@@ -15,7 +15,8 @@ import type { ToolbarItemOptions } from "./toolbar-item.js";
  */
 export declare const useToolbarInput: import("../utils/types.js").Hook<ToolbarInputOptions<"input">>;
 /**
- * Renders an input as a toolbar item.
+ * Renders a text input as a toolbar item, maintaining arrow key navigation on
+ * the toolbar.
  * @see https://ariakit.org/components/toolbar
  * @example
  * ```jsx {2}

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

@@ -15,7 +15,8 @@ import type { ToolbarItemOptions } from "./toolbar-item.js";
  */
 export declare const useToolbarInput: import("../utils/types.js").Hook<ToolbarInputOptions<"input">>;
 /**
- * Renders an input as a toolbar item.
+ * Renders a text input as a toolbar item, maintaining arrow key navigation on
+ * the toolbar.
  * @see https://ariakit.org/components/toolbar
  * @example
  * ```jsx {2}

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

@@ -15,7 +15,8 @@ import type { ToolbarStore } from "./toolbar-store.js";
  */
 export declare const useToolbarItem: import("../utils/types.js").Hook<ToolbarItemOptions<"button">>;
 /**
- * Renders an interactive element in a toolbar.
+ * Renders an interactive element inside a
+ * [`Toolbar`](https://ariakit.org/reference/toolbar).
  * @see https://ariakit.org/components/toolbar
  * @example
  * ```jsx {2}

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

@@ -15,7 +15,8 @@ import type { ToolbarStore } from "./toolbar-store.js";
  */
 export declare const useToolbarItem: import("../utils/types.js").Hook<ToolbarItemOptions<"button">>;
 /**
- * Renders an interactive element in a toolbar.
+ * Renders an interactive element inside a
+ * [`Toolbar`](https://ariakit.org/reference/toolbar).
  * @see https://ariakit.org/components/toolbar
  * @example
  * ```jsx {2}

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

@@ -1,7 +1,8 @@
 import type { ReactNode } from "react";
 import type { ToolbarStoreProps } from "./toolbar-store.js";
 /**
- * Provides a toolbar store to Toolbar components.
+ * Provides a toolbar store to [Toolbar](https://ariakit.org/components/toolbar)
+ * components.
  * @see https://ariakit.org/components/toolbar
  * @example
  * ```jsx

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

@@ -1,7 +1,8 @@
 import type { ReactNode } from "react";
 import type { ToolbarStoreProps } from "./toolbar-store.js";
 /**
- * Provides a toolbar store to Toolbar components.
+ * Provides a toolbar store to [Toolbar](https://ariakit.org/components/toolbar)
+ * components.
  * @see https://ariakit.org/components/toolbar
  * @example
  * ```jsx

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

@@ -17,7 +17,8 @@ import type { ToolbarStore } from "./toolbar-store.js";
  */
 export declare const useToolbarSeparator: import("../utils/types.js").Hook<ToolbarSeparatorOptions<"hr">>;
 /**
- * Renders a separator for toolbar items.
+ * Renders a divider between
+ * [`ToolbarItem`](https://ariakit.org/reference/toolbar-item) elements.
  * @see https://ariakit.org/components/toolbar
  * @example
  * ```jsx {3}

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

@@ -17,7 +17,8 @@ import type { ToolbarStore } from "./toolbar-store.js";
  */
 export declare const useToolbarSeparator: import("../utils/types.js").Hook<ToolbarSeparatorOptions<"hr">>;
 /**
- * Renders a separator for toolbar items.
+ * Renders a divider between
+ * [`ToolbarItem`](https://ariakit.org/reference/toolbar-item) elements.
  * @see https://ariakit.org/components/toolbar
  * @example
  * ```jsx {3}

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

@@ -3,11 +3,13 @@ import type { CompositeStoreFunctions, CompositeStoreOptions, CompositeStoreStat
 import type { Store } from "../utils/store.js";
 export declare function useToolbarStoreProps<T extends Core.ToolbarStore>(store: T, update: () => void, props: ToolbarStoreProps): T;
 /**
- * Creates a toolbar store.
+ * Creates a toolbar store to control the state of
+ * [Toolbar](https://ariakit.org/components/toolbar) components.
  * @see https://ariakit.org/components/toolbar
  * @example
  * ```jsx
  * const toolbar = useToolbarStore();
+ *
  * <Toolbar store={toolbar}>
  *   <ToolbarItem>Item 1</ToolbarItem>
  *   <ToolbarItem>Item 2</ToolbarItem>

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

@@ -3,11 +3,13 @@ import type { CompositeStoreFunctions, CompositeStoreOptions, CompositeStoreStat
 import type { Store } from "../utils/store.js";
 export declare function useToolbarStoreProps<T extends Core.ToolbarStore>(store: T, update: () => void, props: ToolbarStoreProps): T;
 /**
- * Creates a toolbar store.
+ * Creates a toolbar store to control the state of
+ * [Toolbar](https://ariakit.org/components/toolbar) components.
  * @see https://ariakit.org/components/toolbar
  * @example
  * ```jsx
  * const toolbar = useToolbarStore();
+ *
  * <Toolbar store={toolbar}>
  *   <ToolbarItem>Item 1</ToolbarItem>
  *   <ToolbarItem>Item 2</ToolbarItem>

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

@@ -14,9 +14,9 @@ import type { TooltipStore } from "./tooltip-store.js";
  */
 export declare const useTooltipAnchor: import("../utils/types.js").Hook<TooltipAnchorOptions<"div">>;
 /**
- * Renders an element that will be described by a
- * [`Tooltip`](https://ariakit.org/reference/tooltip) component. This component
- * will also be used as the reference to position the tooltip on the screen.
+ * Renders a reference element for a
+ * [`Tooltip`](https://ariakit.org/reference/tooltip), which is triggered by
+ * focusing or hovering over the anchor.
  * @see https://ariakit.org/components/tooltip
  * @example
  * ```jsx {2}

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

@@ -14,9 +14,9 @@ import type { TooltipStore } from "./tooltip-store.js";
  */
 export declare const useTooltipAnchor: import("../utils/types.js").Hook<TooltipAnchorOptions<"div">>;
 /**
- * Renders an element that will be described by a
- * [`Tooltip`](https://ariakit.org/reference/tooltip) component. This component
- * will also be used as the reference to position the tooltip on the screen.
+ * Renders a reference element for a
+ * [`Tooltip`](https://ariakit.org/reference/tooltip), which is triggered by
+ * focusing or hovering over the anchor.
  * @see https://ariakit.org/components/tooltip
  * @example
  * ```jsx {2}

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

@@ -18,7 +18,7 @@ import type { TooltipStore } from "./tooltip-store.js";
 export declare const useTooltipArrow: import("../utils/types.js").Hook<TooltipArrowOptions<"div">>;
 /**
  * Renders an arrow inside a [`Tooltip`](https://ariakit.org/reference/tooltip)
- * component.
+ * pointing to the anchor element.
  * @see https://ariakit.org/components/tooltip
  * @example
  * ```jsx {4}

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

@@ -18,7 +18,7 @@ import type { TooltipStore } from "./tooltip-store.js";
 export declare const useTooltipArrow: import("../utils/types.js").Hook<TooltipArrowOptions<"div">>;
 /**
  * Renders an arrow inside a [`Tooltip`](https://ariakit.org/reference/tooltip)
- * component.
+ * pointing to the anchor element.
  * @see https://ariakit.org/components/tooltip
  * @example
  * ```jsx {4}

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

@@ -1,7 +1,8 @@
 import type { ReactNode } from "react";
 import type { TooltipStoreProps } from "./tooltip-store.js";
 /**
- * Provides a tooltip store to Tooltip components.
+ * Provides a tooltip store to [Tooltip](https://ariakit.org/components/tooltip)
+ * components.
  * @see https://ariakit.org/components/tooltip
  * @example
  * ```jsx

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

@@ -1,7 +1,8 @@
 import type { ReactNode } from "react";
 import type { TooltipStoreProps } from "./tooltip-store.js";
 /**
- * Provides a tooltip store to Tooltip components.
+ * Provides a tooltip store to [Tooltip](https://ariakit.org/components/tooltip)
+ * components.
  * @see https://ariakit.org/components/tooltip
  * @example
  * ```jsx

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

@@ -3,11 +3,13 @@ import type { HovercardStoreFunctions, HovercardStoreOptions, HovercardStoreStat
 import type { Store } from "../utils/store.js";
 export declare function useTooltipStoreProps<T extends TooltipStore>(store: T, update: () => void, props: TooltipStoreProps): T;
 /**
- * Creates a tooltip store.
+ * Creates a tooltip store to control the state of
+ * [Tooltip](https://ariakit.org/components/tooltip) components.
  * @see https://ariakit.org/components/tooltip
  * @example
  * ```jsx
  * const tooltip = useTooltipStore();
+ *
  * <TooltipAnchor store={tooltip}>Anchor</TooltipAnchor>
  * <Tooltip store={tooltip}>Tooltip</Tooltip>
  * ```

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

@@ -3,11 +3,13 @@ import type { HovercardStoreFunctions, HovercardStoreOptions, HovercardStoreStat
 import type { Store } from "../utils/store.js";
 export declare function useTooltipStoreProps<T extends TooltipStore>(store: T, update: () => void, props: TooltipStoreProps): T;
 /**
- * Creates a tooltip store.
+ * Creates a tooltip store to control the state of
+ * [Tooltip](https://ariakit.org/components/tooltip) components.
  * @see https://ariakit.org/components/tooltip
  * @example
  * ```jsx
  * const tooltip = useTooltipStore();
+ *
  * <TooltipAnchor store={tooltip}>Anchor</TooltipAnchor>
  * <Tooltip store={tooltip}>Tooltip</Tooltip>
  * ```