@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,137 @@
1
+ /**
2
+ Every label a Pie or Donut draws for its slices: the labels inside the
3
+ ring (straight or curved, see `curvedLabels.ts`), and which slices take
4
+ a label outside the ring instead (see `labelPosition`). The plan is
5
+ worked out once per layout and kept on the chart's context, so the
6
+ layout stage, which sizes the ring to leave room for the outside labels,
7
+ and the emit step share it.
8
+ */ import { formatAbbreviate } from "@d3plus/format";
9
+ import { resolveAccessor, shapeConfigFor, userLabelConfig } from "../features/emitHelpers.js";
10
+ import { ringLabelFont, ringTextWidth } from "../features/ringLabelNodes.js";
11
+ import { ringLabelPosition } from "../features/ringLabels.js";
12
+ import { pieSliceLabels } from "./curvedLabels.js";
13
+ import { OUTSIDE_LABEL_FONT_SIZE } from "./outsideLabels.js";
14
+ import { pieStraightLabels } from "./straightLabels.js";
15
+ /**
16
+ The narrowest a text gets wrapped onto two lines between its words: the
17
+ wider of the two lines at the best break. A single word can't wrap, so
18
+ its width is its own.
19
+ @param text The text.
20
+ @param width A string's one-line width.
21
+ */ export function twoLineWidth(text, width) {
22
+ const words = text.split(/\s+/).filter(Boolean);
23
+ let best = width(words.join(" "));
24
+ for(let k = 1; k < words.length; k++)best = Math.min(best, Math.max(width(words.slice(0, k).join(" ")), width(words.slice(k).join(" "))));
25
+ return best;
26
+ }
27
+ /**
28
+ Formats a slice's share as a percentage in the chart's locale.
29
+ @param viz The chart.
30
+ */ export function pieSharePct(viz) {
31
+ const locale = viz.schema.locale;
32
+ return (d)=>`${formatAbbreviate((d.share ?? 0) * 100, locale)}%`;
33
+ }
34
+ /**
35
+ The outside labels' font size: the Path labelConfig's `fontSize`, else
36
+ `OUTSIDE_LABEL_FONT_SIZE`.
37
+ @param labelConfig The Path labelConfig.
38
+ */ export function outsideFontSize(labelConfig) {
39
+ const size = labelConfig.fontSize;
40
+ return typeof size === "number" && size > 0 ? size : OUTSIDE_LABEL_FONT_SIZE;
41
+ }
42
+ /**
43
+ Whether a slice's `labelPosition` puts its label outside the ring:
44
+ always for `"outside"`, never for `"inside"` or `"along"`, and for
45
+ `"auto"` only when its label inside doesn't show its whole name.
46
+ @param position The slice's `labelPosition`.
47
+ @param shownWhole Whether its label inside shows its whole name.
48
+ */ export function labelGoesOutside(position, shownWhole) {
49
+ if (position === "outside") return true;
50
+ if (position === "inside" || position === "along") return false;
51
+ return !shownWhole;
52
+ }
53
+ /**
54
+ Whether any slice's `labelPosition` may put its label outside the ring:
55
+ false when every one is `"inside"` or `"along"`.
56
+ @param viz The chart.
57
+ @param slices The laid-out slices.
58
+ */ export function pieMayLabelOutside(viz, slices) {
59
+ return slices.some((d, k)=>{
60
+ const position = ringLabelPosition(viz, d.data, d.i ?? k);
61
+ return position !== "inside" && position !== "along";
62
+ });
63
+ }
64
+ /**
65
+ Works out every slice's label for the current layout (`viz.ctx.arcData`):
66
+ the labels inside the ring, and the slices whose label goes outside it.
67
+ Kept on `viz.ctx`, so the same layout is only worked out once.
68
+ @param viz The chart, laid out by `applyPieLayout`.
69
+ @param slices The laid-out slices.
70
+ */ export function pieLabelPlan(viz, slices) {
71
+ const arcGen = viz.ctx.arcData;
72
+ const cached = viz.ctx.pieLabelPlan;
73
+ if (cached && cached.arc === arcGen && cached.slices === slices) return cached.plan;
74
+ const resolveInnerRadius = arcGen.innerRadius();
75
+ const resolveOuterRadius = arcGen.outerRadius();
76
+ const sc = shapeConfigFor(viz, "Path");
77
+ const labelConfig = userLabelConfig(viz, "Path");
78
+ const sharePct = pieSharePct(viz);
79
+ const nameOf = (d)=>viz._drawLabel(d.data, d.i ?? 0);
80
+ const arcOf = (d)=>({
81
+ innerRadius: resolveInnerRadius(d, d.i ?? 0),
82
+ outerRadius: resolveOuterRadius(d, d.i ?? 0),
83
+ startAngle: d.startAngle,
84
+ endAngle: d.endAngle,
85
+ padAngle: d.padAngle
86
+ });
87
+ const inside = pieSliceLabels({
88
+ viz,
89
+ slices,
90
+ arcOf,
91
+ nameOf,
92
+ shareOf: sharePct,
93
+ fillOf: (d)=>resolveAccessor(sc.fill, d.data, d.i ?? 0),
94
+ straight: pieStraightLabels({
95
+ viz,
96
+ slices,
97
+ arcOf,
98
+ sc,
99
+ sharePct,
100
+ labelConfig
101
+ }),
102
+ labelConfig
103
+ });
104
+ const outside = [];
105
+ if (pieMayLabelOutside(viz, slices)) {
106
+ const font = ringLabelFont(labelConfig);
107
+ const fontSize = outsideFontSize(labelConfig);
108
+ slices.forEach((slice, k)=>{
109
+ const index = slice.i ?? k;
110
+ const name = nameOf(slice);
111
+ const position = ringLabelPosition(viz, slice.data, index);
112
+ if (!name || !labelGoesOutside(position, inside.whole.has(slice))) return;
113
+ const text = `${name} ${sharePct(slice)}`;
114
+ const measure = (t)=>ringTextWidth(t, font)(fontSize);
115
+ outside.push({
116
+ slice,
117
+ index,
118
+ angle: (slice.startAngle + slice.endAngle) / 2,
119
+ text,
120
+ width: measure(text),
121
+ wrapWidth: twoLineWidth(text, measure),
122
+ weight: slice.value
123
+ });
124
+ });
125
+ }
126
+ const plan = {
127
+ straight: inside.straight,
128
+ curved: inside.curved,
129
+ outside
130
+ };
131
+ viz.ctx.pieLabelPlan = {
132
+ arc: arcGen,
133
+ slices,
134
+ plan
135
+ };
136
+ return plan;
137
+ }
@@ -0,0 +1,223 @@
1
+ /**
2
+ Axis-aligned boxes centered on a ring segment's bisector: the line from
3
+ the ring's center through the middle of the segment. A box centered on
4
+ it reads as centered in its slice. Every box here is symmetric about its
5
+ center, so where it goes is a single number, the center's distance from
6
+ the ring's center along the bisector.
7
+
8
+ Angles are radians in d3-shape's convention (0 at 12 o'clock, increasing
9
+ clockwise), so a point at angle `a` and radius `r` sits at
10
+ `(r·sin a, −r·cos a)`.
11
+ */ const TAU = Math.PI * 2;
12
+ const EPSILON = 1e-9;
13
+ /** The point at angle `a` on the unit circle. */ const unit = (a)=>[
14
+ Math.sin(a),
15
+ -Math.cos(a)
16
+ ];
17
+ /**
18
+ Resolves a ring segment's edges, the way d3-shape's arc draws it: a
19
+ `padAngle` narrows a Pie wedge (no hole) by that angle, and offsets a
20
+ ring segment's sides by a constant gap (`padAngle` at the default pad
21
+ radius, `√(inner² + outer²)`). `padding` keeps a box that much further
22
+ inside every edge. A full turn has no sides; its bisector points up.
23
+ Null when the segment has no area.
24
+ @param arc The segment.
25
+ @param padding The room kept inside every edge, in pixels.
26
+ */ export function sectorEdges(arc, padding = 0) {
27
+ let a0 = Math.min(arc.startAngle, arc.endAngle);
28
+ let a1 = Math.max(arc.startAngle, arc.endAngle);
29
+ const inner = arc.innerRadius > 0 ? arc.innerRadius + padding : 0;
30
+ const outer = arc.outerRadius - padding;
31
+ if (!(a1 - a0 > EPSILON) || !(outer > inner)) return null;
32
+ if (a1 - a0 >= TAU - 1e-6) return {
33
+ mid: 0,
34
+ dir: unit(0),
35
+ span: TAU,
36
+ inner,
37
+ outer,
38
+ sides: []
39
+ };
40
+ const half = (arc.padAngle ?? 0) / 2;
41
+ let gap = 0;
42
+ if (half > 0 && arc.innerRadius > 0) gap = Math.hypot(arc.innerRadius, arc.outerRadius) * Math.sin(half);
43
+ else if (half > 0) {
44
+ a0 += half;
45
+ a1 -= half;
46
+ }
47
+ const span = a1 - a0;
48
+ if (!(span > EPSILON)) return null;
49
+ const mid = (a0 + a1) / 2;
50
+ const offset = gap + padding;
51
+ const sides = [
52
+ {
53
+ normal: [
54
+ Math.cos(a0),
55
+ Math.sin(a0)
56
+ ],
57
+ offset,
58
+ ray: unit(a0)
59
+ },
60
+ {
61
+ normal: [
62
+ -Math.cos(a1),
63
+ -Math.sin(a1)
64
+ ],
65
+ offset,
66
+ ray: unit(a1)
67
+ }
68
+ ];
69
+ return {
70
+ mid,
71
+ dir: unit(mid),
72
+ span,
73
+ inner,
74
+ outer,
75
+ sides
76
+ };
77
+ }
78
+ /** The least `t` at which a box of half-size `a`×`b` centered at `t·dir` clears a circle of radius `r` around the center. */ function clearInner(dir, a, b, r) {
79
+ if (!(r > 0)) return -Infinity;
80
+ const ux = Math.abs(dir[0]);
81
+ const uy = Math.abs(dir[1]);
82
+ const found = [];
83
+ // The nearest point is on the box's side facing the center…
84
+ if (ux > EPSILON) {
85
+ const t = (a + r) / ux;
86
+ if (t * uy <= b + EPSILON) found.push(t);
87
+ }
88
+ // …or on its top or bottom…
89
+ if (uy > EPSILON) {
90
+ const t = (b + r) / uy;
91
+ if (t * ux <= a + EPSILON) found.push(t);
92
+ }
93
+ // …or its corner nearest the center.
94
+ const k = a * ux + b * uy;
95
+ const disc = k * k - (a * a + b * b - r * r);
96
+ if (disc >= 0) {
97
+ const t = k + Math.sqrt(disc);
98
+ if (t * ux >= a - EPSILON && t * uy >= b - EPSILON) found.push(t);
99
+ }
100
+ return found.length ? Math.min(...found) : Infinity;
101
+ }
102
+ /** The least `t` at which a box of half-size `a`×`b` centered at `t·dir` sits inside `side`. */ function insideSide(side, dir, a, b) {
103
+ const [nx, ny] = side.normal;
104
+ const along = nx * dir[0] + ny * dir[1];
105
+ const need = side.offset + a * Math.abs(nx) + b * Math.abs(ny);
106
+ return along > EPSILON ? need / along : Infinity;
107
+ }
108
+ /**
109
+ The least `t` at which a box centered at `t·dir` keeps clear of a
110
+ segment's gap when the segment spans more than half a turn. The gap is
111
+ then a convex wedge, so the box clears it when one of the box's own
112
+ axes, or a side's normal, separates the two.
113
+ */ function clearGap(edges, a, b) {
114
+ const { dir, sides, span } = edges;
115
+ let least = Math.min(...sides.map((s)=>insideSide(s, dir, a, b)));
116
+ // The gap's apex sits on the bisector, where the two sides meet.
117
+ const apex = sides[0].offset / Math.sin(span / 2);
118
+ const axes = [
119
+ [
120
+ 1,
121
+ 0
122
+ ],
123
+ [
124
+ -1,
125
+ 0
126
+ ],
127
+ [
128
+ 0,
129
+ 1
130
+ ],
131
+ [
132
+ 0,
133
+ -1
134
+ ]
135
+ ];
136
+ for (const e of axes){
137
+ const dot = (p)=>e[0] * p[0] + e[1] * p[1];
138
+ // The gap reaches no further than its apex along `e` only when both of
139
+ // its edges run that way.
140
+ if (dot(sides[0].ray) < -EPSILON || dot(sides[1].ray) < -EPSILON) continue;
141
+ const reach = a * Math.abs(e[0]) + b * Math.abs(e[1]);
142
+ const toward = dot(dir);
143
+ const limit = apex * toward;
144
+ if (toward < -EPSILON) least = Math.min(least, (reach - limit) / -toward);
145
+ else if (reach <= limit + EPSILON) least = -Infinity;
146
+ }
147
+ return least;
148
+ }
149
+ /**
150
+ The stretch of a segment's bisector where a `width`×`height` box can be
151
+ centered and stay inside the segment, as distances from the ring's
152
+ center: from `lo` to `hi`. For a whole disc it runs through the center,
153
+ from `-hi` to `hi`. Null when the box fits nowhere along it.
154
+ @param edges The segment's edges (see `sectorEdges`).
155
+ @param width The box's width.
156
+ @param height The box's height.
157
+ */ export function sectorBoxRange(edges, width, height) {
158
+ const a = width / 2;
159
+ const b = height / 2;
160
+ const { dir, inner, outer, sides, span } = edges;
161
+ const ux = Math.abs(dir[0]);
162
+ const uy = Math.abs(dir[1]);
163
+ // The corner furthest from the center reaches the outer edge at `hi`.
164
+ const k = a * ux + b * uy;
165
+ const disc = k * k - (a * a + b * b - outer * outer);
166
+ if (a * a + b * b > outer * outer || disc < 0) return null;
167
+ const hi = -k + Math.sqrt(disc);
168
+ if (!sides.length && !(inner > 0)) return {
169
+ lo: -hi,
170
+ hi
171
+ };
172
+ let lo = Math.max(0, clearInner(dir, a, b, inner));
173
+ if (sides.length) lo = Math.max(lo, span > Math.PI ? clearGap(edges, a, b) : Math.max(...sides.map((s)=>insideSide(s, dir, a, b))));
174
+ return lo <= hi + EPSILON ? {
175
+ lo,
176
+ hi: Math.max(lo, hi)
177
+ } : null;
178
+ }
179
+ /**
180
+ The box of the given size centered on the bisector at distance `t`.
181
+ @param edges The segment's edges.
182
+ @param t The center's distance from the ring's center.
183
+ @param width The box's width.
184
+ @param height The box's height.
185
+ */ export function sectorBoxAt(edges, t, width, height) {
186
+ return {
187
+ x: t * edges.dir[0] - width / 2,
188
+ y: t * edges.dir[1] - height / 2,
189
+ width,
190
+ height
191
+ };
192
+ }
193
+ /**
194
+ A `width`×`height` box centered on a segment's bisector, halfway along
195
+ the stretch where it fits (see `sectorBoxRange`), so the room around it
196
+ is shared out evenly. Null when it fits nowhere.
197
+ @param edges The segment's edges.
198
+ @param width The box's width.
199
+ @param height The box's height.
200
+ */ export function centeredSectorBox(edges, width, height) {
201
+ const range = sectorBoxRange(edges, width, height);
202
+ if (!range) return null;
203
+ return sectorBoxAt(edges, (range.lo + range.hi) / 2, width, height);
204
+ }
205
+ /**
206
+ The largest box of a given shape centered on a segment's bisector, at
207
+ the one place along it where that box fits. The scale is searched from
208
+ 0 up to the ring's diameter.
209
+ @param edges The segment's edges.
210
+ @param size The box's width and height at a scale, growing with it.
211
+ @param iterations How finely the scale is searched.
212
+ */ export function largestSectorBox(edges, size, iterations = 40) {
213
+ const fits = (s)=>sectorBoxRange(edges, ...size(s)) !== null;
214
+ let lo = 0;
215
+ let hi = edges.outer * 2;
216
+ if (!fits(lo)) return null;
217
+ for(let n = 0; n < iterations; n++){
218
+ const s = (lo + hi) / 2;
219
+ if (fits(s)) lo = s;
220
+ else hi = s;
221
+ }
222
+ return lo > 0 ? centeredSectorBox(edges, ...size(lo)) : null;
223
+ }
@@ -0,0 +1,96 @@
1
+ /**
2
+ A Pie's straight slice labels, each centered on its slice's bisector
3
+ (see `straightLayout.ts`).
4
+ */ import { colorContrast } from "@d3plus/color";
5
+ import constant from "../../utils/constant.js";
6
+ import { emitLabels } from "../../shapes/emitLabels.js";
7
+ import { resolveAccessor } from "../features/emitHelpers.js";
8
+ import { ringLabelFont, ringTextWidth } from "../features/ringLabelNodes.js";
9
+ import { sectorEdges } from "./sectorBox.js";
10
+ import { centerLabelLines, straightLabelLayout, straightLabelOptions, wrapWidths } from "./straightLayout.js";
11
+ /** The slice a label node names. */ const sliceOf = (node)=>node.datum?.data;
12
+ /**
13
+ Each slice's straight label, centered on its bisector: the name, at the
14
+ largest size that shows it whole, and the share percentage beneath it
15
+ when there is room (see `straightLabelLayout`).
16
+ @param inputs The slices, their segments and fills, and the label config.
17
+ */ export function pieStraightLabels(inputs) {
18
+ const { viz, slices, arcOf, sc, sharePct, labelConfig } = inputs;
19
+ const options = straightLabelOptions(labelConfig);
20
+ const font = ringLabelFont(labelConfig);
21
+ const unitWidth = (text)=>ringTextWidth(text, font)(1);
22
+ const layouts = new Map();
23
+ slices.forEach((d, i)=>{
24
+ const name = viz._drawLabel(d.data, d.i ?? i);
25
+ const edges = name ? sectorEdges(arcOf(d)) : null;
26
+ if (!edges) return;
27
+ const layout = straightLabelLayout(edges, wrapWidths(String(name), unitWidth, options.maxLines), unitWidth(sharePct(d)), options);
28
+ if (layout) layouts.set(d, layout);
29
+ });
30
+ const nodes = emitLabels({
31
+ data: slices,
32
+ label: (_d, i)=>{
33
+ const name = viz._drawLabel(slices[i].data, slices[i].i ?? i);
34
+ return layouts.get(slices[i])?.share ? [
35
+ name,
36
+ sharePct(slices[i])
37
+ ] : [
38
+ name
39
+ ];
40
+ },
41
+ // The boxes are in chart-centered path coordinates, so the anchor is
42
+ // the origin and labelBounds carries each absolute box.
43
+ x: ()=>0,
44
+ y: ()=>0,
45
+ aes: ()=>({}),
46
+ rotate: constant(0),
47
+ id: (_d, i)=>`pie-label-${i}`,
48
+ labelBounds: (_d, i)=>{
49
+ const layout = layouts.get(slices[i]);
50
+ if (!layout) return false;
51
+ const boxes = layout.share ? [
52
+ layout.name,
53
+ layout.share
54
+ ] : [
55
+ layout.name
56
+ ];
57
+ return boxes.map((b)=>({
58
+ ...b,
59
+ angle: 0
60
+ }));
61
+ },
62
+ labelConfig: {
63
+ fontColor: (d)=>{
64
+ const slice = d.data ?? d;
65
+ const fill = resolveAccessor(sc.fill, slice.data, slice.i ?? 0);
66
+ return colorContrast(typeof fill === "string" ? fill : "rgb(255, 255, 255)", viz.schema.colorDefaults);
67
+ },
68
+ textAnchor: "middle",
69
+ verticalAlign: "middle",
70
+ ...labelConfig,
71
+ // Each label's size is worked out to fit its slice.
72
+ fontResize: false,
73
+ fontSize: (d)=>{
74
+ const layout = d.data ? layouts.get(d.data) : undefined;
75
+ if (!layout) return options.fontMin;
76
+ return d.l === 1 && layout.shareSize ? layout.shareSize : layout.fontSize;
77
+ }
78
+ }
79
+ });
80
+ if (labelConfig.verticalAlign === undefined) {
81
+ const bySlice = new Map();
82
+ for (const node of nodes){
83
+ const slice = sliceOf(node);
84
+ if (!slice) continue;
85
+ bySlice.set(slice, [
86
+ ...bySlice.get(slice) ?? [],
87
+ node
88
+ ]);
89
+ }
90
+ bySlice.forEach((list, slice)=>{
91
+ const layout = layouts.get(slice);
92
+ if (layout) centerLabelLines(list, layout.center[1]);
93
+ });
94
+ }
95
+ return nodes;
96
+ }
@@ -0,0 +1,215 @@
1
+ /**
2
+ Sizes a Pie slice's straight label to its slice: the name, wrapped
3
+ between words onto as many lines as shows it largest, and the share on a
4
+ smaller line beneath it, in a box centered on the slice's bisector (see
5
+ `sectorBox.ts`).
6
+ */ import { textLineBoxes } from "../features/linkLabels.js";
7
+ import { centeredSectorBox, largestSectorBox, sectorBoxRange } from "./sectorBox.js";
8
+ /** The defaults for `StraightLabelOptions`. */ export const STRAIGHT_LABEL_DEFAULTS = {
9
+ fontMin: 10,
10
+ fontMax: 32,
11
+ padding: 5,
12
+ lineHeight: 1.2,
13
+ shareRatio: 0.7,
14
+ shareKeep: 0.75,
15
+ shareFont: 16,
16
+ margin: 0.2,
17
+ maxLines: 4
18
+ };
19
+ /** A positive number, or undefined. */ const num = (v)=>typeof v === "number" && Number.isFinite(v) && v > 0 ? v : undefined;
20
+ /**
21
+ The straight label options a labelConfig asks for: its `fontSize` alone
22
+ when it sets one, else `fontMin` to `fontMax` (10 to 32 by default), and
23
+ its `padding` (5 by default).
24
+ @param config The labelConfig.
25
+ */ export function straightLabelOptions(config) {
26
+ const size = num(config.fontSize);
27
+ const fontMax = size ?? num(config.fontMax) ?? STRAIGHT_LABEL_DEFAULTS.fontMax;
28
+ const fontMin = Math.min(fontMax, size ?? num(config.fontMin) ?? STRAIGHT_LABEL_DEFAULTS.fontMin);
29
+ const padding = typeof config.padding === "number" && config.padding >= 0 ? config.padding : STRAIGHT_LABEL_DEFAULTS.padding;
30
+ return {
31
+ ...STRAIGHT_LABEL_DEFAULTS,
32
+ fontMin,
33
+ fontMax,
34
+ padding
35
+ };
36
+ }
37
+ /**
38
+ The narrowest a text wraps between its words onto 1, 2, … lines: for
39
+ each line count, the widest line at the best breaks. Stops at
40
+ `maxLines`, or at one line per word.
41
+ @param text The text.
42
+ @param width A string's one-line width.
43
+ @param maxLines The most lines.
44
+ */ export function wrapWidths(text, width, maxLines) {
45
+ const words = text.split(/\s+/).filter(Boolean);
46
+ const n = words.length;
47
+ if (!n) return [];
48
+ const cache = new Map();
49
+ const line = (i, j)=>{
50
+ const key = `${i},${j}`;
51
+ let w = cache.get(key);
52
+ if (w === undefined) {
53
+ w = width(words.slice(i, j).join(" "));
54
+ cache.set(key, w);
55
+ }
56
+ return w;
57
+ };
58
+ // best[j] is the narrowest the first j words wrap onto the current count.
59
+ let best = Array.from({
60
+ length: n + 1
61
+ }, (_, j)=>j ? line(0, j) : 0);
62
+ const out = [
63
+ best[n]
64
+ ];
65
+ for(let k = 2; k <= Math.min(maxLines, n); k++){
66
+ const next = best.map(()=>Infinity);
67
+ for(let j = k; j <= n; j++)for(let i = k - 1; i < j; i++)next[j] = Math.min(next[j], Math.max(best[i], line(i, j)));
68
+ best = next;
69
+ out.push(best[n]);
70
+ }
71
+ return out;
72
+ }
73
+ /**
74
+ Lays a straight label out in a slice: the largest whole font size (up to
75
+ `fontMax`) at which the name, wrapped onto some number of lines, and the
76
+ share beneath it fit in a box centered on the slice's bisector, with
77
+ room around them (see `margin`). The share is left off when it would
78
+ shrink the name too much (see `shareKeep` and `shareFont`); a name on
79
+ more lines must show larger than on fewer. The box goes halfway along
80
+ the stretch of the bisector where it fits. When even `fontMin` doesn't
81
+ fit the name whole, the label is one line at `fontMin`, as wide as the
82
+ slice allows, and is cut short; null when that has no room for a few
83
+ letters.
84
+ @param edges The slice's edges (see `sectorEdges`).
85
+ @param wraps The name's width at a font size of 1 on 1, 2, … lines (see `wrapWidths`).
86
+ @param shareWidth The share's width at a font size of 1, or null for none.
87
+ @param options How the label is sized.
88
+ */ export function straightLabelLayout(edges, wraps, shareWidth, options = STRAIGHT_LABEL_DEFAULTS) {
89
+ const { fontMin, fontMax, padding: p, lineHeight: lh } = options;
90
+ if (!wraps.length) return null;
91
+ const sizeAt = (lines, s, share)=>{
92
+ const shareSize = share ? Math.max(fontMin, Math.round(s * options.shareRatio)) : null;
93
+ // A pixel or two of slack, so the text wraps the same when it is drawn.
94
+ const nameHeight = lines * lh * s + 1;
95
+ const width = Math.max(wraps[lines - 1] * s, shareSize ? shareWidth * shareSize : 0) * 1.02 + 2;
96
+ const height = nameHeight + (shareSize ? p + lh * shareSize + 1 : 0);
97
+ const margin = Math.max(p, s * options.margin);
98
+ return {
99
+ width,
100
+ height,
101
+ nameHeight,
102
+ shareSize,
103
+ margin
104
+ };
105
+ };
106
+ const fits = (z)=>sectorBoxRange(edges, z.width + z.margin * 2, z.height + z.margin * 2) !== null;
107
+ /** The largest whole font size that fits, from fontMin to fontMax. */ const largest = (lines, share)=>{
108
+ let lo = Math.ceil(fontMin);
109
+ let hi = Math.floor(fontMax);
110
+ if (hi < lo) hi = lo = fontMin;
111
+ if (!fits(sizeAt(lines, lo, share))) return 0;
112
+ while(lo < hi){
113
+ const s = Math.ceil((lo + hi) / 2);
114
+ if (fits(sizeAt(lines, s, share))) lo = s;
115
+ else hi = s - 1;
116
+ }
117
+ return lo;
118
+ };
119
+ const best = (share)=>{
120
+ let pick = {
121
+ lines: 0,
122
+ size: 0
123
+ };
124
+ wraps.forEach((_, k)=>{
125
+ const size = largest(k + 1, share);
126
+ if (size > pick.size) pick = {
127
+ lines: k + 1,
128
+ size
129
+ };
130
+ });
131
+ return pick;
132
+ };
133
+ const alone = best(false);
134
+ const withShare = shareWidth !== null ? best(true) : {
135
+ lines: 0,
136
+ size: 0
137
+ };
138
+ const keep = Math.min(alone.size * options.shareKeep, options.shareFont);
139
+ const pick = withShare.size > 0 && withShare.size >= keep ? {
140
+ ...withShare,
141
+ share: true
142
+ } : {
143
+ ...alone,
144
+ share: false
145
+ };
146
+ if (!pick.size) return cutShort(edges, options);
147
+ const z = sizeAt(pick.lines, pick.size, pick.share);
148
+ const outer = centeredSectorBox(edges, z.width + z.margin * 2, z.height + z.margin * 2);
149
+ const center = [
150
+ outer.x + outer.width / 2,
151
+ outer.y + outer.height / 2
152
+ ];
153
+ // The boxes the text is drawn in: the block, and its padding.
154
+ const x = center[0] - z.width / 2 - p;
155
+ const top = center[1] - z.height / 2;
156
+ return {
157
+ fontSize: pick.size,
158
+ lines: pick.lines,
159
+ shareSize: z.shareSize,
160
+ name: {
161
+ x,
162
+ y: top - p,
163
+ width: z.width + p * 2,
164
+ height: z.nameHeight + p * 2
165
+ },
166
+ share: z.shareSize ? {
167
+ x,
168
+ y: top + z.nameHeight,
169
+ width: z.width + p * 2,
170
+ height: lh * z.shareSize + p * 2 + 1
171
+ } : null,
172
+ center,
173
+ truncated: false
174
+ };
175
+ }
176
+ /** One line at `fontMin`, as wide as the slice allows along its bisector, or null when that holds less than a few letters. */ function cutShort(edges, options) {
177
+ const { fontMin, padding: p, lineHeight: lh } = options;
178
+ const height = lh * fontMin + p * 2 + 1;
179
+ const box = largestSectorBox(edges, (w)=>[
180
+ w,
181
+ height
182
+ ]);
183
+ if (!box || box.width - p * 2 < fontMin * 2) return null;
184
+ return {
185
+ fontSize: fontMin,
186
+ lines: 1,
187
+ shareSize: null,
188
+ name: box,
189
+ share: null,
190
+ center: [
191
+ box.x + box.width / 2,
192
+ box.y + box.height / 2
193
+ ],
194
+ truncated: true
195
+ };
196
+ }
197
+ /**
198
+ Moves a label's text nodes up or down together, so their lines' glyphs
199
+ are centered on `y`.
200
+ @param nodes One label's nodes.
201
+ @param y Where the lines' middle goes.
202
+ */ export function centerLabelLines(nodes, y) {
203
+ const boxes = textLineBoxes(nodes);
204
+ if (!boxes.length) return;
205
+ const top = Math.min(...boxes.map((b)=>b.y - b.height / 2));
206
+ const bottom = Math.max(...boxes.map((b)=>b.y + b.height / 2));
207
+ const shift = y - (top + bottom) / 2;
208
+ const moved = new Set();
209
+ for (const node of nodes){
210
+ const tr = node.transform;
211
+ if (!tr || moved.has(tr)) continue;
212
+ moved.add(tr);
213
+ tr.y = (tr.y ?? 0) + shift;
214
+ }
215
+ }