@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,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,73 @@
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
+ The chart's node rows: `nodes` when set, else one row per data row and
47
+ one per link end no data row stands for (the link's own object, or
48
+ `{id}` for an id), so a chart given only `data` and `links` still draws
49
+ its nodes, linked or not.
50
+ */
51
+ export declare function graphNodeRows(v: VizInstance): DataPoint[];
52
+ /**
53
+ Resolves the filtered data and the node rows (see `graphNodeRows`) into
54
+ node records, in the order the ids first appear (data rows, then nodes).
55
+ Only ids present in the node rows become nodes; a matching data row
56
+ supplies a node's values. `fx`/`fy` read the chart's `x`/`y` accessors
57
+ when it has them.
58
+ */
59
+ export declare function resolveGraphNodes(v: VizInstance): GraphNode[];
60
+ /**
61
+ Resolves `links` against `nodes`, index-aligned with `links`: an endpoint
62
+ that matches no node is undefined. A link whose ends both resolve gets its
63
+ datum, which `linkSize` receives (with the link's index). Stashes the id → node lookup on
64
+ `v.ctx.nodeLookup` and the id → neighbor nodes lookup on
65
+ `v.ctx.linkLookup` (a link from a node to itself adds no neighbor).
66
+ */
67
+ export declare function resolveGraphLinks(v: VizInstance, nodes: GraphNode[]): GraphLink[];
68
+ /**
69
+ Zooms to a node-space extent. Node coordinates sit under the chart's
70
+ margin-origin transform and the current zoom, so they're mapped to their
71
+ on-screen position first — the space `_zoomToBounds` expects.
72
+ */
73
+ 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 {};
@@ -9,6 +9,8 @@ import type { DataPoint } from "@d3plus/data";
9
9
  import type { TransformStage } from "../pipeline/stages.js";
10
10
  type PackLeaf = Omit<HierarchyCircularNode<DataPoint>, "id"> & {
11
11
  __d3plus__: true;
12
+ /** A group circle's row (see `groupRows.ts`), which its circle carries. */
13
+ groupRow?: DataPoint;
12
14
  i: number;
13
15
  id: string | number;
14
16
  };
@@ -0,0 +1,46 @@
1
+ /**
2
+ Pack group rows: a circle enclosing others stands for a group above the
3
+ drawn leaves, so its scene datum is that group's row (see
4
+ `viz/groupRow.ts`), as Treemap's group headers carry theirs: the group's
5
+ rows merged, stamped with its `groupBy` level. Clicking it zooms into the
6
+ group, its tooltip names it at its own level, `packOpacity` reads it,
7
+ and so does its paint (every `shapeConfig` accessor), so it takes its
8
+ group's color.
9
+
10
+ The outermost circle holds every row. Its level, -1, sits above the first
11
+ `groupBy`, so its group is everything drawn and zooming into it changes
12
+ nothing. It names no one group, so it is painted neutral (`neutralFill`,
13
+ between the chart's background and its ink), and so is every group while
14
+ a colorScale colors the leaves, as Treemap's group headers are, rather
15
+ than take the scale's color for its total. A neutral circle's fill is
16
+ that tone, its default stroke that tone a shade darker (see
17
+ `neutralPaint.ts`), and its other paint reads its nest entry, which holds
18
+ no fields.
19
+
20
+ Each row also keeps its nest entry's `key` and, as `values`, the datums of
21
+ the circles directly inside it, unenumerated: hover walks them to light a
22
+ group's descendants (`recursionCircles`), and they stay out of the row's
23
+ fields.
24
+ */
25
+ import type { HierarchyNode } from "d3-hierarchy";
26
+ import { merge } from "@d3plus/data";
27
+ import type { DataPoint } from "@d3plus/data";
28
+ type Aggs = Parameters<typeof merge>[1];
29
+ /** A packed node, carrying its group row once `attachGroupRows` runs. */
30
+ export type GroupedNode = HierarchyNode<DataPoint> & {
31
+ groupRow?: DataPoint;
32
+ };
33
+ /** What the helpers below read off a packed node. */
34
+ type DatumSource = Pick<GroupedNode, "children" | "data" | "groupRow" | "parent">;
35
+ /** The datum a node's circle carries: its group row, or a leaf's own row. */
36
+ export declare function packDatum(node: DatumSource): DataPoint;
37
+ /**
38
+ Whether a node's circle is painted neutral (see above): the outermost
39
+ always, and a group while the chart has a colorScale.
40
+ */
41
+ export declare function packNeutral(node: DatumSource, colorScale: boolean): boolean;
42
+ /** The datum a node's circle is painted from: a neutral one's nest entry. */
43
+ export declare function packPaintDatum(node: DatumSource, neutral: boolean): DataPoint;
44
+ /** Stamps every node with children with its group row, innermost first. */
45
+ export declare function attachGroupRows(root: GroupedNode, aggs: Aggs): void;
46
+ export {};
@@ -4,7 +4,10 @@
4
4
  Implementation files in this folder:
5
5
  - `applyLayout.ts` — chart-specific `TransformStage`.
6
6
  - `emit.ts` — Circle + label scene nodes from the laid-out data.
7
+ - `nodeNames.ts` — each circle's scene key and accessible name.
7
8
  - `recursionCircles.ts` — descendant-walk helper used by hover handlers.
9
+ - `groupRows.ts` — the group row each enclosing circle carries.
10
+ - `neutralPaint.ts` — the fill and stroke of the neutral circles.
8
11
  */
9
12
  import type { ChartDefinition } from "../definition/ChartDefinition.js";
10
13
  export declare const packDef: ChartDefinition;
@@ -0,0 +1,14 @@
1
+ /**
2
+ The paint of Pack's neutral circles (see `groupRows.ts`): the neutral
3
+ fill, and the stroke the chart's default draws around it, unless a stroke
4
+ of the user's own (`shapeConfig.stroke`, or `shapeConfig.Circle.stroke`)
5
+ paints them instead.
6
+ */
7
+ import type { VizInstance } from "../viz/vizTypes.js";
8
+ /** A neutral circle's fill, and its stroke unless the user set one. */
9
+ export interface NeutralPaint {
10
+ fill: string;
11
+ stroke?: string;
12
+ }
13
+ /** The paint of the chart's neutral circles. */
14
+ export declare function packNeutralPaint(viz: Pick<VizInstance, "schema"> & Partial<Pick<VizInstance, "_select" | "_theme">>): NeutralPaint;
@@ -0,0 +1,23 @@
1
+ /**
2
+ A packed circle's scene key and accessible name. Each group and leaf
3
+ circle is keyed by its path of keys, so a redraw pairs it with itself
4
+ however the circles reorder, and a group circle is named after its own
5
+ group, at its own `groupBy` level; the outermost circle, enclosing every
6
+ group, is named as the chart's total.
7
+ */
8
+ import type { VizInstance } from "../viz/vizTypes.js";
9
+ import type { PackLeaf } from "./applyLayout.js";
10
+ type PackNode = Pick<PackLeaf, "children" | "data" | "depth" | "i" | "leaves" | "parent" | "value">;
11
+ /**
12
+ The circle's scene key: a group's path of keys, and a leaf's its groups'
13
+ keys and then its own id (the key of the one-row group it was nested
14
+ in), so no two circles share one and each keeps its own across redraws.
15
+ */
16
+ export declare function packNodeKey(node: PackNode): string;
17
+ /**
18
+ The circle's accessible name and value: a leaf's label, a group's name at
19
+ its own `groupBy` level (as Treemap names its group headers), or the
20
+ translated "Total" for the root.
21
+ */
22
+ export declare function packNodeLabel(viz: VizInstance, node: PackNode): string;
23
+ export {};
@@ -0,0 +1,12 @@
1
+ /**
2
+ ParallelCoordinates chrome: the axes and their titles hold no data and
3
+ stay out of hit-testing, all but the labels with an axis tooltip to show.
4
+ */
5
+ import type { SceneNode } from "@d3plus/render";
6
+ /**
7
+ A copy of an axis's or title's scene as chrome (see `inertAxis`), without
8
+ its data: the pointer passes through it to the lines, and catches only on
9
+ a label stamped with a tooltip target.
10
+ @param node An axis's or title's scene, or a node in it.
11
+ */
12
+ export declare function chromeNode(node: SceneNode): SceneNode;
@@ -6,6 +6,7 @@
6
6
  - `dimensions.ts` — which keys get an axis, their types and domains.
7
7
  - `axes.ts` — one Axis per dimension, laid out with its title.
8
8
  - `titles.ts` — dimension titles (TextBox).
9
+ - `chrome.ts` — axes and titles as chrome, hoverable where a label has a tooltip.
9
10
  - `paths.ts` — each row's crossing points and path.
10
11
  - `applyLayout.ts` — chart-specific `TransformStage`.
11
12
  - `emit.ts` — a path (plus hit path) per row.
@@ -17,5 +17,10 @@ export interface DimensionTitle {
17
17
  export declare function titleWidths(texts: string[], style: Record<string, unknown>, locale?: string): number[];
18
18
  /** The height of the tallest title once each wraps to its `width` (0 when there are none). */
19
19
  export declare function titleHeight(titles: DimensionTitle[], style: Record<string, unknown>, locale?: string): number;
20
- /** The title text nodes. Titles are chrome: no datum, no pointer events. */
21
- export declare function titleNodes(titles: DimensionTitle[], style: Record<string, unknown>, locale?: string): SceneNode[];
20
+ /**
21
+ The title text nodes, as chrome (see `chromeNode`). With `tooltips`, each
22
+ dimension's `titleTooltip` by key, a title with a tooltip to show (the
23
+ option's, or its whole text when it is drawn cut short) takes the
24
+ pointer; without it none does.
25
+ */
26
+ export declare function titleNodes(titles: DimensionTitle[], style: Record<string, unknown>, locale?: string, tooltips?: Map<string, unknown>): SceneNode[];
@@ -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[];