@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
@@ -27,8 +27,6 @@ avoidWhen:
27
27
  use: Kbd
28
28
  - text: Formatted text written in Markdown, such as notes or a description.
29
29
  use: Markdown
30
- - text: The size of a change without its lines.
31
- use: DiffStat
32
30
  components:
33
31
  - Code
34
32
  - CodeBlock
@@ -39,6 +37,7 @@ examples: # Each file is examples/code/<Name>.tsx.
39
37
  HighlightedSource: overview
40
38
  InlineCode: { role: overview, caption: "Code: a command, a value or a file name inside a sentence." }
41
39
  WrapLongLines: example
40
+ PackageManagers: example
42
41
  CodeBlockAnatomy: anatomy
43
42
  PlainOutput: example
44
43
  SettingsDiff: example
@@ -53,6 +52,10 @@ examples: # Each file is examples/code/<Name>.tsx.
53
52
 
54
53
  Example: WrapLongLines.
55
54
 
55
+ ### Actions in the heading
56
+
57
+ Example: PackageManagers.
58
+
56
59
  ## Anatomy
57
60
 
58
61
  1. **Block** (`env-code-block`)
@@ -102,7 +105,8 @@ Source, a command or output as plain text in the code theme of the app theme, su
102
105
  | Prop | Type | Default | Description |
103
106
  | --- | --- | --- | --- |
104
107
  | `children` (required) | `string` | — | The source, as one string; it is shown and copied as it is. |
105
- | `label` | `string` | — | Names the block in its heading and for assistive technology, such as a file name. |
108
+ | `label` | `ReactNode` | — | Names the block in its heading and for assistive technology, such as a file name, or content such as a file-type icon and a path link. Without one, the code takes the generic name of its language, such as Plain text code or TypeScript code, from messages.codeBlock.label. |
109
+ | `headerEnd` | `ReactNode` | — | Content at the end of the heading, before the copy button, such as Open in editor, Run, or a switch between npm, pnpm and yarn, placed as given. |
106
110
  | `copyable` | `boolean` | `false` | Shows a copy button in the heading that copies the source; false by default. |
107
111
  | `wrap` | `boolean` | `false` | Wraps long lines instead of scrolling them; false by default. |
108
112
 
@@ -116,7 +120,7 @@ Source with its syntax colored, in the code theme of the app theme, with that co
116
120
  | --- | --- | --- | --- |
117
121
  | `language` | `string` | — | The language to highlight: js, jsx, ts, tsx, java, json, html, xml, css, sql, sh, bash, yaml, md or ini, or their full names. Other values, and none, leave the source plain text. |
118
122
 
119
- Also `children`, `label`, `copyable` and `wrap`, as on CodeBlock.
123
+ Also `children`, `label`, `headerEnd`, `copyable` and `wrap`, as on CodeBlock.
120
124
 
121
125
  Native props: `<div>`.
122
126
 
@@ -132,13 +136,17 @@ The changes between two versions of a file, rendered by Diffs (diffs.com) in the
132
136
  | `language` | `string` | — | Overrides the language the file name implies, such as json. |
133
137
  | `header` | `boolean` | `true` | Shows the file header with its name and change counts; true by default. |
134
138
  | `expandUnchanged` | `boolean` | `false` | Shows the unchanged lines between changes instead of folding them; false by default. |
135
- | `layout` | `'auto' \| 'unified'` | `'auto'` | auto (default) sets old and new side by side from 56 rem of width; unified keeps one column. |
139
+ | `layout` | `'auto' \| 'split' \| 'unified'` | `'auto'` | auto (default) sets old and new side by side from 56 rem of width; split always sets them side by side, such as for a split and unified toggle; unified keeps one column. |
140
+ | `headerEnd` | `ReactNode` | — | Content at the end of the file header, such as View file, Accept or Revert, or a status Badge. |
141
+ | `annotations` | `readonly CodeDiffAnnotation[]` | — | Notes attached to lines, such as review comments, which renderAnnotation draws under them. |
142
+ | `renderAnnotation` | `(annotation: CodeDiffAnnotation) => ReactNode` | — | Draws one of annotations under its line. |
143
+ | `headingLevel` | `1 \| 2 \| 3 \| 4 \| 5 \| 6` | `3` | The level of the heading of what shows when the diff fails to load, for the page's outline. |
136
144
 
137
145
  Native props: `<div>`.
138
146
 
139
147
  ### countDiffLines
140
148
 
141
- How many lines a change adds and removes, as a DiffStat shows them.
149
+ How many lines a change adds and removes, such as for the size of a change beside its file's name.
142
150
 
143
151
  ```ts
144
152
  countDiffLines(before: string, after: string, filename?: string): { additions: number; deletions: number; }
@@ -155,6 +163,7 @@ countDiffLines(before: string, after: string, filename?: string): { additions: n
155
163
  - `env-code-block`: The block of code.
156
164
  - `env-code-block-copy-status`: The announcement that the code was copied.
157
165
  - `env-code-block-header`: The row above the code: its label, such as a file name, and the copy button.
166
+ - `env-code-block-header-end`: The slot of the content at the end of the heading, before the copy button.
158
167
  - `env-code-block-token`: One highlighted piece of the source, in its syntax color.
159
168
  - `data-wrap`: present
160
169
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: ColorPicker
3
- summary: Chooses a color, in the formats people work in.
3
+ summary: Picks a color, as hex, RGB or HSL.
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Forms & selection
@@ -39,6 +39,7 @@ examples: # Each file is examples/color-picker/<Name>.tsx.
39
39
  EveryFormat: { role: overview, caption: "With alpha, one format at a time." }
40
40
  FormatsTogether: example
41
41
  PickerButtonOpen: example
42
+ TextColorInToolbar: example
42
43
  PresetSwatches: example
43
44
  Swatches: example
44
45
  ColorPickerAnatomy: anatomy
@@ -57,6 +58,10 @@ Example: FormatsTogether.
57
58
 
58
59
  Example: PickerButtonOpen.
59
60
 
61
+ ### A trigger of your own, swatches first
62
+
63
+ Example: TextColorInToolbar.
64
+
60
65
  ### Preset swatches
61
66
 
62
67
  Example: PresetSwatches.
@@ -130,6 +135,8 @@ A compact color picker on React Aria's color hooks: a square saturation and brig
130
135
  | `eyeDropper` | `boolean` | `true` | Whether to show the eyedropper, which picks a color from the screen, where the browser has one (Chromium-based browsers on the desktop); elsewhere it never shows. |
131
136
  | `copyable` | `boolean` | `true` | Whether to show the button that copies the color, as the fields show it. |
132
137
  | `swatches` | `readonly ColorPickerSwatch[]` | — | Preset colors to choose from, under the fields: CSS color strings, React Aria's Colors, or `{ color, label }` with a name, such as the colors of a brand. |
138
+ | `swatchesFirst` | `boolean` | `false` | Show the swatches first, above the area and the fields, for a picker where presets are the usual choice, such as a tag's color. |
139
+ | `fields` | `boolean` | `true` | Whether to show the row of value fields, with the format select, the eyedropper and the copy button; without it, the area, the sliders and the swatches choose the color. |
133
140
  | `name` | `string` | — | Submits the color with a form under this name, as a string in valueFormat. |
134
141
  | `form` | `string` | — | The id of the form the color submits with, where the picker sits outside it. |
135
142
  | `disabled` | `boolean` | `false` | Whether the picker takes no input, faded. |
@@ -149,8 +156,9 @@ A compact button that shows a color as a swatch and its value, and opens a Color
149
156
  | `open` | `boolean` | — | Whether the picker is open, for a picker the application controls with onOpenChange. |
150
157
  | `defaultOpen` | `boolean` | `false` | Whether an uncontrolled picker starts open, such as in a picture of it. |
151
158
  | `onOpenChange` | `(open: boolean, details: PopoverOpenChangeDetails) => void` | — | Receives the requested state, and why, as Popover's onOpenChange does: such as to close the picker once a swatch is chosen. |
159
+ | `trigger` | `ReactElement \| ((color: { value: string }) => ReactElement)` | `a button with a swatch and the value` | The element that opens the picker in place of the swatch button, such as a text color button of a toolbar, an A over a bar of the color: an element, or a function that receives the color's value and returns one. It takes the native props given here, the opening behavior and, unless it has its own, the name after the label and the color; style it, and show the color, yourself. |
152
160
 
153
- Also `label`, `value`, `defaultValue`, `onValueChange`, `valueFormat`, `formats`, `alpha`, `eyeDropper`, `copyable`, `swatches`, `name`, `form`, `disabled` and `readOnly`, as on ColorPicker.
161
+ Also `label`, `value`, `defaultValue`, `onValueChange`, `valueFormat`, `formats`, `alpha`, `eyeDropper`, `copyable`, `swatches`, `swatchesFirst`, `fields`, `name`, `form`, `disabled` and `readOnly`, as on ColorPicker.
154
162
 
155
163
  Native props: `<button>`.
156
164
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Column
3
- summary: Lays out content one under another with even gaps.
3
+ summary: Stacks content vertically with even gaps.
4
4
  status: beta
5
5
  since: 1.0.0
6
6
  category: App frame & layout
@@ -63,7 +63,7 @@ Lays its direct children out one under another, `gap` apart, such as a form's fi
63
63
  | `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. |
64
64
  | `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. |
65
65
  | `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. |
66
- | `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. |
66
+ | `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. |
67
67
  | `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. |
68
68
  | `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. |
69
69
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Combobox
3
- summary: A text field that filters a list of options as people type, to choose one option or, as chips, several.
3
+ summary: A text field that filters options as people type, to pick one or several as chips.
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Forms & selection
@@ -115,8 +115,8 @@ A quick-open dialog near the top of the window: a search field over a list of op
115
115
  | `aria-label` (required) | `string` | — | Accessible name of the dialog, the search field and the list. |
116
116
  | `inputValue` (required) | `string` | — | The text in the search field. |
117
117
  | `onInputValueChange` (required) | `(inputValue: string) => void` | — | Receives the text as people type. |
118
- | `items` (required) | `readonly CommandPaletteItem[]` | — | Filtered and ranked by the application, in display order. |
119
- | `suggestedItems` | `readonly CommandPaletteItem[]` | — | Shown in place of items while the search field is empty, such as recent documents or suggested pages under a group heading; options like any other. |
118
+ | `items` (required) | `readonly CommandPaletteItem[] \| readonly CommandPaletteGroup[]` | — | Filtered and ranked by the application, in display order; or groups of items, each under a heading. |
119
+ | `suggestedItems` | `readonly CommandPaletteItem[] \| readonly CommandPaletteGroup[]` | — | Shown in place of items while the search field is empty, such as recent documents or suggested pages under a group heading; options like any other. |
120
120
  | `onAction` (required) | `(item: CommandPaletteItem, details: CommandPaletteActionDetails) => void` | — | Enter or a press on an option; Ctrl or Cmd sets modifier. |
121
121
  | `closeOnAction` | `boolean` | `true` | Close after an option is chosen. |
122
122
  | `placeholder` | `string` | — | Shown in the empty search field, such as "Search documents by name or folder". |
@@ -127,6 +127,8 @@ A quick-open dialog near the top of the window: a search field over a list of op
127
127
  | `emptyIcon` | `ReactNode` | — | A decorative icon above the empty state's title, such as an error icon when the search failed; none by default. |
128
128
  | `hints` | `readonly CommandPaletteHint[]` | — | Key hints below the list, such as { keys: ['Enter'], label: 'Open' }. A hint with Enter in its keys hides while there is no option to choose. |
129
129
  | `footer` | `ReactNode` | — | Other content below the list, after the hints. |
130
+ | `searchStart` | `ReactNode` | — | Content before the search field in its row, such as a scope chip, In: Projects. |
131
+ | `searchEnd` | `ReactNode` | — | Content after the search field in its row, before the close button, such as a mode switch. |
130
132
 
131
133
  Native props: `<div>`.
132
134
 
@@ -146,6 +148,8 @@ Native props: `<div>`.
146
148
  - `env-command-palette-list`: The list of commands.
147
149
  - `env-command-palette-positioner`: The palette's positioner.
148
150
  - `env-command-palette-search`: The search field, a ghost TextField around the search input.
151
+ - `env-command-palette-search-end`: The slot of the content after the search field, such as a mode switch.
152
+ - `env-command-palette-search-start`: The slot of the content before the search field, such as a scope chip.
149
153
  - `env-command-palette-status`: The EmptyState in place of the list, and the announcement of the number of results.
150
154
  - `data-empty`: present, on `env-command-palette-status`
151
155
  - `data-ending-style`: any value, or present
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Composer
3
- summary: The message field of a conversation, which grows with its text.
3
+ summary: A chat message field that grows as people type.
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Text & content
@@ -21,8 +21,6 @@ useWhen:
21
21
  avoidWhen:
22
22
  - text: Text over several lines in a form, where Enter starts a new line.
23
23
  use: Textarea
24
- - text: Formatted text with headings, lists and links.
25
- use: MarkdownEditor
26
24
  - text: The messages of the conversation itself.
27
25
  use: Message
28
26
  components:
@@ -30,6 +28,7 @@ components:
30
28
  examples: # Each file is examples/composer/<Name>.tsx.
31
29
  AskAnything: overview
32
30
  StartAndFooter: example
31
+ AttachmentsAndVoice: example
33
32
  ComposerAnatomy: anatomy
34
33
  PendingSend: example
35
34
  GrowingDraft: example
@@ -43,6 +42,10 @@ examples: # Each file is examples/composer/<Name>.tsx.
43
42
 
44
43
  Example: StartAndFooter.
45
44
 
45
+ ### Above the field and before Send
46
+
47
+ Example: AttachmentsAndVoice.
48
+
46
49
  ## Anatomy
47
50
 
48
51
  1. **Composer** (`env-composer`)
@@ -66,10 +69,11 @@ Example: GrowingDraft.
66
69
 
67
70
  ### Keyboard
68
71
 
69
- | Key | Action |
70
- | ---------------------------------------------- | ---------------------------------------------------------- |
71
- | <kbd>Enter</kbd> in the field | Sends the message, unless it is blank, pending or running. |
72
- | <kbd>Shift</kbd>+<kbd>Enter</kbd> in the field | Starts a new line. |
72
+ | Key | Action |
73
+ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- |
74
+ | <kbd>Enter</kbd> in the field | Sends the message, unless it is blank, pending or running. |
75
+ | <kbd>Shift</kbd>+<kbd>Enter</kbd> in the field | Starts a new line. |
76
+ | <kbd>Ctrl</kbd>+<kbd>Enter</kbd> or <kbd>⌘</kbd>+<kbd>Enter</kbd> in the field | In a composer that sends with a modifier, sends the message; Enter starts a new line. |
73
77
 
74
78
  ## Compose
75
79
 
@@ -83,7 +87,7 @@ import { Composer } from '@envsemble/envui';
83
87
 
84
88
  ### Composer
85
89
 
86
- The message field of a conversation: a multiline field on a raised surface that grows with its text up to maxRows, with a send button at the end that becomes a stop button while running. Enter submits, Shift+Enter starts a new line and an input method's composition never submits. Without onSend, Enter and the send button submit the field's form.
90
+ The message field of a conversation: a multiline field on a raised surface that grows with its text up to maxRows, with a send button at the end that becomes a stop button while running. Enter submits, or with sendKey mod-enter Ctrl+Enter or ⌘+Enter; Shift+Enter starts a new line and an input method's composition never submits. Without onSend, Enter and the send button submit the field's form.
87
91
 
88
92
  | Prop | Type | Default | Description |
89
93
  | --- | --- | --- | --- |
@@ -99,6 +103,9 @@ The message field of a conversation: a multiline field on a raised surface that
99
103
  | `minRows` | `number` | `1` | Lines the field shows while empty; 1 by default. |
100
104
  | `maxRows` | `number` | `8` | Lines the field grows to before it scrolls; 8 by default. |
101
105
  | `start` | `ReactNode` | — | Content at the start of the action row, such as an attach button or the name of a model. |
106
+ | `end` | `ReactNode` | — | Content in the action row just before the send button, such as a voice button, a model picker or a token count; the field then takes a row of its own above the action row. |
107
+ | `header` | `ReactNode` | — | Content inside the composer above the field, such as attachment chips, a quoted reply or context pills, placed as given. |
108
+ | `sendKey` | `'enter' \| 'mod-enter'` | `'enter'` | The key that sends: enter, where Shift+Enter starts a new line, or mod-enter, Ctrl+Enter or ⌘+Enter, where Enter starts a new line, for prompts that mostly take several lines. |
102
109
  | `description` | `ReactNode` | — | Supporting text below the composer, such as a note on attachments; it describes the field. |
103
110
  | `aria-label` | `string` | — | Required when `aria-labelledby` is not set. Names the field, which has no visible label, such as "Message"; this or aria-labelledby. |
104
111
  | `aria-labelledby` | `string` | — | Required when `aria-label` is not set. The id of visible text that names the field; this or aria-label. |
@@ -110,11 +117,15 @@ Native props: `<textarea>`.
110
117
  - `env-composer`: The message composer.
111
118
  - `env-composer-action`: The send or stop button.
112
119
  - `env-composer-description`: The slot of the supporting text below the composer.
120
+ - `env-composer-end`: The slot of the content in the action row before the send button.
113
121
  - `env-composer-footer`: The supporting text below the composer, which describes the field.
122
+ - `env-composer-header`: The slot of the content inside the composer above the input, such as attachments.
114
123
  - `env-composer-input`: The text input.
115
124
  - `env-composer-start`: The slot of the content at the start of the action row.
116
125
  - `env-composer-surface`: The surface around the input and the footer.
117
126
  - `data-disabled`: present
127
+ - `data-end`: present
128
+ - `data-header`: present
118
129
  - `data-running`: present
119
130
  - `data-start`: present
120
131
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: ConfirmDialog
3
- summary: Asks people to confirm an action whose consequence needs a sentence.
3
+ summary: A dialog that asks people to confirm an action before it runs.
4
4
  status: beta
5
5
  since: 1.0.0
6
6
  category: Overlays
@@ -74,8 +74,8 @@ Asks people to confirm an action whose consequence needs a sentence, such as del
74
74
  | `title` (required) | `ReactNode` | — | The question, which names the dialog, such as “Delete Northwind launch?”. |
75
75
  | `description` | `ReactNode` | — | What confirming does and whether it can be undone; it describes the dialog. |
76
76
  | `children` | `ReactNode` | — | More content between the heading and the actions, such as what else the action affects, or the one field a confirmation holds, such as a typed name. The dialog is a form: Enter in a field confirms as the confirm button does, through onConfirm. Hold no form here; use Dialog for one. |
77
- | `confirmLabel` (required) | `string` | — | The confirm button's label: a verb that names the consequence, such as Delete project. |
78
- | `cancelLabel` | `string` | `'Cancel', or EnvUIProvider's messages.confirmDialog.cancel` | The cancel button's label. |
77
+ | `confirmLabel` (required) | `ReactNode` | — | The confirm button's label: a verb that names the consequence, such as Delete project. Like a Button's content, it can hold more, such as a Kbd of its shortcut. |
78
+ | `cancelLabel` | `ReactNode` | `'Cancel', or EnvUIProvider's messages.confirmDialog.cancel` | The cancel button's label. |
79
79
  | `tone` | `'neutral' \| 'danger'` | `'neutral'` | danger for an action that deletes or ends something: the confirm button is a danger one and focus starts on Cancel, so a hurried Enter doesn't confirm. neutral starts focus on the confirm button. |
80
80
  | `onConfirm` (required) | `() => void \| Promise<void>` | — | Runs the action when the confirm button is pressed, or Enter is pressed in a field in the dialog. The dialog closes when it returns, or, when it returns a promise, once the promise resolves; while it runs, the confirm button is pending and nothing dismisses the dialog. It runs once per opening: further presses, such as the second click of a double-click, are ignored until it fails or the dialog opens again. A rejected promise or a thrown error keeps it open and is passed to reportError, so show what went wrong with error. |
81
81
  | `confirmDisabled` | `boolean` | `false` | Whether the confirm button is disabled, and Enter in a field doesn't confirm, such as for a confirmation that waits on a typed name. |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: DatePicker
3
- summary: A field that opens a calendar to choose a date, or a date and time, and the calendar on its own.
3
+ summary: A date field with a calendar, for a date or a date and time. The calendar also works on its own.
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Forms & selection
@@ -38,6 +38,7 @@ examples: # Each file is examples/date-picker/<Name>.tsx.
38
38
  DatePickerPopupAnatomy: anatomy
39
39
  MeetingTime: example
40
40
  WithinRange: example
41
+ PresetsAndBusyDays: example
41
42
  ---
42
43
 
43
44
  # DatePicker
@@ -78,6 +79,10 @@ Example: MeetingTime.
78
79
 
79
80
  Example: WithinRange.
80
81
 
82
+ ### Presets and marked days
83
+
84
+ Example: PresetsAndBusyDays.
85
+
81
86
  ## Accessibility
82
87
 
83
88
  ### Keyboard
@@ -117,6 +122,8 @@ A field for a date, or a date and time, that shows the value in the reader's loc
117
122
  | `granularity` | `'day' \| 'minute'` | `'day'` | What the value holds: day, a date as YYYY-MM-DD, or minute, a date and a time as YYYY-MM-DDTHH:mm, chosen in a list of times beside the calendar. |
118
123
  | `min` | `string` | — | The earliest value, as YYYY-MM-DD or YYYY-MM-DDTHH:mm; earlier days are unavailable. |
119
124
  | `max` | `string` | — | The latest value, as YYYY-MM-DD or YYYY-MM-DDTHH:mm; later days are unavailable. |
125
+ | `isDateUnavailable` | `CalendarProps['isDateUnavailable']` | — | As Calendar's: whether a day, as YYYY-MM-DD, can't be chosen, such as a booked day. |
126
+ | `renderDay` | `CalendarProps['renderDay']` | — | As Calendar's: the content of a day's mark in the calendar in place of its number. |
120
127
  | `placeholderTime` | `string` | — | The time a newly chosen day starts with, as HH:mm; 00:00 by default. |
121
128
  | `minuteStep` | `number` | `15` | With the minute granularity, the minutes between the times the list offers, from 1 to 60. A value between them still shows in the list, in its place. |
122
129
  | `locale` | `string` | — | The locale of the shown value and the calendar's names and numbers: EnvUIProvider's, else the browser's. Dates are Gregorian, also in a locale with a calendar of its own. |
@@ -130,13 +137,15 @@ A field for a date, or a date and time, that shows the value in the reader's loc
130
137
  | `clearable` | `boolean` | `false` | A clear button in the field and in the calendar removes the value. |
131
138
  | `open` | `boolean` | — | Whether the calendar is open; with `onOpenChange` it controls it. |
132
139
  | `defaultOpen` | `boolean` | `false` | Whether an uncontrolled calendar starts open; closed by default. |
133
- | `onOpenChange` | `(open: boolean, details: PickerOpenChangeDetails) => void` | — | Called with the new state, and why, when the calendar opens or closes. |
140
+ | `onOpenChange` | `(open: boolean, details: DatePickerOpenChangeDetails) => void` | — | Called with the new state, and why, when the calendar opens or closes. |
134
141
  | `clearLabel` | `string` | `'Clear', or EnvUIProvider's messages.datePicker.clear` | Accessible name of the field's clear button and text of the calendar's. |
135
142
  | `todayLabel` | `string` | `'Today', or EnvUIProvider's messages.datePicker.today` | The calendar's shortcut to today. |
136
143
  | `nowLabel` | `string` | `'Now', or EnvUIProvider's messages.datePicker.now` | With the minute granularity, the calendar's shortcut to the current date and time. |
137
144
  | `timeLabel` | `string` | `'Time', or EnvUIProvider's messages.datePicker.time` | With the minute granularity, the heading and accessible name of the list of times. |
138
145
  | `previousMonthLabel` | `string` | `'Previous month', or EnvUIProvider's messages.calendar.previousMonth` | Accessible name of the calendar's previous month button. |
139
146
  | `nextMonthLabel` | `string` | `'Next month', or EnvUIProvider's messages.calendar.nextMonth` | Accessible name of the calendar's next month button. |
147
+ | `popupHeader` | `ReactNode` | — | Content at the top of the popup, above the calendar, such as presets: buttons for Tomorrow or Next Monday that set the value, from a field the application controls. |
148
+ | `popupFooter` | `ReactNode` | — | Content in the popup's footer, after its shortcut to the current date or time and before Clear, such as a note of the time zone or another action. |
140
149
  | `label` | `ReactNode` | — | The field's visible name, above the field, such as Project name; it also names the control for assistive technology. |
141
150
  | `description` | `ReactNode` | — | Lasting guidance under the field, such as a format or a limit, linked to the control as its description. |
142
151
  | `error` | `ReactNode` | — | A message under the field that says how to correct the value. While it is set, the control is invalid (aria-invalid) and the message joins its description, after the description. |
@@ -147,7 +156,7 @@ Native props: `<button>`.
147
156
 
148
157
  ### Calendar
149
158
 
150
- A month of days to choose one from, following the WAI-ARIA date picker grid: the arrow keys move by day and week, Page Up and Page Down by month (with Shift, by year), Home and End to the week's ends, and Enter or Space chooses the day. Named with aria-label or aria-labelledby, it is a group around the month's grid.
159
+ A month of days to choose one from, following the WAI-ARIA date picker grid: the arrow keys move by day and week, Page Up and Page Down by month (with Shift, by year), Home and End to the week's ends, and Enter or Space chooses the day. Named with aria-label or aria-labelledby, or by the List.Item whose control it is, it is a group around the month's grid.
151
160
 
152
161
  | Prop | Type | Default | Description |
153
162
  | --- | --- | --- | --- |
@@ -156,6 +165,8 @@ A month of days to choose one from, following the WAI-ARIA date picker grid: the
156
165
  | `onValueChange` | `(value: string) => void` | — | Receives the chosen day as YYYY-MM-DD. |
157
166
  | `min` | `string` | — | The earliest day that can be chosen, as YYYY-MM-DD; earlier days are unavailable. |
158
167
  | `max` | `string` | — | The latest day that can be chosen, as YYYY-MM-DD; later days are unavailable. |
168
+ | `isDateUnavailable` | `(day: string) => boolean` | — | Whether a day, as YYYY-MM-DD, can't be chosen, such as a weekend, a holiday or a booked day; it shows dimmed and reports aria-disabled, as days outside min and max do, and the keyboard still moves onto it. |
169
+ | `renderDay` | `(day: string, state: CalendarDayState) => ReactNode` | `the day's number` | The content of a day's mark in place of its number, such as the number with a dot under it for a day with events, or a price; it receives the day as YYYY-MM-DD and its state. The cell keeps its role, its name, the full date, and its keyboard handling. |
159
170
  | `weekStart` | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6` | `the locale's, or Monday where the browser cannot tell` | The first day of each week, from 0 for Sunday to 6 for Saturday. |
160
171
  | `locale` | `string` | — | The locale of the month and weekday names and the day numbers: EnvUIProvider's, else the browser's. The days are always Gregorian, also in a locale with a calendar of its own. |
161
172
  | `previousMonthLabel` | `string` | `'Previous month', or EnvUIProvider's messages.calendar.previousMonth` | Accessible name of the previous month button. |
@@ -190,6 +201,7 @@ Native props: `<div>`.
190
201
 
191
202
  - `env-calendar`: The calendar of one month.
192
203
  - `env-calendar-day`: One day.
204
+ - `env-calendar-day-content`: The slot of a day's content from renderDay, in its mark.
193
205
  - `env-calendar-day-mark`: The mark under a day, such as today's.
194
206
  - `env-calendar-grid`: The grid of days.
195
207
  - `env-calendar-header`: The row with the month and the previous and next buttons.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: DescriptionList
3
- summary: The facts about one thing, as labels and their values.
3
+ summary: Labels and their values, describing one thing.
4
4
  status: beta
5
5
  since: 1.0.0
6
6
  category: Data display
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Dialog
3
- summary: A focused task over the page.
3
+ summary: A window over the page for one focused task.
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Overlays
@@ -22,6 +22,7 @@ avoidWhen:
22
22
  components:
23
23
  - Dialog
24
24
  - DialogClose
25
+ - useDialogPending
25
26
  examples: # Each file is examples/dialog/<Name>.tsx.
26
27
  ProjectDetails: overview
27
28
  FindPlan: example
@@ -29,6 +30,7 @@ examples: # Each file is examples/dialog/<Name>.tsx.
29
30
  DialogAnatomy: anatomy
30
31
  RenameProject: example
31
32
  UnsavedChanges: example
33
+ EditMember: example
32
34
  ---
33
35
 
34
36
  # Dialog
@@ -62,12 +64,20 @@ Example: RenameProject.
62
64
 
63
65
  Example: UnsavedChanges.
64
66
 
67
+ ### Actions at the start
68
+
69
+ Example: EditMember.
70
+
65
71
  ## Compose
66
72
 
67
73
  ### Import
68
74
 
69
75
  ```tsx
70
- import { Dialog, DialogClose } from '@envsemble/envui';
76
+ import {
77
+ Dialog,
78
+ DialogClose,
79
+ useDialogPending,
80
+ } from '@envsemble/envui';
71
81
  ```
72
82
 
73
83
  ## Props
@@ -82,11 +92,16 @@ A focused task over the page: a centered modal, or a modal near the top of the w
82
92
  | `defaultOpen` | `boolean` | `false` | Whether a dialog the application doesn't control is open on the first render. |
83
93
  | `onOpenChange` | `(open: boolean, details: DialogOpenChangeDetails) => void` | — | Called with the requested state, and why, when the dialog asks to open or close: from the trigger, Escape, an outside press, the close button or a DialogClose. Not called for a dismissal that pending blocks. |
84
94
  | `trigger` | `ReactElement` | — | The element that opens the dialog, such as a Button. It reports the dialog it opens, and focus returns to it on close. Omit it for a dialog the application opens with open. |
85
- | `title` (required) | `ReactNode` | — | The dialog's heading and accessible name, such as “Delete project?”. |
95
+ | `title` | `ReactNode` | — | The dialog's heading and accessible name, such as “Delete project?”. Without one, such as for an image viewer or a search dialog its field names, name the dialog with aria-label or aria-labelledby. |
86
96
  | `description` | `ReactNode` | — | Muted text under the title that describes the dialog to assistive technology too, such as what its action changes. |
87
97
  | `children` | `ReactNode` | — | The content between the heading and the actions, such as text, fields or a list. |
88
- | `actions` | `ReactNode` | — | The dialog's own actions, after the built-in close button, with the primary action last. They close the dialog only where they are DialogClose or set open to false. While the dialog is pending, the last one shows it, where it is a Button that sets no pending of its own. |
89
- | `closeLabel` | `string` | `'Close', or EnvUIProvider's messages.dialog.close` | The label of the built-in close button that starts the actions, such as Cancel. |
98
+ | `actions` | `ReactNode` | — | The dialog's own actions, after the built-in close button, with the primary action last. They close the dialog only where they are DialogClose or set open to false. While the dialog 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 destructive Delete, a Learn more link or a Don't show again checkbox. |
100
+ | `closeButton` | `boolean` | `true` | Whether the dialog shows its built-in close button, as on a Sheet. Leave it out only where the dialog places its own DialogClose. |
101
+ | `closeButtonPlacement` | `'actions' \| 'heading'` | `'actions'` | Where the built-in close button is: actions, a secondary button that starts the actions; heading, an IconButton with a cross at the end of the heading, as on a Sheet. |
102
+ | `closeLabel` | `string` | `'Close', or EnvUIProvider's messages.dialog.close` | The label of the built-in close button, such as Cancel, or its name in the heading. |
103
+ | `headerStart` | `ReactNode` | — | Content before the title in the heading's row, such as a back button. |
104
+ | `headerEnd` | `ReactNode` | — | Content at the end of the heading's row, before a close button there, such as a Menu of more actions or an Open full page button. |
90
105
  | `placement` | `'center' \| 'top'` | `'center'` | center for a modal in the middle of the window; top for a modal near the top of the window for search-like tasks, so results grow downward without moving the field. For a panel at an edge of the window, use Sheet. |
91
106
  | `width` | `'md' \| 'lg'` | `'md'` | md, 28 rem wide, or lg, 44 rem, for content-heavy dialogs such as tables, comparisons and longer forms. Both narrow to fit the window. |
92
107
  | `modal` | `boolean` | `true` | true traps focus in the dialog over a backdrop, hides the page from assistive technology, blocks presses on it and locks its scroll. false leaves the page usable beside the dialog; it then closes when focus or a press goes outside it, unless disablePointerDismissal. |
@@ -109,21 +124,32 @@ A button inside a Dialog or a Sheet that closes it after its own onClick, for an
109
124
  | `underline` | `boolean` | `false` | Show an underline for the text variant. |
110
125
  | `size` | `'sm' \| 'md' \| 'lg'` | — | The control height, sm, md or lg; without it, the container's, and else md. |
111
126
  | `fullWidth` | `boolean` | `false` | Fill the width of the container, such as the actions of a narrow form stacked in a column. |
112
- | `startIcon` | `ReactNode` | — | A decorative icon before the label, such as IconAdd. |
113
- | `endIcon` | `ReactNode` | — | A decorative icon after the label, such as a ChevronRight for a next step. |
114
- | `end` | `ReactNode` | — | Quiet content at the far end, such as a shortcut's Kbd, with aria-hidden on its keys and aria-keyshortcuts on the button. |
127
+ | `start` | `ReactNode` | — | Content before the label, such as IconAdd, or a small Avatar of the person a button assigns: an envUI icon takes the button's icon size and other content keeps its own. It is hidden from assistive technology, since the label names the button. |
128
+ | `end` | `ReactNode` | — | Content after the label, at the far end of a full-width button, such as IconChevronRight for a next step, or a shortcut's Kbd, with aria-hidden on its keys and aria-keyshortcuts on the button: an envUI icon takes the button's icon size and other content keeps its own. |
115
129
  | `pending` | `boolean` | `false` | Its work is running: a spinner turns over it, it keeps its width and name, and presses do nothing. |
130
+ | `render` | `ReactElement` | — | Another element to render the button as, such as a label for a file input, or a router's own link in one place: the button's class, look, state attributes, content and handlers merge into its props. It takes no type or disabled attribute; disabled reports aria-disabled and blocks presses. |
116
131
 
117
132
  Native props: `<button>`.
118
133
 
134
+ ### useDialogPending
135
+
136
+ Whether the Dialog or Sheet around it is pending, for an action component of the application's own, such as a Button wrapped for analytics, to show the work its press started.
137
+
138
+ ```ts
139
+ useDialogPending(): boolean
140
+ ```
141
+
119
142
  ## Part names
120
143
 
121
144
  - `env-dialog`: The dialog.
122
145
  - `env-dialog-actions`: The row of actions at the bottom.
146
+ - `env-dialog-actions-start`: The slot of the content at the start of the actions' row.
123
147
  - `env-dialog-backdrop`: The backdrop behind a modal dialog.
124
148
  - `env-dialog-content`: The dialog's content between the header and the actions.
125
149
  - `env-dialog-description`: The sentence under the title.
126
150
  - `env-dialog-header`: The row with the title and the close button.
151
+ - `env-dialog-header-end`: The slot of the content at the end of the title's row, before a close button.
152
+ - `env-dialog-header-start`: The slot of the content before the title.
127
153
  - `env-dialog-heading`: The column with the title and the description.
128
154
  - `env-dialog-positioner`: The positioner that centres the dialog.
129
155
  - `env-dialog-surface`: The dialog's surface.
@@ -71,6 +71,8 @@ A summary that shows and hides the details below it, on the native details eleme
71
71
  | `open` | `boolean` | — | Whether the details show, for a controlled disclosure: update it from onOpenChange. Use defaultOpen instead to leave it to the disclosure. |
72
72
  | `defaultOpen` | `boolean` | `false` | Whether the details show at first, for a disclosure that keeps its own state. |
73
73
  | `onOpenChange` | `(open: boolean) => void` | — | Receives whether the details show, each time the disclosure opens or closes. |
74
+ | `indicatorPlacement` | `'start' \| 'end'` | `'start'` | Where the chevron sits in the summary: before its words, or after them, as in a Show more link. |
75
+ | `panelLayout` | `'stack' \| 'flow'` | `'stack'` | stack lays the details out one under another, a small gap apart; flow places them as given, so they keep their own spacing and flow, such as inline text. |
74
76
 
75
77
  Native props: `<details>`.
76
78
 
@@ -80,3 +82,5 @@ Native props: `<details>`.
80
82
  - `env-disclosure-indicator`: The chevron before the summary's words, turned down while open.
81
83
  - `env-disclosure-panel`: The panel it shows.
82
84
  - `env-disclosure-title`: The slot of the summary's words.
85
+ - `data-indicator`: `end`
86
+ - `data-layout`: `flow`, on `env-disclosure-panel`
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: DocumentTabs
3
- summary: Editor-style tabs for the documents people have open.
3
+ summary: Tabs for open documents, as in a code editor.
4
4
  status: stable
5
5
  since: 1.0.0
6
6
  category: Navigation
@@ -27,17 +27,24 @@ components:
27
27
  examples: # Each file is examples/document-tabs/<Name>.tsx.
28
28
  OpenDocuments: overview
29
29
  DocumentTabsAnatomy: anatomy
30
+ EditorTabs: example
30
31
  ManyTabs: example
31
32
  ---
32
33
 
33
34
  # DocumentTabs
34
35
 
36
+ ## Variants
37
+
38
+ ### Tabs of an editor
39
+
40
+ Example: EditorTabs.
41
+
35
42
  ## Anatomy
36
43
 
37
44
  1. **Tabs** (`env-document-tabs-list`)
38
45
  2. **Item** (`env-document-tabs-item`)
39
46
  3. **Tab** (`env-document-tabs-tab`)
40
- 4. **Icon** (`env-document-tabs-tab > env-icon`, `icon`)
47
+ 4. **Start** (`env-document-tabs-tab-start`, `start`)
41
48
  5. **Label** (`env-document-tabs-tab-label`, `label`)
42
49
  6. **Close button** (`env-document-tabs-close`)
43
50
  7. **End** (`env-document-tabs-end`, `end`)
@@ -53,12 +60,12 @@ Example: ManyTabs.
53
60
 
54
61
  ### Keyboard
55
62
 
56
- | Key | Action |
57
- | -------------------------------------------------- | --------------------------------------------------------------------------------------- |
58
- | <kbd>←</kbd>, <kbd>→</kbd> | Moves to the previous or next tab and activates it, wrapping, in the reading direction. |
59
- | <kbd>Home</kbd>, <kbd>End</kbd> | Moves to the first or last tab and activates it. |
60
- | <kbd>Delete</kbd> or <kbd>Backspace</kbd> | Closes the focused tab; focus moves to the tab that becomes active. |
61
- | <kbd>Shift</kbd>+<kbd>F10</kbd> or <kbd>Menu</kbd> | Opens the context menu for the focused tab. |
63
+ | Key | Action |
64
+ | -------------------------------------------------- | -------------------------------------------------------------------------------------------- |
65
+ | <kbd>←</kbd>, <kbd>→</kbd> | Moves to the previous or next tab and activates it, wrapping, in the reading direction. |
66
+ | <kbd>Home</kbd>, <kbd>End</kbd> | Moves to the first or last tab and activates it. |
67
+ | <kbd>Delete</kbd> or <kbd>Backspace</kbd> | Closes the focused tab unless it isn't closable; focus moves to the tab that becomes active. |
68
+ | <kbd>Shift</kbd>+<kbd>F10</kbd> or <kbd>Menu</kbd> | Opens the context menu for the focused tab. |
62
69
 
63
70
  ## Compose
64
71
 
@@ -80,16 +87,17 @@ Editor-style closable tabs for open documents, with the active document in a pan
80
87
  | `items` (required) | `readonly DocumentTabsItem[]` | — | The open documents, in tab order. |
81
88
  | `value` (required) | `string \| null` | — | The active tab, or null. |
82
89
  | `onValueChange` (required) | `(value: string) => void` | — | Called with the tab's value when it is clicked or reached with the arrow keys, Home or End. |
83
- | `onClose` (required) | `(id: string) => void` | — | Called from a tab's close button, a middle click, Delete or Backspace on the focused tab, and Close in the tab's context menu. |
84
- | `onPin` | `(id: string) => void` | — | Called when a tab is double-clicked, typically to keep a preview tab open. |
85
- | `onReorder` | `(ids: string[]) => void` | — | Called with every tab's value in the new order when a tab is dragged to another place with a mouse or pen, or moved with Move left or Move right in its context menu, which also reach the keyboard and touch. Without it, the tabs keep their order. |
90
+ | `onClose` (required) | `(value: string) => void` | — | Called from a tab's close button, a middle click, Delete or Backspace on the focused tab, and Close in the tab's context menu. |
91
+ | `onPin` | `(value: string) => void` | — | Called when a tab is double-clicked, typically to keep a preview tab open. |
92
+ | `onReorder` | `(values: string[]) => void` | — | Called with every tab's value in the new order when a tab is dragged to another place with a mouse or pen, or moved with Move left or Move right in its context menu, which also reach the keyboard and touch. Without it, the tabs keep their order. |
86
93
  | `end` | `ReactNode` | — | Content after the tabs, outside the strip that scrolls and in line with it, such as a button that closes every tab or opens a new one. |
87
94
  | `aria-label` (required) | `string` | — | Accessible name of the tab strip. |
88
95
  | `panelId` | `string` | — | Id of the panel the active tab controls: the one DocumentTabs renders around children, or the one the application renders itself. |
89
- | `closeLabel` | `(label: string) => string` | `'Close {label}', or EnvUIProvider's messages.documentTabs.close` | The name of the context menu's item that closes a tab, and the tooltip of its close button. |
96
+ | `closeLabel` | `(label: string) => string` | `'Close {label}', or EnvUIProvider's messages.documentTabs.close` | The name of the context menu's item that closes a tab, and the tooltip of its close button, from the tab's text value. |
90
97
  | `onCloseAll` | `() => void` | — | Called from Close all tabs in the context menu. Each tab opens a context menu that closes it on right click, long press, the Menu key and Shift+F10; with onCloseAll, the menu also offers Close all tabs, and the strip around the tabs opens it too. |
91
98
  | `closeAllLabel` | `string` | `'Close all tabs', or EnvUIProvider's messages.documentTabs.closeAll` | Label of the Close all tabs item. |
92
99
  | `contextMenuLabel` | `string` | `'Tab actions', or EnvUIProvider's messages.documentTabs.contextMenu` | Accessible name of the context menu. |
100
+ | `contextMenu` | `(tab: DocumentTabsItem \| null) => ReactNode` | — | The application's own items for the context menu of the tab people open it on, or of the strip around the tabs when the tab is null, such as Close others or Copy path. They come after the built-in items, past a separator. |
93
101
 
94
102
  Native props: `<div>`.
95
103
 
@@ -105,14 +113,16 @@ Native props: `<div>`.
105
113
  - `env-document-tabs-panel-content`: The slot of the active document.
106
114
  - `env-document-tabs-strip`: The bar that holds the tabs and the actions at their end.
107
115
  - `env-document-tabs-tab`: A tab's button.
116
+ - `env-document-tabs-tab-end`: The slot after a tab's title, such as a dot for unsaved changes.
108
117
  - `env-document-tabs-tab-label`: A tab's title.
118
+ - `env-document-tabs-tab-start`: The slot before a tab's title, such as a file type's icon.
109
119
  - `data-active`: present, on `env-document-tabs-item`
110
120
  - `data-drop`: `after`, `before`, on `env-document-tabs-item`
111
121
  - `data-first-active`: present
112
122
  - `data-moving`: `pointer`, on `env-document-tabs-item`
113
123
  - `data-preview`: present, on `env-document-tabs-tab`
114
124
  - `data-reordering`: present, on `env-document-tabs-list`
115
- - `data-tab-id`: any value, or present, on `env-document-tabs-tab`
125
+ - `data-value`: any value, or present, on `env-document-tabs-tab`
116
126
 
117
127
  ## Strings
118
128