@envsemble/envui 2.0.0 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1263) hide show
  1. package/CHANGELOG.md +258 -0
  2. package/README.md +14 -27
  3. package/dist/actions/Button.d.ts +25 -8
  4. package/dist/actions/Button.js.map +2 -2
  5. package/dist/actions/CommandPalette.d.ts +37 -9
  6. package/dist/actions/CommandPalette.js +111 -107
  7. package/dist/actions/CommandPalette.js.map +2 -2
  8. package/dist/actions/ConfirmButton.d.ts +1 -1
  9. package/dist/actions/ConfirmButton.js +2 -4
  10. package/dist/actions/ConfirmButton.js.map +2 -2
  11. package/dist/actions/ContextMenu.d.ts +1 -1
  12. package/dist/actions/ContextMenu.js +5 -6
  13. package/dist/actions/ContextMenu.js.map +2 -2
  14. package/dist/actions/CopyButton.js +2 -2
  15. package/dist/actions/CopyButton.js.map +2 -2
  16. package/dist/actions/Menubar.d.ts +12 -5
  17. package/dist/actions/Menubar.js +37 -29
  18. package/dist/actions/Menubar.js.map +3 -3
  19. package/dist/actions/Toolbar.d.ts +42 -2
  20. package/dist/actions/Toolbar.js +18 -0
  21. package/dist/actions/Toolbar.js.map +2 -2
  22. package/dist/actions/internal/ButtonBase.d.ts +3 -2
  23. package/dist/actions/internal/ButtonBase.js +2 -4
  24. package/dist/actions/internal/ButtonBase.js.map +2 -2
  25. package/dist/actions/internal/CommandPaletteOptions.d.ts +7 -6
  26. package/dist/actions/internal/CommandPaletteOptions.js +24 -15
  27. package/dist/actions/internal/CommandPaletteOptions.js.map +2 -2
  28. package/dist/actions/internal/CommandPaletteStatus.js +23 -9
  29. package/dist/actions/internal/CommandPaletteStatus.js.map +2 -2
  30. package/dist/actions/menu/Menu.d.ts +5 -4
  31. package/dist/actions/menu/Menu.js +3 -6
  32. package/dist/actions/menu/Menu.js.map +2 -2
  33. package/dist/actions/menu/MenuChoices.d.ts +9 -7
  34. package/dist/actions/menu/MenuChoices.js +34 -6
  35. package/dist/actions/menu/MenuChoices.js.map +2 -2
  36. package/dist/actions/menu/MenuItem.d.ts +37 -8
  37. package/dist/actions/menu/MenuItem.js +47 -12
  38. package/dist/actions/menu/MenuItem.js.map +2 -2
  39. package/dist/actions/menu/MenuSubmenu.d.ts +9 -3
  40. package/dist/actions/menu/MenuSubmenu.js +26 -24
  41. package/dist/actions/menu/MenuSubmenu.js.map +2 -2
  42. package/dist/actions/{internal → menu/internal}/MenuPopup.d.ts +2 -3
  43. package/dist/actions/{internal → menu/internal}/MenuPopup.js +7 -12
  44. package/dist/actions/menu/internal/MenuPopup.js.map +7 -0
  45. package/dist/actions/{internal → menu/internal}/menuOpenChange.d.ts +1 -1
  46. package/dist/actions/menu/internal/menuTriggerProps.d.ts +11 -0
  47. package/dist/actions/menu/internal/menuTriggerProps.js +1 -0
  48. package/dist/assets/readme/overview-dark.png +0 -0
  49. package/dist/assets/readme/overview-light.png +0 -0
  50. package/dist/content/Accordion.d.ts +32 -2
  51. package/dist/content/Accordion.js +41 -12
  52. package/dist/content/Accordion.js.map +2 -2
  53. package/dist/content/CodeBlock.d.ts +13 -4
  54. package/dist/content/CodeBlock.js +2 -0
  55. package/dist/content/CodeBlock.js.map +2 -2
  56. package/dist/content/CodeDiff.d.ts +34 -4
  57. package/dist/content/CodeDiff.js +41 -24
  58. package/dist/content/CodeDiff.js.map +2 -2
  59. package/dist/content/Composer.d.ts +19 -2
  60. package/dist/content/Composer.js +19 -12
  61. package/dist/content/Composer.js.map +2 -2
  62. package/dist/content/Disclosure.d.ts +13 -1
  63. package/dist/content/Disclosure.js +9 -3
  64. package/dist/content/Disclosure.js.map +2 -2
  65. package/dist/content/HighlightedCodeBlock.d.ts +1 -1
  66. package/dist/content/HighlightedCodeBlock.js +2 -0
  67. package/dist/content/HighlightedCodeBlock.js.map +2 -2
  68. package/dist/content/Kbd.d.ts +12 -5
  69. package/dist/content/Kbd.js +2 -2
  70. package/dist/content/Kbd.js.map +2 -2
  71. package/dist/content/Markdown.d.ts +17 -1
  72. package/dist/content/Markdown.js +26 -4
  73. package/dist/content/Markdown.js.map +2 -2
  74. package/dist/content/Message.d.ts +29 -33
  75. package/dist/content/Message.js +21 -21
  76. package/dist/content/Message.js.map +2 -2
  77. package/dist/content/countDiffLines.d.ts +1 -1
  78. package/dist/content/countDiffLines.js.map +1 -1
  79. package/dist/content/internal/CodeBlockFrame.d.ts +3 -2
  80. package/dist/content/internal/CodeBlockFrame.js +25 -13
  81. package/dist/content/internal/CodeBlockFrame.js.map +2 -2
  82. package/dist/content/internal/MessageListFollow.js +1 -1
  83. package/dist/content/internal/MessageListFollow.js.map +2 -2
  84. package/dist/content/internal/MessageStatusLabel.d.ts +2 -1
  85. package/dist/content/internal/MessageStatusLabel.js.map +2 -2
  86. package/dist/content/internal/codeColors.js +2 -2
  87. package/dist/content/internal/codeColors.js.map +2 -2
  88. package/dist/content/internal/useCodeContrast.js +4 -3
  89. package/dist/content/internal/useCodeContrast.js.map +2 -2
  90. package/dist/data-display/Avatar.d.ts +13 -4
  91. package/dist/data-display/Avatar.js +8 -4
  92. package/dist/data-display/Avatar.js.map +2 -2
  93. package/dist/data-display/AvatarButton.d.ts +20 -5
  94. package/dist/data-display/AvatarButton.js +17 -2
  95. package/dist/data-display/AvatarButton.js.map +2 -2
  96. package/dist/data-display/AvatarGroup.d.ts +28 -12
  97. package/dist/data-display/AvatarGroup.js +21 -32
  98. package/dist/data-display/AvatarGroup.js.map +2 -2
  99. package/dist/data-display/Badge.d.ts +11 -8
  100. package/dist/data-display/Badge.js +4 -3
  101. package/dist/data-display/Badge.js.map +2 -2
  102. package/dist/data-display/List.d.ts +21 -9
  103. package/dist/data-display/List.js +1 -1
  104. package/dist/data-display/List.js.map +2 -2
  105. package/dist/data-display/Meter.d.ts +7 -1
  106. package/dist/data-display/Meter.js +11 -5
  107. package/dist/data-display/Meter.js.map +2 -2
  108. package/dist/data-display/RelativeTime.d.ts +8 -2
  109. package/dist/data-display/RelativeTime.js +18 -7
  110. package/dist/data-display/RelativeTime.js.map +2 -2
  111. package/dist/data-display/Table.d.ts +26 -7
  112. package/dist/data-display/Table.js +70 -65
  113. package/dist/data-display/Table.js.map +2 -2
  114. package/dist/data-display/formatRelativeTime.d.ts +0 -2
  115. package/dist/data-display/formatRelativeTime.js +4 -28
  116. package/dist/data-display/formatRelativeTime.js.map +2 -2
  117. package/dist/data-display/internal/ListNaming.js +1 -1
  118. package/dist/data-display/internal/ListNaming.js.map +1 -1
  119. package/dist/data-display/internal/ReorderableList.d.ts +3 -2
  120. package/dist/data-display/internal/ReorderableList.js +11 -16
  121. package/dist/data-display/internal/ReorderableList.js.map +2 -2
  122. package/dist/data-display/internal/avatarName.d.ts +2 -0
  123. package/dist/data-display/internal/avatarName.js +7 -0
  124. package/dist/data-display/internal/avatarName.js.map +7 -0
  125. package/dist/data-display/internal/{ListRows.d.ts → listMarkup.d.ts} +1 -1
  126. package/dist/data-display/internal/{ListRows.js → listMarkup.js} +29 -15
  127. package/dist/data-display/internal/listMarkup.js.map +7 -0
  128. package/dist/data-display/internal/relativeTimeFormat.d.ts +3 -0
  129. package/dist/data-display/internal/relativeTimeFormat.js +12 -0
  130. package/dist/data-display/internal/relativeTimeFormat.js.map +7 -0
  131. package/dist/data-display/internal/reorderController.js +3 -3
  132. package/dist/data-display/internal/reorderController.js.map +2 -2
  133. package/dist/data-display/internal/reorderGeometry.d.ts +0 -1
  134. package/dist/data-display/internal/reorderGeometry.js +1 -10
  135. package/dist/data-display/internal/reorderGeometry.js.map +2 -2
  136. package/dist/data-display/internal/tableColumns.js +8 -9
  137. package/dist/data-display/internal/tableColumns.js.map +2 -2
  138. package/dist/{internal/react/useStackedReport.d.ts → data-display/internal/tableStacking.d.ts} +2 -0
  139. package/dist/data-display/internal/tableStacking.js +49 -0
  140. package/dist/data-display/internal/tableStacking.js.map +7 -0
  141. package/dist/data-display/internal/useReorder.js +1 -1
  142. package/dist/data-display/internal/useReorder.js.map +1 -1
  143. package/dist/diff.d.ts +1 -1
  144. package/dist/diff.js +1 -4
  145. package/dist/diff.js.map +2 -2
  146. package/dist/feedback/Alert.d.ts +13 -3
  147. package/dist/feedback/Alert.js +16 -6
  148. package/dist/feedback/Alert.js.map +2 -2
  149. package/dist/feedback/EmptyState.d.ts +12 -3
  150. package/dist/feedback/EmptyState.js +6 -6
  151. package/dist/feedback/EmptyState.js.map +2 -2
  152. package/dist/feedback/Halo.d.ts +27 -0
  153. package/dist/feedback/Halo.js +21 -0
  154. package/dist/feedback/Halo.js.map +7 -0
  155. package/dist/feedback/Progress.js +3 -2
  156. package/dist/feedback/Progress.js.map +2 -2
  157. package/dist/feedback/toast/ToastProvider.js +1 -1
  158. package/dist/feedback/toast/ToastProvider.js.map +1 -1
  159. package/dist/feedback/toast/internal/ContainedToast.d.ts +12 -0
  160. package/dist/feedback/toast/internal/ContainedToast.js +43 -0
  161. package/dist/feedback/toast/internal/ContainedToast.js.map +7 -0
  162. package/dist/feedback/toast/internal/{PictureNotice.d.ts → ContainedToastRoot.d.ts} +1 -1
  163. package/dist/feedback/toast/internal/{PictureNotice.js → ContainedToastRoot.js} +3 -3
  164. package/dist/feedback/toast/internal/ContainedToastRoot.js.map +7 -0
  165. package/dist/feedback/toast/internal/LiveToast.d.ts +10 -0
  166. package/dist/feedback/toast/internal/LiveToast.js +78 -0
  167. package/dist/feedback/toast/internal/LiveToast.js.map +7 -0
  168. package/dist/feedback/toast/internal/ToastBody.d.ts +2 -1
  169. package/dist/feedback/toast/internal/ToastBody.js +6 -2
  170. package/dist/feedback/toast/internal/ToastBody.js.map +2 -2
  171. package/dist/feedback/toast/internal/ToastButtons.d.ts +14 -0
  172. package/dist/feedback/toast/internal/ToastButtons.js +77 -0
  173. package/dist/feedback/toast/internal/ToastButtons.js.map +7 -0
  174. package/dist/feedback/toast/internal/ToastManagerContext.d.ts +3 -0
  175. package/dist/feedback/toast/internal/ToastManagerContext.js +7 -0
  176. package/dist/feedback/toast/internal/ToastManagerContext.js.map +7 -0
  177. package/dist/feedback/toast/internal/ToastRegion.js +43 -172
  178. package/dist/feedback/toast/internal/ToastRegion.js.map +2 -2
  179. package/dist/feedback/toast/internal/toastEntry.d.ts +9 -2
  180. package/dist/feedback/toast/internal/toastEntry.js +10 -1
  181. package/dist/feedback/toast/internal/toastEntry.js.map +2 -2
  182. package/dist/feedback/toast/internal/useToastController.d.ts +3 -3
  183. package/dist/feedback/toast/internal/useToastController.js +4 -2
  184. package/dist/feedback/toast/internal/useToastController.js.map +2 -2
  185. package/dist/feedback/toast/internal/useToastGlide.js +2 -1
  186. package/dist/feedback/toast/internal/useToastGlide.js.map +2 -2
  187. package/dist/feedback/toast/toastTypes.d.ts +38 -11
  188. package/dist/feedback/toast/useToast.d.ts +0 -2
  189. package/dist/feedback/toast/useToast.js +2 -3
  190. package/dist/feedback/toast/useToast.js.map +2 -2
  191. package/dist/forms/Calendar.d.ts +30 -11
  192. package/dist/forms/Calendar.js +19 -13
  193. package/dist/forms/Calendar.js.map +2 -2
  194. package/dist/forms/Checkbox.d.ts +7 -1
  195. package/dist/forms/Checkbox.js +33 -27
  196. package/dist/forms/Checkbox.js.map +2 -2
  197. package/dist/forms/Combobox.d.ts +4 -4
  198. package/dist/forms/Combobox.js +26 -146
  199. package/dist/forms/Combobox.js.map +2 -2
  200. package/dist/forms/DatePicker.d.ts +38 -11
  201. package/dist/forms/DatePicker.js +32 -52
  202. package/dist/forms/DatePicker.js.map +2 -2
  203. package/dist/forms/DropZone.d.ts +23 -4
  204. package/dist/forms/DropZone.js +29 -11
  205. package/dist/forms/DropZone.js.map +2 -2
  206. package/dist/forms/Field.d.ts +7 -1
  207. package/dist/forms/Field.js +13 -6
  208. package/dist/forms/Field.js.map +2 -2
  209. package/dist/forms/MonthPicker.d.ts +8 -1
  210. package/dist/forms/MonthPicker.js +22 -42
  211. package/dist/forms/MonthPicker.js.map +2 -2
  212. package/dist/forms/Radio.d.ts +15 -5
  213. package/dist/forms/Radio.js +20 -18
  214. package/dist/forms/Radio.js.map +2 -2
  215. package/dist/forms/SearchField.d.ts +13 -5
  216. package/dist/forms/SearchField.js +26 -21
  217. package/dist/forms/SearchField.js.map +2 -2
  218. package/dist/forms/SegmentedControl.d.ts +37 -8
  219. package/dist/forms/SegmentedControl.js +31 -25
  220. package/dist/forms/SegmentedControl.js.map +2 -2
  221. package/dist/forms/Select.d.ts +31 -6
  222. package/dist/forms/Select.js +43 -24
  223. package/dist/forms/Select.js.map +2 -2
  224. package/dist/forms/Slider.d.ts +12 -4
  225. package/dist/forms/Slider.js +32 -21
  226. package/dist/forms/Slider.js.map +2 -2
  227. package/dist/forms/Switch.d.ts +7 -1
  228. package/dist/forms/Switch.js +31 -25
  229. package/dist/forms/Switch.js.map +2 -2
  230. package/dist/forms/TextField.d.ts +5 -5
  231. package/dist/forms/TextField.js +20 -11
  232. package/dist/forms/TextField.js.map +2 -2
  233. package/dist/forms/Textarea.d.ts +1 -1
  234. package/dist/forms/Textarea.js +12 -2
  235. package/dist/forms/Textarea.js.map +2 -2
  236. package/dist/forms/TimePicker.d.ts +8 -1
  237. package/dist/forms/TimePicker.js +20 -45
  238. package/dist/forms/TimePicker.js.map +2 -2
  239. package/dist/forms/color/ColorPicker.d.ts +1 -1
  240. package/dist/forms/color/ColorPicker.js +29 -23
  241. package/dist/forms/color/ColorPicker.js.map +2 -2
  242. package/dist/forms/color/ColorPickerButton.d.ts +12 -2
  243. package/dist/forms/color/ColorPickerButton.js +37 -22
  244. package/dist/forms/color/ColorPickerButton.js.map +2 -2
  245. package/dist/forms/color/ColorSwatch.js +2 -2
  246. package/dist/forms/color/ColorSwatch.js.map +2 -2
  247. package/dist/forms/color/internal/{colorChange.js → ColorChangeContext.js} +1 -1
  248. package/dist/forms/color/internal/{colorChange.js.map → ColorChangeContext.js.map} +1 -1
  249. package/dist/forms/color/internal/ColorLocale.d.ts +0 -3
  250. package/dist/forms/color/internal/ColorLocale.js +2 -8
  251. package/dist/forms/color/internal/ColorLocale.js.map +2 -2
  252. package/dist/forms/color/internal/ColorValues.d.ts +1 -1
  253. package/dist/forms/color/internal/ColorValues.js +2 -2
  254. package/dist/forms/color/internal/ColorValues.js.map +2 -2
  255. package/dist/forms/color/internal/SwatchList.js +6 -9
  256. package/dist/forms/color/internal/SwatchList.js.map +2 -2
  257. package/dist/forms/color/internal/colorPickerValueProps.d.ts +12 -0
  258. package/dist/forms/color/internal/colorValue.d.ts +1 -0
  259. package/dist/forms/color/internal/colorValue.js +5 -0
  260. package/dist/forms/color/internal/colorValue.js.map +2 -2
  261. package/dist/forms/color/internal/useColorFollowingValue.d.ts +7 -0
  262. package/dist/forms/color/internal/useColorFollowingValue.js +15 -0
  263. package/dist/forms/color/internal/useColorFollowingValue.js.map +7 -0
  264. package/dist/forms/color/internal/useFormResetting.d.ts +9 -0
  265. package/dist/forms/color/internal/useFormResetting.js +36 -0
  266. package/dist/forms/color/internal/useFormResetting.js.map +7 -0
  267. package/dist/forms/color/internal/useSwatchFocus.d.ts +17 -0
  268. package/dist/forms/color/internal/useSwatchFocus.js +62 -0
  269. package/dist/forms/color/internal/useSwatchFocus.js.map +7 -0
  270. package/dist/forms/internal/ComboboxField.d.ts +30 -0
  271. package/dist/forms/internal/ComboboxField.js +147 -0
  272. package/dist/forms/internal/ComboboxField.js.map +7 -0
  273. package/dist/forms/internal/ComboboxPopup.d.ts +2 -2
  274. package/dist/forms/internal/ComboboxPopup.js +8 -16
  275. package/dist/forms/internal/ComboboxPopup.js.map +2 -2
  276. package/dist/forms/internal/MonthGrid.d.ts +1 -1
  277. package/dist/forms/internal/MonthGrid.js +4 -4
  278. package/dist/forms/internal/MonthGrid.js.map +2 -2
  279. package/dist/forms/internal/PickerField.d.ts +32 -27
  280. package/dist/forms/internal/PickerField.js +70 -52
  281. package/dist/forms/internal/PickerField.js.map +3 -3
  282. package/dist/forms/internal/PickerPopup.d.ts +2 -1
  283. package/dist/forms/internal/PickerPopup.js +3 -0
  284. package/dist/forms/internal/PickerPopup.js.map +2 -2
  285. package/dist/forms/internal/TimeList.d.ts +1 -1
  286. package/dist/forms/internal/TimeList.js +4 -4
  287. package/dist/forms/internal/TimeList.js.map +2 -2
  288. package/dist/forms/internal/TimeWheel.d.ts +3 -3
  289. package/dist/forms/internal/TimeWheel.js +5 -5
  290. package/dist/forms/internal/TimeWheel.js.map +2 -2
  291. package/dist/{internal/time → forms/internal}/calendarDays.d.ts +1 -0
  292. package/dist/{internal/time → forms/internal}/calendarDays.js +5 -1
  293. package/dist/forms/internal/calendarDays.js.map +7 -0
  294. package/dist/forms/internal/comboboxItems.d.ts +15 -4
  295. package/dist/forms/internal/comboboxItems.js +0 -12
  296. package/dist/forms/internal/comboboxItems.js.map +3 -3
  297. package/dist/forms/internal/pickerFocus.d.ts +4 -0
  298. package/dist/forms/internal/pickerFocus.js +13 -0
  299. package/dist/forms/internal/pickerFocus.js.map +7 -0
  300. package/dist/forms/internal/timeWheelRows.d.ts +4 -4
  301. package/dist/forms/internal/timeWheelRows.js +6 -4
  302. package/dist/forms/internal/timeWheelRows.js.map +2 -2
  303. package/dist/forms/internal/useComboboxOpen.js +2 -5
  304. package/dist/forms/internal/useComboboxOpen.js.map +2 -2
  305. package/dist/forms/internal/useComboboxOptions.js +3 -4
  306. package/dist/forms/internal/useComboboxOptions.js.map +2 -2
  307. package/dist/forms/internal/useComboboxSelection.d.ts +1 -1
  308. package/dist/forms/internal/usePicker.d.ts +29 -0
  309. package/dist/forms/internal/usePicker.js +38 -0
  310. package/dist/forms/internal/usePicker.js.map +7 -0
  311. package/dist/forms/internal/usePickerFormatter.d.ts +4 -0
  312. package/dist/forms/internal/usePickerFormatter.js +23 -0
  313. package/dist/forms/internal/usePickerFormatter.js.map +7 -0
  314. package/dist/forms/internal/useTimeWheelTurn.d.ts +2 -2
  315. package/dist/forms/internal/useTimeWheelTurn.js +7 -7
  316. package/dist/forms/internal/useTimeWheelTurn.js.map +2 -2
  317. package/dist/foundations/PortalContainer.js +1 -1
  318. package/dist/foundations/PortalContainer.js.map +1 -1
  319. package/dist/foundations/Theme.d.ts +9 -2
  320. package/dist/foundations/Theme.js +24 -19
  321. package/dist/foundations/Theme.js.map +2 -2
  322. package/dist/foundations/ThemeMenuRadioGroup.d.ts +13 -6
  323. package/dist/foundations/ThemeMenuRadioGroup.js +6 -11
  324. package/dist/foundations/ThemeMenuRadioGroup.js.map +2 -2
  325. package/dist/foundations/ThemePreferenceProvider.d.ts +48 -0
  326. package/dist/foundations/{ThemePreference.js → ThemePreferenceProvider.js} +48 -106
  327. package/dist/foundations/ThemePreferenceProvider.js.map +7 -0
  328. package/dist/foundations/ThemeToggle.d.ts +9 -2
  329. package/dist/foundations/ThemeToggle.js +3 -2
  330. package/dist/foundations/ThemeToggle.js.map +2 -2
  331. package/dist/foundations/internal/ThemePreferenceContext.d.ts +4 -4
  332. package/dist/foundations/internal/ThemePreferenceContext.js.map +1 -1
  333. package/dist/foundations/internal/storedPreference.d.ts +3 -0
  334. package/dist/foundations/internal/storedPreference.js +8 -0
  335. package/dist/foundations/internal/storedPreference.js.map +7 -0
  336. package/dist/foundations/messages/defaultMessages.d.ts +4 -72
  337. package/dist/foundations/messages/defaultMessages.js +0 -14
  338. package/dist/foundations/messages/defaultMessages.js.map +2 -2
  339. package/dist/foundations/messages/list.d.ts +13 -35
  340. package/dist/foundations/messages/list.js +1 -5
  341. package/dist/foundations/messages/list.js.map +2 -2
  342. package/dist/foundations/messages/message.d.ts +1 -1
  343. package/dist/foundations/messages/message.js +1 -1
  344. package/dist/foundations/messages/message.js.map +1 -1
  345. package/dist/foundations/messages/navigation.d.ts +4 -0
  346. package/dist/foundations/messages/navigation.js +2 -0
  347. package/dist/foundations/messages/navigation.js.map +2 -2
  348. package/dist/foundations/themeBootstrap.d.ts +13 -35
  349. package/dist/foundations/themeBootstrap.js +4 -35
  350. package/dist/foundations/themeBootstrap.js.map +2 -2
  351. package/dist/foundations/themeStorage.d.ts +20 -0
  352. package/dist/foundations/themeStorage.js +12 -0
  353. package/dist/foundations/themeStorage.js.map +7 -0
  354. package/dist/foundations/useContainerSize.js +13 -11
  355. package/dist/foundations/useContainerSize.js.map +2 -2
  356. package/dist/foundations/useSkeleton.d.ts +5 -0
  357. package/dist/foundations/useSkeleton.js +10 -0
  358. package/dist/foundations/useSkeleton.js.map +7 -0
  359. package/dist/foundations/useStoredThemePreference.d.ts +16 -0
  360. package/dist/foundations/useStoredThemePreference.js +63 -0
  361. package/dist/foundations/useStoredThemePreference.js.map +7 -0
  362. package/dist/foundations/windowClasses.d.ts +0 -2
  363. package/dist/foundations/windowClasses.js +1 -4
  364. package/dist/foundations/windowClasses.js.map +2 -2
  365. package/dist/index.d.ts +15 -20
  366. package/dist/index.js +16 -36
  367. package/dist/index.js.map +2 -2
  368. package/dist/internal/control/ActionElement.d.ts +3 -2
  369. package/dist/internal/control/ActionElement.js +8 -0
  370. package/dist/internal/control/ActionElement.js.map +2 -2
  371. package/dist/internal/dialog/ModalLayer.d.ts +9 -0
  372. package/dist/internal/dialog/ModalLayer.js +32 -0
  373. package/dist/internal/dialog/ModalLayer.js.map +7 -0
  374. package/dist/internal/dom/idRefs.d.ts +2 -0
  375. package/dist/internal/dom/idRefs.js +7 -0
  376. package/dist/internal/dom/idRefs.js.map +7 -0
  377. package/dist/internal/dom/lengths.d.ts +3 -1
  378. package/dist/internal/dom/lengths.js +7 -2
  379. package/dist/internal/dom/lengths.js.map +2 -2
  380. package/dist/internal/dom/observeResize.d.ts +7 -0
  381. package/dist/internal/dom/observeResize.js +11 -0
  382. package/dist/internal/dom/observeResize.js.map +7 -0
  383. package/dist/internal/dom/verticalScrollerOf.d.ts +5 -0
  384. package/dist/internal/dom/verticalScrollerOf.js +12 -0
  385. package/dist/internal/dom/verticalScrollerOf.js.map +7 -0
  386. package/dist/internal/field/FieldFrame.d.ts +2 -61
  387. package/dist/internal/field/FieldFrame.js +17 -8
  388. package/dist/internal/field/FieldFrame.js.map +2 -2
  389. package/dist/internal/field/{rowControl.d.ts → RowControl.d.ts} +2 -2
  390. package/dist/internal/field/{rowControl.js → RowControl.js} +4 -7
  391. package/dist/internal/field/RowControl.js.map +7 -0
  392. package/dist/internal/field/TextareaControl.d.ts +2 -2
  393. package/dist/internal/field/TextareaControl.js +5 -11
  394. package/dist/internal/field/TextareaControl.js.map +2 -2
  395. package/dist/internal/field/{TextareaResizeEdge.d.ts → TextareaResizeHandle.d.ts} +1 -1
  396. package/dist/internal/field/{TextareaResizeEdge.js → TextareaResizeHandle.js} +10 -11
  397. package/dist/internal/field/TextareaResizeHandle.js.map +7 -0
  398. package/dist/internal/field/fieldProps.d.ts +67 -0
  399. package/dist/internal/field/fieldProps.js +1 -0
  400. package/dist/internal/field/fieldProps.js.map +7 -0
  401. package/dist/internal/field/fieldSizing.d.ts +1 -0
  402. package/dist/internal/field/fieldSizing.js +5 -0
  403. package/dist/internal/field/fieldSizing.js.map +7 -0
  404. package/dist/internal/field/useFieldControl.d.ts +36 -0
  405. package/dist/internal/field/useFieldControl.js +53 -0
  406. package/dist/internal/field/useFieldControl.js.map +7 -0
  407. package/dist/internal/field/useFormReset.js +1 -1
  408. package/dist/internal/field/useFormReset.js.map +1 -1
  409. package/dist/internal/icon/DecorativeIcon.d.ts +2 -1
  410. package/dist/internal/icon/DecorativeIcon.js +6 -2
  411. package/dist/internal/icon/DecorativeIcon.js.map +2 -2
  412. package/dist/internal/layout/Slot.d.ts +2 -1
  413. package/dist/internal/layout/Slot.js +3 -1
  414. package/dist/internal/layout/Slot.js.map +2 -2
  415. package/dist/internal/popup/ListRow.d.ts +39 -0
  416. package/dist/internal/{list → popup}/ListRow.js +15 -7
  417. package/dist/internal/popup/ListRow.js.map +7 -0
  418. package/dist/internal/popup/PopupSurface.d.ts +1 -1
  419. package/dist/internal/popup/PopupSurface.js +3 -6
  420. package/dist/internal/popup/PopupSurface.js.map +2 -2
  421. package/dist/internal/popup/TooltipPopup.d.ts +3 -9
  422. package/dist/internal/popup/TooltipPopup.js +2 -9
  423. package/dist/internal/popup/TooltipPopup.js.map +2 -2
  424. package/dist/internal/popup/{PortalContainerContext.d.ts → containedOverlays.d.ts} +2 -14
  425. package/dist/internal/popup/{PortalContainerContext.js → containedOverlays.js} +7 -13
  426. package/dist/internal/popup/containedOverlays.js.map +7 -0
  427. package/dist/internal/popup/listEntries.d.ts +13 -0
  428. package/dist/internal/popup/listEntries.js +11 -0
  429. package/dist/internal/popup/listEntries.js.map +7 -0
  430. package/dist/internal/popup/useCutShort.d.ts +6 -0
  431. package/dist/internal/popup/useCutShort.js +19 -0
  432. package/dist/internal/popup/useCutShort.js.map +7 -0
  433. package/dist/internal/provider/PortalContainerContext.d.ts +14 -0
  434. package/dist/internal/provider/PortalContainerContext.js +11 -0
  435. package/dist/internal/provider/PortalContainerContext.js.map +7 -0
  436. package/dist/internal/provider/formatters.d.ts +17 -0
  437. package/dist/internal/provider/formatters.js +21 -0
  438. package/dist/internal/provider/formatters.js.map +7 -0
  439. package/dist/internal/provider/locale.d.ts +4 -4
  440. package/dist/internal/provider/locale.js +9 -1
  441. package/dist/internal/provider/locale.js.map +2 -2
  442. package/dist/internal/provider/useDirection.d.ts +1 -1
  443. package/dist/internal/provider/useDirection.js +2 -14
  444. package/dist/internal/provider/useDirection.js.map +2 -2
  445. package/dist/internal/provider/useFormatters.d.ts +1 -16
  446. package/dist/internal/provider/useFormatters.js +3 -26
  447. package/dist/internal/provider/useFormatters.js.map +2 -2
  448. package/dist/internal/rangeBarProps.d.ts +6 -2
  449. package/dist/internal/react/chainHandlers.d.ts +6 -0
  450. package/dist/internal/react/chainHandlers.js +12 -0
  451. package/dist/internal/react/chainHandlers.js.map +7 -0
  452. package/dist/internal/react/renderElement.js +2 -14
  453. package/dist/internal/react/renderElement.js.map +2 -2
  454. package/dist/internal/react/rendersContent.d.ts +2 -0
  455. package/dist/internal/react/rendersContent.js +7 -0
  456. package/dist/internal/react/rendersContent.js.map +7 -0
  457. package/dist/internal/react/setRef.d.ts +6 -1
  458. package/dist/internal/react/setRef.js +13 -0
  459. package/dist/internal/react/setRef.js.map +2 -2
  460. package/dist/internal/react/useControllableState.js +1 -1
  461. package/dist/internal/react/useControllableState.js.map +1 -1
  462. package/dist/internal/{useCopy.js.map → react/useCopy.js.map} +1 -1
  463. package/dist/internal/{useLatest.js.map → react/useLatest.js.map} +1 -1
  464. package/dist/internal/react/useMergedRefs.d.ts +3 -0
  465. package/dist/internal/react/useMergedRefs.js +10 -0
  466. package/dist/internal/react/useMergedRefs.js.map +7 -0
  467. package/dist/internal/resize/useResizableWidth.d.ts +4 -16
  468. package/dist/internal/resize/useResizableWidth.js +5 -17
  469. package/dist/internal/resize/useResizableWidth.js.map +2 -2
  470. package/dist/internal/sizeTokens.d.ts +13 -0
  471. package/dist/internal/sizeTokens.js +15 -0
  472. package/dist/internal/sizeTokens.js.map +7 -0
  473. package/dist/internal/skeleton/SkeletonContext.d.ts +2 -0
  474. package/dist/internal/skeleton/SkeletonContext.js +7 -0
  475. package/dist/internal/skeleton/SkeletonContext.js.map +7 -0
  476. package/dist/{foundations → internal/skeleton}/SkeletonScope.d.ts +0 -10
  477. package/dist/{foundations → internal/skeleton}/SkeletonScope.js +6 -11
  478. package/dist/internal/skeleton/SkeletonScope.js.map +7 -0
  479. package/dist/internal/{skeleton.d.ts → skeleton/skeleton.d.ts} +1 -3
  480. package/dist/internal/{skeleton.js → skeleton/skeleton.js} +1 -2
  481. package/dist/internal/skeleton/skeleton.js.map +7 -0
  482. package/dist/{foundations/internal → internal/skeleton}/skeletonText.js +5 -5
  483. package/dist/internal/skeleton/skeletonText.js.map +7 -0
  484. package/dist/internal/text/labelText.d.ts +15 -0
  485. package/dist/internal/text/labelText.js +34 -0
  486. package/dist/internal/text/labelText.js.map +7 -0
  487. package/dist/internal/text/useRenderedText.d.ts +3 -0
  488. package/dist/internal/text/useRenderedText.js +19 -0
  489. package/dist/internal/text/useRenderedText.js.map +7 -0
  490. package/dist/internal/theme/themeRoot.d.ts +27 -0
  491. package/dist/internal/theme/themeRoot.js +45 -0
  492. package/dist/internal/theme/themeRoot.js.map +7 -0
  493. package/dist/internal/typeahead.d.ts +9 -5
  494. package/dist/internal/typeahead.js +4 -1
  495. package/dist/internal/typeahead.js.map +2 -2
  496. package/dist/layout/Card.d.ts +21 -4
  497. package/dist/layout/Card.js +12 -6
  498. package/dist/layout/Card.js.map +2 -2
  499. package/dist/layout/Layout.d.ts +2 -2
  500. package/dist/layout/Layout.js.map +1 -1
  501. package/dist/layout/Page.d.ts +2 -2
  502. package/dist/layout/Page.js.map +1 -1
  503. package/dist/layout/PageHeader.d.ts +6 -1
  504. package/dist/layout/PageHeader.js +3 -1
  505. package/dist/layout/PageHeader.js.map +2 -2
  506. package/dist/layout/Panes.d.ts +10 -20
  507. package/dist/layout/Panes.js +5 -25
  508. package/dist/layout/Panes.js.map +2 -2
  509. package/dist/layout/ResizeHandle.d.ts +1 -0
  510. package/dist/layout/ResizeHandle.js +11 -21
  511. package/dist/layout/ResizeHandle.js.map +2 -2
  512. package/dist/layout/Scaffold.d.ts +14 -4
  513. package/dist/layout/Scaffold.js +16 -51
  514. package/dist/layout/Scaffold.js.map +2 -2
  515. package/dist/layout/Surface.d.ts +1 -1
  516. package/dist/layout/Surface.js +4 -1
  517. package/dist/layout/Surface.js.map +2 -2
  518. package/dist/layout/TopBar.d.ts +2 -2
  519. package/dist/layout/TopBar.js +4 -5
  520. package/dist/layout/TopBar.js.map +2 -2
  521. package/dist/layout/internal/LoadingBar.d.ts +3 -7
  522. package/dist/layout/internal/LoadingBar.js +5 -10
  523. package/dist/layout/internal/LoadingBar.js.map +2 -2
  524. package/dist/layout/internal/PageTitleFocus.d.ts +0 -9
  525. package/dist/layout/internal/PageTitleFocus.js +3 -24
  526. package/dist/layout/internal/PageTitleFocus.js.map +2 -2
  527. package/dist/layout/internal/StickyHeaderSize.js +3 -3
  528. package/dist/layout/internal/StickyHeaderSize.js.map +2 -2
  529. package/dist/layout/internal/{navigationForms.d.ts → scaffold/navigationForms.d.ts} +2 -2
  530. package/dist/layout/internal/scaffold/navigationForms.js.map +7 -0
  531. package/dist/layout/internal/{scaffoldFocus.js.map → scaffold/scaffoldFocus.js.map} +1 -1
  532. package/dist/layout/internal/{scrollKeys.js → scaffold/scrollKeys.js} +1 -1
  533. package/dist/layout/internal/scaffold/scrollKeys.js.map +7 -0
  534. package/dist/layout/internal/scaffold/useBarSizes.d.ts +6 -0
  535. package/dist/layout/internal/scaffold/useBarSizes.js +54 -0
  536. package/dist/layout/internal/scaffold/useBarSizes.js.map +7 -0
  537. package/dist/layout/internal/{useNavigationFocusHandoff.js → scaffold/useNavigationFocusHandoff.js} +5 -4
  538. package/dist/layout/internal/scaffold/useNavigationFocusHandoff.js.map +7 -0
  539. package/dist/layout/internal/{useScrollKeys.js → scaffold/useScrollKeys.js} +1 -1
  540. package/dist/layout/internal/scaffold/useScrollKeys.js.map +7 -0
  541. package/dist/layout/internal/scaffoldPages.d.ts +9 -0
  542. package/dist/layout/internal/scaffoldPages.js +27 -0
  543. package/dist/layout/internal/scaffoldPages.js.map +7 -0
  544. package/dist/markdown.d.ts +0 -1
  545. package/dist/markdown.js +0 -1
  546. package/dist/markdown.js.map +2 -2
  547. package/dist/messages.d.ts +1 -1
  548. package/dist/messages.js +1 -6
  549. package/dist/messages.js.map +2 -2
  550. package/dist/navigation/Breadcrumbs.d.ts +15 -4
  551. package/dist/navigation/Breadcrumbs.js +36 -27
  552. package/dist/navigation/Breadcrumbs.js.map +2 -2
  553. package/dist/navigation/DocumentTabs.d.ts +54 -12
  554. package/dist/navigation/DocumentTabs.js +50 -150
  555. package/dist/navigation/DocumentTabs.js.map +3 -3
  556. package/dist/navigation/NavigationBar.d.ts +10 -3
  557. package/dist/navigation/NavigationBar.js +75 -35
  558. package/dist/navigation/NavigationBar.js.map +2 -2
  559. package/dist/navigation/NavigationDrawer.d.ts +9 -3
  560. package/dist/navigation/NavigationDrawer.js +24 -217
  561. package/dist/navigation/NavigationDrawer.js.map +2 -2
  562. package/dist/navigation/NavigationRail.d.ts +10 -3
  563. package/dist/navigation/NavigationRail.js +20 -10
  564. package/dist/navigation/NavigationRail.js.map +2 -2
  565. package/dist/navigation/Pager.d.ts +25 -11
  566. package/dist/navigation/Pager.js +49 -12
  567. package/dist/navigation/Pager.js.map +3 -3
  568. package/dist/navigation/Pagination.d.ts +24 -9
  569. package/dist/navigation/Pagination.js +37 -11
  570. package/dist/navigation/Pagination.js.map +2 -2
  571. package/dist/navigation/TableOfContents.d.ts +18 -4
  572. package/dist/navigation/TableOfContents.js +41 -121
  573. package/dist/navigation/TableOfContents.js.map +2 -2
  574. package/dist/navigation/Tree.d.ts +28 -11
  575. package/dist/navigation/Tree.js +41 -37
  576. package/dist/navigation/Tree.js.map +2 -2
  577. package/dist/navigation/destinations.d.ts +43 -11
  578. package/dist/navigation/internal/DestinationItem.d.ts +5 -41
  579. package/dist/navigation/internal/DestinationItem.js +41 -44
  580. package/dist/navigation/internal/DestinationItem.js.map +2 -2
  581. package/dist/navigation/internal/destinationModel.d.ts +16 -0
  582. package/dist/navigation/internal/destinationModel.js +28 -0
  583. package/dist/navigation/internal/destinationModel.js.map +7 -0
  584. package/dist/navigation/internal/documentTabs/DocumentTab.d.ts +12 -0
  585. package/dist/navigation/internal/documentTabs/DocumentTab.js +122 -0
  586. package/dist/navigation/internal/documentTabs/DocumentTab.js.map +7 -0
  587. package/dist/navigation/internal/documentTabs/tabMenuContent.d.ts +21 -0
  588. package/dist/navigation/internal/documentTabs/tabMenuContent.js +73 -0
  589. package/dist/navigation/internal/documentTabs/tabMenuContent.js.map +7 -0
  590. package/dist/navigation/internal/documentTabs/tabStrip.d.ts +7 -0
  591. package/dist/navigation/internal/documentTabs/tabStrip.js +26 -0
  592. package/dist/navigation/internal/documentTabs/tabStrip.js.map +7 -0
  593. package/dist/navigation/internal/{useTabCloseFocus.js → documentTabs/useTabCloseFocus.js} +2 -2
  594. package/dist/navigation/internal/documentTabs/useTabCloseFocus.js.map +7 -0
  595. package/dist/navigation/internal/{useTabDrag.d.ts → documentTabs/useTabDrag.d.ts} +3 -3
  596. package/dist/navigation/internal/{useTabDrag.js → documentTabs/useTabDrag.js} +8 -8
  597. package/dist/navigation/internal/documentTabs/useTabDrag.js.map +7 -0
  598. package/dist/navigation/internal/{useTabStripScrolling.js → documentTabs/useTabStripScrolling.js} +22 -3
  599. package/dist/navigation/internal/documentTabs/useTabStripScrolling.js.map +7 -0
  600. package/dist/navigation/internal/landmarkLabel.d.ts +1 -0
  601. package/dist/navigation/internal/landmarkLabel.js +5 -0
  602. package/dist/navigation/internal/landmarkLabel.js.map +7 -0
  603. package/dist/navigation/internal/navigationDrawer/DrawerRows.d.ts +18 -0
  604. package/dist/navigation/internal/navigationDrawer/DrawerRows.js +151 -0
  605. package/dist/navigation/internal/navigationDrawer/DrawerRows.js.map +7 -0
  606. package/dist/navigation/internal/navigationDrawer/destinationSections.d.ts +13 -0
  607. package/dist/navigation/internal/navigationDrawer/destinationSections.js +13 -0
  608. package/dist/navigation/internal/navigationDrawer/destinationSections.js.map +7 -0
  609. package/dist/navigation/internal/navigationDrawer/useExpandedSections.d.ts +6 -0
  610. package/dist/navigation/internal/navigationDrawer/useExpandedSections.js +57 -0
  611. package/dist/navigation/internal/navigationDrawer/useExpandedSections.js.map +7 -0
  612. package/dist/navigation/internal/tableOfContents/contentsOutline.d.ts +26 -0
  613. package/dist/navigation/internal/tableOfContents/contentsOutline.js +38 -0
  614. package/dist/navigation/internal/tableOfContents/contentsOutline.js.map +7 -0
  615. package/dist/navigation/internal/{contentsWave.js → tableOfContents/contentsWave.js} +1 -1
  616. package/dist/navigation/internal/tableOfContents/contentsWave.js.map +7 -0
  617. package/dist/navigation/internal/tableOfContents/readingPosition.d.ts +25 -0
  618. package/dist/navigation/internal/{contentsOutline.js → tableOfContents/readingPosition.js} +2 -37
  619. package/dist/navigation/internal/tableOfContents/readingPosition.js.map +7 -0
  620. package/dist/navigation/internal/{sectionScroll.d.ts → tableOfContents/sectionScroll.d.ts} +6 -1
  621. package/dist/navigation/internal/{sectionScroll.js → tableOfContents/sectionScroll.js} +18 -10
  622. package/dist/navigation/internal/tableOfContents/sectionScroll.js.map +7 -0
  623. package/dist/navigation/internal/{useContentsHeadings.d.ts → tableOfContents/useContentsHeadings.d.ts} +2 -2
  624. package/dist/navigation/internal/{useContentsHeadings.js → tableOfContents/useContentsHeadings.js} +4 -7
  625. package/dist/navigation/internal/tableOfContents/useContentsHeadings.js.map +7 -0
  626. package/dist/navigation/internal/tableOfContents/useReadingPlace.d.ts +15 -0
  627. package/dist/navigation/internal/tableOfContents/useReadingPlace.js +119 -0
  628. package/dist/navigation/internal/tableOfContents/useReadingPlace.js.map +7 -0
  629. package/dist/navigation/internal/{waveDrawer.js → tableOfContents/waveDrawer.js} +5 -4
  630. package/dist/navigation/internal/tableOfContents/waveDrawer.js.map +7 -0
  631. package/dist/navigation/internal/{TreeRow.d.ts → tree/TreeRow.d.ts} +1 -1
  632. package/dist/navigation/internal/{TreeRow.js → tree/TreeRow.js} +9 -5
  633. package/dist/navigation/internal/tree/TreeRow.js.map +7 -0
  634. package/dist/navigation/internal/{treeModel.d.ts → tree/treeModel.d.ts} +7 -9
  635. package/dist/navigation/internal/{treeModel.js → tree/treeModel.js} +10 -13
  636. package/dist/navigation/internal/tree/treeModel.js.map +7 -0
  637. package/dist/navigation/internal/{useTreeTransitions.d.ts → tree/useTreeTransitions.d.ts} +1 -1
  638. package/dist/navigation/internal/tree/useTreeTransitions.js.map +7 -0
  639. package/dist/navigation/internal/{useTreeViewport.d.ts → tree/useTreeViewport.d.ts} +3 -3
  640. package/dist/navigation/internal/{useTreeViewport.js → tree/useTreeViewport.js} +11 -12
  641. package/dist/navigation/internal/tree/useTreeViewport.js.map +7 -0
  642. package/dist/navigation/internal/useLabelText.d.ts +6 -0
  643. package/dist/navigation/internal/useLabelText.js +11 -0
  644. package/dist/navigation/internal/useLabelText.js.map +7 -0
  645. package/dist/navigation/navigationBackground.d.ts +0 -2
  646. package/dist/navigation/navigationBackground.js +0 -6
  647. package/dist/navigation/navigationBackground.js.map +3 -3
  648. package/dist/overlays/ConfirmDialog.d.ts +6 -3
  649. package/dist/overlays/ConfirmDialog.js +64 -68
  650. package/dist/overlays/ConfirmDialog.js.map +2 -2
  651. package/dist/overlays/Dialog.d.ts +40 -6
  652. package/dist/overlays/Dialog.js +69 -41
  653. package/dist/overlays/Dialog.js.map +2 -2
  654. package/dist/overlays/HoverCard.d.ts +9 -2
  655. package/dist/overlays/HoverCard.js +5 -5
  656. package/dist/overlays/HoverCard.js.map +2 -2
  657. package/dist/overlays/Popover.d.ts +20 -5
  658. package/dist/overlays/Popover.js +8 -6
  659. package/dist/overlays/Popover.js.map +2 -2
  660. package/dist/overlays/Sheet.d.ts +16 -3
  661. package/dist/overlays/Sheet.js +88 -87
  662. package/dist/overlays/Sheet.js.map +2 -2
  663. package/dist/overlays/Tooltip.d.ts +7 -0
  664. package/dist/overlays/Tooltip.js +10 -15
  665. package/dist/overlays/Tooltip.js.map +2 -2
  666. package/dist/overlays/internal/accessibleName.js +2 -1
  667. package/dist/overlays/internal/accessibleName.js.map +2 -2
  668. package/dist/overlays/internal/dialog/DialogHeadingClose.d.ts +8 -0
  669. package/dist/overlays/internal/dialog/DialogHeadingClose.js +19 -0
  670. package/dist/overlays/internal/dialog/DialogHeadingClose.js.map +7 -0
  671. package/dist/overlays/internal/dialog/DialogParts.d.ts +33 -0
  672. package/dist/overlays/internal/dialog/DialogParts.js +64 -0
  673. package/dist/overlays/internal/dialog/DialogParts.js.map +7 -0
  674. package/dist/overlays/internal/{DialogPendingAction.d.ts → dialog/dialogPending.d.ts} +8 -0
  675. package/dist/overlays/internal/{DialogPendingAction.js → dialog/dialogPending.js} +13 -2
  676. package/dist/overlays/internal/dialog/dialogPending.js.map +7 -0
  677. package/dist/styles/Accordion.css +1 -1
  678. package/dist/styles/Alert.css +1 -1
  679. package/dist/styles/Avatar.css +1 -1
  680. package/dist/styles/Badge.css +1 -1
  681. package/dist/styles/Base.css +1 -1
  682. package/dist/styles/Breadcrumbs.css +1 -1
  683. package/dist/styles/Card.css +1 -1
  684. package/dist/styles/Checkbox.css +1 -1
  685. package/dist/styles/Code.css +1 -1
  686. package/dist/styles/Combobox.css +1 -1
  687. package/dist/styles/CommandPalette.css +1 -1
  688. package/dist/styles/Composer.css +1 -1
  689. package/dist/styles/CopyButton.css +1 -1
  690. package/dist/styles/Dialog.css +1 -1
  691. package/dist/styles/Disclosure.css +1 -1
  692. package/dist/styles/DocumentTabs.css +1 -1
  693. package/dist/styles/DropZone.css +1 -1
  694. package/dist/styles/EmptyState.css +1 -1
  695. package/dist/styles/Halo.css +1 -0
  696. package/dist/styles/List.css +1 -1
  697. package/dist/styles/ListRow.css +1 -1
  698. package/dist/styles/LoadingBar.css +1 -1
  699. package/dist/styles/Menu.css +1 -1
  700. package/dist/styles/Message.css +1 -1
  701. package/dist/styles/Meter.css +1 -1
  702. package/dist/styles/NavigationBar.css +1 -1
  703. package/dist/styles/NavigationDestinations.css +1 -0
  704. package/dist/styles/NavigationDrawer.css +1 -1
  705. package/dist/styles/NavigationRail.css +1 -1
  706. package/dist/styles/Pager.css +1 -1
  707. package/dist/styles/Panes.css +1 -1
  708. package/dist/styles/Progress.css +1 -0
  709. package/dist/styles/Radio.css +1 -1
  710. package/dist/styles/Scaffold.css +1 -1
  711. package/dist/styles/SegmentedControl.css +1 -1
  712. package/dist/styles/Select.css +1 -1
  713. package/dist/styles/Switch.css +1 -1
  714. package/dist/styles/Table.css +1 -1
  715. package/dist/styles/TableOfContents.css +1 -1
  716. package/dist/styles/Text.css +1 -1
  717. package/dist/styles/TextField.css +1 -1
  718. package/dist/styles/Toast.css +1 -1
  719. package/dist/styles/Toolbar.css +1 -1
  720. package/dist/styles/Tree.css +1 -1
  721. package/dist/styles.css +1 -1
  722. package/dist/theme-bootstrap.d.ts +1 -1
  723. package/dist/theme-bootstrap.js +1 -8
  724. package/dist/theme-bootstrap.js.map +2 -2
  725. package/dist/theme-storage.d.ts +2 -0
  726. package/dist/theme-storage.js +3 -0
  727. package/dist/theme-storage.js.map +7 -0
  728. package/dist/tokens.json +0 -13
  729. package/docs/components/accordion.md +13 -0
  730. package/docs/components/alert.md +8 -1
  731. package/docs/components/avatar.md +16 -4
  732. package/docs/components/badge.md +10 -39
  733. package/docs/components/box.md +3 -3
  734. package/docs/components/breadcrumbs.md +6 -1
  735. package/docs/components/button.md +14 -9
  736. package/docs/components/card.md +14 -5
  737. package/docs/components/checkbox.md +3 -1
  738. package/docs/components/code.md +15 -6
  739. package/docs/components/color-picker.md +10 -2
  740. package/docs/components/column.md +2 -2
  741. package/docs/components/combobox.md +1 -1
  742. package/docs/components/command-palette.md +6 -2
  743. package/docs/components/composer.md +19 -8
  744. package/docs/components/confirm-dialog.md +3 -3
  745. package/docs/components/date-picker.md +15 -3
  746. package/docs/components/description-list.md +1 -1
  747. package/docs/components/dialog.md +34 -8
  748. package/docs/components/disclosure.md +4 -0
  749. package/docs/components/document-tabs.md +23 -13
  750. package/docs/components/drop-zone.md +10 -1
  751. package/docs/components/empty-state.md +12 -3
  752. package/docs/components/field.md +2 -1
  753. package/docs/components/graphic.md +1 -1
  754. package/docs/components/grid.md +2 -2
  755. package/docs/components/halo.md +80 -0
  756. package/docs/components/hover-card.md +2 -1
  757. package/docs/components/kbd.md +8 -2
  758. package/docs/components/link.md +1 -1
  759. package/docs/components/list.md +13 -5
  760. package/docs/components/markdown.md +9 -116
  761. package/docs/components/menu.md +28 -12
  762. package/docs/components/menubar.md +4 -3
  763. package/docs/components/message.md +17 -13
  764. package/docs/components/meter.md +8 -3
  765. package/docs/components/month-picker.md +4 -2
  766. package/docs/components/navigation-drawer.md +32 -7
  767. package/docs/components/page.md +4 -3
  768. package/docs/components/pager.md +16 -6
  769. package/docs/components/pagination.md +3 -2
  770. package/docs/components/panes.md +13 -26
  771. package/docs/components/popover.md +3 -2
  772. package/docs/components/progress.md +2 -2
  773. package/docs/components/radio.md +13 -5
  774. package/docs/components/relative-time.md +2 -1
  775. package/docs/components/resize-handle.md +6 -4
  776. package/docs/components/row.md +2 -2
  777. package/docs/components/scaffold.md +13 -4
  778. package/docs/components/segmented-control.md +10 -4
  779. package/docs/components/select.md +10 -2
  780. package/docs/components/sheet.md +4 -1
  781. package/docs/components/slider.md +8 -2
  782. package/docs/components/spinner.md +1 -1
  783. package/docs/components/surface.md +1 -1
  784. package/docs/components/switch.md +2 -0
  785. package/docs/components/table-of-contents.md +3 -2
  786. package/docs/components/table.md +18 -3
  787. package/docs/components/text-field.md +14 -8
  788. package/docs/components/time-picker.md +4 -2
  789. package/docs/components/toast.md +2 -1
  790. package/docs/components/toolbar.md +31 -6
  791. package/docs/components/tooltip.md +1 -0
  792. package/docs/components/top-bar.md +1 -1
  793. package/docs/components/tree.md +9 -4
  794. package/docs/customizing.md +59 -91
  795. package/docs/examples/accordion/IntegrationSwitches.tsx +33 -0
  796. package/docs/examples/alert/BannerAction.tsx +19 -0
  797. package/docs/examples/avatar/BotsAndPresence.tsx +24 -0
  798. package/docs/examples/badge/BadgeAnatomy.tsx +1 -1
  799. package/docs/examples/badge/CountsInButtons.tsx +2 -2
  800. package/docs/examples/badge/WithContent.tsx +13 -0
  801. package/docs/examples/breadcrumbs/WithAvatar.tsx +20 -0
  802. package/docs/examples/button/ButtonAnatomy.tsx +1 -1
  803. package/docs/examples/button/CreateProject.tsx +1 -1
  804. package/docs/examples/button/FillSidebar.tsx +1 -1
  805. package/docs/examples/button/Icons.tsx +2 -2
  806. package/docs/examples/button/PictureBeforeLabel.tsx +14 -0
  807. package/docs/examples/card/CardAnatomy.tsx +3 -1
  808. package/docs/examples/card/OpenFromCard.tsx +65 -0
  809. package/docs/examples/code/PackageManagers.tsx +35 -0
  810. package/docs/examples/code/SettingsDiff.tsx +5 -9
  811. package/docs/examples/color-picker/TextColorInToolbar.tsx +44 -0
  812. package/docs/examples/colors/Status.tsx +6 -6
  813. package/docs/examples/command-palette/CommandPaletteAnatomy.tsx +11 -5
  814. package/docs/examples/command-palette/GoToDocument.tsx +17 -14
  815. package/docs/examples/command-palette/NarrowSidebar.tsx +1 -1
  816. package/docs/examples/command-palette/RunCommand.tsx +16 -12
  817. package/docs/examples/command-palette/SearchButton.tsx +2 -2
  818. package/docs/examples/command-palette/TypeToSearch.tsx +2 -2
  819. package/docs/examples/composer/AttachmentsAndVoice.tsx +30 -0
  820. package/docs/examples/confirm-dialog/FromMenu.tsx +1 -1
  821. package/docs/examples/date-picker/PresetsAndBusyDays.tsx +61 -0
  822. package/docs/examples/dialog/EditMember.tsx +28 -0
  823. package/docs/examples/dialog/FindPlan.tsx +1 -1
  824. package/docs/examples/document-tabs/DocumentTabsAnatomy.tsx +2 -2
  825. package/docs/examples/document-tabs/EditorTabs.tsx +57 -0
  826. package/docs/examples/document-tabs/OpenDocuments.tsx +2 -2
  827. package/docs/examples/drop-zone/FilesInsideTheZone.tsx +40 -0
  828. package/docs/examples/empty-state/WithIllustration.tsx +22 -0
  829. package/docs/examples/graphic/Colors.tsx +1 -1
  830. package/docs/examples/graphic/SignInWithLogo.tsx +1 -1
  831. package/docs/examples/halo/AroundACard.tsx +14 -0
  832. package/docs/examples/halo/InviteTeam.tsx +15 -0
  833. package/docs/examples/halo/Tones.tsx +14 -0
  834. package/docs/examples/icons/FollowText.tsx +3 -3
  835. package/docs/examples/kbd/Sequences.tsx +10 -0
  836. package/docs/examples/list/TitleActions.tsx +32 -0
  837. package/docs/examples/menu/AccountSwitcher.tsx +32 -0
  838. package/docs/examples/menu/Choices.tsx +1 -1
  839. package/docs/examples/menu/ContextMenuForRows.tsx +3 -3
  840. package/docs/examples/menu/Destinations.tsx +5 -5
  841. package/docs/examples/menu/GroupsAndSeparators.tsx +6 -6
  842. package/docs/examples/menu/IconsAndShortcuts.tsx +5 -5
  843. package/docs/examples/menu/MenuAnatomy.tsx +3 -3
  844. package/docs/examples/menu/Submenus.tsx +4 -4
  845. package/docs/examples/menubar/NotesMenubar.tsx +4 -4
  846. package/docs/examples/message/CommentThread.tsx +30 -0
  847. package/docs/examples/message/Conversation.tsx +7 -2
  848. package/docs/examples/meter/InlineUsage.tsx +10 -0
  849. package/docs/examples/navigation-drawer/ActivityBar.tsx +26 -0
  850. package/docs/examples/navigation-drawer/GroupActions.tsx +43 -0
  851. package/docs/examples/page/WithBreadcrumbs.tsx +1 -1
  852. package/docs/examples/page/WithHeader.tsx +1 -1
  853. package/docs/examples/page/WithToolbar.tsx +1 -1
  854. package/docs/examples/pager/LongTitles.tsx +2 -2
  855. package/docs/examples/pager/PagerAnatomy.tsx +2 -2
  856. package/docs/examples/pager/PreviousAndNext.tsx +2 -2
  857. package/docs/examples/pager/StepThroughAGuide.tsx +2 -2
  858. package/docs/examples/panes/DocumentAndDetails.tsx +53 -0
  859. package/docs/examples/panes/PanesAnatomy.tsx +20 -12
  860. package/docs/examples/panes/ResizableDetails.tsx +35 -2
  861. package/docs/examples/panes/StackedWhenNarrow.tsx +11 -10
  862. package/docs/examples/popover/DocumentDetails.tsx +1 -1
  863. package/docs/examples/popover/RenameInPlace.tsx +1 -1
  864. package/docs/examples/progress/ExportMembers.tsx +1 -1
  865. package/docs/examples/radio/PlanRows.tsx +35 -0
  866. package/docs/examples/relative-time/PastAndComing.tsx +6 -6
  867. package/docs/examples/relative-time/VersionLabels.tsx +5 -5
  868. package/docs/examples/resize-handle/DockedLogs.tsx +44 -0
  869. package/docs/examples/resize-handle/ResizeHandleAnatomy.tsx +22 -22
  870. package/docs/examples/row/SectionHeading.tsx +1 -1
  871. package/docs/examples/scaffold/InspectorAndStatus.tsx +63 -0
  872. package/docs/examples/segmented-control/IconOnlyAndBadge.tsx +31 -0
  873. package/docs/examples/segmented-control/SegmentedControlAnatomy.tsx +2 -2
  874. package/docs/examples/segmented-control/SmallToolbar.tsx +4 -4
  875. package/docs/examples/select/Assignee.tsx +29 -0
  876. package/docs/examples/select/SmallToolbar.tsx +23 -21
  877. package/docs/examples/sheet/FilterPanel.tsx +1 -1
  878. package/docs/examples/sheet/ShareChoices.tsx +1 -1
  879. package/docs/examples/slider/IconsAndUnits.tsx +42 -0
  880. package/docs/examples/spacing/Align.tsx +1 -1
  881. package/docs/examples/table/HeaderEndAndTotals.tsx +61 -0
  882. package/docs/examples/table/WorkItemsWithParts.tsx +1 -1
  883. package/docs/examples/table-of-contents/DocsArticle.tsx +16 -11
  884. package/docs/examples/text-field/ContentAffixes.tsx +32 -0
  885. package/docs/examples/text-field/FieldsBesideButtons.tsx +1 -1
  886. package/docs/examples/text-field/IconAndEndAction.tsx +1 -1
  887. package/docs/examples/text-field/TextFieldAnatomy.tsx +1 -1
  888. package/docs/examples/text-field/Variants.tsx +1 -1
  889. package/docs/examples/toast/ExportReady.tsx +7 -5
  890. package/docs/examples/toast/RetryAfterError.tsx +8 -6
  891. package/docs/examples/toast/ToastAnatomy.tsx +1 -1
  892. package/docs/examples/toast/TopCenter.tsx +1 -1
  893. package/docs/examples/toast/UndoArchive.tsx +10 -8
  894. package/docs/examples/toolbar/LabelledControls.tsx +40 -0
  895. package/docs/examples/tooltip/MenuTrigger.tsx +2 -2
  896. package/docs/examples/tree/ContextMenuActions.tsx +5 -5
  897. package/docs/examples/tree/FileTree.tsx +1 -1
  898. package/docs/examples/tree/MatchedLetters.tsx +37 -0
  899. package/docs/examples/tree/NarrowTree.tsx +3 -3
  900. package/docs/examples/tree/RowDensity.tsx +6 -6
  901. package/docs/examples/tree/TreeAnatomy.tsx +2 -2
  902. package/docs/foundations/accessibility.md +3 -3
  903. package/docs/foundations/colors.md +2 -3
  904. package/docs/foundations/icons.md +3 -3
  905. package/docs/foundations/responsive.md +2 -2
  906. package/docs/foundations/spacing.md +2 -2
  907. package/docs/foundations/typography.md +2 -2
  908. package/docs/generated/exports.json +34 -52
  909. package/docs/generated/parts.json +469 -484
  910. package/docs/generated/props.json +1053 -903
  911. package/docs/index.md +52 -56
  912. package/docs/setup.md +62 -20
  913. package/docs/writing.md +1 -1
  914. package/package.json +6 -25
  915. package/dist/actions/internal/MenuPopup.js.map +0 -7
  916. package/dist/assets/readme/gallery-dark.png +0 -0
  917. package/dist/assets/readme/gallery-light.png +0 -0
  918. package/dist/content/MarkdownEditor.d.ts +0 -35
  919. package/dist/content/MarkdownEditor.js +0 -236
  920. package/dist/content/MarkdownEditor.js.map +0 -7
  921. package/dist/content/internal/markdown/MarkdownPreview.d.ts +0 -9
  922. package/dist/content/internal/markdown/MarkdownPreview.js +0 -30
  923. package/dist/content/internal/markdown/MarkdownPreview.js.map +0 -7
  924. package/dist/content/internal/markdown/markdownFormatting.d.ts +0 -15
  925. package/dist/content/internal/markdown/markdownFormatting.js +0 -96
  926. package/dist/content/internal/markdown/markdownFormatting.js.map +0 -7
  927. package/dist/content/internal/markdown/markdownHistory.d.ts +0 -10
  928. package/dist/content/internal/markdown/markdownHistory.js +0 -54
  929. package/dist/content/internal/markdown/markdownHistory.js.map +0 -7
  930. package/dist/content/internal/markdown/useMarkdownEditing.d.ts +0 -19
  931. package/dist/content/internal/markdown/useMarkdownEditing.js +0 -127
  932. package/dist/content/internal/markdown/useMarkdownEditing.js.map +0 -7
  933. package/dist/content/internal/markdown/useMarkdownLink.d.ts +0 -22
  934. package/dist/content/internal/markdown/useMarkdownLink.js +0 -73
  935. package/dist/content/internal/markdown/useMarkdownLink.js.map +0 -7
  936. package/dist/data-display/AnimatedNumber.d.ts +0 -15
  937. package/dist/data-display/AnimatedNumber.js +0 -111
  938. package/dist/data-display/AnimatedNumber.js.map +0 -7
  939. package/dist/data-display/CalendarHeatmap.d.ts +0 -92
  940. package/dist/data-display/CalendarHeatmap.js +0 -224
  941. package/dist/data-display/CalendarHeatmap.js.map +0 -7
  942. package/dist/data-display/DiffStat.d.ts +0 -23
  943. package/dist/data-display/DiffStat.js +0 -42
  944. package/dist/data-display/DiffStat.js.map +0 -7
  945. package/dist/data-display/Rating.d.ts +0 -32
  946. package/dist/data-display/Rating.js +0 -45
  947. package/dist/data-display/Rating.js.map +0 -7
  948. package/dist/data-display/internal/ListRows.js.map +0 -7
  949. package/dist/data-display/internal/calendarHeatmapModel.d.ts +0 -44
  950. package/dist/data-display/internal/calendarHeatmapModel.js +0 -133
  951. package/dist/data-display/internal/calendarHeatmapModel.js.map +0 -7
  952. package/dist/data-display/internal/useHeatmapLabels.d.ts +0 -16
  953. package/dist/data-display/internal/useHeatmapLabels.js +0 -56
  954. package/dist/data-display/internal/useHeatmapLabels.js.map +0 -7
  955. package/dist/data-display/internal/useHeatmapTooltip.d.ts +0 -24
  956. package/dist/data-display/internal/useHeatmapTooltip.js +0 -142
  957. package/dist/data-display/internal/useHeatmapTooltip.js.map +0 -7
  958. package/dist/dev/api.d.ts +0 -64
  959. package/dist/dev/api.js +0 -88
  960. package/dist/dev/api.js.map +0 -7
  961. package/dist/dev/elements.d.ts +0 -7
  962. package/dist/dev/elements.js +0 -32
  963. package/dist/dev/elements.js.map +0 -7
  964. package/dist/dev/inner.d.ts +0 -17
  965. package/dist/dev/inner.js +0 -139
  966. package/dist/dev/inner.js.map +0 -7
  967. package/dist/dev/install.d.ts +0 -64
  968. package/dist/dev/install.js +0 -128
  969. package/dist/dev/install.js.map +0 -7
  970. package/dist/dev/measure.d.ts +0 -10
  971. package/dist/dev/measure.js +0 -304
  972. package/dist/dev/measure.js.map +0 -7
  973. package/dist/dev/model.d.ts +0 -136
  974. package/dist/dev/model.js +0 -5
  975. package/dist/dev/model.js.map +0 -7
  976. package/dist/dev/overlays.d.ts +0 -5
  977. package/dist/dev/overlays.js +0 -52
  978. package/dist/dev/overlays.js.map +0 -7
  979. package/dist/dev/parts.d.ts +0 -49
  980. package/dist/dev/parts.js +0 -89
  981. package/dist/dev/parts.js.map +0 -7
  982. package/dist/dev/queries.d.ts +0 -28
  983. package/dist/dev/queries.js +0 -135
  984. package/dist/dev/queries.js.map +0 -7
  985. package/dist/dev/readout.d.ts +0 -9
  986. package/dist/dev/readout.js +0 -275
  987. package/dist/dev/readout.js.map +0 -7
  988. package/dist/dev/skeletonShift.d.ts +0 -6
  989. package/dist/dev/skeletonShift.js +0 -174
  990. package/dist/dev/skeletonShift.js.map +0 -7
  991. package/dist/dev/ui/Controls.d.ts +0 -20
  992. package/dist/dev/ui/Controls.js +0 -53
  993. package/dist/dev/ui/Controls.js.map +0 -7
  994. package/dist/dev/ui/DevMode.d.ts +0 -14
  995. package/dist/dev/ui/DevMode.js +0 -222
  996. package/dist/dev/ui/DevMode.js.map +0 -7
  997. package/dist/dev/ui/Frame.d.ts +0 -14
  998. package/dist/dev/ui/Frame.js +0 -178
  999. package/dist/dev/ui/Frame.js.map +0 -7
  1000. package/dist/dev/ui/Icons.d.ts +0 -5
  1001. package/dist/dev/ui/Icons.js +0 -38
  1002. package/dist/dev/ui/Icons.js.map +0 -7
  1003. package/dist/dev/ui/Inspector.d.ts +0 -24
  1004. package/dist/dev/ui/Inspector.js +0 -366
  1005. package/dist/dev/ui/Inspector.js.map +0 -7
  1006. package/dist/dev/ui/Legend.d.ts +0 -4
  1007. package/dist/dev/ui/Legend.js +0 -50
  1008. package/dist/dev/ui/Legend.js.map +0 -7
  1009. package/dist/dev/ui/NodeHints.d.ts +0 -15
  1010. package/dist/dev/ui/NodeHints.js +0 -95
  1011. package/dist/dev/ui/NodeHints.js.map +0 -7
  1012. package/dist/dev/ui/PerformancePanel.d.ts +0 -3
  1013. package/dist/dev/ui/PerformancePanel.js +0 -72
  1014. package/dist/dev/ui/PerformancePanel.js.map +0 -7
  1015. package/dist/dev/ui/Plane.d.ts +0 -37
  1016. package/dist/dev/ui/Plane.js +0 -154
  1017. package/dist/dev/ui/Plane.js.map +0 -7
  1018. package/dist/dev/ui/View3D.d.ts +0 -19
  1019. package/dist/dev/ui/View3D.js +0 -248
  1020. package/dist/dev/ui/View3D.js.map +0 -7
  1021. package/dist/dev/ui/ViewToolbar.d.ts +0 -40
  1022. package/dist/dev/ui/ViewToolbar.js +0 -352
  1023. package/dist/dev/ui/ViewToolbar.js.map +0 -7
  1024. package/dist/dev/ui/camera.d.ts +0 -42
  1025. package/dist/dev/ui/camera.js +0 -157
  1026. package/dist/dev/ui/camera.js.map +0 -7
  1027. package/dist/dev/ui/devices.d.ts +0 -9
  1028. package/dist/dev/ui/devices.js +0 -34
  1029. package/dist/dev/ui/devices.js.map +0 -7
  1030. package/dist/dev/ui/editorTheme.d.ts +0 -6
  1031. package/dist/dev/ui/editorTheme.js +0 -30
  1032. package/dist/dev/ui/editorTheme.js.map +0 -7
  1033. package/dist/dev/ui/sides.d.ts +0 -20
  1034. package/dist/dev/ui/sides.js +0 -43
  1035. package/dist/dev/ui/sides.js.map +0 -7
  1036. package/dist/dev/ui/stats.d.ts +0 -25
  1037. package/dist/dev/ui/stats.js +0 -26
  1038. package/dist/dev/ui/stats.js.map +0 -7
  1039. package/dist/dev/ui/surfaces.d.ts +0 -4
  1040. package/dist/dev/ui/surfaces.js +0 -249
  1041. package/dist/dev/ui/surfaces.js.map +0 -7
  1042. package/dist/dev/ui/useLivePage.d.ts +0 -13
  1043. package/dist/dev/ui/useLivePage.js +0 -138
  1044. package/dist/dev/ui/useLivePage.js.map +0 -7
  1045. package/dist/dev/ui/usePlaneHover.d.ts +0 -9
  1046. package/dist/dev/ui/usePlaneHover.js +0 -46
  1047. package/dist/dev/ui/usePlaneHover.js.map +0 -7
  1048. package/dist/dev/ui/useViewFit.d.ts +0 -16
  1049. package/dist/dev/ui/useViewFit.js +0 -59
  1050. package/dist/dev/ui/useViewFit.js.map +0 -7
  1051. package/dist/dev/ui/useViewWheel.d.ts +0 -11
  1052. package/dist/dev/ui/useViewWheel.js +0 -48
  1053. package/dist/dev/ui/useViewWheel.js.map +0 -7
  1054. package/dist/dev/ui/wheel.d.ts +0 -7
  1055. package/dist/dev/ui/wheel.js +0 -98
  1056. package/dist/dev/ui/wheel.js.map +0 -7
  1057. package/dist/dev/units.d.ts +0 -7
  1058. package/dist/dev/units.js +0 -22
  1059. package/dist/dev/units.js.map +0 -7
  1060. package/dist/dev/usedTokens.d.ts +0 -5
  1061. package/dist/dev/usedTokens.js +0 -56
  1062. package/dist/dev/usedTokens.js.map +0 -7
  1063. package/dist/dev.d.ts +0 -5
  1064. package/dist/dev.js +0 -9
  1065. package/dist/dev.js.map +0 -7
  1066. package/dist/feedback/toast/internal/PictureNotice.js.map +0 -7
  1067. package/dist/forms/color/internal/useColorState.d.ts +0 -10
  1068. package/dist/forms/color/internal/useColorState.js +0 -49
  1069. package/dist/forms/color/internal/useColorState.js.map +0 -7
  1070. package/dist/forms/internal/usePickerValue.d.ts +0 -13
  1071. package/dist/forms/internal/usePickerValue.js +0 -45
  1072. package/dist/forms/internal/usePickerValue.js.map +0 -7
  1073. package/dist/forms/internal/useRovingFocus.d.ts +0 -47
  1074. package/dist/forms/internal/useRovingFocus.js +0 -179
  1075. package/dist/forms/internal/useRovingFocus.js.map +0 -7
  1076. package/dist/forms/rich-text/RichText.d.ts +0 -7
  1077. package/dist/forms/rich-text/RichText.js +0 -91
  1078. package/dist/forms/rich-text/RichText.js.map +0 -7
  1079. package/dist/forms/rich-text/RichTextEditor.d.ts +0 -9
  1080. package/dist/forms/rich-text/RichTextEditor.js +0 -225
  1081. package/dist/forms/rich-text/RichTextEditor.js.map +0 -7
  1082. package/dist/forms/rich-text/extensions.d.ts +0 -10
  1083. package/dist/forms/rich-text/extensions.js +0 -45
  1084. package/dist/forms/rich-text/extensions.js.map +0 -7
  1085. package/dist/forms/rich-text/internal/Listbox.d.ts +0 -10
  1086. package/dist/forms/rich-text/internal/Listbox.js +0 -48
  1087. package/dist/forms/rich-text/internal/Listbox.js.map +0 -7
  1088. package/dist/forms/rich-text/internal/Reference.d.ts +0 -13
  1089. package/dist/forms/rich-text/internal/Reference.js +0 -79
  1090. package/dist/forms/rich-text/internal/Reference.js.map +0 -7
  1091. package/dist/forms/rich-text/internal/commands.d.ts +0 -6
  1092. package/dist/forms/rich-text/internal/commands.js +0 -74
  1093. package/dist/forms/rich-text/internal/commands.js.map +0 -7
  1094. package/dist/forms/rich-text/internal/readOnlyCheckbox.d.ts +0 -6
  1095. package/dist/forms/rich-text/internal/readOnlyCheckbox.js +0 -9
  1096. package/dist/forms/rich-text/internal/readOnlyCheckbox.js.map +0 -7
  1097. package/dist/forms/rich-text/internal/referenceAttributes.d.ts +0 -3
  1098. package/dist/forms/rich-text/internal/referenceAttributes.js +0 -23
  1099. package/dist/forms/rich-text/internal/referenceAttributes.js.map +0 -7
  1100. package/dist/forms/rich-text/internal/referenceExtension.d.ts +0 -2
  1101. package/dist/forms/rich-text/internal/referenceExtension.js +0 -103
  1102. package/dist/forms/rich-text/internal/referenceExtension.js.map +0 -7
  1103. package/dist/forms/rich-text/internal/suggestions.d.ts +0 -16
  1104. package/dist/forms/rich-text/internal/suggestions.js +0 -185
  1105. package/dist/forms/rich-text/internal/suggestions.js.map +0 -7
  1106. package/dist/forms/rich-text/internal/taskItem.d.ts +0 -1
  1107. package/dist/forms/rich-text/internal/taskItem.js +0 -43
  1108. package/dist/forms/rich-text/internal/taskItem.js.map +0 -7
  1109. package/dist/forms/rich-text/internal/useDocumentAttributes.d.ts +0 -13
  1110. package/dist/forms/rich-text/internal/useDocumentAttributes.js +0 -42
  1111. package/dist/forms/rich-text/internal/useDocumentAttributes.js.map +0 -7
  1112. package/dist/forms/rich-text/internal/useLinksAndUploads.d.ts +0 -19
  1113. package/dist/forms/rich-text/internal/useLinksAndUploads.js +0 -141
  1114. package/dist/forms/rich-text/internal/useLinksAndUploads.js.map +0 -7
  1115. package/dist/forms/rich-text/internal/useRichTextDocument.d.ts +0 -26
  1116. package/dist/forms/rich-text/internal/useRichTextDocument.js +0 -101
  1117. package/dist/forms/rich-text/internal/useRichTextDocument.js.map +0 -7
  1118. package/dist/forms/rich-text/internal/useRichTextExtensions.d.ts +0 -13
  1119. package/dist/forms/rich-text/internal/useRichTextExtensions.js +0 -85
  1120. package/dist/forms/rich-text/internal/useRichTextExtensions.js.map +0 -7
  1121. package/dist/forms/rich-text/types.d.ts +0 -190
  1122. package/dist/forms/rich-text/types.js +0 -1
  1123. package/dist/foundations/SkeletonScope.js.map +0 -7
  1124. package/dist/foundations/ThemePreference.d.ts +0 -35
  1125. package/dist/foundations/ThemePreference.js.map +0 -7
  1126. package/dist/foundations/internal/skeletonText.js.map +0 -7
  1127. package/dist/foundations/messages/calendarHeatmap.d.ts +0 -10
  1128. package/dist/foundations/messages/calendarHeatmap.js +0 -10
  1129. package/dist/foundations/messages/calendarHeatmap.js.map +0 -7
  1130. package/dist/foundations/messages/diffStat.d.ts +0 -16
  1131. package/dist/foundations/messages/diffStat.js +0 -17
  1132. package/dist/foundations/messages/diffStat.js.map +0 -7
  1133. package/dist/foundations/messages/editor.d.ts +0 -35
  1134. package/dist/foundations/messages/editor.js +0 -34
  1135. package/dist/foundations/messages/editor.js.map +0 -7
  1136. package/dist/foundations/messages/linkDialog.d.ts +0 -20
  1137. package/dist/foundations/messages/linkDialog.js +0 -20
  1138. package/dist/foundations/messages/linkDialog.js.map +0 -7
  1139. package/dist/foundations/messages/markdownEditor.d.ts +0 -26
  1140. package/dist/foundations/messages/markdownEditor.js +0 -26
  1141. package/dist/foundations/messages/markdownEditor.js.map +0 -7
  1142. package/dist/foundations/messages/rating.d.ts +0 -11
  1143. package/dist/foundations/messages/rating.js +0 -8
  1144. package/dist/foundations/messages/rating.js.map +0 -7
  1145. package/dist/foundations/messages/richText.d.ts +0 -34
  1146. package/dist/foundations/messages/richText.js +0 -34
  1147. package/dist/foundations/messages/richText.js.map +0 -7
  1148. package/dist/internal/dialog/DialogParts.d.ts +0 -46
  1149. package/dist/internal/dialog/DialogParts.js +0 -66
  1150. package/dist/internal/dialog/DialogParts.js.map +0 -7
  1151. package/dist/internal/dom/paints.d.ts +0 -5
  1152. package/dist/internal/dom/paints.js +0 -17
  1153. package/dist/internal/dom/paints.js.map +0 -7
  1154. package/dist/internal/dom/useStripWheel.d.ts +0 -6
  1155. package/dist/internal/dom/useStripWheel.js +0 -26
  1156. package/dist/internal/dom/useStripWheel.js.map +0 -7
  1157. package/dist/internal/editor/EditorStatus.d.ts +0 -8
  1158. package/dist/internal/editor/EditorStatus.js +0 -11
  1159. package/dist/internal/editor/EditorStatus.js.map +0 -7
  1160. package/dist/internal/editor/EditorToolbar.d.ts +0 -28
  1161. package/dist/internal/editor/EditorToolbar.js +0 -89
  1162. package/dist/internal/editor/EditorToolbar.js.map +0 -7
  1163. package/dist/internal/editor/LinkDialog.d.ts +0 -20
  1164. package/dist/internal/editor/LinkDialog.js +0 -78
  1165. package/dist/internal/editor/LinkDialog.js.map +0 -7
  1166. package/dist/internal/editor/editorCommands.d.ts +0 -20
  1167. package/dist/internal/editor/editorCommands.js +0 -45
  1168. package/dist/internal/editor/editorCommands.js.map +0 -7
  1169. package/dist/internal/field/TextareaResizeEdge.js.map +0 -7
  1170. package/dist/internal/field/rowControl.js.map +0 -7
  1171. package/dist/internal/field/useFieldMetadata.d.ts +0 -16
  1172. package/dist/internal/field/useFieldMetadata.js +0 -24
  1173. package/dist/internal/field/useFieldMetadata.js.map +0 -7
  1174. package/dist/internal/list/ListRow.d.ts +0 -33
  1175. package/dist/internal/list/ListRow.js.map +0 -7
  1176. package/dist/internal/popup/PortalContainerContext.js.map +0 -7
  1177. package/dist/internal/react/useStackedReport.js +0 -28
  1178. package/dist/internal/react/useStackedReport.js.map +0 -7
  1179. package/dist/internal/skeleton.js.map +0 -7
  1180. package/dist/internal/time/calendarDays.js.map +0 -7
  1181. package/dist/layout/internal/navigationForms.js.map +0 -7
  1182. package/dist/layout/internal/scrollKeys.js.map +0 -7
  1183. package/dist/layout/internal/useNavigationFocusHandoff.js.map +0 -7
  1184. package/dist/layout/internal/useScrollKeys.js.map +0 -7
  1185. package/dist/layout/panesSize.d.ts +0 -13
  1186. package/dist/layout/panesSize.js +0 -39
  1187. package/dist/layout/panesSize.js.map +0 -7
  1188. package/dist/navigation/internal/TreeRow.js.map +0 -7
  1189. package/dist/navigation/internal/contentsOutline.d.ts +0 -60
  1190. package/dist/navigation/internal/contentsOutline.js.map +0 -7
  1191. package/dist/navigation/internal/contentsWave.js.map +0 -7
  1192. package/dist/navigation/internal/sectionScroll.js.map +0 -7
  1193. package/dist/navigation/internal/tabStrip.d.ts +0 -6
  1194. package/dist/navigation/internal/tabStrip.js +0 -24
  1195. package/dist/navigation/internal/tabStrip.js.map +0 -7
  1196. package/dist/navigation/internal/treeModel.js.map +0 -7
  1197. package/dist/navigation/internal/useContentsHeadings.js.map +0 -7
  1198. package/dist/navigation/internal/useTabCloseFocus.js.map +0 -7
  1199. package/dist/navigation/internal/useTabDrag.js.map +0 -7
  1200. package/dist/navigation/internal/useTabStripScrolling.js.map +0 -7
  1201. package/dist/navigation/internal/useTreeTransitions.js.map +0 -7
  1202. package/dist/navigation/internal/useTreeViewport.js.map +0 -7
  1203. package/dist/navigation/internal/waveDrawer.js.map +0 -7
  1204. package/dist/overlays/internal/DialogPendingAction.js.map +0 -7
  1205. package/dist/rich-text.d.ts +0 -5
  1206. package/dist/rich-text.js +0 -9
  1207. package/dist/rich-text.js.map +0 -7
  1208. package/dist/styles/CalendarHeatmap.css +0 -1
  1209. package/dist/styles/Editor.css +0 -1
  1210. package/dist/styles/Listbox.css +0 -1
  1211. package/dist/styles/MarkdownEditor.css +0 -1
  1212. package/dist/styles/Rating.css +0 -1
  1213. package/dist/styles/RichText.css +0 -1
  1214. package/docs/components/animated-number.md +0 -72
  1215. package/docs/components/calendar-heatmap.md +0 -140
  1216. package/docs/components/rating.md +0 -84
  1217. package/docs/components/rich-text.md +0 -224
  1218. package/docs/dev-mode.md +0 -59
  1219. package/docs/examples/animated-number/AnimatedNumberAnatomy.tsx +0 -9
  1220. package/docs/examples/animated-number/CustomFormat.tsx +0 -28
  1221. package/docs/examples/animated-number/ShowResults.tsx +0 -38
  1222. package/docs/examples/badge/ChangeSize.tsx +0 -21
  1223. package/docs/examples/calendar-heatmap/ApplicationStrings.tsx +0 -23
  1224. package/docs/examples/calendar-heatmap/ColorByRank.tsx +0 -26
  1225. package/docs/examples/calendar-heatmap/CustomTooltip.tsx +0 -26
  1226. package/docs/examples/calendar-heatmap/Deployments.tsx +0 -22
  1227. package/docs/examples/calendar-heatmap/HeatmapAnatomy.tsx +0 -10
  1228. package/docs/examples/calendar-heatmap/ScrollingWeeks.tsx +0 -10
  1229. package/docs/examples/markdown/LinkPicker.tsx +0 -65
  1230. package/docs/examples/markdown/MarkdownEditorAnatomy.tsx +0 -13
  1231. package/docs/examples/markdown/WriteNote.tsx +0 -21
  1232. package/docs/examples/panes/ListAndDetail.tsx +0 -55
  1233. package/docs/examples/rating/RatingAnatomy.tsx +0 -5
  1234. package/docs/examples/rating/ReviewScore.tsx +0 -13
  1235. package/docs/examples/rating/Scales.tsx +0 -11
  1236. package/docs/examples/resize-handle/ProjectSidebar.tsx +0 -40
  1237. package/docs/examples/rich-text/MeetingNotes.tsx +0 -14
  1238. package/docs/examples/rich-text/References.tsx +0 -47
  1239. package/docs/examples/rich-text/RichTextAnatomy.tsx +0 -18
  1240. package/docs/examples/rich-text/SavedContent.tsx +0 -33
  1241. package/docs/examples/rich-text/SlashCommands.tsx +0 -24
  1242. package/docs/examples/rich-text/UploadsAndLinks.tsx +0 -36
  1243. /package/dist/actions/{internal → menu/internal}/menuOpenChange.js +0 -0
  1244. /package/dist/actions/{internal → menu/internal}/menuOpenChange.js.map +0 -0
  1245. /package/dist/{forms/rich-text/types.js.map → actions/menu/internal/menuTriggerProps.js.map} +0 -0
  1246. /package/dist/forms/color/internal/{colorChange.d.ts → ColorChangeContext.d.ts} +0 -0
  1247. /package/dist/internal/{useCopy.d.ts → react/useCopy.d.ts} +0 -0
  1248. /package/dist/internal/{useCopy.js → react/useCopy.js} +0 -0
  1249. /package/dist/internal/{useLatest.d.ts → react/useLatest.d.ts} +0 -0
  1250. /package/dist/internal/{useLatest.js → react/useLatest.js} +0 -0
  1251. /package/dist/{foundations/internal → internal/skeleton}/skeletonText.d.ts +0 -0
  1252. /package/dist/layout/internal/{navigationForms.js → scaffold/navigationForms.js} +0 -0
  1253. /package/dist/layout/internal/{scaffoldFocus.d.ts → scaffold/scaffoldFocus.d.ts} +0 -0
  1254. /package/dist/layout/internal/{scaffoldFocus.js → scaffold/scaffoldFocus.js} +0 -0
  1255. /package/dist/layout/internal/{scrollKeys.d.ts → scaffold/scrollKeys.d.ts} +0 -0
  1256. /package/dist/layout/internal/{useNavigationFocusHandoff.d.ts → scaffold/useNavigationFocusHandoff.d.ts} +0 -0
  1257. /package/dist/layout/internal/{useScrollKeys.d.ts → scaffold/useScrollKeys.d.ts} +0 -0
  1258. /package/dist/navigation/internal/{useTabCloseFocus.d.ts → documentTabs/useTabCloseFocus.d.ts} +0 -0
  1259. /package/dist/navigation/internal/{useTabStripScrolling.d.ts → documentTabs/useTabStripScrolling.d.ts} +0 -0
  1260. /package/dist/navigation/internal/{contentsWave.d.ts → tableOfContents/contentsWave.d.ts} +0 -0
  1261. /package/dist/navigation/internal/{waveDrawer.d.ts → tableOfContents/waveDrawer.d.ts} +0 -0
  1262. /package/dist/navigation/internal/{useTreeTransitions.js → tree/useTreeTransitions.js} +0 -0
  1263. /package/dist/styles/{TextareaResizeEdge.css → TextareaResizeHandle.css} +0 -0
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Menu
3
- summary: Actions and destinations, opened from a trigger or a right click.
3
+ summary: A list of actions and links, opened from a button or a right click.
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Actions
@@ -38,6 +38,7 @@ examples: # Each file is examples/menu/<Name>.tsx.
38
38
  GroupsAndSeparators: example
39
39
  Choices: example
40
40
  Submenus: example
41
+ AccountSwitcher: example
41
42
  Destinations: example
42
43
  MenuAnatomy: anatomy
43
44
  ---
@@ -62,6 +63,10 @@ Example: Choices.
62
63
 
63
64
  Example: Submenus.
64
65
 
66
+ ### Pictures before the label
67
+
68
+ Example: AccountSwitcher.
69
+
65
70
  ### Destinations
66
71
 
67
72
  Example: Destinations.
@@ -71,7 +76,7 @@ Example: Destinations.
71
76
  1. **Menu** (`env-menu`)
72
77
  2. **Group label** (`env-menu-group-label`, `label`)
73
78
  3. **Item** (`env-menu-item`)
74
- 4. **Icon** (`env-menu-item env-icon`, `icon`)
79
+ 4. **Start** (`env-menu-item-start`, `start`)
75
80
  5. **Shortcut** (`env-menu-item-shortcut`, `shortcut`)
76
81
  6. **Description** (`env-menu-item-description`, `description`)
77
82
  7. **Separator** (`env-menu-separator`)
@@ -141,15 +146,18 @@ One action (onClick) or destination (href) in a Menu. Destinations use the LinkP
141
146
  | `aria-current` | `AriaAttributes['aria-current']` | — | Marks a destination as the page shown now, such as aria-current="page" on the current one of a NavigationBar's destinations that its More menu holds. |
142
147
  | `aria-label` | `string` | — | The item's accessible name, where its label and end content don't say it as wanted, such as Inbox, 3 new for a destination whose count shows as a badge. |
143
148
  | `className` | `string` | — | Class of the item's row. |
144
- | `icon` | `ReactNode` | — | A decorative icon before the label, such as Settings. |
149
+ | `start` | `ReactNode` | — | Content before the label, such as the Settings icon or an Avatar in an account switcher: an envUI icon takes the icon size and other content keeps its own, and the labels of the menu's rows still line up. It is hidden from assistive technology, since the label names the item. |
145
150
  | `children` (required) | `ReactNode` | — | The item's label, which names it. |
151
+ | `textValue` | `string` | `children, when it is a string` | The label as plain text, which typing a letter in the open menu matches, where children isn't a string, such as a label with a Badge or emphasis inside. |
146
152
  | `description` | `ReactNode` | — | A second, muted line; announced as the item's description. |
147
153
  | `shortcut` | `string` | — | Keyboard hint at the end, such as Ctrl+P, shown as Kbd keys and announced as aria-keyshortcuts; a sequence, such as Ctrl+K Ctrl+S, shows its keys without the attribute. The application handles the shortcut itself. |
148
154
  | `end` | `ReactNode` | — | End content, such as a Badge or a count; it is part of the item's name. |
155
+ | `ref` | `Ref<HTMLElement>` | — | The item's row element. |
156
+ | `rel` | `string` | — | The destination's relationship to the page, such as noopener, as on a native link. |
149
157
  | `href` | `string` | — | The destination: the item is a link, through the LinkProvider's link component, and the menu closes as it is followed. |
150
158
  | `onClick` | `(event: MouseEvent<HTMLElement>) => void` | — | Runs as the destination is followed, before the menu closes, such as to record the choice; the link still navigates. |
151
159
  | `target` | `string` | — | Where the destination opens, such as _blank, as on a native link. |
152
- | `rel` | `string` | — | The destination's relationship to the page, such as noopener, as on a native link. |
160
+ | `closeOnClick` | `boolean` | `true` | Close the menu once the action runs; false keeps it open, for an action people repeat, such as Zoom in. |
153
161
 
154
162
  Native props: HTML element.
155
163
 
@@ -175,8 +183,9 @@ A row that opens a nested menu beside it, on hover or with the keyboard. The sub
175
183
  | `className` | `string` | — | Class of the submenu popup. |
176
184
  | `ref` | `Ref<HTMLDivElement>` | — | The submenu popup's ref. |
177
185
  | `style` | `CSSProperties` | — | The submenu popup's inline style. |
186
+ | `triggerProps` | `TriggerProps` | — | Attributes of the row that opens the submenu, such as a className, a style, a ref or a data attribute; the submenu's own className, style and ref are its popup's. |
178
187
 
179
- Also `icon` and `description`, as on Menu.Item.
188
+ Also `start`, `end`, `textValue` and `description`, as on Menu.Item.
180
189
 
181
190
  Native props: `<div>`.
182
191
 
@@ -214,9 +223,11 @@ One option of a Menu.RadioGroup.
214
223
  | --- | --- | --- | --- |
215
224
  | `value` (required) | `string` | — | The value the Menu.RadioGroup reports when this item is chosen. |
216
225
  | `disabled` | `boolean` | `false` | The item stays in place, dimmed, but cannot be chosen. |
217
- | `closeOnClick` | `boolean` | `true` | Close the menu after choosing. |
226
+ | `closeOnClick` | `boolean` | `true, or the closeOnClick of the ThemeMenuRadioGroup around it` | Close the menu after choosing. |
218
227
 
219
- Also `className`, `children`, `end`, `icon` and `description`, as on Menu.Item.
228
+ Also `className`, `children`, `start`, `end`, `textValue`, `description` and `ref`, as on Menu.Item.
229
+
230
+ Native props: HTML element.
220
231
 
221
232
  ### Menu.CheckboxItem
222
233
 
@@ -230,7 +241,9 @@ An independent on/off option; a check mark shows while it is on.
230
241
  | `disabled` | `boolean` | `false` | The item stays in place, dimmed, but cannot be toggled. |
231
242
  | `closeOnClick` | `boolean` | `false` | Close the menu after toggling; off by default, so several options can change. |
232
243
 
233
- Also `className`, `icon`, `children`, `description`, `shortcut` and `end`, as on Menu.Item.
244
+ Also `className`, `start`, `children`, `textValue`, `description`, `shortcut`, `end` and `ref`, as on Menu.Item.
245
+
246
+ Native props: HTML element.
234
247
 
235
248
  ### ContextMenu
236
249
 
@@ -253,14 +266,16 @@ Native props: `<div>`.
253
266
 
254
267
  ### ThemeMenuRadioGroup
255
268
 
256
- The theme choice for a Menu: System, Light and Dark as radio items. Inside a ThemePreferenceProvider it shows and stores the provider's preference; value and onValueChange connect it to a theme the application stores itself.
269
+ The theme choice for a Menu: System, Light and Dark as radio items. Inside a ThemePreferenceProvider it shows and changes the provider's preference; value and onValueChange connect it to a preference outside one.
257
270
 
258
271
  | Prop | Type | Default | Description |
259
272
  | --- | --- | --- | --- |
260
273
  | `value` | `'light' \| 'dark' \| 'system'` | `the nearest ThemePreferenceProvider's preference` | The chosen preference: system, light or dark. |
261
- | `onValueChange` | `(value: ThemePreference) => void` | `the nearest ThemePreferenceProvider's setPreference, which stores the choice` | Called with the preference chosen, for an application that stores the theme itself. |
274
+ | `onValueChange` | `(value: ThemePreference) => void` | `the nearest ThemePreferenceProvider's setPreference` | Called with the preference chosen, for a group outside a ThemePreferenceProvider. |
262
275
  | `label` | `ReactNode` | — | A small heading above the choices, which names the group. Leave it out inside a submenu, which its row already names. |
263
- | `closeOnClick` | `boolean` | `false` | Close the menu after a choice. Off by default, so people see the theme change with the menu still open. |
276
+ | `closeOnClick` | `boolean` | `false` | Close the menu after a choice. Off by default, so people see the theme change with the menu still open. It applies to the choices given as children too, unless one sets its own. |
277
+ | `children` | `ReactNode` | — | The choices, as Menu.RadioItems valued system, light or dark, in place of the three default ones: such as Light and Dark alone, or a choice with a hint beside it. |
278
+ | `className` | `string` | — | The group's class, beside env-menu-group. |
264
279
 
265
280
  Also `aria-labelledby`, as on Menu.RadioGroup.
266
281
 
@@ -278,6 +293,7 @@ Also `aria-labelledby`, as on Menu.RadioGroup.
278
293
  - `env-menu-item-indicator-slot`: The place for a chosen item's check.
279
294
  - `env-menu-item-label`: An item's label.
280
295
  - `env-menu-item-shortcut`: An item's keyboard shortcut.
296
+ - `env-menu-item-start`: The slot of the content before an item's label, such as an icon or an Avatar.
281
297
  - `env-menu-item-text`: The column with an item's label and description.
282
298
  - `env-menu-positioner`: The menu's positioner.
283
299
  - `env-menu-separator`: The line between groups.
@@ -296,7 +312,7 @@ Each sets a color of one instance, through `style` or CSS; its hover, focus and
296
312
 
297
313
  - `--env-menu-item-container`: The item's fill; the highlight and press are state layers over it.
298
314
  - `--env-menu-item-content`: The label, and the color of the state layers.
299
- - `--env-menu-item-icon`: The leading icon.
315
+ - `--env-menu-item-icon`: The content before the label, such as its icon.
300
316
 
301
317
  ## Strings
302
318
 
@@ -86,14 +86,15 @@ One menu of a Menubar.Root: a small text trigger and the menu that opens below i
86
86
 
87
87
  | Prop | Type | Default | Description |
88
88
  | --- | --- | --- | --- |
89
- | `label` (required) | `ReactNode` | — | The trigger's text, such as File. |
90
- | `accessKey` | `string` | — | A letter of the label, such as F for File. With Menubar.Root's accessKeys, holding Alt underlines it and Alt with the letter opens the menu. |
89
+ | `label` (required) | `ReactNode` | — | The trigger's text, such as File, or content such as an icon beside the text. |
90
+ | `accessKey` | `string` | — | A letter of the label, such as F for File. With Menubar.Root's accessKeys, holding Alt underlines it, in the label's text also beside an icon or inside an element such as a span, and Alt with the letter opens the menu. |
91
+ | `triggerProps` | `TriggerProps` | — | Attributes of the trigger button, such as a className, a style, a ref or a data attribute; the menu's own className, style and ref are its popup's. |
91
92
  | `children` (required) | `ReactNode` | — | The menu's items: Menu.Item, Menu.Submenu, Menu.Separator and the other menu parts. |
92
93
  | `aria-label` | `string` | — | Accessible name of the menu; by default the label, when it is a string. |
93
94
  | `disabled` | `boolean` | `false` | The trigger stays in place, dimmed, but doesn't open its menu. |
94
95
  | `open` | `boolean` | — | Controlled visibility. |
95
96
  | `defaultOpen` | `boolean` | `false` | Whether an uncontrolled menu starts open; closed by default. |
96
- | `onOpenChange` | `(open: boolean, details: MenuFocusDetails) => void` | — | Called when the menu opens or closes, with the element that had focus before the menubar took it. |
97
+ | `onOpenChange` | `(open: boolean, details: OpenChangeDetails) => void` | — | Called when the menu opens or closes, with the element that had focus before the menubar took it. |
97
98
  | `className` | `string` | — | Class of the menu popup. |
98
99
  | `ref` | `Ref<HTMLDivElement>` | — | The menu popup's ref; the trigger is the menubar's own. |
99
100
  | `style` | `CSSProperties` | — | The menu popup's inline style. |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Message
3
- summary: The entries of a conversation, your own as bubbles and others at full width.
3
+ summary: 'Chat messages: yours as bubbles, others at full width.'
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Text & content
@@ -34,6 +34,7 @@ examples: # Each file is examples/message/<Name>.tsx.
34
34
  FormattedAnswer: variants
35
35
  MessageAnatomy: anatomy
36
36
  DeliveryStatus: example
37
+ CommentThread: example
37
38
  BubbleWidth: example
38
39
  ---
39
40
 
@@ -60,6 +61,10 @@ examples: # Each file is examples/message/<Name>.tsx.
60
61
 
61
62
  Example: DeliveryStatus.
62
63
 
64
+ ### Avatars and rich authors
65
+
66
+ Example: CommentThread.
67
+
63
68
  ### Adapting to width
64
69
 
65
70
  Example: BubbleWidth.
@@ -81,25 +86,23 @@ One entry of a conversation, such as a chat message or a comment, as an article:
81
86
  | Prop | Type | Default | Description |
82
87
  | --- | --- | --- | --- |
83
88
  | `from` (required) | `'self' \| 'other'` | — | self: written by the person using the app, a compact bubble at the inline end. other: from anyone else, such as an assistant or another participant, full-width content without a bubble. |
84
- | `author` | `string` | — | Who wrote the message, such as a name, shown above it at weight 500. Leave it out where the conversation makes it clear, such as on your own messages in a conversation with one person. |
89
+ | `author` | `ReactNode` | — | Who wrote the message, such as a name, shown above it at weight 500, or content such as a link to their profile with a Bot or Owner Badge. Leave it out where the conversation makes it clear, such as on your own messages in a conversation with one person. |
90
+ | `start` | `ReactNode` | — | Content beside the message, at its inline start, placed as given, such as the author's Avatar or an assistant's mark, in a column of its own beside the header and the content. |
85
91
  | `meta` | `ReactNode` | — | Supporting facts beside the author, in the muted color, such as the time or a RelativeTime. |
86
92
  | `actions` | `ReactNode` | — | Small actions below the message, such as Copy or Try again: buttons without a variant or size of their own are small ghost buttons, at the inline end for your own messages. false and null count as absent. |
87
- | `status` | `'sending' \| 'failed'` | — | A message on its way, sending, with a spinner and Sending; or one that could not be sent, failed, with an error icon and Not sent in the danger tone and, on your own message, a red outline around the bubble. Without it the message is sent. |
88
- | `statusLabel` | `string` | `'Sending' or 'Not sent'` | The text beside the status icon, such as "Could not deliver". It overrides EnvUIProvider's `messages.message.sending` and `.failed`. |
89
- | `children` (required) | `ReactNode` | — | The message. Plain text keeps its line breaks; formatted content, such as Markdown, fills the width of a message from someone else. |
93
+ | `status` | `'sending' \| 'failed' \| 'working'` | — | A message on its way, sending, with a spinner and Sending; one that could not be sent, failed, with an error icon and Not sent in the danger tone and, on your own message, a red outline around the bubble; or a reply still being written, working, with a spinner and Working, such as an agent's while it runs, last in a MessageList with aria-busy. Without it the message is sent. |
94
+ | `statusLabel` | `ReactNode` | `'Sending', 'Not sent' or 'Working'` | The content beside the status icon, such as "Could not deliver", a sentence with a Try again link or the step a reply is on, Running tests…. It overrides EnvUIProvider's `messages.message.sending`, `.failed` and `.working`. |
95
+ | `children` | `ReactNode` | — | The message. Plain text keeps its line breaks; formatted content, such as Markdown, fills the width of a message from someone else. A working message shows the reply streamed so far, or only its status while it is empty. |
90
96
  | `skeleton` | `boolean` | `false` | Shows it and its content as a busy skeleton while that loads; turning it on or off renders the content anew. |
91
97
 
92
98
  Native props: HTML element.
93
99
 
94
100
  ### MessageList
95
101
 
96
- The messages of a conversation in order, as a log: assistive technology politely announces messages added anywhere in it and text that changes. Set busy while a reply is on its way or streams in, and follow where the list scrolls by itself. Name it with aria-label or aria-labelledby.
102
+ The messages of a conversation in order, as a log: assistive technology politely announces messages added anywhere in it and text that changes. While a reply is on its way or streams in, set aria-busy, so assistive technology waits for it to finish instead of announcing every step, and show it as a Message with status working, last. Set follow where the list scrolls by itself. Name it with aria-label or aria-labelledby.
97
103
 
98
104
  | Prop | Type | Default | Description |
99
105
  | --- | --- | --- | --- |
100
- | `busy` | `boolean` | `false` | A reply is on its way or streaming in: after the last message, where the reply will show, a row with the busy author, a quiet spinner and Working in the muted color; and the log reports aria-busy, so assistive technology can wait for the reply to finish instead of announcing every step. |
101
- | `busyAuthor` | `string` | — | Who the reply on its way comes from, such as Agent, named on the busy row as a message's author. |
102
- | `busyLabel` | `string` | `'Working'` | The text beside the busy spinner, such as "Thinking". It overrides EnvUIProvider's `messages.message.working`. |
103
106
  | `follow` | `boolean` | `false` | The list scrolls by itself and follows the conversation: it fills the height its container gives it, opens at the latest message and keeps the latest in view while the reader is at the end. Once they scroll away and more arrives, a Jump to latest button shows at its foot, which scrolls back to the end. |
104
107
  | `jumpToLatestLabel` | `string` | `'Jump to latest'` | The text of the Jump to latest button of a list that follows. It overrides EnvUIProvider's `messages.message.jumpToLatest`. |
105
108
 
@@ -115,16 +118,17 @@ Native props: `<div>`.
115
118
  - `env-message-content`: The slot of the message's content, in a bubble on your own messages.
116
119
  - `env-message-header`: The row with the author and the meta.
117
120
  - `env-message-meta`: The slot of the time or another fact about the message.
118
- - `env-message-status`: The sending or failed status.
121
+ - `env-message-start`: The slot of the content beside the message at its inline start, such as the author's avatar.
122
+ - `env-message-status`: The sending, failed or working status.
119
123
  - `env-message-text`: Content given as plain text, which keeps its line breaks.
120
124
  - `data-env-skeleton`: any value, or present, on `env-message`, `env-message-author`, `env-message-header`, `env-message-meta`
121
125
  - `data-from`: `other`, `self`
122
- - `data-status`: `failed`, `sending`
126
+ - `data-start`: present
127
+ - `data-status`: `failed`, `sending`, `working`
123
128
 
124
129
  ### MessageList
125
130
 
126
131
  - `env-message-list`: The list of messages.
127
- - `env-message-list-busy`: The row after the last message while busy: the busy author, a spinner and Working.
128
132
  - `env-message-list-jump`: The place of the Jump to latest button at the foot of a list that follows.
129
133
  - `data-follow`: present
130
134
 
@@ -136,5 +140,5 @@ EnvUIProvider's `messages` overrides each, and a component's own label prop wins
136
140
  | --- | --- | --- |
137
141
  | `messages.message.sending` | `"Sending"` | The status of a message on its way. |
138
142
  | `messages.message.failed` | `"Not sent"` | The status of a message that could not be sent. |
139
- | `messages.message.working` | `"Working"` | Beside the spinner of a MessageList while a reply is on its way. |
143
+ | `messages.message.working` | `"Working"` | The status of a reply still being written, beside its spinner. |
140
144
  | `messages.message.jumpToLatest` | `"Jump to latest"` | The button of a MessageList that follows, shown once newer messages arrive out of view. |
@@ -20,13 +20,12 @@ avoidWhen:
20
20
  use: Progress
21
21
  - text: A value people set within a range, such as a volume or a limit.
22
22
  use: Slider
23
- - text: A score on a scale of stars, such as a review's 4.5 out of 5.
24
- use: Rating
25
23
  components:
26
24
  - Meter
27
25
  examples: # Each file is examples/meter/<Name>.tsx.
28
26
  SeatsAssigned: overview
29
27
  MeterAnatomy: anatomy
28
+ InlineUsage: example
30
29
  LongLabel: example
31
30
  ---
32
31
 
@@ -42,6 +41,10 @@ examples: # Each file is examples/meter/<Name>.tsx.
42
41
 
43
42
  ## Behaviour
44
43
 
44
+ ### On one line
45
+
46
+ Example: InlineUsage.
47
+
45
48
  ### Adapting to width
46
49
 
47
50
  Example: LongLabel.
@@ -63,7 +66,8 @@ A measurement within a known range, such as the seats assigned of a plan or the
63
66
  | Prop | Type | Default | Description |
64
67
  | --- | --- | --- | --- |
65
68
  | `value` (required) | `number` | — | The measurement, between min and max. A value outside the range shows, and is reported, as the nearest end. |
66
- | `label` (required) | `ReactNode` | — | What the bar shows, such as Seats assigned; it is visible above the bar and names it. |
69
+ | `layout` | `'stacked' \| 'inline'` | `'stacked'` | stacked puts the label and the value on a row above the bar; inline puts the label, the bar and the value on one line, as in a table's usage column or a list row. |
70
+ | `label` | `ReactNode` | — | What the bar shows, such as Seats assigned; it shows with the bar and names it. Leave it out for a bare bar named with aria-label or aria-labelledby, such as by the name beside it in a row; without a label or valueText the bar has no row above it. |
67
71
  | `min` | `number` | `0` | The low end of the range. |
68
72
  | `max` | `number` | `100` | The high end of the range. |
69
73
  | `valueText` | `ReactNode` | — | The value as text at the end of the label's row, formatted by the application, such as 2 of 5 or 40%. Without it, no value shows. |
@@ -79,3 +83,4 @@ Native props: `<div>`.
79
83
  - `env-meter-label`: The label.
80
84
  - `env-meter-track`: The track.
81
85
  - `env-meter-value`: The value as text.
86
+ - `data-layout`: `inline`
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: MonthPicker
3
- summary: A field that opens a year of months to choose a month.
3
+ summary: A field for picking a month from a view of the year.
4
4
  status: beta
5
5
  since: 1.0.0
6
6
  category: Forms & selection
@@ -84,6 +84,7 @@ A field for a month of a year that shows the value in the reader's locale and op
84
84
 
85
85
  | Prop | Type | Default | Description |
86
86
  | --- | --- | --- | --- |
87
+ | `onOpenChange` | `(open: boolean, details: MonthPickerOpenChangeDetails) => void` | — | Called with the new state, and why, when the popup opens or closes. |
87
88
  | `value` | `string \| null` | — | The value: a month as YYYY-MM. null, or an empty string, for none. |
88
89
  | `defaultValue` | `string \| null` | `null` | The value an uncontrolled field starts with, and that a form reset restores; none by default. |
89
90
  | `onValueChange` | `(value: string \| null) => void` | — | Receives the new value as YYYY-MM, or null once the field is cleared. |
@@ -105,7 +106,8 @@ A field for a month of a year that shows the value in the reader's locale and op
105
106
  | `clearable` | `boolean` | `false` | A clear button in the field and in the popup removes the value. |
106
107
  | `open` | `boolean` | — | Whether the popup is open; with `onOpenChange` it controls it. |
107
108
  | `defaultOpen` | `boolean` | `false` | Whether an uncontrolled popup starts open; closed by default. |
108
- | `onOpenChange` | `(open: boolean, details: PickerOpenChangeDetails) => void` | — | Called with the new state, and why, when the popup opens or closes. |
109
+ | `popupHeader` | `ReactNode` | — | Content at the top of the popup, above the calendar or the list, such as presets: buttons for Tomorrow or Next Monday that set the value, from a field the application controls. |
110
+ | `popupFooter` | `ReactNode` | — | Content in the popup's footer, after its shortcut to the current date or time and before Clear, such as a note of the time zone or another action. |
109
111
  | `label` | `ReactNode` | — | The field's visible name, above the field, such as Project name; it also names the control for assistive technology. |
110
112
  | `description` | `ReactNode` | — | Lasting guidance under the field, such as a format or a limit, linked to the control as its description. |
111
113
  | `error` | `ReactNode` | — | A message under the field that says how to correct the value. While it is set, the control is invalid (aria-invalid) and the message joins its description, after the description. |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: NavigationDrawer
3
- summary: An application's main destinations, in a drawer, a rail or a bar by the window's width.
3
+ summary: An app's main navigation, shown as a drawer, a rail or a bar depending on the window width.
4
4
  status: beta
5
5
  since: 1.0.0
6
6
  category: Navigation
@@ -62,6 +62,8 @@ examples: # Each file is examples/navigation-drawer/<Name>.tsx.
62
62
  TabletDestinations: { role: overview, caption: "NavigationRail: each destination an icon above a short label, for a tablet." }
63
63
  PhoneDestinations: { role: overview, caption: "NavigationBar: three to five destinations along the bottom of a phone." }
64
64
  GuideSections: example
65
+ ActivityBar: example
66
+ GroupActions: example
65
67
  DrawerAnatomy: anatomy
66
68
  RailAnatomy: anatomy
67
69
  BarAnatomy: anatomy
@@ -81,6 +83,14 @@ examples: # Each file is examples/navigation-drawer/<Name>.tsx.
81
83
 
82
84
  Example: GuideSections.
83
85
 
86
+ ### Icons with tooltips
87
+
88
+ Example: ActivityBar.
89
+
90
+ ### Actions beside a group
91
+
92
+ Example: GroupActions.
93
+
84
94
  ## Anatomy
85
95
 
86
96
  1. **NavigationDrawer** (`env-navigation-drawer`)
@@ -169,6 +179,7 @@ The navigation drawer for expanded and larger windows: a column at the window's
169
179
  | `onExpandedChange` | `(expanded: string[]) => void` | — | Receives the open sections, as in `expanded`, as one opens or closes, and as the current destination moves into a closed section, which opens. |
170
180
  | `header` | `ReactNode` | — | Content above the destinations, such as the application's name or a search trigger. |
171
181
  | `footer` | `ReactNode` | — | Content below the destinations, at the bottom of the drawer, such as the account's menu. |
182
+ | `groupEnd` | `(group: string) => ReactNode` | — | Content after a group's heading, outside it, such as an IconButton that adds a project to Projects, a Menu of the group's actions or a count. It keeps its size, and the heading gives way to it. |
172
183
  | `headingLevel` | `Exclude<HeadingLevel, 1>` | `2` | The level of the groups' headings, which assistive technology lists with the page's headings: one below the heading the drawer sits under, such as 3 in a drawer under an h2. |
173
184
  | `background` | `'default' \| 'page'` | `'default'` | The drawer's background, named as Surface's and Card's: default, the default surface color, the app frame's own fill that stands apart from the page; page, the page's background, the same as the content beside it, from which a Scaffold sets it apart with a hairline. On a surface, such as a Sheet, both take the surface's color. |
174
185
  | `aria-label` | `string` | `messages.navigation.label, Main` | Names the navigation landmark, such as Main or Project; give each landmark of a page its own. |
@@ -193,6 +204,7 @@ The navigation rail for medium windows, such as tablets: a narrow column at the
193
204
  | `header` | `ReactNode` | — | Content above the destinations, such as a button that opens a Sheet with the NavigationDrawer, or the main action of the page. |
194
205
  | `footer` | `ReactNode` | — | Content at the bottom of the rail, such as the account's AvatarButton. |
195
206
  | `background` | `'default' \| 'page'` | `'default'` | The rail's background, named as Surface's and Card's: default, the default surface color, the app frame's own fill that stands apart from the page; page, the page's background, the same as the content beside it, from which a Scaffold sets it apart with a hairline. On a surface, such as a Sheet, both take the surface's color. |
207
+ | `visibleLabel` | `boolean` | `true` | Whether the destinations' labels show under their icons. False shows the icons only, for an icon-only rail such as a code editor's activity bar: each label still names its destination and shows in a tooltip on hover and keyboard focus. |
196
208
 
197
209
  Also `aria-label` and `skeleton`, as on NavigationDrawer.
198
210
 
@@ -206,6 +218,7 @@ The navigation bar for compact windows, such as phones: up to five destinations
206
218
  | --- | --- | --- | --- |
207
219
  | `destinations` (required) | `readonly Destination[]` | — | The application's destinations, the same array NavigationRail and NavigationDrawer take. Give the bar 3 to 5: past 5 it shows the first 4 and a More item that opens the rest in a menu. Groups and nested destinations don't show: a destination whose `children` hold the current one takes the current fill. |
208
220
  | `background` | `'default' \| 'page'` | `'default'` | The bar's background, named as Surface's and Card's: default, the default surface color, the app frame's own fill that stands apart from the page; page, the page's background, the same as the content beside it, from which a Scaffold sets it apart with a hairline. On a surface, such as a Sheet, both take the surface's color. |
221
+ | `visibleLabel` | `boolean` | `true` | Whether the destinations' labels show under their icons. False shows the icons only, for an icon-only bar such as a code editor's activity bar: each label still names its destination and shows in a tooltip on hover and keyboard focus. |
209
222
 
210
223
  Also `aria-label` and `skeleton`, as on NavigationDrawer.
211
224
 
@@ -223,7 +236,9 @@ Native props: `<nav>`.
223
236
  - `env-navigation-drawer-count`: A destination's count, at the item's end; 999+ above 999.
224
237
  - `env-navigation-drawer-end`: The slot of a destination's own controls at the end of its row, outside its link or button.
225
238
  - `env-navigation-drawer-footer`: The slot of the content below the destinations, at the bottom of the drawer.
239
+ - `env-navigation-drawer-group-end`: The slot of the content after a group's heading, outside it.
226
240
  - `env-navigation-drawer-group-label`: A group's label, which names the group's list.
241
+ - `env-navigation-drawer-group-row`: A group's heading with the content after it, in one row.
227
242
  - `env-navigation-drawer-header`: The slot of the content above the destinations, such as the application's name or a search trigger.
228
243
  - `env-navigation-drawer-item`: A destination: a link or button as wide as the drawer, with its icon, label and count.
229
244
  - `env-navigation-drawer-label`: A destination's label.
@@ -234,6 +249,8 @@ Native props: `<nav>`.
234
249
  - `env-navigation-drawer-toggle`: The button at the end of a section's link that opens and closes the section.
235
250
  - `data-background`: `default`, `page`
236
251
  - `data-current`: any value, or present, on `env-navigation-drawer-item`
252
+ - `data-disabled`: any value, or present, on `env-navigation-drawer-item`
253
+ - `data-dot`: any value, or present, on `env-navigation-drawer-count`
237
254
  - `data-ending-style`: any value, or present, on `env-navigation-drawer-children`
238
255
  - `data-env-skeleton`: any value, or present
239
256
  - `data-resizable`: present
@@ -245,18 +262,22 @@ Native props: `<nav>`.
245
262
  - `env-navigation-rail-count`: A destination's count, on the icon's top end; 999+ above 999.
246
263
  - `env-navigation-rail-footer`: The slot of the content at the bottom of the rail, such as the account's button.
247
264
  - `env-navigation-rail-header`: The slot of the content above the destinations, such as a button that opens the drawer or the main action.
248
- - `env-navigation-rail-indicator`: The rounded rectangle around a destination's icon, filled while the destination is current.
249
- - `env-navigation-rail-item`: A destination: a link or button with its indicator above its label.
265
+ - `env-navigation-rail-indicator`: The box around a destination's icon, which holds its count.
266
+ - `env-navigation-rail-item`: A destination: a link or button, its icon above its label. The current one takes the selected fill and a semibold label, as a navigation drawer's current row does.
250
267
  - `env-navigation-rail-label`: A destination's short label, under its indicator.
251
268
  - `env-navigation-rail-list`: The list of destinations, one under another, which scrolls where the rail is shorter.
252
269
  - `data-background`: `default`, `page`
253
270
  - `data-current`: any value, or present, on `env-navigation-rail-item`
271
+ - `data-disabled`: any value, or present, on `env-navigation-rail-item`
272
+ - `data-dot`: any value, or present, on `env-navigation-rail-count`
254
273
  - `data-env-skeleton`: any value, or present
274
+ - `data-label-hidden`: present
255
275
 
256
276
  ### NavigationBar
257
277
 
258
278
  - `env-navigation-bar`: The navigation bar: a nav landmark across the bottom of a compact window.
259
279
  - `env-navigation-bar-count`: A destination's count, on the icon's top end; 999+ above 999.
280
+ - `env-navigation-bar-dot`: The dot at the end of a menu item in More whose destination has something new and no count.
260
281
  - `env-navigation-bar-indicator`: The rounded rectangle around a destination's icon, filled while the destination is current.
261
282
  - `env-navigation-bar-item`: A destination: a link or button with its indicator above its label.
262
283
  - `env-navigation-bar-label`: A destination's label, under its indicator, cut short with an ellipsis.
@@ -264,7 +285,10 @@ Native props: `<nav>`.
264
285
  - `env-navigation-bar-more`: The last item past five destinations, which opens the rest in a menu.
265
286
  - `data-background`: `default`, `page`
266
287
  - `data-current`: present, on `env-navigation-bar-item`
288
+ - `data-disabled`: any value, or present, on `env-navigation-bar-item`
289
+ - `data-dot`: any value, or present, on `env-navigation-bar-count`
267
290
  - `data-env-skeleton`: any value, or present
291
+ - `data-label-hidden`: present
268
292
 
269
293
  ## Color properties
270
294
 
@@ -280,11 +304,11 @@ Each sets a color of one instance, through `style` or CSS; its hover, focus and
280
304
 
281
305
  ### NavigationRail
282
306
 
283
- - `--env-navigation-rail-item-container`: The indicator around the icon at rest; set, it takes state layers instead of the navigation's designed hover and press fills.
284
- - `--env-navigation-rail-item-content`: The label, and the color of the state layers.
307
+ - `--env-navigation-rail-item-container`: A destination's fill at rest; set, it takes state layers instead of the navigation's designed hover and press fills.
308
+ - `--env-navigation-rail-item-content`: The label of a destination that is not current, and the color of the state layers.
285
309
  - `--env-navigation-rail-item-icon`: The icon of a destination that is not current.
286
- - `--env-navigation-rail-item-selected`: The indicator around the icon of the current destination.
287
- - `--env-navigation-rail-item-selected-content`: The icon of the current destination.
310
+ - `--env-navigation-rail-item-selected`: The fill of the current destination.
311
+ - `--env-navigation-rail-item-selected-content`: The icon and label of the current destination.
288
312
 
289
313
  ### NavigationBar
290
314
 
@@ -302,6 +326,7 @@ EnvUIProvider's `messages` overrides each, and a component's own label prop wins
302
326
  | --- | --- | --- |
303
327
  | `messages.navigation.label` | `"Main"` | Names the navigation landmark where the application gives it no name of its own. |
304
328
  | `messages.navigation.itemCount` | `({ label, count }) => string` | Names a destination with a count, such as Inbox, 3 new. |
329
+ | `messages.navigation.itemNew` | `({ label }) => string` | Names a destination with something new and no count, shown as a dot, such as Activity, new. |
305
330
  | `messages.navigation.more` | `"More"` | Labels the NavigationBar's last item, which opens the destinations that don't fit in a menu. |
306
331
  | `messages.navigation.moreCurrent` | `({ name }) => string` | Names the NavigationBar's More item while its menu holds the current destination, after its name with any count, such as More, 5 new, current page inside. |
307
332
  | `messages.navigation.contents` | `({ label }) => string` | Names the button beside a NavigationDrawer destination that opens and closes the destinations nested under it, such as Guides contents; its aria-expanded says whether they show. |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Page
3
- summary: The column a page's content sits in, under its title and actions.
3
+ summary: The content column of a page, below its title and actions.
4
4
  status: beta
5
5
  since: 1.0.0
6
6
  category: App frame & layout
@@ -30,7 +30,7 @@ avoidWhen:
30
30
  use: Scaffold
31
31
  - text: The application's bar across every page, with its name and account menu.
32
32
  use: TopBar
33
- - text: Two panes side by side, such as a list and its detail.
33
+ - text: Two panes side by side, such as a document and its details.
34
34
  use: Panes
35
35
  components:
36
36
  - Page
@@ -101,7 +101,7 @@ The column a page's content sits in: invisible structure that never paints, cent
101
101
  | `width` | `'sm' \| 'md' \| 'lg' \| 'full'` | `'lg'` | How wide the content may grow, a readable width: sm (40 rem) for a form or a settings page, md (60 rem) for a document or a detail page, lg (76 rem) for a dashboard or a list, full for content that uses the whole width, such as a board. The column is centered in the space it has. |
102
102
  | `header` | `ReactNode` | — | The page's heading, usually a PageHeader, at the top of the same column. |
103
103
  | `gutter` | `boolean` | `true` | Pads the column at its inline edges with the page gutter, which follows the window class of the region the page sits in: 1 rem in a compact one, 1.5 rem from medium. False leaves the edges to the content, such as a page that is one full-bleed table. |
104
- | `name` | `string` | — | A name for this node, such as "settings", which dev mode and the docs show; it renders as `data-env-name`. |
104
+ | `name` | `string` | — | A name for this node, such as "settings", for the application's styles and tests to find it by; it renders as `data-env-name`. |
105
105
  | `render` | `ReactElement` | — | The element to render, for its meaning, such as render={<article />}; a div by default. The page's class and attributes merge into its props. |
106
106
  | `children` | `ReactNode` | — | The page's content, under its header. |
107
107
 
@@ -124,6 +124,7 @@ The heading of a page: its title with an optional trail above it, a description,
124
124
  | `sticky` | `boolean` | `false` | Keeps the header in view at the top of the area that scrolls, over the content that scrolls under it: under a Scaffold's top bar where the document scrolls, or at the top of a Scaffold's body that scrolls. As a Page's header, what scrolls into view below it, such as a field taking focus, keeps clear of it: the header measures its height, which CSS reckons from its rows until script runs. |
125
125
  | `controlSize` | `'sm' \| 'md'` | `'md'` | The size of the buttons and icon buttons in `actions` and `toolbar` that set none: sm for a dense page, such as one in a small window, or md. Give fields in the toolbar the same `size`. |
126
126
  | `focusOnNavigation` | `boolean` | `true` | In a Scaffold, moves focus to the title of a level 1 header when the page changes: as a new page's header mounts after the Scaffold first showed, not as a title changes. People using a screen reader then hear the new page, and the next Tab starts from it. Focus moved there shows no ring, and focus in a field or an open overlay stays where it is. False leaves focus to the application. |
127
+ | `children` | `ReactNode` | — | More rows under the toolbar, placed as given, such as a progress strip or an inline Alert. They stay in the header, so they stick with it. |
127
128
 
128
129
  Native props: `<div>`.
129
130
 
@@ -46,7 +46,7 @@ Example: ComposedParts.
46
46
 
47
47
  1. **Pager** (`env-pager`)
48
48
  2. **Link** (`env-pager-link-previous`, `previous`)
49
- 3. **Icon** (`env-pager-link-previous > env-icon`, `icon`)
49
+ 3. **Start** (`env-pager-link-start`, `start`)
50
50
  4. **Direction** (`env-pager-link-label`)
51
51
  5. **Title** (`env-pager-link-title`, `children`)
52
52
 
@@ -72,7 +72,7 @@ import { Pager } from '@envsemble/envui';
72
72
 
73
73
  ### Pager.Root
74
74
 
75
- A centered pair of previous and next destinations in a navigation landmark, its Pager.Previous and Pager.Next children; either one can be left out, and without any it renders nothing.
75
+ A centered pair of previous and next destinations in a navigation landmark, its Pager.Previous and Pager.Next children; either one can be left out, and without any it renders nothing. Where the two don't fit side by side, they stack as rows of the pager's width, the previous first.
76
76
 
77
77
  | Prop | Type | Default | Description |
78
78
  | --- | --- | --- | --- |
@@ -83,32 +83,42 @@ Native props: `<nav>`.
83
83
 
84
84
  ### Pager.Previous
85
85
 
86
- The destination before this one: a native link with rel="prev", its title under the label Previous (EnvUIProvider's messages.pager.previous), and an optional icon before them. It also stands alone, outside Pager.Root.
86
+ The destination before this one: a native link with rel="prev", its title under the label Previous (EnvUIProvider's messages.pager.previous), and optional content before them, its start. It also stands alone, outside Pager.Root.
87
87
 
88
88
  | Prop | Type | Default | Description |
89
89
  | --- | --- | --- | --- |
90
90
  | `href` (required) | `string` | — | The destination; the link renders through the LinkProvider's link component. |
91
91
  | `children` (required) | `ReactNode` | — | The destination's title, such as the name of the next page. It shows below the direction label, wraps between words, and names the link after the label. |
92
- | `icon` | `ReactNode` | — | A decorative icon, such as ArrowBack, before the previous destination's text, or such as ArrowForward, after the next one's; none by default. |
93
92
  | `rel` | `string` | `'prev' on Pager.Previous, 'next' on Pager.Next` | The link's relation to this page. |
93
+ | `label` | `ReactNode` | `'Previous' or 'Up next', or EnvUIProvider's messages.pager.previous or next` | The direction label above the title, such as Previous chapter or Back to setup, for this link alone; null leaves it out. |
94
+ | `start` | `ReactNode` | — | Content before the text, such as IconArrowBack: an envUI icon takes the pager's icon size and other content keeps its own. It is hidden from assistive technology; none by default. |
94
95
 
95
96
  Native props: `<a>`.
96
97
 
97
98
  ### Pager.Next
98
99
 
99
- The destination after this one: a native link with rel="next", its title under the label Up next (EnvUIProvider's messages.pager.next), and an optional icon after them. It also stands alone, outside Pager.Root.
100
+ The destination after this one: a native link with rel="next", its title under the label Up next (EnvUIProvider's messages.pager.next), and optional content after them, its end. It also stands alone, outside Pager.Root.
100
101
 
101
- Takes `href`, `children`, `icon` and `rel`, as on Pager.Previous. Native props: `<a>`.
102
+ | Prop | Type | Default | Description |
103
+ | --- | --- | --- | --- |
104
+ | `end` | `ReactNode` | — | Content after the text, such as IconArrowForward: an envUI icon takes the pager's icon size and other content keeps its own. It is hidden from assistive technology; none by default. |
105
+
106
+ Also `href`, `children`, `rel` and `label`, as on Pager.Previous.
107
+
108
+ Native props: `<a>`.
102
109
 
103
110
  ## Part names
104
111
 
105
112
  - `env-pager`: The previous and next links.
106
113
  - `env-pager-link`: One link.
107
114
  - `env-pager-link-copy`: The column with a link's label and title.
115
+ - `env-pager-link-end`: The slot of the content after the next link's text, such as an icon.
108
116
  - `env-pager-link-label`: A link's label, Previous or Next.
109
117
  - `env-pager-link-next`: The link to the next page.
110
118
  - `env-pager-link-previous`: The link to the previous page.
119
+ - `env-pager-link-start`: The slot of the content before the previous link's text, such as an icon.
111
120
  - `env-pager-link-title`: The title of the page a link leads to.
121
+ - `data-stacked`: present
112
122
 
113
123
  ## Strings
114
124
 
@@ -62,15 +62,16 @@ Compact pagination for toolbars: the range of items shown, such as 1–60 of 245
62
62
  | `pageSize` (required) | `number` | — | The most items a page shows, such as 60; at least 1. |
63
63
  | `total` | `number` | — | All items, when known; the range then ends with it, as in 1–60 of 245, and the last page ends the list. Leave it out for a list read in batches, where hasNextPage says when it ends. |
64
64
  | `hasNextPage` | `boolean` | `true` | Whether a later page exists, for a list without total, such as from a cursor's has more. |
65
- | `onPageChange` (required) | `(page: number) => void` | — | Receives the page before or after the current one when its button is pressed. The application loads that page and passes it back as page. |
66
65
  | `pending` | `boolean` | `false` | A page is loading: the button pressed shows a spinner, also when the load starts in an effect after the page changes, and both buttons ignore presses while staying focusable. A load for another reason, such as a refresh, makes both wait without a spinner. |
67
66
  | `hideWhenSinglePage` | `boolean` | `false` | Render nothing while every item fits on one page, so neither button has anywhere to go. |
68
- | `formatRange` | `(range: PaginationRange) => ReactNode` | `1–60 of 245, or 61–120 without total, with numbers in the locale` | Writes the range from the first and last item shown, the total, the page and the page count, for one pager; EnvUIProvider's messages.pagination.range writes it for every pager. |
67
+ | `renderRange` | `(range: PaginationRange) => ReactNode` | `1–60 of 245, or 61–120 without total, with numbers in the locale` | Draws the range from the first and last item shown, the total, the page and the page count, for one pager; EnvUIProvider's messages.pagination.range writes it for every pager. |
69
68
  | `previousLabel` | `string` | `'Previous page', or EnvUIProvider's messages.pagination.previous` | The previous button's accessible name and tooltip. |
70
69
  | `nextLabel` | `string` | `'Next page', or EnvUIProvider's messages.pagination.next` | The next button's accessible name and tooltip. |
71
70
  | `variant` | `'primary' \| 'secondary' \| 'outline' \| 'ghost' \| 'text'` | `'ghost'` | The buttons' variant, as on IconButton: quiet neutral icon buttons by default. |
72
71
  | `size` | `'sm' \| 'md' \| 'lg'` | — | The buttons' height, as on every control: sm, md or lg in the current scale. Without it, they take the control height of the container, md unless the container sets another. |
73
72
  | `aria-label` | `string` | `'Pagination', or EnvUIProvider's messages.pagination.label` | The navigation landmark's name, such as Report pages, where a page has more than one. |
73
+ | `onPageChange` | `(page: number) => void` | — | Required when `pageHref` is not set. Receives the page before or after the current one when its button is pressed. The application loads that page and passes it back as page. Give it, or pageHref, or both. |
74
+ | `pageHref` | `(page: number) => string` | — | Required when `onPageChange` is not set. The address of a page, such as `?page=3`, for a list whose pages have their own URLs: the previous and next controls are then links, through the LinkProvider's link component, which open in a new tab, are crawlable and work before hydration. A control with no page to go to reports aria-disabled and has no destination. |
74
75
 
75
76
  Native props: `<nav>`.
76
77