@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
@@ -70,6 +70,10 @@ function safeId(raw: string): string {
70
70
  return raw.replace(/[^a-zA-Z0-9_-]/g, "");
71
71
  }
72
72
 
73
+ function sourceIndex(indices: readonly number[] | undefined, start: number, index: number): number {
74
+ return start + (indices ? (indices[index] as number) : index);
75
+ }
76
+
73
77
  function titleOf(value: XValue, xLabel: (value: XValue) => string, custom: boolean): string {
74
78
  if (value instanceof Date && !custom) return formatDate(value);
75
79
  return xLabel(value);
@@ -109,9 +113,12 @@ export function CartesianChart({
109
113
  grid = true,
110
114
  legend,
111
115
  tooltip = true,
116
+ dock,
117
+ tooltipRows,
112
118
  annotations,
113
119
  categoryGroups,
114
120
  categoryLabelRotation,
121
+ categoryTickEvery,
115
122
  onCategoryClick,
116
123
  brush = false,
117
124
  rangeSelect,
@@ -232,6 +239,7 @@ export function CartesianChart({
232
239
  labels={labels}
233
240
  loading={loading}
234
241
  empty={empty}
242
+ dock={tooltip ? dock : "never"}
235
243
  skeleton={series.some((item) => item.kind === "column") ? "bars" : "line"}
236
244
  legendPosition={legendPlacement ?? "top"}
237
245
  legend={
@@ -280,9 +288,11 @@ export function CartesianChart({
280
288
  axes={axes}
281
289
  grid={grid}
282
290
  tooltip={tooltip}
291
+ tooltipRows={tooltipRows}
283
292
  annotations={annotations}
284
293
  categoryGroups={categoryGroups}
285
294
  categoryLabelRotation={categoryLabelRotation}
295
+ categoryTickEvery={categoryTickEvery}
286
296
  onCategoryClick={onCategoryClick}
287
297
  rangeSelect={rangeSelect}
288
298
  overlay={overlay}
@@ -315,9 +325,11 @@ interface CartesianPlotProps
315
325
  | "axes"
316
326
  | "grid"
317
327
  | "tooltip"
328
+ | "tooltipRows"
318
329
  | "annotations"
319
330
  | "categoryGroups"
320
331
  | "categoryLabelRotation"
332
+ | "categoryTickEvery"
321
333
  | "onCategoryClick"
322
334
  | "rangeSelect"
323
335
  | "overlay"
@@ -376,9 +388,11 @@ function CartesianPlot({
376
388
  axes,
377
389
  grid = true,
378
390
  tooltip = true,
391
+ tooltipRows,
379
392
  annotations,
380
393
  categoryGroups,
381
394
  categoryLabelRotation,
395
+ categoryTickEvery,
382
396
  onCategoryClick,
383
397
  rangeSelect,
384
398
  overlay,
@@ -479,6 +493,7 @@ function CartesianPlot({
479
493
  annotations: annotations ?? [],
480
494
  categoryGroups: groupsOn,
481
495
  labelRotation: categoryLabelRotation,
496
+ categoryTickEvery,
482
497
  }),
483
498
  [
484
499
  width,
@@ -498,6 +513,7 @@ function CartesianPlot({
498
513
  annotations,
499
514
  groupsOn,
500
515
  categoryLabelRotation,
516
+ categoryTickEvery,
501
517
  ],
502
518
  );
503
519
  const natural = useMemo(() => computeLayout(layoutInput), [layoutInput]);
@@ -724,8 +740,8 @@ function CartesianPlot({
724
740
  }
725
741
  };
726
742
 
727
- const onPointerLeave = () => {
728
- if (dragStart.current != null) return;
743
+ const onPointerLeave = (event: PointerEvent<HTMLDivElement>) => {
744
+ if (dragStart.current != null || event.pointerType === "touch") return;
729
745
  setActive(null);
730
746
  setPointer(null);
731
747
  setNoteKey(null);
@@ -821,15 +837,25 @@ function CartesianPlot({
821
837
  emphasis: true,
822
838
  });
823
839
  }
824
- return { title: titleOf(category, xLabel, customXLabel), rows };
840
+ const title = titleOf(category, xLabel, customXLabel);
841
+ const text = `${title}: ${rows.map((row) => `${row.name} ${row.value}`).join(", ")}`;
842
+ const custom = tooltipRows?.({
843
+ index: sourceIndex(sampled.indices ?? undefined, start, index),
844
+ category,
845
+ rows,
846
+ });
847
+ return {
848
+ title: custom?.title ?? title,
849
+ rows: custom?.rows ?? rows,
850
+ footer: custom?.footer,
851
+ text,
852
+ };
825
853
  },
826
- [sampled, layout, stack, valueFormat, labels.total, xLabel, customXLabel],
854
+ [sampled, layout, stack, valueFormat, labels.total, xLabel, customXLabel, tooltipRows, start],
827
855
  );
828
856
 
829
857
  const details = active != null && active < count ? describe(active) : null;
830
- const valueText = details
831
- ? `${details.title}: ${details.rows.map((row) => `${row.name} ${row.value}`).join(", ")}`
832
- : labels.explore;
858
+ const valueText = details ? details.text : labels.explore;
833
859
 
834
860
  let anchor: Pointer | null = null;
835
861
  if (active != null && active < count) {
@@ -853,6 +879,22 @@ function CartesianPlot({
853
879
  }
854
880
  }
855
881
 
882
+ const markerSet = useMemo(
883
+ () =>
884
+ Array.isArray(markers)
885
+ ? new Set(
886
+ sampled.categories.flatMap((_, index) =>
887
+ markers.includes(sourceIndex(sampled.indices ?? undefined, start, index))
888
+ ? [index]
889
+ : [],
890
+ ),
891
+ )
892
+ : null,
893
+ [markers, sampled, start],
894
+ );
895
+ const markersFor = (dense: boolean): boolean | ReadonlySet<number> =>
896
+ markerSet ?? (markers === true && dense);
897
+
856
898
  const activePosition = active != null ? layout.positions[active] : undefined;
857
899
  const bandSize = layout.mode === "band" ? layout.step : 0;
858
900
  const gradientId = (seriesId: string) => `${uid}-g-${safeId(seriesId)}`;
@@ -984,7 +1026,7 @@ function CartesianPlot({
984
1026
  geometry={item}
985
1027
  dimmed={highlighted != null && highlighted !== item.id}
986
1028
  gradientId={gradient ? gradientId(item.id) : undefined}
987
- markers={markers && count <= Math.max(2, innerWidth / 9)}
1029
+ markers={markersFor(count <= Math.max(2, innerWidth / 9))}
988
1030
  stacked={stackedAreas}
989
1031
  {...markProps(item.id)}
990
1032
  />
@@ -1009,7 +1051,7 @@ function CartesianPlot({
1009
1051
  key={item.id}
1010
1052
  geometry={item}
1011
1053
  dimmed={highlighted != null && highlighted !== item.id}
1012
- markers={markers && count <= Math.max(2, innerWidth / 9)}
1054
+ markers={markersFor(count <= Math.max(2, innerWidth / 9))}
1013
1055
  stacked={stackedAreas}
1014
1056
  {...markProps(item.id)}
1015
1057
  />
@@ -1158,7 +1200,9 @@ function CartesianPlot({
1158
1200
  aria-valuenow={(active ?? 0) + 1}
1159
1201
  aria-valuetext={valueText}
1160
1202
  onKeyDown={onKeyDown}
1161
- onFocus={() => setActive((current) => current ?? 0)}
1203
+ onFocus={(event) => {
1204
+ if (event.currentTarget.matches(":focus-visible")) setActive((current) => current ?? 0);
1205
+ }}
1162
1206
  onBlur={() => setActive(null)}
1163
1207
  onPointerDown={onPointerDown}
1164
1208
  onPointerMove={onPointerMove}
@@ -1195,6 +1239,7 @@ function CartesianPlot({
1195
1239
  containerWidth={width}
1196
1240
  title={details.title}
1197
1241
  rows={details.rows}
1242
+ footer={details.footer}
1198
1243
  />
1199
1244
  ) : null}
1200
1245
 
@@ -13,7 +13,12 @@ import { type ContinuousScale, extent, linearScale } from "../scales/linear.js";
13
13
  import { logScale } from "../scales/log.js";
14
14
  import { shortMonth, timeScale } from "../scales/time.js";
15
15
  import { type StackLayer, type StackMode, stackLayers } from "../stack.js";
16
- import type { ChartAnnotation, ValueAxisOptions, XValue } from "../types.js";
16
+ import {
17
+ type ChartAnnotation,
18
+ resolveAxisBound,
19
+ type ValueAxisOptions,
20
+ type XValue,
21
+ } from "../types.js";
17
22
  import { type CartesianAxisSpec, resolveAxes, stackAxes } from "./axis-stack.js";
18
23
  import type { MarkKind } from "./types.js";
19
24
 
@@ -169,6 +174,19 @@ export interface LayoutInput {
169
174
  categoryGroups?: boolean;
170
175
  /** Degrees to tilt the category labels (vertical charts). */
171
176
  labelRotation?: number;
177
+ /** Shows every n-th category label, or the ones the predicate accepts; replaces the automatic thinning. */
178
+ categoryTickEvery?: number | ((index: number, label: string) => boolean);
179
+ }
180
+
181
+ /** Keeps the category ticks picked by `every`: each n-th one (from the first), or those the predicate accepts. */
182
+ export function pickCategoryTicks(
183
+ ticks: readonly AxisTick[],
184
+ every: number | ((index: number, label: string) => boolean),
185
+ ): AxisTick[] {
186
+ const step = typeof every === "number" ? Math.max(1, Math.floor(every)) : 0;
187
+ return ticks.filter((tick, index) =>
188
+ typeof every === "function" ? every(index, tick.label) : index % step === 0,
189
+ );
172
190
  }
173
191
 
174
192
  const clamp = (value: number, lo: number, hi: number) => Math.min(hi, Math.max(lo, value));
@@ -211,7 +229,7 @@ function buildLayers(series: readonly ResolvedSeries[], stack: StackMode): Map<s
211
229
  return out;
212
230
  }
213
231
 
214
- function axisDomain(
232
+ export function axisDomain(
215
233
  series: readonly ResolvedSeries[],
216
234
  layers: ReadonlyMap<string, StackLayer>,
217
235
  options: ValueAxisOptions,
@@ -234,9 +252,7 @@ function axisDomain(
234
252
  lo = Math.min(lo, 0);
235
253
  hi = Math.max(hi, 0);
236
254
  }
237
- if (options.min != null) lo = options.min;
238
- if (options.max != null) hi = options.max;
239
- return [lo, hi];
255
+ return [resolveAxisBound(options.min, lo), resolveAxisBound(options.max, hi)];
240
256
  }
241
257
 
242
258
  function makeValueScale(
@@ -473,11 +489,14 @@ export function computeLayout(input: LayoutInput): CartesianLayout {
473
489
  position: positions[index] as number,
474
490
  label,
475
491
  }));
476
- categoryTicks = horizontal
477
- ? ticks
478
- : rotation
479
- ? ticks.filter((_, index) => index % Math.max(1, Math.ceil(14 / band.step)) === 0)
480
- : thinTicks(ticks, 12);
492
+ categoryTicks =
493
+ input.categoryTickEvery != null
494
+ ? pickCategoryTicks(ticks, input.categoryTickEvery)
495
+ : horizontal
496
+ ? ticks
497
+ : rotation
498
+ ? ticks.filter((_, index) => index % Math.max(1, Math.ceil(14 / band.step)) === 0)
499
+ : thinTicks(ticks, 12);
481
500
  indexAt = band.indexAt;
482
501
  mode = band.type;
483
502
  }
@@ -10,8 +10,8 @@ export interface SeriesMarkProps {
10
10
  dimmed: boolean;
11
11
  /** Id of the gradient (areas) defined in the chart `<defs>`. */
12
12
  gradientId?: string;
13
- /** Static dots on every point (lines and areas). */
14
- markers: boolean;
13
+ /** Static dots on every point (lines and areas), or only on the listed point indices. */
14
+ markers: boolean | ReadonlySet<number>;
15
15
  /** Stacked areas use a flatter fill so layers stay distinguishable. */
16
16
  stacked: boolean;
17
17
  /** Id of a gradient that strokes the line instead of the flat color. */
@@ -65,7 +65,7 @@ export const LineAreaMark = memo(function LineAreaMark({
65
65
  ) : null}
66
66
  {markers
67
67
  ? geometry.points.map((point, index) =>
68
- point ? (
68
+ point && (markers === true || markers.has(index)) ? (
69
69
  <circle
70
70
  // biome-ignore lint/suspicious/noArrayIndexKey: one marker per category index.
71
71
  key={index}
@@ -1,7 +1,9 @@
1
1
  import type { ReactNode } from "react";
2
+ import type { ChartDockMode } from "../chart-dock.js";
2
3
  import type { ValueFormat } from "../format.js";
3
4
  import type { Curve } from "../path.js";
4
5
  import type { StackMode } from "../stack.js";
6
+ import type { TooltipRow } from "../tooltip.js";
5
7
  import type {
6
8
  ChartAnnotation,
7
9
  ChartLabels,
@@ -84,6 +86,23 @@ export interface CartesianOverlay {
84
86
  html?: (plot: CartesianPlotInfo) => ReactNode;
85
87
  }
86
88
 
89
+ /** What `tooltipRows` receives for the hovered category. */
90
+ export interface CartesianTooltipContext {
91
+ /** Index in the `categories` you passed (not in the zoomed or downsampled window). */
92
+ index: number;
93
+ category: XValue;
94
+ /** The rows the tooltip would show. */
95
+ rows: TooltipRow[];
96
+ }
97
+
98
+ /** What `tooltipRows` may replace; omitted parts keep their default. */
99
+ export interface CartesianTooltipContent {
100
+ title?: ReactNode;
101
+ rows?: TooltipRow[];
102
+ /** Rendered under the rows. */
103
+ footer?: ReactNode;
104
+ }
105
+
87
106
  export interface CartesianChartProps {
88
107
  /** One entry per data point: strings, numbers or dates. */
89
108
  categories: readonly XValue[];
@@ -101,8 +120,8 @@ export interface CartesianChartProps {
101
120
  /** Stacks every area and column series. */
102
121
  stack?: StackMode;
103
122
  curve?: Curve;
104
- /** Dots on every line point. Hovered points are always marked. */
105
- markers?: boolean;
123
+ /** Dots on every line point, or only on these indices of `categories`. Hovered points are always marked. */
124
+ markers?: boolean | readonly number[];
106
125
  /** Values printed on the marks. */
107
126
  dataLabels?: boolean;
108
127
  /** Strokes lines with a gradient from each series color to the next palette color. */
@@ -139,9 +158,18 @@ export interface CartesianChartProps {
139
158
  legend?: boolean | "top" | "bottom";
140
159
  /** Shared tooltip (default true). */
141
160
  tooltip?: boolean;
161
+ /**
162
+ * Where the tooltip's details go: `auto` (default) docks them in a panel under the chart on
163
+ * containers 480px wide or less and on coarse pointers, `always` / `never` force it.
164
+ */
165
+ dock?: ChartDockMode;
166
+ /** Customises the tooltip content of a category: replace the title or rows, or add a footer. */
167
+ tooltipRows?: (context: CartesianTooltipContext) => CartesianTooltipContent;
142
168
  annotations?: readonly ChartAnnotation[];
143
169
  /** Tilts the category labels (degrees, e.g. -45) so long names fit; vertical charts only. */
144
170
  categoryLabelRotation?: number;
171
+ /** Shows every n-th category label, or those the predicate accepts; replaces the automatic thinning. */
172
+ categoryTickEvery?: number | ((index: number, label: string) => boolean);
145
173
  /** Second tier of labels under the category axis (vertical charts); counts must add up to the categories. */
146
174
  categoryGroups?: readonly CategoryGroup[];
147
175
  /** Click (or Enter on the focused plot) on a category; receives its index in `categories`. */
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
 
3
- import { type KeyboardEvent, type PointerEvent, useState } from "react";
3
+ import { type FocusEvent, type KeyboardEvent, type PointerEvent, useState } from "react";
4
4
  import { cn } from "../../utils/cn.js";
5
5
 
6
6
  export interface CategoryExplorerOptions {
@@ -22,7 +22,7 @@ export interface CategoryExplorer {
22
22
  onPointerLeave: () => void;
23
23
  };
24
24
  onKeyDown: (event: KeyboardEvent<HTMLElement>) => void;
25
- onFocus: () => void;
25
+ onFocus: (event?: FocusEvent<HTMLElement>) => void;
26
26
  onBlur: () => void;
27
27
  }
28
28
 
@@ -52,13 +52,16 @@ export function useCategoryExplorer({
52
52
  const target = event.target as Element | null;
53
53
  const hit = target?.closest?.("[data-category]");
54
54
  const index = hit ? Number(hit.getAttribute("data-category")) : Number.NaN;
55
+ const rect = event.currentTarget.getBoundingClientRect();
56
+ const at = { x: event.clientX - rect.left, y: event.clientY - rect.top };
55
57
  if (!Number.isInteger(index) || !available.includes(index)) {
56
- clear();
58
+ // The gaps between units of one category are not "leaving": keep the category and let the
59
+ // tooltip follow, until another category is reached or the pointer leaves the plot.
60
+ if (active != null) setPointer(at);
57
61
  return;
58
62
  }
59
- const rect = event.currentTarget.getBoundingClientRect();
60
63
  setActive(index);
61
- setPointer({ x: event.clientX - rect.left, y: event.clientY - rect.top });
64
+ setPointer(at);
62
65
  };
63
66
 
64
67
  const onKeyDown = (event: KeyboardEvent<HTMLElement>) => {
@@ -86,7 +89,10 @@ export function useCategoryExplorer({
86
89
  position: shown == null ? null : (pointer ?? anchor(shown)),
87
90
  pointerProps: { onPointerMove, onPointerLeave: clear },
88
91
  onKeyDown,
89
- onFocus: () => setActive((current) => current ?? available[0] ?? null),
92
+ onFocus: (event) => {
93
+ if (event && !event.currentTarget.matches(":focus-visible")) return;
94
+ setActive((current) => current ?? available[0] ?? null);
95
+ },
90
96
  onBlur: clear,
91
97
  };
92
98
  }
@@ -0,0 +1,68 @@
1
+ "use client";
2
+
3
+ import { createContext, useContext, useSyncExternalStore } from "react";
4
+
5
+ /** How a chart's details are shown: `auto` docks on narrow containers and coarse pointers. */
6
+ export type ChartDockMode = "auto" | "always" | "never";
7
+
8
+ /** Viewports up to this width (px) dock their details in `auto` mode. */
9
+ export const DOCK_MAX_WIDTH = 480;
10
+
11
+ /** Minimum height (px) of a touch target, and the snap radius of a tap. */
12
+ export const TOUCH_TARGET = 44;
13
+
14
+ /** A finger as the primary pointer, or a phone-sized viewport: the device, not the chart's width. */
15
+ const DOCK_QUERY = `(pointer: coarse), (max-width: ${DOCK_MAX_WIDTH}px)`;
16
+
17
+ function subscribe(onChange: () => void) {
18
+ const media = window.matchMedia(DOCK_QUERY);
19
+ media.addEventListener("change", onChange);
20
+ return () => media.removeEventListener("change", onChange);
21
+ }
22
+
23
+ /** True on a coarse pointer or a viewport of 480px or less; false during SSR. */
24
+ export function useDockDevice(): boolean {
25
+ return useSyncExternalStore(
26
+ subscribe,
27
+ () => window.matchMedia(DOCK_QUERY).matches,
28
+ () => false,
29
+ );
30
+ }
31
+
32
+ /** Whether details dock for `mode` on this device (`device` is `useDockDevice()`). */
33
+ export function resolveDocked(mode: ChartDockMode, device: boolean): boolean {
34
+ if (mode === "always") return true;
35
+ if (mode === "never") return false;
36
+ return device;
37
+ }
38
+
39
+ /**
40
+ * Classes that show the reserved panel for `mode` without JavaScript, so server markup already
41
+ * holds the space on a phone: always visible for `always`, on a coarse pointer or a viewport of
42
+ * 480px or less for `auto`.
43
+ */
44
+ export const DOCK_SLOT_VISIBILITY: Record<Exclude<ChartDockMode, "never">, string> = {
45
+ always: "block",
46
+ auto: "hidden [@media(pointer:coarse)]:block [@media(max-width:480px)]:block",
47
+ };
48
+
49
+ export interface ChartDockValue {
50
+ /** Element under the plot that receives docked details; null when the frame never docks. */
51
+ slot: HTMLElement | null;
52
+ docked: boolean;
53
+ /** Announces docked details to screen readers; ignored for mouse hover, debounced. */
54
+ announce: (text: string) => void;
55
+ }
56
+
57
+ const ChartDockContext = createContext<ChartDockValue>({
58
+ slot: null,
59
+ docked: false,
60
+ announce: () => {},
61
+ });
62
+
63
+ export const ChartDockProvider = ChartDockContext.Provider;
64
+
65
+ /** Dock state of the enclosing `ChartFrame`. */
66
+ export function useChartDock(): ChartDockValue {
67
+ return useContext(ChartDockContext);
68
+ }
@@ -1,8 +1,16 @@
1
1
  "use client";
2
2
 
3
- import type { ReactNode } from "react";
3
+ import { type ReactNode, useCallback, useEffect, useMemo, useRef, useState } from "react";
4
4
  import { cn } from "../../utils/cn.js";
5
+ import {
6
+ type ChartDockMode,
7
+ ChartDockProvider,
8
+ DOCK_SLOT_VISIBILITY,
9
+ resolveDocked,
10
+ useDockDevice,
11
+ } from "./chart-dock.js";
5
12
  import { ChartEmpty, ChartSkeleton } from "./chart-states.js";
13
+ import { useTouchSelection } from "./touch-select.js";
6
14
  import type { ChartLabels } from "./types.js";
7
15
  import { resolveDrawingHeight, useChartSize } from "./use-chart-size.js";
8
16
 
@@ -34,6 +42,12 @@ export interface ChartFrameProps {
34
42
  legendAside?: boolean;
35
43
  /** Accessible data table (usually `ChartDataTable`), rendered after the drawing. */
36
44
  table?: ReactNode;
45
+ /**
46
+ * Where a chart's details go. `auto` (default) docks them in a panel under the drawing when the
47
+ * frame is 480px wide or less, or the primary pointer is coarse; `always` / `never` force it.
48
+ * The panel reserves a fixed height (it scrolls past that), so the content below never jumps.
49
+ */
50
+ dock?: ChartDockMode;
37
51
  /** Content under the drawing, e.g. the brush. Hidden while loading or empty. */
38
52
  footer?: ReactNode;
39
53
  className?: string;
@@ -59,10 +73,17 @@ export function ChartFrame({
59
73
  legendAside = false,
60
74
  table,
61
75
  footer,
76
+ dock = "auto",
62
77
  className,
63
78
  children,
64
79
  }: ChartFrameProps) {
65
80
  const [ref, size] = useChartSize<HTMLDivElement>();
81
+ const rootRef = useRef<HTMLDivElement>(null);
82
+ const [slot, setSlot] = useState<HTMLElement | null>(null);
83
+ const device = useDockDevice();
84
+ const [spoken, setSpoken] = useState("");
85
+ const how = useRef<"mouse" | "touch" | "keyboard">("mouse");
86
+ const said = useRef({ text: "", timer: undefined as ReturnType<typeof setTimeout> | undefined });
66
87
  const fill = height === "fill";
67
88
  const drawingHeight = resolveDrawingHeight({
68
89
  height,
@@ -71,6 +92,53 @@ export function ChartFrame({
71
92
  measured: size.height,
72
93
  });
73
94
  const ready = !loading && !empty;
95
+ const docked = resolveDocked(dock, device);
96
+ const readDetails = useCallback(
97
+ () => rootRef.current?.querySelector("[data-chart-tooltip]")?.textContent ?? null,
98
+ [],
99
+ );
100
+ useTouchSelection(ref, readDetails, ready);
101
+ useEffect(() => {
102
+ const root = rootRef.current;
103
+ if (!root) return;
104
+ const byPointer = (event: PointerEvent) => {
105
+ how.current = event.pointerType === "mouse" ? "mouse" : "touch";
106
+ };
107
+ const byKey = () => {
108
+ how.current = "keyboard";
109
+ };
110
+ root.addEventListener("pointerover", byPointer, true);
111
+ root.addEventListener("pointermove", byPointer, true);
112
+ root.addEventListener("pointerdown", byPointer, true);
113
+ root.addEventListener("keydown", byKey, true);
114
+ const state = said.current;
115
+ return () => {
116
+ root.removeEventListener("pointerover", byPointer, true);
117
+ root.removeEventListener("pointermove", byPointer, true);
118
+ root.removeEventListener("pointerdown", byPointer, true);
119
+ root.removeEventListener("keydown", byKey, true);
120
+ clearTimeout(state.timer);
121
+ };
122
+ }, []);
123
+ /**
124
+ * Speaks docked details, only when the text changes, 150ms after the last change, and never for
125
+ * mouse hover: keyboard users already hear the slider's value text, and a hover would stream.
126
+ */
127
+ const announce = useCallback((text: string) => {
128
+ const state = said.current;
129
+ clearTimeout(state.timer);
130
+ if (text === "") {
131
+ state.text = "";
132
+ setSpoken("");
133
+ return;
134
+ }
135
+ if (how.current === "mouse" || text === state.text) return;
136
+ state.timer = setTimeout(() => {
137
+ state.text = text;
138
+ setSpoken(text);
139
+ }, 150);
140
+ }, []);
141
+ const dockValue = useMemo(() => ({ slot, docked, announce }), [slot, docked, announce]);
74
142
  const legendNode =
75
143
  ready && legend ? (
76
144
  legendAside ? (
@@ -83,37 +151,58 @@ export function ChartFrame({
83
151
  ) : null;
84
152
 
85
153
  return (
86
- <div className={cn("@container/chart relative w-full min-w-0", fill && "h-full", className)}>
87
- <div
88
- className={cn(
89
- "flex w-full min-w-0 flex-col gap-2",
90
- fill && "h-full",
91
- legendAside && "@lg/chart:flex-row @lg/chart:items-center @lg/chart:gap-4",
92
- )}
93
- >
94
- {legendPosition === "top" ? legendNode : null}
154
+ <div
155
+ ref={rootRef}
156
+ className={cn("@container/chart relative w-full min-w-0", fill && "h-full", className)}
157
+ >
158
+ <ChartDockProvider value={dockValue}>
95
159
  <div
96
- ref={ref}
97
160
  className={cn(
98
- "relative min-w-0",
99
- fill
100
- ? "min-h-0 flex-1 basis-0 @lg/chart:self-stretch"
101
- : cn("w-full", legendAside && "@lg/chart:w-auto @lg/chart:flex-1"),
161
+ "flex w-full min-w-0 flex-col gap-2",
162
+ fill && "h-full",
163
+ legendAside && "@lg/chart:flex-row @lg/chart:items-center @lg/chart:gap-4",
102
164
  )}
103
- style={fill ? { minHeight: FILL_MIN_HEIGHT } : { height: drawingHeight }}
104
165
  >
105
- {loading ? (
106
- <ChartSkeleton height={drawingHeight} label={labels.loading} shape={skeleton} />
107
- ) : empty ? (
108
- <ChartEmpty height={drawingHeight} label={labels.empty} />
109
- ) : (
110
- children(size.width, drawingHeight)
111
- )}
166
+ {legendPosition === "top" ? legendNode : null}
167
+ <div
168
+ ref={ref}
169
+ className={cn(
170
+ "relative min-w-0",
171
+ fill
172
+ ? "min-h-0 flex-1 basis-0 @lg/chart:self-stretch"
173
+ : cn("w-full", legendAside && "@lg/chart:w-auto @lg/chart:flex-1"),
174
+ )}
175
+ style={fill ? { minHeight: FILL_MIN_HEIGHT } : { height: drawingHeight }}
176
+ >
177
+ {loading ? (
178
+ <ChartSkeleton height={drawingHeight} label={labels.loading} shape={skeleton} />
179
+ ) : empty ? (
180
+ <ChartEmpty height={drawingHeight} label={labels.empty} />
181
+ ) : (
182
+ children(size.width, drawingHeight)
183
+ )}
184
+ </div>
185
+ {dock !== "never" ? (
186
+ <>
187
+ <div
188
+ ref={setSlot}
189
+ data-chart-dock=""
190
+ aria-hidden="true"
191
+ className={cn(
192
+ "h-40 shrink-0 overflow-y-auto overscroll-contain",
193
+ DOCK_SLOT_VISIBILITY[dock],
194
+ )}
195
+ />
196
+ <div role="status" aria-live="polite" aria-atomic="true" className="sr-only">
197
+ {spoken}
198
+ </div>
199
+ </>
200
+ ) : null}
201
+ {ready ? footer : null}
202
+ {legendPosition === "bottom" ? legendNode : null}
203
+ {ready ? table : null}
112
204
  </div>
113
- {ready ? footer : null}
114
- {legendPosition === "bottom" ? legendNode : null}
115
- {ready ? table : null}
116
- </div>
205
+ </ChartDockProvider>
117
206
  </div>
118
207
  );
119
208
  }