@jcsoftdev/ui 0.2.3 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (375) hide show
  1. package/CHANGELOG.md +288 -7
  2. package/README.md +2 -1
  3. package/bin/ui-theme.mjs +1151 -25
  4. package/dist/ai/attachment/attachment.js +1 -1
  5. package/dist/ai/chat-list/group.js +3 -1
  6. package/dist/ai/conversation/conversation.js +1 -1
  7. package/dist/ai/internal/use-copy.d.ts +1 -5
  8. package/dist/ai/internal/use-copy.js +1 -32
  9. package/dist/ai/markdown/parse.js +59 -17
  10. package/dist/ai/source/source.js +1 -1
  11. package/dist/atoms/avatar/avatar.d.ts +13 -3
  12. package/dist/atoms/avatar/avatar.js +40 -2
  13. package/dist/atoms/avatar/index.d.ts +1 -1
  14. package/dist/atoms/avatar/index.js +3 -1
  15. package/dist/atoms/button/button.d.ts +4 -1
  16. package/dist/atoms/button/button.js +4 -2
  17. package/dist/atoms/checkbox/checkbox.d.ts +8 -3
  18. package/dist/atoms/checkbox/checkbox.js +23 -2
  19. package/dist/atoms/chip/chip.d.ts +9 -3
  20. package/dist/atoms/chip/chip.js +26 -4
  21. package/dist/atoms/chip/index.d.ts +1 -1
  22. package/dist/atoms/chip/index.js +4 -1
  23. package/dist/atoms/status-dot/index.d.ts +1 -1
  24. package/dist/atoms/status-dot/status-dot.d.ts +4 -2
  25. package/dist/atoms/status-dot/status-dot.js +5 -1
  26. package/dist/charts/bar-chart/bar-race-chart.js +1 -0
  27. package/dist/charts/beeswarm-chart/beeswarm-chart.js +1 -1
  28. package/dist/charts/chord-chart/chord-chart.js +13 -5
  29. package/dist/charts/core/cartesian/cartesian-chart.d.ts +1 -1
  30. package/dist/charts/core/cartesian/cartesian-chart.js +48 -11
  31. package/dist/charts/core/cartesian/layout.d.ts +6 -1
  32. package/dist/charts/core/cartesian/layout.js +14 -5
  33. package/dist/charts/core/cartesian/marks.d.ts +2 -2
  34. package/dist/charts/core/cartesian/marks.js +1 -1
  35. package/dist/charts/core/cartesian/types.d.ts +28 -2
  36. package/dist/charts/core/category-explorer.d.ts +2 -2
  37. package/dist/charts/core/category-explorer.js +8 -4
  38. package/dist/charts/core/chart-dock.d.ts +26 -0
  39. package/dist/charts/core/chart-dock.js +45 -0
  40. package/dist/charts/core/chart-frame.d.ts +9 -2
  41. package/dist/charts/core/chart-frame.js +105 -25
  42. package/dist/charts/core/distribution/explorer.d.ts +5 -2
  43. package/dist/charts/core/distribution/explorer.js +12 -5
  44. package/dist/charts/core/distribution/xy-points.js +1 -1
  45. package/dist/charts/core/index.d.ts +3 -0
  46. package/dist/charts/core/index.js +3 -0
  47. package/dist/charts/core/leave-grace.d.ts +11 -0
  48. package/dist/charts/core/leave-grace.js +26 -0
  49. package/dist/charts/core/nearest.d.ts +14 -0
  50. package/dist/charts/core/nearest.js +22 -0
  51. package/dist/charts/core/plot-overlay.js +9 -3
  52. package/dist/charts/core/pointer.test-utils.d.ts +38 -0
  53. package/dist/charts/core/pointer.test-utils.js +123 -0
  54. package/dist/charts/core/tooltip.d.ts +25 -2
  55. package/dist/charts/core/tooltip.js +115 -40
  56. package/dist/charts/core/touch-select.d.ts +20 -0
  57. package/dist/charts/core/touch-select.js +184 -0
  58. package/dist/charts/core/types.d.ts +8 -4
  59. package/dist/charts/core/types.js +5 -0
  60. package/dist/charts/core/use-index-navigation.d.ts +17 -6
  61. package/dist/charts/core/use-index-navigation.js +47 -10
  62. package/dist/charts/donut-chart/donut-chart.d.ts +5 -1
  63. package/dist/charts/donut-chart/donut-chart.js +40 -1
  64. package/dist/charts/donut-chart/slice-labels.d.ts +20 -0
  65. package/dist/charts/donut-chart/slice-labels.js +20 -0
  66. package/dist/charts/dumbbell-chart/dumbbell-chart.js +6 -3
  67. package/dist/charts/fill-gauge-chart/fill-gauge-chart.js +1 -0
  68. package/dist/charts/funnel-chart/funnel-chart.js +2 -1
  69. package/dist/charts/gauge-chart/gauge-chart.js +2 -1
  70. package/dist/charts/heatmap-chart/heatmap-chart.d.ts +4 -1
  71. package/dist/charts/heatmap-chart/heatmap-chart.js +3 -1
  72. package/dist/charts/heatmap-chart/heatmap-grid.d.ts +4 -1
  73. package/dist/charts/heatmap-chart/heatmap-grid.js +3 -1
  74. package/dist/charts/hex-tile-map/hex-tile-map.js +124 -115
  75. package/dist/charts/hierarchy-morph/hierarchy-morph.js +2 -1
  76. package/dist/charts/icicle-chart/icicle-chart.js +7 -9
  77. package/dist/charts/lollipop-chart/lollipop-chart.js +6 -3
  78. package/dist/charts/maps/geo/map-viewport.js +1 -1
  79. package/dist/charts/polar-area-chart/polar-area-chart.js +42 -12
  80. package/dist/charts/progress-units/progress-units.js +1 -0
  81. package/dist/charts/radar-chart/radar-chart.js +1 -1
  82. package/dist/charts/radial-bar-chart/radial-bar-chart.js +2 -1
  83. package/dist/charts/range-area-chart/range-area-chart.js +3 -2
  84. package/dist/charts/sankey-chart/sankey-chart.js +12 -4
  85. package/dist/charts/tree-chart/tree-chart.js +1 -0
  86. package/dist/charts/treemap-chart/treemap-chart.js +2 -7
  87. package/dist/charts/waterfall-chart/waterfall-chart.js +6 -3
  88. package/dist/containers/action-bar/action-bar.d.ts +11 -2
  89. package/dist/containers/action-bar/action-bar.js +4 -1
  90. package/dist/containers/card/card.d.ts +21 -3
  91. package/dist/containers/card/card.js +20 -5
  92. package/dist/containers/grid/grid.d.ts +15 -0
  93. package/dist/containers/grid/grid.js +24 -0
  94. package/dist/containers/grid/index.d.ts +1 -0
  95. package/dist/containers/grid/index.js +4 -0
  96. package/dist/containers/index.d.ts +3 -0
  97. package/dist/containers/index.js +3 -0
  98. package/dist/containers/kpi/kpi.d.ts +13 -2
  99. package/dist/containers/kpi/kpi.js +86 -24
  100. package/dist/containers/kpi-group/index.d.ts +1 -1
  101. package/dist/containers/kpi-group/index.js +3 -1
  102. package/dist/containers/kpi-group/kpi-group.d.ts +9 -1
  103. package/dist/containers/kpi-group/kpi-group.js +11 -1
  104. package/dist/containers/page/index.d.ts +1 -0
  105. package/dist/containers/page/index.js +4 -0
  106. package/dist/containers/page/page.d.ts +7 -0
  107. package/dist/containers/page/page.js +14 -0
  108. package/dist/containers/page-header/page-header.d.ts +8 -3
  109. package/dist/containers/page-header/page-header.js +35 -8
  110. package/dist/containers/responsive-list/responsive-list.d.ts +1 -1
  111. package/dist/containers/responsive-list/responsive-list.js +6 -3
  112. package/dist/containers/stack/index.d.ts +1 -0
  113. package/dist/containers/stack/index.js +6 -0
  114. package/dist/containers/stack/stack.d.ts +15 -0
  115. package/dist/containers/stack/stack.js +43 -0
  116. package/dist/forms/copy-field/copy-field.d.ts +17 -0
  117. package/dist/forms/copy-field/copy-field.js +72 -0
  118. package/dist/forms/copy-field/index.d.ts +1 -0
  119. package/dist/forms/copy-field/index.js +4 -0
  120. package/dist/forms/emoji-picker/emoji-picker.js +1 -1
  121. package/dist/forms/form/form.d.ts +15 -0
  122. package/dist/forms/form/form.js +29 -0
  123. package/dist/forms/form/index.d.ts +1 -0
  124. package/dist/forms/form/index.js +10 -0
  125. package/dist/forms/index.d.ts +2 -0
  126. package/dist/forms/index.js +2 -0
  127. package/dist/forms/input/index.d.ts +1 -1
  128. package/dist/forms/input/index.js +3 -2
  129. package/dist/forms/input/input.d.ts +6 -2
  130. package/dist/forms/input/input.js +9 -3
  131. package/dist/glass/crystal-map.d.ts +70 -0
  132. package/dist/glass/crystal-map.js +88 -0
  133. package/dist/glass/displacement-map.d.ts +117 -0
  134. package/dist/glass/displacement-map.js +201 -0
  135. package/dist/glass/index.d.ts +8 -0
  136. package/dist/glass/index.js +63 -0
  137. package/dist/glass/lens-crystal.d.ts +29 -0
  138. package/dist/glass/lens-crystal.js +161 -0
  139. package/dist/glass/lens-dispersion.d.ts +11 -0
  140. package/dist/glass/lens-dispersion.js +19 -0
  141. package/dist/glass/liquid-glass.d.ts +41 -0
  142. package/dist/glass/liquid-glass.js +256 -0
  143. package/dist/glass/liquid-motion.d.ts +53 -0
  144. package/dist/glass/liquid-motion.js +302 -0
  145. package/dist/glass/liquid-options.d.ts +162 -0
  146. package/dist/glass/liquid-options.js +179 -0
  147. package/dist/glass/refraction.d.ts +100 -0
  148. package/dist/glass/refraction.js +714 -0
  149. package/dist/glass/specular-map.d.ts +26 -0
  150. package/dist/glass/specular-map.js +75 -0
  151. package/dist/glass/spring.d.ts +79 -0
  152. package/dist/glass/spring.js +58 -0
  153. package/dist/glass/support.d.ts +13 -0
  154. package/dist/glass/support.js +14 -0
  155. package/dist/glass/use-glass-refraction.d.ts +8 -0
  156. package/dist/glass/use-glass-refraction.js +16 -0
  157. package/dist/i18n/strings.d.ts +24 -0
  158. package/dist/i18n/strings.js +18 -2
  159. package/dist/icons/index.d.ts +2 -0
  160. package/dist/icons/index.js +4 -0
  161. package/dist/icons/key.d.ts +2 -0
  162. package/dist/icons/key.js +12 -0
  163. package/dist/icons/webhook.d.ts +2 -0
  164. package/dist/icons/webhook.js +12 -0
  165. package/dist/liquid/index.d.ts +3 -0
  166. package/dist/liquid/index.js +29 -0
  167. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +29 -0
  168. package/dist/navigation/breadcrumbs/breadcrumbs.js +70 -0
  169. package/dist/navigation/breadcrumbs/index.d.ts +1 -0
  170. package/dist/navigation/breadcrumbs/index.js +6 -0
  171. package/dist/navigation/index.d.ts +1 -0
  172. package/dist/navigation/index.js +1 -0
  173. package/dist/navigation/segmented/index.d.ts +1 -1
  174. package/dist/navigation/segmented/model.d.ts +5 -0
  175. package/dist/navigation/segmented/model.js +6 -0
  176. package/dist/navigation/segmented/segmented.d.ts +17 -3
  177. package/dist/navigation/segmented/segmented.js +20 -4
  178. package/dist/overlays/context-menu/context-menu.d.ts +9 -1
  179. package/dist/overlays/context-menu/context-menu.js +4 -1
  180. package/dist/overlays/dialog/dialog.d.ts +9 -1
  181. package/dist/overlays/dialog/dialog.js +3 -0
  182. package/dist/overlays/drawer/drawer.d.ts +9 -1
  183. package/dist/overlays/drawer/drawer.js +3 -0
  184. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +9 -1
  185. package/dist/overlays/dropdown-menu/dropdown-menu.js +3 -1
  186. package/dist/overlays/hover-card/hover-card.d.ts +10 -1
  187. package/dist/overlays/hover-card/hover-card.js +4 -1
  188. package/dist/overlays/popover/popover.d.ts +9 -1
  189. package/dist/overlays/popover/popover.js +3 -0
  190. package/dist/palette/command-palette/command-palette.d.ts +12 -2
  191. package/dist/palette/command-palette/command-palette.js +5 -0
  192. package/dist/primitives/command/command.d.ts +3 -2
  193. package/dist/primitives/command/command.js +2 -0
  194. package/dist/primitives/menu/menu.js +1 -1
  195. package/dist/primitives/popper/popper.js +5 -0
  196. package/dist/rich-text/rich-text-editor.js +94 -8
  197. package/dist/rich-text/sanitize.js +70 -20
  198. package/dist/shell/app-shell/app-shell.d.ts +17 -0
  199. package/dist/shell/app-shell/app-shell.js +44 -4
  200. package/dist/shell/bottom-nav/bottom-nav.d.ts +34 -0
  201. package/dist/shell/bottom-nav/bottom-nav.js +124 -0
  202. package/dist/shell/bottom-nav/index.d.ts +2 -0
  203. package/dist/shell/bottom-nav/index.js +9 -0
  204. package/dist/shell/bottom-nav/split.d.ts +11 -0
  205. package/dist/shell/bottom-nav/split.js +10 -0
  206. package/dist/shell/sidebar/sidebar.d.ts +16 -2
  207. package/dist/shell/sidebar/sidebar.js +46 -4
  208. package/dist/shell/topbar/topbar.d.ts +20 -9
  209. package/dist/shell/topbar/topbar.js +16 -9
  210. package/dist/states/empty-state/empty-state.d.ts +3 -1
  211. package/dist/states/empty-state/empty-state.js +9 -1
  212. package/dist/states/error-state/error-state.d.ts +3 -1
  213. package/dist/states/error-state/error-state.js +2 -0
  214. package/dist/states/index.d.ts +1 -0
  215. package/dist/states/index.js +1 -0
  216. package/dist/states/live-status-bar/index.d.ts +1 -0
  217. package/dist/states/live-status-bar/index.js +6 -0
  218. package/dist/states/live-status-bar/live-status-bar.d.ts +17 -0
  219. package/dist/states/live-status-bar/live-status-bar.js +49 -0
  220. package/dist/states/offline-banner/offline-banner.d.ts +3 -1
  221. package/dist/states/offline-banner/offline-banner.js +8 -4
  222. package/dist/utils/class-groups.js +17 -0
  223. package/dist/utils/index.d.ts +1 -0
  224. package/dist/utils/index.js +2 -0
  225. package/dist/utils/material.d.ts +13 -0
  226. package/dist/utils/material.js +6 -0
  227. package/dist/utils/tone.d.ts +8 -0
  228. package/dist/utils/tone.js +17 -0
  229. package/dist/utils/use-copy.d.ts +5 -0
  230. package/dist/utils/use-copy.js +35 -0
  231. package/icons/svg/key.svg +5 -0
  232. package/icons/svg/webhook.svg +5 -0
  233. package/package.json +31 -21
  234. package/scripts/build-theme.d.mts +22 -0
  235. package/scripts/build-theme.mjs +236 -4
  236. package/src/ai/attachment/attachment.tsx +1 -1
  237. package/src/ai/chat-list/group.ts +3 -1
  238. package/src/ai/conversation/conversation.tsx +1 -1
  239. package/src/ai/internal/use-copy.ts +1 -38
  240. package/src/ai/markdown/parse.ts +74 -17
  241. package/src/ai/source/source.tsx +1 -1
  242. package/src/atoms/avatar/avatar.tsx +57 -4
  243. package/src/atoms/avatar/index.ts +8 -1
  244. package/src/atoms/button/button.tsx +8 -3
  245. package/src/atoms/checkbox/checkbox.tsx +30 -3
  246. package/src/atoms/chip/chip.tsx +37 -5
  247. package/src/atoms/chip/index.ts +7 -1
  248. package/src/atoms/status-dot/index.ts +1 -0
  249. package/src/atoms/status-dot/status-dot.tsx +15 -3
  250. package/src/charts/README.md +21 -0
  251. package/src/charts/bar-chart/bar-race-chart.tsx +1 -0
  252. package/src/charts/beeswarm-chart/beeswarm-chart.tsx +1 -1
  253. package/src/charts/chord-chart/chord-chart.tsx +13 -5
  254. package/src/charts/core/cartesian/cartesian-chart.tsx +55 -10
  255. package/src/charts/core/cartesian/layout.ts +29 -10
  256. package/src/charts/core/cartesian/marks.tsx +3 -3
  257. package/src/charts/core/cartesian/types.ts +30 -2
  258. package/src/charts/core/category-explorer.tsx +12 -6
  259. package/src/charts/core/chart-dock.tsx +68 -0
  260. package/src/charts/core/chart-frame.tsx +116 -27
  261. package/src/charts/core/distribution/explorer.tsx +17 -7
  262. package/src/charts/core/distribution/xy-points.tsx +1 -1
  263. package/src/charts/core/index.ts +3 -0
  264. package/src/charts/core/leave-grace.ts +35 -0
  265. package/src/charts/core/nearest.ts +38 -0
  266. package/src/charts/core/plot-overlay.tsx +9 -3
  267. package/src/charts/core/pointer.test-utils.ts +146 -0
  268. package/src/charts/core/tooltip.tsx +129 -15
  269. package/src/charts/core/touch-select.ts +250 -0
  270. package/src/charts/core/types.ts +13 -4
  271. package/src/charts/core/use-index-navigation.ts +70 -11
  272. package/src/charts/donut-chart/donut-chart.tsx +53 -3
  273. package/src/charts/donut-chart/slice-labels.ts +39 -0
  274. package/src/charts/dumbbell-chart/dumbbell-chart.tsx +8 -3
  275. package/src/charts/fill-gauge-chart/fill-gauge-chart.tsx +1 -0
  276. package/src/charts/funnel-chart/funnel-chart.tsx +2 -1
  277. package/src/charts/gauge-chart/gauge-chart.tsx +2 -1
  278. package/src/charts/heatmap-chart/heatmap-chart.tsx +5 -0
  279. package/src/charts/heatmap-chart/heatmap-grid.tsx +5 -1
  280. package/src/charts/hex-tile-map/hex-tile-map.tsx +6 -1
  281. package/src/charts/hierarchy-morph/hierarchy-morph.tsx +2 -1
  282. package/src/charts/icicle-chart/icicle-chart.tsx +8 -9
  283. package/src/charts/lollipop-chart/lollipop-chart.tsx +8 -3
  284. package/src/charts/maps/geo/map-viewport.tsx +1 -1
  285. package/src/charts/polar-area-chart/polar-area-chart.tsx +37 -12
  286. package/src/charts/progress-units/progress-units.tsx +1 -0
  287. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  288. package/src/charts/radial-bar-chart/radial-bar-chart.tsx +2 -1
  289. package/src/charts/range-area-chart/range-area-chart.tsx +3 -2
  290. package/src/charts/sankey-chart/sankey-chart.tsx +12 -4
  291. package/src/charts/tree-chart/tree-chart.tsx +1 -0
  292. package/src/charts/treemap-chart/treemap-chart.tsx +2 -7
  293. package/src/charts/waterfall-chart/waterfall-chart.tsx +8 -3
  294. package/src/containers/action-bar/action-bar.tsx +13 -2
  295. package/src/containers/card/card.tsx +43 -4
  296. package/src/containers/grid/grid.tsx +37 -0
  297. package/src/containers/grid/index.ts +1 -0
  298. package/src/containers/index.ts +3 -0
  299. package/src/containers/kpi/kpi.tsx +116 -22
  300. package/src/containers/kpi-group/index.ts +7 -1
  301. package/src/containers/kpi-group/kpi-group.tsx +26 -1
  302. package/src/containers/page/index.ts +1 -0
  303. package/src/containers/page/page.tsx +17 -0
  304. package/src/containers/page-header/page-header.tsx +38 -8
  305. package/src/containers/responsive-list/responsive-list.tsx +7 -4
  306. package/src/containers/stack/index.ts +7 -0
  307. package/src/containers/stack/stack.tsx +55 -0
  308. package/src/forms/copy-field/copy-field.tsx +88 -0
  309. package/src/forms/copy-field/index.ts +1 -0
  310. package/src/forms/emoji-picker/emoji-picker.tsx +1 -1
  311. package/src/forms/form/form.tsx +46 -0
  312. package/src/forms/form/index.ts +8 -0
  313. package/src/forms/index.ts +2 -0
  314. package/src/forms/input/index.ts +1 -1
  315. package/src/forms/input/input.tsx +14 -3
  316. package/src/glass/crystal-map.ts +150 -0
  317. package/src/glass/displacement-map.ts +317 -0
  318. package/src/glass/index.ts +43 -0
  319. package/src/glass/lens-crystal.ts +226 -0
  320. package/src/glass/lens-dispersion.ts +34 -0
  321. package/src/glass/liquid-glass.tsx +371 -0
  322. package/src/glass/liquid-motion.ts +395 -0
  323. package/src/glass/liquid-options.ts +306 -0
  324. package/src/glass/refraction.ts +1010 -0
  325. package/src/glass/specular-map.ts +95 -0
  326. package/src/glass/spring.ts +98 -0
  327. package/src/glass/support.ts +27 -0
  328. package/src/glass/use-glass-refraction.ts +21 -0
  329. package/src/i18n/strings.ts +24 -0
  330. package/src/icons/index.ts +2 -0
  331. package/src/icons/key.tsx +13 -0
  332. package/src/icons/webhook.tsx +13 -0
  333. package/src/liquid/index.ts +24 -0
  334. package/src/navigation/breadcrumbs/breadcrumbs.tsx +103 -0
  335. package/src/navigation/breadcrumbs/index.ts +8 -0
  336. package/src/navigation/index.ts +1 -0
  337. package/src/navigation/segmented/index.ts +1 -0
  338. package/src/navigation/segmented/model.ts +11 -0
  339. package/src/navigation/segmented/segmented.tsx +45 -6
  340. package/src/overlays/context-menu/context-menu.tsx +11 -1
  341. package/src/overlays/dialog/dialog.tsx +10 -0
  342. package/src/overlays/drawer/drawer.tsx +10 -0
  343. package/src/overlays/dropdown-menu/dropdown-menu.tsx +10 -1
  344. package/src/overlays/hover-card/hover-card.tsx +12 -1
  345. package/src/overlays/popover/popover.tsx +10 -0
  346. package/src/palette/command-palette/command-palette.tsx +15 -1
  347. package/src/primitives/command/command.tsx +4 -0
  348. package/src/primitives/menu/menu.tsx +1 -1
  349. package/src/primitives/popper/popper.tsx +10 -0
  350. package/src/rich-text/rich-text-editor.tsx +116 -13
  351. package/src/rich-text/sanitize.ts +94 -23
  352. package/src/shell/app-shell/app-shell.tsx +60 -4
  353. package/src/shell/bottom-nav/bottom-nav.tsx +187 -0
  354. package/src/shell/bottom-nav/index.ts +8 -0
  355. package/src/shell/bottom-nav/split.ts +20 -0
  356. package/src/shell/sidebar/sidebar.tsx +51 -5
  357. package/src/shell/topbar/topbar.tsx +81 -58
  358. package/src/states/empty-state/empty-state.tsx +11 -1
  359. package/src/states/error-state/error-state.tsx +4 -0
  360. package/src/states/index.ts +1 -0
  361. package/src/states/live-status-bar/index.ts +6 -0
  362. package/src/states/live-status-bar/live-status-bar.tsx +62 -0
  363. package/src/states/offline-banner/offline-banner.tsx +13 -5
  364. package/src/utils/class-groups.ts +17 -0
  365. package/src/utils/index.ts +1 -0
  366. package/src/utils/material.ts +16 -0
  367. package/src/utils/tone.ts +29 -0
  368. package/src/utils/use-copy.ts +38 -0
  369. package/styles/Theme.kt +64 -3
  370. package/styles/base.css +51 -0
  371. package/styles/tailwind.css +833 -0
  372. package/styles/theme.css +546 -4
  373. package/styles/tokens.css +788 -15
  374. package/tokens/default.json +918 -29
  375. package/scripts/build-theme.d.ts +0 -18
@@ -1,7 +1,15 @@
1
1
  "use client";
2
- import { jsx, jsxs } from "react/jsx-runtime";
2
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
3
+ import { useCallback, useEffect, useMemo, useRef, useState } from "react";
3
4
  import { cn } from "../../utils/cn.js";
5
+ import {
6
+ ChartDockProvider,
7
+ DOCK_SLOT_VISIBILITY,
8
+ resolveDocked,
9
+ useDockDevice
10
+ } from "./chart-dock.js";
4
11
  import { ChartEmpty, ChartSkeleton } from "./chart-states.js";
12
+ import { useTouchSelection } from "./touch-select.js";
5
13
  import { resolveDrawingHeight, useChartSize } from "./use-chart-size.js";
6
14
  const FILL_MIN_HEIGHT = 120;
7
15
  function ChartFrame({
@@ -16,10 +24,17 @@ function ChartFrame({
16
24
  legendAside = false,
17
25
  table,
18
26
  footer,
27
+ dock = "auto",
19
28
  className,
20
29
  children
21
30
  }) {
22
31
  const [ref, size] = useChartSize();
32
+ const rootRef = useRef(null);
33
+ const [slot, setSlot] = useState(null);
34
+ const device = useDockDevice();
35
+ const [spoken, setSpoken] = useState("");
36
+ const how = useRef("mouse");
37
+ const said = useRef({ text: "", timer: void 0 });
23
38
  const fill = height === "fill";
24
39
  const drawingHeight = resolveDrawingHeight({
25
40
  height,
@@ -28,35 +43,100 @@ function ChartFrame({
28
43
  measured: size.height
29
44
  });
30
45
  const ready = !loading && !empty;
46
+ const docked = resolveDocked(dock, device);
47
+ const readDetails = useCallback(
48
+ () => rootRef.current?.querySelector("[data-chart-tooltip]")?.textContent ?? null,
49
+ []
50
+ );
51
+ useTouchSelection(ref, readDetails, ready);
52
+ useEffect(() => {
53
+ const root = rootRef.current;
54
+ if (!root) return;
55
+ const byPointer = (event) => {
56
+ how.current = event.pointerType === "mouse" ? "mouse" : "touch";
57
+ };
58
+ const byKey = () => {
59
+ how.current = "keyboard";
60
+ };
61
+ root.addEventListener("pointerover", byPointer, true);
62
+ root.addEventListener("pointermove", byPointer, true);
63
+ root.addEventListener("pointerdown", byPointer, true);
64
+ root.addEventListener("keydown", byKey, true);
65
+ const state = said.current;
66
+ return () => {
67
+ root.removeEventListener("pointerover", byPointer, true);
68
+ root.removeEventListener("pointermove", byPointer, true);
69
+ root.removeEventListener("pointerdown", byPointer, true);
70
+ root.removeEventListener("keydown", byKey, true);
71
+ clearTimeout(state.timer);
72
+ };
73
+ }, []);
74
+ const announce = useCallback((text) => {
75
+ const state = said.current;
76
+ clearTimeout(state.timer);
77
+ if (text === "") {
78
+ state.text = "";
79
+ setSpoken("");
80
+ return;
81
+ }
82
+ if (how.current === "mouse" || text === state.text) return;
83
+ state.timer = setTimeout(() => {
84
+ state.text = text;
85
+ setSpoken(text);
86
+ }, 150);
87
+ }, []);
88
+ const dockValue = useMemo(() => ({ slot, docked, announce }), [slot, docked, announce]);
31
89
  const legendNode = ready && legend ? legendAside ? /* @__PURE__ */ jsx("div", { className: "@lg/chart:order-last @lg/chart:w-44 @lg/chart:shrink-0 @lg/chart:[&_ul]:flex-col @lg/chart:[&_ul]:flex-nowrap @lg/chart:[&_ul]:items-start", children: legend }) : legend : null;
32
- return /* @__PURE__ */ jsx("div", { className: cn("@container/chart relative w-full min-w-0", fill && "h-full", className), children: /* @__PURE__ */ jsxs(
90
+ return /* @__PURE__ */ jsx(
33
91
  "div",
34
92
  {
35
- className: cn(
36
- "flex w-full min-w-0 flex-col gap-2",
37
- fill && "h-full",
38
- legendAside && "@lg/chart:flex-row @lg/chart:items-center @lg/chart:gap-4"
39
- ),
40
- children: [
41
- legendPosition === "top" ? legendNode : null,
42
- /* @__PURE__ */ jsx(
43
- "div",
44
- {
45
- ref,
46
- className: cn(
47
- "relative min-w-0",
48
- fill ? "min-h-0 flex-1 basis-0 @lg/chart:self-stretch" : cn("w-full", legendAside && "@lg/chart:w-auto @lg/chart:flex-1")
93
+ ref: rootRef,
94
+ className: cn("@container/chart relative w-full min-w-0", fill && "h-full", className),
95
+ children: /* @__PURE__ */ jsx(ChartDockProvider, { value: dockValue, children: /* @__PURE__ */ jsxs(
96
+ "div",
97
+ {
98
+ className: cn(
99
+ "flex w-full min-w-0 flex-col gap-2",
100
+ fill && "h-full",
101
+ legendAside && "@lg/chart:flex-row @lg/chart:items-center @lg/chart:gap-4"
102
+ ),
103
+ children: [
104
+ legendPosition === "top" ? legendNode : null,
105
+ /* @__PURE__ */ jsx(
106
+ "div",
107
+ {
108
+ ref,
109
+ className: cn(
110
+ "relative min-w-0",
111
+ fill ? "min-h-0 flex-1 basis-0 @lg/chart:self-stretch" : cn("w-full", legendAside && "@lg/chart:w-auto @lg/chart:flex-1")
112
+ ),
113
+ style: fill ? { minHeight: FILL_MIN_HEIGHT } : { height: drawingHeight },
114
+ children: loading ? /* @__PURE__ */ jsx(ChartSkeleton, { height: drawingHeight, label: labels.loading, shape: skeleton }) : empty ? /* @__PURE__ */ jsx(ChartEmpty, { height: drawingHeight, label: labels.empty }) : children(size.width, drawingHeight)
115
+ }
49
116
  ),
50
- style: fill ? { minHeight: FILL_MIN_HEIGHT } : { height: drawingHeight },
51
- children: loading ? /* @__PURE__ */ jsx(ChartSkeleton, { height: drawingHeight, label: labels.loading, shape: skeleton }) : empty ? /* @__PURE__ */ jsx(ChartEmpty, { height: drawingHeight, label: labels.empty }) : children(size.width, drawingHeight)
52
- }
53
- ),
54
- ready ? footer : null,
55
- legendPosition === "bottom" ? legendNode : null,
56
- ready ? table : null
57
- ]
117
+ dock !== "never" ? /* @__PURE__ */ jsxs(Fragment, { children: [
118
+ /* @__PURE__ */ jsx(
119
+ "div",
120
+ {
121
+ ref: setSlot,
122
+ "data-chart-dock": "",
123
+ "aria-hidden": "true",
124
+ className: cn(
125
+ "h-40 shrink-0 overflow-y-auto overscroll-contain",
126
+ DOCK_SLOT_VISIBILITY[dock]
127
+ )
128
+ }
129
+ ),
130
+ /* @__PURE__ */ jsx("div", { role: "status", "aria-live": "polite", "aria-atomic": "true", className: "sr-only", children: spoken })
131
+ ] }) : null,
132
+ ready ? footer : null,
133
+ legendPosition === "bottom" ? legendNode : null,
134
+ ready ? table : null
135
+ ]
136
+ }
137
+ ) })
58
138
  }
59
- ) });
139
+ );
60
140
  }
61
141
  export {
62
142
  ChartFrame
@@ -4,8 +4,11 @@ export interface PlotExplorerProps {
4
4
  count: number;
5
5
  active: number | null;
6
6
  onActiveChange: (index: number | null) => void;
7
- /** Item under a plot-relative pixel, or null. */
8
- pick: (x: number, y: number) => number | null;
7
+ /**
8
+ * Item under a plot-relative pixel, or null. `radius` is set for a finger: snap to the nearest
9
+ * item within that many pixels instead of the chart's own, tighter mouse tolerance.
10
+ */
11
+ pick: (x: number, y: number, radius?: number) => number | null;
9
12
  /** Accessible name, e.g. `labels.explore`. */
10
13
  label: string;
11
14
  /** What a screen reader announces for the active item. */
@@ -2,6 +2,7 @@
2
2
  import { jsx } from "react/jsx-runtime";
3
3
  import { useRef } from "react";
4
4
  import { cn } from "../../../utils/cn.js";
5
+ import { TOUCH_TARGET } from "../chart-dock.js";
5
6
  function PlotExplorer({
6
7
  count,
7
8
  active,
@@ -40,7 +41,8 @@ function PlotExplorer({
40
41
  };
41
42
  const onPointerMove = (event) => {
42
43
  const rect = event.currentTarget.getBoundingClientRect();
43
- change(pick(event.clientX - rect.left, event.clientY - rect.top));
44
+ const radius = event.pointerType === "touch" ? TOUCH_TARGET : void 0;
45
+ change(pick(event.clientX - rect.left, event.clientY - rect.top, radius));
44
46
  };
45
47
  return /* @__PURE__ */ jsx(
46
48
  "div",
@@ -53,13 +55,18 @@ function PlotExplorer({
53
55
  "aria-valuenow": (active ?? 0) + 1,
54
56
  "aria-valuetext": valueText,
55
57
  onKeyDown,
56
- onFocus: () => {
57
- if (latest.current == null && count > 0) change(0);
58
+ onFocus: (event) => {
59
+ if (latest.current == null && count > 0 && event.currentTarget.matches(":focus-visible"))
60
+ change(0);
58
61
  },
59
62
  onBlur: () => change(null),
60
63
  onPointerMove,
61
- onPointerDown: onPointerMove,
62
- onPointerLeave: () => change(null),
64
+ onPointerDown: (event) => {
65
+ if (event.pointerType !== "touch") onPointerMove(event);
66
+ },
67
+ onPointerLeave: (event) => {
68
+ if (event.pointerType !== "touch") change(null);
69
+ },
63
70
  className: cn(
64
71
  "absolute cursor-default rounded-xs outline-none focus-visible:outline-2 focus-visible:outline-accent-ink focus-visible:outline-offset-4",
65
72
  className
@@ -920,7 +920,7 @@ function XYPointPlot({
920
920
  count: readOrder.length,
921
921
  active,
922
922
  onActiveChange: setActive,
923
- pick: (x, y) => pointIndex.nearest(x, y, 16),
923
+ pick: (x, y, radius2) => pointIndex.nearest(x, y, radius2 ?? 16),
924
924
  label: labels.explore,
925
925
  valueText,
926
926
  margin,
@@ -12,6 +12,7 @@ export * from "./cartesian/sync.js";
12
12
  export * from "./cartesian/types.js";
13
13
  export * from "./category-axis.js";
14
14
  export * from "./category-explorer.js";
15
+ export * from "./chart-dock.js";
15
16
  export * from "./chart-frame.js";
16
17
  export * from "./chart-states.js";
17
18
  export * from "./chord.js";
@@ -27,6 +28,7 @@ export * from "./hierarchy.js";
27
28
  export * from "./hierarchy-chart.js";
28
29
  export * from "./indicators.js";
29
30
  export * from "./ink.js";
31
+ export * from "./leave-grace.js";
30
32
  export * from "./legend.js";
31
33
  export * from "./motion.js";
32
34
  export * from "./palette.js";
@@ -41,6 +43,7 @@ export * from "./shape-morph.js";
41
43
  export * from "./stack.js";
42
44
  export * from "./time-range.js";
43
45
  export * from "./tooltip.js";
46
+ export * from "./touch-select.js";
44
47
  export * from "./tree-layout.js";
45
48
  export * from "./tree-radial.js";
46
49
  export * from "./types.js";
@@ -12,6 +12,7 @@ export * from "./cartesian/sync.js";
12
12
  export * from "./cartesian/types.js";
13
13
  export * from "./category-axis.js";
14
14
  export * from "./category-explorer.js";
15
+ export * from "./chart-dock.js";
15
16
  export * from "./chart-frame.js";
16
17
  export * from "./chart-states.js";
17
18
  export * from "./chord.js";
@@ -27,6 +28,7 @@ export * from "./hierarchy.js";
27
28
  export * from "./hierarchy-chart.js";
28
29
  export * from "./indicators.js";
29
30
  export * from "./ink.js";
31
+ export * from "./leave-grace.js";
30
32
  export * from "./legend.js";
31
33
  export * from "./motion.js";
32
34
  export * from "./palette.js";
@@ -41,6 +43,7 @@ export * from "./shape-morph.js";
41
43
  export * from "./stack.js";
42
44
  export * from "./time-range.js";
43
45
  export * from "./tooltip.js";
46
+ export * from "./touch-select.js";
44
47
  export * from "./tree-layout.js";
45
48
  export * from "./tree-radial.js";
46
49
  export * from "./types.js";
@@ -0,0 +1,11 @@
1
+ /** How long a pointer may be over nothing before the hover clears (crossing a 1-6px gutter). */
2
+ export declare const LEAVE_GRACE_MS = 60;
3
+ /**
4
+ * Defers clearing a hover so crossing the gutter between two adjacent marks goes A to B without an
5
+ * empty frame. `leave` schedules the clear; `hold` cancels it and must run whenever a mark is
6
+ * entered or moved over, before the new hover is stored.
7
+ */
8
+ export declare function useLeaveGrace(clear: () => void, delay?: number): {
9
+ leave: () => void;
10
+ hold: () => void;
11
+ };
@@ -0,0 +1,26 @@
1
+ "use client";
2
+ import { useCallback, useEffect, useRef } from "react";
3
+ const LEAVE_GRACE_MS = 60;
4
+ function useLeaveGrace(clear, delay = LEAVE_GRACE_MS) {
5
+ const timer = useRef(void 0);
6
+ const latest = useRef(clear);
7
+ latest.current = clear;
8
+ const hold = useCallback(() => {
9
+ if (timer.current === void 0) return;
10
+ clearTimeout(timer.current);
11
+ timer.current = void 0;
12
+ }, []);
13
+ const leave = useCallback(() => {
14
+ hold();
15
+ timer.current = setTimeout(() => {
16
+ timer.current = void 0;
17
+ latest.current();
18
+ }, delay);
19
+ }, [hold, delay]);
20
+ useEffect(() => hold, [hold]);
21
+ return { leave, hold };
22
+ }
23
+ export {
24
+ LEAVE_GRACE_MS,
25
+ useLeaveGrace
26
+ };
@@ -0,0 +1,14 @@
1
+ export interface Box {
2
+ x0: number;
3
+ y0: number;
4
+ x1: number;
5
+ y1: number;
6
+ }
7
+ /** Gap (px) a pointer may sit in between two adjacent cells and still count as on the nearest one. */
8
+ export declare const GUTTER_SNAP = 6;
9
+ /**
10
+ * The item whose box contains `(x, y)`, else the nearest box within `radius` px, else null. Later
11
+ * items win ties, like paint order. Crossing the thin gutter between two cells therefore goes A to
12
+ * B without an empty frame in between.
13
+ */
14
+ export declare function boxAt<T>(items: readonly T[], x: number, y: number, box: (item: T) => Box, radius?: number): T | null;
@@ -0,0 +1,22 @@
1
+ const GUTTER_SNAP = 6;
2
+ function boxAt(items, x, y, box, radius = GUTTER_SNAP) {
3
+ let best = null;
4
+ let gap = radius;
5
+ for (let i = items.length - 1; i >= 0; i -= 1) {
6
+ const item = items[i];
7
+ const { x0, y0, x1, y1 } = box(item);
8
+ const dx = Math.max(x0 - x, 0, x - x1);
9
+ const dy = Math.max(y0 - y, 0, y - y1);
10
+ if (dx === 0 && dy === 0) return item;
11
+ const distance = Math.hypot(dx, dy);
12
+ if (distance <= gap && (best === null || distance < gap)) {
13
+ best = item;
14
+ gap = distance;
15
+ }
16
+ }
17
+ return best;
18
+ }
19
+ export {
20
+ GUTTER_SNAP,
21
+ boxAt
22
+ };
@@ -50,11 +50,17 @@ function PlotOverlay({
50
50
  "aria-valuenow": (active ?? 0) + 1,
51
51
  "aria-valuetext": valueText,
52
52
  onKeyDown,
53
- onFocus: () => onActiveChange(active ?? 0),
53
+ onFocus: (event) => {
54
+ if (event.currentTarget.matches(":focus-visible")) onActiveChange(active ?? 0);
55
+ },
54
56
  onBlur: () => onActiveChange(null),
55
57
  onPointerMove: (event) => onActiveChange(indexAt(local(event))),
56
- onPointerDown: (event) => onActiveChange(indexAt(local(event))),
57
- onPointerLeave: () => onActiveChange(null),
58
+ onPointerDown: (event) => {
59
+ if (event.pointerType !== "touch") onActiveChange(indexAt(local(event)));
60
+ },
61
+ onPointerLeave: (event) => {
62
+ if (event.pointerType !== "touch") onActiveChange(null);
63
+ },
58
64
  className: cn(
59
65
  "absolute rounded-xs outline-none focus-visible:outline-2 focus-visible:outline-accent-ink focus-visible:outline-offset-4",
60
66
  className
@@ -0,0 +1,38 @@
1
+ export declare const frame: () => Promise<number>;
2
+ /**
3
+ * A pointer that stays at one client point, re-hit-tested every frame the way the browser does
4
+ * after layout or transform changes, firing the over/out pairs React turns into enter/leave.
5
+ * Returns how many times the element under the pointer changed.
6
+ */
7
+ export declare function holdPointer(x: number, y: number, ms: number, onFrame: () => void): Promise<number>;
8
+ /** A point just inside the inner edge of a ring shape at its middle angle, at rest. */
9
+ export declare function innerEdgePoint(slice: SVGPathElement, svg: SVGSVGElement): {
10
+ x: number;
11
+ y: number;
12
+ };
13
+ /**
14
+ * A client point on `target` that really hits it: for an SVG shape, the point inside its fill or
15
+ * stroke closest to its box centre (a ring's box centre is its hole); otherwise the box centre.
16
+ */
17
+ export declare function pointInside(target: Element): {
18
+ x: number;
19
+ y: number;
20
+ };
21
+ /**
22
+ * A press and release at a client point the way a browser reports a tap, on the element under it:
23
+ * `over`, `down`, `up`, then `out` (a touch or pen pointer leaves the element when it lifts).
24
+ * A mouse press also leaves when it moves away, which `moveAway` stands for.
25
+ */
26
+ export declare function tapAt(point: {
27
+ x: number;
28
+ y: number;
29
+ }, pointerType?: "mouse" | "touch", { travel }?: {
30
+ travel?: number;
31
+ }): Promise<void>;
32
+ /** A press and release on `target`, aimed at a point that hits it. */
33
+ export declare function tapAndLift(target: Element, pointerType: "mouse" | "touch"): Promise<void>;
34
+ /** A mouse pointer moved to a client point, dispatched on the element under it. */
35
+ export declare function moveTo(point: {
36
+ x: number;
37
+ y: number;
38
+ }): Promise<void>;
@@ -0,0 +1,123 @@
1
+ const frame = () => new Promise((resolve) => requestAnimationFrame(resolve));
2
+ async function holdPointer(x, y, ms, onFrame) {
3
+ let current = null;
4
+ let changes = 0;
5
+ const init = { bubbles: true, clientX: x, clientY: y, pointerType: "mouse", isPrimary: true };
6
+ const end = performance.now() + ms;
7
+ while (performance.now() < end) {
8
+ const next = document.elementFromPoint(x, y);
9
+ if (next !== current) {
10
+ if (current)
11
+ current.dispatchEvent(new PointerEvent("pointerout", { ...init, relatedTarget: next }));
12
+ if (next)
13
+ next.dispatchEvent(new PointerEvent("pointerover", { ...init, relatedTarget: current }));
14
+ if (current) changes++;
15
+ current = next;
16
+ }
17
+ next?.dispatchEvent(new PointerEvent("pointermove", init));
18
+ await frame();
19
+ onFrame();
20
+ }
21
+ return changes;
22
+ }
23
+ function innerEdgePoint(slice, svg) {
24
+ const cx = svg.width.baseVal.value / 2;
25
+ const cy = svg.height.baseVal.value / 2;
26
+ let best = [];
27
+ for (let deg = 0; deg < 360; deg += 1) {
28
+ const a2 = deg * Math.PI / 180;
29
+ for (let r = 4; r < Math.min(cx, cy); r += 1) {
30
+ const point = new DOMPoint(cx + Math.sin(a2) * r, cy - Math.cos(a2) * r);
31
+ if (slice.isPointInFill(point)) {
32
+ best.push({ x: point.x, y: point.y, r, deg });
33
+ break;
34
+ }
35
+ }
36
+ }
37
+ const mid = best.reduce((sum, p) => sum + p.deg, 0) / best.length;
38
+ best = best.sort((a2, b) => Math.abs(a2.deg - mid) - Math.abs(b.deg - mid));
39
+ const pick = best[0];
40
+ const box = svg.getBoundingClientRect();
41
+ const a = pick.deg * Math.PI / 180;
42
+ return { x: box.left + pick.x + Math.sin(a), y: box.top + pick.y - Math.cos(a) };
43
+ }
44
+ function pointInside(target) {
45
+ const box = target.getBoundingClientRect();
46
+ const middle = { x: box.left + box.width / 2, y: box.top + box.height / 2 };
47
+ if (!(target instanceof SVGGeometryElement)) return middle;
48
+ const matrix = target.getScreenCTM();
49
+ if (!matrix) return middle;
50
+ const filled = getComputedStyle(target).fill !== "none";
51
+ const local = target.getBBox();
52
+ const centre = new DOMPoint(local.x + local.width / 2, local.y + local.height / 2);
53
+ const step = Math.max(1, Math.min(local.width, local.height) / 40);
54
+ let best = null;
55
+ for (let x = local.x; x <= local.x + local.width; x += step) {
56
+ for (let y = local.y; y <= local.y + local.height; y += step) {
57
+ const point = new DOMPoint(x, y);
58
+ if (!(filled && target.isPointInFill(point)) && !target.isPointInStroke(point)) continue;
59
+ const distance = Math.hypot(x - centre.x, y - centre.y);
60
+ if (!best || distance < best.distance) best = { point, distance };
61
+ }
62
+ }
63
+ const onLine = !best && target.getTotalLength() > 0 ? target.getPointAtLength(target.getTotalLength() / 2) : null;
64
+ const found = best?.point ?? onLine;
65
+ if (!found) return middle;
66
+ const at = new DOMPoint(found.x, found.y).matrixTransform(matrix);
67
+ return { x: at.x, y: at.y };
68
+ }
69
+ async function tapAt(point, pointerType = "touch", { travel = 0 } = {}) {
70
+ const target = document.elementFromPoint(point.x, point.y) ?? document.body;
71
+ const init = {
72
+ bubbles: true,
73
+ clientX: point.x,
74
+ clientY: point.y,
75
+ pointerType,
76
+ isPrimary: true,
77
+ pointerId: 7
78
+ };
79
+ target.dispatchEvent(new PointerEvent("pointerover", init));
80
+ target.dispatchEvent(new PointerEvent("pointerdown", init));
81
+ await frame();
82
+ if (travel > 0) {
83
+ target.dispatchEvent(
84
+ new PointerEvent("pointermove", { ...init, clientX: point.x + travel, clientY: point.y })
85
+ );
86
+ await frame();
87
+ }
88
+ target.dispatchEvent(
89
+ new PointerEvent(travel > 0 ? "pointercancel" : "pointerup", {
90
+ ...init,
91
+ clientX: point.x + travel
92
+ })
93
+ );
94
+ target.dispatchEvent(new PointerEvent("pointerout", { ...init, relatedTarget: null }));
95
+ await frame();
96
+ await frame();
97
+ await frame();
98
+ }
99
+ async function tapAndLift(target, pointerType) {
100
+ await tapAt(pointInside(target), pointerType);
101
+ }
102
+ async function moveTo(point) {
103
+ const target = document.elementFromPoint(point.x, point.y) ?? document.body;
104
+ target.dispatchEvent(
105
+ new PointerEvent("pointermove", {
106
+ bubbles: true,
107
+ clientX: point.x,
108
+ clientY: point.y,
109
+ pointerType: "mouse",
110
+ isPrimary: true
111
+ })
112
+ );
113
+ await frame();
114
+ }
115
+ export {
116
+ frame,
117
+ holdPointer,
118
+ innerEdgePoint,
119
+ moveTo,
120
+ pointInside,
121
+ tapAndLift,
122
+ tapAt
123
+ };
@@ -1,4 +1,5 @@
1
1
  import { type ReactNode } from "react";
2
+ import { type ChartDockMode } from "./chart-dock.js";
2
3
  import type { LegendShape } from "./legend.js";
3
4
  export interface TooltipRow {
4
5
  id: string;
@@ -23,10 +24,20 @@ export interface ChartTooltipProps {
23
24
  rows: readonly TooltipRow[];
24
25
  /** Wrapped sentence under the title, for notes that are not series values. */
25
26
  body?: string;
27
+ /** Content under the rows. */
28
+ footer?: ReactNode;
26
29
  /** Forces the side of the anchor the card opens on (when it fits); by default it follows the anchor. */
27
30
  side?: "left" | "right";
31
+ /**
32
+ * `auto` (default) docks the details in the frame's panel under the plot when the frame is 480px
33
+ * wide or less, or the primary pointer is coarse. `never` always floats. `always` docks whenever
34
+ * the enclosing `ChartFrame` has a panel, which it only has when it docks itself: set `dock` on
35
+ * the `ChartFrame` too (without a panel the card floats).
36
+ */
37
+ dock?: ChartDockMode;
28
38
  className?: string;
29
39
  }
40
+ type Side = "left" | "right";
30
41
  /**
31
42
  * Floating card that lists every series at the hovered position. Purely
32
43
  * visual (`aria-hidden`): screen readers get the same numbers from the live
@@ -34,9 +45,21 @@ export interface ChartTooltipProps {
34
45
  * the pointer never triggers layout. Its own width is measured so the card
35
46
  * always stays inside the container: it takes the side of the anchor with
36
47
  * room, and is clamped to the edges when neither side fits (narrow charts).
48
+ * The side only changes past a dead zone, and a side swap jumps instead of
49
+ * sliding across the pointer.
50
+ *
51
+ * Docked (see `dock`), the same rows render in the frame's live panel below
52
+ * the plot instead, which is how touch screens read them.
37
53
  */
38
- export declare function ChartTooltip({ x, y, containerWidth, containerHeight, title, rows, body, side, className, }: ChartTooltipProps): import("react").JSX.Element;
54
+ export declare function ChartTooltip({ x, y, containerWidth, containerHeight, title, rows, body, footer, side, dock, className, }: ChartTooltipProps): import("react").JSX.Element;
55
+ /**
56
+ * Side of the anchor a card `width` wide opens on. Unless `forced`, it keeps `previous` while that
57
+ * side fits and the pointer stays inside the dead zone (right of the anchor until 65% of the
58
+ * container, left of it until 55%), so a 1-2px move never swaps sides.
59
+ */
60
+ export declare function chooseTooltipSide(previous: Side | undefined, x: number, width: number, containerWidth: number, forced?: Side): Side;
39
61
  /** Left edge of a tooltip `width` wide next to anchor `x`, kept inside `containerWidth`. */
40
- export declare function tooltipLeft(x: number, width: number, containerWidth: number, side?: "left" | "right"): number;
62
+ export declare function tooltipLeft(x: number, width: number, containerWidth: number, side?: Side): number;
41
63
  /** Vertical centre of a card `height` tall at anchor `y`, kept inside `containerHeight` when it fits. */
42
64
  export declare function tooltipCenterY(y: number, height: number, containerHeight: number): number;
65
+ export {};