@ariakit/core 0.3.10 → 0.3.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (87) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/cjs/__chunks/{ZXCB7MXN.cjs → BFE5R4EZ.cjs} +17 -17
  3. package/cjs/__chunks/{Y6PHIDP6.cjs → E53JW5BD.cjs} +12 -12
  4. package/cjs/__chunks/{5CBCKBZ2.cjs → F6HPKLO2.cjs} +12 -12
  5. package/cjs/__chunks/{MFSCSSBJ.cjs → I3Y4EXEF.cjs} +2 -2
  6. package/cjs/__chunks/{3UT5FE6K.cjs → KBNYGXWI.cjs} +3 -0
  7. package/cjs/__chunks/{YLMJBIQM.cjs → MI6NUQYQ.cjs} +22 -13
  8. package/cjs/__chunks/{CWDUO5EV.cjs → NOFH2BLB.cjs} +7 -7
  9. package/cjs/__chunks/{MWNFQD55.cjs → OTVLDMN2.cjs} +16 -16
  10. package/cjs/__chunks/{HMO4CKUP.cjs → TQTGWD5K.cjs} +10 -10
  11. package/cjs/checkbox/checkbox-store.cjs +5 -5
  12. package/cjs/collection/collection-store.cjs +4 -4
  13. package/cjs/combobox/combobox-store.cjs +32 -32
  14. package/cjs/composite/composite-overflow-store.cjs +6 -6
  15. package/cjs/composite/composite-store.cjs +5 -5
  16. package/cjs/dialog/dialog-store.cjs +5 -5
  17. package/cjs/disclosure/disclosure-store.cjs +4 -4
  18. package/cjs/form/form-store.cjs +23 -23
  19. package/cjs/form/form-store.d.cts +1 -1
  20. package/cjs/form/form-store.d.ts +1 -1
  21. package/cjs/hovercard/hovercard-store.cjs +7 -7
  22. package/cjs/hovercard/hovercard-store.d.cts +14 -7
  23. package/cjs/hovercard/hovercard-store.d.ts +14 -7
  24. package/cjs/menu/menu-bar-store.cjs +6 -6
  25. package/cjs/menu/menu-store.cjs +26 -26
  26. package/cjs/menu/menu-store.d.cts +16 -7
  27. package/cjs/menu/menu-store.d.ts +16 -7
  28. package/cjs/menubar/menubar-store.cjs +6 -6
  29. package/cjs/popover/popover-store.cjs +6 -6
  30. package/cjs/popover/popover-store.d.cts +31 -6
  31. package/cjs/popover/popover-store.d.ts +31 -6
  32. package/cjs/radio/radio-store.cjs +8 -8
  33. package/cjs/radio/radio-store.d.cts +2 -1
  34. package/cjs/radio/radio-store.d.ts +2 -1
  35. package/cjs/select/select-store.cjs +28 -28
  36. package/cjs/select/select-store.d.cts +2 -1
  37. package/cjs/select/select-store.d.ts +2 -1
  38. package/cjs/tab/tab-store.cjs +20 -20
  39. package/cjs/tab/tab-store.d.cts +5 -11
  40. package/cjs/tab/tab-store.d.ts +5 -11
  41. package/cjs/toolbar/toolbar-store.cjs +7 -7
  42. package/cjs/toolbar/toolbar-store.d.cts +2 -6
  43. package/cjs/toolbar/toolbar-store.d.ts +2 -6
  44. package/cjs/tooltip/tooltip-store.cjs +12 -12
  45. package/cjs/tooltip/tooltip-store.d.cts +6 -4
  46. package/cjs/tooltip/tooltip-store.d.ts +6 -4
  47. package/cjs/utils/misc.cjs +2 -2
  48. package/cjs/utils/store.cjs +3 -3
  49. package/esm/__chunks/{MYUKSFP5.js → 22K762VQ.js} +13 -4
  50. package/esm/__chunks/{AKMSZ36N.js → AF6IUUFN.js} +3 -3
  51. package/esm/__chunks/{K6ELJFXN.js → EAHJFCU4.js} +1 -1
  52. package/esm/__chunks/{VEUNYQYR.js → IERTEJ3A.js} +3 -3
  53. package/esm/__chunks/{QJ5CUA32.js → SOLWE6E5.js} +3 -3
  54. package/esm/__chunks/{25MEC56I.js → SX2XFD6A.js} +1 -1
  55. package/esm/__chunks/{UUFF4PQ6.js → XU3EOSCU.js} +3 -3
  56. package/esm/__chunks/{I2VQ3XGR.js → Y3OOHFCN.js} +3 -0
  57. package/esm/__chunks/{L5RYKTVQ.js → Z5IGYIPT.js} +2 -2
  58. package/esm/checkbox/checkbox-store.js +2 -2
  59. package/esm/collection/collection-store.js +3 -3
  60. package/esm/combobox/combobox-store.js +7 -7
  61. package/esm/composite/composite-overflow-store.js +5 -5
  62. package/esm/composite/composite-store.js +4 -4
  63. package/esm/dialog/dialog-store.js +4 -4
  64. package/esm/disclosure/disclosure-store.js +3 -3
  65. package/esm/form/form-store.d.ts +1 -1
  66. package/esm/form/form-store.js +3 -3
  67. package/esm/hovercard/hovercard-store.d.ts +14 -7
  68. package/esm/hovercard/hovercard-store.js +6 -6
  69. package/esm/menu/menu-bar-store.js +5 -5
  70. package/esm/menu/menu-store.d.ts +16 -7
  71. package/esm/menu/menu-store.js +8 -8
  72. package/esm/menubar/menubar-store.js +5 -5
  73. package/esm/popover/popover-store.d.ts +31 -6
  74. package/esm/popover/popover-store.js +5 -5
  75. package/esm/radio/radio-store.d.ts +2 -1
  76. package/esm/radio/radio-store.js +4 -4
  77. package/esm/select/select-store.d.ts +2 -1
  78. package/esm/select/select-store.js +7 -7
  79. package/esm/tab/tab-store.d.ts +5 -11
  80. package/esm/tab/tab-store.js +4 -4
  81. package/esm/toolbar/toolbar-store.d.ts +2 -6
  82. package/esm/toolbar/toolbar-store.js +4 -4
  83. package/esm/tooltip/tooltip-store.d.ts +6 -4
  84. package/esm/tooltip/tooltip-store.js +6 -6
  85. package/esm/utils/misc.js +1 -1
  86. package/esm/utils/store.js +2 -2
  87. package/package.json +1 -1
@@ -1,14 +1,14 @@
1
1
  "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
2
2
 
3
3
 
4
- var _HMO4CKUPcjs = require('../__chunks/HMO4CKUP.cjs');
5
- require('../__chunks/Y6PHIDP6.cjs');
6
- require('../__chunks/MFSCSSBJ.cjs');
7
- require('../__chunks/MWNFQD55.cjs');
4
+ var _TQTGWD5Kcjs = require('../__chunks/TQTGWD5K.cjs');
5
+ require('../__chunks/E53JW5BD.cjs');
6
+ require('../__chunks/I3Y4EXEF.cjs');
7
+ require('../__chunks/OTVLDMN2.cjs');
8
8
 
9
9
 
10
- var _ZXCB7MXNcjs = require('../__chunks/ZXCB7MXN.cjs');
11
- require('../__chunks/YLMJBIQM.cjs');
10
+ var _BFE5R4EZcjs = require('../__chunks/BFE5R4EZ.cjs');
11
+ require('../__chunks/MI6NUQYQ.cjs');
12
12
 
13
13
 
14
14
 
@@ -17,11 +17,11 @@ require('../__chunks/YLMJBIQM.cjs');
17
17
 
18
18
 
19
19
 
20
- var _5CBCKBZ2cjs = require('../__chunks/5CBCKBZ2.cjs');
20
+ var _F6HPKLO2cjs = require('../__chunks/F6HPKLO2.cjs');
21
21
 
22
22
 
23
23
 
24
- var _3UT5FE6Kcjs = require('../__chunks/3UT5FE6K.cjs');
24
+ var _KBNYGXWIcjs = require('../__chunks/KBNYGXWI.cjs');
25
25
  require('../__chunks/5F4DVUNS.cjs');
26
26
  require('../__chunks/ULSPM3Y3.cjs');
27
27
 
@@ -42,10 +42,10 @@ function createMenuStore(_a = {}) {
42
42
  "menubar"
43
43
  ]);
44
44
  const parentIsMenubar = !!menubar && !parent;
45
- const store = _5CBCKBZ2cjs.mergeStore.call(void 0,
45
+ const store = _F6HPKLO2cjs.mergeStore.call(void 0,
46
46
  props.store,
47
- _5CBCKBZ2cjs.pick.call(void 0, parent, ["values"]),
48
- _5CBCKBZ2cjs.omit.call(void 0, combobox, [
47
+ _F6HPKLO2cjs.pick.call(void 0, parent, ["values"]),
48
+ _F6HPKLO2cjs.omit.call(void 0, combobox, [
49
49
  "arrowElement",
50
50
  "anchorElement",
51
51
  "contentElement",
@@ -53,51 +53,51 @@ function createMenuStore(_a = {}) {
53
53
  "disclosureElement"
54
54
  ])
55
55
  );
56
- _5CBCKBZ2cjs.throwOnConflictingProps.call(void 0, props, store);
56
+ _F6HPKLO2cjs.throwOnConflictingProps.call(void 0, props, store);
57
57
  const syncState = store.getState();
58
- const composite = _ZXCB7MXNcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
58
+ const composite = _BFE5R4EZcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
59
59
  store,
60
- orientation: _3UT5FE6Kcjs.defaultValue.call(void 0,
60
+ orientation: _KBNYGXWIcjs.defaultValue.call(void 0,
61
61
  props.orientation,
62
62
  syncState.orientation,
63
63
  "vertical"
64
64
  )
65
65
  }));
66
- const hovercard = _HMO4CKUPcjs.createHovercardStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
66
+ const hovercard = _TQTGWD5Kcjs.createHovercardStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
67
67
  store,
68
- placement: _3UT5FE6Kcjs.defaultValue.call(void 0,
68
+ placement: _KBNYGXWIcjs.defaultValue.call(void 0,
69
69
  props.placement,
70
70
  syncState.placement,
71
71
  "bottom-start"
72
72
  ),
73
- timeout: _3UT5FE6Kcjs.defaultValue.call(void 0,
73
+ timeout: _KBNYGXWIcjs.defaultValue.call(void 0,
74
74
  props.timeout,
75
75
  syncState.timeout,
76
76
  parentIsMenubar ? 0 : 150
77
77
  ),
78
- hideTimeout: _3UT5FE6Kcjs.defaultValue.call(void 0, props.hideTimeout, syncState.hideTimeout, 0)
78
+ hideTimeout: _KBNYGXWIcjs.defaultValue.call(void 0, props.hideTimeout, syncState.hideTimeout, 0)
79
79
  }));
80
80
  const initialState = _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, composite.getState()), hovercard.getState()), {
81
- initialFocus: _3UT5FE6Kcjs.defaultValue.call(void 0, syncState.initialFocus, "container"),
82
- values: _3UT5FE6Kcjs.defaultValue.call(void 0,
81
+ initialFocus: _KBNYGXWIcjs.defaultValue.call(void 0, syncState.initialFocus, "container"),
82
+ values: _KBNYGXWIcjs.defaultValue.call(void 0,
83
83
  props.values,
84
84
  syncState.values,
85
85
  props.defaultValues,
86
86
  {}
87
87
  )
88
88
  });
89
- const menu = _5CBCKBZ2cjs.createStore.call(void 0, initialState, composite, hovercard, store);
90
- _5CBCKBZ2cjs.setup.call(void 0,
89
+ const menu = _F6HPKLO2cjs.createStore.call(void 0, initialState, composite, hovercard, store);
90
+ _F6HPKLO2cjs.setup.call(void 0,
91
91
  menu,
92
- () => _5CBCKBZ2cjs.sync.call(void 0, menu, ["mounted"], (state) => {
92
+ () => _F6HPKLO2cjs.sync.call(void 0, menu, ["mounted"], (state) => {
93
93
  if (state.mounted)
94
94
  return;
95
95
  menu.setState("activeId", null);
96
96
  })
97
97
  );
98
- _5CBCKBZ2cjs.setup.call(void 0,
98
+ _F6HPKLO2cjs.setup.call(void 0,
99
99
  menu,
100
- () => _5CBCKBZ2cjs.sync.call(void 0, parent, ["orientation"], (state) => {
100
+ () => _F6HPKLO2cjs.sync.call(void 0, parent, ["orientation"], (state) => {
101
101
  menu.setState(
102
102
  "placement",
103
103
  state.orientation === "vertical" ? "right-start" : "bottom-start"
@@ -123,7 +123,7 @@ function createMenuStore(_a = {}) {
123
123
  return;
124
124
  menu.setState("values", (values) => {
125
125
  const prevValue = values[name];
126
- const nextValue = _3UT5FE6Kcjs.applyState.call(void 0, value, prevValue);
126
+ const nextValue = _KBNYGXWIcjs.applyState.call(void 0, value, prevValue);
127
127
  if (nextValue === prevValue)
128
128
  return values;
129
129
  return _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, values), {
@@ -13,10 +13,13 @@ export interface MenuStoreState<T extends MenuStoreValues = MenuStoreValues> ext
13
13
  */
14
14
  initialFocus: "container" | "first" | "last";
15
15
  /**
16
- * A map of names and values that will be used by the `MenuItemCheckbox` and
17
- * `MenuItemRadio` components.
16
+ * A map of names and values that will be used by the
17
+ * [`MenuItemCheckbox`](https://ariakit.org/reference/menu-item-checkbox) and
18
+ * [`MenuItemRadio`](https://ariakit.org/reference/menu-item-radio)
19
+ * components.
18
20
  *
19
21
  * Live examples:
22
+ * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
20
23
  * - [Submenu with
21
24
  * Combobox](https://ariakit.org/examples/menu-nested-combobox)
22
25
  */
@@ -42,7 +45,8 @@ export interface MenuStoreFunctions<T extends MenuStoreValues = MenuStoreValues>
42
45
  */
43
46
  setInitialFocus: SetState<MenuStoreState<T>["initialFocus"]>;
44
47
  /**
45
- * Sets the `values` state.
48
+ * Sets the [`values`](https://ariakit.org/reference/menu-provider#values)
49
+ * state.
46
50
  * @example
47
51
  * store.setValues({ watching: ["issues"] });
48
52
  * store.setValues((values) => ({ ...values, watching: ["issues"] }));
@@ -68,16 +72,21 @@ export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> e
68
72
  */
69
73
  combobox?: ComboboxStore | null;
70
74
  /**
71
- * A reference to a parent menu store. This should be used on nested menus.
75
+ * A reference to a parent menu store. This is used on nested menus.
72
76
  */
73
77
  parent?: MenuStore | null;
74
78
  /**
75
- * A reference to a menu bar store. This should be used when rendering menus
76
- * inside a menu bar.
79
+ * A reference to a menubar store. This is used when rendering menus inside a
80
+ * menubar.
77
81
  */
78
82
  menubar?: MenuBarStore | null;
79
83
  /**
80
- * The default values for the `values` state.
84
+ * The default values for the
85
+ * [`values`](https://ariakit.org/reference/menu-provider#values) state.
86
+ *
87
+ * Live examples:
88
+ * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
89
+ * - [MenuItemRadio](https://ariakit.org/examples/menu-item-radio)
81
90
  * @default {}
82
91
  */
83
92
  defaultValues?: MenuStoreState<T>["values"];
@@ -13,10 +13,13 @@ export interface MenuStoreState<T extends MenuStoreValues = MenuStoreValues> ext
13
13
  */
14
14
  initialFocus: "container" | "first" | "last";
15
15
  /**
16
- * A map of names and values that will be used by the `MenuItemCheckbox` and
17
- * `MenuItemRadio` components.
16
+ * A map of names and values that will be used by the
17
+ * [`MenuItemCheckbox`](https://ariakit.org/reference/menu-item-checkbox) and
18
+ * [`MenuItemRadio`](https://ariakit.org/reference/menu-item-radio)
19
+ * components.
18
20
  *
19
21
  * Live examples:
22
+ * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
20
23
  * - [Submenu with
21
24
  * Combobox](https://ariakit.org/examples/menu-nested-combobox)
22
25
  */
@@ -42,7 +45,8 @@ export interface MenuStoreFunctions<T extends MenuStoreValues = MenuStoreValues>
42
45
  */
43
46
  setInitialFocus: SetState<MenuStoreState<T>["initialFocus"]>;
44
47
  /**
45
- * Sets the `values` state.
48
+ * Sets the [`values`](https://ariakit.org/reference/menu-provider#values)
49
+ * state.
46
50
  * @example
47
51
  * store.setValues({ watching: ["issues"] });
48
52
  * store.setValues((values) => ({ ...values, watching: ["issues"] }));
@@ -68,16 +72,21 @@ export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> e
68
72
  */
69
73
  combobox?: ComboboxStore | null;
70
74
  /**
71
- * A reference to a parent menu store. This should be used on nested menus.
75
+ * A reference to a parent menu store. This is used on nested menus.
72
76
  */
73
77
  parent?: MenuStore | null;
74
78
  /**
75
- * A reference to a menu bar store. This should be used when rendering menus
76
- * inside a menu bar.
79
+ * A reference to a menubar store. This is used when rendering menus inside a
80
+ * menubar.
77
81
  */
78
82
  menubar?: MenuBarStore | null;
79
83
  /**
80
- * The default values for the `values` state.
84
+ * The default values for the
85
+ * [`values`](https://ariakit.org/reference/menu-provider#values) state.
86
+ *
87
+ * Live examples:
88
+ * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
89
+ * - [MenuItemRadio](https://ariakit.org/examples/menu-item-radio)
81
90
  * @default {}
82
91
  */
83
92
  defaultValues?: MenuStoreState<T>["values"];
@@ -1,14 +1,14 @@
1
1
  "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
2
2
 
3
3
 
4
- var _CWDUO5EVcjs = require('../__chunks/CWDUO5EV.cjs');
5
- require('../__chunks/ZXCB7MXN.cjs');
6
- require('../__chunks/YLMJBIQM.cjs');
7
- require('../__chunks/5CBCKBZ2.cjs');
8
- require('../__chunks/3UT5FE6K.cjs');
4
+ var _NOFH2BLBcjs = require('../__chunks/NOFH2BLB.cjs');
5
+ require('../__chunks/BFE5R4EZ.cjs');
6
+ require('../__chunks/MI6NUQYQ.cjs');
7
+ require('../__chunks/F6HPKLO2.cjs');
8
+ require('../__chunks/KBNYGXWI.cjs');
9
9
  require('../__chunks/5F4DVUNS.cjs');
10
10
  require('../__chunks/ULSPM3Y3.cjs');
11
11
  require('../__chunks/AV6KTKLE.cjs');
12
12
 
13
13
 
14
- exports.createMenubarStore = _CWDUO5EVcjs.createMenubarStore;
14
+ exports.createMenubarStore = _NOFH2BLBcjs.createMenubarStore;
@@ -1,12 +1,12 @@
1
1
  "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
2
2
 
3
3
 
4
- var _Y6PHIDP6cjs = require('../__chunks/Y6PHIDP6.cjs');
5
- require('../__chunks/MFSCSSBJ.cjs');
6
- require('../__chunks/MWNFQD55.cjs');
7
- require('../__chunks/5CBCKBZ2.cjs');
8
- require('../__chunks/3UT5FE6K.cjs');
4
+ var _E53JW5BDcjs = require('../__chunks/E53JW5BD.cjs');
5
+ require('../__chunks/I3Y4EXEF.cjs');
6
+ require('../__chunks/OTVLDMN2.cjs');
7
+ require('../__chunks/F6HPKLO2.cjs');
8
+ require('../__chunks/KBNYGXWI.cjs');
9
9
  require('../__chunks/AV6KTKLE.cjs');
10
10
 
11
11
 
12
- exports.createPopoverStore = _Y6PHIDP6cjs.createPopoverStore;
12
+ exports.createPopoverStore = _E53JW5BDcjs.createPopoverStore;
@@ -10,10 +10,18 @@ export declare function createPopoverStore({ popover: otherPopover, ...props }?:
10
10
  export interface PopoverStoreState extends DialogStoreState {
11
11
  /**
12
12
  * The anchor element.
13
+ *
14
+ * Live examples:
15
+ * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
13
16
  */
14
17
  anchorElement: HTMLElement | null;
15
18
  /**
16
19
  * The popover element that will render the placement attributes.
20
+ *
21
+ * Live examples:
22
+ * - [Form with Select](https://ariakit.org/examples/form-select)
23
+ * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
24
+ * - [Responsive Popover](https://ariakit.org/examples/popover-responsive)
17
25
  */
18
26
  popoverElement: HTMLElement | null;
19
27
  /**
@@ -21,30 +29,42 @@ export interface PopoverStoreState extends DialogStoreState {
21
29
  */
22
30
  arrowElement: HTMLElement | null;
23
31
  /**
24
- * The current temporary placement state of the popover. This may be different
25
- * from the the `placement` state if the popover has needed to update its
26
- * position on the fly.
32
+ * The current temporary position of the popover. This might differ from the
33
+ * [`placement`](https://ariakit.org/reference/popover-provider#placement)
34
+ * state if the popover has had to adjust its position dynamically.
35
+ *
36
+ * Live examples:
37
+ * - [Tooltip with Framer
38
+ * Motion](https://ariakit.org/examples/tooltip-framer-motion)
27
39
  */
28
40
  currentPlacement: Placement;
29
41
  /**
30
42
  * The placement of the popover.
31
43
  *
32
44
  * Live examples:
33
- * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
34
45
  * - [Submenu with
35
46
  * Combobox](https://ariakit.org/examples/menu-nested-combobox)
47
+ * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
48
+ * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
49
+ * - [Selection Popover](https://ariakit.org/examples/popover-selection)
50
+ * - [Standalone Popover](https://ariakit.org/examples/popover-standalone)
51
+ * - [Select Grid](https://ariakit.org/examples/select-grid)
36
52
  * @default "bottom"
37
53
  */
38
54
  placement: Placement;
39
55
  /**
40
- * A symbol that's used to recompute the popover position when the `render`
41
- * method is called.
56
+ * A symbol that's used to recompute the popover position when the
57
+ * [`render`](https://ariakit.org/reference/use-popover-store#render) method
58
+ * is called.
42
59
  */
43
60
  rendered: symbol;
44
61
  }
45
62
  export interface PopoverStoreFunctions extends DialogStoreFunctions {
46
63
  /**
47
64
  * Sets the anchor element.
65
+ *
66
+ * Live examples:
67
+ * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
48
68
  */
49
69
  setAnchorElement: SetState<PopoverStoreState["anchorElement"]>;
50
70
  /**
@@ -59,6 +79,11 @@ export interface PopoverStoreFunctions extends DialogStoreFunctions {
59
79
  * A function that can be used to recompute the popover position. This is
60
80
  * useful when the popover anchor changes in a way that affects the popover
61
81
  * position.
82
+ *
83
+ * Live examples:
84
+ * - [Textarea with inline
85
+ * Combobox](https://ariakit.org/examples/combobox-textarea)
86
+ * - [Selection Popover](https://ariakit.org/examples/popover-selection)
62
87
  */
63
88
  render: () => void;
64
89
  }
@@ -10,10 +10,18 @@ export declare function createPopoverStore({ popover: otherPopover, ...props }?:
10
10
  export interface PopoverStoreState extends DialogStoreState {
11
11
  /**
12
12
  * The anchor element.
13
+ *
14
+ * Live examples:
15
+ * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
13
16
  */
14
17
  anchorElement: HTMLElement | null;
15
18
  /**
16
19
  * The popover element that will render the placement attributes.
20
+ *
21
+ * Live examples:
22
+ * - [Form with Select](https://ariakit.org/examples/form-select)
23
+ * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
24
+ * - [Responsive Popover](https://ariakit.org/examples/popover-responsive)
17
25
  */
18
26
  popoverElement: HTMLElement | null;
19
27
  /**
@@ -21,30 +29,42 @@ export interface PopoverStoreState extends DialogStoreState {
21
29
  */
22
30
  arrowElement: HTMLElement | null;
23
31
  /**
24
- * The current temporary placement state of the popover. This may be different
25
- * from the the `placement` state if the popover has needed to update its
26
- * position on the fly.
32
+ * The current temporary position of the popover. This might differ from the
33
+ * [`placement`](https://ariakit.org/reference/popover-provider#placement)
34
+ * state if the popover has had to adjust its position dynamically.
35
+ *
36
+ * Live examples:
37
+ * - [Tooltip with Framer
38
+ * Motion](https://ariakit.org/examples/tooltip-framer-motion)
27
39
  */
28
40
  currentPlacement: Placement;
29
41
  /**
30
42
  * The placement of the popover.
31
43
  *
32
44
  * Live examples:
33
- * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
34
45
  * - [Submenu with
35
46
  * Combobox](https://ariakit.org/examples/menu-nested-combobox)
47
+ * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
48
+ * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
49
+ * - [Selection Popover](https://ariakit.org/examples/popover-selection)
50
+ * - [Standalone Popover](https://ariakit.org/examples/popover-standalone)
51
+ * - [Select Grid](https://ariakit.org/examples/select-grid)
36
52
  * @default "bottom"
37
53
  */
38
54
  placement: Placement;
39
55
  /**
40
- * A symbol that's used to recompute the popover position when the `render`
41
- * method is called.
56
+ * A symbol that's used to recompute the popover position when the
57
+ * [`render`](https://ariakit.org/reference/use-popover-store#render) method
58
+ * is called.
42
59
  */
43
60
  rendered: symbol;
44
61
  }
45
62
  export interface PopoverStoreFunctions extends DialogStoreFunctions {
46
63
  /**
47
64
  * Sets the anchor element.
65
+ *
66
+ * Live examples:
67
+ * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
48
68
  */
49
69
  setAnchorElement: SetState<PopoverStoreState["anchorElement"]>;
50
70
  /**
@@ -59,6 +79,11 @@ export interface PopoverStoreFunctions extends DialogStoreFunctions {
59
79
  * A function that can be used to recompute the popover position. This is
60
80
  * useful when the popover anchor changes in a way that affects the popover
61
81
  * position.
82
+ *
83
+ * Live examples:
84
+ * - [Textarea with inline
85
+ * Combobox](https://ariakit.org/examples/combobox-textarea)
86
+ * - [Selection Popover](https://ariakit.org/examples/popover-selection)
62
87
  */
63
88
  render: () => void;
64
89
  }
@@ -1,14 +1,14 @@
1
1
  "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
2
2
 
3
3
 
4
- var _ZXCB7MXNcjs = require('../__chunks/ZXCB7MXN.cjs');
5
- require('../__chunks/YLMJBIQM.cjs');
4
+ var _BFE5R4EZcjs = require('../__chunks/BFE5R4EZ.cjs');
5
+ require('../__chunks/MI6NUQYQ.cjs');
6
6
 
7
7
 
8
- var _5CBCKBZ2cjs = require('../__chunks/5CBCKBZ2.cjs');
8
+ var _F6HPKLO2cjs = require('../__chunks/F6HPKLO2.cjs');
9
9
 
10
10
 
11
- var _3UT5FE6Kcjs = require('../__chunks/3UT5FE6K.cjs');
11
+ var _KBNYGXWIcjs = require('../__chunks/KBNYGXWI.cjs');
12
12
  require('../__chunks/5F4DVUNS.cjs');
13
13
  require('../__chunks/ULSPM3Y3.cjs');
14
14
 
@@ -22,18 +22,18 @@ function createRadioStore(_a = {}) {
22
22
  var props = _AV6KTKLEcjs.__objRest.call(void 0, _a, []);
23
23
  var _a2;
24
24
  const syncState = (_a2 = props.store) == null ? void 0 : _a2.getState();
25
- const composite = _ZXCB7MXNcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
26
- focusLoop: _3UT5FE6Kcjs.defaultValue.call(void 0, props.focusLoop, syncState == null ? void 0 : syncState.focusLoop, true)
25
+ const composite = _BFE5R4EZcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
26
+ focusLoop: _KBNYGXWIcjs.defaultValue.call(void 0, props.focusLoop, syncState == null ? void 0 : syncState.focusLoop, true)
27
27
  }));
28
28
  const initialState = _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, composite.getState()), {
29
- value: _3UT5FE6Kcjs.defaultValue.call(void 0,
29
+ value: _KBNYGXWIcjs.defaultValue.call(void 0,
30
30
  props.value,
31
31
  syncState == null ? void 0 : syncState.value,
32
32
  props.defaultValue,
33
33
  null
34
34
  )
35
35
  });
36
- const radio = _5CBCKBZ2cjs.createStore.call(void 0, initialState, composite, props.store);
36
+ const radio = _F6HPKLO2cjs.createStore.call(void 0, initialState, composite, props.store);
37
37
  return _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, composite), radio), {
38
38
  setValue: (value) => radio.setState("value", value)
39
39
  });
@@ -18,7 +18,8 @@ export interface RadioStoreState extends CompositeStoreState {
18
18
  }
19
19
  export interface RadioStoreFunctions extends CompositeStoreFunctions {
20
20
  /**
21
- * Sets the `value` state.
21
+ * Sets the [`value`](https://ariakit.org/reference/radio-provider#value)
22
+ * state.
22
23
  * @example
23
24
  * store.setValue("apple");
24
25
  * store.setValue((value) => value === "apple" ? "orange" : "apple");
@@ -18,7 +18,8 @@ export interface RadioStoreState extends CompositeStoreState {
18
18
  }
19
19
  export interface RadioStoreFunctions extends CompositeStoreFunctions {
20
20
  /**
21
- * Sets the `value` state.
21
+ * Sets the [`value`](https://ariakit.org/reference/radio-provider#value)
22
+ * state.
22
23
  * @example
23
24
  * store.setValue("apple");
24
25
  * store.setValue((value) => value === "apple" ? "orange" : "apple");
@@ -1,13 +1,13 @@
1
1
  "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
2
2
 
3
3
 
4
- var _Y6PHIDP6cjs = require('../__chunks/Y6PHIDP6.cjs');
5
- require('../__chunks/MFSCSSBJ.cjs');
6
- require('../__chunks/MWNFQD55.cjs');
4
+ var _E53JW5BDcjs = require('../__chunks/E53JW5BD.cjs');
5
+ require('../__chunks/I3Y4EXEF.cjs');
6
+ require('../__chunks/OTVLDMN2.cjs');
7
7
 
8
8
 
9
- var _ZXCB7MXNcjs = require('../__chunks/ZXCB7MXN.cjs');
10
- require('../__chunks/YLMJBIQM.cjs');
9
+ var _BFE5R4EZcjs = require('../__chunks/BFE5R4EZ.cjs');
10
+ require('../__chunks/MI6NUQYQ.cjs');
11
11
 
12
12
 
13
13
 
@@ -16,10 +16,10 @@ require('../__chunks/YLMJBIQM.cjs');
16
16
 
17
17
 
18
18
 
19
- var _5CBCKBZ2cjs = require('../__chunks/5CBCKBZ2.cjs');
19
+ var _F6HPKLO2cjs = require('../__chunks/F6HPKLO2.cjs');
20
20
 
21
21
 
22
- var _3UT5FE6Kcjs = require('../__chunks/3UT5FE6K.cjs');
22
+ var _KBNYGXWIcjs = require('../__chunks/KBNYGXWI.cjs');
23
23
  require('../__chunks/5F4DVUNS.cjs');
24
24
 
25
25
 
@@ -37,9 +37,9 @@ function createSelectStore(_a = {}) {
37
37
  } = _b, props = _AV6KTKLEcjs.__objRest.call(void 0, _b, [
38
38
  "combobox"
39
39
  ]);
40
- const store = _5CBCKBZ2cjs.mergeStore.call(void 0,
40
+ const store = _F6HPKLO2cjs.mergeStore.call(void 0,
41
41
  props.store,
42
- _5CBCKBZ2cjs.omit.call(void 0, combobox, [
42
+ _F6HPKLO2cjs.omit.call(void 0, combobox, [
43
43
  "value",
44
44
  "items",
45
45
  "renderedItems",
@@ -51,35 +51,35 @@ function createSelectStore(_a = {}) {
51
51
  "disclosureElement"
52
52
  ])
53
53
  );
54
- _5CBCKBZ2cjs.throwOnConflictingProps.call(void 0, props, store);
54
+ _F6HPKLO2cjs.throwOnConflictingProps.call(void 0, props, store);
55
55
  const syncState = store.getState();
56
- const composite = _ZXCB7MXNcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
56
+ const composite = _BFE5R4EZcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
57
57
  store,
58
- virtualFocus: _3UT5FE6Kcjs.defaultValue.call(void 0,
58
+ virtualFocus: _KBNYGXWIcjs.defaultValue.call(void 0,
59
59
  props.virtualFocus,
60
60
  syncState.virtualFocus,
61
61
  true
62
62
  ),
63
- includesBaseElement: _3UT5FE6Kcjs.defaultValue.call(void 0,
63
+ includesBaseElement: _KBNYGXWIcjs.defaultValue.call(void 0,
64
64
  props.includesBaseElement,
65
65
  syncState.includesBaseElement,
66
66
  false
67
67
  ),
68
- activeId: _3UT5FE6Kcjs.defaultValue.call(void 0,
68
+ activeId: _KBNYGXWIcjs.defaultValue.call(void 0,
69
69
  props.activeId,
70
70
  syncState.activeId,
71
71
  props.defaultActiveId,
72
72
  null
73
73
  ),
74
- orientation: _3UT5FE6Kcjs.defaultValue.call(void 0,
74
+ orientation: _KBNYGXWIcjs.defaultValue.call(void 0,
75
75
  props.orientation,
76
76
  syncState.orientation,
77
77
  "vertical"
78
78
  )
79
79
  }));
80
- const popover = _Y6PHIDP6cjs.createPopoverStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
80
+ const popover = _E53JW5BDcjs.createPopoverStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
81
81
  store,
82
- placement: _3UT5FE6Kcjs.defaultValue.call(void 0,
82
+ placement: _KBNYGXWIcjs.defaultValue.call(void 0,
83
83
  props.placement,
84
84
  syncState.placement,
85
85
  "bottom-start"
@@ -87,24 +87,24 @@ function createSelectStore(_a = {}) {
87
87
  }));
88
88
  const initialValue = new String("");
89
89
  const initialState = _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, composite.getState()), popover.getState()), {
90
- value: _3UT5FE6Kcjs.defaultValue.call(void 0,
90
+ value: _KBNYGXWIcjs.defaultValue.call(void 0,
91
91
  props.value,
92
92
  syncState.value,
93
93
  props.defaultValue,
94
94
  initialValue
95
95
  ),
96
- setValueOnMove: _3UT5FE6Kcjs.defaultValue.call(void 0,
96
+ setValueOnMove: _KBNYGXWIcjs.defaultValue.call(void 0,
97
97
  props.setValueOnMove,
98
98
  syncState.setValueOnMove,
99
99
  false
100
100
  ),
101
- selectElement: _3UT5FE6Kcjs.defaultValue.call(void 0, syncState.selectElement, null),
102
- labelElement: _3UT5FE6Kcjs.defaultValue.call(void 0, syncState.labelElement, null)
101
+ selectElement: _KBNYGXWIcjs.defaultValue.call(void 0, syncState.selectElement, null),
102
+ labelElement: _KBNYGXWIcjs.defaultValue.call(void 0, syncState.labelElement, null)
103
103
  });
104
- const select = _5CBCKBZ2cjs.createStore.call(void 0, initialState, composite, popover, store);
105
- _5CBCKBZ2cjs.setup.call(void 0,
104
+ const select = _F6HPKLO2cjs.createStore.call(void 0, initialState, composite, popover, store);
105
+ _F6HPKLO2cjs.setup.call(void 0,
106
106
  select,
107
- () => _5CBCKBZ2cjs.sync.call(void 0, select, ["value", "items"], (state) => {
107
+ () => _F6HPKLO2cjs.sync.call(void 0, select, ["value", "items"], (state) => {
108
108
  if (state.value !== initialValue)
109
109
  return;
110
110
  if (!state.items.length)
@@ -117,9 +117,9 @@ function createSelectStore(_a = {}) {
117
117
  select.setState("value", item.value);
118
118
  })
119
119
  );
120
- _5CBCKBZ2cjs.setup.call(void 0,
120
+ _F6HPKLO2cjs.setup.call(void 0,
121
121
  select,
122
- () => _5CBCKBZ2cjs.sync.call(void 0, select, ["mounted", "items", "value"], (state) => {
122
+ () => _F6HPKLO2cjs.sync.call(void 0, select, ["mounted", "items", "value"], (state) => {
123
123
  if (combobox)
124
124
  return;
125
125
  if (state.mounted)
@@ -136,9 +136,9 @@ function createSelectStore(_a = {}) {
136
136
  select.setState("activeId", item.id);
137
137
  })
138
138
  );
139
- _5CBCKBZ2cjs.setup.call(void 0,
139
+ _F6HPKLO2cjs.setup.call(void 0,
140
140
  select,
141
- () => _5CBCKBZ2cjs.batch.call(void 0, select, ["setValueOnMove", "moves"], (state) => {
141
+ () => _F6HPKLO2cjs.batch.call(void 0, select, ["setValueOnMove", "moves"], (state) => {
142
142
  const { mounted, value, activeId } = select.getState();
143
143
  if (!state.setValueOnMove && mounted)
144
144
  return;
@@ -60,7 +60,8 @@ export interface SelectStoreState<T extends SelectStoreValue = SelectStoreValue>
60
60
  }
61
61
  export interface SelectStoreFunctions<T extends SelectStoreValue = SelectStoreValue> extends Pick<SelectStoreOptions<T>, "combobox">, CompositeStoreFunctions<SelectStoreItem>, PopoverStoreFunctions {
62
62
  /**
63
- * Sets the `value` state.
63
+ * Sets the [`value`](https://ariakit.org/reference/select-provider#value)
64
+ * state.
64
65
  * @example
65
66
  * store.setValue("Apple");
66
67
  * store.setValue(["Apple", "Banana"]);