@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
@@ -0,0 +1,189 @@
1
+ "use client";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import { useEffect, useId, useMemo, useRef, useState } from "react";
4
+ import { useUiStrings } from "../../i18n/index.js";
5
+ import { ChevronLeft, ChevronRight } from "../../icons/index.js";
6
+ import { cn } from "../../utils/cn.js";
7
+ import {
8
+ addDays,
9
+ addMonths,
10
+ clampDate,
11
+ formatFullDate,
12
+ formatMonthTitle,
13
+ isIsoDate,
14
+ monthWeeks,
15
+ startOfWeek,
16
+ todayIso,
17
+ weekdayNames,
18
+ weekStartFor
19
+ } from "../internal/date-utils.js";
20
+ const KEY_STEPS = {
21
+ ArrowLeft: -1,
22
+ ArrowRight: 1,
23
+ ArrowUp: -7,
24
+ ArrowDown: 7
25
+ };
26
+ const NAV = "inline-flex size-8 min-h-(--touch-target) min-w-(--touch-target) items-center justify-center rounded-event text-ink-2 outline-none hover:bg-surface-2 focus-visible:focus-ring disabled:pointer-events-none disabled:opacity-40";
27
+ function DateCalendar({
28
+ value,
29
+ onSelect,
30
+ min,
31
+ max,
32
+ isDateDisabled,
33
+ locale: localeProp,
34
+ weekStartsOn: weekStartProp,
35
+ today: todayProp,
36
+ autoFocus = false,
37
+ className,
38
+ classNames
39
+ }) {
40
+ const strings = useUiStrings();
41
+ const locale = localeProp || strings.locale;
42
+ const weekStartsOn = weekStartProp ?? weekStartFor(locale);
43
+ const titleId = useId();
44
+ const gridRef = useRef(null);
45
+ const moveFocus = useRef(autoFocus);
46
+ const [today] = useState(() => todayProp ?? todayIso());
47
+ const [focused, setFocused] = useState(
48
+ () => clampDate(value && isIsoDate(value) ? value : today, min, max)
49
+ );
50
+ const weeks = useMemo(() => monthWeeks(focused, weekStartsOn), [focused, weekStartsOn]);
51
+ const names = useMemo(() => weekdayNames(locale, weekStartsOn), [locale, weekStartsOn]);
52
+ const month = focused.slice(0, 7);
53
+ const disabled = (date) => Boolean(min && date < min || max && date > max || isDateDisabled?.(date));
54
+ useEffect(() => {
55
+ if (!moveFocus.current) return;
56
+ gridRef.current?.querySelector(`[data-date="${focused}"]`)?.focus();
57
+ }, [focused]);
58
+ const goTo = (date, focusDay) => {
59
+ moveFocus.current = focusDay;
60
+ setFocused(clampDate(date, min, max));
61
+ };
62
+ const onKeyDown = (event) => {
63
+ if (event.altKey || event.ctrlKey || event.metaKey) return;
64
+ const step = KEY_STEPS[event.key];
65
+ let next;
66
+ if (step !== void 0) next = addDays(focused, step);
67
+ else if (event.key === "Home") next = startOfWeek(focused, weekStartsOn);
68
+ else if (event.key === "End") next = addDays(startOfWeek(focused, weekStartsOn), 6);
69
+ else if (event.key === "PageUp" || event.key === "PageDown") {
70
+ next = addMonths(focused, (event.key === "PageUp" ? -1 : 1) * (event.shiftKey ? 12 : 1));
71
+ }
72
+ if (next === void 0) return;
73
+ event.preventDefault();
74
+ goTo(next, true);
75
+ };
76
+ const monthStart = `${month}-01`;
77
+ const prevDisabled = Boolean(min && addDays(monthStart, -1) < min);
78
+ const nextDisabled = Boolean(max && addMonths(monthStart, 1) > max);
79
+ return /* @__PURE__ */ jsxs("div", { className: cn("flex w-fit flex-col gap-2", classNames?.root, className), children: [
80
+ /* @__PURE__ */ jsxs("div", { className: cn("flex items-center justify-between gap-2", classNames?.header), children: [
81
+ /* @__PURE__ */ jsx(
82
+ "button",
83
+ {
84
+ type: "button",
85
+ "aria-label": strings.previousMonth,
86
+ disabled: prevDisabled,
87
+ onClick: () => goTo(addMonths(focused, -1), false),
88
+ className: cn(NAV, classNames?.nav),
89
+ children: /* @__PURE__ */ jsx(ChevronLeft, { "aria-hidden": "true", className: "size-4" })
90
+ }
91
+ ),
92
+ /* @__PURE__ */ jsx(
93
+ "div",
94
+ {
95
+ id: titleId,
96
+ "aria-live": "polite",
97
+ className: cn("font-semibold text-body text-ink", classNames?.title),
98
+ children: formatMonthTitle(focused, locale)
99
+ }
100
+ ),
101
+ /* @__PURE__ */ jsx(
102
+ "button",
103
+ {
104
+ type: "button",
105
+ "aria-label": strings.nextMonth,
106
+ disabled: nextDisabled,
107
+ onClick: () => goTo(addMonths(focused, 1), false),
108
+ className: cn(NAV, classNames?.nav),
109
+ children: /* @__PURE__ */ jsx(ChevronRight, { "aria-hidden": "true", className: "size-4" })
110
+ }
111
+ )
112
+ ] }),
113
+ /* @__PURE__ */ jsxs(
114
+ "table",
115
+ {
116
+ ref: gridRef,
117
+ role: "grid",
118
+ "aria-labelledby": titleId,
119
+ onKeyDown,
120
+ className: cn("border-collapse", classNames?.grid),
121
+ children: [
122
+ /* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsx("tr", { children: names.map((name) => /* @__PURE__ */ jsx(
123
+ "th",
124
+ {
125
+ scope: "col",
126
+ "aria-label": name.long,
127
+ className: cn(
128
+ "size-9 p-0 text-center font-semibold text-ink-3 text-meta uppercase",
129
+ classNames?.weekday
130
+ ),
131
+ children: name.narrow
132
+ },
133
+ name.long
134
+ )) }) }),
135
+ /* @__PURE__ */ jsx("tbody", { children: weeks.map((week) => /* @__PURE__ */ jsx("tr", { children: week.map((date) => {
136
+ const selected = date === value;
137
+ const isDisabled = disabled(date);
138
+ const outside = !date.startsWith(month);
139
+ return (
140
+ // biome-ignore lint/a11y/useFocusableInteractive: the button inside the cell takes focus.
141
+ /* @__PURE__ */ jsx(
142
+ "td",
143
+ {
144
+ role: "gridcell",
145
+ "aria-selected": selected,
146
+ className: "p-0",
147
+ children: /* @__PURE__ */ jsx(
148
+ "button",
149
+ {
150
+ type: "button",
151
+ "data-date": date,
152
+ tabIndex: date === focused ? 0 : -1,
153
+ "aria-label": formatFullDate(date, locale),
154
+ "aria-current": date === today ? "date" : void 0,
155
+ "aria-disabled": isDisabled || void 0,
156
+ "data-selected": selected ? "" : void 0,
157
+ "data-outside": outside ? "" : void 0,
158
+ onFocus: () => {
159
+ moveFocus.current = true;
160
+ setFocused(date);
161
+ },
162
+ onClick: () => {
163
+ if (!isDisabled) onSelect(date);
164
+ },
165
+ className: cn(
166
+ "flex size-9 min-h-(--touch-target) min-w-(--touch-target) items-center justify-center rounded-event text-body tabular-nums outline-none focus-visible:focus-ring",
167
+ outside ? "text-ink-3" : "text-ink",
168
+ date === today && !selected && "font-bold text-accent-ink",
169
+ !isDisabled && !selected && "hover:bg-surface-2",
170
+ selected && "bg-accent font-bold text-on-accent",
171
+ isDisabled && "cursor-not-allowed text-ink-3 line-through opacity-50",
172
+ classNames?.day
173
+ ),
174
+ children: Number(date.slice(8))
175
+ }
176
+ )
177
+ },
178
+ date
179
+ )
180
+ );
181
+ }) }, week[0])) })
182
+ ]
183
+ }
184
+ )
185
+ ] });
186
+ }
187
+ export {
188
+ DateCalendar
189
+ };
@@ -0,0 +1 @@
1
+ export { DateCalendar, type DateCalendarPart, type DateCalendarProps, } from "./date-calendar.js";
@@ -0,0 +1,6 @@
1
+ import {
2
+ DateCalendar
3
+ } from "./date-calendar.js";
4
+ export {
5
+ DateCalendar
6
+ };
@@ -1,3 +1,4 @@
1
+ export * from "./date-calendar/index.js";
1
2
  export * from "./day-chip/index.js";
2
3
  export * from "./event-block/index.js";
3
4
  export * from "./month-view/index.js";
@@ -1,3 +1,4 @@
1
+ export * from "./date-calendar/index.js";
1
2
  export * from "./day-chip/index.js";
2
3
  export * from "./event-block/index.js";
3
4
  export * from "./month-view/index.js";
@@ -16,3 +16,29 @@ export declare function formatWeekdayAndDay(value: string, locale?: string): str
16
16
  export declare function formatMonthShort(value: string, locale?: string): string;
17
17
  /** Localized hour label for an hour of the day (0-23). */
18
18
  export declare function formatHour(hour: number, locale?: string): string;
19
+ /** True for a real calendar date written "YYYY-MM-DD" (rejects "2026-02-30"). */
20
+ export declare function isIsoDate(value: string): boolean;
21
+ /** Builds "YYYY-MM-DD" from numeric parts; no time zone is involved. */
22
+ export declare function toIsoDate(year: number, month: number, day: number): string;
23
+ /** Same day of the month `amount` months away, or the last day when the month is shorter. */
24
+ export declare function addMonths(value: string, amount: number): string;
25
+ /** The viewer's calendar date today, read from local fields (never from the UTC date). */
26
+ export declare function todayIso(now?: Date): string;
27
+ /** `value` pulled inside `[min, max]`. ISO dates compare correctly as strings. */
28
+ export declare function clampDate(value: string, min?: string, max?: string): string;
29
+ /**
30
+ * First day of the week for a BCP 47 locale: Sunday (0) where that is the convention of the
31
+ * region (en-US, es-MX, pt-BR, ...), Monday (1) everywhere else, including es-PE and en-GB.
32
+ */
33
+ export declare function weekStartFor(locale: string): WeekStart;
34
+ /** "September 2026" with only the first letter capitalised ("Setiembre de 2026"). */
35
+ export declare function formatMonthTitle(value: string, locale?: string): string;
36
+ /** Full date for a screen reader, e.g. "Monday, September 7, 2026". */
37
+ export declare function formatFullDate(value: string, locale?: string): string;
38
+ /** Weekday names in column order starting at `weekStartsOn`. */
39
+ export declare function weekdayNames(locale: string | undefined, weekStartsOn: WeekStart): {
40
+ narrow: string;
41
+ long: string;
42
+ }[];
43
+ /** Six full weeks of "YYYY-MM-DD" covering the month of `value`, so the grid keeps its height. */
44
+ export declare function monthWeeks(value: string, weekStartsOn: WeekStart): string[][];
@@ -52,15 +52,109 @@ function formatHour(hour, locale) {
52
52
  timeZone: "UTC"
53
53
  }).format(new Date(Date.UTC(1970, 0, 1, hour)));
54
54
  }
55
+ const ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
56
+ function isIsoDate(value) {
57
+ const match = ISO_DATE.exec(value);
58
+ if (!match) return false;
59
+ const [year, month, day] = [Number(match[1]), Number(match[2]), Number(match[3])];
60
+ const date = new Date(Date.UTC(year, month - 1, day));
61
+ return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
62
+ }
63
+ function toIsoDate(year, month, day) {
64
+ return `${String(year).padStart(4, "0")}-${String(month).padStart(2, "0")}-${String(day).padStart(2, "0")}`;
65
+ }
66
+ function addMonths(value, amount) {
67
+ const date = parseDate(value);
68
+ const target = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth() + amount, 1));
69
+ const last = new Date(
70
+ Date.UTC(target.getUTCFullYear(), target.getUTCMonth() + 1, 0)
71
+ ).getUTCDate();
72
+ return toIsoDate(
73
+ target.getUTCFullYear(),
74
+ target.getUTCMonth() + 1,
75
+ Math.min(date.getUTCDate(), last)
76
+ );
77
+ }
78
+ function todayIso(now = /* @__PURE__ */ new Date()) {
79
+ return toIsoDate(now.getFullYear(), now.getMonth() + 1, now.getDate());
80
+ }
81
+ function clampDate(value, min, max) {
82
+ if (min && value < min) return min;
83
+ if (max && value > max) return max;
84
+ return value;
85
+ }
86
+ const SUNDAY_REGIONS = /* @__PURE__ */ new Set([
87
+ "US",
88
+ "CA",
89
+ "MX",
90
+ "BR",
91
+ "JP",
92
+ "KR",
93
+ "IL",
94
+ "IN",
95
+ "PH",
96
+ "TW",
97
+ "HK",
98
+ "ZA",
99
+ "CO",
100
+ "VE",
101
+ "SA"
102
+ ]);
103
+ function weekStartFor(locale) {
104
+ const region = /[-_]([A-Za-z]{2})(?:[-_]|$)/.exec(locale)?.[1]?.toUpperCase();
105
+ if (region) return SUNDAY_REGIONS.has(region) ? 0 : 1;
106
+ return locale.toLowerCase().startsWith("en") || locale.toLowerCase().startsWith("ja") ? 0 : 1;
107
+ }
108
+ function formatMonthTitle(value, locale) {
109
+ const raw = format(value, locale, { month: "long", year: "numeric" });
110
+ return raw.charAt(0).toLocaleUpperCase(locale) + raw.slice(1);
111
+ }
112
+ function formatFullDate(value, locale) {
113
+ return format(value, locale, { dateStyle: "full" });
114
+ }
115
+ function weekdayNames(locale, weekStartsOn) {
116
+ return Array.from({ length: 7 }, (_, index) => {
117
+ const day = addDays("2024-01-07", weekStartsOn + index);
118
+ return {
119
+ narrow: format(day, locale, { weekday: "narrow" }),
120
+ long: format(day, locale, { weekday: "long" })
121
+ };
122
+ });
123
+ }
124
+ function monthWeeks(value, weekStartsOn) {
125
+ const date = parseDate(value);
126
+ let cursor = startOfWeek(
127
+ formatDate(new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), 1))),
128
+ weekStartsOn
129
+ );
130
+ return Array.from(
131
+ { length: 6 },
132
+ () => Array.from({ length: 7 }, () => {
133
+ const day = cursor;
134
+ cursor = addDays(cursor, 1);
135
+ return day;
136
+ })
137
+ );
138
+ }
55
139
  export {
56
140
  addDays,
141
+ addMonths,
142
+ clampDate,
57
143
  formatDate,
144
+ formatFullDate,
58
145
  formatHour,
59
146
  formatMonthShort,
147
+ formatMonthTitle,
60
148
  formatWeekday,
61
149
  formatWeekdayAndDay,
150
+ isIsoDate,
62
151
  minutesSinceMidnight,
63
152
  monthGrid,
153
+ monthWeeks,
64
154
  parseDate,
65
- startOfWeek
155
+ startOfWeek,
156
+ toIsoDate,
157
+ todayIso,
158
+ weekStartFor,
159
+ weekdayNames
66
160
  };
@@ -92,6 +92,7 @@ function BarRaceChart({
92
92
  return /* @__PURE__ */ jsx(
93
93
  ChartFrame,
94
94
  {
95
+ dock: "never",
95
96
  height,
96
97
  aspectRatio,
97
98
  labels,
@@ -331,7 +331,7 @@ function BeeswarmPlot({
331
331
  count: points.length,
332
332
  active,
333
333
  onActiveChange: setActive,
334
- pick: (x, y) => nearestPoint(points, x, y, 14),
334
+ pick: (x, y, radius2) => nearestPoint(points, x, y, radius2 ?? 14),
335
335
  label: labels.explore,
336
336
  valueText,
337
337
  margin,
@@ -8,6 +8,7 @@ import { chordLayout, chordsOf, ribbonPath } from "../core/chord.js";
8
8
  import { ChartDataTable } from "../core/data-table.js";
9
9
  import { DEFAULT_EXPORT_TEXTS, ExportMenu } from "../core/export-menu.js";
10
10
  import { resolveFormat } from "../core/format.js";
11
+ import { useLeaveGrace } from "../core/leave-grace.js";
11
12
  import { ChartLegend } from "../core/legend.js";
12
13
  import { EASE_OUT, fadeIn, useEntryAnimation } from "../core/motion.js";
13
14
  import { seriesColor } from "../core/palette.js";
@@ -160,6 +161,11 @@ function ChordPlot({
160
161
  );
161
162
  const nav = useIndexNavigation(order.length, { wrap: true });
162
163
  const [hover, setHover] = useState(null);
164
+ const { leave: leaveSoon, hold } = useLeaveGrace(() => setHover(null));
165
+ const showHover = (next) => {
166
+ hold();
167
+ setHover(next);
168
+ };
163
169
  const rim = showLabels && width >= 420;
164
170
  const labelRoom = rim ? Math.min(
165
171
  width * 0.28,
@@ -300,8 +306,8 @@ function ChordPlot({
300
306
  radius: inner - 2,
301
307
  colors,
302
308
  lit,
303
- onEnter: (chord, event) => setHover({ focus: { kind: "chord", key: chordKey(chord) }, ...point(event) }),
304
- onLeave: () => setHover(null)
309
+ onEnter: (chord, event) => showHover({ focus: { kind: "chord", key: chordKey(chord) }, ...point(event) }),
310
+ onLeave: leaveSoon
305
311
  }
306
312
  ),
307
313
  layout.groups.map((group) => {
@@ -321,6 +327,7 @@ function ChordPlot({
321
327
  endAngle: group.endAngle,
322
328
  cornerRadius: 3
323
329
  }),
330
+ "data-chart-hit": "",
324
331
  className: onGroupClick ? "cursor-pointer" : "cursor-default",
325
332
  style: {
326
333
  fill: colors[group.index],
@@ -329,9 +336,9 @@ function ChordPlot({
329
336
  transformBox: "fill-box",
330
337
  transformOrigin: "center"
331
338
  },
332
- onPointerEnter: (event) => setHover({ focus: { kind: "group", index: group.index }, ...point(event) }),
333
- onPointerMove: (event) => setHover({ focus: { kind: "group", index: group.index }, ...point(event) }),
334
- onPointerLeave: () => setHover(null),
339
+ onPointerEnter: (event) => showHover({ focus: { kind: "group", index: group.index }, ...point(event) }),
340
+ onPointerMove: (event) => showHover({ focus: { kind: "group", index: group.index }, ...point(event) }),
341
+ onPointerLeave: leaveSoon,
335
342
  onClick: () => {
336
343
  const input = groups[group.index];
337
344
  if (input) onGroupClick?.(input, group.index);
@@ -404,6 +411,7 @@ const ChordRibbons = memo(function ChordRibbons2({
404
411
  "path",
405
412
  {
406
413
  "data-ribbon": "",
414
+ "data-chart-hit": "",
407
415
  d: ribbonPath(chord, radius),
408
416
  className: "motion-safe:transition-[fill-opacity] motion-safe:duration-150",
409
417
  style: {
@@ -5,4 +5,4 @@ import type { CartesianChartProps } from "./types.js";
5
5
  * exploration, annotations, entry animation and the zoom brush.
6
6
  * `LineChart`, `AreaChart`, `BarChart` and `ComboChart` are presets of it.
7
7
  */
8
- export declare function CartesianChart({ categories, series, title, description, height, aspectRatio, orientation, stack, curve, markers, dataLabels, gradient, lineGradient, transition, maxPoints, syncId, onPointClick, barRadius, valueFormat, xFormat, xScale, yAxis, rightAxis, axes, grid, legend, tooltip, annotations, categoryGroups, categoryLabelRotation, onCategoryClick, brush, rangeSelect, overlay, loading, animate, initialHidden, labels: labelsProp, className, }: CartesianChartProps): import("react").JSX.Element;
8
+ export declare function CartesianChart({ categories, series, title, description, height, aspectRatio, orientation, stack, curve, markers, dataLabels, gradient, lineGradient, transition, maxPoints, syncId, onPointClick, barRadius, valueFormat, xFormat, xScale, yAxis, rightAxis, axes, grid, legend, tooltip, dock, tooltipRows, annotations, categoryGroups, categoryLabelRotation, categoryTickEvery, onCategoryClick, brush, rangeSelect, overlay, loading, animate, initialHidden, labels: labelsProp, className, }: CartesianChartProps): import("react").JSX.Element;
@@ -51,6 +51,9 @@ function legendShape(kind, dashed) {
51
51
  function safeId(raw) {
52
52
  return raw.replace(/[^a-zA-Z0-9_-]/g, "");
53
53
  }
54
+ function sourceIndex(indices, start, index) {
55
+ return start + (indices ? indices[index] : index);
56
+ }
54
57
  function titleOf(value, xLabel, custom) {
55
58
  if (value instanceof Date && !custom) return formatDate(value);
56
59
  return xLabel(value);
@@ -83,9 +86,12 @@ function CartesianChart({
83
86
  grid = true,
84
87
  legend,
85
88
  tooltip = true,
89
+ dock,
90
+ tooltipRows,
86
91
  annotations,
87
92
  categoryGroups,
88
93
  categoryLabelRotation,
94
+ categoryTickEvery,
89
95
  onCategoryClick,
90
96
  brush = false,
91
97
  rangeSelect,
@@ -188,6 +194,7 @@ function CartesianChart({
188
194
  labels,
189
195
  loading,
190
196
  empty,
197
+ dock: tooltip ? dock : "never",
191
198
  skeleton: series.some((item) => item.kind === "column") ? "bars" : "line",
192
199
  legendPosition: legendPlacement ?? "top",
193
200
  legend: showLegend ? /* @__PURE__ */ jsx(
@@ -235,9 +242,11 @@ function CartesianChart({
235
242
  axes,
236
243
  grid,
237
244
  tooltip,
245
+ tooltipRows,
238
246
  annotations,
239
247
  categoryGroups,
240
248
  categoryLabelRotation,
249
+ categoryTickEvery,
241
250
  onCategoryClick,
242
251
  rangeSelect,
243
252
  overlay,
@@ -280,9 +289,11 @@ function CartesianPlot({
280
289
  axes,
281
290
  grid = true,
282
291
  tooltip = true,
292
+ tooltipRows,
283
293
  annotations,
284
294
  categoryGroups,
285
295
  categoryLabelRotation,
296
+ categoryTickEvery,
286
297
  onCategoryClick,
287
298
  rangeSelect,
288
299
  overlay,
@@ -365,7 +376,8 @@ function CartesianPlot({
365
376
  axes,
366
377
  annotations: annotations ?? [],
367
378
  categoryGroups: groupsOn,
368
- labelRotation: categoryLabelRotation
379
+ labelRotation: categoryLabelRotation,
380
+ categoryTickEvery
369
381
  }),
370
382
  [
371
383
  width,
@@ -384,7 +396,8 @@ function CartesianPlot({
384
396
  axes,
385
397
  annotations,
386
398
  groupsOn,
387
- categoryLabelRotation
399
+ categoryLabelRotation,
400
+ categoryTickEvery
388
401
  ]
389
402
  );
390
403
  const natural = useMemo(() => computeLayout(layoutInput), [layoutInput]);
@@ -572,8 +585,8 @@ function CartesianPlot({
572
585
  event.currentTarget.releasePointerCapture(event.pointerId);
573
586
  }
574
587
  };
575
- const onPointerLeave = () => {
576
- if (dragStart.current != null) return;
588
+ const onPointerLeave = (event) => {
589
+ if (dragStart.current != null || event.pointerType === "touch") return;
577
590
  setActive(null);
578
591
  setPointer(null);
579
592
  setNoteKey(null);
@@ -657,12 +670,24 @@ function CartesianPlot({
657
670
  emphasis: true
658
671
  });
659
672
  }
660
- return { title: titleOf(category, xLabel, customXLabel), rows };
673
+ const title2 = titleOf(category, xLabel, customXLabel);
674
+ const text = `${title2}: ${rows.map((row) => `${row.name} ${row.value}`).join(", ")}`;
675
+ const custom = tooltipRows?.({
676
+ index: sourceIndex(sampled.indices ?? void 0, start, index),
677
+ category,
678
+ rows
679
+ });
680
+ return {
681
+ title: custom?.title ?? title2,
682
+ rows: custom?.rows ?? rows,
683
+ footer: custom?.footer,
684
+ text
685
+ };
661
686
  },
662
- [sampled, layout, stack, valueFormat, labels.total, xLabel, customXLabel]
687
+ [sampled, layout, stack, valueFormat, labels.total, xLabel, customXLabel, tooltipRows, start]
663
688
  );
664
689
  const details = active != null && active < count ? describe(active) : null;
665
- const valueText = details ? `${details.title}: ${details.rows.map((row) => `${row.name} ${row.value}`).join(", ")}` : labels.explore;
690
+ const valueText = details ? details.text : labels.explore;
666
691
  let anchor = null;
667
692
  if (active != null && active < count) {
668
693
  const position = layout.positions[active];
@@ -682,6 +707,15 @@ function CartesianPlot({
682
707
  };
683
708
  }
684
709
  }
710
+ const markerSet = useMemo(
711
+ () => Array.isArray(markers) ? new Set(
712
+ sampled.categories.flatMap(
713
+ (_, index) => markers.includes(sourceIndex(sampled.indices ?? void 0, start, index)) ? [index] : []
714
+ )
715
+ ) : null,
716
+ [markers, sampled, start]
717
+ );
718
+ const markersFor = (dense) => markerSet ?? (markers === true && dense);
685
719
  const activePosition = active != null ? layout.positions[active] : void 0;
686
720
  const bandSize = layout.mode === "band" ? layout.step : 0;
687
721
  const gradientId = (seriesId) => `${uid}-g-${safeId(seriesId)}`;
@@ -821,7 +855,7 @@ function CartesianPlot({
821
855
  geometry: item,
822
856
  dimmed: highlighted != null && highlighted !== item.id,
823
857
  gradientId: gradient ? gradientId(item.id) : void 0,
824
- markers: markers && count <= Math.max(2, innerWidth / 9),
858
+ markers: markersFor(count <= Math.max(2, innerWidth / 9)),
825
859
  stacked: stackedAreas,
826
860
  ...markProps(item.id)
827
861
  },
@@ -846,7 +880,7 @@ function CartesianPlot({
846
880
  {
847
881
  geometry: item,
848
882
  dimmed: highlighted != null && highlighted !== item.id,
849
- markers: markers && count <= Math.max(2, innerWidth / 9),
883
+ markers: markersFor(count <= Math.max(2, innerWidth / 9)),
850
884
  stacked: stackedAreas,
851
885
  ...markProps(item.id)
852
886
  },
@@ -986,7 +1020,9 @@ function CartesianPlot({
986
1020
  "aria-valuenow": (active ?? 0) + 1,
987
1021
  "aria-valuetext": valueText,
988
1022
  onKeyDown,
989
- onFocus: () => setActive((current) => current ?? 0),
1023
+ onFocus: (event) => {
1024
+ if (event.currentTarget.matches(":focus-visible")) setActive((current) => current ?? 0);
1025
+ },
990
1026
  onBlur: () => setActive(null),
991
1027
  onPointerDown,
992
1028
  onPointerMove,
@@ -1019,7 +1055,8 @@ function CartesianPlot({
1019
1055
  y: anchor.y,
1020
1056
  containerWidth: width,
1021
1057
  title: details.title,
1022
- rows: details.rows
1058
+ rows: details.rows,
1059
+ footer: details.footer
1023
1060
  }
1024
1061
  ) : null,
1025
1062
  range ? /* @__PURE__ */ jsxs(
@@ -5,7 +5,7 @@ import { type Curve, type Point } from "../path.js";
5
5
  import type { ChartPattern } from "../patterns.js";
6
6
  import { type ContinuousScale } from "../scales/linear.js";
7
7
  import { type StackLayer, type StackMode } from "../stack.js";
8
- import type { ChartAnnotation, ValueAxisOptions, XValue } from "../types.js";
8
+ import { type ChartAnnotation, type ValueAxisOptions, type XValue } from "../types.js";
9
9
  import { type CartesianAxisSpec } from "./axis-stack.js";
10
10
  import type { MarkKind } from "./types.js";
11
11
  /** A visible series with its data already cut to the zoom window. */
@@ -152,9 +152,14 @@ export interface LayoutInput {
152
152
  categoryGroups?: boolean;
153
153
  /** Degrees to tilt the category labels (vertical charts). */
154
154
  labelRotation?: number;
155
+ /** Shows every n-th category label, or the ones the predicate accepts; replaces the automatic thinning. */
156
+ categoryTickEvery?: number | ((index: number, label: string) => boolean);
155
157
  }
158
+ /** Keeps the category ticks picked by `every`: each n-th one (from the first), or those the predicate accepts. */
159
+ export declare function pickCategoryTicks(ticks: readonly AxisTick[], every: number | ((index: number, label: string) => boolean)): AxisTick[];
156
160
  /** Default category label: Spanish short dates, grouped numbers, strings as given. */
157
161
  export declare function defaultXLabel(value: XValue): string;
162
+ export declare function axisDomain(series: readonly ResolvedSeries[], layers: ReadonlyMap<string, StackLayer>, options: ValueAxisOptions, annotationValues: readonly number[]): [number, number];
158
163
  /**
159
164
  * Computes every pixel of a cartesian chart: margins, scales, ticks, paths,
160
165
  * bars, labels and annotations. Pure, so it is memoised by the component and
@@ -9,7 +9,16 @@ import { extent, linearScale } from "../scales/linear.js";
9
9
  import { logScale } from "../scales/log.js";
10
10
  import { shortMonth, timeScale } from "../scales/time.js";
11
11
  import { stackLayers } from "../stack.js";
12
+ import {
13
+ resolveAxisBound
14
+ } from "../types.js";
12
15
  import { resolveAxes, stackAxes } from "./axis-stack.js";
16
+ function pickCategoryTicks(ticks, every) {
17
+ const step = typeof every === "number" ? Math.max(1, Math.floor(every)) : 0;
18
+ return ticks.filter(
19
+ (tick, index) => typeof every === "function" ? every(index, tick.label) : index % step === 0
20
+ );
21
+ }
13
22
  const clamp = (value, lo, hi) => Math.min(hi, Math.max(lo, value));
14
23
  function defaultXLabel(value) {
15
24
  if (value instanceof Date) return `${value.getDate()} ${shortMonth(value)}`;
@@ -63,9 +72,7 @@ function axisDomain(series, layers, options, annotationValues) {
63
72
  lo = Math.min(lo, 0);
64
73
  hi = Math.max(hi, 0);
65
74
  }
66
- if (options.min != null) lo = options.min;
67
- if (options.max != null) hi = options.max;
68
- return [lo, hi];
75
+ return [resolveAxisBound(options.min, lo), resolveAxisBound(options.max, hi)];
69
76
  }
70
77
  function makeValueScale(domain, range, options, tickCount, fixed) {
71
78
  if (options.scale === "log") return logScale({ domain, range });
@@ -250,7 +257,7 @@ function computeLayout(input) {
250
257
  position: positions[index],
251
258
  label
252
259
  }));
253
- categoryTicks = horizontal ? ticks : rotation ? ticks.filter((_, index) => index % Math.max(1, Math.ceil(14 / band.step)) === 0) : thinTicks(ticks, 12);
260
+ categoryTicks = input.categoryTickEvery != null ? pickCategoryTicks(ticks, input.categoryTickEvery) : horizontal ? ticks : rotation ? ticks.filter((_, index) => index % Math.max(1, Math.ceil(14 / band.step)) === 0) : thinTicks(ticks, 12);
254
261
  indexAt = band.indexAt;
255
262
  mode = band.type;
256
263
  }
@@ -545,6 +552,8 @@ function computeLayout(input) {
545
552
  };
546
553
  }
547
554
  export {
555
+ axisDomain,
548
556
  computeLayout,
549
- defaultXLabel
557
+ defaultXLabel,
558
+ pickCategoryTicks
550
559
  };