@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: Panes
3
- summary: A region split into two panes side by side, such as a list and its detail.
3
+ summary: Two panes side by side, such as a document and its details.
4
4
  status: beta
5
5
  since: 1.0.0
6
6
  category: App frame & layout
@@ -14,8 +14,8 @@ aliases:
14
14
  - side pane
15
15
  - resizable panes
16
16
  useWhen:
17
- - A list beside the chosen item's detail, such as messages
18
17
  - A document beside its details, which people resize
18
+ - Two views of one thing side by side, such as source and its preview
19
19
  avoidWhen:
20
20
  - text: An application's screen with its top bar and navigation.
21
21
  use: Scaffold
@@ -25,9 +25,8 @@ avoidWhen:
25
25
  use: ResizeHandle
26
26
  components:
27
27
  - Panes
28
- - readPanesWidth
29
28
  examples: # Each file is examples/panes/<Name>.tsx.
30
- ListAndDetail: { role: overview, caption: "A list and its detail, with the resize handle on the seam." }
29
+ DocumentAndDetails: { role: overview, caption: "A document and its details, with the resize handle on the seam; the details pane keeps its width as the region resizes." }
31
30
  ResizableDetails: example
32
31
  PanesAnatomy: anatomy
33
32
  StackedWhenNarrow: example
@@ -35,18 +34,12 @@ examples: # Each file is examples/panes/<Name>.tsx.
35
34
 
36
35
  # Panes
37
36
 
38
- ## Variants
39
-
40
- ### Details at the end
41
-
42
- Example: ResizableDetails.
43
-
44
37
  ## Anatomy
45
38
 
46
39
  1. **Root** (`env-panes`)
47
- 2. **Pane** (`env-panes-pane`)
40
+ 2. **Pane** (`env-panes-pane:first-child`)
48
41
  3. **Resize handle** (`env-panes-resize-handle`)
49
- 4. **Pane** (`env-panes-pane`)
42
+ 4. **Pane** (`env-panes-pane:last-child`)
50
43
 
51
44
  ## Behaviour
52
45
 
@@ -54,6 +47,10 @@ Example: ResizableDetails.
54
47
 
55
48
  Example: StackedWhenNarrow.
56
49
 
50
+ ### Keeping the width people chose
51
+
52
+ Example: ResizableDetails.
53
+
57
54
  ## Accessibility
58
55
 
59
56
  ### Keyboard
@@ -69,27 +66,25 @@ Example: StackedWhenNarrow.
69
66
  ### Import
70
67
 
71
68
  ```tsx
72
- import { Panes, readPanesWidth } from '@envsemble/envui';
69
+ import { Panes } from '@envsemble/envui';
73
70
  ```
74
71
 
75
72
  ## Props
76
73
 
77
74
  ### Panes.Root
78
75
 
79
- A region split into two panes side by side, such as a list and its detail: one pane has a width of its own, which a Panes.ResizeHandle between them resizes, and the other takes the rest. Each pane's content scrolls on its own under its header when Panes has a height. With `stackBelow` the panes stack in a narrow region. Panes fill their region with square corners; an application rounds them with its own class, and the panes follow, since the root clips them.
76
+ A region split into two panes side by side, such as a list and its detail: one pane has a width of its own, which a Panes.ResizeHandle between them resizes, and the other takes the rest. Each pane's content scrolls on its own under its header when Panes has a height. With `stackBelow` the panes stack in a narrow region. A pane the application renders alone, such as the list while no item is open, fills the region and the handle hides. Panes fill their region with square corners; an application rounds them with its own class, and the panes follow, since the root clips them.
80
77
 
81
78
  | Prop | Type | Default | Description |
82
79
  | --- | --- | --- | --- |
83
80
  | `sized` | `'start' \| 'end'` | `'start'` | Which pane has a width of its own, which Panes.ResizeHandle resizes: the first, such as a list or a sidebar, or the last, such as details. The other pane takes the rest of the room. |
84
81
  | `stackBelow` | `'medium' \| 'expanded' \| 'large'` | — | The window class of the Panes' own width below which the panes stack, the first above the last, each half the height, and the resize handle hides: medium (37.5 rem), expanded (52.5 rem) or large (75 rem). CSS decides it, so the server's markup is right before any script runs. Without it the panes always sit side by side. |
85
82
  | `width` | `number` | — | The sized pane's width in rem, for Panes the application controls with onWidthChange. |
86
- | `defaultWidth` | `number` | `22.5` | The sized pane's width in rem until people choose one with Panes.ResizeHandle, or one is kept under `persist`, and the width a double click on the handle returns it to. |
83
+ | `defaultWidth` | `number` | `22.5` | The sized pane's width in rem until people choose one with Panes.ResizeHandle, and the width a double click on the handle returns it to. To keep the width people choose, store what onWidthChange receives and pass it back here. |
87
84
  | `onWidthChange` | `(width: number, details: ResizeDetails) => void` | — | Receives each new width of the sized pane, in rem: while dragging the handle with committed false, and with committed true as a drag ends, a key moves it or a double click resets it. |
88
85
  | `minWidth` | `number` | `16` | The sized pane's smallest width, in rem. |
89
86
  | `maxWidth` | `number` | `40` | The sized pane's largest width, in rem. It never leaves the other pane less than 16 rem. |
90
- | `persist` | `string` | — | Keeps the width people choose in a cookie of this name, for Panes the application doesn't control; a double click on the handle forgets it and returns to `defaultWidth`. Read it on the server with `readPanesWidth(cookieHeader, key)` and pass it as `persistedWidth`, so the server's markup has it and nothing moves as the page hydrates. Without that, the kept width applies after the first render. |
91
- | `persistedWidth` | `number` | — | The width kept under `persist`, in rem, as the server read it from the request's cookies with `readPanesWidth`: the first render uses it, on the server and in the browser alike. |
92
- | `name` | `string` | — | A name for this node, such as "inbox", which dev mode and the docs show; it renders as `data-env-name`. |
87
+ | `name` | `string` | — | A name for this node, such as "inbox", for the application's styles and tests to find it by; it renders as `data-env-name`. |
93
88
  | `children` (required) | `ReactNode` | — | The two panes, with a Panes.ResizeHandle between them for people to resize them. |
94
89
 
95
90
  Native props: `<div>`.
@@ -117,14 +112,6 @@ The ResizeHandle between the panes, which resizes the sized pane: invisible on t
117
112
 
118
113
  Native props: `<div>`.
119
114
 
120
- ### readPanesWidth
121
-
122
- The width Panes keeps under its `persist` key, read from a Cookie header, such as the request's on the server, or from `document.cookie`. Render Panes.Root with it as `persistedWidth`, on the server and in the browser alike, so the server's markup has the width people chose and nothing moves as the page hydrates: <Panes.Root persist="inbox" persistedWidth={readPanesWidth(cookieHeader, 'inbox')}> Returns undefined where no width is kept under the key, or what is kept there is no width.
123
-
124
- ```ts
125
- readPanesWidth(cookies: string | null | undefined, key: string): number | undefined
126
- ```
127
-
128
115
  ## Part names
129
116
 
130
117
  - `env-panes`: The panes: a region split into two panes side by side, or stacked in less room; it never paints.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Popover
3
- summary: A floating panel beside its trigger, for details or a small form.
3
+ summary: A floating panel next to the control that opens it, for details or a small form.
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Overlays
@@ -70,7 +70,8 @@ A floating panel beside its trigger, for details or a small form: it opens on pr
70
70
 
71
71
  | Prop | Type | Default | Description |
72
72
  | --- | --- | --- | --- |
73
- | `trigger` (required) | `ReactElement` | — | The control that opens and closes the popover, such as a Button or an IconButton. It must take a ref and props: it receives the press handler, aria-haspopup and aria-expanded. |
73
+ | `trigger` | `ReactElement` | — | The control that opens and closes the popover, such as a Button or an IconButton. It must take a ref and props: it receives the press handler, aria-haspopup and aria-expanded. Leave it out for a popover the application opens with open, beside its anchor. |
74
+ | `anchor` | `PopoverAnchor` | `the trigger` | What the popover opens beside where that isn't its trigger, such as a table cell, a word in the text or a range of selected text: an element, its ref, or a virtual element with a getBoundingClientRect. |
74
75
  | `title` | `ReactNode` | — | A heading at the top, such as the name of what the popover describes; it names the popover. |
75
76
  | `children` (required) | `ReactNode \| ((close: () => void) => ReactNode)` | — | The popover's content, or a function that receives close, for an action inside it that should close the popover once it is done, such as a form's submit. |
76
77
  | `aria-label` | `string` | — | The popover's accessible name when it has no title, such as Rename document. |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Progress
3
- summary: How much of a task is done, or that it runs while the amount is unknown.
3
+ summary: Shows how much of a task is done, or that it is still running.
4
4
  status: beta
5
5
  since: 1.0.0
6
6
  category: Feedback
@@ -86,7 +86,7 @@ How much of a task is done, such as an upload or an import: a label, an optional
86
86
  | --- | --- | --- | --- |
87
87
  | `value` (required) | `number \| null` | — | How much of the task is done, between min and max, such as 40 of 100; null while the amount of work is unknown, which shows an indeterminate bar announced as Loading. |
88
88
  | `segments` | `number` | — | Splits the track into this many equal steps, such as 4 for a task of four stages, each filling in turn. Without it, the track is one bar. |
89
- | `label` (required) | `ReactNode` | — | What the bar shows, such as Seats assigned; it is visible above the bar and names it. |
89
+ | `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. |
90
90
  | `min` | `number` | `0` | The low end of the range. |
91
91
  | `max` | `number` | `100` | The high end of the range. |
92
92
  | `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. |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Radio
3
- summary: One choice from up to five options, all in view, listed one under the other.
3
+ summary: Picks one of up to five options, all visible at once.
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Forms & selection
@@ -28,6 +28,7 @@ components:
28
28
  examples: # Each file is examples/radio/<Name>.tsx.
29
29
  ChooseLanguage: overview
30
30
  SideBySide: example
31
+ PlanRows: example
31
32
  RadioAnatomy: anatomy
32
33
  RequiredChoice: example
33
34
  ---
@@ -40,12 +41,16 @@ examples: # Each file is examples/radio/<Name>.tsx.
40
41
 
41
42
  Example: SideBySide.
42
43
 
44
+ ### Rows of a list
45
+
46
+ Example: PlanRows.
47
+
43
48
  ## Anatomy
44
49
 
45
50
  1. **Group** (`env-radio-group`)
46
51
  2. **Group label** (`env-radio-group > legend`, `label`)
47
52
  3. **Option** (`env-radio`)
48
- 4. **Label** (`env-radio > span::text`, `label`)
53
+ 4. **Label** (`env-radio-label`, `label`)
49
54
  5. **Description** (`env-radio-description`, `description`)
50
55
  6. **Radio** (`env-radio-input`)
51
56
  7. **State layer** (`env-radio-control`)
@@ -73,7 +78,7 @@ A set of up to five options to choose exactly one from, all in view: a native fi
73
78
  | Prop | Type | Default | Description |
74
79
  | --- | --- | --- | --- |
75
80
  | `ref` | `Ref<HTMLFieldSetElement>` | — | The group's fieldset. |
76
- | `label` | `ReactNode` | — | The group's visible name, such as Visibility, as the fieldset's legend above the options. It names the group for assistive technology. Without it, name it with aria-label or aria-labelledby. |
81
+ | `label` | `ReactNode` | — | The group's visible name, such as Visibility, as the fieldset's legend above the options. It names the group for assistive technology. Without it, a List.Item whose control it is names it, or name it with aria-label or aria-labelledby. |
77
82
  | `value` | `string \| null` | — | The value of the chosen option in a controlled group, or null for none; update it from onValueChange. |
78
83
  | `defaultValue` | `string` | — | The value of the option an uncontrolled group starts with; a native form reset returns to it. Without value or defaultValue, no option is chosen until people choose one. |
79
84
  | `onValueChange` | `(value: string) => void` | — | Receives the value of the option people choose. |
@@ -96,8 +101,9 @@ One option of a RadioGroup: a native radio input with its label, and an optional
96
101
  | `className` | `string` | — | The option's class, on its root element, the label around the radio and the text. |
97
102
  | `style` | `CSSProperties` | — | Styles of the root element. |
98
103
  | `value` (required) | `string` | — | The value the group reports and a form submits when this option is chosen. |
99
- | `label` (required) | `ReactNode` | — | The option's visible name, such as Private; pressing it chooses the option. |
104
+ | `label` | `ReactNode` | — | The option's visible name, such as Private; pressing it chooses the option. Without it, a List.Item whose control it is names it, such as a plan's row with its price and features, or name it with aria-label or aria-labelledby, such as a radio in a table's cell. |
100
105
  | `description` | `ReactNode` | — | A short, muted line under the label that helps people choose, such as Only the people you invite. It is part of the option's label, so it is read with its name. |
106
+ | `labelPlacement` | `'end' \| 'start'` | `'end'` | Where the label sits beside the radio: end, after it, or start, before it, such as in an inline row whose label leads; the native label still names the radio. |
101
107
 
102
108
  Native props: `<input>`.
103
109
 
@@ -119,7 +125,9 @@ Native props: `<input>`.
119
125
  - `env-radio-description`: A radio's description.
120
126
  - `env-radio-description-content`: The slot of a radio's description.
121
127
  - `env-radio-input`: The native input.
122
- - `env-radio-label`: The slot of a radio's label.
128
+ - `env-radio-label`: The label, with the description under it.
129
+ - `env-radio-label-content`: The slot of the label.
130
+ - `data-label-placement`: `start`
123
131
  - `data-orientation`: `horizontal`, `vertical`
124
132
 
125
133
  ## Color properties
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: RelativeTime
3
- summary: A moment as text relative to now, such as 3 hours ago, kept current.
3
+ summary: A time shown relative to now, such as 3 hours ago, kept up to date.
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Data display
@@ -70,6 +70,7 @@ A moment in a time element as text relative to now, such as "3 hours ago", with
70
70
  | `value` (required) | `RelativeTimeValue` | — | The moment to describe: a Date, milliseconds since 1970 or a date string such as an ISO 8601 timestamp. An invalid moment renders nothing. |
71
71
  | `now` | `Date \| number` | — | A fixed moment to compare with, for tests and server rendering; the text then stays as it is. Without it, or with an invalid one, the text follows the current time. |
72
72
  | `tooltip` | `boolean` | `true` | Show the date and time in a tooltip on hover, such as "Oct 14, 2026, 9:41 AM", in the reader's time zone and the locale. Turn it off where the exact moment shows nearby. Inside an application's own Tooltip, that one describes the time instead. |
73
+ | `renderTooltip` | `(date: Date) => ReactNode` | — | The tooltip's content from the moment, such as the time with its time zone, in UTC, or "Edited by Alex Morgan at 9:41"; the date and time in the locale by default. |
73
74
  | `locale` | `string \| readonly string[]` | `EnvUIProvider's locale for RelativeTime, else the runtime's language: the browser's, or the server's while rendering there` | The language of the text, and of the date and time in RelativeTime's tooltip, as a BCP 47 tag such as "en-GB" or "de", or a list of them in order of preference. |
74
75
  | `format` | `'long' \| 'short' \| 'narrow'` | `'long'` | How long the words are, from Intl.RelativeTimeFormat: long "3 hours ago", short "3 hr. ago" or narrow "3h ago", in the locale's own wording. |
75
76
  | `nowLabel` | `string` | `'just now' or 'now' in English, the locale's word for now elsewhere` | Text for a moment less than 45 seconds away, past or coming, such as "moments ago". English says "just now" of a past moment and "now" of a coming one; other languages the locale's word. RelativeTime takes EnvUIProvider's `messages.relativeTime.now` without it. |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: ResizeHandle
3
- summary: A handle people drag, or move with the keys, to resize what is beside it.
3
+ summary: A handle that resizes the area next to it, by dragging or with the arrow keys.
4
4
  status: beta
5
5
  since: 2.0.0
6
6
  category: App frame & layout
@@ -11,17 +11,19 @@ aliases:
11
11
  - drag handle
12
12
  - separator
13
13
  useWhen:
14
- - A sidebar or a panel whose width people choose
15
- - An edge between two regions that aren't Panes
14
+ - A docked panel whose height people choose, such as a run's logs
15
+ - An edge that none of envUI's resizable components already gives
16
16
  avoidWhen:
17
17
  - text: Two panes of one region, side by side, one of them resized.
18
18
  use: Panes
19
+ - text: An application's navigation, whose width people choose.
20
+ use: NavigationDrawer
19
21
  - text: A panel over the page whose width people choose.
20
22
  use: Sheet
21
23
  components:
22
24
  - ResizeHandle
23
25
  examples: # Each file is examples/resize-handle/<Name>.tsx.
24
- ProjectSidebar: { role: overview, caption: "The sidebar's edge, invisible until the pointer is over it, with its grip." }
26
+ DockedLogs: { role: overview, caption: "The top edge of a run's logs, which people drag up to read more of them; its grip shows where to take it." }
25
27
  ResizeHandleAnatomy: anatomy
26
28
  WithoutAGrip: example
27
29
  ---
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Row
3
- summary: Lays out content side by side with even gaps, wrapping when it doesn't fit.
3
+ summary: Places content side by side with even gaps, wrapping when it doesn't fit.
4
4
  status: beta
5
5
  since: 1.0.0
6
6
  category: App frame & layout
@@ -65,7 +65,7 @@ Lays its direct children out side by side, `gap` apart, with `wrap` to run onto
65
65
  | `justify` | `'start' \| 'center' \| 'end' \| 'between'` | `'start'` | Where the children sit along the line when there is room to spare: at the start, in the center, at the end, such as a form's actions, or between, spread out to the edges. |
66
66
  | `render` | `ReactElement` | — | The element to render, for its meaning, such as render={<section />} or render={<ul />}, or another component to lay out without a wrapper, such as a Surface: the primitive's attributes merge into its props. It must forward native props and refs. A div by default. |
67
67
  | `ref` | `Ref<RenderedElement>` | — | The rendered element, a div by default. Its type is the element type parameter, which a ref passed in sets: a ref to the element that render makes, such as useRef<HTMLElement>(null) with render={<section />}, type-checks. |
68
- | `name` | `string` | — | A name for this node, such as "filters" or "summary", which dev mode and the docs show; it renders as `data-env-name`. A component's part class names its node instead. |
68
+ | `name` | `string` | — | A name for this node, such as "filters" or "summary", for the application's styles and tests to find it by; it renders as `data-env-name`. A component's part class names its node instead. |
69
69
  | `container` | `string` | — | Makes the element a size container of this name, for container queries on its inline size, such as container="filters" for `@container filters (width >= 37.5rem)`. A container is as wide as its context gives it, never as its content. container="env-window" makes the element a window of its own on purpose, such as a preview frame, whose content lays out at its window class; other `env-*` names are envUI's own. |
70
70
  | `padding` | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9` | — | The inset on every side, a step of the spacing scale. None by default. |
71
71
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Scaffold
3
- summary: The frame of an application's screen, around its top bar, its navigation and the page.
3
+ summary: 'The layout of an app screen: top bar, navigation and page.'
4
4
  status: beta
5
5
  since: 1.0.0
6
6
  category: App frame & layout
@@ -24,7 +24,7 @@ useWhen:
24
24
  avoidWhen:
25
25
  - text: A readable column for a page's content, with its gutters.
26
26
  use: Page
27
- - text: Two panes side by side inside the body, such as a list and its detail.
27
+ - text: Two panes side by side inside the body, such as a document and its details.
28
28
  use: Panes
29
29
  components:
30
30
  - Scaffold
@@ -33,6 +33,7 @@ examples: # Each file is examples/scaffold/<Name>.tsx.
33
33
  ChooseForms: example
34
34
  NarrowNavigation: example
35
35
  TitleBarAcross: example
36
+ InspectorAndStatus: example
36
37
  NavigationApart: example
37
38
  ScaffoldAnatomy: anatomy
38
39
  FormsByWidth: example
@@ -54,6 +55,10 @@ Example: NarrowNavigation.
54
55
 
55
56
  Example: TitleBarAcross.
56
57
 
58
+ ### An inspector and a status bar
59
+
60
+ Example: InspectorAndStatus.
61
+
57
62
  ### Backgrounds
58
63
 
59
64
  Example: NavigationApart.
@@ -83,11 +88,13 @@ import { Scaffold } from '@envsemble/envui';
83
88
 
84
89
  ### Scaffold
85
90
 
86
- The invisible structure of an application's screen: a top bar region, a navigation region and the body. It never paints. It shows one navigation form at a time by its own width: a NavigationBar at the bottom of a compact window, a NavigationRail at the start of a medium one and a NavigationDrawer at the start from expanded. The document scrolls by default, with the top bar, the bar and the rail or the drawer kept in view; `scroll="body"` scrolls the body alone. Skip links to the body and the navigation come first.
91
+ The invisible structure of an application's screen: a top bar region, a navigation region and the body, with an optional aside region and bottom bar. It never paints. It shows one navigation form at a time by its own width: a NavigationBar at the bottom of a compact window, a NavigationRail at the start of a medium one and a NavigationDrawer at the start from expanded. The document scrolls by default, with the top bar, the bar and the rail or the drawer kept in view; `scroll="body"` scrolls the body alone. Skip links to the body and the navigation come first.
87
92
 
88
93
  | Prop | Type | Default | Description |
89
94
  | --- | --- | --- | --- |
90
95
  | `topBar` | `ReactNode` | — | The top bar region, above the body: usually a TopBar. |
96
+ | `aside` | `ReactNode` | — | A region at the end edge, beside the body and under the top bar, such as an inspector, at the width of its content and scrolling on its own. It stays in view as the rail does. |
97
+ | `bottomBar` | `ReactNode` | — | A bar along the bottom of the body and the aside region, such as a status bar, above a NavigationBar. It stays in view as the top bar does, and focus scrolls clear of it. |
91
98
  | `navigation` | `ScaffoldNavigation` | — | The navigation forms, such as `{ bar: <NavigationBar … />, rail: <NavigationRail … />, drawer: <NavigationDrawer … /> }` with the same destinations. One shows at a time, chosen by the Scaffold's own width; give only the forms the application uses. |
92
99
  | `navigationForms` | `ScaffoldForms` | `{ compact: 'bar', medium: 'rail', expanded: 'drawer', large: 'drawer' }` | Which form shows at each window class, or none, such as `{ compact: 'none' }` for an application that opens its navigation from the top bar on a phone. Where the form a window class asks for wasn't given, the nearest given form shows: a rail for a drawer and the other way round, then the bar. |
93
100
  | `topBarSpan` | `'body' \| 'full'` | `'body'` | body: the top bar sits above the body, beside the rail or drawer, which run the full height. full: the top bar runs across the whole width, above the navigation, as a window's title bar must. |
@@ -97,7 +104,7 @@ The invisible structure of an application's screen: a top bar region, a navigati
97
104
  | `skipToContentLabel` | `string` | `'Skip to content', or EnvUIProvider's messages.scaffold.skipToContent` | The name of the skip link to the body. |
98
105
  | `skipToNavigationLabel` | `string` | `'Skip to navigation', or EnvUIProvider's messages.scaffold.skipToNavigation` | The name of the skip link to the navigation. |
99
106
  | `landmarks` | `boolean` | `true` | false renders the regions without landmarks, a div for the banner and the main, and no skip links, for a preview of an application inside another page's main content. |
100
- | `name` | `string` | — | A name for this node, such as "app", which dev mode and the docs show; it renders as `data-env-name`. |
107
+ | `name` | `string` | — | A name for this node, such as "app", for the application's styles and tests to find it by; it renders as `data-env-name`. |
101
108
  | `children` | `ReactNode` | — | The body: the page's main content, usually a Page or Panes. |
102
109
 
103
110
  Native props: `<div>`.
@@ -105,8 +112,10 @@ Native props: `<div>`.
105
112
  ## Part names
106
113
 
107
114
  - `env-scaffold`: The scaffold: the top bar, navigation and body regions; it never paints.
115
+ - `env-scaffold-aside`: The aside region at the end edge beside the body, such as an inspector, which scrolls on its own.
108
116
  - `env-scaffold-bar`: The slot of the navigation bar, at the bottom of a compact window.
109
117
  - `env-scaffold-body`: The body, the main region, which scrolls.
118
+ - `env-scaffold-bottom-bar`: The bottom bar region under the body and the aside region, such as a status bar.
110
119
  - `env-scaffold-drawer`: The slot of the navigation drawer, at the start from expanded.
111
120
  - `env-scaffold-navigation`: The navigation region, which holds a slot per form.
112
121
  - `env-scaffold-rail`: The slot of the navigation rail, at the start of a medium window.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: SegmentedControl
3
- summary: One choice among a few views or filters of the same content.
3
+ summary: Switches between a few views or filters of the same content.
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Forms & selection
@@ -28,6 +28,7 @@ components:
28
28
  examples: # Each file is examples/segmented-control/<Name>.tsx.
29
29
  WorkItems: overview
30
30
  SmallToolbar: example
31
+ IconOnlyAndBadge: example
31
32
  SegmentedControlAnatomy: anatomy
32
33
  FullWidthScope: example
33
34
  ---
@@ -40,12 +41,16 @@ examples: # Each file is examples/segmented-control/<Name>.tsx.
40
41
 
41
42
  Example: SmallToolbar.
42
43
 
44
+ ### Icon-only segments and badges
45
+
46
+ Example: IconOnlyAndBadge.
47
+
43
48
  ## Anatomy
44
49
 
45
50
  1. **Track** (`env-segmented-control`)
46
51
  2. **Thumb** (`env-segmented-control-item[data-checked]`)
47
52
  3. **Segment** (`env-segmented-control-item[data-unchecked]`)
48
- 4. **Icon** (`env-segmented-control-item[data-unchecked] > env-icon`, `icon`)
53
+ 4. **Start** (`env-segmented-control-item[data-unchecked] > env-segmented-control-item-start`, `start`)
49
54
  5. **Label** (`env-segmented-control-item-label`, `label`)
50
55
  6. **Count** (`env-segmented-control-item-count`, `count`)
51
56
 
@@ -75,7 +80,7 @@ One choice among a few items, such as views or filters of the same content: segm
75
80
  | `value` | `string` | — | The chosen item's value, for a control the application keeps; update it from onValueChange. |
76
81
  | `defaultValue` | `string` | `the first item's value` | The item an uncontrolled control starts with chosen. |
77
82
  | `onValueChange` | `(value: string) => void` | — | Receives the value of the item people choose, by pressing it or with the arrow keys. |
78
- | `aria-label` (required) | `string` | — | The group's accessible name, such as Work items; the control has no visible label. |
83
+ | `aria-label` | `string` | — | The group's accessible name, such as Work items; the control has no visible label. Without it, a List.Item whose control it is names it, or name it with aria-labelledby. |
79
84
  | `size` | `'sm' \| 'md' \| 'lg'` | — | The height, as on every control: sm, md or lg in the current scale, so it lines up with buttons and fields of the same size. Without it, it takes the control height of its container, md unless the container sets another. |
80
85
  | `fullWidth` | `boolean` | `false` | Fill the available width, split evenly between the items; a label too long for its share is cut short with an ellipsis and shows whole in a tooltip. Without it the control is as wide as its items, and scrolls in a container too narrow for them. |
81
86
  | `disabled` | `boolean` | `false` | Disable every item; the control can't be focused or changed. |
@@ -87,8 +92,9 @@ Native props: `<div>`.
87
92
  - `env-segmented-control`: The segmented control: the track the segments sit in.
88
93
  - `env-segmented-control-item`: One segment; the chosen one rises on a raised thumb.
89
94
  - `env-segmented-control-item-count`: A segment's count.
90
- - `env-segmented-control-item-icon`: The slot of a segment's icon.
95
+ - `env-segmented-control-item-end`: The slot of the content after a segment's label and count, such as a Badge.
91
96
  - `env-segmented-control-item-label`: A segment's label.
97
+ - `env-segmented-control-item-start`: The slot of the content before a segment's label, such as an icon.
92
98
  - `env-segmented-control-thumb`: The raised thumb that travels to the chosen segment, hidden until it has measured it.
93
99
  - `data-checked`: any value, or present, on `env-segmented-control-item`
94
100
  - `data-disabled`: any value, or present, on `env-segmented-control-item`
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Select
3
- summary: One choice from a list that stays collapsed until opened.
3
+ summary: A dropdown for picking one option.
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Forms & selection
@@ -31,6 +31,7 @@ components:
31
31
  examples: # Each file is examples/select/<Name>.tsx.
32
32
  ProjectVisibility: overview
33
33
  SmallToolbar: example
34
+ Assignee: example
34
35
  SelectAnatomy: anatomy
35
36
  SelectListAnatomy: anatomy
36
37
  SettingsForm: example
@@ -44,6 +45,10 @@ examples: # Each file is examples/select/<Name>.tsx.
44
45
 
45
46
  Example: SmallToolbar.
46
47
 
48
+ ### Pictures and groups
49
+
50
+ Example: Assignee.
51
+
47
52
  ## Anatomy
48
53
 
49
54
  1. **Select** (`env-select`)
@@ -82,7 +87,7 @@ One choice from a list that stays collapsed until opened: an outlined field, as
82
87
  | `ref` | `Ref<HTMLButtonElement>` | — | The trigger, the button that shows the chosen option and opens the list. |
83
88
  | `className` | `string` | — | The field's class, on its root element, beside env-field and env-select. |
84
89
  | `style` | `CSSProperties` | — | Styles of the field's root element. |
85
- | `items` (required) | `readonly SelectItem[]` | — | The options of the list, in order, each with a value, a label, an optional description and whether it is disabled. |
90
+ | `items` (required) | `readonly SelectItem[] \| readonly SelectGroup[]` | — | The options of the list, in order, each with a value, a label, an optional description, start and end content and whether it is disabled; or groups of options under headings. |
86
91
  | `value` | `string \| null` | — | The chosen option's value in a controlled select, or null for none, which shows the placeholder; update it from onValueChange. |
87
92
  | `defaultValue` | `string \| null` | — | The chosen option's value an uncontrolled select starts with; a native form reset returns to it. Without it, nothing is chosen and the trigger shows the placeholder. |
88
93
  | `onValueChange` | `(value: string \| null) => void` | — | Receives the value of the option people choose. |
@@ -107,6 +112,8 @@ Native props: `<button>`.
107
112
  - `env-select`: The select field.
108
113
  - `env-select-control`: The outlined box that holds the button and the chevron.
109
114
  - `env-select-end`: The chevron's place at the end of the well.
115
+ - `env-select-group`: A group of options.
116
+ - `env-select-group-label`: A group's heading.
110
117
  - `env-select-icon`: The chevron.
111
118
  - `env-select-item`: One option.
112
119
  - `env-select-item-indicator`: The check of the chosen option.
@@ -117,6 +124,7 @@ Native props: `<button>`.
117
124
  - `env-select-sizer`: The labels of every option, hidden, which give the field its width without a visible label.
118
125
  - `env-select-trigger`: The button that shows the value and opens the list.
119
126
  - `env-select-value`: The chosen option's label.
127
+ - `env-select-value-start`: The slot of the chosen option's start content on the trigger.
120
128
  - `data-disabled`: any value, or present, on `env-select-item`
121
129
  - `data-highlighted`: any value, or present, on `env-select-item`
122
130
  - `data-label-hidden`: any value, or present
@@ -95,7 +95,10 @@ A panel that slides in over the page from an edge of the window, for filters, de
95
95
  | `aria-label` | `string` | — | The sheet's accessible name where it has no visible title. |
96
96
  | `description` | `ReactNode` | — | Muted text under the title that describes the sheet to assistive technology too. |
97
97
  | `children` | `ReactNode` | — | The content under the heading, such as filters, details or choices. It scrolls. |
98
- | `actions` | `ReactNode` | — | Actions at the end of the content, such as Apply, with the primary action last. While the sheet is pending, the last one shows it, where it is a Button that sets no pending of its own. |
98
+ | `actions` | `ReactNode` | — | Actions at the end of the content, such as Apply, with the primary action last. While the sheet is pending, the last one shows it, where it is a Button that sets no pending of its own; another component reads it with useDialogPending. |
99
+ | `actionsStart` | `ReactNode` | — | Content at the start of the actions' row, which takes the room the actions leave, such as a Reset button or a Learn more link. |
100
+ | `headerStart` | `ReactNode` | — | Content before the title in the heading's row, such as a back button. |
101
+ | `headerEnd` | `ReactNode` | — | Content at the end of the heading's row, before the close button, such as a Menu of more actions or an Open full page button. |
99
102
  | `closeButton` | `boolean` | `true` | Whether the sheet shows its close button, an IconButton with a cross at the end of the heading. Leave it out only where the sheet holds another control that closes it. |
100
103
  | `closeLabel` | `string` | `'Close', or EnvUIProvider's messages.dialog.close` | The close button's name. |
101
104
  | `width` | `'md' \| 'lg' \| number \| (string & {})` | `'md'` | A side sheet's width: md, 24 rem, for details and filters; lg, 44 rem, for content-heavy panels such as tables and comparisons; or any CSS length, such as min(20rem, 100% - 2rem). md takes the whole width of a compact window, lg of a compact or medium one, where the page beside it would be a sliver. A number is a width in rem: with `resizable`, the width the application controls with onWidthChange, while a CSS length is ignored, and warned of while developing: the sheet starts at `defaultWidth`. A bottom sheet ignores it. |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Slider
3
- summary: A value in a known range, chosen by dragging or with the keyboard.
3
+ summary: Picks a value in a range, by dragging or with the keyboard.
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Forms & selection
@@ -29,6 +29,7 @@ examples: # Each file is examples/slider/<Name>.tsx.
29
29
  SliderAnatomy: { role: anatomy, caption: "As under the pointer, which shows the handle." }
30
30
  SaveOnRelease: example
31
31
  SessionTimeout: example
32
+ IconsAndUnits: example
32
33
  NarrowSlider: example
33
34
  ---
34
35
 
@@ -54,6 +55,10 @@ Example: SaveOnRelease.
54
55
 
55
56
  Example: SessionTimeout.
56
57
 
58
+ ### Icons and units
59
+
60
+ Example: IconsAndUnits.
61
+
57
62
  ### Adapting to width
58
63
 
59
64
  Example: NarrowSlider.
@@ -84,7 +89,7 @@ A value in a range, as a field: as tall as the fields and with their corners, so
84
89
 
85
90
  | Prop | Type | Default | Description |
86
91
  | --- | --- | --- | --- |
87
- | `label` (required) | `string` | — | The value's name, inside the slider at its start, such as Opacity. It names the slider, and ends in an ellipsis where the slider is too narrow for it. |
92
+ | `label` | `ReactNode` | — | The value's name, inside the slider at its start, such as Opacity: text, or any content, such as a volume icon beside the text. It names the slider, and ends in an ellipsis where the slider is too narrow for it. Without it, a List.Item whose control it is names the slider, or name it with aria-label or aria-labelledby. |
88
93
  | `description` | `ReactNode` | — | Lasting guidance under the slider, such as what the value applies to, linked to the slider as its description. |
89
94
  | `error` | `ReactNode` | — | A message under the slider that says how to correct the value; it joins the slider's description, after the description. |
90
95
  | `value` | `number` | — | The value of a controlled slider; update it from onValueChange. |
@@ -96,6 +101,7 @@ A value in a range, as a field: as tall as the fields and with their corners, so
96
101
  | `step` | `number` | `1` | The distance between the values the slider can take, counted from min; an arrow key moves by it. |
97
102
  | `largeStep` | `number` | `a tenth of the range in whole steps, at least one step` | The change of Page Up, Page Down and an arrow key with Shift. |
98
103
  | `formatValue` | `(value: number) => string` | — | The value as people read it at the slider's end and assistive technology announces it, such as (value) => `${value}%`. Without it, the number shows in the locale. |
104
+ | `renderValue` | `(value: number) => ReactNode` | — | What the slider's end shows for the value in place of formatValue's text, such as the number with its unit styled apart, or a swatch; formatValue, or the number in the locale, stays what assistive technology announces. |
99
105
  | `locale` | `string` | — | The locale of the shown number: EnvUIProvider's, else the browser's. |
100
106
  | `disabled` | `boolean` | `false` | Dim the slider; it can't be focused or moved, and forms leave it out. |
101
107
  | `name` | `string` | — | Submits the value with a form under this name. |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Spinner
3
- summary: Work of unknown length in a small area, such as a panel that is updating, as a turning arc.
3
+ summary: A spinning arc that shows a small area is loading.
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Feedback
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Surface
3
- summary: A container with a background, an inset and corners, but no layout of its own.
3
+ summary: A container with a background, padding and rounded corners, but no layout.
4
4
  status: beta
5
5
  since: 1.0.0
6
6
  category: App frame & layout
@@ -79,6 +79,7 @@ An on/off setting that takes effect at once: a native checkbox with the switch r
79
79
  | `style` | `CSSProperties` | — | Styles of the root element. |
80
80
  | `label` | `ReactNode` | — | The setting the switch turns on or off, such as Show completed tasks, beside the track. It names the switch, stays the same in both states, and pressing it toggles the switch too. Without it, a List.Item whose control it is names it, or name it with aria-label or aria-labelledby. |
81
81
  | `description` | `ReactNode` | — | A short, muted line under the label, such as what the option changes. It is part of the switch's label, so it is read with its name. |
82
+ | `labelPlacement` | `'end' \| 'start'` | `'end'` | Where the label sits beside the track: end, after it, or start, before it, as in an inline Dark mode switch whose label leads; the native label still names the switch. |
82
83
  | `checked` | `boolean` | — | Whether a controlled switch is on; update it from onCheckedChange. |
83
84
  | `defaultChecked` | `boolean` | `false` | Whether an uncontrolled switch starts on; a native form reset returns it to this state. |
84
85
  | `onCheckedChange` | `(checked: boolean) => void` | — | Receives the new state each time people turn the switch on or off. |
@@ -93,6 +94,7 @@ Native props: `<input>`.
93
94
  - `env-switch-input`: The native input.
94
95
  - `env-switch-label`: The label, with the description under it.
95
96
  - `env-switch-label-content`: The slot of the label.
97
+ - `data-label-placement`: `start`
96
98
 
97
99
  ## Color properties
98
100
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: TableOfContents
3
- summary: The page's sections as links, with the one the reader is in marked.
3
+ summary: Links to the page's sections, with the current one highlighted.
4
4
  status: beta
5
5
  since: 1.0.0
6
6
  category: Navigation
@@ -39,7 +39,7 @@ examples: # Each file is examples/table-of-contents/<Name>.tsx.
39
39
 
40
40
  1. **Contents** (`env-table-of-contents`)
41
41
  2. **Reader's place** (`env-table-of-contents-wave`)
42
- 3. **Link** (`env-table-of-contents-link:not([aria-current])`)
42
+ 3. **Link** (`env-table-of-contents-item:last-child > env-table-of-contents-link:not([aria-current])`)
43
43
  4. **Current section** (`env-table-of-contents-link[aria-current='location']`)
44
44
 
45
45
  ## Behaviour
@@ -68,6 +68,7 @@ The page's sections as links, nested by level, with the one the reader is in mar
68
68
  | `container` | `RefObject<HTMLElement \| null> \| string` | `The page's `main` element, or the body without one` | Where to find the headings, without `items`: an element's ref or a CSS selector. |
69
69
  | `levels` | `readonly HeadingLevel[]` | `[2, 3]` | The heading levels to list, without `items`. A heading nests under the one above it of a lower level. A heading without an id gets one from its words. |
70
70
  | `filter` | `(heading: HTMLElement) => boolean` | — | Leaves out the headings it returns false for, without `items`, such as an example's own. |
71
+ | `onNavigate` | `(id: string, event: MouseEvent<HTMLAnchorElement>) => void` | — | Called when people follow a link, with its section's id and the click, before envUI scrolls the section into view and focuses it. Each link is an `#id` link through LinkProvider's link component, so the application's router, or else the browser, changes the address. Call preventDefault to make the jump yourself, without envUI's scroll or the address change. |
71
72
  | `aria-label` | `string` | `'On this page', or EnvUIProvider's messages.tableOfContents.label` | The accessible name of the navigation landmark. |
72
73
  | `className` | `string` | — | Classes for the `nav` element. |
73
74