@ariakit/react-core 0.2.16 → 0.3.0

package/esm/__chunks/{ORZC42PG.js → VJZYCNOA.js}

@@ -5,12 +5,16 @@ import {
 } from "./X7FKJQME.js";
 import {
   usePopover
-} from "./CU3AKJBN.js";
+} from "./XWFU333Y.js";
+import {
+  HovercardScopedContextProvider,
+  useHovercardProviderContext
+} from "./5DA3HK6G.js";
 import {
   createComponent,
   createElement,
   createHook
-} from "./NQJBHION.js";
+} from "./CFEUKV6C.js";
 import {
   useBooleanEvent,
   useEvent,
@@ -38,7 +42,11 @@ import {
 import { contains } from "@ariakit/core/utils/dom";
 import { addGlobalEventListener } from "@ariakit/core/utils/events";
 import { hasFocusWithin } from "@ariakit/core/utils/focus";
-import { chain, isFalsyBooleanCallback } from "@ariakit/core/utils/misc";
+import {
+  chain,
+  invariant,
+  isFalsyBooleanCallback
+} from "@ariakit/core/utils/misc";
 import { sync } from "@ariakit/core/utils/store";
 import { jsx } from "react/jsx-runtime";
 function isMovingOnHovercard(target, card, anchor, nested) {
@@ -56,7 +64,11 @@ function isMovingOnHovercard(target, card, anchor, nested) {
   return false;
 }
 function useAutoFocusOnShow(_a) {
-  var _b = _a, { store } = _b, props = __objRest(_b, ["store"]);
+  var _b = _a, {
+    store
+  } = _b, props = __objRest(_b, [
+    "store"
+  ]);
   const open = store.useState("open");
   const openRef = useLiveRef(open);
   useEffect(() => {
@@ -79,7 +91,11 @@ function useAutoFocusOnShow(_a) {
   return __spreadValues({ autoFocusOnShow }, props);
 }
 function useAutoFocusOnHide(_a) {
-  var _b = _a, { store } = _b, props = __objRest(_b, ["store"]);
+  var _b = _a, {
+    store
+  } = _b, props = __objRest(_b, [
+    "store"
+  ]);
   const [autoFocusOnHide, setAutoFocusOnHide] = useState(false);
   const mounted = store.useState("mounted");
   useEffect(() => {
@@ -126,6 +142,12 @@ var useHovercard = createHook(
       "hideOnHoverOutside",
       "disablePointerEventsOnApproach"
     ]);
+    const context = useHovercardProviderContext();
+    store = store || context;
+    invariant(
+      store,
+      process.env.NODE_ENV !== "production" && "Hovercard must receive a `store` prop or be wrapped in a HovercardProvider component."
+    );
     const ref = useRef(null);
     const [nestedHovercards, setNestedHovercards] = useState([]);
     const hideTimeoutRef = useRef(0);
@@ -149,6 +171,8 @@ var useHovercard = createHook(
       if (!element)
         return;
       const onMouseMove = (event) => {
+        if (!store)
+          return;
         const { anchorElement, hideTimeout, timeout } = store.getState();
         const enterPoint = enterPointRef.current;
         const target = event.target;
@@ -177,7 +201,7 @@ var useHovercard = createHook(
           return;
         hideTimeoutRef.current = window.setTimeout(() => {
           hideTimeoutRef.current = 0;
-          store.hide();
+          store == null ? void 0 : store.hide();
         }, hideTimeout != null ? hideTimeout : timeout);
       };
       return chain(
@@ -254,8 +278,8 @@ var useHovercard = createHook(
     );
     props = useWrapElement(
       props,
-      (element) => /* @__PURE__ */ jsx(NestedHovercardContext.Provider, { value: registerNestedHovercard, children: element }),
-      [registerNestedHovercard]
+      (element) => /* @__PURE__ */ jsx(HovercardScopedContextProvider, { value: store, children: /* @__PURE__ */ jsx(NestedHovercardContext.Provider, { value: registerNestedHovercard, children: element }) }),
+      [store, registerNestedHovercard]
     );
     props = __spreadProps(__spreadValues({}, props), {
       ref: useMergeRefs(ref, props.ref)
@@ -271,7 +295,11 @@ var useHovercard = createHook(
       hideOnEscape(event) {
         if (isFalsyBooleanCallback(hideOnEscape, event))
           return false;
-        requestAnimationFrame(() => requestAnimationFrame(store.hide));
+        requestAnimationFrame(() => {
+          requestAnimationFrame(() => {
+            store == null ? void 0 : store.hide();
+          });
+        });
         return true;
       }
     }));

package/esm/__chunks/{AUUE7U2H.js → WJZPOH5E.js}

@@ -1,11 +1,14 @@
 import {
   usePopoverDisclosureArrow
-} from "./LVMO37QD.js";
+} from "./5HSRXC5S.js";
+import {
+  useSelectContext
+} from "./US4OMDIO.js";
 import {
   createComponent,
   createElement,
   createHook
-} from "./NQJBHION.js";
+} from "./CFEUKV6C.js";
 import {
   __objRest,
   __spreadValues
@@ -15,6 +18,8 @@ import {
 var useSelectArrow = createHook(
   (_a) => {
     var _b = _a, { store } = _b, props = __objRest(_b, ["store"]);
+    const context = useSelectContext();
+    store = store || context;
     props = usePopoverDisclosureArrow(__spreadValues({ store }, props));
     return props;
   }

package/esm/__chunks/{NHPU54IO.js → XASENZA4.js}

@@ -1,20 +1,20 @@
 import {
   hideElementFromAccessibilityTree
-} from "./GDORSOK6.js";
+} from "./X5VV5CBA.js";
+import {
+  supportsInert
+} from "./KOVUJERF.js";
 import {
   isBackdrop
 } from "./IXXFVVA2.js";
 import {
-  supportsInert
-} from "./KOVUJERF.js";
+  walkTreeOutside
+} from "./5M4ITSXL.js";
 import {
   assignStyle,
   setAttribute,
   setProperty
 } from "./FW6QFGFT.js";
-import {
-  walkTreeOutside
-} from "./5M4ITSXL.js";
 
 // src/dialog/utils/disable-tree-outside.ts
 import { contains } from "@ariakit/core/utils/dom";

package/esm/__chunks/{W5P7IKOU.js → XCH4OEEE.js}

@@ -1,11 +1,11 @@
 import {
-  CompositeContext
-} from "./WJ37OVG2.js";
+  useCompositeContext
+} from "./5C7J4IAS.js";
 import {
   createElement,
   createHook,
   createMemoComponent
-} from "./NQJBHION.js";
+} from "./CFEUKV6C.js";
 import {
   useBooleanEvent,
   useEvent,
@@ -18,7 +18,6 @@ import {
 } from "./PNRLI7OV.js";
 
 // src/composite/composite-hover.ts
-import { useContext } from "react";
 import { closest, contains } from "@ariakit/core/utils/dom";
 import { hasFocus, hasFocusWithin } from "@ariakit/core/utils/focus";
 import { invariant } from "@ariakit/core/utils/misc";
@@ -45,11 +44,11 @@ function movingToAnotherItem(event) {
 var useCompositeHover = createHook(
   (_a) => {
     var _b = _a, { store, focusOnHover = true } = _b, props = __objRest(_b, ["store", "focusOnHover"]);
-    const context = useContext(CompositeContext);
+    const context = useCompositeContext();
     store = store || context;
     invariant(
       store,
-      process.env.NODE_ENV !== "production" && "CompositeHover must be wrapped in a Composite component"
+      process.env.NODE_ENV !== "production" && "CompositeHover must be wrapped in a Composite component."
     );
     const isMouseMoving = useIsMouseMoving();
     const onMouseMoveProp = props.onMouseMove;

package/esm/__chunks/{VFNGSUSF.js → XIA3HAXM.js}

@@ -1,11 +1,11 @@
 import {
-  CollectionContext
-} from "./T3DJZG63.js";
+  useCollectionContext
+} from "./74KKBFVP.js";
 import {
   createComponent,
   createElement,
   createHook
-} from "./NQJBHION.js";
+} from "./CFEUKV6C.js";
 import {
   useId,
   useMergeRefs
@@ -17,7 +17,7 @@ import {
 } from "./PNRLI7OV.js";
 
 // src/collection/collection-item.ts
-import { useContext, useEffect, useRef } from "react";
+import { useEffect, useRef } from "react";
 import { identity } from "@ariakit/core/utils/misc";
 var useCollectionItem = createHook(
   (_a) => {
@@ -33,7 +33,7 @@ var useCollectionItem = createHook(
       // @ts-expect-error This prop may come from a collection renderer.
       "element"
     ]);
-    const context = useContext(CollectionContext);
+    const context = useCollectionContext();
     store = store || context;
     const id = useId(props.id);
     const ref = useRef(element);

package/esm/__chunks/{5PDNXTAR.js → XIRNSMZD.js}

@@ -1,13 +1,13 @@
 import {
-  CollectionContext
-} from "./T3DJZG63.js";
+  useCollectionContext
+} from "./74KKBFVP.js";
 import {
   createElement,
   forwardRef
-} from "./NQJBHION.js";
+} from "./CFEUKV6C.js";
 import {
   useStoreState
-} from "./QPTZ2G2N.js";
+} from "./L3AX6U5E.js";
 import {
   useBooleanEvent,
   useEvent,
@@ -303,9 +303,12 @@ function useCollectionRenderer(_a) {
     "children"
   ]);
   var _a2, _b2;
-  const context = useContext(CollectionContext);
+  const context = useCollectionContext();
   store = store || context;
-  const items = useStoreState(store, (state) => itemsProp != null ? itemsProp : state.items) || itemsProp;
+  const items = useStoreState(
+    store,
+    (state) => itemsProp != null ? itemsProp : state == null ? void 0 : state.items
+  );
   invariant(
     items != null,
     process.env.NODE_ENV !== "production" && "CollectionRenderer must be either wrapped in a Collection component or be given an `items` prop."

package/esm/__chunks/{CU3AKJBN.js → XWFU333Y.js}

@@ -1,14 +1,15 @@
 import {
   useDialog
-} from "./TG7IDXTX.js";
+} from "./D4PXCBCI.js";
 import {
-  PopoverContext
-} from "./6GS36SYX.js";
+  PopoverScopedContextProvider,
+  usePopoverProviderContext
+} from "./547DFODS.js";
 import {
   createComponent,
   createElement,
   createHook
-} from "./NQJBHION.js";
+} from "./CFEUKV6C.js";
 import {
   useEvent,
   usePortalRef,
@@ -191,6 +192,12 @@ var usePopover = createHook(
       "getAnchorRect",
       "updatePosition"
     ]);
+    const context = usePopoverProviderContext();
+    store = store || context;
+    invariant(
+      store,
+      process.env.NODE_ENV !== "production" && "Popover must receive a `store` prop or be wrapped in a PopoverProvider component."
+    );
     const arrowElement = store.useState("arrowElement");
     const anchorElement = store.useState("anchorElement");
     const popoverElement = store.useState("popoverElement");
@@ -230,7 +237,7 @@ var usePopover = createHook(
           strategy: fixed ? "fixed" : "absolute",
           middleware
         });
-        store.setState("currentPlacement", pos.placement);
+        store == null ? void 0 : store.setState("currentPlacement", pos.placement);
         setPositioned(true);
         const x = roundByDPR(pos.x);
         const y = roundByDPR(pos.y);
@@ -322,7 +329,7 @@ var usePopover = createHook(
             left: 0,
             width: "max-content"
           }, wrapperProps == null ? void 0 : wrapperProps.style),
-          ref: store.setPopoverElement,
+          ref: store == null ? void 0 : store.setPopoverElement,
           children: element
         })
       ),
@@ -330,7 +337,7 @@ var usePopover = createHook(
     );
     props = useWrapElement(
       props,
-      (element) => /* @__PURE__ */ jsx(PopoverContext.Provider, { value: store, children: element }),
+      (element) => /* @__PURE__ */ jsx(PopoverScopedContextProvider, { value: store, children: element }),
       [store]
     );
     props = __spreadProps(__spreadValues({

package/esm/__chunks/XXOVOOT3.js

@@ -0,0 +1,24 @@
+import {
+  useCompositeStoreProps
+} from "./FGP6QO3O.js";
+import {
+  useStore,
+  useStoreProps
+} from "./L3AX6U5E.js";
+
+// src/radio/radio-store.ts
+import * as Core from "@ariakit/core/radio/radio-store";
+function useRadioStoreProps(store, update, props) {
+  store = useCompositeStoreProps(store, update, props);
+  useStoreProps(store, props, "value", "setValue");
+  return store;
+}
+function useRadioStore(props = {}) {
+  const [store, update] = useStore(Core.createRadioStore, props);
+  return useRadioStoreProps(store, update, props);
+}
+
+export {
+  useRadioStoreProps,
+  useRadioStore
+};

package/esm/__chunks/{F4XABKPL.js → YVYWIVKG.js}

@@ -2,13 +2,13 @@ import {
   flipItems
 } from "./OXPV2NBK.js";
 import {
-  CompositeContext
-} from "./WJ37OVG2.js";
+  useCompositeContext
+} from "./5C7J4IAS.js";
 import {
   createComponent,
   createElement,
   createHook
-} from "./NQJBHION.js";
+} from "./CFEUKV6C.js";
 import {
   useEvent
 } from "./J7Q2EO23.js";
@@ -19,7 +19,7 @@ import {
 } from "./PNRLI7OV.js";
 
 // src/composite/composite-typeahead.ts
-import { useContext, useRef } from "react";
+import { useRef } from "react";
 import { isTextField } from "@ariakit/core/utils/dom";
 import { isSelfTarget } from "@ariakit/core/utils/events";
 import { invariant, normalizeString } from "@ariakit/core/utils/misc";
@@ -73,7 +73,7 @@ function getSameInitialItems(items, char, activeId) {
 var useCompositeTypeahead = createHook(
   (_a) => {
     var _b = _a, { store, typeahead = true } = _b, props = __objRest(_b, ["store", "typeahead"]);
-    const context = useContext(CompositeContext);
+    const context = useCompositeContext();
     store = store || context;
     invariant(
       store,

package/esm/button/button.js

@@ -1,11 +1,11 @@
 import {
   Button,
   useButton
-} from "../__chunks/O6CV6VRM.js";
-import "../__chunks/P4RGQGTG.js";
-import "../__chunks/MYID4V27.js";
+} from "../__chunks/QPWEKAWF.js";
+import "../__chunks/LND6SMHN.js";
+import "../__chunks/M4OAD5XF.js";
 import "../__chunks/BMLNRUFQ.js";
-import "../__chunks/NQJBHION.js";
+import "../__chunks/CFEUKV6C.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/checkbox/checkbox-check.js

@@ -1,9 +1,9 @@
 import {
   CheckboxCheck,
   useCheckboxCheck
-} from "../__chunks/37OBPWF6.js";
+} from "../__chunks/3Z4KAOQS.js";
 import "../__chunks/M5KYRTQG.js";
-import "../__chunks/NQJBHION.js";
+import "../__chunks/CFEUKV6C.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/checkbox/checkbox-context.d.ts

@@ -0,0 +1,19 @@
+import type { CheckboxStore } from "./checkbox-store.js";
+/**
+ * Returns the checkbox store from the nearest checkbox container.
+ * @example
+ * function Checkbox() {
+ *   const store = useCheckboxContext();
+ *
+ *   if (!store) {
+ *     throw new Error("Checkbox must be wrapped in CheckboxProvider");
+ *   }
+ *
+ *   // Use the store...
+ * }
+ */
+export declare const useCheckboxContext: () => CheckboxStore<string | number | boolean | (string | number)[]> | undefined;
+export declare const useCheckboxScopedContext: (onlyScoped?: boolean) => CheckboxStore<string | number | boolean | (string | number)[]> | undefined;
+export declare const useCheckboxProviderContext: () => CheckboxStore<string | number | boolean | (string | number)[]> | undefined;
+export declare const CheckboxContextProvider: (props: import("react").ProviderProps<CheckboxStore<string | number | boolean | (string | number)[]> | undefined>) => import("react/jsx-runtime").JSX.Element;
+export declare const CheckboxScopedContextProvider: (props: import("react").ProviderProps<CheckboxStore<string | number | boolean | (string | number)[]> | undefined>) => import("react/jsx-runtime").JSX.Element;

package/esm/checkbox/checkbox-context.js

@@ -0,0 +1,18 @@
+import {
+  CheckboxContextProvider,
+  CheckboxScopedContextProvider,
+  useCheckboxContext,
+  useCheckboxProviderContext,
+  useCheckboxScopedContext
+} from "../__chunks/ICL2YIES.js";
+import "../__chunks/CFEUKV6C.js";
+import "../__chunks/J7Q2EO23.js";
+import "../__chunks/CP3U4HPL.js";
+import "../__chunks/PNRLI7OV.js";
+export {
+  CheckboxContextProvider,
+  CheckboxScopedContextProvider,
+  useCheckboxContext,
+  useCheckboxProviderContext,
+  useCheckboxScopedContext
+};

package/esm/checkbox/checkbox-provider.d.ts

@@ -0,0 +1,29 @@
+import type { ReactElement, ReactNode } from "react";
+import type { PickRequired } from "@ariakit/core/utils/types";
+import type { CheckboxStoreProps, CheckboxStoreValue } from "./checkbox-store.js";
+type Value = CheckboxStoreValue;
+/**
+ * Provides a checkbox store to its descendants. This is useful to create a
+ * group of checkboxes that share the same store.
+ * @see https://ariakit.org/components/checkbox
+ * @example
+ * ```jsx
+ * <CheckboxProvider defaultValue={["orange"]}>
+ *   <label>
+ *     <Checkbox value="apple" /> Apple
+ *   </label>
+ *   <label>
+ *     <Checkbox value="orange" /> Orange
+ *   </label>
+ *   <label>
+ *     <Checkbox value="mango" /> Mango
+ *   </label>
+ * </CheckboxProvider>
+ * ```
+ */
+export declare function CheckboxProvider<T extends Value = Value>(props: PickRequired<CheckboxProviderProps<T>, "value" | "defaultValue">): ReactElement;
+export declare function CheckboxProvider(props?: CheckboxProviderProps): ReactElement;
+export interface CheckboxProviderProps<T extends Value = Value> extends CheckboxStoreProps<T> {
+    children?: ReactNode;
+}
+export {};

package/esm/checkbox/checkbox-provider.js

@@ -0,0 +1,21 @@
+import {
+  useCheckboxStore
+} from "../__chunks/TUPK6PWU.js";
+import {
+  CheckboxContextProvider
+} from "../__chunks/ICL2YIES.js";
+import "../__chunks/CFEUKV6C.js";
+import "../__chunks/L3AX6U5E.js";
+import "../__chunks/J7Q2EO23.js";
+import "../__chunks/CP3U4HPL.js";
+import "../__chunks/PNRLI7OV.js";
+
+// src/checkbox/checkbox-provider.tsx
+import { jsx } from "react/jsx-runtime";
+function CheckboxProvider(props = {}) {
+  const store = useCheckboxStore(props);
+  return /* @__PURE__ */ jsx(CheckboxContextProvider, { value: store, children: props.children });
+}
+export {
+  CheckboxProvider
+};

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

@@ -2,8 +2,7 @@ import * as Core from "@ariakit/core/checkbox/checkbox-store";
 import type { PickRequired } from "@ariakit/core/utils/types";
 import type { Store } from "../utils/store.js";
 type Value = Core.CheckboxStoreValue;
-export declare function useCheckboxStoreOptions(_props: CheckboxStoreProps): Partial<CheckboxStoreOptions>;
-export declare function useCheckboxStoreProps<T extends CheckboxStore>(store: T, props: CheckboxStoreProps): T;
+export declare function useCheckboxStoreProps<T extends Core.CheckboxStore>(store: T, update: () => void, props: CheckboxStoreProps): T;
 /**
  * Creates a checkbox store.
  * @see https://ariakit.org/components/checkbox

package/esm/checkbox/checkbox-store.js

@@ -1,14 +1,12 @@
 import {
   useCheckboxStore,
-  useCheckboxStoreOptions,
   useCheckboxStoreProps
-} from "../__chunks/CYNFBMYS.js";
-import "../__chunks/QPTZ2G2N.js";
+} from "../__chunks/TUPK6PWU.js";
+import "../__chunks/L3AX6U5E.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";
 export {
   useCheckboxStore,
-  useCheckboxStoreOptions,
   useCheckboxStoreProps
 };

package/esm/checkbox/checkbox.js

@@ -1,13 +1,14 @@
 import {
   Checkbox,
   useCheckbox
-} from "../__chunks/R4VIEIUH.js";
+} from "../__chunks/665VBEVH.js";
+import "../__chunks/ICL2YIES.js";
 import "../__chunks/M5KYRTQG.js";
-import "../__chunks/P4RGQGTG.js";
-import "../__chunks/MYID4V27.js";
+import "../__chunks/LND6SMHN.js";
+import "../__chunks/M4OAD5XF.js";
 import "../__chunks/BMLNRUFQ.js";
-import "../__chunks/NQJBHION.js";
-import "../__chunks/QPTZ2G2N.js";
+import "../__chunks/CFEUKV6C.js";
+import "../__chunks/L3AX6U5E.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/collection/collection-context.d.ts

@@ -1,5 +1,34 @@
 import type { CollectionStore } from "./collection-store.js";
-export declare const CollectionContext: import("react").Context<CollectionStore<{
+/**
+ * Returns the collection store from the nearest collection container.
+ * @example
+ * function CollectionItem() {
+ *   const store = useCollectionContext();
+ *
+ *   if (!store) {
+ *     throw new Error("CollectionItem must be wrapped in CollectionProvider");
+ *   }
+ *
+ *   // Use the store...
+ * }
+ */
+export declare const useCollectionContext: () => CollectionStore<{
     id: string;
     element?: HTMLElement | null | undefined;
-}> | undefined>;
+}> | undefined;
+export declare const useCollectionScopedContext: (onlyScoped?: boolean) => CollectionStore<{
+    id: string;
+    element?: HTMLElement | null | undefined;
+}> | undefined;
+export declare const useCollectionProviderContext: () => CollectionStore<{
+    id: string;
+    element?: HTMLElement | null | undefined;
+}> | undefined;
+export declare const CollectionContextProvider: (props: import("react").ProviderProps<CollectionStore<{
+    id: string;
+    element?: HTMLElement | null | undefined;
+}> | undefined>) => import("react/jsx-runtime").JSX.Element;
+export declare const CollectionScopedContextProvider: (props: import("react").ProviderProps<CollectionStore<{
+    id: string;
+    element?: HTMLElement | null | undefined;
+}> | undefined>) => import("react/jsx-runtime").JSX.Element;

package/esm/collection/collection-context.js

@@ -1,7 +1,18 @@
 import {
-  CollectionContext
-} from "../__chunks/T3DJZG63.js";
+  CollectionContextProvider,
+  CollectionScopedContextProvider,
+  useCollectionContext,
+  useCollectionProviderContext,
+  useCollectionScopedContext
+} from "../__chunks/74KKBFVP.js";
+import "../__chunks/CFEUKV6C.js";
+import "../__chunks/J7Q2EO23.js";
+import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";
 export {
-  CollectionContext
+  CollectionContextProvider,
+  CollectionScopedContextProvider,
+  useCollectionContext,
+  useCollectionProviderContext,
+  useCollectionScopedContext
 };

package/esm/collection/collection-item.js

@@ -1,9 +1,9 @@
 import {
   CollectionItem,
   useCollectionItem
-} from "../__chunks/VFNGSUSF.js";
-import "../__chunks/T3DJZG63.js";
-import "../__chunks/NQJBHION.js";
+} from "../__chunks/XIA3HAXM.js";
+import "../__chunks/74KKBFVP.js";
+import "../__chunks/CFEUKV6C.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/collection/collection-provider.d.ts

@@ -0,0 +1,22 @@
+import type { ReactElement, ReactNode } from "react";
+import type { PickRequired } from "@ariakit/core/utils/types";
+import type { CollectionStoreItem, CollectionStoreProps } from "./collection-store.js";
+type Item = CollectionStoreItem;
+/**
+ * Provides a collection store to CollectionItem components.
+ * @see https://ariakit.org/components/collection
+ * @example
+ * ```jsx
+ * <CollectionProvider>
+ *   <CollectionItem />
+ *   <CollectionItem />
+ *   <CollectionItem />
+ * </CollectionProvider>
+ * ```
+ */
+export declare function CollectionProvider<T extends Item = Item>(props: PickRequired<CollectionProviderProps<T>, "items" | "defaultItems">): ReactElement;
+export declare function CollectionProvider(props?: CollectionProviderProps): ReactElement;
+export interface CollectionProviderProps<T extends Item = Item> extends CollectionStoreProps<T> {
+    children?: ReactNode;
+}
+export {};