@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,49 @@
1
+ import type { ComponentPropsWithRef } from "react";
2
+ import { useUiStrings } from "../../i18n/index.js";
3
+ import { cn } from "../../utils/cn.js";
4
+
5
+ export type SpinnerSize = "xs" | "sm" | "md" | "lg";
6
+
7
+ /** Class map behind each named `size`; exported like `buttonSizeClasses`. */
8
+ export const spinnerSizeClasses: Readonly<Record<SpinnerSize, string>> = {
9
+ xs: "size-3",
10
+ sm: "size-4",
11
+ md: "size-5",
12
+ lg: "size-7",
13
+ };
14
+
15
+ export interface SpinnerProps extends Omit<ComponentPropsWithRef<"span">, "children"> {
16
+ /** Named size, or a pixel size for one-offs. Defaults to `sm`. */
17
+ size?: SpinnerSize | number;
18
+ /**
19
+ * Accessible name announced through `role="status"`. Defaults to the localized `loading` UI
20
+ * string. `false` marks the spinner decorative (`aria-hidden`), for use next to its own text.
21
+ */
22
+ label?: string | false;
23
+ }
24
+
25
+ /**
26
+ * Indeterminate activity indicator drawn with the current text color. It spins only when the user
27
+ * has not asked for reduced motion; otherwise it stays a static ring and the label still says
28
+ * that work is in progress.
29
+ */
30
+ export function Spinner({ size = "sm", label, className, style, ...props }: SpinnerProps) {
31
+ const strings = useUiStrings();
32
+ const named = typeof size === "string";
33
+ const a11y =
34
+ label === false
35
+ ? ({ "aria-hidden": true } as const)
36
+ : ({ role: "status", "aria-label": label ?? strings.loading } as const);
37
+ return (
38
+ <span
39
+ {...a11y}
40
+ {...props}
41
+ style={named ? style : { width: size, height: size, ...style }}
42
+ className={cn(
43
+ "inline-block shrink-0 rounded-full border-2 border-current border-t-transparent motion-safe:animate-spin",
44
+ named && spinnerSizeClasses[size],
45
+ className,
46
+ )}
47
+ />
48
+ );
49
+ }
@@ -1,5 +1,6 @@
1
1
  export {
2
2
  StatusDot,
3
+ type StatusDotBuiltinTone,
3
4
  type StatusDotPart,
4
5
  type StatusDotProps,
5
6
  type StatusDotShape,
@@ -1,10 +1,14 @@
1
1
  import type { ComponentPropsWithRef } from "react";
2
2
  import type { ClassNames } from "../../utils/class-names.js";
3
3
  import { cn } from "../../utils/cn.js";
4
+ import { customToneStyle, isCustomTone } from "../../utils/tone.js";
4
5
 
5
- export type StatusDotTone = "danger" | "warning" | "success" | "accent" | "neutral";
6
+ export type StatusDotBuiltinTone = "danger" | "warning" | "success" | "accent" | "neutral";
6
7
 
7
- const toneClasses: Record<StatusDotTone, string> = {
8
+ /** A built-in tone, or the name of a tone declared in `tonePalettes`. */
9
+ export type StatusDotTone = StatusDotBuiltinTone | (string & {});
10
+
11
+ const toneClasses: Record<StatusDotBuiltinTone, string> = {
8
12
  danger: "bg-danger",
9
13
  warning: "bg-warning",
10
14
  success: "bg-success",
@@ -12,6 +16,8 @@ const toneClasses: Record<StatusDotTone, string> = {
12
16
  neutral: "bg-ink-3",
13
17
  };
14
18
 
19
+ const builtinTones = new Set<string>(Object.keys(toneClasses));
20
+
15
21
  export type StatusDotShape = "dot" | "square";
16
22
 
17
23
  const shapeClasses: Record<StatusDotShape, string> = {
@@ -41,11 +47,13 @@ export function StatusDot({
41
47
  hollow,
42
48
  className,
43
49
  classNames,
50
+ style,
44
51
  ...props
45
52
  }: StatusDotProps) {
46
53
  return (
47
54
  <span
48
55
  {...props}
56
+ style={customToneStyle(tone, builtinTones, style)}
49
57
  className={cn("inline-flex max-w-full items-center gap-1.5", classNames?.root, className)}
50
58
  >
51
59
  <span
@@ -53,7 +61,11 @@ export function StatusDot({
53
61
  className={cn(
54
62
  "shrink-0",
55
63
  shapeClasses[shape],
56
- hollow ? "bg-transparent shadow-[inset_0_0_0_2px_var(--accent)]" : toneClasses[tone],
64
+ hollow
65
+ ? "bg-transparent shadow-[inset_0_0_0_2px_var(--accent)]"
66
+ : isCustomTone(tone, builtinTones)
67
+ ? "bg-(--tone-c)"
68
+ : (toneClasses[tone as StatusDotBuiltinTone] ?? toneClasses.neutral),
57
69
  classNames?.dot,
58
70
  )}
59
71
  />
@@ -6,6 +6,7 @@ import { cn } from "../../utils/cn.js";
6
6
  import { composeHandlers, useComposedRefs } from "../../utils/compose.js";
7
7
  import { BubbleInput, useFormBubble, useFormReset } from "../../utils/form-bubble.js";
8
8
  import { useControllableState } from "../../utils/use-controllable-state.js";
9
+ import { touchHitArea } from "../internal/hit-area.js";
9
10
 
10
11
  export type SwitchPart = "root" | "track" | "thumb";
11
12
 
@@ -68,7 +69,8 @@ export function Switch({
68
69
  {...props}
69
70
  ref={composedRef}
70
71
  className={cn(
71
- "group inline-flex size-10 shrink-0 items-center justify-center in-data-[density=touch]:size-11",
72
+ touchHitArea,
73
+ "group inline-flex size-10 shrink-0 items-center justify-center",
72
74
  classNames?.root,
73
75
  className,
74
76
  )}
@@ -0,0 +1,230 @@
1
+ "use client";
2
+
3
+ import { type KeyboardEvent, useEffect, useId, useMemo, useRef, useState } from "react";
4
+ import { useUiStrings } from "../../i18n/index.js";
5
+ import { ChevronLeft, ChevronRight } from "../../icons/index.js";
6
+ import type { ClassNames } from "../../utils/class-names.js";
7
+ import { cn } from "../../utils/cn.js";
8
+ import {
9
+ addDays,
10
+ addMonths,
11
+ clampDate,
12
+ formatFullDate,
13
+ formatMonthTitle,
14
+ isIsoDate,
15
+ monthWeeks,
16
+ startOfWeek,
17
+ todayIso,
18
+ type WeekStart,
19
+ weekdayNames,
20
+ weekStartFor,
21
+ } from "../internal/date-utils.js";
22
+
23
+ export type DateCalendarPart = "root" | "header" | "title" | "nav" | "grid" | "weekday" | "day";
24
+
25
+ export interface DateCalendarProps {
26
+ /** Selected date, "YYYY-MM-DD". */
27
+ value?: string;
28
+ /** Called with the "YYYY-MM-DD" date the person picks. */
29
+ onSelect: (date: string) => void;
30
+ /** Earliest selectable date, "YYYY-MM-DD". */
31
+ min?: string;
32
+ /** Latest selectable date, "YYYY-MM-DD". */
33
+ max?: string;
34
+ /** Extra dates that cannot be picked (holidays, taken days). */
35
+ isDateDisabled?: (date: string) => boolean;
36
+ /** BCP 47 locale for labels. Defaults to the `locale` UI string. */
37
+ locale?: string;
38
+ /** First day of the week, 0 (Sunday) to 6. Defaults from the locale: Monday for es-PE. */
39
+ weekStartsOn?: WeekStart;
40
+ /** "YYYY-MM-DD" treated as today. Defaults to the viewer's local date. */
41
+ today?: string;
42
+ /** Moves focus into the grid on mount (when it opens inside a popover). */
43
+ autoFocus?: boolean;
44
+ className?: string;
45
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
46
+ classNames?: ClassNames<DateCalendarPart>;
47
+ }
48
+
49
+ const KEY_STEPS: Record<string, number> = {
50
+ ArrowLeft: -1,
51
+ ArrowRight: 1,
52
+ ArrowUp: -7,
53
+ ArrowDown: 7,
54
+ };
55
+
56
+ const NAV =
57
+ "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";
58
+
59
+ /**
60
+ * Month grid for picking one date (WAI-ARIA date picker grid). Dates are "YYYY-MM-DD" strings
61
+ * handled in UTC, so a day never shifts with the time zone. Arrows move by day and week,
62
+ * Home/End to the week edges, PageUp/PageDown by month (Shift: year); Enter or Space picks.
63
+ */
64
+ export function DateCalendar({
65
+ value,
66
+ onSelect,
67
+ min,
68
+ max,
69
+ isDateDisabled,
70
+ locale: localeProp,
71
+ weekStartsOn: weekStartProp,
72
+ today: todayProp,
73
+ autoFocus = false,
74
+ className,
75
+ classNames,
76
+ }: DateCalendarProps) {
77
+ const strings = useUiStrings();
78
+ const locale = localeProp || strings.locale;
79
+ const weekStartsOn = weekStartProp ?? weekStartFor(locale);
80
+ const titleId = useId();
81
+ const gridRef = useRef<HTMLTableElement | null>(null);
82
+ const moveFocus = useRef(autoFocus);
83
+ const [today] = useState(() => todayProp ?? todayIso());
84
+ const [focused, setFocused] = useState(() =>
85
+ clampDate(value && isIsoDate(value) ? value : today, min, max),
86
+ );
87
+
88
+ const weeks = useMemo(() => monthWeeks(focused, weekStartsOn), [focused, weekStartsOn]);
89
+ const names = useMemo(() => weekdayNames(locale, weekStartsOn), [locale, weekStartsOn]);
90
+ const month = focused.slice(0, 7);
91
+ const disabled = (date: string) =>
92
+ Boolean((min && date < min) || (max && date > max) || isDateDisabled?.(date));
93
+
94
+ useEffect(() => {
95
+ if (!moveFocus.current) return;
96
+ gridRef.current?.querySelector<HTMLElement>(`[data-date="${focused}"]`)?.focus();
97
+ }, [focused]);
98
+
99
+ const goTo = (date: string, focusDay: boolean) => {
100
+ moveFocus.current = focusDay;
101
+ setFocused(clampDate(date, min, max));
102
+ };
103
+
104
+ const onKeyDown = (event: KeyboardEvent<HTMLTableElement>) => {
105
+ if (event.altKey || event.ctrlKey || event.metaKey) return;
106
+ const step = KEY_STEPS[event.key];
107
+ let next: string | undefined;
108
+ if (step !== undefined) next = addDays(focused, step);
109
+ else if (event.key === "Home") next = startOfWeek(focused, weekStartsOn);
110
+ else if (event.key === "End") next = addDays(startOfWeek(focused, weekStartsOn), 6);
111
+ else if (event.key === "PageUp" || event.key === "PageDown") {
112
+ next = addMonths(focused, (event.key === "PageUp" ? -1 : 1) * (event.shiftKey ? 12 : 1));
113
+ }
114
+ if (next === undefined) return;
115
+ event.preventDefault();
116
+ goTo(next, true);
117
+ };
118
+
119
+ const monthStart = `${month}-01`;
120
+ const prevDisabled = Boolean(min && addDays(monthStart, -1) < min);
121
+ const nextDisabled = Boolean(max && addMonths(monthStart, 1) > max);
122
+
123
+ return (
124
+ <div className={cn("flex w-fit flex-col gap-2", classNames?.root, className)}>
125
+ <div className={cn("flex items-center justify-between gap-2", classNames?.header)}>
126
+ <button
127
+ type="button"
128
+ aria-label={strings.previousMonth}
129
+ disabled={prevDisabled}
130
+ onClick={() => goTo(addMonths(focused, -1), false)}
131
+ className={cn(NAV, classNames?.nav)}
132
+ >
133
+ <ChevronLeft aria-hidden="true" className="size-4" />
134
+ </button>
135
+ <div
136
+ id={titleId}
137
+ aria-live="polite"
138
+ className={cn("font-semibold text-body text-ink", classNames?.title)}
139
+ >
140
+ {formatMonthTitle(focused, locale)}
141
+ </div>
142
+ <button
143
+ type="button"
144
+ aria-label={strings.nextMonth}
145
+ disabled={nextDisabled}
146
+ onClick={() => goTo(addMonths(focused, 1), false)}
147
+ className={cn(NAV, classNames?.nav)}
148
+ >
149
+ <ChevronRight aria-hidden="true" className="size-4" />
150
+ </button>
151
+ </div>
152
+ <table
153
+ ref={gridRef}
154
+ // biome-ignore lint/a11y/noNoninteractiveElementToInteractiveRole: APG date picker grid on a table.
155
+ role="grid"
156
+ aria-labelledby={titleId}
157
+ onKeyDown={onKeyDown}
158
+ className={cn("border-collapse", classNames?.grid)}
159
+ >
160
+ <thead>
161
+ <tr>
162
+ {names.map((name) => (
163
+ <th
164
+ key={name.long}
165
+ scope="col"
166
+ aria-label={name.long}
167
+ className={cn(
168
+ "size-9 p-0 text-center font-semibold text-ink-3 text-meta uppercase",
169
+ classNames?.weekday,
170
+ )}
171
+ >
172
+ {name.narrow}
173
+ </th>
174
+ ))}
175
+ </tr>
176
+ </thead>
177
+ <tbody>
178
+ {weeks.map((week) => (
179
+ <tr key={week[0]}>
180
+ {week.map((date) => {
181
+ const selected = date === value;
182
+ const isDisabled = disabled(date);
183
+ const outside = !date.startsWith(month);
184
+ return (
185
+ // biome-ignore lint/a11y/useFocusableInteractive: the button inside the cell takes focus.
186
+ <td
187
+ key={date}
188
+ // biome-ignore lint/a11y/noNoninteractiveElementToInteractiveRole: APG date picker gridcell.
189
+ role="gridcell"
190
+ aria-selected={selected}
191
+ className="p-0"
192
+ >
193
+ <button
194
+ type="button"
195
+ data-date={date}
196
+ tabIndex={date === focused ? 0 : -1}
197
+ aria-label={formatFullDate(date, locale)}
198
+ aria-current={date === today ? "date" : undefined}
199
+ aria-disabled={isDisabled || undefined}
200
+ data-selected={selected ? "" : undefined}
201
+ data-outside={outside ? "" : undefined}
202
+ onFocus={() => {
203
+ moveFocus.current = true;
204
+ setFocused(date);
205
+ }}
206
+ onClick={() => {
207
+ if (!isDisabled) onSelect(date);
208
+ }}
209
+ className={cn(
210
+ "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",
211
+ outside ? "text-ink-3" : "text-ink",
212
+ date === today && !selected && "font-bold text-accent-ink",
213
+ !isDisabled && !selected && "hover:bg-surface-2",
214
+ selected && "bg-accent font-bold text-on-accent",
215
+ isDisabled && "cursor-not-allowed text-ink-3 line-through opacity-50",
216
+ classNames?.day,
217
+ )}
218
+ >
219
+ {Number(date.slice(8))}
220
+ </button>
221
+ </td>
222
+ );
223
+ })}
224
+ </tr>
225
+ ))}
226
+ </tbody>
227
+ </table>
228
+ </div>
229
+ );
230
+ }
@@ -0,0 +1,5 @@
1
+ export {
2
+ DateCalendar,
3
+ type DateCalendarPart,
4
+ type DateCalendarProps,
5
+ } from "./date-calendar.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";
@@ -76,3 +76,118 @@ export function formatHour(hour: number, locale?: string): string {
76
76
  timeZone: "UTC",
77
77
  }).format(new Date(Date.UTC(1970, 0, 1, hour)));
78
78
  }
79
+
80
+ const ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
81
+
82
+ /** True for a real calendar date written "YYYY-MM-DD" (rejects "2026-02-30"). */
83
+ export function isIsoDate(value: string): boolean {
84
+ const match = ISO_DATE.exec(value);
85
+ if (!match) return false;
86
+ const [year, month, day] = [Number(match[1]), Number(match[2]), Number(match[3])];
87
+ const date = new Date(Date.UTC(year, month - 1, day));
88
+ return (
89
+ date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day
90
+ );
91
+ }
92
+
93
+ /** Builds "YYYY-MM-DD" from numeric parts; no time zone is involved. */
94
+ export function toIsoDate(year: number, month: number, day: number): string {
95
+ return `${String(year).padStart(4, "0")}-${String(month).padStart(2, "0")}-${String(day).padStart(2, "0")}`;
96
+ }
97
+
98
+ /** Same day of the month `amount` months away, or the last day when the month is shorter. */
99
+ export function addMonths(value: string, amount: number): string {
100
+ const date = parseDate(value);
101
+ const target = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth() + amount, 1));
102
+ const last = new Date(
103
+ Date.UTC(target.getUTCFullYear(), target.getUTCMonth() + 1, 0),
104
+ ).getUTCDate();
105
+ return toIsoDate(
106
+ target.getUTCFullYear(),
107
+ target.getUTCMonth() + 1,
108
+ Math.min(date.getUTCDate(), last),
109
+ );
110
+ }
111
+
112
+ /** The viewer's calendar date today, read from local fields (never from the UTC date). */
113
+ export function todayIso(now: Date = new Date()): string {
114
+ return toIsoDate(now.getFullYear(), now.getMonth() + 1, now.getDate());
115
+ }
116
+
117
+ /** `value` pulled inside `[min, max]`. ISO dates compare correctly as strings. */
118
+ export function clampDate(value: string, min?: string, max?: string): string {
119
+ if (min && value < min) return min;
120
+ if (max && value > max) return max;
121
+ return value;
122
+ }
123
+
124
+ /** Regions whose calendars conventionally start the week on Sunday. */
125
+ const SUNDAY_REGIONS = new Set([
126
+ "US",
127
+ "CA",
128
+ "MX",
129
+ "BR",
130
+ "JP",
131
+ "KR",
132
+ "IL",
133
+ "IN",
134
+ "PH",
135
+ "TW",
136
+ "HK",
137
+ "ZA",
138
+ "CO",
139
+ "VE",
140
+ "SA",
141
+ ]);
142
+
143
+ /**
144
+ * First day of the week for a BCP 47 locale: Sunday (0) where that is the convention of the
145
+ * region (en-US, es-MX, pt-BR, ...), Monday (1) everywhere else, including es-PE and en-GB.
146
+ */
147
+ export function weekStartFor(locale: string): WeekStart {
148
+ const region = /[-_]([A-Za-z]{2})(?:[-_]|$)/.exec(locale)?.[1]?.toUpperCase();
149
+ if (region) return SUNDAY_REGIONS.has(region) ? 0 : 1;
150
+ return locale.toLowerCase().startsWith("en") || locale.toLowerCase().startsWith("ja") ? 0 : 1;
151
+ }
152
+
153
+ /** "September 2026" with only the first letter capitalised ("Setiembre de 2026"). */
154
+ export function formatMonthTitle(value: string, locale?: string): string {
155
+ const raw = format(value, locale, { month: "long", year: "numeric" });
156
+ return raw.charAt(0).toLocaleUpperCase(locale) + raw.slice(1);
157
+ }
158
+
159
+ /** Full date for a screen reader, e.g. "Monday, September 7, 2026". */
160
+ export function formatFullDate(value: string, locale?: string): string {
161
+ return format(value, locale, { dateStyle: "full" });
162
+ }
163
+
164
+ /** Weekday names in column order starting at `weekStartsOn`. */
165
+ export function weekdayNames(
166
+ locale: string | undefined,
167
+ weekStartsOn: WeekStart,
168
+ ): { narrow: string; long: string }[] {
169
+ // 2024-01-07 was a Sunday.
170
+ return Array.from({ length: 7 }, (_, index) => {
171
+ const day = addDays("2024-01-07", weekStartsOn + index);
172
+ return {
173
+ narrow: format(day, locale, { weekday: "narrow" }),
174
+ long: format(day, locale, { weekday: "long" }),
175
+ };
176
+ });
177
+ }
178
+
179
+ /** Six full weeks of "YYYY-MM-DD" covering the month of `value`, so the grid keeps its height. */
180
+ export function monthWeeks(value: string, weekStartsOn: WeekStart): string[][] {
181
+ const date = parseDate(value);
182
+ let cursor = startOfWeek(
183
+ formatDate(new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), 1))),
184
+ weekStartsOn,
185
+ );
186
+ return Array.from({ length: 6 }, () =>
187
+ Array.from({ length: 7 }, () => {
188
+ const day = cursor;
189
+ cursor = addDays(cursor, 1);
190
+ return day;
191
+ }),
192
+ );
193
+ }
@@ -158,6 +158,23 @@ Every chart must keep these, so all families behave the same:
158
158
  - Entry animation through `useEntryAnimation` (line reveal by a clip rect, bars grow from their baseline with a short
159
159
  stagger, labels fade). Nothing animates with `prefers-reduced-motion` or `animate={false}`.
160
160
  - `loading` shows `ChartSkeleton`; no finite data shows `ChartEmpty`.
161
+ - Touch: `ChartFrame` owns it, so a chart gets it by rendering inside the frame (`useTouchSelection`). Touch
162
+ `pointerover`/`pointerout` never reach the marks, so a lifted finger is not "leaving". A tap (up within 10px of the
163
+ press) replays a hover on the mark under the finger, or the nearest mark within 44px: marks flagged
164
+ `data-chart-hit` or `data-category` are snap targets. Tapping the pinned mark again (its details read the same),
165
+ tapping outside, tapping empty space or Escape unpins; a swipe never selects. Slider overlays must select from
166
+ keyboard focus only (`:focus-visible`), not from the focus a tap gives them.
167
+ - Details: `ChartTooltip` floats beside the pointer, and docks into the frame's panel under the plot based on the
168
+ device, not the container: when the primary pointer is coarse (`pointer: coarse`) or the viewport is 480px wide or
169
+ less (`dock="auto" | "always" | "never"`, also on `ChartFrame`; `useDockDevice` and `resolveDocked` are exported). A
170
+ narrow card on a desktop with a mouse keeps the floating card. The panel reserves 160px (so nothing below it jumps)
171
+ only while docking applies: the reservation is CSS (`display:none` unless a coarse pointer or a narrow viewport
172
+ matches), so it also holds on the server render. Its rows are at least 44px tall. The panel is hidden from assistive
173
+ tech; a separate polite live region announces the pinned or keyboard-selected category (debounced 150ms, skipped
174
+ for mouse hover). A floating card only changes sides past a dead zone (65% / 55% of the width) and never animates
175
+ the swap.
176
+ - Leaving a mark: clear through `useLeaveGrace` (60ms) so the gutter between two marks never shows an empty frame, and
177
+ keep a category over the gaps between its units.
161
178
 
162
179
  ## Hierarchy and matrix charts
163
180
 
@@ -339,6 +356,10 @@ Every chart adapts to its exact parent, width and height, from the container and
339
356
  <BarChart series={[{ id: "a", name: "A", data, pattern: "stripes" }]} />
340
357
  <BarChart distributed /> // or series[].colors = ["var(--chart-up)", undefined, ...]
341
358
  <BarChart categoryLabelRotation={-45} />
359
+ <BarChart categoryTickEvery={(i, label) => i % 5 === 0 || i === last} yAxis={{ max: (m) => Math.ceil(m / 400) * 400 }} />
360
+ <LineChart markers={[3, 5]} tooltipRows={({ index, rows }) => ({ rows: [...rows, extraRow], footer: "Nota" })} />
361
+ <HeatmapChart cellDetail={(row, column, value) => [{ id: "n", name: "Pagos", value: "12", color: "transparent" }]} />
362
+ <DonutChart sliceLabels="percent" />
342
363
  <DrilldownBarChart data={tree} breadcrumbLabel="Ruta" /> // HierarchyDatum; click a bar with a `›`
343
364
  <BarRaceChart entities={[{ id, name }]} frames={[{ label: "Sem 1", values: [..] }]} topN={6} />
344
365
  <WaterfallChart orientation="horizontal" />
@@ -139,6 +139,7 @@ export function BarRaceChart({
139
139
 
140
140
  return (
141
141
  <ChartFrame
142
+ dock="never"
142
143
  height={height}
143
144
  aspectRatio={aspectRatio}
144
145
  labels={labels}
@@ -445,7 +445,7 @@ function BeeswarmPlot({
445
445
  count={points.length}
446
446
  active={active}
447
447
  onActiveChange={setActive}
448
- pick={(x, y) => nearestPoint(points, x, y, 14)}
448
+ pick={(x, y, radius) => nearestPoint(points, x, y, radius ?? 14)}
449
449
  label={labels.explore}
450
450
  valueText={valueText}
451
451
  margin={margin}
@@ -8,6 +8,7 @@ import { type Chord, chordLayout, chordsOf, ribbonPath } from "../core/chord.js"
8
8
  import { ChartDataTable } from "../core/data-table.js";
9
9
  import { DEFAULT_EXPORT_TEXTS, ExportMenu, type ExportTexts } from "../core/export-menu.js";
10
10
  import { resolveFormat, type ValueFormat, type ValueFormatter } 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";
@@ -250,6 +251,11 @@ function ChordPlot({
250
251
  );
251
252
  const nav = useIndexNavigation(order.length, { wrap: true });
252
253
  const [hover, setHover] = useState<{ focus: Focus; x: number; y: number } | null>(null);
254
+ const { leave: leaveSoon, hold } = useLeaveGrace(() => setHover(null));
255
+ const showHover = (next: { focus: Focus; x: number; y: number }) => {
256
+ hold();
257
+ setHover(next);
258
+ };
253
259
 
254
260
  const rim = showLabels && width >= 420;
255
261
  const labelRoom = rim
@@ -416,9 +422,9 @@ function ChordPlot({
416
422
  colors={colors}
417
423
  lit={lit}
418
424
  onEnter={(chord, event) =>
419
- setHover({ focus: { kind: "chord", key: chordKey(chord) }, ...point(event) })
425
+ showHover({ focus: { kind: "chord", key: chordKey(chord) }, ...point(event) })
420
426
  }
421
- onLeave={() => setHover(null)}
427
+ onLeave={leaveSoon}
422
428
  />
423
429
  {layout.groups.map((group) => {
424
430
  const dim = litGroups ? !litGroups.has(group.index) : false;
@@ -436,6 +442,7 @@ function ChordPlot({
436
442
  endAngle: group.endAngle,
437
443
  cornerRadius: 3,
438
444
  })}
445
+ data-chart-hit=""
439
446
  className={onGroupClick ? "cursor-pointer" : "cursor-default"}
440
447
  style={{
441
448
  fill: colors[group.index],
@@ -445,12 +452,12 @@ function ChordPlot({
445
452
  transformOrigin: "center",
446
453
  }}
447
454
  onPointerEnter={(event) =>
448
- setHover({ focus: { kind: "group", index: group.index }, ...point(event) })
455
+ showHover({ focus: { kind: "group", index: group.index }, ...point(event) })
449
456
  }
450
457
  onPointerMove={(event) =>
451
- setHover({ focus: { kind: "group", index: group.index }, ...point(event) })
458
+ showHover({ focus: { kind: "group", index: group.index }, ...point(event) })
452
459
  }
453
- onPointerLeave={() => setHover(null)}
460
+ onPointerLeave={leaveSoon}
454
461
  onClick={() => {
455
462
  const input = groups[group.index];
456
463
  if (input) onGroupClick?.(input, group.index);
@@ -531,6 +538,7 @@ const ChordRibbons = memo(function ChordRibbons({
531
538
  <path
532
539
  key={chordKey(chord)}
533
540
  data-ribbon=""
541
+ data-chart-hit=""
534
542
  d={ribbonPath(chord, radius)}
535
543
  className="motion-safe:transition-[fill-opacity] motion-safe:duration-150"
536
544
  style={{