@d3plus/core 4.10.0 → 4.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (548) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +167 -8
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +170 -0
  9. package/es/src/charts/Alluvial/layout.js +137 -0
  10. package/es/src/charts/Alluvial/meta.js +57 -0
  11. package/es/src/charts/Alluvial/titles.js +81 -0
  12. package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
  13. package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
  14. package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
  15. package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
  16. package/es/src/charts/ArcDiagram/emit.js +178 -0
  17. package/es/src/charts/ArcDiagram/events.js +144 -0
  18. package/es/src/charts/ArcDiagram/index.js +215 -0
  19. package/es/src/charts/BarChart/index.js +14 -2
  20. package/es/src/charts/BoxWhisker/index.js +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +3 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +2 -1
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +162 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +132 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +204 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +3 -3
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Network/applyLayout.js +138 -94
  70. package/es/src/charts/Network/bundle.js +81 -0
  71. package/es/src/charts/Network/clusterLabels.js +423 -0
  72. package/es/src/charts/Network/clusters.js +290 -0
  73. package/es/src/charts/Network/emit.js +253 -70
  74. package/es/src/charts/Network/graph.js +117 -0
  75. package/es/src/charts/Network/graphFluent.js +79 -0
  76. package/es/src/charts/Network/index.js +86 -106
  77. package/es/src/charts/Network/minNodeDistance.js +64 -0
  78. package/es/src/charts/Network/polygonRows.js +44 -0
  79. package/es/src/charts/Pack/index.js +5 -1
  80. package/es/src/charts/Pie/applyLayout.js +86 -27
  81. package/es/src/charts/Pie/arcFit.js +152 -0
  82. package/es/src/charts/Pie/curvedLabels.js +134 -0
  83. package/es/src/charts/Pie/emit.js +43 -96
  84. package/es/src/charts/Pie/index.js +64 -31
  85. package/es/src/charts/Pie/labelRoom.js +154 -0
  86. package/es/src/charts/Pie/outsideLabels.js +224 -0
  87. package/es/src/charts/Pie/outsideNodes.js +267 -0
  88. package/es/src/charts/Pie/pieLabels.js +137 -0
  89. package/es/src/charts/Pie/sectorBox.js +223 -0
  90. package/es/src/charts/Pie/straightLabels.js +96 -0
  91. package/es/src/charts/Pie/straightLayout.js +215 -0
  92. package/es/src/charts/Plot/alongLegend.js +76 -0
  93. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  94. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  95. package/es/src/charts/Plot/axisValues.js +43 -0
  96. package/es/src/charts/Plot/barWidth.js +59 -11
  97. package/es/src/charts/Plot/circleLabels.js +98 -0
  98. package/es/src/charts/Plot/connectGaps.js +237 -0
  99. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  100. package/es/src/charts/Plot/draw.js +8 -2
  101. package/es/src/charts/Plot/fillBetween.js +2 -1
  102. package/es/src/charts/Plot/forecastScene.js +3 -4
  103. package/es/src/charts/Plot/index.js +18 -10
  104. package/es/src/charts/Plot/labelPlacement.js +1 -1
  105. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  106. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  107. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  108. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  109. package/es/src/charts/Plot/pipeline.js +66 -19
  110. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  111. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  112. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  113. package/es/src/charts/Plot/pipelineScales.js +40 -8
  114. package/es/src/charts/Plot/plotFacet.js +12 -1
  115. package/es/src/charts/Plot/plotInit.js +34 -5
  116. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  117. package/es/src/charts/Plot/referenceDomains.js +133 -0
  118. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  119. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  120. package/es/src/charts/Plot/trendLabels.js +183 -0
  121. package/es/src/charts/Plot/trendLines.js +1 -0
  122. package/es/src/charts/Plot/trendScene.js +6 -3
  123. package/es/src/charts/Plot/trendTooltip.js +5 -1
  124. package/es/src/charts/PolarArea/index.js +2 -2
  125. package/es/src/charts/Priestley/applyLayout.js +14 -20
  126. package/es/src/charts/Priestley/index.js +4 -35
  127. package/es/src/charts/Priestley/timeAxis.js +100 -0
  128. package/es/src/charts/Radar/axisDecorations.js +49 -12
  129. package/es/src/charts/Radar/curvedLabels.js +187 -0
  130. package/es/src/charts/Radar/index.js +2 -3
  131. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  132. package/es/src/charts/RadialBar/emit.js +4 -1
  133. package/es/src/charts/RadialBar/index.js +16 -9
  134. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  135. package/es/src/charts/RadialMatrix/index.js +3 -7
  136. package/es/src/charts/Rings/applyLayout.js +41 -24
  137. package/es/src/charts/Rings/emit.js +174 -58
  138. package/es/src/charts/Rings/index.js +61 -28
  139. package/es/src/charts/Rings/ringsGraph.js +28 -9
  140. package/es/src/charts/Rings/ringsLoops.js +73 -0
  141. package/es/src/charts/Rings/ringsParallel.js +166 -0
  142. package/es/src/charts/Sankey/applyLayout.js +116 -39
  143. package/es/src/charts/Sankey/circularLayout.js +208 -0
  144. package/es/src/charts/Sankey/circularLinks.js +301 -0
  145. package/es/src/charts/Sankey/emit.js +164 -94
  146. package/es/src/charts/Sankey/index.js +72 -75
  147. package/es/src/charts/Sankey/labels.js +80 -0
  148. package/es/src/charts/Sankey/ribbons.js +88 -0
  149. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  150. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  151. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  152. package/es/src/charts/Scatter/index.js +25 -0
  153. package/es/src/charts/SlopeChart/index.js +116 -0
  154. package/es/src/charts/SlopeChart/slope.js +95 -0
  155. package/es/src/charts/Streamgraph/index.js +51 -0
  156. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  157. package/es/src/charts/Sunburst/emit.js +74 -63
  158. package/es/src/charts/Sunburst/index.js +3 -3
  159. package/es/src/charts/Tree/index.js +2 -6
  160. package/es/src/charts/Treemap/index.js +2 -5
  161. package/es/src/charts/Violin/inner.js +3 -5
  162. package/es/src/charts/definition/makeChart.js +10 -2
  163. package/es/src/charts/drawSteps/backControl.js +17 -5
  164. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  165. package/es/src/charts/drawSteps/minimap.js +6 -5
  166. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  167. package/es/src/charts/drawSteps/searchControls.js +2 -1
  168. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  169. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  170. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  171. package/es/src/charts/events/click.legend.js +7 -2
  172. package/es/src/charts/events/click.shape.js +8 -1
  173. package/es/src/charts/events/mousemove.shape.js +5 -2
  174. package/es/src/charts/facet/drawFacets.js +14 -5
  175. package/es/src/charts/features/annotationFrame.js +179 -0
  176. package/es/src/charts/features/annotationText.js +83 -0
  177. package/es/src/charts/features/annotationTypes.js +10 -0
  178. package/es/src/charts/features/attributionFeature.js +6 -11
  179. package/es/src/charts/features/axes.js +2 -1
  180. package/es/src/charts/features/axesFinal.js +3 -1
  181. package/es/src/charts/features/axesMeasure.js +7 -4
  182. package/es/src/charts/features/calloutLayout.js +121 -0
  183. package/es/src/charts/features/calloutScene.js +155 -0
  184. package/es/src/charts/features/chartGeometry.js +1 -1
  185. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  186. package/es/src/charts/features/circleLabels.js +207 -0
  187. package/es/src/charts/features/colorScaleBucket.js +2 -1
  188. package/es/src/charts/features/colorScaleHover.js +3 -2
  189. package/es/src/charts/features/colorScaleValue.js +97 -0
  190. package/es/src/charts/features/curvedArrows.js +158 -0
  191. package/es/src/charts/features/edgeArrows.js +160 -4
  192. package/es/src/charts/features/edgeBundling.js +442 -0
  193. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  194. package/es/src/charts/features/ensureZoomDom.js +32 -8
  195. package/es/src/charts/features/features.js +32 -14
  196. package/es/src/charts/features/featuresColorScale.js +20 -6
  197. package/es/src/charts/features/featuresLegend.js +15 -24
  198. package/es/src/charts/features/legendKeys.js +64 -0
  199. package/es/src/charts/features/lineLabels.js +55 -46
  200. package/es/src/charts/features/linkBundle.js +19 -0
  201. package/es/src/charts/features/linkColor.js +72 -0
  202. package/es/src/charts/features/linkFields.js +86 -0
  203. package/es/src/charts/features/linkFocus.js +118 -0
  204. package/es/src/charts/features/linkInteraction.js +312 -0
  205. package/es/src/charts/features/linkKeys.js +20 -0
  206. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  207. package/es/src/charts/features/linkLabelPath.js +162 -0
  208. package/es/src/charts/features/linkLabels.js +340 -0
  209. package/es/src/charts/features/linkWidths.js +32 -0
  210. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  211. package/es/src/charts/features/pathLabels.js +50 -0
  212. package/es/src/charts/features/plotAnnotations.js +68 -17
  213. package/es/src/charts/features/plotPaint.js +38 -11
  214. package/es/src/charts/features/polyline.js +129 -0
  215. package/es/src/charts/features/referenceAnnotations.js +403 -0
  216. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  217. package/es/src/charts/features/ringLabelNodes.js +93 -0
  218. package/es/src/charts/features/ringLabels.js +222 -0
  219. package/es/src/charts/features/sceneBounds.js +26 -6
  220. package/es/src/charts/features/selfLoops.js +306 -0
  221. package/es/src/charts/features/shapeEmit.js +47 -31
  222. package/es/src/charts/features/sharedFields.js +15 -2
  223. package/es/src/charts/features/textHalo.js +29 -0
  224. package/es/src/charts/index.js +8 -0
  225. package/es/src/charts/partition/chartFields.js +2 -2
  226. package/es/src/charts/partition/interaction.js +9 -5
  227. package/es/src/charts/partition/zoom.js +7 -6
  228. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  229. package/es/src/charts/pipeline/preDrawData.js +46 -3
  230. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  231. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  232. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  233. package/es/src/charts/polar/config.js +2 -3
  234. package/es/src/charts/viz/Viz.js +39 -36
  235. package/es/src/charts/viz/VizBase.js +18 -10
  236. package/es/src/charts/viz/backgroundInk.js +13 -7
  237. package/es/src/charts/viz/focusRing.js +104 -0
  238. package/es/src/charts/viz/focusTargets.js +208 -0
  239. package/es/src/charts/viz/history.js +74 -0
  240. package/es/src/charts/viz/keyboardNav.js +297 -0
  241. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  242. package/es/src/charts/viz/loaderFormat.js +114 -0
  243. package/es/src/charts/viz/missingFields.js +2 -1
  244. package/es/src/charts/viz/mountTarget.js +9 -0
  245. package/es/src/charts/viz/nearestHover.js +183 -0
  246. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  247. package/es/src/charts/viz/ordinalColor.js +14 -12
  248. package/es/src/charts/viz/pageTheme.js +83 -0
  249. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  250. package/es/src/charts/viz/pointVoronoi.js +124 -0
  251. package/es/src/charts/viz/reducedMotion.js +27 -0
  252. package/es/src/charts/viz/vizDataPolling.js +8 -3
  253. package/es/src/charts/viz/vizDefaults.js +15 -23
  254. package/es/src/charts/viz/vizFields.js +35 -0
  255. package/es/src/charts/viz/vizRender.js +43 -28
  256. package/es/src/charts/viz/vizTheme.js +96 -0
  257. package/es/src/charts/viz/vizVisibility.js +14 -0
  258. package/es/src/components/Axis/Axis.js +6 -0
  259. package/es/src/components/Axis/AxisBottom.js +1 -0
  260. package/es/src/components/Axis/AxisLeft.js +1 -0
  261. package/es/src/components/Axis/AxisRight.js +1 -0
  262. package/es/src/components/Axis/AxisTop.js +1 -0
  263. package/es/src/components/Axis/axisBreak.js +4 -1
  264. package/es/src/components/Axis/axisDefaults.js +5 -9
  265. package/es/src/components/Axis/axisLayoutScale.js +7 -1
  266. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  267. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  268. package/es/src/components/Axis/rangeBreaks.js +201 -0
  269. package/es/src/components/Axis/timeValues.js +19 -4
  270. package/es/src/components/ColorScale/ColorScale.js +15 -9
  271. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  272. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  273. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  274. package/es/src/components/Legend/Legend.js +3 -0
  275. package/es/src/components/Legend/legendConfig.js +2 -6
  276. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  277. package/es/src/components/TextBox.js +29 -65
  278. package/es/src/components/Timeline/Timeline.js +12 -3
  279. package/es/src/components/Timeline/timelineConfig.js +20 -10
  280. package/es/src/components/Timeline/timelineMode.js +26 -0
  281. package/es/src/components/Timeline/timelineRender.js +7 -3
  282. package/es/src/components/Tooltip.js +15 -5
  283. package/es/src/components/fontStack.js +20 -0
  284. package/es/src/components/textBoxLayout.js +58 -21
  285. package/es/src/components/textBoxPath.js +73 -0
  286. package/es/src/components/textBoxScene.js +223 -0
  287. package/es/src/components/textBoxWords.js +70 -0
  288. package/es/src/shapes/Area.js +1 -0
  289. package/es/src/shapes/Bar.js +1 -0
  290. package/es/src/shapes/Box.js +1 -0
  291. package/es/src/shapes/Circle.js +1 -0
  292. package/es/src/shapes/Line.js +1 -0
  293. package/es/src/shapes/Path.js +1 -0
  294. package/es/src/shapes/Rect.js +1 -0
  295. package/es/src/shapes/Shape.js +1 -0
  296. package/es/src/shapes/Whisker.js +1 -0
  297. package/es/src/utils/BaseClass.js +25 -12
  298. package/es/src/utils/configPrep.js +2 -1
  299. package/es/src/utils/constant.js +13 -1
  300. package/es/src/utils/displayName.js +12 -0
  301. package/es/src/utils/theme.js +190 -0
  302. package/es/src/utils/themeInk.js +68 -0
  303. package/package.json +14 -11
  304. package/types/index.d.ts +6 -2
  305. package/types/internal.d.ts +250 -8
  306. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  307. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  308. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  309. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  310. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  311. package/types/src/charts/Alluvial/index.d.ts +27 -0
  312. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  313. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  314. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  315. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  316. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  317. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  318. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  319. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  320. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  321. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  322. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  323. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  324. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  325. package/types/src/charts/Chord/labels.d.ts +66 -0
  326. package/types/src/charts/Donut/index.d.ts +2 -1
  327. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  328. package/types/src/charts/Gantt/emit.d.ts +17 -0
  329. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  330. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  331. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  332. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  333. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  334. package/types/src/charts/Gantt/index.d.ts +36 -0
  335. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  336. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  337. package/types/src/charts/Geomap/emit.d.ts +2 -2
  338. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  339. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  340. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  341. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  342. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  343. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  344. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  345. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  346. package/types/src/charts/Geomap/index.d.ts +3 -0
  347. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  348. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  349. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  350. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  351. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  352. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  353. package/types/src/charts/Hexbin/index.d.ts +25 -0
  354. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  355. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  356. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  357. package/types/src/charts/Histogram/binData.d.ts +20 -1
  358. package/types/src/charts/Histogram/index.d.ts +3 -2
  359. package/types/src/charts/Histogram/labels.d.ts +7 -0
  360. package/types/src/charts/Marimekko/index.d.ts +2 -1
  361. package/types/src/charts/Network/bundle.d.ts +67 -0
  362. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  363. package/types/src/charts/Network/clusters.d.ts +115 -0
  364. package/types/src/charts/Network/graph.d.ts +65 -0
  365. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  366. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  367. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  368. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  369. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  370. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  371. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  372. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  373. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  374. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  375. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  376. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  377. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  378. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  379. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  380. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  381. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  382. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  383. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  384. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  385. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  386. package/types/src/charts/Plot/index.d.ts +15 -8
  387. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  388. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  389. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  390. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  391. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  392. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  393. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  394. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  395. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  396. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  397. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  398. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  399. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  400. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  401. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  402. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  403. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  404. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  405. package/types/src/charts/Rings/emit.d.ts +50 -0
  406. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  407. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  408. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  409. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  410. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  411. package/types/src/charts/Sankey/emit.d.ts +58 -0
  412. package/types/src/charts/Sankey/labels.d.ts +19 -0
  413. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  414. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  415. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  416. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  417. package/types/src/charts/Scatter/index.d.ts +15 -0
  418. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  419. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  420. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  421. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  422. package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
  423. package/types/src/charts/definition/makeChart.d.ts +3 -2
  424. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  425. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  426. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  427. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  428. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  429. package/types/src/charts/events/click.legend.d.ts +2 -1
  430. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  431. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  432. package/types/src/charts/features/annotationText.d.ts +57 -0
  433. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  434. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  435. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  436. package/types/src/charts/features/calloutScene.d.ts +40 -0
  437. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  438. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  439. package/types/src/charts/features/circleLabels.d.ts +130 -0
  440. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  441. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  442. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  443. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  444. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  445. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  446. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  447. package/types/src/charts/features/legendKeys.d.ts +34 -0
  448. package/types/src/charts/features/lineLabels.d.ts +15 -12
  449. package/types/src/charts/features/linkBundle.d.ts +16 -0
  450. package/types/src/charts/features/linkColor.d.ts +48 -0
  451. package/types/src/charts/features/linkFields.d.ts +16 -0
  452. package/types/src/charts/features/linkFocus.d.ts +51 -0
  453. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  454. package/types/src/charts/features/linkKeys.d.ts +11 -0
  455. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  456. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  457. package/types/src/charts/features/linkLabels.d.ts +77 -0
  458. package/types/src/charts/features/linkWidths.d.ts +19 -0
  459. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  460. package/types/src/charts/features/pathLabels.d.ts +41 -0
  461. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  462. package/types/src/charts/features/plotPaint.d.ts +17 -0
  463. package/types/src/charts/features/polyline.d.ts +32 -0
  464. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  465. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  466. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  467. package/types/src/charts/features/ringLabels.d.ts +164 -0
  468. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  469. package/types/src/charts/features/selfLoops.d.ts +165 -0
  470. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  471. package/types/src/charts/features/sharedFields.d.ts +11 -2
  472. package/types/src/charts/features/textHalo.d.ts +14 -0
  473. package/types/src/charts/index.d.ts +8 -0
  474. package/types/src/charts/partition/interaction.d.ts +6 -3
  475. package/types/src/charts/partition/zoom.d.ts +4 -4
  476. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  477. package/types/src/charts/pipeline/stages.d.ts +7 -0
  478. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  479. package/types/src/charts/viz/Viz.d.ts +16 -2
  480. package/types/src/charts/viz/VizBase.d.ts +6 -6
  481. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  482. package/types/src/charts/viz/focusRing.d.ts +25 -0
  483. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  484. package/types/src/charts/viz/history.d.ts +35 -0
  485. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  486. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  487. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  488. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  489. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  490. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  491. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  492. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  493. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  494. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  495. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  496. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  497. package/types/src/charts/viz/vizFields.d.ts +32 -0
  498. package/types/src/charts/viz/vizRender.d.ts +2 -1
  499. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  500. package/types/src/charts/viz/vizTypes.d.ts +84 -7
  501. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  502. package/types/src/components/Axis/Axis.d.ts +1 -0
  503. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  504. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  505. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  506. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  507. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  508. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  509. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  510. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  511. package/types/src/components/Axis/timeValues.d.ts +1 -1
  512. package/types/src/components/ColorScale/ColorScale.d.ts +1 -0
  513. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  514. package/types/src/components/Legend/Legend.d.ts +1 -0
  515. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  516. package/types/src/components/TextBox.d.ts +1 -0
  517. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  518. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  519. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  520. package/types/src/components/Tooltip.d.ts +4 -3
  521. package/types/src/components/fontStack.d.ts +10 -0
  522. package/types/src/components/textBoxLayout.d.ts +18 -9
  523. package/types/src/components/textBoxPath.d.ts +59 -0
  524. package/types/src/components/textBoxScene.d.ts +51 -0
  525. package/types/src/components/textBoxWords.d.ts +33 -0
  526. package/types/src/shapes/Area.d.ts +1 -0
  527. package/types/src/shapes/Bar.d.ts +1 -0
  528. package/types/src/shapes/Box.d.ts +1 -0
  529. package/types/src/shapes/Circle.d.ts +1 -0
  530. package/types/src/shapes/Line.d.ts +1 -0
  531. package/types/src/shapes/Path.d.ts +1 -0
  532. package/types/src/shapes/Rect.d.ts +1 -0
  533. package/types/src/shapes/Shape.d.ts +1 -0
  534. package/types/src/shapes/Whisker.d.ts +1 -0
  535. package/types/src/utils/BaseClass.d.ts +9 -0
  536. package/types/src/utils/D3plusConfig.d.ts +981 -30
  537. package/types/src/utils/configPrep.d.ts +2 -0
  538. package/types/src/utils/constant.d.ts +8 -0
  539. package/types/src/utils/displayName.d.ts +10 -0
  540. package/types/src/utils/index.d.ts +1 -1
  541. package/types/src/utils/theme.d.ts +170 -0
  542. package/types/src/utils/themeInk.d.ts +56 -0
  543. package/umd/d3plus-core.full.js +86811 -61031
  544. package/umd/d3plus-core.full.min.js +2 -2
  545. package/umd/d3plus-core.js +28392 -6498
  546. package/umd/d3plus-core.min.js +2 -2
  547. package/es/src/components/Axis/gridStroke.js +0 -10
  548. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -3,7 +3,8 @@ import type { FeatureModule } from "./features.js";
3
3
  import type Legend from "../../components/Legend/Legend.js";
4
4
  import type { VizInstance } from "../viz/vizTypes.js";
5
5
  import type { InsetOrient } from "./insetState.js";
6
- interface LegendData {
6
+ /** The legend's rolled-up entries, with the key and paint accessors its render reuses. */
7
+ export interface LegendData {
7
8
  legendData: DataPoint[];
8
9
  legendKey: (d: DataPoint, i: number) => string;
9
10
  getAttr: (d: DataPoint, i: number, attr: string) => string;
@@ -13,7 +14,8 @@ interface LegendData {
13
14
  `viz._legendDepth` (the lowest groupBy level whose values are unique) and
14
15
  `viz._legendCategories` (see `legendCategory.ts`), then sorts it.
15
16
  Returns the `legendData` array plus the `fill`/`getAttr` accessors the
16
- render step reuses.
17
+ render step reuses. A legend set to a constant false (`legend(false)`)
18
+ gets no entries, and its depth and categories stay as they were.
17
19
  */
18
20
  export declare function buildLegendData(viz: VizInstance): LegendData;
19
21
  /**
@@ -47,4 +49,3 @@ export declare function paintLegendInset(viz: VizInstance, orient: InsetOrient,
47
49
  scene composition for Legend happens via Viz.toScene's `components` array.
48
50
  */
49
51
  export declare const legendFeature: FeatureModule;
50
- export {};
@@ -0,0 +1,34 @@
1
+ /**
2
+ How the legend groups rows into entries: by the color each row encodes,
3
+ its opacity and its texture.
4
+ */
5
+ import type { DataPoint } from "@d3plus/data";
6
+ import type { VizInstance } from "../viz/vizTypes.js";
7
+ /** The functions that read a row's legend paint and key. */
8
+ export interface LegendKeys {
9
+ /** A paint attribute (`fill`, `opacity`, …) from the row's shapeConfig; a Line's fill is its stroke. */
10
+ getAttr: (d: DataPoint, i: number, attr: string) => string;
11
+ /** The row's color encoding input, or undefined without a color accessor. */
12
+ colorOf: (d: DataPoint, i: number) => unknown;
13
+ /** The row's entry key, given its color encoding. */
14
+ keyOf: (d: DataPoint, i: number, c: unknown) => string;
15
+ }
16
+ /**
17
+ The legend's key functions for a chart.
18
+ @param viz The chart.
19
+ */
20
+ export declare function legendKeys(viz: VizInstance): LegendKeys;
21
+ /**
22
+ The rows the legend rolls up: `_legendData`, less the rows a colorScale
23
+ colors.
24
+ @param viz The chart.
25
+ */
26
+ export declare function legendRows(viz: VizInstance): DataPoint[];
27
+ /**
28
+ How many entries the legend has (the number `buildLegendData` rolls its
29
+ rows into), counting no further than `limit + 1`: enough to tell whether
30
+ there are more than `limit`. A legend set to a constant false has none.
31
+ @param viz The chart.
32
+ @param limit The count past which to stop.
33
+ */
34
+ export declare function legendEntryCount(viz: VizInstance, limit?: number): number;
@@ -2,16 +2,19 @@
2
2
  Line-label collision resolution + connector emit for the Plot paint phase.
3
3
 
4
4
  Plot's `lineLabels` feature draws a label at the end of each series line.
5
- When several series end at nearby y positions the labels overlap, so they
6
- are "bumped" apart into discrete y buckets; a thin connector line then
7
- links each bumped label back to its true series position.
5
+ When several series end at nearby y positions the labels would overlap,
6
+ so they are spread apart until none do; a thin connector line then
7
+ links each moved label back to its true series position.
8
+
9
+ Labels at a line's left end (`lineLabels: "start"` or `"both"`) are
10
+ placed the same way, apart from the right-end labels.
8
11
 
9
12
  The measure half (which series get labels + their widths) lives upstream
10
13
  as the `measurePlotLineLabels` pipeline stage. This module owns the two
11
14
  remaining pieces:
12
15
 
13
- - `bumpLineLabels` — resolve overlaps, returning the id→bumped-y map.
14
- - `emitLineLabelConnectors` — draw the connector lines for bumped labels.
16
+ - `bumpLineLabels` — resolve overlaps, returning the id→moved-y map.
17
+ - `emitLineLabelConnectors` — draw the connector lines for moved labels.
15
18
 
16
19
  This is Plot-family-specific (it depends on Line series + the rendered
17
20
  y-axis position function), not a generic cross-viz feature.
@@ -22,18 +25,18 @@ import type { SceneNode } from "@d3plus/render";
22
25
  import type { LabelWidth } from "./plotPaint.js";
23
26
  import type { VizInstance as Viz } from "../viz/vizTypes.js";
24
27
  /**
25
- Resolve label overlaps within each x-group by bumping colliding labels
26
- into discrete y buckets (capped at 1/8 of the range so a label never
27
- travels too far from its series). Mutates each `LabelWidth`'s `newY`/
28
- `defaultY` in place and returns the id→bumped-y map the Line emitter and
29
- connector emit read. Must run AFTER the production y-axis has rendered —
30
- `bumpPrevious` reads `viz._yAxis._getPosition`.
28
+ Resolve label overlaps within each x-group, each end of the lines on its
29
+ own: labels are spread apart until none overlap (see `spreadGroup`).
30
+ Mutates each `LabelWidth`'s `newY`/`defaultY` in place and returns the
31
+ moved-y map, keyed by `lineLabelKey`, that the Line emitter and
32
+ connector emit read. Must run AFTER the production y-axis has rendered:
33
+ it reads `viz._yAxis._getPosition`.
31
34
  */
32
35
  export declare function bumpLineLabels(viz: Viz, labelWidths: LabelWidth[], yRange: number[]): Record<string, number>;
33
36
  /**
34
37
  Emit the connector lines for labels that were bumped (`newY` set). Each
35
38
  connector runs from the label's true series position to its bumped
36
- position. Returns the compute-mode scene nodes (empty when nothing was
39
+ position, rightward for a right-end label and leftward for a left-end one. Returns the compute-mode scene nodes (empty when nothing was
37
40
  bumped). Coords are relative to `_chartTransform`, which the chart-cells
38
41
  group applies.
39
42
  */
@@ -0,0 +1,16 @@
1
+ /**
2
+ `linkBundle` for a chart's links: bundles their straight runs (see
3
+ `bundleEdges`) with the chart's `linkBundleConfig`, through a cache kept
4
+ on the chart, so a redraw with the links where they were reuses the
5
+ last bundling.
6
+ */
7
+ import type { EdgeBundleCache, Segment } from "./edgeBundling.js";
8
+ import type { Point } from "./polyline.js";
9
+ import type { VizInstance } from "../viz/vizTypes.js";
10
+ /** The chart's bundling cache, created on first use. */
11
+ export declare function linkBundleCache(viz: VizInstance): EdgeBundleCache;
12
+ /**
13
+ Each edge's bundled path, from its source to its target, with the
14
+ chart's `linkBundleConfig`.
15
+ */
16
+ export declare function bundleLinkPaths(viz: VizInstance, edges: readonly Segment[]): Point[][];
@@ -0,0 +1,48 @@
1
+ /**
2
+ `linkColor` on the node-link charts (Network, Rings, Sankey, ArcDiagram):
3
+ each link's stroke, from one of its end nodes or from a value on the
4
+ link. Arrowheads take their link's stroke.
5
+ */
6
+ import type { DataPoint } from "@d3plus/data";
7
+ import type { VizInstance } from "../viz/vizTypes.js";
8
+ /** How links are colored: theme gray, an end node's color, or a value on each link. */
9
+ export type LinkColorSetting = false | "source" | "target" | ((d: DataPoint, i: number) => unknown);
10
+ /** A drawn link's end node, as a layout hands it to its emitter. */
11
+ export interface DrawnLinkEnd {
12
+ /** The node's shape kind (`"Circle"` when it has none). */
13
+ shape?: unknown;
14
+ }
15
+ /** A drawn link: its two end nodes. */
16
+ export interface LinkEnds {
17
+ source?: DrawnLinkEnd;
18
+ target?: DrawnLinkEnd;
19
+ }
20
+ /**
21
+ Stores a `linkColor` value: `"source"` and `"target"` as given, a falsy
22
+ value as `false`, a function as given, and any other string as a key
23
+ read from each link.
24
+ */
25
+ export declare function coerceLinkColor(value: unknown): unknown;
26
+ /**
27
+ The datum a drawn link carries (see `makeLinkDatum`), or the link itself
28
+ when it has none, and the link's index in `links` (else `i`).
29
+ */
30
+ export declare function linkRow(link: object, i: number): {
31
+ row: DataPoint;
32
+ index: number;
33
+ };
34
+ /**
35
+ The color a link's value gives it: a number through the chart's
36
+ colorScale, a string as a literal color when it parses as one or as a
37
+ category in the chart's categorical palette (the way `color` colors
38
+ nodes), and nothing for any other value.
39
+ */
40
+ export declare function linkValueColor(viz: VizInstance, value: unknown): string | undefined;
41
+ /**
42
+ Builds the chart's link stroke resolver for one draw: given a link's
43
+ datum (and its drawn ends, for their shape kinds), the stroke
44
+ `linkColor` gives it, or undefined to keep the link's
45
+ `shapeConfig.Path` stroke. Links colored by number are noted for the
46
+ colorScale.
47
+ */
48
+ export declare function linkColorResolver(viz: VizInstance): (datum: DataPoint, drawn?: LinkEnds) => string | undefined;
@@ -0,0 +1,16 @@
1
+ /**
2
+ The link color and label config the node-link charts (Network, Rings,
3
+ Sankey, ArcDiagram) share, and the widest-link and link bundling fields
4
+ Network and Geomap share.
5
+ */
6
+ import type { ConfigField } from "../../fluent.js";
7
+ /** The `linkColor`, `linkLabel`, and `linkLabelConfig` fields. */
8
+ export declare function linkStyleFields(): ConfigField[];
9
+ /**
10
+ The `linkSizeMax` field: the widest link, in pixels, when `linkSize`
11
+ values differ. `fallback` is the chart's default; without one the
12
+ chart works the width out (see `linkWidthRange`).
13
+ */
14
+ export declare function linkSizeMaxField(fallback?: number): ConfigField;
15
+ /** The `linkBundle` and `linkBundleConfig` fields (Network and Geomap). */
16
+ export declare function linkBundleFields(): ConfigField[];
@@ -0,0 +1,51 @@
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
+ */
8
+ import type { DataPoint } from "@d3plus/data";
9
+ import type { VizInstance } from "../viz/vizTypes.js";
10
+ import type { LinkDatum } from "./linkInteraction.js";
11
+ type NodeKey = (d: DataPoint, i: number) => string;
12
+ /** A box as `[[x0, y0], [x1, y1]]`. */
13
+ export type FocusBox = [[number, number], [number, number]];
14
+ /** The id a focused link sets on `viz._focus`. */
15
+ export declare function linkFocusId(d: LinkDatum): string;
16
+ /**
17
+ The box around a link's two ends, from the chart's laid-out nodes
18
+ (`viz.ctx.nodeLookup` records with `x`, `y`, and `r`), or null when they
19
+ aren't laid out that way.
20
+ */
21
+ export declare function linkEndsBox(viz: VizInstance, d: LinkDatum): FocusBox | null;
22
+ /**
23
+ Clears a click focus: the active marks, and the zoom where the chart
24
+ zooms. Returns whether there was a focus to clear.
25
+ */
26
+ export declare function clearLinkFocus(viz: VizInstance): boolean;
27
+ /**
28
+ Routes clicks on the chart's own outer `<svg>` (the empty space around an
29
+ SVG scene, which only takes the pointer over what it paints) to
30
+ `viz._backgroundClick`. Clicks on marks, on the chart's chrome, or on a
31
+ zoom surface's background land on other elements and are left alone; the
32
+ Canvas renderer reports its empty clicks itself.
33
+ */
34
+ export declare function bindSvgBackgroundClick(viz: VizInstance): void;
35
+ /**
36
+ Focuses a clicked link: it and the nodes at its ends stay bright, the
37
+ rest dims, and a chart that zooms zooms to `box`. Clicking the focused
38
+ link again clears the focus. Rows that aren't recorded nodes (legend
39
+ entries) match by `nodeKey`.
40
+ */
41
+ export declare function focusLink(viz: VizInstance, d: LinkDatum, { nodeKey, box }?: {
42
+ nodeKey?: NodeKey;
43
+ box?: FocusBox | null;
44
+ }): void;
45
+ /**
46
+ Clears the chart's click focus when a click lands on no mark within its
47
+ chart area (`viz._backgroundClick`, given the click's point on the
48
+ chart's surface).
49
+ */
50
+ export declare function installFocusBackgroundClick(viz: VizInstance): void;
51
+ export {};
@@ -0,0 +1,183 @@
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
+ */
15
+ import type { DataPoint } from "@d3plus/data";
16
+ import type { VizInstance } from "../viz/vizTypes.js";
17
+ /**
18
+ A link as accessors and tooltips receive it: the link's own fields, with
19
+ `source` and `target` set to the data of the nodes at its ends.
20
+ */
21
+ export type LinkDatum = DataPoint & {
22
+ source: DataPoint;
23
+ target: DataPoint;
24
+ };
25
+ /** One end of a link: the node's datum, its index, and its id. */
26
+ export interface LinkEnd {
27
+ data: DataPoint;
28
+ i: number;
29
+ id: string;
30
+ /** The end's name, for an end with no row of its own to label it (a bare coordinate). */
31
+ label?: string;
32
+ }
33
+ /** The links of a chart, and each node's links by node id. */
34
+ export interface LinkGraph {
35
+ links: LinkDatum[];
36
+ /** Whether the links' values differ, so tooltips and labels report them. */
37
+ sized: boolean;
38
+ byNode: Map<string, LinkDatum[]>;
39
+ }
40
+ /** What the chart knows about a link datum. */
41
+ export interface LinkMeta {
42
+ /** The link's index in `links`. */
43
+ index: number;
44
+ /** The link's row in `links`. */
45
+ raw: DataPoint;
46
+ source: LinkEnd;
47
+ target: LinkEnd;
48
+ /** The keys of `raw` that name its ends. */
49
+ endKeys: string[];
50
+ /** The link's value (`linkSize` or `value`), when it is a number. */
51
+ value?: number;
52
+ graph?: LinkGraph;
53
+ }
54
+ type Predicate = (d: DataPoint, i: number) => boolean;
55
+ type NodeKey = (d: DataPoint, i: number) => string;
56
+ type Row = [string, string];
57
+ /** What the chart recorded for a link datum, if `d` is one. */
58
+ export declare function linkMeta(d: unknown): LinkMeta | undefined;
59
+ /** Whether `d` is a link datum. */
60
+ export declare function isLinkDatum(d: unknown): d is LinkDatum;
61
+ /**
62
+ The datum a link is drawn with: `raw`'s fields, with `source` and
63
+ `target` set to the data of the nodes at its ends.
64
+ @param raw The link's row in `links`.
65
+ @param source The node at its source end.
66
+ @param target The node at its target end.
67
+ @param index The link's index in `links`.
68
+ @param endKeys The keys of `raw` that name its ends.
69
+ */
70
+ export declare function makeLinkDatum(raw: DataPoint, source: LinkEnd, target: LinkEnd, index: number, endKeys?: string[]): LinkDatum;
71
+ /**
72
+ Records a link's value (from `linkSize` or `value`) for its tooltip and
73
+ spoken label, and returns it.
74
+ */
75
+ export declare function setLinkValue<T>(d: LinkDatum, value: T): T;
76
+ /**
77
+ Indexes a chart's links by node and stores the result on `viz.ctx.linkGraph`.
78
+ Each of `nodes` (including any without links) is recognized by its datum
79
+ from then on, so its tooltip can list its connections.
80
+ */
81
+ export declare function publishLinkGraph(viz: VizInstance, links: LinkDatum[], nodes: LinkEnd[]): LinkGraph;
82
+ /**
83
+ Forgets every node `publishLinkGraph` recorded for a chart, so rows that
84
+ no longer end a link stop reading as nodes.
85
+ */
86
+ export declare function forgetLinkNodes(viz: VizInstance): void;
87
+ /** The node id and graph recorded for a node datum, if `d` is one. */
88
+ export declare function linkNodeOf(viz: VizInstance, d: unknown): {
89
+ id: string;
90
+ graph: LinkGraph;
91
+ } | undefined;
92
+ /** Whether a locale code (`"ar-SA"`) names a language written right to left. */
93
+ export declare function rtlLocale(locale: unknown): boolean;
94
+ /**
95
+ The arrows a chart's tooltips point from a link's source to its target
96
+ with: `["→", "←"]`, mirrored to `["←", "→"]` when the chart's locale is
97
+ written right to left or the page's direction is (see `rtl`).
98
+ */
99
+ export declare function linkArrows(viz: VizInstance): [string, string];
100
+ /** A link end's label, as its node's tooltip titles it. */
101
+ export declare function linkEndLabel(viz: VizInstance, end: LinkEnd): string;
102
+ /** A link's tooltip title: "Source → Target" ("Source ← Target" right to left). */
103
+ export declare function linkTooltipTitle(viz: VizInstance, d: LinkDatum): string;
104
+ /** A tooltip cell's text for one field value, or null for a value it skips. */
105
+ export declare function linkCellText(viz: VizInstance, v: unknown): string | null;
106
+ /**
107
+ A link's tooltip rows: its value (when the chart's links differ in value
108
+ and no field of the link already shows it), then each of the link's own
109
+ fields other than the ones naming its ends.
110
+ */
111
+ export declare function linkTooltipRows(viz: VizInstance, d: LinkDatum): Row[];
112
+ /**
113
+ A link's spoken label: "Source to Target." When the chart's links differ
114
+ in value, its value follows: "Source to Target, 4."
115
+ */
116
+ export declare function linkAriaLabel(viz: VizInstance, d: LinkDatum): string;
117
+ /**
118
+ What hovering a link highlights: the link and the nodes at its two ends.
119
+ Rows that aren't recorded nodes (legend entries) match by `nodeKey`.
120
+ */
121
+ export declare function linkHighlight(viz: VizInstance, d: LinkDatum, nodeKey?: NodeKey): Predicate;
122
+ /**
123
+ A node's links in `graph`, the other end of each, and its direction,
124
+ strongest first. A link from the node to itself is `loop`, with the node
125
+ as its other end.
126
+ */
127
+ export declare function nodeConnections(graph: LinkGraph, id: string): {
128
+ link: LinkDatum;
129
+ other: LinkEnd;
130
+ outgoing: boolean;
131
+ loop: boolean;
132
+ value?: number;
133
+ }[];
134
+ /**
135
+ What hovering a node highlights: the node, the nodes it links to, and the
136
+ links between them. Null when `d` isn't a recorded node. Rows that aren't
137
+ recorded nodes (legend entries) match by `nodeKey`.
138
+ */
139
+ export declare function nodeHighlight(viz: VizInstance, d: DataPoint, nodeKey?: NodeKey): Predicate | null;
140
+ /**
141
+ How many links a node's tooltip lists: `nodeTooltipLinks` when it is a
142
+ number (`true` is 3, `false` none), else 3 when the links differ in value
143
+ and none when they don't.
144
+ */
145
+ export declare function nodeTooltipLinkLimit(viz: VizInstance, graph: LinkGraph): number;
146
+ /** The arrow a node's tooltip marks a link from the node to itself with. */
147
+ export declare const LOOP_ARROW = "\u21BB";
148
+ /**
149
+ A node's tooltip rows: its number of connections, then its strongest
150
+ links ("→ Target" or "← Source", or "↻ Node" for a link to itself, with
151
+ the link's value when the links differ in value), up to
152
+ `nodeTooltipLinkLimit`. The arrows mirror right to left (see
153
+ `linkArrows`).
154
+ */
155
+ export declare function nodeConnectionRows(viz: VizInstance, d: DataPoint): Row[];
156
+ /**
157
+ The node-link charts' default `tooltipConfig`: a link is titled
158
+ "Source → Target" and lists its value and fields; a node is titled by its
159
+ label and lists its connections.
160
+ */
161
+ export declare function linkTooltipConfig(viz: VizInstance): {
162
+ title: (d: DataPoint, i: number) => string;
163
+ tbody: (d: DataPoint, i: number) => Row[];
164
+ };
165
+ /** The smallest stroke width a link's hit path takes, in pixels. */
166
+ export declare const LINK_HIT_WIDTH = 8;
167
+ /**
168
+ A transparent path over a link, wider than it, so thin links are easy to
169
+ point at. Keyboard navigation skips it (its key ends in `::hit`).
170
+ */
171
+ export declare function linkHitPath(key: string, d: string, datum: LinkDatum, strokeWidth: unknown): {
172
+ type: "path";
173
+ key: string;
174
+ d: string;
175
+ datum: LinkDatum;
176
+ index: number;
177
+ paint: {
178
+ fill: string;
179
+ stroke: string;
180
+ strokeWidth: number;
181
+ };
182
+ };
183
+ export {};
@@ -0,0 +1,11 @@
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
+ /**
6
+ One unique key per base key, in order: the first link with a base keeps
7
+ it, and each later one adds its order among the links sharing that base
8
+ (`-1`, `-2`, …), skipping any key already taken. The same bases give the
9
+ same keys on every call.
10
+ */
11
+ export declare function uniqueLinkKeys(bases: readonly string[]): string[];
@@ -0,0 +1,67 @@
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
+ */
7
+ import type { CircleLabelBox, LabelCircle } from "./circleLabelPlacement.js";
8
+ /** A point on a link and the direction the link runs there, in radians. */
9
+ export interface LinkAnchor {
10
+ x: number;
11
+ y: number;
12
+ angle: number;
13
+ }
14
+ type Point = [number, number];
15
+ /**
16
+ The middle of a straight link's visible length, between the edges of the
17
+ circles of radius `r0` and `r1` around its ends, and its direction.
18
+ */
19
+ export declare function segmentMidpoint(a: Point, b: Point, r0?: number, r1?: number): LinkAnchor;
20
+ /** The point at `t` (0–1) along a cubic Bézier curve. */
21
+ export declare function cubicPoint(p0: Point, p1: Point, p2: Point, p3: Point, t: number): Point;
22
+ /** The direction (radians) a cubic Bézier curve runs at `t`. */
23
+ export declare function cubicAngle(p0: Point, p1: Point, p2: Point, p3: Point, t: number): number;
24
+ /**
25
+ The point halfway along a cubic Bézier curve's length (not at `t` = 0.5,
26
+ which bunches toward the tighter end), and its direction there.
27
+ @param steps The number of chords the curve's length is measured in.
28
+ */
29
+ export declare function cubicMidpoint(p0: Point, p1: Point, p2: Point, p3: Point, steps?: number): LinkAnchor;
30
+ /**
31
+ A direction (radians) as the rotation (degrees) that keeps text running
32
+ along it upright: within -90° (reading bottom to top) and 90°.
33
+ */
34
+ export declare function uprightAngle(radians: number): number;
35
+ /** A label's box: its center, its size, and its rotation in degrees about its center. */
36
+ export interface LinkLabelBox {
37
+ x: number;
38
+ y: number;
39
+ width: number;
40
+ height: number;
41
+ angle: number;
42
+ }
43
+ /** A label box's four corners, clockwise from its top-left. */
44
+ export declare function labelCorners(box: LinkLabelBox): Point[];
45
+ /** Whether two label boxes overlap. */
46
+ export declare function labelsOverlap(a: LinkLabelBox, b: LinkLabelBox): boolean;
47
+ /** Whether a label box overlaps a circle. */
48
+ export declare function labelHitsCircle(box: LinkLabelBox, circle: LabelCircle): boolean;
49
+ /** Whether a label box overlaps an axis-aligned box (such as a Sankey node). */
50
+ export declare function labelHitsBox(box: LinkLabelBox, rect: CircleLabelBox): boolean;
51
+ /** The nodes (and node labels) link labels must stay clear of. */
52
+ export interface LabelObstacles {
53
+ circles?: LabelCircle[];
54
+ boxes?: CircleLabelBox[];
55
+ /** Other labels' boxes, which may be rotated. */
56
+ labels?: LinkLabelBox[];
57
+ }
58
+ /**
59
+ The labels that fit, in the order given (earlier labels win): each one
60
+ that overlaps no node and no label already kept. A label with `boxes`
61
+ (such as one along a curve) is tested by those, else by its `box`.
62
+ */
63
+ export declare function placeLinkLabels<T extends {
64
+ box: LinkLabelBox;
65
+ boxes?: readonly LinkLabelBox[];
66
+ }>(labels: readonly T[], obstacles: LabelObstacles): T[];
67
+ export {};
@@ -0,0 +1,85 @@
1
+ /**
2
+ Pure geometry for link labels that follow a curved link: the link's
3
+ centerline as points, trimmed to the edges of its nodes; where a label's
4
+ anchor falls along it; the stretch the label covers, kept upright and
5
+ short of tight turns; the path its text follows, which puts the glyphs'
6
+ middles on the centerline; and the stretch its pad covers.
7
+ */
8
+ import type { Pt } from "./pathLabelGeometry.js";
9
+ /** The most a label's stretch turns, in radians: past this, it is cut short. */
10
+ export declare const LINK_LABEL_MAX_TURN: number;
11
+ /** A stretch that turns less than this (radians) takes a straight label. */
12
+ export declare const LINK_LABEL_STRAIGHT_TURN = 0.03;
13
+ /** The tightest a label's stretch may bend, as a radius in ems: a stretch is cut short of tighter bends. */
14
+ export declare const LINK_LABEL_MIN_RADIUS = 2;
15
+ /**
16
+ A path's `d` as points, its curves flattened.
17
+ @param d The path.
18
+ */
19
+ export declare function curvePoints(d: string): Pt[];
20
+ /**
21
+ The part of a polyline outside circles of radius `r0` around its first
22
+ point and `r1` around its last: a link's run between the edges of its
23
+ nodes. Empty when the circles cover it.
24
+ @param points The polyline.
25
+ @param r0 The radius around its first point.
26
+ @param r1 The radius around its last point.
27
+ */
28
+ export declare function trimToNodes(points: Pt[], r0?: number, r1?: number): Pt[];
29
+ /**
30
+ How far along a polyline its point nearest `p` lies.
31
+ @param points The polyline.
32
+ @param p The point.
33
+ */
34
+ export declare function distanceAlong(points: Pt[], p: Pt): number;
35
+ /**
36
+ The most a polyline turns along any `span` pixels of it, in radians: a
37
+ circle of radius `r` turns `span / r`.
38
+ @param points The polyline.
39
+ @param span The length of the stretches measured.
40
+ */
41
+ export declare function sharpestTurn(points: Pt[], span: number): number;
42
+ /**
43
+ The stretch of a polyline a label covers: `length` pixels long (or the
44
+ whole polyline when it is shorter), centered `at` pixels along it as
45
+ near as its ends allow, and shortened until it turns no more than
46
+ `maxTurn` in all, and bends no tighter than a circle of `minRadius`.
47
+ Upright: it runs left to right, or bottom to top when it runs straight
48
+ up or down (see `uprightPoints`).
49
+ @param points The polyline.
50
+ @param at Where the stretch's middle goes, along the polyline.
51
+ @param length The stretch's length.
52
+ @param maxTurn The most the stretch may turn, in radians.
53
+ @param minRadius The tightest bend the stretch may hold, in pixels.
54
+ */
55
+ export declare function labelStretch(points: Pt[], at: number, length: number, maxTurn?: number, minRadius?: number): Pt[];
56
+ /** Where a curved label goes: its centerline stretch and the points its text follows. */
57
+ export interface CurvedLabelSpot {
58
+ /** The centerline stretch the label covers, pad included, upright. */
59
+ stretch: Pt[];
60
+ /** The path its text follows: the stretch less the pad at each end, its baseline dropped so the glyphs' middles sit on the centerline. */
61
+ text: Pt[];
62
+ }
63
+ /**
64
+ Where a label follows a curved link, or null when the stretch it would
65
+ cover runs straight (a straight label reads the same there) or the link
66
+ bends too tightly around the label's spot for a few letters to follow
67
+ it (a small self-loop).
68
+ @param path The link's centerline.
69
+ @param at Where the label's middle goes, along the centerline.
70
+ @param textWidth The text's width.
71
+ @param fontSize The font size.
72
+ @param pad The pad around the text.
73
+ @param minRadius The tightest bend the label follows, in ems.
74
+ */
75
+ export declare function curvedLabelSpot(path: Pt[], at: number, textWidth: number, fontSize: number, pad: number, minRadius?: number): CurvedLabelSpot | null;
76
+ /**
77
+ The centerline stretch a curved label's pad covers: its text, centered
78
+ on the stretch, and `pad` past each end. The text's width along its
79
+ baseline is scaled to the centerline, which runs longer outside a bend
80
+ and shorter inside one.
81
+ @param spot The label's spot.
82
+ @param textWidth The width of the text drawn.
83
+ @param pad The pad around the text.
84
+ */
85
+ export declare function curvedLabelPad(spot: CurvedLabelSpot, textWidth: number, pad: number): Pt[];