@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
@@ -3,9 +3,17 @@
3
3
  `ringsCtx` stashed on `viz.ctx`. Emits flat SceneNodes directly
4
4
  (no transient Shape compute pass).
5
5
  */ import { emitLabels } from "../../shapes/emitLabels.js";
6
- import { arrowEnds, arrowNode, arrowSizeFor, straightEdgeArrows } from "../features/edgeArrows.js";
6
+ import { cubicPathD, edgeArrowTrims, straightEdgeArrows, straightEdgeD } from "../features/edgeArrows.js";
7
7
  import { drawNodeLabel, paintFromShapeConfig, resolveAccessor, shapeConfigFor, userLabelConfig } from "../features/emitHelpers.js";
8
8
  import { backgroundImageNode } from "../features/backgroundImageEmit.js";
9
+ import { linkAriaLabel, linkHitPath, linkMeta } from "../features/linkInteraction.js";
10
+ import { linkColorResolver } from "../features/linkColor.js";
11
+ import { cubicMidpoint, segmentMidpoint } from "../features/linkLabelGeometry.js";
12
+ import { emitLinkLabels, textLineBoxes } from "../features/linkLabels.js";
13
+ import { curvePoints } from "../features/linkLabelPath.js";
14
+ import { selfLoopArrows, selfLoopD } from "../features/selfLoops.js";
15
+ import { chordArrowNodes, cubicArrowEdge } from "../features/curvedArrows.js";
16
+ import { uniqueLinkKeys } from "../features/linkKeys.js";
9
17
  /**
10
18
  Arrowheads for one Rings edge. Spline edges already terminate at the node
11
19
  boundary, so the tangent comes from the bezier's end control point; straight
@@ -14,6 +22,16 @@ import { backgroundImageNode } from "../features/backgroundImageEmit.js";
14
22
  const arrows = viz.schema.arrows;
15
23
  const baseKey = `${edge.source.id}-${edge.target.id}-${i}`;
16
24
  const fill = typeof stroke === "string" ? stroke : undefined;
25
+ if (edge.loop) return selfLoopArrows({
26
+ arrows,
27
+ arrowSize: viz.schema.arrowSize,
28
+ strokeWidth,
29
+ datum,
30
+ i,
31
+ keyPrefix: `rings-arrow-${baseKey}`,
32
+ fill,
33
+ loop: edge.loop
34
+ });
17
35
  if (!edge.spline) {
18
36
  return straightEdgeArrows({
19
37
  arrows,
@@ -27,35 +45,138 @@ import { backgroundImageNode } from "../features/backgroundImageEmit.js";
27
45
  target: edge.target
28
46
  });
29
47
  }
30
- const ends = arrowEnds(arrows, datum, i);
31
- if (!ends.source && !ends.target) return [];
32
- const size = arrowSizeFor(viz.schema.arrowSize, datum, i, typeof strokeWidth === "number" ? strokeWidth : 1);
33
- const out = [];
34
- if (ends.target && edge.targetX != null) {
35
- const angle = Math.atan2(edge.targetY - edge.targetBisectY, edge.targetX - edge.targetBisectX);
36
- out.push(arrowNode({
37
- key: `rings-arrow-t-${baseKey}`,
38
- datum,
39
- x: edge.targetX,
40
- y: edge.targetY,
41
- angle,
42
- size,
43
- fill
44
- }));
45
- }
46
- if (ends.source && edge.sourceX != null) {
47
- const angle = Math.atan2(edge.sourceY - edge.sourceBisectY, edge.sourceX - edge.sourceBisectX);
48
- out.push(arrowNode({
49
- key: `rings-arrow-s-${baseKey}`,
50
- datum,
51
- x: edge.sourceX,
52
- y: edge.sourceY,
53
- angle,
54
- size,
55
- fill
56
- }));
57
- }
58
- return out;
48
+ const curve = ringsCurve(edge);
49
+ if (!curve) return [];
50
+ const trims = ringsTrims(viz, edge, i, strokeWidth);
51
+ if (!trims.ends.source && !trims.ends.target) return [];
52
+ return chordArrowNodes({
53
+ ends: cubicArrowEdge(curve, trims),
54
+ size: trims.size,
55
+ datum,
56
+ keyPrefix: "rings-arrow",
57
+ keys: {
58
+ source: `rings-arrow-s-${baseKey}`,
59
+ target: `rings-arrow-t-${baseKey}`
60
+ },
61
+ fill
62
+ });
63
+ }
64
+ /** A spline edge's curve, from its source end to its target end, or null for a straight edge. */ function ringsCurve(edge) {
65
+ if (!edge.spline || edge.sourceX == null || edge.targetX == null) return null;
66
+ return [
67
+ [
68
+ edge.sourceX,
69
+ edge.sourceY
70
+ ],
71
+ [
72
+ edge.sourceBisectX,
73
+ edge.sourceBisectY
74
+ ],
75
+ [
76
+ edge.targetBisectX,
77
+ edge.targetBisectY
78
+ ],
79
+ [
80
+ edge.targetX,
81
+ edge.targetY
82
+ ]
83
+ ];
84
+ }
85
+ /** An edge's arrow ends, size, and stroke trims. */ const ringsTrims = (viz, edge, i, strokeWidth)=>edgeArrowTrims({
86
+ arrows: viz.schema.arrows,
87
+ arrowSize: viz.schema.arrowSize,
88
+ strokeWidth: typeof strokeWidth === "number" ? strokeWidth : undefined,
89
+ datum: edge.datum,
90
+ i
91
+ });
92
+ /**
93
+ An edge's visible stroke: `d`, cut short inside its arrowheads (see
94
+ `edgeArrowTrims`). A spline edge or a loop follows its curve up to each
95
+ head's base, then runs along the head's axis (see `cubicArrowEdge`); a
96
+ spline's arrow tips sit on the node's edge, where the curve ends.
97
+ */ export function ringsVisibleD(viz, edge, i, strokeWidth, d) {
98
+ const trims = ringsTrims(viz, edge, i, strokeWidth);
99
+ if (!trims.source && !trims.target) return d;
100
+ if (edge.loop) return selfLoopD(edge.loop, trims);
101
+ const curve = ringsCurve(edge);
102
+ if (curve) return cubicArrowEdge(curve, trims).d;
103
+ return straightEdgeD(edge.source, edge.target, trims);
104
+ }
105
+ /** An edge's base scene key (a loop's names its index, as a node can have several). */ const ringsLinkKey = (edge)=>`rings-link-${edge.source.id}-${edge.target.id}${edge.loop ? `-${linkMeta(edge.datum)?.index ?? 0}` : ""}`;
106
+ /** Each edge's scene key, unique across `edges`: parallel edges after the first add their order among them (see `uniqueLinkKeys`). */ export const ringsLinkKeys = (edges)=>uniqueLinkKeys(edges.map(ringsLinkKey));
107
+ /**
108
+ Where an edge's label goes: halfway along a spline edge's curve, along
109
+ a straight edge's run between its nodes, or at a loop's far point.
110
+ */ export function ringsEdgeAnchor(edge) {
111
+ if (edge.loop) return edge.loop.apex;
112
+ if (edge.spline && edge.sourceX != null && edge.targetX != null) return cubicMidpoint([
113
+ edge.sourceX,
114
+ edge.sourceY
115
+ ], [
116
+ edge.sourceBisectX,
117
+ edge.sourceBisectY
118
+ ], [
119
+ edge.targetBisectX,
120
+ edge.targetBisectY
121
+ ], [
122
+ edge.targetX,
123
+ edge.targetY
124
+ ]);
125
+ const r = (n)=>typeof n.r === "number" ? n.r : 0;
126
+ return segmentMidpoint([
127
+ edge.source.x,
128
+ edge.source.y
129
+ ], [
130
+ edge.target.x,
131
+ edge.target.y
132
+ ], r(edge.source), r(edge.target));
133
+ }
134
+ /**
135
+ The curve an edge's label follows: a spline edge's curve or a loop, or
136
+ null for a straight edge.
137
+ */ export function ringsEdgePath(edge) {
138
+ if (edge.loop) return curvePoints(edge.loop.d);
139
+ const curve = ringsCurve(edge);
140
+ return curve ? curvePoints(cubicPathD(curve)) : null;
141
+ }
142
+ /** One node group's labels, each rotated out from the center along its ring. */ function ringsNodeLabels(viz, c, shapeKind, values) {
143
+ const nodeCfg = c.nodeShapeConfig;
144
+ if (!values.length || !nodeCfg.label || !nodeCfg.labelBounds) return [];
145
+ const labelFn = nodeCfg.label;
146
+ const boundsFn = nodeCfg.labelBounds;
147
+ return emitLabels({
148
+ data: values,
149
+ label: (d, i)=>labelFn(d, i),
150
+ x: (d)=>d.x,
151
+ y: (d)=>d.y,
152
+ aes: (d)=>({
153
+ r: d.r
154
+ }),
155
+ rotate: (d)=>nodeCfg.rotate ? nodeCfg.rotate(d) : 0,
156
+ id: (d)=>`rings-label-${d.id}`,
157
+ labelBounds: (d, _i)=>boundsFn(d),
158
+ labelConfig: {
159
+ ...userLabelConfig(viz, shapeKind),
160
+ ...nodeCfg.labelConfig
161
+ }
162
+ });
163
+ }
164
+ /** The edge labels, clear of every node and node label. */ function ringsLinkLabels(viz, c, nodeLabels, keys) {
165
+ return emitLinkLabels(viz, c.edges.map((edge, i)=>({
166
+ key: keys[i],
167
+ link: edge,
168
+ i,
169
+ anchor: ringsEdgeAnchor(edge),
170
+ path: ringsEdgePath(edge),
171
+ priority: edge.size
172
+ })), {
173
+ circles: c.nodeGroups.flatMap(([, values])=>values.map((n)=>({
174
+ x: n.x,
175
+ y: n.y,
176
+ r: n.r
177
+ }))),
178
+ labels: textLineBoxes(nodeLabels)
179
+ });
59
180
  }
60
181
  /** One node's Circle or Rect SceneNode (origin-centered, placed by `transform`), or null for any other shape kind. */ function ringsNode(shapeKind, d, merged, base, i) {
61
182
  const key = `rings-${shapeKind}-${d.id}`;
@@ -86,26 +207,41 @@ export const ringsEmit = ({ viz })=>{
86
207
  const c = viz.ctx.ringsCtx;
87
208
  if (!c) return [];
88
209
  const out = [];
210
+ // Node labels first, so link labels can keep clear of them.
211
+ const nodeLabels = new Map((c.nodeGroups ?? []).map(([shapeKind, values])=>[
212
+ shapeKind,
213
+ ringsNodeLabels(viz, c, shapeKind, values)
214
+ ]));
89
215
  if (c.edges && c.edges.length) {
90
- for(let i = 0; i < c.edges.length; i++){
91
- const edge = c.edges[i];
92
- const datum = edge;
216
+ const linkColor = linkColorResolver(viz);
217
+ const keys = ringsLinkKeys(c.edges);
218
+ for (const [j, edge] of c.edges.entries()){
219
+ const datum = edge.datum;
220
+ const i = linkMeta(datum)?.index ?? 0;
93
221
  const paint = paintFromShapeConfig(c.linkConfig, datum, i);
94
222
  if (typeof edge.size === "number") paint.strokeWidth = edge.size;
95
- const sizeLabel = typeof edge.size === "number" ? `, ${edge.size}` : "";
223
+ const stroke = linkColor(datum, edge);
224
+ if (stroke) paint.stroke = stroke;
225
+ const key = keys[j];
226
+ const d = c.linkD(edge);
96
227
  out.push({
97
228
  type: "path",
98
- key: `rings-link-${edge.source.id}-${edge.target.id}`,
99
- d: c.linkD(edge),
229
+ key,
230
+ d: ringsVisibleD(viz, edge, i, paint.strokeWidth, d),
100
231
  datum,
232
+ index: i,
101
233
  paint,
102
234
  aria: {
103
- label: `${drawNodeLabel(viz, edge.source, 0)} to ${drawNodeLabel(viz, edge.target, 0)}${sizeLabel}.`
235
+ label: linkAriaLabel(viz, datum)
104
236
  }
105
237
  });
238
+ out.push(linkHitPath(key, d, datum, paint.strokeWidth));
106
239
  // Optional directional arrowheads.
107
240
  out.push(...ringsEdgeArrows(viz, edge, datum, paint.stroke, paint.strokeWidth, i));
108
241
  }
242
+ out.push(...ringsLinkLabels(viz, c, [
243
+ ...nodeLabels.values()
244
+ ].flat(), keys));
109
245
  }
110
246
  if (c.nodeGroups && c.nodeGroups.length) {
111
247
  const nodeCfg = c.nodeShapeConfig;
@@ -151,27 +287,7 @@ export const ringsEmit = ({ viz })=>{
151
287
  if (image) images.push(image);
152
288
  }
153
289
  out.push(...images);
154
- if (nodeCfg.label && nodeCfg.labelBounds) {
155
- const labelFn = nodeCfg.label;
156
- const boundsFn = nodeCfg.labelBounds;
157
- const labelNodes = emitLabels({
158
- data: values,
159
- label: (d, i)=>labelFn(d, i),
160
- x: (d)=>d.x,
161
- y: (d)=>d.y,
162
- aes: (d)=>({
163
- r: d.r
164
- }),
165
- rotate: (d)=>nodeCfg.rotate ? nodeCfg.rotate(d) : 0,
166
- id: (d)=>`rings-label-${d.id}`,
167
- labelBounds: (d, _i)=>boundsFn(d),
168
- labelConfig: {
169
- ...userLabelConfig(viz, shapeKind),
170
- ...nodeCfg.labelConfig
171
- }
172
- });
173
- out.push(...labelNodes);
174
- }
290
+ out.push(...nodeLabels.get(shapeKind) ?? []);
175
291
  }
176
292
  }
177
293
  return out;
@@ -7,50 +7,58 @@
7
7
  - `emit.ts` — link Paths + per-shape-type node groups.
8
8
  - `ringsGraph.ts` — node set + link resolution.
9
9
  - `ringsSizing.ts` — ring geometry + node sizing.
10
- */ import { addToQueue } from "@d3plus/data";
11
- import { fieldAccessor } from "../../utils/fieldAccessor.js";
10
+ */ import { fieldAccessor } from "../../utils/fieldAccessor.js";
12
11
  import constant from "../../utils/constant.js";
13
12
  import { makeChart } from "../definition/makeChart.js";
14
13
  import { runPostDrawFeatures } from "../pipeline/runVizPipeline.js";
15
14
  import { sceneInsetRegion } from "../pipeline/insetPlacement.js";
16
15
  import { drawChart } from "../facet/drawFacets.js";
16
+ import { loaderFormatFields, setLoaderValue } from "../viz/loaderFormat.js";
17
17
  import { applyRingsLayout, ringsSizeLegendScale } from "./applyLayout.js";
18
18
  import { ringsEmit } from "./emit.js";
19
19
  import { simpleHover } from "../viz/simpleHover.js";
20
+ import { effectiveDuration } from "../viz/reducedMotion.js";
21
+ import { themed } from "../../utils/theme.js";
22
+ import { clearLinkFocus, focusLink, installFocusBackgroundClick } from "../features/linkFocus.js";
23
+ import { isLinkDatum, linkHighlight, linkMeta, linkTooltipConfig } from "../features/linkInteraction.js";
24
+ import { linkSizeMaxField, linkStyleFields } from "../features/linkFields.js";
20
25
  /** Installs Rings' nodes/links/size/hover fluent accessors onto the instance. */ function installRingsAccessors(viz) {
21
26
  const v = viz;
22
- const queue = (that, _, f, key)=>addToQueue.bind(that)(_, f, key);
23
27
  /**
24
28
  The edges that connect the `nodes`. The `source` and `target` of each
25
29
  link refer to a node by its `id`, by the node object itself (matched by
26
30
  its `id`), or by its index in the `nodes` array. Links to a node that
27
- doesn't exist are dropped.
31
+ doesn't exist are dropped. A link whose `source` and `target` are the
32
+ same node draws as a loop on that node.
28
33
 
29
34
  Accepts an array of links, or a URL/filepath string to load them from.
30
- An optional formatting function can be passed as a second argument; it
31
- receives the loaded data and returns the final links array.
35
+ `linksFormat` transforms them; a function passed as a second argument
36
+ sets it.
32
37
  @type {object[] | string}
33
- */ v.links = function(_, f) {
38
+ */ v.links = function() {
34
39
  if (!arguments.length) return this.schema.links;
35
- queue(this, _, f, "links");
40
+ // eslint-disable-next-line prefer-rest-params
41
+ setLoaderValue(this, "links", arguments);
36
42
  return this;
37
43
  };
38
44
  /**
39
45
  The nodes to draw. When empty, the nodes are the unique `source` and
40
46
  `target` values in `links`. Accepts an array of node objects, or a
41
- URL/filepath string to load them from. An optional formatting function
42
- can be passed as a second argument; it receives the loaded data and
43
- returns the final nodes array.
47
+ URL/filepath string to load them from. `nodesFormat` transforms them; a
48
+ function passed as a second argument sets it.
44
49
  @type {object[] | string}
45
- */ v.nodes = function(_, f) {
50
+ */ v.nodes = function() {
46
51
  if (!arguments.length) return this.schema.nodes;
47
- queue(this, _, f, "nodes");
52
+ // eslint-disable-next-line prefer-rest-params
53
+ setLoaderValue(this, "nodes", arguments);
48
54
  return this;
49
55
  };
50
56
  /**
51
57
  The thickness of each link: a pixel number used for every link, or an
52
- accessor function whose values are scaled between `linkSizeMin` and the
53
- smallest node radius (see `linkSizeScale`).
58
+ accessor function whose values are scaled between `linkSizeMin` and
59
+ `linkSizeMax` (see `linkSizeScale`). The function receives each
60
+ link, with `source` and `target` set to the data of the nodes at its
61
+ ends, and its index in `links`.
54
62
  @type {number | function}
55
63
  */ v.linkSize = function(_) {
56
64
  return arguments.length ? (this.schema.linkSize = typeof _ === "function" ? _ : constant(_), this) : this.schema.linkSize;
@@ -103,6 +111,11 @@ export const ringsDef = {
103
111
  const defaultMouseMove = viz.schema.on["mousemove.shape"];
104
112
  viz.schema.on["mousemove.shape"] = (d, i, x, event)=>{
105
113
  defaultMouseMove(d, i, x, event);
114
+ const nodeKey = (h, hi)=>`${viz._ids(h, hi)[viz._drawDepth]}`;
115
+ if (isLinkDatum(d)) {
116
+ v.hover(linkHighlight(viz, d, nodeKey));
117
+ return;
118
+ }
106
119
  if (viz._focus && viz._focus === d.id) {
107
120
  v.hover(false);
108
121
  viz.schema.on.mouseenter.bind(viz)(d, i, x, event);
@@ -133,12 +146,21 @@ export const ringsDef = {
133
146
  if (l.y + l.r > yDomain[1]) yDomain[1] = l.y + l.r;
134
147
  });
135
148
  v.hover((h, x)=>{
136
- const edge = h;
137
- if (edge.source && edge.target) return edge.source.id === node.id || edge.target.id === node.id;
138
- return filterIds.includes(viz._ids(h, x)[viz._drawDepth]);
149
+ const m = linkMeta(h);
150
+ if (m) return m.source.id === node.id || m.target.id === node.id;
151
+ return filterIds.includes(nodeKey(h, x));
139
152
  });
140
153
  };
154
+ installFocusBackgroundClick(viz);
141
155
  viz.schema.on["click.shape"] = (d)=>{
156
+ // A link focuses; a node re-centers the chart on it.
157
+ if (isLinkDatum(d)) {
158
+ focusLink(viz, d, {
159
+ nodeKey: (h, hi)=>`${viz._ids(h, hi)[viz._drawDepth]}`
160
+ });
161
+ return;
162
+ }
163
+ clearLinkFocus(viz);
142
164
  // Clear the hover/tooltip before re-centering: the clicked node's shapes
143
165
  // move out from under the pointer, so a lingering tooltip would hang over
144
166
  // unrelated content (the shared click.shape drill handler does the same).
@@ -164,7 +186,7 @@ export const ringsDef = {
164
186
  // _draw() only recomputes layout/scene; paint it with the chart duration
165
187
  // so the re-centering animates (a bare _draw leaves the only repaint to
166
188
  // the coalesced duration-0 one, which snaps).
167
- if (viz._sceneRenderer) viz._drawSceneToTarget(viz.schema.duration);
189
+ if (viz._sceneRenderer) viz._drawSceneToTarget(effectiveDuration(viz));
168
190
  };
169
191
  },
170
192
  // Small-multiple panels as close to square as the grid allows.
@@ -185,7 +207,9 @@ export const ringsDef = {
185
207
  },
186
208
  /**
187
209
  The arrowhead size in pixels, or an accessor function returning one
188
- per link. Defaults to three times the link's stroke width (at least 6).
210
+ per link. Defaults to three times the link's stroke width, at least 6
211
+ and at most 12 pixels, but never under 1.5 times the stroke width so
212
+ the head stays wider than its line. The line stops inside the head.
189
213
  @type {number | function}
190
214
  */ {
191
215
  key: "arrowSize"
@@ -201,13 +225,10 @@ export const ringsDef = {
201
225
  {
202
226
  key: "tooltipConfig",
203
227
  merge: true,
204
- factory: (viz)=>({
205
- title: (d)=>{
206
- const edge = d;
207
- return d && edge.source && edge.target ? `${edge.source.id} → ${edge.target.id}` : viz._drawLabel(d, typeof d.i === "number" ? d.i : 0);
208
- }
209
- })
228
+ factory: (viz)=>linkTooltipConfig(viz)
210
229
  },
230
+ ...linkStyleFields(),
231
+ ...loaderFormatFields("links", "nodes"),
211
232
  {
212
233
  key: "links",
213
234
  default: []
@@ -216,7 +237,11 @@ export const ringsDef = {
216
237
  key: "linkSize",
217
238
  default: constant(1)
218
239
  },
219
- /** The minimum pixel stroke width used when sizing links. */ {
240
+ /**
241
+ The widest link, in pixels, when `linkSize` values differ. Defaults
242
+ to half the smallest node's radius.
243
+ */ linkSizeMaxField(),
244
+ /** The thinnest link, in pixels, when `linkSize` values differ. */ {
220
245
  key: "linkSizeMin",
221
246
  default: 1
222
247
  },
@@ -236,6 +261,14 @@ export const ringsDef = {
236
261
  default: []
237
262
  },
238
263
  /**
264
+ How many links a node's tooltip lists under its number of
265
+ connections, strongest first: a number, or `false` for none. Defaults
266
+ to 3 when the links differ in `linkSize`, and none otherwise.
267
+ @type {number | false}
268
+ */ {
269
+ key: "nodeTooltipLinks"
270
+ },
271
+ /**
239
272
  The maximum pixel radius of a node. Defaults to the largest radius
240
273
  that keeps neighboring nodes from overlapping.
241
274
  @type {number}
@@ -279,7 +312,7 @@ export const ringsDef = {
279
312
  Path: {
280
313
  fill: "none",
281
314
  label: false,
282
- stroke: "#adb5bd",
315
+ stroke: ()=>themed(viz._theme, (t)=>t.link, "#adb5bd"),
283
316
  strokeWidth: 1
284
317
  }
285
318
  })
@@ -3,7 +3,13 @@
3
3
  builds the node set and link descriptors from data and `nodes`/`links`.
4
4
 
5
5
  @module
6
- */ /**
6
+ */ import { makeLinkDatum, setLinkValue } from "../features/linkInteraction.js";
7
+ /** A node record as a link end. */ export const ringsLinkEnd = (n)=>({
8
+ data: n.data,
9
+ i: n.i,
10
+ id: n.id
11
+ });
12
+ /**
7
13
  Resolve one link endpoint to its node: a node object by its id, else a
8
14
  node id (raw or coerced), else a number as an index into `schema.nodes`.
9
15
  Undefined when nothing matches.
@@ -30,7 +36,8 @@
30
36
  /**
31
37
  Build the Rings node set + link descriptors from filtered data and schema
32
38
  nodes/links. Stashes `nodeLookup` on `viz.ctx` and returns the working
33
- `nodes`, `nodeLookup`, `links`, and per-node `linkMap`.
39
+ `nodes`, `nodeLookup`, `links`, and per-node `linkMap` (which leaves out
40
+ links from a node to itself).
34
41
  */ export function buildRingsGraph(v, data) {
35
42
  let rawNodes = v.schema.nodes;
36
43
  if (!rawNodes.length && v.schema.links.length) {
@@ -65,14 +72,26 @@
65
72
  return obj;
66
73
  }, {});
67
74
  v.ctx.nodeLookup = nodeLookup;
68
- const links = v.schema.links.map((link)=>({
69
- source: resolveRingsLinkEnd(v, nodeLookup, link.source),
70
- target: resolveRingsLinkEnd(v, nodeLookup, link.target),
71
- size: v.schema.linkSize(link)
72
- }))// A link can name a node id that isn't in the nodes set; that endpoint
73
- // resolves to undefined and can't be placed, so drop the whole link.
74
- .filter((link)=>link.source && link.target);
75
+ // A link can name a node id that isn't in the nodes set; that endpoint
76
+ // resolves to undefined and can't be placed, so the whole link is dropped.
77
+ const links = v.schema.links.flatMap((link, i)=>{
78
+ const source = resolveRingsLinkEnd(v, nodeLookup, link.source);
79
+ const target = resolveRingsLinkEnd(v, nodeLookup, link.target);
80
+ if (!source || !target) return [];
81
+ const datum = makeLinkDatum(link, ringsLinkEnd(source), ringsLinkEnd(target), i);
82
+ const size = setLinkValue(datum, v.schema.linkSize(datum, i));
83
+ return [
84
+ {
85
+ source,
86
+ target,
87
+ size,
88
+ datum
89
+ }
90
+ ];
91
+ });
92
+ // A link from a node to itself places nothing; it draws as a loop.
75
93
  const linkMap = links.reduce((map, link)=>{
94
+ if (link.source === link.target) return map;
76
95
  if (!map[link.source.id]) map[link.source.id] = [];
77
96
  map[link.source.id].push(link);
78
97
  if (!map[link.target.id]) map[link.target.id] = [];
@@ -0,0 +1,73 @@
1
+ /**
2
+ Rings' loops: each placed node's links to itself, drawn as loops into the
3
+ widest gap between its drawn links and, on the rings, its label.
4
+ */ import { isSelfLoop, layoutSelfLoops, selfLoopReach, widestGapAngle } from "../features/selfLoops.js";
5
+ const isPlaced = (n)=>!!n && typeof n.x === "number" && typeof n.y === "number" && typeof n.r === "number";
6
+ /**
7
+ The loops on the placed `nodes`, as edges carrying their `loop`: a
8
+ node's loops point into the widest gap between the nodes its drawn
9
+ `edges` reach and, for a ring node, its label (which runs out from the
10
+ center). The center's loops stay inside the first ring.
11
+ */ export function ringsLoops(links, nodes, edges, center, geom) {
12
+ const placed = new Map(nodes.filter(isPlaced).map((n)=>[
13
+ n.id,
14
+ n
15
+ ]));
16
+ const loops = links.filter((l)=>isSelfLoop(l) && placed.has(l.source.id));
17
+ if (!loops.length) return [];
18
+ const occupied = new Map();
19
+ const add = (id, p)=>{
20
+ if (!occupied.has(id)) occupied.set(id, []);
21
+ occupied.get(id).push(p);
22
+ };
23
+ for (const e of edges){
24
+ const s = placed.get(e.source.id);
25
+ const t = placed.get(e.target.id);
26
+ if (!s || !t || s === t) continue;
27
+ add(s.id, [
28
+ t.x,
29
+ t.y
30
+ ]);
31
+ add(t.id, [
32
+ s.x,
33
+ s.y
34
+ ]);
35
+ }
36
+ for (const n of placed.values()){
37
+ if (n.id === center.id || typeof n.radians !== "number") continue;
38
+ add(n.id, [
39
+ n.x + Math.cos(n.radians) * (n.r + 10),
40
+ n.y + Math.sin(n.radians) * (n.r + 10)
41
+ ]);
42
+ }
43
+ const centerRoom = Math.max(8, (geom.primaryRing - (center.r ?? 0)) * 0.6);
44
+ // The center's loops keep their line within its room (a stroke's line
45
+ // runs a stroke and a half past its hairline reach, see `selfLoopOpening`).
46
+ const centerStroke = Math.max(0, ...loops.filter((l)=>l.source.id === center.id).map((l)=>l.size ?? 1));
47
+ const centerReach = Math.max(0, centerRoom - centerStroke * 1.5);
48
+ const layout = layoutSelfLoops(loops, {
49
+ node: (l)=>placed.get(l.source.id),
50
+ angle: (n)=>widestGapAngle([
51
+ n.x,
52
+ n.y
53
+ ], occupied.get(n.id) ?? [], -Math.PI / 2),
54
+ strokeWidth: (l)=>l.size ?? 1,
55
+ reach: (l)=>{
56
+ const n = placed.get(l.source.id);
57
+ const reach = selfLoopReach(n.r);
58
+ return n.id === center.id ? Math.min(reach, centerReach) : reach;
59
+ }
60
+ });
61
+ return loops.flatMap((l)=>{
62
+ const loop = layout.get(l);
63
+ const node = placed.get(l.source.id);
64
+ return loop ? [
65
+ {
66
+ ...l,
67
+ source: node,
68
+ target: node,
69
+ loop
70
+ }
71
+ ] : [];
72
+ });
73
+ }