@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
@@ -0,0 +1,23 @@
1
+ "use client";
2
+ import { useMemo } from "react";
3
+ import { dateFormat, withHourCycle } from "./calendarDays.js";
4
+ import { useResolvedLocale } from "../../internal/provider/locale.js";
5
+ function usePickerFormatter(locale, formatOptions, fallback, hourCycle) {
6
+ const shownLocale = useResolvedLocale(locale);
7
+ const optionsKeyStableAcrossInlineObjects = JSON.stringify(formatOptions ?? fallback);
8
+ const formatter = useMemo(
9
+ () => dateFormat(
10
+ shownLocale,
11
+ withHourCycle(
12
+ JSON.parse(optionsKeyStableAcrossInlineObjects),
13
+ hourCycle
14
+ )
15
+ ),
16
+ [shownLocale, optionsKeyStableAcrossInlineObjects, hourCycle]
17
+ );
18
+ return { shownLocale, formatter };
19
+ }
20
+ export {
21
+ usePickerFormatter
22
+ };
23
+ //# sourceMappingURL=usePickerFormatter.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/forms/internal/usePickerFormatter.ts"],
4
+ "sourcesContent": ["'use client';\n\nimport { useMemo } from 'react';\nimport { dateFormat, withHourCycle } from './calendarDays.js';\nimport { useResolvedLocale } from '../../internal/provider/locale.js';\n\nexport function usePickerFormatter(\n locale: string | undefined,\n formatOptions: Intl.DateTimeFormatOptions | undefined,\n fallback: Intl.DateTimeFormatOptions,\n hourCycle?: 'h12' | 'h23',\n) {\n const shownLocale = useResolvedLocale(locale);\n const optionsKeyStableAcrossInlineObjects = JSON.stringify(formatOptions ?? fallback);\n const formatter = useMemo(\n () =>\n dateFormat(\n shownLocale,\n withHourCycle(\n JSON.parse(optionsKeyStableAcrossInlineObjects) as Intl.DateTimeFormatOptions,\n hourCycle,\n ),\n ),\n [shownLocale, optionsKeyStableAcrossInlineObjects, hourCycle],\n );\n return { shownLocale, formatter };\n}\n"],
5
+ "mappings": ";AAEA,SAAS,eAAe;AACxB,SAAS,YAAY,qBAAqB;AAC1C,SAAS,yBAAyB;AAE3B,SAAS,mBACd,QACA,eACA,UACA,WACA;AACA,QAAM,cAAc,kBAAkB,MAAM;AAC5C,QAAM,sCAAsC,KAAK,UAAU,iBAAiB,QAAQ;AACpF,QAAM,YAAY;AAAA,IAChB,MACE;AAAA,MACE;AAAA,MACA;AAAA,QACE,KAAK,MAAM,mCAAmC;AAAA,QAC9C;AAAA,MACF;AAAA,IACF;AAAA,IACF,CAAC,aAAa,qCAAqC,SAAS;AAAA,EAC9D;AACA,SAAO,EAAE,aAAa,UAAU;AAClC;",
6
+ "names": []
7
+ }
@@ -1,11 +1,11 @@
1
1
  import { type RefObject } from 'react';
2
- import { type Entry } from './timeWheelRows.js';
2
+ import { type TimeWheelEntry } from './timeWheelRows.js';
3
3
  export declare function useTimeWheelTurn({ wheelRef, dragRef, entries, currentIndex, onChoose, loop, copies, }: {
4
4
  wheelRef: RefObject<HTMLDivElement | null>;
5
5
  dragRef: RefObject<{
6
6
  moved: boolean;
7
7
  } | null>;
8
- entries: readonly Entry[];
8
+ entries: readonly TimeWheelEntry[];
9
9
  currentIndex: number;
10
10
  onChoose: (value: number) => void;
11
11
  loop: boolean;
@@ -1,13 +1,13 @@
1
1
  "use client";
2
2
  import { useEffect, useLayoutEffect, useRef, useState } from "react";
3
3
  import { prefersReducedMotion } from "../../internal/motion/reducedMotion.js";
4
- import { useLatest } from "../../internal/useLatest.js";
4
+ import { useLatest } from "../../internal/react/useLatest.js";
5
5
  import {
6
6
  centredRow,
7
7
  nearestAvailable,
8
8
  topOf,
9
9
  wheelMetrics,
10
- wrap
10
+ wrapIndex
11
11
  } from "./timeWheelRows.js";
12
12
  const turnEasingTimeConstantMs = 90;
13
13
  const longestEasedFrameMs = 64;
@@ -90,7 +90,7 @@ function useTimeWheelTurn({
90
90
  const wheel = wheelRef.current;
91
91
  if (!loop || !wheel) return index;
92
92
  const at = heading(wheel);
93
- const base = at - wrap(at, count);
93
+ const base = at - wrapIndex(at, count);
94
94
  return [base - count, base, base + count].map((start) => start + index).reduce(
95
95
  (best, candidate) => Math.abs(candidate - at) < Math.abs(best - at) ? candidate : best
96
96
  );
@@ -103,7 +103,7 @@ function useTimeWheelTurn({
103
103
  if (sameEntriesSoTurnRatherThanJump) {
104
104
  const wheel = wheelRef.current;
105
105
  const at = wheel ? heading(wheel) : void 0;
106
- if (at !== void 0 && wrap(at, count) === currentIndex) return;
106
+ if (at !== void 0 && wrapIndex(at, count) === currentIndex) return;
107
107
  scrollToRow(nearestRow(currentIndex), true);
108
108
  } else scrollToRow(middleCopy * count + currentIndex, false);
109
109
  },
@@ -129,7 +129,7 @@ function useTimeWheelTurn({
129
129
  }
130
130
  function recentre(wheel, at) {
131
131
  if (!loop || !nearEnds(at)) return at;
132
- const moved = middleCopy * count + wrap(at, count);
132
+ const moved = middleCopy * count + wrapIndex(at, count);
133
133
  shiftRows(wheel, moved - at);
134
134
  return moved;
135
135
  }
@@ -143,7 +143,7 @@ function useTimeWheelTurn({
143
143
  ownTurnTarget.current = null;
144
144
  const { entries: rows, currentIndex: chosen, onChoose: choose } = latestRender.current;
145
145
  const at = recentre(wheel, centredRow(wheel, loop));
146
- const index = loop ? wrap(at, count) : Math.min(Math.max(at, 0), count - 1);
146
+ const index = loop ? wrapIndex(at, count) : Math.min(Math.max(at, 0), count - 1);
147
147
  const available = nearestAvailable(rows, index, loop, 0);
148
148
  if (available === -1) return;
149
149
  if (available !== index) {
@@ -170,7 +170,7 @@ function useTimeWheelTurn({
170
170
  function turnTo(wheel, next) {
171
171
  if (!loop) next = Math.min(Math.max(next, 0), count - 1);
172
172
  else if (nearEnds(next)) {
173
- const shift = middleCopy * count + wrap(next, count) - next;
173
+ const shift = middleCopy * count + wrapIndex(next, count) - next;
174
174
  shiftRows(wheel, shift);
175
175
  next += shift;
176
176
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../src/forms/internal/useTimeWheelTurn.ts"],
4
- "sourcesContent": ["'use client';\n\nimport { useEffect, useLayoutEffect, useRef, useState, type RefObject } from 'react';\nimport { prefersReducedMotion } from '../../internal/motion/reducedMotion.js';\nimport { useLatest } from '../../internal/useLatest.js';\nimport {\n centredRow,\n nearestAvailable,\n topOf,\n wheelMetrics,\n wrap,\n type Entry,\n} from './timeWheelRows.js';\n\nconst turnEasingTimeConstantMs = 90;\nconst longestEasedFrameMs = 64;\nconst settleWithoutScrollendAfterMs = 200;\nconst rowsFromEndsThatRecentreAFling = 3;\n\nfunction holdSnappingOffWhileEasing(wheel: HTMLElement) {\n wheel.dataset.turning = '';\n}\n\nexport function useTimeWheelTurn({\n wheelRef,\n dragRef,\n entries,\n currentIndex,\n onChoose,\n loop,\n copies,\n}: {\n wheelRef: RefObject<HTMLDivElement | null>;\n dragRef: RefObject<{ moved: boolean } | null>;\n entries: readonly Entry[];\n currentIndex: number;\n onChoose: (value: number) => void;\n loop: boolean;\n copies: number;\n}) {\n const count = entries.length;\n const middleCopy = Math.floor(copies / 2);\n const settleTimer = useRef<ReturnType<typeof setTimeout>>(undefined);\n const shown = useRef<{ current: number; count: number } | null>(null);\n const ownTurnTarget = useRef<number | null>(null);\n const easingTurn = useRef<{ position: number; frame: number; time: number } | null>(null);\n const [centred, setCentred] = useState(middleCopy * count + currentIndex);\n const latestRender = useLatest({ entries, currentIndex, onChoose });\n const chosenButNotYetShown = useRef<number | null>(null);\n useLayoutEffect(() => {\n chosenButNotYetShown.current = null;\n });\n\n function stopTurn(wheel: HTMLDivElement | null) {\n if (!easingTurn.current) return;\n cancelAnimationFrame(easingTurn.current.frame);\n easingTurn.current = null;\n if (wheel) delete wheel.dataset.turning;\n }\n\n function turnFrame(time: number) {\n const wheel = wheelRef.current;\n const state = easingTurn.current;\n if (!wheel || !state || ownTurnTarget.current === null) {\n stopTurn(wheel);\n return;\n }\n const goal = topOf(wheel, ownTurnTarget.current, loop);\n const elapsed = Math.min(Math.max(time - state.time, 0), longestEasedFrameMs);\n state.time = time;\n state.position += (goal - state.position) * (1 - Math.exp(-elapsed / turnEasingTimeConstantMs));\n if (Math.abs(goal - state.position) < 0.5) {\n wheel.scrollTop = goal;\n stopTurn(wheel);\n settle();\n return;\n }\n wheel.scrollTop = state.position;\n state.frame = requestAnimationFrame(turnFrame);\n }\n\n function scrollToRow(rowIndex: number, smooth: boolean) {\n const wheel = wheelRef.current;\n if (!wheel) return;\n ownTurnTarget.current = rowIndex;\n chosenButNotYetShown.current = null;\n setCentred(rowIndex);\n if (!smooth || prefersReducedMotion()) {\n stopTurn(wheel);\n wheel.scrollTo({ top: topOf(wheel, rowIndex, loop), behavior: 'instant' });\n return;\n }\n const turnUnderWayHeadsThereFromWhereItIs = easingTurn.current !== null;\n if (turnUnderWayHeadsThereFromWhereItIs) return;\n holdSnappingOffWhileEasing(wheel);\n easingTurn.current = {\n position: wheel.scrollTop,\n time: performance.now(),\n frame: requestAnimationFrame(turnFrame),\n };\n }\n\n function heading(wheel: HTMLDivElement) {\n return ownTurnTarget.current ?? centredRow(wheel, loop);\n }\n\n function nearestRow(index: number) {\n const wheel = wheelRef.current;\n if (!loop || !wheel) return index;\n const at = heading(wheel);\n const base = at - wrap(at, count);\n return [base - count, base, base + count]\n .map((start) => start + index)\n .reduce((best, candidate) =>\n Math.abs(candidate - at) < Math.abs(best - at) ? candidate : best,\n );\n }\n\n useLayoutEffect(\n function bringTheCurrentEntryToTheMiddle() {\n const previous = shown.current;\n shown.current = { current: currentIndex, count };\n const sameEntriesSoTurnRatherThanJump = previous !== null && previous.count === count;\n if (sameEntriesSoTurnRatherThanJump) {\n const wheel = wheelRef.current;\n const at = wheel ? heading(wheel) : undefined;\n if (at !== undefined && wrap(at, count) === currentIndex) return;\n scrollToRow(nearestRow(currentIndex), true);\n } else scrollToRow(middleCopy * count + currentIndex, false);\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [currentIndex, count],\n );\n\n useEffect(\n () => () => {\n clearTimeout(settleTimer.current);\n if (easingTurn.current) cancelAnimationFrame(easingTurn.current.frame);\n },\n [],\n );\n\n function shiftRows(wheel: HTMLDivElement, rows: number) {\n const pixels = rows * wheelMetrics(wheel).row;\n wheel.scrollTop += pixels;\n if (easingTurn.current) easingTurn.current.position += pixels;\n if (ownTurnTarget.current !== null) ownTurnTarget.current += rows;\n setCentred((row) => row + rows);\n }\n\n function nearEnds(row: number) {\n return row < count || row >= (copies - 1) * count;\n }\n\n function recentre(wheel: HTMLDivElement, at: number) {\n if (!loop || !nearEnds(at)) return at;\n const moved = middleCopy * count + wrap(at, count);\n shiftRows(wheel, moved - at);\n return moved;\n }\n\n function settle() {\n const wheel = wheelRef.current;\n const settlesWhenTurnOrDragEnds = easingTurn.current !== null || dragRef.current?.moved;\n if (!wheel || settlesWhenTurnOrDragEnds) return;\n clearTimeout(settleTimer.current);\n const turnCutShortByAnother =\n ownTurnTarget.current !== null && centredRow(wheel, loop) !== ownTurnTarget.current;\n if (turnCutShortByAnother) return;\n ownTurnTarget.current = null;\n const { entries: rows, currentIndex: chosen, onChoose: choose } = latestRender.current;\n const at = recentre(wheel, centredRow(wheel, loop));\n const index = loop ? wrap(at, count) : Math.min(Math.max(at, 0), count - 1);\n const available = nearestAvailable(rows, index, loop, 0);\n if (available === -1) return;\n if (available !== index) {\n scrollToRow(loop ? at + (available - index) : available, true);\n return;\n }\n if (index !== chosen && chosenButNotYetShown.current !== index) {\n chosenButNotYetShown.current = index;\n choose(rows[index].value);\n }\n }\n\n function handleScroll() {\n const wheel = wheelRef.current;\n if (!wheel) return;\n let at = centredRow(wheel, loop);\n const flingReachesTheEnds =\n at < rowsFromEndsThatRecentreAFling ||\n at > copies * count - rowsFromEndsThatRecentreAFling - 1;\n if (loop && flingReachesTheEnds) at = recentre(wheel, at);\n const scrollingByHand = ownTurnTarget.current === null;\n if (scrollingByHand && at !== centred) setCentred(at);\n clearTimeout(settleTimer.current);\n if (!easingTurn.current && !dragRef.current?.moved)\n settleTimer.current = setTimeout(settle, settleWithoutScrollendAfterMs);\n }\n\n function turnTo(wheel: HTMLDivElement, next: number) {\n if (!loop) next = Math.min(Math.max(next, 0), count - 1);\n else if (nearEnds(next)) {\n const shift = middleCopy * count + wrap(next, count) - next;\n shiftRows(wheel, shift);\n next += shift;\n }\n clearTimeout(settleTimer.current);\n scrollToRow(next, true);\n }\n\n return {\n centred,\n scrollToRow,\n turnTo,\n heading,\n settle,\n handleScroll,\n interrupt: (wheel: HTMLDivElement) => {\n stopTurn(wheel);\n ownTurnTarget.current = null;\n },\n holdSettling: () => clearTimeout(settleTimer.current),\n };\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["'use client';\n\nimport { useEffect, useLayoutEffect, useRef, useState, type RefObject } from 'react';\nimport { prefersReducedMotion } from '../../internal/motion/reducedMotion.js';\nimport { useLatest } from '../../internal/react/useLatest.js';\nimport {\n centredRow,\n nearestAvailable,\n topOf,\n wheelMetrics,\n wrapIndex,\n type TimeWheelEntry,\n} from './timeWheelRows.js';\n\nconst turnEasingTimeConstantMs = 90;\nconst longestEasedFrameMs = 64;\nconst settleWithoutScrollendAfterMs = 200;\nconst rowsFromEndsThatRecentreAFling = 3;\n\nfunction holdSnappingOffWhileEasing(wheel: HTMLElement) {\n wheel.dataset.turning = '';\n}\n\nexport function useTimeWheelTurn({\n wheelRef,\n dragRef,\n entries,\n currentIndex,\n onChoose,\n loop,\n copies,\n}: {\n wheelRef: RefObject<HTMLDivElement | null>;\n dragRef: RefObject<{ moved: boolean } | null>;\n entries: readonly TimeWheelEntry[];\n currentIndex: number;\n onChoose: (value: number) => void;\n loop: boolean;\n copies: number;\n}) {\n const count = entries.length;\n const middleCopy = Math.floor(copies / 2);\n const settleTimer = useRef<ReturnType<typeof setTimeout>>(undefined);\n const shown = useRef<{ current: number; count: number } | null>(null);\n const ownTurnTarget = useRef<number | null>(null);\n const easingTurn = useRef<{ position: number; frame: number; time: number } | null>(null);\n const [centred, setCentred] = useState(middleCopy * count + currentIndex);\n const latestRender = useLatest({ entries, currentIndex, onChoose });\n const chosenButNotYetShown = useRef<number | null>(null);\n useLayoutEffect(() => {\n chosenButNotYetShown.current = null;\n });\n\n function stopTurn(wheel: HTMLDivElement | null) {\n if (!easingTurn.current) return;\n cancelAnimationFrame(easingTurn.current.frame);\n easingTurn.current = null;\n if (wheel) delete wheel.dataset.turning;\n }\n\n function turnFrame(time: number) {\n const wheel = wheelRef.current;\n const state = easingTurn.current;\n if (!wheel || !state || ownTurnTarget.current === null) {\n stopTurn(wheel);\n return;\n }\n const goal = topOf(wheel, ownTurnTarget.current, loop);\n const elapsed = Math.min(Math.max(time - state.time, 0), longestEasedFrameMs);\n state.time = time;\n state.position += (goal - state.position) * (1 - Math.exp(-elapsed / turnEasingTimeConstantMs));\n if (Math.abs(goal - state.position) < 0.5) {\n wheel.scrollTop = goal;\n stopTurn(wheel);\n settle();\n return;\n }\n wheel.scrollTop = state.position;\n state.frame = requestAnimationFrame(turnFrame);\n }\n\n function scrollToRow(rowIndex: number, smooth: boolean) {\n const wheel = wheelRef.current;\n if (!wheel) return;\n ownTurnTarget.current = rowIndex;\n chosenButNotYetShown.current = null;\n setCentred(rowIndex);\n if (!smooth || prefersReducedMotion()) {\n stopTurn(wheel);\n wheel.scrollTo({ top: topOf(wheel, rowIndex, loop), behavior: 'instant' });\n return;\n }\n const turnUnderWayHeadsThereFromWhereItIs = easingTurn.current !== null;\n if (turnUnderWayHeadsThereFromWhereItIs) return;\n holdSnappingOffWhileEasing(wheel);\n easingTurn.current = {\n position: wheel.scrollTop,\n time: performance.now(),\n frame: requestAnimationFrame(turnFrame),\n };\n }\n\n function heading(wheel: HTMLDivElement) {\n return ownTurnTarget.current ?? centredRow(wheel, loop);\n }\n\n function nearestRow(index: number) {\n const wheel = wheelRef.current;\n if (!loop || !wheel) return index;\n const at = heading(wheel);\n const base = at - wrapIndex(at, count);\n return [base - count, base, base + count]\n .map((start) => start + index)\n .reduce((best, candidate) =>\n Math.abs(candidate - at) < Math.abs(best - at) ? candidate : best,\n );\n }\n\n useLayoutEffect(\n function bringTheCurrentEntryToTheMiddle() {\n const previous = shown.current;\n shown.current = { current: currentIndex, count };\n const sameEntriesSoTurnRatherThanJump = previous !== null && previous.count === count;\n if (sameEntriesSoTurnRatherThanJump) {\n const wheel = wheelRef.current;\n const at = wheel ? heading(wheel) : undefined;\n if (at !== undefined && wrapIndex(at, count) === currentIndex) return;\n scrollToRow(nearestRow(currentIndex), true);\n } else scrollToRow(middleCopy * count + currentIndex, false);\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [currentIndex, count],\n );\n\n useEffect(\n () => () => {\n clearTimeout(settleTimer.current);\n if (easingTurn.current) cancelAnimationFrame(easingTurn.current.frame);\n },\n [],\n );\n\n function shiftRows(wheel: HTMLDivElement, rows: number) {\n const pixels = rows * wheelMetrics(wheel).row;\n wheel.scrollTop += pixels;\n if (easingTurn.current) easingTurn.current.position += pixels;\n if (ownTurnTarget.current !== null) ownTurnTarget.current += rows;\n setCentred((row) => row + rows);\n }\n\n function nearEnds(row: number) {\n return row < count || row >= (copies - 1) * count;\n }\n\n function recentre(wheel: HTMLDivElement, at: number) {\n if (!loop || !nearEnds(at)) return at;\n const moved = middleCopy * count + wrapIndex(at, count);\n shiftRows(wheel, moved - at);\n return moved;\n }\n\n function settle() {\n const wheel = wheelRef.current;\n const settlesWhenTurnOrDragEnds = easingTurn.current !== null || dragRef.current?.moved;\n if (!wheel || settlesWhenTurnOrDragEnds) return;\n clearTimeout(settleTimer.current);\n const turnCutShortByAnother =\n ownTurnTarget.current !== null && centredRow(wheel, loop) !== ownTurnTarget.current;\n if (turnCutShortByAnother) return;\n ownTurnTarget.current = null;\n const { entries: rows, currentIndex: chosen, onChoose: choose } = latestRender.current;\n const at = recentre(wheel, centredRow(wheel, loop));\n const index = loop ? wrapIndex(at, count) : Math.min(Math.max(at, 0), count - 1);\n const available = nearestAvailable(rows, index, loop, 0);\n if (available === -1) return;\n if (available !== index) {\n scrollToRow(loop ? at + (available - index) : available, true);\n return;\n }\n if (index !== chosen && chosenButNotYetShown.current !== index) {\n chosenButNotYetShown.current = index;\n choose(rows[index].value);\n }\n }\n\n function handleScroll() {\n const wheel = wheelRef.current;\n if (!wheel) return;\n let at = centredRow(wheel, loop);\n const flingReachesTheEnds =\n at < rowsFromEndsThatRecentreAFling ||\n at > copies * count - rowsFromEndsThatRecentreAFling - 1;\n if (loop && flingReachesTheEnds) at = recentre(wheel, at);\n const scrollingByHand = ownTurnTarget.current === null;\n if (scrollingByHand && at !== centred) setCentred(at);\n clearTimeout(settleTimer.current);\n if (!easingTurn.current && !dragRef.current?.moved)\n settleTimer.current = setTimeout(settle, settleWithoutScrollendAfterMs);\n }\n\n function turnTo(wheel: HTMLDivElement, next: number) {\n if (!loop) next = Math.min(Math.max(next, 0), count - 1);\n else if (nearEnds(next)) {\n const shift = middleCopy * count + wrapIndex(next, count) - next;\n shiftRows(wheel, shift);\n next += shift;\n }\n clearTimeout(settleTimer.current);\n scrollToRow(next, true);\n }\n\n return {\n centred,\n scrollToRow,\n turnTo,\n heading,\n settle,\n handleScroll,\n interrupt: (wheel: HTMLDivElement) => {\n stopTurn(wheel);\n ownTurnTarget.current = null;\n },\n holdSettling: () => clearTimeout(settleTimer.current),\n };\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
  import { jsx } from "react/jsx-runtime";
3
3
  import { useMemo } from "react";
4
- import { PortalContainerContext } from "../internal/popup/PortalContainerContext.js";
4
+ import { PortalContainerContext } from "../internal/provider/PortalContainerContext.js";
5
5
  function PortalContainer({ container, contained = false, children }) {
6
6
  const value = useMemo(() => ({ container, contained }), [container, contained]);
7
7
  return /* @__PURE__ */ jsx(PortalContainerContext, { value, children });
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/foundations/PortalContainer.tsx"],
4
- "sourcesContent": ["'use client';\n\n// @client-module\n\nimport { useMemo, type ReactNode } from 'react';\nimport { PortalContainerContext } from '../internal/popup/PortalContainerContext.js';\n\nexport interface PortalContainerProps {\n /**\n * The element that envUI's popups, dialogs, sheets and toasts inside render into, in place of\n * the document's body, such as an element in a shadow root or in an iframe's document. Pass null\n * while the element mounts: overlays wait for it.\n */\n container: HTMLElement | null;\n /**\n * Whether the overlays belong to the container rather than the window, as in a preview of an\n * interface: a modal one neither locks the page's scroll, traps focus nor hides the rest of the\n * page; a dialog takes no focus as it opens; a popup opens on its own side without flipping and\n * sizes to its content; toasts are shown without the page's F6 shortcut; and a press or Esc\n * outside the container and the overlay's trigger doesn't close them, while the trigger and the\n * overlay's own controls do. Make the container a containing block, such as with\n * `contain: layout`, to keep fixed overlays, such as dialogs and their backdrops, inside it, and\n * give it or an ancestor `container-type: inline-size`: a popup is at most as wide as that size\n * container, or else as the window. A ContextMenu opens there too, at the pointer or below the\n * focused element, without hiding the page or locking its scroll; a long press doesn't open it.\n * @default false\n */\n contained?: boolean;\n /** The content whose popups, dialogs and toasts render in the container. */\n children: ReactNode;\n}\n\n/**\n * Renders envUI's overlays inside it, popups, dialogs, sheets and toasts, into another element than\n * the document's body, and with `contained`, as part of that element.\n */\nexport function PortalContainer({ container, contained = false, children }: PortalContainerProps) {\n const value = useMemo(() => ({ container, contained }), [container, contained]);\n return <PortalContainerContext value={value}>{children}</PortalContainerContext>;\n}\n"],
4
+ "sourcesContent": ["'use client';\n\n// @client-module\n\nimport { useMemo, type ReactNode } from 'react';\nimport { PortalContainerContext } from '../internal/provider/PortalContainerContext.js';\n\nexport interface PortalContainerProps {\n /**\n * The element that envUI's popups, dialogs, sheets and toasts inside render into, in place of\n * the document's body, such as an element in a shadow root or in an iframe's document. Pass null\n * while the element mounts: overlays wait for it.\n */\n container: HTMLElement | null;\n /**\n * Whether the overlays belong to the container rather than the window, as in a preview of an\n * interface: a modal one neither locks the page's scroll, traps focus nor hides the rest of the\n * page; a dialog takes no focus as it opens; a popup opens on its own side without flipping and\n * sizes to its content; toasts are shown without the page's F6 shortcut; and a press or Esc\n * outside the container and the overlay's trigger doesn't close them, while the trigger and the\n * overlay's own controls do. Make the container a containing block, such as with\n * `contain: layout`, to keep fixed overlays, such as dialogs and their backdrops, inside it, and\n * give it or an ancestor `container-type: inline-size`: a popup is at most as wide as that size\n * container, or else as the window. A ContextMenu opens there too, at the pointer or below the\n * focused element, without hiding the page or locking its scroll; a long press doesn't open it.\n * @default false\n */\n contained?: boolean;\n /** The content whose popups, dialogs and toasts render in the container. */\n children: ReactNode;\n}\n\n/**\n * Renders envUI's overlays inside it, popups, dialogs, sheets and toasts, into another element than\n * the document's body, and with `contained`, as part of that element.\n */\nexport function PortalContainer({ container, contained = false, children }: PortalContainerProps) {\n const value = useMemo(() => ({ container, contained }), [container, contained]);\n return <PortalContainerContext value={value}>{children}</PortalContainerContext>;\n}\n"],
5
5
  "mappings": ";AAsCS;AAlCT,SAAS,eAA+B;AACxC,SAAS,8BAA8B;AA+BhC,SAAS,gBAAgB,EAAE,WAAW,YAAY,OAAO,SAAS,GAAyB;AAChG,QAAM,QAAQ,QAAQ,OAAO,EAAE,WAAW,UAAU,IAAI,CAAC,WAAW,SAAS,CAAC;AAC9E,SAAO,oBAAC,0BAAuB,OAAe,UAAS;AACzD;",
6
6
  "names": []
7
7
  }
@@ -1,4 +1,4 @@
1
- import { type ComponentPropsWithRef } from 'react';
1
+ import { type ComponentPropsWithRef, type ReactElement } from 'react';
2
2
  /** A color scheme. */
3
3
  export type ColorScheme = 'light' | 'dark';
4
4
  /**
@@ -67,13 +67,20 @@ export interface ThemeProps extends ComponentPropsWithRef<'div'> {
67
67
  * Theme, and to rounded outside any.
68
68
  */
69
69
  corners?: ThemeCorners;
70
+ /**
71
+ * The boundary's element, for its meaning or its place in the markup, such as
72
+ * render={<section />} for a landmark or render={<tbody />} inside a table. The boundary's class
73
+ * and attributes merge into its props, as on Text: classes join, styles merge, both event
74
+ * handlers run and both refs receive the node. A div by default.
75
+ */
76
+ render?: ReactElement;
70
77
  }
71
78
  /**
72
79
  * An explicit, scoped theme: a color scheme, a contrast, a scale, and the selection and corners
73
80
  * of the look, which nested Themes and envUI's popups keep. Theme preference and
74
81
  * persistence belong to the app.
75
82
  */
76
- export declare function Theme({ theme, contrast: ownContrast, scale: ownScale, selection: ownSelection, corners: ownCorners, className, children, ...props }: ThemeProps): import("react").JSX.Element;
83
+ export declare function Theme({ theme, contrast: ownContrast, scale: ownScale, selection: ownSelection, corners: ownCorners, className, render, children, ...props }: ThemeProps): import("react").JSX.Element;
77
84
  /**
78
85
  * The theme of the nearest Theme, including across React portals: its color scheme, contrast,
79
86
  * scale, selection and corners. A portal of the application's own takes it with `<Theme {...useTheme()}>`. A contrast of
@@ -1,10 +1,16 @@
1
1
  "use client";
2
2
  import { jsx } from "react/jsx-runtime";
3
- import { createContext, useContext, useMemo } from "react";
3
+ import {
4
+ createContext,
5
+ useContext,
6
+ useMemo
7
+ } from "react";
4
8
  import { classNames } from "../internal/classNames.js";
9
+ import { renderElement } from "../internal/react/renderElement.js";
5
10
  import { outsideTheme } from "./internal/outsideTheme.js";
6
11
  import { themeFromRootAttribute } from "./internal/themeFromRoot.js";
7
12
  import { reportInDevelopment } from "../internal/developmentReport.js";
13
+ import { explicitContrasts, isOneOf, themeScales } from "../internal/theme/themeRoot.js";
8
14
  import "#styles/Base.css";
9
15
  const ThemeContext = createContext(outsideTheme);
10
16
  const unshowableObject = "an object";
@@ -37,6 +43,7 @@ function Theme({
37
43
  selection: ownSelection,
38
44
  corners: ownCorners,
39
45
  className,
46
+ render,
40
47
  children,
41
48
  ...props
42
49
  }) {
@@ -44,9 +51,9 @@ function Theme({
44
51
  const inherited = useContext(ThemeContext);
45
52
  const writtenAttributes = props;
46
53
  const contrastAttribute = writtenAttributes["data-env-contrast"];
47
- const contrast = ownContrast ?? (contrastAttribute === "high" || contrastAttribute === "standard" ? contrastAttribute : inherited.contrast);
54
+ const contrast = ownContrast ?? (isOneOf(explicitContrasts, contrastAttribute) ? contrastAttribute : inherited.contrast);
48
55
  const scaleAttribute = writtenAttributes["data-env-scale"];
49
- const scale = ownScale ?? (scaleAttribute === "comfortable" || scaleAttribute === "compact" || scaleAttribute === "system" ? scaleAttribute : inherited.scale);
56
+ const scale = ownScale ?? (isOneOf(themeScales, scaleAttribute) ? scaleAttribute : inherited.scale);
50
57
  const selection = ownSelection ?? inherited.selection;
51
58
  const corners = ownCorners ?? inherited.corners;
52
59
  const value = useMemo(
@@ -54,22 +61,20 @@ function Theme({
54
61
  [theme, contrast, scale, selection, corners]
55
62
  );
56
63
  const boundaryTakesRootLook = themeFromRootAttribute in props;
57
- return /* @__PURE__ */ jsx(ThemeContext, { value, children: /* @__PURE__ */ jsx(
58
- "div",
59
- {
60
- ...props,
61
- className,
62
- ...!boundaryTakesRootLook && {
63
- className: classNames("env-theme", className),
64
- "data-env-theme": theme,
65
- "data-env-contrast": contrast === "system" ? void 0 : contrast,
66
- "data-env-scale": scale,
67
- "data-env-selection": selection,
68
- "data-env-corners": corners
69
- },
70
- children
71
- }
72
- ) });
64
+ const boundary = {
65
+ ...props,
66
+ className,
67
+ ...!boundaryTakesRootLook && {
68
+ className: classNames("env-theme", className),
69
+ "data-env-theme": theme,
70
+ "data-env-contrast": contrast === "system" ? void 0 : contrast,
71
+ "data-env-scale": scale,
72
+ "data-env-selection": selection,
73
+ "data-env-corners": corners
74
+ },
75
+ children
76
+ };
77
+ return /* @__PURE__ */ jsx(ThemeContext, { value, children: renderElement("div", render, boundary) });
73
78
  }
74
79
  function useTheme() {
75
80
  return useContext(ThemeContext);
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/foundations/Theme.tsx"],
4
- "sourcesContent": ["'use client';\n\nimport { createContext, useContext, useMemo, type ComponentPropsWithRef } from 'react';\nimport { classNames } from '../internal/classNames.js';\nimport { outsideTheme } from './internal/outsideTheme.js';\nimport { themeFromRootAttribute } from './internal/themeFromRoot.js';\nimport { reportInDevelopment } from '../internal/developmentReport.js';\nimport '../styles/Base.css';\n\n/** A color scheme. */\nexport type ColorScheme = 'light' | 'dark';\n\n/**\n * The contrast of a Theme: the standard colors, the high-contrast ones, or `system`, which takes the\n * high-contrast colors while the system asks for more contrast (`prefers-contrast: more`).\n */\nexport type ThemeContrast = 'standard' | 'high' | 'system';\n\n/**\n * The app scale of a Theme: comfortable, the sizes of web and touch apps; compact, about 0.8 of\n * them with type one step smaller, for desktop productivity apps; or `system`, which takes compact\n * where the primary pointer is fine, such as a mouse or trackpad (`pointer: fine`), and comfortable\n * on touch.\n */\nexport type ThemeScale = 'comfortable' | 'compact' | 'system';\n\n/**\n * The tone of what is selected in a Theme, such as a navigation item, a row or an option: neutral,\n * a gray under the default text color; or accent, the brand's tint under its text color.\n */\nexport type ThemeSelection = 'neutral' | 'accent';\n\n/**\n * The corner shape of a Theme: sharp, with corners close to square; rounded; or round, with larger\n * corners. Parts that are always circles, such as avatars and radios, stay circles.\n */\nexport type ThemeCorners = 'sharp' | 'rounded' | 'round';\n\nexport type { ControlSize } from '../internal/control/controlTypes.js';\n\n/**\n * How tightly a data component, such as a Table, Tree or List, packs its rows: only the rows' block\n * padding changes, never their type, icons or corners. md is the default of tables and lists, sm of\n * trees.\n */\nexport type RowDensity = 'xs' | 'sm' | 'md' | 'lg';\n\n/** The theme of the nearest Theme boundary, as useTheme returns it. */\nexport interface ThemeContextValue {\n theme: ColorScheme;\n contrast: ThemeContrast;\n scale: ThemeScale;\n selection: ThemeSelection;\n corners: ThemeCorners;\n}\n\nexport interface ThemeProps extends ComponentPropsWithRef<'div'> {\n /** The color scheme. */\n theme: ColorScheme;\n /**\n * `high` for the high-contrast colors; `standard` keeps the standard ones even while the system\n * asks for more contrast; `system` follows `prefers-contrast: more`. Defaults to the contrast of\n * the enclosing Theme, and to `system` outside any. It wins over a `data-env-contrast` attribute\n * passed to the Theme; left out, such an attribute of `high` or `standard` sets the contrast, for\n * the boundary, its nested Themes and its popups alike.\n */\n contrast?: ThemeContrast;\n /**\n * The app scale of everything inside: comfortable, compact, or `system`, which is compact under a\n * fine pointer and comfortable on touch, chosen by the stylesheet. Use one scale per app or\n * window, and another only on a Theme around a whole region, such as a docked inspector. Defaults\n * to the scale of the enclosing Theme, and to `system` outside any. It wins over a\n * `data-env-scale` attribute passed to the Theme.\n */\n scale?: ThemeScale;\n /**\n * The tone of selected items inside: neutral or accent. Defaults to the selection of the\n * enclosing Theme, and to neutral outside any.\n */\n selection?: ThemeSelection;\n /**\n * The corner shape inside: sharp, rounded or round. Defaults to the corners of the enclosing\n * Theme, and to rounded outside any.\n */\n corners?: ThemeCorners;\n}\n\nconst ThemeContext = createContext<ThemeContextValue>(outsideTheme);\n\nconst unshowableObject = 'an object';\n\nfunction describeThemeInReport(theme: unknown): string {\n if (typeof theme !== 'object' || theme === null) return String(theme);\n try {\n const objectsContainingValue: unknown[] = [];\n const shown = JSON.stringify(theme, function (this: unknown, _key, value: unknown) {\n if (typeof value === 'bigint') return `${value}n`;\n if (typeof value !== 'object' || value === null) return value;\n while (\n objectsContainingValue.length > 0 &&\n objectsContainingValue[objectsContainingValue.length - 1] !== this\n )\n objectsContainingValue.pop();\n if (objectsContainingValue.includes(value)) return '[Circular]';\n objectsContainingValue.push(value);\n return value;\n }) as string | undefined;\n return shown ?? unshowableObject;\n } catch {\n return unshowableObject;\n }\n}\n\nfunction themeReport(theme: unknown): string | undefined {\n if (theme === 'light' || theme === 'dark') return undefined;\n return (\n `Theme takes a theme of \"light\" or \"dark\", not ${describeThemeInReport(theme)}.` +\n (typeof theme === 'object' && theme !== null\n ? ' useTheme() returns { theme, contrast }: write <Theme {...useTheme()}>.'\n : '')\n );\n}\n\n/**\n * An explicit, scoped theme: a color scheme, a contrast, a scale, and the selection and corners\n * of the look, which nested Themes and envUI's popups keep. Theme preference and\n * persistence belong to the app.\n */\nexport function Theme({\n theme,\n contrast: ownContrast,\n scale: ownScale,\n selection: ownSelection,\n corners: ownCorners,\n className,\n children,\n ...props\n}: ThemeProps) {\n reportInDevelopment(() => process.env.NODE_ENV !== 'production' && themeReport(theme));\n const inherited = useContext(ThemeContext);\n const writtenAttributes = props as Record<string, unknown>;\n const contrastAttribute = writtenAttributes['data-env-contrast'];\n const contrast =\n ownContrast ??\n (contrastAttribute === 'high' || contrastAttribute === 'standard'\n ? contrastAttribute\n : inherited.contrast);\n const scaleAttribute = writtenAttributes['data-env-scale'];\n const scale =\n ownScale ??\n (scaleAttribute === 'comfortable' || scaleAttribute === 'compact' || scaleAttribute === 'system'\n ? scaleAttribute\n : inherited.scale);\n const selection = ownSelection ?? inherited.selection;\n const corners = ownCorners ?? inherited.corners;\n const value = useMemo(\n () => ({ theme, contrast, scale, selection, corners }),\n [theme, contrast, scale, selection, corners],\n );\n const boundaryTakesRootLook = themeFromRootAttribute in props;\n return (\n <ThemeContext value={value}>\n <div\n {...props}\n className={className}\n {...(!boundaryTakesRootLook && {\n className: classNames('env-theme', className),\n 'data-env-theme': theme,\n 'data-env-contrast': contrast === 'system' ? undefined : contrast,\n 'data-env-scale': scale,\n 'data-env-selection': selection,\n 'data-env-corners': corners,\n })}\n >\n {children}\n </div>\n </ThemeContext>\n );\n}\n\n/**\n * The theme of the nearest Theme, including across React portals: its color scheme, contrast,\n * scale, selection and corners. A portal of the application's own takes it with `<Theme {...useTheme()}>`. A contrast of\n * `system` leaves the choice to the stylesheet, which reads `prefers-contrast: more`, as a scale of\n * `system` leaves it to `pointer: fine`.\n */\nexport function useTheme(): ThemeContextValue {\n return useContext(ThemeContext);\n}\n"],
5
- "mappings": ";AAkKM;AAhKN,SAAS,eAAe,YAAY,eAA2C;AAC/E,SAAS,kBAAkB;AAC3B,SAAS,oBAAoB;AAC7B,SAAS,8BAA8B;AACvC,SAAS,2BAA2B;AACpC,OAAO;AAgFP,MAAM,eAAe,cAAiC,YAAY;AAElE,MAAM,mBAAmB;AAEzB,SAAS,sBAAsB,OAAwB;AACrD,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO,OAAO,KAAK;AACpE,MAAI;AACF,UAAM,yBAAoC,CAAC;AAC3C,UAAM,QAAQ,KAAK,UAAU,OAAO,SAAyB,MAAM,OAAgB;AACjF,UAAI,OAAO,UAAU,SAAU,QAAO,GAAG,KAAK;AAC9C,UAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,aACE,uBAAuB,SAAS,KAChC,uBAAuB,uBAAuB,SAAS,CAAC,MAAM;AAE9D,+BAAuB,IAAI;AAC7B,UAAI,uBAAuB,SAAS,KAAK,EAAG,QAAO;AACnD,6BAAuB,KAAK,KAAK;AACjC,aAAO;AAAA,IACT,CAAC;AACD,WAAO,SAAS;AAAA,EAClB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,YAAY,OAAoC;AACvD,MAAI,UAAU,WAAW,UAAU,OAAQ,QAAO;AAClD,SACE,iDAAiD,sBAAsB,KAAK,CAAC,OAC5E,OAAO,UAAU,YAAY,UAAU,OACpC,4EACA;AAER;AAOO,SAAS,MAAM;AAAA,EACpB;AAAA,EACA,UAAU;AAAA,EACV,OAAO;AAAA,EACP,WAAW;AAAA,EACX,SAAS;AAAA,EACT;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAe;AACb,sBAAoB,MAAM,QAAQ,IAAI,aAAa,gBAAgB,YAAY,KAAK,CAAC;AACrF,QAAM,YAAY,WAAW,YAAY;AACzC,QAAM,oBAAoB;AAC1B,QAAM,oBAAoB,kBAAkB,mBAAmB;AAC/D,QAAM,WACJ,gBACC,sBAAsB,UAAU,sBAAsB,aACnD,oBACA,UAAU;AAChB,QAAM,iBAAiB,kBAAkB,gBAAgB;AACzD,QAAM,QACJ,aACC,mBAAmB,iBAAiB,mBAAmB,aAAa,mBAAmB,WACpF,iBACA,UAAU;AAChB,QAAM,YAAY,gBAAgB,UAAU;AAC5C,QAAM,UAAU,cAAc,UAAU;AACxC,QAAM,QAAQ;AAAA,IACZ,OAAO,EAAE,OAAO,UAAU,OAAO,WAAW,QAAQ;AAAA,IACpD,CAAC,OAAO,UAAU,OAAO,WAAW,OAAO;AAAA,EAC7C;AACA,QAAM,wBAAwB,0BAA0B;AACxD,SACE,oBAAC,gBAAa,OACZ;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ;AAAA,MACC,GAAI,CAAC,yBAAyB;AAAA,QAC7B,WAAW,WAAW,aAAa,SAAS;AAAA,QAC5C,kBAAkB;AAAA,QAClB,qBAAqB,aAAa,WAAW,SAAY;AAAA,QACzD,kBAAkB;AAAA,QAClB,sBAAsB;AAAA,QACtB,oBAAoB;AAAA,MACtB;AAAA,MAEC;AAAA;AAAA,EACH,GACF;AAEJ;AAQO,SAAS,WAA8B;AAC5C,SAAO,WAAW,YAAY;AAChC;",
4
+ "sourcesContent": ["'use client';\n\nimport {\n createContext,\n useContext,\n useMemo,\n type ComponentPropsWithRef,\n type ReactElement,\n} from 'react';\nimport { classNames } from '../internal/classNames.js';\nimport { renderElement } from '../internal/react/renderElement.js';\nimport { outsideTheme } from './internal/outsideTheme.js';\nimport { themeFromRootAttribute } from './internal/themeFromRoot.js';\nimport { reportInDevelopment } from '../internal/developmentReport.js';\nimport { explicitContrasts, isOneOf, themeScales } from '../internal/theme/themeRoot.js';\nimport '../styles/Base.css';\n\n/** A color scheme. */\nexport type ColorScheme = 'light' | 'dark';\n\n/**\n * The contrast of a Theme: the standard colors, the high-contrast ones, or `system`, which takes the\n * high-contrast colors while the system asks for more contrast (`prefers-contrast: more`).\n */\nexport type ThemeContrast = 'standard' | 'high' | 'system';\n\n/**\n * The app scale of a Theme: comfortable, the sizes of web and touch apps; compact, about 0.8 of\n * them with type one step smaller, for desktop productivity apps; or `system`, which takes compact\n * where the primary pointer is fine, such as a mouse or trackpad (`pointer: fine`), and comfortable\n * on touch.\n */\nexport type ThemeScale = 'comfortable' | 'compact' | 'system';\n\n/**\n * The tone of what is selected in a Theme, such as a navigation item, a row or an option: neutral,\n * a gray under the default text color; or accent, the brand's tint under its text color.\n */\nexport type ThemeSelection = 'neutral' | 'accent';\n\n/**\n * The corner shape of a Theme: sharp, with corners close to square; rounded; or round, with larger\n * corners. Parts that are always circles, such as avatars and radios, stay circles.\n */\nexport type ThemeCorners = 'sharp' | 'rounded' | 'round';\n\nexport type { ControlSize } from '../internal/control/controlTypes.js';\n\n/**\n * How tightly a data component, such as a Table, Tree or List, packs its rows: only the rows' block\n * padding changes, never their type, icons or corners. md is the default of tables and lists, sm of\n * trees.\n */\nexport type RowDensity = 'xs' | 'sm' | 'md' | 'lg';\n\n/** The theme of the nearest Theme boundary, as useTheme returns it. */\nexport interface ThemeContextValue {\n theme: ColorScheme;\n contrast: ThemeContrast;\n scale: ThemeScale;\n selection: ThemeSelection;\n corners: ThemeCorners;\n}\n\nexport interface ThemeProps extends ComponentPropsWithRef<'div'> {\n /** The color scheme. */\n theme: ColorScheme;\n /**\n * `high` for the high-contrast colors; `standard` keeps the standard ones even while the system\n * asks for more contrast; `system` follows `prefers-contrast: more`. Defaults to the contrast of\n * the enclosing Theme, and to `system` outside any. It wins over a `data-env-contrast` attribute\n * passed to the Theme; left out, such an attribute of `high` or `standard` sets the contrast, for\n * the boundary, its nested Themes and its popups alike.\n */\n contrast?: ThemeContrast;\n /**\n * The app scale of everything inside: comfortable, compact, or `system`, which is compact under a\n * fine pointer and comfortable on touch, chosen by the stylesheet. Use one scale per app or\n * window, and another only on a Theme around a whole region, such as a docked inspector. Defaults\n * to the scale of the enclosing Theme, and to `system` outside any. It wins over a\n * `data-env-scale` attribute passed to the Theme.\n */\n scale?: ThemeScale;\n /**\n * The tone of selected items inside: neutral or accent. Defaults to the selection of the\n * enclosing Theme, and to neutral outside any.\n */\n selection?: ThemeSelection;\n /**\n * The corner shape inside: sharp, rounded or round. Defaults to the corners of the enclosing\n * Theme, and to rounded outside any.\n */\n corners?: ThemeCorners;\n /**\n * The boundary's element, for its meaning or its place in the markup, such as\n * render={<section />} for a landmark or render={<tbody />} inside a table. The boundary's class\n * and attributes merge into its props, as on Text: classes join, styles merge, both event\n * handlers run and both refs receive the node. A div by default.\n */\n render?: ReactElement;\n}\n\nconst ThemeContext = createContext<ThemeContextValue>(outsideTheme);\n\nconst unshowableObject = 'an object';\n\nfunction describeThemeInReport(theme: unknown): string {\n if (typeof theme !== 'object' || theme === null) return String(theme);\n try {\n const objectsContainingValue: unknown[] = [];\n const shown = JSON.stringify(theme, function (this: unknown, _key, value: unknown) {\n if (typeof value === 'bigint') return `${value}n`;\n if (typeof value !== 'object' || value === null) return value;\n while (\n objectsContainingValue.length > 0 &&\n objectsContainingValue[objectsContainingValue.length - 1] !== this\n )\n objectsContainingValue.pop();\n if (objectsContainingValue.includes(value)) return '[Circular]';\n objectsContainingValue.push(value);\n return value;\n }) as string | undefined;\n return shown ?? unshowableObject;\n } catch {\n return unshowableObject;\n }\n}\n\nfunction themeReport(theme: unknown): string | undefined {\n if (theme === 'light' || theme === 'dark') return undefined;\n return (\n `Theme takes a theme of \"light\" or \"dark\", not ${describeThemeInReport(theme)}.` +\n (typeof theme === 'object' && theme !== null\n ? ' useTheme() returns { theme, contrast }: write <Theme {...useTheme()}>.'\n : '')\n );\n}\n\n/**\n * An explicit, scoped theme: a color scheme, a contrast, a scale, and the selection and corners\n * of the look, which nested Themes and envUI's popups keep. Theme preference and\n * persistence belong to the app.\n */\nexport function Theme({\n theme,\n contrast: ownContrast,\n scale: ownScale,\n selection: ownSelection,\n corners: ownCorners,\n className,\n render,\n children,\n ...props\n}: ThemeProps) {\n reportInDevelopment(() => process.env.NODE_ENV !== 'production' && themeReport(theme));\n const inherited = useContext(ThemeContext);\n const writtenAttributes = props as Record<string, unknown>;\n const contrastAttribute = writtenAttributes['data-env-contrast'];\n const contrast =\n ownContrast ??\n (isOneOf(explicitContrasts, contrastAttribute) ? contrastAttribute : inherited.contrast);\n const scaleAttribute = writtenAttributes['data-env-scale'];\n const scale =\n ownScale ?? (isOneOf(themeScales, scaleAttribute) ? scaleAttribute : inherited.scale);\n const selection = ownSelection ?? inherited.selection;\n const corners = ownCorners ?? inherited.corners;\n const value = useMemo(\n () => ({ theme, contrast, scale, selection, corners }),\n [theme, contrast, scale, selection, corners],\n );\n const boundaryTakesRootLook = themeFromRootAttribute in props;\n const boundary = {\n ...props,\n className,\n ...(!boundaryTakesRootLook && {\n className: classNames('env-theme', className),\n 'data-env-theme': theme,\n 'data-env-contrast': contrast === 'system' ? undefined : contrast,\n 'data-env-scale': scale,\n 'data-env-selection': selection,\n 'data-env-corners': corners,\n }),\n children,\n };\n return <ThemeContext value={value}>{renderElement('div', render, boundary)}</ThemeContext>;\n}\n\n/**\n * The theme of the nearest Theme, including across React portals: its color scheme, contrast,\n * scale, selection and corners. A portal of the application's own takes it with `<Theme {...useTheme()}>`. A contrast of\n * `system` leaves the choice to the stylesheet, which reads `prefers-contrast: more`, as a scale of\n * `system` leaves it to `pointer: fine`.\n */\nexport function useTheme(): ThemeContextValue {\n return useContext(ThemeContext);\n}\n"],
5
+ "mappings": ";AAwLS;AAtLT;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,kBAAkB;AAC3B,SAAS,qBAAqB;AAC9B,SAAS,oBAAoB;AAC7B,SAAS,8BAA8B;AACvC,SAAS,2BAA2B;AACpC,SAAS,mBAAmB,SAAS,mBAAmB;AACxD,OAAO;AAuFP,MAAM,eAAe,cAAiC,YAAY;AAElE,MAAM,mBAAmB;AAEzB,SAAS,sBAAsB,OAAwB;AACrD,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO,OAAO,KAAK;AACpE,MAAI;AACF,UAAM,yBAAoC,CAAC;AAC3C,UAAM,QAAQ,KAAK,UAAU,OAAO,SAAyB,MAAM,OAAgB;AACjF,UAAI,OAAO,UAAU,SAAU,QAAO,GAAG,KAAK;AAC9C,UAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,aACE,uBAAuB,SAAS,KAChC,uBAAuB,uBAAuB,SAAS,CAAC,MAAM;AAE9D,+BAAuB,IAAI;AAC7B,UAAI,uBAAuB,SAAS,KAAK,EAAG,QAAO;AACnD,6BAAuB,KAAK,KAAK;AACjC,aAAO;AAAA,IACT,CAAC;AACD,WAAO,SAAS;AAAA,EAClB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,YAAY,OAAoC;AACvD,MAAI,UAAU,WAAW,UAAU,OAAQ,QAAO;AAClD,SACE,iDAAiD,sBAAsB,KAAK,CAAC,OAC5E,OAAO,UAAU,YAAY,UAAU,OACpC,4EACA;AAER;AAOO,SAAS,MAAM;AAAA,EACpB;AAAA,EACA,UAAU;AAAA,EACV,OAAO;AAAA,EACP,WAAW;AAAA,EACX,SAAS;AAAA,EACT;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAe;AACb,sBAAoB,MAAM,QAAQ,IAAI,aAAa,gBAAgB,YAAY,KAAK,CAAC;AACrF,QAAM,YAAY,WAAW,YAAY;AACzC,QAAM,oBAAoB;AAC1B,QAAM,oBAAoB,kBAAkB,mBAAmB;AAC/D,QAAM,WACJ,gBACC,QAAQ,mBAAmB,iBAAiB,IAAI,oBAAoB,UAAU;AACjF,QAAM,iBAAiB,kBAAkB,gBAAgB;AACzD,QAAM,QACJ,aAAa,QAAQ,aAAa,cAAc,IAAI,iBAAiB,UAAU;AACjF,QAAM,YAAY,gBAAgB,UAAU;AAC5C,QAAM,UAAU,cAAc,UAAU;AACxC,QAAM,QAAQ;AAAA,IACZ,OAAO,EAAE,OAAO,UAAU,OAAO,WAAW,QAAQ;AAAA,IACpD,CAAC,OAAO,UAAU,OAAO,WAAW,OAAO;AAAA,EAC7C;AACA,QAAM,wBAAwB,0BAA0B;AACxD,QAAM,WAAW;AAAA,IACf,GAAG;AAAA,IACH;AAAA,IACA,GAAI,CAAC,yBAAyB;AAAA,MAC5B,WAAW,WAAW,aAAa,SAAS;AAAA,MAC5C,kBAAkB;AAAA,MAClB,qBAAqB,aAAa,WAAW,SAAY;AAAA,MACzD,kBAAkB;AAAA,MAClB,sBAAsB;AAAA,MACtB,oBAAoB;AAAA,IACtB;AAAA,IACA;AAAA,EACF;AACA,SAAO,oBAAC,gBAAa,OAAe,wBAAc,OAAO,QAAQ,QAAQ,GAAE;AAC7E;AAQO,SAAS,WAA8B;AAC5C,SAAO,WAAW,YAAY;AAChC;",
6
6
  "names": []
7
7
  }
@@ -7,8 +7,8 @@ export interface ThemeMenuRadioGroupProps {
7
7
  */
8
8
  value?: ThemePreference;
9
9
  /**
10
- * Called with the preference chosen, for an application that stores the theme itself.
11
- * @default the nearest ThemePreferenceProvider's setPreference, which stores the choice
10
+ * Called with the preference chosen, for a group outside a ThemePreferenceProvider.
11
+ * @default the nearest ThemePreferenceProvider's setPreference
12
12
  */
13
13
  onValueChange?: (value: ThemePreference) => void;
14
14
  /**
@@ -20,14 +20,21 @@ export interface ThemeMenuRadioGroupProps {
20
20
  'aria-labelledby'?: string;
21
21
  /**
22
22
  * Close the menu after a choice. Off by default, so people see the theme change with the menu
23
- * still open.
23
+ * still open. It applies to the choices given as children too, unless one sets its own.
24
24
  * @default false
25
25
  */
26
26
  closeOnClick?: boolean;
27
+ /**
28
+ * The choices, as Menu.RadioItems valued system, light or dark, in place of the three default
29
+ * ones: such as Light and Dark alone, or a choice with a hint beside it.
30
+ */
31
+ children?: ReactNode;
32
+ /** The group's class, beside env-menu-group. */
33
+ className?: string;
27
34
  }
28
35
  /**
29
36
  * The theme choice for a Menu: System, Light and Dark as radio items. Inside a
30
- * ThemePreferenceProvider it shows and stores the provider's preference; value and onValueChange
31
- * connect it to a theme the application stores itself.
37
+ * ThemePreferenceProvider it shows and changes the provider's preference; value and onValueChange
38
+ * connect it to a preference outside one.
32
39
  */
33
- export declare function ThemeMenuRadioGroup({ value, onValueChange, label, 'aria-labelledby': labelledBy, closeOnClick, }: ThemeMenuRadioGroupProps): import("react").JSX.Element;
40
+ export declare function ThemeMenuRadioGroup({ value, onValueChange, label, 'aria-labelledby': labelledBy, closeOnClick, children, className, }: ThemeMenuRadioGroupProps): import("react").JSX.Element;
@@ -2,6 +2,7 @@
2
2
  import { jsx } from "react/jsx-runtime";
3
3
  import { useContext } from "react";
4
4
  import * as Menu from "../actions/menu/Menu.js";
5
+ import { RadioItemsCloseOnClickContext } from "../actions/menu/MenuChoices.js";
5
6
  import { useMessages } from "../internal/provider/EnvUIContext.js";
6
7
  import { themePreference } from "./messages/themePreference.js";
7
8
  import { ThemePreferenceContext } from "./internal/ThemePreferenceContext.js";
@@ -18,7 +19,9 @@ function ThemeMenuRadioGroup({
18
19
  onValueChange,
19
20
  label,
20
21
  "aria-labelledby": labelledBy,
21
- closeOnClick = false
22
+ closeOnClick = false,
23
+ children,
24
+ className
22
25
  }) {
23
26
  const provider = useContext(ThemePreferenceContext);
24
27
  const messages = useMessages("themePreference", themePreference);
@@ -35,16 +38,8 @@ function ThemeMenuRadioGroup({
35
38
  onValueChange: (next) => change(next),
36
39
  label,
37
40
  "aria-labelledby": labelledBy,
38
- children: choices.map((choice) => /* @__PURE__ */ jsx(
39
- Menu.RadioItem,
40
- {
41
- value: choice.value,
42
- icon: choice.icon,
43
- closeOnClick,
44
- children: messages[choice.value]
45
- },
46
- choice.value
47
- ))
41
+ className,
42
+ children: /* @__PURE__ */ jsx(RadioItemsCloseOnClickContext, { value: closeOnClick, children: children ?? choices.map((choice) => /* @__PURE__ */ jsx(Menu.RadioItem, { value: choice.value, start: choice.icon, children: messages[choice.value] }, choice.value)) })
48
43
  }
49
44
  );
50
45
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/foundations/ThemeMenuRadioGroup.tsx"],
4
- "sourcesContent": ["'use client';\n\nimport { useContext, type ReactNode } from 'react';\nimport * as Menu from '../actions/menu/Menu.js';\nimport { useMessages } from '../internal/provider/EnvUIContext.js';\nimport { themePreference } from './messages/themePreference.js';\nimport { ThemePreferenceContext } from './internal/ThemePreferenceContext.js';\nimport type { ThemePreference } from './themeBootstrap.js';\nimport { IconComputer } from '../icons/Computer.js';\nimport { IconDarkMode } from '../icons/DarkMode.js';\nimport { IconLightMode } from '../icons/LightMode.js';\n\nexport interface ThemeMenuRadioGroupProps {\n /**\n * The chosen preference: system, light or dark.\n * @default the nearest ThemePreferenceProvider's preference\n */\n value?: ThemePreference;\n /**\n * Called with the preference chosen, for an application that stores the theme itself.\n * @default the nearest ThemePreferenceProvider's setPreference, which stores the choice\n */\n onValueChange?: (value: ThemePreference) => void;\n /**\n * A small heading above the choices, which names the group. Leave it out inside a submenu, which\n * its row already names.\n */\n label?: ReactNode;\n /** Id of a heading elsewhere in the menu that names the group, in place of label. */\n 'aria-labelledby'?: string;\n /**\n * Close the menu after a choice. Off by default, so people see the theme change with the menu\n * still open.\n * @default false\n */\n closeOnClick?: boolean;\n}\n\nconst choices = [\n { value: 'system', icon: <IconComputer /> },\n { value: 'light', icon: <IconLightMode /> },\n { value: 'dark', icon: <IconDarkMode /> },\n] as const satisfies readonly { value: ThemePreference; icon: ReactNode }[];\n\n/**\n * The theme choice for a Menu: System, Light and Dark as radio items. Inside a\n * ThemePreferenceProvider it shows and stores the provider's preference; value and onValueChange\n * connect it to a theme the application stores itself.\n */\nexport function ThemeMenuRadioGroup({\n value,\n onValueChange,\n label,\n 'aria-labelledby': labelledBy,\n closeOnClick = false,\n}: ThemeMenuRadioGroupProps) {\n const provider = useContext(ThemePreferenceContext);\n const messages = useMessages('themePreference', themePreference);\n const current = value ?? provider?.preference;\n const change = onValueChange ?? provider?.setPreference;\n if (current === undefined || !change)\n throw new Error(\n 'ThemeMenuRadioGroup needs a ThemePreferenceProvider around it, or value and onValueChange.',\n );\n return (\n <Menu.RadioGroup\n value={current}\n onValueChange={(next) => change(next as ThemePreference)}\n label={label}\n aria-labelledby={labelledBy}\n >\n {choices.map((choice) => (\n <Menu.RadioItem\n key={choice.value}\n value={choice.value}\n icon={choice.icon}\n closeOnClick={closeOnClick}\n >\n {messages[choice.value]}\n </Menu.RadioItem>\n ))}\n </Menu.RadioGroup>\n );\n}\n"],
5
- "mappings": ";AAuC2B;AArC3B,SAAS,kBAAkC;AAC3C,YAAY,UAAU;AACtB,SAAS,mBAAmB;AAC5B,SAAS,uBAAuB;AAChC,SAAS,8BAA8B;AAEvC,SAAS,oBAAoB;AAC7B,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AA4B9B,MAAM,UAAU;AAAA,EACd,EAAE,OAAO,UAAU,MAAM,oBAAC,gBAAa,EAAG;AAAA,EAC1C,EAAE,OAAO,SAAS,MAAM,oBAAC,iBAAc,EAAG;AAAA,EAC1C,EAAE,OAAO,QAAQ,MAAM,oBAAC,gBAAa,EAAG;AAC1C;AAOO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA,mBAAmB;AAAA,EACnB,eAAe;AACjB,GAA6B;AAC3B,QAAM,WAAW,WAAW,sBAAsB;AAClD,QAAM,WAAW,YAAY,mBAAmB,eAAe;AAC/D,QAAM,UAAU,SAAS,UAAU;AACnC,QAAM,SAAS,iBAAiB,UAAU;AAC1C,MAAI,YAAY,UAAa,CAAC;AAC5B,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,SACE;AAAA,IAAC,KAAK;AAAA,IAAL;AAAA,MACC,OAAO;AAAA,MACP,eAAe,CAAC,SAAS,OAAO,IAAuB;AAAA,MACvD;AAAA,MACA,mBAAiB;AAAA,MAEhB,kBAAQ,IAAI,CAAC,WACZ;AAAA,QAAC,KAAK;AAAA,QAAL;AAAA,UAEC,OAAO,OAAO;AAAA,UACd,MAAM,OAAO;AAAA,UACb;AAAA,UAEC,mBAAS,OAAO,KAAK;AAAA;AAAA,QALjB,OAAO;AAAA,MAMd,CACD;AAAA;AAAA,EACH;AAEJ;",
4
+ "sourcesContent": ["'use client';\n\nimport { useContext, type ReactNode } from 'react';\nimport * as Menu from '../actions/menu/Menu.js';\nimport { RadioItemsCloseOnClickContext } from '../actions/menu/MenuChoices.js';\nimport { useMessages } from '../internal/provider/EnvUIContext.js';\nimport { themePreference } from './messages/themePreference.js';\nimport { ThemePreferenceContext } from './internal/ThemePreferenceContext.js';\nimport type { ThemePreference } from './themeBootstrap.js';\nimport { IconComputer } from '../icons/Computer.js';\nimport { IconDarkMode } from '../icons/DarkMode.js';\nimport { IconLightMode } from '../icons/LightMode.js';\n\nexport interface ThemeMenuRadioGroupProps {\n /**\n * The chosen preference: system, light or dark.\n * @default the nearest ThemePreferenceProvider's preference\n */\n value?: ThemePreference;\n /**\n * Called with the preference chosen, for a group outside a ThemePreferenceProvider.\n * @default the nearest ThemePreferenceProvider's setPreference\n */\n onValueChange?: (value: ThemePreference) => void;\n /**\n * A small heading above the choices, which names the group. Leave it out inside a submenu, which\n * its row already names.\n */\n label?: ReactNode;\n /** Id of a heading elsewhere in the menu that names the group, in place of label. */\n 'aria-labelledby'?: string;\n /**\n * Close the menu after a choice. Off by default, so people see the theme change with the menu\n * still open. It applies to the choices given as children too, unless one sets its own.\n * @default false\n */\n closeOnClick?: boolean;\n /**\n * The choices, as Menu.RadioItems valued system, light or dark, in place of the three default\n * ones: such as Light and Dark alone, or a choice with a hint beside it.\n */\n children?: ReactNode;\n /** The group's class, beside env-menu-group. */\n className?: string;\n}\n\nconst choices = [\n { value: 'system', icon: <IconComputer /> },\n { value: 'light', icon: <IconLightMode /> },\n { value: 'dark', icon: <IconDarkMode /> },\n] as const satisfies readonly { value: ThemePreference; icon: ReactNode }[];\n\n/**\n * The theme choice for a Menu: System, Light and Dark as radio items. Inside a\n * ThemePreferenceProvider it shows and changes the provider's preference; value and onValueChange\n * connect it to a preference outside one.\n */\nexport function ThemeMenuRadioGroup({\n value,\n onValueChange,\n label,\n 'aria-labelledby': labelledBy,\n closeOnClick = false,\n children,\n className,\n}: ThemeMenuRadioGroupProps) {\n const provider = useContext(ThemePreferenceContext);\n const messages = useMessages('themePreference', themePreference);\n const current = value ?? provider?.preference;\n const change = onValueChange ?? provider?.setPreference;\n if (current === undefined || !change)\n throw new Error(\n 'ThemeMenuRadioGroup needs a ThemePreferenceProvider around it, or value and onValueChange.',\n );\n return (\n <Menu.RadioGroup\n value={current}\n onValueChange={(next) => change(next as ThemePreference)}\n label={label}\n aria-labelledby={labelledBy}\n className={className}\n >\n <RadioItemsCloseOnClickContext value={closeOnClick}>\n {children ??\n choices.map((choice) => (\n <Menu.RadioItem key={choice.value} value={choice.value} start={choice.icon}>\n {messages[choice.value]}\n </Menu.RadioItem>\n ))}\n </RadioItemsCloseOnClickContext>\n </Menu.RadioGroup>\n );\n}\n"],
5
+ "mappings": ";AA+C2B;AA7C3B,SAAS,kBAAkC;AAC3C,YAAY,UAAU;AACtB,SAAS,qCAAqC;AAC9C,SAAS,mBAAmB;AAC5B,SAAS,uBAAuB;AAChC,SAAS,8BAA8B;AAEvC,SAAS,oBAAoB;AAC7B,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAmC9B,MAAM,UAAU;AAAA,EACd,EAAE,OAAO,UAAU,MAAM,oBAAC,gBAAa,EAAG;AAAA,EAC1C,EAAE,OAAO,SAAS,MAAM,oBAAC,iBAAc,EAAG;AAAA,EAC1C,EAAE,OAAO,QAAQ,MAAM,oBAAC,gBAAa,EAAG;AAC1C;AAOO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA,mBAAmB;AAAA,EACnB,eAAe;AAAA,EACf;AAAA,EACA;AACF,GAA6B;AAC3B,QAAM,WAAW,WAAW,sBAAsB;AAClD,QAAM,WAAW,YAAY,mBAAmB,eAAe;AAC/D,QAAM,UAAU,SAAS,UAAU;AACnC,QAAM,SAAS,iBAAiB,UAAU;AAC1C,MAAI,YAAY,UAAa,CAAC;AAC5B,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AACF,SACE;AAAA,IAAC,KAAK;AAAA,IAAL;AAAA,MACC,OAAO;AAAA,MACP,eAAe,CAAC,SAAS,OAAO,IAAuB;AAAA,MACvD;AAAA,MACA,mBAAiB;AAAA,MACjB;AAAA,MAEA,8BAAC,iCAA8B,OAAO,cACnC,sBACC,QAAQ,IAAI,CAAC,WACX,oBAAC,KAAK,WAAL,EAAkC,OAAO,OAAO,OAAO,OAAO,OAAO,MACnE,mBAAS,OAAO,KAAK,KADH,OAAO,KAE5B,CACD,GACL;AAAA;AAAA,EACF;AAEJ;",
6
6
  "names": []
7
7
  }
@@ -0,0 +1,48 @@
1
+ import { type ReactNode } from 'react';
2
+ import type { ThemeDefinition, ThemePreference } from './themeBootstrap.js';
3
+ import { type ThemePreferenceValue } from './internal/ThemePreferenceContext.js';
4
+ export type { ThemePreferenceValue } from './internal/ThemePreferenceContext.js';
5
+ export interface ThemePreferenceProviderProps {
6
+ /** The application, or the part of it that the preference themes. */
7
+ children: ReactNode;
8
+ /**
9
+ * The application's theme, from defineTheme: its contrast, scale, selection and corners. Give
10
+ * createThemeBootstrapScript the same theme, so the root has it before the first paint. Left out,
11
+ * the contrast and scale are an enclosing Theme's, or else the page's on the root, or else
12
+ * system, and the look is an enclosing Theme's, or else neutral and rounded.
13
+ */
14
+ theme?: ThemeDefinition;
15
+ /**
16
+ * The chosen preference, for an application that keeps it itself: in a cookie, the user's
17
+ * account or, with useStoredThemePreference, localStorage. Give onPreferenceChange with it.
18
+ */
19
+ preference?: ThemePreference;
20
+ /**
21
+ * The preference while `preference` is left out, until people choose another.
22
+ * @default 'system'
23
+ */
24
+ defaultPreference?: ThemePreference;
25
+ /** Called with the preference people choose, such as with ThemeToggle, for the application to keep. */
26
+ onPreferenceChange?: (preference: ThemePreference) => void;
27
+ /**
28
+ * Theme the document root as well as this subtree (default). Root theming covers the page
29
+ * background, native controls, portals rendered by other libraries and the content of every
30
+ * theme-color meta tag, which takes the canvas color. One provider per document applies to it:
31
+ * pass false to any other, nested in it or beside it. In development, envUI reports two providers
32
+ * that both apply. Outside any Theme, its boundary around the children is a plain element that
33
+ * takes the root's look, with none of a Theme's class and attributes, unless its contrast is
34
+ * system while the page set a contrast of its own on the root. Rendered on the server, and
35
+ * as the page hydrates, it leaves the page's look to the theme createThemeBootstrapScript gave the
36
+ * root, and a system preference renders light; once hydrated, it themes the root itself.
37
+ */
38
+ applyToDocument?: boolean;
39
+ /** Class name for the Theme boundary around the children. */
40
+ className?: string;
41
+ }
42
+ /**
43
+ * Themes the application by the theme preference, which the application keeps where it chooses,
44
+ * following the system's theme for a system preference, and themes the document root.
45
+ */
46
+ export declare function ThemePreferenceProvider({ children, theme: definition, preference: givenPreference, defaultPreference, onPreferenceChange, applyToDocument, className, }: ThemePreferenceProviderProps): import("react").JSX.Element;
47
+ /** The theme preference from the nearest ThemePreferenceProvider. */
48
+ export declare function useThemePreference(): ThemePreferenceValue;