@proyecto-viviana/solidaria 0.2.4 → 0.2.8

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 (219) hide show
  1. package/LICENSE +21 -0
  2. package/dist/actiongroup/createActionGroup.d.ts +29 -0
  3. package/dist/actiongroup/createActionGroup.d.ts.map +1 -0
  4. package/dist/actiongroup/index.d.ts +2 -0
  5. package/dist/actiongroup/index.d.ts.map +1 -0
  6. package/dist/autocomplete/createAutocomplete.d.ts +6 -2
  7. package/dist/autocomplete/createAutocomplete.d.ts.map +1 -1
  8. package/dist/breadcrumbs/createBreadcrumbs.d.ts +2 -0
  9. package/dist/breadcrumbs/createBreadcrumbs.d.ts.map +1 -1
  10. package/dist/button/createToggleButtonGroup.d.ts +32 -0
  11. package/dist/button/createToggleButtonGroup.d.ts.map +1 -0
  12. package/dist/button/index.d.ts +2 -0
  13. package/dist/button/index.d.ts.map +1 -1
  14. package/dist/calendar/createCalendarCell.d.ts +2 -0
  15. package/dist/calendar/createCalendarCell.d.ts.map +1 -1
  16. package/dist/calendar/createCalendarGrid.d.ts.map +1 -1
  17. package/dist/calendar/createRangeCalendarCell.d.ts +3 -1
  18. package/dist/calendar/createRangeCalendarCell.d.ts.map +1 -1
  19. package/dist/checkbox/createCheckboxGroup.d.ts +5 -1
  20. package/dist/checkbox/createCheckboxGroup.d.ts.map +1 -1
  21. package/dist/collections/index.d.ts +56 -0
  22. package/dist/collections/index.d.ts.map +1 -0
  23. package/dist/color/createColorArea.d.ts.map +1 -1
  24. package/dist/color/createColorSlider.d.ts.map +1 -1
  25. package/dist/color/createColorWheel.d.ts.map +1 -1
  26. package/dist/combobox/createComboBox.d.ts +6 -0
  27. package/dist/combobox/createComboBox.d.ts.map +1 -1
  28. package/dist/datepicker/createDatePicker.d.ts +6 -0
  29. package/dist/datepicker/createDatePicker.d.ts.map +1 -1
  30. package/dist/datepicker/createDateRangePicker.d.ts +40 -0
  31. package/dist/datepicker/createDateRangePicker.d.ts.map +1 -0
  32. package/dist/datepicker/createDateSegment.d.ts +1 -1
  33. package/dist/datepicker/createDateSegment.d.ts.map +1 -1
  34. package/dist/datepicker/createTimeSegment.d.ts +29 -0
  35. package/dist/datepicker/createTimeSegment.d.ts.map +1 -0
  36. package/dist/datepicker/index.d.ts +2 -0
  37. package/dist/datepicker/index.d.ts.map +1 -1
  38. package/dist/disclosure/createDisclosureGroup.d.ts +2 -1
  39. package/dist/disclosure/createDisclosureGroup.d.ts.map +1 -1
  40. package/dist/dnd/createDrag.d.ts.map +1 -1
  41. package/dist/dnd/createDraggableCollection.d.ts +4 -0
  42. package/dist/dnd/createDraggableCollection.d.ts.map +1 -1
  43. package/dist/dnd/createDraggableItem.d.ts.map +1 -1
  44. package/dist/dnd/createDrop.d.ts.map +1 -1
  45. package/dist/dnd/createDroppableCollection.d.ts +32 -1
  46. package/dist/dnd/createDroppableCollection.d.ts.map +1 -1
  47. package/dist/dnd/createDroppableItem.d.ts.map +1 -1
  48. package/dist/dnd/index.d.ts +1 -1
  49. package/dist/dnd/index.d.ts.map +1 -1
  50. package/dist/grid/createGrid.d.ts.map +1 -1
  51. package/dist/gridlist/createGridList.d.ts.map +1 -1
  52. package/dist/index.d.ts +6 -4
  53. package/dist/index.d.ts.map +1 -1
  54. package/dist/index.js +4659 -3452
  55. package/dist/index.js.map +1 -7
  56. package/dist/index.ssr.js +4659 -3452
  57. package/dist/index.ssr.js.map +1 -7
  58. package/dist/interactions/createFocus.d.ts.map +1 -1
  59. package/dist/interactions/createFocusWithin.d.ts.map +1 -1
  60. package/dist/link/createLink.d.ts +10 -0
  61. package/dist/link/createLink.d.ts.map +1 -1
  62. package/dist/listbox/createListBox.d.ts +1 -0
  63. package/dist/listbox/createListBox.d.ts.map +1 -1
  64. package/dist/listbox/createOption.d.ts.map +1 -1
  65. package/dist/menu/createMenu.d.ts +1 -0
  66. package/dist/menu/createMenu.d.ts.map +1 -1
  67. package/dist/meter/createMeter.d.ts.map +1 -1
  68. package/dist/numberfield/createNumberField.d.ts +18 -0
  69. package/dist/numberfield/createNumberField.d.ts.map +1 -1
  70. package/dist/overlays/createModal.d.ts +16 -0
  71. package/dist/overlays/createModal.d.ts.map +1 -1
  72. package/dist/overlays/createOverlay.d.ts.map +1 -1
  73. package/dist/overlays/index.d.ts +1 -1
  74. package/dist/overlays/index.d.ts.map +1 -1
  75. package/dist/popover/createOverlayPosition.d.ts.map +1 -1
  76. package/dist/popover/createPopover.d.ts.map +1 -1
  77. package/dist/progress/createProgressBar.d.ts.map +1 -1
  78. package/dist/radio/createRadioGroup.d.ts +2 -2
  79. package/dist/radio/createRadioGroup.d.ts.map +1 -1
  80. package/dist/searchfield/createSearchField.d.ts.map +1 -1
  81. package/dist/select/createHiddenSelect.d.ts.map +1 -1
  82. package/dist/select/createSelect.d.ts.map +1 -1
  83. package/dist/slider/createSlider.d.ts.map +1 -1
  84. package/dist/table/createTable.d.ts.map +1 -1
  85. package/dist/tabs/createTabs.d.ts +1 -1
  86. package/dist/tabs/createTabs.d.ts.map +1 -1
  87. package/dist/tag/createTag.d.ts.map +1 -1
  88. package/dist/tag/createTagGroup.d.ts.map +1 -1
  89. package/dist/toast/createToast.d.ts +4 -0
  90. package/dist/toast/createToast.d.ts.map +1 -1
  91. package/dist/toast/createToastRegion.d.ts.map +1 -1
  92. package/dist/toolbar/createToolbar.d.ts.map +1 -1
  93. package/dist/tooltip/createTooltipTrigger.d.ts.map +1 -1
  94. package/dist/tree/createTree.d.ts.map +1 -1
  95. package/dist/tree/createTreeItem.d.ts.map +1 -1
  96. package/dist/tree/types.d.ts +4 -0
  97. package/dist/tree/types.d.ts.map +1 -1
  98. package/dist/utils/env.d.ts +1 -1
  99. package/dist/utils/env.d.ts.map +1 -1
  100. package/dist/utils/platform.d.ts.map +1 -1
  101. package/dist/visually-hidden/createVisuallyHidden.d.ts.map +1 -1
  102. package/package.json +8 -6
  103. package/src/actiongroup/createActionGroup.ts +324 -0
  104. package/src/actiongroup/index.ts +8 -0
  105. package/src/autocomplete/createAutocomplete.ts +32 -9
  106. package/src/breadcrumbs/createBreadcrumbs.ts +10 -15
  107. package/src/button/createButton.ts +1 -1
  108. package/src/button/createToggleButtonGroup.ts +128 -0
  109. package/src/button/index.ts +9 -0
  110. package/src/calendar/createCalendarCell.ts +6 -4
  111. package/src/calendar/createCalendarGrid.ts +27 -18
  112. package/src/calendar/createRangeCalendarCell.ts +26 -9
  113. package/src/checkbox/createCheckboxGroup.ts +21 -4
  114. package/src/collections/index.ts +242 -0
  115. package/src/color/createColorArea.ts +380 -314
  116. package/src/color/createColorField.ts +137 -137
  117. package/src/color/createColorSlider.ts +286 -197
  118. package/src/color/createColorSwatch.ts +40 -40
  119. package/src/color/createColorWheel.ts +218 -208
  120. package/src/color/index.ts +24 -24
  121. package/src/color/types.ts +116 -116
  122. package/src/combobox/createComboBox.ts +670 -647
  123. package/src/combobox/index.ts +6 -6
  124. package/src/datepicker/createDatePicker.ts +54 -16
  125. package/src/datepicker/createDateRangePicker.ts +246 -0
  126. package/src/datepicker/createDateSegment.ts +185 -31
  127. package/src/datepicker/createTimeSegment.ts +370 -0
  128. package/src/datepicker/index.ts +14 -0
  129. package/src/dialog/createDialog.ts +120 -120
  130. package/src/dialog/index.ts +2 -2
  131. package/src/dialog/types.ts +19 -19
  132. package/src/disclosure/createDisclosureGroup.ts +5 -2
  133. package/src/dnd/createDrag.ts +224 -209
  134. package/src/dnd/createDraggableCollection.ts +96 -63
  135. package/src/dnd/createDraggableItem.ts +259 -243
  136. package/src/dnd/createDrop.ts +322 -321
  137. package/src/dnd/createDroppableCollection.ts +682 -293
  138. package/src/dnd/createDroppableItem.ts +215 -213
  139. package/src/dnd/index.ts +55 -47
  140. package/src/dnd/types.ts +89 -89
  141. package/src/dnd/utils.ts +294 -294
  142. package/src/focus/createAutoFocus.ts +321 -321
  143. package/src/focus/createFocusRestore.ts +313 -313
  144. package/src/focus/createVirtualFocus.ts +396 -396
  145. package/src/form/createFormValidation.ts +224 -224
  146. package/src/form/index.ts +11 -11
  147. package/src/grid/createGrid.ts +3 -1
  148. package/src/gridlist/createGridList.ts +16 -0
  149. package/src/gridlist/createGridListItem.ts +1 -1
  150. package/src/i18n/NumberFormatter.ts +266 -266
  151. package/src/i18n/createCollator.ts +79 -79
  152. package/src/i18n/createDateFormatter.ts +83 -83
  153. package/src/i18n/createFilter.ts +131 -131
  154. package/src/i18n/createNumberFormatter.ts +52 -52
  155. package/src/i18n/index.ts +40 -40
  156. package/src/i18n/locale.tsx +188 -188
  157. package/src/i18n/utils.ts +99 -99
  158. package/src/index.ts +51 -0
  159. package/src/interactions/createFocus.ts +6 -5
  160. package/src/interactions/createFocusWithin.ts +6 -5
  161. package/src/interactions/createLongPress.ts +174 -174
  162. package/src/interactions/createMove.ts +289 -289
  163. package/src/interactions/createPress.ts +5 -5
  164. package/src/landmark/createLandmark.ts +377 -377
  165. package/src/landmark/index.ts +8 -8
  166. package/src/link/createLink.ts +23 -8
  167. package/src/listbox/createListBox.ts +308 -269
  168. package/src/listbox/createOption.ts +162 -151
  169. package/src/listbox/index.ts +12 -12
  170. package/src/live-announcer/announce.ts +322 -322
  171. package/src/live-announcer/index.ts +9 -9
  172. package/src/menu/createMenu.ts +405 -396
  173. package/src/menu/createMenuItem.ts +149 -149
  174. package/src/menu/createMenuTrigger.ts +88 -88
  175. package/src/menu/index.ts +18 -18
  176. package/src/meter/createMeter.ts +1 -6
  177. package/src/numberfield/createNumberField.ts +311 -268
  178. package/src/numberfield/index.ts +5 -5
  179. package/src/overlays/ariaHideOutside.ts +219 -219
  180. package/src/overlays/createInteractOutside.ts +149 -149
  181. package/src/overlays/createModal.tsx +238 -202
  182. package/src/overlays/createOverlay.ts +165 -155
  183. package/src/overlays/createOverlayTrigger.ts +85 -85
  184. package/src/overlays/createPreventScroll.ts +266 -266
  185. package/src/overlays/index.ts +48 -44
  186. package/src/popover/calculatePosition.ts +6 -6
  187. package/src/popover/createOverlayPosition.ts +7 -4
  188. package/src/popover/createPopover.ts +21 -7
  189. package/src/progress/createProgressBar.ts +6 -1
  190. package/src/radio/createRadioGroup.ts +88 -14
  191. package/src/searchfield/createSearchField.ts +241 -186
  192. package/src/searchfield/index.ts +2 -2
  193. package/src/select/createHiddenSelect.tsx +263 -236
  194. package/src/select/createSelect.ts +373 -395
  195. package/src/select/index.ts +14 -14
  196. package/src/slider/createSlider.ts +364 -349
  197. package/src/slider/index.ts +2 -2
  198. package/src/ssr/index.tsx +370 -370
  199. package/src/table/createTable.ts +3 -1
  200. package/src/table/createTableColumnHeader.ts +1 -1
  201. package/src/table/createTableRow.ts +1 -1
  202. package/src/tabs/createTabs.ts +80 -51
  203. package/src/tag/createTag.ts +135 -6
  204. package/src/tag/createTagGroup.ts +7 -2
  205. package/src/toast/createToast.ts +8 -2
  206. package/src/toast/createToastRegion.ts +0 -1
  207. package/src/toolbar/createToolbar.ts +75 -1
  208. package/src/tooltip/createTooltip.ts +79 -79
  209. package/src/tooltip/createTooltipTrigger.ts +226 -222
  210. package/src/tooltip/index.ts +6 -6
  211. package/src/tree/createTree.ts +261 -246
  212. package/src/tree/createTreeItem.ts +282 -233
  213. package/src/tree/createTreeSelectionCheckbox.ts +68 -68
  214. package/src/tree/index.ts +16 -16
  215. package/src/tree/types.ts +91 -87
  216. package/src/utils/env.ts +55 -54
  217. package/src/utils/platform.ts +16 -6
  218. package/src/visually-hidden/createVisuallyHidden.ts +139 -124
  219. package/src/visually-hidden/index.ts +6 -6
@@ -1,395 +1,373 @@
1
- /**
2
- * Provides the behavior and accessibility implementation for a select component.
3
- * A select displays a collapsible list of options and allows a user to select one of them.
4
- * Based on @react-aria/select useSelect.
5
- */
6
-
7
- import { type JSX, type Accessor, createEffect, onCleanup } from 'solid-js';
8
- import { createPress } from '../interactions/createPress';
9
- import { createFocusRing } from '../interactions/createFocusRing';
10
- import { createLabel } from '../label/createLabel';
11
- import { createTypeSelect } from '../selection/createTypeSelect';
12
- import { filterDOMProps } from '../utils/filterDOMProps';
13
- import { mergeProps } from '../utils/mergeProps';
14
- import { createId } from '../ssr';
15
- import { access, type MaybeAccessor } from '../utils/reactivity';
16
- import type { SelectState, CollectionNode } from '@proyecto-viviana/solid-stately';
17
-
18
- export interface AriaSelectProps {
19
- /** An ID for the select. */
20
- id?: string;
21
- /** Whether the select is disabled. */
22
- isDisabled?: boolean;
23
- /** Whether the select is required. */
24
- isRequired?: boolean;
25
- /** The label for the select. */
26
- label?: JSX.Element;
27
- /** An accessible label for the select when no visible label is provided. */
28
- 'aria-label'?: string;
29
- /** The ID of an element that labels the select. */
30
- 'aria-labelledby'?: string;
31
- /** The ID of an element that describes the select. */
32
- 'aria-describedby'?: string;
33
- /** Placeholder text when no option is selected. */
34
- placeholder?: string;
35
- /** Whether the select should be auto-focused. */
36
- autoFocus?: boolean;
37
- /** Handler called when focus moves to the select. */
38
- onFocus?: (e: FocusEvent) => void;
39
- /** Handler called when focus moves away from the select. */
40
- onBlur?: (e: FocusEvent) => void;
41
- /** Handler called when the focus state changes. */
42
- onFocusChange?: (isFocused: boolean) => void;
43
- /** The name of the select, used when submitting an HTML form. */
44
- name?: string;
45
- /** Whether type-to-select is disabled. @default false */
46
- disallowTypeAhead?: boolean;
47
- }
48
-
49
- export interface SelectAria<T> {
50
- /** Props for the label element. */
51
- labelProps: JSX.HTMLAttributes<HTMLElement>;
52
- /** Props for the trigger button element. */
53
- triggerProps: JSX.HTMLAttributes<HTMLElement>;
54
- /** Props for the value display element. */
55
- valueProps: JSX.HTMLAttributes<HTMLElement>;
56
- /** Props for the listbox/menu popup. */
57
- menuProps: JSX.HTMLAttributes<HTMLElement>;
58
- /** Props for the description element, if any. */
59
- descriptionProps: JSX.HTMLAttributes<HTMLElement>;
60
- /** Props for the error message element, if any. */
61
- errorMessageProps: JSX.HTMLAttributes<HTMLElement>;
62
- /** Whether the select is currently focused. */
63
- isFocused: Accessor<boolean>;
64
- /** Whether the select has keyboard focus. */
65
- isFocusVisible: Accessor<boolean>;
66
- /** Whether the select is currently open. */
67
- isOpen: Accessor<boolean>;
68
- /** The currently selected item. */
69
- selectedItem: Accessor<CollectionNode<T> | null>;
70
- }
71
-
72
- // Shared data between select and options
73
- const selectData = new WeakMap<object, SelectData>();
74
-
75
- interface SelectData {
76
- id: string;
77
- }
78
-
79
- export function getSelectData(state: SelectState): SelectData | undefined {
80
- return selectData.get(state);
81
- }
82
-
83
- /**
84
- * Provides the behavior and accessibility implementation for a select component.
85
- */
86
- export function createSelect<T>(
87
- props: MaybeAccessor<AriaSelectProps>,
88
- state: SelectState<T>,
89
- _ref?: () => HTMLElement | null
90
- ): SelectAria<T> {
91
- const getProps = () => access(props);
92
- const id = createId(getProps().id);
93
-
94
- // Generate IDs for associated elements
95
- const buttonId = `${id}-button`;
96
- const listBoxId = `${id}-listbox`;
97
- const valueId = `${id}-value`;
98
- const descriptionId = `${id}-description`;
99
- const errorMessageId = `${id}-error`;
100
-
101
- // Filter DOM props
102
- const domProps = () =>
103
- filterDOMProps(getProps() as unknown as Record<string, unknown>, { labelable: true });
104
-
105
- // Share data with child options
106
- createEffect(() => {
107
- selectData.set(state, { id });
108
-
109
- onCleanup(() => {
110
- selectData.delete(state);
111
- });
112
- });
113
-
114
- // Label handling
115
- const { labelProps, fieldProps } = createLabel({
116
- get id() {
117
- return buttonId;
118
- },
119
- get label() {
120
- return getProps().label;
121
- },
122
- get 'aria-label'() {
123
- return getProps()['aria-label'];
124
- },
125
- get 'aria-labelledby'() {
126
- return getProps()['aria-labelledby'];
127
- },
128
- labelElementType: 'span',
129
- });
130
-
131
- // Focus ring for keyboard focus styling
132
- const { isFocusVisible, focusProps } = createFocusRing({
133
- get autoFocus() {
134
- return getProps().autoFocus;
135
- },
136
- });
137
-
138
- // Track focus state
139
- const isFocused = state.isFocused;
140
-
141
- // Handle press on trigger
142
- const { pressProps } = createPress({
143
- get isDisabled() {
144
- return getProps().isDisabled ?? state.isDisabled;
145
- },
146
- onPress() {
147
- state.toggle();
148
- },
149
- });
150
-
151
- // Helper to find next non-disabled key
152
- const findNextKey = (fromKey: string | number | null, direction: 'forward' | 'backward'): string | number | null => {
153
- const collection = state.collection();
154
- let key = fromKey;
155
-
156
- if (key == null) {
157
- return direction === 'forward' ? collection.getFirstKey() : collection.getLastKey();
158
- }
159
-
160
- const getNext = direction === 'forward'
161
- ? (k: string | number) => collection.getKeyAfter(k)
162
- : (k: string | number) => collection.getKeyBefore(k);
163
-
164
- let next = getNext(key);
165
- while (next != null) {
166
- // Check if item is disabled via state.isKeyDisabled or item.isDisabled
167
- const isDisabled = state.isKeyDisabled?.(next) || collection.getItem(next)?.isDisabled;
168
- if (!isDisabled) {
169
- return next;
170
- }
171
- next = getNext(next);
172
- }
173
-
174
- return null;
175
- };
176
-
177
- // Helper to check if key is disabled
178
- const isKeyDisabled = (key: string | number): boolean => {
179
- const collection = state.collection();
180
- return state.isKeyDisabled?.(key) || collection.getItem(key)?.isDisabled || false;
181
- };
182
-
183
- // Type-to-select - for Select, typing directly selects items when closed
184
- const { typeSelectProps } = createTypeSelect({
185
- collection: () => state.collection(),
186
- focusedKey: () => state.selectedKey(), // Use selectedKey as the "focused" key for closed Select
187
- onFocusedKeyChange: (key) => {
188
- // When closed, type-to-select directly changes selection
189
- if (!state.isOpen()) {
190
- state.setSelectedKey(key);
191
- } else {
192
- // When open, update focused key (listbox handles selection)
193
- state.setFocusedKey(key);
194
- }
195
- },
196
- isKeyDisabled,
197
- get isDisabled() {
198
- return getProps().disallowTypeAhead ?? false;
199
- },
200
- });
201
-
202
- // Keyboard navigation
203
- const onKeyDown: JSX.EventHandler<HTMLElement, KeyboardEvent> = (e) => {
204
- if (getProps().isDisabled) return;
205
-
206
- const collection = state.collection();
207
- const currentKey = state.selectedKey();
208
-
209
- switch (e.key) {
210
- case 'Enter':
211
- case ' ':
212
- e.preventDefault();
213
- state.toggle();
214
- break;
215
-
216
- case 'ArrowDown':
217
- e.preventDefault();
218
- if (!state.isOpen()) {
219
- // ArrowDown: Open the dropdown and focus first/selected item
220
- state.open();
221
- const focusKey = currentKey ?? collection.getFirstKey();
222
- if (focusKey) {
223
- state.setFocusedKey(focusKey);
224
- }
225
- }
226
- // When open, navigation is handled by the listbox
227
- break;
228
-
229
- case 'ArrowUp':
230
- e.preventDefault();
231
- if (!state.isOpen()) {
232
- // ArrowUp: Open the dropdown and focus last/selected item
233
- state.open();
234
- const focusKey = currentKey ?? collection.getLastKey();
235
- if (focusKey) {
236
- state.setFocusedKey(focusKey);
237
- }
238
- }
239
- // When open, navigation is handled by the listbox
240
- break;
241
-
242
- case 'ArrowRight':
243
- // ArrowRight: Select next option (for horizontal keyboard navigation pattern)
244
- if (!state.isOpen()) {
245
- e.preventDefault();
246
- const nextKey = findNextKey(currentKey, 'forward');
247
- if (nextKey != null) {
248
- state.setSelectedKey(nextKey);
249
- }
250
- }
251
- break;
252
-
253
- case 'ArrowLeft':
254
- // ArrowLeft: Select previous option (for horizontal keyboard navigation pattern)
255
- if (!state.isOpen()) {
256
- e.preventDefault();
257
- const prevKey = findNextKey(currentKey, 'backward');
258
- if (prevKey != null) {
259
- state.setSelectedKey(prevKey);
260
- }
261
- }
262
- break;
263
-
264
- case 'Home':
265
- // Home: Select first option
266
- if (!state.isOpen()) {
267
- e.preventDefault();
268
- const firstKey = collection.getFirstKey();
269
- if (firstKey != null) {
270
- // Find first non-disabled key
271
- const item = collection.getItem(firstKey);
272
- if (item && !item.isDisabled) {
273
- state.setSelectedKey(firstKey);
274
- } else {
275
- const nextKey = findNextKey(firstKey, 'forward');
276
- if (nextKey != null) {
277
- state.setSelectedKey(nextKey);
278
- }
279
- }
280
- }
281
- }
282
- break;
283
-
284
- case 'End':
285
- // End: Select last option
286
- if (!state.isOpen()) {
287
- e.preventDefault();
288
- const lastKey = collection.getLastKey();
289
- if (lastKey != null) {
290
- // Find last non-disabled key
291
- const item = collection.getItem(lastKey);
292
- if (item && !item.isDisabled) {
293
- state.setSelectedKey(lastKey);
294
- } else {
295
- const prevKey = findNextKey(lastKey, 'backward');
296
- if (prevKey != null) {
297
- state.setSelectedKey(prevKey);
298
- }
299
- }
300
- }
301
- }
302
- break;
303
-
304
- case 'Escape':
305
- if (state.isOpen()) {
306
- e.preventDefault();
307
- state.close();
308
- }
309
- break;
310
- }
311
- };
312
-
313
- // Handle focus events
314
- const handleFocus = (e: FocusEvent) => {
315
- state.setFocused(true);
316
- getProps().onFocus?.(e);
317
- getProps().onFocusChange?.(true);
318
- };
319
-
320
- const handleBlur = (e: FocusEvent) => {
321
- state.setFocused(false);
322
- getProps().onBlur?.(e);
323
- getProps().onFocusChange?.(false);
324
- };
325
-
326
- return {
327
- get labelProps() {
328
- return labelProps as JSX.HTMLAttributes<HTMLElement>;
329
- },
330
- get triggerProps() {
331
- const p = getProps();
332
- const isOpen = state.isOpen();
333
- const isDisabled = p.isDisabled ?? state.isDisabled;
334
-
335
- const baseProps = mergeProps(
336
- domProps(),
337
- pressProps as Record<string, unknown>,
338
- focusProps as Record<string, unknown>,
339
- fieldProps as Record<string, unknown>,
340
- {
341
- id: buttonId,
342
- role: 'combobox',
343
- type: 'button',
344
- tabIndex: isDisabled ? undefined : 0,
345
- 'aria-haspopup': 'listbox',
346
- 'aria-expanded': isOpen,
347
- 'aria-controls': isOpen ? listBoxId : undefined,
348
- 'aria-disabled': isDisabled || undefined,
349
- 'aria-required': p.isRequired || undefined,
350
- 'aria-describedby': p['aria-describedby'] || undefined,
351
- onKeyDown,
352
- onFocus: handleFocus,
353
- onBlur: handleBlur,
354
- 'data-open': isOpen || undefined,
355
- 'data-disabled': isDisabled || undefined,
356
- 'data-focus-visible': isFocusVisible() || undefined,
357
- } as Record<string, unknown>
358
- );
359
-
360
- // Add type-select props if enabled
361
- if (!p.disallowTypeAhead) {
362
- return mergeProps(baseProps, typeSelectProps as Record<string, unknown>) as JSX.HTMLAttributes<HTMLElement>;
363
- }
364
-
365
- return baseProps as JSX.HTMLAttributes<HTMLElement>;
366
- },
367
- get valueProps() {
368
- return {
369
- id: valueId,
370
- } as JSX.HTMLAttributes<HTMLElement>;
371
- },
372
- get menuProps() {
373
- return {
374
- id: listBoxId,
375
- role: 'listbox',
376
- 'aria-labelledby': buttonId,
377
- tabIndex: -1,
378
- } as JSX.HTMLAttributes<HTMLElement>;
379
- },
380
- get descriptionProps() {
381
- return {
382
- id: descriptionId,
383
- } as JSX.HTMLAttributes<HTMLElement>;
384
- },
385
- get errorMessageProps() {
386
- return {
387
- id: errorMessageId,
388
- } as JSX.HTMLAttributes<HTMLElement>;
389
- },
390
- isFocused,
391
- isFocusVisible: () => isFocused() && isFocusVisible(),
392
- isOpen: state.isOpen,
393
- selectedItem: state.selectedItem,
394
- };
395
- }
1
+ /**
2
+ * Provides the behavior and accessibility implementation for a select component.
3
+ * A select displays a collapsible list of options and allows a user to select one of them.
4
+ * Based on @react-aria/select useSelect.
5
+ */
6
+
7
+ import { type JSX, type Accessor, createEffect, onCleanup } from 'solid-js';
8
+ import { createPress } from '../interactions/createPress';
9
+ import { createFocusRing } from '../interactions/createFocusRing';
10
+ import { createLabel } from '../label/createLabel';
11
+ import { createTypeSelect } from '../selection/createTypeSelect';
12
+ import { filterDOMProps } from '../utils/filterDOMProps';
13
+ import { mergeProps } from '../utils/mergeProps';
14
+ import { createId } from '../ssr';
15
+ import { access, type MaybeAccessor } from '../utils/reactivity';
16
+ import type { SelectState, CollectionNode } from '@proyecto-viviana/solid-stately';
17
+
18
+ export interface AriaSelectProps {
19
+ /** An ID for the select. */
20
+ id?: string;
21
+ /** Whether the select is disabled. */
22
+ isDisabled?: boolean;
23
+ /** Whether the select is required. */
24
+ isRequired?: boolean;
25
+ /** The label for the select. */
26
+ label?: JSX.Element;
27
+ /** An accessible label for the select when no visible label is provided. */
28
+ 'aria-label'?: string;
29
+ /** The ID of an element that labels the select. */
30
+ 'aria-labelledby'?: string;
31
+ /** The ID of an element that describes the select. */
32
+ 'aria-describedby'?: string;
33
+ /** Placeholder text when no option is selected. */
34
+ placeholder?: string;
35
+ /** Whether the select should be auto-focused. */
36
+ autoFocus?: boolean;
37
+ /** Handler called when focus moves to the select. */
38
+ onFocus?: (e: FocusEvent) => void;
39
+ /** Handler called when focus moves away from the select. */
40
+ onBlur?: (e: FocusEvent) => void;
41
+ /** Handler called when the focus state changes. */
42
+ onFocusChange?: (isFocused: boolean) => void;
43
+ /** The name of the select, used when submitting an HTML form. */
44
+ name?: string;
45
+ /** Whether type-to-select is disabled. @default false */
46
+ disallowTypeAhead?: boolean;
47
+ }
48
+
49
+ export interface SelectAria<T> {
50
+ /** Props for the label element. */
51
+ labelProps: JSX.HTMLAttributes<HTMLElement>;
52
+ /** Props for the trigger button element. */
53
+ triggerProps: JSX.HTMLAttributes<HTMLElement>;
54
+ /** Props for the value display element. */
55
+ valueProps: JSX.HTMLAttributes<HTMLElement>;
56
+ /** Props for the listbox/menu popup. */
57
+ menuProps: JSX.HTMLAttributes<HTMLElement>;
58
+ /** Props for the description element, if any. */
59
+ descriptionProps: JSX.HTMLAttributes<HTMLElement>;
60
+ /** Props for the error message element, if any. */
61
+ errorMessageProps: JSX.HTMLAttributes<HTMLElement>;
62
+ /** Whether the select is currently focused. */
63
+ isFocused: Accessor<boolean>;
64
+ /** Whether the select has keyboard focus. */
65
+ isFocusVisible: Accessor<boolean>;
66
+ /** Whether the select is currently open. */
67
+ isOpen: Accessor<boolean>;
68
+ /** The currently selected item. */
69
+ selectedItem: Accessor<CollectionNode<T> | null>;
70
+ }
71
+
72
+ // Shared data between select and options
73
+ const selectData = new WeakMap<object, SelectData>();
74
+
75
+ interface SelectData {
76
+ id: string;
77
+ }
78
+
79
+ export function getSelectData(state: SelectState): SelectData | undefined {
80
+ return selectData.get(state);
81
+ }
82
+
83
+ /**
84
+ * Provides the behavior and accessibility implementation for a select component.
85
+ */
86
+ export function createSelect<T>(
87
+ props: MaybeAccessor<AriaSelectProps>,
88
+ state: SelectState<T>,
89
+ _ref?: () => HTMLElement | null
90
+ ): SelectAria<T> {
91
+ const getProps = () => access(props);
92
+ const id = createId(getProps().id);
93
+
94
+ // Generate IDs for associated elements
95
+ const buttonId = `${id}-button`;
96
+ const listBoxId = `${id}-listbox`;
97
+ const valueId = `${id}-value`;
98
+ const descriptionId = `${id}-description`;
99
+ const errorMessageId = `${id}-error`;
100
+
101
+ // Filter DOM props
102
+ const domProps = () =>
103
+ filterDOMProps(getProps() as unknown as Record<string, unknown>, { labelable: true });
104
+
105
+ // Share data with child options
106
+ createEffect(() => {
107
+ selectData.set(state, { id });
108
+
109
+ onCleanup(() => {
110
+ selectData.delete(state);
111
+ });
112
+ });
113
+
114
+ // Label handling
115
+ const { labelProps, fieldProps } = createLabel({
116
+ get id() {
117
+ return buttonId;
118
+ },
119
+ get label() {
120
+ return getProps().label;
121
+ },
122
+ get 'aria-label'() {
123
+ return getProps()['aria-label'];
124
+ },
125
+ get 'aria-labelledby'() {
126
+ return getProps()['aria-labelledby'];
127
+ },
128
+ labelElementType: 'span',
129
+ });
130
+
131
+ // Focus ring for keyboard focus styling
132
+ const { isFocusVisible, focusProps } = createFocusRing({
133
+ get autoFocus() {
134
+ return getProps().autoFocus;
135
+ },
136
+ });
137
+
138
+ // Track focus state
139
+ const isFocused = state.isFocused;
140
+
141
+ // Handle press on trigger
142
+ const { pressProps } = createPress({
143
+ get isDisabled() {
144
+ return getProps().isDisabled ?? state.isDisabled;
145
+ },
146
+ onPress() {
147
+ state.toggle();
148
+ },
149
+ });
150
+
151
+ // Helper to check if key is disabled
152
+ const isKeyDisabled = (key: string | number): boolean => {
153
+ const collection = state.collection();
154
+ return state.isKeyDisabled?.(key) || collection.getItem(key)?.isDisabled || false;
155
+ };
156
+
157
+ // Helper to find the next non-disabled key.
158
+ const findNextKey = (fromKey: string | number | null, direction: 'forward' | 'backward'): string | number | null => {
159
+ const collection = state.collection();
160
+ const getAdjacent = direction === 'forward'
161
+ ? (k: string | number) => collection.getKeyAfter(k)
162
+ : (k: string | number) => collection.getKeyBefore(k);
163
+ const getBoundary = direction === 'forward'
164
+ ? () => collection.getFirstKey()
165
+ : () => collection.getLastKey();
166
+
167
+ let key = fromKey == null ? getBoundary() : getAdjacent(fromKey);
168
+ while (key != null && isKeyDisabled(key)) {
169
+ key = getAdjacent(key);
170
+ }
171
+
172
+ return key;
173
+ };
174
+
175
+ // Type-to-select - for Select, typing directly selects items when closed
176
+ const { typeSelectProps } = createTypeSelect({
177
+ collection: () => state.collection(),
178
+ focusedKey: () => state.selectedKey(), // Use selectedKey as the "focused" key for closed Select
179
+ onFocusedKeyChange: (key) => {
180
+ // When closed, type-to-select directly changes selection
181
+ if (!state.isOpen()) {
182
+ state.setSelectedKey(key);
183
+ } else {
184
+ // When open, update focused key (listbox handles selection)
185
+ state.setFocusedKey(key);
186
+ }
187
+ },
188
+ isKeyDisabled,
189
+ get isDisabled() {
190
+ return Boolean((getProps().disallowTypeAhead ?? false) || getProps().isDisabled || state.isDisabled);
191
+ },
192
+ });
193
+
194
+ // Keyboard navigation
195
+ const onKeyDown: JSX.EventHandler<HTMLElement, KeyboardEvent> = (e) => {
196
+ if (getProps().isDisabled ?? state.isDisabled) return;
197
+
198
+ const currentKey = state.focusedKey() ?? state.selectedKey();
199
+
200
+ switch (e.key) {
201
+ case 'Enter':
202
+ case ' ':
203
+ e.preventDefault();
204
+ state.toggle();
205
+ break;
206
+
207
+ case 'ArrowDown':
208
+ e.preventDefault();
209
+ if (!state.isOpen()) {
210
+ // ArrowDown: Open the dropdown and focus first/selected item
211
+ state.open();
212
+ const focusKey = currentKey != null && !isKeyDisabled(currentKey)
213
+ ? currentKey
214
+ : findNextKey(currentKey, 'forward');
215
+ if (focusKey) {
216
+ state.setFocusedKey(focusKey);
217
+ }
218
+ }
219
+ // When open, navigation is handled by the listbox
220
+ break;
221
+
222
+ case 'ArrowUp':
223
+ e.preventDefault();
224
+ if (!state.isOpen()) {
225
+ // ArrowUp: Open the dropdown and focus last/selected item
226
+ state.open();
227
+ const focusKey = currentKey != null && !isKeyDisabled(currentKey)
228
+ ? currentKey
229
+ : findNextKey(currentKey, 'backward');
230
+ if (focusKey) {
231
+ state.setFocusedKey(focusKey);
232
+ }
233
+ }
234
+ // When open, navigation is handled by the listbox
235
+ break;
236
+
237
+ case 'ArrowRight':
238
+ // ArrowRight: Select next option (for horizontal keyboard navigation pattern)
239
+ if (!state.isOpen()) {
240
+ e.preventDefault();
241
+ const nextKey = findNextKey(currentKey, 'forward');
242
+ if (nextKey != null) {
243
+ state.setSelectedKey(nextKey);
244
+ }
245
+ }
246
+ break;
247
+
248
+ case 'ArrowLeft':
249
+ // ArrowLeft: Select previous option (for horizontal keyboard navigation pattern)
250
+ if (!state.isOpen()) {
251
+ e.preventDefault();
252
+ const prevKey = findNextKey(currentKey, 'backward');
253
+ if (prevKey != null) {
254
+ state.setSelectedKey(prevKey);
255
+ }
256
+ }
257
+ break;
258
+
259
+ case 'Home':
260
+ // Home: Select first option
261
+ if (!state.isOpen()) {
262
+ e.preventDefault();
263
+ const firstKey = findNextKey(null, 'forward');
264
+ if (firstKey != null) {
265
+ state.setSelectedKey(firstKey);
266
+ }
267
+ }
268
+ break;
269
+
270
+ case 'End':
271
+ // End: Select last option
272
+ if (!state.isOpen()) {
273
+ e.preventDefault();
274
+ const lastKey = findNextKey(null, 'backward');
275
+ if (lastKey != null) {
276
+ state.setSelectedKey(lastKey);
277
+ }
278
+ }
279
+ break;
280
+
281
+ case 'Escape':
282
+ if (state.isOpen()) {
283
+ e.preventDefault();
284
+ state.close();
285
+ }
286
+ break;
287
+ }
288
+ };
289
+
290
+ // Handle focus events
291
+ const handleFocus = (e: FocusEvent) => {
292
+ state.setFocused(true);
293
+ getProps().onFocus?.(e);
294
+ getProps().onFocusChange?.(true);
295
+ };
296
+
297
+ const handleBlur = (e: FocusEvent) => {
298
+ state.setFocused(false);
299
+ getProps().onBlur?.(e);
300
+ getProps().onFocusChange?.(false);
301
+ };
302
+
303
+ return {
304
+ get labelProps() {
305
+ return labelProps as JSX.HTMLAttributes<HTMLElement>;
306
+ },
307
+ get triggerProps() {
308
+ const p = getProps();
309
+ const isOpen = state.isOpen();
310
+ const isDisabled = p.isDisabled ?? state.isDisabled;
311
+
312
+ const baseProps = mergeProps(
313
+ domProps(),
314
+ pressProps as Record<string, unknown>,
315
+ focusProps as Record<string, unknown>,
316
+ fieldProps as Record<string, unknown>,
317
+ {
318
+ id: buttonId,
319
+ role: 'combobox',
320
+ type: 'button',
321
+ tabIndex: isDisabled ? undefined : 0,
322
+ 'aria-haspopup': 'listbox',
323
+ 'aria-expanded': isOpen,
324
+ 'aria-controls': isOpen ? listBoxId : undefined,
325
+ 'aria-disabled': isDisabled || undefined,
326
+ 'aria-required': p.isRequired || undefined,
327
+ 'aria-describedby': p['aria-describedby'] || undefined,
328
+ onKeyDown,
329
+ onFocus: handleFocus,
330
+ onBlur: handleBlur,
331
+ 'data-open': isOpen || undefined,
332
+ 'data-disabled': isDisabled || undefined,
333
+ 'data-focus-visible': isFocusVisible() || undefined,
334
+ } as Record<string, unknown>
335
+ );
336
+
337
+ // Add type-select props if enabled
338
+ if (!p.disallowTypeAhead) {
339
+ return mergeProps(baseProps, typeSelectProps as Record<string, unknown>) as JSX.HTMLAttributes<HTMLElement>;
340
+ }
341
+
342
+ return baseProps as JSX.HTMLAttributes<HTMLElement>;
343
+ },
344
+ get valueProps() {
345
+ return {
346
+ id: valueId,
347
+ } as JSX.HTMLAttributes<HTMLElement>;
348
+ },
349
+ get menuProps() {
350
+ return {
351
+ id: listBoxId,
352
+ role: 'listbox',
353
+ 'aria-labelledby': buttonId,
354
+ 'aria-multiselectable': state.selectionMode() === 'multiple' ? true : undefined,
355
+ tabIndex: -1,
356
+ } as JSX.HTMLAttributes<HTMLElement>;
357
+ },
358
+ get descriptionProps() {
359
+ return {
360
+ id: descriptionId,
361
+ } as JSX.HTMLAttributes<HTMLElement>;
362
+ },
363
+ get errorMessageProps() {
364
+ return {
365
+ id: errorMessageId,
366
+ } as JSX.HTMLAttributes<HTMLElement>;
367
+ },
368
+ isFocused,
369
+ isFocusVisible: () => isFocused() && isFocusVisible(),
370
+ isOpen: state.isOpen,
371
+ selectedItem: state.selectedItem,
372
+ };
373
+ }