@d3plus/core 4.10.0 → 4.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (548) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +167 -8
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +170 -0
  9. package/es/src/charts/Alluvial/layout.js +137 -0
  10. package/es/src/charts/Alluvial/meta.js +57 -0
  11. package/es/src/charts/Alluvial/titles.js +81 -0
  12. package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
  13. package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
  14. package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
  15. package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
  16. package/es/src/charts/ArcDiagram/emit.js +178 -0
  17. package/es/src/charts/ArcDiagram/events.js +144 -0
  18. package/es/src/charts/ArcDiagram/index.js +215 -0
  19. package/es/src/charts/BarChart/index.js +14 -2
  20. package/es/src/charts/BoxWhisker/index.js +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +3 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +2 -1
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +162 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +132 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +204 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +3 -3
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Network/applyLayout.js +138 -94
  70. package/es/src/charts/Network/bundle.js +81 -0
  71. package/es/src/charts/Network/clusterLabels.js +423 -0
  72. package/es/src/charts/Network/clusters.js +290 -0
  73. package/es/src/charts/Network/emit.js +253 -70
  74. package/es/src/charts/Network/graph.js +117 -0
  75. package/es/src/charts/Network/graphFluent.js +79 -0
  76. package/es/src/charts/Network/index.js +86 -106
  77. package/es/src/charts/Network/minNodeDistance.js +64 -0
  78. package/es/src/charts/Network/polygonRows.js +44 -0
  79. package/es/src/charts/Pack/index.js +5 -1
  80. package/es/src/charts/Pie/applyLayout.js +86 -27
  81. package/es/src/charts/Pie/arcFit.js +152 -0
  82. package/es/src/charts/Pie/curvedLabels.js +134 -0
  83. package/es/src/charts/Pie/emit.js +43 -96
  84. package/es/src/charts/Pie/index.js +64 -31
  85. package/es/src/charts/Pie/labelRoom.js +154 -0
  86. package/es/src/charts/Pie/outsideLabels.js +224 -0
  87. package/es/src/charts/Pie/outsideNodes.js +267 -0
  88. package/es/src/charts/Pie/pieLabels.js +137 -0
  89. package/es/src/charts/Pie/sectorBox.js +223 -0
  90. package/es/src/charts/Pie/straightLabels.js +96 -0
  91. package/es/src/charts/Pie/straightLayout.js +215 -0
  92. package/es/src/charts/Plot/alongLegend.js +76 -0
  93. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  94. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  95. package/es/src/charts/Plot/axisValues.js +43 -0
  96. package/es/src/charts/Plot/barWidth.js +59 -11
  97. package/es/src/charts/Plot/circleLabels.js +98 -0
  98. package/es/src/charts/Plot/connectGaps.js +237 -0
  99. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  100. package/es/src/charts/Plot/draw.js +8 -2
  101. package/es/src/charts/Plot/fillBetween.js +2 -1
  102. package/es/src/charts/Plot/forecastScene.js +3 -4
  103. package/es/src/charts/Plot/index.js +18 -10
  104. package/es/src/charts/Plot/labelPlacement.js +1 -1
  105. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  106. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  107. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  108. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  109. package/es/src/charts/Plot/pipeline.js +66 -19
  110. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  111. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  112. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  113. package/es/src/charts/Plot/pipelineScales.js +40 -8
  114. package/es/src/charts/Plot/plotFacet.js +12 -1
  115. package/es/src/charts/Plot/plotInit.js +34 -5
  116. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  117. package/es/src/charts/Plot/referenceDomains.js +133 -0
  118. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  119. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  120. package/es/src/charts/Plot/trendLabels.js +183 -0
  121. package/es/src/charts/Plot/trendLines.js +1 -0
  122. package/es/src/charts/Plot/trendScene.js +6 -3
  123. package/es/src/charts/Plot/trendTooltip.js +5 -1
  124. package/es/src/charts/PolarArea/index.js +2 -2
  125. package/es/src/charts/Priestley/applyLayout.js +14 -20
  126. package/es/src/charts/Priestley/index.js +4 -35
  127. package/es/src/charts/Priestley/timeAxis.js +100 -0
  128. package/es/src/charts/Radar/axisDecorations.js +49 -12
  129. package/es/src/charts/Radar/curvedLabels.js +187 -0
  130. package/es/src/charts/Radar/index.js +2 -3
  131. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  132. package/es/src/charts/RadialBar/emit.js +4 -1
  133. package/es/src/charts/RadialBar/index.js +16 -9
  134. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  135. package/es/src/charts/RadialMatrix/index.js +3 -7
  136. package/es/src/charts/Rings/applyLayout.js +41 -24
  137. package/es/src/charts/Rings/emit.js +174 -58
  138. package/es/src/charts/Rings/index.js +61 -28
  139. package/es/src/charts/Rings/ringsGraph.js +28 -9
  140. package/es/src/charts/Rings/ringsLoops.js +73 -0
  141. package/es/src/charts/Rings/ringsParallel.js +166 -0
  142. package/es/src/charts/Sankey/applyLayout.js +116 -39
  143. package/es/src/charts/Sankey/circularLayout.js +208 -0
  144. package/es/src/charts/Sankey/circularLinks.js +301 -0
  145. package/es/src/charts/Sankey/emit.js +164 -94
  146. package/es/src/charts/Sankey/index.js +72 -75
  147. package/es/src/charts/Sankey/labels.js +80 -0
  148. package/es/src/charts/Sankey/ribbons.js +88 -0
  149. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  150. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  151. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  152. package/es/src/charts/Scatter/index.js +25 -0
  153. package/es/src/charts/SlopeChart/index.js +116 -0
  154. package/es/src/charts/SlopeChart/slope.js +95 -0
  155. package/es/src/charts/Streamgraph/index.js +51 -0
  156. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  157. package/es/src/charts/Sunburst/emit.js +74 -63
  158. package/es/src/charts/Sunburst/index.js +3 -3
  159. package/es/src/charts/Tree/index.js +2 -6
  160. package/es/src/charts/Treemap/index.js +2 -5
  161. package/es/src/charts/Violin/inner.js +3 -5
  162. package/es/src/charts/definition/makeChart.js +10 -2
  163. package/es/src/charts/drawSteps/backControl.js +17 -5
  164. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  165. package/es/src/charts/drawSteps/minimap.js +6 -5
  166. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  167. package/es/src/charts/drawSteps/searchControls.js +2 -1
  168. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  169. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  170. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  171. package/es/src/charts/events/click.legend.js +7 -2
  172. package/es/src/charts/events/click.shape.js +8 -1
  173. package/es/src/charts/events/mousemove.shape.js +5 -2
  174. package/es/src/charts/facet/drawFacets.js +14 -5
  175. package/es/src/charts/features/annotationFrame.js +179 -0
  176. package/es/src/charts/features/annotationText.js +83 -0
  177. package/es/src/charts/features/annotationTypes.js +10 -0
  178. package/es/src/charts/features/attributionFeature.js +6 -11
  179. package/es/src/charts/features/axes.js +2 -1
  180. package/es/src/charts/features/axesFinal.js +3 -1
  181. package/es/src/charts/features/axesMeasure.js +7 -4
  182. package/es/src/charts/features/calloutLayout.js +121 -0
  183. package/es/src/charts/features/calloutScene.js +155 -0
  184. package/es/src/charts/features/chartGeometry.js +1 -1
  185. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  186. package/es/src/charts/features/circleLabels.js +207 -0
  187. package/es/src/charts/features/colorScaleBucket.js +2 -1
  188. package/es/src/charts/features/colorScaleHover.js +3 -2
  189. package/es/src/charts/features/colorScaleValue.js +97 -0
  190. package/es/src/charts/features/curvedArrows.js +158 -0
  191. package/es/src/charts/features/edgeArrows.js +160 -4
  192. package/es/src/charts/features/edgeBundling.js +442 -0
  193. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  194. package/es/src/charts/features/ensureZoomDom.js +32 -8
  195. package/es/src/charts/features/features.js +32 -14
  196. package/es/src/charts/features/featuresColorScale.js +20 -6
  197. package/es/src/charts/features/featuresLegend.js +15 -24
  198. package/es/src/charts/features/legendKeys.js +64 -0
  199. package/es/src/charts/features/lineLabels.js +55 -46
  200. package/es/src/charts/features/linkBundle.js +19 -0
  201. package/es/src/charts/features/linkColor.js +72 -0
  202. package/es/src/charts/features/linkFields.js +86 -0
  203. package/es/src/charts/features/linkFocus.js +118 -0
  204. package/es/src/charts/features/linkInteraction.js +312 -0
  205. package/es/src/charts/features/linkKeys.js +20 -0
  206. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  207. package/es/src/charts/features/linkLabelPath.js +162 -0
  208. package/es/src/charts/features/linkLabels.js +340 -0
  209. package/es/src/charts/features/linkWidths.js +32 -0
  210. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  211. package/es/src/charts/features/pathLabels.js +50 -0
  212. package/es/src/charts/features/plotAnnotations.js +68 -17
  213. package/es/src/charts/features/plotPaint.js +38 -11
  214. package/es/src/charts/features/polyline.js +129 -0
  215. package/es/src/charts/features/referenceAnnotations.js +403 -0
  216. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  217. package/es/src/charts/features/ringLabelNodes.js +93 -0
  218. package/es/src/charts/features/ringLabels.js +222 -0
  219. package/es/src/charts/features/sceneBounds.js +26 -6
  220. package/es/src/charts/features/selfLoops.js +306 -0
  221. package/es/src/charts/features/shapeEmit.js +47 -31
  222. package/es/src/charts/features/sharedFields.js +15 -2
  223. package/es/src/charts/features/textHalo.js +29 -0
  224. package/es/src/charts/index.js +8 -0
  225. package/es/src/charts/partition/chartFields.js +2 -2
  226. package/es/src/charts/partition/interaction.js +9 -5
  227. package/es/src/charts/partition/zoom.js +7 -6
  228. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  229. package/es/src/charts/pipeline/preDrawData.js +46 -3
  230. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  231. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  232. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  233. package/es/src/charts/polar/config.js +2 -3
  234. package/es/src/charts/viz/Viz.js +39 -36
  235. package/es/src/charts/viz/VizBase.js +18 -10
  236. package/es/src/charts/viz/backgroundInk.js +13 -7
  237. package/es/src/charts/viz/focusRing.js +104 -0
  238. package/es/src/charts/viz/focusTargets.js +208 -0
  239. package/es/src/charts/viz/history.js +74 -0
  240. package/es/src/charts/viz/keyboardNav.js +297 -0
  241. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  242. package/es/src/charts/viz/loaderFormat.js +114 -0
  243. package/es/src/charts/viz/missingFields.js +2 -1
  244. package/es/src/charts/viz/mountTarget.js +9 -0
  245. package/es/src/charts/viz/nearestHover.js +183 -0
  246. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  247. package/es/src/charts/viz/ordinalColor.js +14 -12
  248. package/es/src/charts/viz/pageTheme.js +83 -0
  249. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  250. package/es/src/charts/viz/pointVoronoi.js +124 -0
  251. package/es/src/charts/viz/reducedMotion.js +27 -0
  252. package/es/src/charts/viz/vizDataPolling.js +8 -3
  253. package/es/src/charts/viz/vizDefaults.js +15 -23
  254. package/es/src/charts/viz/vizFields.js +35 -0
  255. package/es/src/charts/viz/vizRender.js +43 -28
  256. package/es/src/charts/viz/vizTheme.js +96 -0
  257. package/es/src/charts/viz/vizVisibility.js +14 -0
  258. package/es/src/components/Axis/Axis.js +6 -0
  259. package/es/src/components/Axis/AxisBottom.js +1 -0
  260. package/es/src/components/Axis/AxisLeft.js +1 -0
  261. package/es/src/components/Axis/AxisRight.js +1 -0
  262. package/es/src/components/Axis/AxisTop.js +1 -0
  263. package/es/src/components/Axis/axisBreak.js +4 -1
  264. package/es/src/components/Axis/axisDefaults.js +5 -9
  265. package/es/src/components/Axis/axisLayoutScale.js +7 -1
  266. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  267. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  268. package/es/src/components/Axis/rangeBreaks.js +201 -0
  269. package/es/src/components/Axis/timeValues.js +19 -4
  270. package/es/src/components/ColorScale/ColorScale.js +15 -9
  271. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  272. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  273. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  274. package/es/src/components/Legend/Legend.js +3 -0
  275. package/es/src/components/Legend/legendConfig.js +2 -6
  276. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  277. package/es/src/components/TextBox.js +29 -65
  278. package/es/src/components/Timeline/Timeline.js +12 -3
  279. package/es/src/components/Timeline/timelineConfig.js +20 -10
  280. package/es/src/components/Timeline/timelineMode.js +26 -0
  281. package/es/src/components/Timeline/timelineRender.js +7 -3
  282. package/es/src/components/Tooltip.js +15 -5
  283. package/es/src/components/fontStack.js +20 -0
  284. package/es/src/components/textBoxLayout.js +58 -21
  285. package/es/src/components/textBoxPath.js +73 -0
  286. package/es/src/components/textBoxScene.js +223 -0
  287. package/es/src/components/textBoxWords.js +70 -0
  288. package/es/src/shapes/Area.js +1 -0
  289. package/es/src/shapes/Bar.js +1 -0
  290. package/es/src/shapes/Box.js +1 -0
  291. package/es/src/shapes/Circle.js +1 -0
  292. package/es/src/shapes/Line.js +1 -0
  293. package/es/src/shapes/Path.js +1 -0
  294. package/es/src/shapes/Rect.js +1 -0
  295. package/es/src/shapes/Shape.js +1 -0
  296. package/es/src/shapes/Whisker.js +1 -0
  297. package/es/src/utils/BaseClass.js +25 -12
  298. package/es/src/utils/configPrep.js +2 -1
  299. package/es/src/utils/constant.js +13 -1
  300. package/es/src/utils/displayName.js +12 -0
  301. package/es/src/utils/theme.js +190 -0
  302. package/es/src/utils/themeInk.js +68 -0
  303. package/package.json +14 -11
  304. package/types/index.d.ts +6 -2
  305. package/types/internal.d.ts +250 -8
  306. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  307. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  308. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  309. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  310. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  311. package/types/src/charts/Alluvial/index.d.ts +27 -0
  312. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  313. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  314. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  315. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  316. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  317. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  318. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  319. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  320. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  321. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  322. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  323. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  324. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  325. package/types/src/charts/Chord/labels.d.ts +66 -0
  326. package/types/src/charts/Donut/index.d.ts +2 -1
  327. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  328. package/types/src/charts/Gantt/emit.d.ts +17 -0
  329. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  330. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  331. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  332. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  333. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  334. package/types/src/charts/Gantt/index.d.ts +36 -0
  335. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  336. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  337. package/types/src/charts/Geomap/emit.d.ts +2 -2
  338. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  339. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  340. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  341. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  342. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  343. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  344. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  345. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  346. package/types/src/charts/Geomap/index.d.ts +3 -0
  347. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  348. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  349. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  350. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  351. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  352. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  353. package/types/src/charts/Hexbin/index.d.ts +25 -0
  354. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  355. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  356. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  357. package/types/src/charts/Histogram/binData.d.ts +20 -1
  358. package/types/src/charts/Histogram/index.d.ts +3 -2
  359. package/types/src/charts/Histogram/labels.d.ts +7 -0
  360. package/types/src/charts/Marimekko/index.d.ts +2 -1
  361. package/types/src/charts/Network/bundle.d.ts +67 -0
  362. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  363. package/types/src/charts/Network/clusters.d.ts +115 -0
  364. package/types/src/charts/Network/graph.d.ts +65 -0
  365. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  366. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  367. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  368. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  369. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  370. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  371. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  372. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  373. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  374. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  375. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  376. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  377. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  378. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  379. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  380. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  381. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  382. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  383. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  384. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  385. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  386. package/types/src/charts/Plot/index.d.ts +15 -8
  387. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  388. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  389. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  390. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  391. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  392. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  393. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  394. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  395. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  396. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  397. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  398. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  399. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  400. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  401. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  402. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  403. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  404. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  405. package/types/src/charts/Rings/emit.d.ts +50 -0
  406. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  407. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  408. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  409. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  410. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  411. package/types/src/charts/Sankey/emit.d.ts +58 -0
  412. package/types/src/charts/Sankey/labels.d.ts +19 -0
  413. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  414. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  415. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  416. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  417. package/types/src/charts/Scatter/index.d.ts +15 -0
  418. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  419. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  420. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  421. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  422. package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
  423. package/types/src/charts/definition/makeChart.d.ts +3 -2
  424. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  425. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  426. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  427. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  428. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  429. package/types/src/charts/events/click.legend.d.ts +2 -1
  430. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  431. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  432. package/types/src/charts/features/annotationText.d.ts +57 -0
  433. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  434. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  435. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  436. package/types/src/charts/features/calloutScene.d.ts +40 -0
  437. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  438. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  439. package/types/src/charts/features/circleLabels.d.ts +130 -0
  440. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  441. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  442. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  443. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  444. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  445. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  446. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  447. package/types/src/charts/features/legendKeys.d.ts +34 -0
  448. package/types/src/charts/features/lineLabels.d.ts +15 -12
  449. package/types/src/charts/features/linkBundle.d.ts +16 -0
  450. package/types/src/charts/features/linkColor.d.ts +48 -0
  451. package/types/src/charts/features/linkFields.d.ts +16 -0
  452. package/types/src/charts/features/linkFocus.d.ts +51 -0
  453. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  454. package/types/src/charts/features/linkKeys.d.ts +11 -0
  455. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  456. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  457. package/types/src/charts/features/linkLabels.d.ts +77 -0
  458. package/types/src/charts/features/linkWidths.d.ts +19 -0
  459. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  460. package/types/src/charts/features/pathLabels.d.ts +41 -0
  461. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  462. package/types/src/charts/features/plotPaint.d.ts +17 -0
  463. package/types/src/charts/features/polyline.d.ts +32 -0
  464. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  465. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  466. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  467. package/types/src/charts/features/ringLabels.d.ts +164 -0
  468. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  469. package/types/src/charts/features/selfLoops.d.ts +165 -0
  470. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  471. package/types/src/charts/features/sharedFields.d.ts +11 -2
  472. package/types/src/charts/features/textHalo.d.ts +14 -0
  473. package/types/src/charts/index.d.ts +8 -0
  474. package/types/src/charts/partition/interaction.d.ts +6 -3
  475. package/types/src/charts/partition/zoom.d.ts +4 -4
  476. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  477. package/types/src/charts/pipeline/stages.d.ts +7 -0
  478. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  479. package/types/src/charts/viz/Viz.d.ts +16 -2
  480. package/types/src/charts/viz/VizBase.d.ts +6 -6
  481. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  482. package/types/src/charts/viz/focusRing.d.ts +25 -0
  483. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  484. package/types/src/charts/viz/history.d.ts +35 -0
  485. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  486. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  487. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  488. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  489. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  490. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  491. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  492. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  493. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  494. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  495. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  496. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  497. package/types/src/charts/viz/vizFields.d.ts +32 -0
  498. package/types/src/charts/viz/vizRender.d.ts +2 -1
  499. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  500. package/types/src/charts/viz/vizTypes.d.ts +84 -7
  501. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  502. package/types/src/components/Axis/Axis.d.ts +1 -0
  503. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  504. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  505. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  506. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  507. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  508. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  509. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  510. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  511. package/types/src/components/Axis/timeValues.d.ts +1 -1
  512. package/types/src/components/ColorScale/ColorScale.d.ts +1 -0
  513. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  514. package/types/src/components/Legend/Legend.d.ts +1 -0
  515. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  516. package/types/src/components/TextBox.d.ts +1 -0
  517. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  518. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  519. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  520. package/types/src/components/Tooltip.d.ts +4 -3
  521. package/types/src/components/fontStack.d.ts +10 -0
  522. package/types/src/components/textBoxLayout.d.ts +18 -9
  523. package/types/src/components/textBoxPath.d.ts +59 -0
  524. package/types/src/components/textBoxScene.d.ts +51 -0
  525. package/types/src/components/textBoxWords.d.ts +33 -0
  526. package/types/src/shapes/Area.d.ts +1 -0
  527. package/types/src/shapes/Bar.d.ts +1 -0
  528. package/types/src/shapes/Box.d.ts +1 -0
  529. package/types/src/shapes/Circle.d.ts +1 -0
  530. package/types/src/shapes/Line.d.ts +1 -0
  531. package/types/src/shapes/Path.d.ts +1 -0
  532. package/types/src/shapes/Rect.d.ts +1 -0
  533. package/types/src/shapes/Shape.d.ts +1 -0
  534. package/types/src/shapes/Whisker.d.ts +1 -0
  535. package/types/src/utils/BaseClass.d.ts +9 -0
  536. package/types/src/utils/D3plusConfig.d.ts +981 -30
  537. package/types/src/utils/configPrep.d.ts +2 -0
  538. package/types/src/utils/constant.d.ts +8 -0
  539. package/types/src/utils/displayName.d.ts +10 -0
  540. package/types/src/utils/index.d.ts +1 -1
  541. package/types/src/utils/theme.d.ts +170 -0
  542. package/types/src/utils/themeInk.d.ts +56 -0
  543. package/umd/d3plus-core.full.js +86811 -61031
  544. package/umd/d3plus-core.full.min.js +2 -2
  545. package/umd/d3plus-core.js +28392 -6498
  546. package/umd/d3plus-core.min.js +2 -2
  547. package/es/src/components/Axis/gridStroke.js +0 -10
  548. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -0,0 +1,118 @@
1
+ /**
2
+ Click focus for links on the node-link charts (Network, Rings, Sankey).
3
+ Clicking a link (or pressing Enter on it) keeps it and its two ends
4
+ bright and dims the rest, and a chart that zooms zooms to fit the two
5
+ ends. Clicking the focused link again, or the chart's background, clears
6
+ the focus.
7
+ */ import { zoomToNodeBounds } from "../Network/graph.js";
8
+ import { surfaceOrigin } from "../viz/pointTooltipAnchor.js";
9
+ import { chartBounds } from "./chartGeometry.js";
10
+ import { linkHighlight, linkMeta } from "./linkInteraction.js";
11
+ /** The id a focused link sets on `viz._focus`. */ export function linkFocusId(d) {
12
+ return `link:${linkMeta(d)?.index}`;
13
+ }
14
+ /**
15
+ The box around a link's two ends, from the chart's laid-out nodes
16
+ (`viz.ctx.nodeLookup` records with `x`, `y`, and `r`), or null when they
17
+ aren't laid out that way.
18
+ */ export function linkEndsBox(viz, d) {
19
+ const meta = linkMeta(d);
20
+ const lookup = viz.ctx.nodeLookup;
21
+ if (!meta || !lookup) return null;
22
+ const ends = [
23
+ meta.source.id,
24
+ meta.target.id
25
+ ].map((id)=>lookup[id]);
26
+ const boxes = [];
27
+ for (const n of ends){
28
+ if (!n || typeof n.x !== "number" || typeof n.y !== "number") return null;
29
+ const r = typeof n.r === "number" ? n.r : 0;
30
+ boxes.push([
31
+ [
32
+ n.x - r,
33
+ n.y - r
34
+ ],
35
+ [
36
+ n.x + r,
37
+ n.y + r
38
+ ]
39
+ ]);
40
+ }
41
+ return [
42
+ [
43
+ Math.min(boxes[0][0][0], boxes[1][0][0]),
44
+ Math.min(boxes[0][0][1], boxes[1][0][1])
45
+ ],
46
+ [
47
+ Math.max(boxes[0][1][0], boxes[1][1][0]),
48
+ Math.max(boxes[0][1][1], boxes[1][1][1])
49
+ ]
50
+ ];
51
+ }
52
+ /**
53
+ Clears a click focus: the active marks, and the zoom where the chart
54
+ zooms. Returns whether there was a focus to clear.
55
+ */ export function clearLinkFocus(viz) {
56
+ if (viz._focus === undefined) return false;
57
+ viz.active?.(false);
58
+ viz._focus = undefined;
59
+ viz._zoomToBounds?.(null);
60
+ return true;
61
+ }
62
+ const boundSurfaces = new WeakSet();
63
+ /**
64
+ Routes clicks on the chart's own outer `<svg>` (the empty space around an
65
+ SVG scene, which only takes the pointer over what it paints) to
66
+ `viz._backgroundClick`. Clicks on marks, on the chart's chrome, or on a
67
+ zoom surface's background land on other elements and are left alone; the
68
+ Canvas renderer reports its empty clicks itself.
69
+ */ export function bindSvgBackgroundClick(viz) {
70
+ const outer = viz._select?.node?.();
71
+ if (!outer || typeof outer.addEventListener !== "function") return;
72
+ if (boundSurfaces.has(outer)) return;
73
+ boundSurfaces.add(outer);
74
+ outer.addEventListener("click", (e)=>{
75
+ if (e.target !== outer) return;
76
+ const origin = surfaceOrigin(viz);
77
+ const { clientX, clientY } = e;
78
+ viz._backgroundClick?.([
79
+ clientX - origin.left,
80
+ clientY - origin.top
81
+ ]);
82
+ });
83
+ }
84
+ /**
85
+ Focuses a clicked link: it and the nodes at its ends stay bright, the
86
+ rest dims, and a chart that zooms zooms to `box`. Clicking the focused
87
+ link again clears the focus. Rows that aren't recorded nodes (legend
88
+ entries) match by `nodeKey`.
89
+ */ export function focusLink(viz, d, { nodeKey, box } = {}) {
90
+ viz._tooltipClass?.data([]).render();
91
+ const id = linkFocusId(d);
92
+ if (viz._focus === id) {
93
+ clearLinkFocus(viz);
94
+ return;
95
+ }
96
+ viz.hover?.(false);
97
+ viz.active?.(linkHighlight(viz, d, nodeKey));
98
+ viz._focus = id;
99
+ bindSvgBackgroundClick(viz);
100
+ if (box && viz._zoomToBounds) zoomToNodeBounds(viz, [
101
+ box[0][0],
102
+ box[1][0]
103
+ ], [
104
+ box[0][1],
105
+ box[1][1]
106
+ ]);
107
+ }
108
+ /**
109
+ Clears the chart's click focus when a click lands on no mark within its
110
+ chart area (`viz._backgroundClick`, given the click's point on the
111
+ chart's surface).
112
+ */ export function installFocusBackgroundClick(viz) {
113
+ viz._backgroundClick = ([x, y])=>{
114
+ const { width, height } = chartBounds(viz);
115
+ const { left, top } = viz._margin;
116
+ if (x >= left && x <= left + width && y >= top && y <= top + height) clearLinkFocus(viz);
117
+ };
118
+ }
@@ -0,0 +1,312 @@
1
+ /**
2
+ Link interaction shared by the node-link charts (Network, Rings, Sankey,
3
+ ArcDiagram): the datum each link is drawn with, its tooltip and spoken
4
+ label, what hovering a link or a node highlights, and the connections a
5
+ node's tooltip lists.
6
+
7
+ A link's datum is its row from `links`, with `source` and `target`
8
+ replaced by the data of the nodes they name. `linkSize`, `value`,
9
+ `shapeConfig` functions, arrow accessors, and the tooltip all receive it,
10
+ so they read node fields directly (`d.source.name`). The chart's
11
+ bookkeeping for each datum (its index in `links`, the ids of its ends, its
12
+ value) is kept beside it in a WeakMap, so the datum holds only the link's
13
+ own fields.
14
+ */ import { rtl } from "@d3plus/dom";
15
+ import { formatAbbreviate } from "@d3plus/format";
16
+ const metas = new WeakMap();
17
+ const nodeEntries = new WeakMap();
18
+ /** What the chart recorded for a link datum, if `d` is one. */ export function linkMeta(d) {
19
+ return d && typeof d === "object" ? metas.get(d) : undefined;
20
+ }
21
+ /** Whether `d` is a link datum. */ export function isLinkDatum(d) {
22
+ return linkMeta(d) !== undefined;
23
+ }
24
+ /**
25
+ The datum a link is drawn with: `raw`'s fields, with `source` and
26
+ `target` set to the data of the nodes at its ends.
27
+ @param raw The link's row in `links`.
28
+ @param source The node at its source end.
29
+ @param target The node at its target end.
30
+ @param index The link's index in `links`.
31
+ @param endKeys The keys of `raw` that name its ends.
32
+ */ export function makeLinkDatum(raw, source, target, index, endKeys = [
33
+ "source",
34
+ "target"
35
+ ]) {
36
+ const datum = {
37
+ ...raw,
38
+ source: source.data,
39
+ target: target.data
40
+ };
41
+ metas.set(datum, {
42
+ index,
43
+ raw,
44
+ source,
45
+ target,
46
+ endKeys
47
+ });
48
+ return datum;
49
+ }
50
+ /**
51
+ Records a link's value (from `linkSize` or `value`) for its tooltip and
52
+ spoken label, and returns it.
53
+ */ export function setLinkValue(d, value) {
54
+ const meta = linkMeta(d);
55
+ const n = typeof value === "number" ? value : Number(value);
56
+ if (meta && value !== null && value !== "" && Number.isFinite(n)) meta.value = n;
57
+ return value;
58
+ }
59
+ /**
60
+ Indexes a chart's links by node and stores the result on `viz.ctx.linkGraph`.
61
+ Each of `nodes` (including any without links) is recognized by its datum
62
+ from then on, so its tooltip can list its connections.
63
+ */ export function publishLinkGraph(viz, links, nodes) {
64
+ const values = new Set(links.map((l)=>linkMeta(l)?.value));
65
+ const byNode = new Map(nodes.map((n)=>[
66
+ n.id,
67
+ []
68
+ ]));
69
+ const graph = {
70
+ links,
71
+ sized: values.size > 1,
72
+ byNode
73
+ };
74
+ for (const link of links){
75
+ const meta = linkMeta(link);
76
+ meta.graph = graph;
77
+ const ids = new Set([
78
+ meta.source.id,
79
+ meta.target.id
80
+ ]);
81
+ for (const id of ids){
82
+ if (!byNode.has(id)) byNode.set(id, []);
83
+ byNode.get(id).push(link);
84
+ }
85
+ }
86
+ let entries = nodeEntries.get(viz);
87
+ if (!entries) nodeEntries.set(viz, entries = new WeakMap());
88
+ for (const n of nodes)if (n.data && typeof n.data === "object") entries.set(n.data, {
89
+ id: n.id,
90
+ graph
91
+ });
92
+ viz.ctx.linkGraph = graph;
93
+ return graph;
94
+ }
95
+ /**
96
+ Forgets every node `publishLinkGraph` recorded for a chart, so rows that
97
+ no longer end a link stop reading as nodes.
98
+ */ export function forgetLinkNodes(viz) {
99
+ nodeEntries.delete(viz);
100
+ }
101
+ /** The node id and graph recorded for a node datum, if `d` is one. */ export function linkNodeOf(viz, d) {
102
+ if (!d || typeof d !== "object") return undefined;
103
+ return nodeEntries.get(viz)?.get(d);
104
+ }
105
+ /** Languages written right to left, by their primary language subtag. */ const RTL_LANGUAGES = new Set([
106
+ "ar",
107
+ "dv",
108
+ "fa",
109
+ "he",
110
+ "ps",
111
+ "ur",
112
+ "yi"
113
+ ]);
114
+ /** Whether a locale code (`"ar-SA"`) names a language written right to left. */ export function rtlLocale(locale) {
115
+ const language = `${locale ?? ""}`.split(/[-_]/)[0].toLowerCase();
116
+ return RTL_LANGUAGES.has(language);
117
+ }
118
+ /**
119
+ The arrows a chart's tooltips point from a link's source to its target
120
+ with: `["→", "←"]`, mirrored to `["←", "→"]` when the chart's locale is
121
+ written right to left or the page's direction is (see `rtl`).
122
+ */ export function linkArrows(viz) {
123
+ const mirrored = rtlLocale(viz.schema.locale) || typeof document !== "undefined" && !!document.body && rtl();
124
+ return mirrored ? [
125
+ "←",
126
+ "→"
127
+ ] : [
128
+ "→",
129
+ "←"
130
+ ];
131
+ }
132
+ /** A link end's label, as its node's tooltip titles it. */ export function linkEndLabel(viz, end) {
133
+ if (end.label !== undefined) return end.label;
134
+ return `${viz._drawLabel(end.data, end.i) ?? end.id}`;
135
+ }
136
+ /** A link's tooltip title: "Source → Target" ("Source ← Target" right to left). */ export function linkTooltipTitle(viz, d) {
137
+ const meta = linkMeta(d);
138
+ if (!meta) return "";
139
+ const [forward] = linkArrows(viz);
140
+ return `${linkEndLabel(viz, meta.source)} ${forward} ${linkEndLabel(viz, meta.target)}`;
141
+ }
142
+ /** A tooltip cell's text for one field value, or null for a value it skips. */ export function linkCellText(viz, v) {
143
+ const locale = viz.schema.locale;
144
+ if (typeof v === "number") return Number.isFinite(v) ? formatAbbreviate(v, locale) : null;
145
+ if (typeof v === "string") return v;
146
+ if (typeof v === "boolean") return `${v}`;
147
+ if (v instanceof Date && !isNaN(v.getTime())) return v.toLocaleDateString(locale);
148
+ return null;
149
+ }
150
+ /**
151
+ A link's tooltip rows: its value (when the chart's links differ in value
152
+ and no field of the link already shows it), then each of the link's own
153
+ fields other than the ones naming its ends.
154
+ */ export function linkTooltipRows(viz, d) {
155
+ const meta = linkMeta(d);
156
+ if (!meta) return [];
157
+ const fields = [];
158
+ let shown = false;
159
+ for (const [key, v] of Object.entries(meta.raw)){
160
+ if (meta.endKeys.includes(key) || key.startsWith("__")) continue;
161
+ const text = linkCellText(viz, v);
162
+ if (text === null) continue;
163
+ if (v === meta.value) shown = true;
164
+ fields.push([
165
+ key,
166
+ text
167
+ ]);
168
+ }
169
+ const rows = [];
170
+ if (meta.graph?.sized && meta.value !== undefined && !shown) rows.push([
171
+ viz.schema.translate("Value"),
172
+ linkCellText(viz, meta.value)
173
+ ]);
174
+ return rows.concat(fields);
175
+ }
176
+ /**
177
+ A link's spoken label: "Source to Target." When the chart's links differ
178
+ in value, its value follows: "Source to Target, 4."
179
+ */ export function linkAriaLabel(viz, d) {
180
+ const meta = linkMeta(d);
181
+ if (!meta) return "";
182
+ const value = meta.graph?.sized && meta.value !== undefined ? `, ${meta.value}` : "";
183
+ return `${linkEndLabel(viz, meta.source)} ${viz.schema.translate("to")} ${linkEndLabel(viz, meta.target)}${value}.`;
184
+ }
185
+ /**
186
+ What hovering a link highlights: the link and the nodes at its two ends.
187
+ Rows that aren't recorded nodes (legend entries) match by `nodeKey`.
188
+ */ export function linkHighlight(viz, d, nodeKey) {
189
+ const meta = linkMeta(d);
190
+ const ids = new Set([
191
+ meta.source.id,
192
+ meta.target.id
193
+ ]);
194
+ return (h, hi)=>{
195
+ const m = linkMeta(h);
196
+ if (m) return m.index === meta.index;
197
+ const id = linkNodeOf(viz, h)?.id ?? nodeKey?.(h, hi);
198
+ return id !== undefined && ids.has(`${id}`);
199
+ };
200
+ }
201
+ /**
202
+ A node's links in `graph`, the other end of each, and its direction,
203
+ strongest first. A link from the node to itself is `loop`, with the node
204
+ as its other end.
205
+ */ export function nodeConnections(graph, id) {
206
+ return (graph.byNode.get(id) ?? []).map((link)=>{
207
+ const meta = linkMeta(link);
208
+ const outgoing = meta.source.id === id;
209
+ return {
210
+ link,
211
+ other: outgoing ? meta.target : meta.source,
212
+ outgoing,
213
+ loop: meta.source.id === meta.target.id,
214
+ value: meta.value,
215
+ index: meta.index
216
+ };
217
+ }).sort((a, b)=>(b.value ?? -Infinity) - (a.value ?? -Infinity) || a.index - b.index).map(({ link, other, outgoing, loop, value })=>({
218
+ link,
219
+ other,
220
+ outgoing,
221
+ loop,
222
+ value
223
+ }));
224
+ }
225
+ /**
226
+ What hovering a node highlights: the node, the nodes it links to, and the
227
+ links between them. Null when `d` isn't a recorded node. Rows that aren't
228
+ recorded nodes (legend entries) match by `nodeKey`.
229
+ */ export function nodeHighlight(viz, d, nodeKey) {
230
+ const entry = linkNodeOf(viz, d);
231
+ if (!entry) return null;
232
+ const links = nodeConnections(entry.graph, entry.id);
233
+ const ids = new Set([
234
+ entry.id,
235
+ ...links.map((c)=>c.other.id)
236
+ ]);
237
+ const indices = new Set(links.map((c)=>linkMeta(c.link).index));
238
+ return (h, hi)=>{
239
+ const m = linkMeta(h);
240
+ if (m) return indices.has(m.index);
241
+ const id = linkNodeOf(viz, h)?.id ?? nodeKey?.(h, hi);
242
+ return id !== undefined && ids.has(`${id}`);
243
+ };
244
+ }
245
+ /**
246
+ How many links a node's tooltip lists: `nodeTooltipLinks` when it is a
247
+ number (`true` is 3, `false` none), else 3 when the links differ in value
248
+ and none when they don't.
249
+ */ export function nodeTooltipLinkLimit(viz, graph) {
250
+ const limit = viz.schema.nodeTooltipLinks;
251
+ if (limit === false) return 0;
252
+ if (limit === true) return 3;
253
+ if (typeof limit === "number" && Number.isFinite(limit)) return Math.max(0, Math.floor(limit));
254
+ return graph.sized ? 3 : 0;
255
+ }
256
+ /** The arrow a node's tooltip marks a link from the node to itself with. */ export const LOOP_ARROW = "↻";
257
+ /**
258
+ A node's tooltip rows: its number of connections, then its strongest
259
+ links ("→ Target" or "← Source", or "↻ Node" for a link to itself, with
260
+ the link's value when the links differ in value), up to
261
+ `nodeTooltipLinkLimit`. The arrows mirror right to left (see
262
+ `linkArrows`).
263
+ */ export function nodeConnectionRows(viz, d) {
264
+ const entry = linkNodeOf(viz, d);
265
+ if (!entry) return [];
266
+ const { graph, id } = entry;
267
+ const connections = nodeConnections(graph, id);
268
+ const rows = [
269
+ [
270
+ viz.schema.translate("Connections"),
271
+ `${connections.length}`
272
+ ]
273
+ ];
274
+ const [forward, back] = linkArrows(viz);
275
+ for (const c of connections.slice(0, nodeTooltipLinkLimit(viz, graph))){
276
+ const value = graph.sized && c.value !== undefined ? linkCellText(viz, c.value) : "";
277
+ rows.push([
278
+ `${c.loop ? LOOP_ARROW : c.outgoing ? forward : back} ${linkEndLabel(viz, c.other)}`,
279
+ value
280
+ ]);
281
+ }
282
+ return rows;
283
+ }
284
+ /**
285
+ The node-link charts' default `tooltipConfig`: a link is titled
286
+ "Source → Target" and lists its value and fields; a node is titled by its
287
+ label and lists its connections.
288
+ */ export function linkTooltipConfig(viz) {
289
+ return {
290
+ title: (d, i)=>isLinkDatum(d) ? linkTooltipTitle(viz, d) : viz._drawLabel(d, typeof d.i === "number" ? d.i : i),
291
+ tbody: (d)=>isLinkDatum(d) ? linkTooltipRows(viz, d) : nodeConnectionRows(viz, d)
292
+ };
293
+ }
294
+ /** The smallest stroke width a link's hit path takes, in pixels. */ export const LINK_HIT_WIDTH = 8;
295
+ /**
296
+ A transparent path over a link, wider than it, so thin links are easy to
297
+ point at. Keyboard navigation skips it (its key ends in `::hit`).
298
+ */ export function linkHitPath(key, d, datum, strokeWidth) {
299
+ const width = typeof strokeWidth === "number" ? strokeWidth : 1;
300
+ return {
301
+ type: "path",
302
+ key: `${key}::hit`,
303
+ d,
304
+ datum,
305
+ index: linkMeta(datum)?.index ?? 0,
306
+ paint: {
307
+ fill: "none",
308
+ stroke: "transparent",
309
+ strokeWidth: Math.max(LINK_HIT_WIDTH, width + 4)
310
+ }
311
+ };
312
+ }
@@ -0,0 +1,20 @@
1
+ /**
2
+ Unique scene keys for links whose base key names only their ends, so
3
+ parallel links (the same source and target) each get their own.
4
+ */ /**
5
+ One unique key per base key, in order: the first link with a base keeps
6
+ it, and each later one adds its order among the links sharing that base
7
+ (`-1`, `-2`, …), skipping any key already taken. The same bases give the
8
+ same keys on every call.
9
+ */ export function uniqueLinkKeys(bases) {
10
+ const taken = new Set();
11
+ const seen = new Map();
12
+ return bases.map((base)=>{
13
+ let n = seen.get(base) ?? 0;
14
+ let key = n ? `${base}-${n}` : base;
15
+ while(taken.has(key))key = `${base}-${++n}`;
16
+ seen.set(base, n + 1);
17
+ taken.add(key);
18
+ return key;
19
+ });
20
+ }
@@ -0,0 +1,209 @@
1
+ /**
2
+ Pure geometry for link labels: where on a link its label sits (the
3
+ middle of its length) and which way the link runs there, the angle that
4
+ keeps text upright, and the overlap tests that hide labels which would
5
+ cover each other or a node.
6
+ */ import { boxHitsCircle, boxesOverlap } from "./circleLabelPlacement.js";
7
+ /**
8
+ The middle of a straight link's visible length, between the edges of the
9
+ circles of radius `r0` and `r1` around its ends, and its direction.
10
+ */ export function segmentMidpoint(a, b, r0 = 0, r1 = 0) {
11
+ const dx = b[0] - a[0];
12
+ const dy = b[1] - a[1];
13
+ const length = Math.hypot(dx, dy);
14
+ const angle = Math.atan2(dy, dx);
15
+ if (!length) return {
16
+ x: a[0],
17
+ y: a[1],
18
+ angle
19
+ };
20
+ // Half the visible run past the start edge.
21
+ const t = (r0 + Math.max(0, length - r0 - r1) / 2) / length;
22
+ return {
23
+ x: a[0] + dx * t,
24
+ y: a[1] + dy * t,
25
+ angle
26
+ };
27
+ }
28
+ /** The point at `t` (0–1) along a cubic Bézier curve. */ export function cubicPoint(p0, p1, p2, p3, t) {
29
+ const u = 1 - t;
30
+ const a = u * u * u;
31
+ const b = 3 * u * u * t;
32
+ const c = 3 * u * t * t;
33
+ const d = t * t * t;
34
+ return [
35
+ a * p0[0] + b * p1[0] + c * p2[0] + d * p3[0],
36
+ a * p0[1] + b * p1[1] + c * p2[1] + d * p3[1]
37
+ ];
38
+ }
39
+ /** The direction (radians) a cubic Bézier curve runs at `t`. */ export function cubicAngle(p0, p1, p2, p3, t) {
40
+ const u = 1 - t;
41
+ const dx = 3 * u * u * (p1[0] - p0[0]) + 6 * u * t * (p2[0] - p1[0]) + 3 * t * t * (p3[0] - p2[0]);
42
+ const dy = 3 * u * u * (p1[1] - p0[1]) + 6 * u * t * (p2[1] - p1[1]) + 3 * t * t * (p3[1] - p2[1]);
43
+ // A degenerate end (a control point on its end) runs toward the far end.
44
+ if (!dx && !dy) return Math.atan2(p3[1] - p0[1], p3[0] - p0[0]);
45
+ return Math.atan2(dy, dx);
46
+ }
47
+ /**
48
+ The point halfway along a cubic Bézier curve's length (not at `t` = 0.5,
49
+ which bunches toward the tighter end), and its direction there.
50
+ @param steps The number of chords the curve's length is measured in.
51
+ */ export function cubicMidpoint(p0, p1, p2, p3, steps = 64) {
52
+ const lengths = [
53
+ 0
54
+ ];
55
+ let prev = p0;
56
+ for(let k = 1; k <= steps; k++){
57
+ const p = cubicPoint(p0, p1, p2, p3, k / steps);
58
+ lengths.push(lengths[k - 1] + Math.hypot(p[0] - prev[0], p[1] - prev[1]));
59
+ prev = p;
60
+ }
61
+ const half = lengths[steps] / 2;
62
+ let k = 1;
63
+ while(k < steps && lengths[k] < half)k++;
64
+ const span = lengths[k] - lengths[k - 1];
65
+ const t = (k - 1 + (span ? (half - lengths[k - 1]) / span : 0)) / steps;
66
+ const [x, y] = cubicPoint(p0, p1, p2, p3, t);
67
+ return {
68
+ x,
69
+ y,
70
+ angle: cubicAngle(p0, p1, p2, p3, t)
71
+ };
72
+ }
73
+ /**
74
+ A direction (radians) as the rotation (degrees) that keeps text running
75
+ along it upright: within -90° (reading bottom to top) and 90°.
76
+ */ export function uprightAngle(radians) {
77
+ let deg = radians * 180 / Math.PI;
78
+ deg = ((deg + 90) % 180 + 180) % 180 - 90;
79
+ // -0 reads as 0.
80
+ return deg === 0 ? 0 : Math.round(deg * 1e6) / 1e6;
81
+ }
82
+ /** A label box's four corners, clockwise from its top-left. */ export function labelCorners(box) {
83
+ const rad = box.angle * Math.PI / 180;
84
+ const cos = Math.cos(rad);
85
+ const sin = Math.sin(rad);
86
+ const hw = box.width / 2;
87
+ const hh = box.height / 2;
88
+ return [
89
+ [
90
+ -hw,
91
+ -hh
92
+ ],
93
+ [
94
+ hw,
95
+ -hh
96
+ ],
97
+ [
98
+ hw,
99
+ hh
100
+ ],
101
+ [
102
+ -hw,
103
+ hh
104
+ ]
105
+ ].map(([x, y])=>[
106
+ box.x + x * cos - y * sin,
107
+ box.y + x * sin + y * cos
108
+ ]);
109
+ }
110
+ /** Whether two convex polygons overlap (separating axis test; touching edges don't count). */ function polygonsOverlap(a, b) {
111
+ for (const poly of [
112
+ a,
113
+ b
114
+ ]){
115
+ for(let k = 0; k < poly.length; k++){
116
+ const p = poly[k];
117
+ const q = poly[(k + 1) % poly.length];
118
+ const nx = q[1] - p[1];
119
+ const ny = p[0] - q[0];
120
+ const project = (pts)=>{
121
+ let min = Infinity;
122
+ let max = -Infinity;
123
+ for (const [x, y] of pts){
124
+ const v = x * nx + y * ny;
125
+ if (v < min) min = v;
126
+ if (v > max) max = v;
127
+ }
128
+ return [
129
+ min,
130
+ max
131
+ ];
132
+ };
133
+ const [amin, amax] = project(a);
134
+ const [bmin, bmax] = project(b);
135
+ const eps = 1e-9 * Math.hypot(nx, ny);
136
+ if (amax <= bmin + eps || bmax <= amin + eps) return false;
137
+ }
138
+ }
139
+ return true;
140
+ }
141
+ /** A label box without rotation, as a top-left box. */ const flatBox = (box)=>({
142
+ x: box.x - box.width / 2,
143
+ y: box.y - box.height / 2,
144
+ width: box.width,
145
+ height: box.height
146
+ });
147
+ /** Whether two label boxes overlap. */ export function labelsOverlap(a, b) {
148
+ if (!a.angle && !b.angle) return boxesOverlap(flatBox(a), flatBox(b));
149
+ return polygonsOverlap(labelCorners(a), labelCorners(b));
150
+ }
151
+ /** Whether a label box overlaps a circle. */ export function labelHitsCircle(box, circle) {
152
+ // The circle's center in the label's own (unrotated) frame.
153
+ const rad = -box.angle * Math.PI / 180;
154
+ const dx = circle.x - box.x;
155
+ const dy = circle.y - box.y;
156
+ const local = {
157
+ x: dx * Math.cos(rad) - dy * Math.sin(rad),
158
+ y: dx * Math.sin(rad) + dy * Math.cos(rad),
159
+ r: circle.r
160
+ };
161
+ return boxHitsCircle(flatBox({
162
+ ...box,
163
+ x: 0,
164
+ y: 0
165
+ }), local);
166
+ }
167
+ /** Whether a label box overlaps an axis-aligned box (such as a Sankey node). */ export function labelHitsBox(box, rect) {
168
+ if (!box.angle) return boxesOverlap(flatBox(box), rect);
169
+ return polygonsOverlap(labelCorners(box), [
170
+ [
171
+ rect.x,
172
+ rect.y
173
+ ],
174
+ [
175
+ rect.x + rect.width,
176
+ rect.y
177
+ ],
178
+ [
179
+ rect.x + rect.width,
180
+ rect.y + rect.height
181
+ ],
182
+ [
183
+ rect.x,
184
+ rect.y + rect.height
185
+ ]
186
+ ]);
187
+ }
188
+ /**
189
+ The labels that fit, in the order given (earlier labels win): each one
190
+ that overlaps no node and no label already kept. A label with `boxes`
191
+ (such as one along a curve) is tested by those, else by its `box`.
192
+ */ export function placeLinkLabels(labels, obstacles) {
193
+ const circles = obstacles.circles ?? [];
194
+ const rects = obstacles.boxes ?? [];
195
+ const others = obstacles.labels ?? [];
196
+ const kept = [];
197
+ const keptBoxes = [];
198
+ for (const label of labels){
199
+ const boxes = label.boxes ?? [
200
+ label.box
201
+ ];
202
+ if (!boxes.length || !boxes.every((b)=>b.width > 0 && b.height > 0)) continue;
203
+ const hits = (box)=>circles.some((c)=>labelHitsCircle(box, c)) || rects.some((b)=>labelHitsBox(box, b)) || others.some((o)=>labelsOverlap(box, o)) || keptBoxes.some((k)=>labelsOverlap(box, k));
204
+ if (boxes.some(hits)) continue;
205
+ kept.push(label);
206
+ keptBoxes.push(...boxes);
207
+ }
208
+ return kept;
209
+ }