@envsemble/envui 2.0.0 → 3.0.1

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 (1263) hide show
  1. package/CHANGELOG.md +258 -0
  2. package/README.md +14 -27
  3. package/dist/actions/Button.d.ts +25 -8
  4. package/dist/actions/Button.js.map +2 -2
  5. package/dist/actions/CommandPalette.d.ts +37 -9
  6. package/dist/actions/CommandPalette.js +111 -107
  7. package/dist/actions/CommandPalette.js.map +2 -2
  8. package/dist/actions/ConfirmButton.d.ts +1 -1
  9. package/dist/actions/ConfirmButton.js +2 -4
  10. package/dist/actions/ConfirmButton.js.map +2 -2
  11. package/dist/actions/ContextMenu.d.ts +1 -1
  12. package/dist/actions/ContextMenu.js +5 -6
  13. package/dist/actions/ContextMenu.js.map +2 -2
  14. package/dist/actions/CopyButton.js +2 -2
  15. package/dist/actions/CopyButton.js.map +2 -2
  16. package/dist/actions/Menubar.d.ts +12 -5
  17. package/dist/actions/Menubar.js +37 -29
  18. package/dist/actions/Menubar.js.map +3 -3
  19. package/dist/actions/Toolbar.d.ts +42 -2
  20. package/dist/actions/Toolbar.js +18 -0
  21. package/dist/actions/Toolbar.js.map +2 -2
  22. package/dist/actions/internal/ButtonBase.d.ts +3 -2
  23. package/dist/actions/internal/ButtonBase.js +2 -4
  24. package/dist/actions/internal/ButtonBase.js.map +2 -2
  25. package/dist/actions/internal/CommandPaletteOptions.d.ts +7 -6
  26. package/dist/actions/internal/CommandPaletteOptions.js +24 -15
  27. package/dist/actions/internal/CommandPaletteOptions.js.map +2 -2
  28. package/dist/actions/internal/CommandPaletteStatus.js +23 -9
  29. package/dist/actions/internal/CommandPaletteStatus.js.map +2 -2
  30. package/dist/actions/menu/Menu.d.ts +5 -4
  31. package/dist/actions/menu/Menu.js +3 -6
  32. package/dist/actions/menu/Menu.js.map +2 -2
  33. package/dist/actions/menu/MenuChoices.d.ts +9 -7
  34. package/dist/actions/menu/MenuChoices.js +34 -6
  35. package/dist/actions/menu/MenuChoices.js.map +2 -2
  36. package/dist/actions/menu/MenuItem.d.ts +37 -8
  37. package/dist/actions/menu/MenuItem.js +47 -12
  38. package/dist/actions/menu/MenuItem.js.map +2 -2
  39. package/dist/actions/menu/MenuSubmenu.d.ts +9 -3
  40. package/dist/actions/menu/MenuSubmenu.js +26 -24
  41. package/dist/actions/menu/MenuSubmenu.js.map +2 -2
  42. package/dist/actions/{internal → menu/internal}/MenuPopup.d.ts +2 -3
  43. package/dist/actions/{internal → menu/internal}/MenuPopup.js +7 -12
  44. package/dist/actions/menu/internal/MenuPopup.js.map +7 -0
  45. package/dist/actions/{internal → menu/internal}/menuOpenChange.d.ts +1 -1
  46. package/dist/actions/menu/internal/menuTriggerProps.d.ts +11 -0
  47. package/dist/actions/menu/internal/menuTriggerProps.js +1 -0
  48. package/dist/assets/readme/overview-dark.png +0 -0
  49. package/dist/assets/readme/overview-light.png +0 -0
  50. package/dist/content/Accordion.d.ts +32 -2
  51. package/dist/content/Accordion.js +41 -12
  52. package/dist/content/Accordion.js.map +2 -2
  53. package/dist/content/CodeBlock.d.ts +13 -4
  54. package/dist/content/CodeBlock.js +2 -0
  55. package/dist/content/CodeBlock.js.map +2 -2
  56. package/dist/content/CodeDiff.d.ts +34 -4
  57. package/dist/content/CodeDiff.js +41 -24
  58. package/dist/content/CodeDiff.js.map +2 -2
  59. package/dist/content/Composer.d.ts +19 -2
  60. package/dist/content/Composer.js +19 -12
  61. package/dist/content/Composer.js.map +2 -2
  62. package/dist/content/Disclosure.d.ts +13 -1
  63. package/dist/content/Disclosure.js +9 -3
  64. package/dist/content/Disclosure.js.map +2 -2
  65. package/dist/content/HighlightedCodeBlock.d.ts +1 -1
  66. package/dist/content/HighlightedCodeBlock.js +2 -0
  67. package/dist/content/HighlightedCodeBlock.js.map +2 -2
  68. package/dist/content/Kbd.d.ts +12 -5
  69. package/dist/content/Kbd.js +2 -2
  70. package/dist/content/Kbd.js.map +2 -2
  71. package/dist/content/Markdown.d.ts +17 -1
  72. package/dist/content/Markdown.js +26 -4
  73. package/dist/content/Markdown.js.map +2 -2
  74. package/dist/content/Message.d.ts +29 -33
  75. package/dist/content/Message.js +21 -21
  76. package/dist/content/Message.js.map +2 -2
  77. package/dist/content/countDiffLines.d.ts +1 -1
  78. package/dist/content/countDiffLines.js.map +1 -1
  79. package/dist/content/internal/CodeBlockFrame.d.ts +3 -2
  80. package/dist/content/internal/CodeBlockFrame.js +25 -13
  81. package/dist/content/internal/CodeBlockFrame.js.map +2 -2
  82. package/dist/content/internal/MessageListFollow.js +1 -1
  83. package/dist/content/internal/MessageListFollow.js.map +2 -2
  84. package/dist/content/internal/MessageStatusLabel.d.ts +2 -1
  85. package/dist/content/internal/MessageStatusLabel.js.map +2 -2
  86. package/dist/content/internal/codeColors.js +2 -2
  87. package/dist/content/internal/codeColors.js.map +2 -2
  88. package/dist/content/internal/useCodeContrast.js +4 -3
  89. package/dist/content/internal/useCodeContrast.js.map +2 -2
  90. package/dist/data-display/Avatar.d.ts +13 -4
  91. package/dist/data-display/Avatar.js +8 -4
  92. package/dist/data-display/Avatar.js.map +2 -2
  93. package/dist/data-display/AvatarButton.d.ts +20 -5
  94. package/dist/data-display/AvatarButton.js +17 -2
  95. package/dist/data-display/AvatarButton.js.map +2 -2
  96. package/dist/data-display/AvatarGroup.d.ts +28 -12
  97. package/dist/data-display/AvatarGroup.js +21 -32
  98. package/dist/data-display/AvatarGroup.js.map +2 -2
  99. package/dist/data-display/Badge.d.ts +11 -8
  100. package/dist/data-display/Badge.js +4 -3
  101. package/dist/data-display/Badge.js.map +2 -2
  102. package/dist/data-display/List.d.ts +21 -9
  103. package/dist/data-display/List.js +1 -1
  104. package/dist/data-display/List.js.map +2 -2
  105. package/dist/data-display/Meter.d.ts +7 -1
  106. package/dist/data-display/Meter.js +11 -5
  107. package/dist/data-display/Meter.js.map +2 -2
  108. package/dist/data-display/RelativeTime.d.ts +8 -2
  109. package/dist/data-display/RelativeTime.js +18 -7
  110. package/dist/data-display/RelativeTime.js.map +2 -2
  111. package/dist/data-display/Table.d.ts +26 -7
  112. package/dist/data-display/Table.js +70 -65
  113. package/dist/data-display/Table.js.map +2 -2
  114. package/dist/data-display/formatRelativeTime.d.ts +0 -2
  115. package/dist/data-display/formatRelativeTime.js +4 -28
  116. package/dist/data-display/formatRelativeTime.js.map +2 -2
  117. package/dist/data-display/internal/ListNaming.js +1 -1
  118. package/dist/data-display/internal/ListNaming.js.map +1 -1
  119. package/dist/data-display/internal/ReorderableList.d.ts +3 -2
  120. package/dist/data-display/internal/ReorderableList.js +11 -16
  121. package/dist/data-display/internal/ReorderableList.js.map +2 -2
  122. package/dist/data-display/internal/avatarName.d.ts +2 -0
  123. package/dist/data-display/internal/avatarName.js +7 -0
  124. package/dist/data-display/internal/avatarName.js.map +7 -0
  125. package/dist/data-display/internal/{ListRows.d.ts → listMarkup.d.ts} +1 -1
  126. package/dist/data-display/internal/{ListRows.js → listMarkup.js} +29 -15
  127. package/dist/data-display/internal/listMarkup.js.map +7 -0
  128. package/dist/data-display/internal/relativeTimeFormat.d.ts +3 -0
  129. package/dist/data-display/internal/relativeTimeFormat.js +12 -0
  130. package/dist/data-display/internal/relativeTimeFormat.js.map +7 -0
  131. package/dist/data-display/internal/reorderController.js +3 -3
  132. package/dist/data-display/internal/reorderController.js.map +2 -2
  133. package/dist/data-display/internal/reorderGeometry.d.ts +0 -1
  134. package/dist/data-display/internal/reorderGeometry.js +1 -10
  135. package/dist/data-display/internal/reorderGeometry.js.map +2 -2
  136. package/dist/data-display/internal/tableColumns.js +8 -9
  137. package/dist/data-display/internal/tableColumns.js.map +2 -2
  138. package/dist/{internal/react/useStackedReport.d.ts → data-display/internal/tableStacking.d.ts} +2 -0
  139. package/dist/data-display/internal/tableStacking.js +49 -0
  140. package/dist/data-display/internal/tableStacking.js.map +7 -0
  141. package/dist/data-display/internal/useReorder.js +1 -1
  142. package/dist/data-display/internal/useReorder.js.map +1 -1
  143. package/dist/diff.d.ts +1 -1
  144. package/dist/diff.js +1 -4
  145. package/dist/diff.js.map +2 -2
  146. package/dist/feedback/Alert.d.ts +13 -3
  147. package/dist/feedback/Alert.js +16 -6
  148. package/dist/feedback/Alert.js.map +2 -2
  149. package/dist/feedback/EmptyState.d.ts +12 -3
  150. package/dist/feedback/EmptyState.js +6 -6
  151. package/dist/feedback/EmptyState.js.map +2 -2
  152. package/dist/feedback/Halo.d.ts +27 -0
  153. package/dist/feedback/Halo.js +21 -0
  154. package/dist/feedback/Halo.js.map +7 -0
  155. package/dist/feedback/Progress.js +3 -2
  156. package/dist/feedback/Progress.js.map +2 -2
  157. package/dist/feedback/toast/ToastProvider.js +1 -1
  158. package/dist/feedback/toast/ToastProvider.js.map +1 -1
  159. package/dist/feedback/toast/internal/ContainedToast.d.ts +12 -0
  160. package/dist/feedback/toast/internal/ContainedToast.js +43 -0
  161. package/dist/feedback/toast/internal/ContainedToast.js.map +7 -0
  162. package/dist/feedback/toast/internal/{PictureNotice.d.ts → ContainedToastRoot.d.ts} +1 -1
  163. package/dist/feedback/toast/internal/{PictureNotice.js → ContainedToastRoot.js} +3 -3
  164. package/dist/feedback/toast/internal/ContainedToastRoot.js.map +7 -0
  165. package/dist/feedback/toast/internal/LiveToast.d.ts +10 -0
  166. package/dist/feedback/toast/internal/LiveToast.js +78 -0
  167. package/dist/feedback/toast/internal/LiveToast.js.map +7 -0
  168. package/dist/feedback/toast/internal/ToastBody.d.ts +2 -1
  169. package/dist/feedback/toast/internal/ToastBody.js +6 -2
  170. package/dist/feedback/toast/internal/ToastBody.js.map +2 -2
  171. package/dist/feedback/toast/internal/ToastButtons.d.ts +14 -0
  172. package/dist/feedback/toast/internal/ToastButtons.js +77 -0
  173. package/dist/feedback/toast/internal/ToastButtons.js.map +7 -0
  174. package/dist/feedback/toast/internal/ToastManagerContext.d.ts +3 -0
  175. package/dist/feedback/toast/internal/ToastManagerContext.js +7 -0
  176. package/dist/feedback/toast/internal/ToastManagerContext.js.map +7 -0
  177. package/dist/feedback/toast/internal/ToastRegion.js +43 -172
  178. package/dist/feedback/toast/internal/ToastRegion.js.map +2 -2
  179. package/dist/feedback/toast/internal/toastEntry.d.ts +9 -2
  180. package/dist/feedback/toast/internal/toastEntry.js +10 -1
  181. package/dist/feedback/toast/internal/toastEntry.js.map +2 -2
  182. package/dist/feedback/toast/internal/useToastController.d.ts +3 -3
  183. package/dist/feedback/toast/internal/useToastController.js +4 -2
  184. package/dist/feedback/toast/internal/useToastController.js.map +2 -2
  185. package/dist/feedback/toast/internal/useToastGlide.js +2 -1
  186. package/dist/feedback/toast/internal/useToastGlide.js.map +2 -2
  187. package/dist/feedback/toast/toastTypes.d.ts +38 -11
  188. package/dist/feedback/toast/useToast.d.ts +0 -2
  189. package/dist/feedback/toast/useToast.js +2 -3
  190. package/dist/feedback/toast/useToast.js.map +2 -2
  191. package/dist/forms/Calendar.d.ts +30 -11
  192. package/dist/forms/Calendar.js +19 -13
  193. package/dist/forms/Calendar.js.map +2 -2
  194. package/dist/forms/Checkbox.d.ts +7 -1
  195. package/dist/forms/Checkbox.js +33 -27
  196. package/dist/forms/Checkbox.js.map +2 -2
  197. package/dist/forms/Combobox.d.ts +4 -4
  198. package/dist/forms/Combobox.js +26 -146
  199. package/dist/forms/Combobox.js.map +2 -2
  200. package/dist/forms/DatePicker.d.ts +38 -11
  201. package/dist/forms/DatePicker.js +32 -52
  202. package/dist/forms/DatePicker.js.map +2 -2
  203. package/dist/forms/DropZone.d.ts +23 -4
  204. package/dist/forms/DropZone.js +29 -11
  205. package/dist/forms/DropZone.js.map +2 -2
  206. package/dist/forms/Field.d.ts +7 -1
  207. package/dist/forms/Field.js +13 -6
  208. package/dist/forms/Field.js.map +2 -2
  209. package/dist/forms/MonthPicker.d.ts +8 -1
  210. package/dist/forms/MonthPicker.js +22 -42
  211. package/dist/forms/MonthPicker.js.map +2 -2
  212. package/dist/forms/Radio.d.ts +15 -5
  213. package/dist/forms/Radio.js +20 -18
  214. package/dist/forms/Radio.js.map +2 -2
  215. package/dist/forms/SearchField.d.ts +13 -5
  216. package/dist/forms/SearchField.js +26 -21
  217. package/dist/forms/SearchField.js.map +2 -2
  218. package/dist/forms/SegmentedControl.d.ts +37 -8
  219. package/dist/forms/SegmentedControl.js +31 -25
  220. package/dist/forms/SegmentedControl.js.map +2 -2
  221. package/dist/forms/Select.d.ts +31 -6
  222. package/dist/forms/Select.js +43 -24
  223. package/dist/forms/Select.js.map +2 -2
  224. package/dist/forms/Slider.d.ts +12 -4
  225. package/dist/forms/Slider.js +32 -21
  226. package/dist/forms/Slider.js.map +2 -2
  227. package/dist/forms/Switch.d.ts +7 -1
  228. package/dist/forms/Switch.js +31 -25
  229. package/dist/forms/Switch.js.map +2 -2
  230. package/dist/forms/TextField.d.ts +5 -5
  231. package/dist/forms/TextField.js +20 -11
  232. package/dist/forms/TextField.js.map +2 -2
  233. package/dist/forms/Textarea.d.ts +1 -1
  234. package/dist/forms/Textarea.js +12 -2
  235. package/dist/forms/Textarea.js.map +2 -2
  236. package/dist/forms/TimePicker.d.ts +8 -1
  237. package/dist/forms/TimePicker.js +20 -45
  238. package/dist/forms/TimePicker.js.map +2 -2
  239. package/dist/forms/color/ColorPicker.d.ts +1 -1
  240. package/dist/forms/color/ColorPicker.js +29 -23
  241. package/dist/forms/color/ColorPicker.js.map +2 -2
  242. package/dist/forms/color/ColorPickerButton.d.ts +12 -2
  243. package/dist/forms/color/ColorPickerButton.js +37 -22
  244. package/dist/forms/color/ColorPickerButton.js.map +2 -2
  245. package/dist/forms/color/ColorSwatch.js +2 -2
  246. package/dist/forms/color/ColorSwatch.js.map +2 -2
  247. package/dist/forms/color/internal/{colorChange.js → ColorChangeContext.js} +1 -1
  248. package/dist/forms/color/internal/{colorChange.js.map → ColorChangeContext.js.map} +1 -1
  249. package/dist/forms/color/internal/ColorLocale.d.ts +0 -3
  250. package/dist/forms/color/internal/ColorLocale.js +2 -8
  251. package/dist/forms/color/internal/ColorLocale.js.map +2 -2
  252. package/dist/forms/color/internal/ColorValues.d.ts +1 -1
  253. package/dist/forms/color/internal/ColorValues.js +2 -2
  254. package/dist/forms/color/internal/ColorValues.js.map +2 -2
  255. package/dist/forms/color/internal/SwatchList.js +6 -9
  256. package/dist/forms/color/internal/SwatchList.js.map +2 -2
  257. package/dist/forms/color/internal/colorPickerValueProps.d.ts +12 -0
  258. package/dist/forms/color/internal/colorValue.d.ts +1 -0
  259. package/dist/forms/color/internal/colorValue.js +5 -0
  260. package/dist/forms/color/internal/colorValue.js.map +2 -2
  261. package/dist/forms/color/internal/useColorFollowingValue.d.ts +7 -0
  262. package/dist/forms/color/internal/useColorFollowingValue.js +15 -0
  263. package/dist/forms/color/internal/useColorFollowingValue.js.map +7 -0
  264. package/dist/forms/color/internal/useFormResetting.d.ts +9 -0
  265. package/dist/forms/color/internal/useFormResetting.js +36 -0
  266. package/dist/forms/color/internal/useFormResetting.js.map +7 -0
  267. package/dist/forms/color/internal/useSwatchFocus.d.ts +17 -0
  268. package/dist/forms/color/internal/useSwatchFocus.js +62 -0
  269. package/dist/forms/color/internal/useSwatchFocus.js.map +7 -0
  270. package/dist/forms/internal/ComboboxField.d.ts +30 -0
  271. package/dist/forms/internal/ComboboxField.js +147 -0
  272. package/dist/forms/internal/ComboboxField.js.map +7 -0
  273. package/dist/forms/internal/ComboboxPopup.d.ts +2 -2
  274. package/dist/forms/internal/ComboboxPopup.js +8 -16
  275. package/dist/forms/internal/ComboboxPopup.js.map +2 -2
  276. package/dist/forms/internal/MonthGrid.d.ts +1 -1
  277. package/dist/forms/internal/MonthGrid.js +4 -4
  278. package/dist/forms/internal/MonthGrid.js.map +2 -2
  279. package/dist/forms/internal/PickerField.d.ts +32 -27
  280. package/dist/forms/internal/PickerField.js +70 -52
  281. package/dist/forms/internal/PickerField.js.map +3 -3
  282. package/dist/forms/internal/PickerPopup.d.ts +2 -1
  283. package/dist/forms/internal/PickerPopup.js +3 -0
  284. package/dist/forms/internal/PickerPopup.js.map +2 -2
  285. package/dist/forms/internal/TimeList.d.ts +1 -1
  286. package/dist/forms/internal/TimeList.js +4 -4
  287. package/dist/forms/internal/TimeList.js.map +2 -2
  288. package/dist/forms/internal/TimeWheel.d.ts +3 -3
  289. package/dist/forms/internal/TimeWheel.js +5 -5
  290. package/dist/forms/internal/TimeWheel.js.map +2 -2
  291. package/dist/{internal/time → forms/internal}/calendarDays.d.ts +1 -0
  292. package/dist/{internal/time → forms/internal}/calendarDays.js +5 -1
  293. package/dist/forms/internal/calendarDays.js.map +7 -0
  294. package/dist/forms/internal/comboboxItems.d.ts +15 -4
  295. package/dist/forms/internal/comboboxItems.js +0 -12
  296. package/dist/forms/internal/comboboxItems.js.map +3 -3
  297. package/dist/forms/internal/pickerFocus.d.ts +4 -0
  298. package/dist/forms/internal/pickerFocus.js +13 -0
  299. package/dist/forms/internal/pickerFocus.js.map +7 -0
  300. package/dist/forms/internal/timeWheelRows.d.ts +4 -4
  301. package/dist/forms/internal/timeWheelRows.js +6 -4
  302. package/dist/forms/internal/timeWheelRows.js.map +2 -2
  303. package/dist/forms/internal/useComboboxOpen.js +2 -5
  304. package/dist/forms/internal/useComboboxOpen.js.map +2 -2
  305. package/dist/forms/internal/useComboboxOptions.js +3 -4
  306. package/dist/forms/internal/useComboboxOptions.js.map +2 -2
  307. package/dist/forms/internal/useComboboxSelection.d.ts +1 -1
  308. package/dist/forms/internal/usePicker.d.ts +29 -0
  309. package/dist/forms/internal/usePicker.js +38 -0
  310. package/dist/forms/internal/usePicker.js.map +7 -0
  311. package/dist/forms/internal/usePickerFormatter.d.ts +4 -0
  312. package/dist/forms/internal/usePickerFormatter.js +23 -0
  313. package/dist/forms/internal/usePickerFormatter.js.map +7 -0
  314. package/dist/forms/internal/useTimeWheelTurn.d.ts +2 -2
  315. package/dist/forms/internal/useTimeWheelTurn.js +7 -7
  316. package/dist/forms/internal/useTimeWheelTurn.js.map +2 -2
  317. package/dist/foundations/PortalContainer.js +1 -1
  318. package/dist/foundations/PortalContainer.js.map +1 -1
  319. package/dist/foundations/Theme.d.ts +9 -2
  320. package/dist/foundations/Theme.js +24 -19
  321. package/dist/foundations/Theme.js.map +2 -2
  322. package/dist/foundations/ThemeMenuRadioGroup.d.ts +13 -6
  323. package/dist/foundations/ThemeMenuRadioGroup.js +6 -11
  324. package/dist/foundations/ThemeMenuRadioGroup.js.map +2 -2
  325. package/dist/foundations/ThemePreferenceProvider.d.ts +48 -0
  326. package/dist/foundations/{ThemePreference.js → ThemePreferenceProvider.js} +48 -106
  327. package/dist/foundations/ThemePreferenceProvider.js.map +7 -0
  328. package/dist/foundations/ThemeToggle.d.ts +9 -2
  329. package/dist/foundations/ThemeToggle.js +3 -2
  330. package/dist/foundations/ThemeToggle.js.map +2 -2
  331. package/dist/foundations/internal/ThemePreferenceContext.d.ts +4 -4
  332. package/dist/foundations/internal/ThemePreferenceContext.js.map +1 -1
  333. package/dist/foundations/internal/storedPreference.d.ts +3 -0
  334. package/dist/foundations/internal/storedPreference.js +8 -0
  335. package/dist/foundations/internal/storedPreference.js.map +7 -0
  336. package/dist/foundations/messages/defaultMessages.d.ts +4 -72
  337. package/dist/foundations/messages/defaultMessages.js +0 -14
  338. package/dist/foundations/messages/defaultMessages.js.map +2 -2
  339. package/dist/foundations/messages/list.d.ts +13 -35
  340. package/dist/foundations/messages/list.js +1 -5
  341. package/dist/foundations/messages/list.js.map +2 -2
  342. package/dist/foundations/messages/message.d.ts +1 -1
  343. package/dist/foundations/messages/message.js +1 -1
  344. package/dist/foundations/messages/message.js.map +1 -1
  345. package/dist/foundations/messages/navigation.d.ts +4 -0
  346. package/dist/foundations/messages/navigation.js +2 -0
  347. package/dist/foundations/messages/navigation.js.map +2 -2
  348. package/dist/foundations/themeBootstrap.d.ts +13 -35
  349. package/dist/foundations/themeBootstrap.js +4 -35
  350. package/dist/foundations/themeBootstrap.js.map +2 -2
  351. package/dist/foundations/themeStorage.d.ts +20 -0
  352. package/dist/foundations/themeStorage.js +12 -0
  353. package/dist/foundations/themeStorage.js.map +7 -0
  354. package/dist/foundations/useContainerSize.js +13 -11
  355. package/dist/foundations/useContainerSize.js.map +2 -2
  356. package/dist/foundations/useSkeleton.d.ts +5 -0
  357. package/dist/foundations/useSkeleton.js +10 -0
  358. package/dist/foundations/useSkeleton.js.map +7 -0
  359. package/dist/foundations/useStoredThemePreference.d.ts +16 -0
  360. package/dist/foundations/useStoredThemePreference.js +63 -0
  361. package/dist/foundations/useStoredThemePreference.js.map +7 -0
  362. package/dist/foundations/windowClasses.d.ts +0 -2
  363. package/dist/foundations/windowClasses.js +1 -4
  364. package/dist/foundations/windowClasses.js.map +2 -2
  365. package/dist/index.d.ts +15 -20
  366. package/dist/index.js +16 -36
  367. package/dist/index.js.map +2 -2
  368. package/dist/internal/control/ActionElement.d.ts +3 -2
  369. package/dist/internal/control/ActionElement.js +8 -0
  370. package/dist/internal/control/ActionElement.js.map +2 -2
  371. package/dist/internal/dialog/ModalLayer.d.ts +9 -0
  372. package/dist/internal/dialog/ModalLayer.js +32 -0
  373. package/dist/internal/dialog/ModalLayer.js.map +7 -0
  374. package/dist/internal/dom/idRefs.d.ts +2 -0
  375. package/dist/internal/dom/idRefs.js +7 -0
  376. package/dist/internal/dom/idRefs.js.map +7 -0
  377. package/dist/internal/dom/lengths.d.ts +3 -1
  378. package/dist/internal/dom/lengths.js +7 -2
  379. package/dist/internal/dom/lengths.js.map +2 -2
  380. package/dist/internal/dom/observeResize.d.ts +7 -0
  381. package/dist/internal/dom/observeResize.js +11 -0
  382. package/dist/internal/dom/observeResize.js.map +7 -0
  383. package/dist/internal/dom/verticalScrollerOf.d.ts +5 -0
  384. package/dist/internal/dom/verticalScrollerOf.js +12 -0
  385. package/dist/internal/dom/verticalScrollerOf.js.map +7 -0
  386. package/dist/internal/field/FieldFrame.d.ts +2 -61
  387. package/dist/internal/field/FieldFrame.js +17 -8
  388. package/dist/internal/field/FieldFrame.js.map +2 -2
  389. package/dist/internal/field/{rowControl.d.ts → RowControl.d.ts} +2 -2
  390. package/dist/internal/field/{rowControl.js → RowControl.js} +4 -7
  391. package/dist/internal/field/RowControl.js.map +7 -0
  392. package/dist/internal/field/TextareaControl.d.ts +2 -2
  393. package/dist/internal/field/TextareaControl.js +5 -11
  394. package/dist/internal/field/TextareaControl.js.map +2 -2
  395. package/dist/internal/field/{TextareaResizeEdge.d.ts → TextareaResizeHandle.d.ts} +1 -1
  396. package/dist/internal/field/{TextareaResizeEdge.js → TextareaResizeHandle.js} +10 -11
  397. package/dist/internal/field/TextareaResizeHandle.js.map +7 -0
  398. package/dist/internal/field/fieldProps.d.ts +67 -0
  399. package/dist/internal/field/fieldProps.js +1 -0
  400. package/dist/internal/field/fieldProps.js.map +7 -0
  401. package/dist/internal/field/fieldSizing.d.ts +1 -0
  402. package/dist/internal/field/fieldSizing.js +5 -0
  403. package/dist/internal/field/fieldSizing.js.map +7 -0
  404. package/dist/internal/field/useFieldControl.d.ts +36 -0
  405. package/dist/internal/field/useFieldControl.js +53 -0
  406. package/dist/internal/field/useFieldControl.js.map +7 -0
  407. package/dist/internal/field/useFormReset.js +1 -1
  408. package/dist/internal/field/useFormReset.js.map +1 -1
  409. package/dist/internal/icon/DecorativeIcon.d.ts +2 -1
  410. package/dist/internal/icon/DecorativeIcon.js +6 -2
  411. package/dist/internal/icon/DecorativeIcon.js.map +2 -2
  412. package/dist/internal/layout/Slot.d.ts +2 -1
  413. package/dist/internal/layout/Slot.js +3 -1
  414. package/dist/internal/layout/Slot.js.map +2 -2
  415. package/dist/internal/popup/ListRow.d.ts +39 -0
  416. package/dist/internal/{list → popup}/ListRow.js +15 -7
  417. package/dist/internal/popup/ListRow.js.map +7 -0
  418. package/dist/internal/popup/PopupSurface.d.ts +1 -1
  419. package/dist/internal/popup/PopupSurface.js +3 -6
  420. package/dist/internal/popup/PopupSurface.js.map +2 -2
  421. package/dist/internal/popup/TooltipPopup.d.ts +3 -9
  422. package/dist/internal/popup/TooltipPopup.js +2 -9
  423. package/dist/internal/popup/TooltipPopup.js.map +2 -2
  424. package/dist/internal/popup/{PortalContainerContext.d.ts → containedOverlays.d.ts} +2 -14
  425. package/dist/internal/popup/{PortalContainerContext.js → containedOverlays.js} +7 -13
  426. package/dist/internal/popup/containedOverlays.js.map +7 -0
  427. package/dist/internal/popup/listEntries.d.ts +13 -0
  428. package/dist/internal/popup/listEntries.js +11 -0
  429. package/dist/internal/popup/listEntries.js.map +7 -0
  430. package/dist/internal/popup/useCutShort.d.ts +6 -0
  431. package/dist/internal/popup/useCutShort.js +19 -0
  432. package/dist/internal/popup/useCutShort.js.map +7 -0
  433. package/dist/internal/provider/PortalContainerContext.d.ts +14 -0
  434. package/dist/internal/provider/PortalContainerContext.js +11 -0
  435. package/dist/internal/provider/PortalContainerContext.js.map +7 -0
  436. package/dist/internal/provider/formatters.d.ts +17 -0
  437. package/dist/internal/provider/formatters.js +21 -0
  438. package/dist/internal/provider/formatters.js.map +7 -0
  439. package/dist/internal/provider/locale.d.ts +4 -4
  440. package/dist/internal/provider/locale.js +9 -1
  441. package/dist/internal/provider/locale.js.map +2 -2
  442. package/dist/internal/provider/useDirection.d.ts +1 -1
  443. package/dist/internal/provider/useDirection.js +2 -14
  444. package/dist/internal/provider/useDirection.js.map +2 -2
  445. package/dist/internal/provider/useFormatters.d.ts +1 -16
  446. package/dist/internal/provider/useFormatters.js +3 -26
  447. package/dist/internal/provider/useFormatters.js.map +2 -2
  448. package/dist/internal/rangeBarProps.d.ts +6 -2
  449. package/dist/internal/react/chainHandlers.d.ts +6 -0
  450. package/dist/internal/react/chainHandlers.js +12 -0
  451. package/dist/internal/react/chainHandlers.js.map +7 -0
  452. package/dist/internal/react/renderElement.js +2 -14
  453. package/dist/internal/react/renderElement.js.map +2 -2
  454. package/dist/internal/react/rendersContent.d.ts +2 -0
  455. package/dist/internal/react/rendersContent.js +7 -0
  456. package/dist/internal/react/rendersContent.js.map +7 -0
  457. package/dist/internal/react/setRef.d.ts +6 -1
  458. package/dist/internal/react/setRef.js +13 -0
  459. package/dist/internal/react/setRef.js.map +2 -2
  460. package/dist/internal/react/useControllableState.js +1 -1
  461. package/dist/internal/react/useControllableState.js.map +1 -1
  462. package/dist/internal/{useCopy.js.map → react/useCopy.js.map} +1 -1
  463. package/dist/internal/{useLatest.js.map → react/useLatest.js.map} +1 -1
  464. package/dist/internal/react/useMergedRefs.d.ts +3 -0
  465. package/dist/internal/react/useMergedRefs.js +10 -0
  466. package/dist/internal/react/useMergedRefs.js.map +7 -0
  467. package/dist/internal/resize/useResizableWidth.d.ts +4 -16
  468. package/dist/internal/resize/useResizableWidth.js +5 -17
  469. package/dist/internal/resize/useResizableWidth.js.map +2 -2
  470. package/dist/internal/sizeTokens.d.ts +13 -0
  471. package/dist/internal/sizeTokens.js +15 -0
  472. package/dist/internal/sizeTokens.js.map +7 -0
  473. package/dist/internal/skeleton/SkeletonContext.d.ts +2 -0
  474. package/dist/internal/skeleton/SkeletonContext.js +7 -0
  475. package/dist/internal/skeleton/SkeletonContext.js.map +7 -0
  476. package/dist/{foundations → internal/skeleton}/SkeletonScope.d.ts +0 -10
  477. package/dist/{foundations → internal/skeleton}/SkeletonScope.js +6 -11
  478. package/dist/internal/skeleton/SkeletonScope.js.map +7 -0
  479. package/dist/internal/{skeleton.d.ts → skeleton/skeleton.d.ts} +1 -3
  480. package/dist/internal/{skeleton.js → skeleton/skeleton.js} +1 -2
  481. package/dist/internal/skeleton/skeleton.js.map +7 -0
  482. package/dist/{foundations/internal → internal/skeleton}/skeletonText.js +5 -5
  483. package/dist/internal/skeleton/skeletonText.js.map +7 -0
  484. package/dist/internal/text/labelText.d.ts +15 -0
  485. package/dist/internal/text/labelText.js +34 -0
  486. package/dist/internal/text/labelText.js.map +7 -0
  487. package/dist/internal/text/useRenderedText.d.ts +3 -0
  488. package/dist/internal/text/useRenderedText.js +19 -0
  489. package/dist/internal/text/useRenderedText.js.map +7 -0
  490. package/dist/internal/theme/themeRoot.d.ts +27 -0
  491. package/dist/internal/theme/themeRoot.js +45 -0
  492. package/dist/internal/theme/themeRoot.js.map +7 -0
  493. package/dist/internal/typeahead.d.ts +9 -5
  494. package/dist/internal/typeahead.js +4 -1
  495. package/dist/internal/typeahead.js.map +2 -2
  496. package/dist/layout/Card.d.ts +21 -4
  497. package/dist/layout/Card.js +12 -6
  498. package/dist/layout/Card.js.map +2 -2
  499. package/dist/layout/Layout.d.ts +2 -2
  500. package/dist/layout/Layout.js.map +1 -1
  501. package/dist/layout/Page.d.ts +2 -2
  502. package/dist/layout/Page.js.map +1 -1
  503. package/dist/layout/PageHeader.d.ts +6 -1
  504. package/dist/layout/PageHeader.js +3 -1
  505. package/dist/layout/PageHeader.js.map +2 -2
  506. package/dist/layout/Panes.d.ts +10 -20
  507. package/dist/layout/Panes.js +5 -25
  508. package/dist/layout/Panes.js.map +2 -2
  509. package/dist/layout/ResizeHandle.d.ts +1 -0
  510. package/dist/layout/ResizeHandle.js +11 -21
  511. package/dist/layout/ResizeHandle.js.map +2 -2
  512. package/dist/layout/Scaffold.d.ts +14 -4
  513. package/dist/layout/Scaffold.js +16 -51
  514. package/dist/layout/Scaffold.js.map +2 -2
  515. package/dist/layout/Surface.d.ts +1 -1
  516. package/dist/layout/Surface.js +4 -1
  517. package/dist/layout/Surface.js.map +2 -2
  518. package/dist/layout/TopBar.d.ts +2 -2
  519. package/dist/layout/TopBar.js +4 -5
  520. package/dist/layout/TopBar.js.map +2 -2
  521. package/dist/layout/internal/LoadingBar.d.ts +3 -7
  522. package/dist/layout/internal/LoadingBar.js +5 -10
  523. package/dist/layout/internal/LoadingBar.js.map +2 -2
  524. package/dist/layout/internal/PageTitleFocus.d.ts +0 -9
  525. package/dist/layout/internal/PageTitleFocus.js +3 -24
  526. package/dist/layout/internal/PageTitleFocus.js.map +2 -2
  527. package/dist/layout/internal/StickyHeaderSize.js +3 -3
  528. package/dist/layout/internal/StickyHeaderSize.js.map +2 -2
  529. package/dist/layout/internal/{navigationForms.d.ts → scaffold/navigationForms.d.ts} +2 -2
  530. package/dist/layout/internal/scaffold/navigationForms.js.map +7 -0
  531. package/dist/layout/internal/{scaffoldFocus.js.map → scaffold/scaffoldFocus.js.map} +1 -1
  532. package/dist/layout/internal/{scrollKeys.js → scaffold/scrollKeys.js} +1 -1
  533. package/dist/layout/internal/scaffold/scrollKeys.js.map +7 -0
  534. package/dist/layout/internal/scaffold/useBarSizes.d.ts +6 -0
  535. package/dist/layout/internal/scaffold/useBarSizes.js +54 -0
  536. package/dist/layout/internal/scaffold/useBarSizes.js.map +7 -0
  537. package/dist/layout/internal/{useNavigationFocusHandoff.js → scaffold/useNavigationFocusHandoff.js} +5 -4
  538. package/dist/layout/internal/scaffold/useNavigationFocusHandoff.js.map +7 -0
  539. package/dist/layout/internal/{useScrollKeys.js → scaffold/useScrollKeys.js} +1 -1
  540. package/dist/layout/internal/scaffold/useScrollKeys.js.map +7 -0
  541. package/dist/layout/internal/scaffoldPages.d.ts +9 -0
  542. package/dist/layout/internal/scaffoldPages.js +27 -0
  543. package/dist/layout/internal/scaffoldPages.js.map +7 -0
  544. package/dist/markdown.d.ts +0 -1
  545. package/dist/markdown.js +0 -1
  546. package/dist/markdown.js.map +2 -2
  547. package/dist/messages.d.ts +1 -1
  548. package/dist/messages.js +1 -6
  549. package/dist/messages.js.map +2 -2
  550. package/dist/navigation/Breadcrumbs.d.ts +15 -4
  551. package/dist/navigation/Breadcrumbs.js +36 -27
  552. package/dist/navigation/Breadcrumbs.js.map +2 -2
  553. package/dist/navigation/DocumentTabs.d.ts +54 -12
  554. package/dist/navigation/DocumentTabs.js +50 -150
  555. package/dist/navigation/DocumentTabs.js.map +3 -3
  556. package/dist/navigation/NavigationBar.d.ts +10 -3
  557. package/dist/navigation/NavigationBar.js +75 -35
  558. package/dist/navigation/NavigationBar.js.map +2 -2
  559. package/dist/navigation/NavigationDrawer.d.ts +9 -3
  560. package/dist/navigation/NavigationDrawer.js +24 -217
  561. package/dist/navigation/NavigationDrawer.js.map +2 -2
  562. package/dist/navigation/NavigationRail.d.ts +10 -3
  563. package/dist/navigation/NavigationRail.js +20 -10
  564. package/dist/navigation/NavigationRail.js.map +2 -2
  565. package/dist/navigation/Pager.d.ts +25 -11
  566. package/dist/navigation/Pager.js +49 -12
  567. package/dist/navigation/Pager.js.map +3 -3
  568. package/dist/navigation/Pagination.d.ts +24 -9
  569. package/dist/navigation/Pagination.js +37 -11
  570. package/dist/navigation/Pagination.js.map +2 -2
  571. package/dist/navigation/TableOfContents.d.ts +18 -4
  572. package/dist/navigation/TableOfContents.js +41 -121
  573. package/dist/navigation/TableOfContents.js.map +2 -2
  574. package/dist/navigation/Tree.d.ts +28 -11
  575. package/dist/navigation/Tree.js +41 -37
  576. package/dist/navigation/Tree.js.map +2 -2
  577. package/dist/navigation/destinations.d.ts +43 -11
  578. package/dist/navigation/internal/DestinationItem.d.ts +5 -41
  579. package/dist/navigation/internal/DestinationItem.js +41 -44
  580. package/dist/navigation/internal/DestinationItem.js.map +2 -2
  581. package/dist/navigation/internal/destinationModel.d.ts +16 -0
  582. package/dist/navigation/internal/destinationModel.js +28 -0
  583. package/dist/navigation/internal/destinationModel.js.map +7 -0
  584. package/dist/navigation/internal/documentTabs/DocumentTab.d.ts +12 -0
  585. package/dist/navigation/internal/documentTabs/DocumentTab.js +122 -0
  586. package/dist/navigation/internal/documentTabs/DocumentTab.js.map +7 -0
  587. package/dist/navigation/internal/documentTabs/tabMenuContent.d.ts +21 -0
  588. package/dist/navigation/internal/documentTabs/tabMenuContent.js +73 -0
  589. package/dist/navigation/internal/documentTabs/tabMenuContent.js.map +7 -0
  590. package/dist/navigation/internal/documentTabs/tabStrip.d.ts +7 -0
  591. package/dist/navigation/internal/documentTabs/tabStrip.js +26 -0
  592. package/dist/navigation/internal/documentTabs/tabStrip.js.map +7 -0
  593. package/dist/navigation/internal/{useTabCloseFocus.js → documentTabs/useTabCloseFocus.js} +2 -2
  594. package/dist/navigation/internal/documentTabs/useTabCloseFocus.js.map +7 -0
  595. package/dist/navigation/internal/{useTabDrag.d.ts → documentTabs/useTabDrag.d.ts} +3 -3
  596. package/dist/navigation/internal/{useTabDrag.js → documentTabs/useTabDrag.js} +8 -8
  597. package/dist/navigation/internal/documentTabs/useTabDrag.js.map +7 -0
  598. package/dist/navigation/internal/{useTabStripScrolling.js → documentTabs/useTabStripScrolling.js} +22 -3
  599. package/dist/navigation/internal/documentTabs/useTabStripScrolling.js.map +7 -0
  600. package/dist/navigation/internal/landmarkLabel.d.ts +1 -0
  601. package/dist/navigation/internal/landmarkLabel.js +5 -0
  602. package/dist/navigation/internal/landmarkLabel.js.map +7 -0
  603. package/dist/navigation/internal/navigationDrawer/DrawerRows.d.ts +18 -0
  604. package/dist/navigation/internal/navigationDrawer/DrawerRows.js +151 -0
  605. package/dist/navigation/internal/navigationDrawer/DrawerRows.js.map +7 -0
  606. package/dist/navigation/internal/navigationDrawer/destinationSections.d.ts +13 -0
  607. package/dist/navigation/internal/navigationDrawer/destinationSections.js +13 -0
  608. package/dist/navigation/internal/navigationDrawer/destinationSections.js.map +7 -0
  609. package/dist/navigation/internal/navigationDrawer/useExpandedSections.d.ts +6 -0
  610. package/dist/navigation/internal/navigationDrawer/useExpandedSections.js +57 -0
  611. package/dist/navigation/internal/navigationDrawer/useExpandedSections.js.map +7 -0
  612. package/dist/navigation/internal/tableOfContents/contentsOutline.d.ts +26 -0
  613. package/dist/navigation/internal/tableOfContents/contentsOutline.js +38 -0
  614. package/dist/navigation/internal/tableOfContents/contentsOutline.js.map +7 -0
  615. package/dist/navigation/internal/{contentsWave.js → tableOfContents/contentsWave.js} +1 -1
  616. package/dist/navigation/internal/tableOfContents/contentsWave.js.map +7 -0
  617. package/dist/navigation/internal/tableOfContents/readingPosition.d.ts +25 -0
  618. package/dist/navigation/internal/{contentsOutline.js → tableOfContents/readingPosition.js} +2 -37
  619. package/dist/navigation/internal/tableOfContents/readingPosition.js.map +7 -0
  620. package/dist/navigation/internal/{sectionScroll.d.ts → tableOfContents/sectionScroll.d.ts} +6 -1
  621. package/dist/navigation/internal/{sectionScroll.js → tableOfContents/sectionScroll.js} +18 -10
  622. package/dist/navigation/internal/tableOfContents/sectionScroll.js.map +7 -0
  623. package/dist/navigation/internal/{useContentsHeadings.d.ts → tableOfContents/useContentsHeadings.d.ts} +2 -2
  624. package/dist/navigation/internal/{useContentsHeadings.js → tableOfContents/useContentsHeadings.js} +4 -7
  625. package/dist/navigation/internal/tableOfContents/useContentsHeadings.js.map +7 -0
  626. package/dist/navigation/internal/tableOfContents/useReadingPlace.d.ts +15 -0
  627. package/dist/navigation/internal/tableOfContents/useReadingPlace.js +119 -0
  628. package/dist/navigation/internal/tableOfContents/useReadingPlace.js.map +7 -0
  629. package/dist/navigation/internal/{waveDrawer.js → tableOfContents/waveDrawer.js} +5 -4
  630. package/dist/navigation/internal/tableOfContents/waveDrawer.js.map +7 -0
  631. package/dist/navigation/internal/{TreeRow.d.ts → tree/TreeRow.d.ts} +1 -1
  632. package/dist/navigation/internal/{TreeRow.js → tree/TreeRow.js} +9 -5
  633. package/dist/navigation/internal/tree/TreeRow.js.map +7 -0
  634. package/dist/navigation/internal/{treeModel.d.ts → tree/treeModel.d.ts} +7 -9
  635. package/dist/navigation/internal/{treeModel.js → tree/treeModel.js} +10 -13
  636. package/dist/navigation/internal/tree/treeModel.js.map +7 -0
  637. package/dist/navigation/internal/{useTreeTransitions.d.ts → tree/useTreeTransitions.d.ts} +1 -1
  638. package/dist/navigation/internal/tree/useTreeTransitions.js.map +7 -0
  639. package/dist/navigation/internal/{useTreeViewport.d.ts → tree/useTreeViewport.d.ts} +3 -3
  640. package/dist/navigation/internal/{useTreeViewport.js → tree/useTreeViewport.js} +11 -12
  641. package/dist/navigation/internal/tree/useTreeViewport.js.map +7 -0
  642. package/dist/navigation/internal/useLabelText.d.ts +6 -0
  643. package/dist/navigation/internal/useLabelText.js +11 -0
  644. package/dist/navigation/internal/useLabelText.js.map +7 -0
  645. package/dist/navigation/navigationBackground.d.ts +0 -2
  646. package/dist/navigation/navigationBackground.js +0 -6
  647. package/dist/navigation/navigationBackground.js.map +3 -3
  648. package/dist/overlays/ConfirmDialog.d.ts +6 -3
  649. package/dist/overlays/ConfirmDialog.js +64 -68
  650. package/dist/overlays/ConfirmDialog.js.map +2 -2
  651. package/dist/overlays/Dialog.d.ts +40 -6
  652. package/dist/overlays/Dialog.js +69 -41
  653. package/dist/overlays/Dialog.js.map +2 -2
  654. package/dist/overlays/HoverCard.d.ts +9 -2
  655. package/dist/overlays/HoverCard.js +5 -5
  656. package/dist/overlays/HoverCard.js.map +2 -2
  657. package/dist/overlays/Popover.d.ts +20 -5
  658. package/dist/overlays/Popover.js +8 -6
  659. package/dist/overlays/Popover.js.map +2 -2
  660. package/dist/overlays/Sheet.d.ts +16 -3
  661. package/dist/overlays/Sheet.js +88 -87
  662. package/dist/overlays/Sheet.js.map +2 -2
  663. package/dist/overlays/Tooltip.d.ts +7 -0
  664. package/dist/overlays/Tooltip.js +10 -15
  665. package/dist/overlays/Tooltip.js.map +2 -2
  666. package/dist/overlays/internal/accessibleName.js +2 -1
  667. package/dist/overlays/internal/accessibleName.js.map +2 -2
  668. package/dist/overlays/internal/dialog/DialogHeadingClose.d.ts +8 -0
  669. package/dist/overlays/internal/dialog/DialogHeadingClose.js +19 -0
  670. package/dist/overlays/internal/dialog/DialogHeadingClose.js.map +7 -0
  671. package/dist/overlays/internal/dialog/DialogParts.d.ts +33 -0
  672. package/dist/overlays/internal/dialog/DialogParts.js +64 -0
  673. package/dist/overlays/internal/dialog/DialogParts.js.map +7 -0
  674. package/dist/overlays/internal/{DialogPendingAction.d.ts → dialog/dialogPending.d.ts} +8 -0
  675. package/dist/overlays/internal/{DialogPendingAction.js → dialog/dialogPending.js} +13 -2
  676. package/dist/overlays/internal/dialog/dialogPending.js.map +7 -0
  677. package/dist/styles/Accordion.css +1 -1
  678. package/dist/styles/Alert.css +1 -1
  679. package/dist/styles/Avatar.css +1 -1
  680. package/dist/styles/Badge.css +1 -1
  681. package/dist/styles/Base.css +1 -1
  682. package/dist/styles/Breadcrumbs.css +1 -1
  683. package/dist/styles/Card.css +1 -1
  684. package/dist/styles/Checkbox.css +1 -1
  685. package/dist/styles/Code.css +1 -1
  686. package/dist/styles/Combobox.css +1 -1
  687. package/dist/styles/CommandPalette.css +1 -1
  688. package/dist/styles/Composer.css +1 -1
  689. package/dist/styles/CopyButton.css +1 -1
  690. package/dist/styles/Dialog.css +1 -1
  691. package/dist/styles/Disclosure.css +1 -1
  692. package/dist/styles/DocumentTabs.css +1 -1
  693. package/dist/styles/DropZone.css +1 -1
  694. package/dist/styles/EmptyState.css +1 -1
  695. package/dist/styles/Halo.css +1 -0
  696. package/dist/styles/List.css +1 -1
  697. package/dist/styles/ListRow.css +1 -1
  698. package/dist/styles/LoadingBar.css +1 -1
  699. package/dist/styles/Menu.css +1 -1
  700. package/dist/styles/Message.css +1 -1
  701. package/dist/styles/Meter.css +1 -1
  702. package/dist/styles/NavigationBar.css +1 -1
  703. package/dist/styles/NavigationDestinations.css +1 -0
  704. package/dist/styles/NavigationDrawer.css +1 -1
  705. package/dist/styles/NavigationRail.css +1 -1
  706. package/dist/styles/Pager.css +1 -1
  707. package/dist/styles/Panes.css +1 -1
  708. package/dist/styles/Progress.css +1 -0
  709. package/dist/styles/Radio.css +1 -1
  710. package/dist/styles/Scaffold.css +1 -1
  711. package/dist/styles/SegmentedControl.css +1 -1
  712. package/dist/styles/Select.css +1 -1
  713. package/dist/styles/Switch.css +1 -1
  714. package/dist/styles/Table.css +1 -1
  715. package/dist/styles/TableOfContents.css +1 -1
  716. package/dist/styles/Text.css +1 -1
  717. package/dist/styles/TextField.css +1 -1
  718. package/dist/styles/Toast.css +1 -1
  719. package/dist/styles/Toolbar.css +1 -1
  720. package/dist/styles/Tree.css +1 -1
  721. package/dist/styles.css +1 -1
  722. package/dist/theme-bootstrap.d.ts +1 -1
  723. package/dist/theme-bootstrap.js +1 -8
  724. package/dist/theme-bootstrap.js.map +2 -2
  725. package/dist/theme-storage.d.ts +2 -0
  726. package/dist/theme-storage.js +3 -0
  727. package/dist/theme-storage.js.map +7 -0
  728. package/dist/tokens.json +0 -13
  729. package/docs/components/accordion.md +13 -0
  730. package/docs/components/alert.md +8 -1
  731. package/docs/components/avatar.md +16 -4
  732. package/docs/components/badge.md +10 -39
  733. package/docs/components/box.md +3 -3
  734. package/docs/components/breadcrumbs.md +6 -1
  735. package/docs/components/button.md +14 -9
  736. package/docs/components/card.md +14 -5
  737. package/docs/components/checkbox.md +3 -1
  738. package/docs/components/code.md +15 -6
  739. package/docs/components/color-picker.md +10 -2
  740. package/docs/components/column.md +2 -2
  741. package/docs/components/combobox.md +1 -1
  742. package/docs/components/command-palette.md +6 -2
  743. package/docs/components/composer.md +19 -8
  744. package/docs/components/confirm-dialog.md +3 -3
  745. package/docs/components/date-picker.md +15 -3
  746. package/docs/components/description-list.md +1 -1
  747. package/docs/components/dialog.md +34 -8
  748. package/docs/components/disclosure.md +4 -0
  749. package/docs/components/document-tabs.md +23 -13
  750. package/docs/components/drop-zone.md +10 -1
  751. package/docs/components/empty-state.md +12 -3
  752. package/docs/components/field.md +2 -1
  753. package/docs/components/graphic.md +1 -1
  754. package/docs/components/grid.md +2 -2
  755. package/docs/components/halo.md +80 -0
  756. package/docs/components/hover-card.md +2 -1
  757. package/docs/components/kbd.md +8 -2
  758. package/docs/components/link.md +1 -1
  759. package/docs/components/list.md +13 -5
  760. package/docs/components/markdown.md +9 -116
  761. package/docs/components/menu.md +28 -12
  762. package/docs/components/menubar.md +4 -3
  763. package/docs/components/message.md +17 -13
  764. package/docs/components/meter.md +8 -3
  765. package/docs/components/month-picker.md +4 -2
  766. package/docs/components/navigation-drawer.md +32 -7
  767. package/docs/components/page.md +4 -3
  768. package/docs/components/pager.md +16 -6
  769. package/docs/components/pagination.md +3 -2
  770. package/docs/components/panes.md +13 -26
  771. package/docs/components/popover.md +3 -2
  772. package/docs/components/progress.md +2 -2
  773. package/docs/components/radio.md +13 -5
  774. package/docs/components/relative-time.md +2 -1
  775. package/docs/components/resize-handle.md +6 -4
  776. package/docs/components/row.md +2 -2
  777. package/docs/components/scaffold.md +13 -4
  778. package/docs/components/segmented-control.md +10 -4
  779. package/docs/components/select.md +10 -2
  780. package/docs/components/sheet.md +4 -1
  781. package/docs/components/slider.md +8 -2
  782. package/docs/components/spinner.md +1 -1
  783. package/docs/components/surface.md +1 -1
  784. package/docs/components/switch.md +2 -0
  785. package/docs/components/table-of-contents.md +3 -2
  786. package/docs/components/table.md +18 -3
  787. package/docs/components/text-field.md +14 -8
  788. package/docs/components/time-picker.md +4 -2
  789. package/docs/components/toast.md +2 -1
  790. package/docs/components/toolbar.md +31 -6
  791. package/docs/components/tooltip.md +1 -0
  792. package/docs/components/top-bar.md +1 -1
  793. package/docs/components/tree.md +9 -4
  794. package/docs/customizing.md +59 -91
  795. package/docs/examples/accordion/IntegrationSwitches.tsx +33 -0
  796. package/docs/examples/alert/BannerAction.tsx +19 -0
  797. package/docs/examples/avatar/BotsAndPresence.tsx +24 -0
  798. package/docs/examples/badge/BadgeAnatomy.tsx +1 -1
  799. package/docs/examples/badge/CountsInButtons.tsx +2 -2
  800. package/docs/examples/badge/WithContent.tsx +13 -0
  801. package/docs/examples/breadcrumbs/WithAvatar.tsx +20 -0
  802. package/docs/examples/button/ButtonAnatomy.tsx +1 -1
  803. package/docs/examples/button/CreateProject.tsx +1 -1
  804. package/docs/examples/button/FillSidebar.tsx +1 -1
  805. package/docs/examples/button/Icons.tsx +2 -2
  806. package/docs/examples/button/PictureBeforeLabel.tsx +14 -0
  807. package/docs/examples/card/CardAnatomy.tsx +3 -1
  808. package/docs/examples/card/OpenFromCard.tsx +65 -0
  809. package/docs/examples/code/PackageManagers.tsx +35 -0
  810. package/docs/examples/code/SettingsDiff.tsx +5 -9
  811. package/docs/examples/color-picker/TextColorInToolbar.tsx +44 -0
  812. package/docs/examples/colors/Status.tsx +6 -6
  813. package/docs/examples/command-palette/CommandPaletteAnatomy.tsx +11 -5
  814. package/docs/examples/command-palette/GoToDocument.tsx +17 -14
  815. package/docs/examples/command-palette/NarrowSidebar.tsx +1 -1
  816. package/docs/examples/command-palette/RunCommand.tsx +16 -12
  817. package/docs/examples/command-palette/SearchButton.tsx +2 -2
  818. package/docs/examples/command-palette/TypeToSearch.tsx +2 -2
  819. package/docs/examples/composer/AttachmentsAndVoice.tsx +30 -0
  820. package/docs/examples/confirm-dialog/FromMenu.tsx +1 -1
  821. package/docs/examples/date-picker/PresetsAndBusyDays.tsx +61 -0
  822. package/docs/examples/dialog/EditMember.tsx +28 -0
  823. package/docs/examples/dialog/FindPlan.tsx +1 -1
  824. package/docs/examples/document-tabs/DocumentTabsAnatomy.tsx +2 -2
  825. package/docs/examples/document-tabs/EditorTabs.tsx +57 -0
  826. package/docs/examples/document-tabs/OpenDocuments.tsx +2 -2
  827. package/docs/examples/drop-zone/FilesInsideTheZone.tsx +40 -0
  828. package/docs/examples/empty-state/WithIllustration.tsx +22 -0
  829. package/docs/examples/graphic/Colors.tsx +1 -1
  830. package/docs/examples/graphic/SignInWithLogo.tsx +1 -1
  831. package/docs/examples/halo/AroundACard.tsx +14 -0
  832. package/docs/examples/halo/InviteTeam.tsx +15 -0
  833. package/docs/examples/halo/Tones.tsx +14 -0
  834. package/docs/examples/icons/FollowText.tsx +3 -3
  835. package/docs/examples/kbd/Sequences.tsx +10 -0
  836. package/docs/examples/list/TitleActions.tsx +32 -0
  837. package/docs/examples/menu/AccountSwitcher.tsx +32 -0
  838. package/docs/examples/menu/Choices.tsx +1 -1
  839. package/docs/examples/menu/ContextMenuForRows.tsx +3 -3
  840. package/docs/examples/menu/Destinations.tsx +5 -5
  841. package/docs/examples/menu/GroupsAndSeparators.tsx +6 -6
  842. package/docs/examples/menu/IconsAndShortcuts.tsx +5 -5
  843. package/docs/examples/menu/MenuAnatomy.tsx +3 -3
  844. package/docs/examples/menu/Submenus.tsx +4 -4
  845. package/docs/examples/menubar/NotesMenubar.tsx +4 -4
  846. package/docs/examples/message/CommentThread.tsx +30 -0
  847. package/docs/examples/message/Conversation.tsx +7 -2
  848. package/docs/examples/meter/InlineUsage.tsx +10 -0
  849. package/docs/examples/navigation-drawer/ActivityBar.tsx +26 -0
  850. package/docs/examples/navigation-drawer/GroupActions.tsx +43 -0
  851. package/docs/examples/page/WithBreadcrumbs.tsx +1 -1
  852. package/docs/examples/page/WithHeader.tsx +1 -1
  853. package/docs/examples/page/WithToolbar.tsx +1 -1
  854. package/docs/examples/pager/LongTitles.tsx +2 -2
  855. package/docs/examples/pager/PagerAnatomy.tsx +2 -2
  856. package/docs/examples/pager/PreviousAndNext.tsx +2 -2
  857. package/docs/examples/pager/StepThroughAGuide.tsx +2 -2
  858. package/docs/examples/panes/DocumentAndDetails.tsx +53 -0
  859. package/docs/examples/panes/PanesAnatomy.tsx +20 -12
  860. package/docs/examples/panes/ResizableDetails.tsx +35 -2
  861. package/docs/examples/panes/StackedWhenNarrow.tsx +11 -10
  862. package/docs/examples/popover/DocumentDetails.tsx +1 -1
  863. package/docs/examples/popover/RenameInPlace.tsx +1 -1
  864. package/docs/examples/progress/ExportMembers.tsx +1 -1
  865. package/docs/examples/radio/PlanRows.tsx +35 -0
  866. package/docs/examples/relative-time/PastAndComing.tsx +6 -6
  867. package/docs/examples/relative-time/VersionLabels.tsx +5 -5
  868. package/docs/examples/resize-handle/DockedLogs.tsx +44 -0
  869. package/docs/examples/resize-handle/ResizeHandleAnatomy.tsx +22 -22
  870. package/docs/examples/row/SectionHeading.tsx +1 -1
  871. package/docs/examples/scaffold/InspectorAndStatus.tsx +63 -0
  872. package/docs/examples/segmented-control/IconOnlyAndBadge.tsx +31 -0
  873. package/docs/examples/segmented-control/SegmentedControlAnatomy.tsx +2 -2
  874. package/docs/examples/segmented-control/SmallToolbar.tsx +4 -4
  875. package/docs/examples/select/Assignee.tsx +29 -0
  876. package/docs/examples/select/SmallToolbar.tsx +23 -21
  877. package/docs/examples/sheet/FilterPanel.tsx +1 -1
  878. package/docs/examples/sheet/ShareChoices.tsx +1 -1
  879. package/docs/examples/slider/IconsAndUnits.tsx +42 -0
  880. package/docs/examples/spacing/Align.tsx +1 -1
  881. package/docs/examples/table/HeaderEndAndTotals.tsx +61 -0
  882. package/docs/examples/table/WorkItemsWithParts.tsx +1 -1
  883. package/docs/examples/table-of-contents/DocsArticle.tsx +16 -11
  884. package/docs/examples/text-field/ContentAffixes.tsx +32 -0
  885. package/docs/examples/text-field/FieldsBesideButtons.tsx +1 -1
  886. package/docs/examples/text-field/IconAndEndAction.tsx +1 -1
  887. package/docs/examples/text-field/TextFieldAnatomy.tsx +1 -1
  888. package/docs/examples/text-field/Variants.tsx +1 -1
  889. package/docs/examples/toast/ExportReady.tsx +7 -5
  890. package/docs/examples/toast/RetryAfterError.tsx +8 -6
  891. package/docs/examples/toast/ToastAnatomy.tsx +1 -1
  892. package/docs/examples/toast/TopCenter.tsx +1 -1
  893. package/docs/examples/toast/UndoArchive.tsx +10 -8
  894. package/docs/examples/toolbar/LabelledControls.tsx +40 -0
  895. package/docs/examples/tooltip/MenuTrigger.tsx +2 -2
  896. package/docs/examples/tree/ContextMenuActions.tsx +5 -5
  897. package/docs/examples/tree/FileTree.tsx +1 -1
  898. package/docs/examples/tree/MatchedLetters.tsx +37 -0
  899. package/docs/examples/tree/NarrowTree.tsx +3 -3
  900. package/docs/examples/tree/RowDensity.tsx +6 -6
  901. package/docs/examples/tree/TreeAnatomy.tsx +2 -2
  902. package/docs/foundations/accessibility.md +3 -3
  903. package/docs/foundations/colors.md +2 -3
  904. package/docs/foundations/icons.md +3 -3
  905. package/docs/foundations/responsive.md +2 -2
  906. package/docs/foundations/spacing.md +2 -2
  907. package/docs/foundations/typography.md +2 -2
  908. package/docs/generated/exports.json +34 -52
  909. package/docs/generated/parts.json +469 -484
  910. package/docs/generated/props.json +1053 -903
  911. package/docs/index.md +52 -56
  912. package/docs/setup.md +62 -20
  913. package/docs/writing.md +1 -1
  914. package/package.json +6 -25
  915. package/dist/actions/internal/MenuPopup.js.map +0 -7
  916. package/dist/assets/readme/gallery-dark.png +0 -0
  917. package/dist/assets/readme/gallery-light.png +0 -0
  918. package/dist/content/MarkdownEditor.d.ts +0 -35
  919. package/dist/content/MarkdownEditor.js +0 -236
  920. package/dist/content/MarkdownEditor.js.map +0 -7
  921. package/dist/content/internal/markdown/MarkdownPreview.d.ts +0 -9
  922. package/dist/content/internal/markdown/MarkdownPreview.js +0 -30
  923. package/dist/content/internal/markdown/MarkdownPreview.js.map +0 -7
  924. package/dist/content/internal/markdown/markdownFormatting.d.ts +0 -15
  925. package/dist/content/internal/markdown/markdownFormatting.js +0 -96
  926. package/dist/content/internal/markdown/markdownFormatting.js.map +0 -7
  927. package/dist/content/internal/markdown/markdownHistory.d.ts +0 -10
  928. package/dist/content/internal/markdown/markdownHistory.js +0 -54
  929. package/dist/content/internal/markdown/markdownHistory.js.map +0 -7
  930. package/dist/content/internal/markdown/useMarkdownEditing.d.ts +0 -19
  931. package/dist/content/internal/markdown/useMarkdownEditing.js +0 -127
  932. package/dist/content/internal/markdown/useMarkdownEditing.js.map +0 -7
  933. package/dist/content/internal/markdown/useMarkdownLink.d.ts +0 -22
  934. package/dist/content/internal/markdown/useMarkdownLink.js +0 -73
  935. package/dist/content/internal/markdown/useMarkdownLink.js.map +0 -7
  936. package/dist/data-display/AnimatedNumber.d.ts +0 -15
  937. package/dist/data-display/AnimatedNumber.js +0 -111
  938. package/dist/data-display/AnimatedNumber.js.map +0 -7
  939. package/dist/data-display/CalendarHeatmap.d.ts +0 -92
  940. package/dist/data-display/CalendarHeatmap.js +0 -224
  941. package/dist/data-display/CalendarHeatmap.js.map +0 -7
  942. package/dist/data-display/DiffStat.d.ts +0 -23
  943. package/dist/data-display/DiffStat.js +0 -42
  944. package/dist/data-display/DiffStat.js.map +0 -7
  945. package/dist/data-display/Rating.d.ts +0 -32
  946. package/dist/data-display/Rating.js +0 -45
  947. package/dist/data-display/Rating.js.map +0 -7
  948. package/dist/data-display/internal/ListRows.js.map +0 -7
  949. package/dist/data-display/internal/calendarHeatmapModel.d.ts +0 -44
  950. package/dist/data-display/internal/calendarHeatmapModel.js +0 -133
  951. package/dist/data-display/internal/calendarHeatmapModel.js.map +0 -7
  952. package/dist/data-display/internal/useHeatmapLabels.d.ts +0 -16
  953. package/dist/data-display/internal/useHeatmapLabels.js +0 -56
  954. package/dist/data-display/internal/useHeatmapLabels.js.map +0 -7
  955. package/dist/data-display/internal/useHeatmapTooltip.d.ts +0 -24
  956. package/dist/data-display/internal/useHeatmapTooltip.js +0 -142
  957. package/dist/data-display/internal/useHeatmapTooltip.js.map +0 -7
  958. package/dist/dev/api.d.ts +0 -64
  959. package/dist/dev/api.js +0 -88
  960. package/dist/dev/api.js.map +0 -7
  961. package/dist/dev/elements.d.ts +0 -7
  962. package/dist/dev/elements.js +0 -32
  963. package/dist/dev/elements.js.map +0 -7
  964. package/dist/dev/inner.d.ts +0 -17
  965. package/dist/dev/inner.js +0 -139
  966. package/dist/dev/inner.js.map +0 -7
  967. package/dist/dev/install.d.ts +0 -64
  968. package/dist/dev/install.js +0 -128
  969. package/dist/dev/install.js.map +0 -7
  970. package/dist/dev/measure.d.ts +0 -10
  971. package/dist/dev/measure.js +0 -304
  972. package/dist/dev/measure.js.map +0 -7
  973. package/dist/dev/model.d.ts +0 -136
  974. package/dist/dev/model.js +0 -5
  975. package/dist/dev/model.js.map +0 -7
  976. package/dist/dev/overlays.d.ts +0 -5
  977. package/dist/dev/overlays.js +0 -52
  978. package/dist/dev/overlays.js.map +0 -7
  979. package/dist/dev/parts.d.ts +0 -49
  980. package/dist/dev/parts.js +0 -89
  981. package/dist/dev/parts.js.map +0 -7
  982. package/dist/dev/queries.d.ts +0 -28
  983. package/dist/dev/queries.js +0 -135
  984. package/dist/dev/queries.js.map +0 -7
  985. package/dist/dev/readout.d.ts +0 -9
  986. package/dist/dev/readout.js +0 -275
  987. package/dist/dev/readout.js.map +0 -7
  988. package/dist/dev/skeletonShift.d.ts +0 -6
  989. package/dist/dev/skeletonShift.js +0 -174
  990. package/dist/dev/skeletonShift.js.map +0 -7
  991. package/dist/dev/ui/Controls.d.ts +0 -20
  992. package/dist/dev/ui/Controls.js +0 -53
  993. package/dist/dev/ui/Controls.js.map +0 -7
  994. package/dist/dev/ui/DevMode.d.ts +0 -14
  995. package/dist/dev/ui/DevMode.js +0 -222
  996. package/dist/dev/ui/DevMode.js.map +0 -7
  997. package/dist/dev/ui/Frame.d.ts +0 -14
  998. package/dist/dev/ui/Frame.js +0 -178
  999. package/dist/dev/ui/Frame.js.map +0 -7
  1000. package/dist/dev/ui/Icons.d.ts +0 -5
  1001. package/dist/dev/ui/Icons.js +0 -38
  1002. package/dist/dev/ui/Icons.js.map +0 -7
  1003. package/dist/dev/ui/Inspector.d.ts +0 -24
  1004. package/dist/dev/ui/Inspector.js +0 -366
  1005. package/dist/dev/ui/Inspector.js.map +0 -7
  1006. package/dist/dev/ui/Legend.d.ts +0 -4
  1007. package/dist/dev/ui/Legend.js +0 -50
  1008. package/dist/dev/ui/Legend.js.map +0 -7
  1009. package/dist/dev/ui/NodeHints.d.ts +0 -15
  1010. package/dist/dev/ui/NodeHints.js +0 -95
  1011. package/dist/dev/ui/NodeHints.js.map +0 -7
  1012. package/dist/dev/ui/PerformancePanel.d.ts +0 -3
  1013. package/dist/dev/ui/PerformancePanel.js +0 -72
  1014. package/dist/dev/ui/PerformancePanel.js.map +0 -7
  1015. package/dist/dev/ui/Plane.d.ts +0 -37
  1016. package/dist/dev/ui/Plane.js +0 -154
  1017. package/dist/dev/ui/Plane.js.map +0 -7
  1018. package/dist/dev/ui/View3D.d.ts +0 -19
  1019. package/dist/dev/ui/View3D.js +0 -248
  1020. package/dist/dev/ui/View3D.js.map +0 -7
  1021. package/dist/dev/ui/ViewToolbar.d.ts +0 -40
  1022. package/dist/dev/ui/ViewToolbar.js +0 -352
  1023. package/dist/dev/ui/ViewToolbar.js.map +0 -7
  1024. package/dist/dev/ui/camera.d.ts +0 -42
  1025. package/dist/dev/ui/camera.js +0 -157
  1026. package/dist/dev/ui/camera.js.map +0 -7
  1027. package/dist/dev/ui/devices.d.ts +0 -9
  1028. package/dist/dev/ui/devices.js +0 -34
  1029. package/dist/dev/ui/devices.js.map +0 -7
  1030. package/dist/dev/ui/editorTheme.d.ts +0 -6
  1031. package/dist/dev/ui/editorTheme.js +0 -30
  1032. package/dist/dev/ui/editorTheme.js.map +0 -7
  1033. package/dist/dev/ui/sides.d.ts +0 -20
  1034. package/dist/dev/ui/sides.js +0 -43
  1035. package/dist/dev/ui/sides.js.map +0 -7
  1036. package/dist/dev/ui/stats.d.ts +0 -25
  1037. package/dist/dev/ui/stats.js +0 -26
  1038. package/dist/dev/ui/stats.js.map +0 -7
  1039. package/dist/dev/ui/surfaces.d.ts +0 -4
  1040. package/dist/dev/ui/surfaces.js +0 -249
  1041. package/dist/dev/ui/surfaces.js.map +0 -7
  1042. package/dist/dev/ui/useLivePage.d.ts +0 -13
  1043. package/dist/dev/ui/useLivePage.js +0 -138
  1044. package/dist/dev/ui/useLivePage.js.map +0 -7
  1045. package/dist/dev/ui/usePlaneHover.d.ts +0 -9
  1046. package/dist/dev/ui/usePlaneHover.js +0 -46
  1047. package/dist/dev/ui/usePlaneHover.js.map +0 -7
  1048. package/dist/dev/ui/useViewFit.d.ts +0 -16
  1049. package/dist/dev/ui/useViewFit.js +0 -59
  1050. package/dist/dev/ui/useViewFit.js.map +0 -7
  1051. package/dist/dev/ui/useViewWheel.d.ts +0 -11
  1052. package/dist/dev/ui/useViewWheel.js +0 -48
  1053. package/dist/dev/ui/useViewWheel.js.map +0 -7
  1054. package/dist/dev/ui/wheel.d.ts +0 -7
  1055. package/dist/dev/ui/wheel.js +0 -98
  1056. package/dist/dev/ui/wheel.js.map +0 -7
  1057. package/dist/dev/units.d.ts +0 -7
  1058. package/dist/dev/units.js +0 -22
  1059. package/dist/dev/units.js.map +0 -7
  1060. package/dist/dev/usedTokens.d.ts +0 -5
  1061. package/dist/dev/usedTokens.js +0 -56
  1062. package/dist/dev/usedTokens.js.map +0 -7
  1063. package/dist/dev.d.ts +0 -5
  1064. package/dist/dev.js +0 -9
  1065. package/dist/dev.js.map +0 -7
  1066. package/dist/feedback/toast/internal/PictureNotice.js.map +0 -7
  1067. package/dist/forms/color/internal/useColorState.d.ts +0 -10
  1068. package/dist/forms/color/internal/useColorState.js +0 -49
  1069. package/dist/forms/color/internal/useColorState.js.map +0 -7
  1070. package/dist/forms/internal/usePickerValue.d.ts +0 -13
  1071. package/dist/forms/internal/usePickerValue.js +0 -45
  1072. package/dist/forms/internal/usePickerValue.js.map +0 -7
  1073. package/dist/forms/internal/useRovingFocus.d.ts +0 -47
  1074. package/dist/forms/internal/useRovingFocus.js +0 -179
  1075. package/dist/forms/internal/useRovingFocus.js.map +0 -7
  1076. package/dist/forms/rich-text/RichText.d.ts +0 -7
  1077. package/dist/forms/rich-text/RichText.js +0 -91
  1078. package/dist/forms/rich-text/RichText.js.map +0 -7
  1079. package/dist/forms/rich-text/RichTextEditor.d.ts +0 -9
  1080. package/dist/forms/rich-text/RichTextEditor.js +0 -225
  1081. package/dist/forms/rich-text/RichTextEditor.js.map +0 -7
  1082. package/dist/forms/rich-text/extensions.d.ts +0 -10
  1083. package/dist/forms/rich-text/extensions.js +0 -45
  1084. package/dist/forms/rich-text/extensions.js.map +0 -7
  1085. package/dist/forms/rich-text/internal/Listbox.d.ts +0 -10
  1086. package/dist/forms/rich-text/internal/Listbox.js +0 -48
  1087. package/dist/forms/rich-text/internal/Listbox.js.map +0 -7
  1088. package/dist/forms/rich-text/internal/Reference.d.ts +0 -13
  1089. package/dist/forms/rich-text/internal/Reference.js +0 -79
  1090. package/dist/forms/rich-text/internal/Reference.js.map +0 -7
  1091. package/dist/forms/rich-text/internal/commands.d.ts +0 -6
  1092. package/dist/forms/rich-text/internal/commands.js +0 -74
  1093. package/dist/forms/rich-text/internal/commands.js.map +0 -7
  1094. package/dist/forms/rich-text/internal/readOnlyCheckbox.d.ts +0 -6
  1095. package/dist/forms/rich-text/internal/readOnlyCheckbox.js +0 -9
  1096. package/dist/forms/rich-text/internal/readOnlyCheckbox.js.map +0 -7
  1097. package/dist/forms/rich-text/internal/referenceAttributes.d.ts +0 -3
  1098. package/dist/forms/rich-text/internal/referenceAttributes.js +0 -23
  1099. package/dist/forms/rich-text/internal/referenceAttributes.js.map +0 -7
  1100. package/dist/forms/rich-text/internal/referenceExtension.d.ts +0 -2
  1101. package/dist/forms/rich-text/internal/referenceExtension.js +0 -103
  1102. package/dist/forms/rich-text/internal/referenceExtension.js.map +0 -7
  1103. package/dist/forms/rich-text/internal/suggestions.d.ts +0 -16
  1104. package/dist/forms/rich-text/internal/suggestions.js +0 -185
  1105. package/dist/forms/rich-text/internal/suggestions.js.map +0 -7
  1106. package/dist/forms/rich-text/internal/taskItem.d.ts +0 -1
  1107. package/dist/forms/rich-text/internal/taskItem.js +0 -43
  1108. package/dist/forms/rich-text/internal/taskItem.js.map +0 -7
  1109. package/dist/forms/rich-text/internal/useDocumentAttributes.d.ts +0 -13
  1110. package/dist/forms/rich-text/internal/useDocumentAttributes.js +0 -42
  1111. package/dist/forms/rich-text/internal/useDocumentAttributes.js.map +0 -7
  1112. package/dist/forms/rich-text/internal/useLinksAndUploads.d.ts +0 -19
  1113. package/dist/forms/rich-text/internal/useLinksAndUploads.js +0 -141
  1114. package/dist/forms/rich-text/internal/useLinksAndUploads.js.map +0 -7
  1115. package/dist/forms/rich-text/internal/useRichTextDocument.d.ts +0 -26
  1116. package/dist/forms/rich-text/internal/useRichTextDocument.js +0 -101
  1117. package/dist/forms/rich-text/internal/useRichTextDocument.js.map +0 -7
  1118. package/dist/forms/rich-text/internal/useRichTextExtensions.d.ts +0 -13
  1119. package/dist/forms/rich-text/internal/useRichTextExtensions.js +0 -85
  1120. package/dist/forms/rich-text/internal/useRichTextExtensions.js.map +0 -7
  1121. package/dist/forms/rich-text/types.d.ts +0 -190
  1122. package/dist/forms/rich-text/types.js +0 -1
  1123. package/dist/foundations/SkeletonScope.js.map +0 -7
  1124. package/dist/foundations/ThemePreference.d.ts +0 -35
  1125. package/dist/foundations/ThemePreference.js.map +0 -7
  1126. package/dist/foundations/internal/skeletonText.js.map +0 -7
  1127. package/dist/foundations/messages/calendarHeatmap.d.ts +0 -10
  1128. package/dist/foundations/messages/calendarHeatmap.js +0 -10
  1129. package/dist/foundations/messages/calendarHeatmap.js.map +0 -7
  1130. package/dist/foundations/messages/diffStat.d.ts +0 -16
  1131. package/dist/foundations/messages/diffStat.js +0 -17
  1132. package/dist/foundations/messages/diffStat.js.map +0 -7
  1133. package/dist/foundations/messages/editor.d.ts +0 -35
  1134. package/dist/foundations/messages/editor.js +0 -34
  1135. package/dist/foundations/messages/editor.js.map +0 -7
  1136. package/dist/foundations/messages/linkDialog.d.ts +0 -20
  1137. package/dist/foundations/messages/linkDialog.js +0 -20
  1138. package/dist/foundations/messages/linkDialog.js.map +0 -7
  1139. package/dist/foundations/messages/markdownEditor.d.ts +0 -26
  1140. package/dist/foundations/messages/markdownEditor.js +0 -26
  1141. package/dist/foundations/messages/markdownEditor.js.map +0 -7
  1142. package/dist/foundations/messages/rating.d.ts +0 -11
  1143. package/dist/foundations/messages/rating.js +0 -8
  1144. package/dist/foundations/messages/rating.js.map +0 -7
  1145. package/dist/foundations/messages/richText.d.ts +0 -34
  1146. package/dist/foundations/messages/richText.js +0 -34
  1147. package/dist/foundations/messages/richText.js.map +0 -7
  1148. package/dist/internal/dialog/DialogParts.d.ts +0 -46
  1149. package/dist/internal/dialog/DialogParts.js +0 -66
  1150. package/dist/internal/dialog/DialogParts.js.map +0 -7
  1151. package/dist/internal/dom/paints.d.ts +0 -5
  1152. package/dist/internal/dom/paints.js +0 -17
  1153. package/dist/internal/dom/paints.js.map +0 -7
  1154. package/dist/internal/dom/useStripWheel.d.ts +0 -6
  1155. package/dist/internal/dom/useStripWheel.js +0 -26
  1156. package/dist/internal/dom/useStripWheel.js.map +0 -7
  1157. package/dist/internal/editor/EditorStatus.d.ts +0 -8
  1158. package/dist/internal/editor/EditorStatus.js +0 -11
  1159. package/dist/internal/editor/EditorStatus.js.map +0 -7
  1160. package/dist/internal/editor/EditorToolbar.d.ts +0 -28
  1161. package/dist/internal/editor/EditorToolbar.js +0 -89
  1162. package/dist/internal/editor/EditorToolbar.js.map +0 -7
  1163. package/dist/internal/editor/LinkDialog.d.ts +0 -20
  1164. package/dist/internal/editor/LinkDialog.js +0 -78
  1165. package/dist/internal/editor/LinkDialog.js.map +0 -7
  1166. package/dist/internal/editor/editorCommands.d.ts +0 -20
  1167. package/dist/internal/editor/editorCommands.js +0 -45
  1168. package/dist/internal/editor/editorCommands.js.map +0 -7
  1169. package/dist/internal/field/TextareaResizeEdge.js.map +0 -7
  1170. package/dist/internal/field/rowControl.js.map +0 -7
  1171. package/dist/internal/field/useFieldMetadata.d.ts +0 -16
  1172. package/dist/internal/field/useFieldMetadata.js +0 -24
  1173. package/dist/internal/field/useFieldMetadata.js.map +0 -7
  1174. package/dist/internal/list/ListRow.d.ts +0 -33
  1175. package/dist/internal/list/ListRow.js.map +0 -7
  1176. package/dist/internal/popup/PortalContainerContext.js.map +0 -7
  1177. package/dist/internal/react/useStackedReport.js +0 -28
  1178. package/dist/internal/react/useStackedReport.js.map +0 -7
  1179. package/dist/internal/skeleton.js.map +0 -7
  1180. package/dist/internal/time/calendarDays.js.map +0 -7
  1181. package/dist/layout/internal/navigationForms.js.map +0 -7
  1182. package/dist/layout/internal/scrollKeys.js.map +0 -7
  1183. package/dist/layout/internal/useNavigationFocusHandoff.js.map +0 -7
  1184. package/dist/layout/internal/useScrollKeys.js.map +0 -7
  1185. package/dist/layout/panesSize.d.ts +0 -13
  1186. package/dist/layout/panesSize.js +0 -39
  1187. package/dist/layout/panesSize.js.map +0 -7
  1188. package/dist/navigation/internal/TreeRow.js.map +0 -7
  1189. package/dist/navigation/internal/contentsOutline.d.ts +0 -60
  1190. package/dist/navigation/internal/contentsOutline.js.map +0 -7
  1191. package/dist/navigation/internal/contentsWave.js.map +0 -7
  1192. package/dist/navigation/internal/sectionScroll.js.map +0 -7
  1193. package/dist/navigation/internal/tabStrip.d.ts +0 -6
  1194. package/dist/navigation/internal/tabStrip.js +0 -24
  1195. package/dist/navigation/internal/tabStrip.js.map +0 -7
  1196. package/dist/navigation/internal/treeModel.js.map +0 -7
  1197. package/dist/navigation/internal/useContentsHeadings.js.map +0 -7
  1198. package/dist/navigation/internal/useTabCloseFocus.js.map +0 -7
  1199. package/dist/navigation/internal/useTabDrag.js.map +0 -7
  1200. package/dist/navigation/internal/useTabStripScrolling.js.map +0 -7
  1201. package/dist/navigation/internal/useTreeTransitions.js.map +0 -7
  1202. package/dist/navigation/internal/useTreeViewport.js.map +0 -7
  1203. package/dist/navigation/internal/waveDrawer.js.map +0 -7
  1204. package/dist/overlays/internal/DialogPendingAction.js.map +0 -7
  1205. package/dist/rich-text.d.ts +0 -5
  1206. package/dist/rich-text.js +0 -9
  1207. package/dist/rich-text.js.map +0 -7
  1208. package/dist/styles/CalendarHeatmap.css +0 -1
  1209. package/dist/styles/Editor.css +0 -1
  1210. package/dist/styles/Listbox.css +0 -1
  1211. package/dist/styles/MarkdownEditor.css +0 -1
  1212. package/dist/styles/Rating.css +0 -1
  1213. package/dist/styles/RichText.css +0 -1
  1214. package/docs/components/animated-number.md +0 -72
  1215. package/docs/components/calendar-heatmap.md +0 -140
  1216. package/docs/components/rating.md +0 -84
  1217. package/docs/components/rich-text.md +0 -224
  1218. package/docs/dev-mode.md +0 -59
  1219. package/docs/examples/animated-number/AnimatedNumberAnatomy.tsx +0 -9
  1220. package/docs/examples/animated-number/CustomFormat.tsx +0 -28
  1221. package/docs/examples/animated-number/ShowResults.tsx +0 -38
  1222. package/docs/examples/badge/ChangeSize.tsx +0 -21
  1223. package/docs/examples/calendar-heatmap/ApplicationStrings.tsx +0 -23
  1224. package/docs/examples/calendar-heatmap/ColorByRank.tsx +0 -26
  1225. package/docs/examples/calendar-heatmap/CustomTooltip.tsx +0 -26
  1226. package/docs/examples/calendar-heatmap/Deployments.tsx +0 -22
  1227. package/docs/examples/calendar-heatmap/HeatmapAnatomy.tsx +0 -10
  1228. package/docs/examples/calendar-heatmap/ScrollingWeeks.tsx +0 -10
  1229. package/docs/examples/markdown/LinkPicker.tsx +0 -65
  1230. package/docs/examples/markdown/MarkdownEditorAnatomy.tsx +0 -13
  1231. package/docs/examples/markdown/WriteNote.tsx +0 -21
  1232. package/docs/examples/panes/ListAndDetail.tsx +0 -55
  1233. package/docs/examples/rating/RatingAnatomy.tsx +0 -5
  1234. package/docs/examples/rating/ReviewScore.tsx +0 -13
  1235. package/docs/examples/rating/Scales.tsx +0 -11
  1236. package/docs/examples/resize-handle/ProjectSidebar.tsx +0 -40
  1237. package/docs/examples/rich-text/MeetingNotes.tsx +0 -14
  1238. package/docs/examples/rich-text/References.tsx +0 -47
  1239. package/docs/examples/rich-text/RichTextAnatomy.tsx +0 -18
  1240. package/docs/examples/rich-text/SavedContent.tsx +0 -33
  1241. package/docs/examples/rich-text/SlashCommands.tsx +0 -24
  1242. package/docs/examples/rich-text/UploadsAndLinks.tsx +0 -36
  1243. /package/dist/actions/{internal → menu/internal}/menuOpenChange.js +0 -0
  1244. /package/dist/actions/{internal → menu/internal}/menuOpenChange.js.map +0 -0
  1245. /package/dist/{forms/rich-text/types.js.map → actions/menu/internal/menuTriggerProps.js.map} +0 -0
  1246. /package/dist/forms/color/internal/{colorChange.d.ts → ColorChangeContext.d.ts} +0 -0
  1247. /package/dist/internal/{useCopy.d.ts → react/useCopy.d.ts} +0 -0
  1248. /package/dist/internal/{useCopy.js → react/useCopy.js} +0 -0
  1249. /package/dist/internal/{useLatest.d.ts → react/useLatest.d.ts} +0 -0
  1250. /package/dist/internal/{useLatest.js → react/useLatest.js} +0 -0
  1251. /package/dist/{foundations/internal → internal/skeleton}/skeletonText.d.ts +0 -0
  1252. /package/dist/layout/internal/{navigationForms.js → scaffold/navigationForms.js} +0 -0
  1253. /package/dist/layout/internal/{scaffoldFocus.d.ts → scaffold/scaffoldFocus.d.ts} +0 -0
  1254. /package/dist/layout/internal/{scaffoldFocus.js → scaffold/scaffoldFocus.js} +0 -0
  1255. /package/dist/layout/internal/{scrollKeys.d.ts → scaffold/scrollKeys.d.ts} +0 -0
  1256. /package/dist/layout/internal/{useNavigationFocusHandoff.d.ts → scaffold/useNavigationFocusHandoff.d.ts} +0 -0
  1257. /package/dist/layout/internal/{useScrollKeys.d.ts → scaffold/useScrollKeys.d.ts} +0 -0
  1258. /package/dist/navigation/internal/{useTabCloseFocus.d.ts → documentTabs/useTabCloseFocus.d.ts} +0 -0
  1259. /package/dist/navigation/internal/{useTabStripScrolling.d.ts → documentTabs/useTabStripScrolling.d.ts} +0 -0
  1260. /package/dist/navigation/internal/{contentsWave.d.ts → tableOfContents/contentsWave.d.ts} +0 -0
  1261. /package/dist/navigation/internal/{waveDrawer.d.ts → tableOfContents/waveDrawer.d.ts} +0 -0
  1262. /package/dist/navigation/internal/{useTreeTransitions.js → tree/useTreeTransitions.js} +0 -0
  1263. /package/dist/styles/{TextareaResizeEdge.css → TextareaResizeHandle.css} +0 -0
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/forms/DatePicker.tsx"],
4
- "sourcesContent": ["'use client';\n\nimport { useId, type ButtonHTMLAttributes, type CSSProperties, type Ref } from 'react';\nimport { useMessages } from '../internal/provider/EnvUIContext.js';\nimport { datePicker as datePickerMessages } from '../foundations/messages/datePicker.js';\nimport { Button } from '../actions/Button.js';\nimport { Grid, Row } from '../layout/Layout.js';\nimport { IconCalendarClock } from '../icons/CalendarClock.js';\nimport { IconCalendarMonth } from '../icons/CalendarMonth.js';\nimport { Calendar, calendarActiveDay } from './Calendar.js';\nimport {\n type FieldProps,\n type FieldSizeProps,\n type TextFieldDecorationProps,\n} from '../internal/field/FieldFrame.js';\nimport {\n PickerField,\n usePickerOpen,\n type PickerOpenChangeDetails,\n} from './internal/PickerField.js';\nimport { TimeList } from './internal/TimeList.js';\nimport { usePickerFormatter, usePickerValue } from './internal/usePickerValue.js';\nimport {\n clampDay,\n formatDateTime,\n formatDay,\n fromMoment,\n momentOf,\n now,\n parseDateTime,\n parseDay,\n parseTime,\n toUtcDate,\n type Weekday,\n} from '../internal/time/calendarDays.js';\nimport '../styles/Base.css';\nimport '../styles/DatePicker.css';\n\nexport type { PickerOpenChangeDetails, PickerOpenChangeReason } from './internal/PickerField.js';\n\nexport interface DatePickerProps\n extends\n Omit<\n ButtonHTMLAttributes<HTMLButtonElement>,\n 'value' | 'defaultValue' | 'onChange' | 'children' | 'name' | 'type'\n >,\n FieldProps,\n FieldSizeProps,\n Pick<TextFieldDecorationProps, 'visibleLabel'> {\n /** The field's button, which shows the value and opens the calendar. */\n ref?: Ref<HTMLButtonElement>;\n /** The field's class, on its root element, beside env-field and env-date-picker. */\n className?: string;\n /** Styles of the field's root element. */\n style?: CSSProperties;\n /**\n * The value: a day as YYYY-MM-DD, or with the minute granularity a local date and time as\n * YYYY-MM-DDTHH:mm. null, or an empty string, for none.\n */\n value?: string | null;\n /** The value an uncontrolled field starts with, and that a form reset restores; none by default. */\n defaultValue?: string | null;\n /** Receives the new value, or null once the field is cleared. */\n onValueChange?: (value: string | null) => void;\n /**\n * What the value holds: day, a date as YYYY-MM-DD, or minute, a date and a time as\n * YYYY-MM-DDTHH:mm, chosen in a list of times beside the calendar.\n * @default 'day'\n */\n granularity?: 'day' | 'minute';\n /** The earliest value, as YYYY-MM-DD or YYYY-MM-DDTHH:mm; earlier days are unavailable. */\n min?: string;\n /** The latest value, as YYYY-MM-DD or YYYY-MM-DDTHH:mm; later days are unavailable. */\n max?: string;\n /** The time a newly chosen day starts with, as HH:mm; 00:00 by default. */\n placeholderTime?: string;\n /**\n * With the minute granularity, the minutes between the times the list offers, from 1 to 60. A\n * value between them still shows in the list, in its place.\n * @default 15\n */\n minuteStep?: number;\n /**\n * The locale of the shown value and the calendar's names and numbers: EnvUIProvider's, else the\n * browser's. Dates are Gregorian, also in a locale with a calendar of its own.\n */\n locale?: string;\n /**\n * With the minute granularity, the clock of the shown time and the wheels, whatever the locale's:\n * h23 for 18:00, with no AM/PM wheel, or h12 for 6:00 PM. The value stays on the 24-hour clock.\n * @default the locale's\n */\n hourCycle?: 'h12' | 'h23';\n /**\n * The calendar's first day of the week, from 0 for Sunday to 6 for Saturday.\n * @default the locale's, or Monday where the browser cannot tell\n */\n weekStart?: Weekday;\n /**\n * How the field shows the value: Intl.DateTimeFormat options, by default the medium date style\n * and, with the minute granularity, the short time style, in the Gregorian calendar unless they\n * name another.\n */\n formatOptions?: Intl.DateTimeFormatOptions;\n /** The name the value is submitted under with a form, as YYYY-MM-DD or YYYY-MM-DDTHH:mm. */\n name?: string;\n /**\n * A value is needed: an empty field keeps its form from submitting and takes focus.\n * @default false\n */\n required?: boolean;\n /** The value can be read and focused but not changed. */\n readOnly?: boolean;\n /** Shown while the field is empty and its label floats or is hidden. */\n placeholder?: string;\n /** A clear button in the field and in the calendar removes the value. */\n clearable?: boolean;\n /** Whether the calendar is open; with `onOpenChange` it controls it. */\n open?: boolean;\n /** Whether an uncontrolled calendar starts open; closed by default. */\n defaultOpen?: boolean;\n /** Called with the new state, and why, when the calendar opens or closes. */\n onOpenChange?: (open: boolean, details: PickerOpenChangeDetails) => void;\n /**\n * Accessible name of the field's clear button and text of the calendar's.\n * @default 'Clear', or EnvUIProvider's messages.datePicker.clear\n */\n clearLabel?: string;\n /**\n * The calendar's shortcut to today.\n * @default 'Today', or EnvUIProvider's messages.datePicker.today\n */\n todayLabel?: string;\n /**\n * With the minute granularity, the calendar's shortcut to the current date and time.\n * @default 'Now', or EnvUIProvider's messages.datePicker.now\n */\n nowLabel?: string;\n /**\n * With the minute granularity, the heading and accessible name of the list of times.\n * @default 'Time', or EnvUIProvider's messages.datePicker.time\n */\n timeLabel?: string;\n /**\n * Accessible name of the calendar's previous month button.\n * @default 'Previous month', or EnvUIProvider's messages.calendar.previousMonth\n */\n previousMonthLabel?: string;\n /**\n * Accessible name of the calendar's next month button.\n * @default 'Next month', or EnvUIProvider's messages.calendar.nextMonth\n */\n nextMonthLabel?: string;\n}\n\ninterface DateTimeValue {\n day: number;\n minutes: number;\n}\n\nfunction parseValue(value: string | null | undefined, withTime: boolean, defaultMinutes: number) {\n const dateTime = parseDateTime(value);\n const day = dateTime?.day ?? parseDay(value);\n if (day === undefined) return undefined;\n return { day, minutes: withTime ? (dateTime?.minutes ?? defaultMinutes) : 0 };\n}\n\nfunction boundMoment(value: string | undefined, edge: 'start' | 'end') {\n const dateTime = parseDateTime(value);\n if (dateTime) return momentOf(dateTime.day, dateTime.minutes);\n const day = parseDay(value);\n if (day === undefined) return undefined;\n return edge === 'start' ? momentOf(day, 0) : momentOf(day + 1, 0) - 1;\n}\n\nfunction boundMinutesOnDay(moment: number | undefined, day: number) {\n if (moment === undefined) return undefined;\n const bound = fromMoment(moment);\n return bound.day === day ? bound.minutes : undefined;\n}\n\n/**\n * A field for a date, or a date and time, that shows the value in the reader's locale and opens a\n * calendar to choose it, with keyboard access following the WAI-ARIA date picker.\n */\nexport function DatePicker({\n value,\n defaultValue = null,\n onValueChange,\n granularity = 'day',\n min,\n max,\n placeholderTime,\n minuteStep,\n locale,\n hourCycle,\n weekStart,\n formatOptions,\n disabled = false,\n readOnly = false,\n clearable = false,\n open: controlledOpen,\n defaultOpen = false,\n onOpenChange,\n clearLabel,\n todayLabel,\n nowLabel,\n timeLabel,\n previousMonthLabel,\n nextMonthLabel,\n ...fieldProps\n}: DatePickerProps) {\n const withTime = granularity === 'minute';\n const messages = useMessages('datePicker', datePickerMessages);\n const timeHeadingId = useId();\n const [open, setOpen] = usePickerOpen({\n open: controlledOpen,\n defaultOpen,\n onOpenChange,\n disabled,\n readOnly,\n });\n const defaultMinutes = parseTime(placeholderTime) ?? 0;\n\n const picked = usePickerValue({ value, defaultValue, onValueChange });\n const current = parseValue(picked.raw, withTime, defaultMinutes);\n const serialized = current\n ? withTime\n ? formatDateTime(current.day, current.minutes)\n : formatDay(current.day)\n : '';\n\n const minMoment = boundMoment(min, 'start');\n const maxMoment = boundMoment(max, 'end');\n const minDay = minMoment === undefined ? undefined : fromMoment(minMoment).day;\n const maxDay = maxMoment === undefined ? undefined : fromMoment(maxMoment).day;\n\n const { formatter } = usePickerFormatter(\n locale,\n formatOptions,\n withTime ? { dateStyle: 'medium', timeStyle: 'short' } : { dateStyle: 'medium' },\n hourCycle,\n );\n const display = current ? formatter.format(toUtcDate(current.day, current.minutes)) : '';\n\n function commit(next: DateTimeValue | null) {\n let result: string | null = null;\n if (next) {\n if (withTime) {\n let moment = momentOf(next.day, next.minutes);\n if (minMoment !== undefined) moment = Math.max(moment, minMoment);\n if (maxMoment !== undefined) moment = Math.min(moment, maxMoment);\n const kept = fromMoment(moment);\n result = formatDateTime(kept.day, kept.minutes);\n } else {\n result = formatDay(clampDay(next.day, minDay, maxDay));\n }\n }\n picked.change(result, serialized);\n }\n\n function chooseDay(day: string) {\n const chosen = parseDay(day);\n if (chosen === undefined) return;\n commit({ day: chosen, minutes: current?.minutes ?? defaultMinutes });\n if (!withTime) setOpen(false, 'item-press');\n }\n\n const dayForChosenTime = current?.day ?? clampDay(now().day, minDay, maxDay);\n\n function chooseNow() {\n const moment = now();\n commit(withTime ? moment : { day: moment.day, minutes: 0 });\n if (!withTime) setOpen(false, 'item-press');\n }\n\n function clear() {\n commit(null);\n setOpen(false, 'clear-press');\n }\n\n const reference = now();\n const nowAvailable = withTime\n ? (minMoment === undefined || momentOf(reference.day, reference.minutes) >= minMoment) &&\n (maxMoment === undefined || momentOf(reference.day, reference.minutes) <= maxMoment)\n : (minDay === undefined || reference.day >= minDay) &&\n (maxDay === undefined || reference.day <= maxDay);\n\n const calendar = (\n <Calendar\n value={current ? formatDay(current.day) : null}\n onValueChange={chooseDay}\n min={minDay === undefined ? undefined : formatDay(minDay)}\n max={maxDay === undefined ? undefined : formatDay(maxDay)}\n weekStart={weekStart}\n locale={locale}\n previousMonthLabel={previousMonthLabel}\n nextMonthLabel={nextMonthLabel}\n />\n );\n\n return (\n <PickerField\n {...fieldProps}\n serialized={serialized}\n display={display}\n icon={withTime ? <IconCalendarClock /> : <IconCalendarMonth />}\n rootClassName=\"env-date-picker\"\n initialFocus={calendarActiveDay}\n popupStart={\n <Button\n variant=\"text\"\n aria-disabled={!nowAvailable || undefined}\n onClick={() => {\n if (nowAvailable) chooseNow();\n }}\n >\n {withTime ? (nowLabel ?? messages.now) : (todayLabel ?? messages.today)}\n </Button>\n }\n popupEnd={\n clearable &&\n serialized && (\n <Button variant=\"text\" onClick={clear}>\n {clearLabel ?? messages.clear}\n </Button>\n )\n }\n clearLabel={clearLabel ?? messages.clear}\n onClear={() => commit(null)}\n onFormReset={picked.reset}\n open={open}\n setOpen={setOpen}\n disabled={disabled}\n readOnly={readOnly}\n clearable={clearable}\n >\n {withTime ? (\n <Grid gap={3} className=\"env-date-picker-panes\">\n {calendar}\n <Grid gap={2} className=\"env-date-picker-time\">\n <Row align=\"center\" className=\"env-date-picker-time-title\" id={timeHeadingId}>\n {timeLabel ?? messages.time}\n </Row>\n <TimeList\n aria-labelledby={timeHeadingId}\n value={current?.minutes}\n onValueChange={(minutes) => commit({ day: dayForChosenTime, minutes })}\n minuteStep={minuteStep}\n start={placeholderTime === undefined ? undefined : defaultMinutes}\n min={boundMinutesOnDay(minMoment, dayForChosenTime)}\n max={boundMinutesOnDay(maxMoment, dayForChosenTime)}\n locale={locale}\n hourCycle={hourCycle}\n />\n </Grid>\n </Grid>\n ) : (\n calendar\n )}\n </PickerField>\n );\n}\n"],
5
- "mappings": ";AAiSI,cAmDM,YAnDN;AA/RJ,SAAS,aAAsE;AAC/E,SAAS,mBAAmB;AAC5B,SAAS,cAAc,0BAA0B;AACjD,SAAS,cAAc;AACvB,SAAS,MAAM,WAAW;AAC1B,SAAS,yBAAyB;AAClC,SAAS,yBAAyB;AAClC,SAAS,UAAU,yBAAyB;AAC5C;AAAA,OAIO;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,SAAS,gBAAgB;AACzB,SAAS,oBAAoB,sBAAsB;AACnD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,OAAO;AACP,OAAO;AA4HP,SAAS,WAAW,OAAkC,UAAmB,gBAAwB;AAC/F,QAAM,WAAW,cAAc,KAAK;AACpC,QAAM,MAAM,UAAU,OAAO,SAAS,KAAK;AAC3C,MAAI,QAAQ,OAAW,QAAO;AAC9B,SAAO,EAAE,KAAK,SAAS,WAAY,UAAU,WAAW,iBAAkB,EAAE;AAC9E;AAEA,SAAS,YAAY,OAA2B,MAAuB;AACrE,QAAM,WAAW,cAAc,KAAK;AACpC,MAAI,SAAU,QAAO,SAAS,SAAS,KAAK,SAAS,OAAO;AAC5D,QAAM,MAAM,SAAS,KAAK;AAC1B,MAAI,QAAQ,OAAW,QAAO;AAC9B,SAAO,SAAS,UAAU,SAAS,KAAK,CAAC,IAAI,SAAS,MAAM,GAAG,CAAC,IAAI;AACtE;AAEA,SAAS,kBAAkB,QAA4B,KAAa;AAClE,MAAI,WAAW,OAAW,QAAO;AACjC,QAAM,QAAQ,WAAW,MAAM;AAC/B,SAAO,MAAM,QAAQ,MAAM,MAAM,UAAU;AAC7C;AAMO,SAAS,WAAW;AAAA,EACzB;AAAA,EACA,eAAe;AAAA,EACf;AAAA,EACA,cAAc;AAAA,EACd;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,MAAM;AAAA,EACN,cAAc;AAAA,EACd;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAoB;AAClB,QAAM,WAAW,gBAAgB;AACjC,QAAM,WAAW,YAAY,cAAc,kBAAkB;AAC7D,QAAM,gBAAgB,MAAM;AAC5B,QAAM,CAAC,MAAM,OAAO,IAAI,cAAc;AAAA,IACpC,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,QAAM,iBAAiB,UAAU,eAAe,KAAK;AAErD,QAAM,SAAS,eAAe,EAAE,OAAO,cAAc,cAAc,CAAC;AACpE,QAAM,UAAU,WAAW,OAAO,KAAK,UAAU,cAAc;AAC/D,QAAM,aAAa,UACf,WACE,eAAe,QAAQ,KAAK,QAAQ,OAAO,IAC3C,UAAU,QAAQ,GAAG,IACvB;AAEJ,QAAM,YAAY,YAAY,KAAK,OAAO;AAC1C,QAAM,YAAY,YAAY,KAAK,KAAK;AACxC,QAAM,SAAS,cAAc,SAAY,SAAY,WAAW,SAAS,EAAE;AAC3E,QAAM,SAAS,cAAc,SAAY,SAAY,WAAW,SAAS,EAAE;AAE3E,QAAM,EAAE,UAAU,IAAI;AAAA,IACpB;AAAA,IACA;AAAA,IACA,WAAW,EAAE,WAAW,UAAU,WAAW,QAAQ,IAAI,EAAE,WAAW,SAAS;AAAA,IAC/E;AAAA,EACF;AACA,QAAM,UAAU,UAAU,UAAU,OAAO,UAAU,QAAQ,KAAK,QAAQ,OAAO,CAAC,IAAI;AAEtF,WAAS,OAAO,MAA4B;AAC1C,QAAI,SAAwB;AAC5B,QAAI,MAAM;AACR,UAAI,UAAU;AACZ,YAAI,SAAS,SAAS,KAAK,KAAK,KAAK,OAAO;AAC5C,YAAI,cAAc,OAAW,UAAS,KAAK,IAAI,QAAQ,SAAS;AAChE,YAAI,cAAc,OAAW,UAAS,KAAK,IAAI,QAAQ,SAAS;AAChE,cAAM,OAAO,WAAW,MAAM;AAC9B,iBAAS,eAAe,KAAK,KAAK,KAAK,OAAO;AAAA,MAChD,OAAO;AACL,iBAAS,UAAU,SAAS,KAAK,KAAK,QAAQ,MAAM,CAAC;AAAA,MACvD;AAAA,IACF;AACA,WAAO,OAAO,QAAQ,UAAU;AAAA,EAClC;AAEA,WAAS,UAAU,KAAa;AAC9B,UAAM,SAAS,SAAS,GAAG;AAC3B,QAAI,WAAW,OAAW;AAC1B,WAAO,EAAE,KAAK,QAAQ,SAAS,SAAS,WAAW,eAAe,CAAC;AACnE,QAAI,CAAC,SAAU,SAAQ,OAAO,YAAY;AAAA,EAC5C;AAEA,QAAM,mBAAmB,SAAS,OAAO,SAAS,IAAI,EAAE,KAAK,QAAQ,MAAM;AAE3E,WAAS,YAAY;AACnB,UAAM,SAAS,IAAI;AACnB,WAAO,WAAW,SAAS,EAAE,KAAK,OAAO,KAAK,SAAS,EAAE,CAAC;AAC1D,QAAI,CAAC,SAAU,SAAQ,OAAO,YAAY;AAAA,EAC5C;AAEA,WAAS,QAAQ;AACf,WAAO,IAAI;AACX,YAAQ,OAAO,aAAa;AAAA,EAC9B;AAEA,QAAM,YAAY,IAAI;AACtB,QAAM,eAAe,YAChB,cAAc,UAAa,SAAS,UAAU,KAAK,UAAU,OAAO,KAAK,eACzE,cAAc,UAAa,SAAS,UAAU,KAAK,UAAU,OAAO,KAAK,cACzE,WAAW,UAAa,UAAU,OAAO,YACzC,WAAW,UAAa,UAAU,OAAO;AAE9C,QAAM,WACJ;AAAA,IAAC;AAAA;AAAA,MACC,OAAO,UAAU,UAAU,QAAQ,GAAG,IAAI;AAAA,MAC1C,eAAe;AAAA,MACf,KAAK,WAAW,SAAY,SAAY,UAAU,MAAM;AAAA,MACxD,KAAK,WAAW,SAAY,SAAY,UAAU,MAAM;AAAA,MACxD;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA;AAAA,EACF;AAGF,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ;AAAA,MACA;AAAA,MACA,MAAM,WAAW,oBAAC,qBAAkB,IAAK,oBAAC,qBAAkB;AAAA,MAC5D,eAAc;AAAA,MACd,cAAc;AAAA,MACd,YACE;AAAA,QAAC;AAAA;AAAA,UACC,SAAQ;AAAA,UACR,iBAAe,CAAC,gBAAgB;AAAA,UAChC,SAAS,MAAM;AACb,gBAAI,aAAc,WAAU;AAAA,UAC9B;AAAA,UAEC,qBAAY,YAAY,SAAS,MAAQ,cAAc,SAAS;AAAA;AAAA,MACnE;AAAA,MAEF,UACE,aACA,cACE,oBAAC,UAAO,SAAQ,QAAO,SAAS,OAC7B,wBAAc,SAAS,OAC1B;AAAA,MAGJ,YAAY,cAAc,SAAS;AAAA,MACnC,SAAS,MAAM,OAAO,IAAI;AAAA,MAC1B,aAAa,OAAO;AAAA,MACpB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MAEC,qBACC,qBAAC,QAAK,KAAK,GAAG,WAAU,yBACrB;AAAA;AAAA,QACD,qBAAC,QAAK,KAAK,GAAG,WAAU,wBACtB;AAAA,8BAAC,OAAI,OAAM,UAAS,WAAU,8BAA6B,IAAI,eAC5D,uBAAa,SAAS,MACzB;AAAA,UACA;AAAA,YAAC;AAAA;AAAA,cACC,mBAAiB;AAAA,cACjB,OAAO,SAAS;AAAA,cAChB,eAAe,CAAC,YAAY,OAAO,EAAE,KAAK,kBAAkB,QAAQ,CAAC;AAAA,cACrE;AAAA,cACA,OAAO,oBAAoB,SAAY,SAAY;AAAA,cACnD,KAAK,kBAAkB,WAAW,gBAAgB;AAAA,cAClD,KAAK,kBAAkB,WAAW,gBAAgB;AAAA,cAClD;AAAA,cACA;AAAA;AAAA,UACF;AAAA,WACF;AAAA,SACF,IAEA;AAAA;AAAA,EAEJ;AAEJ;",
4
+ "sourcesContent": ["'use client';\n\nimport {\n useId,\n type ButtonHTMLAttributes,\n type CSSProperties,\n type ReactNode,\n type Ref,\n} from 'react';\nimport { useMessages } from '../internal/provider/EnvUIContext.js';\nimport { datePicker as datePickerMessages } from '../foundations/messages/datePicker.js';\nimport { Grid, Row } from '../layout/Layout.js';\nimport { IconCalendarClock } from '../icons/CalendarClock.js';\nimport { IconCalendarMonth } from '../icons/CalendarMonth.js';\nimport { Calendar, type CalendarProps } from './Calendar.js';\nimport { calendarInitialFocus } from './internal/pickerFocus.js';\nimport {\n type FieldProps,\n type FieldSizeProps,\n type FieldDecorationProps,\n} from '../internal/field/fieldProps.js';\nimport { PickerField } from './internal/PickerField.js';\nimport { TimeList } from './internal/TimeList.js';\nimport {\n usePicker,\n type PickerOpenChangeDetails,\n type PickerOpenChangeReason,\n} from './internal/usePicker.js';\nimport { usePickerFormatter } from './internal/usePickerFormatter.js';\nimport {\n clampDay,\n formatDateTime,\n formatDay,\n fromMoment,\n inBounds,\n momentOf,\n now,\n parseDateTime,\n parseDay,\n parseTime,\n toUtcDate,\n type Weekday,\n} from './internal/calendarDays.js';\nimport '../styles/Base.css';\nimport '../styles/DatePicker.css';\n\n/** Why a date picker's calendar asks to open or close: a picker's reasons. */\nexport type DatePickerOpenChangeReason = PickerOpenChangeReason;\n\n/** What a date picker's onOpenChange receives beside the requested state: a picker's details. */\nexport type DatePickerOpenChangeDetails = PickerOpenChangeDetails;\n\nexport interface DatePickerProps\n extends\n Omit<\n ButtonHTMLAttributes<HTMLButtonElement>,\n 'value' | 'defaultValue' | 'onChange' | 'children' | 'name' | 'type'\n >,\n FieldProps,\n FieldSizeProps,\n Pick<FieldDecorationProps, 'visibleLabel'> {\n /** The field's button, which shows the value and opens the calendar. */\n ref?: Ref<HTMLButtonElement>;\n /** The field's class, on its root element, beside env-field and env-date-picker. */\n className?: string;\n /** Styles of the field's root element. */\n style?: CSSProperties;\n /**\n * The value: a day as YYYY-MM-DD, or with the minute granularity a local date and time as\n * YYYY-MM-DDTHH:mm. null, or an empty string, for none.\n */\n value?: string | null;\n /** The value an uncontrolled field starts with, and that a form reset restores; none by default. */\n defaultValue?: string | null;\n /** Receives the new value, or null once the field is cleared. */\n onValueChange?: (value: string | null) => void;\n /**\n * What the value holds: day, a date as YYYY-MM-DD, or minute, a date and a time as\n * YYYY-MM-DDTHH:mm, chosen in a list of times beside the calendar.\n * @default 'day'\n */\n granularity?: 'day' | 'minute';\n /** The earliest value, as YYYY-MM-DD or YYYY-MM-DDTHH:mm; earlier days are unavailable. */\n min?: string;\n /** The latest value, as YYYY-MM-DD or YYYY-MM-DDTHH:mm; later days are unavailable. */\n max?: string;\n /** As Calendar's: whether a day, as YYYY-MM-DD, can't be chosen, such as a booked day. */\n isDateUnavailable?: CalendarProps['isDateUnavailable'];\n /** As Calendar's: the content of a day's mark in the calendar in place of its number. */\n renderDay?: CalendarProps['renderDay'];\n /** The time a newly chosen day starts with, as HH:mm; 00:00 by default. */\n placeholderTime?: string;\n /**\n * With the minute granularity, the minutes between the times the list offers, from 1 to 60. A\n * value between them still shows in the list, in its place.\n * @default 15\n */\n minuteStep?: number;\n /**\n * The locale of the shown value and the calendar's names and numbers: EnvUIProvider's, else the\n * browser's. Dates are Gregorian, also in a locale with a calendar of its own.\n */\n locale?: string;\n /**\n * With the minute granularity, the clock of the shown time and the wheels, whatever the locale's:\n * h23 for 18:00, with no AM/PM wheel, or h12 for 6:00 PM. The value stays on the 24-hour clock.\n * @default the locale's\n */\n hourCycle?: 'h12' | 'h23';\n /**\n * The calendar's first day of the week, from 0 for Sunday to 6 for Saturday.\n * @default the locale's, or Monday where the browser cannot tell\n */\n weekStart?: Weekday;\n /**\n * How the field shows the value: Intl.DateTimeFormat options, by default the medium date style\n * and, with the minute granularity, the short time style, in the Gregorian calendar unless they\n * name another.\n */\n formatOptions?: Intl.DateTimeFormatOptions;\n /** The name the value is submitted under with a form, as YYYY-MM-DD or YYYY-MM-DDTHH:mm. */\n name?: string;\n /**\n * A value is needed: an empty field keeps its form from submitting and takes focus.\n * @default false\n */\n required?: boolean;\n /**\n * The value can be read and focused but not changed.\n * @default false\n */\n readOnly?: boolean;\n /** Shown while the field is empty and its label floats or is hidden. */\n placeholder?: string;\n /**\n * A clear button in the field and in the calendar removes the value.\n * @default false\n */\n clearable?: boolean;\n /** Whether the calendar is open; with `onOpenChange` it controls it. */\n open?: boolean;\n /**\n * Whether an uncontrolled calendar starts open; closed by default.\n * @default false\n */\n defaultOpen?: boolean;\n /** Called with the new state, and why, when the calendar opens or closes. */\n onOpenChange?: (open: boolean, details: DatePickerOpenChangeDetails) => void;\n /**\n * Accessible name of the field's clear button and text of the calendar's.\n * @default 'Clear', or EnvUIProvider's messages.datePicker.clear\n */\n clearLabel?: string;\n /**\n * The calendar's shortcut to today.\n * @default 'Today', or EnvUIProvider's messages.datePicker.today\n */\n todayLabel?: string;\n /**\n * With the minute granularity, the calendar's shortcut to the current date and time.\n * @default 'Now', or EnvUIProvider's messages.datePicker.now\n */\n nowLabel?: string;\n /**\n * With the minute granularity, the heading and accessible name of the list of times.\n * @default 'Time', or EnvUIProvider's messages.datePicker.time\n */\n timeLabel?: string;\n /**\n * Accessible name of the calendar's previous month button.\n * @default 'Previous month', or EnvUIProvider's messages.calendar.previousMonth\n */\n previousMonthLabel?: string;\n /**\n * Accessible name of the calendar's next month button.\n * @default 'Next month', or EnvUIProvider's messages.calendar.nextMonth\n */\n nextMonthLabel?: string;\n /**\n * Content at the top of the popup, above the calendar, such as presets: buttons for\n * Tomorrow or Next Monday that set the value, from a field the application controls.\n */\n popupHeader?: ReactNode;\n /**\n * Content in the popup's footer, after its shortcut to the current date or time and before Clear,\n * such as a note of the time zone or another action.\n */\n popupFooter?: ReactNode;\n}\n\ninterface DateTimeValue {\n day: number;\n minutes: number;\n}\n\nfunction parseValue(value: string | null | undefined, withTime: boolean, defaultMinutes: number) {\n const dateTime = parseDateTime(value);\n const day = dateTime?.day ?? parseDay(value);\n if (day === undefined) return undefined;\n return { day, minutes: withTime ? (dateTime?.minutes ?? defaultMinutes) : 0 };\n}\n\nfunction boundMoment(value: string | undefined, edge: 'start' | 'end') {\n const dateTime = parseDateTime(value);\n if (dateTime) return momentOf(dateTime.day, dateTime.minutes);\n const day = parseDay(value);\n if (day === undefined) return undefined;\n return edge === 'start' ? momentOf(day, 0) : momentOf(day + 1, 0) - 1;\n}\n\nfunction boundMinutesOnDay(moment: number | undefined, day: number) {\n if (moment === undefined) return undefined;\n const bound = fromMoment(moment);\n return bound.day === day ? bound.minutes : undefined;\n}\n\n/**\n * A field for a date, or a date and time, that shows the value in the reader's locale and opens a\n * calendar to choose it, with keyboard access following the WAI-ARIA date picker.\n */\nexport function DatePicker({\n value,\n defaultValue = null,\n onValueChange,\n granularity = 'day',\n min,\n max,\n isDateUnavailable,\n renderDay,\n placeholderTime,\n minuteStep,\n locale,\n hourCycle,\n weekStart,\n formatOptions,\n open,\n defaultOpen,\n onOpenChange,\n clearLabel,\n todayLabel,\n nowLabel,\n timeLabel,\n previousMonthLabel,\n nextMonthLabel,\n ...fieldProps\n}: DatePickerProps) {\n const withTime = granularity === 'minute';\n const messages = useMessages('datePicker', datePickerMessages);\n const timeHeadingId = useId();\n const defaultMinutes = parseTime(placeholderTime) ?? 0;\n\n const picker = usePicker({ value, defaultValue, onValueChange, open, defaultOpen, onOpenChange });\n const current = parseValue(picker.raw, withTime, defaultMinutes);\n const serialized = current\n ? withTime\n ? formatDateTime(current.day, current.minutes)\n : formatDay(current.day)\n : '';\n\n const minMoment = boundMoment(min, 'start');\n const maxMoment = boundMoment(max, 'end');\n const minDay = minMoment === undefined ? undefined : fromMoment(minMoment).day;\n const maxDay = maxMoment === undefined ? undefined : fromMoment(maxMoment).day;\n\n const { formatter } = usePickerFormatter(\n locale,\n formatOptions,\n withTime ? { dateStyle: 'medium', timeStyle: 'short' } : { dateStyle: 'medium' },\n hourCycle,\n );\n const display = current ? formatter.format(toUtcDate(current.day, current.minutes)) : '';\n\n function commit(next: DateTimeValue | null) {\n let result: string | null = null;\n if (next) {\n if (withTime) {\n let moment = momentOf(next.day, next.minutes);\n if (minMoment !== undefined) moment = Math.max(moment, minMoment);\n if (maxMoment !== undefined) moment = Math.min(moment, maxMoment);\n const kept = fromMoment(moment);\n result = formatDateTime(kept.day, kept.minutes);\n } else {\n result = formatDay(clampDay(next.day, minDay, maxDay));\n }\n }\n picker.change(result, serialized);\n }\n\n function chooseDay(day: string) {\n const chosen = parseDay(day);\n if (chosen === undefined) return;\n commit({ day: chosen, minutes: current?.minutes ?? defaultMinutes });\n if (!withTime) picker.setOpen(false, 'item-press');\n }\n\n const dayForChosenTime = current?.day ?? clampDay(now().day, minDay, maxDay);\n\n function chooseNow() {\n const moment = now();\n commit(withTime ? moment : { day: moment.day, minutes: 0 });\n if (!withTime) picker.setOpen(false, 'item-press');\n }\n\n const reference = now();\n const nowAvailable = withTime\n ? inBounds(momentOf(reference.day, reference.minutes), minMoment, maxMoment)\n : inBounds(reference.day, minDay, maxDay) &&\n isDateUnavailable?.(formatDay(reference.day)) !== true;\n\n const calendar = (\n <Calendar\n value={current ? formatDay(current.day) : null}\n onValueChange={chooseDay}\n min={minDay === undefined ? undefined : formatDay(minDay)}\n max={maxDay === undefined ? undefined : formatDay(maxDay)}\n isDateUnavailable={isDateUnavailable}\n renderDay={renderDay}\n weekStart={weekStart}\n locale={locale}\n previousMonthLabel={previousMonthLabel}\n nextMonthLabel={nextMonthLabel}\n />\n );\n\n return (\n <PickerField\n {...fieldProps}\n picker={picker}\n serialized={serialized}\n display={display}\n icon={withTime ? <IconCalendarClock /> : <IconCalendarMonth />}\n rootClassName=\"env-date-picker\"\n initialFocus={calendarInitialFocus}\n shortcut={{\n label: withTime ? (nowLabel ?? messages.now) : (todayLabel ?? messages.today),\n available: nowAvailable,\n onPress: chooseNow,\n }}\n clearLabel={clearLabel ?? messages.clear}\n >\n {withTime ? (\n <Grid gap={3} className=\"env-date-picker-panes\">\n {calendar}\n <Grid gap={2} className=\"env-date-picker-time\">\n <Row align=\"center\" className=\"env-date-picker-time-title\" id={timeHeadingId}>\n {timeLabel ?? messages.time}\n </Row>\n <TimeList\n aria-labelledby={timeHeadingId}\n value={current?.minutes}\n onValueChange={(minutes) => commit({ day: dayForChosenTime, minutes })}\n minuteStep={minuteStep}\n start={placeholderTime === undefined ? undefined : defaultMinutes}\n min={boundMinutesOnDay(minMoment, dayForChosenTime)}\n max={boundMinutesOnDay(maxMoment, dayForChosenTime)}\n locale={locale}\n hourCycle={hourCycle}\n />\n </Grid>\n </Grid>\n ) : (\n calendar\n )}\n </PickerField>\n );\n}\n"],
5
+ "mappings": ";AAsTI,cAiCM,YAjCN;AApTJ;AAAA,EACE;AAAA,OAKK;AACP,SAAS,mBAAmB;AAC5B,SAAS,cAAc,0BAA0B;AACjD,SAAS,MAAM,WAAW;AAC1B,SAAS,yBAAyB;AAClC,SAAS,yBAAyB;AAClC,SAAS,gBAAoC;AAC7C,SAAS,4BAA4B;AACrC;AAAA,OAIO;AACP,SAAS,mBAAmB;AAC5B,SAAS,gBAAgB;AACzB;AAAA,EACE;AAAA,OAGK;AACP,SAAS,0BAA0B;AACnC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,OAAO;AACP,OAAO;AAuJP,SAAS,WAAW,OAAkC,UAAmB,gBAAwB;AAC/F,QAAM,WAAW,cAAc,KAAK;AACpC,QAAM,MAAM,UAAU,OAAO,SAAS,KAAK;AAC3C,MAAI,QAAQ,OAAW,QAAO;AAC9B,SAAO,EAAE,KAAK,SAAS,WAAY,UAAU,WAAW,iBAAkB,EAAE;AAC9E;AAEA,SAAS,YAAY,OAA2B,MAAuB;AACrE,QAAM,WAAW,cAAc,KAAK;AACpC,MAAI,SAAU,QAAO,SAAS,SAAS,KAAK,SAAS,OAAO;AAC5D,QAAM,MAAM,SAAS,KAAK;AAC1B,MAAI,QAAQ,OAAW,QAAO;AAC9B,SAAO,SAAS,UAAU,SAAS,KAAK,CAAC,IAAI,SAAS,MAAM,GAAG,CAAC,IAAI;AACtE;AAEA,SAAS,kBAAkB,QAA4B,KAAa;AAClE,MAAI,WAAW,OAAW,QAAO;AACjC,QAAM,QAAQ,WAAW,MAAM;AAC/B,SAAO,MAAM,QAAQ,MAAM,MAAM,UAAU;AAC7C;AAMO,SAAS,WAAW;AAAA,EACzB;AAAA,EACA,eAAe;AAAA,EACf;AAAA,EACA,cAAc;AAAA,EACd;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAoB;AAClB,QAAM,WAAW,gBAAgB;AACjC,QAAM,WAAW,YAAY,cAAc,kBAAkB;AAC7D,QAAM,gBAAgB,MAAM;AAC5B,QAAM,iBAAiB,UAAU,eAAe,KAAK;AAErD,QAAM,SAAS,UAAU,EAAE,OAAO,cAAc,eAAe,MAAM,aAAa,aAAa,CAAC;AAChG,QAAM,UAAU,WAAW,OAAO,KAAK,UAAU,cAAc;AAC/D,QAAM,aAAa,UACf,WACE,eAAe,QAAQ,KAAK,QAAQ,OAAO,IAC3C,UAAU,QAAQ,GAAG,IACvB;AAEJ,QAAM,YAAY,YAAY,KAAK,OAAO;AAC1C,QAAM,YAAY,YAAY,KAAK,KAAK;AACxC,QAAM,SAAS,cAAc,SAAY,SAAY,WAAW,SAAS,EAAE;AAC3E,QAAM,SAAS,cAAc,SAAY,SAAY,WAAW,SAAS,EAAE;AAE3E,QAAM,EAAE,UAAU,IAAI;AAAA,IACpB;AAAA,IACA;AAAA,IACA,WAAW,EAAE,WAAW,UAAU,WAAW,QAAQ,IAAI,EAAE,WAAW,SAAS;AAAA,IAC/E;AAAA,EACF;AACA,QAAM,UAAU,UAAU,UAAU,OAAO,UAAU,QAAQ,KAAK,QAAQ,OAAO,CAAC,IAAI;AAEtF,WAAS,OAAO,MAA4B;AAC1C,QAAI,SAAwB;AAC5B,QAAI,MAAM;AACR,UAAI,UAAU;AACZ,YAAI,SAAS,SAAS,KAAK,KAAK,KAAK,OAAO;AAC5C,YAAI,cAAc,OAAW,UAAS,KAAK,IAAI,QAAQ,SAAS;AAChE,YAAI,cAAc,OAAW,UAAS,KAAK,IAAI,QAAQ,SAAS;AAChE,cAAM,OAAO,WAAW,MAAM;AAC9B,iBAAS,eAAe,KAAK,KAAK,KAAK,OAAO;AAAA,MAChD,OAAO;AACL,iBAAS,UAAU,SAAS,KAAK,KAAK,QAAQ,MAAM,CAAC;AAAA,MACvD;AAAA,IACF;AACA,WAAO,OAAO,QAAQ,UAAU;AAAA,EAClC;AAEA,WAAS,UAAU,KAAa;AAC9B,UAAM,SAAS,SAAS,GAAG;AAC3B,QAAI,WAAW,OAAW;AAC1B,WAAO,EAAE,KAAK,QAAQ,SAAS,SAAS,WAAW,eAAe,CAAC;AACnE,QAAI,CAAC,SAAU,QAAO,QAAQ,OAAO,YAAY;AAAA,EACnD;AAEA,QAAM,mBAAmB,SAAS,OAAO,SAAS,IAAI,EAAE,KAAK,QAAQ,MAAM;AAE3E,WAAS,YAAY;AACnB,UAAM,SAAS,IAAI;AACnB,WAAO,WAAW,SAAS,EAAE,KAAK,OAAO,KAAK,SAAS,EAAE,CAAC;AAC1D,QAAI,CAAC,SAAU,QAAO,QAAQ,OAAO,YAAY;AAAA,EACnD;AAEA,QAAM,YAAY,IAAI;AACtB,QAAM,eAAe,WACjB,SAAS,SAAS,UAAU,KAAK,UAAU,OAAO,GAAG,WAAW,SAAS,IACzE,SAAS,UAAU,KAAK,QAAQ,MAAM,KACtC,oBAAoB,UAAU,UAAU,GAAG,CAAC,MAAM;AAEtD,QAAM,WACJ;AAAA,IAAC;AAAA;AAAA,MACC,OAAO,UAAU,UAAU,QAAQ,GAAG,IAAI;AAAA,MAC1C,eAAe;AAAA,MACf,KAAK,WAAW,SAAY,SAAY,UAAU,MAAM;AAAA,MACxD,KAAK,WAAW,SAAY,SAAY,UAAU,MAAM;AAAA,MACxD;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA;AAAA,EACF;AAGF,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,WAAW,oBAAC,qBAAkB,IAAK,oBAAC,qBAAkB;AAAA,MAC5D,eAAc;AAAA,MACd,cAAc;AAAA,MACd,UAAU;AAAA,QACR,OAAO,WAAY,YAAY,SAAS,MAAQ,cAAc,SAAS;AAAA,QACvE,WAAW;AAAA,QACX,SAAS;AAAA,MACX;AAAA,MACA,YAAY,cAAc,SAAS;AAAA,MAElC,qBACC,qBAAC,QAAK,KAAK,GAAG,WAAU,yBACrB;AAAA;AAAA,QACD,qBAAC,QAAK,KAAK,GAAG,WAAU,wBACtB;AAAA,8BAAC,OAAI,OAAM,UAAS,WAAU,8BAA6B,IAAI,eAC5D,uBAAa,SAAS,MACzB;AAAA,UACA;AAAA,YAAC;AAAA;AAAA,cACC,mBAAiB;AAAA,cACjB,OAAO,SAAS;AAAA,cAChB,eAAe,CAAC,YAAY,OAAO,EAAE,KAAK,kBAAkB,QAAQ,CAAC;AAAA,cACrE;AAAA,cACA,OAAO,oBAAoB,SAAY,SAAY;AAAA,cACnD,KAAK,kBAAkB,WAAW,gBAAgB;AAAA,cAClD,KAAK,kBAAkB,WAAW,gBAAgB;AAAA,cAClD;AAAA,cACA;AAAA;AAAA,UACF;AAAA,WACF;AAAA,SACF,IAEA;AAAA;AAAA,EAEJ;AAEJ;",
6
6
  "names": []
7
7
  }
@@ -1,14 +1,20 @@
1
- import { type ComponentPropsWithRef, type ReactNode, type Ref } from 'react';
2
- export interface DropZoneProps extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'onDragEnter' | 'onDragOver' | 'onDragLeave' | 'onDrop'> {
1
+ import { type ComponentPropsWithRef, type ReactElement, type ReactNode, type Ref } from 'react';
2
+ export interface DropZoneProps extends Omit<ComponentPropsWithRef<'div'>, 'onDragEnter' | 'onDragOver' | 'onDragLeave' | 'onDrop'> {
3
3
  /**
4
4
  * What to drop or choose, such as "Drop a logo here, or browse". With the description, it names
5
- * the zone, as its visible text does.
5
+ * the zone, as its visible text does; without the target, only assistive technology reads it.
6
6
  */
7
7
  label: ReactNode;
8
8
  /** Which files fit, such as "PNG, JPG or WebP up to 2 MB"; it is read as part of the name. */
9
9
  description?: ReactNode;
10
10
  /** Replaces the upload icon. */
11
11
  icon?: ReactNode;
12
+ /**
13
+ * Content inside the zone, under its target, such as the chosen files with their previews and
14
+ * Remove buttons, or a Browse button that opens the file picker through inputRef. Files dropped on
15
+ * it are taken too; it can hold controls, since it is beside the target button, not inside it.
16
+ */
17
+ children?: ReactNode;
12
18
  /**
13
19
  * The file types the zone takes, as in the native accept attribute: MIME types such as image/png,
14
20
  * groups such as image/*, and extensions such as .webp.
@@ -53,6 +59,19 @@ export interface DropZoneProps extends Omit<ComponentPropsWithRef<'div'>, 'child
53
59
  * reaches the zone itself.
54
60
  */
55
61
  inputRef?: Ref<HTMLInputElement>;
62
+ /**
63
+ * Show the target: the button with the icon, the label and the description that opens the file
64
+ * picker. Without it, the zone is a group the label names, for content that has its own Browse
65
+ * button, which opens the picker through inputRef, such as a table the files land in.
66
+ * @default true
67
+ */
68
+ target?: boolean;
69
+ /**
70
+ * Another element to render the zone as, such as the application's own panel or table region,
71
+ * which then takes dropped files: the zone's class, its state attributes, such as
72
+ * data-drag-over, and its handlers merge into its props.
73
+ */
74
+ render?: ReactElement;
56
75
  }
57
76
  /** A drop target for files that also opens the file picker; the application shows what was chosen. */
58
- export declare function DropZone({ label, description, icon, accept, multiple, onFilesAccepted, onFilesRejected, disabled, pending, error, size, name, files, form, inputRef, className, ...props }: DropZoneProps): import("react").JSX.Element;
77
+ export declare function DropZone({ label, description, icon, accept, multiple, onFilesAccepted, onFilesRejected, disabled, pending, error, size, name, files, form, inputRef, target: showsTarget, render, className, children, ...props }: DropZoneProps): import("react").JSX.Element;
@@ -12,12 +12,15 @@ import { DecorativeIcon } from "../internal/icon/DecorativeIcon.js";
12
12
  import { Slot } from "../internal/layout/Slot.js";
13
13
  import { ActionElement } from "../internal/control/ActionElement.js";
14
14
  import { FileInput } from "./internal/FileInput.js";
15
- import { setRef } from "../internal/react/setRef.js";
15
+ import { mergeRefs } from "../internal/react/setRef.js";
16
16
  import { Spinner } from "../feedback/Spinner.js";
17
+ import { VisuallyHidden } from "../content/VisuallyHidden.js";
17
18
  import { IconCloudUpload } from "../icons/CloudUpload.js";
18
19
  import * as Field from "./Field.js";
19
20
  import { useFormReset } from "../internal/field/useFormReset.js";
21
+ import { fieldDescribedBy, fieldPartIds } from "../internal/field/useFieldControl.js";
20
22
  import { flag } from "../internal/flag.js";
23
+ import { idRefs } from "../internal/dom/idRefs.js";
21
24
  import "#styles/Base.css";
22
25
  import "#styles/DropZone.css";
23
26
  const spaceReadInName = " ";
@@ -43,7 +46,10 @@ function DropZone({
43
46
  files,
44
47
  form,
45
48
  inputRef,
49
+ target: showsTarget = true,
50
+ render,
46
51
  className,
52
+ children,
47
53
  ...props
48
54
  }) {
49
55
  const id = useId();
@@ -82,14 +88,15 @@ function DropZone({
82
88
  elementsEnteredUnderDrag.current = 0;
83
89
  setDragging(false);
84
90
  }
85
- const visibleTextIds = [`${id}-label`, description != null && `${id}-description`].filter(Boolean).join(" ");
91
+ const ids = fieldPartIds(id);
92
+ const visibleTextIds = idRefs(ids.label, description != null && ids.description);
86
93
  const target = /* @__PURE__ */ jsx(
87
94
  ActionElement,
88
95
  {
89
96
  disabled,
90
97
  pending,
91
98
  "aria-labelledby": visibleTextIds,
92
- "aria-describedby": error != null ? `${id}-error` : void 0,
99
+ "aria-describedby": error != null ? ids.error : void 0,
93
100
  onClick: () => {
94
101
  if (available) filePicker.current?.click();
95
102
  }
@@ -98,17 +105,24 @@ function DropZone({
98
105
  const targetContent = /* @__PURE__ */ jsxs(Fragment, { children: [
99
106
  /* @__PURE__ */ jsx("span", { className: "env-drop-zone-icon", children: pending ? /* @__PURE__ */ jsx(Spinner, { size: size === "sm" ? "sm" : "md" }) : /* @__PURE__ */ jsx(Slot, { className: "env-drop-zone-icon-content", element: "span", layout: "row", shrink: "never", children: /* @__PURE__ */ jsx(DecorativeIcon, { children: icon ?? /* @__PURE__ */ jsx(IconCloudUpload, {}) }) }) }),
100
107
  /* @__PURE__ */ jsxs(Grid, { render: /* @__PURE__ */ jsx("span", {}), gap: size === "sm" ? 0 : 1, className: "env-drop-zone-text", children: [
101
- /* @__PURE__ */ jsx("span", { className: "env-drop-zone-label", id: `${id}-label`, children: /* @__PURE__ */ jsx(Slot, { className: "env-drop-zone-label-content", element: "span", children: label }) }),
108
+ /* @__PURE__ */ jsx("span", { className: "env-drop-zone-label", id: ids.label, children: /* @__PURE__ */ jsx(Slot, { className: "env-drop-zone-label-content", element: "span", children: label }) }),
102
109
  description != null && /* @__PURE__ */ jsxs(Fragment, { children: [
103
110
  spaceReadInName,
104
- /* @__PURE__ */ jsx("span", { className: "env-drop-zone-description", id: `${id}-description`, children: /* @__PURE__ */ jsx(Slot, { className: "env-drop-zone-description-content", element: "span", children: description }) })
111
+ /* @__PURE__ */ jsx("span", { className: "env-drop-zone-description", id: ids.description, children: /* @__PURE__ */ jsx(Slot, { className: "env-drop-zone-description-content", element: "span", children: description }) })
105
112
  ] })
106
113
  ] })
107
114
  ] });
115
+ const group = showsTarget ? {} : {
116
+ role: "group",
117
+ "aria-labelledby": ids.label,
118
+ "aria-describedby": fieldDescribedBy(id, void 0, description, error)
119
+ };
108
120
  return /* @__PURE__ */ jsxs(
109
121
  Field.Root,
110
122
  {
123
+ ...group,
111
124
  ...props,
125
+ render: /* @__PURE__ */ jsx(Grid, { gap: 3, render }),
112
126
  invalid: error != null || void 0,
113
127
  className: classNames("env-drop-zone", className),
114
128
  "data-size": size,
@@ -138,14 +152,18 @@ function DropZone({
138
152
  if (available) take(Array.from(event.dataTransfer.files));
139
153
  },
140
154
  children: [
141
- /* @__PURE__ */ jsx(Grid, { gap: 3, className: "env-drop-zone-target", render: target, children: targetContent }),
155
+ showsTarget ? /* @__PURE__ */ jsx(Grid, { gap: 3, className: "env-drop-zone-target", render: target, children: targetContent }) : /* @__PURE__ */ jsxs(VisuallyHidden, { children: [
156
+ /* @__PURE__ */ jsx("span", { id: ids.label, children: label }),
157
+ description != null && /* @__PURE__ */ jsxs(Fragment, { children: [
158
+ spaceReadInName,
159
+ /* @__PURE__ */ jsx("span", { id: ids.description, children: description })
160
+ ] })
161
+ ] }),
162
+ children != null && /* @__PURE__ */ jsx(Slot, { className: "env-drop-zone-content", children }),
142
163
  /* @__PURE__ */ jsx(
143
164
  FileInput,
144
165
  {
145
- ref: (node) => {
146
- filePicker.current = node;
147
- setRef(inputRef, node);
148
- },
166
+ ref: mergeRefs(filePicker, inputRef),
149
167
  accept,
150
168
  multiple,
151
169
  disabled,
@@ -164,7 +182,7 @@ function DropZone({
164
182
  disabled
165
183
  }
166
184
  ) : null,
167
- error != null && /* @__PURE__ */ jsx(Field.Error, { id: `${id}-error`, children: error })
185
+ error != null && /* @__PURE__ */ jsx(Field.Error, { id: ids.error, children: error })
168
186
  ]
169
187
  }
170
188
  );
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/forms/DropZone.tsx"],
4
- "sourcesContent": ["'use client';\n\nimport {\n useId,\n useLayoutEffect,\n useRef,\n useState,\n type ComponentPropsWithRef,\n type DragEvent,\n type ReactNode,\n type Ref,\n} from 'react';\nimport { classNames } from '../internal/classNames.js';\nimport { Grid } from '../layout/Layout.js';\nimport { DecorativeIcon } from '../internal/icon/DecorativeIcon.js';\nimport { Slot } from '../internal/layout/Slot.js';\nimport { ActionElement } from '../internal/control/ActionElement.js';\nimport { FileInput } from './internal/FileInput.js';\nimport { setRef } from '../internal/react/setRef.js';\nimport { Spinner } from '../feedback/Spinner.js';\nimport { IconCloudUpload } from '../icons/CloudUpload.js';\nimport * as Field from './Field.js';\nimport { useFormReset } from '../internal/field/useFormReset.js';\nimport { flag } from '../internal/flag.js';\nimport '../styles/Base.css';\nimport '../styles/DropZone.css';\n\nexport interface DropZoneProps extends Omit<\n ComponentPropsWithRef<'div'>,\n 'children' | 'onDragEnter' | 'onDragOver' | 'onDragLeave' | 'onDrop'\n> {\n /**\n * What to drop or choose, such as \"Drop a logo here, or browse\". With the description, it names\n * the zone, as its visible text does.\n */\n label: ReactNode;\n /** Which files fit, such as \"PNG, JPG or WebP up to 2 MB\"; it is read as part of the name. */\n description?: ReactNode;\n /** Replaces the upload icon. */\n icon?: ReactNode;\n /**\n * The file types the zone takes, as in the native accept attribute: MIME types such as image/png,\n * groups such as image/*, and extensions such as .webp.\n * @default any file\n */\n accept?: string;\n /** Take several files at once; otherwise the zone takes the first file. */\n multiple?: boolean;\n /** Receives the dropped or chosen files that the zone takes. */\n onFilesAccepted: (files: File[]) => void;\n /** Receives the files that do not match accept, and those after the first without multiple. */\n onFilesRejected?: (files: File[]) => void;\n /** The zone can't be pressed or focused and takes no files; it still keeps the browser from opening dropped files. */\n disabled?: boolean;\n /**\n * The application is working on the files: a spinner replaces the icon, the zone reports that it\n * is busy and takes no new files.\n */\n pending?: boolean;\n /** A message linked to the zone, whose outline takes the error color. */\n error?: ReactNode;\n /**\n * md is the tall area with a large icon; sm is one row with a small icon, for a form or a\n * sidebar.\n * @default 'md'\n */\n size?: 'sm' | 'md';\n /**\n * Submits files with a native form under this name: the last files the zone took, until the form\n * resets, or files.\n */\n name?: string;\n /**\n * The files a named zone submits when the application keeps them, such as after a Remove action;\n * they replace the files the zone took, also after the form resets.\n */\n files?: readonly File[];\n /** The id of a form the zone belongs to when it is outside of it. */\n form?: string;\n /**\n * The native file input that opens the file picker, for example from a Replace button; ref\n * reaches the zone itself.\n */\n inputRef?: Ref<HTMLInputElement>;\n}\n\nconst spaceReadInName = ' ';\n\nfunction takeOverDropFromBrowser(event: DragEvent) {\n event.preventDefault();\n}\n\nfunction carriesFiles(event: DragEvent) {\n return Array.from(event.dataTransfer.types).includes('Files');\n}\n\n/** A drop target for files that also opens the file picker; the application shows what was chosen. */\nexport function DropZone({\n label,\n description,\n icon,\n accept,\n multiple = false,\n onFilesAccepted,\n onFilesRejected,\n disabled = false,\n pending = false,\n error,\n size = 'md',\n name,\n files,\n form,\n inputRef,\n className,\n ...props\n}: DropZoneProps) {\n const id = useId();\n const filePicker = useRef<HTMLInputElement>(null);\n const submittedFilesInput = useRef<HTMLInputElement>(null);\n const [dragging, setDragging] = useState(false);\n const elementsEnteredUnderDrag = useRef(0);\n const available = !disabled && !pending;\n\n function submitWithForm(next: readonly File[]) {\n const element = submittedFilesInput.current;\n if (!element || typeof DataTransfer !== 'function') return;\n const transfer = new DataTransfer();\n next.forEach((file) => transfer.items.add(file));\n element.files = transfer.files;\n }\n\n useLayoutEffect(() => {\n if (files !== undefined) submitWithForm(files);\n }, [files, name]);\n\n useFormReset(\n submittedFilesInput,\n function keepFilesAfterFormReset() {\n if (files !== undefined) submitWithForm(files);\n },\n form,\n );\n\n function take(chosen: File[]) {\n const matching = chosen.filter((file) => matchesNativeAccept(file, accept));\n const taken = multiple ? matching : matching.slice(0, 1);\n const rejected = chosen.filter((file) => !taken.includes(file));\n const applicationKeepsFiles = files !== undefined;\n if (taken.length > 0 && !applicationKeepsFiles) submitWithForm(taken);\n if (rejected.length > 0) onFilesRejected?.(rejected);\n if (taken.length > 0) onFilesAccepted(taken);\n }\n\n function endDrag() {\n elementsEnteredUnderDrag.current = 0;\n setDragging(false);\n }\n\n const visibleTextIds = [`${id}-label`, description != null && `${id}-description`]\n .filter(Boolean)\n .join(' ');\n\n const target = (\n <ActionElement\n disabled={disabled}\n pending={pending}\n aria-labelledby={visibleTextIds}\n aria-describedby={error != null ? `${id}-error` : undefined}\n onClick={() => {\n if (available) filePicker.current?.click();\n }}\n />\n );\n const targetContent = (\n <>\n <span className=\"env-drop-zone-icon\">\n {pending ? (\n <Spinner size={size === 'sm' ? 'sm' : 'md'} />\n ) : (\n <Slot className=\"env-drop-zone-icon-content\" element=\"span\" layout=\"row\" shrink=\"never\">\n <DecorativeIcon>{icon ?? <IconCloudUpload />}</DecorativeIcon>\n </Slot>\n )}\n </span>\n <Grid render={<span />} gap={size === 'sm' ? 0 : 1} className=\"env-drop-zone-text\">\n <span className=\"env-drop-zone-label\" id={`${id}-label`}>\n <Slot className=\"env-drop-zone-label-content\" element=\"span\">\n {label}\n </Slot>\n </span>\n {description != null && (\n <>\n {spaceReadInName}\n <span className=\"env-drop-zone-description\" id={`${id}-description`}>\n <Slot className=\"env-drop-zone-description-content\" element=\"span\">\n {description}\n </Slot>\n </span>\n </>\n )}\n </Grid>\n </>\n );\n return (\n <Field.Root\n {...props}\n invalid={error != null || undefined}\n className={classNames('env-drop-zone', className)}\n data-size={size}\n data-drag-over={flag(dragging)}\n data-pending={flag(pending)}\n data-invalid={flag(error != null)}\n onDragEnter={(event) => {\n if (!carriesFiles(event)) return;\n event.preventDefault();\n elementsEnteredUnderDrag.current += 1;\n if (available) setDragging(true);\n }}\n onDragOver={(event) => {\n if (!carriesFiles(event)) return;\n takeOverDropFromBrowser(event);\n event.dataTransfer.dropEffect = available ? 'copy' : 'none';\n }}\n onDragLeave={(event) => {\n if (!carriesFiles(event)) return;\n elementsEnteredUnderDrag.current = Math.max(0, elementsEnteredUnderDrag.current - 1);\n if (elementsEnteredUnderDrag.current === 0) setDragging(false);\n }}\n onDrop={(event) => {\n if (!carriesFiles(event)) return;\n event.preventDefault();\n endDrag();\n if (available) take(Array.from(event.dataTransfer.files));\n }}\n >\n <Grid gap={3} className=\"env-drop-zone-target\" render={target}>\n {targetContent}\n </Grid>\n <FileInput\n ref={(node) => {\n filePicker.current = node;\n setRef(inputRef, node);\n }}\n accept={accept}\n multiple={multiple}\n disabled={disabled}\n onFiles={(chosen) => {\n if (available) take(chosen);\n }}\n />\n {name ? (\n <FileInput\n ref={submittedFilesInput}\n multiple={multiple}\n name={name}\n form={form}\n disabled={disabled}\n />\n ) : null}\n {error != null && <Field.Error id={`${id}-error`}>{error}</Field.Error>}\n </Field.Root>\n );\n}\n\nfunction matchesNativeAccept(file: File, accept: string | undefined) {\n const patterns = (accept ?? '')\n .split(',')\n .map((pattern) => pattern.trim().toLowerCase())\n .filter(Boolean);\n if (patterns.length === 0) return true;\n const fileName = file.name.toLowerCase();\n const type = file.type.toLowerCase();\n return patterns.some((pattern) => {\n if (pattern.startsWith('.')) return fileName.endsWith(pattern);\n if (pattern.endsWith('/*')) return type.startsWith(pattern.slice(0, -1));\n return type === pattern;\n });\n}\n"],
5
- "mappings": ";AAmKI,SA4BM,UA5BN,KA4BM,YA5BN;AAjKJ;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AACP,SAAS,kBAAkB;AAC3B,SAAS,YAAY;AACrB,SAAS,sBAAsB;AAC/B,SAAS,YAAY;AACrB,SAAS,qBAAqB;AAC9B,SAAS,iBAAiB;AAC1B,SAAS,cAAc;AACvB,SAAS,eAAe;AACxB,SAAS,uBAAuB;AAChC,YAAY,WAAW;AACvB,SAAS,oBAAoB;AAC7B,SAAS,YAAY;AACrB,OAAO;AACP,OAAO;AA6DP,MAAM,kBAAkB;AAExB,SAAS,wBAAwB,OAAkB;AACjD,QAAM,eAAe;AACvB;AAEA,SAAS,aAAa,OAAkB;AACtC,SAAO,MAAM,KAAK,MAAM,aAAa,KAAK,EAAE,SAAS,OAAO;AAC9D;AAGO,SAAS,SAAS;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX,UAAU;AAAA,EACV;AAAA,EACA,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAkB;AAChB,QAAM,KAAK,MAAM;AACjB,QAAM,aAAa,OAAyB,IAAI;AAChD,QAAM,sBAAsB,OAAyB,IAAI;AACzD,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,KAAK;AAC9C,QAAM,2BAA2B,OAAO,CAAC;AACzC,QAAM,YAAY,CAAC,YAAY,CAAC;AAEhC,WAAS,eAAe,MAAuB;AAC7C,UAAM,UAAU,oBAAoB;AACpC,QAAI,CAAC,WAAW,OAAO,iBAAiB,WAAY;AACpD,UAAM,WAAW,IAAI,aAAa;AAClC,SAAK,QAAQ,CAAC,SAAS,SAAS,MAAM,IAAI,IAAI,CAAC;AAC/C,YAAQ,QAAQ,SAAS;AAAA,EAC3B;AAEA,kBAAgB,MAAM;AACpB,QAAI,UAAU,OAAW,gBAAe,KAAK;AAAA,EAC/C,GAAG,CAAC,OAAO,IAAI,CAAC;AAEhB;AAAA,IACE;AAAA,IACA,SAAS,0BAA0B;AACjC,UAAI,UAAU,OAAW,gBAAe,KAAK;AAAA,IAC/C;AAAA,IACA;AAAA,EACF;AAEA,WAAS,KAAK,QAAgB;AAC5B,UAAM,WAAW,OAAO,OAAO,CAAC,SAAS,oBAAoB,MAAM,MAAM,CAAC;AAC1E,UAAM,QAAQ,WAAW,WAAW,SAAS,MAAM,GAAG,CAAC;AACvD,UAAM,WAAW,OAAO,OAAO,CAAC,SAAS,CAAC,MAAM,SAAS,IAAI,CAAC;AAC9D,UAAM,wBAAwB,UAAU;AACxC,QAAI,MAAM,SAAS,KAAK,CAAC,sBAAuB,gBAAe,KAAK;AACpE,QAAI,SAAS,SAAS,EAAG,mBAAkB,QAAQ;AACnD,QAAI,MAAM,SAAS,EAAG,iBAAgB,KAAK;AAAA,EAC7C;AAEA,WAAS,UAAU;AACjB,6BAAyB,UAAU;AACnC,gBAAY,KAAK;AAAA,EACnB;AAEA,QAAM,iBAAiB,CAAC,GAAG,EAAE,UAAU,eAAe,QAAQ,GAAG,EAAE,cAAc,EAC9E,OAAO,OAAO,EACd,KAAK,GAAG;AAEX,QAAM,SACJ;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,MACA,mBAAiB;AAAA,MACjB,oBAAkB,SAAS,OAAO,GAAG,EAAE,WAAW;AAAA,MAClD,SAAS,MAAM;AACb,YAAI,UAAW,YAAW,SAAS,MAAM;AAAA,MAC3C;AAAA;AAAA,EACF;AAEF,QAAM,gBACJ,iCACE;AAAA,wBAAC,UAAK,WAAU,sBACb,oBACC,oBAAC,WAAQ,MAAM,SAAS,OAAO,OAAO,MAAM,IAE5C,oBAAC,QAAK,WAAU,8BAA6B,SAAQ,QAAO,QAAO,OAAM,QAAO,SAC9E,8BAAC,kBAAgB,kBAAQ,oBAAC,mBAAgB,GAAG,GAC/C,GAEJ;AAAA,IACA,qBAAC,QAAK,QAAQ,oBAAC,UAAK,GAAI,KAAK,SAAS,OAAO,IAAI,GAAG,WAAU,sBAC5D;AAAA,0BAAC,UAAK,WAAU,uBAAsB,IAAI,GAAG,EAAE,UAC7C,8BAAC,QAAK,WAAU,+BAA8B,SAAQ,QACnD,iBACH,GACF;AAAA,MACC,eAAe,QACd,iCACG;AAAA;AAAA,QACD,oBAAC,UAAK,WAAU,6BAA4B,IAAI,GAAG,EAAE,gBACnD,8BAAC,QAAK,WAAU,qCAAoC,SAAQ,QACzD,uBACH,GACF;AAAA,SACF;AAAA,OAEJ;AAAA,KACF;AAEF,SACE;AAAA,IAAC,MAAM;AAAA,IAAN;AAAA,MACE,GAAG;AAAA,MACJ,SAAS,SAAS,QAAQ;AAAA,MAC1B,WAAW,WAAW,iBAAiB,SAAS;AAAA,MAChD,aAAW;AAAA,MACX,kBAAgB,KAAK,QAAQ;AAAA,MAC7B,gBAAc,KAAK,OAAO;AAAA,MAC1B,gBAAc,KAAK,SAAS,IAAI;AAAA,MAChC,aAAa,CAAC,UAAU;AACtB,YAAI,CAAC,aAAa,KAAK,EAAG;AAC1B,cAAM,eAAe;AACrB,iCAAyB,WAAW;AACpC,YAAI,UAAW,aAAY,IAAI;AAAA,MACjC;AAAA,MACA,YAAY,CAAC,UAAU;AACrB,YAAI,CAAC,aAAa,KAAK,EAAG;AAC1B,gCAAwB,KAAK;AAC7B,cAAM,aAAa,aAAa,YAAY,SAAS;AAAA,MACvD;AAAA,MACA,aAAa,CAAC,UAAU;AACtB,YAAI,CAAC,aAAa,KAAK,EAAG;AAC1B,iCAAyB,UAAU,KAAK,IAAI,GAAG,yBAAyB,UAAU,CAAC;AACnF,YAAI,yBAAyB,YAAY,EAAG,aAAY,KAAK;AAAA,MAC/D;AAAA,MACA,QAAQ,CAAC,UAAU;AACjB,YAAI,CAAC,aAAa,KAAK,EAAG;AAC1B,cAAM,eAAe;AACrB,gBAAQ;AACR,YAAI,UAAW,MAAK,MAAM,KAAK,MAAM,aAAa,KAAK,CAAC;AAAA,MAC1D;AAAA,MAEA;AAAA,4BAAC,QAAK,KAAK,GAAG,WAAU,wBAAuB,QAAQ,QACpD,yBACH;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC,KAAK,CAAC,SAAS;AACb,yBAAW,UAAU;AACrB,qBAAO,UAAU,IAAI;AAAA,YACvB;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,YACA,SAAS,CAAC,WAAW;AACnB,kBAAI,UAAW,MAAK,MAAM;AAAA,YAC5B;AAAA;AAAA,QACF;AAAA,QACC,OACC;AAAA,UAAC;AAAA;AAAA,YACC,KAAK;AAAA,YACL;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA;AAAA,QACF,IACE;AAAA,QACH,SAAS,QAAQ,oBAAC,MAAM,OAAN,EAAY,IAAI,GAAG,EAAE,UAAW,iBAAM;AAAA;AAAA;AAAA,EAC3D;AAEJ;AAEA,SAAS,oBAAoB,MAAY,QAA4B;AACnE,QAAM,YAAY,UAAU,IACzB,MAAM,GAAG,EACT,IAAI,CAAC,YAAY,QAAQ,KAAK,EAAE,YAAY,CAAC,EAC7C,OAAO,OAAO;AACjB,MAAI,SAAS,WAAW,EAAG,QAAO;AAClC,QAAM,WAAW,KAAK,KAAK,YAAY;AACvC,QAAM,OAAO,KAAK,KAAK,YAAY;AACnC,SAAO,SAAS,KAAK,CAAC,YAAY;AAChC,QAAI,QAAQ,WAAW,GAAG,EAAG,QAAO,SAAS,SAAS,OAAO;AAC7D,QAAI,QAAQ,SAAS,IAAI,EAAG,QAAO,KAAK,WAAW,QAAQ,MAAM,GAAG,EAAE,CAAC;AACvE,WAAO,SAAS;AAAA,EAClB,CAAC;AACH;",
4
+ "sourcesContent": ["'use client';\n\nimport {\n useId,\n useLayoutEffect,\n useRef,\n useState,\n type ComponentPropsWithRef,\n type DragEvent,\n type ReactElement,\n type ReactNode,\n type Ref,\n} from 'react';\nimport { classNames } from '../internal/classNames.js';\nimport { Grid } from '../layout/Layout.js';\nimport { DecorativeIcon } from '../internal/icon/DecorativeIcon.js';\nimport { Slot } from '../internal/layout/Slot.js';\nimport { ActionElement } from '../internal/control/ActionElement.js';\nimport { FileInput } from './internal/FileInput.js';\nimport { mergeRefs } from '../internal/react/setRef.js';\nimport { Spinner } from '../feedback/Spinner.js';\nimport { VisuallyHidden } from '../content/VisuallyHidden.js';\nimport { IconCloudUpload } from '../icons/CloudUpload.js';\nimport * as Field from './Field.js';\nimport { useFormReset } from '../internal/field/useFormReset.js';\nimport { fieldDescribedBy, fieldPartIds } from '../internal/field/useFieldControl.js';\nimport { flag } from '../internal/flag.js';\nimport { idRefs } from '../internal/dom/idRefs.js';\nimport '../styles/Base.css';\nimport '../styles/DropZone.css';\n\nexport interface DropZoneProps extends Omit<\n ComponentPropsWithRef<'div'>,\n 'onDragEnter' | 'onDragOver' | 'onDragLeave' | 'onDrop'\n> {\n /**\n * What to drop or choose, such as \"Drop a logo here, or browse\". With the description, it names\n * the zone, as its visible text does; without the target, only assistive technology reads it.\n */\n label: ReactNode;\n /** Which files fit, such as \"PNG, JPG or WebP up to 2 MB\"; it is read as part of the name. */\n description?: ReactNode;\n /** Replaces the upload icon. */\n icon?: ReactNode;\n /**\n * Content inside the zone, under its target, such as the chosen files with their previews and\n * Remove buttons, or a Browse button that opens the file picker through inputRef. Files dropped on\n * it are taken too; it can hold controls, since it is beside the target button, not inside it.\n */\n children?: ReactNode;\n /**\n * The file types the zone takes, as in the native accept attribute: MIME types such as image/png,\n * groups such as image/*, and extensions such as .webp.\n * @default any file\n */\n accept?: string;\n /** Take several files at once; otherwise the zone takes the first file. */\n multiple?: boolean;\n /** Receives the dropped or chosen files that the zone takes. */\n onFilesAccepted: (files: File[]) => void;\n /** Receives the files that do not match accept, and those after the first without multiple. */\n onFilesRejected?: (files: File[]) => void;\n /** The zone can't be pressed or focused and takes no files; it still keeps the browser from opening dropped files. */\n disabled?: boolean;\n /**\n * The application is working on the files: a spinner replaces the icon, the zone reports that it\n * is busy and takes no new files.\n */\n pending?: boolean;\n /** A message linked to the zone, whose outline takes the error color. */\n error?: ReactNode;\n /**\n * md is the tall area with a large icon; sm is one row with a small icon, for a form or a\n * sidebar.\n * @default 'md'\n */\n size?: 'sm' | 'md';\n /**\n * Submits files with a native form under this name: the last files the zone took, until the form\n * resets, or files.\n */\n name?: string;\n /**\n * The files a named zone submits when the application keeps them, such as after a Remove action;\n * they replace the files the zone took, also after the form resets.\n */\n files?: readonly File[];\n /** The id of a form the zone belongs to when it is outside of it. */\n form?: string;\n /**\n * The native file input that opens the file picker, for example from a Replace button; ref\n * reaches the zone itself.\n */\n inputRef?: Ref<HTMLInputElement>;\n /**\n * Show the target: the button with the icon, the label and the description that opens the file\n * picker. Without it, the zone is a group the label names, for content that has its own Browse\n * button, which opens the picker through inputRef, such as a table the files land in.\n * @default true\n */\n target?: boolean;\n /**\n * Another element to render the zone as, such as the application's own panel or table region,\n * which then takes dropped files: the zone's class, its state attributes, such as\n * data-drag-over, and its handlers merge into its props.\n */\n render?: ReactElement;\n}\n\nconst spaceReadInName = ' ';\n\nfunction takeOverDropFromBrowser(event: DragEvent) {\n event.preventDefault();\n}\n\nfunction carriesFiles(event: DragEvent) {\n return Array.from(event.dataTransfer.types).includes('Files');\n}\n\n/** A drop target for files that also opens the file picker; the application shows what was chosen. */\nexport function DropZone({\n label,\n description,\n icon,\n accept,\n multiple = false,\n onFilesAccepted,\n onFilesRejected,\n disabled = false,\n pending = false,\n error,\n size = 'md',\n name,\n files,\n form,\n inputRef,\n target: showsTarget = true,\n render,\n className,\n children,\n ...props\n}: DropZoneProps) {\n const id = useId();\n const filePicker = useRef<HTMLInputElement>(null);\n const submittedFilesInput = useRef<HTMLInputElement>(null);\n const [dragging, setDragging] = useState(false);\n const elementsEnteredUnderDrag = useRef(0);\n const available = !disabled && !pending;\n\n function submitWithForm(next: readonly File[]) {\n const element = submittedFilesInput.current;\n if (!element || typeof DataTransfer !== 'function') return;\n const transfer = new DataTransfer();\n next.forEach((file) => transfer.items.add(file));\n element.files = transfer.files;\n }\n\n useLayoutEffect(() => {\n if (files !== undefined) submitWithForm(files);\n }, [files, name]);\n\n useFormReset(\n submittedFilesInput,\n function keepFilesAfterFormReset() {\n if (files !== undefined) submitWithForm(files);\n },\n form,\n );\n\n function take(chosen: File[]) {\n const matching = chosen.filter((file) => matchesNativeAccept(file, accept));\n const taken = multiple ? matching : matching.slice(0, 1);\n const rejected = chosen.filter((file) => !taken.includes(file));\n const applicationKeepsFiles = files !== undefined;\n if (taken.length > 0 && !applicationKeepsFiles) submitWithForm(taken);\n if (rejected.length > 0) onFilesRejected?.(rejected);\n if (taken.length > 0) onFilesAccepted(taken);\n }\n\n function endDrag() {\n elementsEnteredUnderDrag.current = 0;\n setDragging(false);\n }\n\n const ids = fieldPartIds(id);\n const visibleTextIds = idRefs(ids.label, description != null && ids.description);\n\n const target = (\n <ActionElement\n disabled={disabled}\n pending={pending}\n aria-labelledby={visibleTextIds}\n aria-describedby={error != null ? ids.error : undefined}\n onClick={() => {\n if (available) filePicker.current?.click();\n }}\n />\n );\n const targetContent = (\n <>\n <span className=\"env-drop-zone-icon\">\n {pending ? (\n <Spinner size={size === 'sm' ? 'sm' : 'md'} />\n ) : (\n <Slot className=\"env-drop-zone-icon-content\" element=\"span\" layout=\"row\" shrink=\"never\">\n <DecorativeIcon>{icon ?? <IconCloudUpload />}</DecorativeIcon>\n </Slot>\n )}\n </span>\n <Grid render={<span />} gap={size === 'sm' ? 0 : 1} className=\"env-drop-zone-text\">\n <span className=\"env-drop-zone-label\" id={ids.label}>\n <Slot className=\"env-drop-zone-label-content\" element=\"span\">\n {label}\n </Slot>\n </span>\n {description != null && (\n <>\n {spaceReadInName}\n <span className=\"env-drop-zone-description\" id={ids.description}>\n <Slot className=\"env-drop-zone-description-content\" element=\"span\">\n {description}\n </Slot>\n </span>\n </>\n )}\n </Grid>\n </>\n );\n const group = showsTarget\n ? {}\n : {\n role: 'group',\n 'aria-labelledby': ids.label,\n 'aria-describedby': fieldDescribedBy(id, undefined, description, error),\n };\n return (\n <Field.Root\n {...group}\n {...props}\n render={<Grid gap={3} render={render} />}\n invalid={error != null || undefined}\n className={classNames('env-drop-zone', className)}\n data-size={size}\n data-drag-over={flag(dragging)}\n data-pending={flag(pending)}\n data-invalid={flag(error != null)}\n onDragEnter={(event) => {\n if (!carriesFiles(event)) return;\n event.preventDefault();\n elementsEnteredUnderDrag.current += 1;\n if (available) setDragging(true);\n }}\n onDragOver={(event) => {\n if (!carriesFiles(event)) return;\n takeOverDropFromBrowser(event);\n event.dataTransfer.dropEffect = available ? 'copy' : 'none';\n }}\n onDragLeave={(event) => {\n if (!carriesFiles(event)) return;\n elementsEnteredUnderDrag.current = Math.max(0, elementsEnteredUnderDrag.current - 1);\n if (elementsEnteredUnderDrag.current === 0) setDragging(false);\n }}\n onDrop={(event) => {\n if (!carriesFiles(event)) return;\n event.preventDefault();\n endDrag();\n if (available) take(Array.from(event.dataTransfer.files));\n }}\n >\n {showsTarget ? (\n <Grid gap={3} className=\"env-drop-zone-target\" render={target}>\n {targetContent}\n </Grid>\n ) : (\n <VisuallyHidden>\n <span id={ids.label}>{label}</span>\n {description != null && (\n <>\n {spaceReadInName}\n <span id={ids.description}>{description}</span>\n </>\n )}\n </VisuallyHidden>\n )}\n {children != null && <Slot className=\"env-drop-zone-content\">{children}</Slot>}\n <FileInput\n ref={mergeRefs(filePicker, inputRef)}\n accept={accept}\n multiple={multiple}\n disabled={disabled}\n onFiles={(chosen) => {\n if (available) take(chosen);\n }}\n />\n {name ? (\n <FileInput\n ref={submittedFilesInput}\n multiple={multiple}\n name={name}\n form={form}\n disabled={disabled}\n />\n ) : null}\n {error != null && <Field.Error id={ids.error}>{error}</Field.Error>}\n </Field.Root>\n );\n}\n\nfunction matchesNativeAccept(file: File, accept: string | undefined) {\n const patterns = (accept ?? '')\n .split(',')\n .map((pattern) => pattern.trim().toLowerCase())\n .filter(Boolean);\n if (patterns.length === 0) return true;\n const fileName = file.name.toLowerCase();\n const type = file.type.toLowerCase();\n return patterns.some((pattern) => {\n if (pattern.startsWith('.')) return fileName.endsWith(pattern);\n if (pattern.endsWith('/*')) return type.startsWith(pattern.slice(0, -1));\n return type === pattern;\n });\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -39,6 +39,12 @@ export type ErrorProps = Omit<ComponentProps<typeof BaseField.Error>, 'className
39
39
  * How to correct the value. Without children, the browser's validation message shows.
40
40
  */
41
41
  children?: ReactNode;
42
+ /**
43
+ * The icon before the message, decorative, so hide an icon of your own from assistive technology,
44
+ * or null for none, such as for a compact error beside a control.
45
+ * @default the error icon
46
+ */
47
+ icon?: ReactNode;
42
48
  };
43
49
  /**
44
50
  * A message under the control that says how to correct the value, with an error icon. It shows
@@ -46,7 +52,7 @@ export type ErrorProps = Omit<ComponentProps<typeof BaseField.Error>, 'className
46
52
  * to the control; match="valueMissing" and the like show it for one kind of failure, and
47
53
  * match={true} always.
48
54
  */
49
- declare function FieldError({ className, children, match, ...props }: ErrorProps): import("react").JSX.Element;
55
+ declare function FieldError({ className, children, match, icon, render, ...props }: ErrorProps): import("react").JSX.Element;
50
56
  declare const RootPart: typeof Root & {
51
57
  displayName: string;
52
58
  };
@@ -1,11 +1,12 @@
1
1
  "use client";
2
- import { jsx, jsxs } from "react/jsx-runtime";
2
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
3
3
  import { Field as BaseField } from "@base-ui/react/field";
4
4
  import { createContext, useContext } from "react";
5
5
  import { IconError } from "../icons/Error.js";
6
6
  import { classNames } from "../internal/classNames.js";
7
7
  import { Grid, Row } from "../layout/Layout.js";
8
8
  import { withDisplayName } from "../internal/react/withDisplayName.js";
9
+ import { renderElement } from "../internal/react/renderElement.js";
9
10
  import "#styles/Base.css";
10
11
  import "#styles/Field.css";
11
12
  const RootGivenInvalidContext = createContext(false);
@@ -37,7 +38,7 @@ function Control({ className, size, ...props }) {
37
38
  function Description({ className, ...props }) {
38
39
  return /* @__PURE__ */ jsx(BaseField.Description, { ...props, className: classNames("env-field-description", className) });
39
40
  }
40
- function FieldError({ className, children, match, ...props }) {
41
+ function FieldError({ className, children, match, icon, render, ...props }) {
41
42
  const invalid = useContext(RootGivenInvalidContext);
42
43
  return /* @__PURE__ */ jsx(
43
44
  BaseField.Error,
@@ -46,10 +47,16 @@ function FieldError({ className, children, match, ...props }) {
46
47
  match: match ?? (invalid || void 0),
47
48
  ...children != null && { children },
48
49
  className: classNames("env-field-error", className),
49
- render: ({ children: message, ...errorProps }) => /* @__PURE__ */ jsxs(Row, { align: "start", gap: 2, ...errorProps, children: [
50
- /* @__PURE__ */ jsx(IconError, { "aria-hidden": "true", focusable: "false" }),
51
- /* @__PURE__ */ jsx("span", { children: message })
52
- ] })
50
+ render: ({ children: message, ...errorProps }, state) => {
51
+ const content = /* @__PURE__ */ jsxs(Fragment, { children: [
52
+ icon === void 0 ? /* @__PURE__ */ jsx(IconError, { "aria-hidden": "true", focusable: "false" }) : icon,
53
+ /* @__PURE__ */ jsx("span", { children: message })
54
+ ] });
55
+ if (typeof render === "function")
56
+ return render({ ...errorProps, children: content }, state);
57
+ if (render) return renderElement("div", render, { ...errorProps, children: content });
58
+ return /* @__PURE__ */ jsx(Row, { align: "start", gap: 2, ...errorProps, children: content });
59
+ }
53
60
  }
54
61
  );
55
62
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/forms/Field.tsx"],
4
- "sourcesContent": ["'use client';\n\nimport { Field as BaseField } from '@base-ui/react/field';\nimport { createContext, useContext, type ComponentProps, type ReactNode } from 'react';\nimport { IconError } from '../icons/Error.js';\nimport { classNames } from '../internal/classNames.js';\nimport { Grid, Row } from '../layout/Layout.js';\nimport { withDisplayName } from '../internal/react/withDisplayName.js';\nimport type { ControlSize } from '../foundations/Theme.js';\nimport '../styles/Base.css';\nimport '../styles/Field.css';\n\ntype ClassName = {\n /** The part's class, beside its own env-field class. */\n className?: string;\n};\n\nconst RootGivenInvalidContext = createContext(false);\n\nexport type RootProps = Omit<ComponentProps<typeof BaseField.Root>, 'className'> & ClassName;\n\n/**\n * A labelled form control with its description and error, for a control envUI has no field for,\n * such as a control of the application's own: Field.Label names Field.Control, and the\n * description and the error describe it.\n */\nfunction Root({ className, invalid, children, ...props }: RootProps) {\n return (\n <BaseField.Root\n render={<Grid gap={3} />}\n {...props}\n invalid={invalid}\n className={classNames('env-field', className)}\n >\n <RootGivenInvalidContext value={invalid === true}>{children}</RootGivenInvalidContext>\n </BaseField.Root>\n );\n}\n\nexport type LabelProps = Omit<ComponentProps<typeof BaseField.Label>, 'className'> & ClassName;\n\n/** The field's visible name; it names the control for assistive technology. */\nfunction Label({ className, ...props }: LabelProps) {\n return <BaseField.Label {...props} className={classNames('env-field-label', className)} />;\n}\n\nexport type ControlProps = Omit<ComponentProps<typeof BaseField.Control>, 'className' | 'size'> &\n ClassName & {\n /**\n * The height, as on every control: sm, md or lg in the current scale. Without it, the control\n * height of the container.\n */\n size?: ControlSize;\n };\n\n/**\n * The control: a native text input in the outlined field look by default, or any control through\n * render, such as render={<MyControl />}, which receives the control's props, id and ref. A custom\n * control styles itself; the class env-field-control gives it the field's outline.\n */\nfunction Control({ className, size, ...props }: ControlProps) {\n return (\n <BaseField.Control\n {...props}\n className={classNames('env-field-control', className)}\n data-size={size}\n />\n );\n}\n\nexport type DescriptionProps = Omit<ComponentProps<typeof BaseField.Description>, 'className'> &\n ClassName;\n\n/**\n * Lasting guidance under the control, such as a format or a limit, linked to the control as its\n * description.\n */\nfunction Description({ className, ...props }: DescriptionProps) {\n return (\n <BaseField.Description {...props} className={classNames('env-field-description', className)} />\n );\n}\n\nexport type ErrorProps = Omit<ComponentProps<typeof BaseField.Error>, 'className' | 'children'> &\n ClassName & {\n /**\n * How to correct the value. Without children, the browser's validation message shows.\n */\n children?: ReactNode;\n };\n\n/**\n * A message under the control that says how to correct the value, with an error icon. It shows\n * while the field is invalid, from its own validation or from invalid on Field.Root, and is linked\n * to the control; match=\"valueMissing\" and the like show it for one kind of failure, and\n * match={true} always.\n */\nfunction FieldError({ className, children, match, ...props }: ErrorProps) {\n const invalid = useContext(RootGivenInvalidContext);\n return (\n <BaseField.Error\n {...props}\n match={match ?? (invalid || undefined)}\n {...(children != null && { children })}\n className={classNames('env-field-error', className)}\n render={({ children: message, ...errorProps }) => (\n <Row align=\"start\" gap={2} {...errorProps}>\n <IconError aria-hidden=\"true\" focusable=\"false\" />\n <span>{message}</span>\n </Row>\n )}\n />\n );\n}\n\nconst RootPart = /* @__PURE__ */ withDisplayName(Root, 'Field.Root');\nconst LabelPart = /* @__PURE__ */ withDisplayName(Label, 'Field.Label');\nconst ControlPart = /* @__PURE__ */ withDisplayName(Control, 'Field.Control');\nconst DescriptionPart = /* @__PURE__ */ withDisplayName(Description, 'Field.Description');\nconst ErrorPart = /* @__PURE__ */ withDisplayName(FieldError, 'Field.Error');\nexport {\n RootPart as Root,\n LabelPart as Label,\n ControlPart as Control,\n DescriptionPart as Description,\n ErrorPart as Error,\n};\n"],
5
- "mappings": ";AA6Bc,cA6EN,YA7EM;AA3Bd,SAAS,SAAS,iBAAiB;AACnC,SAAS,eAAe,kBAAuD;AAC/E,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAC3B,SAAS,MAAM,WAAW;AAC1B,SAAS,uBAAuB;AAEhC,OAAO;AACP,OAAO;AAOP,MAAM,0BAA0B,cAAc,KAAK;AASnD,SAAS,KAAK,EAAE,WAAW,SAAS,UAAU,GAAG,MAAM,GAAc;AACnE,SACE;AAAA,IAAC,UAAU;AAAA,IAAV;AAAA,MACC,QAAQ,oBAAC,QAAK,KAAK,GAAG;AAAA,MACrB,GAAG;AAAA,MACJ;AAAA,MACA,WAAW,WAAW,aAAa,SAAS;AAAA,MAE5C,8BAAC,2BAAwB,OAAO,YAAY,MAAO,UAAS;AAAA;AAAA,EAC9D;AAEJ;AAKA,SAAS,MAAM,EAAE,WAAW,GAAG,MAAM,GAAe;AAClD,SAAO,oBAAC,UAAU,OAAV,EAAiB,GAAG,OAAO,WAAW,WAAW,mBAAmB,SAAS,GAAG;AAC1F;AAgBA,SAAS,QAAQ,EAAE,WAAW,MAAM,GAAG,MAAM,GAAiB;AAC5D,SACE;AAAA,IAAC,UAAU;AAAA,IAAV;AAAA,MACE,GAAG;AAAA,MACJ,WAAW,WAAW,qBAAqB,SAAS;AAAA,MACpD,aAAW;AAAA;AAAA,EACb;AAEJ;AASA,SAAS,YAAY,EAAE,WAAW,GAAG,MAAM,GAAqB;AAC9D,SACE,oBAAC,UAAU,aAAV,EAAuB,GAAG,OAAO,WAAW,WAAW,yBAAyB,SAAS,GAAG;AAEjG;AAgBA,SAAS,WAAW,EAAE,WAAW,UAAU,OAAO,GAAG,MAAM,GAAe;AACxE,QAAM,UAAU,WAAW,uBAAuB;AAClD,SACE;AAAA,IAAC,UAAU;AAAA,IAAV;AAAA,MACE,GAAG;AAAA,MACJ,OAAO,UAAU,WAAW;AAAA,MAC3B,GAAI,YAAY,QAAQ,EAAE,SAAS;AAAA,MACpC,WAAW,WAAW,mBAAmB,SAAS;AAAA,MAClD,QAAQ,CAAC,EAAE,UAAU,SAAS,GAAG,WAAW,MAC1C,qBAAC,OAAI,OAAM,SAAQ,KAAK,GAAI,GAAG,YAC7B;AAAA,4BAAC,aAAU,eAAY,QAAO,WAAU,SAAQ;AAAA,QAChD,oBAAC,UAAM,mBAAQ;AAAA,SACjB;AAAA;AAAA,EAEJ;AAEJ;AAEA,MAAM,WAA2B,gCAAgB,MAAM,YAAY;AACnE,MAAM,YAA4B,gCAAgB,OAAO,aAAa;AACtE,MAAM,cAA8B,gCAAgB,SAAS,eAAe;AAC5E,MAAM,kBAAkC,gCAAgB,aAAa,mBAAmB;AACxF,MAAM,YAA4B,gCAAgB,YAAY,aAAa;",
4
+ "sourcesContent": ["'use client';\n\nimport { Field as BaseField } from '@base-ui/react/field';\nimport { createContext, useContext, type ComponentProps, type ReactNode } from 'react';\nimport { IconError } from '../icons/Error.js';\nimport { classNames } from '../internal/classNames.js';\nimport { Grid, Row } from '../layout/Layout.js';\nimport { withDisplayName } from '../internal/react/withDisplayName.js';\nimport { renderElement } from '../internal/react/renderElement.js';\nimport type { ControlSize } from '../foundations/Theme.js';\nimport '../styles/Base.css';\nimport '../styles/Field.css';\n\ntype ClassName = {\n /** The part's class, beside its own env-field class. */\n className?: string;\n};\n\nconst RootGivenInvalidContext = createContext(false);\n\nexport type RootProps = Omit<ComponentProps<typeof BaseField.Root>, 'className'> & ClassName;\n\n/**\n * A labelled form control with its description and error, for a control envUI has no field for,\n * such as a control of the application's own: Field.Label names Field.Control, and the\n * description and the error describe it.\n */\nfunction Root({ className, invalid, children, ...props }: RootProps) {\n return (\n <BaseField.Root\n render={<Grid gap={3} />}\n {...props}\n invalid={invalid}\n className={classNames('env-field', className)}\n >\n <RootGivenInvalidContext value={invalid === true}>{children}</RootGivenInvalidContext>\n </BaseField.Root>\n );\n}\n\nexport type LabelProps = Omit<ComponentProps<typeof BaseField.Label>, 'className'> & ClassName;\n\n/** The field's visible name; it names the control for assistive technology. */\nfunction Label({ className, ...props }: LabelProps) {\n return <BaseField.Label {...props} className={classNames('env-field-label', className)} />;\n}\n\nexport type ControlProps = Omit<ComponentProps<typeof BaseField.Control>, 'className' | 'size'> &\n ClassName & {\n /**\n * The height, as on every control: sm, md or lg in the current scale. Without it, the control\n * height of the container.\n */\n size?: ControlSize;\n };\n\n/**\n * The control: a native text input in the outlined field look by default, or any control through\n * render, such as render={<MyControl />}, which receives the control's props, id and ref. A custom\n * control styles itself; the class env-field-control gives it the field's outline.\n */\nfunction Control({ className, size, ...props }: ControlProps) {\n return (\n <BaseField.Control\n {...props}\n className={classNames('env-field-control', className)}\n data-size={size}\n />\n );\n}\n\nexport type DescriptionProps = Omit<ComponentProps<typeof BaseField.Description>, 'className'> &\n ClassName;\n\n/**\n * Lasting guidance under the control, such as a format or a limit, linked to the control as its\n * description.\n */\nfunction Description({ className, ...props }: DescriptionProps) {\n return (\n <BaseField.Description {...props} className={classNames('env-field-description', className)} />\n );\n}\n\nexport type ErrorProps = Omit<ComponentProps<typeof BaseField.Error>, 'className' | 'children'> &\n ClassName & {\n /**\n * How to correct the value. Without children, the browser's validation message shows.\n */\n children?: ReactNode;\n /**\n * The icon before the message, decorative, so hide an icon of your own from assistive technology,\n * or null for none, such as for a compact error beside a control.\n * @default the error icon\n */\n icon?: ReactNode;\n };\n\n/**\n * A message under the control that says how to correct the value, with an error icon. It shows\n * while the field is invalid, from its own validation or from invalid on Field.Root, and is linked\n * to the control; match=\"valueMissing\" and the like show it for one kind of failure, and\n * match={true} always.\n */\nfunction FieldError({ className, children, match, icon, render, ...props }: ErrorProps) {\n const invalid = useContext(RootGivenInvalidContext);\n return (\n <BaseField.Error\n {...props}\n match={match ?? (invalid || undefined)}\n {...(children != null && { children })}\n className={classNames('env-field-error', className)}\n render={({ children: message, ...errorProps }, state) => {\n const content = (\n <>\n {icon === undefined ? <IconError aria-hidden=\"true\" focusable=\"false\" /> : icon}\n <span>{message}</span>\n </>\n );\n if (typeof render === 'function')\n return render({ ...errorProps, children: content }, state);\n if (render) return renderElement('div', render, { ...errorProps, children: content });\n return (\n <Row align=\"start\" gap={2} {...errorProps}>\n {content}\n </Row>\n );\n }}\n />\n );\n}\n\nconst RootPart = /* @__PURE__ */ withDisplayName(Root, 'Field.Root');\nconst LabelPart = /* @__PURE__ */ withDisplayName(Label, 'Field.Label');\nconst ControlPart = /* @__PURE__ */ withDisplayName(Control, 'Field.Control');\nconst DescriptionPart = /* @__PURE__ */ withDisplayName(Description, 'Field.Description');\nconst ErrorPart = /* @__PURE__ */ withDisplayName(FieldError, 'Field.Error');\nexport {\n RootPart as Root,\n LabelPart as Label,\n ControlPart as Control,\n DescriptionPart as Description,\n ErrorPart as Error,\n};\n"],
5
+ "mappings": ";AA8Bc,SAoFJ,UApFI,KAoFJ,YApFI;AA5Bd,SAAS,SAAS,iBAAiB;AACnC,SAAS,eAAe,kBAAuD;AAC/E,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAC3B,SAAS,MAAM,WAAW;AAC1B,SAAS,uBAAuB;AAChC,SAAS,qBAAqB;AAE9B,OAAO;AACP,OAAO;AAOP,MAAM,0BAA0B,cAAc,KAAK;AASnD,SAAS,KAAK,EAAE,WAAW,SAAS,UAAU,GAAG,MAAM,GAAc;AACnE,SACE;AAAA,IAAC,UAAU;AAAA,IAAV;AAAA,MACC,QAAQ,oBAAC,QAAK,KAAK,GAAG;AAAA,MACrB,GAAG;AAAA,MACJ;AAAA,MACA,WAAW,WAAW,aAAa,SAAS;AAAA,MAE5C,8BAAC,2BAAwB,OAAO,YAAY,MAAO,UAAS;AAAA;AAAA,EAC9D;AAEJ;AAKA,SAAS,MAAM,EAAE,WAAW,GAAG,MAAM,GAAe;AAClD,SAAO,oBAAC,UAAU,OAAV,EAAiB,GAAG,OAAO,WAAW,WAAW,mBAAmB,SAAS,GAAG;AAC1F;AAgBA,SAAS,QAAQ,EAAE,WAAW,MAAM,GAAG,MAAM,GAAiB;AAC5D,SACE;AAAA,IAAC,UAAU;AAAA,IAAV;AAAA,MACE,GAAG;AAAA,MACJ,WAAW,WAAW,qBAAqB,SAAS;AAAA,MACpD,aAAW;AAAA;AAAA,EACb;AAEJ;AASA,SAAS,YAAY,EAAE,WAAW,GAAG,MAAM,GAAqB;AAC9D,SACE,oBAAC,UAAU,aAAV,EAAuB,GAAG,OAAO,WAAW,WAAW,yBAAyB,SAAS,GAAG;AAEjG;AAsBA,SAAS,WAAW,EAAE,WAAW,UAAU,OAAO,MAAM,QAAQ,GAAG,MAAM,GAAe;AACtF,QAAM,UAAU,WAAW,uBAAuB;AAClD,SACE;AAAA,IAAC,UAAU;AAAA,IAAV;AAAA,MACE,GAAG;AAAA,MACJ,OAAO,UAAU,WAAW;AAAA,MAC3B,GAAI,YAAY,QAAQ,EAAE,SAAS;AAAA,MACpC,WAAW,WAAW,mBAAmB,SAAS;AAAA,MAClD,QAAQ,CAAC,EAAE,UAAU,SAAS,GAAG,WAAW,GAAG,UAAU;AACvD,cAAM,UACJ,iCACG;AAAA,mBAAS,SAAY,oBAAC,aAAU,eAAY,QAAO,WAAU,SAAQ,IAAK;AAAA,UAC3E,oBAAC,UAAM,mBAAQ;AAAA,WACjB;AAEF,YAAI,OAAO,WAAW;AACpB,iBAAO,OAAO,EAAE,GAAG,YAAY,UAAU,QAAQ,GAAG,KAAK;AAC3D,YAAI,OAAQ,QAAO,cAAc,OAAO,QAAQ,EAAE,GAAG,YAAY,UAAU,QAAQ,CAAC;AACpF,eACE,oBAAC,OAAI,OAAM,SAAQ,KAAK,GAAI,GAAG,YAC5B,mBACH;AAAA,MAEJ;AAAA;AAAA,EACF;AAEJ;AAEA,MAAM,WAA2B,gCAAgB,MAAM,YAAY;AACnE,MAAM,YAA4B,gCAAgB,OAAO,aAAa;AACtE,MAAM,cAA8B,gCAAgB,SAAS,eAAe;AAC5E,MAAM,kBAAkC,gCAAgB,aAAa,mBAAmB;AACxF,MAAM,YAA4B,gCAAgB,YAAY,aAAa;",
6
6
  "names": []
7
7
  }
@@ -1,5 +1,12 @@
1
1
  import { type PickerFieldProps } from './internal/PickerField.js';
2
+ import { type PickerOpenChangeDetails, type PickerOpenChangeReason } from './internal/usePicker.js';
3
+ /** Why a month picker's popup asks to open or close: a picker's reasons. */
4
+ export type MonthPickerOpenChangeReason = PickerOpenChangeReason;
5
+ /** What a month picker's onOpenChange receives beside the requested state: a picker's details. */
6
+ export type MonthPickerOpenChangeDetails = PickerOpenChangeDetails;
2
7
  export interface MonthPickerProps extends PickerFieldProps {
8
+ /** Called with the new state, and why, when the popup opens or closes. */
9
+ onOpenChange?: (open: boolean, details: MonthPickerOpenChangeDetails) => void;
3
10
  /** The value: a month as YYYY-MM. null, or an empty string, for none. */
4
11
  value?: string | null;
5
12
  /** The value an uncontrolled field starts with, and that a form reset restores; none by default. */
@@ -45,4 +52,4 @@ export interface MonthPickerProps extends PickerFieldProps {
45
52
  * A field for a month of a year that shows the value in the reader's locale and opens a year of
46
53
  * months to choose it from, with keyboard access like Calendar's.
47
54
  */
48
- export declare function MonthPicker({ value, defaultValue, onValueChange, min, max, locale, formatOptions, disabled, readOnly, clearable, open: controlledOpen, defaultOpen, onOpenChange, clearLabel, thisMonthLabel, previousYearLabel, nextYearLabel, ...fieldProps }: MonthPickerProps): import("react").JSX.Element;
55
+ export declare function MonthPicker({ value, defaultValue, onValueChange, min, max, locale, formatOptions, open, defaultOpen, onOpenChange, clearLabel, thisMonthLabel, previousYearLabel, nextYearLabel, ...fieldProps }: MonthPickerProps): import("react").JSX.Element;
@@ -2,20 +2,23 @@
2
2
  import { jsx } from "react/jsx-runtime";
3
3
  import { useMessages } from "../internal/provider/EnvUIContext.js";
4
4
  import { monthPicker as monthPickerMessages } from "../foundations/messages/monthPicker.js";
5
- import { Button } from "../actions/Button.js";
6
5
  import { IconCalendarMonth } from "../icons/CalendarMonth.js";
7
- import { MonthGrid, monthGridActive } from "./internal/MonthGrid.js";
8
- import { PickerField, usePickerOpen } from "./internal/PickerField.js";
9
- import { usePickerFormatter, usePickerValue } from "./internal/usePickerValue.js";
6
+ import { MonthGrid, monthGridInitialFocus } from "./internal/MonthGrid.js";
7
+ import { PickerField } from "./internal/PickerField.js";
8
+ import {
9
+ usePicker
10
+ } from "./internal/usePicker.js";
11
+ import { usePickerFormatter } from "./internal/usePickerFormatter.js";
10
12
  import {
11
13
  clampMonth,
12
14
  formatMonth,
15
+ inBounds,
13
16
  monthFirstDay,
14
17
  monthOfDay,
15
18
  now,
16
19
  parseMonth,
17
20
  toUtcDate
18
- } from "../internal/time/calendarDays.js";
21
+ } from "./internal/calendarDays.js";
19
22
  import "#styles/Base.css";
20
23
  import "#styles/DatePicker.css";
21
24
  function MonthPicker({
@@ -26,11 +29,8 @@ function MonthPicker({
26
29
  max,
27
30
  locale,
28
31
  formatOptions,
29
- disabled = false,
30
- readOnly = false,
31
- clearable = false,
32
- open: controlledOpen,
33
- defaultOpen = false,
32
+ open,
33
+ defaultOpen,
34
34
  onOpenChange,
35
35
  clearLabel,
36
36
  thisMonthLabel,
@@ -39,15 +39,8 @@ function MonthPicker({
39
39
  ...fieldProps
40
40
  }) {
41
41
  const messages = useMessages("monthPicker", monthPickerMessages);
42
- const [open, setOpen] = usePickerOpen({
43
- open: controlledOpen,
44
- defaultOpen,
45
- onOpenChange,
46
- disabled,
47
- readOnly
48
- });
49
- const picked = usePickerValue({ value, defaultValue, onValueChange });
50
- const current = parseMonth(picked.raw);
42
+ const picker = usePicker({ value, defaultValue, onValueChange, open, defaultOpen, onOpenChange });
43
+ const current = parseMonth(picker.raw);
51
44
  const serialized = current === void 0 ? "" : formatMonth(current);
52
45
  const minMonth = parseMonth(min);
53
46
  const maxMonth = parseMonth(max);
@@ -58,44 +51,31 @@ function MonthPicker({
58
51
  const display = current === void 0 ? "" : formatter.format(toUtcDate(monthFirstDay(current)));
59
52
  function commit(next) {
60
53
  const result = next === null ? null : formatMonth(clampMonth(next, minMonth, maxMonth));
61
- picked.change(result, serialized);
54
+ picker.change(result, serialized);
62
55
  }
63
56
  function choose(month) {
64
57
  commit(month);
65
- setOpen(false, month === null ? "clear-press" : "item-press");
58
+ picker.setOpen(false, month === null ? "clear-press" : "item-press");
66
59
  }
67
60
  const thisMonth = monthOfDay(now().day);
68
- const thisMonthAvailable = (minMonth === void 0 || thisMonth >= minMonth) && (maxMonth === void 0 || thisMonth <= maxMonth);
61
+ const thisMonthAvailable = inBounds(thisMonth, minMonth, maxMonth);
69
62
  return /* @__PURE__ */ jsx(
70
63
  PickerField,
71
64
  {
72
65
  ...fieldProps,
66
+ picker,
73
67
  serialized,
74
68
  display,
75
69
  icon: /* @__PURE__ */ jsx(IconCalendarMonth, {}),
76
70
  rootClassName: "env-date-picker env-month-picker",
77
71
  popupClassName: "env-month-picker-popup",
78
- initialFocus: monthGridActive,
79
- popupStart: /* @__PURE__ */ jsx(
80
- Button,
81
- {
82
- variant: "text",
83
- "aria-disabled": !thisMonthAvailable || void 0,
84
- onClick: () => {
85
- if (thisMonthAvailable) choose(thisMonth);
86
- },
87
- children: thisMonthLabel ?? messages.thisMonth
88
- }
89
- ),
90
- popupEnd: clearable && serialized && /* @__PURE__ */ jsx(Button, { variant: "text", onClick: () => choose(null), children: clearLabel ?? messages.clear }),
72
+ initialFocus: monthGridInitialFocus,
73
+ shortcut: {
74
+ label: thisMonthLabel ?? messages.thisMonth,
75
+ available: thisMonthAvailable,
76
+ onPress: () => choose(thisMonth)
77
+ },
91
78
  clearLabel: clearLabel ?? messages.clear,
92
- onClear: () => commit(null),
93
- onFormReset: picked.reset,
94
- open,
95
- setOpen,
96
- disabled,
97
- readOnly,
98
- clearable,
99
79
  children: /* @__PURE__ */ jsx(
100
80
  MonthGrid,
101
81
  {