@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
@@ -5,15 +5,20 @@
5
5
  - `applyLayout.ts` — node + link resolution + Sankey layout.
6
6
  - `emit.ts` — link Paths + per-shape-type node Rects.
7
7
  - `sankeyLayout.ts` — the layout (a port of d3-sankey).
8
- */ import { sankey, sankeyCenter, sankeyJustify, sankeyLeft, sankeyLinkHorizontal, sankeyRight } from "./sankeyLayout.js";
9
- import { addToQueue } from "@d3plus/data";
8
+ */ import { sankey, sankeyCenter, sankeyJustify, sankeyLeft, sankeyRight } from "./sankeyLayout.js";
9
+ import { colorGray } from "@d3plus/color";
10
10
  import accessor from "../../utils/accessor.js";
11
11
  import { fieldAccessor } from "../../utils/fieldAccessor.js";
12
12
  import constant from "../../utils/constant.js";
13
13
  import { makeChart } from "../definition/makeChart.js";
14
+ import { loaderFormatFields, setLoaderValue } from "../viz/loaderFormat.js";
15
+ import { focusLink, installFocusBackgroundClick } from "../features/linkFocus.js";
16
+ import { isLinkDatum, linkHighlight, linkTooltipConfig, nodeHighlight } from "../features/linkInteraction.js";
14
17
  import { applySankeyLayout } from "./applyLayout.js";
15
18
  import { sankeyEmit } from "./emit.js";
16
19
  import { simpleHover } from "../viz/simpleHover.js";
20
+ import { themeDark, themed } from "../../utils/theme.js";
21
+ import { linkStyleFields } from "../features/linkFields.js";
17
22
  const sankeyAligns = {
18
23
  center: sankeyCenter,
19
24
  justify: sankeyJustify,
@@ -38,35 +43,26 @@ const sankeyAligns = {
38
43
  viz._focus = undefined;
39
44
  return;
40
45
  }
41
- // An edge datum is a `{source, target}` link, not a node — highlight the
42
- // hovered link plus its two endpoint nodes.
43
- const edge = d;
44
- if (edge.source && edge.target) {
45
- const sourceId = edge.source.id;
46
- const targetId = edge.target.id;
47
- viz.hover((h, hi)=>{
48
- if (h.source && h.target) return h.source.id === sourceId && h.target.id === targetId;
49
- const hid = viz.schema.nodeId(h, hi);
50
- return hid === sourceId || hid === targetId;
46
+ const nodeKey = (h, hi)=>`${viz.schema.nodeId(h, hi)}`;
47
+ const predicate = isLinkDatum(d) ? linkHighlight(viz, d, nodeKey) : nodeHighlight(viz, d, nodeKey);
48
+ if (predicate) viz.hover(predicate);
49
+ };
50
+ }
51
+ /**
52
+ Wire Sankey's link click: it keeps the link and its two ends highlighted
53
+ until the link or the background is clicked again. Sankey doesn't zoom,
54
+ so the focus stays in place. Node clicks keep the default handler.
55
+ */ function installSankeyLinkFocus(viz) {
56
+ installFocusBackgroundClick(viz);
57
+ const defaultClick = viz.schema.on["click.shape"];
58
+ viz.schema.on["click.shape"] = function(d, i, x, event) {
59
+ if (isLinkDatum(d)) {
60
+ focusLink(viz, d, {
61
+ nodeKey: (h, hi)=>`${viz.schema.nodeId(h, hi)}`
51
62
  });
52
63
  return;
53
64
  }
54
- const id = viz.schema.nodeId(d, i);
55
- const node = viz.ctx.nodeLookup[String(id)];
56
- const lookup = viz.ctx.nodeLookup;
57
- const nodeLookup = Object.keys(lookup).reduce((all, item)=>{
58
- all[lookup[item]] = !isNaN(Number(item)) ? parseInt(item, 10) : item;
59
- return all;
60
- }, {});
61
- const links = viz.ctx.linkLookup[node] ?? [];
62
- const filterIds = [
63
- id
64
- ];
65
- links.forEach((l)=>filterIds.push(nodeLookup[l]));
66
- viz.hover((h, hi)=>{
67
- if (h.source && h.target) return h.source.id === id || h.target.id === id;
68
- return filterIds.includes(viz.schema.nodeId(h, hi));
69
- });
65
+ if (typeof defaultClick === "function") defaultClick.call(this, d, i, x, event);
70
66
  };
71
67
  }
72
68
  export const sankeyDef = {
@@ -76,30 +72,36 @@ export const sankeyDef = {
76
72
  setup: (viz)=>{
77
73
  const v = viz;
78
74
  installSankeyHover(v);
75
+ installSankeyLinkFocus(viz);
79
76
  /**
80
77
  The flows between `nodes`. Each link's `linksSource` and `linksTarget`
81
78
  values match a node's `nodeId`, and its width comes from `value`.
82
79
  Accepts an array of links, or a URL/filepath string to load them from.
83
- An optional formatting function can be passed as a second argument; it
84
- receives the loaded data and returns the final links array.
80
+ `linksFormat` transforms them; a function passed as a second argument
81
+ sets it. A link that loops back into a node it left (a link from a
82
+ node to itself, or the lightest link on a loop through several nodes,
83
+ A → B → A) is drawn as a circular band around the outside of the
84
+ nodes, or left out with a warning when `circularLinks` is `false`.
85
85
  @type {object[] | string}
86
- */ v.links = function(_, f) {
86
+ */ v.links = function() {
87
87
  if (arguments.length) {
88
- addToQueue.bind(this)(_, f, "links");
88
+ // eslint-disable-next-line prefer-rest-params
89
+ setLoaderValue(this, "links", arguments);
89
90
  return this;
90
91
  }
91
92
  return this.schema.links;
92
93
  };
93
94
  /**
94
- The nodes to draw. When empty, the nodes are the unique source and
95
- target values in `links`. Accepts an array of node objects, or a
96
- URL/filepath string to load them from. An optional formatting function
97
- can be passed as a second argument; it receives the loaded data and
98
- returns the final nodes array.
95
+ The nodes to draw, including any that no link touches (see
96
+ `value`). When empty, the nodes are the unique source and target
97
+ values in `links`. Accepts an array of node objects, or a
98
+ URL/filepath string to load them from. `nodesFormat` transforms them;
99
+ a function passed as a second argument sets it.
99
100
  @type {object[] | string}
100
- */ v.nodes = function(_, f) {
101
+ */ v.nodes = function() {
101
102
  if (arguments.length) {
102
- addToQueue.bind(this)(_, f, "nodes");
103
+ // eslint-disable-next-line prefer-rest-params
104
+ setLoaderValue(this, "nodes", arguments);
103
105
  return this;
104
106
  }
105
107
  return this.schema.nodes;
@@ -108,6 +110,8 @@ export const sankeyDef = {
108
110
  How nodes are aligned horizontally: `"justify"` (default), `"left"`,
109
111
  `"right"`, or `"center"`, or a custom d3-sankey
110
112
  [alignment function](https://github.com/d3/d3-sankey#sankey_nodeAlign).
113
+ A node no link touches sits in the first column, except with
114
+ `"right"`, which puts it in the last.
111
115
  @type {"justify" | "left" | "right" | "center" | function}
112
116
  */ v.nodeAlign = function(_) {
113
117
  return arguments.length ? (this.schema.nodeAlign = typeof _ === "function" ? _ : sankeyAligns[_], this) : this.schema.nodeAlign;
@@ -121,8 +125,12 @@ export const sankeyDef = {
121
125
  };
122
126
  /**
123
127
  The value of each link, which sets its width: a key or an accessor
124
- function that receives the link and its index. Defaults to `1` for
125
- every link.
128
+ function that receives the link, with `source` and `target` set to the
129
+ data of the nodes at its ends, and its index in `links`. Defaults to
130
+ `1` for every link. A node no link touches is sized by `value` read
131
+ from its own row in `nodes` when that is a positive number, and
132
+ otherwise by the smallest link value. A node's height counts the
133
+ flow its circular links return (see `links`).
126
134
  @type {string | function}
127
135
  */ v.value = function(_) {
128
136
  if (!arguments.length) return this.schema.value;
@@ -132,26 +140,12 @@ export const sankeyDef = {
132
140
  v.hover = simpleHover;
133
141
  },
134
142
  ctx: {
135
- sankey: sankey(),
136
- path: sankeyLinkHorizontal()
143
+ sankey: sankey()
137
144
  },
138
145
  fields: [
139
- /**
140
- Draws arrowheads on the links: `true` (or `"target"`) where each link
141
- enters its target, `"source"` where it leaves its source, `"both"`,
142
- or `false` for none. Also accepts an accessor function returning one
143
- of those per link.
144
- @type {boolean | "target" | "source" | "both" | function}
145
- */ {
146
- key: "arrows",
147
- default: false
148
- },
149
- /**
150
- The arrowhead size in pixels, or an accessor function returning one
151
- per link. Defaults to the link's width, kept between 8 and 28.
152
- @type {number | function}
153
- */ {
154
- key: "arrowSize"
146
+ {
147
+ key: "circularLinks",
148
+ default: true
155
149
  },
156
150
  /**
157
151
  The number of relaxation iterations d3-sankey runs to position the
@@ -160,6 +154,8 @@ export const sankeyDef = {
160
154
  key: "iterations",
161
155
  default: 6
162
156
  },
157
+ ...linkStyleFields(),
158
+ ...loaderFormatFields("links", "nodes"),
163
159
  {
164
160
  key: "links",
165
161
  default: accessor("links")
@@ -208,6 +204,14 @@ export const sankeyDef = {
208
204
  */ {
209
205
  key: "nodeSort"
210
206
  },
207
+ /**
208
+ How many links a node's tooltip lists under its number of
209
+ connections, strongest first: a number, or `false` for none. Defaults
210
+ to 3 when the links differ in `value`, and none otherwise.
211
+ @type {number | false}
212
+ */ {
213
+ key: "nodeTooltipLinks"
214
+ },
211
215
  /** The width of each node, in pixels. */ {
212
216
  key: "nodeWidth",
213
217
  default: 30
@@ -224,29 +228,22 @@ export const sankeyDef = {
224
228
  {
225
229
  key: "shapeConfig",
226
230
  merge: true,
227
- factory: ()=>{
228
- const linkStrokeWidth = (d)=>Math.max(1, Math.abs(d.source.y1 - d.source.y0) * (d.value / d.source.value) - 2);
229
- return {
231
+ factory: (viz)=>({
230
232
  Path: {
231
- fill: "none",
232
- hoverStyle: {
233
- "stroke-width": linkStrokeWidth
234
- },
235
- label: false,
236
- stroke: "#DBDBDB",
237
- strokeOpacity: 0.5,
238
- strokeWidth: linkStrokeWidth
233
+ // Each band is a filled ribbon (see `sankeyRibbonD`).
234
+ fill: ()=>// Wide bands recede on dark as #DBDBDB does on white: the dark
235
+ // preset's link gray is for thin Network and Rings edges.
236
+ themed(viz._theme, (t)=>t.link === themeDark.link ? colorGray[800] : t.link, "#DBDBDB"),
237
+ fillOpacity: 0.5,
238
+ label: false
239
239
  },
240
240
  Rect: {}
241
- };
242
- }
241
+ })
243
242
  },
244
243
  {
245
244
  key: "tooltipConfig",
246
245
  merge: true,
247
- factory: (viz)=>({
248
- title: (d)=>d && d.source && d.target ? `${d.source.id} → ${d.target.id}` : viz._drawLabel(d, typeof d.i === "number" ? d.i : 0)
249
- })
246
+ factory: (viz)=>linkTooltipConfig(viz)
250
247
  }
251
248
  ]
252
249
  };
@@ -0,0 +1,80 @@
1
+ /**
2
+ `sankeyLabels` — node labels drawn beside each node: to the right of it,
3
+ over its outgoing links, except in the last column, where they sit to the
4
+ left, over the incoming links.
5
+ */ import constant from "../../utils/constant.js";
6
+ import { emitLabels } from "../../shapes/emitLabels.js";
7
+ import { drawNodeLabel, resolveAccessor, userLabelConfig } from "../features/emitHelpers.js";
8
+ import { backgroundInk } from "../viz/backgroundInk.js";
9
+ /** The gap between a node and its label, in pixels. */ const gap = 5;
10
+ /** The default label font size, in pixels. */ const fontSize = 12;
11
+ export function sankeyLabels(viz, nodes, cfg, width, height) {
12
+ if (!nodes.length || cfg.label === false) return [];
13
+ const columns = Array.from(new Set(nodes.map((d)=>d.x0))).sort((a, b)=>a - b);
14
+ const last = columns.length > 1 ? columns[columns.length - 1] : undefined;
15
+ const rowOf = (d)=>d.data ?? d;
16
+ const leftward = new Set(nodes.filter((d)=>d.x0 === last).map(rowOf));
17
+ // How far each node's label may reach above and below the node's middle:
18
+ // to halfway to its neighbors in the column (or to the chart's edge), so
19
+ // neighboring labels never overlap. A label too tall for this is hidden.
20
+ const reach = new Map();
21
+ for (const x0 of columns){
22
+ const column = nodes.filter((d)=>d.x0 === x0).sort((a, b)=>a.y0 - b.y0);
23
+ column.forEach((d, i)=>{
24
+ const above = i ? (d.y0 + column[i - 1].y1) / 2 : 0;
25
+ const below = i < column.length - 1 ? (d.y1 + column[i + 1].y0) / 2 : height;
26
+ const middle = (d.y0 + d.y1) / 2;
27
+ reach.set(d, Math.min(middle - above, below - middle));
28
+ });
29
+ }
30
+ // The label's box, relative to the node's top-left corner: centered on the
31
+ // node, and spanning the space between it and the next column over.
32
+ const bounds = (d)=>{
33
+ const c = columns.indexOf(d.x0);
34
+ const nodeWidth = d.x1 - d.x0;
35
+ const r = reach.get(d) ?? (d.y1 - d.y0) / 2;
36
+ const y = (d.y1 - d.y0) / 2 - r;
37
+ if (d.x0 === last) {
38
+ const space = d.x0 - (columns[c - 1] + nodeWidth) - gap * 2;
39
+ return {
40
+ x: -gap - space,
41
+ y,
42
+ width: space,
43
+ height: r * 2
44
+ };
45
+ }
46
+ const next = c < columns.length - 1 ? columns[c + 1] : width;
47
+ const space = next - d.x1 - gap * 2;
48
+ return {
49
+ x: nodeWidth + gap,
50
+ y,
51
+ width: space,
52
+ height: r * 2
53
+ };
54
+ };
55
+ return emitLabels({
56
+ data: nodes,
57
+ datum: (d)=>rowOf(d),
58
+ label: (d, i)=>{
59
+ const node = d;
60
+ const text = resolveAccessor(cfg.label, rowOf(node), node.i ?? i);
61
+ if (text === false) return false;
62
+ return text === undefined ? drawNodeLabel(viz, node, i) : text;
63
+ },
64
+ x: (d)=>d.x0,
65
+ y: (d)=>d.y0,
66
+ aes: ()=>({}),
67
+ rotate: constant(0),
68
+ id: (d)=>`sankey-label-${d.id}`,
69
+ labelBounds: (d)=>bounds(d),
70
+ labelConfig: {
71
+ fontColor: ()=>backgroundInk(viz),
72
+ fontResize: false,
73
+ fontSize,
74
+ padding: 0,
75
+ textAnchor: (d)=>leftward.has(d.data) ? "end" : "start",
76
+ verticalAlign: "middle",
77
+ ...userLabelConfig(viz, "Rect")
78
+ }
79
+ });
80
+ }
@@ -0,0 +1,88 @@
1
+ /**
2
+ Sankey bands as filled ribbons: the area between two edges, one each
3
+ side of the band's center line. A ribbon keeps its thickness however
4
+ steeply the band runs, where a thick stroke along the center line folds
5
+ over itself on the inside of a tight curve.
6
+ */ const round = (n)=>Math.round(n * 100) / 100;
7
+ const at = (p)=>`${round(p[0])},${round(p[1])}`;
8
+ /** The steps of an edge as path commands (no `M`). */ function stepsD(steps) {
9
+ return steps.map((s)=>s.c1 && s.c2 ? `C${at(s.c1)} ${at(s.c2)} ${at(s.to)}` : `L${at(s.to)}`).join("");
10
+ }
11
+ /** An edge as a path `d`. */ export function edgeD(edge) {
12
+ return `M${at(edge.start)}${stepsD(edge.steps)}`;
13
+ }
14
+ /** The same edge, run from its end back to its start. */ export function reverseEdge(edge) {
15
+ const points = [
16
+ edge.start,
17
+ ...edge.steps.map((s)=>s.to)
18
+ ];
19
+ const steps = [];
20
+ for(let k = edge.steps.length - 1; k >= 0; k--){
21
+ const s = edge.steps[k];
22
+ steps.push(s.c1 && s.c2 ? {
23
+ to: points[k],
24
+ c1: s.c2,
25
+ c2: s.c1
26
+ } : {
27
+ to: points[k]
28
+ });
29
+ }
30
+ return {
31
+ start: points[points.length - 1],
32
+ steps
33
+ };
34
+ }
35
+ /** An edge moved `dy` pixels down. */ export function shiftEdge(edge, dy) {
36
+ const move = (p)=>[
37
+ p[0],
38
+ p[1] + dy
39
+ ];
40
+ return {
41
+ start: move(edge.start),
42
+ steps: edge.steps.map((s)=>({
43
+ to: move(s.to),
44
+ ...s.c1 && s.c2 ? {
45
+ c1: move(s.c1),
46
+ c2: move(s.c2)
47
+ } : {}
48
+ }))
49
+ };
50
+ }
51
+ /**
52
+ The closed ribbon between two edges that both run from a band's source
53
+ to its target: along `a`, across to the end of `b`, and back along `b`.
54
+ */ export function ribbonD(a, b) {
55
+ const back = reverseEdge(b);
56
+ return `${edgeD(a)}L${at(back.start)}${stepsD(back.steps)}Z`;
57
+ }
58
+ /**
59
+ A band's ribbon from `[x0, y0]` (where it leaves its source) to
60
+ `[x1, y1]` (where it enters its target), `half` its thickness each side
61
+ of its center line: d3-sankey's horizontal link curve, its edges the
62
+ curve moved up and down.
63
+ */ export function bandRibbonD(x0, y0, x1, y1, half) {
64
+ const xm = (x0 + x1) / 2;
65
+ const center = {
66
+ start: [
67
+ x0,
68
+ y0
69
+ ],
70
+ steps: [
71
+ {
72
+ c1: [
73
+ xm,
74
+ y0
75
+ ],
76
+ c2: [
77
+ xm,
78
+ y1
79
+ ],
80
+ to: [
81
+ x1,
82
+ y1
83
+ ]
84
+ }
85
+ ]
86
+ };
87
+ return ribbonD(shiftEdge(center, -half), shiftEdge(center, half));
88
+ }
@@ -0,0 +1,117 @@
1
+ /**
2
+ Finds the links that close a loop (A → B → A, or A → A), so Sankey can
3
+ lay out the rest.
4
+ */ /** A link between two nodes, given as node indices, and its flow. */ /** A link's weight for choosing which links to keep: its value, or 0. */ const weight = (l)=>Number.isFinite(l.value) ? l.value : 0;
5
+ /**
6
+ Node positions in reverse DFS postorder, so most links already point
7
+ forward before any is checked.
8
+ */ function initialOrder(n, out) {
9
+ const ord = new Int32Array(n);
10
+ const seen = new Uint8Array(n);
11
+ let next = n;
12
+ for(let root = 0; root < n; root++){
13
+ if (seen[root]) continue;
14
+ seen[root] = 1;
15
+ const nodes = [
16
+ root
17
+ ];
18
+ const edges = [
19
+ 0
20
+ ];
21
+ while(nodes.length){
22
+ const top = nodes.length - 1;
23
+ const w = nodes[top];
24
+ if (edges[top] < out[w].length) {
25
+ const z = out[w][edges[top]++];
26
+ if (!seen[z]) {
27
+ seen[z] = 1;
28
+ nodes.push(z);
29
+ edges.push(0);
30
+ }
31
+ } else {
32
+ nodes.pop();
33
+ edges.pop();
34
+ ord[w] = --next;
35
+ }
36
+ }
37
+ }
38
+ return ord;
39
+ }
40
+ /**
41
+ An acyclic graph that links are added to one at a time, keeping its
42
+ nodes in topological order (Pearce and Kelly's dynamic topological
43
+ sort), so a link that points forward is added without a search.
44
+ */ function acyclicGraph(n, ord) {
45
+ const out = Array.from({
46
+ length: n
47
+ }, ()=>[]);
48
+ const inn = Array.from({
49
+ length: n
50
+ }, ()=>[]);
51
+ const mark = new Int32Array(n);
52
+ let stamp = 0;
53
+ /** The nodes reachable from `start` along `adj`, within `inside`. */ const search = (start, adj, inside, stop = -1)=>{
54
+ stamp++;
55
+ mark[start] = stamp;
56
+ const found = [
57
+ start
58
+ ];
59
+ for(let k = 0; k < found.length; k++){
60
+ for (const z of adj[found[k]]){
61
+ if (z === stop) return null;
62
+ if (mark[z] !== stamp && inside(z)) {
63
+ mark[z] = stamp;
64
+ found.push(z);
65
+ }
66
+ }
67
+ }
68
+ return found;
69
+ };
70
+ /** Adds `x → y` and returns true, or returns false if it closes a loop. */ return (x, y)=>{
71
+ if (x === y) return false;
72
+ const lb = ord[y];
73
+ const ub = ord[x];
74
+ if (lb < ub) {
75
+ const ahead = search(y, out, (z)=>ord[z] <= ub, x);
76
+ if (!ahead) return false;
77
+ const behind = search(x, inn, (z)=>ord[z] >= lb);
78
+ const byOrd = (a, b)=>ord[a] - ord[b];
79
+ behind.sort(byOrd);
80
+ ahead.sort(byOrd);
81
+ const moved = behind.concat(ahead);
82
+ const slots = moved.map((z)=>ord[z]).sort((a, b)=>a - b);
83
+ moved.forEach((z, k)=>ord[z] = slots[k]);
84
+ }
85
+ out[x].push(y);
86
+ inn[y].push(x);
87
+ return true;
88
+ };
89
+ }
90
+ /**
91
+ Splits links into a set Sankey can lay out, with no loops, and the links
92
+ left out because they close one. Links are taken heaviest `value` first
93
+ (ties in the order given), and a link is left out when the links kept
94
+ so far already lead from its target back to its source. So every link
95
+ left out is the lightest on a loop it closes, and adding any of them
96
+ back would close a loop. A link from a node to itself is left out too.
97
+ Both lists keep the order the links were given in.
98
+ @param links Links whose `source` and `target` are node indices.
99
+ */ export function sankeyAcyclicLinks(links) {
100
+ let n = 0;
101
+ for (const l of links)n = Math.max(n, l.source + 1, l.target + 1);
102
+ const out = Array.from({
103
+ length: n
104
+ }, ()=>[]);
105
+ for (const l of links)if (l.source !== l.target) out[l.source].push(l.target);
106
+ const add = acyclicGraph(n, initialOrder(n, out));
107
+ const byWeight = links.map((l, i)=>i).sort((a, b)=>weight(links[b]) - weight(links[a]) || a - b);
108
+ const looped = new Uint8Array(links.length);
109
+ for (const i of byWeight)if (!add(links[i].source, links[i].target)) looped[i] = 1;
110
+ const kept = [];
111
+ const left = [];
112
+ links.forEach((l, i)=>(looped[i] ? left : kept).push(l));
113
+ return {
114
+ kept,
115
+ looped: left
116
+ };
117
+ }
@@ -5,7 +5,10 @@ import { max, min, sum } from "d3-array";
5
5
  import { linkHorizontal } from "d3-shape";
6
6
  export const sankeyLeft = (node)=>node.depth;
7
7
  export const sankeyRight = (node, n)=>n - 1 - node.height;
8
- export const sankeyJustify = (node, n)=>node.sourceLinks.length ? node.depth : n - 1;
8
+ /**
9
+ Sources at the left, sinks at the right edge, and the rest by depth. A
10
+ node with no links at all sits at the left, with the sources.
11
+ */ export const sankeyJustify = (node, n)=>node.sourceLinks.length || !node.targetLinks.length ? node.depth : n - 1;
9
12
  export const sankeyCenter = (node)=>node.targetLinks.length ? node.depth : node.sourceLinks.length ? min(node.sourceLinks, (d)=>d.target.depth) - 1 : 0;
10
13
  /** A horizontal link path from its source node's right edge to its target's left. */ export function sankeyLinkHorizontal() {
11
14
  return linkHorizontal().source((d)=>[
@@ -90,7 +93,8 @@ export function sankey() {
90
93
  generator.nodes = (_)=>(nodeList = _, generator);
91
94
  generator.links = (_)=>(linkList = _, generator);
92
95
  generator.linkSort = (_)=>(s.linkSort = _, generator);
93
- generator.size = (_)=>(s.x1 = +_[0], s.y1 = +_[1], generator);
96
+ generator.size = (_)=>(s.x0 = s.y0 = 0, s.x1 = +_[0], s.y1 = +_[1], generator);
97
+ generator.extent = ([[x0, y0], [x1, y1]])=>(s.x0 = +x0, s.y0 = +y0, s.x1 = +x1, s.y1 = +y1, generator);
94
98
  generator.iterations = (_)=>(s.iterations = +_, generator);
95
99
  return generator;
96
100
  }
@@ -126,7 +130,8 @@ function computeNodeLinks(s, nodes, links) {
126
130
  }
127
131
  function computeNodeLayers(s, nodes) {
128
132
  const x = max(nodes, (d)=>d.depth) + 1;
129
- const kx = (s.x1 - s.x0 - s.dx) / (x - 1);
133
+ // A single column (no node links to another) sits at the left.
134
+ const kx = x > 1 ? (s.x1 - s.x0 - s.dx) / (x - 1) : 0;
130
135
  const columns = new Array(x);
131
136
  for (const node of nodes){
132
137
  const i = Math.max(0, Math.min(x - 1, Math.floor(s.align(node, x))));
@@ -0,0 +1,47 @@
1
+ /**
2
+ What Sankey lays out: the links it can draw (both ends name a node, and
3
+ the two are different nodes), and the value each node without a drawn
4
+ link is sized by.
5
+ */ /** A link's resolved ends, as indices into the nodes. */ /**
6
+ Splits links into the ones Sankey draws and the ones it leaves out: a
7
+ link with an end that names no node, or a link from a node to itself
8
+ (a flow can't loop back into the node it leaves).
9
+ */ export function sankeyDrawableLinks(links) {
10
+ const drawn = [];
11
+ const unresolved = [];
12
+ const selfLinks = [];
13
+ for (const l of links){
14
+ if (l.source === undefined || l.target === undefined) unresolved.push(l);
15
+ else if (l.source === l.target) selfLinks.push(l);
16
+ else drawn.push(l);
17
+ }
18
+ return {
19
+ drawn,
20
+ unresolved,
21
+ selfLinks
22
+ };
23
+ }
24
+ /**
25
+ The value a node no drawn link touches is sized by: `own` (the `value`
26
+ accessor read from the node's own row) when it is a positive number,
27
+ else the smallest positive value among the drawn links, else 1.
28
+ */ export function unlinkedNodeValue(own, linkValues) {
29
+ const n = typeof own === "number" ? own : Number(own);
30
+ if (own !== null && own !== "" && Number.isFinite(n) && n > 0) return n;
31
+ const positive = linkValues.filter((v)=>Number.isFinite(v) && v > 0);
32
+ return positive.length ? Math.min(...positive) : 1;
33
+ }
34
+ /** How many left-out links a loop warning names before summing up the rest. */ const namedLoops = 10;
35
+ /**
36
+ The warning Sankey logs when it leaves out links that loop back into a
37
+ node they left (a link from a node to itself, or one that closes a loop
38
+ through several nodes), naming each link once as "source → target".
39
+ @param ends Each left-out link's source and target node ids.
40
+ */ export function sankeyLoopWarning(ends) {
41
+ const count = ends.length === 1 ? "1 link" : `${ends.length} links`;
42
+ const names = Array.from(new Set(ends.map(([s, t])=>`${s} → ${t}`)));
43
+ const rest = names.length - namedLoops;
44
+ const list = names.slice(0, namedLoops).join(", ");
45
+ const more = rest > 0 ? `, and ${rest} more` : "";
46
+ return `Sankey can't draw a flow that loops back into a node it left, so it leaves out ${count} (${list}${more}).`;
47
+ }
@@ -0,0 +1,25 @@
1
+ /**
2
+ Scatter — Plot drawing every row as a point (`shape: "Circle"`).
3
+ */ import constant from "../../utils/constant.js";
4
+ import { makeChart } from "../definition/makeChart.js";
5
+ import Plot from "../Plot/index.js";
6
+ export const scatterDef = {
7
+ name: "Scatter",
8
+ paintDriven: true,
9
+ ctx: {},
10
+ fields: [
11
+ /** Every row is a point. */ {
12
+ key: "shape",
13
+ default: constant("Circle"),
14
+ coerce: "const"
15
+ }
16
+ ]
17
+ };
18
+ /**
19
+ Creates a scatter plot from an array of data: each row draws as a point at
20
+ its `x` and `y` values, on continuous axes (set `discrete` to place points
21
+ along a category axis). Points are `sizeMin` pixels in radius; a `size`
22
+ accessor scales them between `sizeMin` and `sizeMax` and adds a size
23
+ legend (see BubbleChart for bubbles sized by area). Hover any point for
24
+ its values.
25
+ */ export default makeChart(scatterDef, Plot);