@d3plus/core 4.10.0 → 4.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (711) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +178 -9
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +176 -0
  9. package/es/src/charts/Alluvial/layout.js +137 -0
  10. package/es/src/charts/Alluvial/meta.js +57 -0
  11. package/es/src/charts/Alluvial/titles.js +101 -0
  12. package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
  13. package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
  14. package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
  15. package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
  16. package/es/src/charts/ArcDiagram/emit.js +192 -0
  17. package/es/src/charts/ArcDiagram/events.js +148 -0
  18. package/es/src/charts/ArcDiagram/index.js +217 -0
  19. package/es/src/charts/BarChart/index.js +12 -7
  20. package/es/src/charts/BoxWhisker/index.js +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +5 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +6 -11
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +160 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +137 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +206 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +6 -4
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Matrix/applyLayout.js +20 -9
  70. package/es/src/charts/Matrix/index.js +19 -1
  71. package/es/src/charts/Network/applyLayout.js +171 -96
  72. package/es/src/charts/Network/bundle.js +82 -0
  73. package/es/src/charts/Network/clusterLabels.js +423 -0
  74. package/es/src/charts/Network/clusters.js +290 -0
  75. package/es/src/charts/Network/emit.js +257 -75
  76. package/es/src/charts/Network/graph.js +146 -0
  77. package/es/src/charts/Network/graphFluent.js +81 -0
  78. package/es/src/charts/Network/index.js +91 -106
  79. package/es/src/charts/Network/minNodeDistance.js +64 -0
  80. package/es/src/charts/Network/polygonRows.js +44 -0
  81. package/es/src/charts/Pack/applyLayout.js +16 -5
  82. package/es/src/charts/Pack/emit.js +15 -8
  83. package/es/src/charts/Pack/groupRows.js +61 -0
  84. package/es/src/charts/Pack/index.js +8 -1
  85. package/es/src/charts/Pack/neutralPaint.js +20 -0
  86. package/es/src/charts/Pack/nodeNames.js +35 -0
  87. package/es/src/charts/ParallelCoordinates/axes.js +22 -22
  88. package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
  89. package/es/src/charts/ParallelCoordinates/index.js +3 -1
  90. package/es/src/charts/ParallelCoordinates/titles.js +17 -9
  91. package/es/src/charts/Pie/applyLayout.js +86 -27
  92. package/es/src/charts/Pie/arcFit.js +152 -0
  93. package/es/src/charts/Pie/curvedLabels.js +134 -0
  94. package/es/src/charts/Pie/emit.js +51 -96
  95. package/es/src/charts/Pie/index.js +74 -31
  96. package/es/src/charts/Pie/labelRoom.js +154 -0
  97. package/es/src/charts/Pie/outsideLabels.js +224 -0
  98. package/es/src/charts/Pie/outsideNodes.js +267 -0
  99. package/es/src/charts/Pie/pieLabels.js +137 -0
  100. package/es/src/charts/Pie/sectorBox.js +223 -0
  101. package/es/src/charts/Pie/straightLabels.js +96 -0
  102. package/es/src/charts/Pie/straightLayout.js +215 -0
  103. package/es/src/charts/Plot/alongLegend.js +76 -0
  104. package/es/src/charts/Plot/areaEnter.js +68 -0
  105. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  106. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  107. package/es/src/charts/Plot/axisValues.js +43 -0
  108. package/es/src/charts/Plot/barWidth.js +59 -11
  109. package/es/src/charts/Plot/circleLabels.js +98 -0
  110. package/es/src/charts/Plot/connectGaps.js +237 -0
  111. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  112. package/es/src/charts/Plot/draw.js +34 -14
  113. package/es/src/charts/Plot/fillBetween.js +2 -1
  114. package/es/src/charts/Plot/forecastScene.js +3 -4
  115. package/es/src/charts/Plot/index.js +19 -17
  116. package/es/src/charts/Plot/labelPlacement.js +1 -1
  117. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  118. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  119. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  120. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  121. package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
  122. package/es/src/charts/Plot/pipeline.js +66 -19
  123. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  124. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  125. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  126. package/es/src/charts/Plot/pipelineScales.js +40 -8
  127. package/es/src/charts/Plot/plotFacet.js +12 -1
  128. package/es/src/charts/Plot/plotInit.js +40 -5
  129. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  130. package/es/src/charts/Plot/referenceDomains.js +133 -0
  131. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  132. package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
  133. package/es/src/charts/Plot/sharedHover.js +2 -1
  134. package/es/src/charts/Plot/sharedTooltip.js +13 -3
  135. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  136. package/es/src/charts/Plot/trendLabels.js +183 -0
  137. package/es/src/charts/Plot/trendLines.js +1 -0
  138. package/es/src/charts/Plot/trendScene.js +6 -3
  139. package/es/src/charts/Plot/trendTooltip.js +5 -1
  140. package/es/src/charts/PolarArea/index.js +4 -3
  141. package/es/src/charts/Priestley/applyLayout.js +21 -23
  142. package/es/src/charts/Priestley/index.js +4 -37
  143. package/es/src/charts/Priestley/timeAxis.js +103 -0
  144. package/es/src/charts/Pyramid/gutter.js +52 -16
  145. package/es/src/charts/Pyramid/index.js +55 -7
  146. package/es/src/charts/Pyramid/scene.js +4 -4
  147. package/es/src/charts/Radar/applyLayout.js +31 -33
  148. package/es/src/charts/Radar/axisDecorations.js +62 -13
  149. package/es/src/charts/Radar/curvedLabels.js +228 -0
  150. package/es/src/charts/Radar/emit.js +30 -15
  151. package/es/src/charts/Radar/index.js +43 -5
  152. package/es/src/charts/Radar/points.js +85 -0
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +9 -1
  155. package/es/src/charts/RadialBar/index.js +26 -9
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
  158. package/es/src/charts/RadialMatrix/index.js +18 -9
  159. package/es/src/charts/Rings/applyLayout.js +39 -161
  160. package/es/src/charts/Rings/emit.js +219 -63
  161. package/es/src/charts/Rings/index.js +88 -32
  162. package/es/src/charts/Rings/ringsCurves.js +156 -0
  163. package/es/src/charts/Rings/ringsGraph.js +28 -9
  164. package/es/src/charts/Rings/ringsLoops.js +73 -0
  165. package/es/src/charts/Rings/ringsParallel.js +183 -0
  166. package/es/src/charts/Rings/ringsPlacement.js +152 -0
  167. package/es/src/charts/Rings/ringsSizing.js +61 -38
  168. package/es/src/charts/Sankey/applyLayout.js +130 -39
  169. package/es/src/charts/Sankey/circularLayout.js +208 -0
  170. package/es/src/charts/Sankey/circularLinks.js +301 -0
  171. package/es/src/charts/Sankey/emit.js +164 -94
  172. package/es/src/charts/Sankey/index.js +78 -75
  173. package/es/src/charts/Sankey/labels.js +80 -0
  174. package/es/src/charts/Sankey/ribbons.js +88 -0
  175. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  176. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  177. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  178. package/es/src/charts/Scatter/index.js +25 -0
  179. package/es/src/charts/SlopeChart/index.js +116 -0
  180. package/es/src/charts/SlopeChart/slope.js +95 -0
  181. package/es/src/charts/Streamgraph/index.js +51 -0
  182. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  183. package/es/src/charts/Sunburst/emit.js +83 -64
  184. package/es/src/charts/Sunburst/index.js +16 -4
  185. package/es/src/charts/Tree/applyLayout.js +44 -14
  186. package/es/src/charts/Tree/emit.js +5 -5
  187. package/es/src/charts/Tree/index.js +12 -18
  188. package/es/src/charts/Tree/keys.js +33 -0
  189. package/es/src/charts/Tree/nodeLabel.js +15 -0
  190. package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
  191. package/es/src/charts/Treemap/index.js +2 -5
  192. package/es/src/charts/Violin/inner.js +3 -5
  193. package/es/src/charts/definition/makeChart.js +14 -2
  194. package/es/src/charts/drawSteps/backControl.js +17 -5
  195. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  196. package/es/src/charts/drawSteps/minimap.js +10 -25
  197. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  198. package/es/src/charts/drawSteps/searchControls.js +2 -1
  199. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  200. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  201. package/es/src/charts/drawSteps/zoomActions.js +36 -0
  202. package/es/src/charts/drawSteps/zoomControls.js +52 -23
  203. package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
  204. package/es/src/charts/drawSteps/zoomDrag.js +188 -0
  205. package/es/src/charts/drawSteps/zoomFit.js +69 -0
  206. package/es/src/charts/events/click.legend.js +11 -4
  207. package/es/src/charts/events/click.shape.js +13 -4
  208. package/es/src/charts/events/mouseenter.js +6 -16
  209. package/es/src/charts/events/mouseleave.js +9 -2
  210. package/es/src/charts/events/mousemove.legend.js +28 -32
  211. package/es/src/charts/events/mousemove.shape.js +45 -42
  212. package/es/src/charts/facet/drawFacets.js +14 -5
  213. package/es/src/charts/features/annotationFrame.js +179 -0
  214. package/es/src/charts/features/annotationText.js +83 -0
  215. package/es/src/charts/features/annotationTypes.js +10 -0
  216. package/es/src/charts/features/attributionFeature.js +6 -11
  217. package/es/src/charts/features/axes.js +17 -5
  218. package/es/src/charts/features/axesFinal.js +10 -3
  219. package/es/src/charts/features/axesMeasure.js +33 -12
  220. package/es/src/charts/features/axisTooltip.js +138 -0
  221. package/es/src/charts/features/calloutLayout.js +121 -0
  222. package/es/src/charts/features/calloutScene.js +155 -0
  223. package/es/src/charts/features/centerLabel.js +177 -0
  224. package/es/src/charts/features/chartGeometry.js +1 -1
  225. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  226. package/es/src/charts/features/circleLabels.js +207 -0
  227. package/es/src/charts/features/colorScaleBivariate.js +83 -0
  228. package/es/src/charts/features/colorScaleBucket.js +20 -1
  229. package/es/src/charts/features/colorScaleHover.js +33 -7
  230. package/es/src/charts/features/colorScaleLimit.js +73 -0
  231. package/es/src/charts/features/colorScaleTooltip.js +77 -0
  232. package/es/src/charts/features/colorScaleTop.js +61 -0
  233. package/es/src/charts/features/colorScaleValue.js +97 -0
  234. package/es/src/charts/features/curvedArrows.js +191 -0
  235. package/es/src/charts/features/depthKey.js +26 -0
  236. package/es/src/charts/features/edgeArrows.js +220 -5
  237. package/es/src/charts/features/edgeBundling.js +442 -0
  238. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  239. package/es/src/charts/features/ensureZoomDom.js +32 -8
  240. package/es/src/charts/features/features.js +32 -14
  241. package/es/src/charts/features/featuresColorScale.js +75 -20
  242. package/es/src/charts/features/featuresLegend.js +15 -24
  243. package/es/src/charts/features/hoverTicks.js +41 -0
  244. package/es/src/charts/features/idleQueue.js +72 -0
  245. package/es/src/charts/features/legendKeys.js +64 -0
  246. package/es/src/charts/features/lineLabels.js +55 -46
  247. package/es/src/charts/features/linkBundle.js +19 -0
  248. package/es/src/charts/features/linkColor.js +72 -0
  249. package/es/src/charts/features/linkFields.js +86 -0
  250. package/es/src/charts/features/linkFocus.js +118 -0
  251. package/es/src/charts/features/linkInteraction.js +364 -0
  252. package/es/src/charts/features/linkKeys.js +20 -0
  253. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  254. package/es/src/charts/features/linkLabelPath.js +162 -0
  255. package/es/src/charts/features/linkLabels.js +340 -0
  256. package/es/src/charts/features/linkWidths.js +32 -0
  257. package/es/src/charts/features/networkMeasures.js +241 -0
  258. package/es/src/charts/features/nodeStats.js +309 -0
  259. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  260. package/es/src/charts/features/pathLabels.js +50 -0
  261. package/es/src/charts/features/plotAnnotations.js +68 -17
  262. package/es/src/charts/features/plotEndLabels.js +28 -7
  263. package/es/src/charts/features/plotPaint.js +46 -12
  264. package/es/src/charts/features/polyline.js +129 -0
  265. package/es/src/charts/features/referenceAnnotations.js +403 -0
  266. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  267. package/es/src/charts/features/ringLabelNodes.js +93 -0
  268. package/es/src/charts/features/ringLabels.js +222 -0
  269. package/es/src/charts/features/sceneBounds.js +26 -6
  270. package/es/src/charts/features/selfLoops.js +306 -0
  271. package/es/src/charts/features/shapeEmit.js +54 -32
  272. package/es/src/charts/features/sharedFields.js +15 -2
  273. package/es/src/charts/features/textHalo.js +30 -0
  274. package/es/src/charts/index.js +8 -0
  275. package/es/src/charts/partition/chartFields.js +14 -5
  276. package/es/src/charts/partition/interaction.js +19 -10
  277. package/es/src/charts/partition/zoom.js +7 -6
  278. package/es/src/charts/pipeline/insetPlacement.js +22 -9
  279. package/es/src/charts/pipeline/preDrawData.js +46 -3
  280. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  281. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  282. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  283. package/es/src/charts/polar/chrome.js +81 -9
  284. package/es/src/charts/polar/config.js +6 -3
  285. package/es/src/charts/polar/wedgeLayout.js +2 -1
  286. package/es/src/charts/viz/Viz.js +61 -49
  287. package/es/src/charts/viz/VizBase.js +57 -14
  288. package/es/src/charts/viz/backgroundInk.js +23 -7
  289. package/es/src/charts/viz/emphasis.js +14 -0
  290. package/es/src/charts/viz/fillStroke.js +10 -0
  291. package/es/src/charts/viz/focusRing.js +104 -0
  292. package/es/src/charts/viz/focusTargets.js +208 -0
  293. package/es/src/charts/viz/history.js +74 -0
  294. package/es/src/charts/viz/interactionOpacity.js +115 -32
  295. package/es/src/charts/viz/keyboardNav.js +297 -0
  296. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  297. package/es/src/charts/viz/loaderFormat.js +114 -0
  298. package/es/src/charts/viz/missingFields.js +2 -1
  299. package/es/src/charts/viz/mountTarget.js +9 -0
  300. package/es/src/charts/viz/nearestHover.js +183 -0
  301. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  302. package/es/src/charts/viz/ordinalColor.js +14 -12
  303. package/es/src/charts/viz/pageTheme.js +83 -0
  304. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  305. package/es/src/charts/viz/pointVoronoi.js +124 -0
  306. package/es/src/charts/viz/reducedMotion.js +27 -0
  307. package/es/src/charts/viz/reportDrawError.js +15 -0
  308. package/es/src/charts/viz/setCursor.js +29 -0
  309. package/es/src/charts/viz/tooltipEnabled.js +38 -0
  310. package/es/src/charts/viz/userClick.js +34 -0
  311. package/es/src/charts/viz/vizDataPolling.js +8 -4
  312. package/es/src/charts/viz/vizDefaults.js +28 -57
  313. package/es/src/charts/viz/vizFields.js +41 -1
  314. package/es/src/charts/viz/vizRender.js +76 -31
  315. package/es/src/charts/viz/vizTheme.js +96 -0
  316. package/es/src/charts/viz/vizVisibility.js +26 -2
  317. package/es/src/components/Axis/Axis.js +35 -2
  318. package/es/src/components/Axis/AxisBottom.js +1 -0
  319. package/es/src/components/Axis/AxisLeft.js +1 -0
  320. package/es/src/components/Axis/AxisRight.js +1 -0
  321. package/es/src/components/Axis/AxisTop.js +1 -0
  322. package/es/src/components/Axis/axisBreak.js +33 -8
  323. package/es/src/components/Axis/axisDefaults.js +16 -9
  324. package/es/src/components/Axis/axisLabelKinds.js +36 -0
  325. package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
  326. package/es/src/components/Axis/axisLabelRoom.js +37 -0
  327. package/es/src/components/Axis/axisLabelSize.js +171 -0
  328. package/es/src/components/Axis/axisLabelThinning.js +98 -4
  329. package/es/src/components/Axis/axisLayout.js +71 -46
  330. package/es/src/components/Axis/axisLayoutLabels.js +82 -140
  331. package/es/src/components/Axis/axisLayoutScale.js +16 -11
  332. package/es/src/components/Axis/axisLimit.js +27 -0
  333. package/es/src/components/Axis/axisMaxSize.js +39 -0
  334. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  335. package/es/src/components/Axis/axisRender.js +20 -8
  336. package/es/src/components/Axis/axisRounding.js +16 -1
  337. package/es/src/components/Axis/axisScene.js +11 -2
  338. package/es/src/components/Axis/axisTitle.js +53 -0
  339. package/es/src/components/Axis/axisTooltipTargets.js +128 -0
  340. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  341. package/es/src/components/Axis/rangeBreaks.js +201 -0
  342. package/es/src/components/Axis/timeValues.js +19 -4
  343. package/es/src/components/ColorScale/ColorScale.js +77 -27
  344. package/es/src/components/ColorScale/bivariateRender.js +353 -0
  345. package/es/src/components/ColorScale/bivariateScale.js +150 -0
  346. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  347. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  348. package/es/src/components/ColorScale/colorScaleRender.js +32 -2
  349. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  350. package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
  351. package/es/src/components/Legend/Legend.js +13 -2
  352. package/es/src/components/Legend/legendConfig.js +2 -6
  353. package/es/src/components/Legend/legendCut.js +108 -0
  354. package/es/src/components/Legend/legendRender.js +38 -13
  355. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  356. package/es/src/components/TextBox.js +34 -67
  357. package/es/src/components/Timeline/Timeline.js +12 -3
  358. package/es/src/components/Timeline/timelineConfig.js +20 -10
  359. package/es/src/components/Timeline/timelineMode.js +26 -0
  360. package/es/src/components/Timeline/timelineRender.js +9 -4
  361. package/es/src/components/Tooltip.js +15 -5
  362. package/es/src/components/fontStack.js +20 -0
  363. package/es/src/components/textBoxLayout.js +58 -21
  364. package/es/src/components/textBoxPath.js +73 -0
  365. package/es/src/components/textBoxScene.js +226 -0
  366. package/es/src/components/textBoxWords.js +70 -0
  367. package/es/src/components/textEllipsis.js +7 -0
  368. package/es/src/components/tooltipDom.js +8 -5
  369. package/es/src/fluent.js +48 -0
  370. package/es/src/shapes/Area.js +1 -0
  371. package/es/src/shapes/Bar.js +1 -0
  372. package/es/src/shapes/Box.js +1 -0
  373. package/es/src/shapes/Circle.js +1 -0
  374. package/es/src/shapes/Line.js +1 -0
  375. package/es/src/shapes/Path.js +1 -0
  376. package/es/src/shapes/Rect.js +1 -0
  377. package/es/src/shapes/Shape.js +1 -0
  378. package/es/src/shapes/Whisker.js +1 -0
  379. package/es/src/utils/BaseClass.js +30 -12
  380. package/es/src/utils/configPrep.js +2 -1
  381. package/es/src/utils/configValue.js +9 -0
  382. package/es/src/utils/constant.js +13 -1
  383. package/es/src/utils/displayName.js +12 -0
  384. package/es/src/utils/theme.js +190 -0
  385. package/es/src/utils/themeInk.js +68 -0
  386. package/package.json +14 -11
  387. package/types/index.d.ts +6 -2
  388. package/types/internal.d.ts +268 -9
  389. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  390. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  391. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  392. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  393. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  394. package/types/src/charts/Alluvial/index.d.ts +27 -0
  395. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  396. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  397. package/types/src/charts/Alluvial/titles.d.ts +46 -0
  398. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  399. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  400. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  401. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  402. package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
  403. package/types/src/charts/ArcDiagram/events.d.ts +29 -0
  404. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  405. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  406. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  407. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  408. package/types/src/charts/Chord/labels.d.ts +66 -0
  409. package/types/src/charts/Donut/index.d.ts +2 -1
  410. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  411. package/types/src/charts/Gantt/emit.d.ts +17 -0
  412. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  413. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  414. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  415. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  416. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  417. package/types/src/charts/Gantt/index.d.ts +36 -0
  418. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  419. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  420. package/types/src/charts/Geomap/emit.d.ts +2 -2
  421. package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
  422. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  423. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  424. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  425. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  426. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  427. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  428. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  429. package/types/src/charts/Geomap/index.d.ts +3 -0
  430. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  431. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  432. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  433. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  434. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  435. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  436. package/types/src/charts/Hexbin/index.d.ts +25 -0
  437. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  438. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  439. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  440. package/types/src/charts/Histogram/binData.d.ts +20 -1
  441. package/types/src/charts/Histogram/index.d.ts +3 -2
  442. package/types/src/charts/Histogram/labels.d.ts +7 -0
  443. package/types/src/charts/Marimekko/index.d.ts +2 -1
  444. package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
  445. package/types/src/charts/Network/applyLayout.d.ts +11 -0
  446. package/types/src/charts/Network/bundle.d.ts +69 -0
  447. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  448. package/types/src/charts/Network/clusters.d.ts +115 -0
  449. package/types/src/charts/Network/graph.d.ts +73 -0
  450. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  451. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  452. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  453. package/types/src/charts/Pack/applyLayout.d.ts +2 -0
  454. package/types/src/charts/Pack/groupRows.d.ts +46 -0
  455. package/types/src/charts/Pack/index.d.ts +3 -0
  456. package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
  457. package/types/src/charts/Pack/nodeNames.d.ts +23 -0
  458. package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
  459. package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
  460. package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
  461. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  462. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  463. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  464. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  465. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  466. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  467. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  468. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  469. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  470. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  471. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  472. package/types/src/charts/Plot/areaEnter.d.ts +34 -0
  473. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  474. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  475. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  476. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  477. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  478. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  479. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  480. package/types/src/charts/Plot/index.d.ts +16 -15
  481. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  482. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  483. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  484. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  485. package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
  486. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  487. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  488. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  489. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  490. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  491. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  492. package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
  493. package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
  494. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  495. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  496. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  497. package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
  498. package/types/src/charts/Pyramid/gutter.d.ts +28 -6
  499. package/types/src/charts/Pyramid/scene.d.ts +1 -1
  500. package/types/src/charts/Radar/applyLayout.d.ts +2 -3
  501. package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
  502. package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
  503. package/types/src/charts/Radar/emit.d.ts +5 -2
  504. package/types/src/charts/Radar/index.d.ts +7 -2
  505. package/types/src/charts/Radar/points.d.ts +50 -0
  506. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  507. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  508. package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
  509. package/types/src/charts/Rings/emit.d.ts +72 -0
  510. package/types/src/charts/Rings/index.d.ts +4 -2
  511. package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
  512. package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
  513. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  514. package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
  515. package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
  516. package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
  517. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  518. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  519. package/types/src/charts/Sankey/emit.d.ts +58 -0
  520. package/types/src/charts/Sankey/labels.d.ts +19 -0
  521. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  522. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  523. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  524. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  525. package/types/src/charts/Scatter/index.d.ts +15 -0
  526. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  527. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  528. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  529. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  530. package/types/src/charts/Tree/applyLayout.d.ts +20 -0
  531. package/types/src/charts/Tree/keys.d.ts +25 -0
  532. package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
  533. package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
  534. package/types/src/charts/definition/makeChart.d.ts +3 -2
  535. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  536. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  537. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  538. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  539. package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
  540. package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
  541. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
  542. package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
  543. package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
  544. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  545. package/types/src/charts/events/click.legend.d.ts +2 -1
  546. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  547. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  548. package/types/src/charts/features/annotationText.d.ts +57 -0
  549. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  550. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  551. package/types/src/charts/features/axisTooltip.d.ts +49 -0
  552. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  553. package/types/src/charts/features/calloutScene.d.ts +40 -0
  554. package/types/src/charts/features/centerLabel.d.ts +75 -0
  555. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  556. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  557. package/types/src/charts/features/circleLabels.d.ts +130 -0
  558. package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
  559. package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
  560. package/types/src/charts/features/colorScaleHover.d.ts +13 -3
  561. package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
  562. package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
  563. package/types/src/charts/features/colorScaleTop.d.ts +30 -0
  564. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  565. package/types/src/charts/features/curvedArrows.d.ts +119 -0
  566. package/types/src/charts/features/depthKey.d.ts +19 -0
  567. package/types/src/charts/features/edgeArrows.d.ts +103 -4
  568. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  569. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  570. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  571. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  572. package/types/src/charts/features/hoverTicks.d.ts +30 -0
  573. package/types/src/charts/features/idleQueue.d.ts +46 -0
  574. package/types/src/charts/features/legendKeys.d.ts +34 -0
  575. package/types/src/charts/features/lineLabels.d.ts +15 -12
  576. package/types/src/charts/features/linkBundle.d.ts +16 -0
  577. package/types/src/charts/features/linkColor.d.ts +48 -0
  578. package/types/src/charts/features/linkFields.d.ts +16 -0
  579. package/types/src/charts/features/linkFocus.d.ts +51 -0
  580. package/types/src/charts/features/linkInteraction.d.ts +192 -0
  581. package/types/src/charts/features/linkKeys.d.ts +11 -0
  582. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  583. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  584. package/types/src/charts/features/linkLabels.d.ts +77 -0
  585. package/types/src/charts/features/linkWidths.d.ts +19 -0
  586. package/types/src/charts/features/networkMeasures.d.ts +53 -0
  587. package/types/src/charts/features/nodeStats.d.ts +93 -0
  588. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  589. package/types/src/charts/features/pathLabels.d.ts +41 -0
  590. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  591. package/types/src/charts/features/plotEndLabels.d.ts +14 -1
  592. package/types/src/charts/features/plotPaint.d.ts +17 -0
  593. package/types/src/charts/features/polyline.d.ts +32 -0
  594. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  595. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  596. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  597. package/types/src/charts/features/ringLabels.d.ts +164 -0
  598. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  599. package/types/src/charts/features/selfLoops.d.ts +165 -0
  600. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  601. package/types/src/charts/features/sharedFields.d.ts +11 -2
  602. package/types/src/charts/features/textHalo.d.ts +15 -0
  603. package/types/src/charts/index.d.ts +8 -0
  604. package/types/src/charts/partition/chartFields.d.ts +6 -1
  605. package/types/src/charts/partition/interaction.d.ts +6 -3
  606. package/types/src/charts/partition/zoom.d.ts +4 -4
  607. package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
  608. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  609. package/types/src/charts/pipeline/stages.d.ts +7 -0
  610. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  611. package/types/src/charts/polar/chrome.d.ts +19 -6
  612. package/types/src/charts/viz/Viz.d.ts +25 -4
  613. package/types/src/charts/viz/VizBase.d.ts +37 -8
  614. package/types/src/charts/viz/backgroundInk.d.ts +19 -4
  615. package/types/src/charts/viz/emphasis.d.ts +17 -0
  616. package/types/src/charts/viz/fillStroke.d.ts +7 -0
  617. package/types/src/charts/viz/focusRing.d.ts +25 -0
  618. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  619. package/types/src/charts/viz/history.d.ts +35 -0
  620. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  621. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  622. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  623. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  624. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  625. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  626. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  627. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  628. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  629. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  630. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  631. package/types/src/charts/viz/reportDrawError.d.ts +12 -0
  632. package/types/src/charts/viz/setCursor.d.ts +26 -0
  633. package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
  634. package/types/src/charts/viz/userClick.d.ts +35 -0
  635. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  636. package/types/src/charts/viz/vizFields.d.ts +37 -0
  637. package/types/src/charts/viz/vizRender.d.ts +2 -1
  638. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  639. package/types/src/charts/viz/vizTypes.d.ts +100 -7
  640. package/types/src/charts/viz/vizVisibility.d.ts +13 -0
  641. package/types/src/components/Axis/Axis.d.ts +34 -3
  642. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  643. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  644. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  645. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  646. package/types/src/components/Axis/axisBreak.d.ts +21 -3
  647. package/types/src/components/Axis/axisDefaults.d.ts +12 -0
  648. package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
  649. package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
  650. package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
  651. package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
  652. package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
  653. package/types/src/components/Axis/axisLayout.d.ts +9 -2
  654. package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
  655. package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
  656. package/types/src/components/Axis/axisLimit.d.ts +18 -0
  657. package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
  658. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  659. package/types/src/components/Axis/axisRounding.d.ts +8 -0
  660. package/types/src/components/Axis/axisTitle.d.ts +30 -0
  661. package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
  662. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  663. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  664. package/types/src/components/Axis/timeValues.d.ts +1 -1
  665. package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
  666. package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
  667. package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
  668. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  669. package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
  670. package/types/src/components/Legend/Legend.d.ts +6 -0
  671. package/types/src/components/Legend/legendCut.d.ts +31 -0
  672. package/types/src/components/Legend/legendRender.d.ts +6 -1
  673. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  674. package/types/src/components/TextBox.d.ts +5 -0
  675. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  676. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  677. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  678. package/types/src/components/Tooltip.d.ts +4 -3
  679. package/types/src/components/fontStack.d.ts +10 -0
  680. package/types/src/components/textBoxLayout.d.ts +18 -9
  681. package/types/src/components/textBoxPath.d.ts +59 -0
  682. package/types/src/components/textBoxScene.d.ts +51 -0
  683. package/types/src/components/textBoxWords.d.ts +33 -0
  684. package/types/src/components/textEllipsis.d.ts +6 -0
  685. package/types/src/fluent.d.ts +18 -0
  686. package/types/src/shapes/Area.d.ts +1 -0
  687. package/types/src/shapes/Bar.d.ts +1 -0
  688. package/types/src/shapes/Box.d.ts +1 -0
  689. package/types/src/shapes/Circle.d.ts +1 -0
  690. package/types/src/shapes/Line.d.ts +1 -0
  691. package/types/src/shapes/Path.d.ts +1 -0
  692. package/types/src/shapes/Rect.d.ts +1 -0
  693. package/types/src/shapes/Shape.d.ts +1 -0
  694. package/types/src/shapes/Whisker.d.ts +1 -0
  695. package/types/src/shapes/emitLabels.d.ts +1 -1
  696. package/types/src/utils/BaseClass.d.ts +9 -0
  697. package/types/src/utils/D3plusConfig.d.ts +1093 -266
  698. package/types/src/utils/configPrep.d.ts +2 -0
  699. package/types/src/utils/configValue.d.ts +8 -0
  700. package/types/src/utils/constant.d.ts +8 -0
  701. package/types/src/utils/displayName.d.ts +10 -0
  702. package/types/src/utils/index.d.ts +1 -1
  703. package/types/src/utils/theme.d.ts +170 -0
  704. package/types/src/utils/themeInk.d.ts +56 -0
  705. package/types/umd-entry.d.ts +4 -0
  706. package/umd/d3plus-core.full.js +72239 -41465
  707. package/umd/d3plus-core.full.min.js +2 -2
  708. package/umd/d3plus-core.js +46249 -19519
  709. package/umd/d3plus-core.min.js +2 -2
  710. package/es/src/components/Axis/gridStroke.js +0 -10
  711. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -0,0 +1,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[];
@@ -0,0 +1,99 @@
1
+ type Point = [number, number];
2
+ /** A stretch of a path, as `[start, end]` lengths along it. */
3
+ export type Interval = [number, number];
4
+ /** The style object `connectGaps` takes for a bridge. */
5
+ export interface ConnectGapsConfig {
6
+ stroke?: string;
7
+ strokeDasharray?: string | number | number[] | false;
8
+ strokeWidth?: number;
9
+ opacity?: number;
10
+ }
11
+ /** Everything `connectGaps` takes. */
12
+ export type ConnectGaps = boolean | "solid" | "dashed" | ConnectGapsConfig;
13
+ /** How a bridge across a gap is drawn. Unset keys take the line's own style. */
14
+ export interface GapBridge {
15
+ stroke?: string;
16
+ strokeDasharray?: number[];
17
+ strokeWidth?: number;
18
+ opacity: number;
19
+ }
20
+ /** The dash pattern `"dashed"` bridges a gap with: short and sparse, unlike a forecast's `"6 4"`. */
21
+ export declare const GAP_DASH: number[];
22
+ /**
23
+ What a `connectGaps` setting asks for: null when lines run through their
24
+ gaps as one continuous line (`true`, `"solid"`, unset), otherwise lines
25
+ break at each gap and `bridge` is the style of the line drawn across it,
26
+ or null to leave the gap empty (`false`).
27
+ @param value The setting.
28
+ */
29
+ export declare function resolveConnectGaps(value: unknown): {
30
+ bridge: GapBridge | null;
31
+ } | null;
32
+ /**
33
+ The indices `k` of a line's points that a gap follows: some missing value
34
+ lies strictly between point `k` and point `k + 1` along the discrete axis.
35
+ A missing value before the first point or after the last makes no gap.
36
+ @param ranks Each drawn point's position along the discrete axis, in drawn order.
37
+ @param missing The positions with no value: every step any line has, and
38
+ the line's own rows with no plottable value.
39
+ */
40
+ export declare function gapsAfter(ranks: number[], missing: number[]): number[];
41
+ /**
42
+ How far along a polyline it first reaches each of `targets` along one
43
+ axis, searching on from where it reached the one before, and its total
44
+ length. A target it never reaches lies at its full length.
45
+ @param line The polyline (see `curvePolyline`).
46
+ @param axis `0` to measure along x, `1` along y.
47
+ @param targets The positions to reach, in order along the line.
48
+ */
49
+ export declare function pointLengths(line: Point[], axis: 0 | 1, targets: number[]): {
50
+ at: number[];
51
+ total: number;
52
+ };
53
+ /**
54
+ The stretches a dash pattern draws between `from` and `to`, starting the
55
+ pattern at `from`. No pattern (or one that draws nothing) draws the
56
+ whole stretch.
57
+ @param dash The pattern, as `[dash, gap, …]`.
58
+ @param from Where the stretch starts.
59
+ @param to Where it ends.
60
+ */
61
+ export declare function patternIntervals(dash: number[] | undefined, from: number, to: number): Interval[];
62
+ /**
63
+ Where two lists of stretches overlap.
64
+ @param a Sorted, non-overlapping stretches.
65
+ @param b Sorted, non-overlapping stretches.
66
+ */
67
+ export declare function intersectIntervals(a: Interval[], b: Interval[]): Interval[];
68
+ /**
69
+ The stretches of `[0, total]` a list of stretches leaves out.
70
+ @param intervals Sorted, non-overlapping stretches.
71
+ @param total The path's length.
72
+ */
73
+ export declare function complementIntervals(intervals: Interval[], total: number): Interval[];
74
+ /**
75
+ The dash array that draws a path along exactly the given stretches and
76
+ nothing else, ending in a gap long enough that the pattern never repeats.
77
+ @param intervals Sorted, non-overlapping stretches to draw.
78
+ @param total The path's length.
79
+ */
80
+ export declare function intervalsDash(intervals: Interval[], total: number): number[];
81
+ /**
82
+ A line's path with a separate subpath for each run of points between its
83
+ gaps, so nothing spans a gap. A point between two gaps gets a short tick
84
+ along the discrete axis.
85
+ @param points The line's points, in drawn order.
86
+ @param gaps The indices a gap follows (see `gapsAfter`).
87
+ @param curve The line's curve name.
88
+ @param axis `0` when the discrete axis is x, `1` when it is y.
89
+ @param stub Half the length of a lone point's tick.
90
+ */
91
+ export declare function runPath(points: Point[], gaps: number[], curve: string, axis: 0 | 1, stub?: number): string;
92
+ /**
93
+ Each run of points between a line's gaps, as its `[first, last]` point
94
+ indices.
95
+ @param count The line's point count.
96
+ @param gaps The indices a gap follows (see `gapsAfter`).
97
+ */
98
+ export declare function runIndices(count: number, gaps: number[]): Interval[];
99
+ export {};
@@ -0,0 +1,55 @@
1
+ /**
2
+ The scene side of a Plot's `connectGaps`: each line's gaps, read from its
3
+ rows, and the edits that break the line there. A line keeps its one path
4
+ through every point, so it follows its curve across a gap; its dash array
5
+ leaves the gaps out, its hit area stops at them, and a bridge (the same
6
+ path, drawn only across the gaps) is decoration that takes no pointer or
7
+ keyboard focus. Confidence bands are clipped to the runs between gaps.
8
+ */
9
+ import type { SceneNode } from "@d3plus/render";
10
+ import type { ShapeEmitContext } from "../features/shapeEmit.js";
11
+ import { type GapBridge, type Interval } from "./connectGaps.js";
12
+ type Point = [number, number];
13
+ /** One line's gaps, measured along its path. */
14
+ export interface SeriesGaps {
15
+ /** The line's points, in plot space and drawn order. */
16
+ points: Point[];
17
+ /** The indices a gap follows. */
18
+ gaps: number[];
19
+ /** The stretches of the path that cross a gap. */
20
+ gapIntervals: Interval[];
21
+ /** The path's length. */
22
+ total: number;
23
+ }
24
+ /** Every gapped line of a Line group, by series id, and how to draw the gaps. */
25
+ export interface LineGaps {
26
+ series: Map<string, SeriesGaps>;
27
+ bridge: GapBridge | null;
28
+ curve: string;
29
+ /** `0` when the discrete axis is x, `1` when it is y. */
30
+ axis: 0 | 1;
31
+ }
32
+ /**
33
+ The gaps in each line of a Line group, or null when `connectGaps` draws
34
+ lines straight through them or no line has one. A gap is a step of the
35
+ discrete axis that some line in the group has and this one skips, or one
36
+ of this line's own rows whose value can't be plotted (`null`, `NaN`).
37
+ @param ctx The Line group's emit context.
38
+ */
39
+ export declare function lineGaps(ctx: ShapeEmitContext): LineGaps | null;
40
+ /**
41
+ Breaks each gapped line among a Line group's nodes: the line's dash array
42
+ leaves its gaps empty, its hit area stops at them, and a bridge follows
43
+ it when `connectGaps` asks for one.
44
+ @param nodes The Line shape's computed nodes.
45
+ @param gaps The group's gaps (see `lineGaps`).
46
+ */
47
+ export declare function breakLines(nodes: SceneNode[], gaps: LineGaps): SceneNode[];
48
+ /**
49
+ Clips each gapped line's confidence bands to the runs between its gaps,
50
+ so no band spans a stretch with no value.
51
+ @param nodes The band Areas' computed nodes.
52
+ @param gaps The group's gaps (see `lineGaps`).
53
+ */
54
+ export declare function clipBands(nodes: SceneNode[], gaps: LineGaps): SceneNode[];
55
+ export {};
@@ -1,3 +1,8 @@
1
+ /**
2
+ The scene for a Plot's `forecast`: a shaded backdrop over the forecast
3
+ stretch with a rule at its start and a label, and the dash array that
4
+ draws each line's forecast stretch dashed.
5
+ */
1
6
  import type { DataPoint } from "@d3plus/data";
2
7
  import type { RectNode, SceneNode } from "@d3plus/render";
3
8
  import type { PlotAxisFn, PlotDatum } from "../features/plotPaint.js";
@@ -4,7 +4,7 @@ import { type ZoomState } from "./plotZoom.js";
4
4
  import { type ConfidenceBand } from "./confidenceBands.js";
5
5
  import { type TrendLineType } from "./trendLines.js";
6
6
  import Viz from "../viz/Viz.js";
7
- import type { InteractionPoint, PickResult, Scene, SceneEvent } from "@d3plus/render";
7
+ import type { InteractionPoint, PickResult, Scene, SceneEvent, SceneNode } from "@d3plus/render";
8
8
  import type { DataPoint } from "@d3plus/data";
9
9
  import type { VizInstance } from "../viz/vizTypes.js";
10
10
  /** Accessor function or string key for a plotted value. */
@@ -15,6 +15,7 @@ type PlotAccessorArg = string | PlotAccessor;
15
15
  Creates an x/y plot based on an array of data.
16
16
  */
17
17
  export default class Plot extends Viz {
18
+ static readonly _displayName: string;
18
19
  _trendLine: TrendLineType;
19
20
  _trendLineConfig: Record<string, unknown>;
20
21
  /**
@@ -77,6 +78,12 @@ export default class Plot extends Viz {
77
78
  i: number;
78
79
  x: unknown;
79
80
  };
81
+ /**
82
+ A Plot's point marks are its Circle and Rect shapes (scatter and
83
+ bubble points, Beeswarm circles), for `hoverDistance`.
84
+ @private
85
+ */
86
+ _pointMark(node: SceneNode): boolean;
80
87
  /**
81
88
  Picks the interaction point closest to a surface-local cursor position
82
89
  along the discrete axis. `event.point` is post-zoom surface space while the
@@ -132,9 +139,7 @@ export default class Plot extends Viz {
132
139
  */
133
140
  _zoomRescale(t: ZoomState, duration?: number): boolean;
134
141
  /**
135
- Allows drawing custom shapes to be used as annotations in the provided x/y plot. This method accepts custom config objects for the [Shape](http://d3plus.org/docs/#Shape) class, either a single config object or an array of config objects. Each config object requires an additional parameter, the "shape", which denotes which [Shape](http://d3plus.org/docs/#Shape) sub-class to use ([Rect](http://d3plus.org/docs/#Rect), [Line](http://d3plus.org/docs/#Line), etc).
136
-
137
- Additionally, each config object can also contain an optional "layer" key, which defines whether the annotations will be displayed in "front" or in "back" of the primary visualization shapes. This value defaults to "back" if not present.
142
+ Custom shapes drawn as annotations on the plot: a [Shape](http://d3plus.org/docs/#Shape) config object, or an array of them, each with a `shape` key naming the Shape class to use (`"Rect"`, `"Line"`, …) and an optional `layer`, `"back"` (the default) or `"front"`. Three more kinds draw chart notes: `"Callout"` (wrapped text joined to a data point by a connector; see `CalloutAnnotation`), and `"ReferenceLine"` and `"ReferenceBand"` (what `referenceLines` and `referenceBands` expand into).
138
143
  */
139
144
  annotations(_?: unknown): this | unknown[];
140
145
  /**
@@ -142,7 +147,7 @@ export default class Plot extends Viz {
142
147
  */
143
148
  axisPersist(_?: boolean): this | boolean;
144
149
  /**
145
- Starts the value axis (the x axis for horizontal charts) at a value: `baseline(n)` renders exactly like `yDomain([n])` (or `xDomain([n])`). Bars, areas, and stems still grow from the chart's own `0` in the Plots that draw from one (such as BarChart, AreaPlot, Histogram, and Lollipop), so with `baselineBreak` on (their default) the axis breaks back to a `0` tick and bars run through the break, with its gap cut across them, and with it off the axis stretches down to `0`. As with `yDomain([n])`, only `n` is pinned: the far end comes from the data and is rounded where the axis would round it with no domain set (left at the data when the axis config's `rounding` is "none"), and marks for values past `n` stop at the axis's edge. When every value sits at or below `n`, it ends the axis instead, like `yDomain([undefined, n])`. A bound given in `yDomain`/`xDomain` wins. Returns the chart's own baseline when none is set.
150
+ Starts the value axis at a value, like `yDomain([n])` (or `xDomain([n])` for horizontal charts); the far end comes from the data. Bars, areas, and stems still grow from `0`, so with `baselineBreak` on the axis breaks back to a `0` tick. A bound in `yDomain`/`xDomain` wins. Returns the chart's own baseline when none is set.
146
151
  */
147
152
  baseline(_?: number): this | number | undefined;
148
153
  /**
@@ -154,9 +159,7 @@ export default class Plot extends Viz {
154
159
  */
155
160
  buffer(_?: boolean | Record<string, boolean>): this | Record<string, unknown>;
156
161
  /**
157
- The confidence interval as an array of [lower, upper] bounds. Lines draw it as a shaded band; bars draw an error bar per bar, from the lower to the upper bound with a cap at each end (a stacked bar's bounds keep their distance from its value, measured from the bar's stacked end). Either bound may be `false` for a one-sided interval, and a row without a bound pinches the band onto its line. The value axis widens to fit the bounds, and tooltips list them (see `confidenceConfig.tooltip`). Pass `false` to turn the interval off.
158
-
159
- Pass an array of bands, outermost first, to draw nested bands around each line (a fan): each band is a `[lower, upper]` pair or `[lower, upper, label]`, or a `{lower, upper, label}` object, and `confidenceConfig.bandOpacity` shades them from the widest (lightest) to the narrowest (darkest). Tooltips list each band's range under its label ("Band 1", "Band 2", … when unlabeled), and bars draw the first band's error bar.
162
+ The confidence interval as `[lower, upper]` bounds (keys or accessors): lines draw a shaded band, bars an error bar. Either bound may be `false` for a one-sided interval, and the value axis widens to fit. Pass an array of bands, outermost first (`[lower, upper, label]` or `{lower, upper, label}`), to draw nested bands (a fan). `false` turns it off.
160
163
 
161
164
  @example <caption>Can be called with accessor functions or static keys:</caption>
162
165
  var data = {id: "alpha", value: 10, lci: 9, hci: 11};
@@ -172,7 +175,7 @@ export default class Plot extends Viz {
172
175
  */
173
176
  confidence(_?: unknown): this | VizInstance["_confidence"] | ConfidenceBand[];
174
177
  /**
175
- Configuration object for shapes rendered as confidence intervals. A line's band is an Area, filled with the line's color at half opacity. A bar's error bar is a Path styled by `stroke` (default a shade darker than the bar), `strokeWidth` (default `2`), `strokeDasharray`, `strokeOpacity`, and `capWidth`: the length of each end cap, in pixels or as a percentage string of the bar's thickness (default `"50%"`). Keys nested under `Area` or `Bar` apply only to that shape's interval. With several bands, `bandOpacity` sets how each band looks where it is the innermost band drawn: an array ramps from the outermost band to the innermost (default `[0.15, 0.6]`), a number gives every band that opacity, and either replaces `fillOpacity`. `tooltip` (default `true`) lists the bounds in tooltips: a "Lower Bound" and "Upper Bound" row for a single mark, and a range after each series' value in a shared tooltip; set it to `false` to leave them out. Accepted keys: any key the Area or Path shape takes at the top level, plus `bandOpacity`, `capWidth`, `tooltip`, `Area` (Area keys), and `Bar` (Path keys and `capWidth`); any other key logs a warning.
178
+ Styles the confidence intervals: a line's band takes Area keys (filled with the line's color), and a bar's error bar takes Path keys (`stroke`, `strokeWidth`, …) plus `capWidth`, in pixels or a percentage of the bar (default `"50%"`). Keys under `Area` or `Bar` apply to that shape only. `bandOpacity` ramps nested bands' opacity (default `[0.15, 0.6]`), and `tooltip: false` leaves the bounds out of tooltips.
176
179
 
177
180
  @example
178
181
  .confidenceConfig({Bar: {stroke: "#333", capWidth: 8}, tooltip: false})
@@ -190,10 +193,6 @@ export default class Plot extends Viz {
190
193
  The d3plus-shape config used on the Line shapes created to connect lineLabels to the end of their associated Line path.
191
194
  */
192
195
  labelConnectorConfig(_?: Record<string, unknown>): this | Record<string, unknown>;
193
- /**
194
- The behavior to be used when calculating the position and size of each shape's label(s). The value passed can either be the _String_ name of the behavior to be used for all shapes, or an accessor _Function_ that will be provided each data point and will be expected to return the behavior to be used for that data point. The availability and options for this method depend on the default logic for each Shape. As an example, the values "outside" or "inside" can be set for Bar shapes, whose "auto" default will calculate the best position dynamically based on the available space.
195
- */
196
- labelPosition(_?: string | ((d: DataPoint, i: number) => string)): this | ((d: DataPoint, i: number) => string);
197
196
  /**
198
197
  Paint for the shared tooltip's crosshair guide line (`stroke`,
199
198
  `strokeWidth`, `strokeDasharray`, `strokeOpacity`, …). Merged into the
@@ -250,8 +249,10 @@ export default class Plot extends Viz {
250
249
  - a value accessor, or a `{value, order}` config, to rank series by an
251
250
  aggregate of any data field.
252
251
 
253
- Unknown named strings warn and fall back to `"descending"`. If *value*
254
- is not specified, returns the current stack order.
252
+ Unknown named strings warn and fall back to `"descending"`. The
253
+ default legend lists the series in the order they stack, from the
254
+ baseline outward. If *value* is not specified, returns the current
255
+ stack order.
255
256
  */
256
257
  stackOrder(_?: StackOrderInput): this | StackOrderFn | string[];
257
258
  /**
@@ -0,0 +1,48 @@
1
+ /**
2
+ The Line shape's label config for a Plot's `lineLabels`: the text and
3
+ bounds of each line's labels past its right end, its left end, or both,
4
+ after their collisions have been bumped apart (see
5
+ `features/lineLabels.ts`).
6
+
7
+ @module
8
+ */
9
+ import type { LabelWidth, PlotDatum } from "../features/plotPaint.js";
10
+ import type { VizInstance as Viz } from "../viz/vizTypes.js";
11
+ import { type LineLabelSide } from "./lineLabelSides.js";
12
+ /** What a Line label config reads from the Plot paint. */
13
+ export interface LineLabelEmitInputs {
14
+ viz: Viz;
15
+ labelWidths: LabelWidth[];
16
+ /** The widest right-end label (padding included). */
17
+ largestLabel: number;
18
+ labelPositions: Record<string, number>;
19
+ /** The series name a label shows, in place of the chart's own label. */
20
+ name?: unknown;
21
+ }
22
+ /** A label's bounds relative to its line's first point. */
23
+ interface LabelBox {
24
+ x: number;
25
+ y: number;
26
+ width: number;
27
+ height: number;
28
+ }
29
+ /**
30
+ The bounds of a line's label past its `side` end: right of its rightmost
31
+ point (`largest` wide, text starting there) or left of its leftmost point
32
+ (text ending there), as tall as a quarter of the chart and centered on
33
+ the label's bumped y.
34
+ */
35
+ export declare function lineLabelBox(points: number[][], side: LineLabelSide, largest: number, chartHeight: number, bumpedY?: number): LabelBox;
36
+ /**
37
+ The Line shape's `label` and `labelBounds` for its line labels, and the
38
+ `textAnchor` that right-aligns the labels left of a line. A line with
39
+ one label keeps a single label; one labeled at both ends takes two.
40
+ */
41
+ export declare function lineLabelConfig(inputs: LineLabelEmitInputs): {
42
+ label: (d: PlotDatum, i: number) => string | string[] | false;
43
+ labelBounds: (d: PlotDatum, i: number, s: {
44
+ points: number[][];
45
+ }) => LabelBox | LabelBox[];
46
+ textAnchor: (base: unknown) => (d: Record<string, unknown>, i: number) => unknown;
47
+ };
48
+ export {};
@@ -0,0 +1,50 @@
1
+ /**
2
+ Pure helpers behind a Plot's `lineLabels` and `lineLabelConfig`: which
3
+ ends of a line take a label, and the value text a label can carry.
4
+
5
+ @module
6
+ */
7
+ import type { DataPoint } from "@d3plus/data";
8
+ /** An end of a line that can carry a label. */
9
+ export type LineLabelSide = "start" | "end";
10
+ /** What `lineLabels` takes for one series. */
11
+ export type LineLabelsValue = boolean | "start" | "end" | "both" | "along";
12
+ /** The `lineLabels` setting: one value for every series, or a function of each row. */
13
+ export type LineLabelsSetting = LineLabelsValue | ((d: DataPoint, i: number) => LineLabelsValue | null | undefined);
14
+ /** Formats a line label's value: the value, the row it belongs to, and the row's index. */
15
+ export type LineLabelValueFormat = (value: unknown, d: DataPoint, i: number) => string;
16
+ /** The `lineLabelConfig` setting. */
17
+ export interface LineLabelConfig {
18
+ /** Adds each end's value after the series name. */
19
+ value?: boolean;
20
+ /** Formats the value (defaults to the y axis's tick format). */
21
+ valueFormat?: LineLabelValueFormat;
22
+ }
23
+ /**
24
+ The ends a `lineLabels` value labels, left end first: `true` and `"end"`
25
+ label the right end, `"start"` the left end, `"both"` both, and
26
+ `"along"` (a label along the line) or anything falsy neither.
27
+ */
28
+ export declare function lineLabelSides(value: LineLabelsValue | null | undefined): LineLabelSide[];
29
+ /**
30
+ The ends `setting` labels for row `d` (index `i`): a function setting is
31
+ called with the row, any other setting applies to every row.
32
+ */
33
+ export declare function rowLineLabelSides(setting: LineLabelsSetting | null | undefined, d: DataPoint, i: number): LineLabelSide[];
34
+ /**
35
+ Whether `setting` runs row `d`'s series name along its line (`"along"`)
36
+ instead of at an end.
37
+ */
38
+ export declare function rowLabelsAlong(setting: LineLabelsSetting | null | undefined, d: DataPoint, i: number): boolean;
39
+ /**
40
+ A line label's value text, or `undefined` when `config` leaves values
41
+ off: `valueFormat` when set, else `format` (the y axis's own).
42
+ */
43
+ export declare function lineLabelValue(config: LineLabelConfig | undefined, value: unknown, d: DataPoint, i: number, format: (value: unknown) => string): string | undefined;
44
+ /** A line label's text: the series name, followed by its value when there is one. */
45
+ export declare function lineLabelText(name: unknown, value?: string): string;
46
+ /**
47
+ The key a label's bumped position is stored under: the series id for the
48
+ right end, prefixed for the left end so the two ends never share one.
49
+ */
50
+ export declare function lineLabelKey(side: LineLabelSide | undefined, id: unknown): string;
@@ -0,0 +1,15 @@
1
+ /**
2
+ Spreads a column of labels apart so none overlap, each as close to the
3
+ position it labels as the others allow.
4
+
5
+ @module
6
+ */
7
+ /**
8
+ Positions for labels centered on `desired` (sorted top to bottom), each
9
+ `sizes[i]` tall, so that no two overlap and every label stays within
10
+ `bounds` (the range its center may take). Touching labels move as a
11
+ group, centered on where they want to be, so each moves as little as the
12
+ others allow. Labels that need more room than `bounds` holds are packed
13
+ from its top and run past its bottom.
14
+ */
15
+ export declare function spreadLabelPositions(desired: number[], sizes: number[], bounds: number[]): number[];