@jcsoftdev/ui 0.2.3 → 0.3.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 (375) hide show
  1. package/CHANGELOG.md +288 -7
  2. package/README.md +2 -1
  3. package/bin/ui-theme.mjs +1151 -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 +23 -2
  19. package/dist/atoms/chip/chip.d.ts +9 -3
  20. package/dist/atoms/chip/chip.js +26 -4
  21. package/dist/atoms/chip/index.d.ts +1 -1
  22. package/dist/atoms/chip/index.js +4 -1
  23. package/dist/atoms/status-dot/index.d.ts +1 -1
  24. package/dist/atoms/status-dot/status-dot.d.ts +4 -2
  25. package/dist/atoms/status-dot/status-dot.js +5 -1
  26. package/dist/charts/bar-chart/bar-race-chart.js +1 -0
  27. package/dist/charts/beeswarm-chart/beeswarm-chart.js +1 -1
  28. package/dist/charts/chord-chart/chord-chart.js +13 -5
  29. package/dist/charts/core/cartesian/cartesian-chart.d.ts +1 -1
  30. package/dist/charts/core/cartesian/cartesian-chart.js +48 -11
  31. package/dist/charts/core/cartesian/layout.d.ts +6 -1
  32. package/dist/charts/core/cartesian/layout.js +14 -5
  33. package/dist/charts/core/cartesian/marks.d.ts +2 -2
  34. package/dist/charts/core/cartesian/marks.js +1 -1
  35. package/dist/charts/core/cartesian/types.d.ts +28 -2
  36. package/dist/charts/core/category-explorer.d.ts +2 -2
  37. package/dist/charts/core/category-explorer.js +8 -4
  38. package/dist/charts/core/chart-dock.d.ts +26 -0
  39. package/dist/charts/core/chart-dock.js +45 -0
  40. package/dist/charts/core/chart-frame.d.ts +9 -2
  41. package/dist/charts/core/chart-frame.js +105 -25
  42. package/dist/charts/core/distribution/explorer.d.ts +5 -2
  43. package/dist/charts/core/distribution/explorer.js +12 -5
  44. package/dist/charts/core/distribution/xy-points.js +1 -1
  45. package/dist/charts/core/index.d.ts +3 -0
  46. package/dist/charts/core/index.js +3 -0
  47. package/dist/charts/core/leave-grace.d.ts +11 -0
  48. package/dist/charts/core/leave-grace.js +26 -0
  49. package/dist/charts/core/nearest.d.ts +14 -0
  50. package/dist/charts/core/nearest.js +22 -0
  51. package/dist/charts/core/plot-overlay.js +9 -3
  52. package/dist/charts/core/pointer.test-utils.d.ts +38 -0
  53. package/dist/charts/core/pointer.test-utils.js +123 -0
  54. package/dist/charts/core/tooltip.d.ts +25 -2
  55. package/dist/charts/core/tooltip.js +115 -40
  56. package/dist/charts/core/touch-select.d.ts +20 -0
  57. package/dist/charts/core/touch-select.js +184 -0
  58. package/dist/charts/core/types.d.ts +8 -4
  59. package/dist/charts/core/types.js +5 -0
  60. package/dist/charts/core/use-index-navigation.d.ts +17 -6
  61. package/dist/charts/core/use-index-navigation.js +47 -10
  62. package/dist/charts/donut-chart/donut-chart.d.ts +5 -1
  63. package/dist/charts/donut-chart/donut-chart.js +40 -1
  64. package/dist/charts/donut-chart/slice-labels.d.ts +20 -0
  65. package/dist/charts/donut-chart/slice-labels.js +20 -0
  66. package/dist/charts/dumbbell-chart/dumbbell-chart.js +6 -3
  67. package/dist/charts/fill-gauge-chart/fill-gauge-chart.js +1 -0
  68. package/dist/charts/funnel-chart/funnel-chart.js +2 -1
  69. package/dist/charts/gauge-chart/gauge-chart.js +2 -1
  70. package/dist/charts/heatmap-chart/heatmap-chart.d.ts +4 -1
  71. package/dist/charts/heatmap-chart/heatmap-chart.js +3 -1
  72. package/dist/charts/heatmap-chart/heatmap-grid.d.ts +4 -1
  73. package/dist/charts/heatmap-chart/heatmap-grid.js +3 -1
  74. package/dist/charts/hex-tile-map/hex-tile-map.js +124 -115
  75. package/dist/charts/hierarchy-morph/hierarchy-morph.js +2 -1
  76. package/dist/charts/icicle-chart/icicle-chart.js +7 -9
  77. package/dist/charts/lollipop-chart/lollipop-chart.js +6 -3
  78. package/dist/charts/maps/geo/map-viewport.js +1 -1
  79. package/dist/charts/polar-area-chart/polar-area-chart.js +42 -12
  80. package/dist/charts/progress-units/progress-units.js +1 -0
  81. package/dist/charts/radar-chart/radar-chart.js +1 -1
  82. package/dist/charts/radial-bar-chart/radial-bar-chart.js +2 -1
  83. package/dist/charts/range-area-chart/range-area-chart.js +3 -2
  84. package/dist/charts/sankey-chart/sankey-chart.js +12 -4
  85. package/dist/charts/tree-chart/tree-chart.js +1 -0
  86. package/dist/charts/treemap-chart/treemap-chart.js +2 -7
  87. package/dist/charts/waterfall-chart/waterfall-chart.js +6 -3
  88. package/dist/containers/action-bar/action-bar.d.ts +11 -2
  89. package/dist/containers/action-bar/action-bar.js +4 -1
  90. package/dist/containers/card/card.d.ts +21 -3
  91. package/dist/containers/card/card.js +20 -5
  92. package/dist/containers/grid/grid.d.ts +15 -0
  93. package/dist/containers/grid/grid.js +24 -0
  94. package/dist/containers/grid/index.d.ts +1 -0
  95. package/dist/containers/grid/index.js +4 -0
  96. package/dist/containers/index.d.ts +3 -0
  97. package/dist/containers/index.js +3 -0
  98. package/dist/containers/kpi/kpi.d.ts +13 -2
  99. package/dist/containers/kpi/kpi.js +86 -24
  100. package/dist/containers/kpi-group/index.d.ts +1 -1
  101. package/dist/containers/kpi-group/index.js +3 -1
  102. package/dist/containers/kpi-group/kpi-group.d.ts +9 -1
  103. package/dist/containers/kpi-group/kpi-group.js +11 -1
  104. package/dist/containers/page/index.d.ts +1 -0
  105. package/dist/containers/page/index.js +4 -0
  106. package/dist/containers/page/page.d.ts +7 -0
  107. package/dist/containers/page/page.js +14 -0
  108. package/dist/containers/page-header/page-header.d.ts +8 -3
  109. package/dist/containers/page-header/page-header.js +35 -8
  110. package/dist/containers/responsive-list/responsive-list.d.ts +1 -1
  111. package/dist/containers/responsive-list/responsive-list.js +6 -3
  112. package/dist/containers/stack/index.d.ts +1 -0
  113. package/dist/containers/stack/index.js +6 -0
  114. package/dist/containers/stack/stack.d.ts +15 -0
  115. package/dist/containers/stack/stack.js +43 -0
  116. package/dist/forms/copy-field/copy-field.d.ts +17 -0
  117. package/dist/forms/copy-field/copy-field.js +72 -0
  118. package/dist/forms/copy-field/index.d.ts +1 -0
  119. package/dist/forms/copy-field/index.js +4 -0
  120. package/dist/forms/emoji-picker/emoji-picker.js +1 -1
  121. package/dist/forms/form/form.d.ts +15 -0
  122. package/dist/forms/form/form.js +29 -0
  123. package/dist/forms/form/index.d.ts +1 -0
  124. package/dist/forms/form/index.js +10 -0
  125. package/dist/forms/index.d.ts +2 -0
  126. package/dist/forms/index.js +2 -0
  127. package/dist/forms/input/index.d.ts +1 -1
  128. package/dist/forms/input/index.js +3 -2
  129. package/dist/forms/input/input.d.ts +6 -2
  130. package/dist/forms/input/input.js +9 -3
  131. package/dist/glass/crystal-map.d.ts +70 -0
  132. package/dist/glass/crystal-map.js +88 -0
  133. package/dist/glass/displacement-map.d.ts +117 -0
  134. package/dist/glass/displacement-map.js +201 -0
  135. package/dist/glass/index.d.ts +8 -0
  136. package/dist/glass/index.js +63 -0
  137. package/dist/glass/lens-crystal.d.ts +29 -0
  138. package/dist/glass/lens-crystal.js +161 -0
  139. package/dist/glass/lens-dispersion.d.ts +11 -0
  140. package/dist/glass/lens-dispersion.js +19 -0
  141. package/dist/glass/liquid-glass.d.ts +41 -0
  142. package/dist/glass/liquid-glass.js +256 -0
  143. package/dist/glass/liquid-motion.d.ts +53 -0
  144. package/dist/glass/liquid-motion.js +302 -0
  145. package/dist/glass/liquid-options.d.ts +162 -0
  146. package/dist/glass/liquid-options.js +179 -0
  147. package/dist/glass/refraction.d.ts +100 -0
  148. package/dist/glass/refraction.js +714 -0
  149. package/dist/glass/specular-map.d.ts +26 -0
  150. package/dist/glass/specular-map.js +75 -0
  151. package/dist/glass/spring.d.ts +79 -0
  152. package/dist/glass/spring.js +58 -0
  153. package/dist/glass/support.d.ts +13 -0
  154. package/dist/glass/support.js +14 -0
  155. package/dist/glass/use-glass-refraction.d.ts +8 -0
  156. package/dist/glass/use-glass-refraction.js +16 -0
  157. package/dist/i18n/strings.d.ts +24 -0
  158. package/dist/i18n/strings.js +18 -2
  159. package/dist/icons/index.d.ts +2 -0
  160. package/dist/icons/index.js +4 -0
  161. package/dist/icons/key.d.ts +2 -0
  162. package/dist/icons/key.js +12 -0
  163. package/dist/icons/webhook.d.ts +2 -0
  164. package/dist/icons/webhook.js +12 -0
  165. package/dist/liquid/index.d.ts +3 -0
  166. package/dist/liquid/index.js +29 -0
  167. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +29 -0
  168. package/dist/navigation/breadcrumbs/breadcrumbs.js +70 -0
  169. package/dist/navigation/breadcrumbs/index.d.ts +1 -0
  170. package/dist/navigation/breadcrumbs/index.js +6 -0
  171. package/dist/navigation/index.d.ts +1 -0
  172. package/dist/navigation/index.js +1 -0
  173. package/dist/navigation/segmented/index.d.ts +1 -1
  174. package/dist/navigation/segmented/model.d.ts +5 -0
  175. package/dist/navigation/segmented/model.js +6 -0
  176. package/dist/navigation/segmented/segmented.d.ts +17 -3
  177. package/dist/navigation/segmented/segmented.js +20 -4
  178. package/dist/overlays/context-menu/context-menu.d.ts +9 -1
  179. package/dist/overlays/context-menu/context-menu.js +4 -1
  180. package/dist/overlays/dialog/dialog.d.ts +9 -1
  181. package/dist/overlays/dialog/dialog.js +3 -0
  182. package/dist/overlays/drawer/drawer.d.ts +9 -1
  183. package/dist/overlays/drawer/drawer.js +3 -0
  184. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +9 -1
  185. package/dist/overlays/dropdown-menu/dropdown-menu.js +3 -1
  186. package/dist/overlays/hover-card/hover-card.d.ts +10 -1
  187. package/dist/overlays/hover-card/hover-card.js +4 -1
  188. package/dist/overlays/popover/popover.d.ts +9 -1
  189. package/dist/overlays/popover/popover.js +3 -0
  190. package/dist/palette/command-palette/command-palette.d.ts +12 -2
  191. package/dist/palette/command-palette/command-palette.js +5 -0
  192. package/dist/primitives/command/command.d.ts +3 -2
  193. package/dist/primitives/command/command.js +2 -0
  194. package/dist/primitives/menu/menu.js +1 -1
  195. package/dist/primitives/popper/popper.js +5 -0
  196. package/dist/rich-text/rich-text-editor.js +94 -8
  197. package/dist/rich-text/sanitize.js +70 -20
  198. package/dist/shell/app-shell/app-shell.d.ts +17 -0
  199. package/dist/shell/app-shell/app-shell.js +44 -4
  200. package/dist/shell/bottom-nav/bottom-nav.d.ts +34 -0
  201. package/dist/shell/bottom-nav/bottom-nav.js +124 -0
  202. package/dist/shell/bottom-nav/index.d.ts +2 -0
  203. package/dist/shell/bottom-nav/index.js +9 -0
  204. package/dist/shell/bottom-nav/split.d.ts +11 -0
  205. package/dist/shell/bottom-nav/split.js +10 -0
  206. package/dist/shell/sidebar/sidebar.d.ts +16 -2
  207. package/dist/shell/sidebar/sidebar.js +46 -4
  208. package/dist/shell/topbar/topbar.d.ts +20 -9
  209. package/dist/shell/topbar/topbar.js +16 -9
  210. package/dist/states/empty-state/empty-state.d.ts +3 -1
  211. package/dist/states/empty-state/empty-state.js +9 -1
  212. package/dist/states/error-state/error-state.d.ts +3 -1
  213. package/dist/states/error-state/error-state.js +2 -0
  214. package/dist/states/index.d.ts +1 -0
  215. package/dist/states/index.js +1 -0
  216. package/dist/states/live-status-bar/index.d.ts +1 -0
  217. package/dist/states/live-status-bar/index.js +6 -0
  218. package/dist/states/live-status-bar/live-status-bar.d.ts +17 -0
  219. package/dist/states/live-status-bar/live-status-bar.js +49 -0
  220. package/dist/states/offline-banner/offline-banner.d.ts +3 -1
  221. package/dist/states/offline-banner/offline-banner.js +8 -4
  222. package/dist/utils/class-groups.js +17 -0
  223. package/dist/utils/index.d.ts +1 -0
  224. package/dist/utils/index.js +2 -0
  225. package/dist/utils/material.d.ts +13 -0
  226. package/dist/utils/material.js +6 -0
  227. package/dist/utils/tone.d.ts +8 -0
  228. package/dist/utils/tone.js +17 -0
  229. package/dist/utils/use-copy.d.ts +5 -0
  230. package/dist/utils/use-copy.js +35 -0
  231. package/icons/svg/key.svg +5 -0
  232. package/icons/svg/webhook.svg +5 -0
  233. package/package.json +31 -21
  234. package/scripts/build-theme.d.mts +22 -0
  235. package/scripts/build-theme.mjs +236 -4
  236. package/src/ai/attachment/attachment.tsx +1 -1
  237. package/src/ai/chat-list/group.ts +3 -1
  238. package/src/ai/conversation/conversation.tsx +1 -1
  239. package/src/ai/internal/use-copy.ts +1 -38
  240. package/src/ai/markdown/parse.ts +74 -17
  241. package/src/ai/source/source.tsx +1 -1
  242. package/src/atoms/avatar/avatar.tsx +57 -4
  243. package/src/atoms/avatar/index.ts +8 -1
  244. package/src/atoms/button/button.tsx +8 -3
  245. package/src/atoms/checkbox/checkbox.tsx +30 -3
  246. package/src/atoms/chip/chip.tsx +37 -5
  247. package/src/atoms/chip/index.ts +7 -1
  248. package/src/atoms/status-dot/index.ts +1 -0
  249. package/src/atoms/status-dot/status-dot.tsx +15 -3
  250. package/src/charts/README.md +21 -0
  251. package/src/charts/bar-chart/bar-race-chart.tsx +1 -0
  252. package/src/charts/beeswarm-chart/beeswarm-chart.tsx +1 -1
  253. package/src/charts/chord-chart/chord-chart.tsx +13 -5
  254. package/src/charts/core/cartesian/cartesian-chart.tsx +55 -10
  255. package/src/charts/core/cartesian/layout.ts +29 -10
  256. package/src/charts/core/cartesian/marks.tsx +3 -3
  257. package/src/charts/core/cartesian/types.ts +30 -2
  258. package/src/charts/core/category-explorer.tsx +12 -6
  259. package/src/charts/core/chart-dock.tsx +68 -0
  260. package/src/charts/core/chart-frame.tsx +116 -27
  261. package/src/charts/core/distribution/explorer.tsx +17 -7
  262. package/src/charts/core/distribution/xy-points.tsx +1 -1
  263. package/src/charts/core/index.ts +3 -0
  264. package/src/charts/core/leave-grace.ts +35 -0
  265. package/src/charts/core/nearest.ts +38 -0
  266. package/src/charts/core/plot-overlay.tsx +9 -3
  267. package/src/charts/core/pointer.test-utils.ts +146 -0
  268. package/src/charts/core/tooltip.tsx +129 -15
  269. package/src/charts/core/touch-select.ts +250 -0
  270. package/src/charts/core/types.ts +13 -4
  271. package/src/charts/core/use-index-navigation.ts +70 -11
  272. package/src/charts/donut-chart/donut-chart.tsx +53 -3
  273. package/src/charts/donut-chart/slice-labels.ts +39 -0
  274. package/src/charts/dumbbell-chart/dumbbell-chart.tsx +8 -3
  275. package/src/charts/fill-gauge-chart/fill-gauge-chart.tsx +1 -0
  276. package/src/charts/funnel-chart/funnel-chart.tsx +2 -1
  277. package/src/charts/gauge-chart/gauge-chart.tsx +2 -1
  278. package/src/charts/heatmap-chart/heatmap-chart.tsx +5 -0
  279. package/src/charts/heatmap-chart/heatmap-grid.tsx +5 -1
  280. package/src/charts/hex-tile-map/hex-tile-map.tsx +6 -1
  281. package/src/charts/hierarchy-morph/hierarchy-morph.tsx +2 -1
  282. package/src/charts/icicle-chart/icicle-chart.tsx +8 -9
  283. package/src/charts/lollipop-chart/lollipop-chart.tsx +8 -3
  284. package/src/charts/maps/geo/map-viewport.tsx +1 -1
  285. package/src/charts/polar-area-chart/polar-area-chart.tsx +37 -12
  286. package/src/charts/progress-units/progress-units.tsx +1 -0
  287. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  288. package/src/charts/radial-bar-chart/radial-bar-chart.tsx +2 -1
  289. package/src/charts/range-area-chart/range-area-chart.tsx +3 -2
  290. package/src/charts/sankey-chart/sankey-chart.tsx +12 -4
  291. package/src/charts/tree-chart/tree-chart.tsx +1 -0
  292. package/src/charts/treemap-chart/treemap-chart.tsx +2 -7
  293. package/src/charts/waterfall-chart/waterfall-chart.tsx +8 -3
  294. package/src/containers/action-bar/action-bar.tsx +13 -2
  295. package/src/containers/card/card.tsx +43 -4
  296. package/src/containers/grid/grid.tsx +37 -0
  297. package/src/containers/grid/index.ts +1 -0
  298. package/src/containers/index.ts +3 -0
  299. package/src/containers/kpi/kpi.tsx +116 -22
  300. package/src/containers/kpi-group/index.ts +7 -1
  301. package/src/containers/kpi-group/kpi-group.tsx +26 -1
  302. package/src/containers/page/index.ts +1 -0
  303. package/src/containers/page/page.tsx +17 -0
  304. package/src/containers/page-header/page-header.tsx +38 -8
  305. package/src/containers/responsive-list/responsive-list.tsx +7 -4
  306. package/src/containers/stack/index.ts +7 -0
  307. package/src/containers/stack/stack.tsx +55 -0
  308. package/src/forms/copy-field/copy-field.tsx +88 -0
  309. package/src/forms/copy-field/index.ts +1 -0
  310. package/src/forms/emoji-picker/emoji-picker.tsx +1 -1
  311. package/src/forms/form/form.tsx +46 -0
  312. package/src/forms/form/index.ts +8 -0
  313. package/src/forms/index.ts +2 -0
  314. package/src/forms/input/index.ts +1 -1
  315. package/src/forms/input/input.tsx +14 -3
  316. package/src/glass/crystal-map.ts +150 -0
  317. package/src/glass/displacement-map.ts +317 -0
  318. package/src/glass/index.ts +43 -0
  319. package/src/glass/lens-crystal.ts +226 -0
  320. package/src/glass/lens-dispersion.ts +34 -0
  321. package/src/glass/liquid-glass.tsx +371 -0
  322. package/src/glass/liquid-motion.ts +395 -0
  323. package/src/glass/liquid-options.ts +306 -0
  324. package/src/glass/refraction.ts +1010 -0
  325. package/src/glass/specular-map.ts +95 -0
  326. package/src/glass/spring.ts +98 -0
  327. package/src/glass/support.ts +27 -0
  328. package/src/glass/use-glass-refraction.ts +21 -0
  329. package/src/i18n/strings.ts +24 -0
  330. package/src/icons/index.ts +2 -0
  331. package/src/icons/key.tsx +13 -0
  332. package/src/icons/webhook.tsx +13 -0
  333. package/src/liquid/index.ts +24 -0
  334. package/src/navigation/breadcrumbs/breadcrumbs.tsx +103 -0
  335. package/src/navigation/breadcrumbs/index.ts +8 -0
  336. package/src/navigation/index.ts +1 -0
  337. package/src/navigation/segmented/index.ts +1 -0
  338. package/src/navigation/segmented/model.ts +11 -0
  339. package/src/navigation/segmented/segmented.tsx +45 -6
  340. package/src/overlays/context-menu/context-menu.tsx +11 -1
  341. package/src/overlays/dialog/dialog.tsx +10 -0
  342. package/src/overlays/drawer/drawer.tsx +10 -0
  343. package/src/overlays/dropdown-menu/dropdown-menu.tsx +10 -1
  344. package/src/overlays/hover-card/hover-card.tsx +12 -1
  345. package/src/overlays/popover/popover.tsx +10 -0
  346. package/src/palette/command-palette/command-palette.tsx +15 -1
  347. package/src/primitives/command/command.tsx +4 -0
  348. package/src/primitives/menu/menu.tsx +1 -1
  349. package/src/primitives/popper/popper.tsx +10 -0
  350. package/src/rich-text/rich-text-editor.tsx +116 -13
  351. package/src/rich-text/sanitize.ts +94 -23
  352. package/src/shell/app-shell/app-shell.tsx +60 -4
  353. package/src/shell/bottom-nav/bottom-nav.tsx +187 -0
  354. package/src/shell/bottom-nav/index.ts +8 -0
  355. package/src/shell/bottom-nav/split.ts +20 -0
  356. package/src/shell/sidebar/sidebar.tsx +51 -5
  357. package/src/shell/topbar/topbar.tsx +81 -58
  358. package/src/states/empty-state/empty-state.tsx +11 -1
  359. package/src/states/error-state/error-state.tsx +4 -0
  360. package/src/states/index.ts +1 -0
  361. package/src/states/live-status-bar/index.ts +6 -0
  362. package/src/states/live-status-bar/live-status-bar.tsx +62 -0
  363. package/src/states/offline-banner/offline-banner.tsx +13 -5
  364. package/src/utils/class-groups.ts +17 -0
  365. package/src/utils/index.ts +1 -0
  366. package/src/utils/material.ts +16 -0
  367. package/src/utils/tone.ts +29 -0
  368. package/src/utils/use-copy.ts +38 -0
  369. package/styles/Theme.kt +64 -3
  370. package/styles/base.css +51 -0
  371. package/styles/tailwind.css +833 -0
  372. package/styles/theme.css +546 -4
  373. package/styles/tokens.css +788 -15
  374. package/tokens/default.json +918 -29
  375. package/scripts/build-theme.d.ts +0 -18
@@ -206,6 +206,17 @@ function RosePlot({
206
206
  startAngle: startAngle + slot * position + pad / 2,
207
207
  endAngle: startAngle + slot * (position + 1) - pad / 2,
208
208
  cornerRadius
209
+ }),
210
+ // The hovered sector steps out by EXPLODE. Pointer events go to this resting wedge, which
211
+ // has no gap to its neighbours and also covers the stepped-out area, never to the moving
212
+ // sector: a sector that moved away from a still pointer fired pointerleave and looped.
213
+ hit: arcPath({
214
+ cx,
215
+ cy,
216
+ innerRadius: inner,
217
+ outerRadius: Math.max(outer, inner + 1) + EXPLODE,
218
+ startAngle: startAngle + slot * position,
219
+ endAngle: startAngle + slot * (position + 1)
209
220
  })
210
221
  };
211
222
  }),
@@ -276,7 +287,7 @@ function RosePlot({
276
287
  },
277
288
  ring.value
278
289
  )) }),
279
- sectors.map((sector, position) => {
290
+ sectors.map((sector) => {
280
291
  const item = items[sector.index];
281
292
  if (!item) return null;
282
293
  const focused = focusIndex === sector.index;
@@ -290,9 +301,24 @@ function RosePlot({
290
301
  dx: shift.x,
291
302
  dy: shift.y,
292
303
  originX: cx,
293
- originY: cy,
294
- onEnter: (event) => nav.hover(position, event),
295
- onLeave: nav.leave
304
+ originY: cy
305
+ },
306
+ item.datum.id
307
+ );
308
+ }),
309
+ sectors.map((sector, position) => {
310
+ const item = items[sector.index];
311
+ if (!item) return null;
312
+ return /* @__PURE__ */ jsx(
313
+ "path",
314
+ {
315
+ "data-sector-hit": "",
316
+ "data-chart-hit": "",
317
+ d: sector.hit,
318
+ fill: "transparent",
319
+ onPointerEnter: (event) => nav.hover(position, event),
320
+ onPointerMove: (event) => nav.hover(position, event),
321
+ onPointerLeave: nav.pointerLeave
296
322
  },
297
323
  item.datum.id
298
324
  );
@@ -351,7 +377,16 @@ function RosePlot({
351
377
  className: "pointer-events-none absolute inset-0 rounded-xs outline-none focus-visible:outline-2 focus-visible:outline-accent-ink focus-visible:outline-offset-2"
352
378
  }
353
379
  ),
354
- tooltip && anchor && rows.length ? /* @__PURE__ */ jsx(ChartTooltip, { x: anchor.x, y: anchor.y, containerWidth: width, rows }) : null
380
+ tooltip && anchor && rows.length ? /* @__PURE__ */ jsx(
381
+ ChartTooltip,
382
+ {
383
+ x: anchor.x,
384
+ y: anchor.y,
385
+ containerWidth: width,
386
+ containerHeight: height,
387
+ rows
388
+ }
389
+ ) : null
355
390
  ] });
356
391
  }
357
392
  const SectorMark = memo(function SectorMark2({
@@ -361,19 +396,14 @@ const SectorMark = memo(function SectorMark2({
361
396
  dx,
362
397
  dy,
363
398
  originX,
364
- originY,
365
- onEnter,
366
- onLeave
399
+ originY
367
400
  }) {
368
401
  return /* @__PURE__ */ jsx(
369
402
  "path",
370
403
  {
371
404
  "data-sector": "",
372
405
  d,
373
- onPointerEnter: onEnter,
374
- onPointerMove: onEnter,
375
- onPointerLeave: onLeave,
376
- className: "motion-safe:transition-[transform,opacity] motion-safe:duration-200 motion-safe:ease-out",
406
+ className: "pointer-events-none motion-safe:transition-[transform,opacity] motion-safe:duration-200 motion-safe:ease-out",
377
407
  style: {
378
408
  fill: color,
379
409
  fillOpacity: 0.9,
@@ -52,6 +52,7 @@ function ProgressUnits({
52
52
  return /* @__PURE__ */ jsx(
53
53
  ChartFrame,
54
54
  {
55
+ dock: "never",
55
56
  height: size,
56
57
  labels,
57
58
  loading,
@@ -351,7 +351,7 @@ function RadarPlot({
351
351
  fill: "transparent",
352
352
  onPointerMove: onPointer,
353
353
  onPointerDown: onPointer,
354
- onPointerLeave: nav.leave
354
+ onPointerLeave: nav.pointerLeave
355
355
  }
356
356
  )
357
357
  ]
@@ -284,7 +284,7 @@ function RadialPlot({
284
284
  stroke: gradient ? `url(#${uid}-g${ring.index})` : item.color,
285
285
  dimmed: focusIndex != null && focusIndex !== ring.index,
286
286
  onEnter: (event) => nav.hover(position, event),
287
- onLeave: nav.leave
287
+ onLeave: nav.pointerLeave
288
288
  },
289
289
  item.datum.id
290
290
  );
@@ -411,6 +411,7 @@ const RingMark = memo(function RingMark2({
411
411
  "path",
412
412
  {
413
413
  d: hitPath,
414
+ "data-chart-hit": "",
414
415
  fill: "none",
415
416
  strokeWidth: band + 4,
416
417
  strokeLinecap: "butt",
@@ -14,6 +14,7 @@ import { PlotOverlay } from "../core/plot-overlay.js";
14
14
  import { linearScale } from "../core/scales/linear.js";
15
15
  import { ChartTooltip } from "../core/tooltip.js";
16
16
  import {
17
+ resolveAxisBound,
17
18
  resolveLabels
18
19
  } from "../core/types.js";
19
20
  import { useSeriesState } from "../core/use-series-state.js";
@@ -92,8 +93,8 @@ function Plot({
92
93
  const lo = Math.min(...all);
93
94
  const hi = Math.max(...all);
94
95
  const zero = yAxis?.zero ?? (all.length > 0 && lo <= hi * 0.35);
95
- const domainLo = yAxis?.min ?? (zero ? Math.min(0, lo) : lo);
96
- const domainHi = yAxis?.max ?? hi;
96
+ const domainLo = resolveAxisBound(yAxis?.min, zero ? Math.min(0, lo) : lo);
97
+ const domainHi = resolveAxisBound(yAxis?.max, hi);
97
98
  const innerHeight2 = height - MARGIN.top - MARGIN.bottom;
98
99
  const probe = linearScale({
99
100
  domain: all.length ? [domainLo, domainHi] : [0, 1],
@@ -16,6 +16,7 @@ import { ChartDataTable } from "../core/data-table.js";
16
16
  import { DEFAULT_EXPORT_TEXTS, ExportMenu } from "../core/export-menu.js";
17
17
  import { resolveFormat } from "../core/format.js";
18
18
  import { fitLabel } from "../core/hierarchy-chart.js";
19
+ import { useLeaveGrace } from "../core/leave-grace.js";
19
20
  import { ChartLegend } from "../core/legend.js";
20
21
  import { EASE_OUT, revealClip, useEntryAnimation, useReducedMotion } from "../core/motion.js";
21
22
  import { seriesColor } from "../core/palette.js";
@@ -274,6 +275,11 @@ function SankeyPlot({
274
275
  const step = lastColumn > 0 ? (width - nodeWidth) / lastColumn : width;
275
276
  const labelRoom = inside ? nodeWidth - 12 : step - nodeWidth - LABEL_GAP * 2;
276
277
  const [hover, setHover] = useState(null);
278
+ const { leave: leaveSoon, hold } = useLeaveGrace(() => setHover(null));
279
+ const showHover = (next) => {
280
+ hold();
281
+ setHover(next);
282
+ };
277
283
  const [active, setActive] = useState(null);
278
284
  const [pinned, setPinned] = useState(null);
279
285
  const reducedMotion = useReducedMotion();
@@ -465,8 +471,8 @@ function SankeyPlot({
465
471
  opacity: linkOpacity,
466
472
  lit: lit?.links ?? null,
467
473
  diffById,
468
- onEnter: (link, event) => setHover({ focus: { kind: "link", id: link.id }, ...pointer(event) }),
469
- onLeave: () => setHover(null),
474
+ onEnter: (link, event) => showHover({ focus: { kind: "link", id: link.id }, ...pointer(event) }),
475
+ onLeave: leaveSoon,
470
476
  onClick: (link) => {
471
477
  if (pathTracing) pin({ kind: "link", id: link.id });
472
478
  onLinkClick?.(link);
@@ -483,8 +489,8 @@ function SankeyPlot({
483
489
  lit: lit?.nodes ?? null,
484
490
  active: activeNode && !activeLink ? activeNode.id : null,
485
491
  inside,
486
- onEnter: (node, event) => setHover({ focus: { kind: "node", id: node.id }, ...pointer(event) }),
487
- onLeave: () => setHover(null),
492
+ onEnter: (node, event) => showHover({ focus: { kind: "node", id: node.id }, ...pointer(event) }),
493
+ onLeave: leaveSoon,
488
494
  onClick: (node) => {
489
495
  if (pathTracing) pin({ kind: "node", id: node.id });
490
496
  onNodeClick?.(node);
@@ -714,6 +720,7 @@ const SankeyLinks = memo(function SankeyLinks2({
714
720
  "path",
715
721
  {
716
722
  d: sankeyLinkPath(link),
723
+ "data-chart-hit": "",
717
724
  strokeWidth: Math.max(1, link.width),
718
725
  className: "cursor-pointer motion-safe:transition-[stroke-opacity] motion-safe:duration-150",
719
726
  style: {
@@ -748,6 +755,7 @@ function SankeyNodes({
748
755
  "rect",
749
756
  {
750
757
  "data-sankey-node": "",
758
+ "data-chart-hit": "",
751
759
  x: node.x0,
752
760
  y: node.y0,
753
761
  width: node.x1 - node.x0,
@@ -95,6 +95,7 @@ function TreeChart({
95
95
  return /* @__PURE__ */ jsx(
96
96
  ChartFrame,
97
97
  {
98
+ dock: "never",
98
99
  height,
99
100
  aspectRatio,
100
101
  labels,
@@ -21,6 +21,7 @@ import {
21
21
  resolveHierarchyLabels
22
22
  } from "../core/hierarchy-chart.js";
23
23
  import { EASE_OUT, useEntryAnimation } from "../core/motion.js";
24
+ import { boxAt } from "../core/nearest.js";
24
25
  import { ChartTooltip } from "../core/tooltip.js";
25
26
  import { useDrill } from "../core/use-drill.js";
26
27
  function TreemapChart({
@@ -135,13 +136,7 @@ function TreemapPlot({
135
136
  },
136
137
  { disabled: !animate, replayKey: focus.id }
137
138
  );
138
- const hit = (x, y) => {
139
- for (let i = cells.length - 1; i >= 0; i--) {
140
- const cell = cells[i];
141
- if (x >= cell.x0 && x <= cell.x1 && y >= cell.y0 && y <= cell.y1) return cell;
142
- }
143
- return null;
144
- };
139
+ const hit = (x, y) => boxAt(cells, x, y, (cell) => cell);
145
140
  const local = (event) => {
146
141
  const box = event.currentTarget.getBoundingClientRect();
147
142
  return { x: event.clientX - box.left, y: event.clientY - box.top };
@@ -13,7 +13,10 @@ import { PlotOverlay } from "../core/plot-overlay.js";
13
13
  import { bandScale } from "../core/scales/band.js";
14
14
  import { linearScale } from "../core/scales/linear.js";
15
15
  import { ChartTooltip } from "../core/tooltip.js";
16
- import { resolveLabels } from "../core/types.js";
16
+ import {
17
+ resolveAxisBound,
18
+ resolveLabels
19
+ } from "../core/types.js";
17
20
  import {
18
21
  pickLabels,
19
22
  waterfallLayout
@@ -169,7 +172,7 @@ function WaterfallPlot({
169
172
  const innerHeight = height - MARGIN.top - MARGIN.bottom;
170
173
  const model = useMemo(() => {
171
174
  const y2 = linearScale({
172
- domain: [yAxis?.min ?? min, yAxis?.max ?? max],
175
+ domain: [resolveAxisBound(yAxis?.min, min), resolveAxisBound(yAxis?.max, max)],
173
176
  range: [innerHeight, 0],
174
177
  tickCount: yAxis?.tickCount ?? Math.max(3, Math.round(innerHeight / 56))
175
178
  });
@@ -368,7 +371,7 @@ function HorizontalWaterfallPlot({
368
371
  );
369
372
  const innerWidth2 = Math.max(40, width - left2 - (dataLabels ? H_MARGIN.right : 12));
370
373
  const x2 = linearScale({
371
- domain: [yAxis?.min ?? min, yAxis?.max ?? max],
374
+ domain: [resolveAxisBound(yAxis?.min, min), resolveAxisBound(yAxis?.max, max)],
372
375
  range: [0, innerWidth2],
373
376
  tickCount: yAxis?.tickCount ?? Math.max(2, Math.round(innerWidth2 / 130))
374
377
  });
@@ -1,7 +1,9 @@
1
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
1
+ import type { ComponentPropsWithoutRef, ReactNode, Ref } from "react";
2
2
  import type { ClassNames } from "../../utils/class-names.js";
3
+ import { type Material } from "../../utils/material.js";
3
4
  export type ActionBarPart = "root" | "count" | "actions" | "clear";
4
5
  export interface ActionBarProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
6
+ ref?: Ref<HTMLDivElement>;
5
7
  /** Number of selected items. The bar renders nothing while it is 0. */
6
8
  selectedCount: number;
7
9
  /** Singular and plural noun for the live count, e.g. ["cita", "citas"]. */
@@ -15,8 +17,15 @@ export interface ActionBarProps extends Omit<ComponentPropsWithoutRef<"div">, "c
15
17
  * ancestor (a card, a table wrapper); `static` renders inline.
16
18
  */
17
19
  position?: "fixed" | "absolute" | "static";
20
+ /**
21
+ * Surface material. Omitted keeps the default for this layer; `"glass"` and `"glass-clear"`
22
+ * are frosted glass, `"liquid"` and `"liquid-clear"` Liquid Glass (with its fallbacks), `"solid"`
23
+ * forces an opaque surface. Liquid options go in `style` (`liquidStyle()` from
24
+ * `@jcsoftdev/ui/liquid`); the lens needs `<LiquidGlass />` mounted once.
25
+ */
26
+ material?: Material;
18
27
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
19
28
  classNames?: ClassNames<ActionBarPart>;
20
29
  }
21
30
  /** Floating toolbar for bulk actions on a selection. Announces the count politely. */
22
- export declare function ActionBar({ selectedCount, noun, onClear, children, position, className, classNames, onKeyDown, ...props }: ActionBarProps): import("react").JSX.Element | null;
31
+ export declare function ActionBar({ selectedCount, noun, onClear, children, position, material, className, classNames, onKeyDown, ...props }: ActionBarProps): import("react").JSX.Element | null;
@@ -2,6 +2,7 @@
2
2
  import { jsx, jsxs } from "react/jsx-runtime";
3
3
  import { X } from "../../icons/index.js";
4
4
  import { cn } from "../../utils/cn.js";
5
+ import { materialClass } from "../../utils/material.js";
5
6
  const positionClasses = {
6
7
  fixed: "fixed inset-x-0 bottom-4 mx-auto",
7
8
  absolute: "absolute inset-x-0 bottom-4 mx-auto",
@@ -13,6 +14,7 @@ function ActionBar({
13
14
  onClear,
14
15
  children,
15
16
  position = "absolute",
17
+ material,
16
18
  className,
17
19
  classNames,
18
20
  onKeyDown,
@@ -33,8 +35,9 @@ function ActionBar({
33
35
  "aria-label": "Acciones para la selecci\xF3n",
34
36
  onKeyDown: handleKeyDown,
35
37
  className: cn(
36
- "@container/action-bar z-40 flex w-fit max-w-[calc(100%-1rem)] flex-wrap items-center gap-density rounded-popover border-card surface-overlay bg-surface-overlay px-control-x py-density-sm shadow-overlay",
38
+ "@container/action-bar z-40 flex w-fit max-w-[calc(100%-1rem)] flex-wrap items-center gap-density rounded-popover border-card surface-overlay px-control-x py-density-sm shadow-overlay",
37
39
  positionClasses[position],
40
+ materialClass(material, "surface-solid"),
38
41
  classNames?.root,
39
42
  className
40
43
  ),
@@ -1,6 +1,24 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithoutRef, ReactNode, Ref } from "react";
2
+ import { type Material } from "../../utils/material.js";
2
3
  export type CardProps = ComponentPropsWithoutRef<"div">;
3
- export declare function Card({ className, ...props }: CardProps): import("react").JSX.Element;
4
- export declare function CardHeader({ className, ...props }: CardProps): import("react").JSX.Element;
4
+ export interface CardRootProps extends CardProps {
5
+ ref?: Ref<HTMLDivElement>;
6
+ /**
7
+ * Cards are content, so they are opaque by default. `"glass"` and `"glass-clear"` opt one into
8
+ * frosted glass, `"liquid"` and `"liquid-clear"` into Liquid Glass (use sparingly, over imagery,
9
+ * never inside another glass surface). Liquid options go in `style` (`liquidStyle()` from
10
+ * `@jcsoftdev/ui/liquid`); the lens needs `<LiquidGlass />` mounted once.
11
+ */
12
+ material?: Material;
13
+ }
14
+ export declare function Card({ className, material, ...props }: CardRootProps): import("react").JSX.Element;
15
+ export interface CardHeaderProps extends Omit<CardProps, "title"> {
16
+ /** Decorative icon before the title; hidden from screen readers. */
17
+ icon?: ReactNode;
18
+ title?: ReactNode;
19
+ /** End slot, e.g. a link or an icon button. */
20
+ action?: ReactNode;
21
+ }
22
+ export declare function CardHeader({ className, icon, title, action, children, ...props }: CardHeaderProps): import("react").JSX.Element;
5
23
  export declare function CardBody({ className, ...props }: CardProps): import("react").JSX.Element;
6
24
  export declare function CardFooter({ className, ...props }: CardProps): import("react").JSX.Element;
@@ -1,26 +1,41 @@
1
- import { jsx } from "react/jsx-runtime";
1
+ import { jsx, jsxs } from "react/jsx-runtime";
2
2
  import { cn } from "../../utils/cn.js";
3
- function Card({ className, ...props }) {
3
+ import { materialClass } from "../../utils/material.js";
4
+ function Card({ className, material, ...props }) {
4
5
  return /* @__PURE__ */ jsx(
5
6
  "div",
6
7
  {
7
8
  className: cn(
8
9
  "min-w-0 rounded-card border-card shadow-card surface-card @container/card",
10
+ materialClass(material, "surface-card"),
9
11
  className
10
12
  ),
11
13
  ...props
12
14
  }
13
15
  );
14
16
  }
15
- function CardHeader({ className, ...props }) {
16
- return /* @__PURE__ */ jsx(
17
+ function CardHeader({
18
+ className,
19
+ icon,
20
+ title,
21
+ action,
22
+ children,
23
+ ...props
24
+ }) {
25
+ return /* @__PURE__ */ jsxs(
17
26
  "div",
18
27
  {
19
28
  className: cn(
20
29
  "flex min-h-12.5 flex-wrap items-center gap-2.5 border-b-divider px-card py-3",
21
30
  className
22
31
  ),
23
- ...props
32
+ ...props,
33
+ children: [
34
+ icon ? /* @__PURE__ */ jsx("span", { "aria-hidden": "true", className: "inline-flex shrink-0 text-ink-3 [&_svg]:size-4.5", children: icon }) : null,
35
+ title ? /* @__PURE__ */ jsx("div", { className: "min-w-0 break-words font-semibold text-ink text-body", children: title }) : null,
36
+ children,
37
+ action ? /* @__PURE__ */ jsx("div", { className: "ml-auto flex shrink-0 items-center gap-2", children: action }) : null
38
+ ]
24
39
  }
25
40
  );
26
41
  }
@@ -0,0 +1,15 @@
1
+ import type { ComponentPropsWithoutRef } from "react";
2
+ import { type StackGap } from "../stack/stack.js";
3
+ export interface GridProps extends ComponentPropsWithoutRef<"div"> {
4
+ /** Fixed number of equal columns. Without it the grid fits as many columns as `minColumnWidth` allows. */
5
+ columns?: number;
6
+ /** Narrowest a column may get before the grid drops one (any CSS length). Defaults to `16rem`. */
7
+ minColumnWidth?: string;
8
+ /** Space between cells. Defaults to `md`. */
9
+ gap?: StackGap;
10
+ }
11
+ /**
12
+ * Equal-width grid. With `columns` the count is fixed; otherwise it is intrinsic (`auto-fill`
13
+ * from `minColumnWidth`), so it reflows by the space it gets without breakpoints.
14
+ */
15
+ export declare function Grid({ columns, minColumnWidth, gap, className, style, ...props }: GridProps): import("react").JSX.Element;
@@ -0,0 +1,24 @@
1
+ import { jsx } from "react/jsx-runtime";
2
+ import { cn } from "../../utils/cn.js";
3
+ import { stackGapClasses } from "../stack/stack.js";
4
+ function Grid({
5
+ columns,
6
+ minColumnWidth = "16rem",
7
+ gap = "md",
8
+ className,
9
+ style,
10
+ ...props
11
+ }) {
12
+ const template = columns === void 0 ? `repeat(auto-fill, minmax(min(100%, ${minColumnWidth}), 1fr))` : `repeat(${columns}, minmax(0, 1fr))`;
13
+ return /* @__PURE__ */ jsx(
14
+ "div",
15
+ {
16
+ className: cn("grid min-w-0", stackGapClasses[gap], className),
17
+ style: { gridTemplateColumns: template, ...style },
18
+ ...props
19
+ }
20
+ );
21
+ }
22
+ export {
23
+ Grid
24
+ };
@@ -0,0 +1 @@
1
+ export { Grid, type GridProps } from "./grid.js";
@@ -0,0 +1,4 @@
1
+ import { Grid } from "./grid.js";
2
+ export {
3
+ Grid
4
+ };
@@ -11,18 +11,21 @@ export * from "./description-list/index.js";
11
11
  export * from "./facts/index.js";
12
12
  export * from "./file-tree/index.js";
13
13
  export * from "./generic-row/index.js";
14
+ export * from "./grid/index.js";
14
15
  export * from "./hbars/index.js";
15
16
  export * from "./highlight-line/index.js";
16
17
  export * from "./item-card-group/index.js";
17
18
  export * from "./kanban/index.js";
18
19
  export * from "./kpi/index.js";
19
20
  export * from "./kpi-group/index.js";
21
+ export * from "./page/index.js";
20
22
  export * from "./page-header/index.js";
21
23
  export * from "./resizable/index.js";
22
24
  export * from "./responsive-list/index.js";
23
25
  export * from "./scrolly/index.js";
24
26
  export * from "./settings-layout/index.js";
25
27
  export * from "./settings-row/index.js";
28
+ export * from "./stack/index.js";
26
29
  export * from "./table/index.js";
27
30
  export * from "./timeline/index.js";
28
31
  export * from "./toolbar/index.js";
@@ -11,18 +11,21 @@ export * from "./description-list/index.js";
11
11
  export * from "./facts/index.js";
12
12
  export * from "./file-tree/index.js";
13
13
  export * from "./generic-row/index.js";
14
+ export * from "./grid/index.js";
14
15
  export * from "./hbars/index.js";
15
16
  export * from "./highlight-line/index.js";
16
17
  export * from "./item-card-group/index.js";
17
18
  export * from "./kanban/index.js";
18
19
  export * from "./kpi/index.js";
19
20
  export * from "./kpi-group/index.js";
21
+ export * from "./page/index.js";
20
22
  export * from "./page-header/index.js";
21
23
  export * from "./resizable/index.js";
22
24
  export * from "./responsive-list/index.js";
23
25
  export * from "./scrolly/index.js";
24
26
  export * from "./settings-layout/index.js";
25
27
  export * from "./settings-row/index.js";
28
+ export * from "./stack/index.js";
26
29
  export * from "./table/index.js";
27
30
  export * from "./timeline/index.js";
28
31
  export * from "./toolbar/index.js";
@@ -1,7 +1,10 @@
1
1
  import type { ComponentPropsWithoutRef, ReactNode } from "react";
2
2
  import type { ClassNames } from "../../utils/class-names.js";
3
3
  export type KpiVariant = "default" | "danger";
4
- export type KpiPart = "root" | "label" | "value" | "suffix" | "description";
4
+ export type KpiBuiltinTone = "neutral" | "accent" | "success" | "warning" | "danger" | "info";
5
+ /** A built-in tone, or the name of a tone declared in `tonePalettes`. */
6
+ export type KpiTone = KpiBuiltinTone | (string & {});
7
+ export type KpiPart = "root" | "header" | "label" | "dot" | "icon" | "value" | "suffix" | "trend" | "description";
5
8
  export interface KpiProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
6
9
  /** Short label describing the metric. */
7
10
  label: ReactNode;
@@ -12,7 +15,15 @@ export interface KpiProps extends Omit<ComponentPropsWithoutRef<"div">, "childre
12
15
  /** Optional subtext. */
13
16
  description?: ReactNode;
14
17
  variant?: KpiVariant;
18
+ /** Colours the value and the label dot. Wins over `variant`. */
19
+ tone?: KpiTone;
20
+ /** Leading dot on the label, in the tone's colour. */
21
+ dot?: boolean;
22
+ /** Icon at the end of the label row. */
23
+ icon?: ReactNode;
24
+ /** Change indicator next to the value, e.g. a `TrendChip`. */
25
+ trend?: ReactNode;
15
26
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
16
27
  classNames?: ClassNames<KpiPart>;
17
28
  }
18
- export declare function Kpi({ label, value, suffix, description, variant, className, classNames, ...props }: KpiProps): import("react").JSX.Element;
29
+ export declare function Kpi({ label, value, suffix, description, variant, tone: toneProp, dot, icon, trend, className, classNames, style, ...props }: KpiProps): import("react").JSX.Element;