@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,103 @@
1
+ /**
2
+ Lays out a Sankey with circular links: runs the layout once to see where
3
+ the nodes fall, reserves room around them for the circular links' lanes
4
+ and legs, runs it again inside that room, then places each circular
5
+ link's band (see `circularLinks.ts`).
6
+ */
7
+ import type { CircularNode, CircularShape } from "./circularLinks.js";
8
+ type Extent = [[number, number], [number, number]];
9
+ /** A circular link once laid out. */
10
+ export interface CircularLaidLink<N, D> {
11
+ source: N;
12
+ target: N;
13
+ value: number;
14
+ datum: D;
15
+ width: number;
16
+ y0: number;
17
+ y1: number;
18
+ /** The band's geometry (see `circularLinkShape`). */
19
+ circular: CircularShape;
20
+ }
21
+ /**
22
+ The pixels per unit of value the layout drew the nodes at: a node's
23
+ height over its value (every node shares it), or 0 when no node has a
24
+ value.
25
+ */
26
+ export declare function sankeyScale(nodes: readonly {
27
+ value?: number;
28
+ y0: number;
29
+ y1: number;
30
+ }[]): number;
31
+ /**
32
+ Shrinks `reserve` (top + bottom, left + right) to at most half of the
33
+ chart's height and width, so the nodes always keep room to draw.
34
+ */
35
+ export declare function capReserve(reserve: {
36
+ top: number;
37
+ right: number;
38
+ bottom: number;
39
+ left: number;
40
+ }, width: number, height: number): {
41
+ top: number;
42
+ right: number;
43
+ bottom: number;
44
+ left: number;
45
+ };
46
+ /**
47
+ The pixels per unit of value the layout draws nodes at in an extent
48
+ `height` tall, as d3-sankey sets it: the scale at which the fullest
49
+ column, with `padding` between its nodes, fills the height.
50
+ @param nodes The nodes, with the column (`layer`) and `value` a layout
51
+ gave them.
52
+ */
53
+ export declare function columnScale(nodes: readonly {
54
+ layer: number;
55
+ value?: number;
56
+ }[], height: number, padding: number): number;
57
+ /**
58
+ The largest scale `ky` at which the nodes, drawn in the height left after
59
+ `reserve(ky)` (the room the circular links take at that scale), are
60
+ drawn at `ky`: so the nodes fill what the lanes leave.
61
+ @param scaleFor The scale nodes are drawn at in a height (see `columnScale`).
62
+ @param reserve The height the circular links take at a scale.
63
+ @param most The scale to search below.
64
+ */
65
+ export declare function solveScale(scaleFor: (height: number) => number, reserve: (ky: number) => number, height: number, most: number): number;
66
+ /**
67
+ Where each column's nodes sit across, in an extent from `x0` to `x1`, as
68
+ d3-sankey spreads them: `lastLayer + 1` columns, `nodeWidth` wide.
69
+ */
70
+ export declare function columnEdges(x0: number, x1: number, lastLayer: number, nodeWidth: number): (layer: number) => [number, number];
71
+ /**
72
+ Runs `run` (the Sankey layout over the links that aren't circular) and
73
+ returns the circular links, laid out around the nodes.
74
+ @param run Lays the nodes out inside an extent.
75
+ @param nodes The nodes, laid out in place by `run`.
76
+ @param links The other links, laid out in place by `run`.
77
+ @param circular The circular links, with node indices for ends.
78
+ @param padding The gap between nodes in a column (`nodePadding`).
79
+ */
80
+ export declare function layOutCircular<N extends CircularNode & {
81
+ value?: number;
82
+ depth?: number;
83
+ }, D>(opts: {
84
+ run: (extent: Extent) => void;
85
+ nodes: readonly N[];
86
+ links: readonly {
87
+ source: N;
88
+ target: N;
89
+ y0: number;
90
+ y1: number;
91
+ }[];
92
+ circular: readonly {
93
+ source: number;
94
+ target: number;
95
+ value: number;
96
+ datum: D;
97
+ i: number;
98
+ }[];
99
+ width: number;
100
+ height: number;
101
+ padding: number;
102
+ }): CircularLaidLink<N, D>[];
103
+ export {};
@@ -0,0 +1,178 @@
1
+ /**
2
+ Pure geometry for Sankey's circular links: the links that loop back into
3
+ a node they left (see `sankeyAcyclicLinks`), drawn as bands that leave
4
+ the source's right side, turn up (or down), run along a lane above (or
5
+ below) every node, and turn back into the target's left side.
6
+ */
7
+ import type { Edge } from "./ribbons.js";
8
+ import type { LinkAnchor } from "../features/linkLabelGeometry.js";
9
+ /** Which side of the nodes a circular link's lane runs along. */
10
+ export type CircularSide = "top" | "bottom";
11
+ /** A laid-out node, as the circular layout reads it. */
12
+ export interface CircularNode {
13
+ layer: number;
14
+ x0: number;
15
+ x1: number;
16
+ y0: number;
17
+ y1: number;
18
+ }
19
+ /** A circular link, as the circular layout reads it. */
20
+ export interface CircularLinkInput {
21
+ index: number;
22
+ source: CircularNode;
23
+ target: CircularNode;
24
+ value: number;
25
+ /** The band's width, in pixels. */
26
+ width: number;
27
+ }
28
+ /** Where a circular link's lane and legs sit, from `circularLanes`. */
29
+ export interface CircularLane {
30
+ /** The total width of the lanes between this one and the nodes. */
31
+ depth: number;
32
+ /**
33
+ The radius of the band's turns at its source, past the bands inside
34
+ it: also how far right of the source's right edge its leg runs.
35
+ */
36
+ arcSource: number;
37
+ /** The same at its target: how far left of the target's left edge its leg runs. */
38
+ arcTarget: number;
39
+ }
40
+ /** A circular link's drawn band, from `circularLinkShape`. */
41
+ export interface CircularShape {
42
+ side: CircularSide;
43
+ /** The source's right edge, and where the band leaves it. */
44
+ xs: number;
45
+ sy: number;
46
+ /** The target's left edge, and where the band enters it. */
47
+ xt: number;
48
+ ty: number;
49
+ /** The lane's center line. */
50
+ laneY: number;
51
+ /** The x of the band's leg past the source, and the radius of its turns. */
52
+ xr: number;
53
+ rs: number;
54
+ /** The x of the band's leg before the target, and the radius of its turns. */
55
+ xl: number;
56
+ rt: number;
57
+ }
58
+ /** The corner radius of the innermost band's turns, past half its width. */
59
+ export declare const CIRCULAR_RADIUS = 8;
60
+ /** The gap between the nodes and the innermost lane, in pixels. */
61
+ export declare const CIRCULAR_CLEARANCE = 12;
62
+ /**
63
+ Which side a circular link's lane runs along: above the nodes when the
64
+ middle of its two ends sits in the upper half of the nodes' extent
65
+ (`top` to `bottom`), else below. Each return band stays on the half of
66
+ the chart its ends are on, so its legs are short and it crosses as few
67
+ other bands as it can.
68
+ */
69
+ export declare function circularLinkSide(link: Pick<CircularLinkInput, "source" | "target">, top: number, bottom: number): CircularSide;
70
+ /**
71
+ Orders one side's circular links from the innermost lane (closest to the
72
+ nodes) outward: shorter spans first, so short loops nest inside long
73
+ ones; then links nearer that side (higher, for the top) first, so a
74
+ band never turns across the bands that leave above it; then heavier
75
+ first, then in the order given. The order is the links' stacking at
76
+ each node too: an inner band attaches closer to the node's edge.
77
+ */
78
+ export declare function circularLinkOrder<L extends CircularLinkInput>(links: readonly L[], side: CircularSide): L[];
79
+ /**
80
+ Each circular link's lane and legs, for one side's links in the order of
81
+ `circularLinkOrder`. The legs leaving (or entering) one column nest,
82
+ each turning around the ones inside it. A lane sits outside every
83
+ earlier lane it would run into: one whose band, legs included, spans
84
+ some of the same width of the chart.
85
+ @param links One side's links, innermost first.
86
+ @param columnX Where a column's nodes sit across: their left and right
87
+ edges.
88
+ */
89
+ export declare function circularLanes(links: readonly CircularLinkInput[], columnX: (layer: number) => readonly [number, number]): CircularLane[];
90
+ /** The margins the circular links' lanes and legs need around the nodes. */
91
+ export interface CircularReserve {
92
+ top: number;
93
+ right: number;
94
+ bottom: number;
95
+ left: number;
96
+ }
97
+ /**
98
+ The space the circular links need outside the nodes: above and below
99
+ for their lanes, and beside the first and last columns for their legs.
100
+ @param sides Each side's links (in the order of `circularLinkOrder`)
101
+ and their lanes.
102
+ @param lastLayer The index of the last column.
103
+ */
104
+ export declare function circularReserve(sides: readonly {
105
+ side: CircularSide;
106
+ links: readonly CircularLinkInput[];
107
+ lanes: readonly CircularLane[];
108
+ }[], lastLayer: number): CircularReserve;
109
+ /**
110
+ A circular link's band: where it leaves its source (`y0`) and enters
111
+ its target (`y1`), its legs, and its lane, which runs `CIRCULAR_CLEARANCE`
112
+ plus its lane's `depth` outside `edge` (the top of the highest node, or
113
+ the bottom of the lowest). Each turn's radius is its arc, or less where
114
+ the band's leg is too short for two.
115
+ */
116
+ export declare function circularLinkShape(link: CircularLinkInput & {
117
+ y0: number;
118
+ y1: number;
119
+ }, lane: CircularLane, side: CircularSide, edge: number): CircularShape;
120
+ /**
121
+ A circular link's center line from its source to its target, made of
122
+ straight runs and quarter turns.
123
+ */
124
+ export declare function circularLinkEdge(shape: CircularShape): Edge;
125
+ /** A circular link's center line as a path (see `circularLinkEdge`). */
126
+ export declare function circularLinkD(shape: CircularShape): string;
127
+ /**
128
+ A circular link's band moved `offset` pixels outward, away from the
129
+ loop it makes (inward when negative): its straight runs move out and
130
+ its turns widen around the same centers.
131
+ */
132
+ export declare function offsetCircularShape(shape: CircularShape, offset: number): CircularShape;
133
+ /**
134
+ A circular link's band as a filled ribbon, `half` its thickness each
135
+ side of its center line.
136
+ */
137
+ export declare function circularRibbonD(shape: CircularShape, half: number): string;
138
+ /** The middle of a circular link's lane, where its label goes. */
139
+ export declare function circularLinkAnchor(shape: CircularShape): LinkAnchor;
140
+ /**
141
+ The value a node is sized by: the larger of the flow leaving it and the
142
+ flow entering it, counting circular links too.
143
+ @param i The node's index.
144
+ @param links Every link Sankey draws, with node indices for ends.
145
+ */
146
+ export declare function sankeyNodeValue(i: number, links: readonly {
147
+ source: number;
148
+ target: number;
149
+ value: number;
150
+ }[]): number;
151
+ /**
152
+ Moves where links meet each node to make room for its circular links:
153
+ those whose lanes run above stack down from the node's top (innermost
154
+ first), the node's other links follow below them, and those whose lanes
155
+ run below stack up from its bottom. Sets each circular link's `y0`
156
+ (where it leaves its source) and `y1` (where it enters its target), and
157
+ shifts the other links' ends down past the circular links above them.
158
+ @param sides Each side's circular links, in the order of `circularLinkOrder`.
159
+ @param links The other links, with the ends the layout gave them.
160
+ */
161
+ export declare function stackCircularEnds<N extends {
162
+ y0: number;
163
+ y1: number;
164
+ }, C extends {
165
+ source: N;
166
+ target: N;
167
+ width: number;
168
+ y0?: number;
169
+ y1?: number;
170
+ }>(sides: readonly {
171
+ side: CircularSide;
172
+ links: readonly C[];
173
+ }[], links: readonly {
174
+ source: N;
175
+ target: N;
176
+ y0: number;
177
+ y1: number;
178
+ }[]): void;
@@ -2,5 +2,63 @@
2
2
  `sankeyEmit` — link Paths + per-shape-type node groups (typically Rect).
3
3
  Emits flat SceneNodes directly (no transient Shape compute pass).
4
4
  */
5
+ import type { DataPoint } from "@d3plus/data";
6
+ import type { LinkDatum } from "../features/linkInteraction.js";
7
+ import type { LinkAnchor } from "../features/linkLabelGeometry.js";
5
8
  import type { ChartEmit } from "../definition/ChartDefinition.js";
9
+ import type { CircularShape } from "./circularLinks.js";
10
+ export interface SankeyLink {
11
+ source: SankeyNode;
12
+ target: SankeyNode;
13
+ value: number;
14
+ datum: LinkDatum;
15
+ width?: number;
16
+ y0?: number;
17
+ y1?: number;
18
+ /** A link that loops back: its band's geometry (see `circularLinkShape`). */
19
+ circular?: CircularShape;
20
+ }
21
+ export type SankeyNode = DataPoint & {
22
+ __d3plus__?: true;
23
+ data?: DataPoint;
24
+ i?: number;
25
+ id: string | number;
26
+ shape: string;
27
+ x0: number;
28
+ y0: number;
29
+ x1: number;
30
+ y1: number;
31
+ };
32
+ export interface SankeyCtx {
33
+ links: SankeyLink[];
34
+ nodeGroups: [string, SankeyNode[]][];
35
+ width: number;
36
+ height: number;
37
+ }
38
+ /**
39
+ A band's thickness: its layout width less a pixel each side, so
40
+ neighboring bands show a gap, and at least 1.
41
+ */
42
+ export declare function sankeyBandThickness(link: {
43
+ width?: number;
44
+ }): number;
45
+ /** A link's band as a filled ribbon from node to node, `half` its thickness each side of its center line. */
46
+ export declare function sankeyRibbonD(link: SankeyLink, half: number): string;
47
+ /**
48
+ Each link's key ids, `source-target`, unique across `links`: parallel
49
+ links after the first add their order among them (see `uniqueLinkKeys`).
50
+ A link's scene key is `sankey-link-${ids}`.
51
+ */
52
+ export declare const sankeyLinkIds: (links: readonly SankeyLink[]) => string[];
53
+ /**
54
+ Where a link's label goes: the middle of its band, which runs as a
55
+ horizontal link curve from where it leaves its source to where it enters
56
+ its target.
57
+ */
58
+ export declare function sankeyLinkAnchor(link: SankeyLink): LinkAnchor | null;
59
+ /**
60
+ The curve a link's label follows: its band's centerline, or a circular
61
+ link's center line around its return lane.
62
+ */
63
+ export declare function sankeyLinkPath(link: SankeyLink): [number, number][] | null;
6
64
  export declare const sankeyEmit: ChartEmit;
@@ -0,0 +1,19 @@
1
+ /**
2
+ `sankeyLabels` — node labels drawn beside each node: to the right of it,
3
+ over its outgoing links, except in the last column, where they sit to the
4
+ left, over the incoming links.
5
+ */
6
+ import type { DataPoint } from "@d3plus/data";
7
+ import type { SceneNode } from "@d3plus/render";
8
+ import type { VizInstance } from "../viz/vizTypes.js";
9
+ type SankeyNode = DataPoint & {
10
+ data?: DataPoint;
11
+ i?: number;
12
+ id: string | number;
13
+ x0: number;
14
+ y0: number;
15
+ x1: number;
16
+ y1: number;
17
+ };
18
+ export declare function sankeyLabels(viz: VizInstance, nodes: SankeyNode[], cfg: Record<string, unknown>, width: number, height: number): SceneNode[];
19
+ export {};
@@ -0,0 +1,36 @@
1
+ /**
2
+ Sankey bands as filled ribbons: the area between two edges, one each
3
+ side of the band's center line. A ribbon keeps its thickness however
4
+ steeply the band runs, where a thick stroke along the center line folds
5
+ over itself on the inside of a tight curve.
6
+ */
7
+ export type Point = [number, number];
8
+ /** One step of an edge: a straight run to `to`, or a cubic curve through `c1` and `c2`. */
9
+ export interface EdgeStep {
10
+ to: Point;
11
+ c1?: Point;
12
+ c2?: Point;
13
+ }
14
+ /** A path from `start` through each step. */
15
+ export interface Edge {
16
+ start: Point;
17
+ steps: EdgeStep[];
18
+ }
19
+ /** An edge as a path `d`. */
20
+ export declare function edgeD(edge: Edge): string;
21
+ /** The same edge, run from its end back to its start. */
22
+ export declare function reverseEdge(edge: Edge): Edge;
23
+ /** An edge moved `dy` pixels down. */
24
+ export declare function shiftEdge(edge: Edge, dy: number): Edge;
25
+ /**
26
+ The closed ribbon between two edges that both run from a band's source
27
+ to its target: along `a`, across to the end of `b`, and back along `b`.
28
+ */
29
+ export declare function ribbonD(a: Edge, b: Edge): string;
30
+ /**
31
+ A band's ribbon from `[x0, y0]` (where it leaves its source) to
32
+ `[x1, y1]` (where it enters its target), `half` its thickness each side
33
+ of its center line: d3-sankey's horizontal link curve, its edges the
34
+ curve moved up and down.
35
+ */
36
+ export declare function bandRibbonD(x0: number, y0: number, x1: number, y1: number, half: number): string;
@@ -0,0 +1,24 @@
1
+ /**
2
+ Finds the links that close a loop (A → B → A, or A → A), so Sankey can
3
+ lay out the rest.
4
+ */
5
+ /** A link between two nodes, given as node indices, and its flow. */
6
+ export interface SankeyWeightedLink {
7
+ source: number;
8
+ target: number;
9
+ value: number;
10
+ }
11
+ /**
12
+ Splits links into a set Sankey can lay out, with no loops, and the links
13
+ left out because they close one. Links are taken heaviest `value` first
14
+ (ties in the order given), and a link is left out when the links kept
15
+ so far already lead from its target back to its source. So every link
16
+ left out is the lightest on a loop it closes, and adding any of them
17
+ back would close a loop. A link from a node to itself is left out too.
18
+ Both lists keep the order the links were given in.
19
+ @param links Links whose `source` and `target` are node indices.
20
+ */
21
+ export declare function sankeyAcyclicLinks<L extends SankeyWeightedLink>(links: readonly L[]): {
22
+ kept: L[];
23
+ looped: L[];
24
+ };
@@ -45,10 +45,16 @@ export interface SankeyGenerator {
45
45
  links(links: SankeyLinkInput[]): SankeyGenerator;
46
46
  linkSort(sort: Comparator<SankeyLink> | null | undefined): SankeyGenerator;
47
47
  size(size: [number, number]): SankeyGenerator;
48
+ /** The box the nodes are laid out in: `[[x0, y0], [x1, y1]]`. */
49
+ extent(extent: [[number, number], [number, number]]): SankeyGenerator;
48
50
  iterations(iterations: number): SankeyGenerator;
49
51
  }
50
52
  export declare const sankeyLeft: SankeyAlign;
51
53
  export declare const sankeyRight: SankeyAlign;
54
+ /**
55
+ Sources at the left, sinks at the right edge, and the rest by depth. A
56
+ node with no links at all sits at the left, with the sources.
57
+ */
52
58
  export declare const sankeyJustify: SankeyAlign;
53
59
  export declare const sankeyCenter: SankeyAlign;
54
60
  /** A horizontal link path from its source node's right edge to its target's left. */
@@ -0,0 +1,36 @@
1
+ /**
2
+ What Sankey lays out: the links it can draw (both ends name a node, and
3
+ the two are different nodes), and the value each node without a drawn
4
+ link is sized by.
5
+ */
6
+ /** A link's resolved ends, as indices into the nodes. */
7
+ export interface SankeyLinkEnds {
8
+ source: number | undefined;
9
+ target: number | undefined;
10
+ }
11
+ /**
12
+ Splits links into the ones Sankey draws and the ones it leaves out: a
13
+ link with an end that names no node, or a link from a node to itself
14
+ (a flow can't loop back into the node it leaves).
15
+ */
16
+ export declare function sankeyDrawableLinks<L extends SankeyLinkEnds>(links: readonly L[]): {
17
+ drawn: (L & {
18
+ source: number;
19
+ target: number;
20
+ })[];
21
+ unresolved: L[];
22
+ selfLinks: L[];
23
+ };
24
+ /**
25
+ The value a node no drawn link touches is sized by: `own` (the `value`
26
+ accessor read from the node's own row) when it is a positive number,
27
+ else the smallest positive value among the drawn links, else 1.
28
+ */
29
+ export declare function unlinkedNodeValue(own: unknown, linkValues: readonly number[]): number;
30
+ /**
31
+ The warning Sankey logs when it leaves out links that loop back into a
32
+ node they left (a link from a node to itself, or one that closes a loop
33
+ through several nodes), naming each link once as "source → target".
34
+ @param ends Each left-out link's source and target node ids.
35
+ */
36
+ export declare function sankeyLoopWarning(ends: readonly (readonly [unknown, unknown])[]): string;
@@ -0,0 +1,15 @@
1
+ /**
2
+ Scatter — Plot drawing every row as a point (`shape: "Circle"`).
3
+ */
4
+ import type { ChartDefinition } from "../definition/ChartDefinition.js";
5
+ export declare const scatterDef: ChartDefinition;
6
+ /**
7
+ Creates a scatter plot from an array of data: each row draws as a point at
8
+ its `x` and `y` values, on continuous axes (set `discrete` to place points
9
+ along a category axis). Points are `sizeMin` pixels in radius; a `size`
10
+ accessor scales them between `sizeMin` and `sizeMax` and adds a size
11
+ legend (see BubbleChart for bubbles sized by area). Hover any point for
12
+ its values.
13
+ */
14
+ declare const _default: new () => any;
15
+ export default _default;
@@ -0,0 +1,43 @@
1
+ /**
2
+ SlopeChart — a LinePlot comparing each series between two periods.
3
+ */
4
+ import type { DataPoint } from "@d3plus/data";
5
+ import type { ChartDefinition } from "../definition/ChartDefinition.js";
6
+ import type { VizInstance } from "../viz/vizTypes.js";
7
+ /**
8
+ The value axis config that hides its labels, ticks, gridlines, and line:
9
+ each line's labels name its values.
10
+ */
11
+ export declare const slopeValueAxis: {
12
+ barConfig: {
13
+ stroke: string;
14
+ };
15
+ labels: never[];
16
+ ticks: never[];
17
+ };
18
+ /**
19
+ Notes each series' direction, and warns when the data spans more than
20
+ two periods (every period is still drawn).
21
+ */
22
+ export declare function prepareSlope(viz: VizInstance): void;
23
+ /**
24
+ The color `slopeColor` gives a row's series, or `undefined` when it is
25
+ off or the series has no direction yet.
26
+ */
27
+ export declare function slopeFill(viz: VizInstance, d: DataPoint, i: number): string | undefined;
28
+ export declare const slopeChartDef: ChartDefinition;
29
+ /**
30
+ Creates a slope chart from an array of data: a LinePlot comparing each
31
+ series between two periods, with a line from its first value to its
32
+ second. Each line is labeled at both ends with its series name and value
33
+ (`lineLabels: "both"` with `lineLabelConfig: {value: true}`), labels that
34
+ would overlap are nudged apart on each side, and the value axis hides its
35
+ labels, ticks, and gridlines, since the labels carry the values (tooltips
36
+ still show them). The x axis shows the periods in the data; with more
37
+ than two, every period is drawn and a warning suggests filtering to two.
38
+ Markers sit at each end of every line. `slopeColor` colors each line by
39
+ whether it rose, fell, or stayed flat. For ranks rather than values, use
40
+ a two-period BumpChart, which labels its rank axes with the series names.
41
+ */
42
+ declare const _default: new () => any;
43
+ export default _default;
@@ -0,0 +1,43 @@
1
+ /**
2
+ Pure helpers behind SlopeChart: the periods its data spans, each series'
3
+ direction between its first and last period, and the colors
4
+ `slopeColor` draws those directions in.
5
+
6
+ @module
7
+ */
8
+ /** Which way a series moved between its first and last period. */
9
+ export type SlopeDirection = "up" | "down" | "flat";
10
+ /** The colors `slopeColor` draws each direction in. */
11
+ export interface SlopeColors {
12
+ up: string;
13
+ down: string;
14
+ flat: string;
15
+ }
16
+ /** The `slopeColor` setting: on with the default colors, off, or on with some colors set. */
17
+ export type SlopeColorSetting = boolean | Partial<SlopeColors>;
18
+ /** A row accessor. */
19
+ type Accessor = (d: Record<string, unknown>, i: number) => unknown;
20
+ /**
21
+ The distinct periods among `values`, first to last: in time or numeric
22
+ order when every value is a Date or a number, else in the order they
23
+ first appear.
24
+ */
25
+ export declare function slopePeriods(values: unknown[]): unknown[];
26
+ /** The direction from `start` to `end`: flat when they are equal. */
27
+ export declare function slopeDirection(start: number, end: number): SlopeDirection;
28
+ /**
29
+ Each series' direction between its first and last period, keyed by the
30
+ series id as a string. A series with fewer than two periods is flat.
31
+ */
32
+ export declare function slopeDirections(rows: Record<string, unknown>[], id: Accessor, x: Accessor, y: Accessor): Map<string, SlopeDirection>;
33
+ /** The default direction colors on a light background. */
34
+ export declare const slopeColorsLight: SlopeColors;
35
+ /** The default direction colors on a dark background. */
36
+ export declare const slopeColorsDark: SlopeColors;
37
+ /**
38
+ The colors a `slopeColor` setting draws in, or `null` when it is off:
39
+ the defaults for a light or `dark` background (flat lines in `flat`, the
40
+ theme's muted text, when given), under any colors the setting names.
41
+ */
42
+ export declare function slopeColors(setting: SlopeColorSetting | undefined, dark: boolean, flat?: string): SlopeColors | null;
43
+ export {};
@@ -0,0 +1,28 @@
1
+ /**
2
+ Streamgraph — a StackedArea flowing around a central baseline.
3
+ */
4
+ import type { ChartDefinition } from "../definition/ChartDefinition.js";
5
+ /**
6
+ The value axis config that hides its labels, ticks, and gridlines: the
7
+ stream's baseline moves, so its positions name no values.
8
+ */
9
+ export declare const streamValueAxis: {
10
+ labels: never[];
11
+ ticks: never[];
12
+ };
13
+ export declare const streamgraphDef: ChartDefinition;
14
+ /**
15
+ Creates a streamgraph from an array of data: a StackedArea whose layers
16
+ flow around a central baseline instead of rising from zero. Layers stack
17
+ with `stackOffset: "silhouette"`, which centers every stack on the same
18
+ line, ordered `"insideOut"` (the largest layers in the middle) along
19
+ smooth `monotoneX` curves. The value axis hides its labels and gridlines,
20
+ since a moving baseline has no zero to read them from; each layer's
21
+ thickness carries its value, and tooltips show each value and its share
22
+ of the stack. Set `stackOffset("wiggle")` to keep each layer's slope as
23
+ steady as it can instead, at the cost of a stream that drifts up or down
24
+ as its total changes. Each layer is named along its own stream (see
25
+ `labelPosition`).
26
+ */
27
+ declare const _default: new () => any;
28
+ export default _default;
@@ -0,0 +1,56 @@
1
+ /**
2
+ Where each Sunburst arc's label goes (see `labelPosition`): a straight
3
+ box along the ring or along the radius (`sunburstLabelBox`), or a curve
4
+ along the arc itself (`ringLabelFit`), whichever shows the label larger.
5
+ A curve reads like the box along the ring but follows it, so it wins that
6
+ tie; the box along the radius suits the narrow arcs of the outer rings,
7
+ where a name runs out of arc long before it runs out of ring.
8
+ */
9
+ import type { SceneNode } from "@d3plus/render";
10
+ import type { RingLabelFit } from "../features/ringLabels.js";
11
+ import type { LabelMetrics } from "../partition/labelWords.js";
12
+ import type { VizInstance } from "../viz/vizTypes.js";
13
+ import type { SunburstLabelBox } from "./labelFit.js";
14
+ import type { SunburstArc } from "./geometry.js";
15
+ import type { SunburstNode } from "./partition.js";
16
+ /** Every labeled arc's straight box or curve. */
17
+ export interface SunburstLabelPlacements {
18
+ boxes: Map<SunburstNode, SunburstLabelBox>;
19
+ curves: Map<SunburstNode, RingLabelFit>;
20
+ }
21
+ /** What placing the labels needs. */
22
+ export interface SunburstLabelInputs {
23
+ /** Each node's label text. */
24
+ labelOf: (node: SunburstNode) => string;
25
+ /** Each node's padded arc. */
26
+ arcOf: (node: SunburstNode) => SunburstArc & {
27
+ padAngle?: number;
28
+ };
29
+ fontMin: number;
30
+ fontMax: number;
31
+ }
32
+ /**
33
+ A label's one-line width at a font size, from its words measured at 1px.
34
+ @param metrics The label's words and space at a 1px font size.
35
+ */
36
+ export declare function metricsWidth(metrics: LabelMetrics): (fontSize: number) => number;
37
+ /**
38
+ Places every node's label, measured in the label font: a straight box,
39
+ a curve along its arc, or nothing when neither fits.
40
+ @param viz The chart.
41
+ @param nodes The laid-out nodes.
42
+ @param labelConfig The Path labelConfig.
43
+ @param inputs Each node's text and arc, and the font range.
44
+ */
45
+ export declare function sunburstLabelPlacements(viz: VizInstance, nodes: SunburstNode[], labelConfig: Record<string, unknown>, inputs: SunburstLabelInputs): SunburstLabelPlacements;
46
+ /**
47
+ The text nodes for the curved labels.
48
+ @param viz The chart.
49
+ @param curves Each curved node's fit.
50
+ @param labelConfig The Path labelConfig.
51
+ @param inputs Each node's text and text color.
52
+ */
53
+ export declare function sunburstCurvedNodes(viz: VizInstance, curves: Map<SunburstNode, RingLabelFit>, labelConfig: Record<string, unknown>, inputs: {
54
+ labelOf: (node: SunburstNode) => string;
55
+ colorOf: (node: SunburstNode) => string;
56
+ }): SceneNode[];