@bazza-ui/react 0.1.0-canary.16 → 0.1.0-canary.17

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 (150) hide show
  1. package/dist/combobox/index.cjs +1 -1
  2. package/dist/combobox/index.cjs.map +1 -1
  3. package/dist/combobox/index.d.ts +842 -834
  4. package/dist/combobox/index.js +1 -1
  5. package/dist/combobox/index.js.map +1 -1
  6. package/dist/command-menu/index.cjs +1 -1
  7. package/dist/command-menu/index.cjs.map +1 -1
  8. package/dist/command-menu/index.d.ts +123 -96
  9. package/dist/command-menu/index.js +1 -1
  10. package/dist/command-menu/index.js.map +1 -1
  11. package/dist/context-menu/index.cjs +1 -1
  12. package/dist/context-menu/index.cjs.map +1 -1
  13. package/dist/context-menu/index.d.ts +701 -658
  14. package/dist/context-menu/index.js +1 -1
  15. package/dist/context-menu/index.js.map +1 -1
  16. package/dist/dropdown-menu/index.cjs +1 -1
  17. package/dist/dropdown-menu/index.cjs.map +1 -1
  18. package/dist/dropdown-menu/index.d.ts +723 -680
  19. package/dist/dropdown-menu/index.js +1 -1
  20. package/dist/dropdown-menu/index.js.map +1 -1
  21. package/dist/events-DDOsDu4X.d.ts +2091 -0
  22. package/dist/index-Cabqj7qI.d.ts +2003 -0
  23. package/dist/index-D8OrKThQ.d.ts +977 -0
  24. package/dist/internal/listbox/index.cjs +1 -2
  25. package/dist/internal/listbox/index.d.ts +2 -272
  26. package/dist/internal/listbox/index.js +1 -2
  27. package/dist/internal/popup-menu/index.cjs +1 -2
  28. package/dist/internal/popup-menu/index.d.ts +4 -238
  29. package/dist/internal/popup-menu/index.js +1 -2
  30. package/dist/items-CD2hw6-3.js +2 -0
  31. package/dist/items-CD2hw6-3.js.map +1 -0
  32. package/dist/items-DYDljwnt.cjs +2 -0
  33. package/dist/items-DYDljwnt.cjs.map +1 -0
  34. package/dist/{items-B6HeFO_8.d.cts → items-ceX--VIv.d.ts} +21 -19
  35. package/dist/kbd/index.cjs +1 -1
  36. package/dist/kbd/index.cjs.map +1 -1
  37. package/dist/kbd/index.d.ts +35 -35
  38. package/dist/kbd/index.js +1 -1
  39. package/dist/kbd/index.js.map +1 -1
  40. package/dist/listbox-CnwUlLZA.js +2 -0
  41. package/dist/listbox-CnwUlLZA.js.map +1 -0
  42. package/dist/listbox-DYvJTiF6.cjs +2 -0
  43. package/dist/listbox-DYvJTiF6.cjs.map +1 -0
  44. package/dist/loaders/index.cjs +1 -1
  45. package/dist/loaders/index.cjs.map +1 -1
  46. package/dist/loaders/index.d.ts +218 -188
  47. package/dist/loaders/index.js +1 -1
  48. package/dist/loaders/index.js.map +1 -1
  49. package/dist/merge-element-props-0mpNO7ZH.cjs +2 -0
  50. package/dist/merge-element-props-0mpNO7ZH.cjs.map +1 -0
  51. package/dist/merge-element-props-PxUvRHax.js +2 -0
  52. package/dist/merge-element-props-PxUvRHax.js.map +1 -0
  53. package/dist/platform-C-sxBTRa.cjs +2 -0
  54. package/dist/platform-C-sxBTRa.cjs.map +1 -0
  55. package/dist/platform-C4_cGUkS.js +2 -0
  56. package/dist/platform-C4_cGUkS.js.map +1 -0
  57. package/dist/popup-menu-BBAzAXIe.cjs +2 -0
  58. package/dist/popup-menu-BBAzAXIe.cjs.map +1 -0
  59. package/dist/popup-menu-HmBMJEZc.js +2 -0
  60. package/dist/popup-menu-HmBMJEZc.js.map +1 -0
  61. package/dist/resolve-state-props-C-zbhdXd.cjs +2 -0
  62. package/dist/resolve-state-props-C-zbhdXd.cjs.map +1 -0
  63. package/dist/resolve-state-props-D31kizRZ.js +2 -0
  64. package/dist/resolve-state-props-D31kizRZ.js.map +1 -0
  65. package/dist/rolldown-runtime-5lHFv1cW.cjs +1 -0
  66. package/dist/rolldown-runtime-DK3Fl9T5.js +1 -0
  67. package/dist/select/index.cjs +1 -1
  68. package/dist/select/index.cjs.map +1 -1
  69. package/dist/select/index.d.ts +835 -828
  70. package/dist/select/index.js +1 -1
  71. package/dist/select/index.js.map +1 -1
  72. package/dist/suggestion-menu/index.cjs +4 -0
  73. package/dist/suggestion-menu/index.cjs.map +1 -0
  74. package/dist/suggestion-menu/index.d.ts +359 -0
  75. package/dist/suggestion-menu/index.js +4 -0
  76. package/dist/suggestion-menu/index.js.map +1 -0
  77. package/dist/types-BbN28E3_.d.ts +50 -0
  78. package/dist/video-player/index.cjs +2 -2
  79. package/dist/video-player/index.cjs.map +1 -1
  80. package/dist/video-player/index.d.ts +964 -1000
  81. package/dist/video-player/index.js +2 -2
  82. package/dist/video-player/index.js.map +1 -1
  83. package/package.json +14 -5
  84. package/dist/ListboxStore-B8oTpM57.d.cts +0 -453
  85. package/dist/ListboxStore-CV5vPUUc.d.ts +0 -453
  86. package/dist/chunk-3HMQLMSF.js +0 -2
  87. package/dist/chunk-3HMQLMSF.js.map +0 -1
  88. package/dist/chunk-4C666HHU.js +0 -2
  89. package/dist/chunk-4C666HHU.js.map +0 -1
  90. package/dist/chunk-5T5B5SPR.cjs +0 -2
  91. package/dist/chunk-5T5B5SPR.cjs.map +0 -1
  92. package/dist/chunk-A4Z5BY7H.js +0 -2
  93. package/dist/chunk-A4Z5BY7H.js.map +0 -1
  94. package/dist/chunk-IT372NHF.js +0 -2
  95. package/dist/chunk-IT372NHF.js.map +0 -1
  96. package/dist/chunk-JFEVUUPC.cjs +0 -2
  97. package/dist/chunk-JFEVUUPC.cjs.map +0 -1
  98. package/dist/chunk-KO3DXT3Y.js +0 -2
  99. package/dist/chunk-KO3DXT3Y.js.map +0 -1
  100. package/dist/chunk-LXXK4S4Q.js +0 -2
  101. package/dist/chunk-LXXK4S4Q.js.map +0 -1
  102. package/dist/chunk-M4G6J7DP.cjs +0 -2
  103. package/dist/chunk-M4G6J7DP.cjs.map +0 -1
  104. package/dist/chunk-MPPIEWSL.js +0 -2
  105. package/dist/chunk-MPPIEWSL.js.map +0 -1
  106. package/dist/chunk-PCNHYMD6.cjs +0 -2
  107. package/dist/chunk-PCNHYMD6.cjs.map +0 -1
  108. package/dist/chunk-RTG6U56O.cjs +0 -2
  109. package/dist/chunk-RTG6U56O.cjs.map +0 -1
  110. package/dist/chunk-SCDHQZFI.cjs +0 -2
  111. package/dist/chunk-SCDHQZFI.cjs.map +0 -1
  112. package/dist/chunk-XMZZ62VJ.cjs +0 -2
  113. package/dist/chunk-XMZZ62VJ.cjs.map +0 -1
  114. package/dist/combobox/index.d.cts +0 -1066
  115. package/dist/command-menu/index.d.cts +0 -154
  116. package/dist/command-score-CTJ9NV6n.d.cts +0 -23
  117. package/dist/command-score-CTJ9NV6n.d.ts +0 -23
  118. package/dist/context-menu/index.d.cts +0 -696
  119. package/dist/dropdown-menu/index.d.cts +0 -723
  120. package/dist/events-BTHQ2OoH.d.ts +0 -1860
  121. package/dist/events-DVcrtGe3.d.cts +0 -1860
  122. package/dist/input-C95v6jB0.d.cts +0 -46
  123. package/dist/input-CYweYB_i.d.ts +0 -46
  124. package/dist/internal/listbox/index.cjs.map +0 -1
  125. package/dist/internal/listbox/index.d.cts +0 -272
  126. package/dist/internal/listbox/index.js.map +0 -1
  127. package/dist/internal/popup-menu/index.cjs.map +0 -1
  128. package/dist/internal/popup-menu/index.d.cts +0 -238
  129. package/dist/internal/popup-menu/index.js.map +0 -1
  130. package/dist/items-B6HeFO_8.d.ts +0 -37
  131. package/dist/kbd/index.d.cts +0 -61
  132. package/dist/loaders/index.d.cts +0 -363
  133. package/dist/loading-C6WZGUc3.d.cts +0 -29
  134. package/dist/loading-CC4n55sR.d.ts +0 -29
  135. package/dist/resolve-B-j0eW24.d.cts +0 -406
  136. package/dist/resolve-B1F-a3P1.d.ts +0 -406
  137. package/dist/scroll-arrow-BBoKckL_.d.cts +0 -544
  138. package/dist/scroll-arrow-fl3B5sVO.d.ts +0 -544
  139. package/dist/select/index.d.cts +0 -1005
  140. package/dist/separator-Dn15rte3.d.ts +0 -275
  141. package/dist/separator-NjsBVzek.d.cts +0 -275
  142. package/dist/surface-context-CGLDpMej.d.ts +0 -14
  143. package/dist/surface-context-CN4Lb_6F.d.cts +0 -14
  144. package/dist/type-guards-BHHzjRvZ.d.cts +0 -351
  145. package/dist/type-guards-C0e_GpeY.d.ts +0 -351
  146. package/dist/types-DT4FOOa2.d.cts +0 -51
  147. package/dist/types-DT4FOOa2.d.ts +0 -51
  148. package/dist/use-listbox-item-NzZuY34-.d.cts +0 -212
  149. package/dist/use-listbox-item-NzZuY34-.d.ts +0 -212
  150. package/dist/video-player/index.d.cts +0 -1391
@@ -1,46 +1,39 @@
1
- import { V as VirtualItem } from '../ListboxStore-CV5vPUUc.js';
2
- export { F as ComboboxFilterFn, I as ComboboxItemRegistration, b as ComboboxStore, L as ComboboxStoreContext, a as ComboboxStoreState } from '../ListboxStore-CV5vPUUc.js';
3
- import { P as PopupMenuDebugOptions, a as PopupMenuRootActions, b as PopupMenuArrow, c as PopupMenuBackdrop, d as PopupMenuPopup, e as PopupMenuPortal, f as PopupMenuScrollDownArrow, g as PopupMenuScrollUpArrow } from '../scroll-arrow-fl3B5sVO.js';
4
- export { h as ComboboxArrowProps, i as ComboboxBackdropProps, p as ComboboxListCssVars, j as ComboboxPopupProps, k as ComboboxPortalProps, q as ComboboxPositionerCssVars, l as ComboboxScrollArrowProps, m as ComboboxScrollArrowState, n as ComboboxScrollDownArrowProps, o as ComboboxScrollUpArrowProps } from '../scroll-arrow-fl3B5sVO.js';
5
- import { f as PopupMenuSurface, t as PopupMenuSurfaceProps, P as PopupMenuEmpty, a as PopupMenuGroup, b as PopupMenuGroupLabel, c as PopupMenuIcon, d as PopupMenuList, e as PopupMenuSeparator } from '../separator-Dn15rte3.js';
6
- export { g as ComboboxEmptyProps, h as ComboboxEmptyState, i as ComboboxGroupLabelProps, j as ComboboxGroupLabelState, k as ComboboxGroupProps, l as ComboboxGroupState, m as ComboboxIconProps, n as ComboboxIconState, o as ComboboxListChildrenState, p as ComboboxListProps, q as ComboboxListState, r as ComboboxSeparatorProps, s as ComboboxSeparatorState, u as ComboboxSurfaceState } from '../separator-Dn15rte3.js';
7
- import * as React from 'react';
8
- import { C as ComponentProps } from '../types-DT4FOOa2.js';
9
- import { PopoverPositionerProps, Popover, PopoverRootProps } from '@base-ui/react/popover';
10
- import { I as ItemEqualityComparer, a as Items } from '../items-B6HeFO_8.js';
11
- import { C as ChangeEventDetails, t as triggerPress, e as escapeKey, o as outsidePress, f as focusOut, i as itemPress, aW as inputChange, aX as inputClear, l as listNavigation, g as imperativeAction, n as none, G as GenericEventDetails, p as pointer, k as keyboard } from '../events-BTHQ2OoH.js';
12
- export { S as SurfaceContextValue, u as useMaybeSurfaceContext, a as useSurfaceContext } from '../surface-context-CGLDpMej.js';
13
- export { c as commandScore, d as defaultFilter } from '../command-score-CTJ9NV6n.js';
14
- import '@base-ui/utils/store';
15
-
1
+ import { B as VirtualItem, F as ListboxContext, I as ListboxState, L as ListboxStore, M as FilterFn, P as ItemRegistration, b as useMaybeSurfaceContext, i as defaultFilter, r as commandScore, x as useSurfaceContext, y as SurfaceContextValue } from "../index-D8OrKThQ.js";
2
+ import { Dn as triggerPress, bn as pointer, dn as imperativeAction, fn as inputChange, gn as listNavigation, hn as keyboard, ln as escapeKey, mn as itemPress, on as ChangeEventDetails, pn as inputClear, sn as GenericEventDetails, un as focusOut, vn as none, xn as reason_parts_d_exports, yn as outsidePress } from "../events-DDOsDu4X.js";
3
+ import { t as ComponentProps } from "../types-BbN28E3_.js";
4
+ import { $t as PopupMenuPopupProps, Ct as PopupMenuList, Dt as PopupMenuListCssVars, Et as PopupMenuListState, Ft as PopupMenuIconProps, H as PopupMenuGroupLabel, I as PopupMenuSeparator, It as PopupMenuIconState, J as PopupMenuGroupState, K as PopupMenuGroup, L as PopupMenuSeparatorProps, Mt as PopupMenuEmptyProps, Nt as PopupMenuEmptyState, Pt as PopupMenuIcon, Qt as PopupMenuPopup, R as PopupMenuSeparatorState, Sn as PopupMenuDebugOptions, Tt as PopupMenuListProps, U as PopupMenuGroupLabelProps, W as PopupMenuGroupLabelState, Xt as PopupMenuPortal, Yt as PopupMenuPositionerCssVars, Zt as PopupMenuPortalProps, _t as PopupMenuScrollDownArrowProps, an as PopupMenuArrowProps, dt as PopupMenuSurface, ft as PopupMenuSurfaceProps, gt as PopupMenuScrollDownArrow, ht as PopupMenuScrollArrowState, in as PopupMenuArrow, jt as PopupMenuEmpty, mt as PopupMenuScrollArrowProps, nn as PopupMenuBackdrop, pt as PopupMenuSurfaceState, q as PopupMenuGroupProps, rn as PopupMenuBackdropProps, sn as PopupMenuRootActions, vt as PopupMenuScrollUpArrow, wt as PopupMenuListChildrenState, yt as PopupMenuScrollUpArrowProps } from "../index-Cabqj7qI.js";
5
+ import { n as ItemEqualityComparer, t as Items } from "../items-ceX--VIv.js";
6
+ import * as React from "react";
7
+ import { Popover, PopoverPositionerProps, PopoverRootProps } from "@base-ui/react/popover";
8
+ //#region src/combobox/clear/clear.d.ts
16
9
  interface ComboboxClearState extends Record<string, unknown> {
17
- /**
18
- * Whether the combobox has a value (clear button is actionable).
19
- */
20
- hasValue: boolean;
21
- /**
22
- * Whether the combobox is disabled.
23
- */
24
- disabled: boolean;
10
+ /**
11
+ * Whether the combobox has a value (clear button is actionable).
12
+ */
13
+ hasValue: boolean;
14
+ /**
15
+ * Whether the combobox is disabled.
16
+ */
17
+ disabled: boolean;
25
18
  }
26
19
  interface ComboboxClearProps extends ComponentProps<'button', ComboboxClear.State> {
27
- /**
28
- * Whether to render the button even when there's no value to clear.
29
- * @default false
30
- */
31
- keepMounted?: boolean;
20
+ /**
21
+ * Whether to render the button even when there's no value to clear.
22
+ * @default false
23
+ */
24
+ keepMounted?: boolean;
32
25
  }
33
26
  /**
34
27
  * A button that clears the selected value(s) when clicked.
35
28
  * Renders a `<button>` element.
36
29
  */
37
- declare const ComboboxClear: React.ForwardRefExoticComponent<Omit<ComboboxClear.Props, "ref"> & React.RefAttributes<HTMLButtonElement>>;
38
- declare namespace ComboboxClear {
39
- type State = ComboboxClearState;
40
- interface Props extends ComboboxClearProps {
41
- }
30
+ export declare const ComboboxClear: React.ForwardRefExoticComponent<Omit<ComboboxClear.Props, "ref"> & React.RefAttributes<HTMLButtonElement>>;
31
+ export declare namespace ComboboxClear {
32
+ type State = ComboboxClearState;
33
+ interface Props extends ComboboxClearProps {}
42
34
  }
43
-
35
+ //#endregion
36
+ //#region src/combobox/contexts/combobox-positioner-context.d.ts
44
37
  type Side = 'top' | 'bottom' | 'left' | 'right';
45
38
  type Align = 'start' | 'center' | 'end';
46
39
  /**
@@ -54,64 +47,66 @@ type ComboboxLayout = 'floating' | 'input-embedded';
54
47
  * Provides alignment state for coordinating positioning behavior.
55
48
  */
56
49
  interface ComboboxPositionerContextValue {
57
- /**
58
- * The layout mode being used.
59
- * - `'floating'` - Standard dropdown positioning
60
- * - `'input-embedded'` - Popup wraps around the input
61
- */
62
- layout: ComboboxLayout;
63
- /**
64
- * The side of the popup relative to the input.
65
- */
66
- side: Side;
67
- /**
68
- * The alignment of the popup.
69
- */
70
- align: Align;
71
- /**
72
- * Height of the input element in pixels.
73
- * Use this to add appropriate padding to the popup.
74
- */
75
- inputHeight: number;
50
+ /**
51
+ * The layout mode being used.
52
+ * - `'floating'` - Standard dropdown positioning
53
+ * - `'input-embedded'` - Popup wraps around the input
54
+ */
55
+ layout: ComboboxLayout;
56
+ /**
57
+ * The side of the popup relative to the input.
58
+ */
59
+ side: Side;
60
+ /**
61
+ * The alignment of the popup.
62
+ */
63
+ align: Align;
64
+ /**
65
+ * Height of the input element in pixels.
66
+ * Use this to add appropriate padding to the popup.
67
+ */
68
+ inputHeight: number;
76
69
  }
77
70
  /**
78
71
  * Hook to access the Combobox Positioner context.
79
72
  * Returns null if used outside a ComboboxPositioner.
80
73
  */
81
- declare function useComboboxPositionerContext(): ComboboxPositionerContextValue | null;
82
-
74
+ export declare function useComboboxPositionerContext(): ComboboxPositionerContextValue | null;
75
+ //#endregion
76
+ //#region src/combobox/input/input.data-attrs.d.ts
83
77
  /**
84
78
  * Data attributes for ComboboxInput component.
85
79
  */
86
- declare const ComboboxInputDataAttributes: {
87
- /**
88
- * Identifies the component part.
89
- * @type {'bazzaui-combobox-input'}
90
- */
91
- readonly slot: "bazzaui-combobox-input";
92
- /** Present when the combobox popup is open. */
93
- readonly open: "data-open";
94
- /** Present when the combobox popup is closed. */
95
- readonly closed: "data-closed";
96
- /** Present when the input is disabled. */
97
- readonly disabled: "data-disabled";
98
- /** Present when no value is selected (showing placeholder). */
99
- readonly placeholder: "data-placeholder";
80
+ export declare const ComboboxInputDataAttributes: {
81
+ /**
82
+ * Identifies the component part.
83
+ * @type {'bazzaui-combobox-input'}
84
+ */
85
+ readonly slot: 'bazzaui-combobox-input';
86
+ /** Present when the combobox popup is open. */
87
+ readonly open: 'data-open';
88
+ /** Present when the combobox popup is closed. */
89
+ readonly closed: 'data-closed';
90
+ /** Present when the input is disabled. */
91
+ readonly disabled: 'data-disabled';
92
+ /** Present when no value is selected (showing placeholder). */
93
+ readonly placeholder: 'data-placeholder';
100
94
  };
101
-
95
+ //#endregion
96
+ //#region src/combobox/input/input.d.ts
102
97
  interface ComboboxInputState extends Record<string, unknown> {
103
- /**
104
- * Whether the combobox popup is open.
105
- */
106
- open: boolean;
107
- /**
108
- * Whether the input is disabled.
109
- */
110
- disabled: boolean;
111
- /**
112
- * Whether the input currently shows placeholder (no value selected).
113
- */
114
- placeholder: boolean;
98
+ /**
99
+ * Whether the combobox popup is open.
100
+ */
101
+ open: boolean;
102
+ /**
103
+ * Whether the input is disabled.
104
+ */
105
+ disabled: boolean;
106
+ /**
107
+ * Whether the input currently shows placeholder (no value selected).
108
+ */
109
+ placeholder: boolean;
115
110
  }
116
111
  /**
117
112
  * Cursor behavior when the combobox popup opens.
@@ -121,53 +116,53 @@ interface ComboboxInputState extends Record<string, unknown> {
121
116
  */
122
117
  type ComboboxInputCursorBehavior = 'none' | 'end' | 'select-all';
123
118
  interface ComboboxInputProps extends Omit<ComponentProps<'input', ComboboxInput.State>, 'value' | 'onChange' | 'type'> {
124
- /**
125
- * Placeholder text shown when no value is selected and input is empty.
126
- * Overrides the placeholder set on Combobox.Root.
127
- */
128
- placeholder?: string;
129
- /**
130
- * Cursor behavior when the combobox popup opens.
131
- * - `'none'` - Don't move the cursor (cursor appears where clicked)
132
- * - `'end'` - Move cursor to the end of the input
133
- * - `'select-all'` - Move cursor to the end and select all text
134
- *
135
- * @default 'none'
136
- */
137
- cursorBehavior?: ComboboxInputCursorBehavior;
119
+ /**
120
+ * Placeholder text shown when no value is selected and input is empty.
121
+ * Overrides the placeholder set on Combobox.Root.
122
+ */
123
+ placeholder?: string;
124
+ /**
125
+ * Cursor behavior when the combobox popup opens.
126
+ * - `'none'` - Don't move the cursor (cursor appears where clicked)
127
+ * - `'end'` - Move cursor to the end of the input
128
+ * - `'select-all'` - Move cursor to the end and select all text
129
+ *
130
+ * @default 'none'
131
+ */
132
+ cursorBehavior?: ComboboxInputCursorBehavior;
138
133
  }
139
134
  /**
140
135
  * An input that acts as both the trigger and search field for the combobox.
141
136
  * Renders an `<input>` element with combobox ARIA semantics.
142
137
  */
143
- declare const ComboboxInput: React.ForwardRefExoticComponent<Omit<ComboboxInput.Props, "ref"> & React.RefAttributes<HTMLInputElement>>;
144
- declare namespace ComboboxInput {
145
- interface Props extends ComboboxInputProps {
146
- }
147
- type State = ComboboxInputState;
138
+ export declare const ComboboxInput: React.ForwardRefExoticComponent<Omit<ComboboxInput.Props, "ref"> & React.RefAttributes<HTMLInputElement>>;
139
+ export declare namespace ComboboxInput {
140
+ interface Props extends ComboboxInputProps {}
141
+ type State = ComboboxInputState;
148
142
  }
149
-
143
+ //#endregion
144
+ //#region src/combobox/input-wrapper/input-wrapper.data-attrs.d.ts
150
145
  /**
151
146
  * Data attributes for ComboboxInputWrapper component.
152
147
  */
153
- declare const ComboboxInputWrapperDataAttributes: {
154
- /**
155
- * Identifies the component part.
156
- * @type {'bazzaui-combobox-input-wrapper'}
157
- */
158
- readonly slot: "bazzaui-combobox-input-wrapper";
159
- /** Present when the combobox popup is open. */
160
- readonly open: "data-open";
148
+ export declare const ComboboxInputWrapperDataAttributes: {
149
+ /**
150
+ * Identifies the component part.
151
+ * @type {'bazzaui-combobox-input-wrapper'}
152
+ */
153
+ readonly slot: 'bazzaui-combobox-input-wrapper';
154
+ /** Present when the combobox popup is open. */
155
+ readonly open: 'data-open';
161
156
  };
162
-
157
+ //#endregion
158
+ //#region src/combobox/input-wrapper/input-wrapper.d.ts
163
159
  interface ComboboxInputWrapperState extends Record<string, unknown> {
164
- /**
165
- * Whether the combobox popup is open.
166
- */
167
- open: boolean;
168
- }
169
- interface ComboboxInputWrapperProps extends ComponentProps<'div', ComboboxInputWrapper.State> {
160
+ /**
161
+ * Whether the combobox popup is open.
162
+ */
163
+ open: boolean;
170
164
  }
165
+ interface ComboboxInputWrapperProps extends ComponentProps<'div', ComboboxInputWrapper.State> {}
171
166
  /**
172
167
  * A wrapper component for the Combobox.Input and Combobox.Icon.
173
168
  * Provides relative positioning context and manages z-index for input-embedded layouts.
@@ -175,13 +170,13 @@ interface ComboboxInputWrapperProps extends ComponentProps<'div', ComboboxInputW
175
170
  *
176
171
  * Renders a `<div>` element with `position: relative`.
177
172
  */
178
- declare const ComboboxInputWrapper: React.ForwardRefExoticComponent<Omit<ComboboxInputWrapper.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
179
- declare namespace ComboboxInputWrapper {
180
- type State = ComboboxInputWrapperState;
181
- interface Props extends ComboboxInputWrapperProps {
182
- }
173
+ export declare const ComboboxInputWrapper: React.ForwardRefExoticComponent<Omit<ComboboxInputWrapper.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
174
+ export declare namespace ComboboxInputWrapper {
175
+ type State = ComboboxInputWrapperState;
176
+ interface Props extends ComboboxInputWrapperProps {}
183
177
  }
184
-
178
+ //#endregion
179
+ //#region src/combobox/item/item.data-attrs.d.ts
185
180
  /**
186
181
  * Data attributes applied to Combobox.Item for styling.
187
182
  *
@@ -199,148 +194,149 @@ declare namespace ComboboxInputWrapper {
199
194
  * }
200
195
  * ```
201
196
  */
202
- declare const ComboboxItemDataAttributes: {
203
- /**
204
- * Identifies the component part.
205
- * @type {'bazzaui-combobox-item'}
206
- */
207
- readonly slot: "bazzaui-combobox-item";
208
- /** Present when the item is highlighted (via keyboard or pointer). */
209
- readonly highlighted: "data-highlighted";
210
- /** Present when the item is disabled. */
211
- readonly disabled: "data-disabled";
212
- /** Present when the item is currently selected. */
213
- readonly selected: "data-selected";
214
- /** Present when this row is the first visible list-level row (not inside a group). */
215
- readonly first: "data-first";
216
- /** Present when this row is the last visible list-level row (not inside a group). */
217
- readonly last: "data-last";
218
- /** Present when this row is the first visible row within its group. */
219
- readonly firstInGroup: "data-first-in-group";
220
- /** Present when this row is the last visible row within its group. */
221
- readonly lastInGroup: "data-last-in-group";
197
+ export declare const ComboboxItemDataAttributes: {
198
+ /**
199
+ * Identifies the component part.
200
+ * @type {'bazzaui-combobox-item'}
201
+ */
202
+ readonly slot: 'bazzaui-combobox-item';
203
+ /** Present when the item is highlighted (via keyboard or pointer). */
204
+ readonly highlighted: 'data-highlighted';
205
+ /** Present when the item is disabled. */
206
+ readonly disabled: 'data-disabled';
207
+ /** Present when the item is currently selected. */
208
+ readonly selected: 'data-selected';
209
+ /** Present when this row is the first visible list-level row (not inside a group). */
210
+ readonly first: 'data-first';
211
+ /** Present when this row is the last visible list-level row (not inside a group). */
212
+ readonly last: 'data-last';
213
+ /** Present when this row is the first visible row within its group. */
214
+ readonly firstInGroup: 'data-first-in-group';
215
+ /** Present when this row is the last visible row within its group. */
216
+ readonly lastInGroup: 'data-last-in-group';
222
217
  };
223
-
218
+ //#endregion
219
+ //#region src/combobox/item/item.d.ts
224
220
  interface ComboboxItemState extends Record<string, unknown> {
225
- /**
226
- * Whether the item is highlighted (via keyboard or pointer).
227
- */
228
- highlighted: boolean;
229
- /**
230
- * Whether the item is disabled.
231
- */
232
- disabled: boolean;
233
- /**
234
- * Whether the item is currently selected.
235
- */
236
- selected: boolean;
237
- first: boolean;
238
- last: boolean;
239
- firstInGroup: boolean;
240
- lastInGroup: boolean;
221
+ /**
222
+ * Whether the item is highlighted (via keyboard or pointer).
223
+ */
224
+ highlighted: boolean;
225
+ /**
226
+ * Whether the item is disabled.
227
+ */
228
+ disabled: boolean;
229
+ /**
230
+ * Whether the item is currently selected.
231
+ */
232
+ selected: boolean;
233
+ first: boolean;
234
+ last: boolean;
235
+ firstInGroup: boolean;
236
+ lastInGroup: boolean;
241
237
  }
242
238
  interface ComboboxItemProps<Value = unknown> extends ComponentProps<'div', ComboboxItem.State> {
243
- /**
244
- * The value of this item. Required and must be unique within the Combobox.
245
- * Can be a primitive or an object.
246
- *
247
- * Pass `null` to render a clearable item: selecting it clears the selection
248
- * and its label is used as the input placeholder (Base UI parity).
249
- */
250
- value: Value | null;
251
- /**
252
- * Text value to use for display in the input when this item is selected.
253
- * If not provided, the text content of the item will be used.
254
- * For object values, this can be auto-detected from `{ label }` shape.
255
- */
256
- textValue?: string;
257
- /**
258
- * Additional keywords to match against when filtering.
259
- * Useful for aliases or synonyms.
260
- */
261
- keywords?: string[];
262
- /**
263
- * Whether this item is disabled.
264
- * Disabled items are not selectable and are skipped during keyboard navigation.
265
- */
266
- disabled?: boolean;
267
- /**
268
- * Callback when this item is selected.
269
- */
270
- onSelect?: () => void;
271
- /**
272
- * Whether to force render this item regardless of filter results.
273
- * @default false
274
- */
275
- forceMount?: boolean;
239
+ /**
240
+ * The value of this item. Required and must be unique within the Combobox.
241
+ * Can be a primitive or an object.
242
+ *
243
+ * Pass `null` to render a clearable item: selecting it clears the selection
244
+ * and its label is used as the input placeholder (Base UI parity).
245
+ */
246
+ value: Value | null;
247
+ /**
248
+ * Text value to use for display in the input when this item is selected.
249
+ * If not provided, the text content of the item will be used.
250
+ * For object values, this can be auto-detected from `{ label }` shape.
251
+ */
252
+ textValue?: string;
253
+ /**
254
+ * Additional keywords to match against when filtering.
255
+ * Useful for aliases or synonyms.
256
+ */
257
+ keywords?: string[];
258
+ /**
259
+ * Whether this item is disabled.
260
+ * Disabled items are not selectable and are skipped during keyboard navigation.
261
+ */
262
+ disabled?: boolean;
263
+ /**
264
+ * Callback when this item is selected.
265
+ */
266
+ onSelect?: () => void;
267
+ /**
268
+ * Whether to force render this item regardless of filter results.
269
+ * @default false
270
+ */
271
+ forceMount?: boolean;
276
272
  }
277
- declare const ComboboxItem: <Value = unknown>(props: ComboboxItemProps<Value> & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;
278
- declare namespace ComboboxItem {
279
- type State = ComboboxItemState;
280
- interface Props<Value = unknown> extends ComboboxItemProps<Value> {
281
- }
273
+ export declare const ComboboxItem: <Value = unknown>(props: ComboboxItemProps<Value> & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;
274
+ export declare namespace ComboboxItem {
275
+ type State = ComboboxItemState;
276
+ interface Props<Value = unknown> extends ComboboxItemProps<Value> {}
282
277
  }
283
-
278
+ //#endregion
279
+ //#region src/combobox/item-indicator/item-indicator.data-attrs.d.ts
284
280
  /**
285
281
  * Data attributes for ComboboxItemIndicator component.
286
282
  */
287
- declare const ComboboxItemIndicatorDataAttributes: {
288
- /**
289
- * Identifies the component part.
290
- * @type {'bazzaui-combobox-item-indicator'}
291
- */
292
- readonly slot: "bazzaui-combobox-item-indicator";
293
- /** Present when the item is selected. */
294
- readonly selected: "data-selected";
283
+ export declare const ComboboxItemIndicatorDataAttributes: {
284
+ /**
285
+ * Identifies the component part.
286
+ * @type {'bazzaui-combobox-item-indicator'}
287
+ */
288
+ readonly slot: 'bazzaui-combobox-item-indicator';
289
+ /** Present when the item is selected. */
290
+ readonly selected: 'data-selected';
295
291
  };
296
-
292
+ //#endregion
293
+ //#region src/combobox/item-indicator/item-indicator.d.ts
297
294
  interface ComboboxItemIndicatorState extends Record<string, unknown> {
298
- /**
299
- * Whether the parent item is selected.
300
- */
301
- selected: boolean;
295
+ /**
296
+ * Whether the parent item is selected.
297
+ */
298
+ selected: boolean;
302
299
  }
303
300
  interface ComboboxItemIndicatorProps extends ComponentProps<'span', ComboboxItemIndicator.State> {
304
- /**
305
- * Whether to always render the indicator regardless of selection state.
306
- * When false (default), only renders when the item is selected.
307
- * @default false
308
- */
309
- keepMounted?: boolean;
301
+ /**
302
+ * Whether to always render the indicator regardless of selection state.
303
+ * When false (default), only renders when the item is selected.
304
+ * @default false
305
+ */
306
+ keepMounted?: boolean;
310
307
  }
311
308
  /**
312
309
  * Visual indicator for the selected state of a combobox item.
313
310
  * Only renders when the parent item is selected (unless keepMounted is true).
314
311
  * Renders a `<span>` element.
315
312
  */
316
- declare const ComboboxItemIndicator: React.ForwardRefExoticComponent<Omit<ComboboxItemIndicator.Props, "ref"> & React.RefAttributes<HTMLSpanElement>>;
317
- declare namespace ComboboxItemIndicator {
318
- type State = ComboboxItemIndicatorState;
319
- interface Props extends ComboboxItemIndicatorProps {
320
- }
313
+ export declare const ComboboxItemIndicator: React.ForwardRefExoticComponent<Omit<ComboboxItemIndicator.Props, "ref"> & React.RefAttributes<HTMLSpanElement>>;
314
+ export declare namespace ComboboxItemIndicator {
315
+ type State = ComboboxItemIndicatorState;
316
+ interface Props extends ComboboxItemIndicatorProps {}
321
317
  }
322
-
318
+ //#endregion
319
+ //#region src/combobox/item-label/item-label.d.ts
323
320
  interface ComboboxItemLabelState extends Record<string, unknown> {
324
- /**
325
- * The serialized string key for the parent item's value.
326
- * For object values, this is the result of `itemToStringValue` or the auto-detected `.value` property.
327
- */
328
- value: string;
329
- /**
330
- * Whether the parent item is selected.
331
- */
332
- selected: boolean;
333
- /**
334
- * Whether the parent item is highlighted.
335
- */
336
- highlighted: boolean;
337
- /**
338
- * Whether the parent item is disabled.
339
- */
340
- disabled: boolean;
341
- }
342
- interface ComboboxItemLabelProps extends ComponentProps<'span', ComboboxItemLabel.State> {
321
+ /**
322
+ * The serialized string key for the parent item's value.
323
+ * For object values, this is the result of `itemToStringValue` or the auto-detected `.value` property.
324
+ */
325
+ value: string;
326
+ /**
327
+ * Whether the parent item is selected.
328
+ */
329
+ selected: boolean;
330
+ /**
331
+ * Whether the parent item is highlighted.
332
+ */
333
+ highlighted: boolean;
334
+ /**
335
+ * Whether the parent item is disabled.
336
+ */
337
+ disabled: boolean;
343
338
  }
339
+ interface ComboboxItemLabelProps extends ComponentProps<'span', ComboboxItemLabel.State> {}
344
340
  /**
345
341
  * Renders the text label for a combobox item.
346
342
  *
@@ -352,51 +348,52 @@ interface ComboboxItemLabelProps extends ComponentProps<'span', ComboboxItemLabe
352
348
  * Also registers the text content for use in the input display.
353
349
  * Renders a `<span>` element.
354
350
  */
355
- declare const ComboboxItemLabel: React.ForwardRefExoticComponent<Omit<ComboboxItemLabel.Props, "ref"> & React.RefAttributes<HTMLSpanElement>>;
356
- declare namespace ComboboxItemLabel {
357
- interface Props extends ComboboxItemLabelProps {
358
- }
359
- type State = ComboboxItemLabelState;
351
+ export declare const ComboboxItemLabel: React.ForwardRefExoticComponent<Omit<ComboboxItemLabel.Props, "ref"> & React.RefAttributes<HTMLSpanElement>>;
352
+ export declare namespace ComboboxItemLabel {
353
+ interface Props extends ComboboxItemLabelProps {}
354
+ type State = ComboboxItemLabelState;
360
355
  }
361
-
356
+ //#endregion
357
+ //#region src/combobox/positioner/positioner.data-attrs.d.ts
362
358
  /**
363
359
  * Data attributes for ComboboxPositioner component.
364
360
  */
365
- declare const ComboboxPositionerDataAttributes: {
366
- /**
367
- * Identifies the component part.
368
- * @type {'bazzaui-combobox-positioner'}
369
- */
370
- readonly slot: "bazzaui-combobox-positioner";
361
+ export declare const ComboboxPositionerDataAttributes: {
362
+ /**
363
+ * Identifies the component part.
364
+ * @type {'bazzaui-combobox-positioner'}
365
+ */
366
+ readonly slot: 'bazzaui-combobox-positioner';
371
367
  };
372
-
368
+ //#endregion
369
+ //#region src/combobox/positioner/positioner.d.ts
373
370
  interface ComboboxPositionerProps extends PopoverPositionerProps {
374
- /**
375
- * Override the layout mode for the popup.
376
- * If not provided, uses the `layout` from `Combobox.Root`.
377
- *
378
- * - `'floating'` - Standard dropdown positioning below/above the input
379
- * - `'input-embedded'` - Popup wraps around the input (macOS Spotlight-style).
380
- * The input appears to be inside the popup at the top.
381
- *
382
- * When `'input-embedded'`:
383
- * - Popup is positioned flush with the input (sideOffset=0)
384
- * - Alignment is centered on the input
385
- * - Positioning styles are automatically applied to the Popup child
386
- * - Use `popupPadding` to control the padding around the input
387
- * - `data-input-embedded` attribute is added to Input, Positioner, Popup, and List
388
- */
389
- layout?: ComboboxLayout;
390
- /**
391
- * Padding around the popup content when `layout="input-embedded"`.
392
- * Creates the "encapsulated" look where the input appears inside the popup
393
- * with padding on all sides.
394
- *
395
- * Only applies when `layout="input-embedded"`.
396
- *
397
- * @default 8
398
- */
399
- popupPadding?: number;
371
+ /**
372
+ * Override the layout mode for the popup.
373
+ * If not provided, uses the `layout` from `Combobox.Root`.
374
+ *
375
+ * - `'floating'` - Standard dropdown positioning below/above the input
376
+ * - `'input-embedded'` - Popup wraps around the input (macOS Spotlight-style).
377
+ * The input appears to be inside the popup at the top.
378
+ *
379
+ * When `'input-embedded'`:
380
+ * - Popup is positioned flush with the input (sideOffset=0)
381
+ * - Alignment is centered on the input
382
+ * - Positioning styles are automatically applied to the Popup child
383
+ * - Use `popupPadding` to control the padding around the input
384
+ * - `data-input-embedded` attribute is added to Input, Positioner, Popup, and List
385
+ */
386
+ layout?: ComboboxLayout;
387
+ /**
388
+ * Padding around the popup content when `layout="input-embedded"`.
389
+ * Creates the "encapsulated" look where the input appears inside the popup
390
+ * with padding on all sides.
391
+ *
392
+ * Only applies when `layout="input-embedded"`.
393
+ *
394
+ * @default 8
395
+ */
396
+ popupPadding?: number;
400
397
  }
401
398
  /**
402
399
  * Positions the combobox popup against the input.
@@ -407,12 +404,13 @@ interface ComboboxPositionerProps extends PopoverPositionerProps {
407
404
  *
408
405
  * Renders a `<div>` element.
409
406
  */
410
- declare const ComboboxPositioner: React.ForwardRefExoticComponent<Omit<ComboboxPositionerProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
411
- declare namespace ComboboxPositioner {
412
- type Props = ComboboxPositionerProps;
413
- type State = Popover.Positioner.State;
407
+ export declare const ComboboxPositioner: React.ForwardRefExoticComponent<Omit<ComboboxPositionerProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
408
+ export declare namespace ComboboxPositioner {
409
+ type Props = ComboboxPositionerProps;
410
+ type State = Popover.Positioner.State;
414
411
  }
415
-
412
+ //#endregion
413
+ //#region src/combobox/events.d.ts
416
414
  /**
417
415
  * Reasons why the combobox's open state changed.
418
416
  */
@@ -429,222 +427,223 @@ type ComboboxHighlightChangeReason = typeof pointer | typeof keyboard | typeof n
429
427
  * Event details passed to the `onHighlightChange` callback.
430
428
  */
431
429
  type ComboboxHighlightChangeEventDetails = GenericEventDetails<ComboboxHighlightChangeReason, {
432
- index: number;
430
+ index: number;
433
431
  }>;
434
-
432
+ //#endregion
433
+ //#region src/combobox/root/root.d.ts
435
434
  /**
436
435
  * Helper type to determine the value type based on the multiple flag.
437
436
  */
438
437
  type ComboboxValueType<Value, Multiple extends boolean | undefined> = Multiple extends true ? Value[] : Value | null;
439
438
  interface ComboboxRootProps<Value = unknown, Multiple extends boolean | undefined = false> extends Omit<PopoverRootProps, 'open' | 'onOpenChange' | 'defaultOpen' | 'actionsRef'> {
440
- /**
441
- * Whether the combobox is open.
442
- * Use for controlled mode.
443
- */
444
- open?: boolean;
445
- /**
446
- * Callback when the open state changes.
447
- * The second parameter contains event details including the reason for the change.
448
- */
449
- onOpenChange?: (open: boolean, eventDetails: ComboboxOpenChangeEventDetails) => void;
450
- /**
451
- * Whether the combobox is initially open.
452
- * Use for uncontrolled mode.
453
- * @default false
454
- */
455
- defaultOpen?: boolean;
456
- /**
457
- * A ref to imperative actions.
458
- * - `close`: closes the menu imperatively.
459
- * - `unmount`: unmounts the popup imperatively (when keep-mounted mode is enabled).
460
- * - `setDisabled`: enables/disables the menu imperatively.
461
- */
462
- actionsRef?: React.RefObject<ComboboxRoot.Actions | null>;
463
- /**
464
- * Current selected value (single-select mode).
465
- * Use for controlled mode.
466
- * Can be a primitive or an object.
467
- */
468
- value?: ComboboxValueType<Value, Multiple>;
469
- /**
470
- * Default selected value (single-select mode).
471
- * Use for uncontrolled mode.
472
- */
473
- defaultValue?: ComboboxValueType<Value, Multiple>;
474
- /**
475
- * Callback when the selected value changes (single-select mode).
476
- *
477
- * Note: when a clearable (`null`) item is selected, this is called with
478
- * `null` at runtime. If you use `null` items, handle that case.
479
- */
480
- onValueChange?: (value: Value) => void;
481
- /**
482
- * Whether multi-select mode is enabled.
483
- * @default false
484
- */
485
- multiple?: Multiple;
486
- /**
487
- * Current selected values (multi-select mode).
488
- * Use for controlled mode.
489
- */
490
- values?: Value[];
491
- /**
492
- * Default selected values (multi-select mode).
493
- * Use for uncontrolled mode.
494
- */
495
- defaultValues?: Value[];
496
- /**
497
- * Callback when the selected values change (multi-select mode).
498
- */
499
- onValuesChange?: (values: Value[]) => void;
500
- /**
501
- * Custom comparison logic used to determine if a combobox item value
502
- * matches the current selected value.
503
- * Useful when item values are objects without matching referentially.
504
- * Defaults to Object.is comparison.
505
- */
506
- isItemEqualToValue?: ItemEqualityComparer<Value>;
507
- /**
508
- * When the item values are objects (`<Combobox.Item value={object}>`),
509
- * this function converts the object value to a string representation
510
- * for display in the input.
511
- * If the shape of the object is `{ value, label }`, the label will be
512
- * used automatically without needing to specify this prop.
513
- */
514
- itemToStringLabel?: (itemValue: Value) => string;
515
- /**
516
- * When the item values are objects (`<Combobox.Item value={object}>`),
517
- * this function converts the object value to a string representation
518
- * for form submission.
519
- * If the shape of the object is `{ value, label }`, the value will be
520
- * used automatically without needing to specify this prop.
521
- */
522
- itemToStringValue?: (itemValue: Value) => string;
523
- /**
524
- * Current input value.
525
- * Use for controlled mode.
526
- */
527
- inputValue?: string;
528
- /**
529
- * Default input value.
530
- * Use for uncontrolled mode.
531
- */
532
- defaultInputValue?: string;
533
- /**
534
- * Callback when the input value changes.
535
- */
536
- onInputValueChange?: (value: string) => void;
537
- /**
538
- * Form field name for submission.
539
- * When set, hidden input(s) will be rendered for form submission.
540
- */
541
- name?: string;
542
- /**
543
- * Associate with a form by ID.
544
- */
545
- form?: string;
546
- /**
547
- * Whether this field is required.
548
- */
549
- required?: boolean;
550
- /**
551
- * Whether the combobox is disabled.
552
- * @default false
553
- */
554
- disabled?: boolean;
555
- /**
556
- * Placeholder text for the input.
557
- * @default "Search..."
558
- */
559
- placeholder?: string;
560
- /**
561
- * Data structure of the items rendered in the combobox popup.
562
- * When specified, the input shows the label of the selected item
563
- * instead of the raw value.
564
- *
565
- * Can be a record mapping values to labels, or an array of
566
- * `{ value, label, keywords? }` objects. Only the array form can express
567
- * `keywords` (extra filter terms) or a `null` (clearable) value.
568
- * @example
569
- * ```tsx
570
- * // Record format
571
- * <Combobox.Root items={{ us: 'United States', uk: 'United Kingdom' }}>
572
- *
573
- * // Array format (supports keywords and a null clearable item)
574
- * <Combobox.Root items={[
575
- * { value: null, label: 'Select a country' },
576
- * { value: 'us', label: 'United States', keywords: ['america', 'usa'] },
577
- * { value: 'uk', label: 'United Kingdom' },
578
- * ]}>
579
- * ```
580
- */
581
- items?: Items;
582
- /**
583
- * Determines if the combobox enters a modal state when open.
584
- *
585
- * - `true`: user interaction is limited to the combobox: document page scroll
586
- * is locked, and pointer interactions on outside elements are disabled.
587
- * - `false`: user interaction with the rest of the document is allowed.
588
- * - `'trap-focus'`: focus is trapped inside the combobox, but document page
589
- * scroll is not locked and pointer interactions outside of it remain enabled.
590
- *
591
- * @default false
592
- */
593
- modal?: boolean | 'trap-focus';
594
- /**
595
- * Whether to close the popup after selecting an item.
596
- * @default true for single-select, false for multi-select
597
- */
598
- closeOnSelect?: boolean;
599
- /**
600
- * Whether to open the popup when the input is focused.
601
- * @default true
602
- */
603
- openOnFocus?: boolean;
604
- /**
605
- * Whether virtualization mode is enabled.
606
- * When true, items should provide an explicit `index` prop and
607
- * the `virtualItems` prop should be provided for navigation to work correctly.
608
- * @default false
609
- */
610
- virtualized?: boolean;
611
- /**
612
- * Pre-registered items for virtualization.
613
- * When provided with `virtualized={true}`, this allows navigation to work
614
- * for items that aren't currently mounted in the DOM.
615
- */
616
- virtualItems?: VirtualItem[];
617
- /**
618
- * Callback when the highlighted item changes.
619
- * Useful for synchronizing with a virtualizer (e.g., scrollToIndex) or other UI state.
620
- * The third parameter contains event details including the reason for the change.
621
- */
622
- onHighlightChange?: (id: string | null, index: number, eventDetails: ComboboxHighlightChangeEventDetails) => void;
623
- /**
624
- * The layout mode for the combobox popup.
625
- *
626
- * - `'floating'` (default) - Standard dropdown positioning below/above the input
627
- * - `'input-embedded'` - Popup wraps around the input (macOS Spotlight-style).
628
- * The input appears to be inside the popup at the top.
629
- *
630
- * When `'input-embedded'`:
631
- * - `data-input-embedded` attribute is added to Input, Positioner, Popup, and List
632
- * - Use CSS selectors like `[data-input-embedded]` to style components
633
- *
634
- * @default 'floating'
635
- */
636
- layout?: ComboboxLayout;
637
- /**
638
- * Event handler called after any open/close animations have completed.
639
- * When `clearSearchOnClose="after-exit"` is set on Surface, the search
640
- * will be cleared before this callback is invoked.
641
- */
642
- onOpenChangeComplete?: (open: boolean) => void;
643
- /**
644
- * Debug visualization options for submenu interaction heuristics.
645
- */
646
- debug?: PopupMenuDebugOptions;
647
- children: React.ReactNode;
439
+ /**
440
+ * Whether the combobox is open.
441
+ * Use for controlled mode.
442
+ */
443
+ open?: boolean;
444
+ /**
445
+ * Callback when the open state changes.
446
+ * The second parameter contains event details including the reason for the change.
447
+ */
448
+ onOpenChange?: (open: boolean, eventDetails: ComboboxOpenChangeEventDetails) => void;
449
+ /**
450
+ * Whether the combobox is initially open.
451
+ * Use for uncontrolled mode.
452
+ * @default false
453
+ */
454
+ defaultOpen?: boolean;
455
+ /**
456
+ * A ref to imperative actions.
457
+ * - `close`: closes the menu imperatively.
458
+ * - `unmount`: unmounts the popup imperatively (when keep-mounted mode is enabled).
459
+ * - `setDisabled`: enables/disables the menu imperatively.
460
+ */
461
+ actionsRef?: React.RefObject<ComboboxRoot.Actions | null>;
462
+ /**
463
+ * Current selected value (single-select mode).
464
+ * Use for controlled mode.
465
+ * Can be a primitive or an object.
466
+ */
467
+ value?: ComboboxValueType<Value, Multiple>;
468
+ /**
469
+ * Default selected value (single-select mode).
470
+ * Use for uncontrolled mode.
471
+ */
472
+ defaultValue?: ComboboxValueType<Value, Multiple>;
473
+ /**
474
+ * Callback when the selected value changes (single-select mode).
475
+ *
476
+ * Note: when a clearable (`null`) item is selected, this is called with
477
+ * `null` at runtime. If you use `null` items, handle that case.
478
+ */
479
+ onValueChange?: (value: Value) => void;
480
+ /**
481
+ * Whether multi-select mode is enabled.
482
+ * @default false
483
+ */
484
+ multiple?: Multiple;
485
+ /**
486
+ * Current selected values (multi-select mode).
487
+ * Use for controlled mode.
488
+ */
489
+ values?: Value[];
490
+ /**
491
+ * Default selected values (multi-select mode).
492
+ * Use for uncontrolled mode.
493
+ */
494
+ defaultValues?: Value[];
495
+ /**
496
+ * Callback when the selected values change (multi-select mode).
497
+ */
498
+ onValuesChange?: (values: Value[]) => void;
499
+ /**
500
+ * Custom comparison logic used to determine if a combobox item value
501
+ * matches the current selected value.
502
+ * Useful when item values are objects without matching referentially.
503
+ * Defaults to Object.is comparison.
504
+ */
505
+ isItemEqualToValue?: ItemEqualityComparer<Value>;
506
+ /**
507
+ * When the item values are objects (`<Combobox.Item value={object}>`),
508
+ * this function converts the object value to a string representation
509
+ * for display in the input.
510
+ * If the shape of the object is `{ value, label }`, the label will be
511
+ * used automatically without needing to specify this prop.
512
+ */
513
+ itemToStringLabel?: (itemValue: Value) => string;
514
+ /**
515
+ * When the item values are objects (`<Combobox.Item value={object}>`),
516
+ * this function converts the object value to a string representation
517
+ * for form submission.
518
+ * If the shape of the object is `{ value, label }`, the value will be
519
+ * used automatically without needing to specify this prop.
520
+ */
521
+ itemToStringValue?: (itemValue: Value) => string;
522
+ /**
523
+ * Current input value.
524
+ * Use for controlled mode.
525
+ */
526
+ inputValue?: string;
527
+ /**
528
+ * Default input value.
529
+ * Use for uncontrolled mode.
530
+ */
531
+ defaultInputValue?: string;
532
+ /**
533
+ * Callback when the input value changes.
534
+ */
535
+ onInputValueChange?: (value: string) => void;
536
+ /**
537
+ * Form field name for submission.
538
+ * When set, hidden input(s) will be rendered for form submission.
539
+ */
540
+ name?: string;
541
+ /**
542
+ * Associate with a form by ID.
543
+ */
544
+ form?: string;
545
+ /**
546
+ * Whether this field is required.
547
+ */
548
+ required?: boolean;
549
+ /**
550
+ * Whether the combobox is disabled.
551
+ * @default false
552
+ */
553
+ disabled?: boolean;
554
+ /**
555
+ * Placeholder text for the input.
556
+ * @default "Search..."
557
+ */
558
+ placeholder?: string;
559
+ /**
560
+ * Data structure of the items rendered in the combobox popup.
561
+ * When specified, the input shows the label of the selected item
562
+ * instead of the raw value.
563
+ *
564
+ * Can be a record mapping values to labels, or an array of
565
+ * `{ value, label, keywords? }` objects. Only the array form can express
566
+ * `keywords` (extra filter terms) or a `null` (clearable) value.
567
+ * @example
568
+ * ```tsx
569
+ * // Record format
570
+ * <Combobox.Root items={{ us: 'United States', uk: 'United Kingdom' }}>
571
+ *
572
+ * // Array format (supports keywords and a null clearable item)
573
+ * <Combobox.Root items={[
574
+ * { value: null, label: 'Select a country' },
575
+ * { value: 'us', label: 'United States', keywords: ['america', 'usa'] },
576
+ * { value: 'uk', label: 'United Kingdom' },
577
+ * ]}>
578
+ * ```
579
+ */
580
+ items?: Items;
581
+ /**
582
+ * Determines if the combobox enters a modal state when open.
583
+ *
584
+ * - `true`: user interaction is limited to the combobox: document page scroll
585
+ * is locked, and pointer interactions on outside elements are disabled.
586
+ * - `false`: user interaction with the rest of the document is allowed.
587
+ * - `'trap-focus'`: focus is trapped inside the combobox, but document page
588
+ * scroll is not locked and pointer interactions outside of it remain enabled.
589
+ *
590
+ * @default false
591
+ */
592
+ modal?: boolean | 'trap-focus';
593
+ /**
594
+ * Whether to close the popup after selecting an item.
595
+ * @default true for single-select, false for multi-select
596
+ */
597
+ closeOnSelect?: boolean;
598
+ /**
599
+ * Whether to open the popup when the input is focused.
600
+ * @default true
601
+ */
602
+ openOnFocus?: boolean;
603
+ /**
604
+ * Whether virtualization mode is enabled.
605
+ * When true, items should provide an explicit `index` prop and
606
+ * the `virtualItems` prop should be provided for navigation to work correctly.
607
+ * @default false
608
+ */
609
+ virtualized?: boolean;
610
+ /**
611
+ * Pre-registered items for virtualization.
612
+ * When provided with `virtualized={true}`, this allows navigation to work
613
+ * for items that aren't currently mounted in the DOM.
614
+ */
615
+ virtualItems?: VirtualItem[];
616
+ /**
617
+ * Callback when the highlighted item changes.
618
+ * Useful for synchronizing with a virtualizer (e.g., scrollToIndex) or other UI state.
619
+ * The third parameter contains event details including the reason for the change.
620
+ */
621
+ onHighlightChange?: (id: string | null, index: number, eventDetails: ComboboxHighlightChangeEventDetails) => void;
622
+ /**
623
+ * The layout mode for the combobox popup.
624
+ *
625
+ * - `'floating'` (default) - Standard dropdown positioning below/above the input
626
+ * - `'input-embedded'` - Popup wraps around the input (macOS Spotlight-style).
627
+ * The input appears to be inside the popup at the top.
628
+ *
629
+ * When `'input-embedded'`:
630
+ * - `data-input-embedded` attribute is added to Input, Positioner, Popup, and List
631
+ * - Use CSS selectors like `[data-input-embedded]` to style components
632
+ *
633
+ * @default 'floating'
634
+ */
635
+ layout?: ComboboxLayout;
636
+ /**
637
+ * Event handler called after any open/close animations have completed.
638
+ * When `clearSearchOnClose="after-exit"` is set on Surface, the search
639
+ * will be cleared before this callback is invoked.
640
+ */
641
+ onOpenChangeComplete?: (open: boolean) => void;
642
+ /**
643
+ * Debug visualization options for submenu interaction heuristics.
644
+ */
645
+ debug?: PopupMenuDebugOptions;
646
+ children: React.ReactNode;
648
647
  }
649
648
  /**
650
649
  * Groups all parts of the combobox.
@@ -654,33 +653,33 @@ interface ComboboxRootProps<Value = unknown, Multiple extends boolean | undefine
654
653
  * @template Value - The type of the combobox value (can be a primitive or object)
655
654
  * @template Multiple - Whether multiple selection is enabled
656
655
  */
657
- declare function ComboboxRoot<Value = unknown, Multiple extends boolean | undefined = false>(props: ComboboxRootProps<Value, Multiple>): React.JSX.Element;
658
- declare namespace ComboboxRoot {
659
- interface Props<Value = unknown, Multiple extends boolean | undefined = false> extends ComboboxRootProps<Value, Multiple> {
660
- }
661
- type OpenChangeEventDetails = ComboboxOpenChangeEventDetails;
662
- type HighlightChangeEventDetails = ComboboxHighlightChangeEventDetails;
663
- type Actions = PopupMenuRootActions;
656
+ export declare function ComboboxRoot<Value = unknown, Multiple extends boolean | undefined = false>(props: ComboboxRootProps<Value, Multiple>): React.JSX.Element;
657
+ export declare namespace ComboboxRoot {
658
+ interface Props<Value = unknown, Multiple extends boolean | undefined = false> extends ComboboxRootProps<Value, Multiple> {}
659
+ type OpenChangeEventDetails = ComboboxOpenChangeEventDetails;
660
+ type HighlightChangeEventDetails = ComboboxHighlightChangeEventDetails;
661
+ type Actions = PopupMenuRootActions;
664
662
  }
665
-
663
+ //#endregion
664
+ //#region src/combobox/surface/surface.d.ts
666
665
  interface ComboboxSurfaceProps extends Omit<PopupMenuSurfaceProps, 'autoHighlightFirst'> {
667
- /**
668
- * Controls auto-highlighting behavior when the combobox opens.
669
- * - `true`: highlight the first item (default)
670
- * - `false`: don't auto-highlight any item
671
- * - `'selected'`: highlight the currently selected item, or first item if none selected
672
- * - `string`: highlight the item with this specific value
673
- * @default true
674
- */
675
- autoHighlightFirst?: boolean | 'selected' | string;
676
- /**
677
- * Whether to clear the search query when the combobox closes.
678
- * - `true`: clear immediately when the combobox closes (default)
679
- * - `false`: preserve search when the combobox closes
680
- * - `'after-exit'`: clear after exit animation completes
681
- * @default true
682
- */
683
- clearSearchOnClose?: boolean | 'after-exit';
666
+ /**
667
+ * Controls auto-highlighting behavior when the combobox opens.
668
+ * - `true`: highlight the first item (default)
669
+ * - `false`: don't auto-highlight any item
670
+ * - `'selected'`: highlight the currently selected item, or first item if none selected
671
+ * - `string`: highlight the item with this specific value
672
+ * @default true
673
+ */
674
+ autoHighlightFirst?: boolean | 'selected' | string;
675
+ /**
676
+ * Whether to clear the search query when the combobox closes.
677
+ * - `true`: clear immediately when the combobox closes (default)
678
+ * - `false`: preserve search when the combobox closes
679
+ * - `'after-exit'`: clear after exit animation completes
680
+ * @default true
681
+ */
682
+ clearSearchOnClose?: boolean | 'after-exit';
684
683
  }
685
684
  /**
686
685
  * Provides search context and manages item registration for Combobox.
@@ -689,210 +688,217 @@ interface ComboboxSurfaceProps extends Omit<PopupMenuSurfaceProps, 'autoHighligh
689
688
  * Place inside Combobox.Popup to enable search functionality.
690
689
  * Renders a `<div>` element.
691
690
  */
692
- declare const ComboboxSurface: React.ForwardRefExoticComponent<Omit<ComboboxSurface.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
693
- declare namespace ComboboxSurface {
694
- type State = PopupMenuSurface.State;
695
- interface Props extends ComboboxSurfaceProps {
696
- }
691
+ export declare const ComboboxSurface: React.ForwardRefExoticComponent<Omit<ComboboxSurface.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
692
+ export declare namespace ComboboxSurface {
693
+ type State = PopupMenuSurface.State;
694
+ interface Props extends ComboboxSurfaceProps {}
697
695
  }
698
-
699
- declare const index_parts_VirtualItem: typeof VirtualItem;
700
- declare const index_parts_useComboboxPositionerContext: typeof useComboboxPositionerContext;
701
- declare namespace index_parts {
702
- export { PopupMenuArrow as Arrow, PopupMenuBackdrop as Backdrop, ComboboxClear as Clear, PopupMenuEmpty as Empty, PopupMenuGroup as Group, PopupMenuGroupLabel as GroupLabel, PopupMenuIcon as Icon, ComboboxInput as Input, ComboboxInputWrapper as InputWrapper, ComboboxItem as Item, ComboboxItemIndicator as ItemIndicator, ComboboxItemLabel as ItemLabel, PopupMenuList as List, PopupMenuPopup as Popup, PopupMenuPortal as Portal, ComboboxPositioner as Positioner, ComboboxRoot as Root, PopupMenuScrollDownArrow as ScrollDownArrow, PopupMenuScrollUpArrow as ScrollUpArrow, PopupMenuSeparator as Separator, ComboboxSurface as Surface, index_parts_VirtualItem as VirtualItem, index_parts_useComboboxPositionerContext as useComboboxPositionerContext };
696
+ declare namespace index_parts_d_exports {
697
+ export { PopupMenuArrow as Arrow, PopupMenuBackdrop as Backdrop, ComboboxClear as Clear, PopupMenuEmpty as Empty, PopupMenuGroup as Group, PopupMenuGroupLabel as GroupLabel, PopupMenuIcon as Icon, ComboboxInput as Input, ComboboxInputWrapper as InputWrapper, ComboboxItem as Item, ComboboxItemIndicator as ItemIndicator, ComboboxItemLabel as ItemLabel, PopupMenuList as List, PopupMenuPopup as Popup, PopupMenuPortal as Portal, ComboboxPositioner as Positioner, ComboboxRoot as Root, PopupMenuScrollDownArrow as ScrollDownArrow, PopupMenuScrollUpArrow as ScrollUpArrow, PopupMenuSeparator as Separator, ComboboxSurface as Surface, VirtualItem, useComboboxPositionerContext };
703
698
  }
704
-
705
- declare enum ComboboxArrowDataAttributes {
706
- /**
707
- * Identifies the component part.
708
- * @type {'bazzaui-combobox-arrow'}
709
- */
710
- slot = "bazzaui-combobox-arrow",
711
- /**
712
- * Present when the popup menu is open.
713
- */
714
- open = "data-open",
715
- /**
716
- * Present when the popup menu is closed.
717
- */
718
- closed = "data-closed",
719
- /**
720
- * Indicates which side the popup is positioned relative to the trigger.
721
- * @type {'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start'}
722
- */
723
- side = "data-side",
724
- /**
725
- * Indicates how the popup is aligned relative to specified side.
726
- * @type {'start' | 'center' | 'end'}
727
- */
728
- align = "data-align",
729
- /**
730
- * Present when the arrow is not centered due to collision avoidance.
731
- */
732
- uncentered = "data-uncentered"
699
+ //#endregion
700
+ //#region src/combobox/arrow/arrow.data-attrs.d.ts
701
+ export declare enum ComboboxArrowDataAttributes {
702
+ /**
703
+ * Identifies the component part.
704
+ * @type {'bazzaui-combobox-arrow'}
705
+ */
706
+ slot = "bazzaui-combobox-arrow",
707
+ /**
708
+ * Present when the popup menu is open.
709
+ */
710
+ open = "data-open",
711
+ /**
712
+ * Present when the popup menu is closed.
713
+ */
714
+ closed = "data-closed",
715
+ /**
716
+ * Indicates which side the popup is positioned relative to the trigger.
717
+ * @type {'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start'}
718
+ */
719
+ side = "data-side",
720
+ /**
721
+ * Indicates how the popup is aligned relative to specified side.
722
+ * @type {'start' | 'center' | 'end'}
723
+ */
724
+ align = "data-align",
725
+ /**
726
+ * Present when the arrow is not centered due to collision avoidance.
727
+ */
728
+ uncentered = "data-uncentered"
733
729
  }
734
-
735
- declare enum ComboboxBackdropDataAttributes {
736
- /**
737
- * Identifies the component part.
738
- * @type {'bazzaui-combobox-backdrop'}
739
- */
740
- slot = "bazzaui-combobox-backdrop",
741
- /**
742
- * Present when the popup menu is open.
743
- */
744
- open = "data-open",
745
- /**
746
- * Present when the popup menu is closed.
747
- */
748
- closed = "data-closed",
749
- /**
750
- * Present when the popup menu is animating in.
751
- */
752
- startingStyle = "data-starting-style",
753
- /**
754
- * Present when the popup menu is animating out.
755
- */
756
- endingStyle = "data-ending-style"
730
+ //#endregion
731
+ //#region src/combobox/backdrop/backdrop.data-attrs.d.ts
732
+ export declare enum ComboboxBackdropDataAttributes {
733
+ /**
734
+ * Identifies the component part.
735
+ * @type {'bazzaui-combobox-backdrop'}
736
+ */
737
+ slot = "bazzaui-combobox-backdrop",
738
+ /**
739
+ * Present when the popup menu is open.
740
+ */
741
+ open = "data-open",
742
+ /**
743
+ * Present when the popup menu is closed.
744
+ */
745
+ closed = "data-closed",
746
+ /**
747
+ * Present when the popup menu is animating in.
748
+ */
749
+ startingStyle = "data-starting-style",
750
+ /**
751
+ * Present when the popup menu is animating out.
752
+ */
753
+ endingStyle = "data-ending-style"
757
754
  }
758
-
759
- declare enum ComboboxEmptyDataAttributes {
760
- /**
761
- * Identifies the component part.
762
- * @type {'bazzaui-combobox-empty'}
763
- */
764
- slot = "bazzaui-combobox-empty"
755
+ //#endregion
756
+ //#region src/combobox/empty/empty.data-attrs.d.ts
757
+ export declare enum ComboboxEmptyDataAttributes {
758
+ /**
759
+ * Identifies the component part.
760
+ * @type {'bazzaui-combobox-empty'}
761
+ */
762
+ slot = "bazzaui-combobox-empty"
765
763
  }
766
-
767
- declare enum ComboboxGroupDataAttributes {
768
- /**
769
- * Identifies the component part.
770
- * @type {'bazzaui-combobox-group'}
771
- */
772
- slot = "bazzaui-combobox-group"
764
+ //#endregion
765
+ //#region src/combobox/group/group.data-attrs.d.ts
766
+ export declare enum ComboboxGroupDataAttributes {
767
+ /**
768
+ * Identifies the component part.
769
+ * @type {'bazzaui-combobox-group'}
770
+ */
771
+ slot = "bazzaui-combobox-group"
773
772
  }
774
-
775
- declare enum ComboboxGroupLabelDataAttributes {
776
- /**
777
- * Identifies the component part.
778
- * @type {'bazzaui-combobox-group-label'}
779
- */
780
- slot = "bazzaui-combobox-group-label"
773
+ //#endregion
774
+ //#region src/combobox/group-label/group-label.data-attrs.d.ts
775
+ export declare enum ComboboxGroupLabelDataAttributes {
776
+ /**
777
+ * Identifies the component part.
778
+ * @type {'bazzaui-combobox-group-label'}
779
+ */
780
+ slot = "bazzaui-combobox-group-label"
781
781
  }
782
-
783
- declare const ComboboxIconDataAttributes: {
784
- /**
785
- * Identifies the component part.
786
- * @type {'bazzaui-combobox-icon'}
787
- */
788
- readonly slot: "bazzaui-combobox-icon";
789
- /** Present when the popup is open. */
790
- readonly open: "data-popup-open";
782
+ //#endregion
783
+ //#region src/combobox/icon/icon.data-attrs.d.ts
784
+ export declare const ComboboxIconDataAttributes: {
785
+ /**
786
+ * Identifies the component part.
787
+ * @type {'bazzaui-combobox-icon'}
788
+ */
789
+ readonly slot: 'bazzaui-combobox-icon';
790
+ /** Present when the popup is open. */
791
+ readonly open: 'data-popup-open';
791
792
  };
792
-
793
- declare enum ComboboxListDataAttributes {
794
- /**
795
- * Identifies the component part.
796
- * @type {'bazzaui-combobox-list'}
797
- */
798
- slot = "bazzaui-combobox-list",
799
- /**
800
- * Always present on the list element.
801
- * Used for styling and by useStickyRowWidth to find the list container.
802
- */
803
- list = "data-popup-menu-list"
793
+ //#endregion
794
+ //#region src/combobox/list/list.data-attrs.d.ts
795
+ export declare enum ComboboxListDataAttributes {
796
+ /**
797
+ * Identifies the component part.
798
+ * @type {'bazzaui-combobox-list'}
799
+ */
800
+ slot = "bazzaui-combobox-list",
801
+ /**
802
+ * Always present on the list element.
803
+ * Used for styling and by useStickyRowWidth to find the list container.
804
+ */
805
+ list = "data-popup-menu-list"
804
806
  }
805
-
806
- declare enum ComboboxPopupDataAttributes {
807
- /**
808
- * Identifies the component part.
809
- * @type {'bazzaui-combobox-popup'}
810
- */
811
- slot = "bazzaui-combobox-popup",
812
- /**
813
- * Present when the popup menu is open.
814
- */
815
- open = "data-open",
816
- /**
817
- * Present when the popup menu is closed.
818
- */
819
- closed = "data-closed",
820
- /**
821
- * Indicates which side the popup is positioned relative to the trigger.
822
- * @type {'top' | 'bottom' | 'left' | 'right'}
823
- */
824
- side = "data-side",
825
- /**
826
- * Indicates how the popup is aligned relative to specified side.
827
- * @type {'start' | 'center' | 'end'}
828
- */
829
- align = "data-align",
830
- /**
831
- * Present when the popup is animating in.
832
- */
833
- startingStyle = "data-starting-style",
834
- /**
835
- * Present when the popup is animating out.
836
- */
837
- endingStyle = "data-ending-style",
838
- /**
839
- * Present if animations should be instant.
840
- * @type {'click' | 'dismiss'}
841
- */
842
- instant = "data-instant",
843
- /**
844
- * Present when this popup's surface is the focus owner.
845
- * Useful for styling the currently focused menu in a submenu chain.
846
- */
847
- focused = "data-focused",
848
- /**
849
- * Present when this popup has an open submenu below it in the menu tree.
850
- * Useful for styling all parent menus in an open submenu chain.
851
- */
852
- hasOpenSubmenu = "data-has-open-submenu",
853
- /**
854
- * Present when this popup is a submenu (not the root menu).
855
- * Useful for applying different styles to submenus vs root menus.
856
- */
857
- submenu = "data-submenu",
858
- /**
859
- * Present while navigating between subpages in this popup.
860
- * Useful for temporary transition adjustments during subpage focus handoff.
861
- */
862
- navigating = "data-navigating"
807
+ //#endregion
808
+ //#region src/combobox/popup/popup.data-attrs.d.ts
809
+ export declare enum ComboboxPopupDataAttributes {
810
+ /**
811
+ * Identifies the component part.
812
+ * @type {'bazzaui-combobox-popup'}
813
+ */
814
+ slot = "bazzaui-combobox-popup",
815
+ /**
816
+ * Present when the popup menu is open.
817
+ */
818
+ open = "data-open",
819
+ /**
820
+ * Present when the popup menu is closed.
821
+ */
822
+ closed = "data-closed",
823
+ /**
824
+ * Indicates which side the popup is positioned relative to the trigger.
825
+ * @type {'top' | 'bottom' | 'left' | 'right'}
826
+ */
827
+ side = "data-side",
828
+ /**
829
+ * Indicates how the popup is aligned relative to specified side.
830
+ * @type {'start' | 'center' | 'end'}
831
+ */
832
+ align = "data-align",
833
+ /**
834
+ * Present when the popup is animating in.
835
+ */
836
+ startingStyle = "data-starting-style",
837
+ /**
838
+ * Present when the popup is animating out.
839
+ */
840
+ endingStyle = "data-ending-style",
841
+ /**
842
+ * Present if animations should be instant.
843
+ * @type {'click' | 'dismiss'}
844
+ */
845
+ instant = "data-instant",
846
+ /**
847
+ * Present when this popup's surface is the focus owner.
848
+ * Useful for styling the currently focused menu in a submenu chain.
849
+ */
850
+ focused = "data-focused",
851
+ /**
852
+ * Present when this popup has an open submenu below it in the menu tree.
853
+ * Useful for styling all parent menus in an open submenu chain.
854
+ */
855
+ hasOpenSubmenu = "data-has-open-submenu",
856
+ /**
857
+ * Present when this popup is a submenu (not the root menu).
858
+ * Useful for applying different styles to submenus vs root menus.
859
+ */
860
+ submenu = "data-submenu",
861
+ /**
862
+ * Present while navigating between subpages in this popup.
863
+ * Useful for temporary transition adjustments during subpage focus handoff.
864
+ */
865
+ navigating = "data-navigating"
863
866
  }
864
-
865
- declare const ComboboxScrollArrowDataAttributes: {
866
- /**
867
- * Identifies the component part for scroll up arrow.
868
- * @type {'bazzaui-combobox-scroll-up-arrow'}
869
- */
870
- readonly slotUp: "bazzaui-combobox-scroll-up-arrow";
871
- /**
872
- * Identifies the component part for scroll down arrow.
873
- * @type {'bazzaui-combobox-scroll-down-arrow'}
874
- */
875
- readonly slotDown: "bazzaui-combobox-scroll-down-arrow";
876
- /**
877
- * Direction of the scroll arrow.
878
- * @type {'up' | 'down'}
879
- */
880
- readonly direction: "data-direction";
881
- /**
882
- * Side of the popup.
883
- * @type {'top' | 'bottom' | 'left' | 'right'}
884
- */
885
- readonly side: "data-side";
867
+ //#endregion
868
+ //#region src/combobox/scroll-arrow/scroll-arrow.data-attrs.d.ts
869
+ export declare const ComboboxScrollArrowDataAttributes: {
870
+ /**
871
+ * Identifies the component part for scroll up arrow.
872
+ * @type {'bazzaui-combobox-scroll-up-arrow'}
873
+ */
874
+ readonly slotUp: 'bazzaui-combobox-scroll-up-arrow';
875
+ /**
876
+ * Identifies the component part for scroll down arrow.
877
+ * @type {'bazzaui-combobox-scroll-down-arrow'}
878
+ */
879
+ readonly slotDown: 'bazzaui-combobox-scroll-down-arrow';
880
+ /**
881
+ * Direction of the scroll arrow.
882
+ * @type {'up' | 'down'}
883
+ */
884
+ readonly direction: 'data-direction';
885
+ /**
886
+ * Side of the popup.
887
+ * @type {'top' | 'bottom' | 'left' | 'right'}
888
+ */
889
+ readonly side: 'data-side';
886
890
  };
887
-
888
- declare enum ComboboxSeparatorDataAttributes {
889
- /**
890
- * Identifies the component part.
891
- * @type {'bazzaui-combobox-separator'}
892
- */
893
- slot = "bazzaui-combobox-separator"
891
+ //#endregion
892
+ //#region src/combobox/separator/separator.data-attrs.d.ts
893
+ export declare enum ComboboxSeparatorDataAttributes {
894
+ /**
895
+ * Identifies the component part.
896
+ * @type {'bazzaui-combobox-separator'}
897
+ */
898
+ slot = "bazzaui-combobox-separator"
894
899
  }
895
-
900
+ //#endregion
901
+ //#region src/combobox/contexts/combobox-context.d.ts
896
902
  /**
897
903
  * Filter mode for the combobox.
898
904
  * Controls how the search/filter value is determined.
@@ -904,12 +910,12 @@ declare enum ComboboxSeparatorDataAttributes {
904
910
  * - Open → close → { type: 'frozen', search: <current> }
905
911
  */
906
912
  type ComboboxFilterMode = {
907
- type: 'active';
913
+ type: 'active';
908
914
  } | {
909
- type: 'showAll';
915
+ type: 'showAll';
910
916
  } | {
911
- type: 'frozen';
912
- search: string;
917
+ type: 'frozen';
918
+ search: string;
913
919
  };
914
920
  /**
915
921
  * Item text registry for displaying selected values.
@@ -923,115 +929,116 @@ type ItemTextRegistry = Map<string, string>;
923
929
  * @template Value - The type of the combobox value (can be a primitive or object)
924
930
  */
925
931
  interface ComboboxContextValue<Value = unknown> {
926
- /** Whether multi-select mode is enabled */
927
- multiple: boolean;
928
- /** Current selected value (single-select mode) */
929
- value: Value | null;
930
- /** Current selected values (multi-select mode) */
931
- values: Value[];
932
- /** Callback when value changes (single-select mode) */
933
- onValueChange: (value: Value | null) => void;
934
- /** Callback when values change (multi-select mode) */
935
- onValuesChange: (values: Value[]) => void;
936
- /**
937
- * Custom comparison logic used to determine if a combobox item value
938
- * matches the current selected value.
939
- * Useful when item values are objects without matching referentially.
940
- * Defaults to Object.is comparison.
941
- */
942
- isItemEqualToValue: ItemEqualityComparer<Value>;
943
- /**
944
- * When the item values are objects, this function converts the object
945
- * value to a string representation for display in the input.
946
- * If the shape of the object is { value, label }, the label will be
947
- * used automatically without needing to specify this prop.
948
- */
949
- itemToStringLabel?: (itemValue: Value) => string;
950
- /**
951
- * When the item values are objects, this function converts the object
952
- * value to a string representation for form submission.
953
- * If the shape of the object is { value, label }, the value will be
954
- * used automatically without needing to specify this prop.
955
- */
956
- itemToStringValue?: (itemValue: Value) => string;
957
- /** Current input value */
958
- inputValue: string;
959
- /** Callback when input value changes */
960
- onInputValueChange: (value: string) => void;
961
- /** Form field name for submission */
962
- name?: string;
963
- /** Associate with a form by ID */
964
- form?: string;
965
- /** Whether this field is required */
966
- required?: boolean;
967
- /** Whether the combobox is disabled */
968
- disabled: boolean;
969
- /** Placeholder text for the input */
970
- placeholder: string;
971
- /** Registry of item values to their text content */
972
- itemTextRegistry: ItemTextRegistry;
973
- /** Register an item's text content */
974
- registerItemText: (value: string, text: string) => () => void;
975
- /**
976
- * Data structure of the items for label resolution.
977
- * Used to display labels before items mount (e.g., on initial render with defaultValue).
978
- * Can be a record mapping values to labels, or an array of
979
- * `{ value, label, keywords? }` objects.
980
- */
981
- items?: Items;
982
- /** ID for the listbox element */
983
- listId: string;
984
- /** Ref to the input element (also serves as anchor) */
985
- inputRef: React.RefObject<HTMLInputElement | null>;
986
- /** Callback to set the input element */
987
- setInputElement: (element: HTMLInputElement | null) => void;
988
- /** Ref to the input wrapper element (used as anchor when present) */
989
- inputWrapperRef: React.RefObject<HTMLElement | null>;
990
- /** Callback to set the input wrapper element */
991
- setInputWrapperElement: (element: HTMLElement | null) => void;
992
- /** Whether to close on selection (default: true for single, false for multiple) */
993
- closeOnSelect: boolean;
994
- /** Whether to open on focus */
995
- openOnFocus: boolean;
996
- /** Open the combobox */
997
- openCombobox: () => void;
998
- /** Close the combobox with an optional reason and event */
999
- closeCombobox: (reason?: ComboboxOpenChangeReason, event?: Event) => void;
1000
- /**
1001
- * Current filter mode for the combobox.
1002
- * Controls how the search/filter value is determined.
1003
- */
1004
- filterMode: ComboboxFilterMode;
1005
- /** Set the filter mode to 'active' (normal filtering using inputValue) */
1006
- setFilterActive: () => void;
1007
- /**
1008
- * Height of the input element in pixels.
1009
- * Used by the positioner for input-embedded layout calculations.
1010
- */
1011
- inputHeight: number;
1012
- /**
1013
- * Width of the input element in pixels.
1014
- * Used by the positioner for input-embedded layout calculations.
1015
- */
1016
- inputWidth: number;
1017
- /**
1018
- * The layout mode for the combobox popup.
1019
- * - `'floating'` - Standard dropdown positioning
1020
- * - `'input-embedded'` - Popup wraps around the input (macOS-style)
1021
- */
1022
- layout: ComboboxLayout;
932
+ /** Whether multi-select mode is enabled */
933
+ multiple: boolean;
934
+ /** Current selected value (single-select mode) */
935
+ value: Value | null;
936
+ /** Current selected values (multi-select mode) */
937
+ values: Value[];
938
+ /** Callback when value changes (single-select mode) */
939
+ onValueChange: (value: Value | null) => void;
940
+ /** Callback when values change (multi-select mode) */
941
+ onValuesChange: (values: Value[]) => void;
942
+ /**
943
+ * Custom comparison logic used to determine if a combobox item value
944
+ * matches the current selected value.
945
+ * Useful when item values are objects without matching referentially.
946
+ * Defaults to Object.is comparison.
947
+ */
948
+ isItemEqualToValue: ItemEqualityComparer<Value>;
949
+ /**
950
+ * When the item values are objects, this function converts the object
951
+ * value to a string representation for display in the input.
952
+ * If the shape of the object is { value, label }, the label will be
953
+ * used automatically without needing to specify this prop.
954
+ */
955
+ itemToStringLabel?: (itemValue: Value) => string;
956
+ /**
957
+ * When the item values are objects, this function converts the object
958
+ * value to a string representation for form submission.
959
+ * If the shape of the object is { value, label }, the value will be
960
+ * used automatically without needing to specify this prop.
961
+ */
962
+ itemToStringValue?: (itemValue: Value) => string;
963
+ /** Current input value */
964
+ inputValue: string;
965
+ /** Callback when input value changes */
966
+ onInputValueChange: (value: string) => void;
967
+ /** Form field name for submission */
968
+ name?: string;
969
+ /** Associate with a form by ID */
970
+ form?: string;
971
+ /** Whether this field is required */
972
+ required?: boolean;
973
+ /** Whether the combobox is disabled */
974
+ disabled: boolean;
975
+ /** Placeholder text for the input */
976
+ placeholder: string;
977
+ /** Registry of item values to their text content */
978
+ itemTextRegistry: ItemTextRegistry;
979
+ /** Register an item's text content */
980
+ registerItemText: (value: string, text: string) => () => void;
981
+ /**
982
+ * Data structure of the items for label resolution.
983
+ * Used to display labels before items mount (e.g., on initial render with defaultValue).
984
+ * Can be a record mapping values to labels, or an array of
985
+ * `{ value, label, keywords? }` objects.
986
+ */
987
+ items?: Items;
988
+ /** ID for the listbox element */
989
+ listId: string;
990
+ /** Ref to the input element (also serves as anchor) */
991
+ inputRef: React.RefObject<HTMLInputElement | null>;
992
+ /** Callback to set the input element */
993
+ setInputElement: (element: HTMLInputElement | null) => void;
994
+ /** Ref to the input wrapper element (used as anchor when present) */
995
+ inputWrapperRef: React.RefObject<HTMLElement | null>;
996
+ /** Callback to set the input wrapper element */
997
+ setInputWrapperElement: (element: HTMLElement | null) => void;
998
+ /** Whether to close on selection (default: true for single, false for multiple) */
999
+ closeOnSelect: boolean;
1000
+ /** Whether to open on focus */
1001
+ openOnFocus: boolean;
1002
+ /** Open the combobox */
1003
+ openCombobox: () => void;
1004
+ /** Close the combobox with an optional reason and event */
1005
+ closeCombobox: (reason?: ComboboxOpenChangeReason, event?: Event) => void;
1006
+ /**
1007
+ * Current filter mode for the combobox.
1008
+ * Controls how the search/filter value is determined.
1009
+ */
1010
+ filterMode: ComboboxFilterMode;
1011
+ /** Set the filter mode to 'active' (normal filtering using inputValue) */
1012
+ setFilterActive: () => void;
1013
+ /**
1014
+ * Height of the input element in pixels.
1015
+ * Used by the positioner for input-embedded layout calculations.
1016
+ */
1017
+ inputHeight: number;
1018
+ /**
1019
+ * Width of the input element in pixels.
1020
+ * Used by the positioner for input-embedded layout calculations.
1021
+ */
1022
+ inputWidth: number;
1023
+ /**
1024
+ * The layout mode for the combobox popup.
1025
+ * - `'floating'` - Standard dropdown positioning
1026
+ * - `'input-embedded'` - Popup wraps around the input (macOS-style)
1027
+ */
1028
+ layout: ComboboxLayout;
1023
1029
  }
1024
1030
  /**
1025
1031
  * Hook to access the Combobox context.
1026
1032
  * Throws if used outside a Combobox.Root.
1027
1033
  */
1028
- declare function useComboboxContext<Value = unknown>(): ComboboxContextValue<Value>;
1034
+ export declare function useComboboxContext<Value = unknown>(): ComboboxContextValue<Value>;
1029
1035
  /**
1030
1036
  * Hook to optionally access the Combobox context.
1031
1037
  * Returns null if used outside a Combobox.Root.
1032
1038
  */
1033
- declare function useMaybeComboboxContext<Value = unknown>(): ComboboxContextValue<Value> | null;
1034
-
1039
+ export declare function useMaybeComboboxContext<Value = unknown>(): ComboboxContextValue<Value> | null;
1040
+ //#endregion
1041
+ //#region src/combobox/item/item-context.d.ts
1035
1042
  /**
1036
1043
  * Context value for ComboboxItem.
1037
1044
  * Provides item state to child components like ItemIndicator.
@@ -1039,28 +1046,29 @@ declare function useMaybeComboboxContext<Value = unknown>(): ComboboxContextValu
1039
1046
  * @template Value - The type of the item value (can be a primitive or object)
1040
1047
  */
1041
1048
  interface ComboboxItemContextValue<Value = unknown> {
1042
- /** Unique ID for the item element */
1043
- id: string;
1044
- /** The item's value */
1045
- value: Value | null;
1046
- /** The text value/label for this item */
1047
- textValue: string | undefined;
1048
- /** Whether the item is highlighted (via keyboard or pointer) */
1049
- highlighted: boolean;
1050
- /** Whether the item is disabled */
1051
- disabled: boolean;
1052
- /** Whether the item is selected */
1053
- selected: boolean;
1049
+ /** Unique ID for the item element */
1050
+ id: string;
1051
+ /** The item's value */
1052
+ value: Value | null;
1053
+ /** The text value/label for this item */
1054
+ textValue: string | undefined;
1055
+ /** Whether the item is highlighted (via keyboard or pointer) */
1056
+ highlighted: boolean;
1057
+ /** Whether the item is disabled */
1058
+ disabled: boolean;
1059
+ /** Whether the item is selected */
1060
+ selected: boolean;
1054
1061
  }
1055
1062
  /**
1056
1063
  * Hook to access the ComboboxItem context.
1057
1064
  * Throws if used outside a ComboboxItem.
1058
1065
  */
1059
- declare function useComboboxItemContext<Value = unknown>(): ComboboxItemContextValue<Value>;
1066
+ export declare function useComboboxItemContext<Value = unknown>(): ComboboxItemContextValue<Value>;
1060
1067
  /**
1061
1068
  * Hook to optionally access the ComboboxItem context.
1062
1069
  * Returns null if used outside a ComboboxItem.
1063
1070
  */
1064
- declare function useMaybeComboboxItemContext<Value = unknown>(): ComboboxItemContextValue<Value> | null;
1065
-
1066
- export { index_parts as Combobox, PopupMenuArrow as ComboboxArrow, ComboboxArrowDataAttributes, PopupMenuBackdrop as ComboboxBackdrop, ComboboxBackdropDataAttributes, ComboboxClear, type ComboboxClearProps, type ComboboxClearState, type ComboboxContextValue, PopupMenuEmpty as ComboboxEmpty, ComboboxEmptyDataAttributes, PopupMenuGroup as ComboboxGroup, ComboboxGroupDataAttributes, PopupMenuGroupLabel as ComboboxGroupLabel, ComboboxGroupLabelDataAttributes, ComboboxIconDataAttributes, ComboboxInput, type ComboboxInputCursorBehavior, ComboboxInputDataAttributes, type ComboboxInputProps, type ComboboxInputState, ComboboxInputWrapper, ComboboxInputWrapperDataAttributes, type ComboboxInputWrapperProps, type ComboboxInputWrapperState, ComboboxItem, type ComboboxItemContextValue, ComboboxItemDataAttributes, ComboboxItemIndicator, ComboboxItemIndicatorDataAttributes, type ComboboxItemIndicatorProps, type ComboboxItemIndicatorState, ComboboxItemLabel, type ComboboxItemLabelProps, type ComboboxItemProps, type ComboboxItemState, type ComboboxLayout, PopupMenuList as ComboboxList, ComboboxListDataAttributes, PopupMenuPopup as ComboboxPopup, ComboboxPopupDataAttributes, PopupMenuPortal as ComboboxPortal, ComboboxPositioner, type ComboboxPositionerContextValue, ComboboxPositionerDataAttributes, type ComboboxPositionerProps, ComboboxRoot, type ComboboxRootProps, ComboboxScrollArrowDataAttributes, PopupMenuSeparator as ComboboxSeparator, ComboboxSeparatorDataAttributes, ComboboxSurface, type ComboboxSurfaceProps, VirtualItem as ComboboxVirtualItem, useComboboxContext, useComboboxItemContext, useComboboxPositionerContext, useMaybeComboboxContext, useMaybeComboboxItemContext };
1071
+ export declare function useMaybeComboboxItemContext<Value = unknown>(): ComboboxItemContextValue<Value> | null;
1072
+ //#endregion
1073
+ export { index_parts_d_exports as Combobox, type PopupMenuArrow as ComboboxArrow, type PopupMenuArrowProps as ComboboxArrowProps, type PopupMenuBackdrop as ComboboxBackdrop, type PopupMenuBackdropProps as ComboboxBackdropProps, type ComboboxClearProps, type ComboboxClearState, type ComboboxContextValue, type PopupMenuEmpty as ComboboxEmpty, type PopupMenuEmptyProps as ComboboxEmptyProps, type PopupMenuEmptyState as ComboboxEmptyState, type FilterFn as ComboboxFilterFn, type PopupMenuGroup as ComboboxGroup, type PopupMenuGroupLabel as ComboboxGroupLabel, type PopupMenuGroupLabelProps as ComboboxGroupLabelProps, type PopupMenuGroupLabelState as ComboboxGroupLabelState, type PopupMenuGroupProps as ComboboxGroupProps, type PopupMenuGroupState as ComboboxGroupState, type PopupMenuIconProps as ComboboxIconProps, type PopupMenuIconState as ComboboxIconState, type ComboboxInputCursorBehavior, type ComboboxInputProps, type ComboboxInputState, type ComboboxInputWrapperProps, type ComboboxInputWrapperState, type ComboboxItemContextValue, type ComboboxItemIndicatorProps, type ComboboxItemIndicatorState, type ComboboxItemLabelProps, type ComboboxItemProps, type ItemRegistration as ComboboxItemRegistration, type ComboboxItemState, type ComboboxLayout, type PopupMenuList as ComboboxList, type PopupMenuListChildrenState as ComboboxListChildrenState, PopupMenuListCssVars as ComboboxListCssVars, type PopupMenuListProps as ComboboxListProps, type PopupMenuListState as ComboboxListState, type PopupMenuPopup as ComboboxPopup, type PopupMenuPopupProps as ComboboxPopupProps, type PopupMenuPortal as ComboboxPortal, type PopupMenuPortalProps as ComboboxPortalProps, type ComboboxPositionerContextValue, PopupMenuPositionerCssVars as ComboboxPositionerCssVars, type ComboboxPositionerProps, type ComboboxRootProps, type PopupMenuScrollArrowProps as ComboboxScrollArrowProps, type PopupMenuScrollArrowState as ComboboxScrollArrowState, type PopupMenuScrollDownArrowProps as ComboboxScrollDownArrowProps, type PopupMenuScrollUpArrowProps as ComboboxScrollUpArrowProps, type PopupMenuSeparator as ComboboxSeparator, type PopupMenuSeparatorProps as ComboboxSeparatorProps, type PopupMenuSeparatorState as ComboboxSeparatorState, ListboxStore as ComboboxStore, type ListboxContext as ComboboxStoreContext, type ListboxState as ComboboxStoreState, type ComboboxSurfaceProps, type PopupMenuSurfaceState as ComboboxSurfaceState, type VirtualItem as ComboboxVirtualItem, type SurfaceContextValue, commandScore, defaultFilter, useMaybeSurfaceContext, useSurfaceContext };
1074
+ //# sourceMappingURL=index.d.ts.map