@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
@@ -2,6 +2,7 @@
2
2
 
3
3
  import { type KeyboardEvent, type PointerEvent, useRef } from "react";
4
4
  import { cn } from "../../../utils/cn.js";
5
+ import { TOUCH_TARGET } from "../chart-dock.js";
5
6
  import type { PlotMargin } from "./layout.js";
6
7
 
7
8
  export interface PlotExplorerProps {
@@ -9,8 +10,11 @@ export interface PlotExplorerProps {
9
10
  count: number;
10
11
  active: number | null;
11
12
  onActiveChange: (index: number | null) => void;
12
- /** Item under a plot-relative pixel, or null. */
13
- pick: (x: number, y: number) => number | null;
13
+ /**
14
+ * Item under a plot-relative pixel, or null. `radius` is set for a finger: snap to the nearest
15
+ * item within that many pixels instead of the chart's own, tighter mouse tolerance.
16
+ */
17
+ pick: (x: number, y: number, radius?: number) => number | null;
14
18
  /** Accessible name, e.g. `labels.explore`. */
15
19
  label: string;
16
20
  /** What a screen reader announces for the active item. */
@@ -66,7 +70,8 @@ export function PlotExplorer({
66
70
 
67
71
  const onPointerMove = (event: PointerEvent<HTMLDivElement>) => {
68
72
  const rect = event.currentTarget.getBoundingClientRect();
69
- change(pick(event.clientX - rect.left, event.clientY - rect.top));
73
+ const radius = event.pointerType === "touch" ? TOUCH_TARGET : undefined;
74
+ change(pick(event.clientX - rect.left, event.clientY - rect.top, radius));
70
75
  };
71
76
 
72
77
  return (
@@ -79,13 +84,18 @@ export function PlotExplorer({
79
84
  aria-valuenow={(active ?? 0) + 1}
80
85
  aria-valuetext={valueText}
81
86
  onKeyDown={onKeyDown}
82
- onFocus={() => {
83
- if (latest.current == null && count > 0) change(0);
87
+ onFocus={(event) => {
88
+ if (latest.current == null && count > 0 && event.currentTarget.matches(":focus-visible"))
89
+ change(0);
84
90
  }}
85
91
  onBlur={() => change(null)}
86
92
  onPointerMove={onPointerMove}
87
- onPointerDown={onPointerMove}
88
- onPointerLeave={() => change(null)}
93
+ onPointerDown={(event) => {
94
+ if (event.pointerType !== "touch") onPointerMove(event);
95
+ }}
96
+ onPointerLeave={(event) => {
97
+ if (event.pointerType !== "touch") change(null);
98
+ }}
89
99
  className={cn(
90
100
  "absolute cursor-default rounded-xs outline-none focus-visible:outline-2 focus-visible:outline-accent-ink focus-visible:outline-offset-4",
91
101
  className,
@@ -1160,7 +1160,7 @@ function XYPointPlot({
1160
1160
  count={readOrder.length}
1161
1161
  active={active}
1162
1162
  onActiveChange={setActive}
1163
- pick={(x, y) => pointIndex.nearest(x, y, 16)}
1163
+ pick={(x, y, radius) => pointIndex.nearest(x, y, radius ?? 16)}
1164
1164
  label={labels.explore}
1165
1165
  valueText={valueText}
1166
1166
  margin={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";
@@ -0,0 +1,35 @@
1
+ "use client";
2
+
3
+ import { useCallback, useEffect, useRef } from "react";
4
+
5
+ /** How long a pointer may be over nothing before the hover clears (crossing a 1-6px gutter). */
6
+ export const LEAVE_GRACE_MS = 60;
7
+
8
+ /**
9
+ * Defers clearing a hover so crossing the gutter between two adjacent marks goes A to B without an
10
+ * empty frame. `leave` schedules the clear; `hold` cancels it and must run whenever a mark is
11
+ * entered or moved over, before the new hover is stored.
12
+ */
13
+ export function useLeaveGrace(clear: () => void, delay: number = LEAVE_GRACE_MS) {
14
+ const timer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);
15
+ const latest = useRef(clear);
16
+ latest.current = clear;
17
+
18
+ const hold = useCallback(() => {
19
+ if (timer.current === undefined) return;
20
+ clearTimeout(timer.current);
21
+ timer.current = undefined;
22
+ }, []);
23
+
24
+ const leave = useCallback(() => {
25
+ hold();
26
+ timer.current = setTimeout(() => {
27
+ timer.current = undefined;
28
+ latest.current();
29
+ }, delay);
30
+ }, [hold, delay]);
31
+
32
+ useEffect(() => hold, [hold]);
33
+
34
+ return { leave, hold };
35
+ }
@@ -0,0 +1,38 @@
1
+ export interface Box {
2
+ x0: number;
3
+ y0: number;
4
+ x1: number;
5
+ y1: number;
6
+ }
7
+
8
+ /** Gap (px) a pointer may sit in between two adjacent cells and still count as on the nearest one. */
9
+ export const GUTTER_SNAP = 6;
10
+
11
+ /**
12
+ * The item whose box contains `(x, y)`, else the nearest box within `radius` px, else null. Later
13
+ * items win ties, like paint order. Crossing the thin gutter between two cells therefore goes A to
14
+ * B without an empty frame in between.
15
+ */
16
+ export function boxAt<T>(
17
+ items: readonly T[],
18
+ x: number,
19
+ y: number,
20
+ box: (item: T) => Box,
21
+ radius: number = GUTTER_SNAP,
22
+ ): T | null {
23
+ let best: T | null = null;
24
+ let gap = radius;
25
+ for (let i = items.length - 1; i >= 0; i -= 1) {
26
+ const item = items[i] as T;
27
+ const { x0, y0, x1, y1 } = box(item);
28
+ const dx = Math.max(x0 - x, 0, x - x1);
29
+ const dy = Math.max(y0 - y, 0, y - y1);
30
+ if (dx === 0 && dy === 0) return item;
31
+ const distance = Math.hypot(dx, dy);
32
+ if (distance <= gap && (best === null || distance < gap)) {
33
+ best = item;
34
+ gap = distance;
35
+ }
36
+ }
37
+ return best;
38
+ }
@@ -91,11 +91,17 @@ export function PlotOverlay({
91
91
  aria-valuenow={(active ?? 0) + 1}
92
92
  aria-valuetext={valueText}
93
93
  onKeyDown={onKeyDown}
94
- onFocus={() => onActiveChange(active ?? 0)}
94
+ onFocus={(event) => {
95
+ if (event.currentTarget.matches(":focus-visible")) onActiveChange(active ?? 0);
96
+ }}
95
97
  onBlur={() => onActiveChange(null)}
96
98
  onPointerMove={(event) => onActiveChange(indexAt(local(event)))}
97
- onPointerDown={(event) => onActiveChange(indexAt(local(event)))}
98
- onPointerLeave={() => onActiveChange(null)}
99
+ onPointerDown={(event) => {
100
+ if (event.pointerType !== "touch") onActiveChange(indexAt(local(event)));
101
+ }}
102
+ onPointerLeave={(event) => {
103
+ if (event.pointerType !== "touch") onActiveChange(null);
104
+ }}
99
105
  className={cn(
100
106
  "absolute rounded-xs outline-none focus-visible:outline-2 focus-visible:outline-accent-ink focus-visible:outline-offset-4",
101
107
  className,
@@ -0,0 +1,146 @@
1
+ export const frame = () => new Promise<number>((resolve) => requestAnimationFrame(resolve));
2
+
3
+ /**
4
+ * A pointer that stays at one client point, re-hit-tested every frame the way the browser does
5
+ * after layout or transform changes, firing the over/out pairs React turns into enter/leave.
6
+ * Returns how many times the element under the pointer changed.
7
+ */
8
+ export async function holdPointer(x: number, y: number, ms: number, onFrame: () => void) {
9
+ let current: Element | null = null;
10
+ let changes = 0;
11
+ const init = { bubbles: true, clientX: x, clientY: y, pointerType: "mouse", isPrimary: true };
12
+ const end = performance.now() + ms;
13
+ while (performance.now() < end) {
14
+ const next = document.elementFromPoint(x, y);
15
+ if (next !== current) {
16
+ if (current)
17
+ current.dispatchEvent(new PointerEvent("pointerout", { ...init, relatedTarget: next }));
18
+ if (next)
19
+ next.dispatchEvent(new PointerEvent("pointerover", { ...init, relatedTarget: current }));
20
+ if (current) changes++;
21
+ current = next;
22
+ }
23
+ next?.dispatchEvent(new PointerEvent("pointermove", init));
24
+ await frame();
25
+ onFrame();
26
+ }
27
+ return changes;
28
+ }
29
+
30
+ /** A point just inside the inner edge of a ring shape at its middle angle, at rest. */
31
+ export function innerEdgePoint(slice: SVGPathElement, svg: SVGSVGElement) {
32
+ const cx = svg.width.baseVal.value / 2;
33
+ const cy = svg.height.baseVal.value / 2;
34
+ let best: { x: number; y: number; r: number; deg: number }[] = [];
35
+ for (let deg = 0; deg < 360; deg += 1) {
36
+ const a = (deg * Math.PI) / 180;
37
+ for (let r = 4; r < Math.min(cx, cy); r += 1) {
38
+ const point = new DOMPoint(cx + Math.sin(a) * r, cy - Math.cos(a) * r);
39
+ if (slice.isPointInFill(point)) {
40
+ best.push({ x: point.x, y: point.y, r, deg });
41
+ break;
42
+ }
43
+ }
44
+ }
45
+ const mid = best.reduce((sum, p) => sum + p.deg, 0) / best.length;
46
+ best = best.sort((a, b) => Math.abs(a.deg - mid) - Math.abs(b.deg - mid));
47
+ const pick = best[0] as { x: number; y: number; r: number; deg: number };
48
+ const box = svg.getBoundingClientRect();
49
+ const a = (pick.deg * Math.PI) / 180;
50
+ // One pixel past the first filled radius, well inside the step-out distance.
51
+ return { x: box.left + pick.x + Math.sin(a), y: box.top + pick.y - Math.cos(a) };
52
+ }
53
+
54
+ /**
55
+ * A client point on `target` that really hits it: for an SVG shape, the point inside its fill or
56
+ * stroke closest to its box centre (a ring's box centre is its hole); otherwise the box centre.
57
+ */
58
+ export function pointInside(target: Element): { x: number; y: number } {
59
+ const box = target.getBoundingClientRect();
60
+ const middle = { x: box.left + box.width / 2, y: box.top + box.height / 2 };
61
+ if (!(target instanceof SVGGeometryElement)) return middle;
62
+ const matrix = target.getScreenCTM();
63
+ if (!matrix) return middle;
64
+ const filled = getComputedStyle(target).fill !== "none";
65
+ const local = target.getBBox();
66
+ const centre = new DOMPoint(local.x + local.width / 2, local.y + local.height / 2);
67
+ const step = Math.max(1, Math.min(local.width, local.height) / 40);
68
+ let best: { point: DOMPoint; distance: number } | null = null;
69
+ for (let x = local.x; x <= local.x + local.width; x += step) {
70
+ for (let y = local.y; y <= local.y + local.height; y += step) {
71
+ const point = new DOMPoint(x, y);
72
+ if (!(filled && target.isPointInFill(point)) && !target.isPointInStroke(point)) continue;
73
+ const distance = Math.hypot(x - centre.x, y - centre.y);
74
+ if (!best || distance < best.distance) best = { point, distance };
75
+ }
76
+ }
77
+ // A stroke-only shape (a ring track): its centre line.
78
+ const onLine =
79
+ !best && target.getTotalLength() > 0
80
+ ? target.getPointAtLength(target.getTotalLength() / 2)
81
+ : null;
82
+ const found = best?.point ?? onLine;
83
+ if (!found) return middle;
84
+ const at = new DOMPoint(found.x, found.y).matrixTransform(matrix);
85
+ return { x: at.x, y: at.y };
86
+ }
87
+
88
+ /**
89
+ * A press and release at a client point the way a browser reports a tap, on the element under it:
90
+ * `over`, `down`, `up`, then `out` (a touch or pen pointer leaves the element when it lifts).
91
+ * A mouse press also leaves when it moves away, which `moveAway` stands for.
92
+ */
93
+ export async function tapAt(
94
+ point: { x: number; y: number },
95
+ pointerType: "mouse" | "touch" = "touch",
96
+ { travel = 0 }: { travel?: number } = {},
97
+ ) {
98
+ const target = document.elementFromPoint(point.x, point.y) ?? document.body;
99
+ const init = {
100
+ bubbles: true,
101
+ clientX: point.x,
102
+ clientY: point.y,
103
+ pointerType,
104
+ isPrimary: true,
105
+ pointerId: 7,
106
+ };
107
+ target.dispatchEvent(new PointerEvent("pointerover", init));
108
+ target.dispatchEvent(new PointerEvent("pointerdown", init));
109
+ await frame();
110
+ if (travel > 0) {
111
+ target.dispatchEvent(
112
+ new PointerEvent("pointermove", { ...init, clientX: point.x + travel, clientY: point.y }),
113
+ );
114
+ await frame();
115
+ }
116
+ target.dispatchEvent(
117
+ new PointerEvent(travel > 0 ? "pointercancel" : "pointerup", {
118
+ ...init,
119
+ clientX: point.x + travel,
120
+ }),
121
+ );
122
+ target.dispatchEvent(new PointerEvent("pointerout", { ...init, relatedTarget: null }));
123
+ await frame();
124
+ await frame();
125
+ await frame();
126
+ }
127
+
128
+ /** A press and release on `target`, aimed at a point that hits it. */
129
+ export async function tapAndLift(target: Element, pointerType: "mouse" | "touch") {
130
+ await tapAt(pointInside(target), pointerType);
131
+ }
132
+
133
+ /** A mouse pointer moved to a client point, dispatched on the element under it. */
134
+ export async function moveTo(point: { x: number; y: number }) {
135
+ const target = document.elementFromPoint(point.x, point.y) ?? document.body;
136
+ target.dispatchEvent(
137
+ new PointerEvent("pointermove", {
138
+ bubbles: true,
139
+ clientX: point.x,
140
+ clientY: point.y,
141
+ pointerType: "mouse",
142
+ isPrimary: true,
143
+ }),
144
+ );
145
+ await frame();
146
+ }
@@ -1,12 +1,18 @@
1
1
  "use client";
2
2
 
3
- import { type ReactNode, useRef, useState } from "react";
3
+ import { type ReactNode, useEffect, useRef, useState } from "react";
4
+ import { createPortal } from "react-dom";
4
5
  import { cn } from "../../utils/cn.js";
6
+ import { type ChartDockMode, useChartDock } from "./chart-dock.js";
5
7
  import type { LegendShape } from "./legend.js";
6
8
  import { useIsomorphicLayoutEffect } from "./use-chart-size.js";
7
9
 
8
10
  const OFFSET = 14;
9
11
  const EDGE = 4;
12
+ /** A card on the right moves left only past this share of the container width. */
13
+ const FLIP_LEFT_AT = 0.65;
14
+ /** A card on the left moves back right only below this share: a dead zone against jitter. */
15
+ const FLIP_RIGHT_AT = 0.55;
10
16
 
11
17
  export interface TooltipRow {
12
18
  id: string;
@@ -32,11 +38,22 @@ export interface ChartTooltipProps {
32
38
  rows: readonly TooltipRow[];
33
39
  /** Wrapped sentence under the title, for notes that are not series values. */
34
40
  body?: string;
41
+ /** Content under the rows. */
42
+ footer?: ReactNode;
35
43
  /** Forces the side of the anchor the card opens on (when it fits); by default it follows the anchor. */
36
44
  side?: "left" | "right";
45
+ /**
46
+ * `auto` (default) docks the details in the frame's panel under the plot when the frame is 480px
47
+ * wide or less, or the primary pointer is coarse. `never` always floats. `always` docks whenever
48
+ * the enclosing `ChartFrame` has a panel, which it only has when it docks itself: set `dock` on
49
+ * the `ChartFrame` too (without a panel the card floats).
50
+ */
51
+ dock?: ChartDockMode;
37
52
  className?: string;
38
53
  }
39
54
 
55
+ type Side = "left" | "right";
56
+
40
57
  /**
41
58
  * Floating card that lists every series at the hovered position. Purely
42
59
  * visual (`aria-hidden`): screen readers get the same numbers from the live
@@ -44,6 +61,11 @@ export interface ChartTooltipProps {
44
61
  * the pointer never triggers layout. Its own width is measured so the card
45
62
  * always stays inside the container: it takes the side of the anchor with
46
63
  * room, and is clamped to the edges when neither side fits (narrow charts).
64
+ * The side only changes past a dead zone, and a side swap jumps instead of
65
+ * sliding across the pointer.
66
+ *
67
+ * Docked (see `dock`), the same rows render in the frame's live panel below
68
+ * the plot instead, which is how touch screens read them.
47
69
  */
48
70
  export function ChartTooltip({
49
71
  x,
@@ -53,10 +75,14 @@ export function ChartTooltip({
53
75
  title,
54
76
  rows,
55
77
  body,
78
+ footer,
56
79
  side,
80
+ dock = "auto",
57
81
  className,
58
82
  }: ChartTooltipProps) {
83
+ const frame = useChartDock();
59
84
  const ref = useRef<HTMLDivElement>(null);
85
+ const committed = useRef<Side | undefined>(undefined);
60
86
  const [size, setSize] = useState({ width: 0, height: 0 });
61
87
  useIsomorphicLayoutEffect(() => {
62
88
  const width = ref.current?.offsetWidth ?? 0;
@@ -64,15 +90,37 @@ export function ChartTooltip({
64
90
  if (Math.abs(width - size.width) > 0.5 || Math.abs(height - size.height) > 0.5)
65
91
  setSize({ width, height });
66
92
  });
67
- const left = tooltipLeft(x, size.width, containerWidth, side);
93
+ const chosen = chooseTooltipSide(committed.current, x, size.width, containerWidth, side);
94
+ const swapped = committed.current != null && committed.current !== chosen;
95
+ useIsomorphicLayoutEffect(() => {
96
+ committed.current = chosen;
97
+ });
98
+
99
+ const docked = dock === "never" ? false : dock === "always" ? true : frame.docked;
100
+ if (docked && frame.slot) {
101
+ return createPortal(
102
+ <DockedDetails
103
+ title={title}
104
+ body={body}
105
+ rows={rows}
106
+ footer={footer}
107
+ announce={frame.announce}
108
+ />,
109
+ frame.slot,
110
+ );
111
+ }
112
+
113
+ const left = leftOnSide(chosen, x, size.width, containerWidth);
68
114
  const top = containerHeight == null ? y : tooltipCenterY(y, size.height, containerHeight);
69
115
  return (
70
116
  <div
71
117
  ref={ref}
118
+ data-chart-tooltip=""
72
119
  aria-hidden="true"
73
120
  className={cn(
74
121
  "pointer-events-none absolute top-0 left-0 z-10 min-w-30 rounded-popover surface-overlay px-3 py-2.5 text-fs-120 shadow-overlay",
75
- "motion-safe:transition-transform motion-safe:duration-100 motion-safe:ease-out",
122
+ !swapped &&
123
+ "motion-safe:transition-transform motion-safe:duration-100 motion-safe:ease-out",
76
124
  className,
77
125
  )}
78
126
  style={{
@@ -80,6 +128,22 @@ export function ChartTooltip({
80
128
  transform: `translate3d(${Math.round(left)}px, ${Math.round(top)}px, 0) translateY(-50%)`,
81
129
  }}
82
130
  >
131
+ <TooltipBody title={title} body={body} rows={rows} footer={footer} />
132
+ </div>
133
+ );
134
+ }
135
+
136
+ interface BodyProps {
137
+ title?: ReactNode;
138
+ body?: string;
139
+ rows: readonly TooltipRow[];
140
+ footer?: ReactNode;
141
+ rowClassName?: string;
142
+ }
143
+
144
+ function TooltipBody({ title, body, rows, footer, rowClassName }: BodyProps) {
145
+ return (
146
+ <>
83
147
  {title ? <div className="mb-1.5 font-bold text-fs-120 text-ink">{title}</div> : null}
84
148
  {body ? <div className="text-ink-2 leading-snug">{body}</div> : null}
85
149
  <div className="flex flex-col gap-1">
@@ -89,6 +153,7 @@ export function ChartTooltip({
89
153
  className={cn(
90
154
  "flex items-center gap-2 text-ink-2",
91
155
  row.emphasis && "mt-0.5 border-t-divider pt-1.5 text-ink",
156
+ rowClassName,
92
157
  )}
93
158
  >
94
159
  {row.emphasis ? (
@@ -110,25 +175,74 @@ export function ChartTooltip({
110
175
  </div>
111
176
  ))}
112
177
  </div>
178
+ {footer ? <div className="mt-1.5 text-ink-2">{footer}</div> : null}
179
+ </>
180
+ );
181
+ }
182
+
183
+ /** Details inside the frame's docked panel: in flow, full width, rows at least 44px tall. */
184
+ function DockedDetails({
185
+ title,
186
+ body,
187
+ rows,
188
+ footer,
189
+ announce,
190
+ }: BodyProps & { announce: (text: string) => void }) {
191
+ const ref = useRef<HTMLDivElement>(null);
192
+ useEffect(() => {
193
+ announce(ref.current?.textContent ?? "");
194
+ });
195
+ useEffect(() => () => announce(""), [announce]);
196
+ return (
197
+ <div
198
+ ref={ref}
199
+ data-chart-tooltip=""
200
+ data-docked=""
201
+ className="rounded-popover surface-overlay px-3 py-2 text-fs-130"
202
+ >
203
+ <TooltipBody title={title} body={body} rows={rows} footer={footer} rowClassName="min-h-11" />
113
204
  </div>
114
205
  );
115
206
  }
116
207
 
117
- /** Left edge of a tooltip `width` wide next to anchor `x`, kept inside `containerWidth`. */
118
- export function tooltipLeft(
208
+ /**
209
+ * Side of the anchor a card `width` wide opens on. Unless `forced`, it keeps `previous` while that
210
+ * side fits and the pointer stays inside the dead zone (right of the anchor until 65% of the
211
+ * container, left of it until 55%), so a 1-2px move never swaps sides.
212
+ */
213
+ export function chooseTooltipSide(
214
+ previous: Side | undefined,
119
215
  x: number,
120
216
  width: number,
121
217
  containerWidth: number,
122
- side?: "left" | "right",
123
- ): number {
124
- const right = x + OFFSET;
125
- const leftSide = x - OFFSET - width;
126
- const preferLeft = side ? side === "left" : x > containerWidth * 0.6;
127
- const fitsRight = right + width <= containerWidth - EDGE;
128
- const fitsLeft = leftSide >= EDGE;
129
- const chosen =
130
- preferLeft && fitsLeft ? leftSide : fitsRight ? right : fitsLeft ? leftSide : right;
131
- return Math.max(EDGE, Math.min(chosen, containerWidth - width - EDGE));
218
+ forced?: Side,
219
+ ): Side {
220
+ const share = containerWidth > 0 ? x / containerWidth : 0;
221
+ let wanted: Side;
222
+ if (forced) wanted = forced;
223
+ else if (previous === "left") wanted = share < FLIP_RIGHT_AT ? "right" : "left";
224
+ else if (previous === "right") wanted = share > FLIP_LEFT_AT ? "left" : "right";
225
+ else wanted = share > 0.6 ? "left" : "right";
226
+ const fitsRight = x + OFFSET + width <= containerWidth - EDGE;
227
+ const fitsLeft = x - OFFSET - width >= EDGE;
228
+ if (wanted === "left" ? fitsLeft : fitsRight) return wanted;
229
+ if (wanted === "left" ? fitsRight : fitsLeft) return wanted === "left" ? "right" : "left";
230
+ return "right";
231
+ }
232
+
233
+ function leftOnSide(side: Side, x: number, width: number, containerWidth: number): number {
234
+ const target = side === "left" ? x - OFFSET - width : x + OFFSET;
235
+ return Math.max(EDGE, Math.min(target, containerWidth - width - EDGE));
236
+ }
237
+
238
+ /** Left edge of a tooltip `width` wide next to anchor `x`, kept inside `containerWidth`. */
239
+ export function tooltipLeft(x: number, width: number, containerWidth: number, side?: Side): number {
240
+ return leftOnSide(
241
+ chooseTooltipSide(undefined, x, width, containerWidth, side),
242
+ x,
243
+ width,
244
+ containerWidth,
245
+ );
132
246
  }
133
247
 
134
248
  /** Vertical centre of a card `height` tall at anchor `y`, kept inside `containerHeight` when it fits. */