@d3plus/core 4.9.0 → 4.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (687) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +170 -9
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +170 -0
  9. package/es/src/charts/Alluvial/layout.js +137 -0
  10. package/es/src/charts/Alluvial/meta.js +57 -0
  11. package/es/src/charts/Alluvial/titles.js +81 -0
  12. package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
  13. package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
  14. package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
  15. package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
  16. package/es/src/charts/ArcDiagram/emit.js +178 -0
  17. package/es/src/charts/ArcDiagram/events.js +144 -0
  18. package/es/src/charts/ArcDiagram/index.js +215 -0
  19. package/es/src/charts/BarChart/index.js +14 -2
  20. package/es/src/charts/BoxWhisker/index.js +95 -4
  21. package/es/src/charts/BoxWhisker/outliers.js +68 -0
  22. package/es/src/charts/BoxWhisker/summary.js +83 -0
  23. package/es/src/charts/BoxWhisker/tooltip.js +122 -0
  24. package/es/src/charts/BubbleChart/emit.js +31 -0
  25. package/es/src/charts/BubbleChart/index.js +54 -0
  26. package/es/src/charts/Bullet/index.js +2 -1
  27. package/es/src/charts/BumpChart/index.js +5 -0
  28. package/es/src/charts/Calendar/emit.js +1 -1
  29. package/es/src/charts/Calendar/index.js +5 -3
  30. package/es/src/charts/Candlestick/aggregate.js +11 -1
  31. package/es/src/charts/Candlestick/buffer.js +6 -4
  32. package/es/src/charts/Candlestick/index.js +7 -6
  33. package/es/src/charts/Chord/applyLayout.js +56 -69
  34. package/es/src/charts/Chord/emit.js +55 -24
  35. package/es/src/charts/Chord/index.js +17 -12
  36. package/es/src/charts/Chord/labels.js +105 -0
  37. package/es/src/charts/Donut/index.js +5 -11
  38. package/es/src/charts/Dumbbell/index.js +2 -4
  39. package/es/src/charts/Funnel/index.js +2 -1
  40. package/es/src/charts/Gantt/applyLayout.js +162 -0
  41. package/es/src/charts/Gantt/emit.js +142 -0
  42. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  43. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  44. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  45. package/es/src/charts/Gantt/ganttRows.js +111 -0
  46. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  47. package/es/src/charts/Gantt/index.js +219 -0
  48. package/es/src/charts/Gauge/index.js +2 -1
  49. package/es/src/charts/Geomap/applyLayout.js +90 -49
  50. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  51. package/es/src/charts/Geomap/emit.js +19 -2
  52. package/es/src/charts/Geomap/flowEmit.js +132 -0
  53. package/es/src/charts/Geomap/flowEvents.js +86 -0
  54. package/es/src/charts/Geomap/flowFields.js +91 -0
  55. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  56. package/es/src/charts/Geomap/flowLinks.js +239 -0
  57. package/es/src/charts/Geomap/geoCache.js +180 -0
  58. package/es/src/charts/Geomap/globeKeys.js +131 -0
  59. package/es/src/charts/Geomap/globeRotate.js +208 -0
  60. package/es/src/charts/Geomap/index.js +60 -19
  61. package/es/src/charts/Geomap/pointLabels.js +107 -0
  62. package/es/src/charts/Hexbin/binning.js +103 -0
  63. package/es/src/charts/Hexbin/buffer.js +33 -0
  64. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  65. package/es/src/charts/Hexbin/contours.js +48 -0
  66. package/es/src/charts/Hexbin/emit.js +142 -0
  67. package/es/src/charts/Hexbin/index.js +204 -0
  68. package/es/src/charts/Hexbin/layers.js +212 -0
  69. package/es/src/charts/Hexbin/settings.js +86 -0
  70. package/es/src/charts/Hexbin/tooltip.js +77 -0
  71. package/es/src/charts/Histogram/binData.js +31 -4
  72. package/es/src/charts/Histogram/index.js +37 -16
  73. package/es/src/charts/Histogram/labels.js +18 -0
  74. package/es/src/charts/Icicle/index.js +3 -3
  75. package/es/src/charts/LinePlot/index.js +7 -0
  76. package/es/src/charts/Marimekko/index.js +7 -4
  77. package/es/src/charts/Matrix/index.js +3 -2
  78. package/es/src/charts/Network/applyLayout.js +138 -94
  79. package/es/src/charts/Network/bundle.js +81 -0
  80. package/es/src/charts/Network/clusterLabels.js +423 -0
  81. package/es/src/charts/Network/clusters.js +290 -0
  82. package/es/src/charts/Network/emit.js +253 -70
  83. package/es/src/charts/Network/graph.js +117 -0
  84. package/es/src/charts/Network/graphFluent.js +79 -0
  85. package/es/src/charts/Network/index.js +93 -108
  86. package/es/src/charts/Network/minNodeDistance.js +64 -0
  87. package/es/src/charts/Network/polygonRows.js +44 -0
  88. package/es/src/charts/Pack/index.js +7 -2
  89. package/es/src/charts/Pie/applyLayout.js +86 -27
  90. package/es/src/charts/Pie/arcFit.js +152 -0
  91. package/es/src/charts/Pie/curvedLabels.js +134 -0
  92. package/es/src/charts/Pie/emit.js +43 -96
  93. package/es/src/charts/Pie/index.js +66 -32
  94. package/es/src/charts/Pie/labelRoom.js +154 -0
  95. package/es/src/charts/Pie/outsideLabels.js +224 -0
  96. package/es/src/charts/Pie/outsideNodes.js +267 -0
  97. package/es/src/charts/Pie/pieLabels.js +137 -0
  98. package/es/src/charts/Pie/sectorBox.js +223 -0
  99. package/es/src/charts/Pie/straightLabels.js +96 -0
  100. package/es/src/charts/Pie/straightLayout.js +215 -0
  101. package/es/src/charts/Plot/alongLegend.js +76 -0
  102. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  103. package/es/src/charts/Plot/axisHover.js +180 -0
  104. package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
  105. package/es/src/charts/Plot/axisHoverScene.js +203 -0
  106. package/es/src/charts/Plot/axisValues.js +43 -0
  107. package/es/src/charts/Plot/barHitArea.js +81 -0
  108. package/es/src/charts/Plot/barLabelFit.js +123 -0
  109. package/es/src/charts/Plot/barWidth.js +61 -13
  110. package/es/src/charts/Plot/circleLabels.js +98 -0
  111. package/es/src/charts/Plot/confidenceConfig.js +2 -2
  112. package/es/src/charts/Plot/connectGaps.js +237 -0
  113. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  114. package/es/src/charts/Plot/draw.js +14 -4
  115. package/es/src/charts/Plot/fillBetween.js +2 -1
  116. package/es/src/charts/Plot/forecastScene.js +3 -4
  117. package/es/src/charts/Plot/index.js +42 -15
  118. package/es/src/charts/Plot/labelPlacement.js +10 -2
  119. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  120. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  121. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  122. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  123. package/es/src/charts/Plot/openDomainEnds.js +2 -5
  124. package/es/src/charts/Plot/pipeline.js +71 -22
  125. package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
  126. package/es/src/charts/Plot/pipelineDomains.js +23 -6
  127. package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
  128. package/es/src/charts/Plot/pipelineScales.js +40 -8
  129. package/es/src/charts/Plot/plotFacet.js +12 -1
  130. package/es/src/charts/Plot/plotInit.js +49 -5
  131. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  132. package/es/src/charts/Plot/plotZoom.js +15 -6
  133. package/es/src/charts/Plot/referenceDomains.js +133 -0
  134. package/es/src/charts/Plot/shapeDefaults.js +14 -9
  135. package/es/src/charts/Plot/sharedHoverScene.js +50 -31
  136. package/es/src/charts/Plot/sharedTooltip.js +19 -7
  137. package/es/src/charts/Plot/stackHelpers.js +13 -1
  138. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  139. package/es/src/charts/Plot/stackShareTooltip.js +9 -4
  140. package/es/src/charts/Plot/stackThreshold.js +154 -0
  141. package/es/src/charts/Plot/trendLabels.js +183 -0
  142. package/es/src/charts/Plot/trendLines.js +1 -0
  143. package/es/src/charts/Plot/trendScene.js +6 -3
  144. package/es/src/charts/Plot/trendTooltip.js +5 -1
  145. package/es/src/charts/PolarArea/index.js +5 -4
  146. package/es/src/charts/Priestley/applyLayout.js +14 -20
  147. package/es/src/charts/Priestley/index.js +4 -34
  148. package/es/src/charts/Priestley/timeAxis.js +100 -0
  149. package/es/src/charts/Pyramid/index.js +4 -2
  150. package/es/src/charts/Radar/axisDecorations.js +49 -12
  151. package/es/src/charts/Radar/curvedLabels.js +187 -0
  152. package/es/src/charts/Radar/index.js +5 -5
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +4 -1
  155. package/es/src/charts/RadialBar/index.js +18 -10
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/index.js +6 -9
  158. package/es/src/charts/Rings/applyLayout.js +41 -24
  159. package/es/src/charts/Rings/emit.js +174 -58
  160. package/es/src/charts/Rings/index.js +65 -30
  161. package/es/src/charts/Rings/ringsGraph.js +28 -9
  162. package/es/src/charts/Rings/ringsLoops.js +73 -0
  163. package/es/src/charts/Rings/ringsParallel.js +166 -0
  164. package/es/src/charts/Sankey/applyLayout.js +116 -39
  165. package/es/src/charts/Sankey/circularLayout.js +208 -0
  166. package/es/src/charts/Sankey/circularLinks.js +301 -0
  167. package/es/src/charts/Sankey/emit.js +164 -94
  168. package/es/src/charts/Sankey/index.js +75 -77
  169. package/es/src/charts/Sankey/labels.js +80 -0
  170. package/es/src/charts/Sankey/ribbons.js +88 -0
  171. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  172. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  173. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  174. package/es/src/charts/Scatter/index.js +25 -0
  175. package/es/src/charts/SlopeChart/index.js +116 -0
  176. package/es/src/charts/SlopeChart/slope.js +95 -0
  177. package/es/src/charts/Streamgraph/index.js +51 -0
  178. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  179. package/es/src/charts/Sunburst/emit.js +74 -63
  180. package/es/src/charts/Sunburst/index.js +3 -3
  181. package/es/src/charts/Tree/index.js +2 -6
  182. package/es/src/charts/Treemap/applyLayout.js +14 -1
  183. package/es/src/charts/Treemap/emit.js +8 -2
  184. package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
  185. package/es/src/charts/Treemap/groupHeaders.js +95 -0
  186. package/es/src/charts/Treemap/index.js +17 -7
  187. package/es/src/charts/Treemap/thresholdFunction.js +11 -9
  188. package/es/src/charts/Violin/inner.js +3 -5
  189. package/es/src/charts/Waffle/index.js +4 -2
  190. package/es/src/charts/Waffle/tooltip.js +6 -2
  191. package/es/src/charts/Waterfall/index.js +4 -2
  192. package/es/src/charts/definition/makeChart.js +20 -5
  193. package/es/src/charts/drawSteps/backControl.js +17 -5
  194. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  195. package/es/src/charts/drawSteps/minimap.js +6 -5
  196. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  197. package/es/src/charts/drawSteps/saveChart.js +176 -0
  198. package/es/src/charts/drawSteps/saveControl.js +148 -0
  199. package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
  200. package/es/src/charts/drawSteps/searchControls.js +2 -1
  201. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  202. package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
  203. package/es/src/charts/drawSteps/topLeftControls.js +3 -1
  204. package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
  205. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  206. package/es/src/charts/events/click.legend.js +7 -2
  207. package/es/src/charts/events/click.shape.js +38 -2
  208. package/es/src/charts/events/mouseenter.js +9 -0
  209. package/es/src/charts/events/mousemove.legend.js +3 -0
  210. package/es/src/charts/events/mousemove.shape.js +12 -4
  211. package/es/src/charts/facet/drawFacets.js +14 -5
  212. package/es/src/charts/facet/facetConfig.js +2 -2
  213. package/es/src/charts/facet/facetData.js +2 -2
  214. package/es/src/charts/features/annotationFrame.js +179 -0
  215. package/es/src/charts/features/annotationText.js +83 -0
  216. package/es/src/charts/features/annotationTypes.js +10 -0
  217. package/es/src/charts/features/attributionFeature.js +6 -11
  218. package/es/src/charts/features/axes.js +9 -7
  219. package/es/src/charts/features/axesFinal.js +26 -4
  220. package/es/src/charts/features/axesMeasure.js +61 -6
  221. package/es/src/charts/features/calloutLayout.js +121 -0
  222. package/es/src/charts/features/calloutScene.js +155 -0
  223. package/es/src/charts/features/chartGeometry.js +1 -1
  224. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  225. package/es/src/charts/features/circleLabels.js +207 -0
  226. package/es/src/charts/features/colorScaleBucket.js +19 -1
  227. package/es/src/charts/features/colorScaleHover.js +70 -0
  228. package/es/src/charts/features/colorScaleValue.js +97 -0
  229. package/es/src/charts/features/curvedArrows.js +158 -0
  230. package/es/src/charts/features/edgeArrows.js +160 -4
  231. package/es/src/charts/features/edgeBundling.js +442 -0
  232. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  233. package/es/src/charts/features/ensureZoomDom.js +32 -8
  234. package/es/src/charts/features/features.js +45 -15
  235. package/es/src/charts/features/featuresColorScale.js +62 -8
  236. package/es/src/charts/features/featuresLegend.js +21 -32
  237. package/es/src/charts/features/legendKeys.js +64 -0
  238. package/es/src/charts/features/lineLabels.js +55 -46
  239. package/es/src/charts/features/linkBundle.js +19 -0
  240. package/es/src/charts/features/linkColor.js +72 -0
  241. package/es/src/charts/features/linkFields.js +86 -0
  242. package/es/src/charts/features/linkFocus.js +118 -0
  243. package/es/src/charts/features/linkInteraction.js +312 -0
  244. package/es/src/charts/features/linkKeys.js +20 -0
  245. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  246. package/es/src/charts/features/linkLabelPath.js +162 -0
  247. package/es/src/charts/features/linkLabels.js +340 -0
  248. package/es/src/charts/features/linkWidths.js +32 -0
  249. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  250. package/es/src/charts/features/pathLabels.js +50 -0
  251. package/es/src/charts/features/plotAnnotations.js +68 -17
  252. package/es/src/charts/features/plotPaint.js +42 -15
  253. package/es/src/charts/features/polyline.js +129 -0
  254. package/es/src/charts/features/referenceAnnotations.js +403 -0
  255. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  256. package/es/src/charts/features/ringLabelNodes.js +93 -0
  257. package/es/src/charts/features/ringLabels.js +222 -0
  258. package/es/src/charts/features/sceneBounds.js +26 -6
  259. package/es/src/charts/features/selfLoops.js +306 -0
  260. package/es/src/charts/features/shapeEmit.js +67 -30
  261. package/es/src/charts/features/shareKey.js +15 -0
  262. package/es/src/charts/features/sharedFields.js +15 -2
  263. package/es/src/charts/features/textHalo.js +29 -0
  264. package/es/src/charts/features/thresholdMembers.js +71 -0
  265. package/es/src/charts/helpers/densityChart.js +3 -1
  266. package/es/src/charts/helpers/valueTitle.js +6 -3
  267. package/es/src/charts/index.js +8 -0
  268. package/es/src/charts/partition/chartFields.js +6 -5
  269. package/es/src/charts/partition/hierarchy.js +2 -0
  270. package/es/src/charts/partition/interaction.js +9 -5
  271. package/es/src/charts/partition/zoom.js +7 -6
  272. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  273. package/es/src/charts/pipeline/preDrawData.js +77 -13
  274. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  275. package/es/src/charts/pipeline/vizDraw.js +40 -29
  276. package/es/src/charts/pipeline/vizPreDraw.js +29 -18
  277. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  278. package/es/src/charts/polar/config.js +2 -3
  279. package/es/src/charts/viz/Viz.js +82 -44
  280. package/es/src/charts/viz/VizBase.js +47 -19
  281. package/es/src/charts/viz/backgroundInk.js +13 -7
  282. package/es/src/charts/viz/dataPoller.js +52 -0
  283. package/es/src/charts/viz/focusRing.js +104 -0
  284. package/es/src/charts/viz/focusTargets.js +208 -0
  285. package/es/src/charts/viz/groupRow.js +35 -0
  286. package/es/src/charts/viz/history.js +74 -0
  287. package/es/src/charts/viz/interactionOpacity.js +19 -5
  288. package/es/src/charts/viz/keyboardNav.js +297 -0
  289. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  290. package/es/src/charts/viz/loaderFormat.js +114 -0
  291. package/es/src/charts/viz/missingFields.js +123 -0
  292. package/es/src/charts/viz/mountTarget.js +9 -0
  293. package/es/src/charts/viz/nearestHover.js +183 -0
  294. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  295. package/es/src/charts/viz/ordinalColor.js +14 -12
  296. package/es/src/charts/viz/pageTheme.js +83 -0
  297. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  298. package/es/src/charts/viz/pointVoronoi.js +124 -0
  299. package/es/src/charts/viz/reducedMotion.js +27 -0
  300. package/es/src/charts/viz/reportHandlerError.js +10 -0
  301. package/es/src/charts/viz/shapeClassTargets.js +18 -2
  302. package/es/src/charts/viz/simpleHover.js +2 -0
  303. package/es/src/charts/viz/vizClassName.js +31 -0
  304. package/es/src/charts/viz/vizDataPolling.js +172 -0
  305. package/es/src/charts/viz/vizDefaults.js +81 -23
  306. package/es/src/charts/viz/vizFields.js +53 -2
  307. package/es/src/charts/viz/vizRender.js +49 -28
  308. package/es/src/charts/viz/vizTheme.js +96 -0
  309. package/es/src/charts/viz/vizVisibility.js +14 -0
  310. package/es/src/components/Axis/Axis.js +34 -0
  311. package/es/src/components/Axis/AxisBottom.js +1 -0
  312. package/es/src/components/Axis/AxisLeft.js +1 -0
  313. package/es/src/components/Axis/AxisRight.js +1 -0
  314. package/es/src/components/Axis/AxisTop.js +1 -0
  315. package/es/src/components/Axis/axisBreak.js +4 -1
  316. package/es/src/components/Axis/axisDefaults.js +8 -10
  317. package/es/src/components/Axis/axisLabelAngle.js +175 -0
  318. package/es/src/components/Axis/axisLabelThinning.js +13 -4
  319. package/es/src/components/Axis/axisLayout.js +86 -19
  320. package/es/src/components/Axis/axisLayoutLabels.js +66 -13
  321. package/es/src/components/Axis/axisLayoutScale.js +10 -1
  322. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  323. package/es/src/components/Axis/axisRender.js +38 -9
  324. package/es/src/components/Axis/axisRounding.js +15 -4
  325. package/es/src/components/Axis/axisSlantWrap.js +39 -0
  326. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  327. package/es/src/components/Axis/powTicks.js +73 -0
  328. package/es/src/components/Axis/rangeBreaks.js +201 -0
  329. package/es/src/components/Axis/timeValues.js +19 -4
  330. package/es/src/components/ColorScale/ColorScale.js +42 -36
  331. package/es/src/components/ColorScale/bucketBounds.js +64 -0
  332. package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
  333. package/es/src/components/ColorScale/colorScaleRender.js +25 -1
  334. package/es/src/components/ColorScale/colorScaleScale.js +43 -24
  335. package/es/src/components/ColorScale/colorScaleType.js +26 -0
  336. package/es/src/components/Legend/Legend.js +3 -0
  337. package/es/src/components/Legend/legendConfig.js +2 -6
  338. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  339. package/es/src/components/TextBox.js +31 -65
  340. package/es/src/components/Timeline/Timeline.js +54 -54
  341. package/es/src/components/Timeline/brushSpan.js +78 -0
  342. package/es/src/components/Timeline/timelineConfig.js +27 -10
  343. package/es/src/components/Timeline/timelineMode.js +26 -0
  344. package/es/src/components/Timeline/timelineRender.js +51 -9
  345. package/es/src/components/Tooltip.js +28 -13
  346. package/es/src/components/fontStack.js +20 -0
  347. package/es/src/components/textBoxLayout.js +58 -21
  348. package/es/src/components/textBoxPath.js +73 -0
  349. package/es/src/components/textBoxScene.js +223 -0
  350. package/es/src/components/textBoxWords.js +70 -0
  351. package/es/src/shapes/Area.js +1 -0
  352. package/es/src/shapes/Bar.js +1 -0
  353. package/es/src/shapes/Box.js +67 -79
  354. package/es/src/shapes/Circle.js +1 -0
  355. package/es/src/shapes/Line.js +1 -0
  356. package/es/src/shapes/Path.js +1 -0
  357. package/es/src/shapes/Rect.js +1 -0
  358. package/es/src/shapes/Shape.js +1 -0
  359. package/es/src/shapes/Whisker.js +1 -0
  360. package/es/src/shapes/boxOutlierShape.js +19 -0
  361. package/es/src/shapes/boxStats.js +35 -0
  362. package/es/src/shapes/boxStyle.js +78 -0
  363. package/es/src/shapes/boxSummary.js +174 -0
  364. package/es/src/shapes/shapeStandalone.js +2 -0
  365. package/es/src/utils/BaseClass.js +44 -12
  366. package/es/src/utils/className.js +78 -0
  367. package/es/src/utils/configPrep.js +2 -1
  368. package/es/src/utils/configWarnings.js +25 -0
  369. package/es/src/utils/constant.js +13 -1
  370. package/es/src/utils/displayName.js +12 -0
  371. package/es/src/utils/fieldAccessor.js +31 -0
  372. package/es/src/utils/paintComponentScene.js +2 -0
  373. package/es/src/utils/theme.js +190 -0
  374. package/es/src/utils/themeInk.js +68 -0
  375. package/package.json +14 -10
  376. package/types/index.d.ts +8 -2
  377. package/types/internal.d.ts +253 -9
  378. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  379. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  380. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  381. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  382. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  383. package/types/src/charts/Alluvial/index.d.ts +27 -0
  384. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  385. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  386. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  387. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  388. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  389. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  390. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  391. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  392. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  393. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  394. package/types/src/charts/BoxWhisker/index.d.ts +3 -1
  395. package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
  396. package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
  397. package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
  398. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  399. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  400. package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
  401. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  402. package/types/src/charts/Chord/labels.d.ts +66 -0
  403. package/types/src/charts/Donut/index.d.ts +2 -1
  404. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  405. package/types/src/charts/Gantt/emit.d.ts +17 -0
  406. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  407. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  408. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  409. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  410. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  411. package/types/src/charts/Gantt/index.d.ts +36 -0
  412. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  413. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  414. package/types/src/charts/Geomap/emit.d.ts +2 -2
  415. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  416. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  417. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  418. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  419. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  420. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  421. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  422. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  423. package/types/src/charts/Geomap/index.d.ts +3 -0
  424. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  425. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  426. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  427. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  428. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  429. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  430. package/types/src/charts/Hexbin/index.d.ts +25 -0
  431. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  432. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  433. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  434. package/types/src/charts/Histogram/binData.d.ts +20 -1
  435. package/types/src/charts/Histogram/index.d.ts +3 -2
  436. package/types/src/charts/Histogram/labels.d.ts +7 -0
  437. package/types/src/charts/Marimekko/index.d.ts +2 -1
  438. package/types/src/charts/Network/bundle.d.ts +67 -0
  439. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  440. package/types/src/charts/Network/clusters.d.ts +115 -0
  441. package/types/src/charts/Network/graph.d.ts +65 -0
  442. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  443. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  444. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  445. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  446. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  447. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  448. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  449. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  450. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  451. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  452. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  453. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  454. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  455. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  456. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  457. package/types/src/charts/Plot/axisHover.d.ts +68 -0
  458. package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
  459. package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
  460. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  461. package/types/src/charts/Plot/barHitArea.d.ts +59 -0
  462. package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
  463. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  464. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  465. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  466. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  467. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  468. package/types/src/charts/Plot/index.d.ts +28 -8
  469. package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
  470. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  471. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  472. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  473. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  474. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  475. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  476. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  477. package/types/src/charts/Plot/plotInit.d.ts +23 -2
  478. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  479. package/types/src/charts/Plot/plotZoom.d.ts +2 -0
  480. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  481. package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
  482. package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
  483. package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
  484. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  485. package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
  486. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  487. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  488. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  489. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  490. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  491. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  492. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  493. package/types/src/charts/Rings/emit.d.ts +50 -0
  494. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  495. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  496. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  497. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  498. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  499. package/types/src/charts/Sankey/emit.d.ts +58 -0
  500. package/types/src/charts/Sankey/labels.d.ts +19 -0
  501. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  502. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  503. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  504. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  505. package/types/src/charts/Scatter/index.d.ts +15 -0
  506. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  507. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  508. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  509. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  510. package/types/src/charts/Treemap/emit.d.ts +2 -1
  511. package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
  512. package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
  513. package/types/src/charts/Treemap/index.d.ts +2 -0
  514. package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
  515. package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
  516. package/types/src/charts/definition/makeChart.d.ts +5 -3
  517. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  518. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  519. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  520. package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
  521. package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
  522. package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
  523. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
  524. package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
  525. package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
  526. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  527. package/types/src/charts/events/click.legend.d.ts +2 -1
  528. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  529. package/types/src/charts/facet/facetData.d.ts +1 -1
  530. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  531. package/types/src/charts/features/annotationText.d.ts +57 -0
  532. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  533. package/types/src/charts/features/axesMeasure.d.ts +13 -1
  534. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  535. package/types/src/charts/features/calloutScene.d.ts +40 -0
  536. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  537. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  538. package/types/src/charts/features/circleLabels.d.ts +130 -0
  539. package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
  540. package/types/src/charts/features/colorScaleHover.d.ts +32 -0
  541. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  542. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  543. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  544. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  545. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  546. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  547. package/types/src/charts/features/features.d.ts +8 -0
  548. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  549. package/types/src/charts/features/legendKeys.d.ts +34 -0
  550. package/types/src/charts/features/lineLabels.d.ts +15 -12
  551. package/types/src/charts/features/linkBundle.d.ts +16 -0
  552. package/types/src/charts/features/linkColor.d.ts +48 -0
  553. package/types/src/charts/features/linkFields.d.ts +16 -0
  554. package/types/src/charts/features/linkFocus.d.ts +51 -0
  555. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  556. package/types/src/charts/features/linkKeys.d.ts +11 -0
  557. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  558. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  559. package/types/src/charts/features/linkLabels.d.ts +77 -0
  560. package/types/src/charts/features/linkWidths.d.ts +19 -0
  561. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  562. package/types/src/charts/features/pathLabels.d.ts +41 -0
  563. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  564. package/types/src/charts/features/plotPaint.d.ts +19 -0
  565. package/types/src/charts/features/polyline.d.ts +32 -0
  566. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  567. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  568. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  569. package/types/src/charts/features/ringLabels.d.ts +164 -0
  570. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  571. package/types/src/charts/features/selfLoops.d.ts +165 -0
  572. package/types/src/charts/features/shapeEmit.d.ts +5 -1
  573. package/types/src/charts/features/shareKey.d.ts +9 -0
  574. package/types/src/charts/features/sharedFields.d.ts +11 -2
  575. package/types/src/charts/features/textHalo.d.ts +14 -0
  576. package/types/src/charts/features/thresholdMembers.d.ts +38 -0
  577. package/types/src/charts/helpers/valueTitle.d.ts +4 -2
  578. package/types/src/charts/index.d.ts +8 -0
  579. package/types/src/charts/partition/interaction.d.ts +6 -3
  580. package/types/src/charts/partition/zoom.d.ts +4 -4
  581. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  582. package/types/src/charts/pipeline/stages.d.ts +9 -0
  583. package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
  584. package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
  585. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  586. package/types/src/charts/viz/Viz.d.ts +44 -6
  587. package/types/src/charts/viz/VizBase.d.ts +16 -7
  588. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  589. package/types/src/charts/viz/dataPoller.d.ts +28 -0
  590. package/types/src/charts/viz/focusRing.d.ts +25 -0
  591. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  592. package/types/src/charts/viz/groupRow.d.ts +24 -0
  593. package/types/src/charts/viz/history.d.ts +35 -0
  594. package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
  595. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  596. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  597. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  598. package/types/src/charts/viz/missingFields.d.ts +57 -0
  599. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  600. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  601. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  602. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  603. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  604. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  605. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  606. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  607. package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
  608. package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
  609. package/types/src/charts/viz/simpleHover.d.ts +2 -1
  610. package/types/src/charts/viz/vizClassName.d.ts +23 -0
  611. package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
  612. package/types/src/charts/viz/vizDefaults.d.ts +49 -9
  613. package/types/src/charts/viz/vizFields.d.ts +47 -0
  614. package/types/src/charts/viz/vizRender.d.ts +2 -1
  615. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  616. package/types/src/charts/viz/vizTypes.d.ts +117 -8
  617. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  618. package/types/src/components/Axis/Axis.d.ts +37 -8
  619. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  620. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  621. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  622. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  623. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  624. package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
  625. package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
  626. package/types/src/components/Axis/axisLayout.d.ts +5 -0
  627. package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
  628. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  629. package/types/src/components/Axis/axisRounding.d.ts +6 -3
  630. package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
  631. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  632. package/types/src/components/Axis/powTicks.d.ts +29 -0
  633. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  634. package/types/src/components/Axis/timeValues.d.ts +1 -1
  635. package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
  636. package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
  637. package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
  638. package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
  639. package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
  640. package/types/src/components/Legend/Legend.d.ts +1 -0
  641. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  642. package/types/src/components/TextBox.d.ts +1 -0
  643. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  644. package/types/src/components/Timeline/brushSpan.d.ts +41 -0
  645. package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
  646. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  647. package/types/src/components/Timeline/timelineRender.d.ts +8 -0
  648. package/types/src/components/Tooltip.d.ts +12 -3
  649. package/types/src/components/fontStack.d.ts +10 -0
  650. package/types/src/components/textBoxLayout.d.ts +18 -9
  651. package/types/src/components/textBoxPath.d.ts +59 -0
  652. package/types/src/components/textBoxScene.d.ts +51 -0
  653. package/types/src/components/textBoxWords.d.ts +33 -0
  654. package/types/src/shapes/Area.d.ts +1 -0
  655. package/types/src/shapes/Bar.d.ts +1 -0
  656. package/types/src/shapes/Box.d.ts +2 -8
  657. package/types/src/shapes/Circle.d.ts +1 -0
  658. package/types/src/shapes/Line.d.ts +1 -0
  659. package/types/src/shapes/Path.d.ts +1 -0
  660. package/types/src/shapes/Rect.d.ts +1 -0
  661. package/types/src/shapes/Shape.d.ts +1 -0
  662. package/types/src/shapes/Whisker.d.ts +1 -0
  663. package/types/src/shapes/boxOutlierShape.d.ts +9 -0
  664. package/types/src/shapes/boxStats.d.ts +19 -0
  665. package/types/src/shapes/boxStyle.d.ts +25 -0
  666. package/types/src/shapes/boxSummary.d.ts +66 -0
  667. package/types/src/shapes/emitLabels.d.ts +1 -1
  668. package/types/src/shapes/shapeConfig.d.ts +42 -4
  669. package/types/src/utils/BaseClass.d.ts +32 -0
  670. package/types/src/utils/D3Scale.d.ts +3 -0
  671. package/types/src/utils/D3plusConfig.d.ts +1240 -33
  672. package/types/src/utils/className.d.ts +64 -0
  673. package/types/src/utils/configPrep.d.ts +2 -0
  674. package/types/src/utils/configWarnings.d.ts +21 -2
  675. package/types/src/utils/constant.d.ts +8 -0
  676. package/types/src/utils/displayName.d.ts +10 -0
  677. package/types/src/utils/fieldAccessor.d.ts +24 -0
  678. package/types/src/utils/index.d.ts +1 -1
  679. package/types/src/utils/paintComponentScene.d.ts +3 -1
  680. package/types/src/utils/theme.d.ts +170 -0
  681. package/types/src/utils/themeInk.d.ts +56 -0
  682. package/umd/d3plus-core.full.js +87388 -56271
  683. package/umd/d3plus-core.full.min.js +2 -2
  684. package/umd/d3plus-core.js +37988 -11768
  685. package/umd/d3plus-core.min.js +2 -2
  686. package/es/src/components/Axis/gridStroke.js +0 -10
  687. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -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 {};
@@ -0,0 +1,115 @@
1
+ /**
2
+ Cluster colors for the node-link charts (Network, ArcDiagram): when the
3
+ chart's color is left to its defaults, each node takes the color of the
4
+ community `louvain` finds it in, named after the community's
5
+ most-connected node, so the legend lists the clusters.
6
+ */
7
+ import type { DataPoint } from "@d3plus/data";
8
+ import type { ConfigField } from "../../fluent.js";
9
+ import type { VizInstance } from "../viz/vizTypes.js";
10
+ import type { GraphLink, GraphNode } from "./graph.js";
11
+ type Comparator = (a: DataPoint, b: DataPoint) => number;
12
+ /** A cluster's index, name, members, and most-connected node. */
13
+ export interface ClusterInfo {
14
+ /** 0 is the largest cluster. */
15
+ index: number;
16
+ name: string;
17
+ /** The members' node ids. */
18
+ ids: string[];
19
+ /** The id of the member with the most links. */
20
+ hub: string;
21
+ }
22
+ /** What the chart's clusters are, for its color accessor and its labels. */
23
+ export interface ClusterState {
24
+ /** Whether nodes are colored by cluster in this draw. */
25
+ active: boolean;
26
+ /** Each node id's color value: its cluster's name, or its own label when it is in no cluster. */
27
+ names: Map<string, string>;
28
+ /** The clusters of two or more nodes, largest first (ties by name). */
29
+ clusters: ClusterInfo[];
30
+ }
31
+ /** The `cluster` and `clusterConfig` fields. */
32
+ export declare function clusterFields(): ConfigField[];
33
+ /** The `color` and `shapeConfig.fill` the chart started with. */
34
+ export interface ClusterDefaults {
35
+ color: unknown;
36
+ fill: unknown;
37
+ }
38
+ /**
39
+ Whether nodes are colored by cluster: `cluster` is on, and the chart's
40
+ colors are its defaults (no `colorScale`, no `colorOrdinal`, the
41
+ starting `color` and `shapeConfig.fill`, and no fill on the Circle or
42
+ Rect shape config), with a single `groupBy` level.
43
+ @param schema The chart's config.
44
+ @param defaults The `color` and `shapeConfig.fill` the chart started with.
45
+ */
46
+ export declare function clusterAutoActive(schema: Record<string, unknown>, defaults: ClusterDefaults): boolean;
47
+ /**
48
+ The clusters `louvain` finds among the nodes, as lists of node ids,
49
+ largest first, weighted by each link's `linkSize` value (1 when it isn't
50
+ a positive number). Links from a node to itself are left out.
51
+ */
52
+ export declare function findClusters(nodes: Pick<GraphNode, "id">[], links: Pick<GraphLink, "source" | "target" | "size">[]): string[][];
53
+ /**
54
+ Whether clusters say more than one color per node would: at least two
55
+ clusters of two or more nodes. One cluster holding every linked node
56
+ (or no links at all) leaves each node its own color.
57
+ */
58
+ export declare function clustersMeaningful(clusters: string[][]): boolean;
59
+ /** The most clusters `clusterConfig.max` keeps by default. */
60
+ export declare const CLUSTER_MAX = 12;
61
+ /**
62
+ Keeps at most `max` clusters of two or more nodes (lone nodes are left
63
+ as they are). While there are more, the smallest (the last listed of the
64
+ smallest) joins the cluster it shares the most link weight with (ties go
65
+ to the larger cluster, then the one listed first), or the largest
66
+ cluster when it has no links to any other. Returns the clusters largest
67
+ first (ties in their listed order), lone nodes last.
68
+ @param clusters Node id lists, largest first (see `findClusters`).
69
+ @param max The most clusters to keep; anything below 1 keeps them all.
70
+ */
71
+ export declare function capClusters(clusters: string[][], links: Pick<GraphLink, "source" | "target" | "size">[], max: number): string[][];
72
+ /**
73
+ Each cluster's most-connected node: the member with the most links to
74
+ other nodes, then the greatest total `size`, then the first listed.
75
+ */
76
+ export declare function clusterHubs(clusters: string[][], links: Pick<GraphLink, "source" | "target" | "size">[]): string[];
77
+ /**
78
+ A cluster's default name: the translated "{node} cluster" with its hub's
79
+ label in place of `{node}`.
80
+ */
81
+ export declare function clusterName(translate: (s: string) => string, label: string): string;
82
+ /**
83
+ The legend's rows: one per cluster, its members' rows merged, and one
84
+ per node in no cluster. A key holding each member's own id (such as
85
+ `id`) is kept as the list of member ids, not merged by value, so the row
86
+ still names every member even when the ids are numbers.
87
+ */
88
+ export declare function clusterLegendRows(viz: VizInstance, clusters: ClusterInfo[], nodes: GraphNode[]): DataPoint[];
89
+ /**
90
+ Works out this draw's clusters onto `viz.ctx.clusterState`: inactive
91
+ unless `clusterAutoActive` holds and the clusters are meaningful. While
92
+ active, the legend lists every node's row (so a network with `nodes` and
93
+ no `data` gets one), and the clusters claim the palette largest first.
94
+ */
95
+ export declare function prepareClusters(viz: VizInstance): void;
96
+ /**
97
+ The cluster a row's node (or every node of a merged row) belongs to, or
98
+ undefined when clusters are off or the row's nodes differ.
99
+ */
100
+ export declare function clusterOf(viz: VizInstance, d: DataPoint, i: number): string | undefined;
101
+ /**
102
+ The legend order: while clusters are active, the clusters largest first
103
+ (the order they take the palette in), then any lone nodes by `base`;
104
+ otherwise `base`.
105
+ */
106
+ export declare function clusterLegendSort(viz: VizInstance, base: Comparator): Comparator;
107
+ /**
108
+ Installs cluster colors on a Network or ArcDiagram: `color` becomes an
109
+ accessor returning a node's cluster name while clusters are active (and
110
+ the default `groupBy` color otherwise), `legendSort` lists the clusters
111
+ largest first (see `clusterLegendSort`), and `_preDraw` works out the
112
+ clusters before the legend is laid out.
113
+ */
114
+ export declare function installClusters(viz: VizInstance): void;
115
+ export {};
@@ -0,0 +1,65 @@
1
+ /**
2
+ Node and link resolution shared by the node-link charts (Network,
3
+ ArcDiagram): merges `data` onto `nodes` by id, and resolves each link's
4
+ `source`/`target` (an index into `nodes`, a node object, or an id string)
5
+ to its node record.
6
+ */
7
+ import type { SimulationNodeDatum } from "d3-force";
8
+ import type { DataPoint } from "@d3plus/data";
9
+ import type { VizInstance } from "../viz/vizTypes.js";
10
+ import type { LinkDatum, LinkEnd } from "../features/linkInteraction.js";
11
+ import type { SelfLoopGeometry } from "../features/selfLoops.js";
12
+ /** One resolved node: its merged row, its `nodes` entry, and its sizing inputs. */
13
+ export interface GraphNode extends SimulationNodeDatum {
14
+ __d3plus__: true;
15
+ /** The `data` row for this node, or its `nodes` entry when no row matches. */
16
+ data: DataPoint;
17
+ i: number;
18
+ id: string;
19
+ fx: number;
20
+ fy: number;
21
+ /** The node's entry in `nodes`. */
22
+ node: DataPoint;
23
+ /** The node's raw `size` value (or `sizeMin` when unsized), before scaling. */
24
+ r: number;
25
+ shape: string;
26
+ width?: number;
27
+ height?: number;
28
+ }
29
+ /** One resolved link: its endpoints' node records and its raw `linkSize` value. */
30
+ export interface GraphLink {
31
+ source: GraphNode;
32
+ target: GraphNode;
33
+ size: number;
34
+ /** The datum the link is drawn with, when both its ends resolve (see `makeLinkDatum`). */
35
+ datum?: LinkDatum;
36
+ /** The loop a link from a node to itself draws as, once laid out. */
37
+ loop?: SelfLoopGeometry;
38
+ /** The link's bundled path, from its source to its target (see `linkBundle`). */
39
+ points?: [number, number][];
40
+ }
41
+ /** A node record as a link end. */
42
+ export declare const graphLinkEnd: (n: GraphNode) => LinkEnd;
43
+ /** A node row's id: its `groupBy` id, else its `nodeGroupBy` id at the drawn depth. */
44
+ export declare function graphNodeId(viz: VizInstance, d: Record<string, unknown>, i: number): string;
45
+ /**
46
+ Resolves the filtered data and `nodes` into node records, in the order the
47
+ ids first appear (data rows, then nodes). Only ids present in `nodes`
48
+ become nodes; a matching data row supplies a node's values. `fx`/`fy` read
49
+ the chart's `x`/`y` accessors when it has them.
50
+ */
51
+ export declare function resolveGraphNodes(v: VizInstance): GraphNode[];
52
+ /**
53
+ Resolves `links` against `nodes`, index-aligned with `links`: an endpoint
54
+ that matches no node is undefined. A link whose ends both resolve gets its
55
+ datum, which `linkSize` receives (with the link's index). Stashes the id → node lookup on
56
+ `v.ctx.nodeLookup` and the id → neighbor nodes lookup on
57
+ `v.ctx.linkLookup` (a link from a node to itself adds no neighbor).
58
+ */
59
+ export declare function resolveGraphLinks(v: VizInstance, nodes: GraphNode[]): GraphLink[];
60
+ /**
61
+ Zooms to a node-space extent. Node coordinates sit under the chart's
62
+ margin-origin transform and the current zoom, so they're mapped to their
63
+ on-screen position first — the space `_zoomToBounds` expects.
64
+ */
65
+ export declare function zoomToNodeBounds(viz: VizInstance, xDomain: number[], yDomain: number[]): void;
@@ -0,0 +1,20 @@
1
+ /**
2
+ The per-instance fluent methods every node-link chart (Network,
3
+ ArcDiagram) installs in its `setup`: `links`, `nodes`, `nodeGroupBy`,
4
+ `size`, and `hover`. They need imperative bodies (queue loading, `aggs`
5
+ side effects), so they are installed per instance rather than as fields.
6
+ */
7
+ import type { DataPoint } from "@d3plus/data";
8
+ import type { VizInstance } from "../viz/vizTypes.js";
9
+ type Predicate = boolean | ((d: DataPoint, i: number) => boolean);
10
+ /** The fluent methods `installGraphFluent` adds. */
11
+ export type GraphFluent = {
12
+ hover: (predicate?: Predicate) => unknown;
13
+ links: (data?: DataPoint[], formatter?: unknown) => unknown;
14
+ nodes: (data?: DataPoint[], formatter?: unknown) => unknown;
15
+ nodeGroupBy: (keys?: unknown) => unknown;
16
+ size: (value?: unknown) => unknown;
17
+ };
18
+ /** Installs `links`, `nodes`, `nodeGroupBy`, `size`, and `hover` on a node-link chart. */
19
+ export declare function installGraphFluent(v: VizInstance & GraphFluent): void;
20
+ export {};
@@ -0,0 +1,18 @@
1
+ /**
2
+ The closest pair of Network nodes, which caps the largest node radius.
3
+
4
+ @module
5
+ */
6
+ /** A positioned node; a missing coordinate counts as 0. */
7
+ export interface PositionedNode {
8
+ x?: number;
9
+ y?: number;
10
+ }
11
+ /**
12
+ The smallest `pointDistance` between two different nodes, or undefined
13
+ when no pair has one (fewer than two nodes, or none with a numeric
14
+ position). Distances that aren't numbers are skipped, as `d3.min` skips
15
+ them. Sorts the nodes by x and sweeps, skipping pairs further apart in x
16
+ than the closest pair found so far.
17
+ */
18
+ export declare function minNodeDistance(nodes: readonly PositionedNode[]): number | undefined;
@@ -0,0 +1,29 @@
1
+ /**
2
+ A `polygonContains` for one polygon tested at many points that share
3
+ rows: the edge crossings along each row are found once.
4
+
5
+ @module
6
+ */
7
+ type Point = [number, number];
8
+ /** A polygon's edge crossings by row, and the test they answer. */
9
+ export interface PolygonRows {
10
+ /** Whether `point` lies inside, as `polygonContains(polygon, point)`. */
11
+ contains: (point: Point) => boolean;
12
+ /** Where the polygon's edges cross the row at `y` (see `insideRow`). */
13
+ row: (y: number) => number[];
14
+ }
15
+ /**
16
+ Whether `x` lies inside a polygon along a row whose edge crossings are
17
+ `xs`: d3-polygon's ray cast, toggling at each crossing past `x`.
18
+ */
19
+ export declare function insideRow(xs: readonly number[], x: number): boolean;
20
+ /**
21
+ Tests points against `polygon` with d3-polygon's `polygonContains` rule
22
+ (a ray cast along the point's row, toggling at each edge it crosses).
23
+ The crossings are worked out with the same arithmetic, so each answer
24
+ equals `polygonContains(polygon, point)`; they are kept per row, so the
25
+ points of a grid cost one pass over the edges per row instead of per
26
+ point.
27
+ */
28
+ export declare function polygonRows(polygon: readonly Point[]): PolygonRows;
29
+ export {};
@@ -1,8 +1,36 @@
1
1
  /**
2
2
  `applyPieLayout` — Pie's chart-specific layout stage. Runs the d3-shape
3
- pie layout against `viz._filteredData`, tags each slice with `__d3plus__`
4
- + index, builds the arc generator from the current schema values, and
5
- stores `pieData`/`arcData`/`pieWidth`/`pieHeight` on `viz.ctx`.
3
+ pie layout against `viz._filteredData` over the configured sweep, fits the
4
+ ring's footprint to the chart area, tags each slice with `__d3plus__` +
5
+ index, builds the arc generator from the current schema values, and
6
+ stores `pieData`/`arcData`/`pieSweep`/`pieCenter`/`pieBox` on `viz.ctx`.
6
7
  */
7
8
  import type { TransformStage } from "../pipeline/stages.js";
9
+ import type { VizInstance } from "../viz/vizTypes.js";
10
+ import type { PieSweep } from "./arcFit.js";
11
+ import type { PieRoom } from "./labelRoom.js";
12
+ import type { PieSlice } from "./pieLabels.js";
13
+ /** Pie's resolved sweep, from its `startAngle` and `endAngle` settings. */
14
+ export declare function pieSweepOf(viz: VizInstance): PieSweep;
15
+ /**
16
+ The outer radius a hole-less ring of this Pie's sweep gets in the chart
17
+ area, before any room is kept for the hover stroke. Donut's default
18
+ `innerRadius` is half of it.
19
+ */
20
+ export declare function pieBaseRadius(viz: VizInstance): number;
21
+ /** The width/height ratio of this Pie's hole-less footprint: 1 for a full circle, 2 for a half ring. */
22
+ export declare function pieAspect(viz: VizInstance): number;
23
+ /**
24
+ Lays the slices out with `room` kept around the ring for labels outside
25
+ it: the ring fits the chart area less that room, its inner radius shrinks
26
+ with it, and it sits within the room left. Stores the layout on
27
+ `viz.ctx` (see `applyPieLayout`) and returns the slices.
28
+ @param viz The chart.
29
+ @param room The room kept on each side.
30
+ */
31
+ export declare function pieRingLayout(viz: VizInstance, room?: PieRoom): PieSlice[];
32
+ /**
33
+ Lays the slices out, keeping room around the ring for the labels that
34
+ go outside it (see `layoutWithLabelRoom`).
35
+ */
8
36
  export declare const applyPieLayout: TransformStage;
@@ -0,0 +1,63 @@
1
+ /**
2
+ Pure geometry for a Pie's sweep: the angular range its slices fill, the
3
+ bounding box of the ring they draw, and where that ring sits in the chart
4
+ area. Angles are radians in d3's convention (0 at 12 o'clock, increasing
5
+ clockwise), so a point at angle `a` and radius `r` sits at
6
+ `(r·sin a, −r·cos a)`.
7
+ */
8
+ /** The angular range a Pie's slices fill, in radians. `end` may be less than `start` (a counter-clockwise sweep). */
9
+ export interface PieSweep {
10
+ start: number;
11
+ end: number;
12
+ }
13
+ /** An axis-aligned box around the ring's center. */
14
+ export interface ArcBox {
15
+ x0: number;
16
+ x1: number;
17
+ y0: number;
18
+ y1: number;
19
+ }
20
+ /** Where the ring sits in the chart area, how large it is, and its footprint in pixels around its center. */
21
+ export interface RingFit {
22
+ cx: number;
23
+ cy: number;
24
+ radius: number;
25
+ box: ArcBox;
26
+ }
27
+ /**
28
+ Resolves the `startAngle` and `endAngle` settings (degrees clockwise from
29
+ 12 o'clock) to a sweep in radians. An unset `endAngle` makes a full turn
30
+ from `startAngle`, and the sweep never exceeds one turn in either direction.
31
+ */
32
+ export declare function pieSweep(startAngle: unknown, endAngle: unknown): PieSweep;
33
+ /** Whether a sweep goes all the way around. */
34
+ export declare function isFullTurn(start: number, end: number): boolean;
35
+ /** Where `angle` falls within the sweep, from 0 at its start to 1 at its end, wrapping around the circle. */
36
+ export declare function sweepFraction(angle: number, sweep: PieSweep): number;
37
+ /**
38
+ The bounding box of a ring's slice from `start` to `end`, in units of its
39
+ outer radius: the outer arc's ends, every 12, 3, 6 and 9 o'clock extreme
40
+ it passes, and the inner arc's ends at `inner` (a fraction of the outer
41
+ radius; 0 puts them at the center).
42
+ */
43
+ export declare function ringExtent(start: number, end: number, inner?: number): ArcBox;
44
+ /**
45
+ Fits a ring sweeping from `start` to `end` (radians) into `width` ×
46
+ `height`, inset by `pad` on every side: the largest outer radius at which
47
+ the ring's own footprint fits, with an inner radius of `innerRadius`
48
+ pixels. The footprint is centered in any room left over.
49
+ */
50
+ export declare function fitRing(width: number, height: number, start: number, end: number, innerRadius?: number, pad?: number): RingFit;
51
+ /**
52
+ The size a ring sweeping from `start` to `end` needs for an outer radius
53
+ of `radius`, inset by `pad` on every side (the inverse of `fitRing`, for
54
+ a ring without a hole).
55
+ @param radius The outer radius.
56
+ @param start Where the sweep starts.
57
+ @param end Where it ends.
58
+ @param pad The inset on each side.
59
+ */
60
+ export declare function ringSizeFor(radius: number, start: number, end: number, pad?: number): {
61
+ width: number;
62
+ height: number;
63
+ };
@@ -0,0 +1,57 @@
1
+ import type { DataPoint } from "@d3plus/data";
2
+ import type { SceneNode } from "@d3plus/render";
3
+ import type { RingArc } from "../features/ringLabels.js";
4
+ import type { VizInstance } from "../viz/vizTypes.js";
5
+ /** A laid-out slice, as `pieEmit` sees it. */
6
+ export interface PieLabelSlice {
7
+ data: DataPoint;
8
+ i?: number;
9
+ }
10
+ /** What placing the curved labels needs from `pieEmit`. */
11
+ export interface PieCurvedInputs<S extends PieLabelSlice> {
12
+ viz: VizInstance;
13
+ slices: S[];
14
+ /** Each slice's ring segment. */
15
+ arcOf: (slice: S) => RingArc;
16
+ /** Each slice's name. */
17
+ nameOf: (slice: S) => string;
18
+ /** Each slice's share, as text. */
19
+ shareOf: (slice: S) => string;
20
+ /** Each slice's fill. */
21
+ fillOf: (slice: S) => unknown;
22
+ /** The straight labels, as `emitLabels` drew them. */
23
+ straight: SceneNode[];
24
+ /** The Path shape's labelConfig. */
25
+ labelConfig: Record<string, unknown>;
26
+ }
27
+ /**
28
+ The font range curved labels try: the labelConfig's `fontSize` alone,
29
+ else `fontMin` to `fontMax`, 8 to 24 by default.
30
+ @param config The labelConfig.
31
+ */
32
+ export declare function ringFontRange(config: Record<string, unknown>): {
33
+ fontMin: number;
34
+ fontMax: number;
35
+ };
36
+ /**
37
+ Whether laid-out lines show all of `text`: every letter, in order, with
38
+ nothing cut short. A word hyphenated across two lines still counts as
39
+ shown whole.
40
+ @param lines The laid-out lines' text.
41
+ @param text The label's text.
42
+ */
43
+ export declare function textShownWhole(lines: string[], text: string): boolean;
44
+ /** The labels for every slice, and which slices they name in full. */
45
+ export interface PieSliceLabelNodes<S> {
46
+ straight: SceneNode[];
47
+ curved: SceneNode[];
48
+ /** The slices whose label shows their whole name. */
49
+ whole: Set<S>;
50
+ }
51
+ /**
52
+ The labels for every slice: each slice's straight label (from
53
+ `straight`) or its curved one, whichever its `labelPosition` and the fit
54
+ choose (see `chooseRingLabel`).
55
+ @param inputs The slices and their geometry, fills, and straight labels.
56
+ */
57
+ export declare function pieSliceLabels<S extends PieLabelSlice>(inputs: PieCurvedInputs<S>): PieSliceLabelNodes<S>;
@@ -0,0 +1,83 @@
1
+ import type { VizInstance } from "../viz/vizTypes.js";
2
+ import type { CrowdedLabel } from "./outsideNodes.js";
3
+ import type { PieSlice } from "./pieLabels.js";
4
+ /** The smallest a ring shrinks to make room for labels outside it, as a share of its full radius. */
5
+ export declare const PIE_MIN_SCALE = 0.6;
6
+ /** The most room a single label claims beside the ring, as a share of the chart's width; a longer label wraps. */
7
+ export declare const OUTSIDE_MAX_SHARE = 0.3;
8
+ /** The room kept on each side of the ring, in pixels. */
9
+ export interface PieRoom {
10
+ left: number;
11
+ right: number;
12
+ top: number;
13
+ bottom: number;
14
+ }
15
+ /** No room kept. */
16
+ export declare const NO_ROOM: PieRoom;
17
+ /**
18
+ Scales the room on two opposite sides down, keeping their proportions,
19
+ so the ring keeps at least `min` of the chart's `size` between them.
20
+ @param a The room on one side.
21
+ @param b The room on the other.
22
+ @param size The chart area's size across both.
23
+ @param min The least the ring keeps.
24
+ */
25
+ export declare function clampSides(a: number, b: number, size: number, min: number): [number, number];
26
+ /**
27
+ The width a label claims beside the ring: its own when it is at most
28
+ `cap`, else the narrowest it wraps onto two lines when that is, else
29
+ none (it is drawn only where the room happens to hold it).
30
+ @param width The label's one-line width.
31
+ @param wrapWidth The narrowest it wraps onto two lines.
32
+ @param cap The most a label claims.
33
+ */
34
+ export declare function outsideClaim(width: number, wrapWidth: number, cap: number): number;
35
+ /**
36
+ The room to keep beside the ring at the current layout: `room`, grown
37
+ on each side to fit that side's widest label outside the ring (see
38
+ `outsideClaim`; a label claims at most `OUTSIDE_MAX_SHARE` of the
39
+ chart's width), then scaled back so the ring keeps `minWidth`.
40
+ @param viz The chart, laid out with `room`.
41
+ @param slices The laid-out slices.
42
+ @param room The room the layout kept.
43
+ @param minWidth The least width the ring keeps.
44
+ */
45
+ export declare function pieLabelRoom(viz: VizInstance, slices: PieSlice[], room: PieRoom, minWidth: number): PieRoom;
46
+ /**
47
+ The room to keep above and below the ring for the labels its columns
48
+ had no place for: each one's height, above the ring when its slice
49
+ faces up and below it when its slice faces down, added to `room`, then
50
+ scaled back so the ring keeps `minHeight` of the chart's `height`.
51
+ @param room The room the layout kept.
52
+ @param crowded The labels with no place.
53
+ @param height The chart area's height.
54
+ @param minHeight The least height the ring keeps.
55
+ */
56
+ export declare function crowdedRoom(room: PieRoom, crowded: CrowdedLabel[], height: number, minHeight: number): PieRoom;
57
+ /**
58
+ The room worth keeping once the labels are placed: a side where no
59
+ label was placed gives its room back to the ring.
60
+ @param room The room kept.
61
+ @param used Whether a label was placed on each side.
62
+ */
63
+ export declare function usedRoom(room: PieRoom, used: {
64
+ left: boolean;
65
+ right: boolean;
66
+ }): PieRoom;
67
+ /**
68
+ Lays the slices out, keeping room around the ring for the labels that
69
+ go outside it. Room beside the ring is grown twice at most (see
70
+ `pieLabelRoom`), since a smaller ring can send more labels outside; then
71
+ room above and below it is kept, once, for the labels the columns had
72
+ no place for (see `crowdedRoom`); last, a side whose labels couldn't be
73
+ placed gives its room back to the ring. The room only grows until that
74
+ last step, so the ring only shrinks, never below `min` (the ring's size
75
+ at `PIE_MIN_SCALE`).
76
+ @param viz The chart.
77
+ @param layout Lays the slices out with room kept around the ring.
78
+ @param min The least size the ring keeps.
79
+ */
80
+ export declare function layoutWithLabelRoom(viz: VizInstance, layout: (room: PieRoom) => PieSlice[], min: {
81
+ width: number;
82
+ height: number;
83
+ }): PieSlice[];