@d3plus/core 4.9.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 (687) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +170 -9
  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 +95 -4
  21. package/es/src/charts/BoxWhisker/outliers.js +68 -0
  22. package/es/src/charts/BoxWhisker/summary.js +83 -0
  23. package/es/src/charts/BoxWhisker/tooltip.js +122 -0
  24. package/es/src/charts/BubbleChart/emit.js +31 -0
  25. package/es/src/charts/BubbleChart/index.js +54 -0
  26. package/es/src/charts/Bullet/index.js +2 -1
  27. package/es/src/charts/BumpChart/index.js +5 -0
  28. package/es/src/charts/Calendar/emit.js +1 -1
  29. package/es/src/charts/Calendar/index.js +5 -3
  30. package/es/src/charts/Candlestick/aggregate.js +11 -1
  31. package/es/src/charts/Candlestick/buffer.js +6 -4
  32. package/es/src/charts/Candlestick/index.js +7 -6
  33. package/es/src/charts/Chord/applyLayout.js +56 -69
  34. package/es/src/charts/Chord/emit.js +55 -24
  35. package/es/src/charts/Chord/index.js +17 -12
  36. package/es/src/charts/Chord/labels.js +105 -0
  37. package/es/src/charts/Donut/index.js +5 -11
  38. package/es/src/charts/Dumbbell/index.js +2 -4
  39. package/es/src/charts/Funnel/index.js +2 -1
  40. package/es/src/charts/Gantt/applyLayout.js +162 -0
  41. package/es/src/charts/Gantt/emit.js +142 -0
  42. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  43. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  44. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  45. package/es/src/charts/Gantt/ganttRows.js +111 -0
  46. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  47. package/es/src/charts/Gantt/index.js +219 -0
  48. package/es/src/charts/Gauge/index.js +2 -1
  49. package/es/src/charts/Geomap/applyLayout.js +90 -49
  50. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  51. package/es/src/charts/Geomap/emit.js +19 -2
  52. package/es/src/charts/Geomap/flowEmit.js +132 -0
  53. package/es/src/charts/Geomap/flowEvents.js +86 -0
  54. package/es/src/charts/Geomap/flowFields.js +91 -0
  55. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  56. package/es/src/charts/Geomap/flowLinks.js +239 -0
  57. package/es/src/charts/Geomap/geoCache.js +180 -0
  58. package/es/src/charts/Geomap/globeKeys.js +131 -0
  59. package/es/src/charts/Geomap/globeRotate.js +208 -0
  60. package/es/src/charts/Geomap/index.js +60 -19
  61. package/es/src/charts/Geomap/pointLabels.js +107 -0
  62. package/es/src/charts/Hexbin/binning.js +103 -0
  63. package/es/src/charts/Hexbin/buffer.js +33 -0
  64. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  65. package/es/src/charts/Hexbin/contours.js +48 -0
  66. package/es/src/charts/Hexbin/emit.js +142 -0
  67. package/es/src/charts/Hexbin/index.js +204 -0
  68. package/es/src/charts/Hexbin/layers.js +212 -0
  69. package/es/src/charts/Hexbin/settings.js +86 -0
  70. package/es/src/charts/Hexbin/tooltip.js +77 -0
  71. package/es/src/charts/Histogram/binData.js +31 -4
  72. package/es/src/charts/Histogram/index.js +37 -16
  73. package/es/src/charts/Histogram/labels.js +18 -0
  74. package/es/src/charts/Icicle/index.js +3 -3
  75. package/es/src/charts/LinePlot/index.js +7 -0
  76. package/es/src/charts/Marimekko/index.js +7 -4
  77. package/es/src/charts/Matrix/index.js +3 -2
  78. package/es/src/charts/Network/applyLayout.js +138 -94
  79. package/es/src/charts/Network/bundle.js +81 -0
  80. package/es/src/charts/Network/clusterLabels.js +423 -0
  81. package/es/src/charts/Network/clusters.js +290 -0
  82. package/es/src/charts/Network/emit.js +253 -70
  83. package/es/src/charts/Network/graph.js +117 -0
  84. package/es/src/charts/Network/graphFluent.js +79 -0
  85. package/es/src/charts/Network/index.js +93 -108
  86. package/es/src/charts/Network/minNodeDistance.js +64 -0
  87. package/es/src/charts/Network/polygonRows.js +44 -0
  88. package/es/src/charts/Pack/index.js +7 -2
  89. package/es/src/charts/Pie/applyLayout.js +86 -27
  90. package/es/src/charts/Pie/arcFit.js +152 -0
  91. package/es/src/charts/Pie/curvedLabels.js +134 -0
  92. package/es/src/charts/Pie/emit.js +43 -96
  93. package/es/src/charts/Pie/index.js +66 -32
  94. package/es/src/charts/Pie/labelRoom.js +154 -0
  95. package/es/src/charts/Pie/outsideLabels.js +224 -0
  96. package/es/src/charts/Pie/outsideNodes.js +267 -0
  97. package/es/src/charts/Pie/pieLabels.js +137 -0
  98. package/es/src/charts/Pie/sectorBox.js +223 -0
  99. package/es/src/charts/Pie/straightLabels.js +96 -0
  100. package/es/src/charts/Pie/straightLayout.js +215 -0
  101. package/es/src/charts/Plot/alongLegend.js +76 -0
  102. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  103. package/es/src/charts/Plot/axisHover.js +180 -0
  104. package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
  105. package/es/src/charts/Plot/axisHoverScene.js +203 -0
  106. package/es/src/charts/Plot/axisValues.js +43 -0
  107. package/es/src/charts/Plot/barHitArea.js +81 -0
  108. package/es/src/charts/Plot/barLabelFit.js +123 -0
  109. package/es/src/charts/Plot/barWidth.js +61 -13
  110. package/es/src/charts/Plot/circleLabels.js +98 -0
  111. package/es/src/charts/Plot/confidenceConfig.js +2 -2
  112. package/es/src/charts/Plot/connectGaps.js +237 -0
  113. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  114. package/es/src/charts/Plot/draw.js +14 -4
  115. package/es/src/charts/Plot/fillBetween.js +2 -1
  116. package/es/src/charts/Plot/forecastScene.js +3 -4
  117. package/es/src/charts/Plot/index.js +42 -15
  118. package/es/src/charts/Plot/labelPlacement.js +10 -2
  119. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  120. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  121. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  122. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  123. package/es/src/charts/Plot/openDomainEnds.js +2 -5
  124. package/es/src/charts/Plot/pipeline.js +71 -22
  125. package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
  126. package/es/src/charts/Plot/pipelineDomains.js +23 -6
  127. package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
  128. package/es/src/charts/Plot/pipelineScales.js +40 -8
  129. package/es/src/charts/Plot/plotFacet.js +12 -1
  130. package/es/src/charts/Plot/plotInit.js +49 -5
  131. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  132. package/es/src/charts/Plot/plotZoom.js +15 -6
  133. package/es/src/charts/Plot/referenceDomains.js +133 -0
  134. package/es/src/charts/Plot/shapeDefaults.js +14 -9
  135. package/es/src/charts/Plot/sharedHoverScene.js +50 -31
  136. package/es/src/charts/Plot/sharedTooltip.js +19 -7
  137. package/es/src/charts/Plot/stackHelpers.js +13 -1
  138. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  139. package/es/src/charts/Plot/stackShareTooltip.js +9 -4
  140. package/es/src/charts/Plot/stackThreshold.js +154 -0
  141. package/es/src/charts/Plot/trendLabels.js +183 -0
  142. package/es/src/charts/Plot/trendLines.js +1 -0
  143. package/es/src/charts/Plot/trendScene.js +6 -3
  144. package/es/src/charts/Plot/trendTooltip.js +5 -1
  145. package/es/src/charts/PolarArea/index.js +5 -4
  146. package/es/src/charts/Priestley/applyLayout.js +14 -20
  147. package/es/src/charts/Priestley/index.js +4 -34
  148. package/es/src/charts/Priestley/timeAxis.js +100 -0
  149. package/es/src/charts/Pyramid/index.js +4 -2
  150. package/es/src/charts/Radar/axisDecorations.js +49 -12
  151. package/es/src/charts/Radar/curvedLabels.js +187 -0
  152. package/es/src/charts/Radar/index.js +5 -5
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +4 -1
  155. package/es/src/charts/RadialBar/index.js +18 -10
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/index.js +6 -9
  158. package/es/src/charts/Rings/applyLayout.js +41 -24
  159. package/es/src/charts/Rings/emit.js +174 -58
  160. package/es/src/charts/Rings/index.js +65 -30
  161. package/es/src/charts/Rings/ringsGraph.js +28 -9
  162. package/es/src/charts/Rings/ringsLoops.js +73 -0
  163. package/es/src/charts/Rings/ringsParallel.js +166 -0
  164. package/es/src/charts/Sankey/applyLayout.js +116 -39
  165. package/es/src/charts/Sankey/circularLayout.js +208 -0
  166. package/es/src/charts/Sankey/circularLinks.js +301 -0
  167. package/es/src/charts/Sankey/emit.js +164 -94
  168. package/es/src/charts/Sankey/index.js +75 -77
  169. package/es/src/charts/Sankey/labels.js +80 -0
  170. package/es/src/charts/Sankey/ribbons.js +88 -0
  171. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  172. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  173. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  174. package/es/src/charts/Scatter/index.js +25 -0
  175. package/es/src/charts/SlopeChart/index.js +116 -0
  176. package/es/src/charts/SlopeChart/slope.js +95 -0
  177. package/es/src/charts/Streamgraph/index.js +51 -0
  178. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  179. package/es/src/charts/Sunburst/emit.js +74 -63
  180. package/es/src/charts/Sunburst/index.js +3 -3
  181. package/es/src/charts/Tree/index.js +2 -6
  182. package/es/src/charts/Treemap/applyLayout.js +14 -1
  183. package/es/src/charts/Treemap/emit.js +8 -2
  184. package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
  185. package/es/src/charts/Treemap/groupHeaders.js +95 -0
  186. package/es/src/charts/Treemap/index.js +17 -7
  187. package/es/src/charts/Treemap/thresholdFunction.js +11 -9
  188. package/es/src/charts/Violin/inner.js +3 -5
  189. package/es/src/charts/Waffle/index.js +4 -2
  190. package/es/src/charts/Waffle/tooltip.js +6 -2
  191. package/es/src/charts/Waterfall/index.js +4 -2
  192. package/es/src/charts/definition/makeChart.js +20 -5
  193. package/es/src/charts/drawSteps/backControl.js +17 -5
  194. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  195. package/es/src/charts/drawSteps/minimap.js +6 -5
  196. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  197. package/es/src/charts/drawSteps/saveChart.js +176 -0
  198. package/es/src/charts/drawSteps/saveControl.js +148 -0
  199. package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
  200. package/es/src/charts/drawSteps/searchControls.js +2 -1
  201. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  202. package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
  203. package/es/src/charts/drawSteps/topLeftControls.js +3 -1
  204. package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
  205. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  206. package/es/src/charts/events/click.legend.js +7 -2
  207. package/es/src/charts/events/click.shape.js +38 -2
  208. package/es/src/charts/events/mouseenter.js +9 -0
  209. package/es/src/charts/events/mousemove.legend.js +3 -0
  210. package/es/src/charts/events/mousemove.shape.js +12 -4
  211. package/es/src/charts/facet/drawFacets.js +14 -5
  212. package/es/src/charts/facet/facetConfig.js +2 -2
  213. package/es/src/charts/facet/facetData.js +2 -2
  214. package/es/src/charts/features/annotationFrame.js +179 -0
  215. package/es/src/charts/features/annotationText.js +83 -0
  216. package/es/src/charts/features/annotationTypes.js +10 -0
  217. package/es/src/charts/features/attributionFeature.js +6 -11
  218. package/es/src/charts/features/axes.js +9 -7
  219. package/es/src/charts/features/axesFinal.js +26 -4
  220. package/es/src/charts/features/axesMeasure.js +61 -6
  221. package/es/src/charts/features/calloutLayout.js +121 -0
  222. package/es/src/charts/features/calloutScene.js +155 -0
  223. package/es/src/charts/features/chartGeometry.js +1 -1
  224. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  225. package/es/src/charts/features/circleLabels.js +207 -0
  226. package/es/src/charts/features/colorScaleBucket.js +19 -1
  227. package/es/src/charts/features/colorScaleHover.js +70 -0
  228. package/es/src/charts/features/colorScaleValue.js +97 -0
  229. package/es/src/charts/features/curvedArrows.js +158 -0
  230. package/es/src/charts/features/edgeArrows.js +160 -4
  231. package/es/src/charts/features/edgeBundling.js +442 -0
  232. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  233. package/es/src/charts/features/ensureZoomDom.js +32 -8
  234. package/es/src/charts/features/features.js +45 -15
  235. package/es/src/charts/features/featuresColorScale.js +62 -8
  236. package/es/src/charts/features/featuresLegend.js +21 -32
  237. package/es/src/charts/features/legendKeys.js +64 -0
  238. package/es/src/charts/features/lineLabels.js +55 -46
  239. package/es/src/charts/features/linkBundle.js +19 -0
  240. package/es/src/charts/features/linkColor.js +72 -0
  241. package/es/src/charts/features/linkFields.js +86 -0
  242. package/es/src/charts/features/linkFocus.js +118 -0
  243. package/es/src/charts/features/linkInteraction.js +312 -0
  244. package/es/src/charts/features/linkKeys.js +20 -0
  245. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  246. package/es/src/charts/features/linkLabelPath.js +162 -0
  247. package/es/src/charts/features/linkLabels.js +340 -0
  248. package/es/src/charts/features/linkWidths.js +32 -0
  249. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  250. package/es/src/charts/features/pathLabels.js +50 -0
  251. package/es/src/charts/features/plotAnnotations.js +68 -17
  252. package/es/src/charts/features/plotPaint.js +42 -15
  253. package/es/src/charts/features/polyline.js +129 -0
  254. package/es/src/charts/features/referenceAnnotations.js +403 -0
  255. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  256. package/es/src/charts/features/ringLabelNodes.js +93 -0
  257. package/es/src/charts/features/ringLabels.js +222 -0
  258. package/es/src/charts/features/sceneBounds.js +26 -6
  259. package/es/src/charts/features/selfLoops.js +306 -0
  260. package/es/src/charts/features/shapeEmit.js +67 -30
  261. package/es/src/charts/features/shareKey.js +15 -0
  262. package/es/src/charts/features/sharedFields.js +15 -2
  263. package/es/src/charts/features/textHalo.js +29 -0
  264. package/es/src/charts/features/thresholdMembers.js +71 -0
  265. package/es/src/charts/helpers/densityChart.js +3 -1
  266. package/es/src/charts/helpers/valueTitle.js +6 -3
  267. package/es/src/charts/index.js +8 -0
  268. package/es/src/charts/partition/chartFields.js +6 -5
  269. package/es/src/charts/partition/hierarchy.js +2 -0
  270. package/es/src/charts/partition/interaction.js +9 -5
  271. package/es/src/charts/partition/zoom.js +7 -6
  272. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  273. package/es/src/charts/pipeline/preDrawData.js +77 -13
  274. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  275. package/es/src/charts/pipeline/vizDraw.js +40 -29
  276. package/es/src/charts/pipeline/vizPreDraw.js +29 -18
  277. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  278. package/es/src/charts/polar/config.js +2 -3
  279. package/es/src/charts/viz/Viz.js +82 -44
  280. package/es/src/charts/viz/VizBase.js +47 -19
  281. package/es/src/charts/viz/backgroundInk.js +13 -7
  282. package/es/src/charts/viz/dataPoller.js +52 -0
  283. package/es/src/charts/viz/focusRing.js +104 -0
  284. package/es/src/charts/viz/focusTargets.js +208 -0
  285. package/es/src/charts/viz/groupRow.js +35 -0
  286. package/es/src/charts/viz/history.js +74 -0
  287. package/es/src/charts/viz/interactionOpacity.js +19 -5
  288. package/es/src/charts/viz/keyboardNav.js +297 -0
  289. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  290. package/es/src/charts/viz/loaderFormat.js +114 -0
  291. package/es/src/charts/viz/missingFields.js +123 -0
  292. package/es/src/charts/viz/mountTarget.js +9 -0
  293. package/es/src/charts/viz/nearestHover.js +183 -0
  294. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  295. package/es/src/charts/viz/ordinalColor.js +14 -12
  296. package/es/src/charts/viz/pageTheme.js +83 -0
  297. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  298. package/es/src/charts/viz/pointVoronoi.js +124 -0
  299. package/es/src/charts/viz/reducedMotion.js +27 -0
  300. package/es/src/charts/viz/reportHandlerError.js +10 -0
  301. package/es/src/charts/viz/shapeClassTargets.js +18 -2
  302. package/es/src/charts/viz/simpleHover.js +2 -0
  303. package/es/src/charts/viz/vizClassName.js +31 -0
  304. package/es/src/charts/viz/vizDataPolling.js +172 -0
  305. package/es/src/charts/viz/vizDefaults.js +81 -23
  306. package/es/src/charts/viz/vizFields.js +53 -2
  307. package/es/src/charts/viz/vizRender.js +49 -28
  308. package/es/src/charts/viz/vizTheme.js +96 -0
  309. package/es/src/charts/viz/vizVisibility.js +14 -0
  310. package/es/src/components/Axis/Axis.js +34 -0
  311. package/es/src/components/Axis/AxisBottom.js +1 -0
  312. package/es/src/components/Axis/AxisLeft.js +1 -0
  313. package/es/src/components/Axis/AxisRight.js +1 -0
  314. package/es/src/components/Axis/AxisTop.js +1 -0
  315. package/es/src/components/Axis/axisBreak.js +4 -1
  316. package/es/src/components/Axis/axisDefaults.js +8 -10
  317. package/es/src/components/Axis/axisLabelAngle.js +175 -0
  318. package/es/src/components/Axis/axisLabelThinning.js +13 -4
  319. package/es/src/components/Axis/axisLayout.js +86 -19
  320. package/es/src/components/Axis/axisLayoutLabels.js +66 -13
  321. package/es/src/components/Axis/axisLayoutScale.js +10 -1
  322. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  323. package/es/src/components/Axis/axisRender.js +38 -9
  324. package/es/src/components/Axis/axisRounding.js +15 -4
  325. package/es/src/components/Axis/axisSlantWrap.js +39 -0
  326. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  327. package/es/src/components/Axis/powTicks.js +73 -0
  328. package/es/src/components/Axis/rangeBreaks.js +201 -0
  329. package/es/src/components/Axis/timeValues.js +19 -4
  330. package/es/src/components/ColorScale/ColorScale.js +42 -36
  331. package/es/src/components/ColorScale/bucketBounds.js +64 -0
  332. package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
  333. package/es/src/components/ColorScale/colorScaleRender.js +25 -1
  334. package/es/src/components/ColorScale/colorScaleScale.js +43 -24
  335. package/es/src/components/ColorScale/colorScaleType.js +26 -0
  336. package/es/src/components/Legend/Legend.js +3 -0
  337. package/es/src/components/Legend/legendConfig.js +2 -6
  338. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  339. package/es/src/components/TextBox.js +31 -65
  340. package/es/src/components/Timeline/Timeline.js +54 -54
  341. package/es/src/components/Timeline/brushSpan.js +78 -0
  342. package/es/src/components/Timeline/timelineConfig.js +27 -10
  343. package/es/src/components/Timeline/timelineMode.js +26 -0
  344. package/es/src/components/Timeline/timelineRender.js +51 -9
  345. package/es/src/components/Tooltip.js +28 -13
  346. package/es/src/components/fontStack.js +20 -0
  347. package/es/src/components/textBoxLayout.js +58 -21
  348. package/es/src/components/textBoxPath.js +73 -0
  349. package/es/src/components/textBoxScene.js +223 -0
  350. package/es/src/components/textBoxWords.js +70 -0
  351. package/es/src/shapes/Area.js +1 -0
  352. package/es/src/shapes/Bar.js +1 -0
  353. package/es/src/shapes/Box.js +67 -79
  354. package/es/src/shapes/Circle.js +1 -0
  355. package/es/src/shapes/Line.js +1 -0
  356. package/es/src/shapes/Path.js +1 -0
  357. package/es/src/shapes/Rect.js +1 -0
  358. package/es/src/shapes/Shape.js +1 -0
  359. package/es/src/shapes/Whisker.js +1 -0
  360. package/es/src/shapes/boxOutlierShape.js +19 -0
  361. package/es/src/shapes/boxStats.js +35 -0
  362. package/es/src/shapes/boxStyle.js +78 -0
  363. package/es/src/shapes/boxSummary.js +174 -0
  364. package/es/src/shapes/shapeStandalone.js +2 -0
  365. package/es/src/utils/BaseClass.js +44 -12
  366. package/es/src/utils/className.js +78 -0
  367. package/es/src/utils/configPrep.js +2 -1
  368. package/es/src/utils/configWarnings.js +25 -0
  369. package/es/src/utils/constant.js +13 -1
  370. package/es/src/utils/displayName.js +12 -0
  371. package/es/src/utils/fieldAccessor.js +31 -0
  372. package/es/src/utils/paintComponentScene.js +2 -0
  373. package/es/src/utils/theme.js +190 -0
  374. package/es/src/utils/themeInk.js +68 -0
  375. package/package.json +14 -10
  376. package/types/index.d.ts +8 -2
  377. package/types/internal.d.ts +253 -9
  378. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  379. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  380. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  381. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  382. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  383. package/types/src/charts/Alluvial/index.d.ts +27 -0
  384. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  385. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  386. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  387. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  388. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  389. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  390. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  391. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  392. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  393. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  394. package/types/src/charts/BoxWhisker/index.d.ts +3 -1
  395. package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
  396. package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
  397. package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
  398. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  399. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  400. package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
  401. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  402. package/types/src/charts/Chord/labels.d.ts +66 -0
  403. package/types/src/charts/Donut/index.d.ts +2 -1
  404. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  405. package/types/src/charts/Gantt/emit.d.ts +17 -0
  406. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  407. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  408. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  409. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  410. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  411. package/types/src/charts/Gantt/index.d.ts +36 -0
  412. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  413. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  414. package/types/src/charts/Geomap/emit.d.ts +2 -2
  415. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  416. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  417. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  418. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  419. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  420. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  421. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  422. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  423. package/types/src/charts/Geomap/index.d.ts +3 -0
  424. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  425. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  426. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  427. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  428. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  429. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  430. package/types/src/charts/Hexbin/index.d.ts +25 -0
  431. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  432. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  433. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  434. package/types/src/charts/Histogram/binData.d.ts +20 -1
  435. package/types/src/charts/Histogram/index.d.ts +3 -2
  436. package/types/src/charts/Histogram/labels.d.ts +7 -0
  437. package/types/src/charts/Marimekko/index.d.ts +2 -1
  438. package/types/src/charts/Network/bundle.d.ts +67 -0
  439. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  440. package/types/src/charts/Network/clusters.d.ts +115 -0
  441. package/types/src/charts/Network/graph.d.ts +65 -0
  442. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  443. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  444. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  445. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  446. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  447. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  448. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  449. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  450. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  451. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  452. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  453. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  454. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  455. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  456. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  457. package/types/src/charts/Plot/axisHover.d.ts +68 -0
  458. package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
  459. package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
  460. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  461. package/types/src/charts/Plot/barHitArea.d.ts +59 -0
  462. package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
  463. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  464. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  465. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  466. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  467. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  468. package/types/src/charts/Plot/index.d.ts +28 -8
  469. package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
  470. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  471. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  472. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  473. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  474. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  475. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  476. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  477. package/types/src/charts/Plot/plotInit.d.ts +23 -2
  478. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  479. package/types/src/charts/Plot/plotZoom.d.ts +2 -0
  480. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  481. package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
  482. package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
  483. package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
  484. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  485. package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
  486. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  487. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  488. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  489. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  490. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  491. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  492. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  493. package/types/src/charts/Rings/emit.d.ts +50 -0
  494. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  495. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  496. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  497. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  498. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  499. package/types/src/charts/Sankey/emit.d.ts +58 -0
  500. package/types/src/charts/Sankey/labels.d.ts +19 -0
  501. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  502. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  503. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  504. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  505. package/types/src/charts/Scatter/index.d.ts +15 -0
  506. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  507. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  508. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  509. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  510. package/types/src/charts/Treemap/emit.d.ts +2 -1
  511. package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
  512. package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
  513. package/types/src/charts/Treemap/index.d.ts +2 -0
  514. package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
  515. package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
  516. package/types/src/charts/definition/makeChart.d.ts +5 -3
  517. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  518. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  519. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  520. package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
  521. package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
  522. package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
  523. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
  524. package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
  525. package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
  526. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  527. package/types/src/charts/events/click.legend.d.ts +2 -1
  528. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  529. package/types/src/charts/facet/facetData.d.ts +1 -1
  530. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  531. package/types/src/charts/features/annotationText.d.ts +57 -0
  532. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  533. package/types/src/charts/features/axesMeasure.d.ts +13 -1
  534. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  535. package/types/src/charts/features/calloutScene.d.ts +40 -0
  536. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  537. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  538. package/types/src/charts/features/circleLabels.d.ts +130 -0
  539. package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
  540. package/types/src/charts/features/colorScaleHover.d.ts +32 -0
  541. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  542. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  543. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  544. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  545. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  546. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  547. package/types/src/charts/features/features.d.ts +8 -0
  548. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  549. package/types/src/charts/features/legendKeys.d.ts +34 -0
  550. package/types/src/charts/features/lineLabels.d.ts +15 -12
  551. package/types/src/charts/features/linkBundle.d.ts +16 -0
  552. package/types/src/charts/features/linkColor.d.ts +48 -0
  553. package/types/src/charts/features/linkFields.d.ts +16 -0
  554. package/types/src/charts/features/linkFocus.d.ts +51 -0
  555. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  556. package/types/src/charts/features/linkKeys.d.ts +11 -0
  557. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  558. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  559. package/types/src/charts/features/linkLabels.d.ts +77 -0
  560. package/types/src/charts/features/linkWidths.d.ts +19 -0
  561. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  562. package/types/src/charts/features/pathLabels.d.ts +41 -0
  563. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  564. package/types/src/charts/features/plotPaint.d.ts +19 -0
  565. package/types/src/charts/features/polyline.d.ts +32 -0
  566. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  567. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  568. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  569. package/types/src/charts/features/ringLabels.d.ts +164 -0
  570. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  571. package/types/src/charts/features/selfLoops.d.ts +165 -0
  572. package/types/src/charts/features/shapeEmit.d.ts +5 -1
  573. package/types/src/charts/features/shareKey.d.ts +9 -0
  574. package/types/src/charts/features/sharedFields.d.ts +11 -2
  575. package/types/src/charts/features/textHalo.d.ts +14 -0
  576. package/types/src/charts/features/thresholdMembers.d.ts +38 -0
  577. package/types/src/charts/helpers/valueTitle.d.ts +4 -2
  578. package/types/src/charts/index.d.ts +8 -0
  579. package/types/src/charts/partition/interaction.d.ts +6 -3
  580. package/types/src/charts/partition/zoom.d.ts +4 -4
  581. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  582. package/types/src/charts/pipeline/stages.d.ts +9 -0
  583. package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
  584. package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
  585. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  586. package/types/src/charts/viz/Viz.d.ts +44 -6
  587. package/types/src/charts/viz/VizBase.d.ts +16 -7
  588. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  589. package/types/src/charts/viz/dataPoller.d.ts +28 -0
  590. package/types/src/charts/viz/focusRing.d.ts +25 -0
  591. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  592. package/types/src/charts/viz/groupRow.d.ts +24 -0
  593. package/types/src/charts/viz/history.d.ts +35 -0
  594. package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
  595. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  596. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  597. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  598. package/types/src/charts/viz/missingFields.d.ts +57 -0
  599. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  600. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  601. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  602. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  603. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  604. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  605. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  606. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  607. package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
  608. package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
  609. package/types/src/charts/viz/simpleHover.d.ts +2 -1
  610. package/types/src/charts/viz/vizClassName.d.ts +23 -0
  611. package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
  612. package/types/src/charts/viz/vizDefaults.d.ts +49 -9
  613. package/types/src/charts/viz/vizFields.d.ts +47 -0
  614. package/types/src/charts/viz/vizRender.d.ts +2 -1
  615. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  616. package/types/src/charts/viz/vizTypes.d.ts +117 -8
  617. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  618. package/types/src/components/Axis/Axis.d.ts +37 -8
  619. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  620. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  621. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  622. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  623. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  624. package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
  625. package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
  626. package/types/src/components/Axis/axisLayout.d.ts +5 -0
  627. package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
  628. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  629. package/types/src/components/Axis/axisRounding.d.ts +6 -3
  630. package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
  631. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  632. package/types/src/components/Axis/powTicks.d.ts +29 -0
  633. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  634. package/types/src/components/Axis/timeValues.d.ts +1 -1
  635. package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
  636. package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
  637. package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
  638. package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
  639. package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
  640. package/types/src/components/Legend/Legend.d.ts +1 -0
  641. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  642. package/types/src/components/TextBox.d.ts +1 -0
  643. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  644. package/types/src/components/Timeline/brushSpan.d.ts +41 -0
  645. package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
  646. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  647. package/types/src/components/Timeline/timelineRender.d.ts +8 -0
  648. package/types/src/components/Tooltip.d.ts +12 -3
  649. package/types/src/components/fontStack.d.ts +10 -0
  650. package/types/src/components/textBoxLayout.d.ts +18 -9
  651. package/types/src/components/textBoxPath.d.ts +59 -0
  652. package/types/src/components/textBoxScene.d.ts +51 -0
  653. package/types/src/components/textBoxWords.d.ts +33 -0
  654. package/types/src/shapes/Area.d.ts +1 -0
  655. package/types/src/shapes/Bar.d.ts +1 -0
  656. package/types/src/shapes/Box.d.ts +2 -8
  657. package/types/src/shapes/Circle.d.ts +1 -0
  658. package/types/src/shapes/Line.d.ts +1 -0
  659. package/types/src/shapes/Path.d.ts +1 -0
  660. package/types/src/shapes/Rect.d.ts +1 -0
  661. package/types/src/shapes/Shape.d.ts +1 -0
  662. package/types/src/shapes/Whisker.d.ts +1 -0
  663. package/types/src/shapes/boxOutlierShape.d.ts +9 -0
  664. package/types/src/shapes/boxStats.d.ts +19 -0
  665. package/types/src/shapes/boxStyle.d.ts +25 -0
  666. package/types/src/shapes/boxSummary.d.ts +66 -0
  667. package/types/src/shapes/emitLabels.d.ts +1 -1
  668. package/types/src/shapes/shapeConfig.d.ts +42 -4
  669. package/types/src/utils/BaseClass.d.ts +32 -0
  670. package/types/src/utils/D3Scale.d.ts +3 -0
  671. package/types/src/utils/D3plusConfig.d.ts +1240 -33
  672. package/types/src/utils/className.d.ts +64 -0
  673. package/types/src/utils/configPrep.d.ts +2 -0
  674. package/types/src/utils/configWarnings.d.ts +21 -2
  675. package/types/src/utils/constant.d.ts +8 -0
  676. package/types/src/utils/displayName.d.ts +10 -0
  677. package/types/src/utils/fieldAccessor.d.ts +24 -0
  678. package/types/src/utils/index.d.ts +1 -1
  679. package/types/src/utils/paintComponentScene.d.ts +3 -1
  680. package/types/src/utils/theme.d.ts +170 -0
  681. package/types/src/utils/themeInk.d.ts +56 -0
  682. package/umd/d3plus-core.full.js +87388 -56271
  683. package/umd/d3plus-core.full.min.js +2 -2
  684. package/umd/d3plus-core.js +37988 -11768
  685. package/umd/d3plus-core.min.js +2 -2
  686. package/es/src/components/Axis/gridStroke.js +0 -10
  687. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -6,11 +6,15 @@
6
6
  */ import { extent, groups, max, min } from "d3-array";
7
7
  import * as scales from "d3-scale";
8
8
  import { colorContrast } from "@d3plus/color";
9
- import { backgroundColor } from "@d3plus/dom";
10
9
  import { chartBounds } from "../features/chartGeometry.js";
11
10
  import { resolveAccessor, shapeConfigFor } from "../features/emitHelpers.js";
12
11
  import { ringsCenterLabel, ringsGeometry, sizeRingsNodes } from "./ringsSizing.js";
13
- import { buildRingsGraph } from "./ringsGraph.js";
12
+ import { publishLinkGraph } from "../features/linkInteraction.js";
13
+ import { linkWidthRange } from "../features/linkWidths.js";
14
+ import { buildRingsGraph, ringsLinkEnd } from "./ringsGraph.js";
15
+ import { ringsLoops } from "./ringsLoops.js";
16
+ import { edgesBetween, fanParallelEdges, firstPerNeighbor } from "./ringsParallel.js";
17
+ import { backgroundInk } from "../viz/backgroundInk.js";
14
18
  /** Shared empty `ringsCtx` value for the early-return branches. */ const emptyRingsCtx = ()=>({
15
19
  edges: [],
16
20
  nodeGroups: [],
@@ -40,8 +44,9 @@ import { buildRingsGraph } from "./ringsGraph.js";
40
44
  const centerLinks = linkMap[v.schema.center] || [];
41
45
  centerLinks.forEach((edge)=>{
42
46
  const node = edge.source.id === v.schema.center ? edge.target : edge.source;
47
+ // A node takes one place however many center links reach it.
48
+ if (primaries.includes(node)) return;
43
49
  node.edges = linkMap[node.id].filter((link)=>link.source.id !== v.schema.center || link.target.id !== v.schema.center);
44
- node.edge = edge;
45
50
  claimed.push(node);
46
51
  primaries.push(node);
47
52
  });
@@ -50,7 +55,7 @@ import { buildRingsGraph } from "./ringsGraph.js";
50
55
  let totalEndNodes = 0;
51
56
  primaries.forEach((p)=>{
52
57
  const primaryId = p.id;
53
- p.edges = p.edges.filter((edge)=>!claimed.includes(edge.source) && edge.target.id === primaryId || !claimed.includes(edge.target) && edge.source.id === primaryId);
58
+ p.edges = firstPerNeighbor(p.edges.filter((edge)=>!claimed.includes(edge.source) && edge.target.id === primaryId || !claimed.includes(edge.target) && edge.source.id === primaryId), primaryId);
54
59
  totalEndNodes += p.edges.length || 1;
55
60
  p.edges.forEach((edge)=>{
56
61
  const { source, target } = edge;
@@ -93,7 +98,8 @@ import { buildRingsGraph } from "./ringsGraph.js";
93
98
  }
94
99
  /**
95
100
  Resolve link endpoints to placed nodes, compute bezier control points for
96
- spline edges, and push every edge onto `edges` (mutated in place).
101
+ spline edges, and push every edge onto `edges` once (mutated in place):
102
+ an edge between two primaries is reached from both.
97
103
  */ function buildRingsEdges(v, nodes, primaries, secondaries, linkMap, center, geom, edges) {
98
104
  const { width, height, ringWidth, primaryRing, secondaryRing } = geom;
99
105
  primaries.forEach((p)=>{
@@ -101,11 +107,12 @@ import { buildRingsGraph } from "./ringsGraph.js";
101
107
  "source",
102
108
  "target"
103
109
  ];
104
- const pEdge = p.edge;
105
- checks.forEach((node)=>{
106
- pEdge[node] = nodes.find((n)=>n.id === pEdge[node].id);
110
+ edgesBetween(linkMap[p.id], p.id, center.id).forEach((pEdge)=>{
111
+ checks.forEach((node)=>{
112
+ pEdge[node] = nodes.find((n)=>n.id === pEdge[node].id);
113
+ });
114
+ if (!edges.includes(pEdge)) edges.push(pEdge);
107
115
  });
108
- edges.push(pEdge);
109
116
  linkMap[p.id].forEach((edge)=>{
110
117
  const otherNode = edge.source.id === p.id ? edge.target : edge.source;
111
118
  if (otherNode.id === center.id) return;
@@ -151,7 +158,7 @@ import { buildRingsGraph } from "./ringsGraph.js";
151
158
  };
152
159
  }
153
160
  });
154
- edges.push(edge);
161
+ if (!edges.includes(edge)) edges.push(edge);
155
162
  });
156
163
  });
157
164
  }
@@ -188,31 +195,36 @@ import { buildRingsGraph } from "./ringsGraph.js";
188
195
  node.textAnchor = textAnchor;
189
196
  });
190
197
  }
198
+ /**
199
+ Scales link stroke sizes onto the linkSizeScale between the widths
200
+ `linkWidthRange` gives for the smallest node, when they differ, mutating
201
+ each link's size.
202
+ */ function scaleRingsStrokes(v, nodes, links) {
203
+ const strokeExtent = extent(links, (d)=>d.size);
204
+ if (strokeExtent[0] !== strokeExtent[1]) {
205
+ const rNodeMin = min(nodes, (d)=>d.r);
206
+ const strokeScale = scales[`scale${v.schema.linkSizeScale.charAt(0).toUpperCase()}${v.schema.linkSizeScale.slice(1)}`]().domain(strokeExtent).range(linkWidthRange(v.schema.linkSizeMin, v.schema.linkSizeMax, rNodeMin));
207
+ links.forEach((link)=>{
208
+ link.size = strokeScale(link.size);
209
+ });
210
+ }
211
+ }
191
212
  /**
192
213
  Build the link/node shape config + `linkD` accessor, scale link strokes, and
193
214
  stash `linkLookup` + `ringsCtx` on `viz.ctx`.
194
215
  */ function publishRingsCtx(v, nodes, nodeLookup, links, edges) {
195
216
  v.ctx.linkLookup = links.reduce((obj, d)=>{
217
+ if (d.source === d.target) return obj;
196
218
  if (!obj[d.source.id]) obj[d.source.id] = [];
197
219
  obj[d.source.id].push(d.target);
198
220
  if (!obj[d.target.id]) obj[d.target.id] = [];
199
221
  obj[d.target.id].push(d.source);
200
222
  return obj;
201
223
  }, {});
202
- const strokeExtent = extent(links, (d)=>d.size);
203
- if (strokeExtent[0] !== strokeExtent[1]) {
204
- const rNodeMin = min(nodes, (d)=>d.r);
205
- const strokeScale = scales[`scale${v.schema.linkSizeScale.charAt(0).toUpperCase()}${v.schema.linkSizeScale.slice(1)}`]().domain(strokeExtent).range([
206
- v.schema.linkSizeMin,
207
- rNodeMin
208
- ]);
209
- links.forEach((link)=>{
210
- link.size = strokeScale(link.size);
211
- });
212
- }
224
+ scaleRingsStrokes(v, nodes, links);
213
225
  const linkConfig = shapeConfigFor(v, "Path", v.schema.shapeConfig, "edge");
214
226
  delete linkConfig.on;
215
- const linkD = (d)=>d.spline ? `M${d.sourceX},${d.sourceY}C${d.sourceBisectX},${d.sourceBisectY} ${d.targetBisectX},${d.targetBisectY} ${d.targetX},${d.targetY}` : `M${d.source.x},${d.source.y} ${d.target.x},${d.target.y}`;
227
+ const linkD = (d)=>d.loop ? d.loop.d : d.spline ? `M${d.sourceX},${d.sourceY}C${d.sourceBisectX},${d.sourceBisectY} ${d.targetBisectX},${d.targetBisectY} ${d.targetX},${d.targetY}` : `M${d.source.x},${d.source.y} ${d.target.x},${d.target.y}`;
216
228
  // The center's label sits inside its circle unless the circle is too small
217
229
  // (see `ringsCenterLabel`), in which case it sits below like any other.
218
230
  const centerInside = (node)=>node.id === v.schema.center && nodeLookup[node.id]?.labelInside !== false;
@@ -226,7 +238,7 @@ import { buildRingsGraph } from "./ringsGraph.js";
226
238
  const fill = resolveAccessor(shapeConfigFor(v, node.key ?? node.shape).fill, node.data ?? node, node.i);
227
239
  return colorContrast(typeof fill === "string" ? fill : "rgb(255, 255, 255)", v.schema.colorDefaults);
228
240
  }
229
- return colorContrast(v._select ? backgroundColor(v._select.node()) : "rgb(255, 255, 255)", v.schema.colorDefaults);
241
+ return backgroundInk(v);
230
242
  },
231
243
  fontResize: (d)=>centerInside(d.data ?? d),
232
244
  padding: 0,
@@ -301,7 +313,8 @@ export const applyRingsLayout = ({ viz })=>{
301
313
  viz
302
314
  };
303
315
  }
304
- const { graph: { nodeLookup, links, linkMap }, center } = prepared;
316
+ const { graph: { nodes: graphNodes, nodeLookup, links, linkMap }, center } = prepared;
317
+ publishLinkGraph(v, links.map((l)=>l.datum), graphNodes.map(ringsLinkEnd));
305
318
  if (!center) {
306
319
  v.ctx.ringsCtx = emptyRingsCtx();
307
320
  return {
@@ -316,6 +329,10 @@ export const applyRingsLayout = ({ viz })=>{
316
329
  buildRingsEdges(v, nodes, primaries, secondaries, linkMap, center, geom, edges);
317
330
  applyRingsLabelBounds(v, nodes, geom);
318
331
  publishRingsCtx(v, nodes, nodeLookup, links, edges);
332
+ // Parallel links fan apart by their scaled sizes.
333
+ fanParallelEdges(edges);
334
+ // Loops take their stroke from the scaled link sizes.
335
+ edges.push(...ringsLoops(links, nodes, edges, center, geom));
319
336
  return {
320
337
  shapeData: nodes
321
338
  };
@@ -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 accessor from "../../utils/accessor.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;
@@ -70,7 +78,7 @@ import { simpleHover } from "../viz/simpleHover.js";
70
78
  const vv = Array.from(new Set(a.map(c)));
71
79
  return vv.length === 1 ? vv[0] : vv;
72
80
  };
73
- return accessor(k);
81
+ return fieldAccessor(k);
74
82
  });
75
83
  return this;
76
84
  };
@@ -81,7 +89,7 @@ import { simpleHover } from "../viz/simpleHover.js";
81
89
  @type {string | function}
82
90
  */ v.size = function(_) {
83
91
  if (!arguments.length) return this._size;
84
- this._size = typeof _ === "function" || !_ ? _ : accessor(_);
92
+ this._size = typeof _ === "function" || !_ ? _ : fieldAccessor(_);
85
93
  this._sizeKey = typeof _ === "string" ? _ : undefined;
86
94
  return this;
87
95
  };
@@ -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);
@@ -112,6 +125,8 @@ export const ringsDef = {
112
125
  const id = viz.schema.nodeGroupBy && viz.schema.nodeGroupBy[viz._drawDepth](d, i) ? viz.schema.nodeGroupBy[viz._drawDepth](d, i) : viz._id(d, i);
113
126
  const links = viz.ctx.linkLookup[id] ?? [];
114
127
  const node = viz.ctx.nodeLookup[id];
128
+ // An edge has no node to focus.
129
+ if (!node) return;
115
130
  const filterIds = [
116
131
  node.id
117
132
  ];
@@ -131,12 +146,21 @@ export const ringsDef = {
131
146
  if (l.y + l.r > yDomain[1]) yDomain[1] = l.y + l.r;
132
147
  });
133
148
  v.hover((h, x)=>{
134
- const edge = h;
135
- if (edge.source && edge.target) return edge.source.id === node.id || edge.target.id === node.id;
136
- 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));
137
152
  });
138
153
  };
154
+ installFocusBackgroundClick(viz);
139
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);
140
164
  // Clear the hover/tooltip before re-centering: the clicked node's shapes
141
165
  // move out from under the pointer, so a lingering tooltip would hang over
142
166
  // unrelated content (the shared click.shape drill handler does the same).
@@ -162,7 +186,7 @@ export const ringsDef = {
162
186
  // _draw() only recomputes layout/scene; paint it with the chart duration
163
187
  // so the re-centering animates (a bare _draw leaves the only repaint to
164
188
  // the coalesced duration-0 one, which snaps).
165
- if (viz._sceneRenderer) viz._drawSceneToTarget(viz.schema.duration);
189
+ if (viz._sceneRenderer) viz._drawSceneToTarget(effectiveDuration(viz));
166
190
  };
167
191
  },
168
192
  // Small-multiple panels as close to square as the grid allows.
@@ -183,7 +207,9 @@ export const ringsDef = {
183
207
  },
184
208
  /**
185
209
  The arrowhead size in pixels, or an accessor function returning one
186
- 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.
187
213
  @type {number | function}
188
214
  */ {
189
215
  key: "arrowSize"
@@ -199,13 +225,10 @@ export const ringsDef = {
199
225
  {
200
226
  key: "tooltipConfig",
201
227
  merge: true,
202
- factory: (viz)=>({
203
- title: (d)=>{
204
- const edge = d;
205
- return d && edge.source && edge.target ? `${edge.source.id} → ${edge.target.id}` : viz._drawLabel(d, typeof d.i === "number" ? d.i : 0);
206
- }
207
- })
228
+ factory: (viz)=>linkTooltipConfig(viz)
208
229
  },
230
+ ...linkStyleFields(),
231
+ ...loaderFormatFields("links", "nodes"),
209
232
  {
210
233
  key: "links",
211
234
  default: []
@@ -214,7 +237,11 @@ export const ringsDef = {
214
237
  key: "linkSize",
215
238
  default: constant(1)
216
239
  },
217
- /** 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. */ {
218
245
  key: "linkSizeMin",
219
246
  default: 1
220
247
  },
@@ -234,6 +261,14 @@ export const ringsDef = {
234
261
  default: []
235
262
  },
236
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
+ /**
237
272
  The maximum pixel radius of a node. Defaults to the largest radius
238
273
  that keeps neighboring nodes from overlapping.
239
274
  @type {number}
@@ -277,7 +312,7 @@ export const ringsDef = {
277
312
  Path: {
278
313
  fill: "none",
279
314
  label: false,
280
- stroke: "#adb5bd",
315
+ stroke: ()=>themed(viz._theme, (t)=>t.link, "#adb5bd"),
281
316
  strokeWidth: 1
282
317
  }
283
318
  })