@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,386 @@
1
+ /**
2
+ `applyArcDiagramLayout` — ArcDiagram's layout stage. Resolves nodes and
3
+ links the way Network does, orders the nodes along the line (`nodeSort`),
4
+ spaces them evenly, sizes them, fits their labels, and shapes each link as
5
+ an arc on its side of the line, flattened just enough that the tallest
6
+ arc fits. The result rides on `viz.ctx.arcCtx` for the emit.
7
+ */ import { extent, max, min } from "d3-array";
8
+ import * as scales from "d3-scale";
9
+ import { chartBounds } from "../features/chartGeometry.js";
10
+ import { measureLabel, pointLabelSettings } from "../features/circleLabels.js";
11
+ import { shapeConfigFor } from "../features/emitHelpers.js";
12
+ import { publishLinkGraph } from "../features/linkInteraction.js";
13
+ import { graphLinkEnd, resolveGraphLinks, resolveGraphNodes } from "../Network/graph.js";
14
+ import { arcPathD, arcSideOf, crossLayout, nodeDegrees, slotPositions, sortArcNodes } from "./arcGeometry.js";
15
+ import { fitLabels, labelReach, labelWidthLimit, placeArcLabel } from "./arcLabels.js";
16
+ import { isSelfLoop } from "../features/selfLoops.js";
17
+ import { arcLoopRoom, loopSide, placeLoops } from "./arcLoops.js";
18
+ /** A d3 continuous scale by name (`"sqrt"` → `scaleSqrt`). */ const namedScale = (name)=>{
19
+ const key = `scale${name.charAt(0).toUpperCase()}${name.slice(1)}`;
20
+ const make = scales[key];
21
+ return (make ?? scales.scaleSqrt)();
22
+ };
23
+ /**
24
+ The node radius scale for nodes `spacing` pixels apart. Nodes are at most
25
+ `sizeMax` (default: just under half the spacing, up to 20px). Unsized
26
+ nodes all draw at `sizeMin` (within that cap); sized ones run from
27
+ `sizeMin` (or half the cap, if smaller) up to the cap.
28
+ */ export function arcRadiusScale(values, opts) {
29
+ const cap = typeof opts.sizeMax === "number" ? opts.sizeMax : Math.max(1, Math.min(opts.spacing * 0.45, 20));
30
+ if (!values) {
31
+ const r = Math.min(opts.sizeMin, cap);
32
+ return Object.assign(()=>r, {
33
+ domain: undefined,
34
+ range: undefined
35
+ });
36
+ }
37
+ const ext = extent(values);
38
+ if (ext[0] === undefined || ext[0] === ext[1]) {
39
+ const scale = scales.scaleLinear().domain([
40
+ 0,
41
+ 1
42
+ ]).range([
43
+ cap,
44
+ cap
45
+ ]);
46
+ return scale;
47
+ }
48
+ return namedScale(opts.sizeScale).domain(ext).range([
49
+ Math.min(cap / 2, opts.sizeMin),
50
+ cap
51
+ ]);
52
+ }
53
+ /** A node's group for `nodeSort: "group"`: its top `groupBy` (or `nodeGroupBy`) level, else its color value. */ export function arcNodeGroup(v, n) {
54
+ const top = (list)=>Array.isArray(list) && list.length > 1 ? list[0] : undefined;
55
+ const group = top(v.schema.groupBy);
56
+ if (group) return group(n.data, n.i);
57
+ const nodeGroup = top(v.schema.nodeGroupBy);
58
+ if (nodeGroup) return nodeGroup(n.node, n.i);
59
+ const color = v.schema.color;
60
+ return typeof color === "function" ? color(n.data, n.i) : undefined;
61
+ }
62
+ /** Resolves, filters, and orders the nodes and links, before any geometry. */ function resolveArcGraph(v) {
63
+ const graph = resolveGraphNodes(v);
64
+ const links = resolveGraphLinks(v, graph).map((l, index)=>({
65
+ ...l,
66
+ index
67
+ }))// Unresolved ends draw nothing.
68
+ .filter((l)=>l.source && l.target);
69
+ const degrees = nodeDegrees(links);
70
+ const order = new Map(v.schema.nodes.map((d, i)=>[
71
+ d,
72
+ i
73
+ ]));
74
+ const sortable = graph.map((n)=>({
75
+ ...n,
76
+ datum: n.data,
77
+ label: `${v._drawLabel(n.data, n.i) ?? ""}`,
78
+ group: arcNodeGroup(v, n),
79
+ degree: degrees.get(n.id) ?? 0,
80
+ order: order.get(n.node) ?? n.i
81
+ }));
82
+ const nodes = sortArcNodes(sortable, v.schema.nodeSort);
83
+ return {
84
+ nodes,
85
+ links: links.filter((l)=>!isSelfLoop(l)),
86
+ loops: links.filter((l)=>isSelfLoop(l))
87
+ };
88
+ }
89
+ /** The radius scale for the chart's nodes along a line `length` pixels long. */ function radiusFor(v, nodes, length) {
90
+ const spacing = nodes.length ? length / nodes.length : length;
91
+ return arcRadiusScale(v._size ? nodes.map((n)=>n.r) : null, {
92
+ sizeMin: v.schema.sizeMin,
93
+ sizeMax: v.schema.sizeMax,
94
+ sizeScale: v.schema.sizeScale || "sqrt",
95
+ spacing
96
+ });
97
+ }
98
+ /** Whether node labels draw at all (`shapeConfig.Circle.label: false` turns them off). */ function labelsOn(v) {
99
+ const cfg = shapeConfigFor(v, "Circle");
100
+ return cfg.label !== false;
101
+ }
102
+ /** The node label settings, their line height, and each node's label width (0 when labels are off). */ function measureNodeLabels(v, nodes) {
103
+ const settings = pointLabelSettings(v);
104
+ const lineHeight = Math.ceil(settings.fontSize * 1.2) + 1;
105
+ const font = {
106
+ size: settings.fontSize,
107
+ lineHeight: settings.fontSize * 1.2
108
+ };
109
+ const showLabels = labelsOn(v);
110
+ const widths = nodes.map((n)=>showLabels && n.label ? measureLabel(n.label, font).width : 0);
111
+ return {
112
+ settings,
113
+ lineHeight,
114
+ widths
115
+ };
116
+ }
117
+ /** Fits the labels and the line's extent along its axis, leaving room for slanted labels at the ends. */ function fitAlong(widths, length, lineHeight, maxDepth, orient, labelSide) {
118
+ const n = widths.length;
119
+ let start = 0;
120
+ let along = length;
121
+ let fit = {
122
+ angle: 0,
123
+ step: 1
124
+ };
125
+ let widthCap = Infinity;
126
+ for(let pass = 0; pass < 3; pass++){
127
+ const spacing = n ? along / n : along;
128
+ fit = fitLabels(max(widths) ?? 0, spacing, lineHeight, orient);
129
+ widthCap = labelWidthLimit(fit.angle, maxDepth, lineHeight, orient);
130
+ if (orient !== "horizontal" || fit.angle !== -45) break;
131
+ // Slanted labels reach past their node: down-left under the line,
132
+ // up-right over it. Inset the line so the end labels stay inside.
133
+ let inset = 0;
134
+ widths.forEach((w, i)=>{
135
+ if (i % fit.step) return;
136
+ const { spread } = labelReach(-45, Math.min(w, widthCap), lineHeight, orient);
137
+ const room = (labelSide === "below" ? i + 0.5 : n - i - 0.5) * spacing;
138
+ inset = Math.max(inset, spread - room);
139
+ });
140
+ start = labelSide === "below" ? inset : 0;
141
+ along = length - inset;
142
+ }
143
+ return {
144
+ start,
145
+ length: along,
146
+ fit,
147
+ widthCap
148
+ };
149
+ }
150
+ /** Each side's widest arc span, with every arc's side. */ function spansBySide(links, side) {
151
+ let above = 0, below = 0;
152
+ const sides = links.map((l)=>{
153
+ const s = arcSideOf(l.source.rank, l.target.rank, side);
154
+ const span = Math.abs(l.target.at - l.source.at);
155
+ if (s === "above") above = Math.max(above, span);
156
+ else below = Math.max(below, span);
157
+ return s;
158
+ });
159
+ return {
160
+ above,
161
+ below,
162
+ sides
163
+ };
164
+ }
165
+ /** Normalizes link widths onto `linkSizeScale`, from `linkSizeMin` to the smallest node's radius. */ function linkWidths(v, sizes, rMin) {
166
+ const ext = extent(sizes);
167
+ if (ext[0] === undefined || ext[0] === ext[1]) return sizes;
168
+ const lo = v.schema.linkSizeMin;
169
+ const scale = namedScale(v.schema.linkSizeScale || "sqrt").domain(ext).range([
170
+ lo,
171
+ Math.max(lo, rMin)
172
+ ]);
173
+ return sizes.map((s)=>scale(s));
174
+ }
175
+ /**
176
+ The arcs' and loops' stroke widths, on one scale: every width, the arcs'
177
+ widths, and each loop with its width.
178
+ */ function sizeLinks(v, arcs, loops, rMin) {
179
+ const allSizes = linkWidths(v, [
180
+ ...arcs,
181
+ ...loops
182
+ ].map((l)=>l.size), rMin);
183
+ const loopItems = loops.map((l, i)=>({
184
+ index: l.index,
185
+ datum: l.datum,
186
+ size: allSizes[arcs.length + i],
187
+ id: l.source.id
188
+ }));
189
+ return {
190
+ allSizes,
191
+ sizes: allSizes.slice(0, arcs.length),
192
+ loopItems
193
+ };
194
+ }
195
+ /** ArcDiagram's size-legend scale for a chart area of `width` × `height`. */ export function arcSizeLegendScale(v, width, height) {
196
+ if (!v._size || !Array.isArray(v.schema.nodes)) return null;
197
+ if (!Array.isArray(v._filteredData) || !Array.isArray(v.schema.links)) return null;
198
+ const { nodeLookup, linkLookup } = v.ctx;
199
+ const nodes = resolveGraphNodes(v);
200
+ v.ctx.nodeLookup = nodeLookup;
201
+ v.ctx.linkLookup = linkLookup;
202
+ if (!nodes.length) return null;
203
+ const length = v.schema.orient === "vertical" ? height : width;
204
+ return radiusFor(v, nodes, length);
205
+ }
206
+ /** The laid-out nodes, on the line at `base`. */ function placeNodes(ranked, radii, base, orient) {
207
+ return ranked.map((n, i)=>{
208
+ const [x, y] = orient === "horizontal" ? [
209
+ n.at,
210
+ base
211
+ ] : [
212
+ base,
213
+ n.at
214
+ ];
215
+ return {
216
+ __d3plus__: true,
217
+ data: n.data,
218
+ i: n.i,
219
+ id: n.id,
220
+ fx: x,
221
+ fy: y,
222
+ node: n.node,
223
+ shape: n.shape,
224
+ x,
225
+ y,
226
+ r: radii[i],
227
+ width: radii[i] * 2,
228
+ height: radii[i] * 2,
229
+ rank: n.rank,
230
+ label: n.label,
231
+ group: n.group,
232
+ degree: n.degree
233
+ };
234
+ });
235
+ }
236
+ /** The laid-out links, longest first so shorter arcs draw (and hit-test) over them. */ function placeLinks(placed, nodes, geometry, sides, sizes) {
237
+ const nodeById = new Map(nodes.map((n)=>[
238
+ n.id,
239
+ n
240
+ ]));
241
+ const links = placed.map((l, i)=>{
242
+ const arc = {
243
+ ...geometry,
244
+ from: l.source.at,
245
+ to: l.target.at,
246
+ side: sides[i]
247
+ };
248
+ return {
249
+ datum: l.datum,
250
+ source: nodeById.get(l.source.id),
251
+ target: nodeById.get(l.target.id),
252
+ size: sizes[i],
253
+ index: l.index,
254
+ arc,
255
+ d: arcPathD(arc)
256
+ };
257
+ });
258
+ return links.sort((a, b)=>Math.abs(b.arc.to - b.arc.from) - Math.abs(a.arc.to - a.arc.from) || a.index - b.index);
259
+ }
260
+ /** Each label's shown width (0 for a label skipped to fit), and how deep the widest reaches. */ function shownLabels(widths, line, lineHeight, orient) {
261
+ const shown = widths.map((w, i)=>i % line.fit.step ? 0 : Math.min(w, line.widthCap));
262
+ const widest = max(shown) ?? 0;
263
+ const depth = widest ? labelReach(line.fit.angle, widest, lineHeight, orient).depth : 0;
264
+ return {
265
+ shown,
266
+ depth
267
+ };
268
+ }
269
+ /** Each node's label with a shown width, placed on the labels' side of the line. */ function placeLabels(nodes, shown, positions, opts) {
270
+ return nodes.flatMap((n, i)=>shown[i] && n.label ? [
271
+ placeArcLabel({
272
+ ...opts,
273
+ id: `arc-label-${n.id}`,
274
+ datum: n.data,
275
+ text: n.label,
276
+ at: positions[i],
277
+ width: shown[i]
278
+ })
279
+ ] : []);
280
+ }
281
+ /** Stashes the layout, the id lookups hover and click focus read, and the link graph tooltips read. */ function stashArcCtx(v, ctx) {
282
+ publishLinkGraph(v, [
283
+ ...ctx.links
284
+ ].sort((a, b)=>a.index - b.index).map((l)=>l.datum), ctx.nodes.map(graphLinkEnd));
285
+ v.ctx.arcCtx = ctx;
286
+ v.ctx.nodeLookup = Object.fromEntries(ctx.nodes.map((n)=>[
287
+ n.id,
288
+ n
289
+ ]));
290
+ const neighbors = {};
291
+ for (const l of ctx.links){
292
+ if (l.loop) continue;
293
+ (neighbors[l.source.id] ??= []).push(l.target);
294
+ (neighbors[l.target.id] ??= []).push(l.source);
295
+ }
296
+ v.ctx.linkLookup = neighbors;
297
+ }
298
+ export const applyArcDiagramLayout = ({ viz })=>{
299
+ const v = viz;
300
+ const { width, height } = chartBounds(v);
301
+ if (!Array.isArray(v._filteredData)) v._filteredData = [];
302
+ if (!Array.isArray(v.schema.nodes)) v.schema.nodes = [];
303
+ if (!Array.isArray(v.schema.links)) v.schema.links = [];
304
+ const orient = v.schema.orient === "vertical" ? "vertical" : "horizontal";
305
+ const side = v.schema.arcSide || "above";
306
+ const labelSide = side === "below" ? "above" : "below";
307
+ const { nodes, links, loops } = resolveArcGraph(v);
308
+ const along = orient === "horizontal" ? width : height;
309
+ const cross = orient === "horizontal" ? height : width;
310
+ const { settings, lineHeight, widths } = measureNodeLabels(v, nodes);
311
+ const line = fitAlong(widths, along, lineHeight, cross * 0.3, orient, labelSide);
312
+ const positions = slotPositions(nodes.length, line.start, line.length);
313
+ const spacing = nodes.length ? line.length / nodes.length : line.length;
314
+ const r = radiusFor(v, nodes, line.length);
315
+ v._sizeLegendFinal = v._size ? r : null;
316
+ const radii = nodes.map((n)=>r(n.r) || 1);
317
+ const rMax = max(radii) ?? 0;
318
+ const ranked = nodes.map((n, rank)=>({
319
+ ...n,
320
+ rank,
321
+ at: positions[rank]
322
+ }));
323
+ const byId = new Map(ranked.map((n)=>[
324
+ n.id,
325
+ n
326
+ ]));
327
+ const placed = links.map((l)=>({
328
+ index: l.index,
329
+ datum: l.datum,
330
+ size: l.size,
331
+ source: byId.get(l.source.id),
332
+ target: byId.get(l.target.id)
333
+ }));
334
+ const spans = spansBySide(placed, side);
335
+ // Labels claim the room past the nodes on their side of the line.
336
+ const labelGap = rMax + settings.padding;
337
+ const { shown, depth } = shownLabels(widths, line, lineHeight, orient);
338
+ const { allSizes, sizes, loopItems } = sizeLinks(v, placed, loops, min(radii) ?? 1);
339
+ const loopRoom = arcLoopRoom(loopItems, new Map(ranked.map((n, i)=>[
340
+ n.id,
341
+ radii[i]
342
+ ])), spacing, side);
343
+ const { scale, base } = crossLayout({
344
+ cross,
345
+ spans,
346
+ labelSide,
347
+ labelBand: depth ? labelGap + depth : rMax,
348
+ rMax,
349
+ strokePad: (max(allSizes) ?? 1) / 2 + 2,
350
+ orient,
351
+ loops: loopRoom
352
+ });
353
+ const arcNodes = placeNodes(ranked, radii, base, orient);
354
+ const arcLinks = placeLinks(placed, arcNodes, {
355
+ base,
356
+ scale,
357
+ orient
358
+ }, spans.sides, sizes).concat(placeLoops(loopItems, arcNodes, {
359
+ base,
360
+ scale,
361
+ orient,
362
+ side: loopSide(side),
363
+ spacing
364
+ }));
365
+ const labels = placeLabels(arcNodes, shown, positions, {
366
+ base,
367
+ gap: labelGap,
368
+ spacing,
369
+ lineHeight,
370
+ angle: line.fit.angle,
371
+ side: labelSide,
372
+ orient
373
+ });
374
+ const linkConfig = shapeConfigFor(v, "Path", v.schema.shapeConfig, "edge");
375
+ delete linkConfig.on;
376
+ stashArcCtx(v, {
377
+ nodes: arcNodes,
378
+ links: arcLinks,
379
+ labels,
380
+ labelHalo: spans.sides.includes(labelSide),
381
+ linkConfig
382
+ });
383
+ return {
384
+ shapeData: arcNodes
385
+ };
386
+ };
@@ -0,0 +1,275 @@
1
+ /**
2
+ Pure geometry for ArcDiagram: node order, node positions along the line,
3
+ which side of the line each arc takes, how far arcs are flattened to fit,
4
+ and each arc's path and arrowhead tip.
5
+ */ import { arrowAlongChord, chordEndsPathD } from "../features/curvedArrows.js";
6
+ /**
7
+ How many link ends touch each node: a link counts once at each end, so a
8
+ link from a node to itself counts twice.
9
+ */ export function nodeDegrees(links) {
10
+ const out = new Map();
11
+ for (const l of links){
12
+ out.set(l.source.id, (out.get(l.source.id) ?? 0) + 1);
13
+ out.set(l.target.id, (out.get(l.target.id) ?? 0) + 1);
14
+ }
15
+ return out;
16
+ }
17
+ /** Compares two values: numbers by size, anything else as text, with numbers inside text read as numbers. */ export function naturalCompare(a, b) {
18
+ const missing = (v)=>v === undefined || v === null || v === "";
19
+ if (missing(a) || missing(b)) return missing(a) ? missing(b) ? 0 : 1 : -1;
20
+ if (typeof a === "number" && typeof b === "number") return a - b;
21
+ return String(a).localeCompare(String(b), undefined, {
22
+ numeric: true
23
+ });
24
+ }
25
+ /**
26
+ Orders nodes for the line: `"data"` keeps their order in `nodes`,
27
+ `"label"` sorts by label, `"group"` by group and then label, `"degree"`
28
+ puts the most connected first (then by label), and a comparator receives
29
+ two node rows. Ties keep the `nodes` order. Returns a new array.
30
+ */ export function sortArcNodes(nodes, sort) {
31
+ const byOrder = (a, b)=>a.order - b.order;
32
+ const byLabel = (a, b)=>naturalCompare(a.label, b.label);
33
+ const compare = typeof sort === "function" ? (a, b)=>sort(a.datum, b.datum) : sort === "label" ? byLabel : sort === "group" ? (a, b)=>naturalCompare(a.group, b.group) || byLabel(a, b) : sort === "degree" ? (a, b)=>b.degree - a.degree || byLabel(a, b) : ()=>0;
34
+ return [
35
+ ...nodes
36
+ ].sort((a, b)=>compare(a, b) || byOrder(a, b));
37
+ }
38
+ /**
39
+ Evenly spaced positions for `count` nodes along a line of `length`
40
+ pixels starting at `start`: each node sits in the middle of an equal slot,
41
+ so neighbors are `length / count` apart and the end nodes sit half a slot
42
+ in from the ends.
43
+ */ export function slotPositions(count, start, length) {
44
+ if (count <= 0) return [];
45
+ const step = length / count;
46
+ return Array.from({
47
+ length: count
48
+ }, (_, i)=>start + (i + 0.5) * step);
49
+ }
50
+ /**
51
+ The side an arc takes. With `"both"`, a link running forward along the
52
+ line (its source placed before its target) arcs above and a link running
53
+ backward arcs below, so the two directions read apart.
54
+ */ export function arcSideOf(sourceRank, targetRank, side) {
55
+ if (side === "below") return "below";
56
+ if (side === "both") return sourceRank <= targetRank ? "above" : "below";
57
+ return "above";
58
+ }
59
+ /**
60
+ How much the arcs flatten to fit. A semicircle over the farthest-apart
61
+ pair on a side rises half its span; `height` is the room both sides share.
62
+ Every arc's height is `scale` times half its span, so heights stay
63
+ proportional to spans on both sides, and `scale` is 1 (true semicircles)
64
+ whenever they fit. Returns the scale and each side's tallest arc.
65
+ */ export function arcScale(maxSpanAbove, maxSpanBelow, height) {
66
+ const need = (Math.max(0, maxSpanAbove) + Math.max(0, maxSpanBelow)) / 2;
67
+ const scale = need > 0 ? Math.max(0, Math.min(1, height / need)) : 1;
68
+ return {
69
+ scale,
70
+ above: scale * Math.max(0, maxSpanAbove) / 2,
71
+ below: scale * Math.max(0, maxSpanBelow) / 2
72
+ };
73
+ }
74
+ const round = (n)=>Math.round(n * 100) / 100;
75
+ /** Maps a point along the line (`u`) and out from it toward the arc's side (`h`) to the screen. */ export function arcPoint(arc, u, h) {
76
+ const dir = arc.side === "above" ? 1 : -1;
77
+ return arc.orient === "vertical" ? [
78
+ arc.base + h * dir,
79
+ u
80
+ ] : [
81
+ u,
82
+ arc.base - h * dir
83
+ ];
84
+ }
85
+ /**
86
+ The arc's SVG path: half an ellipse from its source to its target, as wide
87
+ as their span and `scale` times half the span tall. Horizontal arcs
88
+ "above" rise toward the top; vertical arcs "above" bulge to the right.
89
+ */ export function arcPathD(arc) {
90
+ const half = Math.abs(arc.to - arc.from) / 2;
91
+ const height = half * arc.scale;
92
+ const [x1, y1] = arcPoint(arc, arc.from, 0);
93
+ const [x2, y2] = arcPoint(arc, arc.to, 0);
94
+ const forward = arc.to > arc.from;
95
+ // Clockwise on screen from the earlier end to the later one passes over
96
+ // the top of a horizontal line and the right side of a vertical one.
97
+ const sweep = forward === (arc.side === "above") ? 1 : 0;
98
+ const [rx, ry] = arc.orient === "vertical" ? [
99
+ height,
100
+ half
101
+ ] : [
102
+ half,
103
+ height
104
+ ];
105
+ return `M${round(x1)},${round(y1)}A${round(rx)},${round(ry)} 0 0,${sweep} ${round(x2)},${round(y2)}`;
106
+ }
107
+ /** The arc's highest point: midway between its ends, `scale` times half its span out from the line. */ export function arcApex(arc) {
108
+ const half = Math.abs(arc.to - arc.from) / 2;
109
+ return arcPoint(arc, (arc.from + arc.to) / 2, half * arc.scale);
110
+ }
111
+ /**
112
+ Where an arrowhead at one end of an arc sits: on the arc, `inset` pixels
113
+ out from the line (clear of the node it points into), pointing along the
114
+ arc toward that end. `angle` is in radians.
115
+ */ export function arcEndTip(arc, end, inset) {
116
+ const [endU, otherU] = end === "target" ? [
117
+ arc.to,
118
+ arc.from
119
+ ] : [
120
+ arc.from,
121
+ arc.to
122
+ ];
123
+ const a = Math.abs(endU - otherU) / 2;
124
+ const b = a * arc.scale;
125
+ const center = (endU + otherU) / 2;
126
+ const toward = endU >= otherU ? 1 : -1;
127
+ const sin = b > 0 ? Math.min(1, Math.max(0, inset) / b) : 0;
128
+ const cos = Math.sqrt(1 - sin * sin);
129
+ const [x, y] = arcPoint(arc, center + toward * a * cos, b * sin);
130
+ // Travel along the arc toward its end: along the line toward `endU`, and
131
+ // back down toward the line.
132
+ const du = toward * a * sin;
133
+ const dh = -b * cos;
134
+ const dir = arc.side === "above" ? 1 : -1;
135
+ const [dx, dy] = arc.orient === "vertical" ? [
136
+ dh * dir,
137
+ du
138
+ ] : [
139
+ du,
140
+ -dh * dir
141
+ ];
142
+ return {
143
+ x,
144
+ y,
145
+ angle: Math.atan2(dy, dx)
146
+ };
147
+ }
148
+ /**
149
+ The point on an arc's ellipse `length` pixels along it from where it
150
+ stands `inset` pixels out from the line at `end` (where `arcEndTip` puts
151
+ that end's arrow tip), toward the arc's top. It stops at the top.
152
+ */ export function arcPointAlong(arc, end, inset, length) {
153
+ const [endU, otherU] = end === "target" ? [
154
+ arc.to,
155
+ arc.from
156
+ ] : [
157
+ arc.from,
158
+ arc.to
159
+ ];
160
+ const a = Math.abs(endU - otherU) / 2;
161
+ const b = a * arc.scale;
162
+ const center = (endU + otherU) / 2;
163
+ const toward = endU >= otherU ? 1 : -1;
164
+ let theta = b > 0 ? Math.asin(Math.min(1, Math.max(0, inset) / b)) : 0;
165
+ const steps = 512;
166
+ const dt = Math.PI / 2 / steps;
167
+ let left = Math.max(0, length);
168
+ while(left > 0 && theta < Math.PI / 2){
169
+ const next = Math.min(Math.PI / 2, theta + dt);
170
+ const mid = (theta + next) / 2;
171
+ const ds = Math.hypot(a * Math.sin(mid), b * Math.cos(mid)) * (next - theta);
172
+ if (ds >= left) {
173
+ theta += (next - theta) * (ds ? left / ds : 0);
174
+ left = 0;
175
+ } else {
176
+ left -= ds;
177
+ theta = next;
178
+ }
179
+ }
180
+ return arcPoint(arc, center + toward * a * Math.cos(theta), b * Math.sin(theta));
181
+ }
182
+ /**
183
+ An arc's visible stroke and arrowed ends. Each head's tip sits on the
184
+ arc `insets` pixels out from the line (see `arcEndTip`), its base `size`
185
+ further along the arc, and it is aimed along the chord from base to tip.
186
+ The stroke follows the arc between the bases, then runs along each
187
+ head's axis to end inside it (see `cubicArrowEdge`). The full arc stays
188
+ its hit area.
189
+ */ export function arcArrowEdge(arc, trims, insets) {
190
+ const { ends, size } = trims;
191
+ if (!ends.source && !ends.target) return {
192
+ d: arcPathD(arc)
193
+ };
194
+ const arrowed = (end)=>{
195
+ if (!ends[end]) return undefined;
196
+ const tip = arcEndTip(arc, end, insets[end]);
197
+ return arrowAlongChord([
198
+ tip.x,
199
+ tip.y
200
+ ], arcPointAlong(arc, end, insets[end], size), trims[end]);
201
+ };
202
+ const source = arrowed("source");
203
+ const target = arrowed("target");
204
+ const half = Math.abs(arc.to - arc.from) / 2;
205
+ const height = half * arc.scale;
206
+ const [x1, y1] = source ? source.base : arcPoint(arc, arc.from, 0);
207
+ const [x2, y2] = target ? target.base : arcPoint(arc, arc.to, 0);
208
+ const forward = arc.to > arc.from;
209
+ const sweep = forward === (arc.side === "above") ? 1 : 0;
210
+ const [rx, ry] = arc.orient === "vertical" ? [
211
+ height,
212
+ half
213
+ ] : [
214
+ half,
215
+ height
216
+ ];
217
+ const body = `M${round(x1)},${round(y1)}A${round(rx)},${round(ry)} 0 0,${sweep} ${round(x2)},${round(y2)}`;
218
+ return {
219
+ d: chordEndsPathD(body, source, target),
220
+ source,
221
+ target
222
+ };
223
+ }
224
+ /** The box an arc covers: its two ends and its highest point, as `[[x0, y0], [x1, y1]]`. */ export function arcBox(arc) {
225
+ const points = [
226
+ arcPoint(arc, arc.from, 0),
227
+ arcPoint(arc, arc.to, 0),
228
+ arcApex(arc)
229
+ ];
230
+ const xs = points.map((p)=>p[0]);
231
+ const ys = points.map((p)=>p[1]);
232
+ return [
233
+ [
234
+ Math.min(...xs),
235
+ Math.min(...ys)
236
+ ],
237
+ [
238
+ Math.max(...xs),
239
+ Math.max(...ys)
240
+ ]
241
+ ];
242
+ }
243
+ /** The cross-axis layout: how far arcs flatten, and where the line sits. */ export function crossLayout(opts) {
244
+ const { cross, spans, labelSide, labelBand, rMax, strokePad } = opts;
245
+ const loops = opts.loops ?? {
246
+ above: 0,
247
+ below: 0
248
+ };
249
+ const room = Math.max(0, cross - strokePad * 2);
250
+ const [labelArcs, otherArcs] = labelSide === "above" ? [
251
+ spans.above,
252
+ spans.below
253
+ ] : [
254
+ spans.below,
255
+ spans.above
256
+ ];
257
+ const scale = Math.min(arcScale(otherArcs, labelArcs, room).scale, arcScale(otherArcs, 0, room - labelBand).scale);
258
+ const region = (span, labeled, loop)=>Math.max(scale * span / 2, labeled ? labelBand : rMax, loop);
259
+ const regionAbove = region(spans.above, labelSide === "above", loops.above);
260
+ const regionBelow = region(spans.below, labelSide === "below", loops.below);
261
+ // The region first along the cross axis: above a horizontal line (the top),
262
+ // or below a vertical one (its left, where "below" arcs and labels go).
263
+ const [first, second] = opts.orient === "horizontal" ? [
264
+ regionAbove,
265
+ regionBelow
266
+ ] : [
267
+ regionBelow,
268
+ regionAbove
269
+ ];
270
+ const offset = Math.max(0, (cross - first - second - strokePad * 2) / 2);
271
+ return {
272
+ scale,
273
+ base: offset + strokePad + first
274
+ };
275
+ }