@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,290 @@
1
+ /**
2
+ Cluster colors for the node-link charts (Network, ArcDiagram): when the
3
+ chart's color is left to its defaults, each node takes the color of the
4
+ community `louvain` finds it in, named after the community's
5
+ most-connected node, so the legend lists the clusters.
6
+ */ import { colorAssign } from "@d3plus/color";
7
+ import { merge } from "@d3plus/data";
8
+ import { louvain } from "@d3plus/math";
9
+ import { linkedColorDefaults } from "../viz/linkGroup.js";
10
+ import { graphNodeId, resolveGraphLinks, resolveGraphNodes } from "./graph.js";
11
+ /** The `cluster` and `clusterConfig` fields. */ export function clusterFields() {
12
+ return [
13
+ {
14
+ key: "cluster",
15
+ default: true,
16
+ coerce: (v)=>v !== false
17
+ },
18
+ {
19
+ key: "clusterConfig",
20
+ merge: true,
21
+ default: {}
22
+ }
23
+ ];
24
+ }
25
+ /**
26
+ Whether nodes are colored by cluster: `cluster` is on, and the chart's
27
+ colors are its defaults (no `colorScale`, no `colorOrdinal`, the
28
+ starting `color` and `shapeConfig.fill`, and no fill on the Circle or
29
+ Rect shape config), with a single `groupBy` level.
30
+ @param schema The chart's config.
31
+ @param defaults The `color` and `shapeConfig.fill` the chart started with.
32
+ */ export function clusterAutoActive(schema, defaults) {
33
+ const shapeConfig = schema.shapeConfig ?? {};
34
+ const typeFill = (type)=>(shapeConfig[type] ?? {}).fill;
35
+ return schema.cluster !== false && !schema.colorScale && !schema.colorOrdinal && schema.color === defaults.color && shapeConfig.fill === defaults.fill && typeFill("Circle") === undefined && typeFill("Rect") === undefined && Array.isArray(schema.groupBy) && schema.groupBy.length === 1;
36
+ }
37
+ /**
38
+ The clusters `louvain` finds among the nodes, as lists of node ids,
39
+ largest first, weighted by each link's `linkSize` value (1 when it isn't
40
+ a positive number). Links from a node to itself are left out.
41
+ */ export function findClusters(nodes, links) {
42
+ const assignment = louvain({
43
+ nodes: nodes.map((n)=>n.id),
44
+ links: links.flatMap((l)=>l.source && l.target && l.source.id !== l.target.id ? [
45
+ {
46
+ source: l.source.id,
47
+ target: l.target.id,
48
+ weight: linkWeight(l.size)
49
+ }
50
+ ] : [])
51
+ });
52
+ const clusters = [];
53
+ for (const [id, c] of assignment)(clusters[c] ??= []).push(`${id}`);
54
+ return clusters;
55
+ }
56
+ /**
57
+ Whether clusters say more than one color per node would: at least two
58
+ clusters of two or more nodes. One cluster holding every linked node
59
+ (or no links at all) leaves each node its own color.
60
+ */ export function clustersMeaningful(clusters) {
61
+ return clusters.filter((c)=>c.length > 1).length > 1;
62
+ }
63
+ /** The most clusters `clusterConfig.max` keeps by default. */ export const CLUSTER_MAX = 12;
64
+ /** A link's weight between clusters: its `size`, or 1 when that isn't a positive number. */ const linkWeight = (size)=>size > 0 && Number.isFinite(size) ? size : 1;
65
+ /**
66
+ Keeps at most `max` clusters of two or more nodes (lone nodes are left
67
+ as they are). While there are more, the smallest (the last listed of the
68
+ smallest) joins the cluster it shares the most link weight with (ties go
69
+ to the larger cluster, then the one listed first), or the largest
70
+ cluster when it has no links to any other. Returns the clusters largest
71
+ first (ties in their listed order), lone nodes last.
72
+ @param clusters Node id lists, largest first (see `findClusters`).
73
+ @param max The most clusters to keep; anything below 1 keeps them all.
74
+ */ export function capClusters(clusters, links, max) {
75
+ const groups = clusters.map((ids, order)=>({
76
+ ids: [
77
+ ...ids
78
+ ],
79
+ order
80
+ })).filter((g)=>g.ids.length > 1);
81
+ const lone = clusters.filter((c)=>c.length < 2);
82
+ if (!(max >= 1) || groups.length <= max) return clusters;
83
+ const owner = new Map();
84
+ for (const g of groups)for (const id of g.ids)owner.set(id, g);
85
+ const larger = (a, b)=>b.ids.length - a.ids.length || a.order - b.order;
86
+ while(groups.length > max){
87
+ const small = groups.reduce((s, g)=>larger(s, g) < 0 ? g : s);
88
+ const shared = new Map();
89
+ for (const l of links){
90
+ if (!l.source || !l.target) continue;
91
+ const a = owner.get(l.source.id);
92
+ const b = owner.get(l.target.id);
93
+ if (!a || !b || a === b || a !== small && b !== small) continue;
94
+ const other = a === small ? b : a;
95
+ shared.set(other, (shared.get(other) ?? 0) + linkWeight(l.size));
96
+ }
97
+ let target = groups.filter((g)=>g !== small).sort(larger)[0];
98
+ for (const [g, w] of shared){
99
+ const best = shared.get(target) ?? 0;
100
+ if (w > best || w === best && larger(g, target) < 0) target = g;
101
+ }
102
+ target.ids.push(...small.ids);
103
+ for (const id of small.ids)owner.set(id, target);
104
+ groups.splice(groups.indexOf(small), 1);
105
+ }
106
+ return [
107
+ ...groups.sort(larger).map((g)=>g.ids),
108
+ ...lone
109
+ ];
110
+ }
111
+ /**
112
+ Each cluster's most-connected node: the member with the most links to
113
+ other nodes, then the greatest total `size`, then the first listed.
114
+ */ export function clusterHubs(clusters, links) {
115
+ const degree = new Map();
116
+ const strength = new Map();
117
+ for (const l of links){
118
+ if (!l.source || !l.target || l.source.id === l.target.id) continue;
119
+ for (const id of [
120
+ l.source.id,
121
+ l.target.id
122
+ ]){
123
+ degree.set(id, (degree.get(id) ?? 0) + 1);
124
+ strength.set(id, (strength.get(id) ?? 0) + (l.size || 0));
125
+ }
126
+ }
127
+ return clusters.map((ids)=>ids.reduce((best, id)=>(degree.get(id) ?? 0) > (degree.get(best) ?? 0) || (degree.get(id) ?? 0) === (degree.get(best) ?? 0) && (strength.get(id) ?? 0) > (strength.get(best) ?? 0) ? id : best));
128
+ }
129
+ /**
130
+ A cluster's default name: the translated "{node} cluster" with its hub's
131
+ label in place of `{node}`.
132
+ */ export function clusterName(translate, label) {
133
+ return translate("{node} cluster").replace("{node}", label);
134
+ }
135
+ /** The nodes and links as resolved for layout, keeping the ctx lookups the layout sets. */ function clusterGraph(viz) {
136
+ const { nodeLookup, linkLookup } = viz.ctx;
137
+ const nodes = resolveGraphNodes(viz);
138
+ const links = resolveGraphLinks(viz, nodes);
139
+ viz.ctx.nodeLookup = nodeLookup;
140
+ viz.ctx.linkLookup = linkLookup;
141
+ return {
142
+ nodes,
143
+ links
144
+ };
145
+ }
146
+ /**
147
+ The clusters for the chart's current nodes and links. Louvain depends
148
+ only on the node ids and the links, so its result is cached on
149
+ `viz.ctx.clusterCache` by them.
150
+ */ function cachedClusters(viz, nodes, links) {
151
+ const key = `${nodes.map((n)=>n.id).join("\u0000")}|${links.map((l)=>`${l.source?.id}>${l.target?.id}:${l.size}`).join("\u0000")}`;
152
+ const cache = viz.ctx.clusterCache;
153
+ if (cache && cache.key === key) return cache.clusters;
154
+ const clusters = findClusters(nodes, links);
155
+ viz.ctx.clusterCache = {
156
+ key,
157
+ clusters
158
+ };
159
+ return clusters;
160
+ }
161
+ /** Names the clusters (see `clusterName`, and `clusterConfig.label`). */ function nameClusters(viz, clusters, hubs, byId) {
162
+ const label = (viz.schema.clusterConfig ?? {}).label;
163
+ const translate = (s)=>`${viz.schema.translate(s)}`;
164
+ return clusters.flatMap((ids, index)=>{
165
+ if (ids.length < 2) return [];
166
+ const hub = byId.get(hubs[index]);
167
+ const name = typeof label === "function" ? `${label(hub.data, index, ids.map((id)=>byId.get(id).data))}` : clusterName(translate, `${viz._drawLabel(hub.data, hub.i)}`);
168
+ return [
169
+ {
170
+ index,
171
+ name,
172
+ ids,
173
+ hub: hub.id
174
+ }
175
+ ];
176
+ });
177
+ }
178
+ /**
179
+ The legend's rows: one per cluster, its members' rows merged, and one
180
+ per node in no cluster. A key holding each member's own id (such as
181
+ `id`) is kept as the list of member ids, not merged by value, so the row
182
+ still names every member even when the ids are numbers.
183
+ */ export function clusterLegendRows(viz, clusters, nodes) {
184
+ const byId = new Map(nodes.map((n)=>[
185
+ n.id,
186
+ n
187
+ ]));
188
+ const clustered = new Set(clusters.flatMap((c)=>c.ids));
189
+ const aggs = viz.schema.aggs ?? {};
190
+ const merged = clusters.map((c)=>{
191
+ const rows = c.ids.map((id)=>byId.get(id).data);
192
+ const idKeys = Object.keys(rows[0]).filter((k)=>rows.every((r, j)=>`${r[k]}` === c.ids[j]));
193
+ const own = {
194
+ ...aggs
195
+ };
196
+ for (const k of idKeys)own[k] = (objects, read)=>objects.map(read);
197
+ return merge(rows, own);
198
+ });
199
+ return [
200
+ ...merged,
201
+ ...nodes.filter((n)=>!clustered.has(n.id)).map((n)=>n.data)
202
+ ];
203
+ }
204
+ /**
205
+ Works out this draw's clusters onto `viz.ctx.clusterState`: inactive
206
+ unless `clusterAutoActive` holds and the clusters are meaningful. While
207
+ active, the legend lists every node's row (so a network with `nodes` and
208
+ no `data` gets one), and the clusters claim the palette largest first.
209
+ */ export function prepareClusters(viz) {
210
+ const defaults = viz.ctx.clusterDefaults;
211
+ const off = {
212
+ active: false,
213
+ names: new Map(),
214
+ clusters: []
215
+ };
216
+ viz.ctx.clusterState = off;
217
+ if (!clusterAutoActive(viz.schema, defaults) || !Array.isArray(viz.schema.nodes) || !Array.isArray(viz.schema.links)) return;
218
+ const { nodes, links } = clusterGraph(viz);
219
+ const max = (viz.schema.clusterConfig ?? {}).max;
220
+ const groups = capClusters(cachedClusters(viz, nodes, links), links, typeof max === "number" ? max : CLUSTER_MAX);
221
+ if (!clustersMeaningful(groups)) return;
222
+ const byId = new Map(nodes.map((n)=>[
223
+ n.id,
224
+ n
225
+ ]));
226
+ const clusters = nameClusters(viz, groups, clusterHubs(groups, links), byId).sort((a, b)=>b.ids.length - a.ids.length || a.name.localeCompare(b.name));
227
+ const names = new Map();
228
+ for (const n of nodes)names.set(n.id, `${viz._drawLabel(n.data, n.i)}`);
229
+ for (const c of clusters)for (const id of c.ids)names.set(id, c.name);
230
+ viz.ctx.clusterState = {
231
+ active: true,
232
+ names,
233
+ clusters
234
+ };
235
+ viz._legendData = clusterLegendRows(viz, clusters, nodes);
236
+ const palette = linkedColorDefaults(viz);
237
+ for (const c of clusters)colorAssign(c.name, palette);
238
+ }
239
+ /**
240
+ The cluster a row's node (or every node of a merged row) belongs to, or
241
+ undefined when clusters are off or the row's nodes differ.
242
+ */ export function clusterOf(viz, d, i) {
243
+ const state = viz.ctx.clusterState;
244
+ if (!state?.active) return undefined;
245
+ const raw = viz._id?.(d, i);
246
+ const ids = Array.isArray(raw) ? raw : [
247
+ graphNodeId(viz, d, i)
248
+ ];
249
+ const found = new Set(ids.map((id)=>state.names.get(`${id}`)));
250
+ return found.size === 1 ? [
251
+ ...found
252
+ ][0] : undefined;
253
+ }
254
+ /**
255
+ The legend order: while clusters are active, the clusters largest first
256
+ (the order they take the palette in), then any lone nodes by `base`;
257
+ otherwise `base`.
258
+ */ export function clusterLegendSort(viz, base) {
259
+ return (a, b)=>{
260
+ const state = viz.ctx.clusterState;
261
+ if (!state?.active) return base(a, b);
262
+ const rank = (d)=>{
263
+ const name = clusterOf(viz, d, 0);
264
+ const i = state.clusters.findIndex((c)=>c.name === name);
265
+ return i < 0 ? state.clusters.length : i;
266
+ };
267
+ return rank(a) - rank(b) || base(a, b);
268
+ };
269
+ }
270
+ /**
271
+ Installs cluster colors on a Network or ArcDiagram: `color` becomes an
272
+ accessor returning a node's cluster name while clusters are active (and
273
+ the default `groupBy` color otherwise), `legendSort` lists the clusters
274
+ largest first (see `clusterLegendSort`), and `_preDraw` works out the
275
+ clusters before the legend is laid out.
276
+ */ export function installClusters(viz) {
277
+ const base = viz.schema.color;
278
+ const color = (d, i)=>clusterOf(viz, d, i) ?? base(d, i);
279
+ viz.schema.color = color;
280
+ viz.schema.legendSort = clusterLegendSort(viz, viz.schema.legendSort);
281
+ viz.ctx.clusterDefaults = {
282
+ color,
283
+ fill: viz.schema.shapeConfig.fill
284
+ };
285
+ const preDraw = viz._preDraw.bind(viz);
286
+ viz._preDraw = ()=>{
287
+ preDraw();
288
+ prepareClusters(viz);
289
+ };
290
+ }
@@ -3,49 +3,160 @@
3
3
  SceneNodes directly (no transient Shape compute pass).
4
4
  */ import { colorContrast } from "@d3plus/color";
5
5
  import constant from "../../utils/constant.js";
6
- import { emitLabels } from "../../shapes/emitLabels.js";
7
- import { straightEdgeArrows } from "../features/edgeArrows.js";
6
+ import { emitLabels, shapeLabelDefaults } from "../../shapes/emitLabels.js";
7
+ import { chartBounds } from "../features/chartGeometry.js";
8
+ import { emitOutsideLabels, insideFontMin, layoutCircleLabels, outsideLabels } from "../features/circleLabels.js";
9
+ import { edgeArrowTrims, straightEdgeArrows, straightEdgeD } from "../features/edgeArrows.js";
8
10
  import { drawNodeLabel, paintFromShapeConfig, resolveAccessor, shapeConfigFor, userLabelConfig } from "../features/emitHelpers.js";
9
11
  import { backgroundImageNode } from "../features/backgroundImageEmit.js";
10
- /** Arrowheads for one network link (straight, center-to-center). */ function networkLinkArrows(viz, link, datum, stroke, strokeWidth, i, keyPrefix) {
11
- return straightEdgeArrows({
12
+ import { linkAriaLabel, linkHitPath, linkMeta } from "../features/linkInteraction.js";
13
+ import { linkColorResolver } from "../features/linkColor.js";
14
+ import { segmentMidpoint } from "../features/linkLabelGeometry.js";
15
+ import { selfLoopArrows, selfLoopD } from "../features/selfLoops.js";
16
+ import { emitLinkLabels } from "../features/linkLabels.js";
17
+ import { curvePoints } from "../features/linkLabelPath.js";
18
+ import { networkClusterLabels } from "./clusterLabels.js";
19
+ import { bundledLinkAnchor, bundledLinkEdge, bundledLinkPath } from "./bundle.js";
20
+ /** Arrowheads for one network link (straight, center-to-center, or along its loop). */ function networkLinkArrows(viz, link, datum, stroke, strokeWidth, i, keyPrefix) {
21
+ const common = {
12
22
  arrows: viz.schema.arrows,
13
23
  arrowSize: viz.schema.arrowSize,
14
24
  strokeWidth,
15
25
  datum,
16
26
  i,
17
27
  keyPrefix,
18
- fill: typeof stroke === "string" ? stroke : undefined,
28
+ fill: typeof stroke === "string" ? stroke : undefined
29
+ };
30
+ if (link.loop) return selfLoopArrows({
31
+ ...common,
32
+ loop: link.loop
33
+ });
34
+ if (link.points) return bundledLinkEdge(viz, {
35
+ ...link,
36
+ points: link.points
37
+ }, common).arrows;
38
+ return straightEdgeArrows({
39
+ ...common,
19
40
  source: link.source,
20
41
  target: link.target
21
42
  });
22
43
  }
23
- /** Link Paths, one per `c.links` entry — split out to keep `networkEmit` under the line budget. */ function emitNetworkLinks(viz, c) {
44
+ /**
45
+ A link's visible stroke: `d`, cut short inside its arrowheads (see
46
+ `edgeArrowTrims`) so the line doesn't show past their sides.
47
+ */ function networkVisibleD(viz, link, datum, i, strokeWidth, d) {
48
+ const trims = edgeArrowTrims({
49
+ arrows: viz.schema.arrows,
50
+ arrowSize: viz.schema.arrowSize,
51
+ strokeWidth: typeof strokeWidth === "number" ? strokeWidth : undefined,
52
+ datum,
53
+ i
54
+ });
55
+ if (!trims.source && !trims.target) return d;
56
+ if (link.loop) return selfLoopD(link.loop, trims);
57
+ if (link.points) return bundledLinkEdge(viz, {
58
+ ...link,
59
+ points: link.points
60
+ }, {
61
+ datum,
62
+ i,
63
+ strokeWidth,
64
+ keyPrefix: ""
65
+ }).d;
66
+ return straightEdgeD(link.source, link.target, trims);
67
+ }
68
+ /**
69
+ Link Paths, one per resolved `c.links` entry, each followed by a wider
70
+ transparent hit path over it and its arrowheads.
71
+ */ function emitNetworkLinks(viz, c) {
24
72
  const out = [];
25
- for(let i = 0; i < c.links.length; i++){
26
- const link = c.links[i];
27
- const datum = link;
73
+ const linkColor = linkColorResolver(viz);
74
+ for (const link of c.links){
75
+ const datum = link.datum;
76
+ if (!datum) continue;
77
+ const i = linkMeta(datum).index;
28
78
  const paint = paintFromShapeConfig(c.linkConfig, datum, i);
29
79
  // Link's strokeWidth comes from the layout-injected `d.size`.
30
80
  if (typeof link.size === "number") paint.strokeWidth = link.size;
31
- const sizeLabel = typeof link.size === "number" ? `, ${link.size}` : "";
81
+ const stroke = linkColor(datum, link);
82
+ if (stroke) paint.stroke = stroke;
32
83
  const srcId = link.source.id ?? "";
33
84
  const tgtId = link.target.id ?? "";
85
+ const key = networkLinkKey(link, i);
86
+ const d = c.linkD(link);
34
87
  out.push({
35
88
  type: "path",
36
- key: `network-link-${srcId}-${tgtId}-${i}`,
37
- d: c.linkD(link),
89
+ key,
90
+ d: networkVisibleD(viz, link, datum, i, paint.strokeWidth, d),
38
91
  datum,
92
+ index: i,
39
93
  paint,
40
94
  aria: {
41
- label: `${drawNodeLabel(viz, link.source, 0)} to ${drawNodeLabel(viz, link.target, 0)}${sizeLabel}.`
95
+ label: linkAriaLabel(viz, datum)
42
96
  }
43
97
  });
98
+ out.push(linkHitPath(key, d, datum, paint.strokeWidth));
44
99
  // Optional directional arrowheads at the node boundary.
45
100
  out.push(...networkLinkArrows(viz, link, datum, paint.stroke, paint.strokeWidth, i, `network-arrow-${srcId}-${tgtId}-${i}`));
46
101
  }
47
102
  return out;
48
103
  }
104
+ /** A link's scene key. */ const networkLinkKey = (link, i)=>`network-link-${link.source.id ?? ""}-${link.target.id ?? ""}-${i}`;
105
+ /**
106
+ The link labels, at the middle of each link's run between its nodes (a
107
+ loop's far point), clear of every node and every node label placed
108
+ beside its node.
109
+ */ function networkLinkLabels(viz, c, placed, taken = []) {
110
+ if (!c.links?.length) return [];
111
+ const beside = [
112
+ ...placed.values()
113
+ ].flatMap((p)=>p.position === "outside" ? [
114
+ p.box
115
+ ] : []);
116
+ const nodes = c.nodeGroups.flatMap(([, values])=>values);
117
+ return emitLinkLabels(viz, c.links.flatMap((link)=>{
118
+ if (!link.datum) return [];
119
+ const i = linkMeta(link.datum).index;
120
+ return [
121
+ {
122
+ key: networkLinkKey(link, i),
123
+ link,
124
+ i,
125
+ anchor: link.loop ? link.loop.apex : link.points ? bundledLinkAnchor({
126
+ ...link,
127
+ points: link.points
128
+ }) : link.source && link.target ? segmentMidpoint([
129
+ link.source.x,
130
+ link.source.y
131
+ ], [
132
+ link.target.x,
133
+ link.target.y
134
+ ], link.source.r ?? 0, link.target.r ?? 0) : null,
135
+ path: link.loop ? curvePoints(link.loop.d) : link.points ? bundledLinkPath({
136
+ ...link,
137
+ points: link.points
138
+ }) : null,
139
+ priority: link.size
140
+ }
141
+ ];
142
+ }), {
143
+ circles: nodes.filter((n)=>n.shape !== "Rect").map((n)=>({
144
+ x: n.x,
145
+ y: n.y,
146
+ r: n.r
147
+ })),
148
+ boxes: nodes.filter((n)=>n.shape === "Rect").map((n)=>{
149
+ const w = n.width ?? n.r * 2;
150
+ const h = n.height ?? n.r * 2;
151
+ return {
152
+ x: n.x - w / 2,
153
+ y: n.y - h / 2,
154
+ width: w,
155
+ height: h
156
+ };
157
+ }).concat(beside, taken)
158
+ });
159
+ }
49
160
  /** One node's Circle or Rect SceneNode, or null for any other shape kind. */ function networkNode(shapeKind, d, merged, base, i) {
50
161
  const key = `network-${shapeKind}-${d.id}`;
51
162
  if (shapeKind === "Circle") return {
@@ -71,11 +182,139 @@ import { backgroundImageNode } from "../features/backgroundImageEmit.js";
71
182
  }
72
183
  return null;
73
184
  }
185
+ /** Places the Circle nodes' labels among every node (see `labelPosition`). */ function placeNetworkLabels(viz, c) {
186
+ const labelFn = c.nodeShapeConfig.label;
187
+ const items = [];
188
+ for (const [shapeKind, values] of c.nodeGroups){
189
+ const circle = shapeKind === "Circle";
190
+ const cfg = {
191
+ ...shapeConfigFor(viz, shapeKind),
192
+ ...c.nodeShapeConfig
193
+ };
194
+ const labelConfig = cfg.labelConfig ?? {};
195
+ values.forEach((d, i)=>{
196
+ const datum = d.data ?? d;
197
+ const index = d.i ?? i;
198
+ // A Rect node is an obstacle the size of the circle around it.
199
+ const r = circle ? d.r : Math.hypot(d.width ?? 0, d.height ?? 0) / 2 || d.r;
200
+ items.push({
201
+ key: d,
202
+ datum,
203
+ index,
204
+ x: d.x,
205
+ y: d.y,
206
+ r,
207
+ text: circle && labelFn ? labelFn(d, i) : undefined,
208
+ inside: {
209
+ width: d.r * 1.5,
210
+ height: d.r * 1.5,
211
+ padding: resolveAccessor(labelConfig.padding, datum, index) ?? shapeLabelDefaults.padding,
212
+ font: {
213
+ family: resolveAccessor(labelConfig.fontFamily, datum, index),
214
+ weight: resolveAccessor(labelConfig.fontWeight, datum, index)
215
+ }
216
+ }
217
+ });
218
+ });
219
+ }
220
+ const { width, height } = chartBounds(viz);
221
+ return layoutCircleLabels(viz, items, {
222
+ x: 0,
223
+ y: 0,
224
+ width,
225
+ height
226
+ });
227
+ }
228
+ /**
229
+ One node group's labels: inside each node (the bounds are its shape's
230
+ aes: a square within a circle, a rect's own box), or beside a Circle node
231
+ where `labelPosition` moved it.
232
+ */ function networkNodeLabels(viz, c, shapeKind, values, merged, placed) {
233
+ const labelFn = c.nodeShapeConfig.label;
234
+ if (!labelFn) return [];
235
+ const circle = shapeKind === "Circle";
236
+ const inside = (d)=>{
237
+ const p = placed.get(d);
238
+ return !p || p.position === "inside";
239
+ };
240
+ const baseConfig = merged.labelConfig ?? {
241
+ fontResize: true
242
+ };
243
+ const userConfig = userLabelConfig(viz, shapeKind);
244
+ const fontMin = userConfig.fontMin ?? baseConfig.fontMin;
245
+ const labelNodes = emitLabels({
246
+ data: values,
247
+ label: (d, i)=>inside(d) ? labelFn(d, i) : false,
248
+ x: (d)=>d.x,
249
+ y: (d)=>d.y,
250
+ aes: (d)=>{
251
+ const n = d;
252
+ if (circle) return {
253
+ r: n.r,
254
+ width: n.r * 2,
255
+ height: n.r * 2
256
+ };
257
+ return {
258
+ width: n.width ?? 0,
259
+ height: n.height ?? 0
260
+ };
261
+ },
262
+ rotate: constant(0),
263
+ id: (d)=>`network-label-${d.id}`,
264
+ labelBounds: (_d, _i, aes)=>{
265
+ const a = aes;
266
+ if (circle) {
267
+ const r = a.r ?? 0;
268
+ return {
269
+ width: r * 1.5,
270
+ height: r * 1.5,
271
+ x: -r * 0.75,
272
+ y: -r * 0.75
273
+ };
274
+ }
275
+ const w = a.width ?? 0;
276
+ const h = a.height ?? 0;
277
+ return {
278
+ width: w,
279
+ height: h,
280
+ x: -w / 2,
281
+ y: -h / 2
282
+ };
283
+ },
284
+ labelConfig: {
285
+ ...baseConfig,
286
+ fontColor: (d)=>{
287
+ const node = d.data ?? d;
288
+ const fill = resolveAccessor(merged.fill, node.data ?? node, node.i ?? 0);
289
+ return colorContrast(typeof fill === "string" ? fill : "rgb(255, 255, 255)", viz.schema.colorDefaults);
290
+ },
291
+ ...userConfig,
292
+ fontMin: (rec, i)=>insideFontMin(viz, placed.get(rec.data), resolveAccessor(fontMin, rec, i) ?? shapeLabelDefaults.fontMin)
293
+ }
294
+ });
295
+ if (!circle) return labelNodes;
296
+ const mine = new Map(values.filter((d)=>placed.has(d)).map((d)=>[
297
+ d,
298
+ placed.get(d)
299
+ ]));
300
+ const beside = outsideLabels(mine, (d)=>({
301
+ id: `network-label-${d.id}`,
302
+ datum: d
303
+ }));
304
+ return [
305
+ ...labelNodes,
306
+ ...emitOutsideLabels(viz, beside)
307
+ ];
308
+ }
74
309
  export const networkEmit = ({ viz })=>{
75
310
  const c = viz.ctx.networkCtx;
76
311
  if (!c) return [];
77
312
  const out = [];
313
+ const placed = c.nodeGroups?.length ? placeNetworkLabels(viz, c) : new Map();
78
314
  if (c.links && c.links.length) out.push(...emitNetworkLinks(viz, c));
315
+ const clusters = networkClusterLabels(viz, (c.nodeGroups ?? []).flatMap(([, values])=>values), placed);
316
+ out.push(...clusters.scene);
317
+ out.push(...networkLinkLabels(viz, c, placed, clusters.boxes));
79
318
  if (c.nodeGroups && c.nodeGroups.length) {
80
319
  for (const [shapeKind, values] of c.nodeGroups){
81
320
  if (!values.length) continue;
@@ -110,63 +349,7 @@ export const networkEmit = ({ viz })=>{
110
349
  if (image) images.push(image);
111
350
  }
112
351
  out.push(...images);
113
- // Labels via the chart-specific label fn. labelBounds is the
114
- // shape's aes (r for circles, width/height for rects).
115
- const labelFn = c.nodeShapeConfig.label;
116
- if (labelFn) {
117
- const labelNodes = emitLabels({
118
- data: values,
119
- label: (d, i)=>labelFn(d, i),
120
- x: (d)=>d.x,
121
- y: (d)=>d.y,
122
- aes: (d)=>{
123
- const n = d;
124
- if (shapeKind === "Circle") return {
125
- r: n.r,
126
- width: n.r * 2,
127
- height: n.r * 2
128
- };
129
- return {
130
- width: n.width ?? 0,
131
- height: n.height ?? 0
132
- };
133
- },
134
- rotate: constant(0),
135
- id: (d)=>`network-label-${d.id}`,
136
- labelBounds: (_d, _i, aes)=>{
137
- const a = aes;
138
- if (shapeKind === "Circle") {
139
- const r = a.r ?? 0;
140
- return {
141
- width: r * 1.5,
142
- height: r * 1.5,
143
- x: -r * 0.75,
144
- y: -r * 0.75
145
- };
146
- }
147
- const w = a.width ?? 0;
148
- const h = a.height ?? 0;
149
- return {
150
- width: w,
151
- height: h,
152
- x: -w / 2,
153
- y: -h / 2
154
- };
155
- },
156
- labelConfig: {
157
- ...merged.labelConfig ?? {
158
- fontResize: true
159
- },
160
- fontColor: (d)=>{
161
- const node = d.data ?? d;
162
- const fill = resolveAccessor(merged.fill, node.data ?? node, node.i ?? 0);
163
- return colorContrast(typeof fill === "string" ? fill : "rgb(255, 255, 255)", viz.schema.colorDefaults);
164
- },
165
- ...userLabelConfig(viz, shapeKind)
166
- }
167
- });
168
- out.push(...labelNodes);
169
- }
352
+ out.push(...networkNodeLabels(viz, c, shapeKind, values, merged, placed));
170
353
  }
171
354
  }
172
355
  return out;