@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
+ Hexbin's pure density-contour helpers: a kernel density estimate of the
3
+ points in pixel space (d3-contour's `contourDensity`), cut at threshold
4
+ levels, each level's region as an SVG path.
5
+
6
+ Levels are in points per bin: the density (points per square pixel)
7
+ times the area of one bin, so a level reads as the count a bin would
8
+ hold there and shares the bins' color scale.
9
+
10
+ @module
11
+ */
12
+ import type { PixelPoint } from "./binning.js";
13
+ /** A GeoJSON MultiPolygon's coordinates: polygons of rings of points. */
14
+ type MultiPolygonCoords = number[][][][];
15
+ /** One contour level: its threshold and its region's outline. */
16
+ export interface ContourLevel {
17
+ level: number;
18
+ path: string;
19
+ }
20
+ /** What a density contour pass needs. */
21
+ export interface ContourOptions {
22
+ /** The plot's left and top edge, in pixels: the density grid's origin. */
23
+ left: number;
24
+ top: number;
25
+ /** The plot's size, in pixels. */
26
+ width: number;
27
+ height: number;
28
+ /** The kernel's standard deviation, in pixels. */
29
+ bandwidth: number;
30
+ /** About how many levels to draw (rounded to nice values), or the levels themselves. */
31
+ thresholds: number | number[];
32
+ /** Square pixels per level unit: the area of one bin. */
33
+ unit: number;
34
+ }
35
+ /**
36
+ The levels to cut a density whose peak is `max` at: the given levels
37
+ above zero (sorted), or about `thresholds` nice values between zero and
38
+ the peak.
39
+ */
40
+ export declare function contourLevels(max: number, thresholds: number | number[]): number[];
41
+ /** A MultiPolygon's rings as one absolute SVG path, shifted by `[dx, dy]`. */
42
+ export declare function contourPath(coordinates: MultiPolygonCoords, [dx, dy]?: [number, number]): string;
43
+ /**
44
+ The density contours of `points`, one per level that encloses any area,
45
+ lowest level first.
46
+ */
47
+ export declare function densityContours(points: PixelPoint[], options: ContourOptions): ContourLevel[];
48
+ export {};
@@ -0,0 +1,23 @@
1
+ /**
2
+ Hexbin's Plot shape emitter: the observations binned in pixel space and
3
+ drawn as hexagons or squares, with optional density contours and the raw
4
+ observations beneath. Bins and contours are Paths stamped as `"Hexbin"`
5
+ marks, each carrying a bin or contour row as its datum, so tooltips,
6
+ hover, events and keyboard navigation treat them like any other mark.
7
+
8
+ @module
9
+ */
10
+ import type { ShapeEmitContext, ShapeEmitter } from "../features/shapeEmit.js";
11
+ import { type PixelPoint } from "./binning.js";
12
+ import { type HexbinSettings } from "./settings.js";
13
+ /** The observations of a shape group, placed in pixels. */
14
+ export declare function pixelPoints(ctx: Pick<ShapeEmitContext, "x" | "y" | "values">, settings: Pick<HexbinSettings, "weight">): PixelPoint[];
15
+ /**
16
+ Emits a Hexbin's observations: the raw points (`points`), the bins
17
+ (`binShape`), then the density contours (`contours`) and their level
18
+ labels. Each paint, zoomed
19
+ or not, refits the colorScale to the bins in view (or the contour
20
+ levels), so the fills and the colorScale agree and the densest bin in
21
+ view takes the top color.
22
+ */
23
+ export declare const hexbinEmit: ShapeEmitter;
@@ -0,0 +1,25 @@
1
+ /**
2
+ Hexbin — a Plot of 2D binned density: raw observations on two continuous
3
+ axes, grouped into hexagons (or squares) of a fixed pixel size and
4
+ colored by how many each holds, with optional density contours.
5
+ */
6
+ import type { ChartDefinition } from "../definition/ChartDefinition.js";
7
+ import type { VizInstance } from "../viz/vizTypes.js";
8
+ /**
9
+ Keeps the rows with numeric x and y as the chart's data; the rest are
10
+ skipped. The user's rows stay the chart's source data.
11
+ */
12
+ export declare function keepNumericRows(viz: VizInstance): void;
13
+ export declare const hexbinDef: ChartDefinition;
14
+ /**
15
+ Creates a 2D binned density chart from raw observations: each row is a
16
+ point at its `x` and `y` values (rows without numeric values are
17
+ skipped), and the points are grouped into hexagons (`binShape`) of
18
+ `binSize` pixels, colored on the colorScale by how many each holds (or by
19
+ `binValue`). Empty bins aren't drawn. `contours` adds density contours,
20
+ and `points` draws the observations beneath. `groupBy` names the
21
+ observations for `filter` and the legend (off by default), and `facet`
22
+ bins each panel on its own, on one shared colorScale.
23
+ */
24
+ declare const _default: new () => any;
25
+ export default _default;
@@ -0,0 +1,94 @@
1
+ /**
2
+ Hexbin's per-draw state and the rows its emitter draws: bins and contour
3
+ levels measured from points in pixel space, and the rows the colorScale
4
+ is laid out from (estimated before the plot area is known, then measured
5
+ against it).
6
+
7
+ @module
8
+ */
9
+ import type { DataPoint } from "@d3plus/data";
10
+ import type { ShapeEmitContext } from "../features/shapeEmit.js";
11
+ import type { VizInstance } from "../viz/vizTypes.js";
12
+ import { type PixelBin, type PixelPoint } from "./binning.js";
13
+ import { type HexbinSettings } from "./settings.js";
14
+ /** The plot area in shape coordinates. */
15
+ export interface PlotFrame {
16
+ left: number;
17
+ top: number;
18
+ width: number;
19
+ height: number;
20
+ }
21
+ /** Per-instance state kept on `viz.ctx.hexbin`. */
22
+ export interface HexbinState {
23
+ /** The user's rows. */
24
+ raw: DataPoint[];
25
+ /** The rows with numeric x and y last written to `viz._data`. */
26
+ rows: DataPoint[];
27
+ /** The smallest x and y observed, where the bin grid is anchored. */
28
+ anchor?: [number, number];
29
+ /** Each small-multiples panel's observations, for the shared colorScale. */
30
+ panels?: DataPoint[][];
31
+ /** The colorScale's rows, once this draw's paint has measured them. */
32
+ colorRows?: DataPoint[];
33
+ }
34
+ /** A Hexbin's state. */
35
+ export declare function hexbinState(viz: VizInstance): HexbinState;
36
+ /** Whether a value is a finite number. */
37
+ export declare const isNumeric: (v: unknown) => v is number;
38
+ /** The plot area an emitter draws in. */
39
+ export declare function plotFrame(ctx: Pick<ShapeEmitContext, "xRange" | "yRange" | "x2Height">): PlotFrame;
40
+ /**
41
+ One row per bin, measured: its count and value, its bounds in data units
42
+ (through `invert`), and its outline. Bins whose value isn't a number (a
43
+ `mean` with nothing to average) are left out.
44
+ */
45
+ export declare function binRows(bins: PixelBin[], settings: Pick<HexbinSettings, "shape" | "size" | "agg">, invert: {
46
+ x: (px: number) => number;
47
+ y: (px: number) => number;
48
+ }): DataPoint[];
49
+ /**
50
+ One row per contour level, lowest first. Levels are in points per bin, so
51
+ they share the bins' color scale; a `mean` measure contours the points'
52
+ density, unweighted.
53
+ */
54
+ export declare function contourRows(points: PixelPoint[], frame: PlotFrame, settings: Pick<HexbinSettings, "shape" | "size" | "agg" | "contourConfig">): DataPoint[];
55
+ /** The bins that reach into the plot area: the ones a zoomed view shows. */
56
+ export declare function binsInView(bins: PixelBin[], frame: PlotFrame, settings: Pick<HexbinSettings, "shape" | "size">): PixelBin[];
57
+ /** The points as one path of `r`-pixel dots. */
58
+ export declare function pointPath(points: PixelPoint[], r: number): string;
59
+ /**
60
+ The rows the colorScale reads for some points: their bins in view, or
61
+ with no bins drawn, their contour levels.
62
+ */
63
+ export declare function colorRows(points: PixelPoint[], frame: PlotFrame, origin: [number, number], settings: HexbinSettings): DataPoint[];
64
+ /**
65
+ Notes what the emitter needs from the whole chart before a draw: where
66
+ the bin grid is anchored, and with small multiples, every panel's rows.
67
+ The colorScale rows measured by the last draw are dropped.
68
+ */
69
+ export declare function noteDrawRows(viz: VizInstance): void;
70
+ /**
71
+ The colorScale's rows for a panel's paint: the rows it measured, or with
72
+ small multiples, every panel's, binned at this panel's scale so all of
73
+ them share one colorScale.
74
+ */
75
+ export declare function sharedColorRows(ctx: ShapeEmitContext, own: DataPoint[], frame: PlotFrame, origin: [number, number], settings: HexbinSettings): DataPoint[];
76
+ /**
77
+ The rows the colorScale lays out from: those this draw's paint measured,
78
+ or before the paint, an estimate (see `estimatedColorRows`).
79
+ */
80
+ export declare function colorScaleRows(viz: VizInstance): DataPoint[];
81
+ /**
82
+ The colorScale's rows before the plot area is known (only its margin
83
+ depends on them): the observations measured in a plot area estimated
84
+ from the chart's size. The emitter refreshes the colorScale with the
85
+ rows it measures.
86
+ */
87
+ export declare function estimatedColorRows(viz: VizInstance, settings: HexbinSettings): DataPoint[];
88
+ /**
89
+ Lays the colorScale out again with `rows`, in the frame it already
90
+ claimed, so its scale (which the bins' fills read) spans what's drawn.
91
+ The rows are kept for any later layout of the colorScale in this draw
92
+ (see `colorScaleRows`).
93
+ */
94
+ export declare function refreshColorScale(viz: VizInstance, rows: DataPoint[]): void;
@@ -0,0 +1,122 @@
1
+ /**
2
+ Hexbin's resolved options and the rows it draws: one row per bin or
3
+ contour level, each carrying what it measures under `HEXBIN_META`.
4
+
5
+ @module
6
+ */
7
+ import type { DataPoint } from "@d3plus/data";
8
+ import type { VizInstance } from "../viz/vizTypes.js";
9
+ import type { BinAgg, BinShape } from "./binning.js";
10
+ /** The shape key Hexbin's observations, bins and contours draw under. */
11
+ export declare const HEXBIN_SHAPE = "Hexbin";
12
+ /** The key a bin or contour row keeps its measure under. */
13
+ export declare const HEXBIN_META = "__d3plusHexbin";
14
+ /** What a bin row carries. */
15
+ export interface BinMeta {
16
+ kind: "bin";
17
+ /** How many observations the bin holds. */
18
+ count: number;
19
+ /** What the bin measures: its count, or the sum or mean of `binValue`. */
20
+ value: number;
21
+ /** The bin's bounds in data units. */
22
+ x0: number;
23
+ x1: number;
24
+ y0: number;
25
+ y1: number;
26
+ /** The bin's outline, in pixels. */
27
+ path: string;
28
+ /** The observations in the bin. */
29
+ rows: DataPoint[];
30
+ }
31
+ /** What a contour row carries. */
32
+ export interface ContourMeta {
33
+ kind: "contour";
34
+ /** The density level, in points per bin. */
35
+ level: number;
36
+ /** The next level up, if any: the region's density runs from `level` to it. */
37
+ next?: number;
38
+ /** The level's position, lowest first, and how many levels there are. */
39
+ index: number;
40
+ levels: number;
41
+ path: string;
42
+ }
43
+ export type HexbinMeta = BinMeta | ContourMeta;
44
+ /** The `binValue` option: a count, or a field aggregated per bin. */
45
+ export type BinValueOption = "count" | {
46
+ value: string | ((d: DataPoint, i: number) => unknown);
47
+ agg?: "sum" | "mean";
48
+ label?: string;
49
+ };
50
+ /** The `contours` option. */
51
+ export type ContoursOption = boolean | "lines" | "filled";
52
+ /** The `contourConfig` option. */
53
+ export interface ContourConfig {
54
+ bandwidth?: number;
55
+ thresholds?: number | number[];
56
+ strokeWidth?: number;
57
+ fillOpacity?: number;
58
+ /** Writes each level's value along its contour lines. */
59
+ labels?: boolean;
60
+ /** TextBox config for the level labels, such as `fontSize` or `fontWeight`. */
61
+ labelConfig?: Record<string, unknown>;
62
+ /**
63
+ The least distance between two labels along one contour line, in
64
+ pixels. `"auto"` (the default) takes 20 ems or half the plot's mean
65
+ side, whichever is longer.
66
+ */
67
+ labelSpacing?: number | "auto";
68
+ /**
69
+ Labels every n-th level: `1` labels them all, `2` every other one
70
+ (the multiples of twice the levels' spacing), and so on. `"auto"`
71
+ (the default) labels all of up to five levels, and every other one
72
+ of more.
73
+ */
74
+ labelStep?: number | "auto";
75
+ }
76
+ /** The `pointConfig` option. */
77
+ export interface PointConfig {
78
+ r?: number;
79
+ fill?: string;
80
+ fillOpacity?: number;
81
+ }
82
+ /** Hexbin's options, resolved for a draw. */
83
+ export interface HexbinSettings {
84
+ shape: BinShape | false;
85
+ size: number;
86
+ agg: BinAgg;
87
+ /** What `sum`/`mean` bins aggregate, read from each observation. */
88
+ weight?: (d: DataPoint, i: number) => unknown;
89
+ /** The name of what a bin measures. */
90
+ measure: string;
91
+ contours: false | "lines" | "filled";
92
+ contourConfig: Required<ContourConfig>;
93
+ points: boolean;
94
+ pointConfig: Required<Omit<PointConfig, "fill">> & {
95
+ fill?: string;
96
+ };
97
+ }
98
+ /** `contourConfig`'s defaults. */
99
+ export declare const CONTOUR_DEFAULTS: Required<ContourConfig>;
100
+ /** `pointConfig`'s defaults (the fill follows the chart's text color). */
101
+ export declare const POINT_DEFAULTS: Required<Omit<PointConfig, "fill">>;
102
+ /** The default `binSize`, in pixels. */
103
+ export declare const BIN_SIZE = 12;
104
+ /** Walks Plot's `__d3plus__` wrappers down to the row. */
105
+ export declare function unwrapHexbinRow(d: DataPoint): DataPoint;
106
+ /** The measure a (possibly wrapped) bin or contour row carries, if any. */
107
+ export declare function hexbinMeta(d: DataPoint | undefined): HexbinMeta | undefined;
108
+ /** A bin's measure or a contour's level: what Hexbin's colorScale reads. */
109
+ export declare function hexbinValue(d: DataPoint): number | undefined;
110
+ /** A row holding a bin's or contour's measure. */
111
+ export declare function hexbinRow(id: string, meta: HexbinMeta): DataPoint;
112
+ /**
113
+ Resolves `binValue` to an aggregation, the accessor it aggregates, and
114
+ the name of what each bin measures.
115
+ */
116
+ export declare function resolveBinValue(option: unknown, translate: (s: string) => string): {
117
+ agg: BinAgg;
118
+ weight?: HexbinSettings["weight"];
119
+ measure: string;
120
+ };
121
+ /** Hexbin's options, resolved from its config for one draw. */
122
+ export declare function hexbinSettings(viz: VizInstance): HexbinSettings;
@@ -0,0 +1,26 @@
1
+ /**
2
+ Hexbin's tooltip and aria text: a bin's measure and its x and y ranges,
3
+ or a contour's density range.
4
+
5
+ @module
6
+ */
7
+ import type { DataPoint } from "@d3plus/data";
8
+ import type { VizInstance } from "../viz/vizTypes.js";
9
+ /**
10
+ A contour level's value as text: through `levelFormat` when set, or
11
+ abbreviated (`1.5k`).
12
+ @param viz The chart.
13
+ @param level The level.
14
+ */
15
+ export declare function contourLevelText(viz: VizInstance, level: number): string;
16
+ /** A bin's tooltip title: its measure, such as "Count: 42". */
17
+ export declare function hexbinTooltipTitle(viz: VizInstance, d: DataPoint): string;
18
+ /**
19
+ A bin's tooltip rows: its x and y ranges, and its count when it measures
20
+ something else. A contour's: its density range, in points per bin.
21
+ */
22
+ export declare function hexbinTooltipRows(viz: VizInstance, d: DataPoint): [string, string][];
23
+ /** A bin's accessible name: its measure, then its x and y ranges. */
24
+ export declare function binAriaLabel(viz: VizInstance, d: DataPoint): string;
25
+ /** A contour's accessible name: "Density" and its range. */
26
+ export declare function contourAriaLabel(viz: VizInstance, d: DataPoint): string;
@@ -3,6 +3,12 @@ import type { DataPoint } from "@d3plus/data";
3
3
  export type ThresholdGenerator = (values: ArrayLike<number>, min: number, max: number) => number | number[];
4
4
  /** How bin heights are normalized. */
5
5
  export type BinNormalize = "count" | "density" | "relative";
6
+ /**
7
+ Whether bin heights accumulate: `true` runs from the lowest bin up (values
8
+ below each bin's end), `"reverse"` from the highest bin down (values at or
9
+ above each bin's start).
10
+ */
11
+ export type BinCumulative = boolean | "reverse";
6
12
  export interface BinOptions {
7
13
  /** Numeric observation accessor. */
8
14
  value: (d: DataPoint, i: number) => unknown;
@@ -23,8 +29,13 @@ export interface BinOptions {
23
29
  width?: number;
24
30
  /** `"count"` (default), `"density"` (area sums to 1), or `"relative"` (heights sum to 1). */
25
31
  normalize?: BinNormalize;
32
+ /** Accumulate each group's counts across its bins (see `BinCumulative`). */
33
+ cumulative?: BinCumulative;
26
34
  }
27
- /** One bin of one group. Carries the group's first row's fields. */
35
+ /**
36
+ One bin of one group. Carries the group's first row's fields and, with
37
+ `cumulative`, a `cumulativeCount`: the group's running count through it.
38
+ */
28
39
  export interface BinRow extends DataPoint {
29
40
  /** Bin start (inclusive). */
30
41
  x0: number;
@@ -37,6 +48,14 @@ export interface BinRow extends DataPoint {
37
48
  /** The normalized height. */
38
49
  y: number;
39
50
  }
51
+ /**
52
+ The normalization a cumulative histogram draws: the running sum of a
53
+ density is the share of observations so far, so `"density"` reads as
54
+ `"relative"` (an empirical CDF).
55
+ */
56
+ export declare function cumulativeNormalize(normalize?: BinNormalize, cumulative?: BinCumulative): BinNormalize;
57
+ /** Running sums of `counts`, from the first bin or, with `"reverse"`, the last. */
58
+ export declare function accumulate(counts: number[], cumulative: BinCumulative): number[];
40
59
  /**
41
60
  Bins `rows` by `options.value`. Non-finite values are dropped. Every group
42
61
  gets a row for every bin of its panel (empty bins included, so stacks
@@ -7,8 +7,9 @@ export declare const histogramDef: ChartDefinition;
7
7
  /**
8
8
  Creates a histogram from an array of raw observations: the `value` of each
9
9
  row is binned along a linear x axis, and bar heights show each bin's
10
- count (or density / relative frequency via `binNormalize`). Series set by
11
- `groupBy` share bin edges and are stacked.
10
+ count (or density / relative frequency via `binNormalize`, and running
11
+ totals via `cumulative`). Series set by `groupBy` share bin edges and are
12
+ stacked.
12
13
  */
13
14
  declare const _default: new () => any;
14
15
  export default _default;
@@ -0,0 +1,7 @@
1
+ /** The English labels Histogram translates for its y axis and tooltip rows. */
2
+ import { type BinCumulative, type BinNormalize } from "./binData.js";
3
+ /**
4
+ The (untranslated) label for what a bar's height measures under
5
+ `binNormalize` and `cumulative`, used as the default y-axis title.
6
+ */
7
+ export declare function heightLabel(normalize?: BinNormalize, cumulative?: BinCumulative): string;
@@ -10,7 +10,8 @@ export declare const marimekkoDef: ChartDefinition;
10
10
  Creates a Marimekko (mosaic) chart from an array of data: one bar per
11
11
  discrete value (`x`), as wide as its `barWidth` (by default its total),
12
12
  with the bar's `groupBy` segments stacked to 100% of its height. Each
13
- category's label shows its bar's share of the total width, and tooltips
13
+ category is named beneath its bar, with the bar's share of the total
14
+ width above it (see `barWidthShare`), and tooltips
14
15
  show each segment's value, its share of the bar, and the bar's width and
15
16
  share of the total width. Set `stackOffset("none")` to stack absolute
16
17
  values instead.
@@ -2,8 +2,10 @@
2
2
  `applyMatrixLayout` — Matrix's chart-specific layout stage.
3
3
 
4
4
  Two-pass axis layout: measure-only pass for padding, then compute-mode
5
- render that absorbs row/column axis scenes into `_chartScene`. Stashes
6
- `columnScale`/`rowScale`/`cellWidth`/`cellHeight` on `viz.ctx`.
5
+ render that absorbs row/column axis scenes into `_chartScene` as chrome
6
+ (see `inertAxis`), their labels following the hover (see
7
+ `tagHoverTicks`). Stashes `columnScale`/`rowScale`/`cellWidth`/
8
+ `cellHeight` on `viz.ctx`.
7
9
  */
8
10
  import type { TransformStage } from "../pipeline/stages.js";
9
11
  export declare const applyMatrixLayout: TransformStage;
@@ -8,6 +8,16 @@
8
8
  */
9
9
  import type { TransformStage } from "../pipeline/stages.js";
10
10
  import type { SizeLegendScale } from "../../components/SizeLegend/sizeLegendLayout.js";
11
+ import type { GraphNode } from "./graph.js";
12
+ /** Single laid-out node — accreted across the layout's passes. */
13
+ type NetworkNode = GraphNode;
14
+ /**
15
+ Places `lone` (nodes no link pulls on) in rows under `placed`, as far
16
+ apart as the placed nodes typically sit from their nearest neighbor,
17
+ the rows centered beneath them. Without placed nodes the rows form a
18
+ square-ish grid.
19
+ */
20
+ export declare function placeLoneNodes(placed: NetworkNode[], lone: NetworkNode[]): void;
11
21
  /**
12
22
  Network's size-legend scale for a chart area of `width` × `height`: the
13
23
  same node set, positions, and fitted radius scale the layout builds, run
@@ -16,3 +26,4 @@ import type { SizeLegendScale } from "../../components/SizeLegend/sizeLegendLayo
16
26
  */
17
27
  export declare function networkSizeLegendScale(v: Parameters<TransformStage>[0]["viz"], width: number, height: number): SizeLegendScale | null;
18
28
  export declare const applyNetworkLayout: TransformStage;
29
+ export {};
@@ -0,0 +1,69 @@
1
+ /**
2
+ Network's `linkBundle`: each link between two distinct nodes takes a
3
+ bundled path (`points`, from its source's center to its target's), and
4
+ these helpers draw it: the visible stroke ending inside its arrowheads,
5
+ the heads aimed along the curve where it leaves each node, the label
6
+ anchor, and the box a click focus zooms to.
7
+ */
8
+ import type { DataPoint } from "@d3plus/data";
9
+ import type { SceneNode } from "@d3plus/render";
10
+ import type { LinkAnchor } from "../features/linkLabelGeometry.js";
11
+ import type { Point } from "../features/polyline.js";
12
+ import type { VizInstance } from "../viz/vizTypes.js";
13
+ /** What the bundling reads and writes on a laid-out link. */
14
+ export interface BundledLink {
15
+ source?: {
16
+ id?: unknown;
17
+ x?: number;
18
+ y?: number;
19
+ r?: number;
20
+ } | null;
21
+ target?: {
22
+ id?: unknown;
23
+ x?: number;
24
+ y?: number;
25
+ r?: number;
26
+ } | null;
27
+ loop?: unknown;
28
+ points?: Point[];
29
+ }
30
+ /**
31
+ Gives each link between two distinct, placed nodes its bundled path
32
+ when `linkBundle` is on. Loops keep their own shape.
33
+ */
34
+ export declare function bundleNetworkLinks(viz: VizInstance, links: BundledLink[]): void;
35
+ /**
36
+ How far along a bundled path each end's arrow tip sits: where the path
37
+ leaves a circle a pixel wider than the node at that end.
38
+ */
39
+ export declare function bundledTipBack(points: Point[], rSource?: number, rTarget?: number): {
40
+ source: number;
41
+ target: number;
42
+ };
43
+ /**
44
+ A bundled link's visible stroke and arrowheads: the stroke follows the
45
+ path and ends inside each head, and each head's tip sits a pixel off its
46
+ node, aimed along the path (see `polylineArrowEdge`). `arrowSize`
47
+ defaults to the chart's.
48
+ */
49
+ export declare function bundledLinkEdge(viz: VizInstance, link: BundledLink & {
50
+ points: Point[];
51
+ }, opts: {
52
+ datum: DataPoint;
53
+ i: number;
54
+ strokeWidth: unknown;
55
+ arrowSize?: unknown;
56
+ keyPrefix: string;
57
+ fill?: string;
58
+ }): {
59
+ d: string;
60
+ arrows: SceneNode[];
61
+ };
62
+ /** A bundled link's run between the edges of its two nodes. */
63
+ export declare function bundledLinkPath(link: BundledLink & {
64
+ points: Point[];
65
+ }): Point[];
66
+ /** The middle of a bundled link's run between the edges of its two nodes. */
67
+ export declare function bundledLinkAnchor(link: BundledLink & {
68
+ points: Point[];
69
+ }): LinkAnchor;
@@ -0,0 +1,112 @@
1
+ /**
2
+ Cluster names on a Network: each cluster's name (see `clusters.ts`)
3
+ written inside the hull of its nodes, at the open spot nearest the
4
+ cluster's middle, clear of every node, every node label beside its node,
5
+ and the other names. A name shrinks to fit, down to `fontMin`, and a
6
+ cluster with no room for it goes unnamed. Names are inert to the pointer
7
+ and keyboard, in the chart's ink over a halo of its background.
8
+ */
9
+ import type { Bounds } from "@d3plus/math";
10
+ import type { SceneNode } from "@d3plus/render";
11
+ import type { VizInstance } from "../viz/vizTypes.js";
12
+ type Point = [number, number];
13
+ /** `clusterConfig.labelConfig`'s defaults. */
14
+ export declare const CLUSTER_LABEL_DEFAULTS: {
15
+ fontMax: number;
16
+ fontMin: number;
17
+ padding: number;
18
+ };
19
+ /** The resolved `clusterConfig.labelConfig`, or null when names stay off the chart. */
20
+ export interface ClusterLabelSettings {
21
+ fontMax: number;
22
+ fontMin: number;
23
+ padding: number;
24
+ /** The rest, as TextBox config (fontColor, fontFamily, fontWeight, …). */
25
+ text: Record<string, unknown>;
26
+ }
27
+ /** Reads `clusterConfig.labelConfig`, with its defaults for anything missing or invalid. */
28
+ export declare function clusterLabelSettings(viz: VizInstance): ClusterLabelSettings | null;
29
+ /** A circle a name keeps clear of. */
30
+ export interface ClusterLabelCircle {
31
+ x: number;
32
+ y: number;
33
+ r: number;
34
+ }
35
+ /**
36
+ A grid of buckets over the circles and boxes names keep clear of, so a
37
+ test only checks the obstacles near it. `add` puts a placed name in.
38
+ */
39
+ export declare function clusterLabelObstacles(circles: readonly ClusterLabelCircle[], boxes: readonly Bounds[], cell?: number): {
40
+ hits: (box: Bounds) => boolean;
41
+ add: (box: Bounds) => void;
42
+ };
43
+ /**
44
+ The nearest of `points` to a position, found ring by ring through a grid
45
+ of `cell`-pixel buckets, or undefined when there are none.
46
+ */
47
+ export declare function nearestPoint<T extends {
48
+ x: number;
49
+ y: number;
50
+ }>(points: readonly T[], cell?: number): (x: number, y: number) => T | undefined;
51
+ /**
52
+ The spot for a `width` × `height` box inside the convex `hull` whose
53
+ middle is nearest `target`, among a grid of middles at most `step`
54
+ pixels apart, where `blocked` is false; or null when there is none.
55
+ `blocked` receives the box grown by `padding`. A box is inside when
56
+ `polygonContains` holds at its four corners; the spots of a grid row
57
+ share their corners' rows, so each row's edge crossings are found once.
58
+ */
59
+ export declare function placeClusterLabel(hull: readonly Point[], size: {
60
+ width: number;
61
+ height: number;
62
+ }, target: Point, blocked: (box: Bounds) => boolean, padding?: number, step?: number): Bounds | null;
63
+ /** A laid-out node, as Network's emitter holds it. */
64
+ interface ClusterNode {
65
+ id: string;
66
+ x: number;
67
+ y: number;
68
+ r: number;
69
+ shape?: string;
70
+ width?: number;
71
+ height?: number;
72
+ }
73
+ /** A placed name: its text, font size, and box. */
74
+ export interface ClusterLabel {
75
+ key: string;
76
+ text: string;
77
+ fontSize: number;
78
+ box: Bounds;
79
+ }
80
+ /**
81
+ Where a cluster's name may go: the convex hull around its nodes, grown
82
+ by `margin` past each node's edge, and the members' mean position.
83
+ */
84
+ export declare function clusterRegion(members: readonly ClusterLabelCircle[], margin: number): {
85
+ hull: Point[];
86
+ target: Point;
87
+ } | null;
88
+ /**
89
+ Places each cluster's name (largest cluster first) in its region (see
90
+ `clusterRegion`, grown by `fontMax`), at the open spot nearest its
91
+ middle whose ends and middle all lie nearer one of its own nodes than
92
+ any other node, at the largest font size from `fontMax` down to
93
+ `fontMin` that finds one. A cluster with fewer than three drawn nodes
94
+ goes unnamed.
95
+ @param besides The boxes of node labels drawn beside their nodes.
96
+ */
97
+ export declare function layoutClusterLabels(viz: VizInstance, nodes: readonly ClusterNode[], besides: readonly Bounds[]): ClusterLabel[];
98
+ /** The placed names as text nodes, inert, in the chart's ink over a halo of its background. */
99
+ export declare function emitClusterLabels(viz: VizInstance, labels: readonly ClusterLabel[]): SceneNode[];
100
+ /**
101
+ Network's cluster names, as text nodes, and the boxes they cover (which
102
+ link labels keep clear of).
103
+ @param placed Each node's label placement; those beside a node are obstacles.
104
+ */
105
+ export declare function networkClusterLabels(viz: VizInstance, nodes: readonly ClusterNode[], placed: ReadonlyMap<unknown, {
106
+ position: string;
107
+ box?: Bounds;
108
+ }>): {
109
+ scene: SceneNode[];
110
+ boxes: Bounds[];
111
+ };
112
+ export {};