@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
@@ -1,21 +1,59 @@
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 DescriptionListProps = ComponentPropsWithoutRef<"dl">;
4
+ export type DescriptionListLayout = "auto" | "inline" | "stacked";
5
+
6
+ export interface DescriptionListProps extends ComponentPropsWithoutRef<"dl"> {
7
+ /**
8
+ * `auto` (default) puts the term beside the value and stacks them when the list's own container
9
+ * is narrower than 24rem; `inline` never stacks; `stacked` always puts the term over the value.
10
+ */
11
+ layout?: DescriptionListLayout;
12
+ /** Side the values align to. Defaults to `end` (right in LTR); `start` reads like a form summary. */
13
+ valueAlign?: "end" | "start";
14
+ /** Pairs per row once the container is at least 28rem wide; one column below. Defaults to 1. */
15
+ columns?: 1 | 2 | 3;
16
+ }
17
+
18
+ const layoutClasses: Record<DescriptionListLayout, string> = {
19
+ auto: "grid-cols-[auto_minmax(0,1fr)] @max-sm/dl:grid-cols-1 @max-sm/dl:gap-y-0.5 @max-sm/dl:[&_dd]:mb-2 @max-sm/dl:[&_dd]:text-start",
20
+ inline: "grid-cols-[auto_minmax(0,1fr)]",
21
+ stacked: "grid-cols-1 gap-y-0.5 [&_dd]:mb-2 [&_dd]:text-start",
22
+ };
23
+
24
+ const columnClasses: Record<DescriptionListLayout, Record<2 | 3, string>> = {
25
+ auto: {
26
+ 2: "@md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)]",
27
+ 3: "@md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)_auto_minmax(0,1fr)]",
28
+ },
29
+ inline: {
30
+ 2: "grid-cols-[auto_minmax(0,1fr)] @md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)]",
31
+ 3: "grid-cols-[auto_minmax(0,1fr)] @md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)_auto_minmax(0,1fr)]",
32
+ },
33
+ stacked: { 2: "@md/dl:grid-cols-2", 3: "@md/dl:grid-cols-3" },
34
+ };
5
35
 
6
36
  /**
7
- * Two-column definition list (auto term / flexible value aligned right); stacks term over
8
- * value when its own container is narrower than 24rem.
9
- * Compose flat `<dt>`/`<dd>` pairs as children.
37
+ * Key-value list: terms and values in a grid, no page padding. Compose flat `<dt>`/`<dd>` pairs
38
+ * or `DescriptionListItem`s (which fill an empty value with a placeholder) as children. Layout
39
+ * (`auto`/`inline`/`stacked`), value alignment and multi-column rows are container-query driven.
10
40
  */
11
- export function DescriptionList({ className, ...props }: DescriptionListProps) {
41
+ export function DescriptionList({
42
+ className,
43
+ layout = "auto",
44
+ valueAlign = "end",
45
+ columns = 1,
46
+ ...props
47
+ }: DescriptionListProps) {
12
48
  return (
13
49
  <div className="@container/dl min-w-0">
14
50
  <dl
15
51
  className={cn(
16
- "grid grid-cols-[auto_minmax(0,1fr)] gap-x-4 gap-y-2.25 text-fs-130",
17
- "[&_dt]:text-ink-3 [&_dd]:m-0 [&_dd]:min-w-0 [&_dd]:break-words [&_dd]:text-right [&_dd]:font-semibold",
18
- "@max-sm/dl:grid-cols-1 @max-sm/dl:gap-y-0.5 @max-sm/dl:[&_dd]:mb-2 @max-sm/dl:[&_dd]:text-left",
52
+ "grid gap-x-4 gap-y-2.25 text-fs-130",
53
+ "[&_dt]:text-ink-3 [&_dd]:m-0 [&_dd]:min-w-0 [&_dd]:break-words [&_dd]:font-semibold",
54
+ valueAlign === "end" ? "[&_dd]:text-end" : "[&_dd]:text-start",
55
+ layoutClasses[layout],
56
+ columns !== 1 && columnClasses[layout][columns],
19
57
  className,
20
58
  )}
21
59
  {...props}
@@ -23,3 +61,41 @@ export function DescriptionList({ className, ...props }: DescriptionListProps) {
23
61
  </div>
24
62
  );
25
63
  }
64
+
65
+ export interface DescriptionListItemProps {
66
+ term: ReactNode;
67
+ /** The value. `null`, `undefined`, `false` and `""` render the placeholder instead. */
68
+ children?: ReactNode;
69
+ /** Shown for an empty value. Defaults to an em dash. */
70
+ placeholder?: ReactNode;
71
+ /** Screen-reader text for an empty value (the placeholder itself is decorative). */
72
+ emptyLabel?: string;
73
+ className?: string;
74
+ }
75
+
76
+ /** A `dt`/`dd` pair placed straight in the grid, with a placeholder for a missing value. */
77
+ export function DescriptionListItem({
78
+ term,
79
+ children,
80
+ placeholder = "—",
81
+ emptyLabel,
82
+ className,
83
+ }: DescriptionListItemProps) {
84
+ const empty =
85
+ children === null || children === undefined || children === false || children === "";
86
+ return (
87
+ <>
88
+ <dt>{term}</dt>
89
+ <dd data-empty={empty ? "" : undefined} className={className}>
90
+ {empty ? (
91
+ <>
92
+ <span aria-hidden="true">{placeholder}</span>
93
+ {emptyLabel ? <span className="sr-only">{emptyLabel}</span> : null}
94
+ </>
95
+ ) : (
96
+ children
97
+ )}
98
+ </dd>
99
+ </>
100
+ );
101
+ }
@@ -0,0 +1,99 @@
1
+ "use client";
2
+
3
+ import type { ComponentPropsWithoutRef, ReactNode } from "react";
4
+ import { useUiStrings } from "../../i18n/index.js";
5
+ import type { ClassNames } from "../../utils/class-names.js";
6
+ import { cn } from "../../utils/cn.js";
7
+ import { type FeedTimeOptions, formatFeedTime, toDateTimeAttribute } from "./model.js";
8
+
9
+ export type FeedProps = ComponentPropsWithoutRef<"ol">;
10
+
11
+ /** Compact activity list: an outlined mark per event, a rail between them, a timestamp under each. Flush. */
12
+ export function Feed({ className, ...props }: FeedProps) {
13
+ return <ol className={cn("m-0 flex list-none flex-col p-0", className)} {...props} />;
14
+ }
15
+
16
+ export type FeedEventPart = "mark" | "rail" | "body" | "text" | "meta" | "time";
17
+
18
+ export interface FeedEventProps extends ComponentPropsWithoutRef<"li">, FeedTimeOptions {
19
+ /** Decorative glyph inside the mark (`aria-hidden`). Without it the mark is a dot. */
20
+ icon?: ReactNode;
21
+ /**
22
+ * When it happened: an ISO instant (`2026-03-04T15:30:00Z`), a calendar date (`2026-03-04`) or
23
+ * a `Date`. Rendered as `<time datetime>` and formatted with the locale of the UI strings.
24
+ */
25
+ time?: string | Date;
26
+ /** Replaces the formatted `time` text (the machine value stays on `datetime`). */
27
+ timeLabel?: ReactNode;
28
+ /** Extra line under the text, after the time (an actor, a place). */
29
+ meta?: ReactNode;
30
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the item. */
31
+ classNames?: ClassNames<FeedEventPart>;
32
+ }
33
+
34
+ export function FeedEvent({
35
+ icon,
36
+ time,
37
+ timeLabel,
38
+ meta,
39
+ locale,
40
+ timeZone,
41
+ relative,
42
+ now,
43
+ className,
44
+ classNames,
45
+ children,
46
+ ...props
47
+ }: FeedEventProps) {
48
+ const strings = useUiStrings();
49
+ const text =
50
+ timeLabel ??
51
+ (time === undefined
52
+ ? null
53
+ : formatFeedTime(time, { locale: locale ?? strings.locale, timeZone, relative, now }));
54
+ return (
55
+ <li
56
+ className={cn(
57
+ "group/ev relative grid grid-cols-[1.25rem_minmax(0,1fr)] gap-2.5 py-2",
58
+ className,
59
+ )}
60
+ {...props}
61
+ >
62
+ <span
63
+ aria-hidden="true"
64
+ className={cn(
65
+ "absolute top-6.5 -bottom-2 left-2.25 w-px bg-divider group-last/ev:hidden",
66
+ classNames?.rail,
67
+ )}
68
+ />
69
+ <span
70
+ aria-hidden="true"
71
+ className={cn(
72
+ "relative grid size-5 place-items-center rounded-pill border-divider bg-surface text-ink-3 [&_svg]:size-3",
73
+ classNames?.mark,
74
+ )}
75
+ >
76
+ {icon ?? <span className="size-1.5 rounded-pill bg-current" />}
77
+ </span>
78
+ <div className={cn("min-w-0", classNames?.body)}>
79
+ <p className={cn("m-0 text-fs-130 leading-snug [&_b]:font-medium", classNames?.text)}>
80
+ {children}
81
+ </p>
82
+ {text !== null || meta !== undefined ? (
83
+ <p className={cn("m-0 text-meta text-ink-3 tabular-nums", classNames?.meta)}>
84
+ {text !== null ? (
85
+ <time
86
+ dateTime={time === undefined ? undefined : toDateTimeAttribute(time)}
87
+ className={classNames?.time}
88
+ >
89
+ {text}
90
+ </time>
91
+ ) : null}
92
+ {text !== null && meta !== undefined ? " · " : null}
93
+ {meta}
94
+ </p>
95
+ ) : null}
96
+ </div>
97
+ </li>
98
+ );
99
+ }
@@ -0,0 +1,8 @@
1
+ export {
2
+ Feed,
3
+ FeedEvent,
4
+ type FeedEventPart,
5
+ type FeedEventProps,
6
+ type FeedProps,
7
+ } from "./feed.js";
8
+ export { type FeedTimeOptions, formatFeedTime } from "./model.js";
@@ -0,0 +1,54 @@
1
+ import { isIsoDate, parseDate } from "../../calendar/internal/date-utils.js";
2
+
3
+ export interface FeedTimeOptions {
4
+ locale?: string | undefined;
5
+ /** IANA zone used to show an instant (default: the viewer's). Calendar dates never use a zone. */
6
+ timeZone?: string | undefined;
7
+ /** Show "5 minutes ago" for instants within a week of `now` instead of the absolute time. */
8
+ relative?: boolean | undefined;
9
+ /** Reference instant for `relative` (default: the current time). */
10
+ now?: Date | string | number | undefined;
11
+ }
12
+
13
+ const DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
14
+
15
+ /** True when `value` is a calendar date ("YYYY-MM-DD") rather than an instant. */
16
+ export function isCalendarDate(value: string): boolean {
17
+ return DATE_ONLY.test(value) && isIsoDate(value);
18
+ }
19
+
20
+ /** The value for a `<time datetime>` attribute: strings pass through, dates become ISO instants. */
21
+ export function toDateTimeAttribute(value: string | Date): string {
22
+ return typeof value === "string" ? value : value.toISOString();
23
+ }
24
+
25
+ /**
26
+ * Display text for a feed timestamp. A calendar date ("2026-03-04") is formatted in UTC so it
27
+ * never shifts a day; an instant is shown as date and time in `timeZone`; with `relative`, an
28
+ * instant within a week of `now` reads "5 minutes ago". Invalid input comes back unchanged.
29
+ */
30
+ export function formatFeedTime(value: string | Date, options: FeedTimeOptions = {}): string {
31
+ const { locale, timeZone, relative = false, now } = options;
32
+ if (typeof value === "string" && isCalendarDate(value)) {
33
+ return new Intl.DateTimeFormat(locale, { dateStyle: "medium", timeZone: "UTC" }).format(
34
+ parseDate(value),
35
+ );
36
+ }
37
+ const instant = typeof value === "string" ? new Date(value) : value;
38
+ if (Number.isNaN(instant.getTime())) return String(value);
39
+ if (relative) {
40
+ const reference = now === undefined ? new Date() : new Date(now);
41
+ const seconds = Math.round((instant.getTime() - reference.getTime()) / 1000);
42
+ const abs = Math.abs(seconds);
43
+ const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
44
+ if (abs < 60) return rtf.format(seconds === 0 ? 0 : Math.sign(seconds) * abs, "second");
45
+ if (abs < 3600) return rtf.format(Math.round(seconds / 60), "minute");
46
+ if (abs < 86400) return rtf.format(Math.round(seconds / 3600), "hour");
47
+ if (abs < 7 * 86400) return rtf.format(Math.round(seconds / 86400), "day");
48
+ }
49
+ return new Intl.DateTimeFormat(locale, {
50
+ dateStyle: "medium",
51
+ timeStyle: "short",
52
+ ...(timeZone ? { timeZone } : {}),
53
+ }).format(instant);
54
+ }
@@ -0,0 +1,37 @@
1
+ import type { ComponentPropsWithoutRef, CSSProperties } from "react";
2
+ import { cn } from "../../utils/cn.js";
3
+ import { type StackGap, stackGapClasses } from "../stack/stack.js";
4
+
5
+ export interface GridProps extends ComponentPropsWithoutRef<"div"> {
6
+ /** Fixed number of equal columns. Without it the grid fits as many columns as `minColumnWidth` allows. */
7
+ columns?: number;
8
+ /** Narrowest a column may get before the grid drops one (any CSS length). Defaults to `16rem`. */
9
+ minColumnWidth?: string;
10
+ /** Space between cells. Defaults to `md`. */
11
+ gap?: StackGap;
12
+ }
13
+
14
+ /**
15
+ * Equal-width grid. With `columns` the count is fixed; otherwise it is intrinsic (`auto-fill`
16
+ * from `minColumnWidth`), so it reflows by the space it gets without breakpoints.
17
+ */
18
+ export function Grid({
19
+ columns,
20
+ minColumnWidth = "16rem",
21
+ gap = "md",
22
+ className,
23
+ style,
24
+ ...props
25
+ }: GridProps) {
26
+ const template =
27
+ columns === undefined
28
+ ? `repeat(auto-fill, minmax(min(100%, ${minColumnWidth}), 1fr))`
29
+ : `repeat(${columns}, minmax(0, 1fr))`;
30
+ return (
31
+ <div
32
+ className={cn("grid min-w-0", stackGapClasses[gap], className)}
33
+ style={{ gridTemplateColumns: template, ...style } as CSSProperties}
34
+ {...props}
35
+ />
36
+ );
37
+ }
@@ -0,0 +1 @@
1
+ export { Grid, type GridProps } from "./grid.js";
@@ -1,4 +1,5 @@
1
1
  export * from "./action-bar/index.js";
2
+ export * from "./aside/index.js";
2
3
  export * from "./banner/index.js";
3
4
  export * from "./card/index.js";
4
5
  export * from "./carousel/index.js";
@@ -9,20 +10,28 @@ export * from "./confirm-action/index.js";
9
10
  export * from "./data-grid/index.js";
10
11
  export * from "./description-list/index.js";
11
12
  export * from "./facts/index.js";
13
+ export * from "./feed/index.js";
12
14
  export * from "./file-tree/index.js";
13
15
  export * from "./generic-row/index.js";
16
+ export * from "./grid/index.js";
14
17
  export * from "./hbars/index.js";
15
18
  export * from "./highlight-line/index.js";
16
19
  export * from "./item-card-group/index.js";
17
20
  export * from "./kanban/index.js";
18
21
  export * from "./kpi/index.js";
19
22
  export * from "./kpi-group/index.js";
23
+ export * from "./list-detail/index.js";
24
+ export * from "./note/index.js";
25
+ export * from "./page/index.js";
20
26
  export * from "./page-header/index.js";
21
27
  export * from "./resizable/index.js";
22
28
  export * from "./responsive-list/index.js";
23
29
  export * from "./scrolly/index.js";
30
+ export * from "./section/index.js";
24
31
  export * from "./settings-layout/index.js";
25
32
  export * from "./settings-row/index.js";
33
+ export * from "./shortcuts/index.js";
34
+ export * from "./stack/index.js";
26
35
  export * from "./table/index.js";
27
36
  export * from "./timeline/index.js";
28
37
  export * from "./toolbar/index.js";
@@ -1,71 +1,264 @@
1
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
1
+ import { type ComponentPropsWithoutRef, createContext, type ReactNode, useContext } from "react";
2
2
  import type { ClassNames } from "../../utils/class-names.js";
3
3
  import { cn } from "../../utils/cn.js";
4
+ import { customToneStyle, isCustomTone } from "../../utils/tone.js";
4
5
 
5
6
  export type KpiVariant = "default" | "danger";
6
7
 
7
- export type KpiPart = "root" | "label" | "value" | "suffix" | "description";
8
+ export type KpiBuiltinTone = "neutral" | "accent" | "success" | "warning" | "danger" | "info";
9
+
10
+ /** A built-in tone, or the name of a tone declared in `tonePalettes`. */
11
+ export type KpiTone = KpiBuiltinTone | (string & {});
12
+
13
+ const valueToneClasses: Record<KpiBuiltinTone, string> = {
14
+ neutral: "text-ink",
15
+ accent: "text-accent-ink",
16
+ success: "text-success",
17
+ warning: "text-warning",
18
+ danger: "text-danger",
19
+ info: "text-info",
20
+ };
21
+
22
+ const dotToneClasses: Record<KpiBuiltinTone, string> = {
23
+ neutral: "bg-ink-3",
24
+ accent: "bg-accent",
25
+ success: "bg-success",
26
+ warning: "bg-warning",
27
+ danger: "bg-danger",
28
+ info: "bg-info",
29
+ };
30
+
31
+ const builtinTones = new Set<string>(Object.keys(valueToneClasses));
32
+
33
+ export type KpiPart =
34
+ | "root"
35
+ | "header"
36
+ | "label"
37
+ | "dot"
38
+ | "icon"
39
+ | "trailing"
40
+ | "value"
41
+ | "suffix"
42
+ | "trend"
43
+ | "description";
44
+
45
+ interface KpiContextValue {
46
+ tone: KpiTone;
47
+ dot: boolean;
48
+ classNames: ClassNames<KpiPart> | undefined;
49
+ }
50
+
51
+ const KpiContext = createContext<KpiContextValue>({
52
+ tone: "neutral",
53
+ dot: false,
54
+ classNames: undefined,
55
+ });
8
56
 
9
57
  export interface KpiProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
10
- /** Short label describing the metric. */
11
- label: ReactNode;
12
- /** Highlighted number, already formatted by the consumer. */
13
- value: ReactNode;
58
+ /** Short label describing the metric. Optional when you compose `Kpi.Label` as children. */
59
+ label?: ReactNode;
60
+ /** Highlighted number, already formatted by the consumer. Optional when you compose `Kpi.Value`. */
61
+ value?: ReactNode;
14
62
  /** Small suffix next to the number, e.g. "/12". */
15
63
  suffix?: ReactNode;
16
64
  /** Optional subtext. */
17
65
  description?: ReactNode;
18
66
  variant?: KpiVariant;
67
+ /** Colours the value and the label dot. Wins over `variant`. */
68
+ tone?: KpiTone;
69
+ /** Leading dot on the label, in the tone's colour. */
70
+ dot?: boolean;
71
+ /** Decorative icon at the end of the label row (`aria-hidden`). */
72
+ icon?: ReactNode;
73
+ /** Interactive or labelled content at the end of the label row (a menu, a link); not hidden from assistive tech. */
74
+ trailing?: ReactNode;
75
+ /** Change indicator next to the value, e.g. a `TrendChip`. */
76
+ trend?: ReactNode;
77
+ /** Draws the tile as a card: border and radius. Off by default, so tiles in a `KpiGroup` stay flush. */
78
+ card?: boolean;
79
+ /**
80
+ * Compose the tile from `Kpi.Label`, `Kpi.Value` and `Kpi.Description` instead of (or after)
81
+ * the props. They are laid out in the tile's column in the order written.
82
+ */
83
+ children?: ReactNode;
19
84
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
20
85
  classNames?: ClassNames<KpiPart>;
21
86
  }
22
87
 
88
+ export interface KpiLabelProps extends ComponentPropsWithoutRef<"span"> {
89
+ /** Decorative icon at the end of the row (`aria-hidden`). */
90
+ icon?: ReactNode;
91
+ /** Interactive or labelled content at the end of the row. */
92
+ trailing?: ReactNode;
93
+ /** Overrides the tile's `dot`. */
94
+ dot?: boolean;
95
+ }
96
+
97
+ /** Label row of a composed `Kpi`: the label, then an optional icon and trailing slot at the end. */
98
+ export function KpiLabel({
99
+ icon,
100
+ trailing,
101
+ dot: dotProp,
102
+ className,
103
+ children,
104
+ ...props
105
+ }: KpiLabelProps) {
106
+ const { tone, dot: tileDot, classNames } = useContext(KpiContext);
107
+ const dot = dotProp ?? tileDot;
108
+ const dotTone = isCustomTone(tone, builtinTones)
109
+ ? "bg-(--tone-c)"
110
+ : (dotToneClasses[tone as KpiBuiltinTone] ?? dotToneClasses.neutral);
111
+ const labelNode = (
112
+ <span
113
+ {...props}
114
+ className={cn(
115
+ "min-w-0 break-words font-semibold text-fs-120 text-ink-2",
116
+ dot && "inline-flex items-center gap-1.5",
117
+ classNames?.label,
118
+ className,
119
+ )}
120
+ >
121
+ {dot ? (
122
+ <span
123
+ aria-hidden="true"
124
+ className={cn("size-1.5 shrink-0 rounded-pill", dotTone, classNames?.dot)}
125
+ />
126
+ ) : null}
127
+ {children}
128
+ </span>
129
+ );
130
+ if (!icon && !trailing) return labelNode;
131
+ return (
132
+ <div className={cn("flex items-center justify-between gap-2", classNames?.header)}>
133
+ {labelNode}
134
+ <span className="flex shrink-0 items-center gap-1.5">
135
+ {icon ? (
136
+ <span
137
+ aria-hidden="true"
138
+ className={cn("shrink-0 text-ink-3 [&_svg]:size-4", classNames?.icon)}
139
+ >
140
+ {icon}
141
+ </span>
142
+ ) : null}
143
+ {trailing ? <span className={cn("shrink-0", classNames?.trailing)}>{trailing}</span> : null}
144
+ </span>
145
+ </div>
146
+ );
147
+ }
148
+
149
+ export interface KpiValueProps extends ComponentPropsWithoutRef<"span"> {
150
+ /** Small suffix next to the number. */
151
+ suffix?: ReactNode;
152
+ /** Change indicator next to the value. */
153
+ trend?: ReactNode;
154
+ /** Monospaced digits at a steady weight, for amounts and codes. */
155
+ mono?: boolean;
156
+ }
157
+
158
+ /** The highlighted number of a composed `Kpi`, coloured by the tile's tone. */
159
+ export function KpiValue({ suffix, trend, mono, className, children, ...props }: KpiValueProps) {
160
+ const { tone, classNames } = useContext(KpiContext);
161
+ const valueTone = isCustomTone(tone, builtinTones)
162
+ ? "text-(--tone-c-ink)"
163
+ : (valueToneClasses[tone as KpiBuiltinTone] ?? valueToneClasses.neutral);
164
+ const valueNode = (
165
+ <span
166
+ {...props}
167
+ className={cn(
168
+ "break-words text-kpi-number tabular-nums @max-[9rem]/kpi:text-fs-220",
169
+ mono && "font-mono tracking-normal",
170
+ valueTone,
171
+ classNames?.value,
172
+ className,
173
+ )}
174
+ >
175
+ {children}
176
+ {suffix ? (
177
+ <small
178
+ className={cn(
179
+ "ml-1 font-semibold text-fs-140 text-ink-3 tracking-normal",
180
+ classNames?.suffix,
181
+ )}
182
+ >
183
+ {suffix}
184
+ </small>
185
+ ) : null}
186
+ </span>
187
+ );
188
+ if (!trend) return valueNode;
189
+ return (
190
+ <div className="flex flex-wrap items-baseline gap-x-2 gap-y-1">
191
+ {valueNode}
192
+ <span className={cn("shrink-0", classNames?.trend)}>{trend}</span>
193
+ </div>
194
+ );
195
+ }
196
+
197
+ export interface KpiDescriptionProps extends ComponentPropsWithoutRef<"span"> {}
198
+
199
+ export function KpiDescription({ className, ...props }: KpiDescriptionProps) {
200
+ const { classNames } = useContext(KpiContext);
201
+ return (
202
+ <span
203
+ {...props}
204
+ className={cn("break-words text-fs-120 text-ink-3", classNames?.description, className)}
205
+ />
206
+ );
207
+ }
208
+
209
+ /**
210
+ * One metric: a label, a big number and an optional description. Fill it with props, or compose
211
+ * `Kpi.Label`, `Kpi.Value` and `Kpi.Description` as children when the parts need their own
212
+ * slots (a menu beside the label, a monospaced amount). `card` adds a border and radius.
213
+ */
23
214
  export function Kpi({
24
215
  label,
25
216
  value,
26
217
  suffix,
27
218
  description,
28
219
  variant = "default",
220
+ tone: toneProp,
221
+ dot = false,
222
+ icon,
223
+ trailing,
224
+ trend,
225
+ card = false,
226
+ children,
29
227
  className,
30
228
  classNames,
229
+ style,
31
230
  ...props
32
231
  }: KpiProps) {
232
+ const tone: KpiTone = toneProp ?? (variant === "danger" ? "danger" : "neutral");
33
233
  return (
34
- <div
35
- {...props}
36
- className={cn(
37
- "@container/kpi flex min-w-0 flex-col gap-0.5 bg-surface px-4.5 py-3.5",
38
- classNames?.root,
39
- className,
40
- )}
41
- >
42
- <span className={cn("break-words font-semibold text-fs-120 text-ink-2", classNames?.label)}>
43
- {label}
44
- </span>
45
- <span
234
+ <KpiContext.Provider value={{ tone, dot, classNames }}>
235
+ <div
236
+ {...props}
237
+ style={customToneStyle(tone, builtinTones, style)}
46
238
  className={cn(
47
- "break-words text-kpi-number tabular-nums @max-[9rem]/kpi:text-fs-220",
48
- variant === "danger" ? "text-danger" : "text-ink",
49
- classNames?.value,
239
+ "@container/kpi flex min-w-0 flex-col gap-0.5 bg-surface px-4.5 py-3.5",
240
+ card && "rounded-card border border-line",
241
+ classNames?.root,
242
+ className,
50
243
  )}
51
244
  >
52
- {value}
53
- {suffix ? (
54
- <small
55
- className={cn(
56
- "ml-1 font-semibold text-fs-140 text-ink-3 tracking-normal",
57
- classNames?.suffix,
58
- )}
59
- >
60
- {suffix}
61
- </small>
245
+ {label !== undefined ? (
246
+ <KpiLabel icon={icon} trailing={trailing}>
247
+ {label}
248
+ </KpiLabel>
62
249
  ) : null}
63
- </span>
64
- {description ? (
65
- <span className={cn("break-words text-fs-120 text-ink-3", classNames?.description)}>
66
- {description}
67
- </span>
68
- ) : null}
69
- </div>
250
+ {value !== undefined ? (
251
+ <KpiValue suffix={suffix} trend={trend}>
252
+ {value}
253
+ </KpiValue>
254
+ ) : null}
255
+ {description ? <KpiDescription>{description}</KpiDescription> : null}
256
+ {children}
257
+ </div>
258
+ </KpiContext.Provider>
70
259
  );
71
260
  }
261
+
262
+ Kpi.Label = KpiLabel;
263
+ Kpi.Value = KpiValue;
264
+ Kpi.Description = KpiDescription;
@@ -1 +1,7 @@
1
- export { KpiGroup, type KpiGroupItem, type KpiGroupPart, type KpiGroupProps } from "./kpi-group.js";
1
+ export {
2
+ KpiGroup,
3
+ type KpiGroupItem,
4
+ type KpiGroupLayout,
5
+ type KpiGroupPart,
6
+ type KpiGroupProps,
7
+ } from "./kpi-group.js";