@d3plus/core 4.10.0 → 4.12.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 (711) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +178 -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 +176 -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 +101 -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 +192 -0
  17. package/es/src/charts/ArcDiagram/events.js +148 -0
  18. package/es/src/charts/ArcDiagram/index.js +217 -0
  19. package/es/src/charts/BarChart/index.js +12 -7
  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 +5 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +6 -11
  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 +160 -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 +137 -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 +206 -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 +6 -4
  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/Matrix/applyLayout.js +20 -9
  70. package/es/src/charts/Matrix/index.js +19 -1
  71. package/es/src/charts/Network/applyLayout.js +171 -96
  72. package/es/src/charts/Network/bundle.js +82 -0
  73. package/es/src/charts/Network/clusterLabels.js +423 -0
  74. package/es/src/charts/Network/clusters.js +290 -0
  75. package/es/src/charts/Network/emit.js +257 -75
  76. package/es/src/charts/Network/graph.js +146 -0
  77. package/es/src/charts/Network/graphFluent.js +81 -0
  78. package/es/src/charts/Network/index.js +91 -106
  79. package/es/src/charts/Network/minNodeDistance.js +64 -0
  80. package/es/src/charts/Network/polygonRows.js +44 -0
  81. package/es/src/charts/Pack/applyLayout.js +16 -5
  82. package/es/src/charts/Pack/emit.js +15 -8
  83. package/es/src/charts/Pack/groupRows.js +61 -0
  84. package/es/src/charts/Pack/index.js +8 -1
  85. package/es/src/charts/Pack/neutralPaint.js +20 -0
  86. package/es/src/charts/Pack/nodeNames.js +35 -0
  87. package/es/src/charts/ParallelCoordinates/axes.js +22 -22
  88. package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
  89. package/es/src/charts/ParallelCoordinates/index.js +3 -1
  90. package/es/src/charts/ParallelCoordinates/titles.js +17 -9
  91. package/es/src/charts/Pie/applyLayout.js +86 -27
  92. package/es/src/charts/Pie/arcFit.js +152 -0
  93. package/es/src/charts/Pie/curvedLabels.js +134 -0
  94. package/es/src/charts/Pie/emit.js +51 -96
  95. package/es/src/charts/Pie/index.js +74 -31
  96. package/es/src/charts/Pie/labelRoom.js +154 -0
  97. package/es/src/charts/Pie/outsideLabels.js +224 -0
  98. package/es/src/charts/Pie/outsideNodes.js +267 -0
  99. package/es/src/charts/Pie/pieLabels.js +137 -0
  100. package/es/src/charts/Pie/sectorBox.js +223 -0
  101. package/es/src/charts/Pie/straightLabels.js +96 -0
  102. package/es/src/charts/Pie/straightLayout.js +215 -0
  103. package/es/src/charts/Plot/alongLegend.js +76 -0
  104. package/es/src/charts/Plot/areaEnter.js +68 -0
  105. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  106. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  107. package/es/src/charts/Plot/axisValues.js +43 -0
  108. package/es/src/charts/Plot/barWidth.js +59 -11
  109. package/es/src/charts/Plot/circleLabels.js +98 -0
  110. package/es/src/charts/Plot/connectGaps.js +237 -0
  111. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  112. package/es/src/charts/Plot/draw.js +34 -14
  113. package/es/src/charts/Plot/fillBetween.js +2 -1
  114. package/es/src/charts/Plot/forecastScene.js +3 -4
  115. package/es/src/charts/Plot/index.js +19 -17
  116. package/es/src/charts/Plot/labelPlacement.js +1 -1
  117. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  118. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  119. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  120. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  121. package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
  122. package/es/src/charts/Plot/pipeline.js +66 -19
  123. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  124. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  125. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  126. package/es/src/charts/Plot/pipelineScales.js +40 -8
  127. package/es/src/charts/Plot/plotFacet.js +12 -1
  128. package/es/src/charts/Plot/plotInit.js +40 -5
  129. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  130. package/es/src/charts/Plot/referenceDomains.js +133 -0
  131. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  132. package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
  133. package/es/src/charts/Plot/sharedHover.js +2 -1
  134. package/es/src/charts/Plot/sharedTooltip.js +13 -3
  135. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  136. package/es/src/charts/Plot/trendLabels.js +183 -0
  137. package/es/src/charts/Plot/trendLines.js +1 -0
  138. package/es/src/charts/Plot/trendScene.js +6 -3
  139. package/es/src/charts/Plot/trendTooltip.js +5 -1
  140. package/es/src/charts/PolarArea/index.js +4 -3
  141. package/es/src/charts/Priestley/applyLayout.js +21 -23
  142. package/es/src/charts/Priestley/index.js +4 -37
  143. package/es/src/charts/Priestley/timeAxis.js +103 -0
  144. package/es/src/charts/Pyramid/gutter.js +52 -16
  145. package/es/src/charts/Pyramid/index.js +55 -7
  146. package/es/src/charts/Pyramid/scene.js +4 -4
  147. package/es/src/charts/Radar/applyLayout.js +31 -33
  148. package/es/src/charts/Radar/axisDecorations.js +62 -13
  149. package/es/src/charts/Radar/curvedLabels.js +228 -0
  150. package/es/src/charts/Radar/emit.js +30 -15
  151. package/es/src/charts/Radar/index.js +43 -5
  152. package/es/src/charts/Radar/points.js +85 -0
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +9 -1
  155. package/es/src/charts/RadialBar/index.js +26 -9
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
  158. package/es/src/charts/RadialMatrix/index.js +18 -9
  159. package/es/src/charts/Rings/applyLayout.js +39 -161
  160. package/es/src/charts/Rings/emit.js +219 -63
  161. package/es/src/charts/Rings/index.js +88 -32
  162. package/es/src/charts/Rings/ringsCurves.js +156 -0
  163. package/es/src/charts/Rings/ringsGraph.js +28 -9
  164. package/es/src/charts/Rings/ringsLoops.js +73 -0
  165. package/es/src/charts/Rings/ringsParallel.js +183 -0
  166. package/es/src/charts/Rings/ringsPlacement.js +152 -0
  167. package/es/src/charts/Rings/ringsSizing.js +61 -38
  168. package/es/src/charts/Sankey/applyLayout.js +130 -39
  169. package/es/src/charts/Sankey/circularLayout.js +208 -0
  170. package/es/src/charts/Sankey/circularLinks.js +301 -0
  171. package/es/src/charts/Sankey/emit.js +164 -94
  172. package/es/src/charts/Sankey/index.js +78 -75
  173. package/es/src/charts/Sankey/labels.js +80 -0
  174. package/es/src/charts/Sankey/ribbons.js +88 -0
  175. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  176. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  177. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  178. package/es/src/charts/Scatter/index.js +25 -0
  179. package/es/src/charts/SlopeChart/index.js +116 -0
  180. package/es/src/charts/SlopeChart/slope.js +95 -0
  181. package/es/src/charts/Streamgraph/index.js +51 -0
  182. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  183. package/es/src/charts/Sunburst/emit.js +83 -64
  184. package/es/src/charts/Sunburst/index.js +16 -4
  185. package/es/src/charts/Tree/applyLayout.js +44 -14
  186. package/es/src/charts/Tree/emit.js +5 -5
  187. package/es/src/charts/Tree/index.js +12 -18
  188. package/es/src/charts/Tree/keys.js +33 -0
  189. package/es/src/charts/Tree/nodeLabel.js +15 -0
  190. package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
  191. package/es/src/charts/Treemap/index.js +2 -5
  192. package/es/src/charts/Violin/inner.js +3 -5
  193. package/es/src/charts/definition/makeChart.js +14 -2
  194. package/es/src/charts/drawSteps/backControl.js +17 -5
  195. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  196. package/es/src/charts/drawSteps/minimap.js +10 -25
  197. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  198. package/es/src/charts/drawSteps/searchControls.js +2 -1
  199. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  200. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  201. package/es/src/charts/drawSteps/zoomActions.js +36 -0
  202. package/es/src/charts/drawSteps/zoomControls.js +52 -23
  203. package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
  204. package/es/src/charts/drawSteps/zoomDrag.js +188 -0
  205. package/es/src/charts/drawSteps/zoomFit.js +69 -0
  206. package/es/src/charts/events/click.legend.js +11 -4
  207. package/es/src/charts/events/click.shape.js +13 -4
  208. package/es/src/charts/events/mouseenter.js +6 -16
  209. package/es/src/charts/events/mouseleave.js +9 -2
  210. package/es/src/charts/events/mousemove.legend.js +28 -32
  211. package/es/src/charts/events/mousemove.shape.js +45 -42
  212. package/es/src/charts/facet/drawFacets.js +14 -5
  213. package/es/src/charts/features/annotationFrame.js +179 -0
  214. package/es/src/charts/features/annotationText.js +83 -0
  215. package/es/src/charts/features/annotationTypes.js +10 -0
  216. package/es/src/charts/features/attributionFeature.js +6 -11
  217. package/es/src/charts/features/axes.js +17 -5
  218. package/es/src/charts/features/axesFinal.js +10 -3
  219. package/es/src/charts/features/axesMeasure.js +33 -12
  220. package/es/src/charts/features/axisTooltip.js +138 -0
  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/centerLabel.js +177 -0
  224. package/es/src/charts/features/chartGeometry.js +1 -1
  225. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  226. package/es/src/charts/features/circleLabels.js +207 -0
  227. package/es/src/charts/features/colorScaleBivariate.js +83 -0
  228. package/es/src/charts/features/colorScaleBucket.js +20 -1
  229. package/es/src/charts/features/colorScaleHover.js +33 -7
  230. package/es/src/charts/features/colorScaleLimit.js +73 -0
  231. package/es/src/charts/features/colorScaleTooltip.js +77 -0
  232. package/es/src/charts/features/colorScaleTop.js +61 -0
  233. package/es/src/charts/features/colorScaleValue.js +97 -0
  234. package/es/src/charts/features/curvedArrows.js +191 -0
  235. package/es/src/charts/features/depthKey.js +26 -0
  236. package/es/src/charts/features/edgeArrows.js +220 -5
  237. package/es/src/charts/features/edgeBundling.js +442 -0
  238. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  239. package/es/src/charts/features/ensureZoomDom.js +32 -8
  240. package/es/src/charts/features/features.js +32 -14
  241. package/es/src/charts/features/featuresColorScale.js +75 -20
  242. package/es/src/charts/features/featuresLegend.js +15 -24
  243. package/es/src/charts/features/hoverTicks.js +41 -0
  244. package/es/src/charts/features/idleQueue.js +72 -0
  245. package/es/src/charts/features/legendKeys.js +64 -0
  246. package/es/src/charts/features/lineLabels.js +55 -46
  247. package/es/src/charts/features/linkBundle.js +19 -0
  248. package/es/src/charts/features/linkColor.js +72 -0
  249. package/es/src/charts/features/linkFields.js +86 -0
  250. package/es/src/charts/features/linkFocus.js +118 -0
  251. package/es/src/charts/features/linkInteraction.js +364 -0
  252. package/es/src/charts/features/linkKeys.js +20 -0
  253. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  254. package/es/src/charts/features/linkLabelPath.js +162 -0
  255. package/es/src/charts/features/linkLabels.js +340 -0
  256. package/es/src/charts/features/linkWidths.js +32 -0
  257. package/es/src/charts/features/networkMeasures.js +241 -0
  258. package/es/src/charts/features/nodeStats.js +309 -0
  259. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  260. package/es/src/charts/features/pathLabels.js +50 -0
  261. package/es/src/charts/features/plotAnnotations.js +68 -17
  262. package/es/src/charts/features/plotEndLabels.js +28 -7
  263. package/es/src/charts/features/plotPaint.js +46 -12
  264. package/es/src/charts/features/polyline.js +129 -0
  265. package/es/src/charts/features/referenceAnnotations.js +403 -0
  266. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  267. package/es/src/charts/features/ringLabelNodes.js +93 -0
  268. package/es/src/charts/features/ringLabels.js +222 -0
  269. package/es/src/charts/features/sceneBounds.js +26 -6
  270. package/es/src/charts/features/selfLoops.js +306 -0
  271. package/es/src/charts/features/shapeEmit.js +54 -32
  272. package/es/src/charts/features/sharedFields.js +15 -2
  273. package/es/src/charts/features/textHalo.js +30 -0
  274. package/es/src/charts/index.js +8 -0
  275. package/es/src/charts/partition/chartFields.js +14 -5
  276. package/es/src/charts/partition/interaction.js +19 -10
  277. package/es/src/charts/partition/zoom.js +7 -6
  278. package/es/src/charts/pipeline/insetPlacement.js +22 -9
  279. package/es/src/charts/pipeline/preDrawData.js +46 -3
  280. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  281. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  282. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  283. package/es/src/charts/polar/chrome.js +81 -9
  284. package/es/src/charts/polar/config.js +6 -3
  285. package/es/src/charts/polar/wedgeLayout.js +2 -1
  286. package/es/src/charts/viz/Viz.js +61 -49
  287. package/es/src/charts/viz/VizBase.js +57 -14
  288. package/es/src/charts/viz/backgroundInk.js +23 -7
  289. package/es/src/charts/viz/emphasis.js +14 -0
  290. package/es/src/charts/viz/fillStroke.js +10 -0
  291. package/es/src/charts/viz/focusRing.js +104 -0
  292. package/es/src/charts/viz/focusTargets.js +208 -0
  293. package/es/src/charts/viz/history.js +74 -0
  294. package/es/src/charts/viz/interactionOpacity.js +115 -32
  295. package/es/src/charts/viz/keyboardNav.js +297 -0
  296. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  297. package/es/src/charts/viz/loaderFormat.js +114 -0
  298. package/es/src/charts/viz/missingFields.js +2 -1
  299. package/es/src/charts/viz/mountTarget.js +9 -0
  300. package/es/src/charts/viz/nearestHover.js +183 -0
  301. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  302. package/es/src/charts/viz/ordinalColor.js +14 -12
  303. package/es/src/charts/viz/pageTheme.js +83 -0
  304. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  305. package/es/src/charts/viz/pointVoronoi.js +124 -0
  306. package/es/src/charts/viz/reducedMotion.js +27 -0
  307. package/es/src/charts/viz/reportDrawError.js +15 -0
  308. package/es/src/charts/viz/setCursor.js +29 -0
  309. package/es/src/charts/viz/tooltipEnabled.js +38 -0
  310. package/es/src/charts/viz/userClick.js +34 -0
  311. package/es/src/charts/viz/vizDataPolling.js +8 -4
  312. package/es/src/charts/viz/vizDefaults.js +28 -57
  313. package/es/src/charts/viz/vizFields.js +41 -1
  314. package/es/src/charts/viz/vizRender.js +76 -31
  315. package/es/src/charts/viz/vizTheme.js +96 -0
  316. package/es/src/charts/viz/vizVisibility.js +26 -2
  317. package/es/src/components/Axis/Axis.js +35 -2
  318. package/es/src/components/Axis/AxisBottom.js +1 -0
  319. package/es/src/components/Axis/AxisLeft.js +1 -0
  320. package/es/src/components/Axis/AxisRight.js +1 -0
  321. package/es/src/components/Axis/AxisTop.js +1 -0
  322. package/es/src/components/Axis/axisBreak.js +33 -8
  323. package/es/src/components/Axis/axisDefaults.js +16 -9
  324. package/es/src/components/Axis/axisLabelKinds.js +36 -0
  325. package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
  326. package/es/src/components/Axis/axisLabelRoom.js +37 -0
  327. package/es/src/components/Axis/axisLabelSize.js +171 -0
  328. package/es/src/components/Axis/axisLabelThinning.js +98 -4
  329. package/es/src/components/Axis/axisLayout.js +71 -46
  330. package/es/src/components/Axis/axisLayoutLabels.js +82 -140
  331. package/es/src/components/Axis/axisLayoutScale.js +16 -11
  332. package/es/src/components/Axis/axisLimit.js +27 -0
  333. package/es/src/components/Axis/axisMaxSize.js +39 -0
  334. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  335. package/es/src/components/Axis/axisRender.js +20 -8
  336. package/es/src/components/Axis/axisRounding.js +16 -1
  337. package/es/src/components/Axis/axisScene.js +11 -2
  338. package/es/src/components/Axis/axisTitle.js +53 -0
  339. package/es/src/components/Axis/axisTooltipTargets.js +128 -0
  340. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  341. package/es/src/components/Axis/rangeBreaks.js +201 -0
  342. package/es/src/components/Axis/timeValues.js +19 -4
  343. package/es/src/components/ColorScale/ColorScale.js +77 -27
  344. package/es/src/components/ColorScale/bivariateRender.js +353 -0
  345. package/es/src/components/ColorScale/bivariateScale.js +150 -0
  346. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  347. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  348. package/es/src/components/ColorScale/colorScaleRender.js +32 -2
  349. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  350. package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
  351. package/es/src/components/Legend/Legend.js +13 -2
  352. package/es/src/components/Legend/legendConfig.js +2 -6
  353. package/es/src/components/Legend/legendCut.js +108 -0
  354. package/es/src/components/Legend/legendRender.js +38 -13
  355. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  356. package/es/src/components/TextBox.js +34 -67
  357. package/es/src/components/Timeline/Timeline.js +12 -3
  358. package/es/src/components/Timeline/timelineConfig.js +20 -10
  359. package/es/src/components/Timeline/timelineMode.js +26 -0
  360. package/es/src/components/Timeline/timelineRender.js +9 -4
  361. package/es/src/components/Tooltip.js +15 -5
  362. package/es/src/components/fontStack.js +20 -0
  363. package/es/src/components/textBoxLayout.js +58 -21
  364. package/es/src/components/textBoxPath.js +73 -0
  365. package/es/src/components/textBoxScene.js +226 -0
  366. package/es/src/components/textBoxWords.js +70 -0
  367. package/es/src/components/textEllipsis.js +7 -0
  368. package/es/src/components/tooltipDom.js +8 -5
  369. package/es/src/fluent.js +48 -0
  370. package/es/src/shapes/Area.js +1 -0
  371. package/es/src/shapes/Bar.js +1 -0
  372. package/es/src/shapes/Box.js +1 -0
  373. package/es/src/shapes/Circle.js +1 -0
  374. package/es/src/shapes/Line.js +1 -0
  375. package/es/src/shapes/Path.js +1 -0
  376. package/es/src/shapes/Rect.js +1 -0
  377. package/es/src/shapes/Shape.js +1 -0
  378. package/es/src/shapes/Whisker.js +1 -0
  379. package/es/src/utils/BaseClass.js +30 -12
  380. package/es/src/utils/configPrep.js +2 -1
  381. package/es/src/utils/configValue.js +9 -0
  382. package/es/src/utils/constant.js +13 -1
  383. package/es/src/utils/displayName.js +12 -0
  384. package/es/src/utils/theme.js +190 -0
  385. package/es/src/utils/themeInk.js +68 -0
  386. package/package.json +14 -11
  387. package/types/index.d.ts +6 -2
  388. package/types/internal.d.ts +268 -9
  389. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  390. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  391. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  392. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  393. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  394. package/types/src/charts/Alluvial/index.d.ts +27 -0
  395. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  396. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  397. package/types/src/charts/Alluvial/titles.d.ts +46 -0
  398. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  399. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  400. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  401. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  402. package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
  403. package/types/src/charts/ArcDiagram/events.d.ts +29 -0
  404. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  405. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  406. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  407. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  408. package/types/src/charts/Chord/labels.d.ts +66 -0
  409. package/types/src/charts/Donut/index.d.ts +2 -1
  410. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  411. package/types/src/charts/Gantt/emit.d.ts +17 -0
  412. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  413. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  414. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  415. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  416. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  417. package/types/src/charts/Gantt/index.d.ts +36 -0
  418. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  419. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  420. package/types/src/charts/Geomap/emit.d.ts +2 -2
  421. package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
  422. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  423. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  424. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  425. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  426. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  427. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  428. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  429. package/types/src/charts/Geomap/index.d.ts +3 -0
  430. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  431. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  432. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  433. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  434. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  435. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  436. package/types/src/charts/Hexbin/index.d.ts +25 -0
  437. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  438. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  439. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  440. package/types/src/charts/Histogram/binData.d.ts +20 -1
  441. package/types/src/charts/Histogram/index.d.ts +3 -2
  442. package/types/src/charts/Histogram/labels.d.ts +7 -0
  443. package/types/src/charts/Marimekko/index.d.ts +2 -1
  444. package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
  445. package/types/src/charts/Network/applyLayout.d.ts +11 -0
  446. package/types/src/charts/Network/bundle.d.ts +69 -0
  447. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  448. package/types/src/charts/Network/clusters.d.ts +115 -0
  449. package/types/src/charts/Network/graph.d.ts +73 -0
  450. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  451. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  452. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  453. package/types/src/charts/Pack/applyLayout.d.ts +2 -0
  454. package/types/src/charts/Pack/groupRows.d.ts +46 -0
  455. package/types/src/charts/Pack/index.d.ts +3 -0
  456. package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
  457. package/types/src/charts/Pack/nodeNames.d.ts +23 -0
  458. package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
  459. package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
  460. package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
  461. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  462. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  463. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  464. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  465. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  466. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  467. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  468. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  469. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  470. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  471. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  472. package/types/src/charts/Plot/areaEnter.d.ts +34 -0
  473. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  474. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  475. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  476. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  477. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  478. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  479. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  480. package/types/src/charts/Plot/index.d.ts +16 -15
  481. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  482. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  483. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  484. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  485. package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
  486. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  487. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  488. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  489. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  490. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  491. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  492. package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
  493. package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
  494. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  495. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  496. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  497. package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
  498. package/types/src/charts/Pyramid/gutter.d.ts +28 -6
  499. package/types/src/charts/Pyramid/scene.d.ts +1 -1
  500. package/types/src/charts/Radar/applyLayout.d.ts +2 -3
  501. package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
  502. package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
  503. package/types/src/charts/Radar/emit.d.ts +5 -2
  504. package/types/src/charts/Radar/index.d.ts +7 -2
  505. package/types/src/charts/Radar/points.d.ts +50 -0
  506. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  507. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  508. package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
  509. package/types/src/charts/Rings/emit.d.ts +72 -0
  510. package/types/src/charts/Rings/index.d.ts +4 -2
  511. package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
  512. package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
  513. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  514. package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
  515. package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
  516. package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
  517. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  518. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  519. package/types/src/charts/Sankey/emit.d.ts +58 -0
  520. package/types/src/charts/Sankey/labels.d.ts +19 -0
  521. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  522. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  523. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  524. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  525. package/types/src/charts/Scatter/index.d.ts +15 -0
  526. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  527. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  528. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  529. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  530. package/types/src/charts/Tree/applyLayout.d.ts +20 -0
  531. package/types/src/charts/Tree/keys.d.ts +25 -0
  532. package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
  533. package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
  534. package/types/src/charts/definition/makeChart.d.ts +3 -2
  535. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  536. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  537. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  538. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  539. package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
  540. package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
  541. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
  542. package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
  543. package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
  544. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  545. package/types/src/charts/events/click.legend.d.ts +2 -1
  546. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  547. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  548. package/types/src/charts/features/annotationText.d.ts +57 -0
  549. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  550. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  551. package/types/src/charts/features/axisTooltip.d.ts +49 -0
  552. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  553. package/types/src/charts/features/calloutScene.d.ts +40 -0
  554. package/types/src/charts/features/centerLabel.d.ts +75 -0
  555. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  556. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  557. package/types/src/charts/features/circleLabels.d.ts +130 -0
  558. package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
  559. package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
  560. package/types/src/charts/features/colorScaleHover.d.ts +13 -3
  561. package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
  562. package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
  563. package/types/src/charts/features/colorScaleTop.d.ts +30 -0
  564. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  565. package/types/src/charts/features/curvedArrows.d.ts +119 -0
  566. package/types/src/charts/features/depthKey.d.ts +19 -0
  567. package/types/src/charts/features/edgeArrows.d.ts +103 -4
  568. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  569. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  570. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  571. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  572. package/types/src/charts/features/hoverTicks.d.ts +30 -0
  573. package/types/src/charts/features/idleQueue.d.ts +46 -0
  574. package/types/src/charts/features/legendKeys.d.ts +34 -0
  575. package/types/src/charts/features/lineLabels.d.ts +15 -12
  576. package/types/src/charts/features/linkBundle.d.ts +16 -0
  577. package/types/src/charts/features/linkColor.d.ts +48 -0
  578. package/types/src/charts/features/linkFields.d.ts +16 -0
  579. package/types/src/charts/features/linkFocus.d.ts +51 -0
  580. package/types/src/charts/features/linkInteraction.d.ts +192 -0
  581. package/types/src/charts/features/linkKeys.d.ts +11 -0
  582. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  583. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  584. package/types/src/charts/features/linkLabels.d.ts +77 -0
  585. package/types/src/charts/features/linkWidths.d.ts +19 -0
  586. package/types/src/charts/features/networkMeasures.d.ts +53 -0
  587. package/types/src/charts/features/nodeStats.d.ts +93 -0
  588. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  589. package/types/src/charts/features/pathLabels.d.ts +41 -0
  590. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  591. package/types/src/charts/features/plotEndLabels.d.ts +14 -1
  592. package/types/src/charts/features/plotPaint.d.ts +17 -0
  593. package/types/src/charts/features/polyline.d.ts +32 -0
  594. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  595. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  596. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  597. package/types/src/charts/features/ringLabels.d.ts +164 -0
  598. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  599. package/types/src/charts/features/selfLoops.d.ts +165 -0
  600. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  601. package/types/src/charts/features/sharedFields.d.ts +11 -2
  602. package/types/src/charts/features/textHalo.d.ts +15 -0
  603. package/types/src/charts/index.d.ts +8 -0
  604. package/types/src/charts/partition/chartFields.d.ts +6 -1
  605. package/types/src/charts/partition/interaction.d.ts +6 -3
  606. package/types/src/charts/partition/zoom.d.ts +4 -4
  607. package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
  608. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  609. package/types/src/charts/pipeline/stages.d.ts +7 -0
  610. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  611. package/types/src/charts/polar/chrome.d.ts +19 -6
  612. package/types/src/charts/viz/Viz.d.ts +25 -4
  613. package/types/src/charts/viz/VizBase.d.ts +37 -8
  614. package/types/src/charts/viz/backgroundInk.d.ts +19 -4
  615. package/types/src/charts/viz/emphasis.d.ts +17 -0
  616. package/types/src/charts/viz/fillStroke.d.ts +7 -0
  617. package/types/src/charts/viz/focusRing.d.ts +25 -0
  618. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  619. package/types/src/charts/viz/history.d.ts +35 -0
  620. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  621. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  622. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  623. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  624. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  625. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  626. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  627. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  628. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  629. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  630. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  631. package/types/src/charts/viz/reportDrawError.d.ts +12 -0
  632. package/types/src/charts/viz/setCursor.d.ts +26 -0
  633. package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
  634. package/types/src/charts/viz/userClick.d.ts +35 -0
  635. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  636. package/types/src/charts/viz/vizFields.d.ts +37 -0
  637. package/types/src/charts/viz/vizRender.d.ts +2 -1
  638. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  639. package/types/src/charts/viz/vizTypes.d.ts +100 -7
  640. package/types/src/charts/viz/vizVisibility.d.ts +13 -0
  641. package/types/src/components/Axis/Axis.d.ts +34 -3
  642. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  643. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  644. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  645. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  646. package/types/src/components/Axis/axisBreak.d.ts +21 -3
  647. package/types/src/components/Axis/axisDefaults.d.ts +12 -0
  648. package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
  649. package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
  650. package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
  651. package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
  652. package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
  653. package/types/src/components/Axis/axisLayout.d.ts +9 -2
  654. package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
  655. package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
  656. package/types/src/components/Axis/axisLimit.d.ts +18 -0
  657. package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
  658. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  659. package/types/src/components/Axis/axisRounding.d.ts +8 -0
  660. package/types/src/components/Axis/axisTitle.d.ts +30 -0
  661. package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
  662. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  663. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  664. package/types/src/components/Axis/timeValues.d.ts +1 -1
  665. package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
  666. package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
  667. package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
  668. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  669. package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
  670. package/types/src/components/Legend/Legend.d.ts +6 -0
  671. package/types/src/components/Legend/legendCut.d.ts +31 -0
  672. package/types/src/components/Legend/legendRender.d.ts +6 -1
  673. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  674. package/types/src/components/TextBox.d.ts +5 -0
  675. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  676. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  677. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  678. package/types/src/components/Tooltip.d.ts +4 -3
  679. package/types/src/components/fontStack.d.ts +10 -0
  680. package/types/src/components/textBoxLayout.d.ts +18 -9
  681. package/types/src/components/textBoxPath.d.ts +59 -0
  682. package/types/src/components/textBoxScene.d.ts +51 -0
  683. package/types/src/components/textBoxWords.d.ts +33 -0
  684. package/types/src/components/textEllipsis.d.ts +6 -0
  685. package/types/src/fluent.d.ts +18 -0
  686. package/types/src/shapes/Area.d.ts +1 -0
  687. package/types/src/shapes/Bar.d.ts +1 -0
  688. package/types/src/shapes/Box.d.ts +1 -0
  689. package/types/src/shapes/Circle.d.ts +1 -0
  690. package/types/src/shapes/Line.d.ts +1 -0
  691. package/types/src/shapes/Path.d.ts +1 -0
  692. package/types/src/shapes/Rect.d.ts +1 -0
  693. package/types/src/shapes/Shape.d.ts +1 -0
  694. package/types/src/shapes/Whisker.d.ts +1 -0
  695. package/types/src/shapes/emitLabels.d.ts +1 -1
  696. package/types/src/utils/BaseClass.d.ts +9 -0
  697. package/types/src/utils/D3plusConfig.d.ts +1093 -266
  698. package/types/src/utils/configPrep.d.ts +2 -0
  699. package/types/src/utils/configValue.d.ts +8 -0
  700. package/types/src/utils/constant.d.ts +8 -0
  701. package/types/src/utils/displayName.d.ts +10 -0
  702. package/types/src/utils/index.d.ts +1 -1
  703. package/types/src/utils/theme.d.ts +170 -0
  704. package/types/src/utils/themeInk.d.ts +56 -0
  705. package/types/umd-entry.d.ts +4 -0
  706. package/umd/d3plus-core.full.js +72239 -41465
  707. package/umd/d3plus-core.full.min.js +2 -2
  708. package/umd/d3plus-core.js +46249 -19519
  709. package/umd/d3plus-core.min.js +2 -2
  710. package/es/src/components/Axis/gridStroke.js +0 -10
  711. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -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,192 @@
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, a node, or a legend entry highlights, and
5
+ the connections a
6
+ node's tooltip lists.
7
+
8
+ A link's datum is its row from `links`, with `source` and `target`
9
+ replaced by the data of the nodes they name. `linkSize`, `value`,
10
+ `shapeConfig` functions, arrow accessors, and the tooltip all receive it,
11
+ so they read node fields directly (`d.source.name`). The chart's
12
+ bookkeeping for each datum (its index in `links`, the ids of its ends, its
13
+ value) is kept beside it in a WeakMap, so the datum holds only the link's
14
+ own fields.
15
+ */
16
+ import type { DataPoint } from "@d3plus/data";
17
+ import type { VizInstance } from "../viz/vizTypes.js";
18
+ /**
19
+ A link as accessors and tooltips receive it: the link's own fields, with
20
+ `source` and `target` set to the data of the nodes at its ends.
21
+ */
22
+ export type LinkDatum = DataPoint & {
23
+ source: DataPoint;
24
+ target: DataPoint;
25
+ };
26
+ /** One end of a link: the node's datum, its index, and its id. */
27
+ export interface LinkEnd {
28
+ data: DataPoint;
29
+ i: number;
30
+ id: string;
31
+ /** The end's name, for an end with no row of its own to label it (a bare coordinate). */
32
+ label?: string;
33
+ }
34
+ /** The links of a chart, and each node's links by node id. */
35
+ export interface LinkGraph {
36
+ links: LinkDatum[];
37
+ /** Whether the links' values differ, so tooltips and labels report them. */
38
+ sized: boolean;
39
+ byNode: Map<string, LinkDatum[]>;
40
+ }
41
+ /** What the chart knows about a link datum. */
42
+ export interface LinkMeta {
43
+ /** The link's index in `links`. */
44
+ index: number;
45
+ /** The link's row in `links`. */
46
+ raw: DataPoint;
47
+ source: LinkEnd;
48
+ target: LinkEnd;
49
+ /** The keys of `raw` that name its ends. */
50
+ endKeys: string[];
51
+ /** The link's value (`linkSize` or `value`), when it is a number. */
52
+ value?: number;
53
+ graph?: LinkGraph;
54
+ }
55
+ type Predicate = (d: DataPoint, i: number) => boolean;
56
+ type NodeKey = (d: DataPoint, i: number) => string;
57
+ type Row = [string, string];
58
+ /** What the chart recorded for a link datum, if `d` is one. */
59
+ export declare function linkMeta(d: unknown): LinkMeta | undefined;
60
+ /** Whether `d` is a link datum. */
61
+ export declare function isLinkDatum(d: unknown): d is LinkDatum;
62
+ /**
63
+ The datum a link is drawn with: `raw`'s fields, with `source` and
64
+ `target` set to the data of the nodes at its ends.
65
+ @param raw The link's row in `links`.
66
+ @param source The node at its source end.
67
+ @param target The node at its target end.
68
+ @param index The link's index in `links`.
69
+ @param endKeys The keys of `raw` that name its ends.
70
+ */
71
+ export declare function makeLinkDatum(raw: DataPoint, source: LinkEnd, target: LinkEnd, index: number, endKeys?: string[]): LinkDatum;
72
+ /**
73
+ Records a link's value (from `linkSize` or `value`) for its tooltip and
74
+ spoken label, and returns it.
75
+ */
76
+ export declare function setLinkValue<T>(d: LinkDatum, value: T): T;
77
+ /**
78
+ Indexes a chart's links by node and stores the result on `viz.ctx.linkGraph`.
79
+ Each of `nodes` (including any without links) is recognized by its datum
80
+ from then on, so its tooltip can list its connections.
81
+ */
82
+ export declare function publishLinkGraph(viz: VizInstance, links: LinkDatum[], nodes: LinkEnd[]): LinkGraph;
83
+ /**
84
+ Forgets every node `publishLinkGraph` recorded for a chart, so rows that
85
+ no longer end a link stop reading as nodes.
86
+ */
87
+ export declare function forgetLinkNodes(viz: VizInstance): void;
88
+ /** The node id and graph recorded for a node datum, if `d` is one. */
89
+ export declare function linkNodeOf(viz: VizInstance, d: unknown): {
90
+ id: string;
91
+ graph: LinkGraph;
92
+ } | undefined;
93
+ /** Whether a locale code (`"ar-SA"`) names a language written right to left. */
94
+ export declare function rtlLocale(locale: unknown): boolean;
95
+ /**
96
+ The arrows a chart's tooltips point from a link's source to its target
97
+ with: `["→", "←"]`, mirrored to `["←", "→"]` when the chart's locale is
98
+ written right to left or the page's direction is (see `rtl`).
99
+ */
100
+ export declare function linkArrows(viz: VizInstance): [string, string];
101
+ /** A link end's label, as its node's tooltip titles it. */
102
+ export declare function linkEndLabel(viz: VizInstance, end: LinkEnd): string;
103
+ /** A link's tooltip title: "Source → Target" ("Source ← Target" right to left). */
104
+ export declare function linkTooltipTitle(viz: VizInstance, d: LinkDatum): string;
105
+ /** A tooltip cell's text for one field value, or null for a value it skips. */
106
+ export declare function linkCellText(viz: VizInstance, v: unknown): string | null;
107
+ /**
108
+ A link's tooltip rows: its value (when the chart's links differ in value
109
+ and no field of the link already shows it), then each of the link's own
110
+ fields other than the ones naming its ends.
111
+ */
112
+ export declare function linkTooltipRows(viz: VizInstance, d: LinkDatum): Row[];
113
+ /**
114
+ A link's spoken label: "Source to Target." When the chart's links differ
115
+ in value, its value follows: "Source to Target, 4."
116
+ */
117
+ export declare function linkAriaLabel(viz: VizInstance, d: LinkDatum): string;
118
+ /**
119
+ What hovering a link highlights: the link and the nodes at its two ends.
120
+ Rows that aren't recorded nodes (legend entries) match by `nodeKey`.
121
+ */
122
+ export declare function linkHighlight(viz: VizInstance, d: LinkDatum, nodeKey?: NodeKey): Predicate;
123
+ /**
124
+ What hovering a legend entry highlights: the nodes it stands for (one, or
125
+ every member of a merged entry, such as a cluster) and the links between
126
+ them. A row matches when every id it holds is one of the entry's, so the
127
+ entry matches itself.
128
+ */
129
+ export declare function legendHighlight(viz: VizInstance, d: DataPoint, i: number): Predicate;
130
+ /**
131
+ A node's links in `graph`, the other end of each, and its direction,
132
+ strongest first. A link from the node to itself is `loop`, with the node
133
+ as its other end.
134
+ */
135
+ export declare function nodeConnections(graph: LinkGraph, id: string): {
136
+ link: LinkDatum;
137
+ other: LinkEnd;
138
+ outgoing: boolean;
139
+ loop: boolean;
140
+ value?: number;
141
+ }[];
142
+ /**
143
+ What hovering a node highlights: the node, the nodes it links to, and the
144
+ links between them. Null when `d` isn't a recorded node. Rows that aren't
145
+ recorded nodes (legend entries) match by `nodeKey`.
146
+ */
147
+ export declare function nodeHighlight(viz: VizInstance, d: DataPoint, nodeKey?: NodeKey): Predicate | null;
148
+ /**
149
+ How many links a node's tooltip lists: `nodeTooltipLinks` when it is a
150
+ number (`true` is 3, `false` none), else 3 when the links differ in value
151
+ and none when they don't.
152
+ */
153
+ export declare function nodeTooltipLinkLimit(viz: VizInstance, graph: LinkGraph): number;
154
+ /** The arrow a node's tooltip marks a link from the node to itself with. */
155
+ export declare const LOOP_ARROW = "\u21BB";
156
+ /**
157
+ A node's tooltip rows: its number of connections (left out when its
158
+ degree takes its place) and the network measures `nodeTooltipStats`
159
+ lists (see `nodeStatRows`), then its strongest links ("→ Target" or "← Source", or "↻ Node" for a link to
160
+ itself, with the link's value when the links differ in value), up to
161
+ `nodeTooltipLinkLimit`. The arrows mirror right to left (see
162
+ `linkArrows`).
163
+ */
164
+ export declare function nodeConnectionRows(viz: VizInstance, d: DataPoint): Row[];
165
+ /**
166
+ The node-link charts' default `tooltipConfig`: a link is titled
167
+ "Source → Target" and lists its value and fields; a node is titled by its
168
+ label and lists its connections.
169
+ */
170
+ export declare function linkTooltipConfig(viz: VizInstance): {
171
+ title: (d: DataPoint, i: number) => string;
172
+ tbody: (d: DataPoint, i: number) => Row[];
173
+ };
174
+ /** The smallest stroke width a link's hit path takes, in pixels. */
175
+ export declare const LINK_HIT_WIDTH = 8;
176
+ /**
177
+ A transparent path over a link, wider than it, so thin links are easy to
178
+ point at. Keyboard navigation skips it (its key ends in `::hit`).
179
+ */
180
+ export declare function linkHitPath(key: string, d: string, datum: LinkDatum, strokeWidth: unknown): {
181
+ type: "path";
182
+ key: string;
183
+ d: string;
184
+ datum: LinkDatum;
185
+ index: number;
186
+ paint: {
187
+ fill: string;
188
+ stroke: string;
189
+ strokeWidth: number;
190
+ };
191
+ };
192
+ 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];
@@ -0,0 +1,53 @@
1
+ /**
2
+ Shortest-path measures of a network's nodes: betweenness (Brandes'
3
+ algorithm) and closeness, from one search per node. The graph is a list
4
+ of directed arcs; an undirected link is two arcs, one each way.
5
+ */
6
+ /** One way along a link: from `source` to `target`, `length` steps long (default 1). */
7
+ export interface MeasureArc {
8
+ source: string;
9
+ target: string;
10
+ length?: number;
11
+ }
12
+ /** Each node's betweenness and closeness, both from 0 to 1. */
13
+ export interface NetworkMeasures {
14
+ betweenness: Map<string, number>;
15
+ closeness: Map<string, number>;
16
+ }
17
+ /**
18
+ Works out the measures one node's search at a time (see
19
+ `networkMeasures`), so the work can be spread over several turns.
20
+ */
21
+ export interface MeasuresTask {
22
+ /**
23
+ Runs searches until `budget` milliseconds have passed (at least one),
24
+ and returns whether every node has been searched.
25
+ */
26
+ step(budget?: number): boolean;
27
+ /** The measures, once `step` has returned `true`. */
28
+ result(): NetworkMeasures;
29
+ }
30
+ /**
31
+ A task working out each node's betweenness and closeness (see
32
+ `networkMeasures`), one node's search per unit of work.
33
+ @param nodes The node ids; arcs naming other ids are ignored.
34
+ @param arcs The directed arcs between them.
35
+ */
36
+ export declare function measuresTask(nodes: string[], arcs: MeasureArc[]): MeasuresTask;
37
+ /**
38
+ Each node's betweenness and closeness.
39
+
40
+ Betweenness is the share of shortest paths between other pairs of nodes
41
+ that pass through the node, normalized by `(n - 1)(n - 2)` (the most a
42
+ node can have, as the center of a star), so it runs from 0 to 1.
43
+
44
+ Closeness is the inverse of the node's average distance to the nodes it
45
+ can reach, scaled by the share of the other nodes it can reach (Wasserman
46
+ and Faust's form, so a node in a small component isn't as close as one
47
+ linked to everything). It is 1 for a node one step from every other, and
48
+ 0 for a node that reaches none. In a directed graph it reads distances
49
+ from the node along its arcs.
50
+ @param nodes The node ids; arcs naming other ids are ignored.
51
+ @param arcs The directed arcs between them.
52
+ */
53
+ export declare function networkMeasures(nodes: string[], arcs: MeasureArc[]): NetworkMeasures;