@d3plus/core 4.10.0 → 4.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (548) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +167 -8
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +170 -0
  9. package/es/src/charts/Alluvial/layout.js +137 -0
  10. package/es/src/charts/Alluvial/meta.js +57 -0
  11. package/es/src/charts/Alluvial/titles.js +81 -0
  12. package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
  13. package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
  14. package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
  15. package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
  16. package/es/src/charts/ArcDiagram/emit.js +178 -0
  17. package/es/src/charts/ArcDiagram/events.js +144 -0
  18. package/es/src/charts/ArcDiagram/index.js +215 -0
  19. package/es/src/charts/BarChart/index.js +14 -2
  20. package/es/src/charts/BoxWhisker/index.js +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 +3 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +2 -1
  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 +162 -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 +132 -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 +204 -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 +3 -3
  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/Network/applyLayout.js +138 -94
  70. package/es/src/charts/Network/bundle.js +81 -0
  71. package/es/src/charts/Network/clusterLabels.js +423 -0
  72. package/es/src/charts/Network/clusters.js +290 -0
  73. package/es/src/charts/Network/emit.js +253 -70
  74. package/es/src/charts/Network/graph.js +117 -0
  75. package/es/src/charts/Network/graphFluent.js +79 -0
  76. package/es/src/charts/Network/index.js +86 -106
  77. package/es/src/charts/Network/minNodeDistance.js +64 -0
  78. package/es/src/charts/Network/polygonRows.js +44 -0
  79. package/es/src/charts/Pack/index.js +5 -1
  80. package/es/src/charts/Pie/applyLayout.js +86 -27
  81. package/es/src/charts/Pie/arcFit.js +152 -0
  82. package/es/src/charts/Pie/curvedLabels.js +134 -0
  83. package/es/src/charts/Pie/emit.js +43 -96
  84. package/es/src/charts/Pie/index.js +64 -31
  85. package/es/src/charts/Pie/labelRoom.js +154 -0
  86. package/es/src/charts/Pie/outsideLabels.js +224 -0
  87. package/es/src/charts/Pie/outsideNodes.js +267 -0
  88. package/es/src/charts/Pie/pieLabels.js +137 -0
  89. package/es/src/charts/Pie/sectorBox.js +223 -0
  90. package/es/src/charts/Pie/straightLabels.js +96 -0
  91. package/es/src/charts/Pie/straightLayout.js +215 -0
  92. package/es/src/charts/Plot/alongLegend.js +76 -0
  93. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  94. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  95. package/es/src/charts/Plot/axisValues.js +43 -0
  96. package/es/src/charts/Plot/barWidth.js +59 -11
  97. package/es/src/charts/Plot/circleLabels.js +98 -0
  98. package/es/src/charts/Plot/connectGaps.js +237 -0
  99. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  100. package/es/src/charts/Plot/draw.js +8 -2
  101. package/es/src/charts/Plot/fillBetween.js +2 -1
  102. package/es/src/charts/Plot/forecastScene.js +3 -4
  103. package/es/src/charts/Plot/index.js +18 -10
  104. package/es/src/charts/Plot/labelPlacement.js +1 -1
  105. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  106. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  107. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  108. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  109. package/es/src/charts/Plot/pipeline.js +66 -19
  110. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  111. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  112. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  113. package/es/src/charts/Plot/pipelineScales.js +40 -8
  114. package/es/src/charts/Plot/plotFacet.js +12 -1
  115. package/es/src/charts/Plot/plotInit.js +34 -5
  116. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  117. package/es/src/charts/Plot/referenceDomains.js +133 -0
  118. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  119. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  120. package/es/src/charts/Plot/trendLabels.js +183 -0
  121. package/es/src/charts/Plot/trendLines.js +1 -0
  122. package/es/src/charts/Plot/trendScene.js +6 -3
  123. package/es/src/charts/Plot/trendTooltip.js +5 -1
  124. package/es/src/charts/PolarArea/index.js +2 -2
  125. package/es/src/charts/Priestley/applyLayout.js +14 -20
  126. package/es/src/charts/Priestley/index.js +4 -35
  127. package/es/src/charts/Priestley/timeAxis.js +100 -0
  128. package/es/src/charts/Radar/axisDecorations.js +49 -12
  129. package/es/src/charts/Radar/curvedLabels.js +187 -0
  130. package/es/src/charts/Radar/index.js +2 -3
  131. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  132. package/es/src/charts/RadialBar/emit.js +4 -1
  133. package/es/src/charts/RadialBar/index.js +16 -9
  134. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  135. package/es/src/charts/RadialMatrix/index.js +3 -7
  136. package/es/src/charts/Rings/applyLayout.js +41 -24
  137. package/es/src/charts/Rings/emit.js +174 -58
  138. package/es/src/charts/Rings/index.js +61 -28
  139. package/es/src/charts/Rings/ringsGraph.js +28 -9
  140. package/es/src/charts/Rings/ringsLoops.js +73 -0
  141. package/es/src/charts/Rings/ringsParallel.js +166 -0
  142. package/es/src/charts/Sankey/applyLayout.js +116 -39
  143. package/es/src/charts/Sankey/circularLayout.js +208 -0
  144. package/es/src/charts/Sankey/circularLinks.js +301 -0
  145. package/es/src/charts/Sankey/emit.js +164 -94
  146. package/es/src/charts/Sankey/index.js +72 -75
  147. package/es/src/charts/Sankey/labels.js +80 -0
  148. package/es/src/charts/Sankey/ribbons.js +88 -0
  149. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  150. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  151. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  152. package/es/src/charts/Scatter/index.js +25 -0
  153. package/es/src/charts/SlopeChart/index.js +116 -0
  154. package/es/src/charts/SlopeChart/slope.js +95 -0
  155. package/es/src/charts/Streamgraph/index.js +51 -0
  156. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  157. package/es/src/charts/Sunburst/emit.js +74 -63
  158. package/es/src/charts/Sunburst/index.js +3 -3
  159. package/es/src/charts/Tree/index.js +2 -6
  160. package/es/src/charts/Treemap/index.js +2 -5
  161. package/es/src/charts/Violin/inner.js +3 -5
  162. package/es/src/charts/definition/makeChart.js +10 -2
  163. package/es/src/charts/drawSteps/backControl.js +17 -5
  164. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  165. package/es/src/charts/drawSteps/minimap.js +6 -5
  166. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  167. package/es/src/charts/drawSteps/searchControls.js +2 -1
  168. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  169. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  170. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  171. package/es/src/charts/events/click.legend.js +7 -2
  172. package/es/src/charts/events/click.shape.js +8 -1
  173. package/es/src/charts/events/mousemove.shape.js +5 -2
  174. package/es/src/charts/facet/drawFacets.js +14 -5
  175. package/es/src/charts/features/annotationFrame.js +179 -0
  176. package/es/src/charts/features/annotationText.js +83 -0
  177. package/es/src/charts/features/annotationTypes.js +10 -0
  178. package/es/src/charts/features/attributionFeature.js +6 -11
  179. package/es/src/charts/features/axes.js +2 -1
  180. package/es/src/charts/features/axesFinal.js +3 -1
  181. package/es/src/charts/features/axesMeasure.js +7 -4
  182. package/es/src/charts/features/calloutLayout.js +121 -0
  183. package/es/src/charts/features/calloutScene.js +155 -0
  184. package/es/src/charts/features/chartGeometry.js +1 -1
  185. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  186. package/es/src/charts/features/circleLabels.js +207 -0
  187. package/es/src/charts/features/colorScaleBucket.js +2 -1
  188. package/es/src/charts/features/colorScaleHover.js +3 -2
  189. package/es/src/charts/features/colorScaleValue.js +97 -0
  190. package/es/src/charts/features/curvedArrows.js +158 -0
  191. package/es/src/charts/features/edgeArrows.js +160 -4
  192. package/es/src/charts/features/edgeBundling.js +442 -0
  193. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  194. package/es/src/charts/features/ensureZoomDom.js +32 -8
  195. package/es/src/charts/features/features.js +32 -14
  196. package/es/src/charts/features/featuresColorScale.js +20 -6
  197. package/es/src/charts/features/featuresLegend.js +15 -24
  198. package/es/src/charts/features/legendKeys.js +64 -0
  199. package/es/src/charts/features/lineLabels.js +55 -46
  200. package/es/src/charts/features/linkBundle.js +19 -0
  201. package/es/src/charts/features/linkColor.js +72 -0
  202. package/es/src/charts/features/linkFields.js +86 -0
  203. package/es/src/charts/features/linkFocus.js +118 -0
  204. package/es/src/charts/features/linkInteraction.js +312 -0
  205. package/es/src/charts/features/linkKeys.js +20 -0
  206. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  207. package/es/src/charts/features/linkLabelPath.js +162 -0
  208. package/es/src/charts/features/linkLabels.js +340 -0
  209. package/es/src/charts/features/linkWidths.js +32 -0
  210. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  211. package/es/src/charts/features/pathLabels.js +50 -0
  212. package/es/src/charts/features/plotAnnotations.js +68 -17
  213. package/es/src/charts/features/plotPaint.js +38 -11
  214. package/es/src/charts/features/polyline.js +129 -0
  215. package/es/src/charts/features/referenceAnnotations.js +403 -0
  216. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  217. package/es/src/charts/features/ringLabelNodes.js +93 -0
  218. package/es/src/charts/features/ringLabels.js +222 -0
  219. package/es/src/charts/features/sceneBounds.js +26 -6
  220. package/es/src/charts/features/selfLoops.js +306 -0
  221. package/es/src/charts/features/shapeEmit.js +47 -31
  222. package/es/src/charts/features/sharedFields.js +15 -2
  223. package/es/src/charts/features/textHalo.js +29 -0
  224. package/es/src/charts/index.js +8 -0
  225. package/es/src/charts/partition/chartFields.js +2 -2
  226. package/es/src/charts/partition/interaction.js +9 -5
  227. package/es/src/charts/partition/zoom.js +7 -6
  228. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  229. package/es/src/charts/pipeline/preDrawData.js +46 -3
  230. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  231. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  232. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  233. package/es/src/charts/polar/config.js +2 -3
  234. package/es/src/charts/viz/Viz.js +39 -36
  235. package/es/src/charts/viz/VizBase.js +18 -10
  236. package/es/src/charts/viz/backgroundInk.js +13 -7
  237. package/es/src/charts/viz/focusRing.js +104 -0
  238. package/es/src/charts/viz/focusTargets.js +208 -0
  239. package/es/src/charts/viz/history.js +74 -0
  240. package/es/src/charts/viz/keyboardNav.js +297 -0
  241. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  242. package/es/src/charts/viz/loaderFormat.js +114 -0
  243. package/es/src/charts/viz/missingFields.js +2 -1
  244. package/es/src/charts/viz/mountTarget.js +9 -0
  245. package/es/src/charts/viz/nearestHover.js +183 -0
  246. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  247. package/es/src/charts/viz/ordinalColor.js +14 -12
  248. package/es/src/charts/viz/pageTheme.js +83 -0
  249. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  250. package/es/src/charts/viz/pointVoronoi.js +124 -0
  251. package/es/src/charts/viz/reducedMotion.js +27 -0
  252. package/es/src/charts/viz/vizDataPolling.js +8 -3
  253. package/es/src/charts/viz/vizDefaults.js +15 -23
  254. package/es/src/charts/viz/vizFields.js +35 -0
  255. package/es/src/charts/viz/vizRender.js +43 -28
  256. package/es/src/charts/viz/vizTheme.js +96 -0
  257. package/es/src/charts/viz/vizVisibility.js +14 -0
  258. package/es/src/components/Axis/Axis.js +6 -0
  259. package/es/src/components/Axis/AxisBottom.js +1 -0
  260. package/es/src/components/Axis/AxisLeft.js +1 -0
  261. package/es/src/components/Axis/AxisRight.js +1 -0
  262. package/es/src/components/Axis/AxisTop.js +1 -0
  263. package/es/src/components/Axis/axisBreak.js +4 -1
  264. package/es/src/components/Axis/axisDefaults.js +5 -9
  265. package/es/src/components/Axis/axisLayoutScale.js +7 -1
  266. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  267. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  268. package/es/src/components/Axis/rangeBreaks.js +201 -0
  269. package/es/src/components/Axis/timeValues.js +19 -4
  270. package/es/src/components/ColorScale/ColorScale.js +15 -9
  271. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  272. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  273. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  274. package/es/src/components/Legend/Legend.js +3 -0
  275. package/es/src/components/Legend/legendConfig.js +2 -6
  276. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  277. package/es/src/components/TextBox.js +29 -65
  278. package/es/src/components/Timeline/Timeline.js +12 -3
  279. package/es/src/components/Timeline/timelineConfig.js +20 -10
  280. package/es/src/components/Timeline/timelineMode.js +26 -0
  281. package/es/src/components/Timeline/timelineRender.js +7 -3
  282. package/es/src/components/Tooltip.js +15 -5
  283. package/es/src/components/fontStack.js +20 -0
  284. package/es/src/components/textBoxLayout.js +58 -21
  285. package/es/src/components/textBoxPath.js +73 -0
  286. package/es/src/components/textBoxScene.js +223 -0
  287. package/es/src/components/textBoxWords.js +70 -0
  288. package/es/src/shapes/Area.js +1 -0
  289. package/es/src/shapes/Bar.js +1 -0
  290. package/es/src/shapes/Box.js +1 -0
  291. package/es/src/shapes/Circle.js +1 -0
  292. package/es/src/shapes/Line.js +1 -0
  293. package/es/src/shapes/Path.js +1 -0
  294. package/es/src/shapes/Rect.js +1 -0
  295. package/es/src/shapes/Shape.js +1 -0
  296. package/es/src/shapes/Whisker.js +1 -0
  297. package/es/src/utils/BaseClass.js +25 -12
  298. package/es/src/utils/configPrep.js +2 -1
  299. package/es/src/utils/constant.js +13 -1
  300. package/es/src/utils/displayName.js +12 -0
  301. package/es/src/utils/theme.js +190 -0
  302. package/es/src/utils/themeInk.js +68 -0
  303. package/package.json +14 -11
  304. package/types/index.d.ts +6 -2
  305. package/types/internal.d.ts +250 -8
  306. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  307. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  308. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  309. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  310. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  311. package/types/src/charts/Alluvial/index.d.ts +27 -0
  312. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  313. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  314. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  315. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  316. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  317. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  318. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  319. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  320. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  321. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  322. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  323. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  324. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  325. package/types/src/charts/Chord/labels.d.ts +66 -0
  326. package/types/src/charts/Donut/index.d.ts +2 -1
  327. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  328. package/types/src/charts/Gantt/emit.d.ts +17 -0
  329. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  330. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  331. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  332. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  333. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  334. package/types/src/charts/Gantt/index.d.ts +36 -0
  335. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  336. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  337. package/types/src/charts/Geomap/emit.d.ts +2 -2
  338. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  339. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  340. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  341. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  342. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  343. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  344. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  345. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  346. package/types/src/charts/Geomap/index.d.ts +3 -0
  347. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  348. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  349. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  350. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  351. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  352. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  353. package/types/src/charts/Hexbin/index.d.ts +25 -0
  354. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  355. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  356. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  357. package/types/src/charts/Histogram/binData.d.ts +20 -1
  358. package/types/src/charts/Histogram/index.d.ts +3 -2
  359. package/types/src/charts/Histogram/labels.d.ts +7 -0
  360. package/types/src/charts/Marimekko/index.d.ts +2 -1
  361. package/types/src/charts/Network/bundle.d.ts +67 -0
  362. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  363. package/types/src/charts/Network/clusters.d.ts +115 -0
  364. package/types/src/charts/Network/graph.d.ts +65 -0
  365. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  366. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  367. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  368. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  369. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  370. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  371. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  372. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  373. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  374. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  375. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  376. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  377. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  378. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  379. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  380. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  381. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  382. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  383. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  384. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  385. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  386. package/types/src/charts/Plot/index.d.ts +15 -8
  387. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  388. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  389. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  390. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  391. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  392. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  393. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  394. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  395. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  396. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  397. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  398. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  399. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  400. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  401. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  402. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  403. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  404. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  405. package/types/src/charts/Rings/emit.d.ts +50 -0
  406. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  407. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  408. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  409. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  410. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  411. package/types/src/charts/Sankey/emit.d.ts +58 -0
  412. package/types/src/charts/Sankey/labels.d.ts +19 -0
  413. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  414. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  415. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  416. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  417. package/types/src/charts/Scatter/index.d.ts +15 -0
  418. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  419. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  420. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  421. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  422. package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
  423. package/types/src/charts/definition/makeChart.d.ts +3 -2
  424. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  425. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  426. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  427. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  428. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  429. package/types/src/charts/events/click.legend.d.ts +2 -1
  430. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  431. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  432. package/types/src/charts/features/annotationText.d.ts +57 -0
  433. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  434. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  435. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  436. package/types/src/charts/features/calloutScene.d.ts +40 -0
  437. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  438. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  439. package/types/src/charts/features/circleLabels.d.ts +130 -0
  440. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  441. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  442. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  443. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  444. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  445. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  446. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  447. package/types/src/charts/features/legendKeys.d.ts +34 -0
  448. package/types/src/charts/features/lineLabels.d.ts +15 -12
  449. package/types/src/charts/features/linkBundle.d.ts +16 -0
  450. package/types/src/charts/features/linkColor.d.ts +48 -0
  451. package/types/src/charts/features/linkFields.d.ts +16 -0
  452. package/types/src/charts/features/linkFocus.d.ts +51 -0
  453. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  454. package/types/src/charts/features/linkKeys.d.ts +11 -0
  455. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  456. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  457. package/types/src/charts/features/linkLabels.d.ts +77 -0
  458. package/types/src/charts/features/linkWidths.d.ts +19 -0
  459. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  460. package/types/src/charts/features/pathLabels.d.ts +41 -0
  461. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  462. package/types/src/charts/features/plotPaint.d.ts +17 -0
  463. package/types/src/charts/features/polyline.d.ts +32 -0
  464. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  465. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  466. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  467. package/types/src/charts/features/ringLabels.d.ts +164 -0
  468. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  469. package/types/src/charts/features/selfLoops.d.ts +165 -0
  470. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  471. package/types/src/charts/features/sharedFields.d.ts +11 -2
  472. package/types/src/charts/features/textHalo.d.ts +14 -0
  473. package/types/src/charts/index.d.ts +8 -0
  474. package/types/src/charts/partition/interaction.d.ts +6 -3
  475. package/types/src/charts/partition/zoom.d.ts +4 -4
  476. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  477. package/types/src/charts/pipeline/stages.d.ts +7 -0
  478. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  479. package/types/src/charts/viz/Viz.d.ts +16 -2
  480. package/types/src/charts/viz/VizBase.d.ts +6 -6
  481. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  482. package/types/src/charts/viz/focusRing.d.ts +25 -0
  483. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  484. package/types/src/charts/viz/history.d.ts +35 -0
  485. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  486. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  487. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  488. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  489. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  490. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  491. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  492. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  493. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  494. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  495. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  496. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  497. package/types/src/charts/viz/vizFields.d.ts +32 -0
  498. package/types/src/charts/viz/vizRender.d.ts +2 -1
  499. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  500. package/types/src/charts/viz/vizTypes.d.ts +84 -7
  501. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  502. package/types/src/components/Axis/Axis.d.ts +1 -0
  503. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  504. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  505. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  506. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  507. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  508. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  509. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  510. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  511. package/types/src/components/Axis/timeValues.d.ts +1 -1
  512. package/types/src/components/ColorScale/ColorScale.d.ts +1 -0
  513. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  514. package/types/src/components/Legend/Legend.d.ts +1 -0
  515. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  516. package/types/src/components/TextBox.d.ts +1 -0
  517. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  518. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  519. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  520. package/types/src/components/Tooltip.d.ts +4 -3
  521. package/types/src/components/fontStack.d.ts +10 -0
  522. package/types/src/components/textBoxLayout.d.ts +18 -9
  523. package/types/src/components/textBoxPath.d.ts +59 -0
  524. package/types/src/components/textBoxScene.d.ts +51 -0
  525. package/types/src/components/textBoxWords.d.ts +33 -0
  526. package/types/src/shapes/Area.d.ts +1 -0
  527. package/types/src/shapes/Bar.d.ts +1 -0
  528. package/types/src/shapes/Box.d.ts +1 -0
  529. package/types/src/shapes/Circle.d.ts +1 -0
  530. package/types/src/shapes/Line.d.ts +1 -0
  531. package/types/src/shapes/Path.d.ts +1 -0
  532. package/types/src/shapes/Rect.d.ts +1 -0
  533. package/types/src/shapes/Shape.d.ts +1 -0
  534. package/types/src/shapes/Whisker.d.ts +1 -0
  535. package/types/src/utils/BaseClass.d.ts +9 -0
  536. package/types/src/utils/D3plusConfig.d.ts +981 -30
  537. package/types/src/utils/configPrep.d.ts +2 -0
  538. package/types/src/utils/constant.d.ts +8 -0
  539. package/types/src/utils/displayName.d.ts +10 -0
  540. package/types/src/utils/index.d.ts +1 -1
  541. package/types/src/utils/theme.d.ts +170 -0
  542. package/types/src/utils/themeInk.d.ts +56 -0
  543. package/umd/d3plus-core.full.js +86811 -61031
  544. package/umd/d3plus-core.full.min.js +2 -2
  545. package/umd/d3plus-core.js +28392 -6498
  546. package/umd/d3plus-core.min.js +2 -2
  547. package/es/src/components/Axis/gridStroke.js +0 -10
  548. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -5,48 +5,65 @@
5
5
  - `applyLayout.ts` — chart-specific `TransformStage`.
6
6
  - `emit.ts` — Path + label scene nodes from the laid-out slices.
7
7
  */ import { pie as d3Pie } from "d3-shape";
8
- import { backgroundColor } from "@d3plus/dom";
9
8
  import accessor from "../../utils/accessor.js";
10
9
  import { fieldAccessor } from "../../utils/fieldAccessor.js";
11
- import { centerChartTransform } from "../features/chartGeometry.js";
12
- import { rowLegend, shareRow } from "../features/sharedFields.js";
10
+ import { chartBounds, centerChartTransform } from "../features/chartGeometry.js";
11
+ import { legendLargestFirst, rowLegend, shareRow } from "../features/sharedFields.js";
13
12
  import { makeChart } from "../definition/makeChart.js";
14
- import { applyPieLayout } from "./applyLayout.js";
13
+ import { applyPieLayout, pieAspect } from "./applyLayout.js";
15
14
  import { pieEmit } from "./emit.js";
16
15
  import { sceneInsetRegion } from "../pipeline/insetPlacement.js";
16
+ import { chartBackground } from "../viz/backgroundInk.js";
17
17
  export const pieDef = {
18
18
  name: "Pie",
19
19
  layoutStage: applyPieLayout,
20
20
  emit: pieEmit,
21
21
  insetRegion: sceneInsetRegion,
22
- chartTransform: (viz)=>centerChartTransform(viz, viz.ctx.pieWidth, viz.ctx.pieHeight),
23
- // Pie's chartTransform centers the origin — wedges are drawn in
24
- // [-pieWidth/2, pieWidth/2] × [-pieHeight/2, pieHeight/2], not the
25
- // top-left-origin box the default chartBodyRect assumes (that default is
26
- // only correct for a marginOriginTransform chart like Treemap). Without
27
- // this override, the drill-down morph's enter/exit fractions would be
28
- // computed against the wrong origin.
22
+ // The origin sits at the ring's center, which applyPieLayout fits to the
23
+ // chart area along with the ring's own footprint.
24
+ chartTransform: (viz)=>{
25
+ const center = viz.ctx.pieCenter;
26
+ if (!center) {
27
+ const { width, height } = chartBounds(viz);
28
+ return centerChartTransform(viz, width, height);
29
+ }
30
+ return {
31
+ x: viz._margin.left + center.x,
32
+ y: viz._margin.top + center.y
33
+ };
34
+ },
35
+ // Wedges are drawn around the centered origin, not in the top-left-origin
36
+ // box the default chartBodyRect assumes (that default is only correct for
37
+ // a marginOriginTransform chart like Treemap); without this override, the
38
+ // drill-down morph's enter/exit fractions would be computed against the
39
+ // wrong origin.
29
40
  //
30
- // Uses the TIGHT circle (radius = pieOuterRadius, applyPieLayout's own
31
- // actual, buffer-reduced outerRadius — see its comment on strokeBuffer)
32
- // rather than the loose pieWidth × pieHeight box: pieWidth/pieHeight is
33
- // the available space (not square when the chart area isn't, and larger
34
- // than the wedges' real size by the hover-stroke buffer), and the
35
- // drill-down morph's proportional remap (collapseTo's shapeType "Pie"
36
- // case) uses this as the "whole pie" reference — a mismatched reference
37
- // would stretch the circle into an ellipse, or off-scale it, as it grows.
41
+ // Uses the ring's TIGHT footprint (pieBox, at applyPieLayout's actual,
42
+ // buffer-reduced outerRadius — see its comment on strokeBuffer) rather
43
+ // than the loose available space: the drill-down morph's proportional
44
+ // remap (collapseTo's shapeType "Pie" case) uses this as the "whole pie"
45
+ // reference, and a mismatched reference would stretch the ring, or
46
+ // off-scale it, as it grows.
38
47
  chartBodyRect: (viz)=>{
39
- const r = viz.ctx.pieOuterRadius ?? 0;
48
+ const b = viz.ctx.pieBox;
49
+ if (!b) return {
50
+ x: 0,
51
+ y: 0,
52
+ width: 0,
53
+ height: 0
54
+ };
40
55
  return {
41
- x: -r,
42
- y: -r,
43
- width: r * 2,
44
- height: r * 2
56
+ x: b.x0,
57
+ y: b.y0,
58
+ width: b.x1 - b.x0,
59
+ height: b.y1 - b.y0
45
60
  };
46
61
  },
47
- // Small-multiple panels as close to square as the grid allows.
62
+ // Small-multiple panels shaped like the ring's footprint: as close to
63
+ // square as the grid allows for a full circle, twice as wide as tall for a
64
+ // half ring.
48
65
  facet: {
49
- aspect: 1
66
+ aspect: pieAspect
50
67
  },
51
68
  ctx: {
52
69
  pie: d3Pie()
@@ -61,6 +78,25 @@ export const pieDef = {
61
78
  default: 0
62
79
  },
63
80
  /**
81
+ Where the slices start, in degrees clockwise from 12 o'clock, the same
82
+ convention Gauge, PolarArea and RadialBar use. With `endAngle`, draws a
83
+ partial ring: `startAngle: -90, endAngle: 90` makes a half pie (or,
84
+ with Donut, a half donut) that opens downward. A partial ring is sized
85
+ to its own footprint and centered, so a half ring fills the chart's
86
+ width.
87
+ */ {
88
+ key: "startAngle",
89
+ default: 0
90
+ },
91
+ /**
92
+ Where the slices end, in degrees clockwise from 12 o'clock. Defaults to
93
+ one full turn past `startAngle`; an `endAngle` less than `startAngle`
94
+ lays the slices out counter-clockwise. The sweep is capped at one turn.
95
+ @type {number}
96
+ */ {
97
+ key: "endAngle"
98
+ },
99
+ /**
64
100
  The padding between each arc, in radians. When set, takes precedence
65
101
  over `padPixel`.
66
102
  @type {number}
@@ -101,10 +137,7 @@ export const pieDef = {
101
137
  },
102
138
  {
103
139
  key: "legendSort",
104
- factory: (viz)=>{
105
- const valueFn = viz.schema.value;
106
- return (a, b)=>valueFn(b) - valueFn(a);
107
- }
140
+ factory: (viz)=>legendLargestFirst(viz, "value")
108
141
  },
109
142
  {
110
143
  key: "shapeConfig",
@@ -128,7 +161,7 @@ export const pieDef = {
128
161
  // angular gap has nowhere left to taper from. Centered on each
129
162
  // wedge's outline (SVG's default), so half its width falls on each
130
163
  // side of an edge shared with a neighbor.
131
- stroke: ()=>backgroundColor(viz._select?.node()),
164
+ stroke: ()=>chartBackground(viz),
132
165
  strokeWidth: 2
133
166
  })
134
167
  },
@@ -0,0 +1,154 @@
1
+ /**
2
+ The room a Pie or Donut keeps around its ring for labels outside it (see
3
+ `labelPosition`): beside the ring, enough for the widest label on each
4
+ side that needs one; above and below it, enough for the labels its
5
+ columns had no place for; and never so much that the ring shrinks below
6
+ `PIE_MIN_SCALE` of its full size.
7
+ */ import { chartBounds } from "../features/chartGeometry.js";
8
+ import { userLabelConfig } from "../features/emitHelpers.js";
9
+ import { outsideMetrics, outsideRoom, outsideSide } from "./outsideLabels.js";
10
+ import { pieOutsideLabels } from "./outsideNodes.js";
11
+ import { outsideFontSize, pieLabelPlan, pieMayLabelOutside } from "./pieLabels.js";
12
+ /** The smallest a ring shrinks to make room for labels outside it, as a share of its full radius. */ export const PIE_MIN_SCALE = 0.6;
13
+ /** The most room a single label claims beside the ring, as a share of the chart's width; a longer label wraps. */ export const OUTSIDE_MAX_SHARE = 0.3;
14
+ /** No room kept. */ export const NO_ROOM = {
15
+ left: 0,
16
+ right: 0,
17
+ top: 0,
18
+ bottom: 0
19
+ };
20
+ /**
21
+ Scales the room on two opposite sides down, keeping their proportions,
22
+ so the ring keeps at least `min` of the chart's `size` between them.
23
+ @param a The room on one side.
24
+ @param b The room on the other.
25
+ @param size The chart area's size across both.
26
+ @param min The least the ring keeps.
27
+ */ export function clampSides(a, b, size, min) {
28
+ const total = a + b;
29
+ const spare = Math.max(0, size - min);
30
+ if (total <= spare) return [
31
+ a,
32
+ b
33
+ ];
34
+ const k = total > 0 ? spare / total : 0;
35
+ return [
36
+ a * k,
37
+ b * k
38
+ ];
39
+ }
40
+ /**
41
+ The width a label claims beside the ring: its own when it is at most
42
+ `cap`, else the narrowest it wraps onto two lines when that is, else
43
+ none (it is drawn only where the room happens to hold it).
44
+ @param width The label's one-line width.
45
+ @param wrapWidth The narrowest it wraps onto two lines.
46
+ @param cap The most a label claims.
47
+ */ export function outsideClaim(width, wrapWidth, cap) {
48
+ if (width <= cap) return width;
49
+ return wrapWidth <= cap ? wrapWidth : 0;
50
+ }
51
+ /**
52
+ The room to keep beside the ring at the current layout: `room`, grown
53
+ on each side to fit that side's widest label outside the ring (see
54
+ `outsideClaim`; a label claims at most `OUTSIDE_MAX_SHARE` of the
55
+ chart's width), then scaled back so the ring keeps `minWidth`.
56
+ @param viz The chart, laid out with `room`.
57
+ @param slices The laid-out slices.
58
+ @param room The room the layout kept.
59
+ @param minWidth The least width the ring keeps.
60
+ */ export function pieLabelRoom(viz, slices, room, minWidth) {
61
+ if (!pieMayLabelOutside(viz, slices)) return room;
62
+ const { outside } = pieLabelPlan(viz, slices);
63
+ if (!outside.length) return room;
64
+ const { width } = chartBounds(viz);
65
+ const metrics = outsideMetrics(outsideFontSize(userLabelConfig(viz, "Path")));
66
+ const cap = width * OUTSIDE_MAX_SHARE;
67
+ const need = outsideRoom(outside.map((c)=>({
68
+ angle: c.angle,
69
+ width: outsideClaim(c.width, c.wrapWidth, cap)
70
+ })).filter((c)=>c.width > 0), metrics);
71
+ const [left, right] = clampSides(Math.max(room.left, Math.ceil(need.left)), Math.max(room.right, Math.ceil(need.right)), width, minWidth);
72
+ return {
73
+ ...room,
74
+ left,
75
+ right
76
+ };
77
+ }
78
+ /**
79
+ The room to keep above and below the ring for the labels its columns
80
+ had no place for: each one's height, above the ring when its slice
81
+ faces up and below it when its slice faces down, added to `room`, then
82
+ scaled back so the ring keeps `minHeight` of the chart's `height`.
83
+ @param room The room the layout kept.
84
+ @param crowded The labels with no place.
85
+ @param height The chart area's height.
86
+ @param minHeight The least height the ring keeps.
87
+ */ export function crowdedRoom(room, crowded, height, minHeight) {
88
+ let top = room.top;
89
+ let bottom = room.bottom;
90
+ for (const { angle, size } of crowded){
91
+ if (Math.cos(angle) >= 0) top += size;
92
+ else bottom += size;
93
+ }
94
+ [top, bottom] = clampSides(top, bottom, height, minHeight);
95
+ return {
96
+ ...room,
97
+ top,
98
+ bottom
99
+ };
100
+ }
101
+ /**
102
+ The room worth keeping once the labels are placed: a side where no
103
+ label was placed gives its room back to the ring.
104
+ @param room The room kept.
105
+ @param used Whether a label was placed on each side.
106
+ */ export function usedRoom(room, used) {
107
+ return {
108
+ ...room,
109
+ left: used.left ? room.left : 0,
110
+ right: used.right ? room.right : 0
111
+ };
112
+ }
113
+ /** Whether two rooms are the same. */ const sameRoom = (a, b)=>a.left === b.left && a.right === b.right && a.top === b.top && a.bottom === b.bottom;
114
+ /**
115
+ Lays the slices out, keeping room around the ring for the labels that
116
+ go outside it. Room beside the ring is grown twice at most (see
117
+ `pieLabelRoom`), since a smaller ring can send more labels outside; then
118
+ room above and below it is kept, once, for the labels the columns had
119
+ no place for (see `crowdedRoom`); last, a side whose labels couldn't be
120
+ placed gives its room back to the ring. The room only grows until that
121
+ last step, so the ring only shrinks, never below `min` (the ring's size
122
+ at `PIE_MIN_SCALE`).
123
+ @param viz The chart.
124
+ @param layout Lays the slices out with room kept around the ring.
125
+ @param min The least size the ring keeps.
126
+ */ export function layoutWithLabelRoom(viz, layout, min) {
127
+ let room = NO_ROOM;
128
+ let slices = layout(room);
129
+ for(let pass = 0; pass < 2; pass++){
130
+ const next = pieLabelRoom(viz, slices, room, min.width);
131
+ if (sameRoom(next, room)) break;
132
+ room = next;
133
+ slices = layout(room);
134
+ }
135
+ if (!room.left && !room.right) return slices;
136
+ const { crowded } = pieOutsideLabels(viz, slices);
137
+ if (crowded.length) {
138
+ const next = crowdedRoom(room, crowded, chartBounds(viz).height, min.height);
139
+ if (!sameRoom(next, room)) {
140
+ room = next;
141
+ slices = layout(room);
142
+ }
143
+ }
144
+ const used = {
145
+ left: false,
146
+ right: false
147
+ };
148
+ for (const d of pieOutsideLabels(viz, slices).named){
149
+ const right = outsideSide((d.startAngle + d.endAngle) / 2) === 1;
150
+ used[right ? "right" : "left"] = true;
151
+ }
152
+ const kept = usedRoom(room, used);
153
+ return sameRoom(kept, room) ? slices : layout(kept);
154
+ }
@@ -0,0 +1,224 @@
1
+ /**
2
+ Pure geometry for labels drawn outside a Pie or Donut's ring: which side
3
+ of the ring a slice's label takes, the room the labels need beside the
4
+ ring, how one side's labels stack without overlapping, and the leader
5
+ line that joins each label to its slice. Coordinates are relative to the
6
+ ring's center; angles are radians in d3's convention (0 at 12 o'clock,
7
+ increasing clockwise), so a point at angle `a` and radius `r` sits at
8
+ `(r·sin a, −r·cos a)`.
9
+ */ import { spreadLabelPositions } from "../Plot/lineLabelSpread.js";
10
+ /** The label font size when the Path labelConfig sets none. */ export const OUTSIDE_LABEL_FONT_SIZE = 12;
11
+ /**
12
+ The metrics for labels at `fontSize`: a column line of 1.3em, and a
13
+ leader that runs out 10px, bends, and runs at least 8px across to a
14
+ label 4px past its end.
15
+ @param fontSize The label's font size.
16
+ */ export function outsideMetrics(fontSize) {
17
+ return {
18
+ fontSize,
19
+ lineHeight: Math.ceil(fontSize * 1.3),
20
+ elbow: 10,
21
+ tail: 8,
22
+ gap: 4
23
+ };
24
+ }
25
+ /**
26
+ The side of the ring a slice's label goes on: `1` (right, its text
27
+ reading away from the ring) when the slice's middle faces right, else
28
+ `-1` (left). A slice facing straight up or down takes the right.
29
+ @param angle The slice's middle angle.
30
+ */ export function outsideSide(angle) {
31
+ return Math.sin(angle) >= -1e-9 ? 1 : -1;
32
+ }
33
+ /**
34
+ How far from the ring's center each side's leaders end, where the
35
+ labels' text starts (less `gap`): past the ring by the elbow and the
36
+ shortest horizontal run.
37
+ @param radius The ring's outer radius.
38
+ @param metrics The label metrics.
39
+ */ export function outsideColumn(radius, metrics) {
40
+ return radius + metrics.elbow + metrics.tail;
41
+ }
42
+ /**
43
+ The room labels need beside the ring on each side: the widest label on
44
+ that side, plus its leader and gap, or 0 for a side without labels.
45
+ @param labels Each label's middle angle and text width.
46
+ @param metrics The label metrics.
47
+ */ export function outsideRoom(labels, metrics) {
48
+ const room = {
49
+ left: 0,
50
+ right: 0
51
+ };
52
+ const leader = metrics.elbow + metrics.tail + metrics.gap;
53
+ for (const { angle, width } of labels){
54
+ const key = outsideSide(angle) === 1 ? "right" : "left";
55
+ room[key] = Math.max(room[key], width + leader);
56
+ }
57
+ return room;
58
+ }
59
+ /**
60
+ Stacks one side's labels so none overlap and all stay between `bounds`:
61
+ sorted by the height each would like, then spread as little as they
62
+ must (see `spreadLabelPositions`). While they don't all fit, or `fits`
63
+ rejects one where it lands, the label with the smallest weight is
64
+ dropped and the rest are stacked again. Returns the height of each
65
+ label's middle, or null for a dropped one.
66
+ @param items The labels.
67
+ @param bounds The top and bottom of the room they share.
68
+ @param fits Whether label `i` may sit at height `y`.
69
+ */ export function stackOutsideLabels(items, bounds, fits = ()=>true) {
70
+ const out = items.map(()=>null);
71
+ const top = Math.min(...bounds);
72
+ const bottom = Math.max(...bounds);
73
+ let active = items.map((item, i)=>({
74
+ ...item,
75
+ i
76
+ })).filter((d)=>d.size <= bottom - top).sort((a, b)=>a.y - b.y || a.i - b.i);
77
+ while(active.length){
78
+ // The column's centers run from the first label's half height below the
79
+ // top to the last label's half height above the bottom.
80
+ const first = active[0].size / 2;
81
+ const last = active[active.length - 1].size / 2;
82
+ const ys = spreadLabelPositions(active.map((d)=>d.y), active.map((d)=>d.size), [
83
+ top + first,
84
+ bottom - last
85
+ ]);
86
+ const ok = ys.every((y, k)=>y + active[k].size / 2 <= bottom + 0.5 && fits(active[k].i, y));
87
+ if (ok) {
88
+ active.forEach((d, k)=>out[d.i] = ys[k]);
89
+ break;
90
+ }
91
+ const smallest = active.reduce((m, d)=>d.weight < m.weight || d.weight === m.weight && d.i > m.i ? d : m);
92
+ active = active.filter((d)=>d !== smallest);
93
+ }
94
+ return out;
95
+ }
96
+ /** The distance from the origin to the segment from `p` to `q`. */ export function segmentDistance(p, q) {
97
+ const dx = q[0] - p[0];
98
+ const dy = q[1] - p[1];
99
+ const len2 = dx * dx + dy * dy;
100
+ const t = len2 ? Math.max(0, Math.min(1, -(p[0] * dx + p[1] * dy) / len2)) : 0;
101
+ return Math.hypot(p[0] + t * dx, p[1] + t * dy);
102
+ }
103
+ /**
104
+ The ways a leader can run from a slice to its label at height `y`, best
105
+ first. The first runs straight out from the middle of the slice's outer
106
+ edge by the elbow, across to the label's height, and level for the last
107
+ `tail` pixels into the label's column, when its run across keeps half an
108
+ elbow clear of the ring. The second leaves the ring leaning only as far
109
+ as it must to stay outside it, reaching the label's height before it
110
+ runs level into the column, when that is short of the column. Empty when
111
+ the label's height can't be reached without crossing the ring.
112
+ @param angle The slice's middle angle.
113
+ @param radius The ring's outer radius.
114
+ @param y The label's height.
115
+ @param metrics The label metrics.
116
+ */ export function leaderRoutes(angle, radius, y, metrics) {
117
+ const side = outsideSide(angle);
118
+ const column = outsideColumn(radius, metrics);
119
+ const sin = Math.sin(angle);
120
+ const cos = Math.cos(angle);
121
+ const a = [
122
+ radius * sin,
123
+ -radius * cos
124
+ ];
125
+ const end = [
126
+ side * column,
127
+ y
128
+ ];
129
+ const knee = [
130
+ side * (column - metrics.tail),
131
+ y
132
+ ];
133
+ const elbow = [
134
+ (radius + metrics.elbow) * sin,
135
+ -(radius + metrics.elbow) * cos
136
+ ];
137
+ const routes = [];
138
+ if (segmentDistance(elbow, knee) >= radius + metrics.elbow / 2 - 1e-9) routes.push([
139
+ a,
140
+ elbow,
141
+ knee,
142
+ end
143
+ ]);
144
+ // The run from the ring stays outside it while it heads away from the
145
+ // ring's center: (B − A) · A ≥ 0.
146
+ let bx = Math.abs(elbow[0]);
147
+ const need = radius * radius - a[1] * y;
148
+ const along = Math.abs(a[0]);
149
+ if (bx * along < need) bx = along < 1e-9 ? Infinity : need / along;
150
+ if (bx <= column - metrics.tail / 2 + 1e-9) {
151
+ const b = [
152
+ side * bx,
153
+ y
154
+ ];
155
+ routes.push([
156
+ a,
157
+ [
158
+ (a[0] + b[0]) / 2,
159
+ (a[1] + b[1]) / 2
160
+ ],
161
+ b,
162
+ end
163
+ ]);
164
+ }
165
+ return routes;
166
+ }
167
+ /**
168
+ The leader from a slice to its label at height `y`: the best of
169
+ `leaderRoutes`, or null when there is none.
170
+ @param angle The slice's middle angle.
171
+ @param radius The ring's outer radius.
172
+ @param y The label's height.
173
+ @param metrics The label metrics.
174
+ */ export function leaderPoints(angle, radius, y, metrics) {
175
+ return leaderRoutes(angle, radius, y, metrics)[0] ?? null;
176
+ }
177
+ /**
178
+ Whether two polylines cross: some segment of one passes through some
179
+ segment of the other more than `tolerance` pixels from either segment's
180
+ ends (merely touching, or meeting where two leaders leave neighboring
181
+ slivers together, doesn't count).
182
+ @param a One polyline.
183
+ @param b The other.
184
+ @param tolerance How far from a segment's ends a crossing must be.
185
+ */ export function polylinesCross(a, b, tolerance = 2) {
186
+ for(let i = 1; i < a.length; i++)for(let j = 1; j < b.length; j++){
187
+ const [p, q, r, s] = [
188
+ a[i - 1],
189
+ a[i],
190
+ b[j - 1],
191
+ b[j]
192
+ ];
193
+ const d1 = [
194
+ q[0] - p[0],
195
+ q[1] - p[1]
196
+ ];
197
+ const d2 = [
198
+ s[0] - r[0],
199
+ s[1] - r[1]
200
+ ];
201
+ const denom = d1[0] * d2[1] - d1[1] * d2[0];
202
+ if (Math.abs(denom) < 1e-12) continue;
203
+ const e = [
204
+ r[0] - p[0],
205
+ r[1] - p[1]
206
+ ];
207
+ const t = (e[0] * d2[1] - e[1] * d2[0]) / denom;
208
+ const u = (e[0] * d1[1] - e[1] * d1[0]) / denom;
209
+ const l1 = Math.hypot(...d1);
210
+ const l2 = Math.hypot(...d2);
211
+ const inside = (v, len)=>v * len > tolerance && (1 - v) * len > tolerance;
212
+ if (inside(t, l1) && inside(u, l2)) return true;
213
+ }
214
+ return false;
215
+ }
216
+ /**
217
+ The height a slice's label would like: level with the middle of the
218
+ slice's outer edge, pushed out by the leader's elbow.
219
+ @param angle The slice's middle angle.
220
+ @param radius The ring's outer radius.
221
+ @param metrics The label metrics.
222
+ */ export function outsideIdealY(angle, radius, metrics) {
223
+ return -(radius + metrics.elbow) * Math.cos(angle);
224
+ }