@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
@@ -0,0 +1,333 @@
1
+ /**
2
+ Stacked area labels along their bands (`labelPosition: "along"`, the
3
+ default for stacked areas): each series' name runs along its band's
4
+ centerline, on the stretch where the band is thick enough for the text
5
+ and flattest, in a color that reads on the band's fill. The font shrinks
6
+ to fit a thinner band, and a band too thin for its name everywhere goes
7
+ unlabeled.
8
+ */ import { rgb } from "d3-color";
9
+ import { colorContrast } from "@d3plus/color";
10
+ import { fontExists, textWidth } from "@d3plus/dom";
11
+ import { fontFamily as defaultFontFamily } from "@d3plus/text";
12
+ import { samplePath } from "@d3plus/render";
13
+ import { shapeConfigFor, userLabelConfig } from "../features/emitHelpers.js";
14
+ import { offsetPolyline, polylineD } from "../features/pathLabelGeometry.js";
15
+ import { pathLabelNodes } from "../features/pathLabels.js";
16
+ import { chartBackground } from "../viz/backgroundInk.js";
17
+ import { outsideBaselineBreak } from "./baselineBreak.js";
18
+ import { bestStretch, labelFont, PointGrid } from "./lineLabelsAlong.js";
19
+ /** The room a label keeps from its band's edges, above and below it together. */ export const AREA_LABEL_PADDING = 4;
20
+ /** The along label's weight when the Area's labelConfig sets none: the box labels' regular weight. */ export const AREA_LABEL_FONT_WEIGHT = 400;
21
+ /** How far past a label, in font sizes, more room in its band still scores better. */ const ROOM_REACH = 1.5;
22
+ /** The largest along label when the Area's labelConfig sets no `fontSize` or `fontMax`. */ export const AREA_LABEL_FONT_MAX = 16;
23
+ /** The smallest along label, whatever lower `fontMin` the Area's labelConfig sets. */ export const AREA_LABEL_FONT_MIN = 8;
24
+ /**
25
+ Whether a `labelPosition` value runs a stacked area's label along its
26
+ band: `"along"` and `"auto"` (or anything unrecognized) do, `"inside"`
27
+ and `"outside"` keep it in the band's largest box.
28
+ @param position The row's `labelPosition`.
29
+ */ export function labelsAlongBand(position) {
30
+ return position !== "inside" && position !== "outside";
31
+ }
32
+ /**
33
+ The centerline of a band: at every `step` pixels along `axis` (0 for a
34
+ band running along x, 1 along y), the midpoint between the band's two
35
+ edges there, and the distance between them.
36
+ @param outline The band's closed outline.
37
+ @param axis The axis the band runs along.
38
+ @param step The spacing of the centerline's points.
39
+ */ export function bandSections(outline, axis = 0, step = 3) {
40
+ if (outline.length < 3) return [];
41
+ const other = axis ? 0 : 1;
42
+ let lo = Infinity, hi = -Infinity;
43
+ for (const p of outline){
44
+ lo = Math.min(lo, p[axis]);
45
+ hi = Math.max(hi, p[axis]);
46
+ }
47
+ if (!(hi > lo)) return [];
48
+ const count = Math.ceil((hi - lo) / step);
49
+ const gap = (hi - lo) / count;
50
+ const near = new Array(count + 1).fill(Infinity);
51
+ const far = new Array(count + 1).fill(-Infinity);
52
+ const mark = (k, v)=>{
53
+ near[k] = Math.min(near[k], v);
54
+ far[k] = Math.max(far[k], v);
55
+ };
56
+ for(let i = 1; i < outline.length; i++){
57
+ const a = outline[i - 1], b = outline[i];
58
+ const span = b[axis] - a[axis];
59
+ const from = Math.ceil((Math.min(a[axis], b[axis]) - lo) / gap - 1e-9);
60
+ const to = Math.floor((Math.max(a[axis], b[axis]) - lo) / gap + 1e-9);
61
+ for(let k = from; k <= to; k++){
62
+ if (!span) {
63
+ mark(k, a[other]);
64
+ mark(k, b[other]);
65
+ } else {
66
+ const t = (lo + k * gap - a[axis]) / span;
67
+ mark(k, a[other] + t * (b[other] - a[other]));
68
+ }
69
+ }
70
+ }
71
+ const out = [];
72
+ near.forEach((v, k)=>{
73
+ if (v > far[k]) return;
74
+ const mid = (v + far[k]) / 2;
75
+ const at = lo + k * gap;
76
+ out.push({
77
+ point: axis ? [
78
+ mid,
79
+ at
80
+ ] : [
81
+ at,
82
+ mid
83
+ ],
84
+ thickness: far[k] - v
85
+ });
86
+ });
87
+ return out;
88
+ }
89
+ /**
90
+ The runs of a band's centerline where the band is at least `min` thick:
91
+ the only places a label that needs that much room can sit.
92
+ @param sections The band's sections (see `bandSections`).
93
+ @param min The least thickness.
94
+ */ export function thickRuns(sections, min) {
95
+ const runs = [];
96
+ let run = [];
97
+ for (const s of sections){
98
+ if (s.thickness >= min) run.push(s.point);
99
+ else {
100
+ if (run.length > 1) runs.push(run);
101
+ run = [];
102
+ }
103
+ }
104
+ if (run.length > 1) runs.push(run);
105
+ return runs;
106
+ }
107
+ /**
108
+ The polyline with points added along every segment longer than `step`,
109
+ so no stretch of it is more than `step` pixels from a point.
110
+ @param points The polyline.
111
+ @param step The longest gap left between points.
112
+ */ export function densify(points, step) {
113
+ const out = points.slice(0, 1);
114
+ for(let i = 1; i < points.length; i++){
115
+ const [ax, ay] = points[i - 1];
116
+ const [bx, by] = points[i];
117
+ const n = Math.ceil(Math.hypot(bx - ax, by - ay) / step);
118
+ for(let k = 1; k <= n; k++)out.push([
119
+ ax + (bx - ax) * k / n,
120
+ ay + (by - ay) * k / n
121
+ ]);
122
+ }
123
+ return out;
124
+ }
125
+ /**
126
+ The font sizes to try for an along label, largest first: from `fontSize`
127
+ (or `fontMax`) down to `fontMin`, a pixel at a time, stopping at
128
+ `AREA_LABEL_FONT_MIN` however low `fontMin` goes (unless `fontSize`
129
+ itself is smaller).
130
+ @param config The Area's labelConfig.
131
+ */ export function labelSizes(config = {}) {
132
+ const num = (v)=>typeof v === "number" && Number.isFinite(v) && v > 0 ? v : undefined;
133
+ const max = num(config.fontSize) ?? num(config.fontMax) ?? AREA_LABEL_FONT_MAX;
134
+ const floor = Math.max(num(config.fontMin) ?? 0, AREA_LABEL_FONT_MIN);
135
+ const min = Math.min(max, floor);
136
+ const sizes = [];
137
+ for(let s = max; s >= min; s--)sizes.push(s);
138
+ if (sizes[sizes.length - 1] !== min) sizes.push(min);
139
+ return sizes;
140
+ }
141
+ /**
142
+ The text color of a band's label: the `fontColor` a user's labelConfig
143
+ sets (a color, or an accessor of the band's datum and index), else the
144
+ color that contrasts with the band.
145
+ @param fontColor The user's `fontColor`, if any.
146
+ @param datum The band's datum.
147
+ @param index The band's index.
148
+ @param fill The color the band shows.
149
+ @param colorDefaults The chart's `colorDefaults`, for the contrast.
150
+ */ export function bandTextColor(fontColor, datum, index, fill, colorDefaults) {
151
+ const own = typeof fontColor === "function" ? fontColor(datum, index) : fontColor;
152
+ if (typeof own === "string" && own) return own;
153
+ return colorContrast(fill, colorDefaults);
154
+ }
155
+ /**
156
+ The font weight of a band's label: the Area labelConfig's `fontWeight`
157
+ (a weight, or an accessor of the band's datum and index), the same one
158
+ its box label would take, else regular.
159
+ @param fontWeight The labelConfig's `fontWeight`, if any.
160
+ @param datum The band's datum.
161
+ @param index The band's index.
162
+ */ export function bandFontWeight(fontWeight, datum, index) {
163
+ const own = typeof fontWeight === "function" ? fontWeight(datum, index) : fontWeight;
164
+ return typeof own === "number" || typeof own === "string" && own ? own : AREA_LABEL_FONT_WEIGHT;
165
+ }
166
+ /**
167
+ The best stretch of a band's centerline for its label, at the largest
168
+ font size that fits: a stretch where the band is at least the font size
169
+ plus `AREA_LABEL_PADDING` thick under the whole label and inside the
170
+ plot, scored toward where the band is thickest and flattest. Null when
171
+ no size fits anywhere.
172
+ @param outlines The band's closed outlines (one per run of defined data).
173
+ @param width The label's width at a font size.
174
+ @param sizes The font sizes to try, largest first.
175
+ @param rect The plot area.
176
+ @param axis The axis the band runs along.
177
+ */ export function placeBandLabel(outlines, width, sizes, rect, axis = 0) {
178
+ const sections = outlines.map((o)=>bandSections(o, axis));
179
+ const thickest = Math.max(0, ...sections.flat().map((s)=>s.thickness));
180
+ if (!sizes.length) return null;
181
+ const grid = new PointGrid(Math.max(...sizes) * ROOM_REACH);
182
+ for (const outline of outlines)grid.add(densify(outline, 2));
183
+ for (const fontSize of sizes){
184
+ // A band is no thicker across its slope than straight across its axis,
185
+ // so only the runs that thick need scoring.
186
+ const need = fontSize + AREA_LABEL_PADDING;
187
+ if (need > thickest) continue;
188
+ const runs = sections.flatMap((s)=>thickRuns(s, need));
189
+ // The glyphs, 0.2em below the baseline to 0.8em above it, center on the
190
+ // centerline, and keep half the padding from either edge.
191
+ const ctx = {
192
+ grid,
193
+ rect,
194
+ fontSize,
195
+ lift: -0.3 * fontSize,
196
+ minClearance: 0.2 * fontSize + AREA_LABEL_PADDING / 2,
197
+ roomReach: fontSize * ROOM_REACH,
198
+ roomWeight: 1.5,
199
+ // Bands running up the chart read bottom to top within 25° of upright.
200
+ steep: axis ? Math.tan(25 * Math.PI / 180) : undefined
201
+ };
202
+ const stretch = bestStretch(runs, width(fontSize) + fontSize, ctx);
203
+ if (stretch) return {
204
+ points: offsetPolyline(stretch, ctx.lift),
205
+ fontSize
206
+ };
207
+ }
208
+ return null;
209
+ }
210
+ /**
211
+ The color a band shows: its fill, laid over the chart's background at
212
+ its opacity.
213
+ @param fill The band's fill.
214
+ @param opacity Its fill opacity.
215
+ @param background The chart's background.
216
+ */ export function bandColor(fill, opacity, background) {
217
+ if (opacity >= 1) return fill;
218
+ const f = rgb(fill), b = rgb(background);
219
+ if (Number.isNaN(f.r) || Number.isNaN(b.r)) return fill;
220
+ const mix = (x, y)=>x * opacity + y * (1 - opacity);
221
+ return rgb(mix(f.r, b.r), mix(f.g, b.g), mix(f.b, b.b)).formatHex();
222
+ }
223
+ /** Every drawn Area with a datum, sampled into outlines in the plot's coordinates. */ function drawnBands(nodes, background) {
224
+ const out = [];
225
+ const visit = (node, ox, oy)=>{
226
+ const t = node.transform ?? {};
227
+ const x = ox + (t.x ?? 0), y = oy + (t.y ?? 0);
228
+ if (node.type === "group") node.children.forEach((c)=>visit(c, x, y));
229
+ if (node.type !== "path" || node.shapeType !== "Area" || !node.datum || `${node.key}`.endsWith("::hit")) return;
230
+ const outlines = (node.d.match(/M[^M]*/g) ?? []).map((d)=>samplePath(d).points.map(([px, py])=>[
231
+ px + x,
232
+ py + y
233
+ ])).filter((points)=>points.length > 2);
234
+ const paint = node.paint ?? {};
235
+ const opacity = (typeof paint.fillOpacity === "number" ? paint.fillOpacity : 1) * (typeof paint.opacity === "number" ? paint.opacity : 1);
236
+ out.push({
237
+ datum: node.datum,
238
+ index: node.index ?? 0,
239
+ key: `${node.key}`,
240
+ outlines,
241
+ fill: bandColor(`${paint.fill ?? "#444"}`, opacity, background)
242
+ });
243
+ };
244
+ nodes.forEach((n)=>visit(n, 0, 0));
245
+ return out;
246
+ }
247
+ /** A label's text from the Area's `label` accessor, or null for none. */ function labelText(label, d, i) {
248
+ let text = typeof label === "function" ? label(d, i) : label;
249
+ if (Array.isArray(text)) text = text[0];
250
+ if (text === false || text === null || text === undefined || text === "") return null;
251
+ return `${text}`;
252
+ }
253
+ /**
254
+ The labels along every stacked area band whose `labelPosition` runs it
255
+ along (see `labelsAlongBand`), each in the text the Area's `label` gives.
256
+ Counts the bands and labels into `viz._alongStats`, for the legend.
257
+ @param viz The chart.
258
+ @param marks The plot's drawn marks, its Areas among them.
259
+ @param rect The plot area.
260
+ */ export function emitAreaLabels(viz, marks, rect) {
261
+ if (!viz.schema.stacked) return [];
262
+ const background = chartBackground(viz);
263
+ const bands = drawnBands(marks, background);
264
+ if (!bands.length) return [];
265
+ const config = shapeConfigFor(viz, "Area");
266
+ const { fontColor } = userLabelConfig(viz, "Area");
267
+ const font = labelFont(viz, "Area");
268
+ const labelConfig = config.labelConfig ?? {};
269
+ const sizes = labelSizes(labelConfig);
270
+ const family = fontExists(font.fontFamily ?? defaultFontFamily);
271
+ const axis = viz.schema.discrete === "y" ? 1 : 0;
272
+ const position = viz.schema.labelPosition;
273
+ // Counted for the legend (see `alongLegend.ts`).
274
+ const stats = viz._alongStats;
275
+ if (stats) stats.series += bands.length;
276
+ const labels = bands.flatMap((band)=>{
277
+ const row = band.datum.data ?? band.datum;
278
+ const where = typeof position === "function" ? position(row, band.index) : position;
279
+ if (!labelsAlongBand(where)) return [];
280
+ const text = labelText(config.label, band.datum, band.index);
281
+ if (!text) return [];
282
+ if (stats) stats.requested++;
283
+ const fontWeight = bandFontWeight(labelConfig.fontWeight, band.datum, band.index);
284
+ const style = {
285
+ "font-family": family,
286
+ "font-weight": fontWeight
287
+ };
288
+ const outlines = band.outlines.map((o)=>outsideBaselineBreak(viz, o));
289
+ const placed = placeBandLabel(outlines, (fontSize)=>textWidth(text, {
290
+ ...style,
291
+ "font-size": fontSize
292
+ }), sizes, rect, axis);
293
+ if (!placed) return [];
294
+ if (stats) stats.placed++;
295
+ return [
296
+ {
297
+ key: `area-label-along-${band.key}`,
298
+ text,
299
+ d: polylineD(placed.points),
300
+ color: bandTextColor(fontColor, band.datum, band.index, band.fill, viz.schema.colorDefaults),
301
+ anchor: "middle",
302
+ datum: band.datum,
303
+ index: band.index,
304
+ fontSize: placed.fontSize,
305
+ fontWeight
306
+ }
307
+ ];
308
+ });
309
+ return pathLabelNodes(viz, labels, {
310
+ ...font,
311
+ fontColor: (d)=>d.color,
312
+ fontSize: (d)=>d.fontSize,
313
+ fontWeight: (d)=>d.fontWeight
314
+ }, {
315
+ halo: false
316
+ });
317
+ }
318
+ /**
319
+ Wraps a stacked Area's `label` accessor so the bands labeled along their
320
+ centerline (see `emitAreaLabels`) draw no label of their own.
321
+ @param viz The chart.
322
+ @param label The Area's `label` accessor.
323
+ */ export function boxLabelsOnly(viz, label) {
324
+ return (d, i)=>{
325
+ const wrapped = d;
326
+ const row = wrapped.__d3plus__ && wrapped.data ? wrapped.data : d;
327
+ const index = typeof wrapped.i === "number" ? wrapped.i : i;
328
+ const position = viz.schema.labelPosition;
329
+ const where = typeof position === "function" ? position(row, index) : position;
330
+ if (labelsAlongBand(where)) return false;
331
+ return typeof label === "function" ? label(d, i) : label;
332
+ };
333
+ }
@@ -0,0 +1,180 @@
1
+ /**
2
+ Axis hover for Plot charts (#782): hovering a mark draws a dashed guide
3
+ from its point to each axis and a badge on the axis with the point's
4
+ value there, formatted as the tooltip formats that axis. With a discrete
5
+ axis it follows the snapped hover (see `sharedHover.ts`): the crosshair is
6
+ the discrete axis's guide, and the value axis gets the hovered (or
7
+ nearest) series' point.
8
+ */ import { nodeColor, ownerNode } from "../features/tooltipSwatch.js";
9
+ import { facetPanelAt } from "../facet/facetPanel.js";
10
+ import { anchorAxes, closestAnchor, collectAnchors, isAnchorMark, liftAnchor, markAnchors, nearestAnchor } from "./axisHoverAnchors.js";
11
+ import { contentPoint, labeledMark } from "./sharedHover.js";
12
+ import { axisValue } from "./sharedTooltip.js";
13
+ /** Pixels a point may sit outside the plot area and still count as shown. */ const SLACK = 1;
14
+ /** Where a value lands on a Plot axis (its position functions take raw values). */ const place = (position, value, axis)=>position(value, axis);
15
+ /**
16
+ The value an axis reads at `pixel`: the record's own value when it is
17
+ drawn there, else the scale inverted at the pixel (a stacked mark's top
18
+ sits at the stack's running total, not its own value).
19
+ @param value The record's value on the axis.
20
+ @param position Where `value` lands on the axis.
21
+ @param pixel Where the anchor sits on the axis.
22
+ @param invert The axis's pixel → value mapping, when it has one.
23
+ */ export function axisValueAt(value, position, pixel, invert) {
24
+ if (Number.isFinite(position) && Math.abs(position - pixel) <= SLACK) return value;
25
+ return invert ? invert(pixel) : value;
26
+ }
27
+ /**
28
+ A badge's text for `value`, as plain text: `value` run through `format`,
29
+ with any markup removed. Empty for a missing value.
30
+ @param format The axis's value formatter.
31
+ @param value The value to label.
32
+ */ export function formatAxisValue(format, value) {
33
+ if (value === undefined || value === null) return "";
34
+ if (typeof value === "number" && !Number.isFinite(value)) return "";
35
+ const text = format ? format(value) : `${value}`;
36
+ return `${text ?? ""}`.replace(/<[^>]*>/g, "").trim();
37
+ }
38
+ /** The pixel → value mapping of a Plot axis, offset the way its position function is. */ function axisInvert(viz, name, position, sample) {
39
+ const scale = viz[`_${name}Axis`]?._d3Scale;
40
+ if (!scale || typeof scale.invert !== "function") return undefined;
41
+ const offset = place(position, sample, name) - scale(sample);
42
+ if (!Number.isFinite(offset)) return undefined;
43
+ return (px)=>scale.invert(px - offset);
44
+ }
45
+ /**
46
+ An Area's anchor moved from its baseline to its top edge: its value's
47
+ position, or on a stacked chart the stack's running total there.
48
+ */ function areaAnchor(viz, anchor, valueAxis) {
49
+ if (anchor.shape !== "Area") return anchor;
50
+ const name = anchor.datum[`${valueAxis}2`] !== undefined ? `${valueAxis}2` : valueAxis;
51
+ const position = valueAxis === "x" ? viz._xFunc : viz._yFunc;
52
+ const value = Number(anchor.datum[name]);
53
+ if (!position || !Number.isFinite(value)) return anchor;
54
+ if (!viz.schema.stacked) return liftAnchor(anchor, place(position, value, name), valueAxis);
55
+ const invert = axisInvert(viz, name, position, value);
56
+ const low = invert ? Number(invert(anchor[valueAxis])) : NaN;
57
+ if (!Number.isFinite(low)) return anchor;
58
+ return liftAnchor(anchor, place(position, low + value, name), valueAxis);
59
+ }
60
+ /** The chart's discrete axis, when it has one. */ function discreteAxis(viz) {
61
+ const discrete = viz.schema.discrete;
62
+ return discrete === "x" || discrete === "y" ? discrete : undefined;
63
+ }
64
+ /** Whether a point sits in the plot area (within a pixel). */ function shown(viz, point) {
65
+ const a = viz._plotArea;
66
+ if (!a) return false;
67
+ return point.x >= a.x - SLACK && point.x <= a.x + a.width + SLACK && point.y >= a.y - SLACK && point.y <= a.y + a.height + SLACK;
68
+ }
69
+ /**
70
+ The hovered point of a mark plotted against a secondary value axis, which
71
+ the snapped hover doesn't read: the mark's point nearest the cursor along
72
+ the discrete axis.
73
+ */ function secondaryAnchor(viz, mark, discrete, cursor) {
74
+ const valueAxis = discrete === "x" ? "y" : "x";
75
+ const anchors = markAnchors(mark, valueAxis, nodeColor(viz, mark));
76
+ if (!anchors.length || anchors[0].datum[`${valueAxis}2`] === undefined) return null;
77
+ return nearestAnchor(anchors.map((a)=>areaAnchor(viz, a, valueAxis)), discrete, cursor[discrete === "x" ? 0 : 1]);
78
+ }
79
+ /**
80
+ The anchor a hover resolves to. With a discrete axis it follows the
81
+ snapped hover: among the marks at its position, the hovered mark's (when
82
+ a single mark is hovered), else the one nearest the cursor; a mark the
83
+ snapped hover skips (see `secondaryAnchor`) reads its own point. Without
84
+ a discrete axis it's the hovered mark's point nearest the cursor.
85
+ */ function hoveredAnchor(viz, event, cursor) {
86
+ const discrete = discreteAxis(viz);
87
+ const picked = event.pick ? event.pick.node : undefined;
88
+ const mark = ownerNode(viz, labeledMark(viz, picked) ?? picked);
89
+ const onMark = isAnchorMark(mark);
90
+ if (discrete) {
91
+ const state = viz._sharedHoverState;
92
+ if (!state) return onMark ? secondaryAnchor(viz, mark, discrete, cursor) : null;
93
+ const id = state.mode === "single" && onMark ? String(mark.datum.id) : undefined;
94
+ const valueAxis = discrete === "x" ? "y" : "x";
95
+ const column = collectAnchors(viz).map((a)=>areaAnchor(viz, a, valueAxis)).filter((a)=>Math.abs(a[discrete] - state.px) <= SLACK && (id === undefined || String(a.datum.id) === id));
96
+ const cross = discrete === "x" ? "y" : "x";
97
+ return nearestAnchor(column, cross, cursor[cross === "x" ? 0 : 1]);
98
+ }
99
+ if (!onMark) return null;
100
+ const anchors = markAnchors(mark, "y", nodeColor(viz, mark));
101
+ return closestAnchor(anchors.map((a)=>areaAnchor(viz, a, "y")), cursor);
102
+ }
103
+ /**
104
+ Resolves the axis hover for a pointer event (see the module notes), or
105
+ null when nothing is hovered, the point is outside the plot area, or no
106
+ axis has a value to show.
107
+ @param viz The Plot.
108
+ @param event The pointer event.
109
+ @param cursor The pointer in chart content space.
110
+ */ export function resolveAxisHover(viz, event, cursor) {
111
+ const anchor = hoveredAnchor(viz, event, cursor);
112
+ if (!anchor || !shown(viz, anchor)) return null;
113
+ const discrete = discreteAxis(viz);
114
+ const state = discrete ? viz._sharedHoverState : null;
115
+ const setting = viz.schema.axisHover;
116
+ const axes = anchorAxes(anchor.datum, {
117
+ discrete,
118
+ bar: anchor.shape === "Bar",
119
+ cross: viz._swarm?.cross,
120
+ only: setting === "x" || setting === "y" ? setting : undefined
121
+ });
122
+ const badges = [];
123
+ for (const axis of axes){
124
+ const dim = axis.charAt(0);
125
+ const snapped = !!state && dim === discrete;
126
+ const at = snapped ? state.px : anchor[dim];
127
+ const position = dim === "x" ? viz._xFunc : viz._yFunc;
128
+ const raw = snapped ? state.value : anchor.datum[axis];
129
+ const value = snapped || !position ? raw : axisValueAt(raw, place(position, raw, axis), at, axisInvert(viz, axis, position, raw));
130
+ const text = formatAxisValue((v)=>axisValue(viz, axis, v), value);
131
+ if (text) badges.push({
132
+ axis,
133
+ at,
134
+ text,
135
+ guide: !snapped
136
+ });
137
+ }
138
+ if (!badges.length) return null;
139
+ const row = anchor.datum.data || anchor.datum;
140
+ return {
141
+ point: {
142
+ x: anchor.x,
143
+ y: anchor.y
144
+ },
145
+ color: anchor.color,
146
+ datum: row,
147
+ index: typeof anchor.datum.i === "number" ? anchor.datum.i : 0,
148
+ badges
149
+ };
150
+ }
151
+ /** A string that changes whenever the drawn hover would. */ const signature = (s)=>s ? JSON.stringify([
152
+ s.point,
153
+ s.color,
154
+ s.panel,
155
+ s.badges
156
+ ]) : "";
157
+ /**
158
+ Plot's axis hover handler, run after the snapped hover resolves: tracks
159
+ the hovered point across moves and clears when the pointer leaves it,
160
+ repainting only when what it draws changes. Off with `axisHover(false)`.
161
+ @param viz The Plot.
162
+ @param event The pointer event.
163
+ */ export function handleAxisHover(viz, event) {
164
+ let next = null;
165
+ if (event.type === "mousemove" || event.type === "mouseenter") {
166
+ if (viz._transitionEndsAt && Date.now() < viz._transitionEndsAt) return;
167
+ const pick = event.pick?.node;
168
+ if (viz.schema.axisHover !== false && viz._plotArea && Array.isArray(event.point) && !(pick && pick.interactionGroup === "legend")) {
169
+ next = resolveAxisHover(viz, event, contentPoint(viz, event.point));
170
+ if (next) {
171
+ const panel = facetPanelAt(viz, event.point)?.key;
172
+ if (panel !== undefined) next.panel = panel;
173
+ }
174
+ }
175
+ } else if (event.type !== "mouseleave") return;
176
+ const prev = viz._axisHoverState;
177
+ if (signature(prev) === signature(next)) return;
178
+ viz._axisHoverState = next;
179
+ viz._scheduleSceneRepaint();
180
+ }
@@ -0,0 +1,174 @@
1
+ /**
2
+ The points a Plot's axis hover (#782) can snap to: a Line/Area's points, a
3
+ Circle's center, and a Bar's end, read from the painted chart scene.
4
+ */ import { nodeColor } from "../features/tooltipSwatch.js";
5
+ /** Nodes drawn on behalf of another mark (hit targets, stems, error bars). */ const OWNED = /::(hit|stem|confidence)$/;
6
+ /**
7
+ Which edge of a bar's rect is its end: the edge farther from the bar's
8
+ base, which its transform sits on (a negative bar runs the other way).
9
+ @param offset The rect's start along the value axis, relative to the base.
10
+ @param length The rect's size along the value axis.
11
+ */ export function barEndOffset(offset, length) {
12
+ return Math.abs(offset) >= Math.abs(offset + length) ? offset : offset + length;
13
+ }
14
+ /**
15
+ Moves an anchor along its value axis to `end`, spanning from where it was
16
+ (an Area's points sit on its baseline; its value is drawn at its top edge).
17
+ @param anchor The anchor.
18
+ @param end Its end along the value axis.
19
+ @param valueAxis The axis the mark's values run along.
20
+ */ export function liftAnchor(anchor, end, valueAxis) {
21
+ if (!Number.isFinite(end)) return anchor;
22
+ return {
23
+ ...anchor,
24
+ [valueAxis]: end,
25
+ span: [
26
+ anchor[valueAxis],
27
+ end
28
+ ]
29
+ };
30
+ }
31
+ /**
32
+ The anchors one mark node draws: each of a Line/Area's interaction points
33
+ (an Area's sit on its baseline, see `liftAnchor`), a circle's center, a Bar's end (along `valueAxis`), or another rect's
34
+ center. Nodes without a source datum, and those drawn for another mark,
35
+ have none.
36
+ @param node The mark's scene node.
37
+ @param valueAxis The axis a Bar's length runs along.
38
+ @param color The mark's color.
39
+ */ export function markAnchors(node, valueAxis, color) {
40
+ const n = node;
41
+ const datum = n.datum;
42
+ if (!datum || typeof n.key === "string" && OWNED.test(n.key)) return [];
43
+ const shape = n.shapeType;
44
+ if (n.interactionPoints) return n.interactionPoints.map((p)=>({
45
+ x: p.x,
46
+ y: p.y,
47
+ datum: p.datum,
48
+ color,
49
+ shape
50
+ }));
51
+ const tx = n.transform?.x ?? 0, ty = n.transform?.y ?? 0;
52
+ if (n.type === "circle") return [
53
+ {
54
+ x: tx + (n.cx ?? 0),
55
+ y: ty + (n.cy ?? 0),
56
+ datum,
57
+ color,
58
+ shape
59
+ }
60
+ ];
61
+ if (n.type !== "rect") return [];
62
+ const x = n.x ?? 0, y = n.y ?? 0, w = n.width ?? 0, h = n.height ?? 0;
63
+ if (shape !== "Bar") return [
64
+ {
65
+ x: tx + x + w / 2,
66
+ y: ty + y + h / 2,
67
+ datum,
68
+ color,
69
+ shape
70
+ }
71
+ ];
72
+ if (valueAxis === "x") {
73
+ const end = tx + barEndOffset(x, w);
74
+ return [
75
+ {
76
+ x: end,
77
+ y: ty + y + h / 2,
78
+ datum,
79
+ color,
80
+ shape,
81
+ span: [
82
+ tx,
83
+ end
84
+ ]
85
+ }
86
+ ];
87
+ }
88
+ const end = ty + barEndOffset(y, h);
89
+ return [
90
+ {
91
+ x: tx + x + w / 2,
92
+ y: end,
93
+ datum,
94
+ color,
95
+ shape,
96
+ span: [
97
+ ty,
98
+ end
99
+ ]
100
+ }
101
+ ];
102
+ }
103
+ /** Whether a scene node is a data mark the axis hover reads. */ export function isAnchorMark(node) {
104
+ return !!node && !!node.shapeType && !!node.datum && node.shapeType !== "Box" && !node.interactionGroup && node.interactive !== false && !node.datum.__d3plusShape__;
105
+ }
106
+ /** Every anchor the chart's marks draw (see `markAnchors`). */ export function collectAnchors(viz) {
107
+ const valueAxis = viz.schema.discrete === "y" ? "x" : "y";
108
+ const out = [];
109
+ const walk = (node)=>{
110
+ if (node.interactionGroup || node.interactive === false) return;
111
+ if (node.children) node.children.forEach((c)=>walk(c));
112
+ if (isAnchorMark(node)) out.push(...markAnchors(node, valueAxis, nodeColor(viz, node)));
113
+ };
114
+ (viz._chartScene || []).forEach((node)=>walk(node));
115
+ return out;
116
+ }
117
+ /**
118
+ The anchor nearest `target` along one axis. A bar holding the target
119
+ within its span counts as no distance away.
120
+ @param anchors The candidates.
121
+ @param axis The axis the distance is measured along.
122
+ @param target The position, in chart content space.
123
+ */ export function nearestAnchor(anchors, axis, target) {
124
+ let best = null;
125
+ let bestDist = Infinity;
126
+ for (const a of anchors){
127
+ const span = a.span;
128
+ const inside = span && target >= Math.min(span[0], span[1]) && target <= Math.max(span[0], span[1]);
129
+ const dist = inside ? 0 : Math.abs(a[axis] - target);
130
+ if (dist < bestDist) {
131
+ bestDist = dist;
132
+ best = a;
133
+ }
134
+ }
135
+ return best;
136
+ }
137
+ /**
138
+ The anchor nearest a point in both directions.
139
+ @param anchors The candidates.
140
+ @param point The position, in chart content space.
141
+ */ export function closestAnchor(anchors, point) {
142
+ let best = null;
143
+ let bestDist = Infinity;
144
+ for (const a of anchors){
145
+ const dist = Math.hypot(a.x - point[0], a.y - point[1]);
146
+ if (dist < bestDist) {
147
+ bestDist = dist;
148
+ best = a;
149
+ }
150
+ }
151
+ return best;
152
+ }
153
+ /**
154
+ The axes a hovered anchor gets a guide and badge on: x and y, each the
155
+ secondary axis when the record is plotted against it. A bar leaves out its
156
+ discrete axis (its band is labeled already), a swarm leaves out the axis
157
+ its circles are packed along, and `only` keeps just one direction.
158
+ @param datum The anchor's record.
159
+ @param options `discrete`: the chart's discrete axis; `bar`: whether the
160
+ anchor is a Bar's end; `cross`: a swarm's packing axis; `only`: the one
161
+ direction to keep (`axisHover: "x"` or `"y"`).
162
+ */ export function anchorAxes(datum, options) {
163
+ const out = [];
164
+ for (const dim of [
165
+ "x",
166
+ "y"
167
+ ]){
168
+ if (options.bar && dim === (options.discrete ?? "x")) continue;
169
+ if (options.cross === dim) continue;
170
+ if (options.only && options.only !== dim) continue;
171
+ out.push(datum[`${dim}2`] !== undefined ? `${dim}2` : dim);
172
+ }
173
+ return out;
174
+ }