@d3plus/core 4.10.0 → 4.12.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 (711) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +178 -9
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +176 -0
  9. package/es/src/charts/Alluvial/layout.js +137 -0
  10. package/es/src/charts/Alluvial/meta.js +57 -0
  11. package/es/src/charts/Alluvial/titles.js +101 -0
  12. package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
  13. package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
  14. package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
  15. package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
  16. package/es/src/charts/ArcDiagram/emit.js +192 -0
  17. package/es/src/charts/ArcDiagram/events.js +148 -0
  18. package/es/src/charts/ArcDiagram/index.js +217 -0
  19. package/es/src/charts/BarChart/index.js +12 -7
  20. package/es/src/charts/BoxWhisker/index.js +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +5 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +6 -11
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +160 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +137 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +206 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +6 -4
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Matrix/applyLayout.js +20 -9
  70. package/es/src/charts/Matrix/index.js +19 -1
  71. package/es/src/charts/Network/applyLayout.js +171 -96
  72. package/es/src/charts/Network/bundle.js +82 -0
  73. package/es/src/charts/Network/clusterLabels.js +423 -0
  74. package/es/src/charts/Network/clusters.js +290 -0
  75. package/es/src/charts/Network/emit.js +257 -75
  76. package/es/src/charts/Network/graph.js +146 -0
  77. package/es/src/charts/Network/graphFluent.js +81 -0
  78. package/es/src/charts/Network/index.js +91 -106
  79. package/es/src/charts/Network/minNodeDistance.js +64 -0
  80. package/es/src/charts/Network/polygonRows.js +44 -0
  81. package/es/src/charts/Pack/applyLayout.js +16 -5
  82. package/es/src/charts/Pack/emit.js +15 -8
  83. package/es/src/charts/Pack/groupRows.js +61 -0
  84. package/es/src/charts/Pack/index.js +8 -1
  85. package/es/src/charts/Pack/neutralPaint.js +20 -0
  86. package/es/src/charts/Pack/nodeNames.js +35 -0
  87. package/es/src/charts/ParallelCoordinates/axes.js +22 -22
  88. package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
  89. package/es/src/charts/ParallelCoordinates/index.js +3 -1
  90. package/es/src/charts/ParallelCoordinates/titles.js +17 -9
  91. package/es/src/charts/Pie/applyLayout.js +86 -27
  92. package/es/src/charts/Pie/arcFit.js +152 -0
  93. package/es/src/charts/Pie/curvedLabels.js +134 -0
  94. package/es/src/charts/Pie/emit.js +51 -96
  95. package/es/src/charts/Pie/index.js +74 -31
  96. package/es/src/charts/Pie/labelRoom.js +154 -0
  97. package/es/src/charts/Pie/outsideLabels.js +224 -0
  98. package/es/src/charts/Pie/outsideNodes.js +267 -0
  99. package/es/src/charts/Pie/pieLabels.js +137 -0
  100. package/es/src/charts/Pie/sectorBox.js +223 -0
  101. package/es/src/charts/Pie/straightLabels.js +96 -0
  102. package/es/src/charts/Pie/straightLayout.js +215 -0
  103. package/es/src/charts/Plot/alongLegend.js +76 -0
  104. package/es/src/charts/Plot/areaEnter.js +68 -0
  105. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  106. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  107. package/es/src/charts/Plot/axisValues.js +43 -0
  108. package/es/src/charts/Plot/barWidth.js +59 -11
  109. package/es/src/charts/Plot/circleLabels.js +98 -0
  110. package/es/src/charts/Plot/connectGaps.js +237 -0
  111. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  112. package/es/src/charts/Plot/draw.js +34 -14
  113. package/es/src/charts/Plot/fillBetween.js +2 -1
  114. package/es/src/charts/Plot/forecastScene.js +3 -4
  115. package/es/src/charts/Plot/index.js +19 -17
  116. package/es/src/charts/Plot/labelPlacement.js +1 -1
  117. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  118. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  119. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  120. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  121. package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
  122. package/es/src/charts/Plot/pipeline.js +66 -19
  123. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  124. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  125. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  126. package/es/src/charts/Plot/pipelineScales.js +40 -8
  127. package/es/src/charts/Plot/plotFacet.js +12 -1
  128. package/es/src/charts/Plot/plotInit.js +40 -5
  129. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  130. package/es/src/charts/Plot/referenceDomains.js +133 -0
  131. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  132. package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
  133. package/es/src/charts/Plot/sharedHover.js +2 -1
  134. package/es/src/charts/Plot/sharedTooltip.js +13 -3
  135. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  136. package/es/src/charts/Plot/trendLabels.js +183 -0
  137. package/es/src/charts/Plot/trendLines.js +1 -0
  138. package/es/src/charts/Plot/trendScene.js +6 -3
  139. package/es/src/charts/Plot/trendTooltip.js +5 -1
  140. package/es/src/charts/PolarArea/index.js +4 -3
  141. package/es/src/charts/Priestley/applyLayout.js +21 -23
  142. package/es/src/charts/Priestley/index.js +4 -37
  143. package/es/src/charts/Priestley/timeAxis.js +103 -0
  144. package/es/src/charts/Pyramid/gutter.js +52 -16
  145. package/es/src/charts/Pyramid/index.js +55 -7
  146. package/es/src/charts/Pyramid/scene.js +4 -4
  147. package/es/src/charts/Radar/applyLayout.js +31 -33
  148. package/es/src/charts/Radar/axisDecorations.js +62 -13
  149. package/es/src/charts/Radar/curvedLabels.js +228 -0
  150. package/es/src/charts/Radar/emit.js +30 -15
  151. package/es/src/charts/Radar/index.js +43 -5
  152. package/es/src/charts/Radar/points.js +85 -0
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +9 -1
  155. package/es/src/charts/RadialBar/index.js +26 -9
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
  158. package/es/src/charts/RadialMatrix/index.js +18 -9
  159. package/es/src/charts/Rings/applyLayout.js +39 -161
  160. package/es/src/charts/Rings/emit.js +219 -63
  161. package/es/src/charts/Rings/index.js +88 -32
  162. package/es/src/charts/Rings/ringsCurves.js +156 -0
  163. package/es/src/charts/Rings/ringsGraph.js +28 -9
  164. package/es/src/charts/Rings/ringsLoops.js +73 -0
  165. package/es/src/charts/Rings/ringsParallel.js +183 -0
  166. package/es/src/charts/Rings/ringsPlacement.js +152 -0
  167. package/es/src/charts/Rings/ringsSizing.js +61 -38
  168. package/es/src/charts/Sankey/applyLayout.js +130 -39
  169. package/es/src/charts/Sankey/circularLayout.js +208 -0
  170. package/es/src/charts/Sankey/circularLinks.js +301 -0
  171. package/es/src/charts/Sankey/emit.js +164 -94
  172. package/es/src/charts/Sankey/index.js +78 -75
  173. package/es/src/charts/Sankey/labels.js +80 -0
  174. package/es/src/charts/Sankey/ribbons.js +88 -0
  175. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  176. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  177. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  178. package/es/src/charts/Scatter/index.js +25 -0
  179. package/es/src/charts/SlopeChart/index.js +116 -0
  180. package/es/src/charts/SlopeChart/slope.js +95 -0
  181. package/es/src/charts/Streamgraph/index.js +51 -0
  182. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  183. package/es/src/charts/Sunburst/emit.js +83 -64
  184. package/es/src/charts/Sunburst/index.js +16 -4
  185. package/es/src/charts/Tree/applyLayout.js +44 -14
  186. package/es/src/charts/Tree/emit.js +5 -5
  187. package/es/src/charts/Tree/index.js +12 -18
  188. package/es/src/charts/Tree/keys.js +33 -0
  189. package/es/src/charts/Tree/nodeLabel.js +15 -0
  190. package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
  191. package/es/src/charts/Treemap/index.js +2 -5
  192. package/es/src/charts/Violin/inner.js +3 -5
  193. package/es/src/charts/definition/makeChart.js +14 -2
  194. package/es/src/charts/drawSteps/backControl.js +17 -5
  195. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  196. package/es/src/charts/drawSteps/minimap.js +10 -25
  197. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  198. package/es/src/charts/drawSteps/searchControls.js +2 -1
  199. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  200. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  201. package/es/src/charts/drawSteps/zoomActions.js +36 -0
  202. package/es/src/charts/drawSteps/zoomControls.js +52 -23
  203. package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
  204. package/es/src/charts/drawSteps/zoomDrag.js +188 -0
  205. package/es/src/charts/drawSteps/zoomFit.js +69 -0
  206. package/es/src/charts/events/click.legend.js +11 -4
  207. package/es/src/charts/events/click.shape.js +13 -4
  208. package/es/src/charts/events/mouseenter.js +6 -16
  209. package/es/src/charts/events/mouseleave.js +9 -2
  210. package/es/src/charts/events/mousemove.legend.js +28 -32
  211. package/es/src/charts/events/mousemove.shape.js +45 -42
  212. package/es/src/charts/facet/drawFacets.js +14 -5
  213. package/es/src/charts/features/annotationFrame.js +179 -0
  214. package/es/src/charts/features/annotationText.js +83 -0
  215. package/es/src/charts/features/annotationTypes.js +10 -0
  216. package/es/src/charts/features/attributionFeature.js +6 -11
  217. package/es/src/charts/features/axes.js +17 -5
  218. package/es/src/charts/features/axesFinal.js +10 -3
  219. package/es/src/charts/features/axesMeasure.js +33 -12
  220. package/es/src/charts/features/axisTooltip.js +138 -0
  221. package/es/src/charts/features/calloutLayout.js +121 -0
  222. package/es/src/charts/features/calloutScene.js +155 -0
  223. package/es/src/charts/features/centerLabel.js +177 -0
  224. package/es/src/charts/features/chartGeometry.js +1 -1
  225. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  226. package/es/src/charts/features/circleLabels.js +207 -0
  227. package/es/src/charts/features/colorScaleBivariate.js +83 -0
  228. package/es/src/charts/features/colorScaleBucket.js +20 -1
  229. package/es/src/charts/features/colorScaleHover.js +33 -7
  230. package/es/src/charts/features/colorScaleLimit.js +73 -0
  231. package/es/src/charts/features/colorScaleTooltip.js +77 -0
  232. package/es/src/charts/features/colorScaleTop.js +61 -0
  233. package/es/src/charts/features/colorScaleValue.js +97 -0
  234. package/es/src/charts/features/curvedArrows.js +191 -0
  235. package/es/src/charts/features/depthKey.js +26 -0
  236. package/es/src/charts/features/edgeArrows.js +220 -5
  237. package/es/src/charts/features/edgeBundling.js +442 -0
  238. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  239. package/es/src/charts/features/ensureZoomDom.js +32 -8
  240. package/es/src/charts/features/features.js +32 -14
  241. package/es/src/charts/features/featuresColorScale.js +75 -20
  242. package/es/src/charts/features/featuresLegend.js +15 -24
  243. package/es/src/charts/features/hoverTicks.js +41 -0
  244. package/es/src/charts/features/idleQueue.js +72 -0
  245. package/es/src/charts/features/legendKeys.js +64 -0
  246. package/es/src/charts/features/lineLabels.js +55 -46
  247. package/es/src/charts/features/linkBundle.js +19 -0
  248. package/es/src/charts/features/linkColor.js +72 -0
  249. package/es/src/charts/features/linkFields.js +86 -0
  250. package/es/src/charts/features/linkFocus.js +118 -0
  251. package/es/src/charts/features/linkInteraction.js +364 -0
  252. package/es/src/charts/features/linkKeys.js +20 -0
  253. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  254. package/es/src/charts/features/linkLabelPath.js +162 -0
  255. package/es/src/charts/features/linkLabels.js +340 -0
  256. package/es/src/charts/features/linkWidths.js +32 -0
  257. package/es/src/charts/features/networkMeasures.js +241 -0
  258. package/es/src/charts/features/nodeStats.js +309 -0
  259. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  260. package/es/src/charts/features/pathLabels.js +50 -0
  261. package/es/src/charts/features/plotAnnotations.js +68 -17
  262. package/es/src/charts/features/plotEndLabels.js +28 -7
  263. package/es/src/charts/features/plotPaint.js +46 -12
  264. package/es/src/charts/features/polyline.js +129 -0
  265. package/es/src/charts/features/referenceAnnotations.js +403 -0
  266. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  267. package/es/src/charts/features/ringLabelNodes.js +93 -0
  268. package/es/src/charts/features/ringLabels.js +222 -0
  269. package/es/src/charts/features/sceneBounds.js +26 -6
  270. package/es/src/charts/features/selfLoops.js +306 -0
  271. package/es/src/charts/features/shapeEmit.js +54 -32
  272. package/es/src/charts/features/sharedFields.js +15 -2
  273. package/es/src/charts/features/textHalo.js +30 -0
  274. package/es/src/charts/index.js +8 -0
  275. package/es/src/charts/partition/chartFields.js +14 -5
  276. package/es/src/charts/partition/interaction.js +19 -10
  277. package/es/src/charts/partition/zoom.js +7 -6
  278. package/es/src/charts/pipeline/insetPlacement.js +22 -9
  279. package/es/src/charts/pipeline/preDrawData.js +46 -3
  280. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  281. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  282. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  283. package/es/src/charts/polar/chrome.js +81 -9
  284. package/es/src/charts/polar/config.js +6 -3
  285. package/es/src/charts/polar/wedgeLayout.js +2 -1
  286. package/es/src/charts/viz/Viz.js +61 -49
  287. package/es/src/charts/viz/VizBase.js +57 -14
  288. package/es/src/charts/viz/backgroundInk.js +23 -7
  289. package/es/src/charts/viz/emphasis.js +14 -0
  290. package/es/src/charts/viz/fillStroke.js +10 -0
  291. package/es/src/charts/viz/focusRing.js +104 -0
  292. package/es/src/charts/viz/focusTargets.js +208 -0
  293. package/es/src/charts/viz/history.js +74 -0
  294. package/es/src/charts/viz/interactionOpacity.js +115 -32
  295. package/es/src/charts/viz/keyboardNav.js +297 -0
  296. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  297. package/es/src/charts/viz/loaderFormat.js +114 -0
  298. package/es/src/charts/viz/missingFields.js +2 -1
  299. package/es/src/charts/viz/mountTarget.js +9 -0
  300. package/es/src/charts/viz/nearestHover.js +183 -0
  301. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  302. package/es/src/charts/viz/ordinalColor.js +14 -12
  303. package/es/src/charts/viz/pageTheme.js +83 -0
  304. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  305. package/es/src/charts/viz/pointVoronoi.js +124 -0
  306. package/es/src/charts/viz/reducedMotion.js +27 -0
  307. package/es/src/charts/viz/reportDrawError.js +15 -0
  308. package/es/src/charts/viz/setCursor.js +29 -0
  309. package/es/src/charts/viz/tooltipEnabled.js +38 -0
  310. package/es/src/charts/viz/userClick.js +34 -0
  311. package/es/src/charts/viz/vizDataPolling.js +8 -4
  312. package/es/src/charts/viz/vizDefaults.js +28 -57
  313. package/es/src/charts/viz/vizFields.js +41 -1
  314. package/es/src/charts/viz/vizRender.js +76 -31
  315. package/es/src/charts/viz/vizTheme.js +96 -0
  316. package/es/src/charts/viz/vizVisibility.js +26 -2
  317. package/es/src/components/Axis/Axis.js +35 -2
  318. package/es/src/components/Axis/AxisBottom.js +1 -0
  319. package/es/src/components/Axis/AxisLeft.js +1 -0
  320. package/es/src/components/Axis/AxisRight.js +1 -0
  321. package/es/src/components/Axis/AxisTop.js +1 -0
  322. package/es/src/components/Axis/axisBreak.js +33 -8
  323. package/es/src/components/Axis/axisDefaults.js +16 -9
  324. package/es/src/components/Axis/axisLabelKinds.js +36 -0
  325. package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
  326. package/es/src/components/Axis/axisLabelRoom.js +37 -0
  327. package/es/src/components/Axis/axisLabelSize.js +171 -0
  328. package/es/src/components/Axis/axisLabelThinning.js +98 -4
  329. package/es/src/components/Axis/axisLayout.js +71 -46
  330. package/es/src/components/Axis/axisLayoutLabels.js +82 -140
  331. package/es/src/components/Axis/axisLayoutScale.js +16 -11
  332. package/es/src/components/Axis/axisLimit.js +27 -0
  333. package/es/src/components/Axis/axisMaxSize.js +39 -0
  334. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  335. package/es/src/components/Axis/axisRender.js +20 -8
  336. package/es/src/components/Axis/axisRounding.js +16 -1
  337. package/es/src/components/Axis/axisScene.js +11 -2
  338. package/es/src/components/Axis/axisTitle.js +53 -0
  339. package/es/src/components/Axis/axisTooltipTargets.js +128 -0
  340. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  341. package/es/src/components/Axis/rangeBreaks.js +201 -0
  342. package/es/src/components/Axis/timeValues.js +19 -4
  343. package/es/src/components/ColorScale/ColorScale.js +77 -27
  344. package/es/src/components/ColorScale/bivariateRender.js +353 -0
  345. package/es/src/components/ColorScale/bivariateScale.js +150 -0
  346. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  347. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  348. package/es/src/components/ColorScale/colorScaleRender.js +32 -2
  349. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  350. package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
  351. package/es/src/components/Legend/Legend.js +13 -2
  352. package/es/src/components/Legend/legendConfig.js +2 -6
  353. package/es/src/components/Legend/legendCut.js +108 -0
  354. package/es/src/components/Legend/legendRender.js +38 -13
  355. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  356. package/es/src/components/TextBox.js +34 -67
  357. package/es/src/components/Timeline/Timeline.js +12 -3
  358. package/es/src/components/Timeline/timelineConfig.js +20 -10
  359. package/es/src/components/Timeline/timelineMode.js +26 -0
  360. package/es/src/components/Timeline/timelineRender.js +9 -4
  361. package/es/src/components/Tooltip.js +15 -5
  362. package/es/src/components/fontStack.js +20 -0
  363. package/es/src/components/textBoxLayout.js +58 -21
  364. package/es/src/components/textBoxPath.js +73 -0
  365. package/es/src/components/textBoxScene.js +226 -0
  366. package/es/src/components/textBoxWords.js +70 -0
  367. package/es/src/components/textEllipsis.js +7 -0
  368. package/es/src/components/tooltipDom.js +8 -5
  369. package/es/src/fluent.js +48 -0
  370. package/es/src/shapes/Area.js +1 -0
  371. package/es/src/shapes/Bar.js +1 -0
  372. package/es/src/shapes/Box.js +1 -0
  373. package/es/src/shapes/Circle.js +1 -0
  374. package/es/src/shapes/Line.js +1 -0
  375. package/es/src/shapes/Path.js +1 -0
  376. package/es/src/shapes/Rect.js +1 -0
  377. package/es/src/shapes/Shape.js +1 -0
  378. package/es/src/shapes/Whisker.js +1 -0
  379. package/es/src/utils/BaseClass.js +30 -12
  380. package/es/src/utils/configPrep.js +2 -1
  381. package/es/src/utils/configValue.js +9 -0
  382. package/es/src/utils/constant.js +13 -1
  383. package/es/src/utils/displayName.js +12 -0
  384. package/es/src/utils/theme.js +190 -0
  385. package/es/src/utils/themeInk.js +68 -0
  386. package/package.json +14 -11
  387. package/types/index.d.ts +6 -2
  388. package/types/internal.d.ts +268 -9
  389. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  390. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  391. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  392. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  393. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  394. package/types/src/charts/Alluvial/index.d.ts +27 -0
  395. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  396. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  397. package/types/src/charts/Alluvial/titles.d.ts +46 -0
  398. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  399. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  400. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  401. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  402. package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
  403. package/types/src/charts/ArcDiagram/events.d.ts +29 -0
  404. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  405. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  406. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  407. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  408. package/types/src/charts/Chord/labels.d.ts +66 -0
  409. package/types/src/charts/Donut/index.d.ts +2 -1
  410. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  411. package/types/src/charts/Gantt/emit.d.ts +17 -0
  412. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  413. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  414. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  415. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  416. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  417. package/types/src/charts/Gantt/index.d.ts +36 -0
  418. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  419. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  420. package/types/src/charts/Geomap/emit.d.ts +2 -2
  421. package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
  422. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  423. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  424. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  425. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  426. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  427. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  428. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  429. package/types/src/charts/Geomap/index.d.ts +3 -0
  430. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  431. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  432. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  433. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  434. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  435. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  436. package/types/src/charts/Hexbin/index.d.ts +25 -0
  437. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  438. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  439. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  440. package/types/src/charts/Histogram/binData.d.ts +20 -1
  441. package/types/src/charts/Histogram/index.d.ts +3 -2
  442. package/types/src/charts/Histogram/labels.d.ts +7 -0
  443. package/types/src/charts/Marimekko/index.d.ts +2 -1
  444. package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
  445. package/types/src/charts/Network/applyLayout.d.ts +11 -0
  446. package/types/src/charts/Network/bundle.d.ts +69 -0
  447. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  448. package/types/src/charts/Network/clusters.d.ts +115 -0
  449. package/types/src/charts/Network/graph.d.ts +73 -0
  450. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  451. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  452. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  453. package/types/src/charts/Pack/applyLayout.d.ts +2 -0
  454. package/types/src/charts/Pack/groupRows.d.ts +46 -0
  455. package/types/src/charts/Pack/index.d.ts +3 -0
  456. package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
  457. package/types/src/charts/Pack/nodeNames.d.ts +23 -0
  458. package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
  459. package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
  460. package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
  461. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  462. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  463. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  464. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  465. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  466. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  467. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  468. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  469. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  470. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  471. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  472. package/types/src/charts/Plot/areaEnter.d.ts +34 -0
  473. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  474. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  475. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  476. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  477. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  478. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  479. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  480. package/types/src/charts/Plot/index.d.ts +16 -15
  481. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  482. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  483. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  484. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  485. package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
  486. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  487. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  488. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  489. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  490. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  491. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  492. package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
  493. package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
  494. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  495. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  496. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  497. package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
  498. package/types/src/charts/Pyramid/gutter.d.ts +28 -6
  499. package/types/src/charts/Pyramid/scene.d.ts +1 -1
  500. package/types/src/charts/Radar/applyLayout.d.ts +2 -3
  501. package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
  502. package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
  503. package/types/src/charts/Radar/emit.d.ts +5 -2
  504. package/types/src/charts/Radar/index.d.ts +7 -2
  505. package/types/src/charts/Radar/points.d.ts +50 -0
  506. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  507. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  508. package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
  509. package/types/src/charts/Rings/emit.d.ts +72 -0
  510. package/types/src/charts/Rings/index.d.ts +4 -2
  511. package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
  512. package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
  513. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  514. package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
  515. package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
  516. package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
  517. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  518. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  519. package/types/src/charts/Sankey/emit.d.ts +58 -0
  520. package/types/src/charts/Sankey/labels.d.ts +19 -0
  521. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  522. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  523. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  524. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  525. package/types/src/charts/Scatter/index.d.ts +15 -0
  526. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  527. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  528. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  529. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  530. package/types/src/charts/Tree/applyLayout.d.ts +20 -0
  531. package/types/src/charts/Tree/keys.d.ts +25 -0
  532. package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
  533. package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
  534. package/types/src/charts/definition/makeChart.d.ts +3 -2
  535. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  536. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  537. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  538. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  539. package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
  540. package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
  541. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
  542. package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
  543. package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
  544. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  545. package/types/src/charts/events/click.legend.d.ts +2 -1
  546. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  547. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  548. package/types/src/charts/features/annotationText.d.ts +57 -0
  549. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  550. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  551. package/types/src/charts/features/axisTooltip.d.ts +49 -0
  552. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  553. package/types/src/charts/features/calloutScene.d.ts +40 -0
  554. package/types/src/charts/features/centerLabel.d.ts +75 -0
  555. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  556. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  557. package/types/src/charts/features/circleLabels.d.ts +130 -0
  558. package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
  559. package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
  560. package/types/src/charts/features/colorScaleHover.d.ts +13 -3
  561. package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
  562. package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
  563. package/types/src/charts/features/colorScaleTop.d.ts +30 -0
  564. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  565. package/types/src/charts/features/curvedArrows.d.ts +119 -0
  566. package/types/src/charts/features/depthKey.d.ts +19 -0
  567. package/types/src/charts/features/edgeArrows.d.ts +103 -4
  568. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  569. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  570. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  571. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  572. package/types/src/charts/features/hoverTicks.d.ts +30 -0
  573. package/types/src/charts/features/idleQueue.d.ts +46 -0
  574. package/types/src/charts/features/legendKeys.d.ts +34 -0
  575. package/types/src/charts/features/lineLabels.d.ts +15 -12
  576. package/types/src/charts/features/linkBundle.d.ts +16 -0
  577. package/types/src/charts/features/linkColor.d.ts +48 -0
  578. package/types/src/charts/features/linkFields.d.ts +16 -0
  579. package/types/src/charts/features/linkFocus.d.ts +51 -0
  580. package/types/src/charts/features/linkInteraction.d.ts +192 -0
  581. package/types/src/charts/features/linkKeys.d.ts +11 -0
  582. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  583. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  584. package/types/src/charts/features/linkLabels.d.ts +77 -0
  585. package/types/src/charts/features/linkWidths.d.ts +19 -0
  586. package/types/src/charts/features/networkMeasures.d.ts +53 -0
  587. package/types/src/charts/features/nodeStats.d.ts +93 -0
  588. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  589. package/types/src/charts/features/pathLabels.d.ts +41 -0
  590. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  591. package/types/src/charts/features/plotEndLabels.d.ts +14 -1
  592. package/types/src/charts/features/plotPaint.d.ts +17 -0
  593. package/types/src/charts/features/polyline.d.ts +32 -0
  594. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  595. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  596. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  597. package/types/src/charts/features/ringLabels.d.ts +164 -0
  598. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  599. package/types/src/charts/features/selfLoops.d.ts +165 -0
  600. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  601. package/types/src/charts/features/sharedFields.d.ts +11 -2
  602. package/types/src/charts/features/textHalo.d.ts +15 -0
  603. package/types/src/charts/index.d.ts +8 -0
  604. package/types/src/charts/partition/chartFields.d.ts +6 -1
  605. package/types/src/charts/partition/interaction.d.ts +6 -3
  606. package/types/src/charts/partition/zoom.d.ts +4 -4
  607. package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
  608. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  609. package/types/src/charts/pipeline/stages.d.ts +7 -0
  610. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  611. package/types/src/charts/polar/chrome.d.ts +19 -6
  612. package/types/src/charts/viz/Viz.d.ts +25 -4
  613. package/types/src/charts/viz/VizBase.d.ts +37 -8
  614. package/types/src/charts/viz/backgroundInk.d.ts +19 -4
  615. package/types/src/charts/viz/emphasis.d.ts +17 -0
  616. package/types/src/charts/viz/fillStroke.d.ts +7 -0
  617. package/types/src/charts/viz/focusRing.d.ts +25 -0
  618. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  619. package/types/src/charts/viz/history.d.ts +35 -0
  620. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  621. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  622. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  623. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  624. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  625. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  626. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  627. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  628. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  629. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  630. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  631. package/types/src/charts/viz/reportDrawError.d.ts +12 -0
  632. package/types/src/charts/viz/setCursor.d.ts +26 -0
  633. package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
  634. package/types/src/charts/viz/userClick.d.ts +35 -0
  635. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  636. package/types/src/charts/viz/vizFields.d.ts +37 -0
  637. package/types/src/charts/viz/vizRender.d.ts +2 -1
  638. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  639. package/types/src/charts/viz/vizTypes.d.ts +100 -7
  640. package/types/src/charts/viz/vizVisibility.d.ts +13 -0
  641. package/types/src/components/Axis/Axis.d.ts +34 -3
  642. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  643. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  644. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  645. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  646. package/types/src/components/Axis/axisBreak.d.ts +21 -3
  647. package/types/src/components/Axis/axisDefaults.d.ts +12 -0
  648. package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
  649. package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
  650. package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
  651. package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
  652. package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
  653. package/types/src/components/Axis/axisLayout.d.ts +9 -2
  654. package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
  655. package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
  656. package/types/src/components/Axis/axisLimit.d.ts +18 -0
  657. package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
  658. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  659. package/types/src/components/Axis/axisRounding.d.ts +8 -0
  660. package/types/src/components/Axis/axisTitle.d.ts +30 -0
  661. package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
  662. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  663. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  664. package/types/src/components/Axis/timeValues.d.ts +1 -1
  665. package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
  666. package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
  667. package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
  668. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  669. package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
  670. package/types/src/components/Legend/Legend.d.ts +6 -0
  671. package/types/src/components/Legend/legendCut.d.ts +31 -0
  672. package/types/src/components/Legend/legendRender.d.ts +6 -1
  673. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  674. package/types/src/components/TextBox.d.ts +5 -0
  675. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  676. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  677. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  678. package/types/src/components/Tooltip.d.ts +4 -3
  679. package/types/src/components/fontStack.d.ts +10 -0
  680. package/types/src/components/textBoxLayout.d.ts +18 -9
  681. package/types/src/components/textBoxPath.d.ts +59 -0
  682. package/types/src/components/textBoxScene.d.ts +51 -0
  683. package/types/src/components/textBoxWords.d.ts +33 -0
  684. package/types/src/components/textEllipsis.d.ts +6 -0
  685. package/types/src/fluent.d.ts +18 -0
  686. package/types/src/shapes/Area.d.ts +1 -0
  687. package/types/src/shapes/Bar.d.ts +1 -0
  688. package/types/src/shapes/Box.d.ts +1 -0
  689. package/types/src/shapes/Circle.d.ts +1 -0
  690. package/types/src/shapes/Line.d.ts +1 -0
  691. package/types/src/shapes/Path.d.ts +1 -0
  692. package/types/src/shapes/Rect.d.ts +1 -0
  693. package/types/src/shapes/Shape.d.ts +1 -0
  694. package/types/src/shapes/Whisker.d.ts +1 -0
  695. package/types/src/shapes/emitLabels.d.ts +1 -1
  696. package/types/src/utils/BaseClass.d.ts +9 -0
  697. package/types/src/utils/D3plusConfig.d.ts +1093 -266
  698. package/types/src/utils/configPrep.d.ts +2 -0
  699. package/types/src/utils/configValue.d.ts +8 -0
  700. package/types/src/utils/constant.d.ts +8 -0
  701. package/types/src/utils/displayName.d.ts +10 -0
  702. package/types/src/utils/index.d.ts +1 -1
  703. package/types/src/utils/theme.d.ts +170 -0
  704. package/types/src/utils/themeInk.d.ts +56 -0
  705. package/types/umd-entry.d.ts +4 -0
  706. package/umd/d3plus-core.full.js +72239 -41465
  707. package/umd/d3plus-core.full.min.js +2 -2
  708. package/umd/d3plus-core.js +46249 -19519
  709. package/umd/d3plus-core.min.js +2 -2
  710. package/es/src/components/Axis/gridStroke.js +0 -10
  711. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -0,0 +1,177 @@
1
+ /**
2
+ The text a ring chart (Pie with a hole, Donut, Sunburst, RadialBar) draws
3
+ in its empty middle when `centerLabel` is set: the chart's total, a
4
+ string, or what a function returns, wrapped and shrunk to fit the largest
5
+ box in the hole (see `centerLabelBoxes`). It is chrome: it carries no
6
+ datum, takes no pointer events, and draws nothing when it can't fit whole.
7
+ */ import { formatAbbreviate } from "@d3plus/format";
8
+ import constant from "../../utils/constant.js";
9
+ import { emitLabels } from "../../shapes/emitLabels.js";
10
+ import { isFullTurn } from "../Pie/arcFit.js";
11
+ import { largestSectorBox, sectorEdges } from "../Pie/sectorBox.js";
12
+ import { centerLabelLines } from "../Pie/straightLayout.js";
13
+ import { backgroundInk } from "../viz/backgroundInk.js";
14
+ /** The scene key of the center label's group. */ export const CENTER_LABEL_KEY = "center-label";
15
+ /** The width/height ratios tried for a partial sweep's hole. */ const SECTOR_ASPECTS = [
16
+ 1,
17
+ 2,
18
+ 3
19
+ ];
20
+ /**
21
+ The `centerLabelConfig` defaults: the chart's text color, sized between
22
+ 10 and 40 pixels, 5 pixels clear of the ring.
23
+ @param viz The chart.
24
+ */ export function centerLabelDefaults(viz) {
25
+ return {
26
+ fontColor: ()=>backgroundInk(viz),
27
+ fontMax: 40,
28
+ fontMin: 10,
29
+ padding: 5
30
+ };
31
+ }
32
+ /**
33
+ The sum of `value` over `data`, leaving out values that aren't numbers.
34
+ @param data The drawn rows.
35
+ @param value The chart's value accessor.
36
+ */ export function centerLabelTotal(data, value) {
37
+ return data.reduce((sum, d, i)=>{
38
+ const v = Number(value(d, i));
39
+ return Number.isFinite(v) ? sum + v : sum;
40
+ }, 0);
41
+ }
42
+ /**
43
+ The text a `centerLabel` setting draws: the total, formatted the way the
44
+ chart's tooltips format values, for `true`; the string itself; or a
45
+ function's return value. Empty for a falsy setting or return value.
46
+ @param setting The `centerLabel` setting.
47
+ @param data The drawn rows.
48
+ @param total Their total.
49
+ @param locale The chart's locale.
50
+ */ export function centerLabelText(setting, data, total, locale) {
51
+ if (!setting) return "";
52
+ if (typeof setting === "function") {
53
+ const out = setting(data, total);
54
+ return out || out === 0 ? String(out) : "";
55
+ }
56
+ if (typeof setting === "string") return setting;
57
+ return formatAbbreviate(total, locale);
58
+ }
59
+ /**
60
+ The boxes the text may fill in a hole: the whole circle (its text wrapped
61
+ to the circle) for a full turn, or, for a partial sweep, the largest box
62
+ of each of a few shapes that fits in the slice of the circle it spans.
63
+ Empty when the hole has no room.
64
+ @param hole The hole.
65
+ */ export function centerLabelBoxes(hole) {
66
+ const r = hole.radius;
67
+ if (!(r > 0)) return [];
68
+ const { startAngle, endAngle } = hole;
69
+ if (startAngle === undefined || endAngle === undefined || isFullTurn(startAngle, endAngle)) return [
70
+ {
71
+ x: -r,
72
+ y: -r,
73
+ width: r * 2,
74
+ height: r * 2,
75
+ shape: "circle"
76
+ }
77
+ ];
78
+ const edges = sectorEdges({
79
+ innerRadius: 0,
80
+ outerRadius: r,
81
+ startAngle,
82
+ endAngle
83
+ });
84
+ if (!edges) return [];
85
+ return SECTOR_ASPECTS.flatMap((aspect)=>{
86
+ const box = largestSectorBox(edges, (s)=>[
87
+ s * aspect,
88
+ s
89
+ ]);
90
+ return box ? [
91
+ {
92
+ ...box,
93
+ shape: "square"
94
+ }
95
+ ] : [];
96
+ });
97
+ }
98
+ /**
99
+ The TextBox config the label is drawn with: the user's `centerLabelConfig`
100
+ over the centered defaults. A `fontSize` without `fontResize` fixes the
101
+ size; otherwise the text shrinks from `fontMax` to fit.
102
+ @param config The `centerLabelConfig`.
103
+ */ export function centerLabelStyle(config) {
104
+ const fontResize = config.fontResize ?? config.fontSize === undefined;
105
+ return {
106
+ textAnchor: "middle",
107
+ verticalAlign: "middle",
108
+ ...config,
109
+ fontResize,
110
+ pointerEvents: "none"
111
+ };
112
+ }
113
+ /** The label's text nodes in one box, or null when the text doesn't fit whole. */ function fitIn(text, box, style) {
114
+ const nodes = emitLabels({
115
+ data: [
116
+ {
117
+ text
118
+ }
119
+ ],
120
+ label: ()=>text,
121
+ x: ()=>0,
122
+ y: ()=>0,
123
+ aes: ()=>({}),
124
+ rotate: constant(0),
125
+ id: ()=>CENTER_LABEL_KEY,
126
+ labelBounds: ()=>({
127
+ ...box
128
+ }),
129
+ labelConfig: style
130
+ }).filter((n)=>n.type === "text");
131
+ if (!nodes.length || nodes.some((n)=>n.truncated)) return null;
132
+ return nodes;
133
+ }
134
+ /** The largest font size among text nodes. */ const fontSizeOf = (nodes)=>Math.max(...nodes.map((n)=>n.font?.size ?? 0));
135
+ /**
136
+ The center label's scene nodes: one inert group holding the text, at the
137
+ largest size that fits the hole whole, centered in it. Empty when
138
+ `centerLabel` is unset or the text fits nowhere.
139
+ @param viz The chart.
140
+ @param hole The chart's empty middle, around its origin.
141
+ @param value The chart's value accessor, summed for the total.
142
+ */ export function centerLabelNodes(viz, hole, value) {
143
+ const setting = viz.schema.centerLabel;
144
+ if (!setting) return [];
145
+ const boxes = centerLabelBoxes(hole);
146
+ if (!boxes.length) return [];
147
+ const data = viz._filteredData ?? [];
148
+ const text = centerLabelText(setting, data, centerLabelTotal(data, value), viz.schema.locale);
149
+ if (!text) return [];
150
+ const config = viz.schema.centerLabelConfig ?? {};
151
+ const style = centerLabelStyle(config);
152
+ let best = null;
153
+ for (const box of boxes){
154
+ const nodes = fitIn(text, box, style);
155
+ if (nodes && (!best || fontSizeOf(nodes) > fontSizeOf(best.nodes))) best = {
156
+ nodes,
157
+ box
158
+ };
159
+ }
160
+ if (!best) return [];
161
+ // The text is chrome: no datum for hover to match or a tooltip to show.
162
+ const children = best.nodes.map((n)=>({
163
+ ...n,
164
+ datum: undefined,
165
+ index: undefined,
166
+ interactive: false
167
+ }));
168
+ if (style.verticalAlign === "middle") centerLabelLines(children, best.box.y + best.box.height / 2);
169
+ return [
170
+ {
171
+ type: "group",
172
+ key: CENTER_LABEL_KEY,
173
+ interactive: false,
174
+ children
175
+ }
176
+ ];
177
+ }
@@ -55,7 +55,7 @@
55
55
 
56
56
  Width and height are the margin-adjusted chart-area dimensions —
57
57
  callers usually have them on hand from `chartBounds(viz)` or from
58
- fields a stage stashed (e.g. `_pieWidth` / `_radialMatrixWidth`).
58
+ fields a stage stashed (e.g. `_radialMatrixWidth`).
59
59
  */ export function centerChartTransform(viz, width, height) {
60
60
  return {
61
61
  x: viz._margin.left + width / 2,
@@ -0,0 +1,297 @@
1
+ /**
2
+ Placement of circle labels: each label sits inside its circle when it fits
3
+ there at a readable size, otherwise beside the circle on the side with the
4
+ most open room (Moritz Stefaner's Voronoi labeling), otherwise nowhere.
5
+ Pure geometry: text is measured by the caller.
6
+
7
+ @module
8
+ */ import { pointVoronoi } from "../viz/pointVoronoi.js";
9
+ /** The sides in their default order, with each one's direction (y down). */ const SIDES = [
10
+ [
11
+ "right",
12
+ 1,
13
+ 0
14
+ ],
15
+ [
16
+ "left",
17
+ -1,
18
+ 0
19
+ ],
20
+ [
21
+ "top",
22
+ 0,
23
+ -1
24
+ ],
25
+ [
26
+ "bottom",
27
+ 0,
28
+ 1
29
+ ],
30
+ [
31
+ "top-right",
32
+ Math.SQRT1_2,
33
+ -Math.SQRT1_2
34
+ ],
35
+ [
36
+ "top-left",
37
+ -Math.SQRT1_2,
38
+ -Math.SQRT1_2
39
+ ],
40
+ [
41
+ "bottom-right",
42
+ Math.SQRT1_2,
43
+ Math.SQRT1_2
44
+ ],
45
+ [
46
+ "bottom-left",
47
+ -Math.SQRT1_2,
48
+ Math.SQRT1_2
49
+ ]
50
+ ];
51
+ /** Degrees added to a diagonal side's angle when ranking sides: straight sides read better. */ const DIAGONAL_PENALTY = 20;
52
+ /** Rounding slack for overlap and containment tests. */ const EPSILON = 1e-6;
53
+ /**
54
+ The box a `width` × `height` label takes on one side of a circle, `gap`
55
+ pixels clear of its edge: centered on the circle's axis for a straight
56
+ side, with its nearest corner on the circle's diagonal for a diagonal one.
57
+ */ export function sideBox(circle, side, width, height, gap = 0) {
58
+ const d = circle.r + gap;
59
+ const { x, y } = circle;
60
+ switch(side){
61
+ case "right":
62
+ return {
63
+ x: x + d,
64
+ y: y - height / 2,
65
+ width,
66
+ height
67
+ };
68
+ case "left":
69
+ return {
70
+ x: x - d - width,
71
+ y: y - height / 2,
72
+ width,
73
+ height
74
+ };
75
+ case "top":
76
+ return {
77
+ x: x - width / 2,
78
+ y: y - d - height,
79
+ width,
80
+ height
81
+ };
82
+ case "bottom":
83
+ return {
84
+ x: x - width / 2,
85
+ y: y + d,
86
+ width,
87
+ height
88
+ };
89
+ }
90
+ const o = d * Math.SQRT1_2;
91
+ const right = side.endsWith("right");
92
+ const top = side.startsWith("top");
93
+ return {
94
+ x: right ? x + o : x - o - width,
95
+ y: top ? y - o - height : y + o,
96
+ width,
97
+ height
98
+ };
99
+ }
100
+ /** The signed area of a ring (positive when its vertices run clockwise in y-down space). */ function ringArea(ring) {
101
+ let a = 0;
102
+ for(let i = 0, j = ring.length - 1; i < ring.length; j = i++)a += ring[j][0] * ring[i][1] - ring[i][0] * ring[j][1];
103
+ return a / 2;
104
+ }
105
+ /** A ring's centroid, or null when it has no area. */ export function ringCentroid(ring) {
106
+ const area = ringArea(ring);
107
+ if (Math.abs(area) < EPSILON) return null;
108
+ let cx = 0, cy = 0;
109
+ for(let i = 0, j = ring.length - 1; i < ring.length; j = i++){
110
+ const f = ring[j][0] * ring[i][1] - ring[i][0] * ring[j][1];
111
+ cx += (ring[j][0] + ring[i][0]) * f;
112
+ cy += (ring[j][1] + ring[i][1]) * f;
113
+ }
114
+ return [
115
+ cx / (6 * area),
116
+ cy / (6 * area)
117
+ ];
118
+ }
119
+ /**
120
+ The sides of a circle, most open first: ordered by how closely each
121
+ points toward the centroid of the circle's Voronoi cell (diagonals
122
+ slightly discounted), or in the default order (right, left, top, bottom,
123
+ then the diagonals) when the centroid is too close to the center to point
124
+ anywhere, which is the case for an evenly surrounded circle.
125
+ @param circle The circle.
126
+ @param cell Its Voronoi cell, or null.
127
+ */ export function sideOrder(circle, cell) {
128
+ const base = SIDES.map((s)=>s[0]);
129
+ const centroid = cell ? ringCentroid(cell) : null;
130
+ if (!centroid || !cell) return base;
131
+ const dx = centroid[0] - circle.x, dy = centroid[1] - circle.y;
132
+ const reach = Math.sqrt(Math.abs(ringArea(cell)));
133
+ if (Math.hypot(dx, dy) < reach * 0.1) return base;
134
+ const toward = Math.atan2(dy, dx);
135
+ const score = ([, sx, sy])=>{
136
+ let diff = Math.abs(Math.atan2(sy, sx) - toward);
137
+ if (diff > Math.PI) diff = 2 * Math.PI - diff;
138
+ const degrees = diff * 180 / Math.PI;
139
+ return degrees + (sx && sy ? DIAGONAL_PENALTY : 0);
140
+ };
141
+ return SIDES.map((s, i)=>({
142
+ side: s[0],
143
+ score: score(s),
144
+ i
145
+ })).sort((a, b)=>a.score - b.score || a.i - b.i).map((s)=>s.side);
146
+ }
147
+ /** Clips a ring to one half-plane of a box edge (Sutherland–Hodgman). */ function clipEdge(ring, inside, cross) {
148
+ const out = [];
149
+ for(let i = 0; i < ring.length; i++){
150
+ const cur = ring[i], prev = ring[(i + ring.length - 1) % ring.length];
151
+ if (inside(cur)) {
152
+ if (!inside(prev)) out.push(cross(prev, cur));
153
+ out.push(cur);
154
+ } else if (inside(prev)) out.push(cross(prev, cur));
155
+ }
156
+ return out;
157
+ }
158
+ /** Where the segment `a`–`b` crosses the vertical line at `x`. */ const atX = (a, b, x)=>[
159
+ x,
160
+ a[1] + (b[1] - a[1]) * (x - a[0]) / (b[0] - a[0])
161
+ ];
162
+ /** Where the segment `a`–`b` crosses the horizontal line at `y`. */ const atY = (a, b, y)=>[
163
+ a[0] + (b[0] - a[0]) * (y - a[1]) / (b[1] - a[1]),
164
+ y
165
+ ];
166
+ /** The share (0–1) of a box's area that lies inside a ring. */ export function boxCoverage(box, ring) {
167
+ const area = box.width * box.height;
168
+ if (!(area > 0) || ring.length < 3) return 0;
169
+ const x1 = box.x + box.width, y1 = box.y + box.height;
170
+ let r = clipEdge(ring, (p)=>p[0] >= box.x, (a, b)=>atX(a, b, box.x));
171
+ r = clipEdge(r, (p)=>p[0] <= x1, (a, b)=>atX(a, b, x1));
172
+ r = clipEdge(r, (p)=>p[1] >= box.y, (a, b)=>atY(a, b, box.y));
173
+ r = clipEdge(r, (p)=>p[1] <= y1, (a, b)=>atY(a, b, y1));
174
+ return r.length < 3 ? 0 : Math.min(1, Math.abs(ringArea(r)) / area);
175
+ }
176
+ /** Whether a box overlaps a circle's interior. */ export function boxHitsCircle(box, circle) {
177
+ const dx = Math.max(box.x - circle.x, 0, circle.x - (box.x + box.width));
178
+ const dy = Math.max(box.y - circle.y, 0, circle.y - (box.y + box.height));
179
+ return dx * dx + dy * dy < circle.r * circle.r - EPSILON;
180
+ }
181
+ /** Whether two boxes overlap (touching edges don't count). */ export function boxesOverlap(a, b) {
182
+ return a.x < b.x + b.width - EPSILON && b.x < a.x + a.width - EPSILON && a.y < b.y + b.height - EPSILON && b.y < a.y + a.height - EPSILON;
183
+ }
184
+ /** Whether a box lies inside the bounds. */ function inBounds(box, bounds) {
185
+ return box.x >= bounds.x - EPSILON && box.y >= bounds.y - EPSILON && box.x + box.width <= bounds.x + bounds.width + EPSILON && box.y + box.height <= bounds.y + bounds.height + EPSILON;
186
+ }
187
+ /** A uniform grid of buckets, so overlap tests only look at nearby items. */ class BoxGrid {
188
+ size;
189
+ cells = new Map();
190
+ constructor(size){
191
+ this.size = size;
192
+ }
193
+ keys(box) {
194
+ const s = this.size;
195
+ const out = [];
196
+ for(let i = Math.floor(box.x / s); i <= Math.floor((box.x + box.width) / s); i++)for(let j = Math.floor(box.y / s); j <= Math.floor((box.y + box.height) / s); j++)out.push(`${i},${j}`);
197
+ return out;
198
+ }
199
+ add(box, item) {
200
+ for (const k of this.keys(box)){
201
+ const list = this.cells.get(k);
202
+ if (list) list.push(item);
203
+ else this.cells.set(k, [
204
+ item
205
+ ]);
206
+ }
207
+ }
208
+ near(box) {
209
+ const out = new Set();
210
+ for (const k of this.keys(box))for (const item of this.cells.get(k) ?? [])out.add(item);
211
+ return out;
212
+ }
213
+ }
214
+ /** A circle's bounding box. */ const circleBox = (c)=>({
215
+ x: c.x - c.r,
216
+ y: c.y - c.r,
217
+ width: c.r * 2,
218
+ height: c.r * 2
219
+ });
220
+ /**
221
+ Places circle labels. A label in `"inside"` mode stays inside its circle;
222
+ in `"auto"` mode it stays inside when `fitsInside`, and otherwise (or in
223
+ `"outside"` mode) it takes the first side of its circle, most open first
224
+ (see `sideOrder`), where it lies mostly in the circle's Voronoi cell, stays
225
+ in `bounds`, and overlaps no circle and no label placed before it. A label
226
+ with no such side, or whose circle is centered outside `bounds`, is
227
+ hidden. Labels are placed largest circle first
228
+ (ties in input order), so big circles win the room; the result is in
229
+ input order and depends only on the input.
230
+ @param circles Every circle, labeled or not: each is an obstacle.
231
+ @param labels The labels to place.
232
+ @param bounds The box labels must stay in.
233
+ */ export function placeCircleLabels(circles, labels, bounds, options = {}) {
234
+ const gap = options.gap ?? 3;
235
+ const coverage = options.cellCoverage ?? 0.5;
236
+ const result = labels.map(()=>({
237
+ position: "hidden"
238
+ }));
239
+ const valid = (c)=>!!c && [
240
+ c.x,
241
+ c.y,
242
+ c.r
243
+ ].every(Number.isFinite);
244
+ const outside = [];
245
+ labels.forEach((label, i)=>{
246
+ if (!valid(circles[label.circle])) return;
247
+ if (label.position === "inside" || label.position !== "outside" && label.fitsInside) result[i] = {
248
+ position: "inside"
249
+ };
250
+ else if (label.width > 0 && label.height > 0) outside.push(i);
251
+ });
252
+ if (!outside.length) return result;
253
+ const voronoi = pointVoronoi(circles.map((c, i)=>({
254
+ x: c.x,
255
+ y: c.y,
256
+ r: c.r,
257
+ item: i
258
+ })), bounds);
259
+ const sizes = outside.map((i)=>Math.max(labels[i].width, labels[i].height));
260
+ const grid = new BoxGrid(Math.max(16, sizes.reduce((a, b)=>a + b, 0) / sizes.length));
261
+ circles.forEach((c, i)=>{
262
+ if (valid(c)) grid.add(circleBox(c), i);
263
+ });
264
+ const placed = new BoxGrid(grid.size);
265
+ outside.sort((a, b)=>circles[labels[b].circle].r - circles[labels[a].circle].r || a - b);
266
+ for (const i of outside){
267
+ const label = labels[i];
268
+ const circle = circles[label.circle];
269
+ const cell = voronoi.cell(label.circle);
270
+ // A circle centered outside the bounds (scrolled off by a zoom) is cut
271
+ // off there, so a label beside it would name nothing in view.
272
+ if (!cell || !inBounds({
273
+ ...circle,
274
+ width: 0,
275
+ height: 0
276
+ }, bounds)) continue;
277
+ for (const side of sideOrder(circle, cell)){
278
+ const box = sideBox(circle, side, label.width, label.height, gap);
279
+ if (!inBounds(box, bounds)) continue;
280
+ if ([
281
+ ...grid.near(box)
282
+ ].some((c)=>boxHitsCircle(box, circles[c]))) continue;
283
+ if ([
284
+ ...placed.near(box)
285
+ ].some((b)=>boxesOverlap(box, b))) continue;
286
+ if (boxCoverage(box, cell) < coverage - EPSILON) continue;
287
+ result[i] = {
288
+ position: "outside",
289
+ side,
290
+ box
291
+ };
292
+ placed.add(box, box);
293
+ break;
294
+ }
295
+ }
296
+ return result;
297
+ }
@@ -0,0 +1,207 @@
1
+ /**
2
+ Circle labels on a chart: resolves each label's `labelPosition`, measures
3
+ its text, places it (see `circleLabelPlacement.ts`), and emits the labels
4
+ that sit beside their circles. Shared by Plot's point marks, Network's
5
+ nodes, and Geomap's coordinate points.
6
+
7
+ @module
8
+ */ import { fontExists, parseSides, rtl, textWidth } from "@d3plus/dom";
9
+ import { fontFamily as defaultFontFamily, textWrap } from "@d3plus/text";
10
+ import { emitLabels } from "../../shapes/emitLabels.js";
11
+ import constant from "../../utils/constant.js";
12
+ import { backgroundInk } from "../viz/backgroundInk.js";
13
+ import { placeCircleLabels } from "./circleLabelPlacement.js";
14
+ /** The resolved CSS font family, as TextBox renders it. */ const familyOf = (family)=>fontExists(family ?? defaultFontFamily);
15
+ /**
16
+ Whether `text` fits inside a box at `font.size`, wrapped the way a label
17
+ TextBox wraps it, without being cut short.
18
+ @param text The label text.
19
+ @param box The box, with its wrapping shape and padding.
20
+ @param font The font, at the smallest size that counts as fitting.
21
+ */ export function labelFitsInside(text, box, font) {
22
+ const pad = parseSides(box.padding ?? 0);
23
+ const width = box.width - pad.left - pad.right;
24
+ const height = box.height - pad.top - pad.bottom;
25
+ const lineHeight = font.lineHeight ?? font.size * 1.2;
26
+ if (!text || width <= font.size || height < lineHeight) return false;
27
+ const wrapped = textWrap().fontFamily(familyOf(font.family)).fontSize(font.size).fontWeight(font.weight ?? 400).lineHeight(lineHeight).shape(box.shape ?? "square").width(width).height(height)(text);
28
+ return !wrapped.truncated && wrapped.lines.some((l)=>l !== "");
29
+ }
30
+ /**
31
+ The box a one-line label takes: its measured width, plus a pixel of slack
32
+ on each side so the TextBox drawing it never wraps it, by a line's height
33
+ plus a pixel.
34
+ */ export function measureLabel(text, font) {
35
+ const width = textWidth(text, {
36
+ "font-family": familyOf(font.family),
37
+ "font-size": font.size,
38
+ "font-weight": font.weight ?? 400
39
+ });
40
+ const lineHeight = font.lineHeight ?? font.size * 1.2;
41
+ return {
42
+ width: Math.ceil(width) + 2,
43
+ height: Math.ceil(lineHeight) + 1
44
+ };
45
+ }
46
+ /** Reads `pointLabelConfig`: numbers for fontMin/fontSize/padding, the rest as TextBox config. */ export function pointLabelSettings(viz) {
47
+ const cfg = viz.schema.pointLabelConfig ?? {};
48
+ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fallback;
49
+ const { fontMin, fontSize, padding, ...text } = cfg;
50
+ return {
51
+ fontMin: num(fontMin, 10),
52
+ fontSize: num(fontSize, 11),
53
+ padding: num(padding, 3),
54
+ text
55
+ };
56
+ }
57
+ /** A row's `labelPosition`, with anything unrecognized read as `"auto"`. */ export function labelPositionOf(viz, d, i) {
58
+ const fn = viz.schema.labelPosition;
59
+ const value = typeof fn === "function" ? fn(d, i) : fn;
60
+ return value === "inside" || value === "outside" ? value : "auto";
61
+ }
62
+ /**
63
+ Places every labeled circle's label (see `placeCircleLabels`), reading
64
+ each row's `labelPosition` and the chart's `pointLabelConfig`. An
65
+ `"auto"` label counts as fitting inside when it fits at
66
+ `pointLabelConfig.fontMin`.
67
+ @param viz The chart.
68
+ @param items Every circle, labeled or not.
69
+ @param bounds The box labels must stay in, in the circles' space.
70
+ */ export function layoutCircleLabels(viz, items, bounds) {
71
+ const settings = pointLabelSettings(viz);
72
+ const font = outsideFont(settings);
73
+ const labeled = [];
74
+ items.forEach((item, at)=>{
75
+ const t = item.text;
76
+ if (typeof t === "string" && t.trim() || typeof t === "number") labeled.push({
77
+ item,
78
+ at,
79
+ text: `${t}`.trim()
80
+ });
81
+ });
82
+ const requests = labeled.map(({ item, at, text })=>{
83
+ const mode = labelPositionOf(viz, item.datum, item.index);
84
+ const inside = item.inside ?? {
85
+ width: item.r * 2,
86
+ height: item.r * 2
87
+ };
88
+ const fitsInside = mode === "auto" && labelFitsInside(text, inside, {
89
+ ...inside.font,
90
+ size: settings.fontMin
91
+ });
92
+ // Only a label that may go beside its circle needs measuring.
93
+ const size = mode === "inside" || fitsInside ? {
94
+ width: 0,
95
+ height: 0
96
+ } : measureLabel(text, resolveFont(font, item));
97
+ return {
98
+ circle: at,
99
+ ...size,
100
+ position: mode,
101
+ fitsInside
102
+ };
103
+ });
104
+ const placements = placeCircleLabels(items.map(({ x, y, r })=>({
105
+ x,
106
+ y,
107
+ r: Number.isFinite(r) ? r : 0
108
+ })), requests, bounds, {
109
+ gap: settings.padding
110
+ });
111
+ const out = new Map();
112
+ labeled.forEach(({ item, text }, j)=>out.set(item.key, {
113
+ ...placements[j],
114
+ mode: requests[j].position,
115
+ text
116
+ }));
117
+ return out;
118
+ }
119
+ /** The font a label beside its circle is drawn in, as accessors of the row. */ function outsideFont(settings) {
120
+ const { fontFamily, fontWeight } = settings.text;
121
+ return {
122
+ size: settings.fontSize,
123
+ family: fontFamily,
124
+ weight: fontWeight
125
+ };
126
+ }
127
+ /** Resolves the outside font's accessors for one row. */ function resolveFont(font, item) {
128
+ const at = (v)=>typeof v === "function" ? v(item.datum, item.index) : v;
129
+ return {
130
+ size: font.size,
131
+ family: at(font.family),
132
+ weight: at(font.weight)
133
+ };
134
+ }
135
+ /** The text anchor that keeps a label flush against its circle. */ export function sideAnchor(side) {
136
+ const anchor = side.endsWith("right") ? "start" : side.endsWith("left") ? "end" : "middle";
137
+ // Right to left, TextBox reads "start" as the box's right edge.
138
+ if (anchor !== "middle" && rtl()) return anchor === "start" ? "end" : "start";
139
+ return anchor;
140
+ }
141
+ /**
142
+ Text nodes for labels placed beside their circles: one line each, in the
143
+ chart's ink (`backgroundInk`) at `pointLabelConfig.fontSize`, flush
144
+ against the circle, and inert to the pointer.
145
+ @param viz The chart.
146
+ @param labels The labels, each with its placed box.
147
+ @param config TextBox config layered under `pointLabelConfig` (such as a
148
+ `fontOpacity` that follows the shapes).
149
+ */ export function emitOutsideLabels(viz, labels, config = {}) {
150
+ if (!labels.length) return [];
151
+ const settings = pointLabelSettings(viz);
152
+ const byId = new Map(labels.map((l)=>[
153
+ `${l.id}_0`,
154
+ l
155
+ ]));
156
+ const sideOf = (rec)=>byId.get(String(rec.id))?.side ?? "right";
157
+ const lineHeight = settings.fontSize * 1.2;
158
+ return emitLabels({
159
+ data: labels,
160
+ label: (d)=>d.text,
161
+ labelBounds: (d)=>({
162
+ ...d.box
163
+ }),
164
+ x: constant(0),
165
+ y: constant(0),
166
+ aes: constant({}),
167
+ rotate: constant(0),
168
+ id: (d)=>d.id,
169
+ datum: (d)=>d.datum,
170
+ labelConfig: {
171
+ fontColor: ()=>backgroundInk(viz),
172
+ ...config,
173
+ fontResize: false,
174
+ fontSize: settings.fontSize,
175
+ lineHeight,
176
+ padding: 0,
177
+ pointerEvents: "none",
178
+ textAnchor: (rec)=>sideAnchor(sideOf(rec)),
179
+ verticalAlign: "middle",
180
+ ...settings.text
181
+ }
182
+ });
183
+ }
184
+ /**
185
+ Splits laid-out labels into the ones drawn beside their circles, with the
186
+ id and scene datum each takes.
187
+ */ export function outsideLabels(layout, describe) {
188
+ const out = [];
189
+ for (const [key, placed] of layout){
190
+ if (placed.position !== "outside") continue;
191
+ out.push({
192
+ ...describe(key),
193
+ text: placed.text,
194
+ side: placed.side,
195
+ box: placed.box
196
+ });
197
+ }
198
+ return out;
199
+ }
200
+ /**
201
+ The font size floor of an inside label: `pointLabelConfig.fontMin` when it
202
+ was placed in `"auto"` mode (so it never shrinks below the size it was
203
+ judged to fit at), else its own.
204
+ */ export function insideFontMin(viz, placed, own) {
205
+ if (!placed || placed.mode !== "auto" || placed.position !== "inside") return own;
206
+ return Math.max(own, pointLabelSettings(viz).fontMin);
207
+ }