@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,129 @@
1
+ /**
2
+ Measuring and drawing polylines: a sampled curve, a map's projected
3
+ link, or a bundled edge, as a list of `[x, y]` points.
4
+ */ const round = (n)=>Math.round(n * 100) / 100;
5
+ /** A polyline as a path `d`. */ export function polylinePath(points) {
6
+ return points.map(([x, y], k)=>`${k ? "L" : "M"}${round(x)},${round(y)}`).join("");
7
+ }
8
+ /**
9
+ A polyline shortened along its length by `start` pixels at its first
10
+ end and `end` at its last. When the cuts meet, it collapses to the
11
+ point where they do.
12
+ */ export function trimPolyline(points, start, end) {
13
+ const length = polylineLength(points);
14
+ const s = Math.max(0, start);
15
+ const e = Math.max(0, end);
16
+ if (!s && !e) return points.slice();
17
+ if (s + e >= length) {
18
+ const at = polylineAt(points, length * s / (s + e || 1));
19
+ return [
20
+ [
21
+ at.x,
22
+ at.y
23
+ ],
24
+ [
25
+ at.x,
26
+ at.y
27
+ ]
28
+ ];
29
+ }
30
+ const out = [];
31
+ let walked = 0;
32
+ const first = polylineAt(points, s);
33
+ const last = polylineAt(points, length - e);
34
+ out.push([
35
+ first.x,
36
+ first.y
37
+ ]);
38
+ for(let k = 1; k < points.length - 1; k++){
39
+ walked += Math.hypot(points[k][0] - points[k - 1][0], points[k][1] - points[k - 1][1]);
40
+ if (walked > s && walked < length - e) out.push(points[k]);
41
+ }
42
+ out.push([
43
+ last.x,
44
+ last.y
45
+ ]);
46
+ return out;
47
+ }
48
+ /** A polyline's length. */ export function polylineLength(points) {
49
+ let length = 0;
50
+ for(let k = 1; k < points.length; k++)length += Math.hypot(points[k][0] - points[k - 1][0], points[k][1] - points[k - 1][1]);
51
+ return length;
52
+ }
53
+ /**
54
+ The point `distance` along a polyline from its start (clamped to its
55
+ ends), and the direction the polyline runs there, in radians.
56
+ */ export function polylineAt(points, distance) {
57
+ const last = points.length - 1;
58
+ let left = Math.max(0, distance);
59
+ for(let k = 1; k <= last; k++){
60
+ const [x0, y0] = points[k - 1];
61
+ const [x1, y1] = points[k];
62
+ const step = Math.hypot(x1 - x0, y1 - y0);
63
+ if (!step) continue;
64
+ const angle = Math.atan2(y1 - y0, x1 - x0);
65
+ if (left <= step || k === last) {
66
+ const t = Math.min(1, left / step);
67
+ return {
68
+ x: x0 + (x1 - x0) * t,
69
+ y: y0 + (y1 - y0) * t,
70
+ angle
71
+ };
72
+ }
73
+ left -= step;
74
+ }
75
+ const [x, y] = points[0] ?? [
76
+ 0,
77
+ 0
78
+ ];
79
+ return {
80
+ x,
81
+ y,
82
+ angle: 0
83
+ };
84
+ }
85
+ /** The middle of a polyline's length, and its direction there. */ export function polylineMidpoint(points) {
86
+ return polylineAt(points, polylineLength(points) / 2);
87
+ }
88
+ /** The box around a polyline, as `[[x0, y0], [x1, y1]]`. */ export function polylineBox(points) {
89
+ const xs = points.map((p)=>p[0]);
90
+ const ys = points.map((p)=>p[1]);
91
+ return [
92
+ [
93
+ Math.min(...xs),
94
+ Math.min(...ys)
95
+ ],
96
+ [
97
+ Math.max(...xs),
98
+ Math.max(...ys)
99
+ ]
100
+ ];
101
+ }
102
+ /**
103
+ How far along a polyline, from its first point, it first gets `radius`
104
+ pixels away from that point: where it leaves a circle of that radius
105
+ around its start. The polyline's whole length when it never does.
106
+ */ export function polylineReach(points, radius) {
107
+ if (!points.length || radius <= 0) return 0;
108
+ const [cx, cy] = points[0];
109
+ let walked = 0;
110
+ for(let k = 1; k < points.length; k++){
111
+ const [x0, y0] = points[k - 1];
112
+ const [x1, y1] = points[k];
113
+ const dx = x1 - x0;
114
+ const dy = y1 - y0;
115
+ const step = Math.hypot(dx, dy);
116
+ if (Math.hypot(x1 - cx, y1 - cy) >= radius && step) {
117
+ // Where the segment crosses the circle: |p0 + t·d − c| = radius.
118
+ const fx = x0 - cx;
119
+ const fy = y0 - cy;
120
+ const a = dx * dx + dy * dy;
121
+ const b = 2 * (fx * dx + fy * dy);
122
+ const c = fx * fx + fy * fy - radius * radius;
123
+ const t = (-b + Math.sqrt(Math.max(0, b * b - 4 * a * c))) / (2 * a);
124
+ return walked + Math.min(1, Math.max(0, t)) * step;
125
+ }
126
+ walked += step;
127
+ }
128
+ return walked;
129
+ }
@@ -0,0 +1,403 @@
1
+ /**
2
+ Reference lines and bands: `referenceLines`/`referenceBands` entries
3
+ expand into `"ReferenceLine"`/`"ReferenceBand"` annotations, drawn as a
4
+ line across the whole plot at one value, or a shaded span between two,
5
+ with an optional label. Both sit behind the data unless `layer: "front"`;
6
+ their labels draw above it, clear of the data labels (see
7
+ `placeReferenceLabels`).
8
+ */ import { parseDash } from "../../shapes/Shape.js";
9
+ import { axisPixel, axisSpan, clipSpan, isVertical } from "./annotationFrame.js";
10
+ import { annotationTextNode, annotationTextStyle, wrapAnnotationText } from "./annotationText.js";
11
+ import { LABEL_PAD as PAD, registerLabelSpots, slideSteps } from "./referenceLabelPlacement.js";
12
+ /** The annotation shape a `referenceLines` entry expands into. */ export const REFERENCE_LINE = "ReferenceLine";
13
+ /** The annotation shape a `referenceBands` entry expands into. */ export const REFERENCE_BAND = "ReferenceBand";
14
+ const AXES = [
15
+ "x",
16
+ "y",
17
+ "x2",
18
+ "y2"
19
+ ];
20
+ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fallback;
21
+ /** The entries of a `referenceLines`/`referenceBands` setting: a list, one entry, or nothing. */ function entries(setting) {
22
+ const list = Array.isArray(setting) ? setting : setting ? [
23
+ setting
24
+ ] : [];
25
+ return list.filter((d)=>!!d && typeof d === "object");
26
+ }
27
+ /**
28
+ Expands `referenceLines` into `"ReferenceLine"` annotations, in the back
29
+ layer unless an entry sets its own.
30
+ @param setting The `referenceLines` setting.
31
+ */ export function expandReferenceLines(setting) {
32
+ return entries(setting).map((d)=>({
33
+ layer: "back",
34
+ ...d,
35
+ shape: REFERENCE_LINE
36
+ }));
37
+ }
38
+ /**
39
+ Expands `referenceBands` into `"ReferenceBand"` annotations, in the back
40
+ layer unless an entry sets its own.
41
+ @param setting The `referenceBands` setting.
42
+ */ export function expandReferenceBands(setting) {
43
+ return entries(setting).map((d)=>({
44
+ layer: "back",
45
+ ...d,
46
+ shape: REFERENCE_BAND
47
+ }));
48
+ }
49
+ /**
50
+ The axis a reference entry is on: the first of `x`, `y`, `x2`, `y2` it
51
+ sets, or null.
52
+ @param entry The entry.
53
+ */ export function referenceAxis(entry) {
54
+ return AXES.find((a)=>entry[a] !== undefined && entry[a] !== null) ?? null;
55
+ }
56
+ /** The plot's pixel extent along an axis. */ const extent = (frame, axis)=>isVertical(axis) ? [
57
+ frame.plot.y0,
58
+ frame.plot.y1
59
+ ] : [
60
+ frame.plot.x0,
61
+ frame.plot.x1
62
+ ];
63
+ /**
64
+ Where a reference line runs: its axis, its pixel position `at` along that
65
+ axis, and its two end points across the plot (start first). Null when it
66
+ has no position or falls outside the plot area.
67
+ @param frame The plot area and its axes.
68
+ @param entry The reference line.
69
+ */ export function referenceLinePoints(frame, entry) {
70
+ const axis = referenceAxis(entry);
71
+ if (!axis) return null;
72
+ const at = axisPixel(frame, axis, entry[axis], entry.ref);
73
+ const [lo, hi] = extent(frame, axis);
74
+ if (!Number.isFinite(at) || at < lo - 0.5 || at > hi + 0.5) return null;
75
+ const { plot } = frame;
76
+ const points = isVertical(axis) ? [
77
+ [
78
+ plot.x0,
79
+ at
80
+ ],
81
+ [
82
+ plot.x1,
83
+ at
84
+ ]
85
+ ] : [
86
+ [
87
+ at,
88
+ plot.y1
89
+ ],
90
+ [
91
+ at,
92
+ plot.y0
93
+ ]
94
+ ];
95
+ return {
96
+ axis,
97
+ at,
98
+ points
99
+ };
100
+ }
101
+ /**
102
+ The rect a reference band shades, clipped to the plot area, and its
103
+ axis. Null when it has no position or lies wholly outside the plot.
104
+ @param frame The plot area and its axes.
105
+ @param entry The reference band.
106
+ */ export function referenceBandRect(frame, entry) {
107
+ const axis = referenceAxis(entry);
108
+ const values = axis ? entry[axis] : undefined;
109
+ if (!axis || !Array.isArray(values) || values.length < 2) return null;
110
+ const span = axisSpan(frame, axis, [
111
+ values[0],
112
+ values[1]
113
+ ], entry.ref);
114
+ const [lo, hi] = extent(frame, axis);
115
+ const clipped = span && clipSpan(span, lo, hi);
116
+ if (!clipped) return null;
117
+ const { plot } = frame;
118
+ const box = isVertical(axis) ? {
119
+ x: plot.x0,
120
+ y: clipped[0],
121
+ width: plot.x1 - plot.x0,
122
+ height: clipped[1] - clipped[0]
123
+ } : {
124
+ x: clipped[0],
125
+ y: plot.y0,
126
+ width: clipped[1] - clipped[0],
127
+ height: plot.y1 - plot.y0
128
+ };
129
+ return {
130
+ axis,
131
+ box
132
+ };
133
+ }
134
+ /**
135
+ Where a reference line's label goes (the top-left of its text block, and
136
+ its alignment): beside the line's `"end"` (the right of a horizontal line,
137
+ the top of a vertical one) or `"start"`, above a horizontal line (below
138
+ it near the plot's top) and right of a vertical one (left of it near the
139
+ plot's right edge).
140
+ @param frame The plot area and its axes.
141
+ @param line The line's axis and pixel position.
142
+ @param block The wrapped label.
143
+ @param position Which end of the line.
144
+ */ export function referenceLineLabelAt(frame, line, block, position = "end") {
145
+ const { plot } = frame;
146
+ if (isVertical(line.axis)) {
147
+ const above = line.at - PAD - block.height;
148
+ return {
149
+ x: position === "start" ? plot.x0 + PAD : plot.x1 - PAD,
150
+ y: above >= plot.y0 ? above : line.at + PAD,
151
+ align: position === "start" ? "start" : "end"
152
+ };
153
+ }
154
+ const right = line.at + PAD + block.width <= plot.x1;
155
+ return {
156
+ x: right ? line.at + PAD : line.at - PAD,
157
+ y: position === "start" ? plot.y1 - PAD - block.height : plot.y0 + PAD,
158
+ align: right ? "start" : "end"
159
+ };
160
+ }
161
+ /**
162
+ Where a reference band's label goes: inside its top-left corner
163
+ (`"start"`) or top-right (`"end"`).
164
+ @param box The band's rect.
165
+ @param position Which corner.
166
+ */ export function referenceBandLabelAt(box, position = "start") {
167
+ return position === "end" ? {
168
+ x: box.x + box.width - PAD,
169
+ y: box.y + PAD,
170
+ align: "end"
171
+ } : {
172
+ x: box.x + PAD,
173
+ y: box.y + PAD,
174
+ align: "start"
175
+ };
176
+ }
177
+ /** Each spot of `firsts` crossed with each of `seconds`, `firsts` varying slowest. */ const cross = (firsts, seconds)=>firsts.flatMap((a)=>seconds.map((b)=>[
178
+ a,
179
+ b
180
+ ]));
181
+ /**
182
+ Every spot a reference line's label may take, the one
183
+ `referenceLineLabelAt` picks first: then the other side of the line, then
184
+ the line's other end on either side, then along the line from the
185
+ preferred end on either side.
186
+ @param frame The plot area and its axes.
187
+ @param line The line's axis and pixel position.
188
+ @param block The wrapped label.
189
+ @param position Which end of the line is preferred.
190
+ */ export function referenceLineLabelSpots(frame, line, block, position = "end") {
191
+ const { plot } = frame;
192
+ const first = referenceLineLabelAt(frame, line, block, position);
193
+ const other = position === "start" ? "end" : "start";
194
+ if (isVertical(line.axis)) {
195
+ // A horizontal line: its ends are the plot's sides; its sides, above and below.
196
+ const sides = [
197
+ first.y,
198
+ first.y === line.at + PAD ? line.at - PAD - block.height : line.at + PAD
199
+ ];
200
+ const ends = [
201
+ [
202
+ first.x,
203
+ first.align
204
+ ],
205
+ other === "start" ? [
206
+ plot.x0 + PAD,
207
+ "start"
208
+ ] : [
209
+ plot.x1 - PAD,
210
+ "end"
211
+ ]
212
+ ];
213
+ const along = slideSteps(first.align === "end" ? plot.x1 - PAD - block.width : plot.x0 + PAD, first.align === "end" ? plot.x0 + PAD : plot.x1 - PAD - block.width);
214
+ return [
215
+ ...cross(ends, sides).map(([[x, align], y])=>({
216
+ x,
217
+ y,
218
+ align
219
+ })),
220
+ ...cross(along, sides).map(([x, y])=>({
221
+ x,
222
+ y,
223
+ align: "start"
224
+ }))
225
+ ];
226
+ }
227
+ // A vertical line: its ends are the plot's top and bottom; its sides, right and left.
228
+ const sides = [
229
+ [
230
+ first.x,
231
+ first.align
232
+ ],
233
+ first.align === "start" ? [
234
+ line.at - PAD,
235
+ "end"
236
+ ] : [
237
+ line.at + PAD,
238
+ "start"
239
+ ]
240
+ ];
241
+ const top = plot.y0 + PAD, bottom = plot.y1 - PAD - block.height;
242
+ const ends = [
243
+ first.y,
244
+ first.y === top ? bottom : top
245
+ ];
246
+ const along = slideSteps(first.y, first.y === top ? bottom : top);
247
+ return cross([
248
+ ...ends,
249
+ ...along
250
+ ], sides).map(([y, [x, align]])=>({
251
+ x,
252
+ y,
253
+ align
254
+ }));
255
+ }
256
+ /**
257
+ Every spot a reference band's label may take, inside the band: the
258
+ corner `referenceBandLabelAt` picks first, then the other top corner,
259
+ then the bottom corners, then along the band's length from its top (or,
260
+ across the plot, from its preferred side).
261
+ @param box The band's rect.
262
+ @param axis The band's axis.
263
+ @param block The wrapped label.
264
+ @param position Which top corner is preferred.
265
+ */ export function referenceBandLabelSpots(box, axis, block, position = "start") {
266
+ const startX = [
267
+ box.x + PAD,
268
+ "start"
269
+ ], endX = [
270
+ box.x + box.width - PAD,
271
+ "end"
272
+ ];
273
+ const xs = position === "end" ? [
274
+ endX,
275
+ startX
276
+ ] : [
277
+ startX,
278
+ endX
279
+ ];
280
+ const top = box.y + PAD, bottom = box.y + box.height - PAD - block.height;
281
+ const corners = cross([
282
+ top,
283
+ bottom
284
+ ], xs).map(([y, [x, align]])=>({
285
+ x,
286
+ y,
287
+ align
288
+ }));
289
+ if (isVertical(axis)) {
290
+ const [[x0], [x1]] = xs;
291
+ const fromX = position === "end" ? x0 - block.width : x0;
292
+ const toX = position === "end" ? x1 : x1 - block.width;
293
+ return [
294
+ ...corners,
295
+ ...cross(slideSteps(fromX, toX), [
296
+ top,
297
+ bottom
298
+ ]).map(([x, y])=>({
299
+ x,
300
+ y,
301
+ align: "start"
302
+ }))
303
+ ];
304
+ }
305
+ return [
306
+ ...corners,
307
+ ...cross(slideSteps(top, bottom), xs).map(([y, [x, align]])=>({
308
+ x,
309
+ y,
310
+ align
311
+ }))
312
+ ];
313
+ }
314
+ /**
315
+ The label's text node at its preferred spot, registered with the rest of
316
+ its spots (see `placeReferenceLabels`), or null when the entry has no label.
317
+ */ function labelNode(viz, annotation, key, spotsFor) {
318
+ const text = annotation.label;
319
+ if (text === undefined || text === null || text === false || text === "") return null;
320
+ const style = annotationTextStyle(viz, (k)=>annotation[k]);
321
+ const block = wrapAnnotationText(`${text}`, style);
322
+ if (!block.lines.length) return null;
323
+ const spots = spotsFor(block);
324
+ const node = annotationTextNode(block, style, {
325
+ key,
326
+ ...spots[0]
327
+ });
328
+ registerLabelSpots(node, block, spots);
329
+ return node;
330
+ }
331
+ /** A `dash` setting's pattern: `true` is "4 4". */ function dashOf(annotation) {
332
+ const dash = annotation.dash ?? annotation.strokeDasharray;
333
+ if (dash === true) return [
334
+ 4,
335
+ 4
336
+ ];
337
+ if (dash === false) return undefined;
338
+ return parseDash(dash);
339
+ }
340
+ /**
341
+ The scene nodes of a reference line: the line and its label.
342
+ @param viz The chart.
343
+ @param annotation The `"ReferenceLine"` annotation.
344
+ @param frame The plot area and its axes.
345
+ @param key The annotation's key, which prefixes its nodes'.
346
+ */ export function referenceLineNodes(viz, annotation, frame, key) {
347
+ const line = referenceLinePoints(frame, annotation);
348
+ if (!line) return [];
349
+ const style = annotationTextStyle(viz, (k)=>annotation[k]);
350
+ const paint = {
351
+ fill: "none",
352
+ stroke: annotation.stroke || style.fontColor,
353
+ strokeWidth: num(annotation.strokeWidth, 1),
354
+ strokeOpacity: num(annotation.strokeOpacity, 0.6)
355
+ };
356
+ const dash = dashOf(annotation);
357
+ if (dash) paint.strokeDasharray = dash;
358
+ const out = [
359
+ {
360
+ type: "line",
361
+ key: `${key}-line`,
362
+ interactive: false,
363
+ points: line.points,
364
+ curve: "linear",
365
+ paint
366
+ }
367
+ ];
368
+ const label = labelNode(viz, annotation, `${key}-label`, (block)=>referenceLineLabelSpots(frame, line, block, annotation.labelPosition === "start" ? "start" : "end"));
369
+ if (label) out.push(label);
370
+ return out;
371
+ }
372
+ /**
373
+ The scene nodes of a reference band: the shaded rect and its label.
374
+ @param viz The chart.
375
+ @param annotation The `"ReferenceBand"` annotation.
376
+ @param frame The plot area and its axes.
377
+ @param key The annotation's key, which prefixes its nodes'.
378
+ */ export function referenceBandNodes(viz, annotation, frame, key) {
379
+ const band = referenceBandRect(frame, annotation);
380
+ if (!band) return [];
381
+ const style = annotationTextStyle(viz, (k)=>annotation[k]);
382
+ const paint = {
383
+ fill: annotation.fill || style.fontColor,
384
+ fillOpacity: num(annotation.fillOpacity, 0.08)
385
+ };
386
+ if (annotation.stroke) {
387
+ paint.stroke = annotation.stroke;
388
+ paint.strokeWidth = num(annotation.strokeWidth, 1);
389
+ paint.strokeOpacity = num(annotation.strokeOpacity, 0.4);
390
+ }
391
+ const out = [
392
+ {
393
+ type: "rect",
394
+ key: `${key}-band`,
395
+ interactive: false,
396
+ ...band.box,
397
+ paint
398
+ }
399
+ ];
400
+ const label = labelNode(viz, annotation, `${key}-label`, (block)=>referenceBandLabelSpots(band.box, band.axis, block, annotation.labelPosition === "end" ? "end" : "start"));
401
+ if (label) out.push(label);
402
+ return out;
403
+ }
@@ -0,0 +1,106 @@
1
+ /**
2
+ Where reference line and band labels go once the data is drawn: each
3
+ label has a list of spots, its preferred one first, and takes the first
4
+ whose box is clear of the data labels and of the reference labels placed
5
+ before it, inside the plot. A label with no clear spot is hidden.
6
+ */ /** Gap between a reference label and its line or band edge, in pixels. */ export const LABEL_PAD = 4;
7
+ /** How far apart the spots along a line or band edge are, in pixels. */ const SLIDE_STEP = 6;
8
+ /** Each label node's block and spots, for `placeReferenceLabels`. */ const labelSpots = new WeakMap();
9
+ /**
10
+ Records the spots a reference label node may move to (its preferred spot
11
+ first, where it is drawn), for `placeReferenceLabels`.
12
+ @param node The label's text node.
13
+ @param block The wrapped label.
14
+ @param spots Its spots, preferred first.
15
+ */ export function registerLabelSpots(node, block, spots) {
16
+ labelSpots.set(node, {
17
+ block,
18
+ spots
19
+ });
20
+ }
21
+ /**
22
+ The box a label's block covers at a spot.
23
+ @param spot The spot.
24
+ @param block The wrapped label.
25
+ */ export function labelSpotBox(spot, block) {
26
+ const shift = spot.align === "end" ? block.width : spot.align === "middle" ? block.width / 2 : 0;
27
+ return {
28
+ x: spot.x - shift,
29
+ y: spot.y,
30
+ width: block.width,
31
+ height: block.height
32
+ };
33
+ }
34
+ /** Whether two boxes overlap by more than a hair. */ const overlaps = (a, b)=>a.x < b.x + b.width - 0.5 && b.x < a.x + a.width - 0.5 && a.y < b.y + b.height - 0.5 && b.y < a.y + a.height - 0.5;
35
+ /** Whether a box lies inside the plot, to half a pixel. */ const inside = (b, plot)=>b.x >= plot.x0 - 0.5 && b.y >= plot.y0 - 0.5 && b.x + b.width <= plot.x1 + 0.5 && b.y + b.height <= plot.y1 + 0.5;
36
+ /**
37
+ The first of `spots` whose box is clear of every obstacle and inside the
38
+ plot (the first spot, the preferred one, need only be clear), or null
39
+ when none is.
40
+ @param spots The spots, preferred first.
41
+ @param block The wrapped label.
42
+ @param obstacles The boxes to stay clear of.
43
+ @param plot The plot area.
44
+ */ export function pickLabelSpot(spots, block, obstacles, plot) {
45
+ return spots.find((spot, i)=>{
46
+ const b = labelSpotBox(spot, block);
47
+ return (!i || inside(b, plot)) && !obstacles.some((o)=>overlaps(b, o));
48
+ }) ?? null;
49
+ }
50
+ /**
51
+ Positions from `from` toward `to`, `SLIDE_STEP` apart, both ends included.
52
+ @param from The first position.
53
+ @param to The last.
54
+ */ export function slideSteps(from, to) {
55
+ const steps = Math.floor(Math.abs(to - from) / SLIDE_STEP);
56
+ const dir = to < from ? -1 : 1;
57
+ const out = Array.from({
58
+ length: steps + 1
59
+ }, (_, i)=>from + dir * i * SLIDE_STEP);
60
+ if (out[out.length - 1] !== to) out.push(to);
61
+ return out;
62
+ }
63
+ /**
64
+ Moves each registered reference label among `nodes` to its first clear
65
+ spot (see `pickLabelSpot`), in order, each placed label joining the
66
+ obstacles of the ones after it, and drops a label with no clear spot.
67
+ Returns the nodes with the labels moved; unregistered nodes pass through.
68
+ @param nodes Scene nodes holding reference labels, at any depth.
69
+ @param obstacles The boxes to keep clear of, such as the data labels'.
70
+ @param plot The plot area.
71
+ */ export function placeReferenceLabels(nodes, obstacles, plot) {
72
+ const taken = [
73
+ ...obstacles
74
+ ];
75
+ const visit = (list)=>list.flatMap((node)=>{
76
+ if (node.type === "group") return [
77
+ {
78
+ ...node,
79
+ children: visit(node.children)
80
+ }
81
+ ];
82
+ const entry = labelSpots.get(node);
83
+ if (!entry || node.type !== "text") return [
84
+ node
85
+ ];
86
+ const spot = pickLabelSpot(entry.spots, entry.block, taken, plot);
87
+ if (!spot) return [];
88
+ taken.push(labelSpotBox(spot, entry.block));
89
+ const moved = {
90
+ ...node,
91
+ transform: {
92
+ ...node.transform,
93
+ x: spot.x,
94
+ y: spot.y
95
+ },
96
+ font: {
97
+ ...node.font,
98
+ anchor: spot.align
99
+ }
100
+ };
101
+ return [
102
+ moved
103
+ ];
104
+ });
105
+ return visit(nodes);
106
+ }