@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,10 +1,14 @@
1
1
  "use client";
2
- import { jsx, jsxs } from "react/jsx-runtime";
3
- import { useRef, useState } from "react";
2
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
3
+ import { useEffect, useRef, useState } from "react";
4
+ import { createPortal } from "react-dom";
4
5
  import { cn } from "../../utils/cn.js";
6
+ import { useChartDock } from "./chart-dock.js";
5
7
  import { useIsomorphicLayoutEffect } from "./use-chart-size.js";
6
8
  const OFFSET = 14;
7
9
  const EDGE = 4;
10
+ const FLIP_LEFT_AT = 0.65;
11
+ const FLIP_RIGHT_AT = 0.55;
8
12
  function ChartTooltip({
9
13
  x,
10
14
  y,
@@ -13,10 +17,14 @@ function ChartTooltip({
13
17
  title,
14
18
  rows,
15
19
  body,
20
+ footer,
16
21
  side,
22
+ dock = "auto",
17
23
  className
18
24
  }) {
25
+ const frame = useChartDock();
19
26
  const ref = useRef(null);
27
+ const committed = useRef(void 0);
20
28
  const [size, setSize] = useState({ width: 0, height: 0 });
21
29
  useIsomorphicLayoutEffect(() => {
22
30
  const width = ref.current?.offsetWidth ?? 0;
@@ -24,62 +32,128 @@ function ChartTooltip({
24
32
  if (Math.abs(width - size.width) > 0.5 || Math.abs(height - size.height) > 0.5)
25
33
  setSize({ width, height });
26
34
  });
27
- const left = tooltipLeft(x, size.width, containerWidth, side);
35
+ const chosen = chooseTooltipSide(committed.current, x, size.width, containerWidth, side);
36
+ const swapped = committed.current != null && committed.current !== chosen;
37
+ useIsomorphicLayoutEffect(() => {
38
+ committed.current = chosen;
39
+ });
40
+ const docked = dock === "never" ? false : dock === "always" ? true : frame.docked;
41
+ if (docked && frame.slot) {
42
+ return createPortal(
43
+ /* @__PURE__ */ jsx(
44
+ DockedDetails,
45
+ {
46
+ title,
47
+ body,
48
+ rows,
49
+ footer,
50
+ announce: frame.announce
51
+ }
52
+ ),
53
+ frame.slot
54
+ );
55
+ }
56
+ const left = leftOnSide(chosen, x, size.width, containerWidth);
28
57
  const top = containerHeight == null ? y : tooltipCenterY(y, size.height, containerHeight);
29
- return /* @__PURE__ */ jsxs(
58
+ return /* @__PURE__ */ jsx(
30
59
  "div",
31
60
  {
32
61
  ref,
62
+ "data-chart-tooltip": "",
33
63
  "aria-hidden": "true",
34
64
  className: cn(
35
65
  "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",
36
- "motion-safe:transition-transform motion-safe:duration-100 motion-safe:ease-out",
66
+ !swapped && "motion-safe:transition-transform motion-safe:duration-100 motion-safe:ease-out",
37
67
  className
38
68
  ),
39
69
  style: {
40
70
  maxWidth: Math.max(120, Math.min(260, containerWidth - EDGE * 2)),
41
71
  transform: `translate3d(${Math.round(left)}px, ${Math.round(top)}px, 0) translateY(-50%)`
42
72
  },
43
- children: [
44
- title ? /* @__PURE__ */ jsx("div", { className: "mb-1.5 font-bold text-fs-120 text-ink", children: title }) : null,
45
- body ? /* @__PURE__ */ jsx("div", { className: "text-ink-2 leading-snug", children: body }) : null,
46
- /* @__PURE__ */ jsx("div", { className: "flex flex-col gap-1", children: rows.map((row) => /* @__PURE__ */ jsxs(
47
- "div",
48
- {
49
- className: cn(
50
- "flex items-center gap-2 text-ink-2",
51
- row.emphasis && "mt-0.5 border-t-divider pt-1.5 text-ink"
52
- ),
53
- children: [
54
- row.emphasis ? /* @__PURE__ */ jsx("span", { className: "w-2.5 shrink-0" }) : /* @__PURE__ */ jsx(
55
- "span",
56
- {
57
- className: cn(
58
- "size-2.5 shrink-0",
59
- row.shape === "line" || row.shape === "dashed" || row.shape === "dot" ? "rounded-pill" : "rounded-xs"
60
- ),
61
- style: { background: row.color }
62
- }
73
+ children: /* @__PURE__ */ jsx(TooltipBody, { title, body, rows, footer })
74
+ }
75
+ );
76
+ }
77
+ function TooltipBody({ title, body, rows, footer, rowClassName }) {
78
+ return /* @__PURE__ */ jsxs(Fragment, { children: [
79
+ title ? /* @__PURE__ */ jsx("div", { className: "mb-1.5 font-bold text-fs-120 text-ink", children: title }) : null,
80
+ body ? /* @__PURE__ */ jsx("div", { className: "text-ink-2 leading-snug", children: body }) : null,
81
+ /* @__PURE__ */ jsx("div", { className: "flex flex-col gap-1", children: rows.map((row) => /* @__PURE__ */ jsxs(
82
+ "div",
83
+ {
84
+ className: cn(
85
+ "flex items-center gap-2 text-ink-2",
86
+ row.emphasis && "mt-0.5 border-t-divider pt-1.5 text-ink",
87
+ rowClassName
88
+ ),
89
+ children: [
90
+ row.emphasis ? /* @__PURE__ */ jsx("span", { className: "w-2.5 shrink-0" }) : /* @__PURE__ */ jsx(
91
+ "span",
92
+ {
93
+ className: cn(
94
+ "size-2.5 shrink-0",
95
+ row.shape === "line" || row.shape === "dashed" || row.shape === "dot" ? "rounded-pill" : "rounded-xs"
63
96
  ),
64
- /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate", children: row.name }),
65
- /* @__PURE__ */ jsx("span", { className: "font-bold text-ink tabular-nums", children: row.value }),
66
- row.note ? /* @__PURE__ */ jsx("span", { className: "text-ink-3 tabular-nums", children: row.note }) : null
67
- ]
68
- },
69
- row.id
70
- )) })
71
- ]
97
+ style: { background: row.color }
98
+ }
99
+ ),
100
+ /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate", children: row.name }),
101
+ /* @__PURE__ */ jsx("span", { className: "font-bold text-ink tabular-nums", children: row.value }),
102
+ row.note ? /* @__PURE__ */ jsx("span", { className: "text-ink-3 tabular-nums", children: row.note }) : null
103
+ ]
104
+ },
105
+ row.id
106
+ )) }),
107
+ footer ? /* @__PURE__ */ jsx("div", { className: "mt-1.5 text-ink-2", children: footer }) : null
108
+ ] });
109
+ }
110
+ function DockedDetails({
111
+ title,
112
+ body,
113
+ rows,
114
+ footer,
115
+ announce
116
+ }) {
117
+ const ref = useRef(null);
118
+ useEffect(() => {
119
+ announce(ref.current?.textContent ?? "");
120
+ });
121
+ useEffect(() => () => announce(""), [announce]);
122
+ return /* @__PURE__ */ jsx(
123
+ "div",
124
+ {
125
+ ref,
126
+ "data-chart-tooltip": "",
127
+ "data-docked": "",
128
+ className: "rounded-popover surface-overlay px-3 py-2 text-fs-130",
129
+ children: /* @__PURE__ */ jsx(TooltipBody, { title, body, rows, footer, rowClassName: "min-h-11" })
72
130
  }
73
131
  );
74
132
  }
133
+ function chooseTooltipSide(previous, x, width, containerWidth, forced) {
134
+ const share = containerWidth > 0 ? x / containerWidth : 0;
135
+ let wanted;
136
+ if (forced) wanted = forced;
137
+ else if (previous === "left") wanted = share < FLIP_RIGHT_AT ? "right" : "left";
138
+ else if (previous === "right") wanted = share > FLIP_LEFT_AT ? "left" : "right";
139
+ else wanted = share > 0.6 ? "left" : "right";
140
+ const fitsRight = x + OFFSET + width <= containerWidth - EDGE;
141
+ const fitsLeft = x - OFFSET - width >= EDGE;
142
+ if (wanted === "left" ? fitsLeft : fitsRight) return wanted;
143
+ if (wanted === "left" ? fitsRight : fitsLeft) return wanted === "left" ? "right" : "left";
144
+ return "right";
145
+ }
146
+ function leftOnSide(side, x, width, containerWidth) {
147
+ const target = side === "left" ? x - OFFSET - width : x + OFFSET;
148
+ return Math.max(EDGE, Math.min(target, containerWidth - width - EDGE));
149
+ }
75
150
  function tooltipLeft(x, width, containerWidth, side) {
76
- const right = x + OFFSET;
77
- const leftSide = x - OFFSET - width;
78
- const preferLeft = side ? side === "left" : x > containerWidth * 0.6;
79
- const fitsRight = right + width <= containerWidth - EDGE;
80
- const fitsLeft = leftSide >= EDGE;
81
- const chosen = preferLeft && fitsLeft ? leftSide : fitsRight ? right : fitsLeft ? leftSide : right;
82
- return Math.max(EDGE, Math.min(chosen, containerWidth - width - EDGE));
151
+ return leftOnSide(
152
+ chooseTooltipSide(void 0, x, width, containerWidth, side),
153
+ x,
154
+ width,
155
+ containerWidth
156
+ );
83
157
  }
84
158
  function tooltipCenterY(y, height, containerHeight) {
85
159
  const min = height / 2 + EDGE;
@@ -88,6 +162,7 @@ function tooltipCenterY(y, height, containerHeight) {
88
162
  }
89
163
  export {
90
164
  ChartTooltip,
165
+ chooseTooltipSide,
91
166
  tooltipCenterY,
92
167
  tooltipLeft
93
168
  };
@@ -0,0 +1,20 @@
1
+ import { type RefObject } from "react";
2
+ /** A finger that travels farther than this (px) is a swipe or scroll, never a selection. */
3
+ export declare const TAP_SLOP = 10;
4
+ /**
5
+ * Touch selection for every chart, in one place. On a touch screen the browser turns a tap into
6
+ * `pointerover`, `pointerdown`, `pointerup` and then `pointerout`, and a swipe into the same
7
+ * start followed by `pointercancel`, so hover handlers either flash and vanish or select while
8
+ * the page scrolls. This hook, attached to the plot element:
9
+ *
10
+ * - swallows touch `pointerover` / `pointerout`, so a lifted finger never counts as leaving;
11
+ * - on a tap (up within `TAP_SLOP` of the press) finds the mark under the finger, or the nearest
12
+ * one within `TOUCH_TARGET` px, and replays a mouse hover on it: the details are pinned;
13
+ * - tapping the pinned mark again (the details read the same), tapping outside the plot, tapping
14
+ * empty space or pressing Escape replays the mouse leaving, which unpins;
15
+ * - leaves the pinned mark alone while the page scrolls.
16
+ *
17
+ * Mouse and pen events pass through untouched. `details` reads the text the chart currently
18
+ * shows, which is how "the same mark" is recognised for charts with one hit area.
19
+ */
20
+ export declare function useTouchSelection(ref: RefObject<HTMLElement | null>, details: () => string | null, enabled?: boolean): void;
@@ -0,0 +1,184 @@
1
+ "use client";
2
+ import { useEffect, useRef } from "react";
3
+ import { TOUCH_TARGET } from "./chart-dock.js";
4
+ const TAP_SLOP = 10;
5
+ const MARK = "[data-chart-hit],[data-category]";
6
+ const KEEP = "[data-chart-dock],[data-chart-tooltip]";
7
+ const RING_DIRECTIONS = 8;
8
+ const RING_STEPS = 4;
9
+ const replayed = /* @__PURE__ */ new WeakSet();
10
+ function emit(target, type, at, related, pointerType = "mouse") {
11
+ const event = new PointerEvent(type, {
12
+ bubbles: true,
13
+ cancelable: true,
14
+ composed: true,
15
+ clientX: at.x,
16
+ clientY: at.y,
17
+ pointerId: 1,
18
+ pointerType,
19
+ isPrimary: true,
20
+ relatedTarget: related
21
+ });
22
+ replayed.add(event);
23
+ target.dispatchEvent(event);
24
+ }
25
+ function useTouchSelection(ref, details, enabled = true) {
26
+ const read = useRef(details);
27
+ read.current = details;
28
+ useEffect(() => {
29
+ const root = ref.current;
30
+ if (!root || !enabled) return;
31
+ const host = root;
32
+ let pin = null;
33
+ let press = null;
34
+ let settle = 0;
35
+ const inside = (element) => element != null && element !== root && root.contains(element);
36
+ const markOf = (element) => {
37
+ const mark = element?.closest(MARK) ?? null;
38
+ return inside(mark) ? mark : null;
39
+ };
40
+ const pick = (at) => {
41
+ const marked = root.querySelector(MARK) != null;
42
+ const direct = document.elementFromPoint(at.x, at.y);
43
+ const mark = markOf(direct);
44
+ if (mark) return mark;
45
+ if (!marked) return inside(direct) ? direct : null;
46
+ for (let step = 1; step <= RING_STEPS; step += 1) {
47
+ const radius = TOUCH_TARGET / RING_STEPS * step;
48
+ for (let k = 0; k < RING_DIRECTIONS; k += 1) {
49
+ const angle = k / RING_DIRECTIONS * Math.PI * 2;
50
+ const near = markOf(
51
+ document.elementFromPoint(
52
+ at.x + Math.cos(angle) * radius,
53
+ at.y + Math.sin(angle) * radius
54
+ )
55
+ );
56
+ if (near) return near;
57
+ }
58
+ }
59
+ return null;
60
+ };
61
+ const onKey = (event) => {
62
+ if (event.key === "Escape") release();
63
+ };
64
+ const onOutside = (event) => {
65
+ const target = event.target instanceof Element ? event.target : null;
66
+ if (!target || root.contains(target) || target.closest(KEEP)) return;
67
+ release();
68
+ };
69
+ function release() {
70
+ cancelAnimationFrame(settle);
71
+ document.removeEventListener("keydown", onKey, true);
72
+ document.removeEventListener("pointerdown", onOutside, true);
73
+ const gone = pin;
74
+ pin = null;
75
+ if (!gone) return;
76
+ const target = gone.target.isConnected ? gone.target : inside(document.elementFromPoint(gone.x, gone.y)) ? document.elementFromPoint(gone.x, gone.y) : host.firstElementChild;
77
+ if (target) emit(target, "pointerout", gone, null);
78
+ }
79
+ const hold = () => {
80
+ if (pin?.target.isConnected) {
81
+ emit(pin.target, "pointerover", pin, null, "touch");
82
+ emit(pin.target, "pointermove", pin, null, "touch");
83
+ }
84
+ };
85
+ let undoing;
86
+ const abandon = (target) => {
87
+ if (undoing !== void 0) return;
88
+ undoing = setTimeout(() => {
89
+ undoing = void 0;
90
+ if (pin) hold();
91
+ else if (target instanceof Element && target.isConnected)
92
+ emit(target, "pointerout", { x: 0, y: 0 }, null);
93
+ }, 0);
94
+ };
95
+ const tap = (at) => {
96
+ const mark = pick(at);
97
+ if (!mark) {
98
+ release();
99
+ return;
100
+ }
101
+ const previous = pin;
102
+ if (previous && previous.target !== mark) emit(previous.target, "pointerout", previous, mark);
103
+ else if (!previous) {
104
+ document.addEventListener("keydown", onKey, true);
105
+ document.addEventListener("pointerdown", onOutside, true);
106
+ }
107
+ const next = { ...at, target: mark, text: null };
108
+ pin = next;
109
+ emit(mark, "pointerover", at, previous?.target ?? null, "touch");
110
+ emit(mark, "pointermove", at, null, "touch");
111
+ cancelAnimationFrame(settle);
112
+ settle = requestAnimationFrame(() => {
113
+ settle = requestAnimationFrame(() => {
114
+ if (pin !== next) return;
115
+ const text = read.current();
116
+ const again = previous != null && (text != null ? text === previous.text : previous.target === mark);
117
+ if (again) release();
118
+ else next.text = text;
119
+ });
120
+ });
121
+ };
122
+ const swallow = (event) => {
123
+ if (event.pointerType === "touch" && !replayed.has(event))
124
+ event.stopPropagation();
125
+ };
126
+ const onDown = (event) => {
127
+ if (replayed.has(event)) return;
128
+ if (event.pointerType !== "touch") return;
129
+ if (press && press.id !== event.pointerId) press.moved = true;
130
+ else
131
+ press = {
132
+ x: event.clientX,
133
+ y: event.clientY,
134
+ id: event.pointerId,
135
+ moved: !event.isPrimary
136
+ };
137
+ };
138
+ const onMove = (event) => {
139
+ if (replayed.has(event)) return;
140
+ if (event.pointerType !== "touch" || !press || press.id !== event.pointerId) return;
141
+ if (!press.moved && Math.hypot(event.clientX - press.x, event.clientY - press.y) <= TAP_SLOP)
142
+ return;
143
+ press.moved = true;
144
+ };
145
+ const onCancel = (event) => {
146
+ if (replayed.has(event)) return;
147
+ if (event.pointerType !== "touch") return;
148
+ if (press) abandon(event.target);
149
+ press = null;
150
+ };
151
+ const onUp = (event) => {
152
+ if (replayed.has(event)) return;
153
+ if (event.pointerType !== "touch") return;
154
+ const current = press;
155
+ press = null;
156
+ if (!current || current.id !== event.pointerId) return;
157
+ if (current.moved) abandon(event.target);
158
+ else tap({ x: event.clientX, y: event.clientY });
159
+ };
160
+ const listen = (type, handler) => root.addEventListener(type, handler, true);
161
+ root.addEventListener("pointerover", swallow, true);
162
+ root.addEventListener("pointerout", swallow, true);
163
+ listen("pointerdown", onDown);
164
+ listen("pointermove", onMove);
165
+ listen("pointercancel", onCancel);
166
+ listen("pointerup", onUp);
167
+ return () => {
168
+ root.removeEventListener("pointerover", swallow, true);
169
+ root.removeEventListener("pointerout", swallow, true);
170
+ root.removeEventListener("pointerdown", onDown, true);
171
+ root.removeEventListener("pointermove", onMove, true);
172
+ root.removeEventListener("pointercancel", onCancel, true);
173
+ root.removeEventListener("pointerup", onUp, true);
174
+ cancelAnimationFrame(settle);
175
+ clearTimeout(undoing);
176
+ document.removeEventListener("keydown", onKey, true);
177
+ document.removeEventListener("pointerdown", onOutside, true);
178
+ };
179
+ }, [ref, enabled]);
180
+ }
181
+ export {
182
+ TAP_SLOP,
183
+ useTouchSelection
184
+ };
@@ -85,11 +85,15 @@ export type ChartAnnotation = (AnnotationBase & {
85
85
  y: number;
86
86
  yAxis?: string;
87
87
  });
88
+ /** An axis bound given as a number or as a function of the value the data would give. */
89
+ export type AxisBound = number | ((dataValue: number) => number);
90
+ /** The bound to use: `bound` itself, `bound(dataValue)` for a function, or `dataValue` when unset. */
91
+ export declare function resolveAxisBound(bound: AxisBound | undefined, dataValue: number): number;
88
92
  export interface ValueAxisOptions {
89
- /** Fixed lower bound; by default the data decides (bars and areas start at 0). */
90
- min?: number;
91
- /** Fixed upper bound. */
92
- max?: number;
93
+ /** Fixed lower bound, or a function of the data minimum; by default the data decides (bars and areas start at 0). */
94
+ min?: AxisBound;
95
+ /** Fixed upper bound, or a function of the data maximum, e.g. `(max) => Math.ceil(max / 400) * 400`. */
96
+ max?: AxisBound;
93
97
  /** Approximate number of ticks; derived from the height by default. */
94
98
  tickCount?: number;
95
99
  /** Tick format; defaults to a short form of the chart `valueFormat`. */
@@ -12,7 +12,12 @@ const DEFAULT_LABELS = {
12
12
  function resolveLabels(labels) {
13
13
  return labels ? { ...DEFAULT_LABELS, ...labels } : DEFAULT_LABELS;
14
14
  }
15
+ function resolveAxisBound(bound, dataValue) {
16
+ if (bound == null) return dataValue;
17
+ return typeof bound === "function" ? bound(dataValue) : bound;
18
+ }
15
19
  export {
16
20
  DEFAULT_LABELS,
21
+ resolveAxisBound,
17
22
  resolveLabels
18
23
  };
@@ -1,13 +1,23 @@
1
- import { type KeyboardEvent } from "react";
1
+ import { type FocusEvent, type KeyboardEvent } from "react";
2
2
  export interface IndexNavigationOptions {
3
3
  /** Arrow keys wrap around the ends (circular charts). */
4
4
  wrap?: boolean;
5
5
  }
6
+ interface HoverEvent {
7
+ clientX: number;
8
+ clientY: number;
9
+ /** `mouse`, `touch` or `pen`; absent for synthetic calls, which behave like a mouse. */
10
+ pointerType?: string;
11
+ }
6
12
  /**
7
13
  * Active-item state for charts made of discrete items (slices, axes, stages).
8
14
  * One source of truth for pointer hover and keyboard focus, so the tooltip,
9
15
  * the highlight and `aria-valuetext` always agree. `ref` goes on the
10
16
  * positioned container: `hover` stores the pointer relative to it.
17
+ *
18
+ * A touch or pen press pins the item: lifting the finger fires `pointerleave`,
19
+ * which `pointerLeave` ignores for those pointers, so the details stay up
20
+ * until the next press outside a `CHART_HIT` target.
11
21
  */
12
22
  export declare function useIndexNavigation<T extends HTMLElement = HTMLDivElement>(count: number, { wrap }?: IndexNavigationOptions): {
13
23
  ref: import("react").RefObject<T | null>;
@@ -17,14 +27,15 @@ export declare function useIndexNavigation<T extends HTMLElement = HTMLDivElemen
17
27
  y: number;
18
28
  } | null;
19
29
  setActive: import("react").Dispatch<import("react").SetStateAction<number | null>>;
20
- hover: (index: number, event: {
21
- clientX: number;
22
- clientY: number;
23
- }) => void;
30
+ hover: (index: number, event: HoverEvent) => void;
24
31
  leave: () => void;
32
+ pointerLeave: (event?: {
33
+ pointerType?: string;
34
+ }) => void;
25
35
  sliderProps: {
26
36
  onKeyDown: (event: KeyboardEvent<HTMLElement>) => void;
27
- onFocus: () => void;
37
+ onFocus: (event?: FocusEvent<HTMLElement>) => void;
28
38
  onBlur: () => void;
29
39
  };
30
40
  };
41
+ export {};
@@ -1,22 +1,56 @@
1
1
  "use client";
2
- import { useCallback, useEffect, useRef, useState } from "react";
2
+ import {
3
+ useCallback,
4
+ useEffect,
5
+ useRef,
6
+ useState
7
+ } from "react";
8
+ import { useLeaveGrace } from "./leave-grace.js";
9
+ const CHART_HIT = "data-chart-hit";
3
10
  function useIndexNavigation(count, { wrap = false } = {}) {
4
11
  const ref = useRef(null);
5
12
  const [active, setActive] = useState(null);
6
13
  const [pointer, setPointer] = useState(null);
14
+ const [pinned, setPinned] = useState(false);
7
15
  useEffect(() => {
8
16
  setActive((current) => current != null && current >= count ? null : current);
9
17
  }, [count]);
10
- const hover = useCallback((index, event) => {
11
- const box = ref.current?.getBoundingClientRect();
12
- if (!box) return;
13
- setActive(index);
14
- setPointer({ x: event.clientX - box.left, y: event.clientY - box.top });
15
- }, []);
16
- const leave = useCallback(() => {
18
+ const clear = useCallback(() => {
17
19
  setActive(null);
18
20
  setPointer(null);
21
+ setPinned(false);
19
22
  }, []);
23
+ const { leave: leaveSoon, hold } = useLeaveGrace(clear);
24
+ const hover = useCallback(
25
+ (index, event) => {
26
+ hold();
27
+ const box = ref.current?.getBoundingClientRect();
28
+ if (!box) return;
29
+ setActive(index);
30
+ setPointer({ x: event.clientX - box.left, y: event.clientY - box.top });
31
+ setPinned(event.pointerType != null && event.pointerType !== "mouse");
32
+ },
33
+ [hold]
34
+ );
35
+ const leave = useCallback(() => {
36
+ hold();
37
+ clear();
38
+ }, [hold, clear]);
39
+ const pointerLeave = useCallback(
40
+ (event) => {
41
+ if (event?.pointerType == null || event.pointerType === "mouse") leaveSoon();
42
+ },
43
+ [leaveSoon]
44
+ );
45
+ useEffect(() => {
46
+ if (!pinned) return;
47
+ const dismiss = (event) => {
48
+ const target = event.target instanceof Element ? event.target : null;
49
+ if (!target?.closest(`[${CHART_HIT}]`) || !ref.current?.contains(target)) leave();
50
+ };
51
+ document.addEventListener("pointerdown", dismiss, true);
52
+ return () => document.removeEventListener("pointerdown", dismiss, true);
53
+ }, [pinned, leave]);
20
54
  const onKeyDown = (event) => {
21
55
  if (count === 0) return;
22
56
  const last = count - 1;
@@ -37,10 +71,13 @@ function useIndexNavigation(count, { wrap = false } = {}) {
37
71
  };
38
72
  const sliderProps = {
39
73
  onKeyDown,
40
- onFocus: () => setActive((current) => current ?? 0),
74
+ onFocus: (event) => {
75
+ if (event && !event.currentTarget.matches(":focus-visible")) return;
76
+ setActive((current) => current ?? 0);
77
+ },
41
78
  onBlur: leave
42
79
  };
43
- return { ref, active, pointer, setActive, hover, leave, sliderProps };
80
+ return { ref, active, pointer, setActive, hover, leave, pointerLeave, sliderProps };
44
81
  }
45
82
  export {
46
83
  useIndexNavigation
@@ -15,6 +15,8 @@ export interface DonutDatum {
15
15
  /** How slices are painted: flat color, a radial gradient, or a texture over the color. */
16
16
  export type DonutFill = "solid" | "gradient" | "pattern";
17
17
  export type DonutOutsideLabels = boolean | "name" | "percent" | "both";
18
+ /** Labels inside the ring: `true` and "percent" show the share, "value" the formatted value. */
19
+ export type DonutSliceLabels = boolean | "percent" | "value";
18
20
  export interface DonutChartProps {
19
21
  /** Accessible name of the drawing. */
20
22
  title: string;
@@ -54,6 +56,8 @@ export interface DonutChartProps {
54
56
  centerValue?: string;
55
57
  /** Names / percentages on leader lines around the ring. `true` shows both. */
56
58
  outsideLabels?: DonutOutsideLabels;
59
+ /** Labels drawn inside the ring; slices too small to hold their label are skipped. */
60
+ sliceLabels?: DonutSliceLabels;
57
61
  legend?: boolean | "top" | "bottom";
58
62
  tooltip?: boolean;
59
63
  loading?: boolean;
@@ -70,4 +74,4 @@ export interface DonutChartProps {
70
74
  * on hover or keyboard focus, optional outside labels on leader lines (with
71
75
  * collision avoidance) and a legend that toggles slices.
72
76
  */
73
- export declare function DonutChart({ title, description, data, variant, semi, innerRadius, cornerRadius, gap, explode, startAngle, monochrome, fill, drilldown, rootLabel, breadcrumbLabel, height, aspectRatio, valueFormat, centerLabel, centerValue, outsideLabels, legend, tooltip, loading, animate, initialHidden, onSliceClick, labels: labelsProp, className, }: DonutChartProps): import("react").JSX.Element;
77
+ export declare function DonutChart({ title, description, data, variant, semi, innerRadius, cornerRadius, gap, explode, startAngle, monochrome, fill, drilldown, rootLabel, breadcrumbLabel, height, aspectRatio, valueFormat, centerLabel, centerValue, outsideLabels, sliceLabels, legend, tooltip, loading, animate, initialHidden, onSliceClick, labels: labelsProp, className, }: DonutChartProps): import("react").JSX.Element;