@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,56 @@
1
+ /**
2
+ Alluvial dimensions: the `dimensions` config resolved to one accessor and
3
+ title per column, and the `colorBy` config resolved to a column index.
4
+ */ import { fieldAccessor } from "../../utils/fieldAccessor.js";
5
+ /** A dimension from one `dimensions` entry, or null for an entry that names nothing. */ function resolveOne(input) {
6
+ if (typeof input === "string") return {
7
+ accessor: fieldAccessor(input),
8
+ title: input,
9
+ key: input
10
+ };
11
+ if (typeof input === "function") return {
12
+ accessor: input,
13
+ title: ""
14
+ };
15
+ if (input && typeof input === "object" && "value" in input) {
16
+ const { value, title } = input;
17
+ const inner = resolveOne(value);
18
+ if (!inner) return null;
19
+ return typeof title === "string" ? {
20
+ ...inner,
21
+ title
22
+ } : inner;
23
+ }
24
+ return null;
25
+ }
26
+ /**
27
+ The columns `dimensions` describes, in order. Entries that are neither a
28
+ key, an accessor, nor a `{value, title}` object are skipped.
29
+ @param input The `dimensions` config.
30
+ */ export function resolveAlluvialDimensions(input) {
31
+ if (!Array.isArray(input)) return [];
32
+ return input.map(resolveOne).filter((d)=>d !== null);
33
+ }
34
+ /**
35
+ Whether a category value is missing: `undefined`, `null`, an empty
36
+ string, or `NaN`. A row missing any dimension is left out of the chart.
37
+ @param value The category value.
38
+ */ export function isMissingCategory(value) {
39
+ return value === undefined || value === null || value === "" || typeof value === "number" && isNaN(value);
40
+ }
41
+ /**
42
+ The column `colorBy` names: a column index, or a dimension's data key or
43
+ title. Anything else, or a name no dimension has, is the first column.
44
+ @param colorBy The `colorBy` config.
45
+ @param dims The resolved dimensions.
46
+ */ export function resolveColorBy(colorBy, dims) {
47
+ if (!dims.length) return 0;
48
+ if (typeof colorBy === "number" && Number.isInteger(colorBy)) return colorBy >= 0 && colorBy < dims.length ? colorBy : 0;
49
+ if (typeof colorBy === "string") {
50
+ const byKey = dims.findIndex((d)=>d.key === colorBy);
51
+ if (byKey >= 0) return byKey;
52
+ const byTitle = dims.findIndex((d)=>d.title === colorBy);
53
+ if (byTitle >= 0) return byTitle;
54
+ }
55
+ return 0;
56
+ }
@@ -0,0 +1,73 @@
1
+ /**
2
+ `alluvialEmit` — a filled ribbon per band, a rect per node with its label
3
+ beside it (Sankey's node labels), and the column titles.
4
+ */ import { formatAbbreviate } from "@d3plus/format";
5
+ import { paintFromShapeConfig, resolveAccessor, shapeConfigFor } from "../features/emitHelpers.js";
6
+ import { sankeyLabels } from "../Sankey/labels.js";
7
+ import { alluvialRibbon } from "./layout.js";
8
+ import { alluvialMeta } from "./meta.js";
9
+ import { alluvialTitleNodes } from "./titles.js";
10
+ /** A value as the chart prints it. */ export function formatAlluvialValue(viz, value) {
11
+ return formatAbbreviate(value, viz.schema.locale);
12
+ }
13
+ /** A node's label: its category, unless `shapeConfig.Rect.label` says otherwise. */ function nodeLabel(cfg) {
14
+ return (d, i)=>{
15
+ const custom = resolveAccessor(cfg.label, d, i);
16
+ if (custom !== undefined) return custom;
17
+ const meta = alluvialMeta(d);
18
+ return meta?.kind === "node" ? meta.node.label : undefined;
19
+ };
20
+ }
21
+ export const alluvialEmit = ({ viz })=>{
22
+ const c = viz.ctx.alluvial;
23
+ if (!c) return [];
24
+ const v = viz;
25
+ const out = [];
26
+ const pathCfg = shapeConfigFor(v, "Path");
27
+ const fillOpacity = Number(v.schema.bandOpacity ?? 0.5);
28
+ c.bands.forEach(({ band, datum, text }, i)=>{
29
+ const paint = paintFromShapeConfig(pathCfg, datum, i);
30
+ out.push({
31
+ type: "path",
32
+ shapeType: "Path",
33
+ key: `alluvial-band-${band.id}`,
34
+ d: alluvialRibbon(band),
35
+ datum,
36
+ index: i,
37
+ paint: {
38
+ ...paint,
39
+ fillOpacity,
40
+ opacity: paint.opacity ?? 1
41
+ },
42
+ aria: {
43
+ label: `${text}, ${formatAlluvialValue(v, band.value)}.`
44
+ }
45
+ });
46
+ });
47
+ const rectCfg = shapeConfigFor(v, "Rect");
48
+ for (const d of c.nodes){
49
+ const title = c.dims[d.node.column]?.title;
50
+ const name = title ? `${title}: ${d.node.label}` : d.node.label;
51
+ out.push({
52
+ type: "rect",
53
+ shapeType: "Rect",
54
+ key: `alluvial-node-${d.id}`,
55
+ x: d.x0,
56
+ y: d.y0,
57
+ width: d.x1 - d.x0,
58
+ height: d.y1 - d.y0,
59
+ datum: d.data,
60
+ index: d.i,
61
+ paint: paintFromShapeConfig(rectCfg, d.data, d.i),
62
+ aria: {
63
+ label: `${name}, ${formatAlluvialValue(v, d.node.value)}.`
64
+ }
65
+ });
66
+ }
67
+ out.push(...sankeyLabels(v, c.nodes, {
68
+ ...rectCfg,
69
+ label: nodeLabel(rectCfg)
70
+ }, c.width, c.height));
71
+ out.push(...alluvialTitleNodes(c.titles, c.titleStyle, v.schema.locale));
72
+ return out;
73
+ };
@@ -0,0 +1,101 @@
1
+ /**
2
+ Alluvial hover and tooltips. Hovering a band or a node highlights the
3
+ rows it carries, through every column: each band and node they pass
4
+ through. Tooltips title a band with its path and a node
5
+ with its category, then list the value and its share of the total.
6
+ */ import { formatAbbreviate } from "@d3plus/format";
7
+ import { shapeHoverEnabled } from "../viz/shapeHover.js";
8
+ import { alluvialPathText } from "./aggregate.js";
9
+ import { alluvialValueTitle } from "./applyLayout.js";
10
+ import { formatAlluvialValue } from "./emit.js";
11
+ import { alluvialMeta } from "./meta.js";
12
+ /** Whether two sets share a member. */ function intersects(a, b) {
13
+ const [small, large] = a.size <= b.size ? [
14
+ a,
15
+ b
16
+ ] : [
17
+ b,
18
+ a
19
+ ];
20
+ for (const x of small)if (large.has(x)) return true;
21
+ return false;
22
+ }
23
+ /**
24
+ The ids of the bands and nodes a hovered datum highlights, or null when
25
+ the datum is not one of the chart's bands or nodes: every band and node
26
+ that the hovered band's or node's rows pass through, in every column.
27
+ @param graph The chart's graph.
28
+ @param d The hovered datum.
29
+ */ export function alluvialHighlight(graph, d) {
30
+ const meta = alluvialMeta(d);
31
+ const paths = meta?.kind === "band" ? meta.band.paths : meta?.kind === "node" ? meta.node.paths : null;
32
+ if (!paths) return null;
33
+ const ids = new Set();
34
+ for (const band of graph.bands)if (intersects(band.paths, paths)) ids.add(band.id);
35
+ for (const node of graph.columns.flat())if (intersects(node.paths, paths)) ids.add(node.id);
36
+ return ids;
37
+ }
38
+ /** The band or node id a drawn datum stands for, if any. */ function markId(d) {
39
+ const meta = alluvialMeta(d);
40
+ if (meta?.kind === "band") return meta.band.id;
41
+ if (meta?.kind === "node") return meta.node.id;
42
+ return undefined;
43
+ }
44
+ /**
45
+ Replaces the chart's `mouseenter` handler: over a band or node it
46
+ highlights what `alluvialHighlight` names, and over anything else (a
47
+ color scale swatch) it falls back to the default handler.
48
+ @param viz The chart.
49
+ */ export function installAlluvialHover(viz) {
50
+ const base = viz.schema.on.mouseenter;
51
+ viz.schema.on.mouseenter = function(d, i, ...rest) {
52
+ const c = viz.ctx.alluvial;
53
+ const ids = c ? alluvialHighlight(c.graph, d) : null;
54
+ if (!ids) return base(d, i, ...rest);
55
+ if (!shapeHoverEnabled(viz)) return;
56
+ viz._hoverBucket = false;
57
+ viz.hover((h)=>{
58
+ const id = markId(h);
59
+ return id !== undefined && ids.has(id);
60
+ });
61
+ };
62
+ }
63
+ /** A tooltip's title: a band's path, or a node's category. */ export function alluvialTooltipTitle(viz, d, i) {
64
+ const meta = alluvialMeta(d);
65
+ const c = viz.ctx.alluvial;
66
+ if (meta?.kind === "band") return alluvialPathText(meta.band, c ? c.dims.length : 0);
67
+ if (meta?.kind === "node") return meta.node.label;
68
+ return viz._drawLabel(d, i);
69
+ }
70
+ /** A node's column title, if it has one. */ function columnTitle(viz, node) {
71
+ const c = viz.ctx.alluvial;
72
+ return c?.dims[node.column]?.title ?? "";
73
+ }
74
+ /**
75
+ A tooltip's rows for a band or node: its column's title (for a node), its
76
+ value, and its share of the chart's total. Other datums get none.
77
+ */ export function alluvialTooltipRows(viz, d) {
78
+ const meta = alluvialMeta(d);
79
+ if (meta?.kind !== "band" && meta?.kind !== "node") return [];
80
+ const c = viz.ctx.alluvial;
81
+ const value = meta.kind === "band" ? meta.band.value : meta.node.value;
82
+ const translate = viz.schema.translate;
83
+ const rows = [];
84
+ if (meta.kind === "node") {
85
+ const title = columnTitle(viz, meta.node);
86
+ if (title) rows.push([
87
+ title,
88
+ meta.node.label
89
+ ]);
90
+ }
91
+ rows.push([
92
+ alluvialValueTitle(viz),
93
+ formatAlluvialValue(viz, value)
94
+ ]);
95
+ const total = c?.graph.total ?? 0;
96
+ if (total > 0) rows.push([
97
+ translate("Share"),
98
+ `${formatAbbreviate(value / total * 100, viz.schema.locale)}%`
99
+ ]);
100
+ return rows;
101
+ }
@@ -0,0 +1,170 @@
1
+ /**
2
+ Alluvial — parallel sets: how rows flow across several categorical
3
+ dimensions, one column of category nodes per dimension.
4
+
5
+ Implementation files in this folder:
6
+ - `dimensions.ts` — resolves `dimensions` and `colorBy`.
7
+ - `aggregate.ts` — rows → nodes, bands split by origin, and paths.
8
+ - `layout.ts` — node order, node and band positions, ribbon paths.
9
+ - `titles.ts` — the column titles.
10
+ - `meta.ts` — what each drawn datum stands for, and the default `groupBy`.
11
+ - `applyLayout.ts` — chart-specific `TransformStage`.
12
+ - `emit.ts` — band ribbons, node rects and labels, column titles.
13
+ - `hover.ts` — path highlighting and tooltip content.
14
+ */ import { colorGray } from "@d3plus/color";
15
+ import { merge } from "@d3plus/data";
16
+ import constant from "../../utils/constant.js";
17
+ import { fieldAccessor } from "../../utils/fieldAccessor.js";
18
+ import { themed } from "../../utils/theme.js";
19
+ import { makeChart } from "../definition/makeChart.js";
20
+ import { simpleHover } from "../viz/simpleHover.js";
21
+ import { applyAlluvialLayout, countRows } from "./applyLayout.js";
22
+ import { isMissingCategory } from "./dimensions.js";
23
+ import { alluvialEmit } from "./emit.js";
24
+ import { alluvialTooltipRows, alluvialTooltipTitle, installAlluvialHover } from "./hover.js";
25
+ import { alluvialGroupBy, alluvialMeta, setAlluvialMeta } from "./meta.js";
26
+ /** `value`'s setter: a data key, an accessor, or a constant. */ export function alluvialValue(value) {
27
+ if (typeof value === "function") return value;
28
+ if (typeof value === "string") return fieldAccessor(value);
29
+ return constant(value);
30
+ }
31
+ /**
32
+ Drops the drawn (and legend) rows whose `colorBy` category is missing:
33
+ their rows have no origin, so the chart leaves them out.
34
+ */ function dropMissingOrigins(viz, data) {
35
+ const id = viz.schema.groupBy[0];
36
+ return data.filter((d, i)=>!isMissingCategory(id(d, i)));
37
+ }
38
+ /**
39
+ Rows merge by origin for the legend; the merged row keeps its origin and
40
+ rows, so the layout can trace each row.
41
+ */ function installRowMerging(viz) {
42
+ const groupBy = alluvialGroupBy(viz);
43
+ viz._mergeRows = (leaves)=>{
44
+ const merged = merge(leaves, viz.schema.aggs);
45
+ const index = viz._data.indexOf(leaves[0]);
46
+ return setAlluvialMeta(merged, {
47
+ kind: "group",
48
+ id: groupBy(leaves[0], index),
49
+ rows: leaves
50
+ });
51
+ };
52
+ }
53
+ export const alluvialDef = {
54
+ name: "Alluvial",
55
+ layoutStage: applyAlluvialLayout,
56
+ emit: alluvialEmit,
57
+ thresholdFunction: dropMissingOrigins,
58
+ setup: (viz)=>{
59
+ viz.schema.groupBy = [
60
+ alluvialGroupBy(viz)
61
+ ];
62
+ installRowMerging(viz);
63
+ installAlluvialHover(viz);
64
+ viz.hover = simpleHover;
65
+ },
66
+ facet: {
67
+ aspect: 3 / 2
68
+ },
69
+ ctx: {},
70
+ fields: [
71
+ /**
72
+ The fill opacity of the bands between columns.
73
+ */ {
74
+ key: "bandOpacity",
75
+ default: 0.5
76
+ },
77
+ /**
78
+ The column whose categories color the bands: a column index, or a
79
+ dimension's data key or title. Each row's band keeps its category's
80
+ color through every column, and the legend lists that column's
81
+ categories. Defaults to the first column.
82
+ @type {number | string}
83
+ */ {
84
+ key: "colorBy",
85
+ default: 0
86
+ },
87
+ /**
88
+ The categorical dimensions, one column each, left to right: data
89
+ keys, accessor functions `(d, i) => category`, or `{value, title}`
90
+ objects (`value` being a key or an accessor). A key is its column's
91
+ title; a bare accessor has none. Rows missing a category on any
92
+ dimension (`undefined`, `null`, or `""`) are left out; to keep them,
93
+ map the missing values to a category of their own with an accessor.
94
+ @type {(string | function | {value: string | function, title?: string})[]}
95
+ */ {
96
+ key: "dimensions",
97
+ default: []
98
+ },
99
+ /**
100
+ Styles the column titles above each column (any TextBox config).
101
+ @type {object}
102
+ */ {
103
+ key: "dimensionTitleConfig",
104
+ merge: true,
105
+ default: {}
106
+ },
107
+ /** The vertical gap between nodes in the same column, in pixels. */ {
108
+ key: "nodePadding",
109
+ default: 10
110
+ },
111
+ /**
112
+ How the nodes in each column are ordered, top to bottom:
113
+ `"crossings"` (the default: the first column by value, then each
114
+ column by where its flows come from, which untangles the bands),
115
+ `"value"` (largest first), `"data"` (the order categories first appear
116
+ in the data), or a comparator receiving two nodes
117
+ (`{category, column, label, value}`).
118
+ @type {"crossings" | "value" | "data" | function}
119
+ */ {
120
+ key: "nodeSort",
121
+ default: "crossings"
122
+ },
123
+ /** The width of each node, in pixels. */ {
124
+ key: "nodeWidth",
125
+ default: 16
126
+ },
127
+ /**
128
+ Each row's weight: a data key or an accessor `(d, i) => number`. Node
129
+ and band sizes sum it, so a key sums that field. Defaults to
130
+ counting rows.
131
+ @type {string | function}
132
+ */ {
133
+ key: "value",
134
+ default: countRows,
135
+ coerce: alluvialValue
136
+ },
137
+ {
138
+ key: "shapeConfig",
139
+ merge: true,
140
+ factory: (viz)=>({
141
+ Rect: {
142
+ // Nodes in the colorBy column take their category's color; the
143
+ // rest are a neutral gray.
144
+ fill: (d, i)=>{
145
+ const meta = alluvialMeta(d);
146
+ const c = viz.ctx.alluvial;
147
+ if (meta?.kind === "node" && meta.node.column !== c?.graph.colorBy) return themed(viz._theme, (t)=>t.link, colorGray[500]);
148
+ const fill = viz.schema.shapeConfig.fill;
149
+ return typeof fill === "function" ? fill(d, i) : fill;
150
+ }
151
+ }
152
+ })
153
+ },
154
+ {
155
+ key: "tooltipConfig",
156
+ merge: true,
157
+ factory: (viz)=>({
158
+ title: (d, i)=>alluvialTooltipTitle(viz, d, i),
159
+ tbody: (d)=>alluvialTooltipRows(viz, d)
160
+ })
161
+ }
162
+ ]
163
+ };
164
+ /**
165
+ Creates an alluvial (parallel sets) chart from plain data rows: one
166
+ column per entry in `dimensions`, one node per category in each column,
167
+ and bands between neighboring columns sized by how many rows (or how
168
+ much `value`) flow between each pair of categories. Each band keeps the
169
+ color of its rows' category in the `colorBy` column across every column.
170
+ */ export default makeChart(alluvialDef);
@@ -0,0 +1,137 @@
1
+ /**
2
+ Alluvial geometry: the node order within each column, each node's place
3
+ in its fixed column, each band's ends, and the ribbon drawn for a band.
4
+ */ const byFirst = (a, b)=>a.first - b.first;
5
+ const byValue = (a, b)=>b.value - a.value || byFirst(a, b);
6
+ /**
7
+ Where each node's incoming flows come from: the mean of the middles of
8
+ their source nodes, weighted by each flow's value and measured in value
9
+ units down the previous column (in its current order). A node with no
10
+ incoming flows sorts last.
11
+ @param column The nodes to place.
12
+ @param previous The previous column, already ordered.
13
+ */ export function incomingBarycenters(column, previous) {
14
+ const middles = new Map();
15
+ let y = 0;
16
+ for (const node of previous){
17
+ middles.set(node, y + node.value / 2);
18
+ y += node.value;
19
+ }
20
+ const centers = new Map();
21
+ for (const node of column){
22
+ let sum = 0;
23
+ let weight = 0;
24
+ for (const band of node.targetBands){
25
+ const middle = middles.get(band.source);
26
+ if (middle === undefined) continue;
27
+ sum += middle * band.value;
28
+ weight += band.value;
29
+ }
30
+ centers.set(node, weight ? sum / weight : Infinity);
31
+ }
32
+ return centers;
33
+ }
34
+ /**
35
+ Orders the nodes in every column by `sort` (see `AlluvialNodeSort`), and
36
+ sets each node's `rank` to its position. Ties keep the order the
37
+ categories first appeared in.
38
+ @param graph The aggregated graph; its columns are sorted in place.
39
+ @param sort The ordering.
40
+ */ export function sortAlluvialColumns(graph, sort = "crossings") {
41
+ graph.columns.forEach((column, k)=>{
42
+ if (typeof sort === "function") column.sort((a, b)=>sort(a, b) || byFirst(a, b));
43
+ else if (sort === "data") column.sort(byFirst);
44
+ else if (sort === "crossings" && k > 0) {
45
+ const centers = incomingBarycenters(column, graph.columns[k - 1]);
46
+ column.sort((a, b)=>(centers.get(a) ?? 0) - (centers.get(b) ?? 0) || byValue(a, b));
47
+ } else column.sort(byValue);
48
+ column.forEach((node, rank)=>node.rank = rank);
49
+ });
50
+ }
51
+ /**
52
+ Where each of `n` columns sits: evenly spaced across `width`, the first
53
+ flush left and the last flush right (a single column is centered). Nodes
54
+ narrow when `nodeWidth` would leave less room between columns than a node.
55
+ @param n The number of columns.
56
+ @param width The width to spread them across.
57
+ @param nodeWidth The preferred node width.
58
+ @returns Each column's left edge, and the node width.
59
+ */ export function alluvialColumns(n, width, nodeWidth) {
60
+ const w = Math.max(0, width);
61
+ const size = Math.max(1, Math.min(nodeWidth, n > 1 ? w / (2 * n - 1) : w));
62
+ const step = n > 1 ? (w - size) / (n - 1) : 0;
63
+ const x = Array.from({
64
+ length: n
65
+ }, (_, k)=>n > 1 ? k * step : (w - size) / 2);
66
+ return {
67
+ x,
68
+ nodeWidth: size
69
+ };
70
+ }
71
+ /**
72
+ Places every node and band. The columns sit where `alluvialColumns`
73
+ places them. The nodes in each column stack in rank order,
74
+ `nodePadding` apart (less when the most crowded column wouldn't fit),
75
+ centered in the space below `top`, with one value-to-pixel scale for
76
+ every column. Where bands leave a node they stack in the order of their
77
+ targets, and where they enter one in the order of their sources; bands
78
+ sharing both ends stack in the order of their origins.
79
+ @param graph The aggregated, sorted graph; its nodes and bands are positioned in place.
80
+ @param options The layout space and node sizing.
81
+ */ export function layoutAlluvial(graph, options) {
82
+ const { columns } = graph;
83
+ const n = columns.length;
84
+ if (!n) return;
85
+ const { x, nodeWidth } = alluvialColumns(n, options.width, options.nodeWidth);
86
+ const top = Math.max(0, options.top);
87
+ const space = Math.max(0, options.height - top);
88
+ const crowded = Math.max(...columns.map((c)=>c.length));
89
+ const padding = crowded > 1 ? Math.max(0, Math.min(options.nodePadding, space / 2 / (crowded - 1))) : 0;
90
+ const scales = columns.filter((c)=>c.length).map((c)=>{
91
+ const sum = c.reduce((s, d)=>s + d.value, 0);
92
+ return sum > 0 ? (space - (c.length - 1) * padding) / sum : Infinity;
93
+ });
94
+ const ky = Math.max(0, Math.min(...scales, Infinity));
95
+ const scale = Number.isFinite(ky) ? ky : 0;
96
+ columns.forEach((column, k)=>{
97
+ const x0 = x[k];
98
+ const used = column.reduce((s, d)=>s + d.value, 0) * scale + Math.max(0, column.length - 1) * padding;
99
+ let y = top + (space - used) / 2;
100
+ for (const node of column){
101
+ node.x0 = x0;
102
+ node.x1 = x0 + nodeWidth;
103
+ node.y0 = y;
104
+ node.y1 = y + node.value * scale;
105
+ y = node.y1 + padding;
106
+ }
107
+ });
108
+ const outgoing = (a, b)=>a.target.rank - b.target.rank || a.origin.rank - b.origin.rank;
109
+ const incoming = (a, b)=>a.source.rank - b.source.rank || a.origin.rank - b.origin.rank;
110
+ for (const column of columns){
111
+ for (const node of column){
112
+ let y = node.y0;
113
+ for (const band of node.sourceBands.sort(outgoing)){
114
+ band.sy0 = y;
115
+ y += band.value * scale;
116
+ band.sy1 = y;
117
+ }
118
+ y = node.y0;
119
+ for (const band of node.targetBands.sort(incoming)){
120
+ band.ty0 = y;
121
+ y += band.value * scale;
122
+ band.ty1 = y;
123
+ }
124
+ }
125
+ }
126
+ }
127
+ /**
128
+ A band's ribbon: a filled shape from its source node's right edge to its
129
+ target node's left edge, its top and bottom each an S-curve, so its
130
+ thickness at either end matches its share of the node it touches.
131
+ @param band A positioned band.
132
+ */ export function alluvialRibbon(band) {
133
+ const xs = band.source.x1;
134
+ const xt = band.target.x0;
135
+ const xm = (xs + xt) / 2;
136
+ return `M${xs},${band.sy0}C${xm},${band.sy0},${xm},${band.ty0},${xt},${band.ty0}` + `L${xt},${band.ty1}C${xm},${band.ty1},${xm},${band.sy1},${xs},${band.sy1}Z`;
137
+ }
@@ -0,0 +1,57 @@
1
+ /**
2
+ What each Alluvial datum stands for. The chart draws merged rows (a node's
3
+ rows, a band's rows) and groups rows by origin for its legend; this keeps,
4
+ beside each of those datums, which node, band, or origin it is, and the
5
+ rows it holds. The chart's default `groupBy` reads it, so every datum
6
+ reports its origin (or node) as its id and takes its color from it.
7
+ */ import { resolveAlluvialDimensions, resolveColorBy } from "./dimensions.js";
8
+ const metas = new WeakMap();
9
+ /** The role recorded for `d`, if any. */ export function alluvialMeta(d) {
10
+ return d && typeof d === "object" ? metas.get(d) : undefined;
11
+ }
12
+ /** Records `d`'s role, and returns `d`. */ export function setAlluvialMeta(d, meta) {
13
+ metas.set(d, meta);
14
+ return d;
15
+ }
16
+ /**
17
+ The source rows a drawn row stands for: a group's or a path row's rows,
18
+ or the row itself.
19
+ @param d A row from the chart's drawn rows.
20
+ */ export function sourceRows(d) {
21
+ const meta = alluvialMeta(d);
22
+ return meta && (meta.kind === "group" || meta.kind === "path") ? meta.rows : [
23
+ d
24
+ ];
25
+ }
26
+ const dimensionCache = new WeakMap();
27
+ /**
28
+ The chart's dimensions and its `colorBy` column, resolved once per change
29
+ to `dimensions` or `colorBy`.
30
+ @param viz The chart.
31
+ */ export function alluvialDimensions(viz) {
32
+ const input = viz.schema.dimensions;
33
+ const colorBy = viz.schema.colorBy;
34
+ const cached = dimensionCache.get(viz);
35
+ if (cached && cached.input === input && cached.colorBy === colorBy) return cached;
36
+ const dims = resolveAlluvialDimensions(input);
37
+ const entry = {
38
+ input,
39
+ colorBy,
40
+ dims,
41
+ k: resolveColorBy(colorBy, dims)
42
+ };
43
+ dimensionCache.set(viz, entry);
44
+ return entry;
45
+ }
46
+ /**
47
+ The chart's default `groupBy`: a datum's recorded id, or for a plain data
48
+ row its category in the `colorBy` column.
49
+ @param viz The chart.
50
+ */ export function alluvialGroupBy(viz) {
51
+ return (d, i)=>{
52
+ const meta = alluvialMeta(d);
53
+ const { dims, k } = alluvialDimensions(viz);
54
+ const id = meta ? meta.id : dims[k]?.accessor(d, i);
55
+ return id;
56
+ };
57
+ }
@@ -0,0 +1,81 @@
1
+ /**
2
+ Alluvial column titles: each dimension's title above its column, flush
3
+ with the first and last columns' outer edges and centered over the rest.
4
+ */ import { backgroundInk } from "../viz/backgroundInk.js";
5
+ import { titleHeight, titleNodes } from "../ParallelCoordinates/titles.js";
6
+ /** The space between the titles and the nodes below them, in pixels. */ export const TITLE_GAP = 8;
7
+ /**
8
+ Each titled column's title box, in chart coordinates (from y = 0, with no
9
+ height yet): a middle column's spans halfway to each neighbor, the first
10
+ column's runs from its left edge, and the last column's ends at its
11
+ right edge. Columns with an empty title get none.
12
+ @param texts Each column's title.
13
+ @param x Each column's left edge.
14
+ @param nodeWidth The node width.
15
+ @param width The chart width.
16
+ */ export function alluvialTitleBoxes(texts, x, nodeWidth, width) {
17
+ const n = texts.length;
18
+ const step = n > 1 ? x[1] - x[0] : width;
19
+ const gap = 4;
20
+ const half = Math.max(1, step / 2 - gap);
21
+ const titles = [];
22
+ texts.forEach((text, k)=>{
23
+ if (!text) return;
24
+ const center = x[k] + nodeWidth / 2;
25
+ const base = {
26
+ key: `${k}`,
27
+ text,
28
+ y: 0,
29
+ height: 0
30
+ };
31
+ if (n === 1) titles.push({
32
+ ...base,
33
+ x: 0,
34
+ width: Math.max(1, width),
35
+ anchor: "middle"
36
+ });
37
+ else if (k === 0) titles.push({
38
+ ...base,
39
+ x: x[k],
40
+ width: half + nodeWidth / 2,
41
+ anchor: "start"
42
+ });
43
+ else if (k === n - 1) titles.push({
44
+ ...base,
45
+ x: center - half,
46
+ width: half + nodeWidth / 2,
47
+ anchor: "end"
48
+ });
49
+ else titles.push({
50
+ ...base,
51
+ x: center - half,
52
+ width: half * 2,
53
+ anchor: "middle"
54
+ });
55
+ });
56
+ return titles;
57
+ }
58
+ /** The column title style: `dimensionTitleConfig` over the chart's background ink. */ export function alluvialTitleStyle(viz, titles) {
59
+ return {
60
+ fontColor: backgroundInk(viz),
61
+ fontSize: 12,
62
+ fontWeight: 600,
63
+ textAnchor: (_d, i)=>titles[i]?.anchor ?? "middle",
64
+ verticalAlign: "bottom",
65
+ ...viz.schema.dimensionTitleConfig ?? {}
66
+ };
67
+ }
68
+ /**
69
+ Sizes the title boxes to the tallest wrapped title and returns that
70
+ height (0 with no titles).
71
+ */ export function sizeAlluvialTitles(titles, style, locale) {
72
+ const height = titleHeight(titles, style, locale);
73
+ for (const t of titles)t.height = height;
74
+ return height;
75
+ }
76
+ /** The title text nodes: chrome, so no datum and no pointer events. */ export function alluvialTitleNodes(titles, style, locale) {
77
+ return titleNodes(titles, style, locale).map((node)=>({
78
+ ...node,
79
+ key: `alluvial-${String(node.key)}`
80
+ }));
81
+ }