@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,117 @@
1
+ /**
2
+ Node and link resolution shared by the node-link charts (Network,
3
+ ArcDiagram): merges `data` onto `nodes` by id, and resolves each link's
4
+ `source`/`target` (an index into `nodes`, a node object, or an id string)
5
+ to its node record.
6
+ */ import { min } from "d3-array";
7
+ import { zoomTransform } from "d3-zoom";
8
+ import { makeLinkDatum, setLinkValue } from "../features/linkInteraction.js";
9
+ /** A node record as a link end. */ export const graphLinkEnd = (n)=>({
10
+ data: n.data,
11
+ i: n.i,
12
+ id: n.id
13
+ });
14
+ /** A node row's id: its `groupBy` id, else its `nodeGroupBy` id at the drawn depth. */ export function graphNodeId(viz, d, i) {
15
+ return `${viz._id(d, i) || viz.schema.nodeGroupBy[min([
16
+ viz._drawDepth,
17
+ viz.schema.nodeGroupBy.length - 1
18
+ ])](d, i)}`;
19
+ }
20
+ /**
21
+ Resolves the filtered data and `nodes` into node records, in the order the
22
+ ids first appear (data rows, then nodes). Only ids present in `nodes`
23
+ become nodes; a matching data row supplies a node's values. `fx`/`fy` read
24
+ the chart's `x`/`y` accessors when it has them.
25
+ */ export function resolveGraphNodes(v) {
26
+ const data = v._filteredData.reduce((obj, d, i)=>{
27
+ obj[v._id(d, i)] = d;
28
+ return obj;
29
+ }, {});
30
+ const rawNodes = v.schema.nodes.reduce((obj, d, i)=>{
31
+ obj[graphNodeId(v, d, i)] = d;
32
+ return obj;
33
+ }, {});
34
+ const position = (acc)=>typeof acc === "function" ? acc : undefined;
35
+ const xAcc = position(v._x);
36
+ const yAcc = position(v._y);
37
+ return Array.from(new Set(Object.keys(data).concat(Object.keys(rawNodes)))).map((id, i)=>{
38
+ const d = data[id];
39
+ const n = rawNodes[id];
40
+ if (n === undefined) return false;
41
+ const pickFrom = (accessor, validate = (vv)=>vv !== undefined)=>d !== undefined && validate(accessor(d)) ? accessor(d) : accessor(n);
42
+ const valid = (val)=>!isNaN(val);
43
+ return {
44
+ __d3plus__: true,
45
+ data: d || n,
46
+ i,
47
+ id,
48
+ fx: xAcc ? pickFrom(xAcc, valid) : undefined,
49
+ fy: yAcc ? pickFrom(yAcc, valid) : undefined,
50
+ node: n,
51
+ r: v._size ? pickFrom(v._size) : v.schema.sizeMin,
52
+ shape: pickFrom(v.schema.shape)
53
+ };
54
+ }).filter((n)=>!!n);
55
+ }
56
+ /**
57
+ Resolves `links` against `nodes`, index-aligned with `links`: an endpoint
58
+ that matches no node is undefined. A link whose ends both resolve gets its
59
+ datum, which `linkSize` receives (with the link's index). Stashes the id → node lookup on
60
+ `v.ctx.nodeLookup` and the id → neighbor nodes lookup on
61
+ `v.ctx.linkLookup` (a link from a node to itself adds no neighbor).
62
+ */ export function resolveGraphLinks(v, nodes) {
63
+ const nodeLookup = nodes.reduce((obj, d)=>{
64
+ obj[d.id] = d;
65
+ return obj;
66
+ }, {});
67
+ v.ctx.nodeLookup = nodeLookup;
68
+ const nodeByOriginal = new Map();
69
+ for (const n of nodes)nodeByOriginal.set(n.node, n);
70
+ const endpoint = (ref, referenceType)=>referenceType === "number" ? nodeByOriginal.get(v.schema.nodes[ref]) : referenceType === "string" ? nodeLookup[ref] : nodeLookup[ref.id];
71
+ const links = v.schema.links.map((l, i)=>{
72
+ const referenceType = typeof l.source;
73
+ const source = endpoint(l.source, referenceType);
74
+ const target = endpoint(l.target, referenceType);
75
+ if (!source || !target) return {
76
+ size: v.schema.linkSize(l, i),
77
+ source,
78
+ target
79
+ };
80
+ const datum = makeLinkDatum(l, graphLinkEnd(source), graphLinkEnd(target), i);
81
+ const size = setLinkValue(datum, v.schema.linkSize(datum, i));
82
+ return {
83
+ size,
84
+ source,
85
+ target,
86
+ datum
87
+ };
88
+ });
89
+ v.ctx.linkLookup = links.reduce((obj, d)=>{
90
+ // A link from a node to itself adds no neighbor.
91
+ if (!d.source || !d.target || d.source === d.target) return obj;
92
+ if (!obj[d.source.id]) obj[d.source.id] = [];
93
+ obj[d.source.id].push(d.target);
94
+ if (!obj[d.target.id]) obj[d.target.id] = [];
95
+ obj[d.target.id].push(d.source);
96
+ return obj;
97
+ }, {});
98
+ return links;
99
+ }
100
+ /**
101
+ Zooms to a node-space extent. Node coordinates sit under the chart's
102
+ margin-origin transform and the current zoom, so they're mapped to their
103
+ on-screen position first — the space `_zoomToBounds` expects.
104
+ */ export function zoomToNodeBounds(viz, xDomain, yDomain) {
105
+ const t = zoomTransform((viz._zoomEventTarget || viz._container).node());
106
+ const { x: cx = 0, y: cy = 0 } = viz._chartTransform || {};
107
+ viz._zoomToBounds([
108
+ [
109
+ (xDomain[0] + cx) * t.k + t.x,
110
+ (yDomain[0] + cy) * t.k + t.y
111
+ ],
112
+ [
113
+ (xDomain[1] + cx) * t.k + t.x,
114
+ (yDomain[1] + cy) * t.k + t.y
115
+ ]
116
+ ]);
117
+ }
@@ -0,0 +1,79 @@
1
+ /**
2
+ The per-instance fluent methods every node-link chart (Network,
3
+ ArcDiagram) installs in its `setup`: `links`, `nodes`, `nodeGroupBy`,
4
+ `size`, and `hover`. They need imperative bodies (queue loading, `aggs`
5
+ side effects), so they are installed per instance rather than as fields.
6
+ */ import { fieldAccessor } from "../../utils/fieldAccessor.js";
7
+ import { simpleHover } from "../viz/simpleHover.js";
8
+ import { setLoaderValue } from "../viz/loaderFormat.js";
9
+ /** Installs `links`, `nodes`, `nodeGroupBy`, `size`, and `hover` on a node-link chart. */ export function installGraphFluent(v) {
10
+ /**
11
+ The edges that connect the `nodes`. The `source` and `target` of each
12
+ link refer to a node in one of three ways: its index in the `nodes`
13
+ array, the node object itself (matched by its `id`), or a string
14
+ matching the node's `id`. A link whose `source` and `target` are the
15
+ same node draws as a loop beside it.
16
+
17
+ Accepts an array of links, or a URL/filepath string to load them from.
18
+ `linksFormat` transforms them; a function passed as a second argument
19
+ sets it.
20
+ @type {object[] | string}
21
+ */ v.links = function() {
22
+ if (arguments.length) {
23
+ // eslint-disable-next-line prefer-rest-params
24
+ setLoaderValue(this, "links", arguments);
25
+ return this;
26
+ }
27
+ return this.schema.links;
28
+ };
29
+ /**
30
+ The nodes to draw. Accepts an array of node objects, or a URL/filepath
31
+ string to load them from. `nodesFormat` transforms them; a function
32
+ passed as a second argument sets it.
33
+ @type {object[] | string}
34
+ */ v.nodes = function() {
35
+ if (arguments.length) {
36
+ // eslint-disable-next-line prefer-rest-params
37
+ setLoaderValue(this, "nodes", arguments);
38
+ return this;
39
+ }
40
+ return this.schema.nodes;
41
+ };
42
+ /**
43
+ The key(s) or accessor(s) that identify each object passed to `nodes`,
44
+ one per `groupBy` depth, used in place of `groupBy` for nodes that the
45
+ data doesn't cover. Defaults to each node's `id`.
46
+ @type {string | function | (string | function)[]}
47
+ */ v.nodeGroupBy = function(_) {
48
+ if (!arguments.length) return this.schema.nodeGroupBy;
49
+ const keys = _ instanceof Array ? _ : [
50
+ _
51
+ ];
52
+ // `_nodeGroupBy` is typed as `(d: DataPoint, i: number) => string | number | Date` —
53
+ // the accessors installed here return broader types; cast.
54
+ this.schema.nodeGroupBy = keys.map((k)=>{
55
+ if (typeof k === "function") return k;
56
+ const key = k;
57
+ if (!this.schema.aggs[key]) {
58
+ this.schema.aggs[key] = (a, c)=>{
59
+ const vv = Array.from(new Set(a.map(c)));
60
+ return vv.length === 1 ? vv[0] : vv;
61
+ };
62
+ }
63
+ return fieldAccessor(key);
64
+ });
65
+ return this;
66
+ };
67
+ /**
68
+ Sizes each node: a data key or an accessor function whose values are
69
+ scaled between `sizeMin` and `sizeMax` (see `sizeScale`). When unset,
70
+ every node is drawn at the same size.
71
+ @type {string | function}
72
+ */ v.size = function(_) {
73
+ if (!arguments.length) return this._size;
74
+ this._size = typeof _ === "function" || !_ ? _ : fieldAccessor(_);
75
+ this._sizeKey = typeof _ === "string" ? _ : undefined;
76
+ return this;
77
+ };
78
+ v.hover = simpleHover;
79
+ }
@@ -5,46 +5,60 @@
5
5
  - `applyLayout.ts` — resolves nodes+links, runs force sim, normalizes
6
6
  link stroke sizes.
7
7
  - `emit.ts` — link Paths + per-shape-type node groups.
8
- */ import { mean, min } from "d3-array";
9
- import { zoomTransform } from "d3-zoom";
10
- import { addToQueue } from "@d3plus/data";
8
+ */ import { mean } from "d3-array";
11
9
  import accessor from "../../utils/accessor.js";
12
10
  import { fieldAccessor } from "../../utils/fieldAccessor.js";
13
11
  import constant from "../../utils/constant.js";
14
12
  import { chartBounds } from "../features/chartGeometry.js";
15
13
  import { ensureZoomDom } from "../features/ensureZoomDom.js";
14
+ import { isPointShape } from "../viz/nearestHover.js";
16
15
  import { makeChart } from "../definition/makeChart.js";
17
16
  import { applyNetworkLayout, networkSizeLegendScale } from "./applyLayout.js";
18
17
  import { networkEmit } from "./emit.js";
19
18
  import { sceneInsetRegion } from "../pipeline/insetPlacement.js";
20
- import { simpleHover } from "../viz/simpleHover.js";
21
- function getNodeId(viz, d, i) {
22
- return `${viz._id(d, i) || viz.schema.nodeGroupBy[min([
23
- viz._drawDepth,
24
- viz.schema.nodeGroupBy.length - 1
25
- ])](d, i)}`;
26
- }
19
+ import { graphNodeId, zoomToNodeBounds } from "./graph.js";
20
+ import { installGraphFluent } from "./graphFluent.js";
21
+ import { effectiveDuration } from "../viz/reducedMotion.js";
22
+ import { themed } from "../../utils/theme.js";
23
+ import { focusLink, installFocusBackgroundClick, linkEndsBox } from "../features/linkFocus.js";
24
+ import { isLinkDatum, linkHighlight, linkMeta, linkTooltipConfig } from "../features/linkInteraction.js";
25
+ import { linkBundleFields, linkSizeMaxField, linkStyleFields } from "../features/linkFields.js";
26
+ import { polylineBox } from "../features/polyline.js";
27
+ import { isSelfLoopMark, unionBox } from "../features/selfLoops.js";
28
+ import { loaderFormatFields } from "../viz/loaderFormat.js";
29
+ import { clusterFields, installClusters } from "./clusters.js";
30
+ const getNodeId = graphNodeId;
31
+ /** The laid-out links, from the last layout. */ const networkLinks = (viz)=>viz.ctx.networkCtx?.links ?? [];
27
32
  /**
28
- Zooms to a node-space extent. Node coordinates sit under the chart's
29
- margin-origin transform and the current zoom, so they're mapped to their
30
- on-screen position first — the space `_zoomToBounds` expects.
31
- */ function zoomToNodeBounds(viz, xDomain, yDomain) {
32
- const t = zoomTransform((viz._zoomEventTarget || viz._container).node());
33
- const { x: cx = 0, y: cy = 0 } = viz._chartTransform || {};
34
- viz._zoomToBounds([
35
- [
36
- (xDomain[0] + cx) * t.k + t.x,
37
- (yDomain[0] + cy) * t.k + t.y
38
- ],
39
- [
40
- (xDomain[1] + cx) * t.k + t.x,
41
- (yDomain[1] + cy) * t.k + t.y
42
- ]
43
- ]);
33
+ The box a link's focus zooms to: its two ends, and its loop or bundled
34
+ path when it has one.
35
+ */ function networkLinkBox(viz, d) {
36
+ const box = linkEndsBox(viz, d);
37
+ const link = networkLinks(viz).find((l)=>l.datum === d);
38
+ if (box && link?.loop) return unionBox(box, link.loop.box);
39
+ if (box && link?.points) return unionBox(box, polylineBox(link.points));
40
+ return box;
41
+ }
42
+ /** Grows a node focus's `[x0, x1]`/`[y0, y1]` domains around the node's loops. */ function includeNodeLoops(viz, id, xDomain, yDomain) {
43
+ for (const l of networkLinks(viz)){
44
+ if (!l.loop || l.source?.id !== id) continue;
45
+ const [[x0, y0], [x1, y1]] = l.loop.box;
46
+ xDomain[0] = Math.min(xDomain[0], x0);
47
+ xDomain[1] = Math.max(xDomain[1], x1);
48
+ yDomain[0] = Math.min(yDomain[0], y0);
49
+ yDomain[1] = Math.max(yDomain[1], y1);
50
+ }
44
51
  }
45
52
  /** Installs the `click.shape` handler that focuses/zooms a node + its links. */ function setupNetworkClickShape(viz, v) {
46
53
  viz.schema.on["click.shape"] = (d, i, x, event)=>{
47
54
  viz._tooltipClass.data([]).render();
55
+ if (isLinkDatum(d)) {
56
+ focusLink(viz, d, {
57
+ nodeKey: (h, hi)=>`${viz._ids(h, hi)[viz._drawDepth]}`,
58
+ box: networkLinkBox(viz, d)
59
+ });
60
+ return;
61
+ }
48
62
  if (viz._drawDepth >= viz.schema.groupBy.length - 1) {
49
63
  const id = getNodeId(viz, d, i);
50
64
  if (viz._focus && viz._focus === id) {
@@ -76,8 +90,10 @@ function getNodeId(viz, d, i) {
76
90
  if (l.y - l.r < yDomain[0]) yDomain[0] = l.y - l.r;
77
91
  if (l.y + l.r > yDomain[1]) yDomain[1] = l.y + l.r;
78
92
  });
93
+ includeNodeLoops(viz, id, xDomain, yDomain);
79
94
  v.active((h, hi)=>{
80
- if (h.source && h.target) return h.source.id === id || h.target.id === id;
95
+ const m = linkMeta(h);
96
+ if (m) return m.source.id === id || m.target.id === id;
81
97
  return filterIds.includes(getNodeId(viz, h, hi));
82
98
  });
83
99
  viz._focus = id;
@@ -121,7 +137,8 @@ function getNodeId(viz, d, i) {
121
137
  if (l.y + l.r > yDomain[1]) yDomain[1] = l.y + l.r;
122
138
  });
123
139
  v.active((h, hi)=>{
124
- if (h.source && h.target) return filterIds.includes(h.source.id) && filterIds.includes(h.target.id);
140
+ const m = linkMeta(h);
141
+ if (m) return filterIds.includes(m.source.id) && filterIds.includes(m.target.id);
125
142
  const myIds = viz._ids(h, hi);
126
143
  return filterIds.includes(`${myIds[myIds.length - 1]}`);
127
144
  });
@@ -141,6 +158,11 @@ function getNodeId(viz, d, i) {
141
158
  const defaultMouseMove = viz.schema.on["mousemove.shape"];
142
159
  viz.schema.on["mousemove.shape"] = (d, i, x, event)=>{
143
160
  defaultMouseMove(d, i, x, event);
161
+ const nodeKey = (h, hi)=>`${viz._ids(h, hi)[viz._drawDepth]}`;
162
+ if (isLinkDatum(d)) {
163
+ v.hover(linkHighlight(viz, d, nodeKey));
164
+ return;
165
+ }
144
166
  const id = getNodeId(viz, d, i);
145
167
  const links = viz.ctx.linkLookup[id] ?? [];
146
168
  const node = viz.ctx.nodeLookup[id];
@@ -165,83 +187,20 @@ function getNodeId(viz, d, i) {
165
187
  if (l.y + l.r > yDomain[1]) yDomain[1] = l.y + l.r;
166
188
  });
167
189
  v.hover((h, hi)=>{
168
- if (h.source && h.target) return h.source.id === id || h.target.id === id;
169
- return filterIds.includes(`${viz._ids(h, hi)[viz._drawDepth]}`);
190
+ const m = linkMeta(h);
191
+ if (m) return m.source.id === id || m.target.id === id;
192
+ return filterIds.includes(nodeKey(h, hi));
170
193
  });
171
194
  };
172
195
  }
173
196
  /** Installs the shape/legend/mouse event handlers that drive Network focus + hover. */ function setupNetworkEvents(viz, v) {
197
+ installFocusBackgroundClick(viz);
174
198
  setupNetworkClickShape(viz, v);
175
199
  setupNetworkClickLegend(viz, v);
176
200
  setupNetworkMouse(viz, v);
177
201
  }
178
- /** Installs the per-instance fluent methods (links/nodes/nodeGroupBy/size/x/y/hover). */ function setupNetworkFluent(v) {
179
- /**
180
- The edges that connect the `nodes`. The `source` and `target` of each
181
- link refer to a node in one of three ways: its index in the `nodes`
182
- array, the node object itself (matched by its `id`), or a string
183
- matching the node's `id`.
184
-
185
- Accepts an array of links, or a URL/filepath string to load them from.
186
- An optional formatting function can be passed as a second argument; it
187
- receives the loaded data and returns the final links array.
188
- @type {object[] | string}
189
- */ v.links = function(_, f) {
190
- if (arguments.length) {
191
- addToQueue.bind(this)(_, f, "links");
192
- return this;
193
- }
194
- return this.schema.links;
195
- };
196
- /**
197
- The nodes to draw. Accepts an array of node objects, or a URL/filepath
198
- string to load them from. An optional formatting function can be passed
199
- as a second argument; it receives the loaded data and returns the final
200
- nodes array.
201
- @type {object[] | string}
202
- */ v.nodes = function(_, f) {
203
- if (arguments.length) {
204
- addToQueue.bind(this)(_, f, "nodes");
205
- return this;
206
- }
207
- return this.schema.nodes;
208
- };
209
- /**
210
- The key(s) or accessor(s) that identify each object passed to `nodes`,
211
- one per `groupBy` depth, used in place of `groupBy` for nodes that the
212
- data doesn't cover. Defaults to each node's `id`.
213
- @type {string | function | (string | function)[]}
214
- */ v.nodeGroupBy = function(_) {
215
- if (!arguments.length) return this.schema.nodeGroupBy;
216
- const keys = _ instanceof Array ? _ : [
217
- _
218
- ];
219
- // `_nodeGroupBy` is typed as `(d: DataPoint, i: number) => string | number | Date` —
220
- // we historically install (d) => d[k] returning broader types; cast.
221
- this.schema.nodeGroupBy = keys.map((k)=>{
222
- if (typeof k === "function") return k;
223
- const key = k;
224
- if (!this.schema.aggs[key]) {
225
- this.schema.aggs[key] = (a, c)=>{
226
- const vv = Array.from(new Set(a.map(c)));
227
- return vv.length === 1 ? vv[0] : vv;
228
- };
229
- }
230
- return fieldAccessor(key);
231
- });
232
- return this;
233
- };
234
- /**
235
- Sizes each node: a data key or an accessor function whose values are
236
- scaled between `sizeMin` and `sizeMax` (see `sizeScale`). When unset,
237
- every node is drawn at the same size.
238
- @type {string | function}
239
- */ v.size = function(_) {
240
- if (!arguments.length) return this._size;
241
- this._size = typeof _ === "function" || !_ ? _ : fieldAccessor(_);
242
- this._sizeKey = typeof _ === "string" ? _ : undefined;
243
- return this;
244
- };
202
+ /** Installs the per-instance fluent methods (the shared graph ones, plus x/y). */ function setupNetworkFluent(v) {
203
+ installGraphFluent(v);
245
204
  /**
246
205
  The x position of each node: a key in the data or `nodes`, or an
247
206
  accessor function. Defaults to `"x"`. When any node has no x/y
@@ -274,7 +233,6 @@ function getNodeId(viz, d, i) {
274
233
  }
275
234
  return this;
276
235
  };
277
- v.hover = simpleHover;
278
236
  }
279
237
  export const networkDef = {
280
238
  name: "Network",
@@ -292,6 +250,7 @@ export const networkDef = {
292
250
  // `hover()` need imperative method bodies (queue loading, aggs side
293
251
  // effects). Install them per-instance.
294
252
  setupNetworkFluent(v);
253
+ installClusters(viz);
295
254
  // Default x/y accessors for nodes (Network reads node coords directly).
296
255
  viz._x = accessor("x");
297
256
  viz._y = accessor("y");
@@ -304,7 +263,7 @@ export const networkDef = {
304
263
  kind: "network",
305
264
  width,
306
265
  height,
307
- duration: viz.schema.duration
266
+ duration: effectiveDuration(viz)
308
267
  });
309
268
  return result;
310
269
  };
@@ -313,6 +272,9 @@ export const networkDef = {
313
272
  facet: {
314
273
  aspect: 1
315
274
  },
275
+ // Nodes (and loops, which sit within reach of their node) are points for
276
+ // `hoverDistance`; links keep exact hit-testing.
277
+ pointMark: (_viz, node)=>isPointShape(node) || isSelfLoopMark(node),
316
278
  ctx: {},
317
279
  fields: [
318
280
  /**
@@ -327,11 +289,17 @@ export const networkDef = {
327
289
  },
328
290
  /**
329
291
  The arrowhead size in pixels, or an accessor function returning one
330
- per link. Defaults to three times the link's stroke width (at least 6).
292
+ per link. Defaults to three times the link's stroke width, at least 6
293
+ and at most 12 pixels, but never under 1.5 times the stroke width so
294
+ the head stays wider than its line. The line stops inside the head.
331
295
  @type {number | function}
332
296
  */ {
333
297
  key: "arrowSize"
334
298
  },
299
+ ...clusterFields(),
300
+ ...linkStyleFields(),
301
+ ...linkBundleFields(),
302
+ ...loaderFormatFields("links", "nodes"),
335
303
  {
336
304
  key: "links",
337
305
  default: []
@@ -339,14 +307,20 @@ export const networkDef = {
339
307
  /**
340
308
  The thickness of each link: a pixel number used for every link, or an
341
309
  accessor function whose values are scaled between `linkSizeMin` and
342
- the smallest node radius (see `linkSizeScale`).
310
+ `linkSizeMax` (see `linkSizeScale`). The function receives each
311
+ link, with `source` and `target` set to the data of the nodes at its
312
+ ends, and its index in `links`.
343
313
  @type {number | function}
344
314
  */ {
345
315
  key: "linkSize",
346
316
  default: constant(1),
347
317
  coerce: (v)=>typeof v === "function" ? v : constant(v)
348
318
  },
349
- /** The minimum pixel stroke width used when sizing links. */ {
319
+ /**
320
+ The widest link, in pixels, when `linkSize` values differ. Defaults
321
+ to half the smallest node's radius.
322
+ */ linkSizeMaxField(),
323
+ /** The thinnest link, in pixels, when `linkSize` values differ. */ {
350
324
  key: "linkSizeMin",
351
325
  default: 1
352
326
  },
@@ -367,12 +341,18 @@ export const networkDef = {
367
341
  accessor("id")
368
342
  ]
369
343
  },
344
+ /**
345
+ How many links a node's tooltip lists under its number of
346
+ connections, strongest first: a number, or `false` for none. Defaults
347
+ to 3 when the links differ in `linkSize`, and none otherwise.
348
+ @type {number | false}
349
+ */ {
350
+ key: "nodeTooltipLinks"
351
+ },
370
352
  {
371
353
  key: "tooltipConfig",
372
354
  merge: true,
373
- factory: (viz)=>({
374
- title: (d)=>d && d.source && d.target ? `${d.source.id} → ${d.target.id}` : viz._drawLabel(d, typeof d.i === "number" ? d.i : 0)
375
- })
355
+ factory: (viz)=>linkTooltipConfig(viz)
376
356
  },
377
357
  {
378
358
  key: "nodes",
@@ -422,7 +402,7 @@ export const networkDef = {
422
402
  Path: {
423
403
  fill: "none",
424
404
  label: false,
425
- stroke: "#adb5bd"
405
+ stroke: ()=>themed(viz._theme, (t)=>t.link, "#adb5bd")
426
406
  }
427
407
  })
428
408
  }
@@ -0,0 +1,64 @@
1
+ /**
2
+ The closest pair of Network nodes, which caps the largest node radius.
3
+
4
+ @module
5
+ */ import { min } from "d3-array";
6
+ import { pointDistance, pointDistanceSquared } from "@d3plus/math";
7
+ /** Every pairwise distance's minimum, pair by pair. */ function pairwiseMinimum(nodes) {
8
+ const distances = [];
9
+ for (const n1 of nodes)for (const n2 of nodes)if (n1 !== n2) distances.push(pointDistance([
10
+ n1.x ?? 0,
11
+ n1.y ?? 0
12
+ ], [
13
+ n2.x ?? 0,
14
+ n2.y ?? 0
15
+ ]));
16
+ return min(distances);
17
+ }
18
+ /**
19
+ The smallest `pointDistance` between two different nodes, or undefined
20
+ when no pair has one (fewer than two nodes, or none with a numeric
21
+ position). Distances that aren't numbers are skipped, as `d3.min` skips
22
+ them. Sorts the nodes by x and sweeps, skipping pairs further apart in x
23
+ than the closest pair found so far.
24
+ */ export function minNodeDistance(nodes) {
25
+ const points = [];
26
+ let other = false;
27
+ for (const node of nodes){
28
+ const p = [
29
+ node.x ?? 0,
30
+ node.y ?? 0
31
+ ];
32
+ if (Number.isFinite(p[0]) && Number.isFinite(p[1])) points.push({
33
+ node,
34
+ p
35
+ });
36
+ else if (!Number.isNaN(p[0]) && !Number.isNaN(p[1])) other = true;
37
+ }
38
+ points.sort((a, b)=>a.p[0] - b.p[0]);
39
+ let best = Infinity, found = false;
40
+ for(let i = 0; i < points.length; i++){
41
+ const a = points[i];
42
+ for(let j = i + 1; j < points.length; j++){
43
+ const b = points[j];
44
+ // Squared like `pointDistanceSquared`, so the cut-off is exact.
45
+ if (pointDistanceSquared([
46
+ a.p[0],
47
+ 0
48
+ ], [
49
+ b.p[0],
50
+ 0
51
+ ]) > best) break;
52
+ if (a.node === b.node) continue;
53
+ const d = pointDistanceSquared(a.p, b.p);
54
+ if (!found || d < best) {
55
+ best = d;
56
+ found = true;
57
+ }
58
+ }
59
+ }
60
+ if (found) return Math.sqrt(best);
61
+ // Pairs with an infinite coordinate only decide the minimum when no two
62
+ // finite points make a pair.
63
+ return other ? pairwiseMinimum(nodes) : undefined;
64
+ }
@@ -0,0 +1,44 @@
1
+ /**
2
+ A `polygonContains` for one polygon tested at many points that share
3
+ rows: the edge crossings along each row are found once.
4
+
5
+ @module
6
+ */ /**
7
+ Whether `x` lies inside a polygon along a row whose edge crossings are
8
+ `xs`: d3-polygon's ray cast, toggling at each crossing past `x`.
9
+ */ export function insideRow(xs, x) {
10
+ let inside = false;
11
+ for (const cx of xs)if (x < cx) inside = !inside;
12
+ return inside;
13
+ }
14
+ /**
15
+ Tests points against `polygon` with d3-polygon's `polygonContains` rule
16
+ (a ray cast along the point's row, toggling at each edge it crosses).
17
+ The crossings are worked out with the same arithmetic, so each answer
18
+ equals `polygonContains(polygon, point)`; they are kept per row, so the
19
+ points of a grid cost one pass over the edges per row instead of per
20
+ point.
21
+ */ export function polygonRows(polygon) {
22
+ const rows = new Map();
23
+ const crossings = (y)=>{
24
+ const xs = [];
25
+ const n = polygon.length;
26
+ let [x0, y0] = polygon[n - 1];
27
+ for(let i = 0; i < n; ++i){
28
+ const [x1, y1] = polygon[i];
29
+ if (y1 > y !== y0 > y) xs.push((x0 - x1) * (y - y1) / (y0 - y1) + x1);
30
+ x0 = x1;
31
+ y0 = y1;
32
+ }
33
+ return xs;
34
+ };
35
+ const row = (y)=>{
36
+ let xs = rows.get(y);
37
+ if (!xs) rows.set(y, xs = crossings(y));
38
+ return xs;
39
+ };
40
+ return {
41
+ contains: ([x, y])=>insideRow(row(y), x),
42
+ row
43
+ };
44
+ }
@@ -9,7 +9,7 @@
9
9
  import accessor from "../../utils/accessor.js";
10
10
  import { fieldAccessor } from "../../utils/fieldAccessor.js";
11
11
  import constant from "../../utils/constant.js";
12
- import { rowLegend } from "../features/sharedFields.js";
12
+ import { legendLargestFirst, rowLegend } from "../features/sharedFields.js";
13
13
  import { makeChart } from "../definition/makeChart.js";
14
14
  import { applyPackLayout } from "./applyLayout.js";
15
15
  import { packEmit } from "./emit.js";
@@ -114,6 +114,10 @@ export const packDef = {
114
114
  }
115
115
  })
116
116
  },
117
+ {
118
+ key: "legendSort",
119
+ factory: (viz)=>legendLargestFirst(viz, "sum")
120
+ },
117
121
  {
118
122
  key: "legend",
119
123
  coerce: "const",