@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,85 @@
1
+ /**
2
+ Every label a Pie or Donut draws for its slices: the labels inside the
3
+ ring (straight or curved, see `curvedLabels.ts`), and which slices take
4
+ a label outside the ring instead (see `labelPosition`). The plan is
5
+ worked out once per layout and kept on the chart's context, so the
6
+ layout stage, which sizes the ring to leave room for the outside labels,
7
+ and the emit step share it.
8
+ */
9
+ import type { PieArcDatum } from "d3-shape";
10
+ import type { DataPoint } from "@d3plus/data";
11
+ import type { SceneNode } from "@d3plus/render";
12
+ import type { VizInstance } from "../viz/vizTypes.js";
13
+ /** A laid-out slice. */
14
+ export type PieSlice = PieArcDatum<DataPoint> & {
15
+ __d3plus__?: true;
16
+ i?: number;
17
+ share?: number;
18
+ };
19
+ /** A slice whose label goes outside the ring. */
20
+ export interface OutsideCandidate {
21
+ slice: PieSlice;
22
+ /** The slice's index. */
23
+ index: number;
24
+ /** The slice's middle angle. */
25
+ angle: number;
26
+ /** The label: the slice's name and share. */
27
+ text: string;
28
+ /** The label's one-line width. */
29
+ width: number;
30
+ /** The narrowest it gets wrapped onto two lines between words. */
31
+ wrapWidth: number;
32
+ /** The slice's value: smaller slices give up their labels first. */
33
+ weight: number;
34
+ }
35
+ /** A Pie's labels for one layout. */
36
+ export interface PieLabelPlan {
37
+ /** The straight labels inside the slices. */
38
+ straight: SceneNode[];
39
+ /** The curved labels along the ring. */
40
+ curved: SceneNode[];
41
+ /** The slices whose label goes outside the ring, if there is room for it. */
42
+ outside: OutsideCandidate[];
43
+ }
44
+ /**
45
+ The narrowest a text gets wrapped onto two lines between its words: the
46
+ wider of the two lines at the best break. A single word can't wrap, so
47
+ its width is its own.
48
+ @param text The text.
49
+ @param width A string's one-line width.
50
+ */
51
+ export declare function twoLineWidth(text: string, width: (text: string) => number): number;
52
+ /**
53
+ Formats a slice's share as a percentage in the chart's locale.
54
+ @param viz The chart.
55
+ */
56
+ export declare function pieSharePct(viz: VizInstance): (d: PieSlice) => string;
57
+ /**
58
+ The outside labels' font size: the Path labelConfig's `fontSize`, else
59
+ `OUTSIDE_LABEL_FONT_SIZE`.
60
+ @param labelConfig The Path labelConfig.
61
+ */
62
+ export declare function outsideFontSize(labelConfig: Record<string, unknown>): number;
63
+ /**
64
+ Whether a slice's `labelPosition` puts its label outside the ring:
65
+ always for `"outside"`, never for `"inside"` or `"along"`, and for
66
+ `"auto"` only when its label inside doesn't show its whole name.
67
+ @param position The slice's `labelPosition`.
68
+ @param shownWhole Whether its label inside shows its whole name.
69
+ */
70
+ export declare function labelGoesOutside(position: unknown, shownWhole: boolean): boolean;
71
+ /**
72
+ Whether any slice's `labelPosition` may put its label outside the ring:
73
+ false when every one is `"inside"` or `"along"`.
74
+ @param viz The chart.
75
+ @param slices The laid-out slices.
76
+ */
77
+ export declare function pieMayLabelOutside(viz: VizInstance, slices: PieSlice[]): boolean;
78
+ /**
79
+ Works out every slice's label for the current layout (`viz.ctx.arcData`):
80
+ the labels inside the ring, and the slices whose label goes outside it.
81
+ Kept on `viz.ctx`, so the same layout is only worked out once.
82
+ @param viz The chart, laid out by `applyPieLayout`.
83
+ @param slices The laid-out slices.
84
+ */
85
+ export declare function pieLabelPlan(viz: VizInstance, slices: PieSlice[]): PieLabelPlan;
@@ -0,0 +1,95 @@
1
+ /**
2
+ Axis-aligned boxes centered on a ring segment's bisector: the line from
3
+ the ring's center through the middle of the segment. A box centered on
4
+ it reads as centered in its slice. Every box here is symmetric about its
5
+ center, so where it goes is a single number, the center's distance from
6
+ the ring's center along the bisector.
7
+
8
+ Angles are radians in d3-shape's convention (0 at 12 o'clock, increasing
9
+ clockwise), so a point at angle `a` and radius `r` sits at
10
+ `(r·sin a, −r·cos a)`.
11
+ */
12
+ import type { RingArc } from "../features/ringLabels.js";
13
+ type Pt = [number, number];
14
+ /** A box by its top-left corner and size. */
15
+ export interface SectorBox {
16
+ x: number;
17
+ y: number;
18
+ width: number;
19
+ height: number;
20
+ }
21
+ /** One straight side of a segment: the line its pad leaves along a boundary ray. */
22
+ export interface SectorSide {
23
+ /** The unit normal pointing into the segment. */
24
+ normal: Pt;
25
+ /** The side's distance from the ring's center, along `normal`. */
26
+ offset: number;
27
+ /** The boundary ray's direction, away from the center. */
28
+ ray: Pt;
29
+ }
30
+ /** A segment's edges, as `sectorEdges` resolves them. */
31
+ export interface SectorEdges {
32
+ /** The bisector's angle. */
33
+ mid: number;
34
+ /** The bisector's direction, away from the center. */
35
+ dir: Pt;
36
+ /** The angle the segment spans, after its pad. */
37
+ span: number;
38
+ /** The radius a box stays outside of (0 for none). */
39
+ inner: number;
40
+ /** The radius a box stays inside of. */
41
+ outer: number;
42
+ /** The two straight sides, or none for a full turn. */
43
+ sides: SectorSide[];
44
+ }
45
+ /**
46
+ Resolves a ring segment's edges, the way d3-shape's arc draws it: a
47
+ `padAngle` narrows a Pie wedge (no hole) by that angle, and offsets a
48
+ ring segment's sides by a constant gap (`padAngle` at the default pad
49
+ radius, `√(inner² + outer²)`). `padding` keeps a box that much further
50
+ inside every edge. A full turn has no sides; its bisector points up.
51
+ Null when the segment has no area.
52
+ @param arc The segment.
53
+ @param padding The room kept inside every edge, in pixels.
54
+ */
55
+ export declare function sectorEdges(arc: RingArc, padding?: number): SectorEdges | null;
56
+ /**
57
+ The stretch of a segment's bisector where a `width`×`height` box can be
58
+ centered and stay inside the segment, as distances from the ring's
59
+ center: from `lo` to `hi`. For a whole disc it runs through the center,
60
+ from `-hi` to `hi`. Null when the box fits nowhere along it.
61
+ @param edges The segment's edges (see `sectorEdges`).
62
+ @param width The box's width.
63
+ @param height The box's height.
64
+ */
65
+ export declare function sectorBoxRange(edges: SectorEdges, width: number, height: number): {
66
+ lo: number;
67
+ hi: number;
68
+ } | null;
69
+ /**
70
+ The box of the given size centered on the bisector at distance `t`.
71
+ @param edges The segment's edges.
72
+ @param t The center's distance from the ring's center.
73
+ @param width The box's width.
74
+ @param height The box's height.
75
+ */
76
+ export declare function sectorBoxAt(edges: SectorEdges, t: number, width: number, height: number): SectorBox;
77
+ /**
78
+ A `width`×`height` box centered on a segment's bisector, halfway along
79
+ the stretch where it fits (see `sectorBoxRange`), so the room around it
80
+ is shared out evenly. Null when it fits nowhere.
81
+ @param edges The segment's edges.
82
+ @param width The box's width.
83
+ @param height The box's height.
84
+ */
85
+ export declare function centeredSectorBox(edges: SectorEdges, width: number, height: number): SectorBox | null;
86
+ /**
87
+ The largest box of a given shape centered on a segment's bisector, at
88
+ the one place along it where that box fits. The scale is searched from
89
+ 0 up to the ring's diameter.
90
+ @param edges The segment's edges.
91
+ @param size The box's width and height at a scale, growing with it.
92
+ @param iterations How finely the scale is searched.
93
+ */
94
+ export declare function largestSectorBox(edges: SectorEdges, size: (scale: number) => [number, number], iterations?: number): SectorBox | null;
95
+ export {};
@@ -0,0 +1,24 @@
1
+ import type { SceneNode } from "@d3plus/render";
2
+ import type { RingArc } from "../features/ringLabels.js";
3
+ import type { VizInstance } from "../viz/vizTypes.js";
4
+ import type { PieSlice } from "./pieLabels.js";
5
+ /** What placing the straight labels needs. */
6
+ export interface StraightLabelInputs {
7
+ viz: VizInstance;
8
+ slices: PieSlice[];
9
+ /** Each slice's ring segment. */
10
+ arcOf: (d: PieSlice) => RingArc;
11
+ /** The Path shape config, for each slice's fill. */
12
+ sc: Record<string, unknown>;
13
+ /** Each slice's share, as text. */
14
+ sharePct: (d: PieSlice) => string;
15
+ /** The Path shape's labelConfig. */
16
+ labelConfig: Record<string, unknown>;
17
+ }
18
+ /**
19
+ Each slice's straight label, centered on its bisector: the name, at the
20
+ largest size that shows it whole, and the share percentage beneath it
21
+ when there is room (see `straightLabelLayout`).
22
+ @param inputs The slices, their segments and fills, and the label config.
23
+ */
24
+ export declare function pieStraightLabels(inputs: StraightLabelInputs): SceneNode[];
@@ -0,0 +1,88 @@
1
+ /**
2
+ Sizes a Pie slice's straight label to its slice: the name, wrapped
3
+ between words onto as many lines as shows it largest, and the share on a
4
+ smaller line beneath it, in a box centered on the slice's bisector (see
5
+ `sectorBox.ts`).
6
+ */
7
+ import type { SceneNode } from "@d3plus/render";
8
+ import type { SectorBox, SectorEdges } from "./sectorBox.js";
9
+ /** How a straight label is sized. */
10
+ export interface StraightLabelOptions {
11
+ /** The smallest font size worth drawing. */
12
+ fontMin: number;
13
+ /** The largest font size to try. */
14
+ fontMax: number;
15
+ /** The room kept between the text and its box's edges, in pixels. */
16
+ padding: number;
17
+ /** The line height, as a multiple of the font size. */
18
+ lineHeight: number;
19
+ /** The share's font size, as a multiple of the name's. */
20
+ shareRatio: number;
21
+ /** The share is drawn when the name, with it, keeps at least this share of its size alone… */
22
+ shareKeep: number;
23
+ /** …or at least this font size. */
24
+ shareFont: number;
25
+ /** The room kept around the text inside its slice, as a multiple of the font size, when that is more than `padding`. */
26
+ margin: number;
27
+ /** The most lines the name wraps onto. */
28
+ maxLines: number;
29
+ }
30
+ /** The defaults for `StraightLabelOptions`. */
31
+ export declare const STRAIGHT_LABEL_DEFAULTS: StraightLabelOptions;
32
+ /**
33
+ The straight label options a labelConfig asks for: its `fontSize` alone
34
+ when it sets one, else `fontMin` to `fontMax` (10 to 32 by default), and
35
+ its `padding` (5 by default).
36
+ @param config The labelConfig.
37
+ */
38
+ export declare function straightLabelOptions(config: Record<string, unknown>): StraightLabelOptions;
39
+ /**
40
+ The narrowest a text wraps between its words onto 1, 2, … lines: for
41
+ each line count, the widest line at the best breaks. Stops at
42
+ `maxLines`, or at one line per word.
43
+ @param text The text.
44
+ @param width A string's one-line width.
45
+ @param maxLines The most lines.
46
+ */
47
+ export declare function wrapWidths(text: string, width: (text: string) => number, maxLines: number): number[];
48
+ /** A straight label's sizes and boxes. */
49
+ export interface StraightLabelLayout {
50
+ /** The name's font size. */
51
+ fontSize: number;
52
+ /** The lines the name wraps onto. */
53
+ lines: number;
54
+ /** The share's font size, or null when it isn't drawn. */
55
+ shareSize: number | null;
56
+ /** The name's box. */
57
+ name: SectorBox;
58
+ /** The share's box, beneath the name's. */
59
+ share: SectorBox | null;
60
+ /** The center of the whole label, on the slice's bisector. */
61
+ center: [number, number];
62
+ /** Whether no font size shows the whole name, so it is cut short at `fontMin`. */
63
+ truncated: boolean;
64
+ }
65
+ /**
66
+ Lays a straight label out in a slice: the largest whole font size (up to
67
+ `fontMax`) at which the name, wrapped onto some number of lines, and the
68
+ share beneath it fit in a box centered on the slice's bisector, with
69
+ room around them (see `margin`). The share is left off when it would
70
+ shrink the name too much (see `shareKeep` and `shareFont`); a name on
71
+ more lines must show larger than on fewer. The box goes halfway along
72
+ the stretch of the bisector where it fits. When even `fontMin` doesn't
73
+ fit the name whole, the label is one line at `fontMin`, as wide as the
74
+ slice allows, and is cut short; null when that has no room for a few
75
+ letters.
76
+ @param edges The slice's edges (see `sectorEdges`).
77
+ @param wraps The name's width at a font size of 1 on 1, 2, … lines (see `wrapWidths`).
78
+ @param shareWidth The share's width at a font size of 1, or null for none.
79
+ @param options How the label is sized.
80
+ */
81
+ export declare function straightLabelLayout(edges: SectorEdges, wraps: number[], shareWidth: number | null, options?: StraightLabelOptions): StraightLabelLayout | null;
82
+ /**
83
+ Moves a label's text nodes up or down together, so their lines' glyphs
84
+ are centered on `y`.
85
+ @param nodes One label's nodes.
86
+ @param y Where the lines' middle goes.
87
+ */
88
+ export declare function centerLabelLines(nodes: SceneNode[], y: number): void;
@@ -0,0 +1,42 @@
1
+ import type { VizInstance } from "../viz/vizTypes.js";
2
+ /** How many series (lines or stacked bands) a draw had, asked to be labeled along, and labeled. */
3
+ export interface AlongStats {
4
+ series: number;
5
+ requested: number;
6
+ placed: number;
7
+ }
8
+ /** Fresh counts for a draw. */
9
+ export declare const emptyAlongStats: () => AlongStats;
10
+ /**
11
+ Whether a chart draws stacked areas whose labels can run along their
12
+ bands: it stacks, draws its first row as an Area, and `labelPosition`
13
+ can ask for along labels.
14
+ @param viz The chart.
15
+ */
16
+ export declare function bandLabelsPossible(viz: VizInstance): boolean;
17
+ /**
18
+ Whether this chart's legend may stand aside for its along labels: it is
19
+ the default legend (a user's `legend` always wins), no series is hidden
20
+ or soloed from it (the legend is the way back to them), and `lineLabels`
21
+ or stacked areas can ask for along labels, or the chart says its own
22
+ along labels can name every series (`_alongLabelsPossible`, such as a
23
+ RadialBar's curved track labels).
24
+ @param viz The chart.
25
+ */
26
+ export declare function alongLegendAuto(viz: VizInstance): boolean;
27
+ /**
28
+ Whether a draw labeled every series along it: more than one series (a
29
+ lone one has no label to stand in for the legend), each of which asked
30
+ for an along label and got one.
31
+ @param stats The draw's counts.
32
+ */
33
+ export declare function allAlongLabeled(stats: AlongStats | undefined): boolean;
34
+ /**
35
+ Runs a chart's draw, hiding its default legend when along labels name
36
+ every series: the first draw lays out without the legend, and when any
37
+ series goes unlabeled, the chart draws again, from the same margins,
38
+ with the legend.
39
+ @param viz The chart.
40
+ @param draw Draws the chart once.
41
+ */
42
+ export declare function drawWithAlongLegend(viz: VizInstance, draw: () => void): void;
@@ -0,0 +1,119 @@
1
+ import { colorContrast } from "@d3plus/color";
2
+ import type { DataPoint } from "@d3plus/data";
3
+ import type { SceneNode } from "@d3plus/render";
4
+ import type { Edges, Pt } from "../features/pathLabelGeometry.js";
5
+ import type { VizInstance } from "../viz/vizTypes.js";
6
+ /** The room a label keeps from its band's edges, above and below it together. */
7
+ export declare const AREA_LABEL_PADDING = 4;
8
+ /** The along label's weight when the Area's labelConfig sets none: the box labels' regular weight. */
9
+ export declare const AREA_LABEL_FONT_WEIGHT = 400;
10
+ /** The largest along label when the Area's labelConfig sets no `fontSize` or `fontMax`. */
11
+ export declare const AREA_LABEL_FONT_MAX = 16;
12
+ /** The smallest along label, whatever lower `fontMin` the Area's labelConfig sets. */
13
+ export declare const AREA_LABEL_FONT_MIN = 8;
14
+ /**
15
+ Whether a `labelPosition` value runs a stacked area's label along its
16
+ band: `"along"` and `"auto"` (or anything unrecognized) do, `"inside"`
17
+ and `"outside"` keep it in the band's largest box.
18
+ @param position The row's `labelPosition`.
19
+ */
20
+ export declare function labelsAlongBand(position: unknown): boolean;
21
+ /** A point on a band's centerline, and how thick the band is across it. */
22
+ export interface BandSection {
23
+ point: Pt;
24
+ thickness: number;
25
+ }
26
+ /**
27
+ The centerline of a band: at every `step` pixels along `axis` (0 for a
28
+ band running along x, 1 along y), the midpoint between the band's two
29
+ edges there, and the distance between them.
30
+ @param outline The band's closed outline.
31
+ @param axis The axis the band runs along.
32
+ @param step The spacing of the centerline's points.
33
+ */
34
+ export declare function bandSections(outline: Pt[], axis?: 0 | 1, step?: number): BandSection[];
35
+ /**
36
+ The runs of a band's centerline where the band is at least `min` thick:
37
+ the only places a label that needs that much room can sit.
38
+ @param sections The band's sections (see `bandSections`).
39
+ @param min The least thickness.
40
+ */
41
+ export declare function thickRuns(sections: BandSection[], min: number): Pt[][];
42
+ /**
43
+ The polyline with points added along every segment longer than `step`,
44
+ so no stretch of it is more than `step` pixels from a point.
45
+ @param points The polyline.
46
+ @param step The longest gap left between points.
47
+ */
48
+ export declare function densify(points: Pt[], step: number): Pt[];
49
+ /**
50
+ The font sizes to try for an along label, largest first: from `fontSize`
51
+ (or `fontMax`) down to `fontMin`, a pixel at a time, stopping at
52
+ `AREA_LABEL_FONT_MIN` however low `fontMin` goes (unless `fontSize`
53
+ itself is smaller).
54
+ @param config The Area's labelConfig.
55
+ */
56
+ export declare function labelSizes(config?: Record<string, unknown>): number[];
57
+ /**
58
+ The text color of a band's label: the `fontColor` a user's labelConfig
59
+ sets (a color, or an accessor of the band's datum and index), else the
60
+ color that contrasts with the band.
61
+ @param fontColor The user's `fontColor`, if any.
62
+ @param datum The band's datum.
63
+ @param index The band's index.
64
+ @param fill The color the band shows.
65
+ @param colorDefaults The chart's `colorDefaults`, for the contrast.
66
+ */
67
+ export declare function bandTextColor(fontColor: unknown, datum: DataPoint, index: number, fill: string, colorDefaults?: Parameters<typeof colorContrast>[1]): string;
68
+ /**
69
+ The font weight of a band's label: the Area labelConfig's `fontWeight`
70
+ (a weight, or an accessor of the band's datum and index), the same one
71
+ its box label would take, else regular.
72
+ @param fontWeight The labelConfig's `fontWeight`, if any.
73
+ @param datum The band's datum.
74
+ @param index The band's index.
75
+ */
76
+ export declare function bandFontWeight(fontWeight: unknown, datum: DataPoint, index: number): number | string;
77
+ /** Where a band's label goes: the path its baseline follows, and its font size. */
78
+ export interface BandLabelPlacement {
79
+ /** The baseline, upright, in the plot's coordinates. */
80
+ points: Pt[];
81
+ fontSize: number;
82
+ }
83
+ /**
84
+ The best stretch of a band's centerline for its label, at the largest
85
+ font size that fits: a stretch where the band is at least the font size
86
+ plus `AREA_LABEL_PADDING` thick under the whole label and inside the
87
+ plot, scored toward where the band is thickest and flattest. Null when
88
+ no size fits anywhere.
89
+ @param outlines The band's closed outlines (one per run of defined data).
90
+ @param width The label's width at a font size.
91
+ @param sizes The font sizes to try, largest first.
92
+ @param rect The plot area.
93
+ @param axis The axis the band runs along.
94
+ */
95
+ export declare function placeBandLabel(outlines: Pt[][], width: (fontSize: number) => number, sizes: number[], rect: Edges, axis?: 0 | 1): BandLabelPlacement | null;
96
+ /**
97
+ The color a band shows: its fill, laid over the chart's background at
98
+ its opacity.
99
+ @param fill The band's fill.
100
+ @param opacity Its fill opacity.
101
+ @param background The chart's background.
102
+ */
103
+ export declare function bandColor(fill: string, opacity: number, background: string): string;
104
+ /**
105
+ The labels along every stacked area band whose `labelPosition` runs it
106
+ along (see `labelsAlongBand`), each in the text the Area's `label` gives.
107
+ Counts the bands and labels into `viz._alongStats`, for the legend.
108
+ @param viz The chart.
109
+ @param marks The plot's drawn marks, its Areas among them.
110
+ @param rect The plot area.
111
+ */
112
+ export declare function emitAreaLabels(viz: VizInstance, marks: SceneNode[], rect: Edges): SceneNode[];
113
+ /**
114
+ Wraps a stacked Area's `label` accessor so the bands labeled along their
115
+ centerline (see `emitAreaLabels`) draw no label of their own.
116
+ @param viz The chart.
117
+ @param label The Area's `label` accessor.
118
+ */
119
+ export declare function boxLabelsOnly(viz: VizInstance, label: unknown): (d: DataPoint, i: number) => unknown;
@@ -0,0 +1,24 @@
1
+ /**
2
+ The sorted values a continuous Plot axis spans.
3
+
4
+ @module
5
+ */
6
+ /** A row of Plot's axis data: its axis values, and the row they came from. */
7
+ type AxisRow = Record<string, unknown>;
8
+ /**
9
+ `numbers` sorted ascending (stably, as `sort((a, b) => a - b)`) without
10
+ repeats, keeping the first of each. Sorted as a Float64Array, which
11
+ orders them the same way, unless NaN (which that comparator leaves in
12
+ place) or both zeros (which it keeps in their order, where a Float64Array
13
+ puts -0 first) are among them.
14
+ */
15
+ export declare function uniqueSortedNumbers(numbers: number[]): number[];
16
+ /**
17
+ The values of `axis` across `rows`, sorted (by `sort`, else ascending)
18
+ and without repeats (compared as strings, the
19
+ first of each kept). Sorts `rows` in place, except when every value is a
20
+ number and there is no `sort`: those values are sorted on their own,
21
+ which gives the same list.
22
+ */
23
+ export declare function sortedAxisValues(rows: AxisRow[], axis: string, sort?: (a: AxisRow, b: AxisRow) => number): unknown[];
24
+ export {};
@@ -24,6 +24,8 @@ export interface BarSpan {
24
24
  end: number;
25
25
  /** The bar's center, where its rows are plotted and its label sits. */
26
26
  mid: number;
27
+ /** The merge of the bar's rows' data. */
28
+ data?: DataPoint;
27
29
  }
28
30
  /** A bar before layout: its category, width measure, and merged datum. */
29
31
  export interface MeasuredBar {
@@ -57,12 +59,13 @@ export declare function labelBarWidth(fn: BarWidthAccessor, text: string): BarWi
57
59
  */
58
60
  export declare function measureBars(rows: Row[], axis: "x" | "y", measure: BarWidthAccessor, aggs?: Aggs): MeasuredBar[];
59
61
  /**
60
- Lays bars end to end from zero, in order. Bars without a positive, finite
61
- width are dropped.
62
+ Lays bars end to end from zero, in order, keeping each bar's merged
63
+ `data`. Bars without a positive, finite width are dropped.
62
64
  */
63
65
  export declare function layoutBarSpans(bars: {
64
66
  value: unknown;
65
67
  size: number;
68
+ data?: DataPoint;
66
69
  }[]): BarSpan[];
67
70
  /**
68
71
  Applies `barWidth` to the formatted Plot rows: measures each bar over
@@ -77,6 +80,24 @@ export declare function applyBarWidths(viz: VizInstance, formattedData: Row[], a
77
80
  its own panel when faceted; empty without a total.
78
81
  */
79
82
  export declare function widthShareText(layout: BarSpanLayout, span: BarSpan, locale?: string): string;
83
+ /** What `barWidthShareFormat` receives about a bar, after its merged datum. */
84
+ export interface BarShareInfo {
85
+ /** The bar's share of the total width, from 0 to 1. */
86
+ share: number;
87
+ /** The bar's width measure. */
88
+ size: number;
89
+ /** Every bar's combined width (its own panel's, when faceted). */
90
+ total: number;
91
+ /** The default label: the share as a percentage, such as "23%". */
92
+ text: string;
93
+ }
94
+ /** A `barWidthShareFormat` function. */
95
+ export type BarShareFormat = (d: DataPoint, info: BarShareInfo) => unknown;
96
+ /**
97
+ A bar's width-share label: `barWidthShareFormat` called with the bar's
98
+ merged datum and its share, else the share as a percentage.
99
+ */
100
+ export declare function shareText(viz: VizInstance, layout: BarSpanLayout, span: BarSpan): string;
80
101
  /**
81
102
  A category's axis label with its bar's width share: on a second line
82
103
  beneath the name along a horizontal axis, after it in parentheses along
@@ -84,11 +105,24 @@ export declare function widthShareText(layout: BarSpanLayout, span: BarSpan, loc
84
105
  along the axis, so it never crowds a neighboring label out.
85
106
  */
86
107
  export declare function shareLabel(name: string, share: string, axis: "x" | "y"): string;
108
+ /**
109
+ The secondary axis that carries the width shares when `barWidthShare` is
110
+ "opposite": `x2` (above the bars) for bars along `x`, `y2` (right of them)
111
+ for bars along `y`. Undefined otherwise, or without variable widths.
112
+ */
113
+ export declare function shareAxis(viz: VizInstance): "x2" | "y2" | undefined;
114
+ /**
115
+ Axis config for the axis opposite a variable-width discrete axis when
116
+ `barWidthShare` is "opposite": each bar's width share labeled at its
117
+ center, with no line, ticks, gridlines, or title. Empty for any other
118
+ axis.
119
+ */
120
+ export declare function barShareAxisConfig(viz: VizInstance, axis: "x2" | "y2"): Record<string, unknown>;
87
121
  /**
88
122
  Axis config for a variable-width discrete axis: each category ticked and
89
123
  labeled at its bar's center, and nowhere else, with its width share when
90
- `barWidthShare` is on. Labels the axis rotates show the name alone. Empty
91
- for any other axis.
124
+ `barWidthShare` is `true`. Labels the axis rotates show the name alone.
125
+ Empty for any other axis.
92
126
  */
93
127
  export declare function barSpanAxisConfig(viz: VizInstance, axis: "x" | "y"): Record<string, unknown>;
94
128
  /** The tooltip name of the current `barWidth` measure. */
@@ -0,0 +1,29 @@
1
+ /**
2
+ Labels of a Plot's Circle marks (scatter, bubble, beeswarm points): each
3
+ stays inside its circle when it fits there, else moves beside it where
4
+ there's room, else hides (see `labelPosition` and `features/circleLabels.ts`).
5
+
6
+ @module
7
+ */
8
+ import type { SceneNode } from "@d3plus/render";
9
+ import type { Shape } from "../../shapes/index.js";
10
+ import type { ShapeEmitContext } from "../features/shapeEmit.js";
11
+ /**
12
+ Places the labels of a configured Circle shape before it renders: the
13
+ shape keeps the labels that stay inside (an `"auto"` one no smaller than
14
+ `pointLabelConfig.fontMin`), and the returned function emits the ones that
15
+ sit beside their circles, to paint over the circles. Returns null, leaving
16
+ the shape's labels alone, when the user gave the Circles their own
17
+ `labelBounds`.
18
+ @param ctx The shape group's emit context.
19
+ @param s The Circle shape, configured but not yet rendered.
20
+ @param userConfig The user's merged Circle shapeConfig.
21
+ */
22
+ export declare function plotCircleLabels(ctx: ShapeEmitContext, s: Shape, userConfig: Record<string, unknown>): (() => SceneNode[]) | null;
23
+ /**
24
+ Lifts a Circle group's labels over every circle. Sized circles are layered
25
+ by a `z` rank (largest behind), and a node without one sorts as 0, so
26
+ without this a label would paint beneath the circles layered over its own.
27
+ @param nodes The group's circles and labels.
28
+ */
29
+ export declare function labelsOverCircles(nodes: SceneNode[]): SceneNode[];