@d3plus/core 4.9.0 → 4.11.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 (687) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +170 -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 +170 -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 +81 -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 +178 -0
  17. package/es/src/charts/ArcDiagram/events.js +144 -0
  18. package/es/src/charts/ArcDiagram/index.js +215 -0
  19. package/es/src/charts/BarChart/index.js +14 -2
  20. package/es/src/charts/BoxWhisker/index.js +95 -4
  21. package/es/src/charts/BoxWhisker/outliers.js +68 -0
  22. package/es/src/charts/BoxWhisker/summary.js +83 -0
  23. package/es/src/charts/BoxWhisker/tooltip.js +122 -0
  24. package/es/src/charts/BubbleChart/emit.js +31 -0
  25. package/es/src/charts/BubbleChart/index.js +54 -0
  26. package/es/src/charts/Bullet/index.js +2 -1
  27. package/es/src/charts/BumpChart/index.js +5 -0
  28. package/es/src/charts/Calendar/emit.js +1 -1
  29. package/es/src/charts/Calendar/index.js +5 -3
  30. package/es/src/charts/Candlestick/aggregate.js +11 -1
  31. package/es/src/charts/Candlestick/buffer.js +6 -4
  32. package/es/src/charts/Candlestick/index.js +7 -6
  33. package/es/src/charts/Chord/applyLayout.js +56 -69
  34. package/es/src/charts/Chord/emit.js +55 -24
  35. package/es/src/charts/Chord/index.js +17 -12
  36. package/es/src/charts/Chord/labels.js +105 -0
  37. package/es/src/charts/Donut/index.js +5 -11
  38. package/es/src/charts/Dumbbell/index.js +2 -4
  39. package/es/src/charts/Funnel/index.js +2 -1
  40. package/es/src/charts/Gantt/applyLayout.js +162 -0
  41. package/es/src/charts/Gantt/emit.js +142 -0
  42. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  43. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  44. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  45. package/es/src/charts/Gantt/ganttRows.js +111 -0
  46. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  47. package/es/src/charts/Gantt/index.js +219 -0
  48. package/es/src/charts/Gauge/index.js +2 -1
  49. package/es/src/charts/Geomap/applyLayout.js +90 -49
  50. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  51. package/es/src/charts/Geomap/emit.js +19 -2
  52. package/es/src/charts/Geomap/flowEmit.js +132 -0
  53. package/es/src/charts/Geomap/flowEvents.js +86 -0
  54. package/es/src/charts/Geomap/flowFields.js +91 -0
  55. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  56. package/es/src/charts/Geomap/flowLinks.js +239 -0
  57. package/es/src/charts/Geomap/geoCache.js +180 -0
  58. package/es/src/charts/Geomap/globeKeys.js +131 -0
  59. package/es/src/charts/Geomap/globeRotate.js +208 -0
  60. package/es/src/charts/Geomap/index.js +60 -19
  61. package/es/src/charts/Geomap/pointLabels.js +107 -0
  62. package/es/src/charts/Hexbin/binning.js +103 -0
  63. package/es/src/charts/Hexbin/buffer.js +33 -0
  64. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  65. package/es/src/charts/Hexbin/contours.js +48 -0
  66. package/es/src/charts/Hexbin/emit.js +142 -0
  67. package/es/src/charts/Hexbin/index.js +204 -0
  68. package/es/src/charts/Hexbin/layers.js +212 -0
  69. package/es/src/charts/Hexbin/settings.js +86 -0
  70. package/es/src/charts/Hexbin/tooltip.js +77 -0
  71. package/es/src/charts/Histogram/binData.js +31 -4
  72. package/es/src/charts/Histogram/index.js +37 -16
  73. package/es/src/charts/Histogram/labels.js +18 -0
  74. package/es/src/charts/Icicle/index.js +3 -3
  75. package/es/src/charts/LinePlot/index.js +7 -0
  76. package/es/src/charts/Marimekko/index.js +7 -4
  77. package/es/src/charts/Matrix/index.js +3 -2
  78. package/es/src/charts/Network/applyLayout.js +138 -94
  79. package/es/src/charts/Network/bundle.js +81 -0
  80. package/es/src/charts/Network/clusterLabels.js +423 -0
  81. package/es/src/charts/Network/clusters.js +290 -0
  82. package/es/src/charts/Network/emit.js +253 -70
  83. package/es/src/charts/Network/graph.js +117 -0
  84. package/es/src/charts/Network/graphFluent.js +79 -0
  85. package/es/src/charts/Network/index.js +93 -108
  86. package/es/src/charts/Network/minNodeDistance.js +64 -0
  87. package/es/src/charts/Network/polygonRows.js +44 -0
  88. package/es/src/charts/Pack/index.js +7 -2
  89. package/es/src/charts/Pie/applyLayout.js +86 -27
  90. package/es/src/charts/Pie/arcFit.js +152 -0
  91. package/es/src/charts/Pie/curvedLabels.js +134 -0
  92. package/es/src/charts/Pie/emit.js +43 -96
  93. package/es/src/charts/Pie/index.js +66 -32
  94. package/es/src/charts/Pie/labelRoom.js +154 -0
  95. package/es/src/charts/Pie/outsideLabels.js +224 -0
  96. package/es/src/charts/Pie/outsideNodes.js +267 -0
  97. package/es/src/charts/Pie/pieLabels.js +137 -0
  98. package/es/src/charts/Pie/sectorBox.js +223 -0
  99. package/es/src/charts/Pie/straightLabels.js +96 -0
  100. package/es/src/charts/Pie/straightLayout.js +215 -0
  101. package/es/src/charts/Plot/alongLegend.js +76 -0
  102. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  103. package/es/src/charts/Plot/axisHover.js +180 -0
  104. package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
  105. package/es/src/charts/Plot/axisHoverScene.js +203 -0
  106. package/es/src/charts/Plot/axisValues.js +43 -0
  107. package/es/src/charts/Plot/barHitArea.js +81 -0
  108. package/es/src/charts/Plot/barLabelFit.js +123 -0
  109. package/es/src/charts/Plot/barWidth.js +61 -13
  110. package/es/src/charts/Plot/circleLabels.js +98 -0
  111. package/es/src/charts/Plot/confidenceConfig.js +2 -2
  112. package/es/src/charts/Plot/connectGaps.js +237 -0
  113. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  114. package/es/src/charts/Plot/draw.js +14 -4
  115. package/es/src/charts/Plot/fillBetween.js +2 -1
  116. package/es/src/charts/Plot/forecastScene.js +3 -4
  117. package/es/src/charts/Plot/index.js +42 -15
  118. package/es/src/charts/Plot/labelPlacement.js +10 -2
  119. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  120. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  121. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  122. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  123. package/es/src/charts/Plot/openDomainEnds.js +2 -5
  124. package/es/src/charts/Plot/pipeline.js +71 -22
  125. package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
  126. package/es/src/charts/Plot/pipelineDomains.js +23 -6
  127. package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
  128. package/es/src/charts/Plot/pipelineScales.js +40 -8
  129. package/es/src/charts/Plot/plotFacet.js +12 -1
  130. package/es/src/charts/Plot/plotInit.js +49 -5
  131. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  132. package/es/src/charts/Plot/plotZoom.js +15 -6
  133. package/es/src/charts/Plot/referenceDomains.js +133 -0
  134. package/es/src/charts/Plot/shapeDefaults.js +14 -9
  135. package/es/src/charts/Plot/sharedHoverScene.js +50 -31
  136. package/es/src/charts/Plot/sharedTooltip.js +19 -7
  137. package/es/src/charts/Plot/stackHelpers.js +13 -1
  138. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  139. package/es/src/charts/Plot/stackShareTooltip.js +9 -4
  140. package/es/src/charts/Plot/stackThreshold.js +154 -0
  141. package/es/src/charts/Plot/trendLabels.js +183 -0
  142. package/es/src/charts/Plot/trendLines.js +1 -0
  143. package/es/src/charts/Plot/trendScene.js +6 -3
  144. package/es/src/charts/Plot/trendTooltip.js +5 -1
  145. package/es/src/charts/PolarArea/index.js +5 -4
  146. package/es/src/charts/Priestley/applyLayout.js +14 -20
  147. package/es/src/charts/Priestley/index.js +4 -34
  148. package/es/src/charts/Priestley/timeAxis.js +100 -0
  149. package/es/src/charts/Pyramid/index.js +4 -2
  150. package/es/src/charts/Radar/axisDecorations.js +49 -12
  151. package/es/src/charts/Radar/curvedLabels.js +187 -0
  152. package/es/src/charts/Radar/index.js +5 -5
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +4 -1
  155. package/es/src/charts/RadialBar/index.js +18 -10
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/index.js +6 -9
  158. package/es/src/charts/Rings/applyLayout.js +41 -24
  159. package/es/src/charts/Rings/emit.js +174 -58
  160. package/es/src/charts/Rings/index.js +65 -30
  161. package/es/src/charts/Rings/ringsGraph.js +28 -9
  162. package/es/src/charts/Rings/ringsLoops.js +73 -0
  163. package/es/src/charts/Rings/ringsParallel.js +166 -0
  164. package/es/src/charts/Sankey/applyLayout.js +116 -39
  165. package/es/src/charts/Sankey/circularLayout.js +208 -0
  166. package/es/src/charts/Sankey/circularLinks.js +301 -0
  167. package/es/src/charts/Sankey/emit.js +164 -94
  168. package/es/src/charts/Sankey/index.js +75 -77
  169. package/es/src/charts/Sankey/labels.js +80 -0
  170. package/es/src/charts/Sankey/ribbons.js +88 -0
  171. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  172. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  173. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  174. package/es/src/charts/Scatter/index.js +25 -0
  175. package/es/src/charts/SlopeChart/index.js +116 -0
  176. package/es/src/charts/SlopeChart/slope.js +95 -0
  177. package/es/src/charts/Streamgraph/index.js +51 -0
  178. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  179. package/es/src/charts/Sunburst/emit.js +74 -63
  180. package/es/src/charts/Sunburst/index.js +3 -3
  181. package/es/src/charts/Tree/index.js +2 -6
  182. package/es/src/charts/Treemap/applyLayout.js +14 -1
  183. package/es/src/charts/Treemap/emit.js +8 -2
  184. package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
  185. package/es/src/charts/Treemap/groupHeaders.js +95 -0
  186. package/es/src/charts/Treemap/index.js +17 -7
  187. package/es/src/charts/Treemap/thresholdFunction.js +11 -9
  188. package/es/src/charts/Violin/inner.js +3 -5
  189. package/es/src/charts/Waffle/index.js +4 -2
  190. package/es/src/charts/Waffle/tooltip.js +6 -2
  191. package/es/src/charts/Waterfall/index.js +4 -2
  192. package/es/src/charts/definition/makeChart.js +20 -5
  193. package/es/src/charts/drawSteps/backControl.js +17 -5
  194. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  195. package/es/src/charts/drawSteps/minimap.js +6 -5
  196. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  197. package/es/src/charts/drawSteps/saveChart.js +176 -0
  198. package/es/src/charts/drawSteps/saveControl.js +148 -0
  199. package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
  200. package/es/src/charts/drawSteps/searchControls.js +2 -1
  201. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  202. package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
  203. package/es/src/charts/drawSteps/topLeftControls.js +3 -1
  204. package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
  205. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  206. package/es/src/charts/events/click.legend.js +7 -2
  207. package/es/src/charts/events/click.shape.js +38 -2
  208. package/es/src/charts/events/mouseenter.js +9 -0
  209. package/es/src/charts/events/mousemove.legend.js +3 -0
  210. package/es/src/charts/events/mousemove.shape.js +12 -4
  211. package/es/src/charts/facet/drawFacets.js +14 -5
  212. package/es/src/charts/facet/facetConfig.js +2 -2
  213. package/es/src/charts/facet/facetData.js +2 -2
  214. package/es/src/charts/features/annotationFrame.js +179 -0
  215. package/es/src/charts/features/annotationText.js +83 -0
  216. package/es/src/charts/features/annotationTypes.js +10 -0
  217. package/es/src/charts/features/attributionFeature.js +6 -11
  218. package/es/src/charts/features/axes.js +9 -7
  219. package/es/src/charts/features/axesFinal.js +26 -4
  220. package/es/src/charts/features/axesMeasure.js +61 -6
  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/chartGeometry.js +1 -1
  224. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  225. package/es/src/charts/features/circleLabels.js +207 -0
  226. package/es/src/charts/features/colorScaleBucket.js +19 -1
  227. package/es/src/charts/features/colorScaleHover.js +70 -0
  228. package/es/src/charts/features/colorScaleValue.js +97 -0
  229. package/es/src/charts/features/curvedArrows.js +158 -0
  230. package/es/src/charts/features/edgeArrows.js +160 -4
  231. package/es/src/charts/features/edgeBundling.js +442 -0
  232. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  233. package/es/src/charts/features/ensureZoomDom.js +32 -8
  234. package/es/src/charts/features/features.js +45 -15
  235. package/es/src/charts/features/featuresColorScale.js +62 -8
  236. package/es/src/charts/features/featuresLegend.js +21 -32
  237. package/es/src/charts/features/legendKeys.js +64 -0
  238. package/es/src/charts/features/lineLabels.js +55 -46
  239. package/es/src/charts/features/linkBundle.js +19 -0
  240. package/es/src/charts/features/linkColor.js +72 -0
  241. package/es/src/charts/features/linkFields.js +86 -0
  242. package/es/src/charts/features/linkFocus.js +118 -0
  243. package/es/src/charts/features/linkInteraction.js +312 -0
  244. package/es/src/charts/features/linkKeys.js +20 -0
  245. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  246. package/es/src/charts/features/linkLabelPath.js +162 -0
  247. package/es/src/charts/features/linkLabels.js +340 -0
  248. package/es/src/charts/features/linkWidths.js +32 -0
  249. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  250. package/es/src/charts/features/pathLabels.js +50 -0
  251. package/es/src/charts/features/plotAnnotations.js +68 -17
  252. package/es/src/charts/features/plotPaint.js +42 -15
  253. package/es/src/charts/features/polyline.js +129 -0
  254. package/es/src/charts/features/referenceAnnotations.js +403 -0
  255. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  256. package/es/src/charts/features/ringLabelNodes.js +93 -0
  257. package/es/src/charts/features/ringLabels.js +222 -0
  258. package/es/src/charts/features/sceneBounds.js +26 -6
  259. package/es/src/charts/features/selfLoops.js +306 -0
  260. package/es/src/charts/features/shapeEmit.js +67 -30
  261. package/es/src/charts/features/shareKey.js +15 -0
  262. package/es/src/charts/features/sharedFields.js +15 -2
  263. package/es/src/charts/features/textHalo.js +29 -0
  264. package/es/src/charts/features/thresholdMembers.js +71 -0
  265. package/es/src/charts/helpers/densityChart.js +3 -1
  266. package/es/src/charts/helpers/valueTitle.js +6 -3
  267. package/es/src/charts/index.js +8 -0
  268. package/es/src/charts/partition/chartFields.js +6 -5
  269. package/es/src/charts/partition/hierarchy.js +2 -0
  270. package/es/src/charts/partition/interaction.js +9 -5
  271. package/es/src/charts/partition/zoom.js +7 -6
  272. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  273. package/es/src/charts/pipeline/preDrawData.js +77 -13
  274. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  275. package/es/src/charts/pipeline/vizDraw.js +40 -29
  276. package/es/src/charts/pipeline/vizPreDraw.js +29 -18
  277. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  278. package/es/src/charts/polar/config.js +2 -3
  279. package/es/src/charts/viz/Viz.js +82 -44
  280. package/es/src/charts/viz/VizBase.js +47 -19
  281. package/es/src/charts/viz/backgroundInk.js +13 -7
  282. package/es/src/charts/viz/dataPoller.js +52 -0
  283. package/es/src/charts/viz/focusRing.js +104 -0
  284. package/es/src/charts/viz/focusTargets.js +208 -0
  285. package/es/src/charts/viz/groupRow.js +35 -0
  286. package/es/src/charts/viz/history.js +74 -0
  287. package/es/src/charts/viz/interactionOpacity.js +19 -5
  288. package/es/src/charts/viz/keyboardNav.js +297 -0
  289. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  290. package/es/src/charts/viz/loaderFormat.js +114 -0
  291. package/es/src/charts/viz/missingFields.js +123 -0
  292. package/es/src/charts/viz/mountTarget.js +9 -0
  293. package/es/src/charts/viz/nearestHover.js +183 -0
  294. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  295. package/es/src/charts/viz/ordinalColor.js +14 -12
  296. package/es/src/charts/viz/pageTheme.js +83 -0
  297. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  298. package/es/src/charts/viz/pointVoronoi.js +124 -0
  299. package/es/src/charts/viz/reducedMotion.js +27 -0
  300. package/es/src/charts/viz/reportHandlerError.js +10 -0
  301. package/es/src/charts/viz/shapeClassTargets.js +18 -2
  302. package/es/src/charts/viz/simpleHover.js +2 -0
  303. package/es/src/charts/viz/vizClassName.js +31 -0
  304. package/es/src/charts/viz/vizDataPolling.js +172 -0
  305. package/es/src/charts/viz/vizDefaults.js +81 -23
  306. package/es/src/charts/viz/vizFields.js +53 -2
  307. package/es/src/charts/viz/vizRender.js +49 -28
  308. package/es/src/charts/viz/vizTheme.js +96 -0
  309. package/es/src/charts/viz/vizVisibility.js +14 -0
  310. package/es/src/components/Axis/Axis.js +34 -0
  311. package/es/src/components/Axis/AxisBottom.js +1 -0
  312. package/es/src/components/Axis/AxisLeft.js +1 -0
  313. package/es/src/components/Axis/AxisRight.js +1 -0
  314. package/es/src/components/Axis/AxisTop.js +1 -0
  315. package/es/src/components/Axis/axisBreak.js +4 -1
  316. package/es/src/components/Axis/axisDefaults.js +8 -10
  317. package/es/src/components/Axis/axisLabelAngle.js +175 -0
  318. package/es/src/components/Axis/axisLabelThinning.js +13 -4
  319. package/es/src/components/Axis/axisLayout.js +86 -19
  320. package/es/src/components/Axis/axisLayoutLabels.js +66 -13
  321. package/es/src/components/Axis/axisLayoutScale.js +10 -1
  322. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  323. package/es/src/components/Axis/axisRender.js +38 -9
  324. package/es/src/components/Axis/axisRounding.js +15 -4
  325. package/es/src/components/Axis/axisSlantWrap.js +39 -0
  326. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  327. package/es/src/components/Axis/powTicks.js +73 -0
  328. package/es/src/components/Axis/rangeBreaks.js +201 -0
  329. package/es/src/components/Axis/timeValues.js +19 -4
  330. package/es/src/components/ColorScale/ColorScale.js +42 -36
  331. package/es/src/components/ColorScale/bucketBounds.js +64 -0
  332. package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
  333. package/es/src/components/ColorScale/colorScaleRender.js +25 -1
  334. package/es/src/components/ColorScale/colorScaleScale.js +43 -24
  335. package/es/src/components/ColorScale/colorScaleType.js +26 -0
  336. package/es/src/components/Legend/Legend.js +3 -0
  337. package/es/src/components/Legend/legendConfig.js +2 -6
  338. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  339. package/es/src/components/TextBox.js +31 -65
  340. package/es/src/components/Timeline/Timeline.js +54 -54
  341. package/es/src/components/Timeline/brushSpan.js +78 -0
  342. package/es/src/components/Timeline/timelineConfig.js +27 -10
  343. package/es/src/components/Timeline/timelineMode.js +26 -0
  344. package/es/src/components/Timeline/timelineRender.js +51 -9
  345. package/es/src/components/Tooltip.js +28 -13
  346. package/es/src/components/fontStack.js +20 -0
  347. package/es/src/components/textBoxLayout.js +58 -21
  348. package/es/src/components/textBoxPath.js +73 -0
  349. package/es/src/components/textBoxScene.js +223 -0
  350. package/es/src/components/textBoxWords.js +70 -0
  351. package/es/src/shapes/Area.js +1 -0
  352. package/es/src/shapes/Bar.js +1 -0
  353. package/es/src/shapes/Box.js +67 -79
  354. package/es/src/shapes/Circle.js +1 -0
  355. package/es/src/shapes/Line.js +1 -0
  356. package/es/src/shapes/Path.js +1 -0
  357. package/es/src/shapes/Rect.js +1 -0
  358. package/es/src/shapes/Shape.js +1 -0
  359. package/es/src/shapes/Whisker.js +1 -0
  360. package/es/src/shapes/boxOutlierShape.js +19 -0
  361. package/es/src/shapes/boxStats.js +35 -0
  362. package/es/src/shapes/boxStyle.js +78 -0
  363. package/es/src/shapes/boxSummary.js +174 -0
  364. package/es/src/shapes/shapeStandalone.js +2 -0
  365. package/es/src/utils/BaseClass.js +44 -12
  366. package/es/src/utils/className.js +78 -0
  367. package/es/src/utils/configPrep.js +2 -1
  368. package/es/src/utils/configWarnings.js +25 -0
  369. package/es/src/utils/constant.js +13 -1
  370. package/es/src/utils/displayName.js +12 -0
  371. package/es/src/utils/fieldAccessor.js +31 -0
  372. package/es/src/utils/paintComponentScene.js +2 -0
  373. package/es/src/utils/theme.js +190 -0
  374. package/es/src/utils/themeInk.js +68 -0
  375. package/package.json +14 -10
  376. package/types/index.d.ts +8 -2
  377. package/types/internal.d.ts +253 -9
  378. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  379. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  380. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  381. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  382. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  383. package/types/src/charts/Alluvial/index.d.ts +27 -0
  384. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  385. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  386. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  387. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  388. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  389. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  390. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  391. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  392. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  393. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  394. package/types/src/charts/BoxWhisker/index.d.ts +3 -1
  395. package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
  396. package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
  397. package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
  398. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  399. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  400. package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
  401. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  402. package/types/src/charts/Chord/labels.d.ts +66 -0
  403. package/types/src/charts/Donut/index.d.ts +2 -1
  404. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  405. package/types/src/charts/Gantt/emit.d.ts +17 -0
  406. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  407. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  408. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  409. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  410. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  411. package/types/src/charts/Gantt/index.d.ts +36 -0
  412. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  413. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  414. package/types/src/charts/Geomap/emit.d.ts +2 -2
  415. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  416. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  417. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  418. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  419. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  420. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  421. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  422. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  423. package/types/src/charts/Geomap/index.d.ts +3 -0
  424. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  425. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  426. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  427. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  428. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  429. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  430. package/types/src/charts/Hexbin/index.d.ts +25 -0
  431. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  432. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  433. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  434. package/types/src/charts/Histogram/binData.d.ts +20 -1
  435. package/types/src/charts/Histogram/index.d.ts +3 -2
  436. package/types/src/charts/Histogram/labels.d.ts +7 -0
  437. package/types/src/charts/Marimekko/index.d.ts +2 -1
  438. package/types/src/charts/Network/bundle.d.ts +67 -0
  439. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  440. package/types/src/charts/Network/clusters.d.ts +115 -0
  441. package/types/src/charts/Network/graph.d.ts +65 -0
  442. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  443. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  444. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  445. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  446. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  447. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  448. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  449. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  450. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  451. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  452. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  453. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  454. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  455. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  456. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  457. package/types/src/charts/Plot/axisHover.d.ts +68 -0
  458. package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
  459. package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
  460. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  461. package/types/src/charts/Plot/barHitArea.d.ts +59 -0
  462. package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
  463. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  464. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  465. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  466. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  467. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  468. package/types/src/charts/Plot/index.d.ts +28 -8
  469. package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
  470. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  471. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  472. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  473. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  474. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  475. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  476. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  477. package/types/src/charts/Plot/plotInit.d.ts +23 -2
  478. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  479. package/types/src/charts/Plot/plotZoom.d.ts +2 -0
  480. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  481. package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
  482. package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
  483. package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
  484. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  485. package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
  486. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  487. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  488. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  489. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  490. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  491. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  492. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  493. package/types/src/charts/Rings/emit.d.ts +50 -0
  494. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  495. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  496. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  497. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  498. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  499. package/types/src/charts/Sankey/emit.d.ts +58 -0
  500. package/types/src/charts/Sankey/labels.d.ts +19 -0
  501. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  502. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  503. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  504. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  505. package/types/src/charts/Scatter/index.d.ts +15 -0
  506. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  507. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  508. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  509. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  510. package/types/src/charts/Treemap/emit.d.ts +2 -1
  511. package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
  512. package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
  513. package/types/src/charts/Treemap/index.d.ts +2 -0
  514. package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
  515. package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
  516. package/types/src/charts/definition/makeChart.d.ts +5 -3
  517. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  518. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  519. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  520. package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
  521. package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
  522. package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
  523. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
  524. package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
  525. package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
  526. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  527. package/types/src/charts/events/click.legend.d.ts +2 -1
  528. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  529. package/types/src/charts/facet/facetData.d.ts +1 -1
  530. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  531. package/types/src/charts/features/annotationText.d.ts +57 -0
  532. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  533. package/types/src/charts/features/axesMeasure.d.ts +13 -1
  534. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  535. package/types/src/charts/features/calloutScene.d.ts +40 -0
  536. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  537. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  538. package/types/src/charts/features/circleLabels.d.ts +130 -0
  539. package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
  540. package/types/src/charts/features/colorScaleHover.d.ts +32 -0
  541. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  542. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  543. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  544. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  545. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  546. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  547. package/types/src/charts/features/features.d.ts +8 -0
  548. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  549. package/types/src/charts/features/legendKeys.d.ts +34 -0
  550. package/types/src/charts/features/lineLabels.d.ts +15 -12
  551. package/types/src/charts/features/linkBundle.d.ts +16 -0
  552. package/types/src/charts/features/linkColor.d.ts +48 -0
  553. package/types/src/charts/features/linkFields.d.ts +16 -0
  554. package/types/src/charts/features/linkFocus.d.ts +51 -0
  555. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  556. package/types/src/charts/features/linkKeys.d.ts +11 -0
  557. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  558. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  559. package/types/src/charts/features/linkLabels.d.ts +77 -0
  560. package/types/src/charts/features/linkWidths.d.ts +19 -0
  561. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  562. package/types/src/charts/features/pathLabels.d.ts +41 -0
  563. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  564. package/types/src/charts/features/plotPaint.d.ts +19 -0
  565. package/types/src/charts/features/polyline.d.ts +32 -0
  566. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  567. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  568. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  569. package/types/src/charts/features/ringLabels.d.ts +164 -0
  570. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  571. package/types/src/charts/features/selfLoops.d.ts +165 -0
  572. package/types/src/charts/features/shapeEmit.d.ts +5 -1
  573. package/types/src/charts/features/shareKey.d.ts +9 -0
  574. package/types/src/charts/features/sharedFields.d.ts +11 -2
  575. package/types/src/charts/features/textHalo.d.ts +14 -0
  576. package/types/src/charts/features/thresholdMembers.d.ts +38 -0
  577. package/types/src/charts/helpers/valueTitle.d.ts +4 -2
  578. package/types/src/charts/index.d.ts +8 -0
  579. package/types/src/charts/partition/interaction.d.ts +6 -3
  580. package/types/src/charts/partition/zoom.d.ts +4 -4
  581. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  582. package/types/src/charts/pipeline/stages.d.ts +9 -0
  583. package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
  584. package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
  585. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  586. package/types/src/charts/viz/Viz.d.ts +44 -6
  587. package/types/src/charts/viz/VizBase.d.ts +16 -7
  588. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  589. package/types/src/charts/viz/dataPoller.d.ts +28 -0
  590. package/types/src/charts/viz/focusRing.d.ts +25 -0
  591. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  592. package/types/src/charts/viz/groupRow.d.ts +24 -0
  593. package/types/src/charts/viz/history.d.ts +35 -0
  594. package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
  595. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  596. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  597. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  598. package/types/src/charts/viz/missingFields.d.ts +57 -0
  599. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  600. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  601. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  602. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  603. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  604. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  605. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  606. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  607. package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
  608. package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
  609. package/types/src/charts/viz/simpleHover.d.ts +2 -1
  610. package/types/src/charts/viz/vizClassName.d.ts +23 -0
  611. package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
  612. package/types/src/charts/viz/vizDefaults.d.ts +49 -9
  613. package/types/src/charts/viz/vizFields.d.ts +47 -0
  614. package/types/src/charts/viz/vizRender.d.ts +2 -1
  615. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  616. package/types/src/charts/viz/vizTypes.d.ts +117 -8
  617. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  618. package/types/src/components/Axis/Axis.d.ts +37 -8
  619. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  620. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  621. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  622. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  623. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  624. package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
  625. package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
  626. package/types/src/components/Axis/axisLayout.d.ts +5 -0
  627. package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
  628. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  629. package/types/src/components/Axis/axisRounding.d.ts +6 -3
  630. package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
  631. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  632. package/types/src/components/Axis/powTicks.d.ts +29 -0
  633. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  634. package/types/src/components/Axis/timeValues.d.ts +1 -1
  635. package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
  636. package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
  637. package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
  638. package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
  639. package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
  640. package/types/src/components/Legend/Legend.d.ts +1 -0
  641. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  642. package/types/src/components/TextBox.d.ts +1 -0
  643. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  644. package/types/src/components/Timeline/brushSpan.d.ts +41 -0
  645. package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
  646. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  647. package/types/src/components/Timeline/timelineRender.d.ts +8 -0
  648. package/types/src/components/Tooltip.d.ts +12 -3
  649. package/types/src/components/fontStack.d.ts +10 -0
  650. package/types/src/components/textBoxLayout.d.ts +18 -9
  651. package/types/src/components/textBoxPath.d.ts +59 -0
  652. package/types/src/components/textBoxScene.d.ts +51 -0
  653. package/types/src/components/textBoxWords.d.ts +33 -0
  654. package/types/src/shapes/Area.d.ts +1 -0
  655. package/types/src/shapes/Bar.d.ts +1 -0
  656. package/types/src/shapes/Box.d.ts +2 -8
  657. package/types/src/shapes/Circle.d.ts +1 -0
  658. package/types/src/shapes/Line.d.ts +1 -0
  659. package/types/src/shapes/Path.d.ts +1 -0
  660. package/types/src/shapes/Rect.d.ts +1 -0
  661. package/types/src/shapes/Shape.d.ts +1 -0
  662. package/types/src/shapes/Whisker.d.ts +1 -0
  663. package/types/src/shapes/boxOutlierShape.d.ts +9 -0
  664. package/types/src/shapes/boxStats.d.ts +19 -0
  665. package/types/src/shapes/boxStyle.d.ts +25 -0
  666. package/types/src/shapes/boxSummary.d.ts +66 -0
  667. package/types/src/shapes/emitLabels.d.ts +1 -1
  668. package/types/src/shapes/shapeConfig.d.ts +42 -4
  669. package/types/src/utils/BaseClass.d.ts +32 -0
  670. package/types/src/utils/D3Scale.d.ts +3 -0
  671. package/types/src/utils/D3plusConfig.d.ts +1240 -33
  672. package/types/src/utils/className.d.ts +64 -0
  673. package/types/src/utils/configPrep.d.ts +2 -0
  674. package/types/src/utils/configWarnings.d.ts +21 -2
  675. package/types/src/utils/constant.d.ts +8 -0
  676. package/types/src/utils/displayName.d.ts +10 -0
  677. package/types/src/utils/fieldAccessor.d.ts +24 -0
  678. package/types/src/utils/index.d.ts +1 -1
  679. package/types/src/utils/paintComponentScene.d.ts +3 -1
  680. package/types/src/utils/theme.d.ts +170 -0
  681. package/types/src/utils/themeInk.d.ts +56 -0
  682. package/umd/d3plus-core.full.js +87388 -56271
  683. package/umd/d3plus-core.full.min.js +2 -2
  684. package/umd/d3plus-core.js +37988 -11768
  685. package/umd/d3plus-core.min.js +2 -2
  686. package/es/src/components/Axis/gridStroke.js +0 -10
  687. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -1,6 +1,6 @@
1
1
  /* eslint no-cond-assign: 0*/ import { zoomTransform } from "d3-zoom";
2
2
  import { assign } from "@d3plus/dom";
3
- import { accessor, constant } from "../../utils/index.js";
3
+ import { fieldAccessor } from "../../utils/fieldAccessor.js";
4
4
  import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
5
5
  import { baselineValue, setBaseline } from "./baselineDomain.js";
6
6
  import { initPlotAxes, initPlotDefaults, plotSchema } from "./plotInit.js";
@@ -12,11 +12,15 @@ import { validateConfidenceConfig } from "./confidenceConfig.js";
12
12
  import { resolveConfidenceBands } from "./confidenceBands.js";
13
13
  import { trendLineDefaults } from "./trendLines.js";
14
14
  import { contentPoint, handleSharedHover } from "./sharedHover.js";
15
+ import { handleAxisHover } from "./axisHover.js";
15
16
  import { appendSharedHoverNodes } from "./sharedHoverScene.js";
16
17
  import Viz from "../viz/Viz.js";
17
18
  import { plotInsetRegion } from "./insetRegion.js";
18
19
  import { plotFacetHooks } from "./plotFacet.js";
20
+ import { plotStackThreshold, plotStackThresholdLegend } from "./stackThreshold.js";
21
+ import { isPointShape } from "../viz/nearestHover.js";
19
22
  import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
23
+ import { displayName } from "../../utils/displayName.js";
20
24
  /** A y-axis config patch with its `domain` array reversed (y scales run top-down). */ function reverseDomain(patch) {
21
25
  const domain = patch?.domain;
22
26
  return Array.isArray(domain) ? {
@@ -27,6 +31,7 @@ import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
27
31
  /**
28
32
  Creates an x/y plot based on an array of data.
29
33
  */ export default class Plot extends Viz {
34
+ static _displayName = "Plot";
30
35
  _trendLine = plotDef.defaults.trendLine;
31
36
  _trendLineConfig = trendLineDefaults();
32
37
  /**
@@ -71,6 +76,20 @@ import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
71
76
  });
72
77
  super._preDraw();
73
78
  }
79
+ /**
80
+ The legend rows with a stacked chart's threshold bucket folded into
81
+ one entry (see `stackThreshold.ts`).
82
+ @private
83
+ */ _thresholdLegend(legendData) {
84
+ return plotStackThresholdLegend(this, legendData);
85
+ }
86
+ /**
87
+ Folds a stacked chart's small series into one threshold bucket (see
88
+ `stackThreshold.ts`).
89
+ @private
90
+ */ _thresholdFunction(data, _tree, all) {
91
+ return plotStackThreshold(this, data, all);
92
+ }
74
93
  /**
75
94
  Composes the chart's scene graph: the native shape scenes from Viz.toScene
76
95
  (bars/lines/areas + labels) plus snapshots of the rendered axes, so a Plot
@@ -158,6 +177,13 @@ import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
158
177
  }
159
178
  return super._interactionDatum(pick, event);
160
179
  }
180
+ /**
181
+ A Plot's point marks are its Circle and Rect shapes (scatter and
182
+ bubble points, Beeswarm circles), for `hoverDistance`.
183
+ @private
184
+ */ _pointMark(node) {
185
+ return isPointShape(node);
186
+ }
161
187
  /**
162
188
  Picks the interaction point closest to a surface-local cursor position
163
189
  along the discrete axis. `event.point` is post-zoom surface space while the
@@ -185,9 +211,11 @@ import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
185
211
  inside the plot area, snaps to the nearest discrete position and, when
186
212
  two or more series share it, shows them all in one tooltip (suppressing
187
213
  the single-shape tooltip). Clears on leaving the plot area or the chart.
214
+ Then tracks the hovered point's axis guides and badges (`axisHover`).
188
215
  @private
189
216
  */ _sharedHover(event) {
190
217
  handleSharedHover(this, event);
218
+ handleAxisHover(this, event);
191
219
  }
192
220
  /**
193
221
  Extends the draw behavior of the abstract Viz class.
@@ -247,7 +275,9 @@ import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
247
275
  /**
248
276
  Allows drawing custom shapes to be used as annotations in the provided x/y plot. This method accepts custom config objects for the [Shape](http://d3plus.org/docs/#Shape) class, either a single config object or an array of config objects. Each config object requires an additional parameter, the "shape", which denotes which [Shape](http://d3plus.org/docs/#Shape) sub-class to use ([Rect](http://d3plus.org/docs/#Rect), [Line](http://d3plus.org/docs/#Line), etc).
249
277
 
250
- Additionally, each config object can also contain an optional "layer" key, which defines whether the annotations will be displayed in "front" or in "back" of the primary visualization shapes. This value defaults to "back" if not present.
278
+ Additionally, each config object can also contain an optional "layer" key, which defines whether the annotations will be displayed in "front" or in "back" of the primary visualization shapes. This value defaults to "back" if not present ("front" for callouts).
279
+
280
+ Three more kinds draw chart notes: `"Callout"` anchors wrapped text in a box at each data row's `x`/`y` (in data units, or plot-area fractions with `xRef`/`yRef: "plot"`), offset by `dx`/`dy` pixels and joined to its anchor by a connector ending in an arrowhead or dot (see `CalloutAnnotation`); `"ReferenceLine"` and `"ReferenceBand"` draw what `referenceLines` and `referenceBands` entries expand into. All annotations follow zoom and never respond to the pointer or keyboard.
251
281
  */ annotations(_) {
252
282
  return arguments.length ? (this._annotations = _ instanceof Array ? _ : [
253
283
  _
@@ -317,7 +347,7 @@ Additionally, each config object can also contain an optional "layer" key, which
317
347
  .confidenceConfig({Bar: {stroke: "#333", capWidth: 8}, tooltip: false})
318
348
  */ confidenceConfig(_) {
319
349
  if (!arguments.length) return this._confidenceConfig;
320
- validateConfidenceConfig(this.constructor.name, _);
350
+ validateConfidenceConfig(displayName(this), _);
321
351
  this._confidenceConfig = mergeConfigBag(this, "confidenceConfig", _, this._confidenceConfig);
322
352
  return this;
323
353
  }
@@ -336,11 +366,6 @@ Additionally, each config object can also contain an optional "layer" key, which
336
366
  */ labelConnectorConfig(_) {
337
367
  return arguments.length ? (this._labelConnectorConfig = mergeConfigBag(this, "labelConnectorConfig", _, this._labelConnectorConfig), this) : this._labelConnectorConfig;
338
368
  }
339
- /**
340
- The behavior to be used when calculating the position and size of each shape's label(s). The value passed can either be the _String_ name of the behavior to be used for all shapes, or an accessor _Function_ that will be provided each data point and will be expected to return the behavior to be used for that data point. The availability and options for this method depend on the default logic for each Shape. As an example, the values "outside" or "inside" can be set for Bar shapes, whose "auto" default will calculate the best position dynamically based on the available space.
341
- */ labelPosition(_) {
342
- return arguments.length ? (this._labelPosition = typeof _ === "function" ? _ : constant(_), this) : this._labelPosition;
343
- }
344
369
  /**
345
370
  Paint for the shared tooltip's crosshair guide line (`stroke`,
346
371
  `strokeWidth`, `strokeDasharray`, `strokeOpacity`, …). Merged into the
@@ -383,7 +408,7 @@ Stacked charts always fit one line to the stack totals.
383
408
  Sets the size of bubbles to the given Number, data key, or function.
384
409
  */ size(_) {
385
410
  if (!arguments.length) return this._size;
386
- this._size = typeof _ === "function" || !_ ? _ : accessor(_);
411
+ this._size = typeof _ === "function" || !_ ? _ : fieldAccessor(_);
387
412
  this._sizeKey = typeof _ === "string" ? _ : undefined;
388
413
  return this;
389
414
  }
@@ -407,8 +432,10 @@ Stacked charts always fit one line to the stack totals.
407
432
  - a value accessor, or a `{value, order}` config, to rank series by an
408
433
  aggregate of any data field.
409
434
 
410
- Unknown named strings warn and fall back to `"descending"`. If *value*
411
- is not specified, returns the current stack order.
435
+ Unknown named strings warn and fall back to `"descending"`. The
436
+ default legend lists the series in the order they stack, from the
437
+ baseline outward. If *value* is not specified, returns the current
438
+ stack order.
412
439
  */ stackOrder(_) {
413
440
  return arguments.length ? (this._stackOrder = resolveStackOrder(_), this) : this._stackOrder;
414
441
  }
@@ -418,7 +445,7 @@ Stacked charts always fit one line to the stack totals.
418
445
  if (arguments.length) {
419
446
  if (typeof _ === "function") this._x = _;
420
447
  else {
421
- this._x = accessor(_);
448
+ this._x = fieldAccessor(_);
422
449
  this._xKey = _;
423
450
  }
424
451
  return this;
@@ -430,7 +457,7 @@ Stacked charts always fit one line to the stack totals.
430
457
  if (arguments.length) {
431
458
  if (typeof _ === "function") this._x2 = _;
432
459
  else {
433
- this._x2 = accessor(_);
460
+ this._x2 = fieldAccessor(_);
434
461
  this._x2Key = _;
435
462
  }
436
463
  return this;
@@ -452,7 +479,7 @@ Stacked charts always fit one line to the stack totals.
452
479
  if (arguments.length) {
453
480
  if (typeof _ === "function") this._y = _;
454
481
  else {
455
- this._y = accessor(_);
482
+ this._y = fieldAccessor(_);
456
483
  this._yKey = _;
457
484
  }
458
485
  return this;
@@ -464,7 +491,7 @@ Stacked charts always fit one line to the stack totals.
464
491
  if (arguments.length) {
465
492
  if (typeof _ === "function") this._y2 = _;
466
493
  else {
467
- this._y2 = accessor(_);
494
+ this._y2 = fieldAccessor(_);
468
495
  this._y2Key = _;
469
496
  }
470
497
  return this;
@@ -9,13 +9,21 @@
9
9
  // so the `null` argument is ignored (cast to satisfy the scale signature).
10
10
  return this._sizeScaleD3(this._size ? this._size(d) : null);
11
11
  }
12
+ /**
13
+ Whether a bar grows back along its value axis: a negative value, or a
14
+ positive one on a `reverse` axis (down a y axis, left along an x axis).
15
+ */ export function growsBack(viz, valueAxis, d, i) {
16
+ const value = (valueAxis === "y" ? viz._y : viz._x)(d, i);
17
+ const axis = valueAxis === "y" ? viz._yAxis : viz._xAxis;
18
+ return value < 0 !== Boolean(axis?.schema?.reverse);
19
+ }
12
20
  /**
13
21
  Determines if a Bar label should be placed outside of the Bar.
14
22
  */ export function outside(d, i) {
15
23
  // Force all Stacked Bars to use "inside" labels.
16
24
  if (this.schema.stacked) return false;
17
25
  // Detect user "outside" or "inside" override.
18
- const labelPosition = this._labelPosition(d, i);
26
+ const labelPosition = this.schema.labelPosition(d, i);
19
27
  if (labelPosition === "outside") return true;
20
28
  else if (labelPosition === "inside") return false;
21
29
  // Run "auto" logic based on available space, against the non-discrete axis.
@@ -25,7 +33,7 @@
25
33
  const accessor = nonDiscrete === "y" ? this._y : this._x;
26
34
  const range = axis._d3Scale.range();
27
35
  const value = accessor(d, i);
28
- const negative = value < 0;
36
+ const negative = growsBack(this, nonDiscrete, d, i);
29
37
  const zero = axis._getPosition(0);
30
38
  const space = nonDiscrete === "y" ? negative ? range[1] - zero : zero - range[0] : negative ? zero - range[0] : range[1] - zero;
31
39
  const pos = axis._getPosition(value);
@@ -0,0 +1,82 @@
1
+ /**
2
+ The Line shape's label config for a Plot's `lineLabels`: the text and
3
+ bounds of each line's labels past its right end, its left end, or both,
4
+ after their collisions have been bumped apart (see
5
+ `features/lineLabels.ts`).
6
+
7
+ @module
8
+ */ import { max } from "d3-array";
9
+ import { formatAbbreviate } from "@d3plus/format";
10
+ import { lineLabelKey, lineLabelText, rowLineLabelSides } from "./lineLabelSides.js";
11
+ /**
12
+ The text one measured label shows: the series name (and its value), or,
13
+ where the plot had no room for every label, `"+N more"` on the last that
14
+ fit and nothing on the rest.
15
+ */ function entryText(inputs, measure, d, i) {
16
+ const { viz } = inputs;
17
+ if (measure.hidden) return false;
18
+ if (measure.collapsed) return `+${formatAbbreviate(measure.collapsed, viz.schema.locale)} ${viz.schema.translate("more")}`;
19
+ // A label shortened to fit its room keeps its shortened name.
20
+ const name = measure.name !== undefined ? measure.name : inputs.name === undefined || inputs.name === null ? viz._drawLabel(d, i) : typeof inputs.name === "function" ? inputs.name(d, i) : inputs.name;
21
+ return measure.valueText === undefined ? name : lineLabelText(name, measure.valueText);
22
+ }
23
+ /** The labels a line shows, left end first. */ function lineEntries(inputs, d, i) {
24
+ const { viz, labelWidths } = inputs;
25
+ if (!rowLineLabelSides(viz.schema.lineLabels, d.data, d.i).length) return [];
26
+ const entries = [];
27
+ for (const side of [
28
+ "start",
29
+ "end"
30
+ ]){
31
+ const measure = labelWidths.find((l)=>l.id === d.id && (l.side ?? "end") === side);
32
+ if (!measure) continue;
33
+ const text = entryText(inputs, measure, d, i);
34
+ if (text !== false) entries.push({
35
+ side,
36
+ text,
37
+ measure
38
+ });
39
+ }
40
+ return entries;
41
+ }
42
+ /**
43
+ The bounds of a line's label past its `side` end: right of its rightmost
44
+ point (`largest` wide, text starting there) or left of its leftmost point
45
+ (text ending there), as tall as a quarter of the chart and centered on
46
+ the label's bumped y.
47
+ */ export function lineLabelBox(points, side, largest, chartHeight, bumpedY) {
48
+ const [firstX, firstY] = points[0];
49
+ const [edgeX, edgeY] = points.reduce((a, b)=>side === "end" ? b[0] >= a[0] ? b : a : b[0] < a[0] ? b : a);
50
+ const height = chartHeight / 4;
51
+ const mod = bumpedY ? edgeY - bumpedY : 0;
52
+ return {
53
+ x: edgeX - firstX - (side === "start" ? largest : 0),
54
+ y: edgeY - firstY - height / 2 - mod,
55
+ width: largest,
56
+ height
57
+ };
58
+ }
59
+ /**
60
+ The Line shape's `label` and `labelBounds` for its line labels, and the
61
+ `textAnchor` that right-aligns the labels left of a line. A line with
62
+ one label keeps a single label; one labeled at both ends takes two.
63
+ */ export function lineLabelConfig(inputs) {
64
+ const { viz, labelWidths, largestLabel, labelPositions } = inputs;
65
+ const largestStart = max(labelWidths.filter((l)=>l.side === "start"), (l)=>l.labelWidth) ?? 0;
66
+ const sidesById = new Map();
67
+ const pick = (list)=>list.length === 1 ? list[0] : list;
68
+ return {
69
+ label: (d, i)=>{
70
+ const entries = lineEntries(inputs, d, i);
71
+ sidesById.set(d.id, entries.map((e)=>e.side));
72
+ return entries.length ? pick(entries.map((e)=>e.text)) : false;
73
+ },
74
+ labelBounds: (d, i, s)=>pick(lineEntries(inputs, d, i).map(({ side })=>lineLabelBox(s.points, side, side === "start" ? largestStart : largestLabel, viz.schema.height, labelPositions[lineLabelKey(side, d.id)]))),
75
+ textAnchor: (base)=>(d, i)=>{
76
+ const rec = d.l === undefined ? d.data : d;
77
+ const id = rec?.data?.id;
78
+ if (sidesById.get(id)?.[rec?.l] === "start") return "end";
79
+ return typeof base === "function" ? base(d, i) : base;
80
+ }
81
+ };
82
+ }
@@ -0,0 +1,51 @@
1
+ /**
2
+ Pure helpers behind a Plot's `lineLabels` and `lineLabelConfig`: which
3
+ ends of a line take a label, and the value text a label can carry.
4
+
5
+ @module
6
+ */ /**
7
+ The ends a `lineLabels` value labels, left end first: `true` and `"end"`
8
+ label the right end, `"start"` the left end, `"both"` both, and
9
+ `"along"` (a label along the line) or anything falsy neither.
10
+ */ export function lineLabelSides(value) {
11
+ if (value === "along") return [];
12
+ if (value === "both") return [
13
+ "start",
14
+ "end"
15
+ ];
16
+ if (value === "start") return [
17
+ "start"
18
+ ];
19
+ return value ? [
20
+ "end"
21
+ ] : [];
22
+ }
23
+ /**
24
+ The ends `setting` labels for row `d` (index `i`): a function setting is
25
+ called with the row, any other setting applies to every row.
26
+ */ export function rowLineLabelSides(setting, d, i) {
27
+ return lineLabelSides(typeof setting === "function" ? setting(d, i) : setting);
28
+ }
29
+ /**
30
+ Whether `setting` runs row `d`'s series name along its line (`"along"`)
31
+ instead of at an end.
32
+ */ export function rowLabelsAlong(setting, d, i) {
33
+ return (typeof setting === "function" ? setting(d, i) : setting) === "along";
34
+ }
35
+ /**
36
+ A line label's value text, or `undefined` when `config` leaves values
37
+ off: `valueFormat` when set, else `format` (the y axis's own).
38
+ */ export function lineLabelValue(config, value, d, i, format) {
39
+ if (!config?.value || value === undefined || value === null) return undefined;
40
+ const text = config.valueFormat ? config.valueFormat(value, d, i) : format(value);
41
+ return text === undefined || text === null || text === "" ? undefined : `${text}`;
42
+ }
43
+ /** A line label's text: the series name, followed by its value when there is one. */ export function lineLabelText(name, value) {
44
+ return value === undefined ? `${name}` : `${name} ${value}`;
45
+ }
46
+ /**
47
+ The key a label's bumped position is stored under: the series id for the
48
+ right end, prefixed for the left end so the two ends never share one.
49
+ */ export function lineLabelKey(side, id) {
50
+ return side === "start" ? `start:${id}` : `${id}`;
51
+ }
@@ -0,0 +1,65 @@
1
+ /**
2
+ Spreads a column of labels apart so none overlap, each as close to the
3
+ position it labels as the others allow.
4
+
5
+ @module
6
+ */ /** A run of labels that touch, placed as one. */ /**
7
+ Positions for labels centered on `desired` (sorted top to bottom), each
8
+ `sizes[i]` tall, so that no two overlap and every label stays within
9
+ `bounds` (the range its center may take). Touching labels move as a
10
+ group, centered on where they want to be, so each moves as little as the
11
+ others allow. Labels that need more room than `bounds` holds are packed
12
+ from its top and run past its bottom.
13
+ */ export function spreadLabelPositions(desired, sizes, bounds) {
14
+ const n = desired.length;
15
+ if (!n) return [];
16
+ // offsets[i]: label i's center below the first label's, packed tight.
17
+ const offsets = [
18
+ 0
19
+ ];
20
+ for(let i = 1; i < n; i++)offsets.push(offsets[i - 1] + (sizes[i - 1] + sizes[i]) / 2);
21
+ const offsetFrom = (c, i)=>offsets[i] - offsets[c.start];
22
+ const bestTop = (c)=>{
23
+ let sum = 0;
24
+ for(let i = c.start; i <= c.end; i++)sum += desired[i] - offsetFrom(c, i);
25
+ return sum / (c.end - c.start + 1);
26
+ };
27
+ const clusters = [];
28
+ for(let i = 0; i < n; i++){
29
+ let c = {
30
+ start: i,
31
+ end: i,
32
+ top: desired[i]
33
+ };
34
+ for(;;){
35
+ const prev = clusters[clusters.length - 1];
36
+ if (!prev) break;
37
+ const prevBottom = prev.top + offsetFrom(prev, prev.end);
38
+ const gap = (sizes[prev.end] + sizes[c.start]) / 2;
39
+ if (c.top >= prevBottom + gap) break;
40
+ clusters.pop();
41
+ c = {
42
+ start: prev.start,
43
+ end: c.end,
44
+ top: 0
45
+ };
46
+ c.top = bestTop(c);
47
+ }
48
+ clusters.push(c);
49
+ }
50
+ const out = [];
51
+ for (const c of clusters)for(let i = c.start; i <= c.end; i++)out.push(c.top + offsetFrom(c, i));
52
+ // Keep the column inside the bounds: push down from the top, then up from
53
+ // the bottom, then down again, so a column too tall to fit starts at the top.
54
+ const [lo, hi] = [
55
+ Math.min(...bounds),
56
+ Math.max(...bounds)
57
+ ];
58
+ out[0] = Math.max(out[0], lo);
59
+ for(let i = 1; i < n; i++)out[i] = Math.max(out[i], out[i - 1] + (sizes[i - 1] + sizes[i]) / 2);
60
+ out[n - 1] = Math.min(out[n - 1], hi);
61
+ for(let i = n - 2; i >= 0; i--)out[i] = Math.min(out[i], out[i + 1] - (sizes[i] + sizes[i + 1]) / 2);
62
+ out[0] = Math.max(out[0], lo);
63
+ for(let i = 1; i < n; i++)out[i] = Math.max(out[i], out[i - 1] + (sizes[i - 1] + sizes[i]) / 2);
64
+ return out;
65
+ }
@@ -0,0 +1,282 @@
1
+ /**
2
+ Line labels along their lines (`lineLabels: "along"`): each series' name
3
+ runs along its own line, following its curve, on the stretch a scored
4
+ search finds flattest and clearest of the other lines and labels. The
5
+ text reads upright, and a series with no clear stretch goes unlabeled.
6
+ */ import { fontExists, textWidth } from "@d3plus/dom";
7
+ import { fontFamily as defaultFontFamily } from "@d3plus/text";
8
+ import { samplePath } from "@d3plus/render";
9
+ import { shapeConfigFor } from "../features/emitHelpers.js";
10
+ import { offsetPolyline, polylineD, PolylineRuler, uprightPoints } from "../features/pathLabelGeometry.js";
11
+ import { PATH_LABEL_FONT_SIZE, pathLabelNodes } from "../features/pathLabels.js";
12
+ import { rowLabelsAlong } from "./lineLabelSides.js";
13
+ /**
14
+ Obstacle points, bucketed by cell for nearest-distance lookups. Each
15
+ point may carry a tag, so a lookup can ignore the points of the line a
16
+ label sits on.
17
+ */ export class PointGrid {
18
+ cell;
19
+ cells = new Map();
20
+ /** @param cell The cell size: lookups see obstacles this far away. */ constructor(cell){
21
+ this.cell = cell;
22
+ }
23
+ /** A cell's key: its column and row, packed into one number. */ static key(cx, cy) {
24
+ return cx * 1048576 + cy;
25
+ }
26
+ /**
27
+ Adds obstacle points.
28
+ @param points The points.
29
+ @param tag A tag `nearest` can ignore them by.
30
+ */ add(points, tag = -1) {
31
+ for (const [x, y] of points){
32
+ const k = PointGrid.key(Math.floor(x / this.cell), Math.floor(y / this.cell));
33
+ const list = this.cells.get(k);
34
+ if (list) list.push([
35
+ x,
36
+ y,
37
+ tag
38
+ ]);
39
+ else this.cells.set(k, [
40
+ [
41
+ x,
42
+ y,
43
+ tag
44
+ ]
45
+ ]);
46
+ }
47
+ }
48
+ /**
49
+ The distance from `p` to its nearest obstacle within one cell, or `Infinity`.
50
+ @param p The point.
51
+ @param ignore A tag whose points are left out.
52
+ */ nearest(p, ignore) {
53
+ const cx = Math.floor(p[0] / this.cell), cy = Math.floor(p[1] / this.cell);
54
+ let best = Infinity;
55
+ for(let dx = -1; dx <= 1; dx++)for(let dy = -1; dy <= 1; dy++){
56
+ const list = this.cells.get(PointGrid.key(cx + dx, cy + dy));
57
+ if (!list) continue;
58
+ for (const [x, y, tag] of list){
59
+ if (tag !== -1 && tag === ignore) continue;
60
+ const ex = p[0] - x, ey = p[1] - y;
61
+ const d = ex * ex + ey * ey;
62
+ if (d < best) best = d;
63
+ }
64
+ }
65
+ return Math.sqrt(best);
66
+ }
67
+ }
68
+ /**
69
+ Points every `step` pixels along a polyline.
70
+ @param points The polyline.
71
+ @param step The spacing.
72
+ */ export function resample(points, step) {
73
+ const ruler = new PolylineRuler(points);
74
+ const out = [];
75
+ for(let s = 0; s <= ruler.length; s += step){
76
+ const p = ruler.at(s);
77
+ if (p) out.push(p);
78
+ }
79
+ return out;
80
+ }
81
+ /**
82
+ How much a stretch bends: the sum of its turns, in radians.
83
+ @param points The stretch.
84
+ */ export function curvature(points) {
85
+ let total = 0;
86
+ let prev = null;
87
+ for(let i = 1; i < points.length; i++){
88
+ const dx = points[i][0] - points[i - 1][0], dy = points[i][1] - points[i - 1][1];
89
+ if (!dx && !dy) continue;
90
+ const angle = Math.atan2(dy, dx);
91
+ if (prev !== null) {
92
+ let turn = Math.abs(angle - prev);
93
+ if (turn > Math.PI) turn = 2 * Math.PI - turn;
94
+ total += turn;
95
+ }
96
+ prev = angle;
97
+ }
98
+ return total;
99
+ }
100
+ /**
101
+ The points a label along `points` would cover: its baseline and two rows
102
+ above it, up to its letters' height.
103
+ @param points The upright stretch.
104
+ @param ctx The font size and lift.
105
+ */ export function labelBand(points, ctx) {
106
+ return BAND_ROWS.flatMap((f)=>bandRow(points, ctx, f));
107
+ }
108
+ /** The rows of a label's band, as fractions of its font size above its baseline. */ const BAND_ROWS = [
109
+ 0,
110
+ 0.35,
111
+ 0.7
112
+ ];
113
+ /** One row of a label's band (see `labelBand`). */ function bandRow(points, ctx, f) {
114
+ const step = Math.max(2, ctx.fontSize / 2);
115
+ return resample(offsetPolyline(points, ctx.lift + f * ctx.fontSize), step);
116
+ }
117
+ /**
118
+ A stretch's score, lower being better: how much it bends and slopes, less
119
+ a bonus for room around its label (up to `roomReach`, weighted by
120
+ `roomWeight`); null when its label would leave the
121
+ plot or come within `minClearance` of an obstacle (another line or
122
+ label, or the edges of the band it runs in).
123
+ @param points The upright stretch.
124
+ @param ctx The obstacles, plot area, and font.
125
+ */ export function scoreStretch(points, ctx) {
126
+ const { rect, minClearance = 2 } = ctx;
127
+ let clearance = Infinity;
128
+ // Row by row, so a blocked stretch stops at its first blocked row.
129
+ for (const f of BAND_ROWS)for (const p of bandRow(points, ctx, f)){
130
+ if (p[0] < rect.x0 || p[0] > rect.x1 || p[1] < rect.y0 || p[1] > rect.y1) return null;
131
+ clearance = Math.min(clearance, ctx.grid.nearest(p, ctx.ignore));
132
+ if (clearance < minClearance) return null;
133
+ }
134
+ const [x0, y0] = points[0];
135
+ const [x1, y1] = points[points.length - 1];
136
+ const slope = Math.abs(Math.atan2(y1 - y0, x1 - x0));
137
+ const { roomReach = ctx.fontSize, roomWeight = 0.5 } = ctx;
138
+ const room = Math.min(clearance, roomReach) / roomReach;
139
+ return curvature(points) * 2 + slope * 0.5 - room * roomWeight;
140
+ }
141
+ /**
142
+ The best-scoring stretch of `length` pixels along any of a line's
143
+ pieces, upright, with where it lies, or null when every stretch is
144
+ blocked or too bent.
145
+ @param pieces The line's pieces (where its data has gaps), in pixels.
146
+ @param length The stretch's length.
147
+ @param ctx The obstacles, plot area, and font.
148
+ @param allow Which stretches may be taken, by their piece and start.
149
+ */ export function bestStretchAt(pieces, length, ctx, allow) {
150
+ let best = null;
151
+ let bestScore = Infinity;
152
+ const step = Math.max(4, ctx.fontSize / 2);
153
+ const maxTurn = ctx.maxTurn ?? Math.PI / 2;
154
+ for(let index = 0; index < pieces.length; index++){
155
+ const ruler = new PolylineRuler(pieces[index]);
156
+ for(let from = 0; from + length <= ruler.length; from += step){
157
+ if (allow && !allow(from, index)) continue;
158
+ const stretch = uprightPoints(ruler.trim(from, from + length), ctx.steep);
159
+ // A label can't follow a line that doubles back under it.
160
+ if (curvature(stretch) > maxTurn) continue;
161
+ const score = scoreStretch(stretch, ctx);
162
+ if (score !== null && score < bestScore) {
163
+ bestScore = score;
164
+ best = {
165
+ points: stretch,
166
+ piece: index,
167
+ from
168
+ };
169
+ }
170
+ }
171
+ }
172
+ return best;
173
+ }
174
+ /**
175
+ The best-scoring stretch of `length` pixels along any of a line's
176
+ pieces, upright, or null when every stretch is blocked or too bent.
177
+ @param pieces The line's pieces (where its data has gaps), in pixels.
178
+ @param length The stretch's length.
179
+ @param ctx The obstacles, plot area, and font.
180
+ */ export function bestStretch(pieces, length, ctx) {
181
+ return bestStretchAt(pieces, length, ctx)?.points ?? null;
182
+ }
183
+ /** Every drawn Line's pieces, sampled into points, with the offsets of the groups around it. */ function seriesLines(nodes) {
184
+ const out = [];
185
+ const visit = (node, ox, oy)=>{
186
+ const t = node.transform ?? {};
187
+ const x = ox + (t.x ?? 0), y = oy + (t.y ?? 0);
188
+ if (node.type === "group") node.children.forEach((c)=>visit(c, x, y));
189
+ const row = node.datum;
190
+ if (node.type !== "path" || node.shapeType !== "Line" || `${node.key}`.endsWith("::hit") || row?.shape !== "Line") return;
191
+ // Each moveto starts a piece of its own (a gap in the data).
192
+ const pieces = (node.d.match(/M[^M]*/g) ?? []).map((d)=>samplePath(d).points.map(([px, py])=>[
193
+ px + x,
194
+ py + y
195
+ ])).filter((points)=>points.length > 1);
196
+ const stroke = node.paint?.stroke;
197
+ out.push({
198
+ row,
199
+ key: `${node.key}`,
200
+ color: `${stroke ?? "#444"}`,
201
+ pieces
202
+ });
203
+ };
204
+ nodes.forEach((n)=>visit(n, 0, 0));
205
+ return out;
206
+ }
207
+ /**
208
+ The label font a shape's labelConfig sets, as plain values.
209
+ @param viz The chart.
210
+ @param shape The shape whose labelConfig to read.
211
+ */ export function labelFont(viz, shape = "Line") {
212
+ const config = shapeConfigFor(viz, shape).labelConfig ?? {};
213
+ const out = {};
214
+ for (const key of [
215
+ "fontFamily",
216
+ "fontSize",
217
+ "fontWeight"
218
+ ])if (config[key] !== undefined && typeof config[key] !== "function") out[key] = config[key];
219
+ return out;
220
+ }
221
+ /**
222
+ The labels for every series `lineLabels` runs along its line, placed one
223
+ by one so each stays clear of the lines and the labels before it. A
224
+ plot (or panel) with a single line labels none. Counts the lines and
225
+ labels into `viz._alongStats`, for the legend (see `alongLegend.ts`).
226
+ @param viz The chart.
227
+ @param marks The plot's drawn marks, its Lines among them.
228
+ @param rect The plot area.
229
+ */ export function emitAlongLabels(viz, marks, rect) {
230
+ const setting = viz.schema.lineLabels;
231
+ if (!setting) return [];
232
+ const lines = seriesLines(marks);
233
+ const along = lines.filter((l)=>rowLabelsAlong(setting, l.row.data ?? l.row, l.row.i ?? 0));
234
+ const stats = viz._alongStats;
235
+ if (stats) {
236
+ stats.series += lines.length;
237
+ stats.requested += along.length;
238
+ }
239
+ // A lone line needs no name.
240
+ if (!along.length || lines.length < 2) return [];
241
+ const font = labelFont(viz);
242
+ const fontSize = font.fontSize ?? PATH_LABEL_FONT_SIZE;
243
+ const style = {
244
+ "font-family": fontExists(font.fontFamily ?? defaultFontFamily),
245
+ "font-size": fontSize,
246
+ "font-weight": font.fontWeight ?? 600
247
+ };
248
+ const grid = new PointGrid(fontSize);
249
+ for (const line of lines)for (const piece of line.pieces)grid.add(resample(piece, 2));
250
+ const ctx = {
251
+ grid,
252
+ rect,
253
+ fontSize,
254
+ lift: 3.5
255
+ };
256
+ // A series drawn as several lines (observed and predicted, say) is named
257
+ // once: its later lines count as named when an earlier one was.
258
+ const named = new Set();
259
+ const labels = along.flatMap((line)=>{
260
+ const text = `${viz._drawLabel(line.row, line.row.i ?? 0)}`;
261
+ if (named.has(text)) {
262
+ if (stats) stats.placed++;
263
+ return [];
264
+ }
265
+ const length = textWidth(text, style) + fontSize;
266
+ const stretch = bestStretch(line.pieces, length, ctx);
267
+ if (!stretch) return [];
268
+ grid.add(labelBand(stretch, ctx));
269
+ named.add(text);
270
+ if (stats) stats.placed++;
271
+ return [
272
+ {
273
+ key: `line-label-along-${line.key}`,
274
+ text,
275
+ d: polylineD(offsetPolyline(stretch, ctx.lift)),
276
+ color: line.color,
277
+ anchor: "middle"
278
+ }
279
+ ];
280
+ });
281
+ return pathLabelNodes(viz, labels, font);
282
+ }