@proyecto-viviana/solidaria 0.2.5 → 0.3.0

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 (555) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +31 -236
  3. package/dist/actiongroup/createActionGroup.d.ts +29 -0
  4. package/dist/actiongroup/createActionGroup.d.ts.map +1 -0
  5. package/dist/actiongroup/index.d.ts +2 -0
  6. package/dist/actiongroup/index.d.ts.map +1 -0
  7. package/dist/autocomplete/createAutocomplete.d.ts +16 -12
  8. package/dist/autocomplete/createAutocomplete.d.ts.map +1 -1
  9. package/dist/autocomplete/index.d.ts +1 -1
  10. package/dist/autocomplete/index.d.ts.map +1 -1
  11. package/dist/breadcrumbs/createBreadcrumbs.d.ts +11 -7
  12. package/dist/breadcrumbs/createBreadcrumbs.d.ts.map +1 -1
  13. package/dist/breadcrumbs/index.d.ts +1 -1
  14. package/dist/button/createButton.d.ts +1 -1
  15. package/dist/button/createButton.d.ts.map +1 -1
  16. package/dist/button/createToggleButton.d.ts +3 -3
  17. package/dist/button/createToggleButtonGroup.d.ts +32 -0
  18. package/dist/button/createToggleButtonGroup.d.ts.map +1 -0
  19. package/dist/button/index.d.ts +6 -4
  20. package/dist/button/index.d.ts.map +1 -1
  21. package/dist/button/types.d.ts +18 -12
  22. package/dist/button/types.d.ts.map +1 -1
  23. package/dist/calendar/createCalendar.d.ts +15 -5
  24. package/dist/calendar/createCalendar.d.ts.map +1 -1
  25. package/dist/calendar/createCalendarCell.d.ts +8 -2
  26. package/dist/calendar/createCalendarCell.d.ts.map +1 -1
  27. package/dist/calendar/createCalendarGrid.d.ts +4 -4
  28. package/dist/calendar/createCalendarGrid.d.ts.map +1 -1
  29. package/dist/calendar/createRangeCalendar.d.ts +15 -5
  30. package/dist/calendar/createRangeCalendar.d.ts.map +1 -1
  31. package/dist/calendar/createRangeCalendarCell.d.ts +7 -3
  32. package/dist/calendar/createRangeCalendarCell.d.ts.map +1 -1
  33. package/dist/calendar/index.d.ts +5 -5
  34. package/dist/calendar/index.d.ts.map +1 -1
  35. package/dist/calendar/intl/index.d.ts +12 -0
  36. package/dist/calendar/intl/index.d.ts.map +1 -0
  37. package/dist/calendar/utils.d.ts +12 -0
  38. package/dist/calendar/utils.d.ts.map +1 -0
  39. package/dist/checkbox/createCheckbox.d.ts +6 -6
  40. package/dist/checkbox/createCheckbox.d.ts.map +1 -1
  41. package/dist/checkbox/createCheckboxGroup.d.ts +11 -7
  42. package/dist/checkbox/createCheckboxGroup.d.ts.map +1 -1
  43. package/dist/checkbox/createCheckboxGroupItem.d.ts +4 -4
  44. package/dist/checkbox/createCheckboxGroupItem.d.ts.map +1 -1
  45. package/dist/checkbox/createCheckboxGroupState.d.ts +2 -2
  46. package/dist/checkbox/createCheckboxGroupState.d.ts.map +1 -1
  47. package/dist/checkbox/index.d.ts +8 -8
  48. package/dist/checkbox/index.d.ts.map +1 -1
  49. package/dist/collections/index.d.ts +56 -0
  50. package/dist/collections/index.d.ts.map +1 -0
  51. package/dist/color/createColorArea.d.ts +3 -3
  52. package/dist/color/createColorArea.d.ts.map +1 -1
  53. package/dist/color/createColorField.d.ts +4 -4
  54. package/dist/color/createColorField.d.ts.map +1 -1
  55. package/dist/color/createColorSlider.d.ts +4 -4
  56. package/dist/color/createColorSlider.d.ts.map +1 -1
  57. package/dist/color/createColorSwatch.d.ts +2 -2
  58. package/dist/color/createColorSwatch.d.ts.map +1 -1
  59. package/dist/color/createColorWheel.d.ts +3 -3
  60. package/dist/color/createColorWheel.d.ts.map +1 -1
  61. package/dist/color/index.d.ts +6 -6
  62. package/dist/color/types.d.ts +98 -16
  63. package/dist/color/types.d.ts.map +1 -1
  64. package/dist/combobox/createComboBox.d.ts +16 -7
  65. package/dist/combobox/createComboBox.d.ts.map +1 -1
  66. package/dist/combobox/index.d.ts +1 -1
  67. package/dist/combobox/intl/index.d.ts +1 -1
  68. package/dist/datepicker/createDateField.d.ts +18 -6
  69. package/dist/datepicker/createDateField.d.ts.map +1 -1
  70. package/dist/datepicker/createDatePicker.d.ts +57 -5
  71. package/dist/datepicker/createDatePicker.d.ts.map +1 -1
  72. package/dist/datepicker/createDatePickerGroup.d.ts +19 -0
  73. package/dist/datepicker/createDatePickerGroup.d.ts.map +1 -0
  74. package/dist/datepicker/createDateRangePicker.d.ts +42 -0
  75. package/dist/datepicker/createDateRangePicker.d.ts.map +1 -0
  76. package/dist/datepicker/createDateSegment.d.ts +11 -3
  77. package/dist/datepicker/createDateSegment.d.ts.map +1 -1
  78. package/dist/datepicker/createTimeField.d.ts +11 -5
  79. package/dist/datepicker/createTimeField.d.ts.map +1 -1
  80. package/dist/datepicker/createTimeSegment.d.ts +29 -0
  81. package/dist/datepicker/createTimeSegment.d.ts.map +1 -0
  82. package/dist/datepicker/index.d.ts +7 -4
  83. package/dist/datepicker/index.d.ts.map +1 -1
  84. package/dist/dialog/createDialog.d.ts +5 -5
  85. package/dist/dialog/createDialog.d.ts.map +1 -1
  86. package/dist/dialog/index.d.ts +2 -2
  87. package/dist/dialog/index.d.ts.map +1 -1
  88. package/dist/dialog/types.d.ts +4 -4
  89. package/dist/disclosure/createDisclosure.d.ts +5 -2
  90. package/dist/disclosure/createDisclosure.d.ts.map +1 -1
  91. package/dist/disclosure/createDisclosureGroup.d.ts +4 -3
  92. package/dist/disclosure/createDisclosureGroup.d.ts.map +1 -1
  93. package/dist/disclosure/index.d.ts +2 -2
  94. package/dist/dnd/createDrag.d.ts +2 -2
  95. package/dist/dnd/createDrag.d.ts.map +1 -1
  96. package/dist/dnd/createDraggableCollection.d.ts +6 -2
  97. package/dist/dnd/createDraggableCollection.d.ts.map +1 -1
  98. package/dist/dnd/createDraggableItem.d.ts +3 -3
  99. package/dist/dnd/createDraggableItem.d.ts.map +1 -1
  100. package/dist/dnd/createDrop.d.ts +2 -2
  101. package/dist/dnd/createDrop.d.ts.map +1 -1
  102. package/dist/dnd/createDroppableCollection.d.ts +55 -4
  103. package/dist/dnd/createDroppableCollection.d.ts.map +1 -1
  104. package/dist/dnd/createDroppableItem.d.ts +3 -3
  105. package/dist/dnd/createDroppableItem.d.ts.map +1 -1
  106. package/dist/dnd/index.d.ts +12 -12
  107. package/dist/dnd/index.d.ts.map +1 -1
  108. package/dist/dnd/types.d.ts +2 -2
  109. package/dist/dnd/types.d.ts.map +1 -1
  110. package/dist/dnd/utils.d.ts +1 -1
  111. package/dist/dnd/utils.d.ts.map +1 -1
  112. package/dist/focus/FocusScope.d.ts +1 -1
  113. package/dist/focus/FocusScope.d.ts.map +1 -1
  114. package/dist/focus/createAutoFocus.d.ts.map +1 -1
  115. package/dist/focus/createFocusRestore.d.ts.map +1 -1
  116. package/dist/focus/createVirtualFocus.d.ts +4 -4
  117. package/dist/focus/createVirtualFocus.d.ts.map +1 -1
  118. package/dist/focus/index.d.ts +4 -4
  119. package/dist/focus/index.d.ts.map +1 -1
  120. package/dist/form/createFormReset.d.ts +1 -1
  121. package/dist/form/createFormValidation.d.ts +3 -3
  122. package/dist/form/createFormValidation.d.ts.map +1 -1
  123. package/dist/form/index.d.ts +2 -2
  124. package/dist/form/index.d.ts.map +1 -1
  125. package/dist/grid/GridKeyboardDelegate.d.ts +5 -5
  126. package/dist/grid/createGrid.d.ts +3 -3
  127. package/dist/grid/createGrid.d.ts.map +1 -1
  128. package/dist/grid/createGridCell.d.ts +3 -3
  129. package/dist/grid/createGridRow.d.ts +3 -3
  130. package/dist/grid/index.d.ts +5 -5
  131. package/dist/grid/types.d.ts +8 -8
  132. package/dist/gridlist/createGridList.d.ts +6 -4
  133. package/dist/gridlist/createGridList.d.ts.map +1 -1
  134. package/dist/gridlist/createGridListItem.d.ts +4 -4
  135. package/dist/gridlist/createGridListItem.d.ts.map +1 -1
  136. package/dist/gridlist/createGridListSelectionCheckbox.d.ts +3 -3
  137. package/dist/gridlist/createGridListSelectionCheckbox.d.ts.map +1 -1
  138. package/dist/gridlist/index.d.ts +4 -4
  139. package/dist/gridlist/types.d.ts +11 -7
  140. package/dist/gridlist/types.d.ts.map +1 -1
  141. package/dist/i18n/createCollator.d.ts.map +1 -1
  142. package/dist/i18n/createDateFormatter.d.ts.map +1 -1
  143. package/dist/i18n/createFilter.d.ts.map +1 -1
  144. package/dist/i18n/createNumberFormatter.d.ts +1 -1
  145. package/dist/i18n/createNumberFormatter.d.ts.map +1 -1
  146. package/dist/i18n/createStringFormatter.d.ts +2 -2
  147. package/dist/i18n/createStringFormatter.d.ts.map +1 -1
  148. package/dist/i18n/index.d.ts +8 -8
  149. package/dist/i18n/index.d.ts.map +1 -1
  150. package/dist/i18n/locale.d.ts +2 -2
  151. package/dist/i18n/locale.d.ts.map +1 -1
  152. package/dist/i18n/utils.d.ts.map +1 -1
  153. package/dist/index.d.ts +52 -49
  154. package/dist/index.d.ts.map +1 -1
  155. package/dist/index.js +18089 -15690
  156. package/dist/index.js.map +1 -7
  157. package/dist/index.jsx +18242 -0
  158. package/dist/index.jsx.map +1 -0
  159. package/dist/interactions/FocusableProvider.d.ts +2 -2
  160. package/dist/interactions/FocusableProvider.d.ts.map +1 -1
  161. package/dist/interactions/PressEvent.d.ts +2 -2
  162. package/dist/interactions/createFocus.d.ts +1 -1
  163. package/dist/interactions/createFocus.d.ts.map +1 -1
  164. package/dist/interactions/createFocusRing.d.ts +1 -1
  165. package/dist/interactions/createFocusRing.d.ts.map +1 -1
  166. package/dist/interactions/createFocusWithin.d.ts +1 -1
  167. package/dist/interactions/createFocusWithin.d.ts.map +1 -1
  168. package/dist/interactions/createFocusable.d.ts +3 -3
  169. package/dist/interactions/createFocusable.d.ts.map +1 -1
  170. package/dist/interactions/createHover.d.ts +5 -5
  171. package/dist/interactions/createHover.d.ts.map +1 -1
  172. package/dist/interactions/createInteractionModality.d.ts +3 -3
  173. package/dist/interactions/createInteractionModality.d.ts.map +1 -1
  174. package/dist/interactions/createKeyboard.d.ts +1 -1
  175. package/dist/interactions/createLongPress.d.ts +5 -5
  176. package/dist/interactions/createMove.d.ts +5 -5
  177. package/dist/interactions/createMove.d.ts.map +1 -1
  178. package/dist/interactions/createPress.d.ts +4 -4
  179. package/dist/interactions/createPress.d.ts.map +1 -1
  180. package/dist/interactions/index.d.ts +12 -12
  181. package/dist/interactions/index.d.ts.map +1 -1
  182. package/dist/label/createField.d.ts +4 -4
  183. package/dist/label/createField.d.ts.map +1 -1
  184. package/dist/label/createLabel.d.ts +7 -7
  185. package/dist/label/createLabel.d.ts.map +1 -1
  186. package/dist/label/createLabels.d.ts +1 -1
  187. package/dist/label/createLabels.d.ts.map +1 -1
  188. package/dist/label/index.d.ts +5 -5
  189. package/dist/landmark/createLandmark.d.ts +5 -5
  190. package/dist/landmark/createLandmark.d.ts.map +1 -1
  191. package/dist/landmark/index.d.ts +1 -1
  192. package/dist/link/createLink.d.ts +23 -7
  193. package/dist/link/createLink.d.ts.map +1 -1
  194. package/dist/link/index.d.ts +1 -1
  195. package/dist/listbox/createListBox.d.ts +12 -6
  196. package/dist/listbox/createListBox.d.ts.map +1 -1
  197. package/dist/listbox/createOption.d.ts +21 -4
  198. package/dist/listbox/createOption.d.ts.map +1 -1
  199. package/dist/listbox/index.d.ts +2 -2
  200. package/dist/listbox/index.d.ts.map +1 -1
  201. package/dist/live-announcer/announce.d.ts +2 -2
  202. package/dist/live-announcer/announce.d.ts.map +1 -1
  203. package/dist/live-announcer/index.d.ts +1 -1
  204. package/dist/menu/createMenu.d.ts +8 -7
  205. package/dist/menu/createMenu.d.ts.map +1 -1
  206. package/dist/menu/createMenuItem.d.ts +16 -4
  207. package/dist/menu/createMenuItem.d.ts.map +1 -1
  208. package/dist/menu/createMenuTrigger.d.ts +4 -4
  209. package/dist/menu/index.d.ts +3 -3
  210. package/dist/menu/index.d.ts.map +1 -1
  211. package/dist/meter/createMeter.d.ts +6 -6
  212. package/dist/meter/createMeter.d.ts.map +1 -1
  213. package/dist/meter/index.d.ts +1 -1
  214. package/dist/numberfield/createNumberField.d.ts +27 -8
  215. package/dist/numberfield/createNumberField.d.ts.map +1 -1
  216. package/dist/numberfield/index.d.ts +1 -1
  217. package/dist/overlays/ariaHideOutside.d.ts.map +1 -1
  218. package/dist/overlays/createModal.d.ts +19 -3
  219. package/dist/overlays/createModal.d.ts.map +1 -1
  220. package/dist/overlays/createOverlay.d.ts +1 -1
  221. package/dist/overlays/createOverlay.d.ts.map +1 -1
  222. package/dist/overlays/createOverlayTrigger.d.ts +6 -6
  223. package/dist/overlays/index.d.ts +6 -6
  224. package/dist/overlays/index.d.ts.map +1 -1
  225. package/dist/popover/calculatePosition.d.ts +4 -4
  226. package/dist/popover/calculatePosition.d.ts.map +1 -1
  227. package/dist/popover/createOverlayPosition.d.ts +3 -3
  228. package/dist/popover/createOverlayPosition.d.ts.map +1 -1
  229. package/dist/popover/createPopover.d.ts +4 -4
  230. package/dist/popover/createPopover.d.ts.map +1 -1
  231. package/dist/popover/index.d.ts +3 -3
  232. package/dist/progress/createProgressBar.d.ts +7 -5
  233. package/dist/progress/createProgressBar.d.ts.map +1 -1
  234. package/dist/progress/index.d.ts +1 -1
  235. package/dist/radio/createRadio.d.ts +7 -7
  236. package/dist/radio/createRadio.d.ts.map +1 -1
  237. package/dist/radio/createRadioGroup.d.ts +11 -11
  238. package/dist/radio/createRadioGroup.d.ts.map +1 -1
  239. package/dist/radio/createRadioGroupState.d.ts +3 -3
  240. package/dist/radio/createRadioGroupState.d.ts.map +1 -1
  241. package/dist/radio/index.d.ts +3 -3
  242. package/dist/radio/index.d.ts.map +1 -1
  243. package/dist/searchfield/createSearchField.d.ts +7 -7
  244. package/dist/searchfield/createSearchField.d.ts.map +1 -1
  245. package/dist/searchfield/index.d.ts +2 -2
  246. package/dist/select/createHiddenSelect.d.ts +4 -4
  247. package/dist/select/createHiddenSelect.d.ts.map +1 -1
  248. package/dist/select/createSelect.d.ts +14 -6
  249. package/dist/select/createSelect.d.ts.map +1 -1
  250. package/dist/select/index.d.ts +2 -2
  251. package/dist/select/index.d.ts.map +1 -1
  252. package/dist/selection/createTypeSelect.d.ts +2 -2
  253. package/dist/selection/index.d.ts +1 -1
  254. package/dist/separator/createSeparator.d.ts +9 -5
  255. package/dist/separator/createSeparator.d.ts.map +1 -1
  256. package/dist/separator/index.d.ts +1 -1
  257. package/dist/slider/createSlider.d.ts +11 -7
  258. package/dist/slider/createSlider.d.ts.map +1 -1
  259. package/dist/slider/index.d.ts +2 -2
  260. package/dist/ssr/index.d.ts +1 -1
  261. package/dist/ssr/index.d.ts.map +1 -1
  262. package/dist/steplist/createStepList.d.ts +36 -0
  263. package/dist/steplist/createStepList.d.ts.map +1 -0
  264. package/dist/steplist/index.d.ts +2 -0
  265. package/dist/steplist/index.d.ts.map +1 -0
  266. package/dist/switch/createSwitch.d.ts +6 -4
  267. package/dist/switch/createSwitch.d.ts.map +1 -1
  268. package/dist/switch/index.d.ts +1 -1
  269. package/dist/table/createTable.d.ts +3 -3
  270. package/dist/table/createTable.d.ts.map +1 -1
  271. package/dist/table/createTableCell.d.ts +3 -3
  272. package/dist/table/createTableCell.d.ts.map +1 -1
  273. package/dist/table/createTableColumnHeader.d.ts +3 -3
  274. package/dist/table/createTableColumnHeader.d.ts.map +1 -1
  275. package/dist/table/createTableColumnResize.d.ts +41 -0
  276. package/dist/table/createTableColumnResize.d.ts.map +1 -0
  277. package/dist/table/createTableHeaderRow.d.ts +3 -3
  278. package/dist/table/createTableRow.d.ts +3 -3
  279. package/dist/table/createTableRow.d.ts.map +1 -1
  280. package/dist/table/createTableRowGroup.d.ts +2 -2
  281. package/dist/table/createTableRowGroup.d.ts.map +1 -1
  282. package/dist/table/createTableSelectAllCheckbox.d.ts +3 -3
  283. package/dist/table/createTableSelectAllCheckbox.d.ts.map +1 -1
  284. package/dist/table/createTableSelectionCheckbox.d.ts +3 -3
  285. package/dist/table/index.d.ts +11 -9
  286. package/dist/table/index.d.ts.map +1 -1
  287. package/dist/table/types.d.ts +15 -7
  288. package/dist/table/types.d.ts.map +1 -1
  289. package/dist/tabs/createTabs.d.ts +28 -25
  290. package/dist/tabs/createTabs.d.ts.map +1 -1
  291. package/dist/tabs/index.d.ts +1 -1
  292. package/dist/tag/createTag.d.ts +2 -2
  293. package/dist/tag/createTag.d.ts.map +1 -1
  294. package/dist/tag/createTagGroup.d.ts +5 -5
  295. package/dist/tag/createTagGroup.d.ts.map +1 -1
  296. package/dist/tag/index.d.ts +2 -2
  297. package/dist/tag/index.d.ts.map +1 -1
  298. package/dist/textfield/createTextField.d.ts +17 -11
  299. package/dist/textfield/createTextField.d.ts.map +1 -1
  300. package/dist/textfield/index.d.ts +1 -1
  301. package/dist/textfield/index.d.ts.map +1 -1
  302. package/dist/toast/createToast.d.ts +6 -2
  303. package/dist/toast/createToast.d.ts.map +1 -1
  304. package/dist/toast/createToastRegion.d.ts +5 -3
  305. package/dist/toast/createToastRegion.d.ts.map +1 -1
  306. package/dist/toast/index.d.ts +2 -2
  307. package/dist/toast/index.d.ts.map +1 -1
  308. package/dist/toggle/createToggle.d.ts +9 -9
  309. package/dist/toggle/createToggle.d.ts.map +1 -1
  310. package/dist/toggle/createToggleState.d.ts +2 -2
  311. package/dist/toggle/createToggleState.d.ts.map +1 -1
  312. package/dist/toggle/index.d.ts +4 -4
  313. package/dist/toggle/index.d.ts.map +1 -1
  314. package/dist/toolbar/createToolbar.d.ts +9 -9
  315. package/dist/toolbar/createToolbar.d.ts.map +1 -1
  316. package/dist/toolbar/index.d.ts +1 -1
  317. package/dist/toolbar/index.d.ts.map +1 -1
  318. package/dist/tooltip/createTooltip.d.ts +5 -5
  319. package/dist/tooltip/createTooltip.d.ts.map +1 -1
  320. package/dist/tooltip/createTooltipTrigger.d.ts +10 -5
  321. package/dist/tooltip/createTooltipTrigger.d.ts.map +1 -1
  322. package/dist/tooltip/index.d.ts +2 -2
  323. package/dist/tree/createTree.d.ts +3 -3
  324. package/dist/tree/createTree.d.ts.map +1 -1
  325. package/dist/tree/createTreeItem.d.ts +4 -4
  326. package/dist/tree/createTreeItem.d.ts.map +1 -1
  327. package/dist/tree/createTreeSelectionCheckbox.d.ts +3 -3
  328. package/dist/tree/createTreeSelectionCheckbox.d.ts.map +1 -1
  329. package/dist/tree/index.d.ts +4 -4
  330. package/dist/tree/types.d.ts +13 -5
  331. package/dist/tree/types.d.ts.map +1 -1
  332. package/dist/utils/createDescription.d.ts +2 -2
  333. package/dist/utils/createDescription.d.ts.map +1 -1
  334. package/dist/utils/dom.d.ts.map +1 -1
  335. package/dist/utils/env.d.ts +1 -1
  336. package/dist/utils/env.d.ts.map +1 -1
  337. package/dist/utils/focus.d.ts +1 -1
  338. package/dist/utils/focus.d.ts.map +1 -1
  339. package/dist/utils/geometry.d.ts.map +1 -1
  340. package/dist/utils/index.d.ts +12 -12
  341. package/dist/utils/index.d.ts.map +1 -1
  342. package/dist/utils/mergeProps.d.ts.map +1 -1
  343. package/dist/utils/platform.d.ts.map +1 -1
  344. package/dist/utils/reactivity.d.ts +1 -1
  345. package/dist/visually-hidden/createVisuallyHidden.d.ts +2 -2
  346. package/dist/visually-hidden/createVisuallyHidden.d.ts.map +1 -1
  347. package/dist/visually-hidden/index.d.ts +1 -1
  348. package/package.json +34 -32
  349. package/src/actiongroup/createActionGroup.ts +334 -0
  350. package/src/actiongroup/index.ts +8 -0
  351. package/src/autocomplete/createAutocomplete.ts +137 -131
  352. package/src/autocomplete/index.ts +1 -1
  353. package/src/breadcrumbs/createBreadcrumbs.ts +37 -51
  354. package/src/breadcrumbs/index.ts +1 -1
  355. package/src/button/createButton.ts +102 -73
  356. package/src/button/createToggleButton.ts +10 -10
  357. package/src/button/createToggleButtonGroup.ts +121 -0
  358. package/src/button/index.ts +10 -4
  359. package/src/button/types.ts +18 -12
  360. package/src/calendar/createCalendar.ts +62 -29
  361. package/src/calendar/createCalendarCell.ts +102 -48
  362. package/src/calendar/createCalendarGrid.ts +78 -47
  363. package/src/calendar/createRangeCalendar.ts +66 -31
  364. package/src/calendar/createRangeCalendarCell.ts +115 -37
  365. package/src/calendar/index.ts +5 -9
  366. package/src/calendar/intl/index.ts +210 -0
  367. package/src/calendar/utils.ts +227 -0
  368. package/src/checkbox/createCheckbox.ts +13 -21
  369. package/src/checkbox/createCheckboxGroup.ts +86 -45
  370. package/src/checkbox/createCheckboxGroupItem.ts +16 -27
  371. package/src/checkbox/createCheckboxGroupState.ts +3 -22
  372. package/src/checkbox/index.ts +8 -10
  373. package/src/collections/index.ts +246 -0
  374. package/src/color/createColorArea.ts +458 -314
  375. package/src/color/createColorField.ts +186 -137
  376. package/src/color/createColorSlider.ts +444 -197
  377. package/src/color/createColorSwatch.ts +65 -40
  378. package/src/color/createColorWheel.ts +343 -208
  379. package/src/color/index.ts +24 -24
  380. package/src/color/types.ts +198 -116
  381. package/src/combobox/createComboBox.ts +727 -647
  382. package/src/combobox/index.ts +6 -6
  383. package/src/combobox/intl/index.ts +5 -5
  384. package/src/datepicker/createDateField.ts +192 -39
  385. package/src/datepicker/createDatePicker.ts +294 -63
  386. package/src/datepicker/createDatePickerGroup.ts +149 -0
  387. package/src/datepicker/createDateRangePicker.ts +294 -0
  388. package/src/datepicker/createDateSegment.ts +316 -75
  389. package/src/datepicker/createTimeField.ts +38 -34
  390. package/src/datepicker/createTimeSegment.ts +352 -0
  391. package/src/datepicker/index.ts +24 -11
  392. package/src/dialog/createDialog.ts +127 -120
  393. package/src/dialog/index.ts +2 -2
  394. package/src/dialog/types.ts +19 -19
  395. package/src/disclosure/createDisclosure.ts +138 -33
  396. package/src/disclosure/createDisclosureGroup.ts +8 -18
  397. package/src/disclosure/index.ts +2 -2
  398. package/src/dnd/createDrag.ts +218 -209
  399. package/src/dnd/createDraggableCollection.ts +96 -63
  400. package/src/dnd/createDraggableItem.ts +260 -243
  401. package/src/dnd/createDrop.ts +313 -321
  402. package/src/dnd/createDroppableCollection.ts +799 -293
  403. package/src/dnd/createDroppableItem.ts +215 -213
  404. package/src/dnd/index.ts +66 -47
  405. package/src/dnd/types.ts +86 -89
  406. package/src/dnd/utils.ts +281 -294
  407. package/src/focus/FocusScope.tsx +155 -164
  408. package/src/focus/createAutoFocus.ts +305 -321
  409. package/src/focus/createFocusRestore.ts +300 -313
  410. package/src/focus/createVirtualFocus.ts +380 -396
  411. package/src/focus/index.ts +4 -8
  412. package/src/form/createFormReset.ts +4 -4
  413. package/src/form/createFormValidation.ts +201 -224
  414. package/src/form/index.ts +8 -11
  415. package/src/grid/GridKeyboardDelegate.ts +30 -30
  416. package/src/grid/createGrid.ts +38 -36
  417. package/src/grid/createGridCell.ts +18 -18
  418. package/src/grid/createGridRow.ts +14 -14
  419. package/src/grid/index.ts +5 -5
  420. package/src/grid/types.ts +8 -8
  421. package/src/gridlist/createGridList.ts +45 -24
  422. package/src/gridlist/createGridListItem.ts +68 -23
  423. package/src/gridlist/createGridListSelectionCheckbox.ts +12 -9
  424. package/src/gridlist/index.ts +4 -4
  425. package/src/gridlist/types.ts +11 -7
  426. package/src/i18n/createCollator.ts +66 -79
  427. package/src/i18n/createDateFormatter.ts +75 -83
  428. package/src/i18n/createFilter.ts +118 -131
  429. package/src/i18n/createNumberFormatter.ts +50 -52
  430. package/src/i18n/createStringFormatter.ts +19 -15
  431. package/src/i18n/index.ts +37 -40
  432. package/src/i18n/locale.tsx +163 -188
  433. package/src/i18n/utils.ts +95 -99
  434. package/src/index.ts +114 -164
  435. package/src/interactions/FocusableProvider.tsx +3 -7
  436. package/src/interactions/PressEvent.ts +4 -4
  437. package/src/interactions/createFocus.ts +16 -11
  438. package/src/interactions/createFocusRing.ts +21 -19
  439. package/src/interactions/createFocusWithin.ts +24 -16
  440. package/src/interactions/createFocusable.ts +15 -16
  441. package/src/interactions/createHover.ts +70 -55
  442. package/src/interactions/createInteractionModality.ts +75 -82
  443. package/src/interactions/createKeyboard.ts +2 -2
  444. package/src/interactions/createLongPress.ts +174 -174
  445. package/src/interactions/createMove.ts +299 -289
  446. package/src/interactions/createPress.ts +168 -91
  447. package/src/interactions/index.ts +24 -16
  448. package/src/label/createField.ts +18 -19
  449. package/src/label/createLabel.ts +18 -30
  450. package/src/label/createLabels.ts +8 -12
  451. package/src/label/index.ts +5 -5
  452. package/src/landmark/createLandmark.ts +356 -377
  453. package/src/landmark/index.ts +8 -8
  454. package/src/link/createLink.ts +96 -54
  455. package/src/link/index.ts +1 -1
  456. package/src/listbox/createListBox.ts +319 -269
  457. package/src/listbox/createOption.ts +208 -151
  458. package/src/listbox/index.ts +8 -12
  459. package/src/live-announcer/announce.ts +295 -322
  460. package/src/live-announcer/index.ts +9 -9
  461. package/src/menu/createMenu.ts +434 -396
  462. package/src/menu/createMenuItem.ts +201 -149
  463. package/src/menu/createMenuTrigger.ts +88 -88
  464. package/src/menu/index.ts +9 -18
  465. package/src/meter/createMeter.ts +7 -20
  466. package/src/meter/index.ts +1 -1
  467. package/src/numberfield/createNumberField.ts +368 -268
  468. package/src/numberfield/index.ts +5 -5
  469. package/src/overlays/ariaHideOutside.ts +223 -219
  470. package/src/overlays/createInteractOutside.ts +152 -149
  471. package/src/overlays/createModal.tsx +238 -202
  472. package/src/overlays/createOverlay.ts +195 -155
  473. package/src/overlays/createOverlayTrigger.ts +85 -85
  474. package/src/overlays/createPreventScroll.ts +288 -266
  475. package/src/overlays/index.ts +37 -44
  476. package/src/popover/calculatePosition.ts +117 -119
  477. package/src/popover/createOverlayPosition.ts +52 -43
  478. package/src/popover/createPopover.ts +63 -24
  479. package/src/popover/index.ts +3 -3
  480. package/src/progress/createProgressBar.ts +36 -32
  481. package/src/progress/index.ts +1 -1
  482. package/src/radio/createRadio.ts +95 -73
  483. package/src/radio/createRadioGroup.ts +142 -62
  484. package/src/radio/createRadioGroupState.ts +7 -31
  485. package/src/radio/index.ts +3 -8
  486. package/src/searchfield/createSearchField.ts +269 -186
  487. package/src/searchfield/index.ts +2 -2
  488. package/src/select/createHiddenSelect.tsx +276 -236
  489. package/src/select/createSelect.ts +430 -395
  490. package/src/select/index.ts +9 -14
  491. package/src/selection/createTypeSelect.ts +11 -11
  492. package/src/selection/index.ts +1 -1
  493. package/src/separator/createSeparator.ts +20 -25
  494. package/src/separator/index.ts +1 -1
  495. package/src/slider/createSlider.ts +333 -349
  496. package/src/slider/index.ts +2 -2
  497. package/src/ssr/index.tsx +331 -370
  498. package/src/steplist/createStepList.ts +106 -0
  499. package/src/steplist/index.ts +8 -0
  500. package/src/switch/createSwitch.ts +9 -14
  501. package/src/switch/index.ts +1 -1
  502. package/src/table/createTable.ts +155 -86
  503. package/src/table/createTableCell.ts +17 -16
  504. package/src/table/createTableColumnHeader.ts +67 -20
  505. package/src/table/createTableColumnResize.ts +256 -0
  506. package/src/table/createTableHeaderRow.ts +7 -7
  507. package/src/table/createTableRow.ts +149 -29
  508. package/src/table/createTableRowGroup.ts +5 -7
  509. package/src/table/createTableSelectAllCheckbox.ts +12 -11
  510. package/src/table/createTableSelectionCheckbox.ts +8 -8
  511. package/src/table/index.ts +14 -9
  512. package/src/table/types.ts +15 -7
  513. package/src/tabs/createTabs.ts +138 -127
  514. package/src/tabs/index.ts +1 -1
  515. package/src/tag/createTag.ts +171 -40
  516. package/src/tag/createTagGroup.ts +50 -39
  517. package/src/tag/index.ts +2 -6
  518. package/src/textfield/createTextField.ts +67 -35
  519. package/src/textfield/index.ts +1 -5
  520. package/src/toast/createToast.ts +34 -26
  521. package/src/toast/createToastRegion.ts +169 -27
  522. package/src/toast/index.ts +2 -6
  523. package/src/toggle/createToggle.ts +95 -53
  524. package/src/toggle/createToggleState.ts +2 -10
  525. package/src/toggle/index.ts +4 -5
  526. package/src/toolbar/createToolbar.ts +226 -169
  527. package/src/toolbar/index.ts +1 -1
  528. package/src/tooltip/createTooltip.ts +66 -79
  529. package/src/tooltip/createTooltipTrigger.ts +238 -222
  530. package/src/tooltip/index.ts +6 -6
  531. package/src/tree/createTree.ts +259 -246
  532. package/src/tree/createTreeItem.ts +282 -233
  533. package/src/tree/createTreeSelectionCheckbox.ts +71 -68
  534. package/src/tree/index.ts +16 -16
  535. package/src/tree/types.ts +95 -87
  536. package/src/utils/createDescription.ts +6 -23
  537. package/src/utils/dom.ts +61 -54
  538. package/src/utils/env.ts +53 -54
  539. package/src/utils/events.ts +7 -7
  540. package/src/utils/filterDOMProps.ts +49 -49
  541. package/src/utils/focus.ts +60 -68
  542. package/src/utils/geometry.ts +1 -4
  543. package/src/utils/globalListeners.ts +9 -9
  544. package/src/utils/index.ts +12 -22
  545. package/src/utils/mergeProps.ts +42 -15
  546. package/src/utils/platform.ts +16 -6
  547. package/src/utils/reactivity.ts +3 -3
  548. package/src/utils/textSelection.ts +16 -16
  549. package/src/visually-hidden/createVisuallyHidden.ts +127 -124
  550. package/src/visually-hidden/index.ts +6 -6
  551. package/dist/i18n/NumberFormatter.d.ts +0 -43
  552. package/dist/i18n/NumberFormatter.d.ts.map +0 -1
  553. package/dist/index.ssr.js +0 -15875
  554. package/dist/index.ssr.js.map +0 -7
  555. package/src/i18n/NumberFormatter.ts +0 -266
@@ -1,395 +1,430 @@
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
+ /** Whether the select is invalid. */
26
+ isInvalid?: boolean;
27
+ /** The label for the select. */
28
+ label?: JSX.Element;
29
+ /** An accessible label for the select when no visible label is provided. */
30
+ "aria-label"?: string;
31
+ /** The ID of an element that labels the select. */
32
+ "aria-labelledby"?: string;
33
+ /** The ID of an element that describes the select. */
34
+ "aria-describedby"?: string;
35
+ /** Placeholder text when no option is selected. */
36
+ placeholder?: string;
37
+ /** Whether the select should be auto-focused. */
38
+ autoFocus?: boolean;
39
+ /** Handler called when focus moves to the select. */
40
+ onFocus?: (e: FocusEvent) => void;
41
+ /** Handler called when focus moves away from the select. */
42
+ onBlur?: (e: FocusEvent) => void;
43
+ /** Handler called when the focus state changes. */
44
+ onFocusChange?: (isFocused: boolean) => void;
45
+ /** The name of the select, used when submitting an HTML form. */
46
+ name?: string;
47
+ /** Associates the hidden native select with a form element by id. */
48
+ form?: string;
49
+ /** Whether type-to-select is disabled. @default false */
50
+ disallowTypeAhead?: boolean;
51
+ /** Whether the select can open when its collection is empty. @default false */
52
+ allowsEmptyCollection?: boolean;
53
+ /** Whether validation should use ARIA attributes or native browser validation. */
54
+ validationBehavior?: "aria" | "native";
55
+ }
56
+
57
+ export interface SelectAria<T> {
58
+ /** Props for the label element. */
59
+ labelProps: JSX.HTMLAttributes<HTMLElement>;
60
+ /** Props for the trigger button element. */
61
+ triggerProps: JSX.HTMLAttributes<HTMLElement>;
62
+ /** Props for the value display element. */
63
+ valueProps: JSX.HTMLAttributes<HTMLElement>;
64
+ /** Props for the listbox/menu popup. */
65
+ menuProps: JSX.HTMLAttributes<HTMLElement>;
66
+ /** Props for the description element, if any. */
67
+ descriptionProps: JSX.HTMLAttributes<HTMLElement>;
68
+ /** Props for the error message element, if any. */
69
+ errorMessageProps: JSX.HTMLAttributes<HTMLElement>;
70
+ /** Whether the select is currently focused. */
71
+ isFocused: Accessor<boolean>;
72
+ /** Whether the select has keyboard focus. */
73
+ isFocusVisible: Accessor<boolean>;
74
+ /** Whether the select is currently open. */
75
+ isOpen: Accessor<boolean>;
76
+ /** The currently selected item. */
77
+ selectedItem: Accessor<CollectionNode<T> | null>;
78
+ }
79
+
80
+ // Shared data between select and options
81
+ const selectData = new WeakMap<object, SelectData>();
82
+
83
+ interface SelectData {
84
+ id: string;
85
+ }
86
+
87
+ export function getSelectData(state: SelectState): SelectData | undefined {
88
+ return selectData.get(state);
89
+ }
90
+
91
+ /**
92
+ * Provides the behavior and accessibility implementation for a select component.
93
+ */
94
+ export function createSelect<T>(
95
+ props: MaybeAccessor<AriaSelectProps>,
96
+ state: SelectState<T>,
97
+ _ref?: () => HTMLElement | null,
98
+ ): SelectAria<T> {
99
+ const getProps = () => access(props);
100
+ const id = createId(getProps().id);
101
+
102
+ // Generate IDs for associated elements
103
+ const buttonId = `${id}-button`;
104
+ const listBoxId = `${id}-listbox`;
105
+ const valueId = `${id}-value`;
106
+ const descriptionId = `${id}-description`;
107
+ const errorMessageId = `${id}-error`;
108
+
109
+ // Filter DOM props
110
+ const domProps = () =>
111
+ filterDOMProps(getProps() as unknown as Record<string, unknown>, { labelable: true });
112
+
113
+ // Share data with child options
114
+ createEffect(() => {
115
+ selectData.set(state, { id });
116
+
117
+ onCleanup(() => {
118
+ selectData.delete(state);
119
+ });
120
+ });
121
+
122
+ // Label handling
123
+ const { labelProps, fieldProps } = createLabel({
124
+ get id() {
125
+ return buttonId;
126
+ },
127
+ get label() {
128
+ return getProps().label;
129
+ },
130
+ get "aria-label"() {
131
+ return getProps()["aria-label"];
132
+ },
133
+ get "aria-labelledby"() {
134
+ return getProps()["aria-labelledby"];
135
+ },
136
+ labelElementType: "span",
137
+ });
138
+
139
+ // Focus ring for keyboard focus styling
140
+ const { isFocusVisible, focusProps } = createFocusRing({
141
+ get autoFocus() {
142
+ return getProps().autoFocus;
143
+ },
144
+ });
145
+
146
+ // Track focus state
147
+ const isFocused = state.isFocused;
148
+
149
+ // Handle press on trigger
150
+ const canOpen = () =>
151
+ getProps().allowsEmptyCollection || state.collection().getFirstKey() != null;
152
+
153
+ // Helper to check if key is disabled
154
+ const isKeyDisabled = (key: string | number): boolean => {
155
+ const collection = state.collection();
156
+ return state.isKeyDisabled?.(key) || collection.getItem(key)?.isDisabled || false;
157
+ };
158
+
159
+ // Helper to find the next non-disabled key.
160
+ const findNextKey = (
161
+ fromKey: string | number | null,
162
+ direction: "forward" | "backward",
163
+ ): string | number | null => {
164
+ const collection = state.collection();
165
+ const getAdjacent =
166
+ direction === "forward"
167
+ ? (k: string | number) => collection.getKeyAfter(k)
168
+ : (k: string | number) => collection.getKeyBefore(k);
169
+ const getBoundary =
170
+ direction === "forward" ? () => collection.getFirstKey() : () => collection.getLastKey();
171
+
172
+ let key = fromKey == null ? getBoundary() : getAdjacent(fromKey);
173
+ while (key != null && isKeyDisabled(key)) {
174
+ key = getAdjacent(key);
175
+ }
176
+
177
+ return key;
178
+ };
179
+
180
+ const focusKeyForOpen = (): string | number | null => {
181
+ const selectedKey = state.selectedKey();
182
+ if (selectedKey != null && !isKeyDisabled(selectedKey)) {
183
+ return selectedKey;
184
+ }
185
+ return findNextKey(null, "forward");
186
+ };
187
+
188
+ const openWithFocus = () => {
189
+ if (state.isOpen() || !canOpen()) {
190
+ return;
191
+ }
192
+ state.open();
193
+ const focusKey = focusKeyForOpen();
194
+ if (focusKey != null) {
195
+ state.setFocusedKey(focusKey);
196
+ }
197
+ };
198
+
199
+ const { pressProps } = createPress({
200
+ get isDisabled() {
201
+ return getProps().isDisabled ?? state.isDisabled;
202
+ },
203
+ onPress(e) {
204
+ if (e.pointerType === "keyboard") {
205
+ return;
206
+ }
207
+
208
+ if (state.isOpen()) {
209
+ state.close();
210
+ } else {
211
+ openWithFocus();
212
+ }
213
+ },
214
+ });
215
+
216
+ // Type-to-select - for Select, typing directly selects items when closed
217
+ const { typeSelectProps } = createTypeSelect({
218
+ collection: () => state.collection(),
219
+ focusedKey: () => state.selectedKey(), // Use selectedKey as the "focused" key for closed Select
220
+ onFocusedKeyChange: (key) => {
221
+ // When closed, type-to-select directly changes selection
222
+ if (!state.isOpen()) {
223
+ state.setSelectedKey(key);
224
+ } else {
225
+ // When open, update focused key (listbox handles selection)
226
+ state.setFocusedKey(key);
227
+ }
228
+ },
229
+ isKeyDisabled,
230
+ get isDisabled() {
231
+ return Boolean(
232
+ (getProps().disallowTypeAhead ?? false) || getProps().isDisabled || state.isDisabled,
233
+ );
234
+ },
235
+ });
236
+
237
+ // Keyboard navigation
238
+ const onKeyDown: JSX.EventHandler<HTMLElement, KeyboardEvent> = (e) => {
239
+ if (getProps().isDisabled ?? state.isDisabled) return;
240
+
241
+ const currentKey = state.focusedKey() ?? state.selectedKey();
242
+
243
+ switch (e.key) {
244
+ case "Enter":
245
+ case " ":
246
+ e.preventDefault();
247
+ if (state.isOpen()) {
248
+ state.close();
249
+ } else {
250
+ openWithFocus();
251
+ }
252
+ break;
253
+
254
+ case "ArrowDown":
255
+ e.preventDefault();
256
+ if (!state.isOpen()) {
257
+ if (!canOpen()) {
258
+ return;
259
+ }
260
+ // ArrowDown: Open the dropdown and focus first/selected item
261
+ state.open();
262
+ const focusKey =
263
+ currentKey != null && !isKeyDisabled(currentKey)
264
+ ? currentKey
265
+ : findNextKey(currentKey, "forward");
266
+ if (focusKey) {
267
+ state.setFocusedKey(focusKey);
268
+ }
269
+ }
270
+ // When open, navigation is handled by the listbox
271
+ break;
272
+
273
+ case "ArrowUp":
274
+ e.preventDefault();
275
+ if (!state.isOpen()) {
276
+ if (!canOpen()) {
277
+ return;
278
+ }
279
+ // ArrowUp: Open the dropdown and focus last/selected item
280
+ state.open();
281
+ const focusKey =
282
+ currentKey != null && !isKeyDisabled(currentKey)
283
+ ? currentKey
284
+ : findNextKey(currentKey, "backward");
285
+ if (focusKey) {
286
+ state.setFocusedKey(focusKey);
287
+ }
288
+ }
289
+ // When open, navigation is handled by the listbox
290
+ break;
291
+
292
+ case "ArrowRight":
293
+ // ArrowRight: Select next option (for horizontal keyboard navigation pattern)
294
+ if (!state.isOpen()) {
295
+ e.preventDefault();
296
+ const nextKey = findNextKey(currentKey, "forward");
297
+ if (nextKey != null) {
298
+ state.setSelectedKey(nextKey);
299
+ }
300
+ }
301
+ break;
302
+
303
+ case "ArrowLeft":
304
+ // ArrowLeft: Select previous option (for horizontal keyboard navigation pattern)
305
+ if (!state.isOpen()) {
306
+ e.preventDefault();
307
+ const prevKey = findNextKey(currentKey, "backward");
308
+ if (prevKey != null) {
309
+ state.setSelectedKey(prevKey);
310
+ }
311
+ }
312
+ break;
313
+
314
+ case "Home":
315
+ // Home: Select first option
316
+ if (!state.isOpen()) {
317
+ e.preventDefault();
318
+ const firstKey = findNextKey(null, "forward");
319
+ if (firstKey != null) {
320
+ state.setSelectedKey(firstKey);
321
+ }
322
+ }
323
+ break;
324
+
325
+ case "End":
326
+ // End: Select last option
327
+ if (!state.isOpen()) {
328
+ e.preventDefault();
329
+ const lastKey = findNextKey(null, "backward");
330
+ if (lastKey != null) {
331
+ state.setSelectedKey(lastKey);
332
+ }
333
+ }
334
+ break;
335
+
336
+ case "Escape":
337
+ if (state.isOpen()) {
338
+ e.preventDefault();
339
+ state.close();
340
+ }
341
+ break;
342
+ }
343
+ };
344
+
345
+ // Handle focus events
346
+ const handleFocus = (e: FocusEvent) => {
347
+ state.setFocused(true);
348
+ getProps().onFocus?.(e);
349
+ getProps().onFocusChange?.(true);
350
+ };
351
+
352
+ const handleBlur = (e: FocusEvent) => {
353
+ state.setFocused(false);
354
+ getProps().onBlur?.(e);
355
+ getProps().onFocusChange?.(false);
356
+ };
357
+
358
+ return {
359
+ get labelProps() {
360
+ return labelProps as JSX.HTMLAttributes<HTMLElement>;
361
+ },
362
+ get triggerProps() {
363
+ const p = getProps();
364
+ const isOpen = state.isOpen();
365
+ const isDisabled = p.isDisabled ?? state.isDisabled;
366
+
367
+ const baseProps = mergeProps(
368
+ domProps(),
369
+ pressProps as Record<string, unknown>,
370
+ focusProps as Record<string, unknown>,
371
+ fieldProps as Record<string, unknown>,
372
+ {
373
+ id: buttonId,
374
+ type: "button",
375
+ tabIndex: isDisabled ? undefined : 0,
376
+ "aria-haspopup": "listbox",
377
+ "aria-expanded": isOpen,
378
+ "aria-controls": isOpen ? listBoxId : undefined,
379
+ "aria-disabled": isDisabled || undefined,
380
+ "aria-required": p.isRequired || undefined,
381
+ "aria-describedby": p["aria-describedby"] || undefined,
382
+ onKeyDown,
383
+ onFocus: handleFocus,
384
+ onBlur: handleBlur,
385
+ "data-open": isOpen || undefined,
386
+ "data-disabled": isDisabled || undefined,
387
+ "data-focus-visible": isFocusVisible() || undefined,
388
+ } as Record<string, unknown>,
389
+ );
390
+
391
+ // Add type-select props if enabled
392
+ if (!p.disallowTypeAhead) {
393
+ return mergeProps(
394
+ baseProps,
395
+ typeSelectProps as Record<string, unknown>,
396
+ ) as JSX.HTMLAttributes<HTMLElement>;
397
+ }
398
+
399
+ return baseProps as JSX.HTMLAttributes<HTMLElement>;
400
+ },
401
+ get valueProps() {
402
+ return {
403
+ id: valueId,
404
+ } as JSX.HTMLAttributes<HTMLElement>;
405
+ },
406
+ get menuProps() {
407
+ return {
408
+ id: listBoxId,
409
+ role: "listbox",
410
+ "aria-labelledby": buttonId,
411
+ "aria-multiselectable": state.selectionMode() === "multiple" ? true : undefined,
412
+ tabIndex: -1,
413
+ } as JSX.HTMLAttributes<HTMLElement>;
414
+ },
415
+ get descriptionProps() {
416
+ return {
417
+ id: descriptionId,
418
+ } as JSX.HTMLAttributes<HTMLElement>;
419
+ },
420
+ get errorMessageProps() {
421
+ return {
422
+ id: errorMessageId,
423
+ } as JSX.HTMLAttributes<HTMLElement>;
424
+ },
425
+ isFocused,
426
+ isFocusVisible: () => isFocused() && isFocusVisible(),
427
+ isOpen: state.isOpen,
428
+ selectedItem: state.selectedItem,
429
+ };
430
+ }