@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,11 +1,12 @@
1
1
  /**
2
2
  Scene nodes for Plot's shared tooltip (#779): the transparent hover surface,
3
3
  the crosshair (drawn as a Line annotation), and markers on the hovered Line
4
- points.
4
+ points; and the axis hover's guides and badges (#782).
5
5
  */ import { collectComputed, makeShape } from "../features/emitHelpers.js";
6
6
  import { collectAnnotationGroup, renderPlotAnnotation } from "../features/plotAnnotations.js";
7
7
  import { PLOT_ZOOM_CONTENT_KEY } from "../features/plotPaint.js";
8
8
  import { hasSharedMarks } from "./sharedHover.js";
9
+ import { axisHoverNodes } from "./axisHoverScene.js";
9
10
  import { isDomainClip } from "./domainClip.js";
10
11
  import { withFacetPanel } from "../facet/facetPanel.js";
11
12
  import { prefixKeys } from "../facet/facetScene.js";
@@ -75,34 +76,38 @@ import { prefixKeys } from "../facet/facetScene.js";
75
76
  return !!n.shapeType && !n.interactionGroup && n.interactive !== false && !!datum && datum.id !== undefined;
76
77
  };
77
78
  /**
78
- Places the crosshair behind the first data mark ("back") or after every
79
- mark ("front"), then the markers on top. Returns a fresh array — `nodes` may
80
- be `_chartScene` itself, which must not accumulate per-paint nodes.
81
- */ function layer(nodes, crosshair, markers, side) {
79
+ Places the guides (the crosshair and any axis-hover guides) behind the
80
+ first data mark ("back") or after every mark ("front"), then the markers
81
+ on top. Returns a fresh array — `nodes` may be `_chartScene` itself, which
82
+ must not accumulate per-paint nodes.
83
+ */ function layer(nodes, guides, markers, side) {
82
84
  const out = [
83
85
  ...nodes
84
86
  ];
85
- if (crosshair) {
87
+ if (guides.length) {
86
88
  const first = out.findIndex((n)=>isMark(n) || isDomainClip(n) && n.children.some(isMark));
87
- if (side === "back" && first >= 0) out.splice(first, 0, crosshair);
88
- else out.push(crosshair);
89
+ if (side === "back" && first >= 0) out.splice(first, 0, ...guides);
90
+ else out.push(...guides);
89
91
  }
90
92
  out.push(...markers);
91
93
  return out;
92
94
  }
93
95
  /**
94
- The hover nodes for one chart body's children: with `tooltipShared`, a
95
- transparent hover surface behind the marks, so the SVG backend receives
96
- pointer events over empty plot space; and — while a hover is active — the
97
- crosshair and the hovered Line markers, inside the zoom-clipped plot
98
- content when the chart is zoomable. `key` maps a node key to its key in
99
- this body (small-multiples panels prefix theirs).
100
- */ function decorateBody(viz, nodes, state, key) {
96
+ The hover nodes for one chart body's children: with `tooltipShared` on a
97
+ chart with a discrete axis, a transparent hover surface behind the marks,
98
+ so the SVG backend receives pointer events over empty plot space; and —
99
+ while a hover is active — the crosshair, the hovered Line markers, and the
100
+ axis hover's guides, inside the zoom-clipped plot content when the chart
101
+ is zoomable, with its badges over the axes. `key` maps a node key to its
102
+ key in this body (small-multiples panels prefix theirs).
103
+ */ function decorateBody(viz, nodes, hover, key) {
101
104
  const area = viz._plotArea;
102
105
  if (!area) return nodes;
106
+ const { state, axis } = hover;
107
+ const discrete = viz.schema.discrete === "x" || viz.schema.discrete === "y";
103
108
  // The surface is only needed for shared hovers over empty space; a single
104
109
  // hover (tooltipShared off) needs the pointer on a mark anyway.
105
- const surface = viz.schema.tooltipShared && hasSharedMarks(viz) ? [
110
+ const surface = discrete && viz.schema.tooltipShared && hasSharedMarks(viz) ? [
106
111
  {
107
112
  type: "rect",
108
113
  key: key("plot-hover-surface"),
@@ -114,12 +119,17 @@ import { prefixKeys } from "../facet/facetScene.js";
114
119
  }
115
120
  ] : [];
116
121
  let children = nodes;
117
- if (state) {
118
- const rekey = (n)=>n && prefixKeys([
119
- n
120
- ], key)[0];
121
- const crosshair = rekey(crosshairAnnotation(viz, state));
122
- const markers = prefixKeys(hoverMarkers(viz, state), key);
122
+ const crosshair = state && discrete ? crosshairAnnotation(viz, state) : null;
123
+ const axisNodes = axis ? axisHoverNodes(viz, axis) : null;
124
+ const guides = prefixKeys([
125
+ ...crosshair ? [
126
+ crosshair
127
+ ] : [],
128
+ ...axisNodes ? axisNodes.guides : []
129
+ ], key);
130
+ const markers = prefixKeys(state && discrete ? hoverMarkers(viz, state) : [], key);
131
+ if (guides.length || markers.length) {
132
+ const side = state ? state.layer : "back";
123
133
  const content = children.findIndex((n)=>n.key === key(PLOT_ZOOM_CONTENT_KEY));
124
134
  if (content >= 0) {
125
135
  const group = children[content];
@@ -128,13 +138,15 @@ import { prefixKeys } from "../facet/facetScene.js";
128
138
  ];
129
139
  children[content] = {
130
140
  ...group,
131
- children: layer(group.children || [], crosshair, markers, state.layer)
141
+ children: layer(group.children || [], guides, markers, side)
132
142
  };
133
- } else children = layer(children, crosshair, markers, state.layer);
143
+ } else children = layer(children, guides, markers, side);
134
144
  }
145
+ const badges = axisNodes ? prefixKeys(axisNodes.badges, key) : [];
135
146
  return [
136
147
  ...surface,
137
- ...children
148
+ ...children,
149
+ ...badges
138
150
  ];
139
151
  }
140
152
  /**
@@ -148,7 +160,11 @@ import { prefixKeys } from "../facet/facetScene.js";
148
160
  const body = cells && cells.children && cells.children[0];
149
161
  if (!cells || !body || !body.children) return group;
150
162
  const state = viz._sharedHoverState;
151
- const children = withFacetPanel(viz, panel, ()=>decorateBody(viz, body.children, state && state.panel === panel.key ? state : null, (k)=>`${panel.key}/${k}`));
163
+ const axis = viz._axisHoverState;
164
+ const children = withFacetPanel(viz, panel, ()=>decorateBody(viz, body.children, {
165
+ state: state && state.panel === panel.key ? state : null,
166
+ axis: axis && axis.panel === panel.key ? axis : null
167
+ }, (k)=>`${panel.key}/${k}`));
152
168
  const next = [
153
169
  ...kids
154
170
  ];
@@ -168,12 +184,12 @@ import { prefixKeys } from "../facet/facetScene.js";
168
184
  };
169
185
  }
170
186
  /**
171
- Adds the snapped hover's scene nodes (see `decorateBody`) to the chart
172
- body group (content space, so they track zoom) — to each panel's body
173
- when the chart is drawn as small multiples.
187
+ Adds the hover's scene nodes (see `decorateBody`) to the chart body group
188
+ (content space, so they track zoom) — to each panel's body when the chart
189
+ is drawn as small multiples.
174
190
  */ export function appendSharedHoverNodes(viz, scene) {
175
191
  const discrete = viz.schema.discrete;
176
- if (discrete !== "x" && discrete !== "y") return;
192
+ if (discrete !== "x" && discrete !== "y" && !viz._axisHoverState) return;
177
193
  const cells = scene.root.children.find((n)=>n.key === "viz-chart-cells");
178
194
  const zoom = cells && cells.children && cells.children[0];
179
195
  const body = zoom && zoom.children && zoom.children[0];
@@ -184,5 +200,8 @@ import { prefixKeys } from "../facet/facetScene.js";
184
200
  const panel = panels.find((p)=>p.key === group.key);
185
201
  return panel ? decoratePanel(viz, group, panel) : group;
186
202
  });
187
- } else body.children = decorateBody(viz, body.children, viz._sharedHoverState, (k)=>k);
203
+ } else body.children = decorateBody(viz, body.children, {
204
+ state: viz._sharedHoverState,
205
+ axis: viz._axisHoverState
206
+ }, (k)=>k);
188
207
  }
@@ -7,6 +7,7 @@ import { axisDateLabel, isValidDate, parseTime } from "../../components/Axis/tim
7
7
  import { axisIsYearLike, formatYear } from "../../components/Axis/yearValues.js";
8
8
  import { configPrep } from "../../utils/index.js";
9
9
  import { leadTitleWithSwatch, tooltipSwatch, withSwatch } from "../features/tooltipSwatch.js";
10
+ import { thresholdMemberRows } from "../features/thresholdMembers.js";
10
11
  import { confidenceRows, confidenceSuffix, rangeSuffix } from "./confidenceTooltip.js";
11
12
  const other = (k)=>k === "x" ? "y" : "x";
12
13
  /** An axis's display name: its configured title, else its data key. */ export function axisName(viz, k) {
@@ -134,27 +135,37 @@ const other = (k)=>k === "x" ? "y" : "x";
134
135
  names: hover.rows.map((r)=>r.projected && !all ? `${r.name}${label}` : r.name)
135
136
  };
136
137
  }
138
+ /**
139
+ How many of a threshold bucket's series the shared tooltip lists under
140
+ its row: fewer than a single-mark tooltip, since every other series has
141
+ a row of its own beside them.
142
+ */ export const SHARED_MEMBER_LIMIT = 5;
137
143
  /**
138
144
  The shared tooltip: title from the continuous axis, a header row naming
139
145
  the hovered discrete value, then one `[name, value]` row per series, the
140
146
  name led by a swatch in its series stroke and the value followed by its
141
- `confidence` range. User `tooltipConfig` styles apply first; the shared
142
- title/rows win.
147
+ `confidence` range, and a threshold bucket's series listed under its row.
148
+ User `tooltipConfig` styles apply first; the shared title/rows win.
143
149
  */ export function renderSharedTooltip(viz, hover, event) {
144
150
  const cont = other(hover.axis);
145
151
  const { header, names } = markProjected(viz, hover);
146
152
  prepareTooltip(viz).data([
147
153
  hover.rows[0].datum
148
- ]).config(configPrep.bind(viz)(viz.schema.tooltipConfig)).title(()=>axisName(viz, cont)).thead(header).tbody(hover.rows.map((r, i)=>[
149
- withSwatch(tooltipSwatch(r.color, r.shape), names[i]),
150
- `${axisValue(viz, cont, r.value)}${bounds(viz, cont, r)}`
154
+ ]).config(configPrep.bind(viz)(viz.schema.tooltipConfig)).title(()=>axisName(viz, cont)).thead(header).tbody(hover.rows.flatMap((r, i)=>[
155
+ [
156
+ withSwatch(tooltipSwatch(r.color, r.shape), names[i]),
157
+ `${axisValue(viz, cont, r.value)}${bounds(viz, cont, r)}`
158
+ ],
159
+ // A threshold bucket's series, under its row.
160
+ ...thresholdMemberRows(viz, r.datum, SHARED_MEMBER_LIMIT)
151
161
  ])).footer(false).arrow(false).position(snappedPosition(viz, hover, event)).render();
152
162
  }
153
163
  /**
154
164
  The single-mark tooltip (one series, `tooltipShared(false)`, or a
155
165
  side-by-side bar): the default title (the mark's label, unless
156
166
  `tooltipConfig` sets one), its x and y values, its `confidence` bounds,
157
- then any rows the chart's `tooltipConfig` adds.
167
+ then any rows the chart's `tooltipConfig` adds, and a threshold bucket's
168
+ series.
158
169
  */ export function renderSingleTooltip(viz, hover, event) {
159
170
  const row = hover.rows[0];
160
171
  const deeper = viz._drawDepth < viz.schema.groupBy.length - 1;
@@ -170,6 +181,7 @@ const other = (k)=>k === "x" ? "y" : "x";
170
181
  axisRow(viz, "y", hover)
171
182
  ],
172
183
  ...row.projected ? [] : confidenceRows(viz, row.datum, row.index, (v)=>axisValue(viz, other(hover.axis), v)),
173
- ...Array.isArray(extra) ? extra : []
184
+ ...Array.isArray(extra) ? extra : [],
185
+ ...thresholdMemberRows(viz, row.datum)
174
186
  ]).arrow(false).position(snappedPosition(viz, hover, event)).render();
175
187
  }
@@ -8,6 +8,7 @@
8
8
  pipeline applies: a tagged comparator or an array of series keys.
9
9
  */ import * as d3Shape from "d3-shape";
10
10
  import accessor from "../../utils/accessor.js";
11
+ import { markField } from "../../utils/fieldAccessor.js";
11
12
  /** Marks a comparator as an already-resolved d3plus stack order. */ function tagOrder(fn) {
12
13
  fn.__d3plusStackOrder = true;
13
14
  return fn;
@@ -65,6 +66,16 @@ const asStack = (series)=>series;
65
66
  return d3Shape.stackOrderNone(asStack(series)).sort((a, b)=>order === "ascending" ? totals[a] - totals[b] : totals[b] - totals[a]);
66
67
  });
67
68
  }
69
+ /**
70
+ Wraps a stack order so the series in `last` sit at the top of the stack,
71
+ in the order `order` gives them, above every other series.
72
+ */ export function orderLast(order, last) {
73
+ return (series)=>{
74
+ const ranked = order(series);
75
+ const isLast = (i)=>last.has(series[i].key);
76
+ return ranked.filter((i)=>!isLast(i)).concat(ranked.filter(isLast));
77
+ };
78
+ }
68
79
  /** Named stack orders accepted by `Plot.stackOrder`. */ const NAMED_ORDERS = {
69
80
  ascending: stackOrderTotalAscending,
70
81
  descending: stackOrderTotalDescending,
@@ -90,7 +101,8 @@ const asStack = (series)=>series;
90
101
  if (Array.isArray(input)) return input;
91
102
  if (input && typeof input === "object") {
92
103
  const { value, order } = input;
93
- return stackOrderField(typeof value === "function" ? value : accessor(value), order);
104
+ if (typeof value === "function") return stackOrderField(value, order);
105
+ return markField(stackOrderField(accessor(value), order), value);
94
106
  }
95
107
  if (typeof input === "string") {
96
108
  if (input in NAMED_ORDERS) return NAMED_ORDERS[input];
@@ -0,0 +1,176 @@
1
+ /**
2
+ A stacked Plot's legend order: its series in stacking order, from the
3
+ baseline outward, so the default `"descending"` order lists the largest
4
+ series first. The order is d3-stack's own (each drawn series' `index`),
5
+ which the chart's `stackOrder` sets, whatever the `stackOffset` does
6
+ with it: a diverging stack's negative series and a streamgraph's
7
+ centered layers keep the order they were stacked in.
8
+
9
+ @module
10
+ */ /**
11
+ Where each series sits in the drawn stacks. Each stack (one per discrete
12
+ group) lists its non-empty segments in stacking order (each series'
13
+ d3-stack `index`, else its place in `stackData`), and each segment adds
14
+ its fractional position, `(rank + 0.5) / segments`, to its series. A
15
+ stacked bar keys each segment as its own series, so this also averages
16
+ bars that stack in different orders.
17
+ @param stackData The d3-stack output, `[series][group] = [start, end]`.
18
+ @param stackKeys Each series' stack key, in `stackData` order.
19
+ @param seriesOf The legend series a stack key belongs to; undefined skips it.
20
+ */ export function stackPositions(stackData, stackKeys, seriesOf) {
21
+ const positions = new Map();
22
+ const groups = Math.max(0, ...stackData.map((s)=>s.length));
23
+ for(let j = 0; j < groups; j++){
24
+ const segments = [];
25
+ stackData.forEach((s, i)=>{
26
+ const segment = s[j];
27
+ const series = seriesOf(`${stackKeys[i]}`);
28
+ if (!segment || series === undefined) return;
29
+ const [start, end] = [
30
+ +segment[0],
31
+ +segment[1]
32
+ ];
33
+ if (!Number.isFinite(start) || !Number.isFinite(end) || start === end) return;
34
+ segments.push({
35
+ series,
36
+ order: s.index ?? i
37
+ });
38
+ });
39
+ segments.sort((a, b)=>a.order - b.order);
40
+ segments.forEach(({ series }, rank)=>{
41
+ const entry = positions.get(series) ?? {
42
+ total: 0,
43
+ count: 0
44
+ };
45
+ entry.total += (rank + 0.5) / segments.length;
46
+ entry.count += 1;
47
+ positions.set(series, entry);
48
+ });
49
+ }
50
+ return positions;
51
+ }
52
+ /**
53
+ Combines the positions of several sets of stacks (such as each small
54
+ multiple's) into one.
55
+ @param all Each set's positions.
56
+ */ export function poolStackPositions(all) {
57
+ const pooled = new Map();
58
+ for (const positions of all){
59
+ positions.forEach(({ total, count }, series)=>{
60
+ const entry = pooled.get(series) ?? {
61
+ total: 0,
62
+ count: 0
63
+ };
64
+ pooled.set(series, {
65
+ total: entry.total + total,
66
+ count: entry.count + count
67
+ });
68
+ });
69
+ }
70
+ return pooled;
71
+ }
72
+ /**
73
+ The series in reading order: by mean position, ties in the order the
74
+ positions list them.
75
+ @param positions Each series' stack positions.
76
+ */ export function stackReadingOrder(positions) {
77
+ const mean = (s)=>{
78
+ const { total, count } = positions.get(s);
79
+ return total / count;
80
+ };
81
+ return Array.from(positions.keys()).sort((a, b)=>mean(a) - mean(b));
82
+ }
83
+ /**
84
+ The drawn order with the series it left out (hidden or soloed away)
85
+ kept in their previous place: each follows the series it followed
86
+ before, so hiding a series doesn't move it in the legend.
87
+ @param previous The order of the previous draw.
88
+ @param drawn The order of this draw.
89
+ @param keep The series still in the legend; others in `previous` drop out.
90
+ */ export function mergeStackOrder(previous, drawn, keep) {
91
+ const out = drawn.slice();
92
+ const placed = new Set(drawn);
93
+ let anchor;
94
+ for (const series of previous){
95
+ if (!placed.has(series)) {
96
+ if (!keep.has(series)) continue;
97
+ const at = anchor === undefined ? 0 : out.indexOf(anchor) + 1;
98
+ out.splice(at, 0, series);
99
+ placed.add(series);
100
+ }
101
+ anchor = series;
102
+ }
103
+ return out;
104
+ }
105
+ /**
106
+ The ids of the Plot series a row or legend entry stands for: its groupBy
107
+ values down to the drawn depth, joined like a Plot row's `id`. A legend
108
+ entry merging several series (an array at some level) stands for each
109
+ combination.
110
+ @param viz The chart.
111
+ @param d A row or legend entry.
112
+ @param i Its index.
113
+ */ export function plotSeriesIds(viz, d, i) {
114
+ let ids = [
115
+ []
116
+ ];
117
+ const depth = viz._drawDepth ?? 0;
118
+ for(let level = 0; level <= depth; level++){
119
+ const groupBy = viz.schema.groupBy?.[level];
120
+ if (typeof groupBy !== "function") break;
121
+ const value = groupBy.bind(viz)(d, i);
122
+ const values = (Array.isArray(value) ? value : [
123
+ value
124
+ ]).map((v)=>`${v}`).filter(Boolean);
125
+ if (!values.length) continue;
126
+ ids = ids.flatMap((path)=>values.map((v)=>[
127
+ ...path,
128
+ v
129
+ ]));
130
+ }
131
+ return ids.map((path)=>path.join("_"));
132
+ }
133
+ /**
134
+ Records a draw's stack positions as the legend's order (see
135
+ `stackLegendSort`), keeping series the draw left out where they were.
136
+ Undefined positions (an unstacked draw) clear it.
137
+ @param viz The chart.
138
+ @param positions The draw's stack positions.
139
+ */ export function recordStackLegendOrder(viz, positions) {
140
+ if (!positions?.size) {
141
+ viz._stackLegendOrder = undefined;
142
+ return;
143
+ }
144
+ const keep = new Set((viz._legendData ?? []).flatMap((d, i)=>plotSeriesIds(viz, d, i)));
145
+ viz._stackLegendOrder = mergeStackOrder(viz._stackLegendOrder ?? [], stackReadingOrder(positions), keep);
146
+ }
147
+ /**
148
+ A stacked Plot's default legend comparator: entries in the order of
149
+ `viz._stackLegendOrder` (an entry merging several series sits at their
150
+ mean place), then the entries the stacks don't place, with ties broken
151
+ by `fallback`. An unstacked chart sorts by `fallback` alone.
152
+ @param viz The chart.
153
+ @param fallback The comparator for everything the stack order doesn't settle.
154
+ */ export function stackLegendSort(viz, fallback) {
155
+ let cached;
156
+ let index = new Map();
157
+ const place = (d)=>{
158
+ const ranks = plotSeriesIds(viz, d, 0).map((id)=>index.get(id)).filter((r)=>r !== undefined);
159
+ return ranks.length ? ranks.reduce((a, b)=>a + b, 0) / ranks.length : Infinity;
160
+ };
161
+ return (a, b)=>{
162
+ const order = viz.schema.stacked ? viz._stackLegendOrder : undefined;
163
+ if (order?.length) {
164
+ if (order !== cached) {
165
+ cached = order;
166
+ index = new Map(order.map((id, rank)=>[
167
+ id,
168
+ rank
169
+ ]));
170
+ }
171
+ const pa = place(a), pb = place(b);
172
+ if (pa !== pb) return pa < pb ? -1 : 1;
173
+ }
174
+ return fallback(a, b);
175
+ };
176
+ }
@@ -3,7 +3,7 @@
3
3
  BarChart), reading the share that `computePlotInitialDomains` stamps on
4
4
  each stacked datum.
5
5
  */ import { formatAbbreviate } from "@d3plus/format";
6
- import { shareOf } from "../features/shareKey.js";
6
+ import { shareOf, shareOfRows, unwrapRow } from "../features/shareKey.js";
7
7
  /**
8
8
  A `tooltipConfig` default whose `tbody` resolves per hover, so the Share
9
9
  row only appears while the chart is stacked.
@@ -11,9 +11,14 @@ import { shareOf } from "../features/shareKey.js";
11
11
  const row = [
12
12
  ()=>viz.schema.translate("Share"),
13
13
  (_d, _i, x)=>{
14
- // A legend swatch aggregates a series across every discrete position,
15
- // so its merged share is an array with no meaningful total.
16
- const share = shareOf(x);
14
+ const row = unwrapRow(x);
15
+ let share = shareOf(row);
16
+ // A legend entry merges a series over every discrete position, so its
17
+ // share is of the whole chart: of every legend row's stacked value.
18
+ if (!Number.isFinite(share)) {
19
+ const value = viz[`_${viz.schema.discrete === "y" ? "x" : "y"}`];
20
+ share = row ? shareOfRows(row, viz._legendData || [], value) : NaN;
21
+ }
17
22
  if (!Number.isFinite(share)) return "";
18
23
  return `${formatAbbreviate(share * 100, viz.schema.locale)}%`;
19
24
  }
@@ -0,0 +1,154 @@
1
+ /**
2
+ `threshold` on stacked Plot charts: the series whose summed value, over
3
+ every position on the discrete axis, is under `threshold` of the chart's
4
+ total fold into one bucket series. Membership is decided once for the
5
+ whole chart, so a series is in the bucket at every position or at none.
6
+ */ import { merge } from "@d3plus/data";
7
+ import { MEMBERS_KEY, thresholdMemberList } from "../features/thresholdMembers.js";
8
+ /** A value's comparison key: arrays by their items, Dates by their time. */ const valueKey = (v)=>Array.isArray(v) ? v.map(valueKey).join("\u0001") : v instanceof Date ? +v : v;
9
+ /**
10
+ The fields that name a series rather than a point on it, merged over the
11
+ bucket's series: every non-numeric field that holds one value along each
12
+ series and is not a row's position. Every bucket row carries them, so the
13
+ bucket keeps one id, label, and color at every position, whichever of
14
+ its series have a row there.
15
+ */ export function seriesIdentity(series, position, aggs) {
16
+ const keys = new Set();
17
+ series.forEach((rows)=>rows.forEach((d)=>Object.keys(d).forEach((k)=>keys.add(k))));
18
+ const identityKeys = Array.from(keys).filter((k)=>series.every((rows)=>{
19
+ let first;
20
+ return rows.every((d, i)=>{
21
+ const v = d[k];
22
+ if (typeof v === "number") return false;
23
+ const key = valueKey(v);
24
+ if (position.some((p)=>valueKey(p(d, i)) === key)) return false;
25
+ if (i === 0) first = key;
26
+ return key === first;
27
+ });
28
+ }));
29
+ const reps = series.filter((rows)=>rows.length).map((rows)=>{
30
+ const rep = {};
31
+ for (const k of identityKeys)rep[k] = rows[0][k];
32
+ return rep;
33
+ });
34
+ return merge(reps, aggs);
35
+ }
36
+ /**
37
+ The bucket for `rows`: the series whose summed absolute `value` is under
38
+ `threshold` of the summed absolute value of every row. Null when the
39
+ threshold is off (0 or not a number) or fewer than two series fall
40
+ under it: a lone small series stays as itself.
41
+ */ export function stackThresholdBucket(rows, inputs) {
42
+ const { aggs, id, position, threshold, value } = inputs;
43
+ const percent = Math.min(1, Math.max(0, +threshold(rows)));
44
+ if (!(percent > 0)) return null;
45
+ const totals = new Map();
46
+ const series = new Map();
47
+ let grand = 0;
48
+ rows.forEach((d, i)=>{
49
+ const key = `${id(d, i)}`;
50
+ const v = Math.abs(+value(d, i)) || 0;
51
+ totals.set(key, (totals.get(key) ?? 0) + v);
52
+ const list = series.get(key);
53
+ if (list) list.push(d);
54
+ else series.set(key, [
55
+ d
56
+ ]);
57
+ grand += v;
58
+ });
59
+ if (!(grand > 0)) return null;
60
+ const members = new Set();
61
+ totals.forEach((total, key)=>{
62
+ if (total < percent * grand) members.add(key);
63
+ });
64
+ if (members.size < 2) return null;
65
+ const identity = seriesIdentity(Array.from(members, (key)=>series.get(key)), position, aggs);
66
+ return {
67
+ members,
68
+ percent,
69
+ identity
70
+ };
71
+ }
72
+ /**
73
+ Replaces the rows of the bucket's series with one bucket row per
74
+ position: their merged values at that position, the bucket's
75
+ series-level fields, the `_isAggregation` / `_threshold` flags the
76
+ threshold label reads, and its series' values there (largest first,
77
+ under `MEMBERS_KEY`). The bucket rows come after every kept row.
78
+ */ export function foldStackRows(rows, bucket, inputs) {
79
+ const { aggs, id, position } = inputs;
80
+ const label = inputs.label ?? id;
81
+ const measure = inputs.measure ?? inputs.value;
82
+ const kept = [];
83
+ const folded = new Map();
84
+ rows.forEach((d, i)=>{
85
+ if (!bucket.members.has(`${id(d, i)}`)) {
86
+ kept.push(d);
87
+ return;
88
+ }
89
+ const at = position.map((p)=>`${valueKey(p(d, i))}`).join("\u0002");
90
+ const list = folded.get(at);
91
+ if (list) list.push(d);
92
+ else folded.set(at, [
93
+ d
94
+ ]);
95
+ });
96
+ if (!folded.size) return rows;
97
+ const merged = Array.from(folded.values(), (group)=>{
98
+ const row = merge(group, aggs);
99
+ // The fields holding the position keep it, rather than summing it.
100
+ const first = group[0];
101
+ const at = position.map((p)=>valueKey(p(first, 0)));
102
+ for (const k of Object.keys(first)){
103
+ if (at.some((v)=>group.every((d)=>valueKey(d[k]) === v))) row[k] = first[k];
104
+ }
105
+ return {
106
+ ...row,
107
+ ...bucket.identity,
108
+ _isAggregation: true,
109
+ _threshold: bucket.percent,
110
+ [MEMBERS_KEY]: thresholdMemberList(group, id, label, measure)
111
+ };
112
+ });
113
+ return kept.concat(merged);
114
+ }
115
+ /** The bucket inputs a stacked Plot reads: its series, positions, and stacked value. */ export function plotStackInputs(viz) {
116
+ const discrete = viz.schema.discrete === "y" ? "y" : "x";
117
+ const opp = discrete === "x" ? "y" : "x";
118
+ const position = [
119
+ viz[`_${discrete}`]
120
+ ];
121
+ if (viz.schema.time) position.push(viz.schema.time);
122
+ return {
123
+ aggs: viz.schema.aggs,
124
+ id: viz._id,
125
+ label: viz._drawLabel,
126
+ measure: viz[`_${opp}`],
127
+ position,
128
+ threshold: viz.schema.threshold,
129
+ value: viz.schema.thresholdKey ?? viz[`_${opp}`]
130
+ };
131
+ }
132
+ /**
133
+ A stacked Plot's `threshold`: folds `data` (the drawn rows) into a bucket
134
+ series, deciding the bucket's series from `all` (every row, legend-hidden
135
+ ones included, so hiding a series doesn't move others in or out of the
136
+ bucket). Returns `data` unchanged when the chart isn't stacked.
137
+ */ export function plotStackThreshold(viz, data, all = data) {
138
+ if (!viz.schema.stacked) return data;
139
+ const inputs = plotStackInputs(viz);
140
+ const bucket = stackThresholdBucket(all, inputs);
141
+ return bucket ? foldStackRows(data, bucket, inputs) : data;
142
+ }
143
+ /**
144
+ The legend rows of a stacked Plot with its threshold bucket folded into
145
+ one entry, so the legend shows the bucket instead of its series.
146
+ */ export function plotStackThresholdLegend(viz, legendData) {
147
+ if (!viz.schema.stacked || !legendData.length) return legendData;
148
+ const inputs = plotStackInputs(viz);
149
+ const bucket = stackThresholdBucket(legendData, inputs);
150
+ return bucket ? foldStackRows(legendData, bucket, {
151
+ ...inputs,
152
+ position: []
153
+ }) : legendData;
154
+ }