@jcsoftdev/ui 0.2.3 → 0.4.0

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 (601) hide show
  1. package/CHANGELOG.md +390 -7
  2. package/README.md +57 -3
  3. package/bin/ui-theme.mjs +1162 -25
  4. package/dist/ai/attachment/attachment.js +1 -1
  5. package/dist/ai/chat-list/group.js +3 -1
  6. package/dist/ai/conversation/conversation.js +1 -1
  7. package/dist/ai/internal/use-copy.d.ts +1 -5
  8. package/dist/ai/internal/use-copy.js +1 -32
  9. package/dist/ai/markdown/parse.js +59 -17
  10. package/dist/ai/source/source.js +1 -1
  11. package/dist/atoms/avatar/avatar.d.ts +13 -3
  12. package/dist/atoms/avatar/avatar.js +40 -2
  13. package/dist/atoms/avatar/index.d.ts +1 -1
  14. package/dist/atoms/avatar/index.js +3 -1
  15. package/dist/atoms/button/button.d.ts +4 -1
  16. package/dist/atoms/button/button.js +4 -2
  17. package/dist/atoms/checkbox/checkbox.d.ts +8 -3
  18. package/dist/atoms/checkbox/checkbox.js +26 -3
  19. package/dist/atoms/chip/chip.d.ts +19 -5
  20. package/dist/atoms/chip/chip.js +34 -5
  21. package/dist/atoms/chip/index.d.ts +1 -1
  22. package/dist/atoms/chip/index.js +6 -1
  23. package/dist/atoms/due-chip/due-chip.d.ts +31 -0
  24. package/dist/atoms/due-chip/due-chip.js +41 -0
  25. package/dist/atoms/due-chip/index.d.ts +2 -0
  26. package/dist/atoms/due-chip/index.js +6 -0
  27. package/dist/atoms/due-chip/model.d.ts +25 -0
  28. package/dist/atoms/due-chip/model.js +44 -0
  29. package/dist/atoms/icon-button/icon-button.d.ts +22 -0
  30. package/dist/atoms/icon-button/icon-button.js +38 -0
  31. package/dist/atoms/icon-button/index.d.ts +1 -0
  32. package/dist/atoms/icon-button/index.js +8 -0
  33. package/dist/atoms/index.d.ts +5 -0
  34. package/dist/atoms/index.js +5 -0
  35. package/dist/atoms/internal/hit-area.d.ts +6 -0
  36. package/dist/atoms/internal/hit-area.js +4 -0
  37. package/dist/atoms/kbd/index.d.ts +1 -0
  38. package/dist/atoms/kbd/index.js +4 -0
  39. package/dist/atoms/kbd/kbd.d.ts +7 -0
  40. package/dist/atoms/kbd/kbd.js +17 -0
  41. package/dist/atoms/radio-group/radio-group.js +6 -2
  42. package/dist/atoms/seal/index.d.ts +1 -0
  43. package/dist/atoms/seal/index.js +4 -0
  44. package/dist/atoms/seal/seal.d.ts +30 -0
  45. package/dist/atoms/seal/seal.js +71 -0
  46. package/dist/atoms/spinner/index.d.ts +1 -0
  47. package/dist/atoms/spinner/index.js +5 -0
  48. package/dist/atoms/spinner/spinner.d.ts +19 -0
  49. package/dist/atoms/spinner/spinner.js +31 -0
  50. package/dist/atoms/status-dot/index.d.ts +1 -1
  51. package/dist/atoms/status-dot/status-dot.d.ts +4 -2
  52. package/dist/atoms/status-dot/status-dot.js +5 -1
  53. package/dist/atoms/switch/switch.js +3 -1
  54. package/dist/calendar/date-calendar/date-calendar.d.ts +32 -0
  55. package/dist/calendar/date-calendar/date-calendar.js +189 -0
  56. package/dist/calendar/date-calendar/index.d.ts +1 -0
  57. package/dist/calendar/date-calendar/index.js +6 -0
  58. package/dist/calendar/index.d.ts +1 -0
  59. package/dist/calendar/index.js +1 -0
  60. package/dist/calendar/internal/date-utils.d.ts +26 -0
  61. package/dist/calendar/internal/date-utils.js +95 -1
  62. package/dist/charts/bar-chart/bar-race-chart.js +1 -0
  63. package/dist/charts/beeswarm-chart/beeswarm-chart.js +1 -1
  64. package/dist/charts/chord-chart/chord-chart.js +13 -5
  65. package/dist/charts/core/cartesian/cartesian-chart.d.ts +1 -1
  66. package/dist/charts/core/cartesian/cartesian-chart.js +48 -11
  67. package/dist/charts/core/cartesian/layout.d.ts +6 -1
  68. package/dist/charts/core/cartesian/layout.js +14 -5
  69. package/dist/charts/core/cartesian/marks.d.ts +2 -2
  70. package/dist/charts/core/cartesian/marks.js +1 -1
  71. package/dist/charts/core/cartesian/types.d.ts +28 -2
  72. package/dist/charts/core/category-explorer.d.ts +2 -2
  73. package/dist/charts/core/category-explorer.js +8 -4
  74. package/dist/charts/core/chart-dock.d.ts +26 -0
  75. package/dist/charts/core/chart-dock.js +45 -0
  76. package/dist/charts/core/chart-frame.d.ts +9 -2
  77. package/dist/charts/core/chart-frame.js +105 -25
  78. package/dist/charts/core/distribution/explorer.d.ts +5 -2
  79. package/dist/charts/core/distribution/explorer.js +12 -5
  80. package/dist/charts/core/distribution/xy-points.js +1 -1
  81. package/dist/charts/core/index.d.ts +3 -0
  82. package/dist/charts/core/index.js +3 -0
  83. package/dist/charts/core/leave-grace.d.ts +11 -0
  84. package/dist/charts/core/leave-grace.js +26 -0
  85. package/dist/charts/core/nearest.d.ts +14 -0
  86. package/dist/charts/core/nearest.js +22 -0
  87. package/dist/charts/core/plot-overlay.js +9 -3
  88. package/dist/charts/core/pointer.test-utils.d.ts +38 -0
  89. package/dist/charts/core/pointer.test-utils.js +123 -0
  90. package/dist/charts/core/tooltip.d.ts +25 -2
  91. package/dist/charts/core/tooltip.js +115 -40
  92. package/dist/charts/core/touch-select.d.ts +20 -0
  93. package/dist/charts/core/touch-select.js +184 -0
  94. package/dist/charts/core/types.d.ts +8 -4
  95. package/dist/charts/core/types.js +5 -0
  96. package/dist/charts/core/use-index-navigation.d.ts +17 -6
  97. package/dist/charts/core/use-index-navigation.js +47 -10
  98. package/dist/charts/donut-chart/donut-chart.d.ts +5 -1
  99. package/dist/charts/donut-chart/donut-chart.js +40 -1
  100. package/dist/charts/donut-chart/slice-labels.d.ts +20 -0
  101. package/dist/charts/donut-chart/slice-labels.js +20 -0
  102. package/dist/charts/dumbbell-chart/dumbbell-chart.js +6 -3
  103. package/dist/charts/fill-gauge-chart/fill-gauge-chart.js +1 -0
  104. package/dist/charts/funnel-chart/funnel-chart.js +2 -1
  105. package/dist/charts/gauge-chart/gauge-chart.js +2 -1
  106. package/dist/charts/heatmap-chart/heatmap-chart.d.ts +4 -1
  107. package/dist/charts/heatmap-chart/heatmap-chart.js +3 -1
  108. package/dist/charts/heatmap-chart/heatmap-grid.d.ts +4 -1
  109. package/dist/charts/heatmap-chart/heatmap-grid.js +3 -1
  110. package/dist/charts/hex-tile-map/hex-tile-map.js +124 -115
  111. package/dist/charts/hierarchy-morph/hierarchy-morph.js +2 -1
  112. package/dist/charts/icicle-chart/icicle-chart.js +7 -9
  113. package/dist/charts/lollipop-chart/lollipop-chart.js +6 -3
  114. package/dist/charts/maps/geo/map-viewport.js +1 -1
  115. package/dist/charts/polar-area-chart/polar-area-chart.js +42 -12
  116. package/dist/charts/progress-units/progress-units.js +1 -0
  117. package/dist/charts/radar-chart/radar-chart.js +1 -1
  118. package/dist/charts/radial-bar-chart/radial-bar-chart.js +2 -1
  119. package/dist/charts/range-area-chart/range-area-chart.js +3 -2
  120. package/dist/charts/sankey-chart/sankey-chart.js +12 -4
  121. package/dist/charts/tree-chart/tree-chart.js +1 -0
  122. package/dist/charts/treemap-chart/treemap-chart.js +2 -7
  123. package/dist/charts/waterfall-chart/waterfall-chart.js +6 -3
  124. package/dist/containers/action-bar/action-bar.d.ts +11 -2
  125. package/dist/containers/action-bar/action-bar.js +4 -1
  126. package/dist/containers/aside/aside.d.ts +14 -0
  127. package/dist/containers/aside/aside.js +25 -0
  128. package/dist/containers/aside/index.d.ts +1 -0
  129. package/dist/containers/aside/index.js +5 -0
  130. package/dist/containers/banner/banner.d.ts +4 -1
  131. package/dist/containers/banner/banner.js +9 -1
  132. package/dist/containers/card/card.d.ts +21 -3
  133. package/dist/containers/card/card.js +20 -5
  134. package/dist/containers/description-list/description-list.d.ts +29 -6
  135. package/dist/containers/description-list/description-list.js +47 -6
  136. package/dist/containers/feed/feed.d.ts +23 -0
  137. package/dist/containers/feed/feed.js +77 -0
  138. package/dist/containers/feed/index.d.ts +2 -0
  139. package/dist/containers/feed/index.js +10 -0
  140. package/dist/containers/feed/model.d.ts +19 -0
  141. package/dist/containers/feed/model.js +38 -0
  142. package/dist/containers/grid/grid.d.ts +15 -0
  143. package/dist/containers/grid/grid.js +24 -0
  144. package/dist/containers/grid/index.d.ts +1 -0
  145. package/dist/containers/grid/index.js +4 -0
  146. package/dist/containers/index.d.ts +9 -0
  147. package/dist/containers/index.js +9 -0
  148. package/dist/containers/kpi/kpi.d.ts +60 -7
  149. package/dist/containers/kpi/kpi.js +142 -28
  150. package/dist/containers/kpi-group/index.d.ts +1 -1
  151. package/dist/containers/kpi-group/index.js +3 -1
  152. package/dist/containers/kpi-group/kpi-group.d.ts +9 -1
  153. package/dist/containers/kpi-group/kpi-group.js +11 -1
  154. package/dist/containers/list-detail/index.d.ts +1 -0
  155. package/dist/containers/list-detail/index.js +20 -0
  156. package/dist/containers/list-detail/list-detail.d.ts +55 -0
  157. package/dist/containers/list-detail/list-detail.js +221 -0
  158. package/dist/containers/note/index.d.ts +1 -0
  159. package/dist/containers/note/index.js +4 -0
  160. package/dist/containers/note/note.d.ts +13 -0
  161. package/dist/containers/note/note.js +27 -0
  162. package/dist/containers/page/index.d.ts +1 -0
  163. package/dist/containers/page/index.js +4 -0
  164. package/dist/containers/page/page.d.ts +7 -0
  165. package/dist/containers/page/page.js +14 -0
  166. package/dist/containers/page-header/page-header.d.ts +8 -3
  167. package/dist/containers/page-header/page-header.js +35 -8
  168. package/dist/containers/responsive-list/responsive-list.d.ts +1 -1
  169. package/dist/containers/responsive-list/responsive-list.js +6 -3
  170. package/dist/containers/section/index.d.ts +1 -0
  171. package/dist/containers/section/index.js +6 -0
  172. package/dist/containers/section/section.d.ts +68 -0
  173. package/dist/containers/section/section.js +198 -0
  174. package/dist/containers/shortcuts/index.d.ts +1 -0
  175. package/dist/containers/shortcuts/index.js +8 -0
  176. package/dist/containers/shortcuts/shortcuts.d.ts +18 -0
  177. package/dist/containers/shortcuts/shortcuts.js +50 -0
  178. package/dist/containers/stack/index.d.ts +1 -0
  179. package/dist/containers/stack/index.js +6 -0
  180. package/dist/containers/stack/stack.d.ts +15 -0
  181. package/dist/containers/stack/stack.js +43 -0
  182. package/dist/containers/table/selection.d.ts +9 -0
  183. package/dist/containers/table/selection.js +20 -0
  184. package/dist/containers/table/table.d.ts +66 -4
  185. package/dist/containers/table/table.js +128 -7
  186. package/dist/containers/timeline/index.d.ts +1 -1
  187. package/dist/containers/timeline/index.js +4 -2
  188. package/dist/containers/timeline/timeline.d.ts +32 -5
  189. package/dist/containers/timeline/timeline.js +154 -90
  190. package/dist/forms/chip-group/chip-group.d.ts +54 -0
  191. package/dist/forms/chip-group/chip-group.js +114 -0
  192. package/dist/forms/chip-group/index.d.ts +1 -0
  193. package/dist/forms/chip-group/index.js +6 -0
  194. package/dist/forms/combobox/combobox.d.ts +60 -0
  195. package/dist/forms/combobox/combobox.js +281 -0
  196. package/dist/forms/combobox/index.d.ts +1 -0
  197. package/dist/forms/combobox/index.js +6 -0
  198. package/dist/forms/copy-field/copy-field.d.ts +17 -0
  199. package/dist/forms/copy-field/copy-field.js +72 -0
  200. package/dist/forms/copy-field/index.d.ts +1 -0
  201. package/dist/forms/copy-field/index.js +4 -0
  202. package/dist/forms/date-picker/date-picker.d.ts +40 -0
  203. package/dist/forms/date-picker/date-picker.js +183 -0
  204. package/dist/forms/date-picker/date-time-picker.d.ts +43 -0
  205. package/dist/forms/date-picker/date-time-picker.js +121 -0
  206. package/dist/forms/date-picker/index.d.ts +2 -0
  207. package/dist/forms/date-picker/index.js +10 -0
  208. package/dist/forms/date-picker/model.d.ts +35 -0
  209. package/dist/forms/date-picker/model.js +83 -0
  210. package/dist/forms/dropzone/dropzone.d.ts +30 -2
  211. package/dist/forms/dropzone/dropzone.js +153 -23
  212. package/dist/forms/emoji-picker/emoji-picker.js +1 -1
  213. package/dist/forms/field/field.d.ts +16 -10
  214. package/dist/forms/field/field.js +41 -5
  215. package/dist/forms/form/form.d.ts +15 -0
  216. package/dist/forms/form/form.js +29 -0
  217. package/dist/forms/form/index.d.ts +1 -0
  218. package/dist/forms/form/index.js +10 -0
  219. package/dist/forms/index.d.ts +6 -0
  220. package/dist/forms/index.js +6 -0
  221. package/dist/forms/input/index.d.ts +1 -1
  222. package/dist/forms/input/index.js +6 -2
  223. package/dist/forms/input/input.d.ts +23 -3
  224. package/dist/forms/input/input.js +78 -7
  225. package/dist/forms/input-icon/input-icon.d.ts +1 -1
  226. package/dist/forms/internal/listbox-items.d.ts +18 -0
  227. package/dist/forms/internal/listbox-items.js +88 -0
  228. package/dist/forms/internal/listbox.d.ts +44 -0
  229. package/dist/forms/internal/listbox.js +74 -0
  230. package/dist/forms/number-stepper/model.d.ts +16 -0
  231. package/dist/forms/number-stepper/model.js +23 -0
  232. package/dist/forms/number-stepper/number-stepper.d.ts +36 -6
  233. package/dist/forms/number-stepper/number-stepper.js +86 -37
  234. package/dist/forms/select-menu/index.d.ts +1 -0
  235. package/dist/forms/select-menu/index.js +6 -0
  236. package/dist/forms/select-menu/select-menu.d.ts +35 -0
  237. package/dist/forms/select-menu/select-menu.js +230 -0
  238. package/dist/glass/crystal-map.d.ts +70 -0
  239. package/dist/glass/crystal-map.js +88 -0
  240. package/dist/glass/displacement-map.d.ts +117 -0
  241. package/dist/glass/displacement-map.js +201 -0
  242. package/dist/glass/index.d.ts +8 -0
  243. package/dist/glass/index.js +63 -0
  244. package/dist/glass/lens-crystal.d.ts +29 -0
  245. package/dist/glass/lens-crystal.js +161 -0
  246. package/dist/glass/lens-dispersion.d.ts +11 -0
  247. package/dist/glass/lens-dispersion.js +19 -0
  248. package/dist/glass/liquid-glass.d.ts +41 -0
  249. package/dist/glass/liquid-glass.js +256 -0
  250. package/dist/glass/liquid-motion.d.ts +53 -0
  251. package/dist/glass/liquid-motion.js +302 -0
  252. package/dist/glass/liquid-options.d.ts +162 -0
  253. package/dist/glass/liquid-options.js +179 -0
  254. package/dist/glass/refraction.d.ts +100 -0
  255. package/dist/glass/refraction.js +714 -0
  256. package/dist/glass/specular-map.d.ts +26 -0
  257. package/dist/glass/specular-map.js +75 -0
  258. package/dist/glass/spring.d.ts +79 -0
  259. package/dist/glass/spring.js +58 -0
  260. package/dist/glass/support.d.ts +13 -0
  261. package/dist/glass/support.js +14 -0
  262. package/dist/glass/use-glass-refraction.d.ts +8 -0
  263. package/dist/glass/use-glass-refraction.js +16 -0
  264. package/dist/i18n/strings.d.ts +113 -0
  265. package/dist/i18n/strings.js +70 -2
  266. package/dist/i18n/ui-strings-provider.d.ts +1 -1
  267. package/dist/i18n/ui-strings-provider.js +6 -2
  268. package/dist/icons/index.d.ts +2 -0
  269. package/dist/icons/index.js +4 -0
  270. package/dist/icons/key.d.ts +2 -0
  271. package/dist/icons/key.js +12 -0
  272. package/dist/icons/webhook.d.ts +2 -0
  273. package/dist/icons/webhook.js +12 -0
  274. package/dist/liquid/index.d.ts +3 -0
  275. package/dist/liquid/index.js +29 -0
  276. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +29 -0
  277. package/dist/navigation/breadcrumbs/breadcrumbs.js +70 -0
  278. package/dist/navigation/breadcrumbs/index.d.ts +1 -0
  279. package/dist/navigation/breadcrumbs/index.js +6 -0
  280. package/dist/navigation/index.d.ts +2 -0
  281. package/dist/navigation/index.js +2 -0
  282. package/dist/navigation/segmented/index.d.ts +1 -1
  283. package/dist/navigation/segmented/model.d.ts +5 -0
  284. package/dist/navigation/segmented/model.js +6 -0
  285. package/dist/navigation/segmented/segmented.d.ts +17 -3
  286. package/dist/navigation/segmented/segmented.js +20 -4
  287. package/dist/navigation/stepper/index.d.ts +1 -1
  288. package/dist/navigation/stepper/index.js +3 -1
  289. package/dist/navigation/stepper/stepper.d.ts +8 -0
  290. package/dist/navigation/stepper/stepper.js +68 -45
  291. package/dist/navigation/tabs/index.d.ts +1 -0
  292. package/dist/navigation/tabs/index.js +6 -0
  293. package/dist/navigation/tabs/tabs-nav.d.ts +37 -0
  294. package/dist/navigation/tabs/tabs-nav.js +57 -0
  295. package/dist/navigation/wizard/index.d.ts +1 -0
  296. package/dist/navigation/wizard/index.js +6 -0
  297. package/dist/navigation/wizard/model.d.ts +33 -0
  298. package/dist/navigation/wizard/model.js +34 -0
  299. package/dist/navigation/wizard/wizard.d.ts +45 -0
  300. package/dist/navigation/wizard/wizard.js +169 -0
  301. package/dist/overlays/alert-dialog/alert-dialog.d.ts +103 -0
  302. package/dist/overlays/alert-dialog/alert-dialog.js +342 -0
  303. package/dist/overlays/alert-dialog/index.d.ts +1 -0
  304. package/dist/overlays/alert-dialog/index.js +26 -0
  305. package/dist/overlays/context-menu/context-menu.d.ts +9 -1
  306. package/dist/overlays/context-menu/context-menu.js +4 -1
  307. package/dist/overlays/dialog/dialog.d.ts +9 -1
  308. package/dist/overlays/dialog/dialog.js +3 -0
  309. package/dist/overlays/drawer/drawer.d.ts +9 -1
  310. package/dist/overlays/drawer/drawer.js +3 -0
  311. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +25 -1
  312. package/dist/overlays/dropdown-menu/dropdown-menu.js +14 -4
  313. package/dist/overlays/dropdown-menu/index.d.ts +1 -1
  314. package/dist/overlays/dropdown-menu/index.js +8 -2
  315. package/dist/overlays/hover-card/hover-card.d.ts +10 -1
  316. package/dist/overlays/hover-card/hover-card.js +4 -1
  317. package/dist/overlays/index.d.ts +2 -0
  318. package/dist/overlays/index.js +2 -0
  319. package/dist/overlays/popover/popover.d.ts +9 -1
  320. package/dist/overlays/popover/popover.js +3 -0
  321. package/dist/overlays/testing/index.d.ts +5 -0
  322. package/dist/overlays/testing/index.js +4 -0
  323. package/dist/overlays/toaster/index.d.ts +2 -1
  324. package/dist/overlays/toaster/index.js +4 -2
  325. package/dist/overlays/toaster/toast-store.d.ts +6 -2
  326. package/dist/overlays/toaster/toast.d.ts +3 -0
  327. package/dist/overlays/toaster/toast.js +3 -0
  328. package/dist/overlays/toaster/toaster.d.ts +3 -0
  329. package/dist/overlays/toaster/toaster.js +36 -3
  330. package/dist/overlays/tooltip/index.d.ts +1 -0
  331. package/dist/overlays/tooltip/index.js +4 -0
  332. package/dist/overlays/tooltip/model.d.ts +10 -0
  333. package/dist/overlays/tooltip/model.js +13 -0
  334. package/dist/overlays/tooltip/tooltip.d.ts +41 -0
  335. package/dist/overlays/tooltip/tooltip.js +116 -0
  336. package/dist/palette/command-palette/command-palette.d.ts +12 -2
  337. package/dist/palette/command-palette/command-palette.js +5 -0
  338. package/dist/primitives/command/command.d.ts +3 -2
  339. package/dist/primitives/command/command.js +2 -0
  340. package/dist/primitives/menu/menu.js +1 -1
  341. package/dist/primitives/popper/popper.js +5 -0
  342. package/dist/primitives/use-dismissable-layer.js +1 -1
  343. package/dist/rich-text/rich-text-editor.js +94 -8
  344. package/dist/rich-text/sanitize.js +70 -20
  345. package/dist/shell/app-shell/app-shell.d.ts +17 -0
  346. package/dist/shell/app-shell/app-shell.js +44 -4
  347. package/dist/shell/bottom-nav/bottom-nav.d.ts +34 -0
  348. package/dist/shell/bottom-nav/bottom-nav.js +124 -0
  349. package/dist/shell/bottom-nav/index.d.ts +2 -0
  350. package/dist/shell/bottom-nav/index.js +9 -0
  351. package/dist/shell/bottom-nav/split.d.ts +11 -0
  352. package/dist/shell/bottom-nav/split.js +10 -0
  353. package/dist/shell/sidebar/sidebar.d.ts +16 -2
  354. package/dist/shell/sidebar/sidebar.js +46 -4
  355. package/dist/shell/topbar/topbar.d.ts +20 -9
  356. package/dist/shell/topbar/topbar.js +16 -9
  357. package/dist/states/empty-state/empty-state.d.ts +3 -1
  358. package/dist/states/empty-state/empty-state.js +9 -1
  359. package/dist/states/error-state/error-state.d.ts +8 -1
  360. package/dist/states/error-state/error-state.js +15 -9
  361. package/dist/states/index.d.ts +1 -0
  362. package/dist/states/index.js +1 -0
  363. package/dist/states/live-status-bar/index.d.ts +1 -0
  364. package/dist/states/live-status-bar/index.js +6 -0
  365. package/dist/states/live-status-bar/live-status-bar.d.ts +17 -0
  366. package/dist/states/live-status-bar/live-status-bar.js +49 -0
  367. package/dist/states/offline-banner/offline-banner.d.ts +3 -1
  368. package/dist/states/offline-banner/offline-banner.js +8 -4
  369. package/dist/states/skeleton/skeleton.d.ts +8 -2
  370. package/dist/states/skeleton/skeleton.js +44 -2
  371. package/dist/utils/class-groups.js +17 -0
  372. package/dist/utils/index.d.ts +1 -0
  373. package/dist/utils/index.js +2 -0
  374. package/dist/utils/material.d.ts +13 -0
  375. package/dist/utils/material.js +6 -0
  376. package/dist/utils/tone.d.ts +8 -0
  377. package/dist/utils/tone.js +17 -0
  378. package/dist/utils/use-copy.d.ts +5 -0
  379. package/dist/utils/use-copy.js +35 -0
  380. package/icons/svg/key.svg +5 -0
  381. package/icons/svg/webhook.svg +5 -0
  382. package/package.json +31 -21
  383. package/scripts/build-theme.d.mts +22 -0
  384. package/scripts/build-theme.mjs +248 -5
  385. package/src/ai/attachment/attachment.tsx +1 -1
  386. package/src/ai/chat-list/group.ts +3 -1
  387. package/src/ai/conversation/conversation.tsx +1 -1
  388. package/src/ai/internal/use-copy.ts +1 -38
  389. package/src/ai/markdown/parse.ts +74 -17
  390. package/src/ai/source/source.tsx +1 -1
  391. package/src/atoms/avatar/avatar.tsx +57 -4
  392. package/src/atoms/avatar/index.ts +8 -1
  393. package/src/atoms/button/button.tsx +8 -3
  394. package/src/atoms/checkbox/checkbox.tsx +33 -4
  395. package/src/atoms/chip/chip.tsx +55 -8
  396. package/src/atoms/chip/index.ts +9 -1
  397. package/src/atoms/due-chip/due-chip.tsx +75 -0
  398. package/src/atoms/due-chip/index.ts +2 -0
  399. package/src/atoms/due-chip/model.ts +67 -0
  400. package/src/atoms/icon-button/icon-button.tsx +58 -0
  401. package/src/atoms/icon-button/index.ts +6 -0
  402. package/src/atoms/index.ts +5 -0
  403. package/src/atoms/internal/hit-area.ts +7 -0
  404. package/src/atoms/kbd/index.ts +1 -0
  405. package/src/atoms/kbd/kbd.tsx +20 -0
  406. package/src/atoms/radio-group/radio-group.tsx +8 -2
  407. package/src/atoms/seal/index.ts +1 -0
  408. package/src/atoms/seal/seal.tsx +107 -0
  409. package/src/atoms/spinner/index.ts +1 -0
  410. package/src/atoms/spinner/spinner.tsx +49 -0
  411. package/src/atoms/status-dot/index.ts +1 -0
  412. package/src/atoms/status-dot/status-dot.tsx +15 -3
  413. package/src/atoms/switch/switch.tsx +3 -1
  414. package/src/calendar/date-calendar/date-calendar.tsx +230 -0
  415. package/src/calendar/date-calendar/index.ts +5 -0
  416. package/src/calendar/index.ts +1 -0
  417. package/src/calendar/internal/date-utils.ts +115 -0
  418. package/src/charts/README.md +21 -0
  419. package/src/charts/bar-chart/bar-race-chart.tsx +1 -0
  420. package/src/charts/beeswarm-chart/beeswarm-chart.tsx +1 -1
  421. package/src/charts/chord-chart/chord-chart.tsx +13 -5
  422. package/src/charts/core/cartesian/cartesian-chart.tsx +55 -10
  423. package/src/charts/core/cartesian/layout.ts +29 -10
  424. package/src/charts/core/cartesian/marks.tsx +3 -3
  425. package/src/charts/core/cartesian/types.ts +30 -2
  426. package/src/charts/core/category-explorer.tsx +12 -6
  427. package/src/charts/core/chart-dock.tsx +68 -0
  428. package/src/charts/core/chart-frame.tsx +116 -27
  429. package/src/charts/core/distribution/explorer.tsx +17 -7
  430. package/src/charts/core/distribution/xy-points.tsx +1 -1
  431. package/src/charts/core/index.ts +3 -0
  432. package/src/charts/core/leave-grace.ts +35 -0
  433. package/src/charts/core/nearest.ts +38 -0
  434. package/src/charts/core/plot-overlay.tsx +9 -3
  435. package/src/charts/core/pointer.test-utils.ts +146 -0
  436. package/src/charts/core/tooltip.tsx +129 -15
  437. package/src/charts/core/touch-select.ts +250 -0
  438. package/src/charts/core/types.ts +13 -4
  439. package/src/charts/core/use-index-navigation.ts +70 -11
  440. package/src/charts/donut-chart/donut-chart.tsx +53 -3
  441. package/src/charts/donut-chart/slice-labels.ts +39 -0
  442. package/src/charts/dumbbell-chart/dumbbell-chart.tsx +8 -3
  443. package/src/charts/fill-gauge-chart/fill-gauge-chart.tsx +1 -0
  444. package/src/charts/funnel-chart/funnel-chart.tsx +2 -1
  445. package/src/charts/gauge-chart/gauge-chart.tsx +2 -1
  446. package/src/charts/heatmap-chart/heatmap-chart.tsx +5 -0
  447. package/src/charts/heatmap-chart/heatmap-grid.tsx +5 -1
  448. package/src/charts/hex-tile-map/hex-tile-map.tsx +6 -1
  449. package/src/charts/hierarchy-morph/hierarchy-morph.tsx +2 -1
  450. package/src/charts/icicle-chart/icicle-chart.tsx +8 -9
  451. package/src/charts/lollipop-chart/lollipop-chart.tsx +8 -3
  452. package/src/charts/maps/geo/map-viewport.tsx +1 -1
  453. package/src/charts/polar-area-chart/polar-area-chart.tsx +37 -12
  454. package/src/charts/progress-units/progress-units.tsx +1 -0
  455. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  456. package/src/charts/radial-bar-chart/radial-bar-chart.tsx +2 -1
  457. package/src/charts/range-area-chart/range-area-chart.tsx +3 -2
  458. package/src/charts/sankey-chart/sankey-chart.tsx +12 -4
  459. package/src/charts/tree-chart/tree-chart.tsx +1 -0
  460. package/src/charts/treemap-chart/treemap-chart.tsx +2 -7
  461. package/src/charts/waterfall-chart/waterfall-chart.tsx +8 -3
  462. package/src/containers/action-bar/action-bar.tsx +13 -2
  463. package/src/containers/aside/aside.tsx +40 -0
  464. package/src/containers/aside/index.ts +1 -0
  465. package/src/containers/banner/banner.tsx +18 -1
  466. package/src/containers/card/card.tsx +43 -4
  467. package/src/containers/description-list/description-list.tsx +85 -9
  468. package/src/containers/feed/feed.tsx +99 -0
  469. package/src/containers/feed/index.ts +8 -0
  470. package/src/containers/feed/model.ts +54 -0
  471. package/src/containers/grid/grid.tsx +37 -0
  472. package/src/containers/grid/index.ts +1 -0
  473. package/src/containers/index.ts +9 -0
  474. package/src/containers/kpi/kpi.tsx +231 -38
  475. package/src/containers/kpi-group/index.ts +7 -1
  476. package/src/containers/kpi-group/kpi-group.tsx +26 -1
  477. package/src/containers/list-detail/index.ts +15 -0
  478. package/src/containers/list-detail/list-detail.tsx +293 -0
  479. package/src/containers/note/index.ts +1 -0
  480. package/src/containers/note/note.tsx +38 -0
  481. package/src/containers/page/index.ts +1 -0
  482. package/src/containers/page/page.tsx +17 -0
  483. package/src/containers/page-header/page-header.tsx +38 -8
  484. package/src/containers/responsive-list/responsive-list.tsx +7 -4
  485. package/src/containers/section/index.ts +11 -0
  486. package/src/containers/section/section.tsx +281 -0
  487. package/src/containers/shortcuts/index.ts +6 -0
  488. package/src/containers/shortcuts/shortcuts.tsx +92 -0
  489. package/src/containers/stack/index.ts +7 -0
  490. package/src/containers/stack/stack.tsx +55 -0
  491. package/src/containers/table/selection.ts +26 -0
  492. package/src/containers/table/table.tsx +215 -13
  493. package/src/containers/timeline/index.ts +3 -0
  494. package/src/containers/timeline/timeline.tsx +204 -93
  495. package/src/forms/chip-group/chip-group.tsx +184 -0
  496. package/src/forms/chip-group/index.ts +8 -0
  497. package/src/forms/combobox/combobox.tsx +359 -0
  498. package/src/forms/combobox/index.ts +7 -0
  499. package/src/forms/copy-field/copy-field.tsx +88 -0
  500. package/src/forms/copy-field/index.ts +1 -0
  501. package/src/forms/date-picker/date-picker.tsx +239 -0
  502. package/src/forms/date-picker/date-time-picker.tsx +178 -0
  503. package/src/forms/date-picker/index.ts +10 -0
  504. package/src/forms/date-picker/model.ts +108 -0
  505. package/src/forms/dropzone/dropzone.tsx +217 -35
  506. package/src/forms/emoji-picker/emoji-picker.tsx +1 -1
  507. package/src/forms/field/field.tsx +72 -7
  508. package/src/forms/form/form.tsx +46 -0
  509. package/src/forms/form/index.ts +8 -0
  510. package/src/forms/index.ts +6 -0
  511. package/src/forms/input/index.ts +8 -1
  512. package/src/forms/input/input.tsx +103 -7
  513. package/src/forms/input-icon/input-icon.tsx +1 -1
  514. package/src/forms/internal/listbox-items.tsx +103 -0
  515. package/src/forms/internal/listbox.ts +124 -0
  516. package/src/forms/number-stepper/model.ts +35 -0
  517. package/src/forms/number-stepper/number-stepper.tsx +132 -42
  518. package/src/forms/select-menu/index.ts +7 -0
  519. package/src/forms/select-menu/select-menu.tsx +280 -0
  520. package/src/glass/crystal-map.ts +150 -0
  521. package/src/glass/displacement-map.ts +317 -0
  522. package/src/glass/index.ts +43 -0
  523. package/src/glass/lens-crystal.ts +226 -0
  524. package/src/glass/lens-dispersion.ts +34 -0
  525. package/src/glass/liquid-glass.tsx +371 -0
  526. package/src/glass/liquid-motion.ts +395 -0
  527. package/src/glass/liquid-options.ts +306 -0
  528. package/src/glass/refraction.ts +1010 -0
  529. package/src/glass/specular-map.ts +95 -0
  530. package/src/glass/spring.ts +98 -0
  531. package/src/glass/support.ts +27 -0
  532. package/src/glass/use-glass-refraction.ts +21 -0
  533. package/src/i18n/strings.ts +113 -0
  534. package/src/i18n/ui-strings-provider.tsx +15 -4
  535. package/src/icons/index.ts +2 -0
  536. package/src/icons/key.tsx +13 -0
  537. package/src/icons/webhook.tsx +13 -0
  538. package/src/liquid/index.ts +24 -0
  539. package/src/navigation/breadcrumbs/breadcrumbs.tsx +103 -0
  540. package/src/navigation/breadcrumbs/index.ts +8 -0
  541. package/src/navigation/index.ts +2 -0
  542. package/src/navigation/segmented/index.ts +1 -0
  543. package/src/navigation/segmented/model.ts +11 -0
  544. package/src/navigation/segmented/segmented.tsx +45 -6
  545. package/src/navigation/stepper/index.ts +7 -1
  546. package/src/navigation/stepper/stepper.tsx +41 -5
  547. package/src/navigation/tabs/index.ts +7 -0
  548. package/src/navigation/tabs/tabs-nav.tsx +131 -0
  549. package/src/navigation/wizard/index.ts +7 -0
  550. package/src/navigation/wizard/model.ts +61 -0
  551. package/src/navigation/wizard/wizard.tsx +222 -0
  552. package/src/overlays/alert-dialog/alert-dialog.tsx +486 -0
  553. package/src/overlays/alert-dialog/index.ts +19 -0
  554. package/src/overlays/context-menu/context-menu.tsx +11 -1
  555. package/src/overlays/dialog/dialog.tsx +10 -0
  556. package/src/overlays/drawer/drawer.tsx +10 -0
  557. package/src/overlays/dropdown-menu/dropdown-menu.tsx +38 -4
  558. package/src/overlays/dropdown-menu/index.ts +3 -0
  559. package/src/overlays/hover-card/hover-card.tsx +12 -1
  560. package/src/overlays/index.ts +2 -0
  561. package/src/overlays/popover/popover.tsx +10 -0
  562. package/src/overlays/testing/index.ts +5 -0
  563. package/src/overlays/toaster/index.ts +2 -0
  564. package/src/overlays/toaster/toast-store.ts +6 -2
  565. package/src/overlays/toaster/toast.ts +6 -0
  566. package/src/overlays/toaster/toaster.tsx +44 -2
  567. package/src/overlays/tooltip/index.ts +1 -0
  568. package/src/overlays/tooltip/model.ts +18 -0
  569. package/src/overlays/tooltip/tooltip.tsx +166 -0
  570. package/src/palette/command-palette/command-palette.tsx +15 -1
  571. package/src/primitives/command/command.tsx +4 -0
  572. package/src/primitives/menu/menu.tsx +1 -1
  573. package/src/primitives/popper/popper.tsx +10 -0
  574. package/src/primitives/use-dismissable-layer.ts +7 -2
  575. package/src/rich-text/rich-text-editor.tsx +116 -13
  576. package/src/rich-text/sanitize.ts +94 -23
  577. package/src/shell/app-shell/app-shell.tsx +60 -4
  578. package/src/shell/bottom-nav/bottom-nav.tsx +187 -0
  579. package/src/shell/bottom-nav/index.ts +8 -0
  580. package/src/shell/bottom-nav/split.ts +20 -0
  581. package/src/shell/sidebar/sidebar.tsx +51 -5
  582. package/src/shell/topbar/topbar.tsx +81 -58
  583. package/src/states/empty-state/empty-state.tsx +11 -1
  584. package/src/states/error-state/error-state.tsx +23 -8
  585. package/src/states/index.ts +1 -0
  586. package/src/states/live-status-bar/index.ts +6 -0
  587. package/src/states/live-status-bar/live-status-bar.tsx +62 -0
  588. package/src/states/offline-banner/offline-banner.tsx +13 -5
  589. package/src/states/skeleton/skeleton.tsx +68 -2
  590. package/src/utils/class-groups.ts +17 -0
  591. package/src/utils/index.ts +1 -0
  592. package/src/utils/material.ts +16 -0
  593. package/src/utils/tone.ts +29 -0
  594. package/src/utils/use-copy.ts +38 -0
  595. package/styles/Theme.kt +64 -3
  596. package/styles/base.css +51 -0
  597. package/styles/tailwind.css +836 -0
  598. package/styles/theme.css +579 -34
  599. package/styles/tokens.css +788 -15
  600. package/tokens/default.json +918 -29
  601. package/scripts/build-theme.d.ts +0 -18
@@ -19,10 +19,19 @@ export interface KpiGroupItem {
19
19
  description?: ReactNode;
20
20
  }
21
21
 
22
+ export type KpiGroupLayout = "divided" | "auto-fit";
23
+
22
24
  export type KpiGroupPart = "root" | "list" | "item" | "label" | "value" | "trend" | "description";
23
25
 
24
26
  export interface KpiGroupProps extends Omit<ComponentPropsWithoutRef<"dl">, "children"> {
25
27
  items: KpiGroupItem[];
28
+ /**
29
+ * `divided` (default): one card, 1, 2 or 4 columns by container width. `auto-fit`: separate
30
+ * cards in as many columns as fit `minItemWidth`.
31
+ */
32
+ layout?: KpiGroupLayout;
33
+ /** Minimum tile width in px for `layout="auto-fit"`. */
34
+ minItemWidth?: number;
26
35
  /** Animate numeric values counting up. */
27
36
  animate?: boolean;
28
37
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root wrapper and is merged last. */
@@ -35,17 +44,32 @@ export interface KpiGroupProps extends Omit<ComponentPropsWithoutRef<"dl">, "chi
35
44
  */
36
45
  export function KpiGroup({
37
46
  items,
47
+ layout = "divided",
48
+ minItemWidth = 150,
38
49
  animate = true,
39
50
  className,
40
51
  classNames,
52
+ style,
41
53
  ...props
42
54
  }: KpiGroupProps) {
55
+ const autoFit = layout === "auto-fit";
43
56
  return (
44
57
  <div className={cn("@container/kpi-group min-w-0", classNames?.root, className)}>
45
58
  <dl
46
59
  {...props}
60
+ style={
61
+ autoFit
62
+ ? {
63
+ gridTemplateColumns: `repeat(auto-fit, minmax(min(100%, ${minItemWidth}px), 1fr))`,
64
+ ...style,
65
+ }
66
+ : style
67
+ }
47
68
  className={cn(
48
- "m-0 grid grid-cols-1 gap-px overflow-hidden rounded-card border-card bg-divider shadow-card @sm/kpi-group:grid-cols-2 @3xl/kpi-group:grid-cols-4",
69
+ "m-0 grid",
70
+ autoFit
71
+ ? "gap-density"
72
+ : "grid-cols-1 gap-px overflow-hidden rounded-card border-card bg-divider shadow-card @sm/kpi-group:grid-cols-2 @3xl/kpi-group:grid-cols-4",
49
73
  classNames?.list,
50
74
  )}
51
75
  >
@@ -54,6 +78,7 @@ export function KpiGroup({
54
78
  key={item.id}
55
79
  className={cn(
56
80
  "surface-card flex min-w-0 flex-col gap-density-sm p-card",
81
+ autoFit && "rounded-card border-card shadow-card",
57
82
  classNames?.item,
58
83
  )}
59
84
  >
@@ -0,0 +1,15 @@
1
+ export {
2
+ ListDetail,
3
+ ListDetailDetail,
4
+ ListDetailDetailHeader,
5
+ type ListDetailDetailHeaderProps,
6
+ type ListDetailDetailProps,
7
+ ListDetailItem,
8
+ type ListDetailItemProps,
9
+ ListDetailList,
10
+ type ListDetailListProps,
11
+ ListDetailMeta,
12
+ type ListDetailProps,
13
+ ListDetailTitle,
14
+ useListDetail,
15
+ } from "./list-detail.js";
@@ -0,0 +1,293 @@
1
+ "use client";
2
+
3
+ import {
4
+ type ComponentPropsWithoutRef,
5
+ createContext,
6
+ type ReactNode,
7
+ useCallback,
8
+ useContext,
9
+ useEffect,
10
+ useId,
11
+ useLayoutEffect,
12
+ useMemo,
13
+ useRef,
14
+ useState,
15
+ } from "react";
16
+ import { useUiStrings } from "../../i18n/index.js";
17
+ import { ChevronLeft } from "../../icons/index.js";
18
+ import { cn } from "../../utils/cn.js";
19
+ import { composeHandlers } from "../../utils/compose.js";
20
+ import { useControllableState } from "../../utils/use-controllable-state.js";
21
+
22
+ interface ListDetailContextValue {
23
+ value: string | null;
24
+ select: (value: string | null) => void;
25
+ label: string;
26
+ }
27
+
28
+ const ListDetailContext = createContext<ListDetailContextValue | null>(null);
29
+
30
+ function useListDetailContext(part: string): ListDetailContextValue {
31
+ const context = useContext(ListDetailContext);
32
+ if (!context) throw new Error(`\`${part}\` must be used within \`ListDetail\``);
33
+ return context;
34
+ }
35
+
36
+ /** The selected item id (`null` while none) and a way to change it, for content inside the detail pane. */
37
+ export function useListDetail() {
38
+ const { value, select } = useListDetailContext("useListDetail");
39
+ return { value, select, isSelected: (candidate: string) => candidate === value };
40
+ }
41
+
42
+ export interface ListDetailProps
43
+ extends Omit<ComponentPropsWithoutRef<"div">, "defaultValue" | "onChange"> {
44
+ /** Controlled selected item id; `null` means none (the single-pane view then shows the list). */
45
+ value?: string | null | undefined;
46
+ defaultValue?: string | null | undefined;
47
+ /**
48
+ * Called with the id the user chose. It is never called with `null`: going back to the list
49
+ * calls `onBack` instead, so a handler that loads the selected record never sees "no record".
50
+ */
51
+ onValueChange?: ((value: string) => void) | undefined;
52
+ /**
53
+ * Called when the back action (or `select(null)` from `useListDetail`) clears the selection.
54
+ * Uncontrolled, the list shows again on its own; controlled, set `value` to `null` here.
55
+ */
56
+ onBack?: (() => void) | undefined;
57
+ /** Names the list of items. */
58
+ "aria-label": string;
59
+ children: ReactNode;
60
+ }
61
+
62
+ /**
63
+ * Master-detail: a list of items beside the detail of the selected one. Under 641px of its own
64
+ * width it collapses to a single pane: the list until an item is chosen, then the detail with a
65
+ * back action (focus follows the change). Panes render flush to the container's inline edges.
66
+ */
67
+ export function ListDetail({
68
+ value: valueProp,
69
+ defaultValue = null,
70
+ onValueChange,
71
+ onBack,
72
+ "aria-label": label,
73
+ className,
74
+ children,
75
+ ...props
76
+ }: ListDetailProps) {
77
+ const [value, setValue] = useControllableState<string | null>({
78
+ prop: valueProp,
79
+ defaultProp: defaultValue,
80
+ onChange: (next) => {
81
+ if (next !== null) onValueChange?.(next);
82
+ },
83
+ });
84
+ const onBackRef = useRef(onBack);
85
+ onBackRef.current = onBack;
86
+ const select = useCallback(
87
+ (next: string | null) => {
88
+ setValue(next);
89
+ if (next === null) onBackRef.current?.();
90
+ },
91
+ [setValue],
92
+ );
93
+ const rootRef = useRef<HTMLDivElement>(null);
94
+ const previous = useRef<string | null>(value);
95
+
96
+ useEffect(() => {
97
+ const before = previous.current;
98
+ previous.current = value;
99
+ const root = rootRef.current;
100
+ if (before === value || !root) return;
101
+ if (value === null && before !== null) {
102
+ root.querySelector<HTMLElement>(`[data-list-detail-item="${CSS.escape(before)}"]`)?.focus();
103
+ return;
104
+ }
105
+ const detail = root.querySelector<HTMLElement>('[data-list-detail-pane="detail"]');
106
+ // Only when the detail replaced the list (single pane): beside the list, focus stays put.
107
+ const back = detail?.querySelector<HTMLElement>("[data-list-detail-back]");
108
+ if (detail && back && back.getClientRects().length > 0) detail.focus();
109
+ }, [value]);
110
+
111
+ const context = useMemo(() => ({ value, select, label }), [value, select, label]);
112
+
113
+ return (
114
+ <ListDetailContext.Provider value={context}>
115
+ <div {...props} ref={rootRef} className={cn("@container/list-detail min-w-0", className)}>
116
+ <div
117
+ data-view={value === null ? "list" : "detail"}
118
+ className={cn(
119
+ "group/ld grid grid-cols-1 border-t-divider",
120
+ "@min-[641px]/list-detail:grid-cols-2",
121
+ "[&>*]:min-w-0",
122
+ )}
123
+ >
124
+ {children}
125
+ </div>
126
+ </div>
127
+ </ListDetailContext.Provider>
128
+ );
129
+ }
130
+
131
+ export type ListDetailListProps = Omit<ComponentPropsWithoutRef<"ul">, "aria-label">;
132
+
133
+ export function ListDetailList({ className, ...props }: ListDetailListProps) {
134
+ const { label } = useListDetailContext("ListDetailList");
135
+ return (
136
+ <ul
137
+ data-list-detail-pane="list"
138
+ aria-label={label}
139
+ className={cn(
140
+ "m-0 flex list-none flex-col p-0",
141
+ "@min-[641px]/list-detail:border-r-divider",
142
+ "group-data-[view=detail]/ld:@max-[640px]/list-detail:hidden",
143
+ className,
144
+ )}
145
+ {...props}
146
+ />
147
+ );
148
+ }
149
+
150
+ export interface ListDetailItemProps extends Omit<ComponentPropsWithoutRef<"button">, "value"> {
151
+ value: string;
152
+ /** End slot: a count, a status chip, a time. */
153
+ trailing?: ReactNode;
154
+ }
155
+
156
+ export function ListDetailItem({
157
+ value,
158
+ trailing,
159
+ className,
160
+ children,
161
+ onClick,
162
+ ...props
163
+ }: ListDetailItemProps) {
164
+ const { value: selected, select } = useListDetailContext("ListDetailItem");
165
+ const isSelected = selected === value;
166
+ return (
167
+ <li>
168
+ <button
169
+ type="button"
170
+ data-list-detail-item={value}
171
+ aria-current={isSelected ? "true" : undefined}
172
+ onClick={composeHandlers(onClick, () => select(value))}
173
+ className={cn(
174
+ "grid min-h-11 w-full cursor-pointer grid-cols-[minmax(0,1fr)_auto] items-center gap-3 border-b-divider py-2.5 text-start hover:bg-surface-2 focus-visible:-outline-offset-2 focus-visible:focus-ring aria-[current=true]:bg-accent-soft",
175
+ className,
176
+ )}
177
+ {...props}
178
+ >
179
+ <span className="min-w-0">{children}</span>
180
+ {trailing !== undefined ? (
181
+ <span className="min-w-0 justify-self-end">{trailing}</span>
182
+ ) : null}
183
+ </button>
184
+ </li>
185
+ );
186
+ }
187
+
188
+ export function ListDetailTitle({ className, ...props }: ComponentPropsWithoutRef<"span">) {
189
+ return <span className={cn("block font-medium text-ink", className)} {...props} />;
190
+ }
191
+
192
+ export function ListDetailMeta({ className, ...props }: ComponentPropsWithoutRef<"span">) {
193
+ return <span className={cn("block text-meta text-ink-3", className)} {...props} />;
194
+ }
195
+
196
+ interface DetailTitleValue {
197
+ titleId: string;
198
+ register: () => () => void;
199
+ }
200
+
201
+ const DetailTitleContext = createContext<DetailTitleValue | null>(null);
202
+
203
+ export interface ListDetailDetailProps extends ComponentPropsWithoutRef<"section"> {
204
+ /** Label of the back action shown in the single-pane view. Defaults to the localized "Back to list". */
205
+ backLabel?: string;
206
+ /** Hides the back action (the consumer then provides its own way back). */
207
+ hideBack?: boolean;
208
+ }
209
+
210
+ /** The detail pane. A labelled region named by its `ListDetailDetailHeader` title or an `aria-label`. */
211
+ export function ListDetailDetail({
212
+ backLabel,
213
+ hideBack = false,
214
+ className,
215
+ children,
216
+ ...props
217
+ }: ListDetailDetailProps) {
218
+ const strings = useUiStrings();
219
+ const { select } = useListDetailContext("ListDetailDetail");
220
+ const titleId = useId();
221
+ const [titled, setTitled] = useState(0);
222
+ const register = useCallback(() => {
223
+ setTitled((count) => count + 1);
224
+ return () => setTitled((count) => count - 1);
225
+ }, []);
226
+ const context = useMemo(() => ({ titleId, register }), [titleId, register]);
227
+ return (
228
+ <DetailTitleContext.Provider value={context}>
229
+ <section
230
+ data-list-detail-pane="detail"
231
+ tabIndex={-1}
232
+ aria-labelledby={titled > 0 && props["aria-label"] === undefined ? titleId : undefined}
233
+ {...props}
234
+ className={cn(
235
+ "flex min-w-0 flex-col outline-none",
236
+ "group-data-[view=list]/ld:@max-[640px]/list-detail:hidden",
237
+ className,
238
+ )}
239
+ >
240
+ {hideBack ? null : (
241
+ <button
242
+ type="button"
243
+ data-list-detail-back=""
244
+ onClick={() => select(null)}
245
+ className={cn(
246
+ "inline-flex min-h-11 cursor-pointer items-center gap-1 self-start text-control text-ink-2 hover:text-ink focus-visible:focus-ring",
247
+ "@min-[641px]/list-detail:hidden",
248
+ )}
249
+ >
250
+ <ChevronLeft aria-hidden="true" className="size-4" />
251
+ {backLabel ?? strings.backToList}
252
+ </button>
253
+ )}
254
+ {children}
255
+ </section>
256
+ </DetailTitleContext.Provider>
257
+ );
258
+ }
259
+
260
+ export interface ListDetailDetailHeaderProps
261
+ extends Omit<ComponentPropsWithoutRef<"div">, "title"> {
262
+ title: ReactNode;
263
+ description?: ReactNode;
264
+ actions?: ReactNode;
265
+ }
266
+
267
+ export function ListDetailDetailHeader({
268
+ title,
269
+ description,
270
+ actions,
271
+ className,
272
+ ...props
273
+ }: ListDetailDetailHeaderProps) {
274
+ const detail = useContext(DetailTitleContext);
275
+ const register = detail?.register;
276
+ useLayoutEffect(() => register?.(), [register]);
277
+ return (
278
+ <div
279
+ className={cn("flex flex-wrap items-start justify-between gap-3 pt-4 pb-3", className)}
280
+ {...props}
281
+ >
282
+ <div className="min-w-0">
283
+ <h3 id={detail?.titleId} className="m-0 font-semibold text-body text-ink">
284
+ {title}
285
+ </h3>
286
+ {description !== undefined ? (
287
+ <p className="m-0 mt-0.5 text-meta text-ink-3">{description}</p>
288
+ ) : null}
289
+ </div>
290
+ {actions !== undefined ? <div className="flex flex-wrap gap-2">{actions}</div> : null}
291
+ </div>
292
+ );
293
+ }
@@ -0,0 +1 @@
1
+ export { Note, type NoteProps, type NoteTone } from "./note.js";
@@ -0,0 +1,38 @@
1
+ import type { ComponentPropsWithoutRef } from "react";
2
+ import { cn } from "../../utils/cn.js";
3
+
4
+ export type NoteTone = "neutral" | "info" | "success" | "warning" | "danger";
5
+
6
+ const toneClasses: Record<NoteTone, string> = {
7
+ neutral: "text-ink-3",
8
+ info: "text-info",
9
+ success: "text-success",
10
+ warning: "text-warning",
11
+ danger: "text-danger",
12
+ };
13
+
14
+ export interface NoteProps extends ComponentPropsWithoutRef<"p"> {
15
+ /** Colors the text. Defaults to `neutral`. */
16
+ tone?: NoteTone;
17
+ /** Hairline above the note, to hang it under a block it explains. */
18
+ divider?: boolean;
19
+ }
20
+
21
+ /**
22
+ * Small annotated text under a block: explains a rule, a caveat or an empty state. Flush to its
23
+ * container's inline edges; tone only changes the text color, so it never carries meaning alone.
24
+ */
25
+ export function Note({ tone = "neutral", divider = false, className, ...props }: NoteProps) {
26
+ return (
27
+ <p
28
+ data-tone={tone}
29
+ className={cn(
30
+ "m-0 text-meta",
31
+ divider && "border-t-divider pt-2.5",
32
+ toneClasses[tone],
33
+ className,
34
+ )}
35
+ {...props}
36
+ />
37
+ );
38
+ }
@@ -0,0 +1 @@
1
+ export { Page, type PageProps } from "./page.js";
@@ -0,0 +1,17 @@
1
+ import type { ComponentPropsWithoutRef } from "react";
2
+ import { cn } from "../../utils/cn.js";
3
+
4
+ export type PageProps = ComponentPropsWithoutRef<"div">;
5
+
6
+ /**
7
+ * Vertical flow of page sections. It is the `page` container, so `Cols` and `SettingsLayout`
8
+ * inside it react to the page width instead of the viewport.
9
+ */
10
+ export function Page({ className, ...props }: PageProps) {
11
+ return (
12
+ <div
13
+ className={cn("@container/page flex w-full min-w-0 flex-col gap-6", className)}
14
+ {...props}
15
+ />
16
+ );
17
+ }
@@ -1,26 +1,50 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithoutRef, ReactNode } from "react";
2
2
  import { cn } from "../../utils/cn.js";
3
3
 
4
- export type PageHeaderProps = ComponentPropsWithoutRef<"header">;
4
+ export interface PageHeaderProps extends ComponentPropsWithoutRef<"header"> {
5
+ /** Trail shown on its own row above the title, usually a `Breadcrumbs`. */
6
+ breadcrumbs?: ReactNode;
7
+ /** Tighter, centred header with a smaller title and a body-size lede. */
8
+ compact?: boolean;
9
+ }
5
10
 
6
11
  /**
7
12
  * Page header. No required parts: compose an eyebrow / title / lede block in
8
13
  * a plain `<div>` and, when the view has buttons, `PageHeaderActions` as the
9
14
  * second child. Actions wrap under the title when the container is too narrow.
10
15
  */
11
- export function PageHeader({ className, ...props }: PageHeaderProps) {
16
+ export function PageHeader({
17
+ breadcrumbs,
18
+ className,
19
+ compact,
20
+ children,
21
+ ...props
22
+ }: PageHeaderProps) {
12
23
  return (
13
24
  <header
14
- className={cn("flex flex-wrap items-end justify-between gap-x-6 gap-y-3.5", className)}
25
+ data-compact={compact ? "" : undefined}
26
+ className={cn(
27
+ "flex flex-wrap items-end justify-between gap-x-6 gap-y-3.5",
28
+ compact && "flex-col items-center justify-center gap-y-2 text-center",
29
+ className,
30
+ )}
15
31
  {...props}
16
- />
32
+ >
33
+ {breadcrumbs ? <div className="basis-full">{breadcrumbs}</div> : null}
34
+ {children}
35
+ </header>
17
36
  );
18
37
  }
19
38
 
20
39
  export type PageHeaderEyebrowProps = ComponentPropsWithoutRef<"div">;
21
40
 
22
41
  export function PageHeaderEyebrow({ className, ...props }: PageHeaderEyebrowProps) {
23
- return <div className={cn("mb-1 font-semibold text-fs-120 text-ink-3", className)} {...props} />;
42
+ return (
43
+ <div
44
+ className={cn("mb-1 font-semibold text-fs-120 text-ink-3 in-data-compact:mb-0.5", className)}
45
+ {...props}
46
+ />
47
+ );
24
48
  }
25
49
 
26
50
  export type PageHeaderTitleProps = ComponentPropsWithoutRef<"h1">;
@@ -29,7 +53,10 @@ export type PageHeaderTitleProps = ComponentPropsWithoutRef<"h1">;
29
53
  export function PageHeaderTitle({ className, ...props }: PageHeaderTitleProps) {
30
54
  return (
31
55
  <h1
32
- className={cn("m-0 break-words text-page-title [text-wrap:balance]", className)}
56
+ className={cn(
57
+ "m-0 break-words text-page-title [text-wrap:balance] in-data-compact:text-fs-220",
58
+ className,
59
+ )}
33
60
  {...props}
34
61
  />
35
62
  );
@@ -40,7 +67,10 @@ export type PageHeaderLedeProps = ComponentPropsWithoutRef<"p">;
40
67
  export function PageHeaderLede({ className, ...props }: PageHeaderLedeProps) {
41
68
  return (
42
69
  <p
43
- className={cn("mt-1.25 max-w-[68ch] break-words text-lede text-ink-2", className)}
70
+ className={cn(
71
+ "mt-1.25 max-w-[68ch] break-words text-lede text-ink-2 in-data-compact:mt-0.5 in-data-compact:text-body",
72
+ className,
73
+ )}
44
74
  {...props}
45
75
  />
46
76
  );
@@ -50,7 +50,7 @@ export interface ResponsiveListProps<T> {
50
50
  classNames?: ClassNames<ResponsiveListPart>;
51
51
  }
52
52
 
53
- /** A table from `md` up and a stack of cards below it, from one column definition. */
53
+ /** A table once its own container is 42rem wide and a stack of cards below that, from one column definition. */
54
54
  export function ResponsiveList<T>({
55
55
  caption,
56
56
  items,
@@ -67,10 +67,10 @@ export function ResponsiveList<T>({
67
67
  const details = columns.filter((column) => column !== primary);
68
68
 
69
69
  return (
70
- <div className={cn("min-w-0", classNames?.root, className)}>
70
+ <div className={cn("@container/responsive-list min-w-0", classNames?.root, className)}>
71
71
  <div
72
72
  className={cn(
73
- "hidden rounded-card border-card shadow-card surface-card md:block",
73
+ "hidden rounded-card border-card shadow-card surface-card @min-[42rem]/responsive-list:block",
74
74
  classNames?.tableWrapper,
75
75
  )}
76
76
  >
@@ -116,7 +116,10 @@ export function ResponsiveList<T>({
116
116
  </div>
117
117
  <ul
118
118
  aria-label={caption}
119
- className={cn("m-0 flex list-none flex-col gap-density p-0 md:hidden", classNames?.cards)}
119
+ className={cn(
120
+ "m-0 flex list-none flex-col gap-density p-0 @min-[42rem]/responsive-list:hidden",
121
+ classNames?.cards,
122
+ )}
120
123
  >
121
124
  {items.map((item) => (
122
125
  <li
@@ -0,0 +1,11 @@
1
+ export {
2
+ Section,
3
+ type SectionActionsProps,
4
+ type SectionBodyProps,
5
+ type SectionCountProps,
6
+ type SectionDescriptionProps,
7
+ type SectionHeaderProps,
8
+ type SectionPart,
9
+ type SectionProps,
10
+ type SectionTitleProps,
11
+ } from "./section.js";