@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
@@ -0,0 +1,65 @@
1
+ /**
2
+ Node and link resolution shared by the node-link charts (Network,
3
+ ArcDiagram): merges `data` onto `nodes` by id, and resolves each link's
4
+ `source`/`target` (an index into `nodes`, a node object, or an id string)
5
+ to its node record.
6
+ */
7
+ import type { SimulationNodeDatum } from "d3-force";
8
+ import type { DataPoint } from "@d3plus/data";
9
+ import type { VizInstance } from "../viz/vizTypes.js";
10
+ import type { LinkDatum, LinkEnd } from "../features/linkInteraction.js";
11
+ import type { SelfLoopGeometry } from "../features/selfLoops.js";
12
+ /** One resolved node: its merged row, its `nodes` entry, and its sizing inputs. */
13
+ export interface GraphNode extends SimulationNodeDatum {
14
+ __d3plus__: true;
15
+ /** The `data` row for this node, or its `nodes` entry when no row matches. */
16
+ data: DataPoint;
17
+ i: number;
18
+ id: string;
19
+ fx: number;
20
+ fy: number;
21
+ /** The node's entry in `nodes`. */
22
+ node: DataPoint;
23
+ /** The node's raw `size` value (or `sizeMin` when unsized), before scaling. */
24
+ r: number;
25
+ shape: string;
26
+ width?: number;
27
+ height?: number;
28
+ }
29
+ /** One resolved link: its endpoints' node records and its raw `linkSize` value. */
30
+ export interface GraphLink {
31
+ source: GraphNode;
32
+ target: GraphNode;
33
+ size: number;
34
+ /** The datum the link is drawn with, when both its ends resolve (see `makeLinkDatum`). */
35
+ datum?: LinkDatum;
36
+ /** The loop a link from a node to itself draws as, once laid out. */
37
+ loop?: SelfLoopGeometry;
38
+ /** The link's bundled path, from its source to its target (see `linkBundle`). */
39
+ points?: [number, number][];
40
+ }
41
+ /** A node record as a link end. */
42
+ export declare const graphLinkEnd: (n: GraphNode) => LinkEnd;
43
+ /** A node row's id: its `groupBy` id, else its `nodeGroupBy` id at the drawn depth. */
44
+ export declare function graphNodeId(viz: VizInstance, d: Record<string, unknown>, i: number): string;
45
+ /**
46
+ Resolves the filtered data and `nodes` into node records, in the order the
47
+ ids first appear (data rows, then nodes). Only ids present in `nodes`
48
+ become nodes; a matching data row supplies a node's values. `fx`/`fy` read
49
+ the chart's `x`/`y` accessors when it has them.
50
+ */
51
+ export declare function resolveGraphNodes(v: VizInstance): GraphNode[];
52
+ /**
53
+ Resolves `links` against `nodes`, index-aligned with `links`: an endpoint
54
+ that matches no node is undefined. A link whose ends both resolve gets its
55
+ datum, which `linkSize` receives (with the link's index). Stashes the id → node lookup on
56
+ `v.ctx.nodeLookup` and the id → neighbor nodes lookup on
57
+ `v.ctx.linkLookup` (a link from a node to itself adds no neighbor).
58
+ */
59
+ export declare function resolveGraphLinks(v: VizInstance, nodes: GraphNode[]): GraphLink[];
60
+ /**
61
+ Zooms to a node-space extent. Node coordinates sit under the chart's
62
+ margin-origin transform and the current zoom, so they're mapped to their
63
+ on-screen position first — the space `_zoomToBounds` expects.
64
+ */
65
+ export declare function zoomToNodeBounds(viz: VizInstance, xDomain: number[], yDomain: number[]): void;
@@ -0,0 +1,20 @@
1
+ /**
2
+ The per-instance fluent methods every node-link chart (Network,
3
+ ArcDiagram) installs in its `setup`: `links`, `nodes`, `nodeGroupBy`,
4
+ `size`, and `hover`. They need imperative bodies (queue loading, `aggs`
5
+ side effects), so they are installed per instance rather than as fields.
6
+ */
7
+ import type { DataPoint } from "@d3plus/data";
8
+ import type { VizInstance } from "../viz/vizTypes.js";
9
+ type Predicate = boolean | ((d: DataPoint, i: number) => boolean);
10
+ /** The fluent methods `installGraphFluent` adds. */
11
+ export type GraphFluent = {
12
+ hover: (predicate?: Predicate) => unknown;
13
+ links: (data?: DataPoint[], formatter?: unknown) => unknown;
14
+ nodes: (data?: DataPoint[], formatter?: unknown) => unknown;
15
+ nodeGroupBy: (keys?: unknown) => unknown;
16
+ size: (value?: unknown) => unknown;
17
+ };
18
+ /** Installs `links`, `nodes`, `nodeGroupBy`, `size`, and `hover` on a node-link chart. */
19
+ export declare function installGraphFluent(v: VizInstance & GraphFluent): void;
20
+ export {};
@@ -0,0 +1,18 @@
1
+ /**
2
+ The closest pair of Network nodes, which caps the largest node radius.
3
+
4
+ @module
5
+ */
6
+ /** A positioned node; a missing coordinate counts as 0. */
7
+ export interface PositionedNode {
8
+ x?: number;
9
+ y?: number;
10
+ }
11
+ /**
12
+ The smallest `pointDistance` between two different nodes, or undefined
13
+ when no pair has one (fewer than two nodes, or none with a numeric
14
+ position). Distances that aren't numbers are skipped, as `d3.min` skips
15
+ them. Sorts the nodes by x and sweeps, skipping pairs further apart in x
16
+ than the closest pair found so far.
17
+ */
18
+ export declare function minNodeDistance(nodes: readonly PositionedNode[]): number | undefined;
@@ -0,0 +1,29 @@
1
+ /**
2
+ A `polygonContains` for one polygon tested at many points that share
3
+ rows: the edge crossings along each row are found once.
4
+
5
+ @module
6
+ */
7
+ type Point = [number, number];
8
+ /** A polygon's edge crossings by row, and the test they answer. */
9
+ export interface PolygonRows {
10
+ /** Whether `point` lies inside, as `polygonContains(polygon, point)`. */
11
+ contains: (point: Point) => boolean;
12
+ /** Where the polygon's edges cross the row at `y` (see `insideRow`). */
13
+ row: (y: number) => number[];
14
+ }
15
+ /**
16
+ Whether `x` lies inside a polygon along a row whose edge crossings are
17
+ `xs`: d3-polygon's ray cast, toggling at each crossing past `x`.
18
+ */
19
+ export declare function insideRow(xs: readonly number[], x: number): boolean;
20
+ /**
21
+ Tests points against `polygon` with d3-polygon's `polygonContains` rule
22
+ (a ray cast along the point's row, toggling at each edge it crosses).
23
+ The crossings are worked out with the same arithmetic, so each answer
24
+ equals `polygonContains(polygon, point)`; they are kept per row, so the
25
+ points of a grid cost one pass over the edges per row instead of per
26
+ point.
27
+ */
28
+ export declare function polygonRows(polygon: readonly Point[]): PolygonRows;
29
+ export {};
@@ -1,8 +1,36 @@
1
1
  /**
2
2
  `applyPieLayout` — Pie's chart-specific layout stage. Runs the d3-shape
3
- pie layout against `viz._filteredData`, tags each slice with `__d3plus__`
4
- + index, builds the arc generator from the current schema values, and
5
- stores `pieData`/`arcData`/`pieWidth`/`pieHeight` on `viz.ctx`.
3
+ pie layout against `viz._filteredData` over the configured sweep, fits the
4
+ ring's footprint to the chart area, tags each slice with `__d3plus__` +
5
+ index, builds the arc generator from the current schema values, and
6
+ stores `pieData`/`arcData`/`pieSweep`/`pieCenter`/`pieBox` on `viz.ctx`.
6
7
  */
7
8
  import type { TransformStage } from "../pipeline/stages.js";
9
+ import type { VizInstance } from "../viz/vizTypes.js";
10
+ import type { PieSweep } from "./arcFit.js";
11
+ import type { PieRoom } from "./labelRoom.js";
12
+ import type { PieSlice } from "./pieLabels.js";
13
+ /** Pie's resolved sweep, from its `startAngle` and `endAngle` settings. */
14
+ export declare function pieSweepOf(viz: VizInstance): PieSweep;
15
+ /**
16
+ The outer radius a hole-less ring of this Pie's sweep gets in the chart
17
+ area, before any room is kept for the hover stroke. Donut's default
18
+ `innerRadius` is half of it.
19
+ */
20
+ export declare function pieBaseRadius(viz: VizInstance): number;
21
+ /** The width/height ratio of this Pie's hole-less footprint: 1 for a full circle, 2 for a half ring. */
22
+ export declare function pieAspect(viz: VizInstance): number;
23
+ /**
24
+ Lays the slices out with `room` kept around the ring for labels outside
25
+ it: the ring fits the chart area less that room, its inner radius shrinks
26
+ with it, and it sits within the room left. Stores the layout on
27
+ `viz.ctx` (see `applyPieLayout`) and returns the slices.
28
+ @param viz The chart.
29
+ @param room The room kept on each side.
30
+ */
31
+ export declare function pieRingLayout(viz: VizInstance, room?: PieRoom): PieSlice[];
32
+ /**
33
+ Lays the slices out, keeping room around the ring for the labels that
34
+ go outside it (see `layoutWithLabelRoom`).
35
+ */
8
36
  export declare const applyPieLayout: TransformStage;
@@ -0,0 +1,63 @@
1
+ /**
2
+ Pure geometry for a Pie's sweep: the angular range its slices fill, the
3
+ bounding box of the ring they draw, and where that ring sits in the chart
4
+ area. Angles are radians in d3's convention (0 at 12 o'clock, increasing
5
+ clockwise), so a point at angle `a` and radius `r` sits at
6
+ `(r·sin a, −r·cos a)`.
7
+ */
8
+ /** The angular range a Pie's slices fill, in radians. `end` may be less than `start` (a counter-clockwise sweep). */
9
+ export interface PieSweep {
10
+ start: number;
11
+ end: number;
12
+ }
13
+ /** An axis-aligned box around the ring's center. */
14
+ export interface ArcBox {
15
+ x0: number;
16
+ x1: number;
17
+ y0: number;
18
+ y1: number;
19
+ }
20
+ /** Where the ring sits in the chart area, how large it is, and its footprint in pixels around its center. */
21
+ export interface RingFit {
22
+ cx: number;
23
+ cy: number;
24
+ radius: number;
25
+ box: ArcBox;
26
+ }
27
+ /**
28
+ Resolves the `startAngle` and `endAngle` settings (degrees clockwise from
29
+ 12 o'clock) to a sweep in radians. An unset `endAngle` makes a full turn
30
+ from `startAngle`, and the sweep never exceeds one turn in either direction.
31
+ */
32
+ export declare function pieSweep(startAngle: unknown, endAngle: unknown): PieSweep;
33
+ /** Whether a sweep goes all the way around. */
34
+ export declare function isFullTurn(start: number, end: number): boolean;
35
+ /** Where `angle` falls within the sweep, from 0 at its start to 1 at its end, wrapping around the circle. */
36
+ export declare function sweepFraction(angle: number, sweep: PieSweep): number;
37
+ /**
38
+ The bounding box of a ring's slice from `start` to `end`, in units of its
39
+ outer radius: the outer arc's ends, every 12, 3, 6 and 9 o'clock extreme
40
+ it passes, and the inner arc's ends at `inner` (a fraction of the outer
41
+ radius; 0 puts them at the center).
42
+ */
43
+ export declare function ringExtent(start: number, end: number, inner?: number): ArcBox;
44
+ /**
45
+ Fits a ring sweeping from `start` to `end` (radians) into `width` ×
46
+ `height`, inset by `pad` on every side: the largest outer radius at which
47
+ the ring's own footprint fits, with an inner radius of `innerRadius`
48
+ pixels. The footprint is centered in any room left over.
49
+ */
50
+ export declare function fitRing(width: number, height: number, start: number, end: number, innerRadius?: number, pad?: number): RingFit;
51
+ /**
52
+ The size a ring sweeping from `start` to `end` needs for an outer radius
53
+ of `radius`, inset by `pad` on every side (the inverse of `fitRing`, for
54
+ a ring without a hole).
55
+ @param radius The outer radius.
56
+ @param start Where the sweep starts.
57
+ @param end Where it ends.
58
+ @param pad The inset on each side.
59
+ */
60
+ export declare function ringSizeFor(radius: number, start: number, end: number, pad?: number): {
61
+ width: number;
62
+ height: number;
63
+ };
@@ -0,0 +1,57 @@
1
+ import type { DataPoint } from "@d3plus/data";
2
+ import type { SceneNode } from "@d3plus/render";
3
+ import type { RingArc } from "../features/ringLabels.js";
4
+ import type { VizInstance } from "../viz/vizTypes.js";
5
+ /** A laid-out slice, as `pieEmit` sees it. */
6
+ export interface PieLabelSlice {
7
+ data: DataPoint;
8
+ i?: number;
9
+ }
10
+ /** What placing the curved labels needs from `pieEmit`. */
11
+ export interface PieCurvedInputs<S extends PieLabelSlice> {
12
+ viz: VizInstance;
13
+ slices: S[];
14
+ /** Each slice's ring segment. */
15
+ arcOf: (slice: S) => RingArc;
16
+ /** Each slice's name. */
17
+ nameOf: (slice: S) => string;
18
+ /** Each slice's share, as text. */
19
+ shareOf: (slice: S) => string;
20
+ /** Each slice's fill. */
21
+ fillOf: (slice: S) => unknown;
22
+ /** The straight labels, as `emitLabels` drew them. */
23
+ straight: SceneNode[];
24
+ /** The Path shape's labelConfig. */
25
+ labelConfig: Record<string, unknown>;
26
+ }
27
+ /**
28
+ The font range curved labels try: the labelConfig's `fontSize` alone,
29
+ else `fontMin` to `fontMax`, 8 to 24 by default.
30
+ @param config The labelConfig.
31
+ */
32
+ export declare function ringFontRange(config: Record<string, unknown>): {
33
+ fontMin: number;
34
+ fontMax: number;
35
+ };
36
+ /**
37
+ Whether laid-out lines show all of `text`: every letter, in order, with
38
+ nothing cut short. A word hyphenated across two lines still counts as
39
+ shown whole.
40
+ @param lines The laid-out lines' text.
41
+ @param text The label's text.
42
+ */
43
+ export declare function textShownWhole(lines: string[], text: string): boolean;
44
+ /** The labels for every slice, and which slices they name in full. */
45
+ export interface PieSliceLabelNodes<S> {
46
+ straight: SceneNode[];
47
+ curved: SceneNode[];
48
+ /** The slices whose label shows their whole name. */
49
+ whole: Set<S>;
50
+ }
51
+ /**
52
+ The labels for every slice: each slice's straight label (from
53
+ `straight`) or its curved one, whichever its `labelPosition` and the fit
54
+ choose (see `chooseRingLabel`).
55
+ @param inputs The slices and their geometry, fills, and straight labels.
56
+ */
57
+ export declare function pieSliceLabels<S extends PieLabelSlice>(inputs: PieCurvedInputs<S>): PieSliceLabelNodes<S>;
@@ -0,0 +1,83 @@
1
+ import type { VizInstance } from "../viz/vizTypes.js";
2
+ import type { CrowdedLabel } from "./outsideNodes.js";
3
+ import type { PieSlice } from "./pieLabels.js";
4
+ /** The smallest a ring shrinks to make room for labels outside it, as a share of its full radius. */
5
+ export declare const PIE_MIN_SCALE = 0.6;
6
+ /** The most room a single label claims beside the ring, as a share of the chart's width; a longer label wraps. */
7
+ export declare const OUTSIDE_MAX_SHARE = 0.3;
8
+ /** The room kept on each side of the ring, in pixels. */
9
+ export interface PieRoom {
10
+ left: number;
11
+ right: number;
12
+ top: number;
13
+ bottom: number;
14
+ }
15
+ /** No room kept. */
16
+ export declare const NO_ROOM: PieRoom;
17
+ /**
18
+ Scales the room on two opposite sides down, keeping their proportions,
19
+ so the ring keeps at least `min` of the chart's `size` between them.
20
+ @param a The room on one side.
21
+ @param b The room on the other.
22
+ @param size The chart area's size across both.
23
+ @param min The least the ring keeps.
24
+ */
25
+ export declare function clampSides(a: number, b: number, size: number, min: number): [number, number];
26
+ /**
27
+ The width a label claims beside the ring: its own when it is at most
28
+ `cap`, else the narrowest it wraps onto two lines when that is, else
29
+ none (it is drawn only where the room happens to hold it).
30
+ @param width The label's one-line width.
31
+ @param wrapWidth The narrowest it wraps onto two lines.
32
+ @param cap The most a label claims.
33
+ */
34
+ export declare function outsideClaim(width: number, wrapWidth: number, cap: number): number;
35
+ /**
36
+ The room to keep beside the ring at the current layout: `room`, grown
37
+ on each side to fit that side's widest label outside the ring (see
38
+ `outsideClaim`; a label claims at most `OUTSIDE_MAX_SHARE` of the
39
+ chart's width), then scaled back so the ring keeps `minWidth`.
40
+ @param viz The chart, laid out with `room`.
41
+ @param slices The laid-out slices.
42
+ @param room The room the layout kept.
43
+ @param minWidth The least width the ring keeps.
44
+ */
45
+ export declare function pieLabelRoom(viz: VizInstance, slices: PieSlice[], room: PieRoom, minWidth: number): PieRoom;
46
+ /**
47
+ The room to keep above and below the ring for the labels its columns
48
+ had no place for: each one's height, above the ring when its slice
49
+ faces up and below it when its slice faces down, added to `room`, then
50
+ scaled back so the ring keeps `minHeight` of the chart's `height`.
51
+ @param room The room the layout kept.
52
+ @param crowded The labels with no place.
53
+ @param height The chart area's height.
54
+ @param minHeight The least height the ring keeps.
55
+ */
56
+ export declare function crowdedRoom(room: PieRoom, crowded: CrowdedLabel[], height: number, minHeight: number): PieRoom;
57
+ /**
58
+ The room worth keeping once the labels are placed: a side where no
59
+ label was placed gives its room back to the ring.
60
+ @param room The room kept.
61
+ @param used Whether a label was placed on each side.
62
+ */
63
+ export declare function usedRoom(room: PieRoom, used: {
64
+ left: boolean;
65
+ right: boolean;
66
+ }): PieRoom;
67
+ /**
68
+ Lays the slices out, keeping room around the ring for the labels that
69
+ go outside it. Room beside the ring is grown twice at most (see
70
+ `pieLabelRoom`), since a smaller ring can send more labels outside; then
71
+ room above and below it is kept, once, for the labels the columns had
72
+ no place for (see `crowdedRoom`); last, a side whose labels couldn't be
73
+ placed gives its room back to the ring. The room only grows until that
74
+ last step, so the ring only shrinks, never below `min` (the ring's size
75
+ at `PIE_MIN_SCALE`).
76
+ @param viz The chart.
77
+ @param layout Lays the slices out with room kept around the ring.
78
+ @param min The least size the ring keeps.
79
+ */
80
+ export declare function layoutWithLabelRoom(viz: VizInstance, layout: (room: PieRoom) => PieSlice[], min: {
81
+ width: number;
82
+ height: number;
83
+ }): PieSlice[];
@@ -0,0 +1,119 @@
1
+ /** A point, `[x, y]`. */
2
+ export type Point = [number, number];
3
+ /** The label font size when the Path labelConfig sets none. */
4
+ export declare const OUTSIDE_LABEL_FONT_SIZE = 12;
5
+ /** How the leaders and labels sit beside the ring, in pixels. */
6
+ export interface OutsideMetrics {
7
+ /** The label's font size. */
8
+ fontSize: number;
9
+ /** The height each label takes in its column. */
10
+ lineHeight: number;
11
+ /** How far the leader runs straight out from the ring before it bends. */
12
+ elbow: number;
13
+ /** The shortest horizontal run of a leader before its label. */
14
+ tail: number;
15
+ /** The gap between the end of a leader and its label's text. */
16
+ gap: number;
17
+ }
18
+ /**
19
+ The metrics for labels at `fontSize`: a column line of 1.3em, and a
20
+ leader that runs out 10px, bends, and runs at least 8px across to a
21
+ label 4px past its end.
22
+ @param fontSize The label's font size.
23
+ */
24
+ export declare function outsideMetrics(fontSize: number): OutsideMetrics;
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
+ */
31
+ export declare function outsideSide(angle: number): 1 | -1;
32
+ /**
33
+ How far from the ring's center each side's leaders end, where the
34
+ labels' text starts (less `gap`): past the ring by the elbow and the
35
+ shortest horizontal run.
36
+ @param radius The ring's outer radius.
37
+ @param metrics The label metrics.
38
+ */
39
+ export declare function outsideColumn(radius: number, metrics: OutsideMetrics): number;
40
+ /**
41
+ The room labels need beside the ring on each side: the widest label on
42
+ that side, plus its leader and gap, or 0 for a side without labels.
43
+ @param labels Each label's middle angle and text width.
44
+ @param metrics The label metrics.
45
+ */
46
+ export declare function outsideRoom(labels: {
47
+ angle: number;
48
+ width: number;
49
+ }[], metrics: OutsideMetrics): {
50
+ left: number;
51
+ right: number;
52
+ };
53
+ /** One label in a side's column. */
54
+ export interface StackItem {
55
+ /** The height it would like its middle to sit at. */
56
+ y: number;
57
+ /** How tall it is. */
58
+ size: number;
59
+ /** How much it matters: the smallest are dropped first. */
60
+ weight: number;
61
+ }
62
+ /**
63
+ Stacks one side's labels so none overlap and all stay between `bounds`:
64
+ sorted by the height each would like, then spread as little as they
65
+ must (see `spreadLabelPositions`). While they don't all fit, or `fits`
66
+ rejects one where it lands, the label with the smallest weight is
67
+ dropped and the rest are stacked again. Returns the height of each
68
+ label's middle, or null for a dropped one.
69
+ @param items The labels.
70
+ @param bounds The top and bottom of the room they share.
71
+ @param fits Whether label `i` may sit at height `y`.
72
+ */
73
+ export declare function stackOutsideLabels(items: StackItem[], bounds: [number, number], fits?: (i: number, y: number) => boolean): (number | null)[];
74
+ /** The distance from the origin to the segment from `p` to `q`. */
75
+ export declare function segmentDistance(p: Point, q: Point): number;
76
+ /** A leader: from the slice's outer edge, through two bends, to the label's column. */
77
+ export type Leader = [Point, Point, Point, Point];
78
+ /**
79
+ The ways a leader can run from a slice to its label at height `y`, best
80
+ first. The first runs straight out from the middle of the slice's outer
81
+ edge by the elbow, across to the label's height, and level for the last
82
+ `tail` pixels into the label's column, when its run across keeps half an
83
+ elbow clear of the ring. The second leaves the ring leaning only as far
84
+ as it must to stay outside it, reaching the label's height before it
85
+ runs level into the column, when that is short of the column. Empty when
86
+ the label's height can't be reached without crossing the ring.
87
+ @param angle The slice's middle angle.
88
+ @param radius The ring's outer radius.
89
+ @param y The label's height.
90
+ @param metrics The label metrics.
91
+ */
92
+ export declare function leaderRoutes(angle: number, radius: number, y: number, metrics: OutsideMetrics): Leader[];
93
+ /**
94
+ The leader from a slice to its label at height `y`: the best of
95
+ `leaderRoutes`, or null when there is none.
96
+ @param angle The slice's middle angle.
97
+ @param radius The ring's outer radius.
98
+ @param y The label's height.
99
+ @param metrics The label metrics.
100
+ */
101
+ export declare function leaderPoints(angle: number, radius: number, y: number, metrics: OutsideMetrics): Leader | null;
102
+ /**
103
+ Whether two polylines cross: some segment of one passes through some
104
+ segment of the other more than `tolerance` pixels from either segment's
105
+ ends (merely touching, or meeting where two leaders leave neighboring
106
+ slivers together, doesn't count).
107
+ @param a One polyline.
108
+ @param b The other.
109
+ @param tolerance How far from a segment's ends a crossing must be.
110
+ */
111
+ export declare function polylinesCross(a: Point[], b: Point[], tolerance?: number): boolean;
112
+ /**
113
+ The height a slice's label would like: level with the middle of the
114
+ slice's outer edge, pushed out by the leader's elbow.
115
+ @param angle The slice's middle angle.
116
+ @param radius The ring's outer radius.
117
+ @param metrics The label metrics.
118
+ */
119
+ export declare function outsideIdealY(angle: number, radius: number, metrics: OutsideMetrics): number;
@@ -0,0 +1,93 @@
1
+ import type { SceneNode } from "@d3plus/render";
2
+ import type { VizInstance } from "../viz/vizTypes.js";
3
+ import type { Leader, OutsideMetrics } from "./outsideLabels.js";
4
+ import type { OutsideCandidate, PieSlice } from "./pieLabels.js";
5
+ /** The leader's opacity over the theme's ink. */
6
+ export declare const LEADER_OPACITY = 0.5;
7
+ /**
8
+ When an outside label and its leader fade in: over the second half of a
9
+ redraw, once the slices have mostly settled, so they don't fade in
10
+ where a label that is leaving still shows.
11
+ */
12
+ export declare const OUTSIDE_ENTER: {
13
+ start: number;
14
+ end: number;
15
+ };
16
+ /** Where the ring sits: its radius, its center in the chart area, and the chart area's size. */
17
+ export interface OutsideFrame {
18
+ radius: number;
19
+ cx: number;
20
+ cy: number;
21
+ width: number;
22
+ height: number;
23
+ }
24
+ /** A label to stack beside the ring: its slice's middle angle, its weight, and how many lines it takes. */
25
+ export interface OutsideStackLabel {
26
+ angle: number;
27
+ weight: number;
28
+ lines: number;
29
+ }
30
+ /** Where a stacked label goes: the height of its middle, and its leader. */
31
+ export interface OutsidePlacement {
32
+ y: number;
33
+ leader: Leader;
34
+ }
35
+ /**
36
+ The room beside the ring on each side, from where the labels' text
37
+ starts to the chart area's edge.
38
+ @param frame The ring and the chart area.
39
+ @param metrics The label metrics.
40
+ */
41
+ export declare function outsideSpace(frame: OutsideFrame, metrics: OutsideMetrics): {
42
+ left: number;
43
+ right: number;
44
+ };
45
+ /**
46
+ Stacks the outside labels: each side's labels in a column beside the
47
+ ring, within the chart area's height, the smallest slices' labels
48
+ dropped when they don't all fit or a leader can't reach one (see
49
+ `stackOutsideLabels`). Each leader takes the best of its routes (see
50
+ `leaderRoutes`) that crosses no leader above it; when every route
51
+ crosses one, the side's smallest slice gives up its label and the side
52
+ is stacked again. Returns each label's placement, or null for a
53
+ dropped one.
54
+ @param labels The labels.
55
+ @param frame The ring and the chart area.
56
+ @param metrics The label metrics.
57
+ */
58
+ export declare function placeOutsideLabels(labels: OutsideStackLabel[], frame: OutsideFrame, metrics: OutsideMetrics): (OutsidePlacement | null)[];
59
+ /** A label that fit its side's room but found no place in its column. */
60
+ export interface CrowdedLabel {
61
+ /** Its slice's middle angle. */
62
+ angle: number;
63
+ /** Its height. */
64
+ size: number;
65
+ }
66
+ /** The outside labels' scene nodes, the slices they name, and the labels that found no place. */
67
+ export interface PieOutsideScene {
68
+ nodes: SceneNode[];
69
+ named: Set<PieSlice>;
70
+ crowded: CrowdedLabel[];
71
+ }
72
+ /**
73
+ The outside labels' scene nodes, the slices they name, and the labels
74
+ their columns had no place for (see `CrowdedLabel`): a leader and
75
+ a label per slice placed beside the ring (see `placeOutsideLabels`), in
76
+ the theme's ink unless the Path labelConfig's `fontColor` sets a color.
77
+ A label wider than its side's room wraps onto a second line, between
78
+ words, and drops its share when even that is too narrow; a label that
79
+ can't show its slice's whole name within its room is left out, so the
80
+ slice keeps its label inside the ring.
81
+ @param viz The chart.
82
+ @param candidates The slices whose labels go outside.
83
+ @param frame The ring and the chart area.
84
+ */
85
+ export declare function pieOutsideNodes(viz: VizInstance, candidates: OutsideCandidate[], frame: OutsideFrame): PieOutsideScene;
86
+ /**
87
+ The outside labels for the current layout (see `pieOutsideNodes`), with
88
+ the ring and the chart area read from the layout `applyPieLayout` kept
89
+ on `viz.ctx`. Worked out once per layout.
90
+ @param viz The chart, laid out by `applyPieLayout`.
91
+ @param slices The laid-out slices.
92
+ */
93
+ export declare function pieOutsideLabels(viz: VizInstance, slices: PieSlice[]): PieOutsideScene;