@envsemble/envui 2.0.0 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1263) hide show
  1. package/CHANGELOG.md +258 -0
  2. package/README.md +14 -27
  3. package/dist/actions/Button.d.ts +25 -8
  4. package/dist/actions/Button.js.map +2 -2
  5. package/dist/actions/CommandPalette.d.ts +37 -9
  6. package/dist/actions/CommandPalette.js +111 -107
  7. package/dist/actions/CommandPalette.js.map +2 -2
  8. package/dist/actions/ConfirmButton.d.ts +1 -1
  9. package/dist/actions/ConfirmButton.js +2 -4
  10. package/dist/actions/ConfirmButton.js.map +2 -2
  11. package/dist/actions/ContextMenu.d.ts +1 -1
  12. package/dist/actions/ContextMenu.js +5 -6
  13. package/dist/actions/ContextMenu.js.map +2 -2
  14. package/dist/actions/CopyButton.js +2 -2
  15. package/dist/actions/CopyButton.js.map +2 -2
  16. package/dist/actions/Menubar.d.ts +12 -5
  17. package/dist/actions/Menubar.js +37 -29
  18. package/dist/actions/Menubar.js.map +3 -3
  19. package/dist/actions/Toolbar.d.ts +42 -2
  20. package/dist/actions/Toolbar.js +18 -0
  21. package/dist/actions/Toolbar.js.map +2 -2
  22. package/dist/actions/internal/ButtonBase.d.ts +3 -2
  23. package/dist/actions/internal/ButtonBase.js +2 -4
  24. package/dist/actions/internal/ButtonBase.js.map +2 -2
  25. package/dist/actions/internal/CommandPaletteOptions.d.ts +7 -6
  26. package/dist/actions/internal/CommandPaletteOptions.js +24 -15
  27. package/dist/actions/internal/CommandPaletteOptions.js.map +2 -2
  28. package/dist/actions/internal/CommandPaletteStatus.js +23 -9
  29. package/dist/actions/internal/CommandPaletteStatus.js.map +2 -2
  30. package/dist/actions/menu/Menu.d.ts +5 -4
  31. package/dist/actions/menu/Menu.js +3 -6
  32. package/dist/actions/menu/Menu.js.map +2 -2
  33. package/dist/actions/menu/MenuChoices.d.ts +9 -7
  34. package/dist/actions/menu/MenuChoices.js +34 -6
  35. package/dist/actions/menu/MenuChoices.js.map +2 -2
  36. package/dist/actions/menu/MenuItem.d.ts +37 -8
  37. package/dist/actions/menu/MenuItem.js +47 -12
  38. package/dist/actions/menu/MenuItem.js.map +2 -2
  39. package/dist/actions/menu/MenuSubmenu.d.ts +9 -3
  40. package/dist/actions/menu/MenuSubmenu.js +26 -24
  41. package/dist/actions/menu/MenuSubmenu.js.map +2 -2
  42. package/dist/actions/{internal → menu/internal}/MenuPopup.d.ts +2 -3
  43. package/dist/actions/{internal → menu/internal}/MenuPopup.js +7 -12
  44. package/dist/actions/menu/internal/MenuPopup.js.map +7 -0
  45. package/dist/actions/{internal → menu/internal}/menuOpenChange.d.ts +1 -1
  46. package/dist/actions/menu/internal/menuTriggerProps.d.ts +11 -0
  47. package/dist/actions/menu/internal/menuTriggerProps.js +1 -0
  48. package/dist/assets/readme/overview-dark.png +0 -0
  49. package/dist/assets/readme/overview-light.png +0 -0
  50. package/dist/content/Accordion.d.ts +32 -2
  51. package/dist/content/Accordion.js +41 -12
  52. package/dist/content/Accordion.js.map +2 -2
  53. package/dist/content/CodeBlock.d.ts +13 -4
  54. package/dist/content/CodeBlock.js +2 -0
  55. package/dist/content/CodeBlock.js.map +2 -2
  56. package/dist/content/CodeDiff.d.ts +34 -4
  57. package/dist/content/CodeDiff.js +41 -24
  58. package/dist/content/CodeDiff.js.map +2 -2
  59. package/dist/content/Composer.d.ts +19 -2
  60. package/dist/content/Composer.js +19 -12
  61. package/dist/content/Composer.js.map +2 -2
  62. package/dist/content/Disclosure.d.ts +13 -1
  63. package/dist/content/Disclosure.js +9 -3
  64. package/dist/content/Disclosure.js.map +2 -2
  65. package/dist/content/HighlightedCodeBlock.d.ts +1 -1
  66. package/dist/content/HighlightedCodeBlock.js +2 -0
  67. package/dist/content/HighlightedCodeBlock.js.map +2 -2
  68. package/dist/content/Kbd.d.ts +12 -5
  69. package/dist/content/Kbd.js +2 -2
  70. package/dist/content/Kbd.js.map +2 -2
  71. package/dist/content/Markdown.d.ts +17 -1
  72. package/dist/content/Markdown.js +26 -4
  73. package/dist/content/Markdown.js.map +2 -2
  74. package/dist/content/Message.d.ts +29 -33
  75. package/dist/content/Message.js +21 -21
  76. package/dist/content/Message.js.map +2 -2
  77. package/dist/content/countDiffLines.d.ts +1 -1
  78. package/dist/content/countDiffLines.js.map +1 -1
  79. package/dist/content/internal/CodeBlockFrame.d.ts +3 -2
  80. package/dist/content/internal/CodeBlockFrame.js +25 -13
  81. package/dist/content/internal/CodeBlockFrame.js.map +2 -2
  82. package/dist/content/internal/MessageListFollow.js +1 -1
  83. package/dist/content/internal/MessageListFollow.js.map +2 -2
  84. package/dist/content/internal/MessageStatusLabel.d.ts +2 -1
  85. package/dist/content/internal/MessageStatusLabel.js.map +2 -2
  86. package/dist/content/internal/codeColors.js +2 -2
  87. package/dist/content/internal/codeColors.js.map +2 -2
  88. package/dist/content/internal/useCodeContrast.js +4 -3
  89. package/dist/content/internal/useCodeContrast.js.map +2 -2
  90. package/dist/data-display/Avatar.d.ts +13 -4
  91. package/dist/data-display/Avatar.js +8 -4
  92. package/dist/data-display/Avatar.js.map +2 -2
  93. package/dist/data-display/AvatarButton.d.ts +20 -5
  94. package/dist/data-display/AvatarButton.js +17 -2
  95. package/dist/data-display/AvatarButton.js.map +2 -2
  96. package/dist/data-display/AvatarGroup.d.ts +28 -12
  97. package/dist/data-display/AvatarGroup.js +21 -32
  98. package/dist/data-display/AvatarGroup.js.map +2 -2
  99. package/dist/data-display/Badge.d.ts +11 -8
  100. package/dist/data-display/Badge.js +4 -3
  101. package/dist/data-display/Badge.js.map +2 -2
  102. package/dist/data-display/List.d.ts +21 -9
  103. package/dist/data-display/List.js +1 -1
  104. package/dist/data-display/List.js.map +2 -2
  105. package/dist/data-display/Meter.d.ts +7 -1
  106. package/dist/data-display/Meter.js +11 -5
  107. package/dist/data-display/Meter.js.map +2 -2
  108. package/dist/data-display/RelativeTime.d.ts +8 -2
  109. package/dist/data-display/RelativeTime.js +18 -7
  110. package/dist/data-display/RelativeTime.js.map +2 -2
  111. package/dist/data-display/Table.d.ts +26 -7
  112. package/dist/data-display/Table.js +70 -65
  113. package/dist/data-display/Table.js.map +2 -2
  114. package/dist/data-display/formatRelativeTime.d.ts +0 -2
  115. package/dist/data-display/formatRelativeTime.js +4 -28
  116. package/dist/data-display/formatRelativeTime.js.map +2 -2
  117. package/dist/data-display/internal/ListNaming.js +1 -1
  118. package/dist/data-display/internal/ListNaming.js.map +1 -1
  119. package/dist/data-display/internal/ReorderableList.d.ts +3 -2
  120. package/dist/data-display/internal/ReorderableList.js +11 -16
  121. package/dist/data-display/internal/ReorderableList.js.map +2 -2
  122. package/dist/data-display/internal/avatarName.d.ts +2 -0
  123. package/dist/data-display/internal/avatarName.js +7 -0
  124. package/dist/data-display/internal/avatarName.js.map +7 -0
  125. package/dist/data-display/internal/{ListRows.d.ts → listMarkup.d.ts} +1 -1
  126. package/dist/data-display/internal/{ListRows.js → listMarkup.js} +29 -15
  127. package/dist/data-display/internal/listMarkup.js.map +7 -0
  128. package/dist/data-display/internal/relativeTimeFormat.d.ts +3 -0
  129. package/dist/data-display/internal/relativeTimeFormat.js +12 -0
  130. package/dist/data-display/internal/relativeTimeFormat.js.map +7 -0
  131. package/dist/data-display/internal/reorderController.js +3 -3
  132. package/dist/data-display/internal/reorderController.js.map +2 -2
  133. package/dist/data-display/internal/reorderGeometry.d.ts +0 -1
  134. package/dist/data-display/internal/reorderGeometry.js +1 -10
  135. package/dist/data-display/internal/reorderGeometry.js.map +2 -2
  136. package/dist/data-display/internal/tableColumns.js +8 -9
  137. package/dist/data-display/internal/tableColumns.js.map +2 -2
  138. package/dist/{internal/react/useStackedReport.d.ts → data-display/internal/tableStacking.d.ts} +2 -0
  139. package/dist/data-display/internal/tableStacking.js +49 -0
  140. package/dist/data-display/internal/tableStacking.js.map +7 -0
  141. package/dist/data-display/internal/useReorder.js +1 -1
  142. package/dist/data-display/internal/useReorder.js.map +1 -1
  143. package/dist/diff.d.ts +1 -1
  144. package/dist/diff.js +1 -4
  145. package/dist/diff.js.map +2 -2
  146. package/dist/feedback/Alert.d.ts +13 -3
  147. package/dist/feedback/Alert.js +16 -6
  148. package/dist/feedback/Alert.js.map +2 -2
  149. package/dist/feedback/EmptyState.d.ts +12 -3
  150. package/dist/feedback/EmptyState.js +6 -6
  151. package/dist/feedback/EmptyState.js.map +2 -2
  152. package/dist/feedback/Halo.d.ts +27 -0
  153. package/dist/feedback/Halo.js +21 -0
  154. package/dist/feedback/Halo.js.map +7 -0
  155. package/dist/feedback/Progress.js +3 -2
  156. package/dist/feedback/Progress.js.map +2 -2
  157. package/dist/feedback/toast/ToastProvider.js +1 -1
  158. package/dist/feedback/toast/ToastProvider.js.map +1 -1
  159. package/dist/feedback/toast/internal/ContainedToast.d.ts +12 -0
  160. package/dist/feedback/toast/internal/ContainedToast.js +43 -0
  161. package/dist/feedback/toast/internal/ContainedToast.js.map +7 -0
  162. package/dist/feedback/toast/internal/{PictureNotice.d.ts → ContainedToastRoot.d.ts} +1 -1
  163. package/dist/feedback/toast/internal/{PictureNotice.js → ContainedToastRoot.js} +3 -3
  164. package/dist/feedback/toast/internal/ContainedToastRoot.js.map +7 -0
  165. package/dist/feedback/toast/internal/LiveToast.d.ts +10 -0
  166. package/dist/feedback/toast/internal/LiveToast.js +78 -0
  167. package/dist/feedback/toast/internal/LiveToast.js.map +7 -0
  168. package/dist/feedback/toast/internal/ToastBody.d.ts +2 -1
  169. package/dist/feedback/toast/internal/ToastBody.js +6 -2
  170. package/dist/feedback/toast/internal/ToastBody.js.map +2 -2
  171. package/dist/feedback/toast/internal/ToastButtons.d.ts +14 -0
  172. package/dist/feedback/toast/internal/ToastButtons.js +77 -0
  173. package/dist/feedback/toast/internal/ToastButtons.js.map +7 -0
  174. package/dist/feedback/toast/internal/ToastManagerContext.d.ts +3 -0
  175. package/dist/feedback/toast/internal/ToastManagerContext.js +7 -0
  176. package/dist/feedback/toast/internal/ToastManagerContext.js.map +7 -0
  177. package/dist/feedback/toast/internal/ToastRegion.js +43 -172
  178. package/dist/feedback/toast/internal/ToastRegion.js.map +2 -2
  179. package/dist/feedback/toast/internal/toastEntry.d.ts +9 -2
  180. package/dist/feedback/toast/internal/toastEntry.js +10 -1
  181. package/dist/feedback/toast/internal/toastEntry.js.map +2 -2
  182. package/dist/feedback/toast/internal/useToastController.d.ts +3 -3
  183. package/dist/feedback/toast/internal/useToastController.js +4 -2
  184. package/dist/feedback/toast/internal/useToastController.js.map +2 -2
  185. package/dist/feedback/toast/internal/useToastGlide.js +2 -1
  186. package/dist/feedback/toast/internal/useToastGlide.js.map +2 -2
  187. package/dist/feedback/toast/toastTypes.d.ts +38 -11
  188. package/dist/feedback/toast/useToast.d.ts +0 -2
  189. package/dist/feedback/toast/useToast.js +2 -3
  190. package/dist/feedback/toast/useToast.js.map +2 -2
  191. package/dist/forms/Calendar.d.ts +30 -11
  192. package/dist/forms/Calendar.js +19 -13
  193. package/dist/forms/Calendar.js.map +2 -2
  194. package/dist/forms/Checkbox.d.ts +7 -1
  195. package/dist/forms/Checkbox.js +33 -27
  196. package/dist/forms/Checkbox.js.map +2 -2
  197. package/dist/forms/Combobox.d.ts +4 -4
  198. package/dist/forms/Combobox.js +26 -146
  199. package/dist/forms/Combobox.js.map +2 -2
  200. package/dist/forms/DatePicker.d.ts +38 -11
  201. package/dist/forms/DatePicker.js +32 -52
  202. package/dist/forms/DatePicker.js.map +2 -2
  203. package/dist/forms/DropZone.d.ts +23 -4
  204. package/dist/forms/DropZone.js +29 -11
  205. package/dist/forms/DropZone.js.map +2 -2
  206. package/dist/forms/Field.d.ts +7 -1
  207. package/dist/forms/Field.js +13 -6
  208. package/dist/forms/Field.js.map +2 -2
  209. package/dist/forms/MonthPicker.d.ts +8 -1
  210. package/dist/forms/MonthPicker.js +22 -42
  211. package/dist/forms/MonthPicker.js.map +2 -2
  212. package/dist/forms/Radio.d.ts +15 -5
  213. package/dist/forms/Radio.js +20 -18
  214. package/dist/forms/Radio.js.map +2 -2
  215. package/dist/forms/SearchField.d.ts +13 -5
  216. package/dist/forms/SearchField.js +26 -21
  217. package/dist/forms/SearchField.js.map +2 -2
  218. package/dist/forms/SegmentedControl.d.ts +37 -8
  219. package/dist/forms/SegmentedControl.js +31 -25
  220. package/dist/forms/SegmentedControl.js.map +2 -2
  221. package/dist/forms/Select.d.ts +31 -6
  222. package/dist/forms/Select.js +43 -24
  223. package/dist/forms/Select.js.map +2 -2
  224. package/dist/forms/Slider.d.ts +12 -4
  225. package/dist/forms/Slider.js +32 -21
  226. package/dist/forms/Slider.js.map +2 -2
  227. package/dist/forms/Switch.d.ts +7 -1
  228. package/dist/forms/Switch.js +31 -25
  229. package/dist/forms/Switch.js.map +2 -2
  230. package/dist/forms/TextField.d.ts +5 -5
  231. package/dist/forms/TextField.js +20 -11
  232. package/dist/forms/TextField.js.map +2 -2
  233. package/dist/forms/Textarea.d.ts +1 -1
  234. package/dist/forms/Textarea.js +12 -2
  235. package/dist/forms/Textarea.js.map +2 -2
  236. package/dist/forms/TimePicker.d.ts +8 -1
  237. package/dist/forms/TimePicker.js +20 -45
  238. package/dist/forms/TimePicker.js.map +2 -2
  239. package/dist/forms/color/ColorPicker.d.ts +1 -1
  240. package/dist/forms/color/ColorPicker.js +29 -23
  241. package/dist/forms/color/ColorPicker.js.map +2 -2
  242. package/dist/forms/color/ColorPickerButton.d.ts +12 -2
  243. package/dist/forms/color/ColorPickerButton.js +37 -22
  244. package/dist/forms/color/ColorPickerButton.js.map +2 -2
  245. package/dist/forms/color/ColorSwatch.js +2 -2
  246. package/dist/forms/color/ColorSwatch.js.map +2 -2
  247. package/dist/forms/color/internal/{colorChange.js → ColorChangeContext.js} +1 -1
  248. package/dist/forms/color/internal/{colorChange.js.map → ColorChangeContext.js.map} +1 -1
  249. package/dist/forms/color/internal/ColorLocale.d.ts +0 -3
  250. package/dist/forms/color/internal/ColorLocale.js +2 -8
  251. package/dist/forms/color/internal/ColorLocale.js.map +2 -2
  252. package/dist/forms/color/internal/ColorValues.d.ts +1 -1
  253. package/dist/forms/color/internal/ColorValues.js +2 -2
  254. package/dist/forms/color/internal/ColorValues.js.map +2 -2
  255. package/dist/forms/color/internal/SwatchList.js +6 -9
  256. package/dist/forms/color/internal/SwatchList.js.map +2 -2
  257. package/dist/forms/color/internal/colorPickerValueProps.d.ts +12 -0
  258. package/dist/forms/color/internal/colorValue.d.ts +1 -0
  259. package/dist/forms/color/internal/colorValue.js +5 -0
  260. package/dist/forms/color/internal/colorValue.js.map +2 -2
  261. package/dist/forms/color/internal/useColorFollowingValue.d.ts +7 -0
  262. package/dist/forms/color/internal/useColorFollowingValue.js +15 -0
  263. package/dist/forms/color/internal/useColorFollowingValue.js.map +7 -0
  264. package/dist/forms/color/internal/useFormResetting.d.ts +9 -0
  265. package/dist/forms/color/internal/useFormResetting.js +36 -0
  266. package/dist/forms/color/internal/useFormResetting.js.map +7 -0
  267. package/dist/forms/color/internal/useSwatchFocus.d.ts +17 -0
  268. package/dist/forms/color/internal/useSwatchFocus.js +62 -0
  269. package/dist/forms/color/internal/useSwatchFocus.js.map +7 -0
  270. package/dist/forms/internal/ComboboxField.d.ts +30 -0
  271. package/dist/forms/internal/ComboboxField.js +147 -0
  272. package/dist/forms/internal/ComboboxField.js.map +7 -0
  273. package/dist/forms/internal/ComboboxPopup.d.ts +2 -2
  274. package/dist/forms/internal/ComboboxPopup.js +8 -16
  275. package/dist/forms/internal/ComboboxPopup.js.map +2 -2
  276. package/dist/forms/internal/MonthGrid.d.ts +1 -1
  277. package/dist/forms/internal/MonthGrid.js +4 -4
  278. package/dist/forms/internal/MonthGrid.js.map +2 -2
  279. package/dist/forms/internal/PickerField.d.ts +32 -27
  280. package/dist/forms/internal/PickerField.js +70 -52
  281. package/dist/forms/internal/PickerField.js.map +3 -3
  282. package/dist/forms/internal/PickerPopup.d.ts +2 -1
  283. package/dist/forms/internal/PickerPopup.js +3 -0
  284. package/dist/forms/internal/PickerPopup.js.map +2 -2
  285. package/dist/forms/internal/TimeList.d.ts +1 -1
  286. package/dist/forms/internal/TimeList.js +4 -4
  287. package/dist/forms/internal/TimeList.js.map +2 -2
  288. package/dist/forms/internal/TimeWheel.d.ts +3 -3
  289. package/dist/forms/internal/TimeWheel.js +5 -5
  290. package/dist/forms/internal/TimeWheel.js.map +2 -2
  291. package/dist/{internal/time → forms/internal}/calendarDays.d.ts +1 -0
  292. package/dist/{internal/time → forms/internal}/calendarDays.js +5 -1
  293. package/dist/forms/internal/calendarDays.js.map +7 -0
  294. package/dist/forms/internal/comboboxItems.d.ts +15 -4
  295. package/dist/forms/internal/comboboxItems.js +0 -12
  296. package/dist/forms/internal/comboboxItems.js.map +3 -3
  297. package/dist/forms/internal/pickerFocus.d.ts +4 -0
  298. package/dist/forms/internal/pickerFocus.js +13 -0
  299. package/dist/forms/internal/pickerFocus.js.map +7 -0
  300. package/dist/forms/internal/timeWheelRows.d.ts +4 -4
  301. package/dist/forms/internal/timeWheelRows.js +6 -4
  302. package/dist/forms/internal/timeWheelRows.js.map +2 -2
  303. package/dist/forms/internal/useComboboxOpen.js +2 -5
  304. package/dist/forms/internal/useComboboxOpen.js.map +2 -2
  305. package/dist/forms/internal/useComboboxOptions.js +3 -4
  306. package/dist/forms/internal/useComboboxOptions.js.map +2 -2
  307. package/dist/forms/internal/useComboboxSelection.d.ts +1 -1
  308. package/dist/forms/internal/usePicker.d.ts +29 -0
  309. package/dist/forms/internal/usePicker.js +38 -0
  310. package/dist/forms/internal/usePicker.js.map +7 -0
  311. package/dist/forms/internal/usePickerFormatter.d.ts +4 -0
  312. package/dist/forms/internal/usePickerFormatter.js +23 -0
  313. package/dist/forms/internal/usePickerFormatter.js.map +7 -0
  314. package/dist/forms/internal/useTimeWheelTurn.d.ts +2 -2
  315. package/dist/forms/internal/useTimeWheelTurn.js +7 -7
  316. package/dist/forms/internal/useTimeWheelTurn.js.map +2 -2
  317. package/dist/foundations/PortalContainer.js +1 -1
  318. package/dist/foundations/PortalContainer.js.map +1 -1
  319. package/dist/foundations/Theme.d.ts +9 -2
  320. package/dist/foundations/Theme.js +24 -19
  321. package/dist/foundations/Theme.js.map +2 -2
  322. package/dist/foundations/ThemeMenuRadioGroup.d.ts +13 -6
  323. package/dist/foundations/ThemeMenuRadioGroup.js +6 -11
  324. package/dist/foundations/ThemeMenuRadioGroup.js.map +2 -2
  325. package/dist/foundations/ThemePreferenceProvider.d.ts +48 -0
  326. package/dist/foundations/{ThemePreference.js → ThemePreferenceProvider.js} +48 -106
  327. package/dist/foundations/ThemePreferenceProvider.js.map +7 -0
  328. package/dist/foundations/ThemeToggle.d.ts +9 -2
  329. package/dist/foundations/ThemeToggle.js +3 -2
  330. package/dist/foundations/ThemeToggle.js.map +2 -2
  331. package/dist/foundations/internal/ThemePreferenceContext.d.ts +4 -4
  332. package/dist/foundations/internal/ThemePreferenceContext.js.map +1 -1
  333. package/dist/foundations/internal/storedPreference.d.ts +3 -0
  334. package/dist/foundations/internal/storedPreference.js +8 -0
  335. package/dist/foundations/internal/storedPreference.js.map +7 -0
  336. package/dist/foundations/messages/defaultMessages.d.ts +4 -72
  337. package/dist/foundations/messages/defaultMessages.js +0 -14
  338. package/dist/foundations/messages/defaultMessages.js.map +2 -2
  339. package/dist/foundations/messages/list.d.ts +13 -35
  340. package/dist/foundations/messages/list.js +1 -5
  341. package/dist/foundations/messages/list.js.map +2 -2
  342. package/dist/foundations/messages/message.d.ts +1 -1
  343. package/dist/foundations/messages/message.js +1 -1
  344. package/dist/foundations/messages/message.js.map +1 -1
  345. package/dist/foundations/messages/navigation.d.ts +4 -0
  346. package/dist/foundations/messages/navigation.js +2 -0
  347. package/dist/foundations/messages/navigation.js.map +2 -2
  348. package/dist/foundations/themeBootstrap.d.ts +13 -35
  349. package/dist/foundations/themeBootstrap.js +4 -35
  350. package/dist/foundations/themeBootstrap.js.map +2 -2
  351. package/dist/foundations/themeStorage.d.ts +20 -0
  352. package/dist/foundations/themeStorage.js +12 -0
  353. package/dist/foundations/themeStorage.js.map +7 -0
  354. package/dist/foundations/useContainerSize.js +13 -11
  355. package/dist/foundations/useContainerSize.js.map +2 -2
  356. package/dist/foundations/useSkeleton.d.ts +5 -0
  357. package/dist/foundations/useSkeleton.js +10 -0
  358. package/dist/foundations/useSkeleton.js.map +7 -0
  359. package/dist/foundations/useStoredThemePreference.d.ts +16 -0
  360. package/dist/foundations/useStoredThemePreference.js +63 -0
  361. package/dist/foundations/useStoredThemePreference.js.map +7 -0
  362. package/dist/foundations/windowClasses.d.ts +0 -2
  363. package/dist/foundations/windowClasses.js +1 -4
  364. package/dist/foundations/windowClasses.js.map +2 -2
  365. package/dist/index.d.ts +15 -20
  366. package/dist/index.js +16 -36
  367. package/dist/index.js.map +2 -2
  368. package/dist/internal/control/ActionElement.d.ts +3 -2
  369. package/dist/internal/control/ActionElement.js +8 -0
  370. package/dist/internal/control/ActionElement.js.map +2 -2
  371. package/dist/internal/dialog/ModalLayer.d.ts +9 -0
  372. package/dist/internal/dialog/ModalLayer.js +32 -0
  373. package/dist/internal/dialog/ModalLayer.js.map +7 -0
  374. package/dist/internal/dom/idRefs.d.ts +2 -0
  375. package/dist/internal/dom/idRefs.js +7 -0
  376. package/dist/internal/dom/idRefs.js.map +7 -0
  377. package/dist/internal/dom/lengths.d.ts +3 -1
  378. package/dist/internal/dom/lengths.js +7 -2
  379. package/dist/internal/dom/lengths.js.map +2 -2
  380. package/dist/internal/dom/observeResize.d.ts +7 -0
  381. package/dist/internal/dom/observeResize.js +11 -0
  382. package/dist/internal/dom/observeResize.js.map +7 -0
  383. package/dist/internal/dom/verticalScrollerOf.d.ts +5 -0
  384. package/dist/internal/dom/verticalScrollerOf.js +12 -0
  385. package/dist/internal/dom/verticalScrollerOf.js.map +7 -0
  386. package/dist/internal/field/FieldFrame.d.ts +2 -61
  387. package/dist/internal/field/FieldFrame.js +17 -8
  388. package/dist/internal/field/FieldFrame.js.map +2 -2
  389. package/dist/internal/field/{rowControl.d.ts → RowControl.d.ts} +2 -2
  390. package/dist/internal/field/{rowControl.js → RowControl.js} +4 -7
  391. package/dist/internal/field/RowControl.js.map +7 -0
  392. package/dist/internal/field/TextareaControl.d.ts +2 -2
  393. package/dist/internal/field/TextareaControl.js +5 -11
  394. package/dist/internal/field/TextareaControl.js.map +2 -2
  395. package/dist/internal/field/{TextareaResizeEdge.d.ts → TextareaResizeHandle.d.ts} +1 -1
  396. package/dist/internal/field/{TextareaResizeEdge.js → TextareaResizeHandle.js} +10 -11
  397. package/dist/internal/field/TextareaResizeHandle.js.map +7 -0
  398. package/dist/internal/field/fieldProps.d.ts +67 -0
  399. package/dist/internal/field/fieldProps.js +1 -0
  400. package/dist/internal/field/fieldProps.js.map +7 -0
  401. package/dist/internal/field/fieldSizing.d.ts +1 -0
  402. package/dist/internal/field/fieldSizing.js +5 -0
  403. package/dist/internal/field/fieldSizing.js.map +7 -0
  404. package/dist/internal/field/useFieldControl.d.ts +36 -0
  405. package/dist/internal/field/useFieldControl.js +53 -0
  406. package/dist/internal/field/useFieldControl.js.map +7 -0
  407. package/dist/internal/field/useFormReset.js +1 -1
  408. package/dist/internal/field/useFormReset.js.map +1 -1
  409. package/dist/internal/icon/DecorativeIcon.d.ts +2 -1
  410. package/dist/internal/icon/DecorativeIcon.js +6 -2
  411. package/dist/internal/icon/DecorativeIcon.js.map +2 -2
  412. package/dist/internal/layout/Slot.d.ts +2 -1
  413. package/dist/internal/layout/Slot.js +3 -1
  414. package/dist/internal/layout/Slot.js.map +2 -2
  415. package/dist/internal/popup/ListRow.d.ts +39 -0
  416. package/dist/internal/{list → popup}/ListRow.js +15 -7
  417. package/dist/internal/popup/ListRow.js.map +7 -0
  418. package/dist/internal/popup/PopupSurface.d.ts +1 -1
  419. package/dist/internal/popup/PopupSurface.js +3 -6
  420. package/dist/internal/popup/PopupSurface.js.map +2 -2
  421. package/dist/internal/popup/TooltipPopup.d.ts +3 -9
  422. package/dist/internal/popup/TooltipPopup.js +2 -9
  423. package/dist/internal/popup/TooltipPopup.js.map +2 -2
  424. package/dist/internal/popup/{PortalContainerContext.d.ts → containedOverlays.d.ts} +2 -14
  425. package/dist/internal/popup/{PortalContainerContext.js → containedOverlays.js} +7 -13
  426. package/dist/internal/popup/containedOverlays.js.map +7 -0
  427. package/dist/internal/popup/listEntries.d.ts +13 -0
  428. package/dist/internal/popup/listEntries.js +11 -0
  429. package/dist/internal/popup/listEntries.js.map +7 -0
  430. package/dist/internal/popup/useCutShort.d.ts +6 -0
  431. package/dist/internal/popup/useCutShort.js +19 -0
  432. package/dist/internal/popup/useCutShort.js.map +7 -0
  433. package/dist/internal/provider/PortalContainerContext.d.ts +14 -0
  434. package/dist/internal/provider/PortalContainerContext.js +11 -0
  435. package/dist/internal/provider/PortalContainerContext.js.map +7 -0
  436. package/dist/internal/provider/formatters.d.ts +17 -0
  437. package/dist/internal/provider/formatters.js +21 -0
  438. package/dist/internal/provider/formatters.js.map +7 -0
  439. package/dist/internal/provider/locale.d.ts +4 -4
  440. package/dist/internal/provider/locale.js +9 -1
  441. package/dist/internal/provider/locale.js.map +2 -2
  442. package/dist/internal/provider/useDirection.d.ts +1 -1
  443. package/dist/internal/provider/useDirection.js +2 -14
  444. package/dist/internal/provider/useDirection.js.map +2 -2
  445. package/dist/internal/provider/useFormatters.d.ts +1 -16
  446. package/dist/internal/provider/useFormatters.js +3 -26
  447. package/dist/internal/provider/useFormatters.js.map +2 -2
  448. package/dist/internal/rangeBarProps.d.ts +6 -2
  449. package/dist/internal/react/chainHandlers.d.ts +6 -0
  450. package/dist/internal/react/chainHandlers.js +12 -0
  451. package/dist/internal/react/chainHandlers.js.map +7 -0
  452. package/dist/internal/react/renderElement.js +2 -14
  453. package/dist/internal/react/renderElement.js.map +2 -2
  454. package/dist/internal/react/rendersContent.d.ts +2 -0
  455. package/dist/internal/react/rendersContent.js +7 -0
  456. package/dist/internal/react/rendersContent.js.map +7 -0
  457. package/dist/internal/react/setRef.d.ts +6 -1
  458. package/dist/internal/react/setRef.js +13 -0
  459. package/dist/internal/react/setRef.js.map +2 -2
  460. package/dist/internal/react/useControllableState.js +1 -1
  461. package/dist/internal/react/useControllableState.js.map +1 -1
  462. package/dist/internal/{useCopy.js.map → react/useCopy.js.map} +1 -1
  463. package/dist/internal/{useLatest.js.map → react/useLatest.js.map} +1 -1
  464. package/dist/internal/react/useMergedRefs.d.ts +3 -0
  465. package/dist/internal/react/useMergedRefs.js +10 -0
  466. package/dist/internal/react/useMergedRefs.js.map +7 -0
  467. package/dist/internal/resize/useResizableWidth.d.ts +4 -16
  468. package/dist/internal/resize/useResizableWidth.js +5 -17
  469. package/dist/internal/resize/useResizableWidth.js.map +2 -2
  470. package/dist/internal/sizeTokens.d.ts +13 -0
  471. package/dist/internal/sizeTokens.js +15 -0
  472. package/dist/internal/sizeTokens.js.map +7 -0
  473. package/dist/internal/skeleton/SkeletonContext.d.ts +2 -0
  474. package/dist/internal/skeleton/SkeletonContext.js +7 -0
  475. package/dist/internal/skeleton/SkeletonContext.js.map +7 -0
  476. package/dist/{foundations → internal/skeleton}/SkeletonScope.d.ts +0 -10
  477. package/dist/{foundations → internal/skeleton}/SkeletonScope.js +6 -11
  478. package/dist/internal/skeleton/SkeletonScope.js.map +7 -0
  479. package/dist/internal/{skeleton.d.ts → skeleton/skeleton.d.ts} +1 -3
  480. package/dist/internal/{skeleton.js → skeleton/skeleton.js} +1 -2
  481. package/dist/internal/skeleton/skeleton.js.map +7 -0
  482. package/dist/{foundations/internal → internal/skeleton}/skeletonText.js +5 -5
  483. package/dist/internal/skeleton/skeletonText.js.map +7 -0
  484. package/dist/internal/text/labelText.d.ts +15 -0
  485. package/dist/internal/text/labelText.js +34 -0
  486. package/dist/internal/text/labelText.js.map +7 -0
  487. package/dist/internal/text/useRenderedText.d.ts +3 -0
  488. package/dist/internal/text/useRenderedText.js +19 -0
  489. package/dist/internal/text/useRenderedText.js.map +7 -0
  490. package/dist/internal/theme/themeRoot.d.ts +27 -0
  491. package/dist/internal/theme/themeRoot.js +45 -0
  492. package/dist/internal/theme/themeRoot.js.map +7 -0
  493. package/dist/internal/typeahead.d.ts +9 -5
  494. package/dist/internal/typeahead.js +4 -1
  495. package/dist/internal/typeahead.js.map +2 -2
  496. package/dist/layout/Card.d.ts +21 -4
  497. package/dist/layout/Card.js +12 -6
  498. package/dist/layout/Card.js.map +2 -2
  499. package/dist/layout/Layout.d.ts +2 -2
  500. package/dist/layout/Layout.js.map +1 -1
  501. package/dist/layout/Page.d.ts +2 -2
  502. package/dist/layout/Page.js.map +1 -1
  503. package/dist/layout/PageHeader.d.ts +6 -1
  504. package/dist/layout/PageHeader.js +3 -1
  505. package/dist/layout/PageHeader.js.map +2 -2
  506. package/dist/layout/Panes.d.ts +10 -20
  507. package/dist/layout/Panes.js +5 -25
  508. package/dist/layout/Panes.js.map +2 -2
  509. package/dist/layout/ResizeHandle.d.ts +1 -0
  510. package/dist/layout/ResizeHandle.js +11 -21
  511. package/dist/layout/ResizeHandle.js.map +2 -2
  512. package/dist/layout/Scaffold.d.ts +14 -4
  513. package/dist/layout/Scaffold.js +16 -51
  514. package/dist/layout/Scaffold.js.map +2 -2
  515. package/dist/layout/Surface.d.ts +1 -1
  516. package/dist/layout/Surface.js +4 -1
  517. package/dist/layout/Surface.js.map +2 -2
  518. package/dist/layout/TopBar.d.ts +2 -2
  519. package/dist/layout/TopBar.js +4 -5
  520. package/dist/layout/TopBar.js.map +2 -2
  521. package/dist/layout/internal/LoadingBar.d.ts +3 -7
  522. package/dist/layout/internal/LoadingBar.js +5 -10
  523. package/dist/layout/internal/LoadingBar.js.map +2 -2
  524. package/dist/layout/internal/PageTitleFocus.d.ts +0 -9
  525. package/dist/layout/internal/PageTitleFocus.js +3 -24
  526. package/dist/layout/internal/PageTitleFocus.js.map +2 -2
  527. package/dist/layout/internal/StickyHeaderSize.js +3 -3
  528. package/dist/layout/internal/StickyHeaderSize.js.map +2 -2
  529. package/dist/layout/internal/{navigationForms.d.ts → scaffold/navigationForms.d.ts} +2 -2
  530. package/dist/layout/internal/scaffold/navigationForms.js.map +7 -0
  531. package/dist/layout/internal/{scaffoldFocus.js.map → scaffold/scaffoldFocus.js.map} +1 -1
  532. package/dist/layout/internal/{scrollKeys.js → scaffold/scrollKeys.js} +1 -1
  533. package/dist/layout/internal/scaffold/scrollKeys.js.map +7 -0
  534. package/dist/layout/internal/scaffold/useBarSizes.d.ts +6 -0
  535. package/dist/layout/internal/scaffold/useBarSizes.js +54 -0
  536. package/dist/layout/internal/scaffold/useBarSizes.js.map +7 -0
  537. package/dist/layout/internal/{useNavigationFocusHandoff.js → scaffold/useNavigationFocusHandoff.js} +5 -4
  538. package/dist/layout/internal/scaffold/useNavigationFocusHandoff.js.map +7 -0
  539. package/dist/layout/internal/{useScrollKeys.js → scaffold/useScrollKeys.js} +1 -1
  540. package/dist/layout/internal/scaffold/useScrollKeys.js.map +7 -0
  541. package/dist/layout/internal/scaffoldPages.d.ts +9 -0
  542. package/dist/layout/internal/scaffoldPages.js +27 -0
  543. package/dist/layout/internal/scaffoldPages.js.map +7 -0
  544. package/dist/markdown.d.ts +0 -1
  545. package/dist/markdown.js +0 -1
  546. package/dist/markdown.js.map +2 -2
  547. package/dist/messages.d.ts +1 -1
  548. package/dist/messages.js +1 -6
  549. package/dist/messages.js.map +2 -2
  550. package/dist/navigation/Breadcrumbs.d.ts +15 -4
  551. package/dist/navigation/Breadcrumbs.js +36 -27
  552. package/dist/navigation/Breadcrumbs.js.map +2 -2
  553. package/dist/navigation/DocumentTabs.d.ts +54 -12
  554. package/dist/navigation/DocumentTabs.js +50 -150
  555. package/dist/navigation/DocumentTabs.js.map +3 -3
  556. package/dist/navigation/NavigationBar.d.ts +10 -3
  557. package/dist/navigation/NavigationBar.js +75 -35
  558. package/dist/navigation/NavigationBar.js.map +2 -2
  559. package/dist/navigation/NavigationDrawer.d.ts +9 -3
  560. package/dist/navigation/NavigationDrawer.js +24 -217
  561. package/dist/navigation/NavigationDrawer.js.map +2 -2
  562. package/dist/navigation/NavigationRail.d.ts +10 -3
  563. package/dist/navigation/NavigationRail.js +20 -10
  564. package/dist/navigation/NavigationRail.js.map +2 -2
  565. package/dist/navigation/Pager.d.ts +25 -11
  566. package/dist/navigation/Pager.js +49 -12
  567. package/dist/navigation/Pager.js.map +3 -3
  568. package/dist/navigation/Pagination.d.ts +24 -9
  569. package/dist/navigation/Pagination.js +37 -11
  570. package/dist/navigation/Pagination.js.map +2 -2
  571. package/dist/navigation/TableOfContents.d.ts +18 -4
  572. package/dist/navigation/TableOfContents.js +41 -121
  573. package/dist/navigation/TableOfContents.js.map +2 -2
  574. package/dist/navigation/Tree.d.ts +28 -11
  575. package/dist/navigation/Tree.js +41 -37
  576. package/dist/navigation/Tree.js.map +2 -2
  577. package/dist/navigation/destinations.d.ts +43 -11
  578. package/dist/navigation/internal/DestinationItem.d.ts +5 -41
  579. package/dist/navigation/internal/DestinationItem.js +41 -44
  580. package/dist/navigation/internal/DestinationItem.js.map +2 -2
  581. package/dist/navigation/internal/destinationModel.d.ts +16 -0
  582. package/dist/navigation/internal/destinationModel.js +28 -0
  583. package/dist/navigation/internal/destinationModel.js.map +7 -0
  584. package/dist/navigation/internal/documentTabs/DocumentTab.d.ts +12 -0
  585. package/dist/navigation/internal/documentTabs/DocumentTab.js +122 -0
  586. package/dist/navigation/internal/documentTabs/DocumentTab.js.map +7 -0
  587. package/dist/navigation/internal/documentTabs/tabMenuContent.d.ts +21 -0
  588. package/dist/navigation/internal/documentTabs/tabMenuContent.js +73 -0
  589. package/dist/navigation/internal/documentTabs/tabMenuContent.js.map +7 -0
  590. package/dist/navigation/internal/documentTabs/tabStrip.d.ts +7 -0
  591. package/dist/navigation/internal/documentTabs/tabStrip.js +26 -0
  592. package/dist/navigation/internal/documentTabs/tabStrip.js.map +7 -0
  593. package/dist/navigation/internal/{useTabCloseFocus.js → documentTabs/useTabCloseFocus.js} +2 -2
  594. package/dist/navigation/internal/documentTabs/useTabCloseFocus.js.map +7 -0
  595. package/dist/navigation/internal/{useTabDrag.d.ts → documentTabs/useTabDrag.d.ts} +3 -3
  596. package/dist/navigation/internal/{useTabDrag.js → documentTabs/useTabDrag.js} +8 -8
  597. package/dist/navigation/internal/documentTabs/useTabDrag.js.map +7 -0
  598. package/dist/navigation/internal/{useTabStripScrolling.js → documentTabs/useTabStripScrolling.js} +22 -3
  599. package/dist/navigation/internal/documentTabs/useTabStripScrolling.js.map +7 -0
  600. package/dist/navigation/internal/landmarkLabel.d.ts +1 -0
  601. package/dist/navigation/internal/landmarkLabel.js +5 -0
  602. package/dist/navigation/internal/landmarkLabel.js.map +7 -0
  603. package/dist/navigation/internal/navigationDrawer/DrawerRows.d.ts +18 -0
  604. package/dist/navigation/internal/navigationDrawer/DrawerRows.js +151 -0
  605. package/dist/navigation/internal/navigationDrawer/DrawerRows.js.map +7 -0
  606. package/dist/navigation/internal/navigationDrawer/destinationSections.d.ts +13 -0
  607. package/dist/navigation/internal/navigationDrawer/destinationSections.js +13 -0
  608. package/dist/navigation/internal/navigationDrawer/destinationSections.js.map +7 -0
  609. package/dist/navigation/internal/navigationDrawer/useExpandedSections.d.ts +6 -0
  610. package/dist/navigation/internal/navigationDrawer/useExpandedSections.js +57 -0
  611. package/dist/navigation/internal/navigationDrawer/useExpandedSections.js.map +7 -0
  612. package/dist/navigation/internal/tableOfContents/contentsOutline.d.ts +26 -0
  613. package/dist/navigation/internal/tableOfContents/contentsOutline.js +38 -0
  614. package/dist/navigation/internal/tableOfContents/contentsOutline.js.map +7 -0
  615. package/dist/navigation/internal/{contentsWave.js → tableOfContents/contentsWave.js} +1 -1
  616. package/dist/navigation/internal/tableOfContents/contentsWave.js.map +7 -0
  617. package/dist/navigation/internal/tableOfContents/readingPosition.d.ts +25 -0
  618. package/dist/navigation/internal/{contentsOutline.js → tableOfContents/readingPosition.js} +2 -37
  619. package/dist/navigation/internal/tableOfContents/readingPosition.js.map +7 -0
  620. package/dist/navigation/internal/{sectionScroll.d.ts → tableOfContents/sectionScroll.d.ts} +6 -1
  621. package/dist/navigation/internal/{sectionScroll.js → tableOfContents/sectionScroll.js} +18 -10
  622. package/dist/navigation/internal/tableOfContents/sectionScroll.js.map +7 -0
  623. package/dist/navigation/internal/{useContentsHeadings.d.ts → tableOfContents/useContentsHeadings.d.ts} +2 -2
  624. package/dist/navigation/internal/{useContentsHeadings.js → tableOfContents/useContentsHeadings.js} +4 -7
  625. package/dist/navigation/internal/tableOfContents/useContentsHeadings.js.map +7 -0
  626. package/dist/navigation/internal/tableOfContents/useReadingPlace.d.ts +15 -0
  627. package/dist/navigation/internal/tableOfContents/useReadingPlace.js +119 -0
  628. package/dist/navigation/internal/tableOfContents/useReadingPlace.js.map +7 -0
  629. package/dist/navigation/internal/{waveDrawer.js → tableOfContents/waveDrawer.js} +5 -4
  630. package/dist/navigation/internal/tableOfContents/waveDrawer.js.map +7 -0
  631. package/dist/navigation/internal/{TreeRow.d.ts → tree/TreeRow.d.ts} +1 -1
  632. package/dist/navigation/internal/{TreeRow.js → tree/TreeRow.js} +9 -5
  633. package/dist/navigation/internal/tree/TreeRow.js.map +7 -0
  634. package/dist/navigation/internal/{treeModel.d.ts → tree/treeModel.d.ts} +7 -9
  635. package/dist/navigation/internal/{treeModel.js → tree/treeModel.js} +10 -13
  636. package/dist/navigation/internal/tree/treeModel.js.map +7 -0
  637. package/dist/navigation/internal/{useTreeTransitions.d.ts → tree/useTreeTransitions.d.ts} +1 -1
  638. package/dist/navigation/internal/tree/useTreeTransitions.js.map +7 -0
  639. package/dist/navigation/internal/{useTreeViewport.d.ts → tree/useTreeViewport.d.ts} +3 -3
  640. package/dist/navigation/internal/{useTreeViewport.js → tree/useTreeViewport.js} +11 -12
  641. package/dist/navigation/internal/tree/useTreeViewport.js.map +7 -0
  642. package/dist/navigation/internal/useLabelText.d.ts +6 -0
  643. package/dist/navigation/internal/useLabelText.js +11 -0
  644. package/dist/navigation/internal/useLabelText.js.map +7 -0
  645. package/dist/navigation/navigationBackground.d.ts +0 -2
  646. package/dist/navigation/navigationBackground.js +0 -6
  647. package/dist/navigation/navigationBackground.js.map +3 -3
  648. package/dist/overlays/ConfirmDialog.d.ts +6 -3
  649. package/dist/overlays/ConfirmDialog.js +64 -68
  650. package/dist/overlays/ConfirmDialog.js.map +2 -2
  651. package/dist/overlays/Dialog.d.ts +40 -6
  652. package/dist/overlays/Dialog.js +69 -41
  653. package/dist/overlays/Dialog.js.map +2 -2
  654. package/dist/overlays/HoverCard.d.ts +9 -2
  655. package/dist/overlays/HoverCard.js +5 -5
  656. package/dist/overlays/HoverCard.js.map +2 -2
  657. package/dist/overlays/Popover.d.ts +20 -5
  658. package/dist/overlays/Popover.js +8 -6
  659. package/dist/overlays/Popover.js.map +2 -2
  660. package/dist/overlays/Sheet.d.ts +16 -3
  661. package/dist/overlays/Sheet.js +88 -87
  662. package/dist/overlays/Sheet.js.map +2 -2
  663. package/dist/overlays/Tooltip.d.ts +7 -0
  664. package/dist/overlays/Tooltip.js +10 -15
  665. package/dist/overlays/Tooltip.js.map +2 -2
  666. package/dist/overlays/internal/accessibleName.js +2 -1
  667. package/dist/overlays/internal/accessibleName.js.map +2 -2
  668. package/dist/overlays/internal/dialog/DialogHeadingClose.d.ts +8 -0
  669. package/dist/overlays/internal/dialog/DialogHeadingClose.js +19 -0
  670. package/dist/overlays/internal/dialog/DialogHeadingClose.js.map +7 -0
  671. package/dist/overlays/internal/dialog/DialogParts.d.ts +33 -0
  672. package/dist/overlays/internal/dialog/DialogParts.js +64 -0
  673. package/dist/overlays/internal/dialog/DialogParts.js.map +7 -0
  674. package/dist/overlays/internal/{DialogPendingAction.d.ts → dialog/dialogPending.d.ts} +8 -0
  675. package/dist/overlays/internal/{DialogPendingAction.js → dialog/dialogPending.js} +13 -2
  676. package/dist/overlays/internal/dialog/dialogPending.js.map +7 -0
  677. package/dist/styles/Accordion.css +1 -1
  678. package/dist/styles/Alert.css +1 -1
  679. package/dist/styles/Avatar.css +1 -1
  680. package/dist/styles/Badge.css +1 -1
  681. package/dist/styles/Base.css +1 -1
  682. package/dist/styles/Breadcrumbs.css +1 -1
  683. package/dist/styles/Card.css +1 -1
  684. package/dist/styles/Checkbox.css +1 -1
  685. package/dist/styles/Code.css +1 -1
  686. package/dist/styles/Combobox.css +1 -1
  687. package/dist/styles/CommandPalette.css +1 -1
  688. package/dist/styles/Composer.css +1 -1
  689. package/dist/styles/CopyButton.css +1 -1
  690. package/dist/styles/Dialog.css +1 -1
  691. package/dist/styles/Disclosure.css +1 -1
  692. package/dist/styles/DocumentTabs.css +1 -1
  693. package/dist/styles/DropZone.css +1 -1
  694. package/dist/styles/EmptyState.css +1 -1
  695. package/dist/styles/Halo.css +1 -0
  696. package/dist/styles/List.css +1 -1
  697. package/dist/styles/ListRow.css +1 -1
  698. package/dist/styles/LoadingBar.css +1 -1
  699. package/dist/styles/Menu.css +1 -1
  700. package/dist/styles/Message.css +1 -1
  701. package/dist/styles/Meter.css +1 -1
  702. package/dist/styles/NavigationBar.css +1 -1
  703. package/dist/styles/NavigationDestinations.css +1 -0
  704. package/dist/styles/NavigationDrawer.css +1 -1
  705. package/dist/styles/NavigationRail.css +1 -1
  706. package/dist/styles/Pager.css +1 -1
  707. package/dist/styles/Panes.css +1 -1
  708. package/dist/styles/Progress.css +1 -0
  709. package/dist/styles/Radio.css +1 -1
  710. package/dist/styles/Scaffold.css +1 -1
  711. package/dist/styles/SegmentedControl.css +1 -1
  712. package/dist/styles/Select.css +1 -1
  713. package/dist/styles/Switch.css +1 -1
  714. package/dist/styles/Table.css +1 -1
  715. package/dist/styles/TableOfContents.css +1 -1
  716. package/dist/styles/Text.css +1 -1
  717. package/dist/styles/TextField.css +1 -1
  718. package/dist/styles/Toast.css +1 -1
  719. package/dist/styles/Toolbar.css +1 -1
  720. package/dist/styles/Tree.css +1 -1
  721. package/dist/styles.css +1 -1
  722. package/dist/theme-bootstrap.d.ts +1 -1
  723. package/dist/theme-bootstrap.js +1 -8
  724. package/dist/theme-bootstrap.js.map +2 -2
  725. package/dist/theme-storage.d.ts +2 -0
  726. package/dist/theme-storage.js +3 -0
  727. package/dist/theme-storage.js.map +7 -0
  728. package/dist/tokens.json +0 -13
  729. package/docs/components/accordion.md +13 -0
  730. package/docs/components/alert.md +8 -1
  731. package/docs/components/avatar.md +16 -4
  732. package/docs/components/badge.md +10 -39
  733. package/docs/components/box.md +3 -3
  734. package/docs/components/breadcrumbs.md +6 -1
  735. package/docs/components/button.md +14 -9
  736. package/docs/components/card.md +14 -5
  737. package/docs/components/checkbox.md +3 -1
  738. package/docs/components/code.md +15 -6
  739. package/docs/components/color-picker.md +10 -2
  740. package/docs/components/column.md +2 -2
  741. package/docs/components/combobox.md +1 -1
  742. package/docs/components/command-palette.md +6 -2
  743. package/docs/components/composer.md +19 -8
  744. package/docs/components/confirm-dialog.md +3 -3
  745. package/docs/components/date-picker.md +15 -3
  746. package/docs/components/description-list.md +1 -1
  747. package/docs/components/dialog.md +34 -8
  748. package/docs/components/disclosure.md +4 -0
  749. package/docs/components/document-tabs.md +23 -13
  750. package/docs/components/drop-zone.md +10 -1
  751. package/docs/components/empty-state.md +12 -3
  752. package/docs/components/field.md +2 -1
  753. package/docs/components/graphic.md +1 -1
  754. package/docs/components/grid.md +2 -2
  755. package/docs/components/halo.md +80 -0
  756. package/docs/components/hover-card.md +2 -1
  757. package/docs/components/kbd.md +8 -2
  758. package/docs/components/link.md +1 -1
  759. package/docs/components/list.md +13 -5
  760. package/docs/components/markdown.md +9 -116
  761. package/docs/components/menu.md +28 -12
  762. package/docs/components/menubar.md +4 -3
  763. package/docs/components/message.md +17 -13
  764. package/docs/components/meter.md +8 -3
  765. package/docs/components/month-picker.md +4 -2
  766. package/docs/components/navigation-drawer.md +32 -7
  767. package/docs/components/page.md +4 -3
  768. package/docs/components/pager.md +16 -6
  769. package/docs/components/pagination.md +3 -2
  770. package/docs/components/panes.md +13 -26
  771. package/docs/components/popover.md +3 -2
  772. package/docs/components/progress.md +2 -2
  773. package/docs/components/radio.md +13 -5
  774. package/docs/components/relative-time.md +2 -1
  775. package/docs/components/resize-handle.md +6 -4
  776. package/docs/components/row.md +2 -2
  777. package/docs/components/scaffold.md +13 -4
  778. package/docs/components/segmented-control.md +10 -4
  779. package/docs/components/select.md +10 -2
  780. package/docs/components/sheet.md +4 -1
  781. package/docs/components/slider.md +8 -2
  782. package/docs/components/spinner.md +1 -1
  783. package/docs/components/surface.md +1 -1
  784. package/docs/components/switch.md +2 -0
  785. package/docs/components/table-of-contents.md +3 -2
  786. package/docs/components/table.md +18 -3
  787. package/docs/components/text-field.md +14 -8
  788. package/docs/components/time-picker.md +4 -2
  789. package/docs/components/toast.md +2 -1
  790. package/docs/components/toolbar.md +31 -6
  791. package/docs/components/tooltip.md +1 -0
  792. package/docs/components/top-bar.md +1 -1
  793. package/docs/components/tree.md +9 -4
  794. package/docs/customizing.md +59 -91
  795. package/docs/examples/accordion/IntegrationSwitches.tsx +33 -0
  796. package/docs/examples/alert/BannerAction.tsx +19 -0
  797. package/docs/examples/avatar/BotsAndPresence.tsx +24 -0
  798. package/docs/examples/badge/BadgeAnatomy.tsx +1 -1
  799. package/docs/examples/badge/CountsInButtons.tsx +2 -2
  800. package/docs/examples/badge/WithContent.tsx +13 -0
  801. package/docs/examples/breadcrumbs/WithAvatar.tsx +20 -0
  802. package/docs/examples/button/ButtonAnatomy.tsx +1 -1
  803. package/docs/examples/button/CreateProject.tsx +1 -1
  804. package/docs/examples/button/FillSidebar.tsx +1 -1
  805. package/docs/examples/button/Icons.tsx +2 -2
  806. package/docs/examples/button/PictureBeforeLabel.tsx +14 -0
  807. package/docs/examples/card/CardAnatomy.tsx +3 -1
  808. package/docs/examples/card/OpenFromCard.tsx +65 -0
  809. package/docs/examples/code/PackageManagers.tsx +35 -0
  810. package/docs/examples/code/SettingsDiff.tsx +5 -9
  811. package/docs/examples/color-picker/TextColorInToolbar.tsx +44 -0
  812. package/docs/examples/colors/Status.tsx +6 -6
  813. package/docs/examples/command-palette/CommandPaletteAnatomy.tsx +11 -5
  814. package/docs/examples/command-palette/GoToDocument.tsx +17 -14
  815. package/docs/examples/command-palette/NarrowSidebar.tsx +1 -1
  816. package/docs/examples/command-palette/RunCommand.tsx +16 -12
  817. package/docs/examples/command-palette/SearchButton.tsx +2 -2
  818. package/docs/examples/command-palette/TypeToSearch.tsx +2 -2
  819. package/docs/examples/composer/AttachmentsAndVoice.tsx +30 -0
  820. package/docs/examples/confirm-dialog/FromMenu.tsx +1 -1
  821. package/docs/examples/date-picker/PresetsAndBusyDays.tsx +61 -0
  822. package/docs/examples/dialog/EditMember.tsx +28 -0
  823. package/docs/examples/dialog/FindPlan.tsx +1 -1
  824. package/docs/examples/document-tabs/DocumentTabsAnatomy.tsx +2 -2
  825. package/docs/examples/document-tabs/EditorTabs.tsx +57 -0
  826. package/docs/examples/document-tabs/OpenDocuments.tsx +2 -2
  827. package/docs/examples/drop-zone/FilesInsideTheZone.tsx +40 -0
  828. package/docs/examples/empty-state/WithIllustration.tsx +22 -0
  829. package/docs/examples/graphic/Colors.tsx +1 -1
  830. package/docs/examples/graphic/SignInWithLogo.tsx +1 -1
  831. package/docs/examples/halo/AroundACard.tsx +14 -0
  832. package/docs/examples/halo/InviteTeam.tsx +15 -0
  833. package/docs/examples/halo/Tones.tsx +14 -0
  834. package/docs/examples/icons/FollowText.tsx +3 -3
  835. package/docs/examples/kbd/Sequences.tsx +10 -0
  836. package/docs/examples/list/TitleActions.tsx +32 -0
  837. package/docs/examples/menu/AccountSwitcher.tsx +32 -0
  838. package/docs/examples/menu/Choices.tsx +1 -1
  839. package/docs/examples/menu/ContextMenuForRows.tsx +3 -3
  840. package/docs/examples/menu/Destinations.tsx +5 -5
  841. package/docs/examples/menu/GroupsAndSeparators.tsx +6 -6
  842. package/docs/examples/menu/IconsAndShortcuts.tsx +5 -5
  843. package/docs/examples/menu/MenuAnatomy.tsx +3 -3
  844. package/docs/examples/menu/Submenus.tsx +4 -4
  845. package/docs/examples/menubar/NotesMenubar.tsx +4 -4
  846. package/docs/examples/message/CommentThread.tsx +30 -0
  847. package/docs/examples/message/Conversation.tsx +7 -2
  848. package/docs/examples/meter/InlineUsage.tsx +10 -0
  849. package/docs/examples/navigation-drawer/ActivityBar.tsx +26 -0
  850. package/docs/examples/navigation-drawer/GroupActions.tsx +43 -0
  851. package/docs/examples/page/WithBreadcrumbs.tsx +1 -1
  852. package/docs/examples/page/WithHeader.tsx +1 -1
  853. package/docs/examples/page/WithToolbar.tsx +1 -1
  854. package/docs/examples/pager/LongTitles.tsx +2 -2
  855. package/docs/examples/pager/PagerAnatomy.tsx +2 -2
  856. package/docs/examples/pager/PreviousAndNext.tsx +2 -2
  857. package/docs/examples/pager/StepThroughAGuide.tsx +2 -2
  858. package/docs/examples/panes/DocumentAndDetails.tsx +53 -0
  859. package/docs/examples/panes/PanesAnatomy.tsx +20 -12
  860. package/docs/examples/panes/ResizableDetails.tsx +35 -2
  861. package/docs/examples/panes/StackedWhenNarrow.tsx +11 -10
  862. package/docs/examples/popover/DocumentDetails.tsx +1 -1
  863. package/docs/examples/popover/RenameInPlace.tsx +1 -1
  864. package/docs/examples/progress/ExportMembers.tsx +1 -1
  865. package/docs/examples/radio/PlanRows.tsx +35 -0
  866. package/docs/examples/relative-time/PastAndComing.tsx +6 -6
  867. package/docs/examples/relative-time/VersionLabels.tsx +5 -5
  868. package/docs/examples/resize-handle/DockedLogs.tsx +44 -0
  869. package/docs/examples/resize-handle/ResizeHandleAnatomy.tsx +22 -22
  870. package/docs/examples/row/SectionHeading.tsx +1 -1
  871. package/docs/examples/scaffold/InspectorAndStatus.tsx +63 -0
  872. package/docs/examples/segmented-control/IconOnlyAndBadge.tsx +31 -0
  873. package/docs/examples/segmented-control/SegmentedControlAnatomy.tsx +2 -2
  874. package/docs/examples/segmented-control/SmallToolbar.tsx +4 -4
  875. package/docs/examples/select/Assignee.tsx +29 -0
  876. package/docs/examples/select/SmallToolbar.tsx +23 -21
  877. package/docs/examples/sheet/FilterPanel.tsx +1 -1
  878. package/docs/examples/sheet/ShareChoices.tsx +1 -1
  879. package/docs/examples/slider/IconsAndUnits.tsx +42 -0
  880. package/docs/examples/spacing/Align.tsx +1 -1
  881. package/docs/examples/table/HeaderEndAndTotals.tsx +61 -0
  882. package/docs/examples/table/WorkItemsWithParts.tsx +1 -1
  883. package/docs/examples/table-of-contents/DocsArticle.tsx +16 -11
  884. package/docs/examples/text-field/ContentAffixes.tsx +32 -0
  885. package/docs/examples/text-field/FieldsBesideButtons.tsx +1 -1
  886. package/docs/examples/text-field/IconAndEndAction.tsx +1 -1
  887. package/docs/examples/text-field/TextFieldAnatomy.tsx +1 -1
  888. package/docs/examples/text-field/Variants.tsx +1 -1
  889. package/docs/examples/toast/ExportReady.tsx +7 -5
  890. package/docs/examples/toast/RetryAfterError.tsx +8 -6
  891. package/docs/examples/toast/ToastAnatomy.tsx +1 -1
  892. package/docs/examples/toast/TopCenter.tsx +1 -1
  893. package/docs/examples/toast/UndoArchive.tsx +10 -8
  894. package/docs/examples/toolbar/LabelledControls.tsx +40 -0
  895. package/docs/examples/tooltip/MenuTrigger.tsx +2 -2
  896. package/docs/examples/tree/ContextMenuActions.tsx +5 -5
  897. package/docs/examples/tree/FileTree.tsx +1 -1
  898. package/docs/examples/tree/MatchedLetters.tsx +37 -0
  899. package/docs/examples/tree/NarrowTree.tsx +3 -3
  900. package/docs/examples/tree/RowDensity.tsx +6 -6
  901. package/docs/examples/tree/TreeAnatomy.tsx +2 -2
  902. package/docs/foundations/accessibility.md +3 -3
  903. package/docs/foundations/colors.md +2 -3
  904. package/docs/foundations/icons.md +3 -3
  905. package/docs/foundations/responsive.md +2 -2
  906. package/docs/foundations/spacing.md +2 -2
  907. package/docs/foundations/typography.md +2 -2
  908. package/docs/generated/exports.json +34 -52
  909. package/docs/generated/parts.json +469 -484
  910. package/docs/generated/props.json +1053 -903
  911. package/docs/index.md +52 -56
  912. package/docs/setup.md +62 -20
  913. package/docs/writing.md +1 -1
  914. package/package.json +6 -25
  915. package/dist/actions/internal/MenuPopup.js.map +0 -7
  916. package/dist/assets/readme/gallery-dark.png +0 -0
  917. package/dist/assets/readme/gallery-light.png +0 -0
  918. package/dist/content/MarkdownEditor.d.ts +0 -35
  919. package/dist/content/MarkdownEditor.js +0 -236
  920. package/dist/content/MarkdownEditor.js.map +0 -7
  921. package/dist/content/internal/markdown/MarkdownPreview.d.ts +0 -9
  922. package/dist/content/internal/markdown/MarkdownPreview.js +0 -30
  923. package/dist/content/internal/markdown/MarkdownPreview.js.map +0 -7
  924. package/dist/content/internal/markdown/markdownFormatting.d.ts +0 -15
  925. package/dist/content/internal/markdown/markdownFormatting.js +0 -96
  926. package/dist/content/internal/markdown/markdownFormatting.js.map +0 -7
  927. package/dist/content/internal/markdown/markdownHistory.d.ts +0 -10
  928. package/dist/content/internal/markdown/markdownHistory.js +0 -54
  929. package/dist/content/internal/markdown/markdownHistory.js.map +0 -7
  930. package/dist/content/internal/markdown/useMarkdownEditing.d.ts +0 -19
  931. package/dist/content/internal/markdown/useMarkdownEditing.js +0 -127
  932. package/dist/content/internal/markdown/useMarkdownEditing.js.map +0 -7
  933. package/dist/content/internal/markdown/useMarkdownLink.d.ts +0 -22
  934. package/dist/content/internal/markdown/useMarkdownLink.js +0 -73
  935. package/dist/content/internal/markdown/useMarkdownLink.js.map +0 -7
  936. package/dist/data-display/AnimatedNumber.d.ts +0 -15
  937. package/dist/data-display/AnimatedNumber.js +0 -111
  938. package/dist/data-display/AnimatedNumber.js.map +0 -7
  939. package/dist/data-display/CalendarHeatmap.d.ts +0 -92
  940. package/dist/data-display/CalendarHeatmap.js +0 -224
  941. package/dist/data-display/CalendarHeatmap.js.map +0 -7
  942. package/dist/data-display/DiffStat.d.ts +0 -23
  943. package/dist/data-display/DiffStat.js +0 -42
  944. package/dist/data-display/DiffStat.js.map +0 -7
  945. package/dist/data-display/Rating.d.ts +0 -32
  946. package/dist/data-display/Rating.js +0 -45
  947. package/dist/data-display/Rating.js.map +0 -7
  948. package/dist/data-display/internal/ListRows.js.map +0 -7
  949. package/dist/data-display/internal/calendarHeatmapModel.d.ts +0 -44
  950. package/dist/data-display/internal/calendarHeatmapModel.js +0 -133
  951. package/dist/data-display/internal/calendarHeatmapModel.js.map +0 -7
  952. package/dist/data-display/internal/useHeatmapLabels.d.ts +0 -16
  953. package/dist/data-display/internal/useHeatmapLabels.js +0 -56
  954. package/dist/data-display/internal/useHeatmapLabels.js.map +0 -7
  955. package/dist/data-display/internal/useHeatmapTooltip.d.ts +0 -24
  956. package/dist/data-display/internal/useHeatmapTooltip.js +0 -142
  957. package/dist/data-display/internal/useHeatmapTooltip.js.map +0 -7
  958. package/dist/dev/api.d.ts +0 -64
  959. package/dist/dev/api.js +0 -88
  960. package/dist/dev/api.js.map +0 -7
  961. package/dist/dev/elements.d.ts +0 -7
  962. package/dist/dev/elements.js +0 -32
  963. package/dist/dev/elements.js.map +0 -7
  964. package/dist/dev/inner.d.ts +0 -17
  965. package/dist/dev/inner.js +0 -139
  966. package/dist/dev/inner.js.map +0 -7
  967. package/dist/dev/install.d.ts +0 -64
  968. package/dist/dev/install.js +0 -128
  969. package/dist/dev/install.js.map +0 -7
  970. package/dist/dev/measure.d.ts +0 -10
  971. package/dist/dev/measure.js +0 -304
  972. package/dist/dev/measure.js.map +0 -7
  973. package/dist/dev/model.d.ts +0 -136
  974. package/dist/dev/model.js +0 -5
  975. package/dist/dev/model.js.map +0 -7
  976. package/dist/dev/overlays.d.ts +0 -5
  977. package/dist/dev/overlays.js +0 -52
  978. package/dist/dev/overlays.js.map +0 -7
  979. package/dist/dev/parts.d.ts +0 -49
  980. package/dist/dev/parts.js +0 -89
  981. package/dist/dev/parts.js.map +0 -7
  982. package/dist/dev/queries.d.ts +0 -28
  983. package/dist/dev/queries.js +0 -135
  984. package/dist/dev/queries.js.map +0 -7
  985. package/dist/dev/readout.d.ts +0 -9
  986. package/dist/dev/readout.js +0 -275
  987. package/dist/dev/readout.js.map +0 -7
  988. package/dist/dev/skeletonShift.d.ts +0 -6
  989. package/dist/dev/skeletonShift.js +0 -174
  990. package/dist/dev/skeletonShift.js.map +0 -7
  991. package/dist/dev/ui/Controls.d.ts +0 -20
  992. package/dist/dev/ui/Controls.js +0 -53
  993. package/dist/dev/ui/Controls.js.map +0 -7
  994. package/dist/dev/ui/DevMode.d.ts +0 -14
  995. package/dist/dev/ui/DevMode.js +0 -222
  996. package/dist/dev/ui/DevMode.js.map +0 -7
  997. package/dist/dev/ui/Frame.d.ts +0 -14
  998. package/dist/dev/ui/Frame.js +0 -178
  999. package/dist/dev/ui/Frame.js.map +0 -7
  1000. package/dist/dev/ui/Icons.d.ts +0 -5
  1001. package/dist/dev/ui/Icons.js +0 -38
  1002. package/dist/dev/ui/Icons.js.map +0 -7
  1003. package/dist/dev/ui/Inspector.d.ts +0 -24
  1004. package/dist/dev/ui/Inspector.js +0 -366
  1005. package/dist/dev/ui/Inspector.js.map +0 -7
  1006. package/dist/dev/ui/Legend.d.ts +0 -4
  1007. package/dist/dev/ui/Legend.js +0 -50
  1008. package/dist/dev/ui/Legend.js.map +0 -7
  1009. package/dist/dev/ui/NodeHints.d.ts +0 -15
  1010. package/dist/dev/ui/NodeHints.js +0 -95
  1011. package/dist/dev/ui/NodeHints.js.map +0 -7
  1012. package/dist/dev/ui/PerformancePanel.d.ts +0 -3
  1013. package/dist/dev/ui/PerformancePanel.js +0 -72
  1014. package/dist/dev/ui/PerformancePanel.js.map +0 -7
  1015. package/dist/dev/ui/Plane.d.ts +0 -37
  1016. package/dist/dev/ui/Plane.js +0 -154
  1017. package/dist/dev/ui/Plane.js.map +0 -7
  1018. package/dist/dev/ui/View3D.d.ts +0 -19
  1019. package/dist/dev/ui/View3D.js +0 -248
  1020. package/dist/dev/ui/View3D.js.map +0 -7
  1021. package/dist/dev/ui/ViewToolbar.d.ts +0 -40
  1022. package/dist/dev/ui/ViewToolbar.js +0 -352
  1023. package/dist/dev/ui/ViewToolbar.js.map +0 -7
  1024. package/dist/dev/ui/camera.d.ts +0 -42
  1025. package/dist/dev/ui/camera.js +0 -157
  1026. package/dist/dev/ui/camera.js.map +0 -7
  1027. package/dist/dev/ui/devices.d.ts +0 -9
  1028. package/dist/dev/ui/devices.js +0 -34
  1029. package/dist/dev/ui/devices.js.map +0 -7
  1030. package/dist/dev/ui/editorTheme.d.ts +0 -6
  1031. package/dist/dev/ui/editorTheme.js +0 -30
  1032. package/dist/dev/ui/editorTheme.js.map +0 -7
  1033. package/dist/dev/ui/sides.d.ts +0 -20
  1034. package/dist/dev/ui/sides.js +0 -43
  1035. package/dist/dev/ui/sides.js.map +0 -7
  1036. package/dist/dev/ui/stats.d.ts +0 -25
  1037. package/dist/dev/ui/stats.js +0 -26
  1038. package/dist/dev/ui/stats.js.map +0 -7
  1039. package/dist/dev/ui/surfaces.d.ts +0 -4
  1040. package/dist/dev/ui/surfaces.js +0 -249
  1041. package/dist/dev/ui/surfaces.js.map +0 -7
  1042. package/dist/dev/ui/useLivePage.d.ts +0 -13
  1043. package/dist/dev/ui/useLivePage.js +0 -138
  1044. package/dist/dev/ui/useLivePage.js.map +0 -7
  1045. package/dist/dev/ui/usePlaneHover.d.ts +0 -9
  1046. package/dist/dev/ui/usePlaneHover.js +0 -46
  1047. package/dist/dev/ui/usePlaneHover.js.map +0 -7
  1048. package/dist/dev/ui/useViewFit.d.ts +0 -16
  1049. package/dist/dev/ui/useViewFit.js +0 -59
  1050. package/dist/dev/ui/useViewFit.js.map +0 -7
  1051. package/dist/dev/ui/useViewWheel.d.ts +0 -11
  1052. package/dist/dev/ui/useViewWheel.js +0 -48
  1053. package/dist/dev/ui/useViewWheel.js.map +0 -7
  1054. package/dist/dev/ui/wheel.d.ts +0 -7
  1055. package/dist/dev/ui/wheel.js +0 -98
  1056. package/dist/dev/ui/wheel.js.map +0 -7
  1057. package/dist/dev/units.d.ts +0 -7
  1058. package/dist/dev/units.js +0 -22
  1059. package/dist/dev/units.js.map +0 -7
  1060. package/dist/dev/usedTokens.d.ts +0 -5
  1061. package/dist/dev/usedTokens.js +0 -56
  1062. package/dist/dev/usedTokens.js.map +0 -7
  1063. package/dist/dev.d.ts +0 -5
  1064. package/dist/dev.js +0 -9
  1065. package/dist/dev.js.map +0 -7
  1066. package/dist/feedback/toast/internal/PictureNotice.js.map +0 -7
  1067. package/dist/forms/color/internal/useColorState.d.ts +0 -10
  1068. package/dist/forms/color/internal/useColorState.js +0 -49
  1069. package/dist/forms/color/internal/useColorState.js.map +0 -7
  1070. package/dist/forms/internal/usePickerValue.d.ts +0 -13
  1071. package/dist/forms/internal/usePickerValue.js +0 -45
  1072. package/dist/forms/internal/usePickerValue.js.map +0 -7
  1073. package/dist/forms/internal/useRovingFocus.d.ts +0 -47
  1074. package/dist/forms/internal/useRovingFocus.js +0 -179
  1075. package/dist/forms/internal/useRovingFocus.js.map +0 -7
  1076. package/dist/forms/rich-text/RichText.d.ts +0 -7
  1077. package/dist/forms/rich-text/RichText.js +0 -91
  1078. package/dist/forms/rich-text/RichText.js.map +0 -7
  1079. package/dist/forms/rich-text/RichTextEditor.d.ts +0 -9
  1080. package/dist/forms/rich-text/RichTextEditor.js +0 -225
  1081. package/dist/forms/rich-text/RichTextEditor.js.map +0 -7
  1082. package/dist/forms/rich-text/extensions.d.ts +0 -10
  1083. package/dist/forms/rich-text/extensions.js +0 -45
  1084. package/dist/forms/rich-text/extensions.js.map +0 -7
  1085. package/dist/forms/rich-text/internal/Listbox.d.ts +0 -10
  1086. package/dist/forms/rich-text/internal/Listbox.js +0 -48
  1087. package/dist/forms/rich-text/internal/Listbox.js.map +0 -7
  1088. package/dist/forms/rich-text/internal/Reference.d.ts +0 -13
  1089. package/dist/forms/rich-text/internal/Reference.js +0 -79
  1090. package/dist/forms/rich-text/internal/Reference.js.map +0 -7
  1091. package/dist/forms/rich-text/internal/commands.d.ts +0 -6
  1092. package/dist/forms/rich-text/internal/commands.js +0 -74
  1093. package/dist/forms/rich-text/internal/commands.js.map +0 -7
  1094. package/dist/forms/rich-text/internal/readOnlyCheckbox.d.ts +0 -6
  1095. package/dist/forms/rich-text/internal/readOnlyCheckbox.js +0 -9
  1096. package/dist/forms/rich-text/internal/readOnlyCheckbox.js.map +0 -7
  1097. package/dist/forms/rich-text/internal/referenceAttributes.d.ts +0 -3
  1098. package/dist/forms/rich-text/internal/referenceAttributes.js +0 -23
  1099. package/dist/forms/rich-text/internal/referenceAttributes.js.map +0 -7
  1100. package/dist/forms/rich-text/internal/referenceExtension.d.ts +0 -2
  1101. package/dist/forms/rich-text/internal/referenceExtension.js +0 -103
  1102. package/dist/forms/rich-text/internal/referenceExtension.js.map +0 -7
  1103. package/dist/forms/rich-text/internal/suggestions.d.ts +0 -16
  1104. package/dist/forms/rich-text/internal/suggestions.js +0 -185
  1105. package/dist/forms/rich-text/internal/suggestions.js.map +0 -7
  1106. package/dist/forms/rich-text/internal/taskItem.d.ts +0 -1
  1107. package/dist/forms/rich-text/internal/taskItem.js +0 -43
  1108. package/dist/forms/rich-text/internal/taskItem.js.map +0 -7
  1109. package/dist/forms/rich-text/internal/useDocumentAttributes.d.ts +0 -13
  1110. package/dist/forms/rich-text/internal/useDocumentAttributes.js +0 -42
  1111. package/dist/forms/rich-text/internal/useDocumentAttributes.js.map +0 -7
  1112. package/dist/forms/rich-text/internal/useLinksAndUploads.d.ts +0 -19
  1113. package/dist/forms/rich-text/internal/useLinksAndUploads.js +0 -141
  1114. package/dist/forms/rich-text/internal/useLinksAndUploads.js.map +0 -7
  1115. package/dist/forms/rich-text/internal/useRichTextDocument.d.ts +0 -26
  1116. package/dist/forms/rich-text/internal/useRichTextDocument.js +0 -101
  1117. package/dist/forms/rich-text/internal/useRichTextDocument.js.map +0 -7
  1118. package/dist/forms/rich-text/internal/useRichTextExtensions.d.ts +0 -13
  1119. package/dist/forms/rich-text/internal/useRichTextExtensions.js +0 -85
  1120. package/dist/forms/rich-text/internal/useRichTextExtensions.js.map +0 -7
  1121. package/dist/forms/rich-text/types.d.ts +0 -190
  1122. package/dist/forms/rich-text/types.js +0 -1
  1123. package/dist/foundations/SkeletonScope.js.map +0 -7
  1124. package/dist/foundations/ThemePreference.d.ts +0 -35
  1125. package/dist/foundations/ThemePreference.js.map +0 -7
  1126. package/dist/foundations/internal/skeletonText.js.map +0 -7
  1127. package/dist/foundations/messages/calendarHeatmap.d.ts +0 -10
  1128. package/dist/foundations/messages/calendarHeatmap.js +0 -10
  1129. package/dist/foundations/messages/calendarHeatmap.js.map +0 -7
  1130. package/dist/foundations/messages/diffStat.d.ts +0 -16
  1131. package/dist/foundations/messages/diffStat.js +0 -17
  1132. package/dist/foundations/messages/diffStat.js.map +0 -7
  1133. package/dist/foundations/messages/editor.d.ts +0 -35
  1134. package/dist/foundations/messages/editor.js +0 -34
  1135. package/dist/foundations/messages/editor.js.map +0 -7
  1136. package/dist/foundations/messages/linkDialog.d.ts +0 -20
  1137. package/dist/foundations/messages/linkDialog.js +0 -20
  1138. package/dist/foundations/messages/linkDialog.js.map +0 -7
  1139. package/dist/foundations/messages/markdownEditor.d.ts +0 -26
  1140. package/dist/foundations/messages/markdownEditor.js +0 -26
  1141. package/dist/foundations/messages/markdownEditor.js.map +0 -7
  1142. package/dist/foundations/messages/rating.d.ts +0 -11
  1143. package/dist/foundations/messages/rating.js +0 -8
  1144. package/dist/foundations/messages/rating.js.map +0 -7
  1145. package/dist/foundations/messages/richText.d.ts +0 -34
  1146. package/dist/foundations/messages/richText.js +0 -34
  1147. package/dist/foundations/messages/richText.js.map +0 -7
  1148. package/dist/internal/dialog/DialogParts.d.ts +0 -46
  1149. package/dist/internal/dialog/DialogParts.js +0 -66
  1150. package/dist/internal/dialog/DialogParts.js.map +0 -7
  1151. package/dist/internal/dom/paints.d.ts +0 -5
  1152. package/dist/internal/dom/paints.js +0 -17
  1153. package/dist/internal/dom/paints.js.map +0 -7
  1154. package/dist/internal/dom/useStripWheel.d.ts +0 -6
  1155. package/dist/internal/dom/useStripWheel.js +0 -26
  1156. package/dist/internal/dom/useStripWheel.js.map +0 -7
  1157. package/dist/internal/editor/EditorStatus.d.ts +0 -8
  1158. package/dist/internal/editor/EditorStatus.js +0 -11
  1159. package/dist/internal/editor/EditorStatus.js.map +0 -7
  1160. package/dist/internal/editor/EditorToolbar.d.ts +0 -28
  1161. package/dist/internal/editor/EditorToolbar.js +0 -89
  1162. package/dist/internal/editor/EditorToolbar.js.map +0 -7
  1163. package/dist/internal/editor/LinkDialog.d.ts +0 -20
  1164. package/dist/internal/editor/LinkDialog.js +0 -78
  1165. package/dist/internal/editor/LinkDialog.js.map +0 -7
  1166. package/dist/internal/editor/editorCommands.d.ts +0 -20
  1167. package/dist/internal/editor/editorCommands.js +0 -45
  1168. package/dist/internal/editor/editorCommands.js.map +0 -7
  1169. package/dist/internal/field/TextareaResizeEdge.js.map +0 -7
  1170. package/dist/internal/field/rowControl.js.map +0 -7
  1171. package/dist/internal/field/useFieldMetadata.d.ts +0 -16
  1172. package/dist/internal/field/useFieldMetadata.js +0 -24
  1173. package/dist/internal/field/useFieldMetadata.js.map +0 -7
  1174. package/dist/internal/list/ListRow.d.ts +0 -33
  1175. package/dist/internal/list/ListRow.js.map +0 -7
  1176. package/dist/internal/popup/PortalContainerContext.js.map +0 -7
  1177. package/dist/internal/react/useStackedReport.js +0 -28
  1178. package/dist/internal/react/useStackedReport.js.map +0 -7
  1179. package/dist/internal/skeleton.js.map +0 -7
  1180. package/dist/internal/time/calendarDays.js.map +0 -7
  1181. package/dist/layout/internal/navigationForms.js.map +0 -7
  1182. package/dist/layout/internal/scrollKeys.js.map +0 -7
  1183. package/dist/layout/internal/useNavigationFocusHandoff.js.map +0 -7
  1184. package/dist/layout/internal/useScrollKeys.js.map +0 -7
  1185. package/dist/layout/panesSize.d.ts +0 -13
  1186. package/dist/layout/panesSize.js +0 -39
  1187. package/dist/layout/panesSize.js.map +0 -7
  1188. package/dist/navigation/internal/TreeRow.js.map +0 -7
  1189. package/dist/navigation/internal/contentsOutline.d.ts +0 -60
  1190. package/dist/navigation/internal/contentsOutline.js.map +0 -7
  1191. package/dist/navigation/internal/contentsWave.js.map +0 -7
  1192. package/dist/navigation/internal/sectionScroll.js.map +0 -7
  1193. package/dist/navigation/internal/tabStrip.d.ts +0 -6
  1194. package/dist/navigation/internal/tabStrip.js +0 -24
  1195. package/dist/navigation/internal/tabStrip.js.map +0 -7
  1196. package/dist/navigation/internal/treeModel.js.map +0 -7
  1197. package/dist/navigation/internal/useContentsHeadings.js.map +0 -7
  1198. package/dist/navigation/internal/useTabCloseFocus.js.map +0 -7
  1199. package/dist/navigation/internal/useTabDrag.js.map +0 -7
  1200. package/dist/navigation/internal/useTabStripScrolling.js.map +0 -7
  1201. package/dist/navigation/internal/useTreeTransitions.js.map +0 -7
  1202. package/dist/navigation/internal/useTreeViewport.js.map +0 -7
  1203. package/dist/navigation/internal/waveDrawer.js.map +0 -7
  1204. package/dist/overlays/internal/DialogPendingAction.js.map +0 -7
  1205. package/dist/rich-text.d.ts +0 -5
  1206. package/dist/rich-text.js +0 -9
  1207. package/dist/rich-text.js.map +0 -7
  1208. package/dist/styles/CalendarHeatmap.css +0 -1
  1209. package/dist/styles/Editor.css +0 -1
  1210. package/dist/styles/Listbox.css +0 -1
  1211. package/dist/styles/MarkdownEditor.css +0 -1
  1212. package/dist/styles/Rating.css +0 -1
  1213. package/dist/styles/RichText.css +0 -1
  1214. package/docs/components/animated-number.md +0 -72
  1215. package/docs/components/calendar-heatmap.md +0 -140
  1216. package/docs/components/rating.md +0 -84
  1217. package/docs/components/rich-text.md +0 -224
  1218. package/docs/dev-mode.md +0 -59
  1219. package/docs/examples/animated-number/AnimatedNumberAnatomy.tsx +0 -9
  1220. package/docs/examples/animated-number/CustomFormat.tsx +0 -28
  1221. package/docs/examples/animated-number/ShowResults.tsx +0 -38
  1222. package/docs/examples/badge/ChangeSize.tsx +0 -21
  1223. package/docs/examples/calendar-heatmap/ApplicationStrings.tsx +0 -23
  1224. package/docs/examples/calendar-heatmap/ColorByRank.tsx +0 -26
  1225. package/docs/examples/calendar-heatmap/CustomTooltip.tsx +0 -26
  1226. package/docs/examples/calendar-heatmap/Deployments.tsx +0 -22
  1227. package/docs/examples/calendar-heatmap/HeatmapAnatomy.tsx +0 -10
  1228. package/docs/examples/calendar-heatmap/ScrollingWeeks.tsx +0 -10
  1229. package/docs/examples/markdown/LinkPicker.tsx +0 -65
  1230. package/docs/examples/markdown/MarkdownEditorAnatomy.tsx +0 -13
  1231. package/docs/examples/markdown/WriteNote.tsx +0 -21
  1232. package/docs/examples/panes/ListAndDetail.tsx +0 -55
  1233. package/docs/examples/rating/RatingAnatomy.tsx +0 -5
  1234. package/docs/examples/rating/ReviewScore.tsx +0 -13
  1235. package/docs/examples/rating/Scales.tsx +0 -11
  1236. package/docs/examples/resize-handle/ProjectSidebar.tsx +0 -40
  1237. package/docs/examples/rich-text/MeetingNotes.tsx +0 -14
  1238. package/docs/examples/rich-text/References.tsx +0 -47
  1239. package/docs/examples/rich-text/RichTextAnatomy.tsx +0 -18
  1240. package/docs/examples/rich-text/SavedContent.tsx +0 -33
  1241. package/docs/examples/rich-text/SlashCommands.tsx +0 -24
  1242. package/docs/examples/rich-text/UploadsAndLinks.tsx +0 -36
  1243. /package/dist/actions/{internal → menu/internal}/menuOpenChange.js +0 -0
  1244. /package/dist/actions/{internal → menu/internal}/menuOpenChange.js.map +0 -0
  1245. /package/dist/{forms/rich-text/types.js.map → actions/menu/internal/menuTriggerProps.js.map} +0 -0
  1246. /package/dist/forms/color/internal/{colorChange.d.ts → ColorChangeContext.d.ts} +0 -0
  1247. /package/dist/internal/{useCopy.d.ts → react/useCopy.d.ts} +0 -0
  1248. /package/dist/internal/{useCopy.js → react/useCopy.js} +0 -0
  1249. /package/dist/internal/{useLatest.d.ts → react/useLatest.d.ts} +0 -0
  1250. /package/dist/internal/{useLatest.js → react/useLatest.js} +0 -0
  1251. /package/dist/{foundations/internal → internal/skeleton}/skeletonText.d.ts +0 -0
  1252. /package/dist/layout/internal/{navigationForms.js → scaffold/navigationForms.js} +0 -0
  1253. /package/dist/layout/internal/{scaffoldFocus.d.ts → scaffold/scaffoldFocus.d.ts} +0 -0
  1254. /package/dist/layout/internal/{scaffoldFocus.js → scaffold/scaffoldFocus.js} +0 -0
  1255. /package/dist/layout/internal/{scrollKeys.d.ts → scaffold/scrollKeys.d.ts} +0 -0
  1256. /package/dist/layout/internal/{useNavigationFocusHandoff.d.ts → scaffold/useNavigationFocusHandoff.d.ts} +0 -0
  1257. /package/dist/layout/internal/{useScrollKeys.d.ts → scaffold/useScrollKeys.d.ts} +0 -0
  1258. /package/dist/navigation/internal/{useTabCloseFocus.d.ts → documentTabs/useTabCloseFocus.d.ts} +0 -0
  1259. /package/dist/navigation/internal/{useTabStripScrolling.d.ts → documentTabs/useTabStripScrolling.d.ts} +0 -0
  1260. /package/dist/navigation/internal/{contentsWave.d.ts → tableOfContents/contentsWave.d.ts} +0 -0
  1261. /package/dist/navigation/internal/{waveDrawer.d.ts → tableOfContents/waveDrawer.d.ts} +0 -0
  1262. /package/dist/navigation/internal/{useTreeTransitions.js → tree/useTreeTransitions.js} +0 -0
  1263. /package/dist/styles/{TextareaResizeEdge.css → TextareaResizeHandle.css} +0 -0
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/navigation/NavigationRail.tsx"],
4
- "sourcesContent": ["'use client';\n\nimport type { ComponentPropsWithRef, ReactNode } from 'react';\nimport { Column } from '../layout/Layout.js';\nimport { Slot } from '../internal/layout/Slot.js';\nimport { classNames } from '../internal/classNames.js';\nimport { inSkeleton, skeletonAttributes, type SkeletonProps } from '../internal/skeleton.js';\nimport {\n destinationKey,\n DestinationItem,\n useNavigationMessages,\n type DestinationClasses,\n} from './internal/DestinationItem.js';\nimport type { Destination } from './destinations.js';\nimport { backgroundAttribute, type NavigationBackground } from './navigationBackground.js';\nimport '../styles/Base.css';\nimport '../styles/NavigationRail.css';\n\nconst railClasses: DestinationClasses = {\n item: 'env-navigation-rail-item',\n indicator: 'env-navigation-rail-indicator',\n label: 'env-navigation-rail-label',\n count: 'env-navigation-rail-count',\n};\n\nexport interface NavigationRailProps\n extends Omit<ComponentPropsWithRef<'nav'>, 'children'>, SkeletonProps {\n /**\n * The application's destinations, the same array NavigationBar and NavigationDrawer take, each an icon above a short\n * label. Groups don't show: the destinations follow one another in the array's order. Nested\n * destinations don't show either: a destination whose `children` hold the current one takes the\n * current fill.\n */\n destinations: readonly Destination[];\n /**\n * Content above the destinations, such as a button that opens a Sheet with the NavigationDrawer, or the\n * main action of the page.\n */\n header?: ReactNode;\n /** Content at the bottom of the rail, such as the account's AvatarButton. */\n footer?: ReactNode;\n /**\n * The rail's background, named as Surface's and Card's: default, the default surface color, the\n * app frame's own fill that stands apart from the page; page, the page's background, the same as\n * the content beside it, from which a Scaffold sets it apart with a hairline. On a surface, such\n * as a Sheet, both take the surface's color.\n * @default 'default'\n */\n background?: NavigationBackground;\n /**\n * Names the navigation landmark, such as Main or Project; give each landmark of a page its own.\n * @default messages.navigation.label, Main\n */\n 'aria-label'?: string;\n}\n\n/**\n * The navigation rail for medium windows, such as tablets: a narrow column at the window's start\n * with the destinations one under another, each an icon above a short label. A `nav` landmark; the\n * current destination reports aria-current=\"page\", and every destination is a tab stop.\n */\nexport function NavigationRail({\n destinations,\n header,\n footer,\n background = 'default',\n 'aria-label': label,\n 'aria-labelledby': labelledBy,\n skeleton = false,\n className,\n ...props\n}: NavigationRailProps) {\n const messages = useNavigationMessages();\n return (\n <Column\n render={<nav />}\n {...props}\n aria-label={label ?? (labelledBy === undefined ? messages.label : undefined)}\n aria-labelledby={labelledBy}\n {...skeletonAttributes(skeleton)}\n className={classNames('env-navigation-rail', className)}\n data-background={backgroundAttribute(background)}\n align=\"center\"\n gap={4}\n >\n {inSkeleton(\n skeleton,\n <>\n {header != null && <Slot className=\"env-navigation-rail-header\">{header}</Slot>}\n <Column render={<ul />} className=\"env-navigation-rail-list\" align=\"stretch\" gap={1}>\n {destinations.map((destination) => (\n <li key={destinationKey(destination)}>\n <DestinationItem classes={railClasses} destination={destination} topLevel />\n </li>\n ))}\n </Column>\n {footer != null && <Slot className=\"env-navigation-rail-footer\">{footer}</Slot>}\n </>,\n )}\n </Column>\n );\n}\n"],
5
- "mappings": ";AA2Ec,SAYN,UAZM,KAYN,YAZM;AAxEd,SAAS,cAAc;AACvB,SAAS,YAAY;AACrB,SAAS,kBAAkB;AAC3B,SAAS,YAAY,0BAA8C;AACnE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAEP,SAAS,2BAAsD;AAC/D,OAAO;AACP,OAAO;AAEP,MAAM,cAAkC;AAAA,EACtC,MAAM;AAAA,EACN,WAAW;AAAA,EACX,OAAO;AAAA,EACP,OAAO;AACT;AAsCO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb,cAAc;AAAA,EACd,mBAAmB;AAAA,EACnB,WAAW;AAAA,EACX;AAAA,EACA,GAAG;AACL,GAAwB;AACtB,QAAM,WAAW,sBAAsB;AACvC,SACE;AAAA,IAAC;AAAA;AAAA,MACC,QAAQ,oBAAC,SAAI;AAAA,MACZ,GAAG;AAAA,MACJ,cAAY,UAAU,eAAe,SAAY,SAAS,QAAQ;AAAA,MAClE,mBAAiB;AAAA,MAChB,GAAG,mBAAmB,QAAQ;AAAA,MAC/B,WAAW,WAAW,uBAAuB,SAAS;AAAA,MACtD,mBAAiB,oBAAoB,UAAU;AAAA,MAC/C,OAAM;AAAA,MACN,KAAK;AAAA,MAEJ;AAAA,QACC;AAAA,QACA,iCACG;AAAA,oBAAU,QAAQ,oBAAC,QAAK,WAAU,8BAA8B,kBAAO;AAAA,UACxE,oBAAC,UAAO,QAAQ,oBAAC,QAAG,GAAI,WAAU,4BAA2B,OAAM,WAAU,KAAK,GAC/E,uBAAa,IAAI,CAAC,gBACjB,oBAAC,QACC,8BAAC,mBAAgB,SAAS,aAAa,aAA0B,UAAQ,MAAC,KADnE,eAAe,WAAW,CAEnC,CACD,GACH;AAAA,UACC,UAAU,QAAQ,oBAAC,QAAK,WAAU,8BAA8B,kBAAO;AAAA,WAC1E;AAAA,MACF;AAAA;AAAA,EACF;AAEJ;",
4
+ "sourcesContent": ["'use client';\n\nimport type { ComponentPropsWithRef, ReactNode } from 'react';\nimport { Column } from '../layout/Layout.js';\nimport { Slot } from '../internal/layout/Slot.js';\nimport { CutLabelTooltip } from '../internal/popup/TooltipPopup.js';\nimport { classNames } from '../internal/classNames.js';\nimport { landmarkLabel } from './internal/landmarkLabel.js';\nimport {\n inSkeleton,\n skeletonAttributes,\n type SkeletonProps,\n} from '../internal/skeleton/skeleton.js';\nimport { useMessages } from '../internal/provider/EnvUIContext.js';\nimport { navigation } from '../foundations/messages/navigation.js';\nimport { DestinationItem, type DestinationClasses } from './internal/DestinationItem.js';\nimport { destinationKey } from './internal/destinationModel.js';\nimport type { Destination } from './destinations.js';\nimport type { NavigationBackground } from './navigationBackground.js';\nimport { flag } from '../internal/flag.js';\nimport '../styles/Base.css';\nimport '../styles/NavigationDestinations.css';\nimport '../styles/NavigationRail.css';\n\nconst railClasses: DestinationClasses = {\n item: 'env-navigation-rail-item',\n indicator: 'env-navigation-rail-indicator',\n label: 'env-navigation-rail-label',\n count: 'env-navigation-rail-count',\n};\n\nexport interface NavigationRailProps\n extends Omit<ComponentPropsWithRef<'nav'>, 'children'>, SkeletonProps {\n /**\n * The application's destinations, the same array NavigationBar and NavigationDrawer take, each an icon above a short\n * label. Groups don't show: the destinations follow one another in the array's order. Nested\n * destinations don't show either: a destination whose `children` hold the current one takes the\n * current fill.\n */\n destinations: readonly Destination[];\n /**\n * Content above the destinations, such as a button that opens a Sheet with the NavigationDrawer, or the\n * main action of the page.\n */\n header?: ReactNode;\n /** Content at the bottom of the rail, such as the account's AvatarButton. */\n footer?: ReactNode;\n /**\n * The rail's background, named as Surface's and Card's: default, the default surface color, the\n * app frame's own fill that stands apart from the page; page, the page's background, the same as\n * the content beside it, from which a Scaffold sets it apart with a hairline. On a surface, such\n * as a Sheet, both take the surface's color.\n * @default 'default'\n */\n background?: NavigationBackground;\n /**\n * Whether the destinations' labels show under their icons. False shows the icons only, for an\n * icon-only rail such as a code editor's activity bar: each label still names its destination\n * and shows in a tooltip on hover and keyboard focus.\n * @default true\n */\n visibleLabel?: boolean;\n /**\n * Names the navigation landmark, such as Main or Project; give each landmark of a page its own.\n * @default messages.navigation.label, Main\n */\n 'aria-label'?: string;\n}\n\n/**\n * The navigation rail for medium windows, such as tablets: a narrow column at the window's start\n * with the destinations one under another, each an icon above a short label. A `nav` landmark; the\n * current destination reports aria-current=\"page\", and every destination is a tab stop.\n */\nexport function NavigationRail({\n destinations,\n header,\n footer,\n background = 'default',\n visibleLabel = true,\n 'aria-label': label,\n 'aria-labelledby': labelledBy,\n skeleton = false,\n className,\n ...props\n}: NavigationRailProps) {\n const messages = useMessages('navigation', navigation);\n return (\n <Column\n render={<nav />}\n {...props}\n aria-label={landmarkLabel(label, labelledBy, messages.label)}\n aria-labelledby={labelledBy}\n {...skeletonAttributes(skeleton)}\n className={classNames('env-navigation-rail', className)}\n data-background={background}\n data-label-hidden={flag(!visibleLabel)}\n align=\"center\"\n gap={4}\n >\n {inSkeleton(\n skeleton,\n <>\n {header != null && <Slot className=\"env-navigation-rail-header\">{header}</Slot>}\n <Column render={<ul />} className=\"env-navigation-rail-list\" align=\"stretch\" gap={1}>\n {destinations.map((destination) => {\n const item = (\n <DestinationItem classes={railClasses} destination={destination} topLevel />\n );\n return (\n <li key={destinationKey(destination)}>\n {!visibleLabel ? (\n <CutLabelTooltip cut label={destination.label} side=\"inline-end\">\n {item}\n </CutLabelTooltip>\n ) : (\n item\n )}\n </li>\n );\n })}\n </Column>\n {footer != null && <Slot className=\"env-navigation-rail-footer\">{footer}</Slot>}\n </>,\n )}\n </Column>\n );\n}\n"],
5
+ "mappings": ";AAyFc,SAaN,UAbM,KAaN,YAbM;AAtFd,SAAS,cAAc;AACvB,SAAS,YAAY;AACrB,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAC3B,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,SAAS,mBAAmB;AAC5B,SAAS,kBAAkB;AAC3B,SAAS,uBAAgD;AACzD,SAAS,sBAAsB;AAG/B,SAAS,YAAY;AACrB,OAAO;AACP,OAAO;AACP,OAAO;AAEP,MAAM,cAAkC;AAAA,EACtC,MAAM;AAAA,EACN,WAAW;AAAA,EACX,OAAO;AAAA,EACP,OAAO;AACT;AA6CO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb,eAAe;AAAA,EACf,cAAc;AAAA,EACd,mBAAmB;AAAA,EACnB,WAAW;AAAA,EACX;AAAA,EACA,GAAG;AACL,GAAwB;AACtB,QAAM,WAAW,YAAY,cAAc,UAAU;AACrD,SACE;AAAA,IAAC;AAAA;AAAA,MACC,QAAQ,oBAAC,SAAI;AAAA,MACZ,GAAG;AAAA,MACJ,cAAY,cAAc,OAAO,YAAY,SAAS,KAAK;AAAA,MAC3D,mBAAiB;AAAA,MAChB,GAAG,mBAAmB,QAAQ;AAAA,MAC/B,WAAW,WAAW,uBAAuB,SAAS;AAAA,MACtD,mBAAiB;AAAA,MACjB,qBAAmB,KAAK,CAAC,YAAY;AAAA,MACrC,OAAM;AAAA,MACN,KAAK;AAAA,MAEJ;AAAA,QACC;AAAA,QACA,iCACG;AAAA,oBAAU,QAAQ,oBAAC,QAAK,WAAU,8BAA8B,kBAAO;AAAA,UACxE,oBAAC,UAAO,QAAQ,oBAAC,QAAG,GAAI,WAAU,4BAA2B,OAAM,WAAU,KAAK,GAC/E,uBAAa,IAAI,CAAC,gBAAgB;AACjC,kBAAM,OACJ,oBAAC,mBAAgB,SAAS,aAAa,aAA0B,UAAQ,MAAC;AAE5E,mBACE,oBAAC,QACE,WAAC,eACA,oBAAC,mBAAgB,KAAG,MAAC,OAAO,YAAY,OAAO,MAAK,cACjD,gBACH,IAEA,QANK,eAAe,WAAW,CAQnC;AAAA,UAEJ,CAAC,GACH;AAAA,UACC,UAAU,QAAQ,oBAAC,QAAK,WAAU,8BAA8B,kBAAO;AAAA,WAC1E;AAAA,MACF;AAAA;AAAA,EACF;AAEJ;",
6
6
  "names": []
7
7
  }
@@ -7,21 +7,34 @@ export interface LinkProps extends Omit<ComponentPropsWithRef<'a'>, 'children'>
7
7
  * label, wraps between words, and names the link after the label.
8
8
  */
9
9
  children: ReactNode;
10
- /**
11
- * A decorative icon, such as ArrowBack, before the previous destination's text, or such as
12
- * ArrowForward, after the next one's; none by default.
13
- */
14
- icon?: ReactNode;
15
10
  /**
16
11
  * The link's relation to this page.
17
12
  * @default 'prev' on Pager.Previous, 'next' on Pager.Next
18
13
  */
19
14
  rel?: string;
15
+ /**
16
+ * The direction label above the title, such as Previous chapter or Back to setup, for this link
17
+ * alone; null leaves it out.
18
+ * @default 'Previous' or 'Up next', or EnvUIProvider's messages.pager.previous or next
19
+ */
20
+ label?: ReactNode;
20
21
  }
21
22
  /** The link to the previous page. */
22
- export type PreviousProps = LinkProps;
23
+ export type PreviousProps = LinkProps & {
24
+ /**
25
+ * Content before the text, such as IconArrowBack: an envUI icon takes the pager's icon size and
26
+ * other content keeps its own. It is hidden from assistive technology; none by default.
27
+ */
28
+ start?: ReactNode;
29
+ };
23
30
  /** The link to the next page. */
24
- export type NextProps = LinkProps;
31
+ export type NextProps = LinkProps & {
32
+ /**
33
+ * Content after the text, such as IconArrowForward: an envUI icon takes the pager's icon size and
34
+ * other content keeps its own. It is hidden from assistive technology; none by default.
35
+ */
36
+ end?: ReactNode;
37
+ };
25
38
  declare function Previous(props: PreviousProps): import("react").JSX.Element;
26
39
  declare function Next(props: NextProps): import("react").JSX.Element;
27
40
  export interface RootProps extends ComponentPropsWithRef<'nav'> {
@@ -36,17 +49,18 @@ export interface RootProps extends ComponentPropsWithRef<'nav'> {
36
49
  */
37
50
  'aria-label'?: string;
38
51
  }
39
- declare function Root({ children, className, 'aria-label': ariaLabel, ...props }: RootProps): import("react").JSX.Element | null;
52
+ declare function Root({ children, className, 'aria-label': ariaLabel, ref, ...props }: RootProps): import("react").JSX.Element | null;
40
53
  /**
41
54
  * A centered pair of previous and next destinations in a navigation landmark, its Pager.Previous
42
- * and Pager.Next children; either one can be left out, and without any it renders nothing.
55
+ * and Pager.Next children; either one can be left out, and without any it renders nothing. Where
56
+ * the two don't fit side by side, they stack as rows of the pager's width, the previous first.
43
57
  */
44
58
  declare const RootPart: typeof Root & {
45
59
  displayName: string;
46
60
  };
47
61
  /**
48
62
  * The destination before this one: a native link with rel="prev", its title under the label
49
- * Previous (EnvUIProvider's messages.pager.previous), and an optional icon before them. It also
63
+ * Previous (EnvUIProvider's messages.pager.previous), and optional content before them, its start. It also
50
64
  * stands alone, outside Pager.Root.
51
65
  */
52
66
  declare const PreviousPart: typeof Previous & {
@@ -54,7 +68,7 @@ declare const PreviousPart: typeof Previous & {
54
68
  };
55
69
  /**
56
70
  * The destination after this one: a native link with rel="next", its title under the label Up
57
- * next (EnvUIProvider's messages.pager.next), and an optional icon after them. It also stands
71
+ * next (EnvUIProvider's messages.pager.next), and optional content after them, its end. It also stands
58
72
  * alone, outside Pager.Root.
59
73
  */
60
74
  declare const NextPart: typeof Next & {
@@ -1,27 +1,35 @@
1
1
  "use client";
2
2
  import { jsx, jsxs } from "react/jsx-runtime";
3
- import { Children } from "react";
4
- import { DecorativeIcon } from "../internal/icon/DecorativeIcon.js";
3
+ import {
4
+ Children,
5
+ useLayoutEffect,
6
+ useRef
7
+ } from "react";
8
+ import { Slot } from "../internal/layout/Slot.js";
5
9
  import { classNames } from "../internal/classNames.js";
10
+ import { landmarkLabel } from "./internal/landmarkLabel.js";
6
11
  import { Row } from "../layout/Layout.js";
12
+ import { mergeRefs } from "../internal/react/setRef.js";
7
13
  import { withDisplayName } from "../internal/react/withDisplayName.js";
8
14
  import { useLinkComponent } from "../internal/provider/LinkComponentContext.js";
9
- import { useEnvUI, useMessages } from "../internal/provider/EnvUIContext.js";
15
+ import { useMessages } from "../internal/provider/EnvUIContext.js";
10
16
  import { pager } from "../foundations/messages/pager.js";
17
+ import { observeResize } from "../internal/dom/observeResize.js";
11
18
  import "#styles/Base.css";
12
19
  import "#styles/Pager.css";
13
20
  function PagerLink({
14
21
  direction,
15
- icon,
22
+ start,
23
+ end,
16
24
  children,
17
25
  className,
18
26
  rel,
27
+ label,
19
28
  ...props
20
29
  }) {
21
30
  const LinkComponent = useLinkComponent();
22
- const captionWithoutMergingNamespace = useEnvUI().messages.pager?.[direction] ?? pager[direction];
31
+ const caption = useMessages("pager", pager)[direction];
23
32
  const isPrevious = direction === "previous";
24
- const symbol = icon != null ? /* @__PURE__ */ jsx(DecorativeIcon, { children: icon }) : null;
25
33
  return (
26
34
  // eslint-disable-next-line react-hooks/static-components
27
35
  /* @__PURE__ */ jsxs(
@@ -31,12 +39,22 @@ function PagerLink({
31
39
  rel: rel ?? (isPrevious ? "prev" : "next"),
32
40
  className: classNames("env-pager-link", `env-pager-link-${direction}`, className),
33
41
  children: [
34
- isPrevious && symbol,
42
+ start != null && /* @__PURE__ */ jsx(
43
+ Slot,
44
+ {
45
+ className: "env-pager-link-start",
46
+ element: "span",
47
+ layout: "row",
48
+ shrink: "never",
49
+ "aria-hidden": true,
50
+ children: start
51
+ }
52
+ ),
35
53
  /* @__PURE__ */ jsxs("span", { className: "env-pager-link-copy", children: [
36
- /* @__PURE__ */ jsx("span", { className: "env-pager-link-label", children: captionWithoutMergingNamespace }),
54
+ label !== null && /* @__PURE__ */ jsx("span", { className: "env-pager-link-label", children: label ?? caption }),
37
55
  /* @__PURE__ */ jsx("span", { className: "env-pager-link-title", children })
38
56
  ] }),
39
- !isPrevious && symbol
57
+ end != null && /* @__PURE__ */ jsx(Slot, { className: "env-pager-link-end", element: "span", layout: "row", shrink: "never", "aria-hidden": true, children: end })
40
58
  ]
41
59
  }
42
60
  )
@@ -48,9 +66,27 @@ function Previous(props) {
48
66
  function Next(props) {
49
67
  return /* @__PURE__ */ jsx(PagerLink, { ...props, direction: "next" });
50
68
  }
51
- function Root({ children, className, "aria-label": ariaLabel, ...props }) {
69
+ function useStackedOnceWrapped(pager2, linkCount) {
70
+ useLayoutEffect(() => {
71
+ const element = pager2.current;
72
+ if (!element) return;
73
+ let measuredWidth = -1;
74
+ return observeResize(element, function stackWhereLinksWrap() {
75
+ if (element.clientWidth === measuredWidth) return;
76
+ measuredWidth = element.clientWidth;
77
+ delete element.dataset.stacked;
78
+ const links = [...element.children];
79
+ const wrapped = links.some((link) => link.offsetTop !== links[0].offsetTop);
80
+ if (wrapped) element.dataset.stacked = "";
81
+ });
82
+ }, [pager2, linkCount]);
83
+ }
84
+ function Root({ children, className, "aria-label": ariaLabel, ref, ...props }) {
52
85
  const messages = useMessages("pager", pager);
53
- if (Children.toArray(children).length === 0) return null;
86
+ const element = useRef(null);
87
+ const linkCount = Children.toArray(children).length;
88
+ useStackedOnceWrapped(element, linkCount);
89
+ if (linkCount === 0) return null;
54
90
  return /* @__PURE__ */ jsx(
55
91
  Row,
56
92
  {
@@ -62,7 +98,8 @@ function Root({ children, className, "aria-label": ariaLabel, ...props }) {
62
98
  "nav",
63
99
  {
64
100
  ...props,
65
- "aria-label": ariaLabel ?? messages.label,
101
+ ref: mergeRefs(element, ref),
102
+ "aria-label": landmarkLabel(ariaLabel, props["aria-labelledby"], messages.label),
66
103
  className: classNames("env-pager", className)
67
104
  }
68
105
  ),
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/navigation/Pager.tsx"],
4
- "sourcesContent": ["'use client';\n\nimport { Children, type ComponentPropsWithRef, type ReactNode } from 'react';\nimport { DecorativeIcon } from '../internal/icon/DecorativeIcon.js';\nimport { classNames } from '../internal/classNames.js';\nimport { Row } from '../layout/Layout.js';\nimport { withDisplayName } from '../internal/react/withDisplayName.js';\nimport { useLinkComponent } from '../internal/provider/LinkComponentContext.js';\nimport { useEnvUI, useMessages } from '../internal/provider/EnvUIContext.js';\nimport { pager } from '../foundations/messages/pager.js';\nimport '../styles/Base.css';\nimport '../styles/Pager.css';\n\nexport interface LinkProps extends Omit<ComponentPropsWithRef<'a'>, 'children'> {\n /** The destination; the link renders through the LinkProvider's link component. */\n href: string;\n /**\n * The destination's title, such as the name of the next page. It shows below the direction\n * label, wraps between words, and names the link after the label.\n */\n children: ReactNode;\n /**\n * A decorative icon, such as ArrowBack, before the previous destination's text, or such as\n * ArrowForward, after the next one's; none by default.\n */\n icon?: ReactNode;\n /**\n * The link's relation to this page.\n * @default 'prev' on Pager.Previous, 'next' on Pager.Next\n */\n rel?: string;\n}\n\n/** The link to the previous page. */\nexport type PreviousProps = LinkProps;\n/** The link to the next page. */\nexport type NextProps = LinkProps;\n\nfunction PagerLink({\n direction,\n icon,\n children,\n className,\n rel,\n ...props\n}: LinkProps & { direction: 'previous' | 'next' }) {\n const LinkComponent = useLinkComponent();\n const captionWithoutMergingNamespace =\n (useEnvUI().messages.pager?.[direction] as string | undefined) ?? pager[direction];\n const isPrevious = direction === 'previous';\n const symbol = icon != null ? <DecorativeIcon>{icon}</DecorativeIcon> : null;\n\n return (\n // eslint-disable-next-line react-hooks/static-components\n <LinkComponent\n {...props}\n rel={rel ?? (isPrevious ? 'prev' : 'next')}\n className={classNames('env-pager-link', `env-pager-link-${direction}`, className)}\n >\n {isPrevious && symbol}\n <span className=\"env-pager-link-copy\">\n <span className=\"env-pager-link-label\">{captionWithoutMergingNamespace}</span>\n <span className=\"env-pager-link-title\">{children}</span>\n </span>\n {!isPrevious && symbol}\n </LinkComponent>\n );\n}\n\nfunction Previous(props: PreviousProps) {\n return <PagerLink {...props} direction=\"previous\" />;\n}\n\nfunction Next(props: NextProps) {\n return <PagerLink {...props} direction=\"next\" />;\n}\n\nexport interface RootProps extends ComponentPropsWithRef<'nav'> {\n /**\n * Pager.Previous and Pager.Next, in that order; leave one out on the first or the last page of a\n * sequence.\n */\n children?: ReactNode;\n /**\n * The navigation landmark's name; give each pager its own where a page has several.\n * @default 'Previous and next content', or EnvUIProvider's messages.pager.label\n */\n 'aria-label'?: string;\n}\n\nfunction Root({ children, className, 'aria-label': ariaLabel, ...props }: RootProps) {\n const messages = useMessages('pager', pager);\n if (Children.toArray(children).length === 0) return null;\n\n return (\n <Row\n wrap\n justify=\"center\"\n align=\"stretch\"\n gap={4}\n render={\n <nav\n {...props}\n aria-label={ariaLabel ?? messages.label}\n className={classNames('env-pager', className)}\n />\n }\n >\n {children}\n </Row>\n );\n}\n\n/**\n * A centered pair of previous and next destinations in a navigation landmark, its Pager.Previous\n * and Pager.Next children; either one can be left out, and without any it renders nothing.\n */\nconst RootPart = /* @__PURE__ */ withDisplayName(Root, 'Pager.Root');\n/**\n * The destination before this one: a native link with rel=\"prev\", its title under the label\n * Previous (EnvUIProvider's messages.pager.previous), and an optional icon before them. It also\n * stands alone, outside Pager.Root.\n */\nconst PreviousPart = /* @__PURE__ */ withDisplayName(Previous, 'Pager.Previous');\n/**\n * The destination after this one: a native link with rel=\"next\", its title under the label Up\n * next (EnvUIProvider's messages.pager.next), and an optional icon after them. It also stands\n * alone, outside Pager.Root.\n */\nconst NextPart = /* @__PURE__ */ withDisplayName(Next, 'Pager.Next');\nexport { RootPart as Root, PreviousPart as Previous, NextPart as Next };\n"],
5
- "mappings": ";AAkDgC,cAU1B,YAV0B;AAhDhC,SAAS,gBAA4D;AACrE,SAAS,sBAAsB;AAC/B,SAAS,kBAAkB;AAC3B,SAAS,WAAW;AACpB,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AACjC,SAAS,UAAU,mBAAmB;AACtC,SAAS,aAAa;AACtB,OAAO;AACP,OAAO;AA2BP,SAAS,UAAU;AAAA,EACjB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAmD;AACjD,QAAM,gBAAgB,iBAAiB;AACvC,QAAM,iCACH,SAAS,EAAE,SAAS,QAAQ,SAAS,KAA4B,MAAM,SAAS;AACnF,QAAM,aAAa,cAAc;AACjC,QAAM,SAAS,QAAQ,OAAO,oBAAC,kBAAgB,gBAAK,IAAoB;AAExE;AAAA;AAAA,IAEE;AAAA,MAAC;AAAA;AAAA,QACE,GAAG;AAAA,QACJ,KAAK,QAAQ,aAAa,SAAS;AAAA,QACnC,WAAW,WAAW,kBAAkB,kBAAkB,SAAS,IAAI,SAAS;AAAA,QAE/E;AAAA,wBAAc;AAAA,UACf,qBAAC,UAAK,WAAU,uBACd;AAAA,gCAAC,UAAK,WAAU,wBAAwB,0CAA+B;AAAA,YACvE,oBAAC,UAAK,WAAU,wBAAwB,UAAS;AAAA,aACnD;AAAA,UACC,CAAC,cAAc;AAAA;AAAA;AAAA,IAClB;AAAA;AAEJ;AAEA,SAAS,SAAS,OAAsB;AACtC,SAAO,oBAAC,aAAW,GAAG,OAAO,WAAU,YAAW;AACpD;AAEA,SAAS,KAAK,OAAkB;AAC9B,SAAO,oBAAC,aAAW,GAAG,OAAO,WAAU,QAAO;AAChD;AAeA,SAAS,KAAK,EAAE,UAAU,WAAW,cAAc,WAAW,GAAG,MAAM,GAAc;AACnF,QAAM,WAAW,YAAY,SAAS,KAAK;AAC3C,MAAI,SAAS,QAAQ,QAAQ,EAAE,WAAW,EAAG,QAAO;AAEpD,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAI;AAAA,MACJ,SAAQ;AAAA,MACR,OAAM;AAAA,MACN,KAAK;AAAA,MACL,QACE;AAAA,QAAC;AAAA;AAAA,UACE,GAAG;AAAA,UACJ,cAAY,aAAa,SAAS;AAAA,UAClC,WAAW,WAAW,aAAa,SAAS;AAAA;AAAA,MAC9C;AAAA,MAGD;AAAA;AAAA,EACH;AAEJ;AAMA,MAAM,WAA2B,gCAAgB,MAAM,YAAY;AAMnE,MAAM,eAA+B,gCAAgB,UAAU,gBAAgB;AAM/E,MAAM,WAA2B,gCAAgB,MAAM,YAAY;",
6
- "names": []
4
+ "sourcesContent": ["'use client';\n\nimport {\n Children,\n useLayoutEffect,\n useRef,\n type ComponentPropsWithRef,\n type ReactNode,\n type RefObject,\n} from 'react';\nimport { Slot } from '../internal/layout/Slot.js';\nimport { classNames } from '../internal/classNames.js';\nimport { landmarkLabel } from './internal/landmarkLabel.js';\nimport { Row } from '../layout/Layout.js';\nimport { mergeRefs } from '../internal/react/setRef.js';\nimport { withDisplayName } from '../internal/react/withDisplayName.js';\nimport { useLinkComponent } from '../internal/provider/LinkComponentContext.js';\nimport { useMessages } from '../internal/provider/EnvUIContext.js';\nimport { pager } from '../foundations/messages/pager.js';\nimport { observeResize } from '../internal/dom/observeResize.js';\nimport '../styles/Base.css';\nimport '../styles/Pager.css';\n\nexport interface LinkProps extends Omit<ComponentPropsWithRef<'a'>, 'children'> {\n /** The destination; the link renders through the LinkProvider's link component. */\n href: string;\n /**\n * The destination's title, such as the name of the next page. It shows below the direction\n * label, wraps between words, and names the link after the label.\n */\n children: ReactNode;\n /**\n * The link's relation to this page.\n * @default 'prev' on Pager.Previous, 'next' on Pager.Next\n */\n rel?: string;\n /**\n * The direction label above the title, such as Previous chapter or Back to setup, for this link\n * alone; null leaves it out.\n * @default 'Previous' or 'Up next', or EnvUIProvider's messages.pager.previous or next\n */\n label?: ReactNode;\n}\n\n/** The link to the previous page. */\nexport type PreviousProps = LinkProps & {\n /**\n * Content before the text, such as IconArrowBack: an envUI icon takes the pager's icon size and\n * other content keeps its own. It is hidden from assistive technology; none by default.\n */\n start?: ReactNode;\n};\n/** The link to the next page. */\nexport type NextProps = LinkProps & {\n /**\n * Content after the text, such as IconArrowForward: an envUI icon takes the pager's icon size and\n * other content keeps its own. It is hidden from assistive technology; none by default.\n */\n end?: ReactNode;\n};\n\nfunction PagerLink({\n direction,\n start,\n end,\n children,\n className,\n rel,\n label,\n ...props\n}: LinkProps & { direction: 'previous' | 'next'; start?: ReactNode; end?: ReactNode }) {\n const LinkComponent = useLinkComponent();\n const caption = useMessages('pager', pager)[direction];\n const isPrevious = direction === 'previous';\n\n return (\n // eslint-disable-next-line react-hooks/static-components\n <LinkComponent\n {...props}\n rel={rel ?? (isPrevious ? 'prev' : 'next')}\n className={classNames('env-pager-link', `env-pager-link-${direction}`, className)}\n >\n {start != null && (\n <Slot\n className=\"env-pager-link-start\"\n element=\"span\"\n layout=\"row\"\n shrink=\"never\"\n aria-hidden\n >\n {start}\n </Slot>\n )}\n <span className=\"env-pager-link-copy\">\n {label !== null && <span className=\"env-pager-link-label\">{label ?? caption}</span>}\n <span className=\"env-pager-link-title\">{children}</span>\n </span>\n {end != null && (\n <Slot className=\"env-pager-link-end\" element=\"span\" layout=\"row\" shrink=\"never\" aria-hidden>\n {end}\n </Slot>\n )}\n </LinkComponent>\n );\n}\n\nfunction Previous(props: PreviousProps) {\n return <PagerLink {...props} direction=\"previous\" />;\n}\n\nfunction Next(props: NextProps) {\n return <PagerLink {...props} direction=\"next\" />;\n}\n\nexport interface RootProps extends ComponentPropsWithRef<'nav'> {\n /**\n * Pager.Previous and Pager.Next, in that order; leave one out on the first or the last page of a\n * sequence.\n */\n children?: ReactNode;\n /**\n * The navigation landmark's name; give each pager its own where a page has several.\n * @default 'Previous and next content', or EnvUIProvider's messages.pager.label\n */\n 'aria-label'?: string;\n}\n\nfunction useStackedOnceWrapped(pager: RefObject<HTMLElement | null>, linkCount: number) {\n useLayoutEffect(() => {\n const element = pager.current;\n if (!element) return;\n let measuredWidth = -1;\n return observeResize(element, function stackWhereLinksWrap() {\n if (element.clientWidth === measuredWidth) return;\n measuredWidth = element.clientWidth;\n delete element.dataset.stacked;\n const links = [...element.children] as HTMLElement[];\n const wrapped = links.some((link) => link.offsetTop !== links[0].offsetTop);\n if (wrapped) element.dataset.stacked = '';\n });\n }, [pager, linkCount]);\n}\n\nfunction Root({ children, className, 'aria-label': ariaLabel, ref, ...props }: RootProps) {\n const messages = useMessages('pager', pager);\n const element = useRef<HTMLElement>(null);\n const linkCount = Children.toArray(children).length;\n useStackedOnceWrapped(element, linkCount);\n if (linkCount === 0) return null;\n\n return (\n <Row\n wrap\n justify=\"center\"\n align=\"stretch\"\n gap={4}\n render={\n <nav\n {...props}\n ref={mergeRefs(element, ref)}\n aria-label={landmarkLabel(ariaLabel, props['aria-labelledby'], messages.label)}\n className={classNames('env-pager', className)}\n />\n }\n >\n {children}\n </Row>\n );\n}\n\n/**\n * A centered pair of previous and next destinations in a navigation landmark, its Pager.Previous\n * and Pager.Next children; either one can be left out, and without any it renders nothing. Where\n * the two don't fit side by side, they stack as rows of the pager's width, the previous first.\n */\nconst RootPart = /* @__PURE__ */ withDisplayName(Root, 'Pager.Root');\n/**\n * The destination before this one: a native link with rel=\"prev\", its title under the label\n * Previous (EnvUIProvider's messages.pager.previous), and optional content before them, its start. It also\n * stands alone, outside Pager.Root.\n */\nconst PreviousPart = /* @__PURE__ */ withDisplayName(Previous, 'Pager.Previous');\n/**\n * The destination after this one: a native link with rel=\"next\", its title under the label Up\n * next (EnvUIProvider's messages.pager.next), and optional content after them, its end. It also stands\n * alone, outside Pager.Root.\n */\nconst NextPart = /* @__PURE__ */ withDisplayName(Next, 'Pager.Next');\nexport { RootPart as Root, PreviousPart as Previous, NextPart as Next };\n"],
5
+ "mappings": "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",
6
+ "names": ["pager"]
7
7
  }
@@ -14,7 +14,7 @@ export interface PaginationRange {
14
14
  /** The number of pages, when the total is known. */
15
15
  pageCount?: number;
16
16
  }
17
- export interface PaginationProps extends Omit<ComponentPropsWithRef<'nav'>, 'children' | 'onChange'> {
17
+ interface PaginationOwnProps extends Omit<ComponentPropsWithRef<'nav'>, 'children' | 'onChange'> {
18
18
  /**
19
19
  * The page shown, counted from 1. It is kept within the pages that exist, so a page beyond the
20
20
  * end shows the last one.
@@ -32,11 +32,6 @@ export interface PaginationProps extends Omit<ComponentPropsWithRef<'nav'>, 'chi
32
32
  * @default true
33
33
  */
34
34
  hasNextPage?: boolean;
35
- /**
36
- * Receives the page before or after the current one when its button is pressed. The application
37
- * loads that page and passes it back as page.
38
- */
39
- onPageChange: (page: number) => void;
40
35
  /**
41
36
  * A page is loading: the button pressed shows a spinner, also when the load starts in an effect
42
37
  * after the page changes, and both buttons ignore presses while staying focusable. A load for
@@ -46,11 +41,11 @@ export interface PaginationProps extends Omit<ComponentPropsWithRef<'nav'>, 'chi
46
41
  /** Render nothing while every item fits on one page, so neither button has anywhere to go. */
47
42
  hideWhenSinglePage?: boolean;
48
43
  /**
49
- * Writes the range from the first and last item shown, the total, the page and the page count,
44
+ * Draws the range from the first and last item shown, the total, the page and the page count,
50
45
  * for one pager; EnvUIProvider's messages.pagination.range writes it for every pager.
51
46
  * @default 1–60 of 245, or 61–120 without total, with numbers in the locale
52
47
  */
53
- formatRange?: (range: PaginationRange) => ReactNode;
48
+ renderRange?: (range: PaginationRange) => ReactNode;
54
49
  /**
55
50
  * The previous button's accessible name and tooltip.
56
51
  * @default 'Previous page', or EnvUIProvider's messages.pagination.previous
@@ -77,9 +72,29 @@ export interface PaginationProps extends Omit<ComponentPropsWithRef<'nav'>, 'chi
77
72
  */
78
73
  'aria-label'?: string;
79
74
  }
75
+ /** How the controls reach a page: onPageChange, pageHref, or both. */
76
+ type PaginationTarget = {
77
+ /**
78
+ * Receives the page before or after the current one when its button is pressed. The
79
+ * application loads that page and passes it back as page. Give it, or pageHref, or both.
80
+ */
81
+ onPageChange: (page: number) => void;
82
+ /**
83
+ * The address of a page, such as `?page=3`, for a list whose pages have their own URLs: the
84
+ * previous and next controls are then links, through the LinkProvider's link component,
85
+ * which open in a new tab, are crawlable and work before hydration. A control with no page
86
+ * to go to reports aria-disabled and has no destination.
87
+ */
88
+ pageHref?: (page: number) => string;
89
+ } | {
90
+ onPageChange?: (page: number) => void;
91
+ pageHref: (page: number) => string;
92
+ };
93
+ export type PaginationProps = PaginationOwnProps & PaginationTarget;
80
94
  /**
81
95
  * Compact pagination for toolbars: the range of items shown, such as 1–60 of 245, and icon buttons
82
96
  * for the previous and next pages, in a navigation landmark. The application loads the pages; the
83
97
  * range is announced as it changes, and focus stays on the button pressed.
84
98
  */
85
- export declare function Pagination({ page, pageSize, total, hasNextPage, onPageChange, pending, hideWhenSinglePage, formatRange, previousLabel, nextLabel, variant, size, className, 'aria-label': label, ...props }: PaginationProps): import("react").JSX.Element | null;
99
+ export declare function Pagination({ page, pageSize, total, hasNextPage, onPageChange, pageHref, pending, hideWhenSinglePage, renderRange, previousLabel, nextLabel, variant, size, className, 'aria-label': label, ...props }: PaginationProps): import("react").JSX.Element | null;
100
+ export {};
@@ -1,11 +1,15 @@
1
1
  "use client";
2
2
  import { jsx, jsxs } from "react/jsx-runtime";
3
- import { useEffect, useState } from "react";
3
+ import {
4
+ useEffect,
5
+ useState
6
+ } from "react";
4
7
  import { IconButton } from "../actions/Button.js";
5
8
  import { Tooltip } from "../overlays/Tooltip.js";
6
9
  import { IconChevronLeft } from "../icons/ChevronLeft.js";
7
10
  import { IconChevronRight } from "../icons/ChevronRight.js";
8
11
  import { classNames } from "../internal/classNames.js";
12
+ import { landmarkLabel } from "./internal/landmarkLabel.js";
9
13
  import { Row } from "../layout/Layout.js";
10
14
  import { useMessages } from "../internal/provider/EnvUIContext.js";
11
15
  import { useFormatters } from "../internal/provider/useFormatters.js";
@@ -18,9 +22,10 @@ function Pagination({
18
22
  total,
19
23
  hasNextPage,
20
24
  onPageChange,
25
+ pageHref,
21
26
  pending = false,
22
27
  hideWhenSinglePage = false,
23
- formatRange,
28
+ renderRange,
24
29
  previousLabel,
25
30
  nextLabel,
26
31
  variant = "ghost",
@@ -58,20 +63,41 @@ function Pagination({
58
63
  const name = direction === "previous" ? previousLabel ?? messages.previous : nextLabel ?? messages.next;
59
64
  const loading = pending && press?.direction === direction;
60
65
  const unavailableButFocusable = !loading && (!available || pending);
61
- return /* @__PURE__ */ jsx(Tooltip, { content: name, children: /* @__PURE__ */ jsx(
66
+ const target = direction === "previous" ? current - 1 : current + 1;
67
+ const shared = {
68
+ icon: direction === "previous" ? /* @__PURE__ */ jsx(IconChevronLeft, {}) : /* @__PURE__ */ jsx(IconChevronRight, {}),
69
+ "aria-label": name,
70
+ variant,
71
+ pending: loading,
72
+ "aria-disabled": unavailableButFocusable ? true : void 0
73
+ };
74
+ return /* @__PURE__ */ jsx(Tooltip, { content: name, children: pageHref ? /* @__PURE__ */ jsx(
62
75
  IconButton,
63
76
  {
64
- icon: direction === "previous" ? /* @__PURE__ */ jsx(IconChevronLeft, {}) : /* @__PURE__ */ jsx(IconChevronRight, {}),
65
- "aria-label": name,
66
- variant,
67
- pending: loading,
68
- "aria-disabled": unavailableButFocusable ? true : void 0,
77
+ ...shared,
78
+ className: "env-pagination-button",
79
+ "data-direction": direction,
80
+ href: available ? pageHref(target) : "",
81
+ disabled: !available,
82
+ onClick: (event) => {
83
+ if (pending) {
84
+ event.preventDefault();
85
+ return;
86
+ }
87
+ setPress({ direction, state: "pressed" });
88
+ onPageChange?.(target);
89
+ }
90
+ }
91
+ ) : /* @__PURE__ */ jsx(
92
+ IconButton,
93
+ {
94
+ ...shared,
69
95
  className: "env-pagination-button",
70
96
  "data-direction": direction,
71
97
  onClick: () => {
72
98
  if (!available || pending) return;
73
99
  setPress({ direction, state: "pressed" });
74
- onPageChange(direction === "previous" ? current - 1 : current + 1);
100
+ onPageChange?.(target);
75
101
  }
76
102
  }
77
103
  ) });
@@ -86,13 +112,13 @@ function Pagination({
86
112
  "nav",
87
113
  {
88
114
  ...props,
89
- "aria-label": label ?? messages.label,
115
+ "aria-label": landmarkLabel(label, props["aria-labelledby"], messages.label),
90
116
  className: classNames("env-pagination", className),
91
117
  "data-size": size
92
118
  }
93
119
  ),
94
120
  children: [
95
- /* @__PURE__ */ jsx("span", { className: "env-pagination-range", dir: "auto", "aria-live": "polite", "aria-atomic": "true", children: formatRange ? formatRange({ start, end, total: count, page: current, pageCount }) : messages.range({
121
+ /* @__PURE__ */ jsx("span", { className: "env-pagination-range", dir: "auto", "aria-live": "polite", "aria-atomic": "true", children: renderRange ? renderRange({ start, end, total: count, page: current, pageCount }) : messages.range({
96
122
  start: numbers.format(start),
97
123
  end: numbers.format(end),
98
124
  total: count === void 0 ? void 0 : numbers.format(count)
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/navigation/Pagination.tsx"],
4
- "sourcesContent": ["'use client';\n\nimport { useEffect, useState, type ComponentPropsWithRef, type ReactNode } from 'react';\nimport type { ControlSize } from '../foundations/Theme.js';\nimport { IconButton, type ButtonVariant } from '../actions/Button.js';\nimport { Tooltip } from '../overlays/Tooltip.js';\nimport { IconChevronLeft } from '../icons/ChevronLeft.js';\nimport { IconChevronRight } from '../icons/ChevronRight.js';\nimport { classNames } from '../internal/classNames.js';\nimport { Row } from '../layout/Layout.js';\nimport { useMessages } from '../internal/provider/EnvUIContext.js';\nimport { useFormatters } from '../internal/provider/useFormatters.js';\nimport { pagination } from '../foundations/messages/pagination.js';\nimport '../styles/Base.css';\nimport '../styles/Pagination.css';\n\n/** The items a page shows, for the text of the range. */\nexport interface PaginationRange {\n /** The first item on the page, counted from 1; 0 when there are no items. */\n start: number;\n /** The last item on the page. */\n end: number;\n /** All items, when known. */\n total?: number;\n /** The page, counted from 1. */\n page: number;\n /** The number of pages, when the total is known. */\n pageCount?: number;\n}\n\nexport interface PaginationProps extends Omit<\n ComponentPropsWithRef<'nav'>,\n 'children' | 'onChange'\n> {\n /**\n * The page shown, counted from 1. It is kept within the pages that exist, so a page beyond the\n * end shows the last one.\n */\n page: number;\n /** The most items a page shows, such as 60; at least 1. */\n pageSize: number;\n /**\n * All items, when known; the range then ends with it, as in 1\u201360 of 245, and the last page ends\n * the list. Leave it out for a list read in batches, where hasNextPage says when it ends.\n */\n total?: number;\n /**\n * Whether a later page exists, for a list without total, such as from a cursor's has more.\n * @default true\n */\n hasNextPage?: boolean;\n /**\n * Receives the page before or after the current one when its button is pressed. The application\n * loads that page and passes it back as page.\n */\n onPageChange: (page: number) => void;\n /**\n * A page is loading: the button pressed shows a spinner, also when the load starts in an effect\n * after the page changes, and both buttons ignore presses while staying focusable. A load for\n * another reason, such as a refresh, makes both wait without a spinner.\n */\n pending?: boolean;\n /** Render nothing while every item fits on one page, so neither button has anywhere to go. */\n hideWhenSinglePage?: boolean;\n /**\n * Writes the range from the first and last item shown, the total, the page and the page count,\n * for one pager; EnvUIProvider's messages.pagination.range writes it for every pager.\n * @default 1\u201360 of 245, or 61\u2013120 without total, with numbers in the locale\n */\n formatRange?: (range: PaginationRange) => ReactNode;\n /**\n * The previous button's accessible name and tooltip.\n * @default 'Previous page', or EnvUIProvider's messages.pagination.previous\n */\n previousLabel?: string;\n /**\n * The next button's accessible name and tooltip.\n * @default 'Next page', or EnvUIProvider's messages.pagination.next\n */\n nextLabel?: string;\n /**\n * The buttons' variant, as on IconButton: quiet neutral icon buttons by default.\n * @default 'ghost'\n */\n variant?: ButtonVariant;\n /**\n * The buttons' height, as on every control: sm, md or lg in the current scale. Without it, they\n * take the control height of the container, md unless the container sets another.\n */\n size?: ControlSize;\n /**\n * The navigation landmark's name, such as Report pages, where a page has more than one.\n * @default 'Pagination', or EnvUIProvider's messages.pagination.label\n */\n 'aria-label'?: string;\n}\n\ninterface PressAwaitingItsLoad {\n direction: 'previous' | 'next';\n state: 'pressed' | 'settling' | 'loading';\n}\n\n/**\n * Compact pagination for toolbars: the range of items shown, such as 1\u201360 of 245, and icon buttons\n * for the previous and next pages, in a navigation landmark. The application loads the pages; the\n * range is announced as it changes, and focus stays on the button pressed.\n */\nexport function Pagination({\n page,\n pageSize,\n total,\n hasNextPage,\n onPageChange,\n pending = false,\n hideWhenSinglePage = false,\n formatRange,\n previousLabel,\n nextLabel,\n variant = 'ghost',\n size,\n className,\n 'aria-label': label,\n ...props\n}: PaginationProps) {\n const messages = useMessages('pagination', pagination);\n const numbers = useFormatters().number();\n const [press, setPress] = useState<PressAwaitingItsLoad | null>(null);\n if (press) {\n if (pending) {\n if (press.state !== 'loading') setPress({ ...press, state: 'loading' });\n } else if (press.state !== 'pressed') setPress(null);\n }\n useEffect(\n function settleAfterApplicationEffectsForNewPage() {\n if (press?.state === 'pressed' && !pending)\n setPress((current) => (current === press ? { ...press, state: 'settling' } : current));\n },\n [press, pending],\n );\n const perPage = Math.max(1, Math.floor(pageSize) || 1);\n const count = total === undefined ? undefined : Math.max(0, Math.floor(total) || 0);\n const pageCount = count === undefined ? undefined : Math.max(1, Math.ceil(count / perPage));\n const current = Math.min(Math.max(1, Math.floor(page) || 1), pageCount ?? Infinity);\n const hasPrevious = current > 1;\n const hasNext = pageCount === undefined ? (hasNextPage ?? true) : current < pageCount;\n if (hideWhenSinglePage && !hasPrevious && !hasNext) return null;\n const start = count === 0 ? 0 : (current - 1) * perPage + 1;\n const end = count === undefined ? current * perPage : Math.min(current * perPage, count);\n\n function pageButton(direction: 'previous' | 'next') {\n const available = direction === 'previous' ? hasPrevious : hasNext;\n const name =\n direction === 'previous'\n ? (previousLabel ?? messages.previous)\n : (nextLabel ?? messages.next);\n const loading = pending && press?.direction === direction;\n const unavailableButFocusable = !loading && (!available || pending);\n return (\n <Tooltip content={name}>\n <IconButton\n icon={direction === 'previous' ? <IconChevronLeft /> : <IconChevronRight />}\n aria-label={name}\n variant={variant}\n pending={loading}\n aria-disabled={unavailableButFocusable ? true : undefined}\n className=\"env-pagination-button\"\n data-direction={direction}\n onClick={() => {\n if (!available || pending) return;\n setPress({ direction, state: 'pressed' });\n onPageChange(direction === 'previous' ? current - 1 : current + 1);\n }}\n />\n </Tooltip>\n );\n }\n\n return (\n <Row\n wrap\n align=\"center\"\n gap={1}\n render={\n <nav\n {...props}\n aria-label={label ?? messages.label}\n className={classNames('env-pagination', className)}\n data-size={size}\n />\n }\n >\n <span className=\"env-pagination-range\" dir=\"auto\" aria-live=\"polite\" aria-atomic=\"true\">\n {formatRange\n ? formatRange({ start, end, total: count, page: current, pageCount })\n : messages.range({\n start: numbers.format(start),\n end: numbers.format(end),\n total: count === undefined ? undefined : numbers.format(count),\n })}\n </span>\n {pageButton('previous')}\n {pageButton('next')}\n </Row>\n );\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["'use client';\n\nimport {\n useEffect,\n useState,\n type ComponentPropsWithRef,\n type MouseEvent,\n type ReactNode,\n} from 'react';\nimport type { ControlSize } from '../foundations/Theme.js';\nimport { IconButton, type ButtonVariant } from '../actions/Button.js';\nimport { Tooltip } from '../overlays/Tooltip.js';\nimport { IconChevronLeft } from '../icons/ChevronLeft.js';\nimport { IconChevronRight } from '../icons/ChevronRight.js';\nimport { classNames } from '../internal/classNames.js';\nimport { landmarkLabel } from './internal/landmarkLabel.js';\nimport { Row } from '../layout/Layout.js';\nimport { useMessages } from '../internal/provider/EnvUIContext.js';\nimport { useFormatters } from '../internal/provider/useFormatters.js';\nimport { pagination } from '../foundations/messages/pagination.js';\nimport '../styles/Base.css';\nimport '../styles/Pagination.css';\n\n/** The items a page shows, for the text of the range. */\nexport interface PaginationRange {\n /** The first item on the page, counted from 1; 0 when there are no items. */\n start: number;\n /** The last item on the page. */\n end: number;\n /** All items, when known. */\n total?: number;\n /** The page, counted from 1. */\n page: number;\n /** The number of pages, when the total is known. */\n pageCount?: number;\n}\n\ninterface PaginationOwnProps extends Omit<ComponentPropsWithRef<'nav'>, 'children' | 'onChange'> {\n /**\n * The page shown, counted from 1. It is kept within the pages that exist, so a page beyond the\n * end shows the last one.\n */\n page: number;\n /** The most items a page shows, such as 60; at least 1. */\n pageSize: number;\n /**\n * All items, when known; the range then ends with it, as in 1\u201360 of 245, and the last page ends\n * the list. Leave it out for a list read in batches, where hasNextPage says when it ends.\n */\n total?: number;\n /**\n * Whether a later page exists, for a list without total, such as from a cursor's has more.\n * @default true\n */\n hasNextPage?: boolean;\n /**\n * A page is loading: the button pressed shows a spinner, also when the load starts in an effect\n * after the page changes, and both buttons ignore presses while staying focusable. A load for\n * another reason, such as a refresh, makes both wait without a spinner.\n */\n pending?: boolean;\n /** Render nothing while every item fits on one page, so neither button has anywhere to go. */\n hideWhenSinglePage?: boolean;\n /**\n * Draws the range from the first and last item shown, the total, the page and the page count,\n * for one pager; EnvUIProvider's messages.pagination.range writes it for every pager.\n * @default 1\u201360 of 245, or 61\u2013120 without total, with numbers in the locale\n */\n renderRange?: (range: PaginationRange) => ReactNode;\n /**\n * The previous button's accessible name and tooltip.\n * @default 'Previous page', or EnvUIProvider's messages.pagination.previous\n */\n previousLabel?: string;\n /**\n * The next button's accessible name and tooltip.\n * @default 'Next page', or EnvUIProvider's messages.pagination.next\n */\n nextLabel?: string;\n /**\n * The buttons' variant, as on IconButton: quiet neutral icon buttons by default.\n * @default 'ghost'\n */\n variant?: ButtonVariant;\n /**\n * The buttons' height, as on every control: sm, md or lg in the current scale. Without it, they\n * take the control height of the container, md unless the container sets another.\n */\n size?: ControlSize;\n /**\n * The navigation landmark's name, such as Report pages, where a page has more than one.\n * @default 'Pagination', or EnvUIProvider's messages.pagination.label\n */\n 'aria-label'?: string;\n}\n\n/** How the controls reach a page: onPageChange, pageHref, or both. */\ntype PaginationTarget =\n | {\n /**\n * Receives the page before or after the current one when its button is pressed. The\n * application loads that page and passes it back as page. Give it, or pageHref, or both.\n */\n onPageChange: (page: number) => void;\n /**\n * The address of a page, such as `?page=3`, for a list whose pages have their own URLs: the\n * previous and next controls are then links, through the LinkProvider's link component,\n * which open in a new tab, are crawlable and work before hydration. A control with no page\n * to go to reports aria-disabled and has no destination.\n */\n pageHref?: (page: number) => string;\n }\n | {\n onPageChange?: (page: number) => void;\n pageHref: (page: number) => string;\n };\n\nexport type PaginationProps = PaginationOwnProps & PaginationTarget;\n\ninterface PressAwaitingItsLoad {\n direction: 'previous' | 'next';\n state: 'pressed' | 'settling' | 'loading';\n}\n\n/**\n * Compact pagination for toolbars: the range of items shown, such as 1\u201360 of 245, and icon buttons\n * for the previous and next pages, in a navigation landmark. The application loads the pages; the\n * range is announced as it changes, and focus stays on the button pressed.\n */\nexport function Pagination({\n page,\n pageSize,\n total,\n hasNextPage,\n onPageChange,\n pageHref,\n pending = false,\n hideWhenSinglePage = false,\n renderRange,\n previousLabel,\n nextLabel,\n variant = 'ghost',\n size,\n className,\n 'aria-label': label,\n ...props\n}: PaginationProps) {\n const messages = useMessages('pagination', pagination);\n const numbers = useFormatters().number();\n const [press, setPress] = useState<PressAwaitingItsLoad | null>(null);\n if (press) {\n if (pending) {\n if (press.state !== 'loading') setPress({ ...press, state: 'loading' });\n } else if (press.state !== 'pressed') setPress(null);\n }\n useEffect(\n function settleAfterApplicationEffectsForNewPage() {\n if (press?.state === 'pressed' && !pending)\n setPress((current) => (current === press ? { ...press, state: 'settling' } : current));\n },\n [press, pending],\n );\n const perPage = Math.max(1, Math.floor(pageSize) || 1);\n const count = total === undefined ? undefined : Math.max(0, Math.floor(total) || 0);\n const pageCount = count === undefined ? undefined : Math.max(1, Math.ceil(count / perPage));\n const current = Math.min(Math.max(1, Math.floor(page) || 1), pageCount ?? Infinity);\n const hasPrevious = current > 1;\n const hasNext = pageCount === undefined ? (hasNextPage ?? true) : current < pageCount;\n if (hideWhenSinglePage && !hasPrevious && !hasNext) return null;\n const start = count === 0 ? 0 : (current - 1) * perPage + 1;\n const end = count === undefined ? current * perPage : Math.min(current * perPage, count);\n\n function pageButton(direction: 'previous' | 'next') {\n const available = direction === 'previous' ? hasPrevious : hasNext;\n const name =\n direction === 'previous'\n ? (previousLabel ?? messages.previous)\n : (nextLabel ?? messages.next);\n const loading = pending && press?.direction === direction;\n const unavailableButFocusable = !loading && (!available || pending);\n const target = direction === 'previous' ? current - 1 : current + 1;\n const shared = {\n icon: direction === 'previous' ? <IconChevronLeft /> : <IconChevronRight />,\n 'aria-label': name,\n variant,\n pending: loading,\n 'aria-disabled': unavailableButFocusable ? true : undefined,\n };\n return (\n <Tooltip content={name}>\n {pageHref ? (\n <IconButton\n {...shared}\n className=\"env-pagination-button\"\n data-direction={direction}\n href={available ? pageHref(target) : ''}\n disabled={!available}\n onClick={(event: MouseEvent<HTMLAnchorElement>) => {\n if (pending) {\n event.preventDefault();\n return;\n }\n setPress({ direction, state: 'pressed' });\n onPageChange?.(target);\n }}\n />\n ) : (\n <IconButton\n {...shared}\n className=\"env-pagination-button\"\n data-direction={direction}\n onClick={() => {\n if (!available || pending) return;\n setPress({ direction, state: 'pressed' });\n onPageChange?.(target);\n }}\n />\n )}\n </Tooltip>\n );\n }\n\n return (\n <Row\n wrap\n align=\"center\"\n gap={1}\n render={\n <nav\n {...props}\n aria-label={landmarkLabel(label, props['aria-labelledby'], messages.label)}\n className={classNames('env-pagination', className)}\n data-size={size}\n />\n }\n >\n <span className=\"env-pagination-range\" dir=\"auto\" aria-live=\"polite\" aria-atomic=\"true\">\n {renderRange\n ? renderRange({ start, end, total: count, page: current, pageCount })\n : messages.range({\n start: numbers.format(start),\n end: numbers.format(end),\n total: count === undefined ? undefined : numbers.format(count),\n })}\n </span>\n {pageButton('previous')}\n {pageButton('next')}\n </Row>\n );\n}\n"],
5
+ "mappings": "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",
6
6
  "names": ["current"]
7
7
  }
@@ -1,7 +1,14 @@
1
- import { type ComponentPropsWithRef, type RefObject } from 'react';
2
- import { type TableOfContentsItem } from './internal/contentsOutline.js';
1
+ import { type ComponentPropsWithRef, type MouseEvent, type ReactNode, type RefObject } from 'react';
3
2
  import type { HeadingLevel } from '../foundations/headingLevel.js';
4
- export type { TableOfContentsItem } from './internal/contentsOutline.js';
3
+ /** One entry of a table of contents: a section of the page, and the sections nested in it. */
4
+ export interface TableOfContentsItem {
5
+ /** The id of the element the entry leads to: a heading, or any section of the page with an id. */
6
+ id: string;
7
+ /** The entry's text, such as the heading's words or a shorter name for a section. */
8
+ label: ReactNode;
9
+ /** The sections nested under this one, such as a heading's subsections. */
10
+ children?: readonly TableOfContentsItem[];
11
+ }
5
12
  export interface TableOfContentsProps extends Omit<ComponentPropsWithRef<'nav'>, 'children'> {
6
13
  /**
7
14
  * The sections to list, nested through `children`, each leading to the element with its `id`:
@@ -22,6 +29,13 @@ export interface TableOfContentsProps extends Omit<ComponentPropsWithRef<'nav'>,
22
29
  levels?: readonly HeadingLevel[];
23
30
  /** Leaves out the headings it returns false for, without `items`, such as an example's own. */
24
31
  filter?: (heading: HTMLElement) => boolean;
32
+ /**
33
+ * Called when people follow a link, with its section's id and the click, before envUI scrolls the
34
+ * section into view and focuses it. Each link is an `#id` link through LinkProvider's link
35
+ * component, so the application's router, or else the browser, changes the address. Call
36
+ * preventDefault to make the jump yourself, without envUI's scroll or the address change.
37
+ */
38
+ onNavigate?: (id: string, event: MouseEvent<HTMLAnchorElement>) => void;
25
39
  /**
26
40
  * The accessible name of the navigation landmark.
27
41
  * @default 'On this page', or EnvUIProvider's messages.tableOfContents.label
@@ -34,4 +48,4 @@ export interface TableOfContentsProps extends Omit<ComponentPropsWithRef<'nav'>,
34
48
  * The page's sections as links, nested by level, with the one the reader is in marked as they
35
49
  * scroll: the headings in a container by default, or sections of your own.
36
50
  */
37
- export declare function TableOfContents({ items: givenItems, container, levels, filter, 'aria-label': label, className, ...props }: TableOfContentsProps): import("react").JSX.Element;
51
+ export declare function TableOfContents({ items: givenItems, container, levels, filter, onNavigate, 'aria-label': label, className, ...props }: TableOfContentsProps): import("react").JSX.Element;