@d3plus/core 4.10.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 (548) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +167 -8
  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 +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +3 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +2 -1
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +162 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +132 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +204 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +3 -3
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Network/applyLayout.js +138 -94
  70. package/es/src/charts/Network/bundle.js +81 -0
  71. package/es/src/charts/Network/clusterLabels.js +423 -0
  72. package/es/src/charts/Network/clusters.js +290 -0
  73. package/es/src/charts/Network/emit.js +253 -70
  74. package/es/src/charts/Network/graph.js +117 -0
  75. package/es/src/charts/Network/graphFluent.js +79 -0
  76. package/es/src/charts/Network/index.js +86 -106
  77. package/es/src/charts/Network/minNodeDistance.js +64 -0
  78. package/es/src/charts/Network/polygonRows.js +44 -0
  79. package/es/src/charts/Pack/index.js +5 -1
  80. package/es/src/charts/Pie/applyLayout.js +86 -27
  81. package/es/src/charts/Pie/arcFit.js +152 -0
  82. package/es/src/charts/Pie/curvedLabels.js +134 -0
  83. package/es/src/charts/Pie/emit.js +43 -96
  84. package/es/src/charts/Pie/index.js +64 -31
  85. package/es/src/charts/Pie/labelRoom.js +154 -0
  86. package/es/src/charts/Pie/outsideLabels.js +224 -0
  87. package/es/src/charts/Pie/outsideNodes.js +267 -0
  88. package/es/src/charts/Pie/pieLabels.js +137 -0
  89. package/es/src/charts/Pie/sectorBox.js +223 -0
  90. package/es/src/charts/Pie/straightLabels.js +96 -0
  91. package/es/src/charts/Pie/straightLayout.js +215 -0
  92. package/es/src/charts/Plot/alongLegend.js +76 -0
  93. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  94. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  95. package/es/src/charts/Plot/axisValues.js +43 -0
  96. package/es/src/charts/Plot/barWidth.js +59 -11
  97. package/es/src/charts/Plot/circleLabels.js +98 -0
  98. package/es/src/charts/Plot/connectGaps.js +237 -0
  99. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  100. package/es/src/charts/Plot/draw.js +8 -2
  101. package/es/src/charts/Plot/fillBetween.js +2 -1
  102. package/es/src/charts/Plot/forecastScene.js +3 -4
  103. package/es/src/charts/Plot/index.js +18 -10
  104. package/es/src/charts/Plot/labelPlacement.js +1 -1
  105. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  106. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  107. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  108. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  109. package/es/src/charts/Plot/pipeline.js +66 -19
  110. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  111. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  112. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  113. package/es/src/charts/Plot/pipelineScales.js +40 -8
  114. package/es/src/charts/Plot/plotFacet.js +12 -1
  115. package/es/src/charts/Plot/plotInit.js +34 -5
  116. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  117. package/es/src/charts/Plot/referenceDomains.js +133 -0
  118. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  119. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  120. package/es/src/charts/Plot/trendLabels.js +183 -0
  121. package/es/src/charts/Plot/trendLines.js +1 -0
  122. package/es/src/charts/Plot/trendScene.js +6 -3
  123. package/es/src/charts/Plot/trendTooltip.js +5 -1
  124. package/es/src/charts/PolarArea/index.js +2 -2
  125. package/es/src/charts/Priestley/applyLayout.js +14 -20
  126. package/es/src/charts/Priestley/index.js +4 -35
  127. package/es/src/charts/Priestley/timeAxis.js +100 -0
  128. package/es/src/charts/Radar/axisDecorations.js +49 -12
  129. package/es/src/charts/Radar/curvedLabels.js +187 -0
  130. package/es/src/charts/Radar/index.js +2 -3
  131. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  132. package/es/src/charts/RadialBar/emit.js +4 -1
  133. package/es/src/charts/RadialBar/index.js +16 -9
  134. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  135. package/es/src/charts/RadialMatrix/index.js +3 -7
  136. package/es/src/charts/Rings/applyLayout.js +41 -24
  137. package/es/src/charts/Rings/emit.js +174 -58
  138. package/es/src/charts/Rings/index.js +61 -28
  139. package/es/src/charts/Rings/ringsGraph.js +28 -9
  140. package/es/src/charts/Rings/ringsLoops.js +73 -0
  141. package/es/src/charts/Rings/ringsParallel.js +166 -0
  142. package/es/src/charts/Sankey/applyLayout.js +116 -39
  143. package/es/src/charts/Sankey/circularLayout.js +208 -0
  144. package/es/src/charts/Sankey/circularLinks.js +301 -0
  145. package/es/src/charts/Sankey/emit.js +164 -94
  146. package/es/src/charts/Sankey/index.js +72 -75
  147. package/es/src/charts/Sankey/labels.js +80 -0
  148. package/es/src/charts/Sankey/ribbons.js +88 -0
  149. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  150. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  151. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  152. package/es/src/charts/Scatter/index.js +25 -0
  153. package/es/src/charts/SlopeChart/index.js +116 -0
  154. package/es/src/charts/SlopeChart/slope.js +95 -0
  155. package/es/src/charts/Streamgraph/index.js +51 -0
  156. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  157. package/es/src/charts/Sunburst/emit.js +74 -63
  158. package/es/src/charts/Sunburst/index.js +3 -3
  159. package/es/src/charts/Tree/index.js +2 -6
  160. package/es/src/charts/Treemap/index.js +2 -5
  161. package/es/src/charts/Violin/inner.js +3 -5
  162. package/es/src/charts/definition/makeChart.js +10 -2
  163. package/es/src/charts/drawSteps/backControl.js +17 -5
  164. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  165. package/es/src/charts/drawSteps/minimap.js +6 -5
  166. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  167. package/es/src/charts/drawSteps/searchControls.js +2 -1
  168. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  169. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  170. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  171. package/es/src/charts/events/click.legend.js +7 -2
  172. package/es/src/charts/events/click.shape.js +8 -1
  173. package/es/src/charts/events/mousemove.shape.js +5 -2
  174. package/es/src/charts/facet/drawFacets.js +14 -5
  175. package/es/src/charts/features/annotationFrame.js +179 -0
  176. package/es/src/charts/features/annotationText.js +83 -0
  177. package/es/src/charts/features/annotationTypes.js +10 -0
  178. package/es/src/charts/features/attributionFeature.js +6 -11
  179. package/es/src/charts/features/axes.js +2 -1
  180. package/es/src/charts/features/axesFinal.js +3 -1
  181. package/es/src/charts/features/axesMeasure.js +7 -4
  182. package/es/src/charts/features/calloutLayout.js +121 -0
  183. package/es/src/charts/features/calloutScene.js +155 -0
  184. package/es/src/charts/features/chartGeometry.js +1 -1
  185. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  186. package/es/src/charts/features/circleLabels.js +207 -0
  187. package/es/src/charts/features/colorScaleBucket.js +2 -1
  188. package/es/src/charts/features/colorScaleHover.js +3 -2
  189. package/es/src/charts/features/colorScaleValue.js +97 -0
  190. package/es/src/charts/features/curvedArrows.js +158 -0
  191. package/es/src/charts/features/edgeArrows.js +160 -4
  192. package/es/src/charts/features/edgeBundling.js +442 -0
  193. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  194. package/es/src/charts/features/ensureZoomDom.js +32 -8
  195. package/es/src/charts/features/features.js +32 -14
  196. package/es/src/charts/features/featuresColorScale.js +20 -6
  197. package/es/src/charts/features/featuresLegend.js +15 -24
  198. package/es/src/charts/features/legendKeys.js +64 -0
  199. package/es/src/charts/features/lineLabels.js +55 -46
  200. package/es/src/charts/features/linkBundle.js +19 -0
  201. package/es/src/charts/features/linkColor.js +72 -0
  202. package/es/src/charts/features/linkFields.js +86 -0
  203. package/es/src/charts/features/linkFocus.js +118 -0
  204. package/es/src/charts/features/linkInteraction.js +312 -0
  205. package/es/src/charts/features/linkKeys.js +20 -0
  206. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  207. package/es/src/charts/features/linkLabelPath.js +162 -0
  208. package/es/src/charts/features/linkLabels.js +340 -0
  209. package/es/src/charts/features/linkWidths.js +32 -0
  210. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  211. package/es/src/charts/features/pathLabels.js +50 -0
  212. package/es/src/charts/features/plotAnnotations.js +68 -17
  213. package/es/src/charts/features/plotPaint.js +38 -11
  214. package/es/src/charts/features/polyline.js +129 -0
  215. package/es/src/charts/features/referenceAnnotations.js +403 -0
  216. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  217. package/es/src/charts/features/ringLabelNodes.js +93 -0
  218. package/es/src/charts/features/ringLabels.js +222 -0
  219. package/es/src/charts/features/sceneBounds.js +26 -6
  220. package/es/src/charts/features/selfLoops.js +306 -0
  221. package/es/src/charts/features/shapeEmit.js +47 -31
  222. package/es/src/charts/features/sharedFields.js +15 -2
  223. package/es/src/charts/features/textHalo.js +29 -0
  224. package/es/src/charts/index.js +8 -0
  225. package/es/src/charts/partition/chartFields.js +2 -2
  226. package/es/src/charts/partition/interaction.js +9 -5
  227. package/es/src/charts/partition/zoom.js +7 -6
  228. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  229. package/es/src/charts/pipeline/preDrawData.js +46 -3
  230. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  231. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  232. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  233. package/es/src/charts/polar/config.js +2 -3
  234. package/es/src/charts/viz/Viz.js +39 -36
  235. package/es/src/charts/viz/VizBase.js +18 -10
  236. package/es/src/charts/viz/backgroundInk.js +13 -7
  237. package/es/src/charts/viz/focusRing.js +104 -0
  238. package/es/src/charts/viz/focusTargets.js +208 -0
  239. package/es/src/charts/viz/history.js +74 -0
  240. package/es/src/charts/viz/keyboardNav.js +297 -0
  241. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  242. package/es/src/charts/viz/loaderFormat.js +114 -0
  243. package/es/src/charts/viz/missingFields.js +2 -1
  244. package/es/src/charts/viz/mountTarget.js +9 -0
  245. package/es/src/charts/viz/nearestHover.js +183 -0
  246. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  247. package/es/src/charts/viz/ordinalColor.js +14 -12
  248. package/es/src/charts/viz/pageTheme.js +83 -0
  249. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  250. package/es/src/charts/viz/pointVoronoi.js +124 -0
  251. package/es/src/charts/viz/reducedMotion.js +27 -0
  252. package/es/src/charts/viz/vizDataPolling.js +8 -3
  253. package/es/src/charts/viz/vizDefaults.js +15 -23
  254. package/es/src/charts/viz/vizFields.js +35 -0
  255. package/es/src/charts/viz/vizRender.js +43 -28
  256. package/es/src/charts/viz/vizTheme.js +96 -0
  257. package/es/src/charts/viz/vizVisibility.js +14 -0
  258. package/es/src/components/Axis/Axis.js +6 -0
  259. package/es/src/components/Axis/AxisBottom.js +1 -0
  260. package/es/src/components/Axis/AxisLeft.js +1 -0
  261. package/es/src/components/Axis/AxisRight.js +1 -0
  262. package/es/src/components/Axis/AxisTop.js +1 -0
  263. package/es/src/components/Axis/axisBreak.js +4 -1
  264. package/es/src/components/Axis/axisDefaults.js +5 -9
  265. package/es/src/components/Axis/axisLayoutScale.js +7 -1
  266. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  267. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  268. package/es/src/components/Axis/rangeBreaks.js +201 -0
  269. package/es/src/components/Axis/timeValues.js +19 -4
  270. package/es/src/components/ColorScale/ColorScale.js +15 -9
  271. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  272. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  273. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  274. package/es/src/components/Legend/Legend.js +3 -0
  275. package/es/src/components/Legend/legendConfig.js +2 -6
  276. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  277. package/es/src/components/TextBox.js +29 -65
  278. package/es/src/components/Timeline/Timeline.js +12 -3
  279. package/es/src/components/Timeline/timelineConfig.js +20 -10
  280. package/es/src/components/Timeline/timelineMode.js +26 -0
  281. package/es/src/components/Timeline/timelineRender.js +7 -3
  282. package/es/src/components/Tooltip.js +15 -5
  283. package/es/src/components/fontStack.js +20 -0
  284. package/es/src/components/textBoxLayout.js +58 -21
  285. package/es/src/components/textBoxPath.js +73 -0
  286. package/es/src/components/textBoxScene.js +223 -0
  287. package/es/src/components/textBoxWords.js +70 -0
  288. package/es/src/shapes/Area.js +1 -0
  289. package/es/src/shapes/Bar.js +1 -0
  290. package/es/src/shapes/Box.js +1 -0
  291. package/es/src/shapes/Circle.js +1 -0
  292. package/es/src/shapes/Line.js +1 -0
  293. package/es/src/shapes/Path.js +1 -0
  294. package/es/src/shapes/Rect.js +1 -0
  295. package/es/src/shapes/Shape.js +1 -0
  296. package/es/src/shapes/Whisker.js +1 -0
  297. package/es/src/utils/BaseClass.js +25 -12
  298. package/es/src/utils/configPrep.js +2 -1
  299. package/es/src/utils/constant.js +13 -1
  300. package/es/src/utils/displayName.js +12 -0
  301. package/es/src/utils/theme.js +190 -0
  302. package/es/src/utils/themeInk.js +68 -0
  303. package/package.json +14 -11
  304. package/types/index.d.ts +6 -2
  305. package/types/internal.d.ts +250 -8
  306. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  307. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  308. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  309. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  310. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  311. package/types/src/charts/Alluvial/index.d.ts +27 -0
  312. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  313. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  314. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  315. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  316. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  317. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  318. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  319. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  320. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  321. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  322. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  323. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  324. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  325. package/types/src/charts/Chord/labels.d.ts +66 -0
  326. package/types/src/charts/Donut/index.d.ts +2 -1
  327. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  328. package/types/src/charts/Gantt/emit.d.ts +17 -0
  329. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  330. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  331. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  332. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  333. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  334. package/types/src/charts/Gantt/index.d.ts +36 -0
  335. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  336. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  337. package/types/src/charts/Geomap/emit.d.ts +2 -2
  338. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  339. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  340. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  341. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  342. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  343. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  344. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  345. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  346. package/types/src/charts/Geomap/index.d.ts +3 -0
  347. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  348. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  349. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  350. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  351. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  352. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  353. package/types/src/charts/Hexbin/index.d.ts +25 -0
  354. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  355. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  356. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  357. package/types/src/charts/Histogram/binData.d.ts +20 -1
  358. package/types/src/charts/Histogram/index.d.ts +3 -2
  359. package/types/src/charts/Histogram/labels.d.ts +7 -0
  360. package/types/src/charts/Marimekko/index.d.ts +2 -1
  361. package/types/src/charts/Network/bundle.d.ts +67 -0
  362. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  363. package/types/src/charts/Network/clusters.d.ts +115 -0
  364. package/types/src/charts/Network/graph.d.ts +65 -0
  365. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  366. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  367. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  368. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  369. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  370. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  371. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  372. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  373. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  374. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  375. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  376. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  377. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  378. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  379. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  380. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  381. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  382. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  383. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  384. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  385. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  386. package/types/src/charts/Plot/index.d.ts +15 -8
  387. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  388. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  389. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  390. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  391. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  392. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  393. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  394. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  395. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  396. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  397. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  398. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  399. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  400. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  401. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  402. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  403. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  404. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  405. package/types/src/charts/Rings/emit.d.ts +50 -0
  406. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  407. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  408. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  409. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  410. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  411. package/types/src/charts/Sankey/emit.d.ts +58 -0
  412. package/types/src/charts/Sankey/labels.d.ts +19 -0
  413. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  414. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  415. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  416. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  417. package/types/src/charts/Scatter/index.d.ts +15 -0
  418. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  419. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  420. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  421. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  422. package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
  423. package/types/src/charts/definition/makeChart.d.ts +3 -2
  424. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  425. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  426. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  427. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  428. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  429. package/types/src/charts/events/click.legend.d.ts +2 -1
  430. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  431. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  432. package/types/src/charts/features/annotationText.d.ts +57 -0
  433. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  434. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  435. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  436. package/types/src/charts/features/calloutScene.d.ts +40 -0
  437. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  438. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  439. package/types/src/charts/features/circleLabels.d.ts +130 -0
  440. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  441. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  442. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  443. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  444. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  445. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  446. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  447. package/types/src/charts/features/legendKeys.d.ts +34 -0
  448. package/types/src/charts/features/lineLabels.d.ts +15 -12
  449. package/types/src/charts/features/linkBundle.d.ts +16 -0
  450. package/types/src/charts/features/linkColor.d.ts +48 -0
  451. package/types/src/charts/features/linkFields.d.ts +16 -0
  452. package/types/src/charts/features/linkFocus.d.ts +51 -0
  453. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  454. package/types/src/charts/features/linkKeys.d.ts +11 -0
  455. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  456. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  457. package/types/src/charts/features/linkLabels.d.ts +77 -0
  458. package/types/src/charts/features/linkWidths.d.ts +19 -0
  459. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  460. package/types/src/charts/features/pathLabels.d.ts +41 -0
  461. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  462. package/types/src/charts/features/plotPaint.d.ts +17 -0
  463. package/types/src/charts/features/polyline.d.ts +32 -0
  464. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  465. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  466. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  467. package/types/src/charts/features/ringLabels.d.ts +164 -0
  468. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  469. package/types/src/charts/features/selfLoops.d.ts +165 -0
  470. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  471. package/types/src/charts/features/sharedFields.d.ts +11 -2
  472. package/types/src/charts/features/textHalo.d.ts +14 -0
  473. package/types/src/charts/index.d.ts +8 -0
  474. package/types/src/charts/partition/interaction.d.ts +6 -3
  475. package/types/src/charts/partition/zoom.d.ts +4 -4
  476. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  477. package/types/src/charts/pipeline/stages.d.ts +7 -0
  478. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  479. package/types/src/charts/viz/Viz.d.ts +16 -2
  480. package/types/src/charts/viz/VizBase.d.ts +6 -6
  481. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  482. package/types/src/charts/viz/focusRing.d.ts +25 -0
  483. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  484. package/types/src/charts/viz/history.d.ts +35 -0
  485. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  486. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  487. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  488. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  489. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  490. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  491. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  492. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  493. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  494. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  495. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  496. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  497. package/types/src/charts/viz/vizFields.d.ts +32 -0
  498. package/types/src/charts/viz/vizRender.d.ts +2 -1
  499. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  500. package/types/src/charts/viz/vizTypes.d.ts +84 -7
  501. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  502. package/types/src/components/Axis/Axis.d.ts +1 -0
  503. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  504. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  505. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  506. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  507. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  508. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  509. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  510. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  511. package/types/src/components/Axis/timeValues.d.ts +1 -1
  512. package/types/src/components/ColorScale/ColorScale.d.ts +1 -0
  513. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  514. package/types/src/components/Legend/Legend.d.ts +1 -0
  515. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  516. package/types/src/components/TextBox.d.ts +1 -0
  517. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  518. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  519. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  520. package/types/src/components/Tooltip.d.ts +4 -3
  521. package/types/src/components/fontStack.d.ts +10 -0
  522. package/types/src/components/textBoxLayout.d.ts +18 -9
  523. package/types/src/components/textBoxPath.d.ts +59 -0
  524. package/types/src/components/textBoxScene.d.ts +51 -0
  525. package/types/src/components/textBoxWords.d.ts +33 -0
  526. package/types/src/shapes/Area.d.ts +1 -0
  527. package/types/src/shapes/Bar.d.ts +1 -0
  528. package/types/src/shapes/Box.d.ts +1 -0
  529. package/types/src/shapes/Circle.d.ts +1 -0
  530. package/types/src/shapes/Line.d.ts +1 -0
  531. package/types/src/shapes/Path.d.ts +1 -0
  532. package/types/src/shapes/Rect.d.ts +1 -0
  533. package/types/src/shapes/Shape.d.ts +1 -0
  534. package/types/src/shapes/Whisker.d.ts +1 -0
  535. package/types/src/utils/BaseClass.d.ts +9 -0
  536. package/types/src/utils/D3plusConfig.d.ts +981 -30
  537. package/types/src/utils/configPrep.d.ts +2 -0
  538. package/types/src/utils/constant.d.ts +8 -0
  539. package/types/src/utils/displayName.d.ts +10 -0
  540. package/types/src/utils/index.d.ts +1 -1
  541. package/types/src/utils/theme.d.ts +170 -0
  542. package/types/src/utils/themeInk.d.ts +56 -0
  543. package/umd/d3plus-core.full.js +86811 -61031
  544. package/umd/d3plus-core.full.min.js +2 -2
  545. package/umd/d3plus-core.js +28392 -6498
  546. package/umd/d3plus-core.min.js +2 -2
  547. package/es/src/components/Axis/gridStroke.js +0 -10
  548. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -0,0 +1,166 @@
1
+ /**
2
+ Rings' parallel links: several links between the same two nodes, in
3
+ either direction. Each node takes one place on its ring however many
4
+ links reach it, and the links fan out as curves bowed either side of
5
+ the line between their nodes, so each stays its own mark.
6
+ */ import { LINK_HIT_WIDTH } from "../features/linkInteraction.js";
7
+ /** The node at the other end of `edge` from the node `id`. */ const otherEnd = (edge, id)=>edge.source.id === id ? edge.target : edge.source;
8
+ /** `edges` from the node `id`, keeping only the first to each other node. */ export function firstPerNeighbor(edges, id) {
9
+ const seen = new Set();
10
+ return edges.filter((edge)=>{
11
+ const other = otherEnd(edge, id).id;
12
+ if (seen.has(other)) return false;
13
+ seen.add(other);
14
+ return true;
15
+ });
16
+ }
17
+ /** The edges among `edges` between the node `id` and the node `otherId`. */ export const edgesBetween = (edges, id, otherId)=>edges.filter((edge)=>otherEnd(edge, id).id === otherId);
18
+ /** How far apart, at their middles, `n` parallel links sit, centered on the line: `[-step/2, step/2]` for two. */ export const parallelOffsets = (n, step)=>Array.from({
19
+ length: n
20
+ }, (_, k)=>(k - (n - 1) / 2) * step);
21
+ /**
22
+ The point on the rim of `node` (centered on `node`, through `p`) moved
23
+ `e` pixels along the unit `normal`, keeping to the side of the center
24
+ `p` is on. It slides at most 90% of the radius out, and a node with no
25
+ radius keeps `p`.
26
+ */ export function slideOnRim(node, p, normal, e) {
27
+ const vx = p[0] - node.x;
28
+ const vy = p[1] - node.y;
29
+ const r = Math.hypot(vx, vy);
30
+ if (!r) return p;
31
+ const along = [
32
+ normal[1],
33
+ -normal[0]
34
+ ];
35
+ const limit = r * 0.9;
36
+ const a = Math.max(-limit, Math.min(limit, vx * normal[0] + vy * normal[1] + e));
37
+ const side = vx * along[0] + vy * along[1] < 0 ? -1 : 1;
38
+ const b = side * Math.sqrt(r * r - a * a);
39
+ return [
40
+ node.x + normal[0] * a + along[0] * b,
41
+ node.y + normal[1] * a + along[1] * b
42
+ ];
43
+ }
44
+ /** How far out, as a share of a parallel link's offset, its ends slide along their nodes' rims. */ const END_SHARE = 0.75;
45
+ /** How far `p` sits along the unit `normal` from `q`. */ const offsetAlong = (p, q, n)=>(p[0] - q[0]) * n[0] + (p[1] - q[1]) * n[1];
46
+ /**
47
+ A straight link from `s` to `t` bowed `offset` pixels along the unit
48
+ `normal` at its middle: a cubic across the gap between the two nodes,
49
+ whose ends slide most of that way along each node's rim (see
50
+ `END_SHARE`), and whose control points sit a third and two thirds of
51
+ the way across, out as far as the rest of the bow needs.
52
+ */ export function bowedEdge(s, t, normal, offset) {
53
+ const len = Math.hypot(t.x - s.x, t.y - s.y) || 1;
54
+ const ux = (t.x - s.x) / len;
55
+ const uy = (t.y - s.y) / len;
56
+ const rs = s.r ?? 0;
57
+ const rt = t.r ?? 0;
58
+ const e = offset * END_SHARE;
59
+ const s0 = [
60
+ s.x + ux * rs,
61
+ s.y + uy * rs
62
+ ];
63
+ const t0 = [
64
+ t.x - ux * rt,
65
+ t.y - uy * rt
66
+ ];
67
+ const [sourceX, sourceY] = slideOnRim(s, s0, normal, e);
68
+ const [targetX, targetY] = slideOnRim(t, t0, normal, e);
69
+ // The middle sits halfway between the ends, plus 3/4 of the control
70
+ // points' (equal) offset `h`.
71
+ const ends = offsetAlong([
72
+ sourceX,
73
+ sourceY
74
+ ], s0, normal) + offsetAlong([
75
+ targetX,
76
+ targetY
77
+ ], t0, normal);
78
+ const h = (offset - ends / 2) / 0.75;
79
+ const dx = targetX - sourceX;
80
+ const dy = targetY - sourceY;
81
+ return {
82
+ sourceX,
83
+ sourceY,
84
+ sourceBisectX: sourceX + dx / 3 + normal[0] * h,
85
+ sourceBisectY: sourceY + dy / 3 + normal[1] * h,
86
+ targetBisectX: sourceX + dx * 2 / 3 + normal[0] * h,
87
+ targetBisectY: sourceY + dy * 2 / 3 + normal[1] * h,
88
+ targetX,
89
+ targetY
90
+ };
91
+ }
92
+ /** Moves a curved link `offset` pixels along the unit `normal` at its middle: its ends most of that way along their rims (see `END_SHARE`), its control points the rest. */ function shiftSpline(edge, normal, offset) {
93
+ const e = offset * END_SHARE;
94
+ const s0 = [
95
+ edge.sourceX,
96
+ edge.sourceY
97
+ ];
98
+ const t0 = [
99
+ edge.targetX,
100
+ edge.targetY
101
+ ];
102
+ [edge.sourceX, edge.sourceY] = slideOnRim(edge.source, s0, normal, e);
103
+ [edge.targetX, edge.targetY] = slideOnRim(edge.target, t0, normal, e);
104
+ // Each end moves the middle an eighth as far, the control points 3/4 of `h`.
105
+ const ends = offsetAlong([
106
+ edge.sourceX,
107
+ edge.sourceY
108
+ ], s0, normal) + offsetAlong([
109
+ edge.targetX,
110
+ edge.targetY
111
+ ], t0, normal);
112
+ const h = (offset - ends / 8) / 0.75;
113
+ edge.sourceBisectX += normal[0] * h;
114
+ edge.sourceBisectY += normal[1] * h;
115
+ edge.targetBisectX += normal[0] * h;
116
+ edge.targetBisectY += normal[1] * h;
117
+ }
118
+ const isPlaced = (n)=>typeof n.x === "number" && typeof n.y === "number";
119
+ /**
120
+ Fans out each group of parallel links among `edges` (mutated in place),
121
+ leaving a link with no parallel alone. Their middles sit a hit path's
122
+ width (and a gap) apart, so each can be pointed at. A straight link
123
+ becomes a bowed curve (see `bowedEdge`); a curved one moves to the side
124
+ (see `shiftSpline`). The side follows the two nodes, not the link's
125
+ direction, so links both ways between them fan apart too.
126
+ */ export function fanParallelEdges(edges) {
127
+ const groups = new Map();
128
+ for (const edge of edges){
129
+ if (edge.loop || edge.source.id === edge.target.id) continue;
130
+ const ids = [
131
+ String(edge.source.id),
132
+ String(edge.target.id)
133
+ ].sort();
134
+ const key = JSON.stringify(ids);
135
+ if (!groups.has(key)) groups.set(key, []);
136
+ groups.get(key).push(edge);
137
+ }
138
+ for (const group of groups.values()){
139
+ if (group.length < 2) continue;
140
+ const first = group[0];
141
+ const [a, b] = String(first.source.id) < String(first.target.id) ? [
142
+ first.source,
143
+ first.target
144
+ ] : [
145
+ first.target,
146
+ first.source
147
+ ];
148
+ if (!isPlaced(a) || !isPlaced(b)) continue;
149
+ const len = Math.hypot(b.x - a.x, b.y - a.y);
150
+ if (!len) continue;
151
+ const normal = [
152
+ -(b.y - a.y) / len,
153
+ (b.x - a.x) / len
154
+ ];
155
+ const widest = Math.max(...group.map((e)=>e.size ?? 1));
156
+ const step = Math.max(LINK_HIT_WIDTH, widest + 4) + 4;
157
+ parallelOffsets(group.length, step).forEach((offset, k)=>{
158
+ const edge = group[k];
159
+ if (edge.spline && edge.sourceX != null && edge.targetX != null) shiftSpline(edge, normal, offset);
160
+ else {
161
+ Object.assign(edge, bowedEdge(edge.source, edge.target, normal, offset));
162
+ edge.spline = true;
163
+ }
164
+ });
165
+ }
166
+ }
@@ -4,6 +4,83 @@
4
4
  `nodeLookup` + `linkLookup` on `viz.ctx`.
5
5
  */ import { groups } from "d3-array";
6
6
  import { chartBounds } from "../features/chartGeometry.js";
7
+ import { makeLinkDatum, publishLinkGraph, setLinkValue } from "../features/linkInteraction.js";
8
+ import { warnConfigOnce } from "../../utils/configWarnings.js";
9
+ import { layOutCircular } from "./circularLayout.js";
10
+ import { sankeyNodeValue } from "./circularLinks.js";
11
+ import { sankeyAcyclicLinks } from "./sankeyCycles.js";
12
+ import { sankeyDrawableLinks, sankeyLoopWarning, unlinkedNodeValue } from "./sankeyLinks.js";
13
+ /** A node as a link end. */ const sankeyLinkEnd = (n)=>({
14
+ data: n.data,
15
+ i: n.i,
16
+ id: String(n.id)
17
+ });
18
+ /** One node per distinct source or target value in `links`, in order. */ function nodesFromLinks(links, endKeys) {
19
+ const ids = new Set();
20
+ for (const d of links)for (const key of endKeys)ids.add(d[key]);
21
+ return Array.from(ids, (id)=>({
22
+ id
23
+ }));
24
+ }
25
+ /**
26
+ Gives each node no drawn link touches a `fixedValue` (see
27
+ `unlinkedNodeValue`), so it draws with a height like the rest.
28
+ */ function sizeUnlinkedNodes(v, nodes, links) {
29
+ const linked = new Set(links.flatMap((l)=>[
30
+ l.source,
31
+ l.target
32
+ ]));
33
+ const values = links.map((l)=>Number(l.value));
34
+ nodes.forEach((n, i)=>{
35
+ if (linked.has(i)) return;
36
+ let own;
37
+ try {
38
+ own = v.schema.value(n.data, n.i);
39
+ } catch {
40
+ // An accessor written for links may not read a node's row.
41
+ own = undefined;
42
+ }
43
+ n.fixedValue = unlinkedNodeValue(own, values);
44
+ });
45
+ }
46
+ /**
47
+ The links whose ends both name a node (a link from a node to itself
48
+ included), each with its datum and value, in the order given.
49
+ */ function resolveLinks(v, nodes, nodeLookup, hasLinks) {
50
+ const endKeys = [
51
+ v.schema.linksSource,
52
+ v.schema.linksTarget
53
+ ];
54
+ const { drawn, selfLinks } = sankeyDrawableLinks(hasLinks ? v.schema.links.map((link, i)=>({
55
+ link,
56
+ i,
57
+ source: nodeLookup[String(link[endKeys[0]])],
58
+ target: nodeLookup[String(link[endKeys[1]])]
59
+ })) : []);
60
+ return [
61
+ ...drawn,
62
+ ...selfLinks
63
+ ].sort((x, y)=>x.i - y.i).map(({ link, i, source, target })=>{
64
+ const datum = makeLinkDatum(link, sankeyLinkEnd(nodes[source]), sankeyLinkEnd(nodes[target]), i, endKeys);
65
+ const value = setLinkValue(datum, v.schema.value(datum, i));
66
+ return {
67
+ source: source,
68
+ target: target,
69
+ value,
70
+ datum,
71
+ i
72
+ };
73
+ });
74
+ }
75
+ /** Each node's neighbors, by the links between them. */ function linkLookupOf(links) {
76
+ return links.reduce((obj, d)=>{
77
+ if (!obj[d.source]) obj[d.source] = [];
78
+ obj[d.source].push(d.target);
79
+ if (!obj[d.target]) obj[d.target] = [];
80
+ obj[d.target].push(d.source);
81
+ return obj;
82
+ }, {});
83
+ }
7
84
  export const applySankeyLayout = ({ viz })=>{
8
85
  const v = viz;
9
86
  const { width, height } = chartBounds(v);
@@ -16,28 +93,10 @@ export const applySankeyLayout = ({ viz })=>{
16
93
  viz
17
94
  };
18
95
  }
19
- let _nodes;
20
- if (hasNodes) {
21
- _nodes = v.schema.nodes;
22
- } else {
23
- const seen = new Set();
24
- const ids = [];
25
- for (const d of v.schema.links){
26
- const src = d[v.schema.linksSource];
27
- if (!seen.has(src)) {
28
- seen.add(src);
29
- ids.push(src);
30
- }
31
- const tgt = d[v.schema.linksTarget];
32
- if (!seen.has(tgt)) {
33
- seen.add(tgt);
34
- ids.push(tgt);
35
- }
36
- }
37
- _nodes = ids.map((id)=>({
38
- id
39
- }));
40
- }
96
+ const _nodes = hasNodes ? v.schema.nodes : nodesFromLinks(v.schema.links, [
97
+ v.schema.linksSource,
98
+ v.schema.linksTarget
99
+ ]);
41
100
  const nodes = _nodes.map((n, i)=>({
42
101
  __d3plus__: true,
43
102
  data: n,
@@ -51,27 +110,45 @@ export const applySankeyLayout = ({ viz })=>{
51
110
  return obj;
52
111
  }, {});
53
112
  v.ctx.nodeLookup = nodeLookup;
54
- const links = hasLinks ? v.schema.links.map((link, i)=>({
55
- source: nodeLookup[String(link[v.schema.linksSource])],
56
- target: nodeLookup[String(link[v.schema.linksTarget])],
57
- value: v.schema.value(link, i)
58
- })) : [];
59
- v.ctx.linkLookup = links.reduce((obj, d)=>{
60
- if (!obj[d.source]) obj[d.source] = [];
61
- obj[d.source].push(d.target);
62
- if (!obj[d.target]) obj[d.target] = [];
63
- obj[d.target].push(d.source);
64
- return obj;
65
- }, {});
66
- v.ctx.sankey.nodeAlign(v.schema.nodeAlign).nodePadding(v.schema.nodePadding).nodeWidth(v.schema.nodeWidth).nodes(nodes).nodeSort(v.schema.nodeSort).links(links).linkSort(v.schema.linkSort).iterations(v.schema.iterations).size([
113
+ const resolved = resolveLinks(v, nodes, nodeLookup, hasLinks);
114
+ const { kept: links, looped } = sankeyAcyclicLinks(resolved);
115
+ const circularOn = v.schema.circularLinks !== false;
116
+ if (!circularOn && looped.length) warnConfigOnce(v, "sankeyLoops", sankeyLoopWarning(looped.map((l)=>[
117
+ nodes[l.source].id,
118
+ nodes[l.target].id
119
+ ])));
120
+ const circular = circularOn ? looped : [];
121
+ const shown = circular.length ? [
122
+ ...links,
123
+ ...circular
124
+ ].sort((x, y)=>x.i - y.i) : links;
125
+ publishLinkGraph(v, shown.map((l)=>l.datum), nodes.map(sankeyLinkEnd));
126
+ sizeUnlinkedNodes(v, nodes, shown);
127
+ // A node a circular link touches is sized by its returning flow too.
128
+ for (const i of new Set(circular.flatMap((l)=>[
129
+ l.source,
130
+ l.target
131
+ ])))nodes[i].fixedValue = sankeyNodeValue(i, shown);
132
+ v.ctx.linkLookup = linkLookupOf(shown);
133
+ const layout = v.ctx.sankey.nodeAlign(v.schema.nodeAlign).nodePadding(v.schema.nodePadding).nodeWidth(v.schema.nodeWidth).nodes(nodes).nodeSort(v.schema.nodeSort).links(links).linkSort(v.schema.linkSort).iterations(v.schema.iterations);
134
+ const laid = layOutCircular({
135
+ run: (extent)=>layout.extent(extent)(),
136
+ nodes: nodes,
137
+ links: links,
138
+ circular,
67
139
  width,
68
- height
69
- ])();
140
+ height,
141
+ padding: v.schema.nodePadding
142
+ });
70
143
  const nodeGroups = Array.from(groups(nodes, (d)=>d.shape));
71
144
  v.ctx.sankeyCtx = {
72
- links,
145
+ links: [
146
+ ...links,
147
+ ...laid
148
+ ],
73
149
  nodeGroups,
74
- pathFn: v.ctx.path
150
+ width,
151
+ height
75
152
  };
76
153
  return {
77
154
  shapeData: nodes
@@ -0,0 +1,208 @@
1
+ /**
2
+ Lays out a Sankey with circular links: runs the layout once to see where
3
+ the nodes fall, reserves room around them for the circular links' lanes
4
+ and legs, runs it again inside that room, then places each circular
5
+ link's band (see `circularLinks.ts`).
6
+ */ import { circularLanes, circularLinkOrder, circularLinkShape, circularLinkSide, circularReserve, stackCircularEnds } from "./circularLinks.js";
7
+ /**
8
+ The pixels per unit of value the layout drew the nodes at: a node's
9
+ height over its value (every node shares it), or 0 when no node has a
10
+ value.
11
+ */ export function sankeyScale(nodes) {
12
+ const n = nodes.find((d)=>typeof d.value === "number" && d.value > 0);
13
+ return n ? (n.y1 - n.y0) / n.value : 0;
14
+ }
15
+ /**
16
+ Shrinks `reserve` (top + bottom, left + right) to at most half of the
17
+ chart's height and width, so the nodes always keep room to draw.
18
+ */ export function capReserve(reserve, width, height) {
19
+ const fit = (a, b, room)=>{
20
+ const k = a + b > room / 2 ? room / 2 / (a + b) : 1;
21
+ return [
22
+ a * k,
23
+ b * k
24
+ ];
25
+ };
26
+ const [top, bottom] = fit(reserve.top, reserve.bottom, height);
27
+ const [left, right] = fit(reserve.left, reserve.right, width);
28
+ return {
29
+ top,
30
+ right,
31
+ bottom,
32
+ left
33
+ };
34
+ }
35
+ /**
36
+ The pixels per unit of value the layout draws nodes at in an extent
37
+ `height` tall, as d3-sankey sets it: the scale at which the fullest
38
+ column, with `padding` between its nodes, fills the height.
39
+ @param nodes The nodes, with the column (`layer`) and `value` a layout
40
+ gave them.
41
+ */ export function columnScale(nodes, height, padding) {
42
+ const columns = new Map();
43
+ for (const n of nodes){
44
+ const c = columns.get(n.layer) ?? {
45
+ count: 0,
46
+ total: 0
47
+ };
48
+ c.count++;
49
+ c.total += typeof n.value === "number" ? n.value : 0;
50
+ columns.set(n.layer, c);
51
+ }
52
+ const most = Math.max(0, ...Array.from(columns.values(), (c)=>c.count));
53
+ const py = Math.min(padding, height / (most - 1));
54
+ let ky = Infinity;
55
+ for (const { count, total } of columns.values())if (total > 0) ky = Math.min(ky, (height - (count - 1) * py) / total);
56
+ return Number.isFinite(ky) ? Math.max(0, ky) : 0;
57
+ }
58
+ /**
59
+ The largest scale `ky` at which the nodes, drawn in the height left after
60
+ `reserve(ky)` (the room the circular links take at that scale), are
61
+ drawn at `ky`: so the nodes fill what the lanes leave.
62
+ @param scaleFor The scale nodes are drawn at in a height (see `columnScale`).
63
+ @param reserve The height the circular links take at a scale.
64
+ @param most The scale to search below.
65
+ */ export function solveScale(scaleFor, reserve, height, most) {
66
+ let lo = 0;
67
+ let hi = Math.max(0, most);
68
+ for(let k = 0; k < 48; k++){
69
+ const mid = (lo + hi) / 2;
70
+ if (scaleFor(Math.max(0, height - reserve(mid))) >= mid) lo = mid;
71
+ else hi = mid;
72
+ }
73
+ return lo;
74
+ }
75
+ /**
76
+ Where each column's nodes sit across, in an extent from `x0` to `x1`, as
77
+ d3-sankey spreads them: `lastLayer + 1` columns, `nodeWidth` wide.
78
+ */ export function columnEdges(x0, x1, lastLayer, nodeWidth) {
79
+ const kx = lastLayer > 0 ? (x1 - x0 - nodeWidth) / lastLayer : 0;
80
+ return (layer)=>[
81
+ x0 + layer * kx,
82
+ x0 + layer * kx + nodeWidth
83
+ ];
84
+ }
85
+ /** Each placed circular link's band, around the nodes, by its index. */ function shapeLinks(placed, nodes) {
86
+ const top = Math.min(...nodes.map((n)=>n.y0));
87
+ const bottom = Math.max(...nodes.map((n)=>n.y1));
88
+ const byIndex = new Map();
89
+ for (const { side, links, lanes } of placed){
90
+ links.forEach((l, k)=>{
91
+ const ends = l;
92
+ byIndex.set(l.i, {
93
+ source: l.source,
94
+ target: l.target,
95
+ value: l.value,
96
+ datum: l.datum,
97
+ width: l.width,
98
+ y0: ends.y0,
99
+ y1: ends.y1,
100
+ circular: circularLinkShape(ends, lanes[k], side, side === "top" ? top : bottom)
101
+ });
102
+ });
103
+ }
104
+ return byIndex;
105
+ }
106
+ /**
107
+ Runs `run` (the Sankey layout over the links that aren't circular) and
108
+ returns the circular links, laid out around the nodes.
109
+ @param run Lays the nodes out inside an extent.
110
+ @param nodes The nodes, laid out in place by `run`.
111
+ @param links The other links, laid out in place by `run`.
112
+ @param circular The circular links, with node indices for ends.
113
+ @param padding The gap between nodes in a column (`nodePadding`).
114
+ */ export function layOutCircular(opts) {
115
+ const { run, nodes, links, circular, width, height, padding } = opts;
116
+ run([
117
+ [
118
+ 0,
119
+ 0
120
+ ],
121
+ [
122
+ width,
123
+ height
124
+ ]
125
+ ]);
126
+ if (!circular.length || !nodes.length) return [];
127
+ const sized = (ky)=>circular.map((l)=>({
128
+ index: l.i,
129
+ i: l.i,
130
+ datum: l.datum,
131
+ source: nodes[l.source],
132
+ target: nodes[l.target],
133
+ value: l.value,
134
+ width: Number.isFinite(l.value) ? Math.max(0, l.value) * ky : 0
135
+ }));
136
+ // d3-sankey spreads its columns by depth (see `computeNodeLayers`).
137
+ const lastLayer = Math.max(...nodes.map((n)=>n.depth ?? n.layer));
138
+ const nodeWidth = nodes[0].x1 - nodes[0].x0;
139
+ // The first pass decides each link's side and the lanes' order.
140
+ const first = sized(sankeyScale(nodes));
141
+ const sides = new Map(first.map((l)=>[
142
+ l.i,
143
+ circularLinkSide(l, 0, height)
144
+ ]));
145
+ const order = new Map([
146
+ "top",
147
+ "bottom"
148
+ ].flatMap((side)=>circularLinkOrder(first.filter((l)=>sides.get(l.i) === side), side).map((l, k)=>[
149
+ l.i,
150
+ k
151
+ ])));
152
+ const place = (ky, columnX)=>{
153
+ const laid = sized(ky);
154
+ return [
155
+ "top",
156
+ "bottom"
157
+ ].map((side)=>{
158
+ const own = laid.filter((l)=>sides.get(l.i) === side).sort((a, b)=>(order.get(a.i) ?? 0) - (order.get(b.i) ?? 0));
159
+ return {
160
+ side,
161
+ links: own,
162
+ lanes: circularLanes(own, columnX)
163
+ };
164
+ });
165
+ };
166
+ // The room the links take at a scale: their legs first, then the lanes
167
+ // over the columns that sit between the legs.
168
+ const roomAt = (ky)=>{
169
+ const edges = columnEdges(0, width, lastLayer, nodeWidth);
170
+ const { left, right } = circularReserve(place(ky, edges), lastLayer);
171
+ const inner = columnEdges(left, width - right, lastLayer, nodeWidth);
172
+ return {
173
+ ...circularReserve(place(ky, inner), lastLayer),
174
+ left,
175
+ right
176
+ };
177
+ };
178
+ const ky = solveScale((h)=>columnScale(nodes, h, padding), (k)=>{
179
+ const r = roomAt(k);
180
+ return r.top + r.bottom;
181
+ }, height, sankeyScale(nodes));
182
+ const room = capReserve(roomAt(ky), width, height);
183
+ run([
184
+ [
185
+ room.left,
186
+ room.top
187
+ ],
188
+ [
189
+ width - room.right,
190
+ height - room.bottom
191
+ ]
192
+ ]);
193
+ // The second pass draws at the scale the layout settled on.
194
+ const columnX = new Map(nodes.map((n)=>[
195
+ n.layer,
196
+ [
197
+ n.x0,
198
+ n.x1
199
+ ]
200
+ ]));
201
+ const placed = place(sankeyScale(nodes), (layer)=>columnX.get(layer) ?? [
202
+ 0,
203
+ 0
204
+ ]);
205
+ stackCircularEnds(placed, links);
206
+ const byIndex = shapeLinks(placed, nodes);
207
+ return circular.map((l)=>byIndex.get(l.i));
208
+ }