@d3plus/core 4.9.0 → 4.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (687) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +170 -9
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +170 -0
  9. package/es/src/charts/Alluvial/layout.js +137 -0
  10. package/es/src/charts/Alluvial/meta.js +57 -0
  11. package/es/src/charts/Alluvial/titles.js +81 -0
  12. package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
  13. package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
  14. package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
  15. package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
  16. package/es/src/charts/ArcDiagram/emit.js +178 -0
  17. package/es/src/charts/ArcDiagram/events.js +144 -0
  18. package/es/src/charts/ArcDiagram/index.js +215 -0
  19. package/es/src/charts/BarChart/index.js +14 -2
  20. package/es/src/charts/BoxWhisker/index.js +95 -4
  21. package/es/src/charts/BoxWhisker/outliers.js +68 -0
  22. package/es/src/charts/BoxWhisker/summary.js +83 -0
  23. package/es/src/charts/BoxWhisker/tooltip.js +122 -0
  24. package/es/src/charts/BubbleChart/emit.js +31 -0
  25. package/es/src/charts/BubbleChart/index.js +54 -0
  26. package/es/src/charts/Bullet/index.js +2 -1
  27. package/es/src/charts/BumpChart/index.js +5 -0
  28. package/es/src/charts/Calendar/emit.js +1 -1
  29. package/es/src/charts/Calendar/index.js +5 -3
  30. package/es/src/charts/Candlestick/aggregate.js +11 -1
  31. package/es/src/charts/Candlestick/buffer.js +6 -4
  32. package/es/src/charts/Candlestick/index.js +7 -6
  33. package/es/src/charts/Chord/applyLayout.js +56 -69
  34. package/es/src/charts/Chord/emit.js +55 -24
  35. package/es/src/charts/Chord/index.js +17 -12
  36. package/es/src/charts/Chord/labels.js +105 -0
  37. package/es/src/charts/Donut/index.js +5 -11
  38. package/es/src/charts/Dumbbell/index.js +2 -4
  39. package/es/src/charts/Funnel/index.js +2 -1
  40. package/es/src/charts/Gantt/applyLayout.js +162 -0
  41. package/es/src/charts/Gantt/emit.js +142 -0
  42. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  43. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  44. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  45. package/es/src/charts/Gantt/ganttRows.js +111 -0
  46. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  47. package/es/src/charts/Gantt/index.js +219 -0
  48. package/es/src/charts/Gauge/index.js +2 -1
  49. package/es/src/charts/Geomap/applyLayout.js +90 -49
  50. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  51. package/es/src/charts/Geomap/emit.js +19 -2
  52. package/es/src/charts/Geomap/flowEmit.js +132 -0
  53. package/es/src/charts/Geomap/flowEvents.js +86 -0
  54. package/es/src/charts/Geomap/flowFields.js +91 -0
  55. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  56. package/es/src/charts/Geomap/flowLinks.js +239 -0
  57. package/es/src/charts/Geomap/geoCache.js +180 -0
  58. package/es/src/charts/Geomap/globeKeys.js +131 -0
  59. package/es/src/charts/Geomap/globeRotate.js +208 -0
  60. package/es/src/charts/Geomap/index.js +60 -19
  61. package/es/src/charts/Geomap/pointLabels.js +107 -0
  62. package/es/src/charts/Hexbin/binning.js +103 -0
  63. package/es/src/charts/Hexbin/buffer.js +33 -0
  64. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  65. package/es/src/charts/Hexbin/contours.js +48 -0
  66. package/es/src/charts/Hexbin/emit.js +142 -0
  67. package/es/src/charts/Hexbin/index.js +204 -0
  68. package/es/src/charts/Hexbin/layers.js +212 -0
  69. package/es/src/charts/Hexbin/settings.js +86 -0
  70. package/es/src/charts/Hexbin/tooltip.js +77 -0
  71. package/es/src/charts/Histogram/binData.js +31 -4
  72. package/es/src/charts/Histogram/index.js +37 -16
  73. package/es/src/charts/Histogram/labels.js +18 -0
  74. package/es/src/charts/Icicle/index.js +3 -3
  75. package/es/src/charts/LinePlot/index.js +7 -0
  76. package/es/src/charts/Marimekko/index.js +7 -4
  77. package/es/src/charts/Matrix/index.js +3 -2
  78. package/es/src/charts/Network/applyLayout.js +138 -94
  79. package/es/src/charts/Network/bundle.js +81 -0
  80. package/es/src/charts/Network/clusterLabels.js +423 -0
  81. package/es/src/charts/Network/clusters.js +290 -0
  82. package/es/src/charts/Network/emit.js +253 -70
  83. package/es/src/charts/Network/graph.js +117 -0
  84. package/es/src/charts/Network/graphFluent.js +79 -0
  85. package/es/src/charts/Network/index.js +93 -108
  86. package/es/src/charts/Network/minNodeDistance.js +64 -0
  87. package/es/src/charts/Network/polygonRows.js +44 -0
  88. package/es/src/charts/Pack/index.js +7 -2
  89. package/es/src/charts/Pie/applyLayout.js +86 -27
  90. package/es/src/charts/Pie/arcFit.js +152 -0
  91. package/es/src/charts/Pie/curvedLabels.js +134 -0
  92. package/es/src/charts/Pie/emit.js +43 -96
  93. package/es/src/charts/Pie/index.js +66 -32
  94. package/es/src/charts/Pie/labelRoom.js +154 -0
  95. package/es/src/charts/Pie/outsideLabels.js +224 -0
  96. package/es/src/charts/Pie/outsideNodes.js +267 -0
  97. package/es/src/charts/Pie/pieLabels.js +137 -0
  98. package/es/src/charts/Pie/sectorBox.js +223 -0
  99. package/es/src/charts/Pie/straightLabels.js +96 -0
  100. package/es/src/charts/Pie/straightLayout.js +215 -0
  101. package/es/src/charts/Plot/alongLegend.js +76 -0
  102. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  103. package/es/src/charts/Plot/axisHover.js +180 -0
  104. package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
  105. package/es/src/charts/Plot/axisHoverScene.js +203 -0
  106. package/es/src/charts/Plot/axisValues.js +43 -0
  107. package/es/src/charts/Plot/barHitArea.js +81 -0
  108. package/es/src/charts/Plot/barLabelFit.js +123 -0
  109. package/es/src/charts/Plot/barWidth.js +61 -13
  110. package/es/src/charts/Plot/circleLabels.js +98 -0
  111. package/es/src/charts/Plot/confidenceConfig.js +2 -2
  112. package/es/src/charts/Plot/connectGaps.js +237 -0
  113. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  114. package/es/src/charts/Plot/draw.js +14 -4
  115. package/es/src/charts/Plot/fillBetween.js +2 -1
  116. package/es/src/charts/Plot/forecastScene.js +3 -4
  117. package/es/src/charts/Plot/index.js +42 -15
  118. package/es/src/charts/Plot/labelPlacement.js +10 -2
  119. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  120. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  121. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  122. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  123. package/es/src/charts/Plot/openDomainEnds.js +2 -5
  124. package/es/src/charts/Plot/pipeline.js +71 -22
  125. package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
  126. package/es/src/charts/Plot/pipelineDomains.js +23 -6
  127. package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
  128. package/es/src/charts/Plot/pipelineScales.js +40 -8
  129. package/es/src/charts/Plot/plotFacet.js +12 -1
  130. package/es/src/charts/Plot/plotInit.js +49 -5
  131. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  132. package/es/src/charts/Plot/plotZoom.js +15 -6
  133. package/es/src/charts/Plot/referenceDomains.js +133 -0
  134. package/es/src/charts/Plot/shapeDefaults.js +14 -9
  135. package/es/src/charts/Plot/sharedHoverScene.js +50 -31
  136. package/es/src/charts/Plot/sharedTooltip.js +19 -7
  137. package/es/src/charts/Plot/stackHelpers.js +13 -1
  138. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  139. package/es/src/charts/Plot/stackShareTooltip.js +9 -4
  140. package/es/src/charts/Plot/stackThreshold.js +154 -0
  141. package/es/src/charts/Plot/trendLabels.js +183 -0
  142. package/es/src/charts/Plot/trendLines.js +1 -0
  143. package/es/src/charts/Plot/trendScene.js +6 -3
  144. package/es/src/charts/Plot/trendTooltip.js +5 -1
  145. package/es/src/charts/PolarArea/index.js +5 -4
  146. package/es/src/charts/Priestley/applyLayout.js +14 -20
  147. package/es/src/charts/Priestley/index.js +4 -34
  148. package/es/src/charts/Priestley/timeAxis.js +100 -0
  149. package/es/src/charts/Pyramid/index.js +4 -2
  150. package/es/src/charts/Radar/axisDecorations.js +49 -12
  151. package/es/src/charts/Radar/curvedLabels.js +187 -0
  152. package/es/src/charts/Radar/index.js +5 -5
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +4 -1
  155. package/es/src/charts/RadialBar/index.js +18 -10
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/index.js +6 -9
  158. package/es/src/charts/Rings/applyLayout.js +41 -24
  159. package/es/src/charts/Rings/emit.js +174 -58
  160. package/es/src/charts/Rings/index.js +65 -30
  161. package/es/src/charts/Rings/ringsGraph.js +28 -9
  162. package/es/src/charts/Rings/ringsLoops.js +73 -0
  163. package/es/src/charts/Rings/ringsParallel.js +166 -0
  164. package/es/src/charts/Sankey/applyLayout.js +116 -39
  165. package/es/src/charts/Sankey/circularLayout.js +208 -0
  166. package/es/src/charts/Sankey/circularLinks.js +301 -0
  167. package/es/src/charts/Sankey/emit.js +164 -94
  168. package/es/src/charts/Sankey/index.js +75 -77
  169. package/es/src/charts/Sankey/labels.js +80 -0
  170. package/es/src/charts/Sankey/ribbons.js +88 -0
  171. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  172. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  173. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  174. package/es/src/charts/Scatter/index.js +25 -0
  175. package/es/src/charts/SlopeChart/index.js +116 -0
  176. package/es/src/charts/SlopeChart/slope.js +95 -0
  177. package/es/src/charts/Streamgraph/index.js +51 -0
  178. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  179. package/es/src/charts/Sunburst/emit.js +74 -63
  180. package/es/src/charts/Sunburst/index.js +3 -3
  181. package/es/src/charts/Tree/index.js +2 -6
  182. package/es/src/charts/Treemap/applyLayout.js +14 -1
  183. package/es/src/charts/Treemap/emit.js +8 -2
  184. package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
  185. package/es/src/charts/Treemap/groupHeaders.js +95 -0
  186. package/es/src/charts/Treemap/index.js +17 -7
  187. package/es/src/charts/Treemap/thresholdFunction.js +11 -9
  188. package/es/src/charts/Violin/inner.js +3 -5
  189. package/es/src/charts/Waffle/index.js +4 -2
  190. package/es/src/charts/Waffle/tooltip.js +6 -2
  191. package/es/src/charts/Waterfall/index.js +4 -2
  192. package/es/src/charts/definition/makeChart.js +20 -5
  193. package/es/src/charts/drawSteps/backControl.js +17 -5
  194. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  195. package/es/src/charts/drawSteps/minimap.js +6 -5
  196. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  197. package/es/src/charts/drawSteps/saveChart.js +176 -0
  198. package/es/src/charts/drawSteps/saveControl.js +148 -0
  199. package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
  200. package/es/src/charts/drawSteps/searchControls.js +2 -1
  201. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  202. package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
  203. package/es/src/charts/drawSteps/topLeftControls.js +3 -1
  204. package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
  205. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  206. package/es/src/charts/events/click.legend.js +7 -2
  207. package/es/src/charts/events/click.shape.js +38 -2
  208. package/es/src/charts/events/mouseenter.js +9 -0
  209. package/es/src/charts/events/mousemove.legend.js +3 -0
  210. package/es/src/charts/events/mousemove.shape.js +12 -4
  211. package/es/src/charts/facet/drawFacets.js +14 -5
  212. package/es/src/charts/facet/facetConfig.js +2 -2
  213. package/es/src/charts/facet/facetData.js +2 -2
  214. package/es/src/charts/features/annotationFrame.js +179 -0
  215. package/es/src/charts/features/annotationText.js +83 -0
  216. package/es/src/charts/features/annotationTypes.js +10 -0
  217. package/es/src/charts/features/attributionFeature.js +6 -11
  218. package/es/src/charts/features/axes.js +9 -7
  219. package/es/src/charts/features/axesFinal.js +26 -4
  220. package/es/src/charts/features/axesMeasure.js +61 -6
  221. package/es/src/charts/features/calloutLayout.js +121 -0
  222. package/es/src/charts/features/calloutScene.js +155 -0
  223. package/es/src/charts/features/chartGeometry.js +1 -1
  224. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  225. package/es/src/charts/features/circleLabels.js +207 -0
  226. package/es/src/charts/features/colorScaleBucket.js +19 -1
  227. package/es/src/charts/features/colorScaleHover.js +70 -0
  228. package/es/src/charts/features/colorScaleValue.js +97 -0
  229. package/es/src/charts/features/curvedArrows.js +158 -0
  230. package/es/src/charts/features/edgeArrows.js +160 -4
  231. package/es/src/charts/features/edgeBundling.js +442 -0
  232. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  233. package/es/src/charts/features/ensureZoomDom.js +32 -8
  234. package/es/src/charts/features/features.js +45 -15
  235. package/es/src/charts/features/featuresColorScale.js +62 -8
  236. package/es/src/charts/features/featuresLegend.js +21 -32
  237. package/es/src/charts/features/legendKeys.js +64 -0
  238. package/es/src/charts/features/lineLabels.js +55 -46
  239. package/es/src/charts/features/linkBundle.js +19 -0
  240. package/es/src/charts/features/linkColor.js +72 -0
  241. package/es/src/charts/features/linkFields.js +86 -0
  242. package/es/src/charts/features/linkFocus.js +118 -0
  243. package/es/src/charts/features/linkInteraction.js +312 -0
  244. package/es/src/charts/features/linkKeys.js +20 -0
  245. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  246. package/es/src/charts/features/linkLabelPath.js +162 -0
  247. package/es/src/charts/features/linkLabels.js +340 -0
  248. package/es/src/charts/features/linkWidths.js +32 -0
  249. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  250. package/es/src/charts/features/pathLabels.js +50 -0
  251. package/es/src/charts/features/plotAnnotations.js +68 -17
  252. package/es/src/charts/features/plotPaint.js +42 -15
  253. package/es/src/charts/features/polyline.js +129 -0
  254. package/es/src/charts/features/referenceAnnotations.js +403 -0
  255. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  256. package/es/src/charts/features/ringLabelNodes.js +93 -0
  257. package/es/src/charts/features/ringLabels.js +222 -0
  258. package/es/src/charts/features/sceneBounds.js +26 -6
  259. package/es/src/charts/features/selfLoops.js +306 -0
  260. package/es/src/charts/features/shapeEmit.js +67 -30
  261. package/es/src/charts/features/shareKey.js +15 -0
  262. package/es/src/charts/features/sharedFields.js +15 -2
  263. package/es/src/charts/features/textHalo.js +29 -0
  264. package/es/src/charts/features/thresholdMembers.js +71 -0
  265. package/es/src/charts/helpers/densityChart.js +3 -1
  266. package/es/src/charts/helpers/valueTitle.js +6 -3
  267. package/es/src/charts/index.js +8 -0
  268. package/es/src/charts/partition/chartFields.js +6 -5
  269. package/es/src/charts/partition/hierarchy.js +2 -0
  270. package/es/src/charts/partition/interaction.js +9 -5
  271. package/es/src/charts/partition/zoom.js +7 -6
  272. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  273. package/es/src/charts/pipeline/preDrawData.js +77 -13
  274. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  275. package/es/src/charts/pipeline/vizDraw.js +40 -29
  276. package/es/src/charts/pipeline/vizPreDraw.js +29 -18
  277. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  278. package/es/src/charts/polar/config.js +2 -3
  279. package/es/src/charts/viz/Viz.js +82 -44
  280. package/es/src/charts/viz/VizBase.js +47 -19
  281. package/es/src/charts/viz/backgroundInk.js +13 -7
  282. package/es/src/charts/viz/dataPoller.js +52 -0
  283. package/es/src/charts/viz/focusRing.js +104 -0
  284. package/es/src/charts/viz/focusTargets.js +208 -0
  285. package/es/src/charts/viz/groupRow.js +35 -0
  286. package/es/src/charts/viz/history.js +74 -0
  287. package/es/src/charts/viz/interactionOpacity.js +19 -5
  288. package/es/src/charts/viz/keyboardNav.js +297 -0
  289. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  290. package/es/src/charts/viz/loaderFormat.js +114 -0
  291. package/es/src/charts/viz/missingFields.js +123 -0
  292. package/es/src/charts/viz/mountTarget.js +9 -0
  293. package/es/src/charts/viz/nearestHover.js +183 -0
  294. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  295. package/es/src/charts/viz/ordinalColor.js +14 -12
  296. package/es/src/charts/viz/pageTheme.js +83 -0
  297. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  298. package/es/src/charts/viz/pointVoronoi.js +124 -0
  299. package/es/src/charts/viz/reducedMotion.js +27 -0
  300. package/es/src/charts/viz/reportHandlerError.js +10 -0
  301. package/es/src/charts/viz/shapeClassTargets.js +18 -2
  302. package/es/src/charts/viz/simpleHover.js +2 -0
  303. package/es/src/charts/viz/vizClassName.js +31 -0
  304. package/es/src/charts/viz/vizDataPolling.js +172 -0
  305. package/es/src/charts/viz/vizDefaults.js +81 -23
  306. package/es/src/charts/viz/vizFields.js +53 -2
  307. package/es/src/charts/viz/vizRender.js +49 -28
  308. package/es/src/charts/viz/vizTheme.js +96 -0
  309. package/es/src/charts/viz/vizVisibility.js +14 -0
  310. package/es/src/components/Axis/Axis.js +34 -0
  311. package/es/src/components/Axis/AxisBottom.js +1 -0
  312. package/es/src/components/Axis/AxisLeft.js +1 -0
  313. package/es/src/components/Axis/AxisRight.js +1 -0
  314. package/es/src/components/Axis/AxisTop.js +1 -0
  315. package/es/src/components/Axis/axisBreak.js +4 -1
  316. package/es/src/components/Axis/axisDefaults.js +8 -10
  317. package/es/src/components/Axis/axisLabelAngle.js +175 -0
  318. package/es/src/components/Axis/axisLabelThinning.js +13 -4
  319. package/es/src/components/Axis/axisLayout.js +86 -19
  320. package/es/src/components/Axis/axisLayoutLabels.js +66 -13
  321. package/es/src/components/Axis/axisLayoutScale.js +10 -1
  322. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  323. package/es/src/components/Axis/axisRender.js +38 -9
  324. package/es/src/components/Axis/axisRounding.js +15 -4
  325. package/es/src/components/Axis/axisSlantWrap.js +39 -0
  326. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  327. package/es/src/components/Axis/powTicks.js +73 -0
  328. package/es/src/components/Axis/rangeBreaks.js +201 -0
  329. package/es/src/components/Axis/timeValues.js +19 -4
  330. package/es/src/components/ColorScale/ColorScale.js +42 -36
  331. package/es/src/components/ColorScale/bucketBounds.js +64 -0
  332. package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
  333. package/es/src/components/ColorScale/colorScaleRender.js +25 -1
  334. package/es/src/components/ColorScale/colorScaleScale.js +43 -24
  335. package/es/src/components/ColorScale/colorScaleType.js +26 -0
  336. package/es/src/components/Legend/Legend.js +3 -0
  337. package/es/src/components/Legend/legendConfig.js +2 -6
  338. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  339. package/es/src/components/TextBox.js +31 -65
  340. package/es/src/components/Timeline/Timeline.js +54 -54
  341. package/es/src/components/Timeline/brushSpan.js +78 -0
  342. package/es/src/components/Timeline/timelineConfig.js +27 -10
  343. package/es/src/components/Timeline/timelineMode.js +26 -0
  344. package/es/src/components/Timeline/timelineRender.js +51 -9
  345. package/es/src/components/Tooltip.js +28 -13
  346. package/es/src/components/fontStack.js +20 -0
  347. package/es/src/components/textBoxLayout.js +58 -21
  348. package/es/src/components/textBoxPath.js +73 -0
  349. package/es/src/components/textBoxScene.js +223 -0
  350. package/es/src/components/textBoxWords.js +70 -0
  351. package/es/src/shapes/Area.js +1 -0
  352. package/es/src/shapes/Bar.js +1 -0
  353. package/es/src/shapes/Box.js +67 -79
  354. package/es/src/shapes/Circle.js +1 -0
  355. package/es/src/shapes/Line.js +1 -0
  356. package/es/src/shapes/Path.js +1 -0
  357. package/es/src/shapes/Rect.js +1 -0
  358. package/es/src/shapes/Shape.js +1 -0
  359. package/es/src/shapes/Whisker.js +1 -0
  360. package/es/src/shapes/boxOutlierShape.js +19 -0
  361. package/es/src/shapes/boxStats.js +35 -0
  362. package/es/src/shapes/boxStyle.js +78 -0
  363. package/es/src/shapes/boxSummary.js +174 -0
  364. package/es/src/shapes/shapeStandalone.js +2 -0
  365. package/es/src/utils/BaseClass.js +44 -12
  366. package/es/src/utils/className.js +78 -0
  367. package/es/src/utils/configPrep.js +2 -1
  368. package/es/src/utils/configWarnings.js +25 -0
  369. package/es/src/utils/constant.js +13 -1
  370. package/es/src/utils/displayName.js +12 -0
  371. package/es/src/utils/fieldAccessor.js +31 -0
  372. package/es/src/utils/paintComponentScene.js +2 -0
  373. package/es/src/utils/theme.js +190 -0
  374. package/es/src/utils/themeInk.js +68 -0
  375. package/package.json +14 -10
  376. package/types/index.d.ts +8 -2
  377. package/types/internal.d.ts +253 -9
  378. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  379. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  380. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  381. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  382. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  383. package/types/src/charts/Alluvial/index.d.ts +27 -0
  384. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  385. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  386. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  387. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  388. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  389. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  390. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  391. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  392. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  393. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  394. package/types/src/charts/BoxWhisker/index.d.ts +3 -1
  395. package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
  396. package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
  397. package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
  398. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  399. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  400. package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
  401. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  402. package/types/src/charts/Chord/labels.d.ts +66 -0
  403. package/types/src/charts/Donut/index.d.ts +2 -1
  404. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  405. package/types/src/charts/Gantt/emit.d.ts +17 -0
  406. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  407. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  408. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  409. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  410. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  411. package/types/src/charts/Gantt/index.d.ts +36 -0
  412. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  413. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  414. package/types/src/charts/Geomap/emit.d.ts +2 -2
  415. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  416. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  417. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  418. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  419. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  420. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  421. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  422. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  423. package/types/src/charts/Geomap/index.d.ts +3 -0
  424. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  425. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  426. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  427. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  428. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  429. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  430. package/types/src/charts/Hexbin/index.d.ts +25 -0
  431. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  432. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  433. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  434. package/types/src/charts/Histogram/binData.d.ts +20 -1
  435. package/types/src/charts/Histogram/index.d.ts +3 -2
  436. package/types/src/charts/Histogram/labels.d.ts +7 -0
  437. package/types/src/charts/Marimekko/index.d.ts +2 -1
  438. package/types/src/charts/Network/bundle.d.ts +67 -0
  439. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  440. package/types/src/charts/Network/clusters.d.ts +115 -0
  441. package/types/src/charts/Network/graph.d.ts +65 -0
  442. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  443. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  444. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  445. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  446. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  447. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  448. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  449. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  450. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  451. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  452. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  453. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  454. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  455. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  456. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  457. package/types/src/charts/Plot/axisHover.d.ts +68 -0
  458. package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
  459. package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
  460. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  461. package/types/src/charts/Plot/barHitArea.d.ts +59 -0
  462. package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
  463. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  464. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  465. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  466. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  467. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  468. package/types/src/charts/Plot/index.d.ts +28 -8
  469. package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
  470. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  471. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  472. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  473. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  474. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  475. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  476. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  477. package/types/src/charts/Plot/plotInit.d.ts +23 -2
  478. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  479. package/types/src/charts/Plot/plotZoom.d.ts +2 -0
  480. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  481. package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
  482. package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
  483. package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
  484. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  485. package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
  486. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  487. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  488. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  489. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  490. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  491. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  492. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  493. package/types/src/charts/Rings/emit.d.ts +50 -0
  494. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  495. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  496. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  497. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  498. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  499. package/types/src/charts/Sankey/emit.d.ts +58 -0
  500. package/types/src/charts/Sankey/labels.d.ts +19 -0
  501. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  502. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  503. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  504. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  505. package/types/src/charts/Scatter/index.d.ts +15 -0
  506. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  507. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  508. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  509. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  510. package/types/src/charts/Treemap/emit.d.ts +2 -1
  511. package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
  512. package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
  513. package/types/src/charts/Treemap/index.d.ts +2 -0
  514. package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
  515. package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
  516. package/types/src/charts/definition/makeChart.d.ts +5 -3
  517. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  518. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  519. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  520. package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
  521. package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
  522. package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
  523. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
  524. package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
  525. package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
  526. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  527. package/types/src/charts/events/click.legend.d.ts +2 -1
  528. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  529. package/types/src/charts/facet/facetData.d.ts +1 -1
  530. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  531. package/types/src/charts/features/annotationText.d.ts +57 -0
  532. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  533. package/types/src/charts/features/axesMeasure.d.ts +13 -1
  534. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  535. package/types/src/charts/features/calloutScene.d.ts +40 -0
  536. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  537. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  538. package/types/src/charts/features/circleLabels.d.ts +130 -0
  539. package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
  540. package/types/src/charts/features/colorScaleHover.d.ts +32 -0
  541. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  542. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  543. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  544. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  545. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  546. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  547. package/types/src/charts/features/features.d.ts +8 -0
  548. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  549. package/types/src/charts/features/legendKeys.d.ts +34 -0
  550. package/types/src/charts/features/lineLabels.d.ts +15 -12
  551. package/types/src/charts/features/linkBundle.d.ts +16 -0
  552. package/types/src/charts/features/linkColor.d.ts +48 -0
  553. package/types/src/charts/features/linkFields.d.ts +16 -0
  554. package/types/src/charts/features/linkFocus.d.ts +51 -0
  555. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  556. package/types/src/charts/features/linkKeys.d.ts +11 -0
  557. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  558. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  559. package/types/src/charts/features/linkLabels.d.ts +77 -0
  560. package/types/src/charts/features/linkWidths.d.ts +19 -0
  561. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  562. package/types/src/charts/features/pathLabels.d.ts +41 -0
  563. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  564. package/types/src/charts/features/plotPaint.d.ts +19 -0
  565. package/types/src/charts/features/polyline.d.ts +32 -0
  566. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  567. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  568. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  569. package/types/src/charts/features/ringLabels.d.ts +164 -0
  570. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  571. package/types/src/charts/features/selfLoops.d.ts +165 -0
  572. package/types/src/charts/features/shapeEmit.d.ts +5 -1
  573. package/types/src/charts/features/shareKey.d.ts +9 -0
  574. package/types/src/charts/features/sharedFields.d.ts +11 -2
  575. package/types/src/charts/features/textHalo.d.ts +14 -0
  576. package/types/src/charts/features/thresholdMembers.d.ts +38 -0
  577. package/types/src/charts/helpers/valueTitle.d.ts +4 -2
  578. package/types/src/charts/index.d.ts +8 -0
  579. package/types/src/charts/partition/interaction.d.ts +6 -3
  580. package/types/src/charts/partition/zoom.d.ts +4 -4
  581. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  582. package/types/src/charts/pipeline/stages.d.ts +9 -0
  583. package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
  584. package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
  585. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  586. package/types/src/charts/viz/Viz.d.ts +44 -6
  587. package/types/src/charts/viz/VizBase.d.ts +16 -7
  588. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  589. package/types/src/charts/viz/dataPoller.d.ts +28 -0
  590. package/types/src/charts/viz/focusRing.d.ts +25 -0
  591. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  592. package/types/src/charts/viz/groupRow.d.ts +24 -0
  593. package/types/src/charts/viz/history.d.ts +35 -0
  594. package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
  595. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  596. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  597. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  598. package/types/src/charts/viz/missingFields.d.ts +57 -0
  599. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  600. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  601. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  602. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  603. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  604. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  605. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  606. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  607. package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
  608. package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
  609. package/types/src/charts/viz/simpleHover.d.ts +2 -1
  610. package/types/src/charts/viz/vizClassName.d.ts +23 -0
  611. package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
  612. package/types/src/charts/viz/vizDefaults.d.ts +49 -9
  613. package/types/src/charts/viz/vizFields.d.ts +47 -0
  614. package/types/src/charts/viz/vizRender.d.ts +2 -1
  615. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  616. package/types/src/charts/viz/vizTypes.d.ts +117 -8
  617. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  618. package/types/src/components/Axis/Axis.d.ts +37 -8
  619. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  620. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  621. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  622. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  623. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  624. package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
  625. package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
  626. package/types/src/components/Axis/axisLayout.d.ts +5 -0
  627. package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
  628. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  629. package/types/src/components/Axis/axisRounding.d.ts +6 -3
  630. package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
  631. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  632. package/types/src/components/Axis/powTicks.d.ts +29 -0
  633. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  634. package/types/src/components/Axis/timeValues.d.ts +1 -1
  635. package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
  636. package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
  637. package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
  638. package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
  639. package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
  640. package/types/src/components/Legend/Legend.d.ts +1 -0
  641. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  642. package/types/src/components/TextBox.d.ts +1 -0
  643. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  644. package/types/src/components/Timeline/brushSpan.d.ts +41 -0
  645. package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
  646. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  647. package/types/src/components/Timeline/timelineRender.d.ts +8 -0
  648. package/types/src/components/Tooltip.d.ts +12 -3
  649. package/types/src/components/fontStack.d.ts +10 -0
  650. package/types/src/components/textBoxLayout.d.ts +18 -9
  651. package/types/src/components/textBoxPath.d.ts +59 -0
  652. package/types/src/components/textBoxScene.d.ts +51 -0
  653. package/types/src/components/textBoxWords.d.ts +33 -0
  654. package/types/src/shapes/Area.d.ts +1 -0
  655. package/types/src/shapes/Bar.d.ts +1 -0
  656. package/types/src/shapes/Box.d.ts +2 -8
  657. package/types/src/shapes/Circle.d.ts +1 -0
  658. package/types/src/shapes/Line.d.ts +1 -0
  659. package/types/src/shapes/Path.d.ts +1 -0
  660. package/types/src/shapes/Rect.d.ts +1 -0
  661. package/types/src/shapes/Shape.d.ts +1 -0
  662. package/types/src/shapes/Whisker.d.ts +1 -0
  663. package/types/src/shapes/boxOutlierShape.d.ts +9 -0
  664. package/types/src/shapes/boxStats.d.ts +19 -0
  665. package/types/src/shapes/boxStyle.d.ts +25 -0
  666. package/types/src/shapes/boxSummary.d.ts +66 -0
  667. package/types/src/shapes/emitLabels.d.ts +1 -1
  668. package/types/src/shapes/shapeConfig.d.ts +42 -4
  669. package/types/src/utils/BaseClass.d.ts +32 -0
  670. package/types/src/utils/D3Scale.d.ts +3 -0
  671. package/types/src/utils/D3plusConfig.d.ts +1240 -33
  672. package/types/src/utils/className.d.ts +64 -0
  673. package/types/src/utils/configPrep.d.ts +2 -0
  674. package/types/src/utils/configWarnings.d.ts +21 -2
  675. package/types/src/utils/constant.d.ts +8 -0
  676. package/types/src/utils/displayName.d.ts +10 -0
  677. package/types/src/utils/fieldAccessor.d.ts +24 -0
  678. package/types/src/utils/index.d.ts +1 -1
  679. package/types/src/utils/paintComponentScene.d.ts +3 -1
  680. package/types/src/utils/theme.d.ts +170 -0
  681. package/types/src/utils/themeInk.d.ts +56 -0
  682. package/umd/d3plus-core.full.js +87388 -56271
  683. package/umd/d3plus-core.full.min.js +2 -2
  684. package/umd/d3plus-core.js +37988 -11768
  685. package/umd/d3plus-core.min.js +2 -2
  686. package/es/src/components/Axis/gridStroke.js +0 -10
  687. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -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[];
@@ -0,0 +1,77 @@
1
+ /**
2
+ `linkLabel` on the node-link charts: a line of text at the middle of each
3
+ link, along it or level, on a pad of the chart's background so it reads
4
+ over the links. Along a curved link, the text and its pad follow the
5
+ curve. Labels that would cover a node or another label are left out, the
6
+ most prominent links' first. Labels are inert to the pointer and
7
+ keyboard, and dim with their link on hover.
8
+ */
9
+ import type { SceneNode } from "@d3plus/render";
10
+ import type { VizInstance } from "../viz/vizTypes.js";
11
+ import type { LabelObstacles, LinkAnchor, LinkLabelBox } from "./linkLabelGeometry.js";
12
+ import type { Pt } from "./pathLabelGeometry.js";
13
+ /** `linkLabelConfig`'s defaults. */
14
+ export declare const LINK_LABEL_DEFAULTS: {
15
+ rotate: string;
16
+ fontSize: number;
17
+ padding: number;
18
+ backgroundOpacity: number;
19
+ minRadius: number;
20
+ };
21
+ /** The resolved `linkLabelConfig`. */
22
+ export interface LinkLabelSettings {
23
+ /** `"along"` runs text along its link (kept upright); `"horizontal"` keeps it level. */
24
+ rotate: "along" | "horizontal";
25
+ fontSize: number;
26
+ /** The pad around the text, in pixels. */
27
+ padding: number;
28
+ /** The opacity of the background pad. */
29
+ backgroundOpacity: number;
30
+ /** The tightest bend a curved label follows, as a radius in ems. */
31
+ minRadius: number;
32
+ /** The rest, as TextBox config (fontFamily, fontColor, fontWeight, …). */
33
+ text: Record<string, unknown>;
34
+ }
35
+ /** Reads `linkLabelConfig`, with its defaults for anything missing or invalid. */
36
+ export declare function linkLabelSettings(viz: VizInstance): LinkLabelSettings;
37
+ /**
38
+ A `linkLabel` value as text: a number abbreviated in the chart's locale,
39
+ a string as given, and nothing for anything else.
40
+ */
41
+ export declare function linkLabelText(value: unknown, locale?: string): string;
42
+ /**
43
+ The boxes the lines of text scene nodes (such as a chart's node labels)
44
+ cover, each rotated with its node: about a line's glyphs, from 0.8em
45
+ above its baseline to 0.2em below.
46
+ @param nodes Scene nodes; text nodes inside groups are included.
47
+ */
48
+ export declare function textLineBoxes(nodes: readonly SceneNode[]): LinkLabelBox[];
49
+ /** One drawn link a label may go on. */
50
+ export interface LinkLabelRequest {
51
+ /** The link's scene key; the label's is built from it. */
52
+ key: string;
53
+ /** The drawn link's datum, which the label carries so it dims with the link. */
54
+ link: object;
55
+ /** The link's position among the drawn links. */
56
+ i: number;
57
+ /** Where on the link the label goes, or null for nowhere. */
58
+ anchor: LinkAnchor | null;
59
+ /**
60
+ A curved link's centerline, between the edges of its nodes: an
61
+ `"along"` label follows it, centered where `anchor` falls on it (or
62
+ halfway along without one). A straight link needs none.
63
+ */
64
+ path?: Pt[] | null;
65
+ /** Links with a larger priority (such as a wider stroke) get their label first. */
66
+ priority?: number;
67
+ }
68
+ /**
69
+ The labels for the drawn links, as scene nodes: for each link with
70
+ `linkLabel` text that fits, a group at the link's middle, rotated with
71
+ the link unless `linkLabelConfig.rotate` is `"horizontal"`, holding a pad
72
+ in the chart's background and the text in the chart's ink. Along a
73
+ curved link (one with a `path`), the text follows the curve over a pad
74
+ that follows it too.
75
+ @param obstacles The nodes labels stay clear of.
76
+ */
77
+ export declare function emitLinkLabels(viz: VizInstance, requests: readonly LinkLabelRequest[], obstacles: LabelObstacles): SceneNode[];
@@ -0,0 +1,19 @@
1
+ /**
2
+ The stroke widths the node-link charts size their links between when
3
+ `linkSize` values differ.
4
+ */
5
+ /**
6
+ The share of the smallest node's radius the heaviest link is drawn at
7
+ by default: a quarter of the node's width, so links read as weighted
8
+ lines beside their nodes rather than bands as wide as them, and a
9
+ heavy link's arrowhead (1.5× its stroke) stays narrower than the node.
10
+ */
11
+ export declare const LINK_SIZE_SHARE = 0.5;
12
+ /**
13
+ The thinnest and widest link, in pixels, for links whose `linkSize`
14
+ values differ. The thinnest is `sizeMin` (1 when unset). The widest is
15
+ `sizeMax` when set, which also caps the thinnest; otherwise it is half
16
+ the smallest node's radius (`rMin`), and never thinner than the
17
+ thinnest.
18
+ */
19
+ export declare function linkWidthRange(sizeMin: unknown, sizeMax: unknown, rMin: number): [number, number];