@d3plus/core 4.9.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 (687) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +170 -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 +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 +95 -4
  21. package/es/src/charts/BoxWhisker/outliers.js +68 -0
  22. package/es/src/charts/BoxWhisker/summary.js +83 -0
  23. package/es/src/charts/BoxWhisker/tooltip.js +122 -0
  24. package/es/src/charts/BubbleChart/emit.js +31 -0
  25. package/es/src/charts/BubbleChart/index.js +54 -0
  26. package/es/src/charts/Bullet/index.js +2 -1
  27. package/es/src/charts/BumpChart/index.js +5 -0
  28. package/es/src/charts/Calendar/emit.js +1 -1
  29. package/es/src/charts/Calendar/index.js +5 -3
  30. package/es/src/charts/Candlestick/aggregate.js +11 -1
  31. package/es/src/charts/Candlestick/buffer.js +6 -4
  32. package/es/src/charts/Candlestick/index.js +7 -6
  33. package/es/src/charts/Chord/applyLayout.js +56 -69
  34. package/es/src/charts/Chord/emit.js +55 -24
  35. package/es/src/charts/Chord/index.js +17 -12
  36. package/es/src/charts/Chord/labels.js +105 -0
  37. package/es/src/charts/Donut/index.js +5 -11
  38. package/es/src/charts/Dumbbell/index.js +2 -4
  39. package/es/src/charts/Funnel/index.js +2 -1
  40. package/es/src/charts/Gantt/applyLayout.js +162 -0
  41. package/es/src/charts/Gantt/emit.js +142 -0
  42. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  43. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  44. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  45. package/es/src/charts/Gantt/ganttRows.js +111 -0
  46. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  47. package/es/src/charts/Gantt/index.js +219 -0
  48. package/es/src/charts/Gauge/index.js +2 -1
  49. package/es/src/charts/Geomap/applyLayout.js +90 -49
  50. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  51. package/es/src/charts/Geomap/emit.js +19 -2
  52. package/es/src/charts/Geomap/flowEmit.js +132 -0
  53. package/es/src/charts/Geomap/flowEvents.js +86 -0
  54. package/es/src/charts/Geomap/flowFields.js +91 -0
  55. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  56. package/es/src/charts/Geomap/flowLinks.js +239 -0
  57. package/es/src/charts/Geomap/geoCache.js +180 -0
  58. package/es/src/charts/Geomap/globeKeys.js +131 -0
  59. package/es/src/charts/Geomap/globeRotate.js +208 -0
  60. package/es/src/charts/Geomap/index.js +60 -19
  61. package/es/src/charts/Geomap/pointLabels.js +107 -0
  62. package/es/src/charts/Hexbin/binning.js +103 -0
  63. package/es/src/charts/Hexbin/buffer.js +33 -0
  64. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  65. package/es/src/charts/Hexbin/contours.js +48 -0
  66. package/es/src/charts/Hexbin/emit.js +142 -0
  67. package/es/src/charts/Hexbin/index.js +204 -0
  68. package/es/src/charts/Hexbin/layers.js +212 -0
  69. package/es/src/charts/Hexbin/settings.js +86 -0
  70. package/es/src/charts/Hexbin/tooltip.js +77 -0
  71. package/es/src/charts/Histogram/binData.js +31 -4
  72. package/es/src/charts/Histogram/index.js +37 -16
  73. package/es/src/charts/Histogram/labels.js +18 -0
  74. package/es/src/charts/Icicle/index.js +3 -3
  75. package/es/src/charts/LinePlot/index.js +7 -0
  76. package/es/src/charts/Marimekko/index.js +7 -4
  77. package/es/src/charts/Matrix/index.js +3 -2
  78. package/es/src/charts/Network/applyLayout.js +138 -94
  79. package/es/src/charts/Network/bundle.js +81 -0
  80. package/es/src/charts/Network/clusterLabels.js +423 -0
  81. package/es/src/charts/Network/clusters.js +290 -0
  82. package/es/src/charts/Network/emit.js +253 -70
  83. package/es/src/charts/Network/graph.js +117 -0
  84. package/es/src/charts/Network/graphFluent.js +79 -0
  85. package/es/src/charts/Network/index.js +93 -108
  86. package/es/src/charts/Network/minNodeDistance.js +64 -0
  87. package/es/src/charts/Network/polygonRows.js +44 -0
  88. package/es/src/charts/Pack/index.js +7 -2
  89. package/es/src/charts/Pie/applyLayout.js +86 -27
  90. package/es/src/charts/Pie/arcFit.js +152 -0
  91. package/es/src/charts/Pie/curvedLabels.js +134 -0
  92. package/es/src/charts/Pie/emit.js +43 -96
  93. package/es/src/charts/Pie/index.js +66 -32
  94. package/es/src/charts/Pie/labelRoom.js +154 -0
  95. package/es/src/charts/Pie/outsideLabels.js +224 -0
  96. package/es/src/charts/Pie/outsideNodes.js +267 -0
  97. package/es/src/charts/Pie/pieLabels.js +137 -0
  98. package/es/src/charts/Pie/sectorBox.js +223 -0
  99. package/es/src/charts/Pie/straightLabels.js +96 -0
  100. package/es/src/charts/Pie/straightLayout.js +215 -0
  101. package/es/src/charts/Plot/alongLegend.js +76 -0
  102. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  103. package/es/src/charts/Plot/axisHover.js +180 -0
  104. package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
  105. package/es/src/charts/Plot/axisHoverScene.js +203 -0
  106. package/es/src/charts/Plot/axisValues.js +43 -0
  107. package/es/src/charts/Plot/barHitArea.js +81 -0
  108. package/es/src/charts/Plot/barLabelFit.js +123 -0
  109. package/es/src/charts/Plot/barWidth.js +61 -13
  110. package/es/src/charts/Plot/circleLabels.js +98 -0
  111. package/es/src/charts/Plot/confidenceConfig.js +2 -2
  112. package/es/src/charts/Plot/connectGaps.js +237 -0
  113. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  114. package/es/src/charts/Plot/draw.js +14 -4
  115. package/es/src/charts/Plot/fillBetween.js +2 -1
  116. package/es/src/charts/Plot/forecastScene.js +3 -4
  117. package/es/src/charts/Plot/index.js +42 -15
  118. package/es/src/charts/Plot/labelPlacement.js +10 -2
  119. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  120. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  121. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  122. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  123. package/es/src/charts/Plot/openDomainEnds.js +2 -5
  124. package/es/src/charts/Plot/pipeline.js +71 -22
  125. package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
  126. package/es/src/charts/Plot/pipelineDomains.js +23 -6
  127. package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
  128. package/es/src/charts/Plot/pipelineScales.js +40 -8
  129. package/es/src/charts/Plot/plotFacet.js +12 -1
  130. package/es/src/charts/Plot/plotInit.js +49 -5
  131. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  132. package/es/src/charts/Plot/plotZoom.js +15 -6
  133. package/es/src/charts/Plot/referenceDomains.js +133 -0
  134. package/es/src/charts/Plot/shapeDefaults.js +14 -9
  135. package/es/src/charts/Plot/sharedHoverScene.js +50 -31
  136. package/es/src/charts/Plot/sharedTooltip.js +19 -7
  137. package/es/src/charts/Plot/stackHelpers.js +13 -1
  138. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  139. package/es/src/charts/Plot/stackShareTooltip.js +9 -4
  140. package/es/src/charts/Plot/stackThreshold.js +154 -0
  141. package/es/src/charts/Plot/trendLabels.js +183 -0
  142. package/es/src/charts/Plot/trendLines.js +1 -0
  143. package/es/src/charts/Plot/trendScene.js +6 -3
  144. package/es/src/charts/Plot/trendTooltip.js +5 -1
  145. package/es/src/charts/PolarArea/index.js +5 -4
  146. package/es/src/charts/Priestley/applyLayout.js +14 -20
  147. package/es/src/charts/Priestley/index.js +4 -34
  148. package/es/src/charts/Priestley/timeAxis.js +100 -0
  149. package/es/src/charts/Pyramid/index.js +4 -2
  150. package/es/src/charts/Radar/axisDecorations.js +49 -12
  151. package/es/src/charts/Radar/curvedLabels.js +187 -0
  152. package/es/src/charts/Radar/index.js +5 -5
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +4 -1
  155. package/es/src/charts/RadialBar/index.js +18 -10
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/index.js +6 -9
  158. package/es/src/charts/Rings/applyLayout.js +41 -24
  159. package/es/src/charts/Rings/emit.js +174 -58
  160. package/es/src/charts/Rings/index.js +65 -30
  161. package/es/src/charts/Rings/ringsGraph.js +28 -9
  162. package/es/src/charts/Rings/ringsLoops.js +73 -0
  163. package/es/src/charts/Rings/ringsParallel.js +166 -0
  164. package/es/src/charts/Sankey/applyLayout.js +116 -39
  165. package/es/src/charts/Sankey/circularLayout.js +208 -0
  166. package/es/src/charts/Sankey/circularLinks.js +301 -0
  167. package/es/src/charts/Sankey/emit.js +164 -94
  168. package/es/src/charts/Sankey/index.js +75 -77
  169. package/es/src/charts/Sankey/labels.js +80 -0
  170. package/es/src/charts/Sankey/ribbons.js +88 -0
  171. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  172. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  173. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  174. package/es/src/charts/Scatter/index.js +25 -0
  175. package/es/src/charts/SlopeChart/index.js +116 -0
  176. package/es/src/charts/SlopeChart/slope.js +95 -0
  177. package/es/src/charts/Streamgraph/index.js +51 -0
  178. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  179. package/es/src/charts/Sunburst/emit.js +74 -63
  180. package/es/src/charts/Sunburst/index.js +3 -3
  181. package/es/src/charts/Tree/index.js +2 -6
  182. package/es/src/charts/Treemap/applyLayout.js +14 -1
  183. package/es/src/charts/Treemap/emit.js +8 -2
  184. package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
  185. package/es/src/charts/Treemap/groupHeaders.js +95 -0
  186. package/es/src/charts/Treemap/index.js +17 -7
  187. package/es/src/charts/Treemap/thresholdFunction.js +11 -9
  188. package/es/src/charts/Violin/inner.js +3 -5
  189. package/es/src/charts/Waffle/index.js +4 -2
  190. package/es/src/charts/Waffle/tooltip.js +6 -2
  191. package/es/src/charts/Waterfall/index.js +4 -2
  192. package/es/src/charts/definition/makeChart.js +20 -5
  193. package/es/src/charts/drawSteps/backControl.js +17 -5
  194. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  195. package/es/src/charts/drawSteps/minimap.js +6 -5
  196. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  197. package/es/src/charts/drawSteps/saveChart.js +176 -0
  198. package/es/src/charts/drawSteps/saveControl.js +148 -0
  199. package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
  200. package/es/src/charts/drawSteps/searchControls.js +2 -1
  201. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  202. package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
  203. package/es/src/charts/drawSteps/topLeftControls.js +3 -1
  204. package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
  205. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  206. package/es/src/charts/events/click.legend.js +7 -2
  207. package/es/src/charts/events/click.shape.js +38 -2
  208. package/es/src/charts/events/mouseenter.js +9 -0
  209. package/es/src/charts/events/mousemove.legend.js +3 -0
  210. package/es/src/charts/events/mousemove.shape.js +12 -4
  211. package/es/src/charts/facet/drawFacets.js +14 -5
  212. package/es/src/charts/facet/facetConfig.js +2 -2
  213. package/es/src/charts/facet/facetData.js +2 -2
  214. package/es/src/charts/features/annotationFrame.js +179 -0
  215. package/es/src/charts/features/annotationText.js +83 -0
  216. package/es/src/charts/features/annotationTypes.js +10 -0
  217. package/es/src/charts/features/attributionFeature.js +6 -11
  218. package/es/src/charts/features/axes.js +9 -7
  219. package/es/src/charts/features/axesFinal.js +26 -4
  220. package/es/src/charts/features/axesMeasure.js +61 -6
  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/chartGeometry.js +1 -1
  224. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  225. package/es/src/charts/features/circleLabels.js +207 -0
  226. package/es/src/charts/features/colorScaleBucket.js +19 -1
  227. package/es/src/charts/features/colorScaleHover.js +70 -0
  228. package/es/src/charts/features/colorScaleValue.js +97 -0
  229. package/es/src/charts/features/curvedArrows.js +158 -0
  230. package/es/src/charts/features/edgeArrows.js +160 -4
  231. package/es/src/charts/features/edgeBundling.js +442 -0
  232. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  233. package/es/src/charts/features/ensureZoomDom.js +32 -8
  234. package/es/src/charts/features/features.js +45 -15
  235. package/es/src/charts/features/featuresColorScale.js +62 -8
  236. package/es/src/charts/features/featuresLegend.js +21 -32
  237. package/es/src/charts/features/legendKeys.js +64 -0
  238. package/es/src/charts/features/lineLabels.js +55 -46
  239. package/es/src/charts/features/linkBundle.js +19 -0
  240. package/es/src/charts/features/linkColor.js +72 -0
  241. package/es/src/charts/features/linkFields.js +86 -0
  242. package/es/src/charts/features/linkFocus.js +118 -0
  243. package/es/src/charts/features/linkInteraction.js +312 -0
  244. package/es/src/charts/features/linkKeys.js +20 -0
  245. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  246. package/es/src/charts/features/linkLabelPath.js +162 -0
  247. package/es/src/charts/features/linkLabels.js +340 -0
  248. package/es/src/charts/features/linkWidths.js +32 -0
  249. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  250. package/es/src/charts/features/pathLabels.js +50 -0
  251. package/es/src/charts/features/plotAnnotations.js +68 -17
  252. package/es/src/charts/features/plotPaint.js +42 -15
  253. package/es/src/charts/features/polyline.js +129 -0
  254. package/es/src/charts/features/referenceAnnotations.js +403 -0
  255. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  256. package/es/src/charts/features/ringLabelNodes.js +93 -0
  257. package/es/src/charts/features/ringLabels.js +222 -0
  258. package/es/src/charts/features/sceneBounds.js +26 -6
  259. package/es/src/charts/features/selfLoops.js +306 -0
  260. package/es/src/charts/features/shapeEmit.js +67 -30
  261. package/es/src/charts/features/shareKey.js +15 -0
  262. package/es/src/charts/features/sharedFields.js +15 -2
  263. package/es/src/charts/features/textHalo.js +29 -0
  264. package/es/src/charts/features/thresholdMembers.js +71 -0
  265. package/es/src/charts/helpers/densityChart.js +3 -1
  266. package/es/src/charts/helpers/valueTitle.js +6 -3
  267. package/es/src/charts/index.js +8 -0
  268. package/es/src/charts/partition/chartFields.js +6 -5
  269. package/es/src/charts/partition/hierarchy.js +2 -0
  270. package/es/src/charts/partition/interaction.js +9 -5
  271. package/es/src/charts/partition/zoom.js +7 -6
  272. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  273. package/es/src/charts/pipeline/preDrawData.js +77 -13
  274. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  275. package/es/src/charts/pipeline/vizDraw.js +40 -29
  276. package/es/src/charts/pipeline/vizPreDraw.js +29 -18
  277. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  278. package/es/src/charts/polar/config.js +2 -3
  279. package/es/src/charts/viz/Viz.js +82 -44
  280. package/es/src/charts/viz/VizBase.js +47 -19
  281. package/es/src/charts/viz/backgroundInk.js +13 -7
  282. package/es/src/charts/viz/dataPoller.js +52 -0
  283. package/es/src/charts/viz/focusRing.js +104 -0
  284. package/es/src/charts/viz/focusTargets.js +208 -0
  285. package/es/src/charts/viz/groupRow.js +35 -0
  286. package/es/src/charts/viz/history.js +74 -0
  287. package/es/src/charts/viz/interactionOpacity.js +19 -5
  288. package/es/src/charts/viz/keyboardNav.js +297 -0
  289. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  290. package/es/src/charts/viz/loaderFormat.js +114 -0
  291. package/es/src/charts/viz/missingFields.js +123 -0
  292. package/es/src/charts/viz/mountTarget.js +9 -0
  293. package/es/src/charts/viz/nearestHover.js +183 -0
  294. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  295. package/es/src/charts/viz/ordinalColor.js +14 -12
  296. package/es/src/charts/viz/pageTheme.js +83 -0
  297. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  298. package/es/src/charts/viz/pointVoronoi.js +124 -0
  299. package/es/src/charts/viz/reducedMotion.js +27 -0
  300. package/es/src/charts/viz/reportHandlerError.js +10 -0
  301. package/es/src/charts/viz/shapeClassTargets.js +18 -2
  302. package/es/src/charts/viz/simpleHover.js +2 -0
  303. package/es/src/charts/viz/vizClassName.js +31 -0
  304. package/es/src/charts/viz/vizDataPolling.js +172 -0
  305. package/es/src/charts/viz/vizDefaults.js +81 -23
  306. package/es/src/charts/viz/vizFields.js +53 -2
  307. package/es/src/charts/viz/vizRender.js +49 -28
  308. package/es/src/charts/viz/vizTheme.js +96 -0
  309. package/es/src/charts/viz/vizVisibility.js +14 -0
  310. package/es/src/components/Axis/Axis.js +34 -0
  311. package/es/src/components/Axis/AxisBottom.js +1 -0
  312. package/es/src/components/Axis/AxisLeft.js +1 -0
  313. package/es/src/components/Axis/AxisRight.js +1 -0
  314. package/es/src/components/Axis/AxisTop.js +1 -0
  315. package/es/src/components/Axis/axisBreak.js +4 -1
  316. package/es/src/components/Axis/axisDefaults.js +8 -10
  317. package/es/src/components/Axis/axisLabelAngle.js +175 -0
  318. package/es/src/components/Axis/axisLabelThinning.js +13 -4
  319. package/es/src/components/Axis/axisLayout.js +86 -19
  320. package/es/src/components/Axis/axisLayoutLabels.js +66 -13
  321. package/es/src/components/Axis/axisLayoutScale.js +10 -1
  322. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  323. package/es/src/components/Axis/axisRender.js +38 -9
  324. package/es/src/components/Axis/axisRounding.js +15 -4
  325. package/es/src/components/Axis/axisSlantWrap.js +39 -0
  326. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  327. package/es/src/components/Axis/powTicks.js +73 -0
  328. package/es/src/components/Axis/rangeBreaks.js +201 -0
  329. package/es/src/components/Axis/timeValues.js +19 -4
  330. package/es/src/components/ColorScale/ColorScale.js +42 -36
  331. package/es/src/components/ColorScale/bucketBounds.js +64 -0
  332. package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
  333. package/es/src/components/ColorScale/colorScaleRender.js +25 -1
  334. package/es/src/components/ColorScale/colorScaleScale.js +43 -24
  335. package/es/src/components/ColorScale/colorScaleType.js +26 -0
  336. package/es/src/components/Legend/Legend.js +3 -0
  337. package/es/src/components/Legend/legendConfig.js +2 -6
  338. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  339. package/es/src/components/TextBox.js +31 -65
  340. package/es/src/components/Timeline/Timeline.js +54 -54
  341. package/es/src/components/Timeline/brushSpan.js +78 -0
  342. package/es/src/components/Timeline/timelineConfig.js +27 -10
  343. package/es/src/components/Timeline/timelineMode.js +26 -0
  344. package/es/src/components/Timeline/timelineRender.js +51 -9
  345. package/es/src/components/Tooltip.js +28 -13
  346. package/es/src/components/fontStack.js +20 -0
  347. package/es/src/components/textBoxLayout.js +58 -21
  348. package/es/src/components/textBoxPath.js +73 -0
  349. package/es/src/components/textBoxScene.js +223 -0
  350. package/es/src/components/textBoxWords.js +70 -0
  351. package/es/src/shapes/Area.js +1 -0
  352. package/es/src/shapes/Bar.js +1 -0
  353. package/es/src/shapes/Box.js +67 -79
  354. package/es/src/shapes/Circle.js +1 -0
  355. package/es/src/shapes/Line.js +1 -0
  356. package/es/src/shapes/Path.js +1 -0
  357. package/es/src/shapes/Rect.js +1 -0
  358. package/es/src/shapes/Shape.js +1 -0
  359. package/es/src/shapes/Whisker.js +1 -0
  360. package/es/src/shapes/boxOutlierShape.js +19 -0
  361. package/es/src/shapes/boxStats.js +35 -0
  362. package/es/src/shapes/boxStyle.js +78 -0
  363. package/es/src/shapes/boxSummary.js +174 -0
  364. package/es/src/shapes/shapeStandalone.js +2 -0
  365. package/es/src/utils/BaseClass.js +44 -12
  366. package/es/src/utils/className.js +78 -0
  367. package/es/src/utils/configPrep.js +2 -1
  368. package/es/src/utils/configWarnings.js +25 -0
  369. package/es/src/utils/constant.js +13 -1
  370. package/es/src/utils/displayName.js +12 -0
  371. package/es/src/utils/fieldAccessor.js +31 -0
  372. package/es/src/utils/paintComponentScene.js +2 -0
  373. package/es/src/utils/theme.js +190 -0
  374. package/es/src/utils/themeInk.js +68 -0
  375. package/package.json +14 -10
  376. package/types/index.d.ts +8 -2
  377. package/types/internal.d.ts +253 -9
  378. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  379. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  380. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  381. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  382. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  383. package/types/src/charts/Alluvial/index.d.ts +27 -0
  384. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  385. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  386. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  387. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  388. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  389. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  390. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  391. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  392. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  393. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  394. package/types/src/charts/BoxWhisker/index.d.ts +3 -1
  395. package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
  396. package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
  397. package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
  398. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  399. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  400. package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
  401. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  402. package/types/src/charts/Chord/labels.d.ts +66 -0
  403. package/types/src/charts/Donut/index.d.ts +2 -1
  404. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  405. package/types/src/charts/Gantt/emit.d.ts +17 -0
  406. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  407. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  408. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  409. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  410. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  411. package/types/src/charts/Gantt/index.d.ts +36 -0
  412. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  413. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  414. package/types/src/charts/Geomap/emit.d.ts +2 -2
  415. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  416. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  417. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  418. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  419. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  420. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  421. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  422. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  423. package/types/src/charts/Geomap/index.d.ts +3 -0
  424. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  425. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  426. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  427. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  428. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  429. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  430. package/types/src/charts/Hexbin/index.d.ts +25 -0
  431. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  432. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  433. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  434. package/types/src/charts/Histogram/binData.d.ts +20 -1
  435. package/types/src/charts/Histogram/index.d.ts +3 -2
  436. package/types/src/charts/Histogram/labels.d.ts +7 -0
  437. package/types/src/charts/Marimekko/index.d.ts +2 -1
  438. package/types/src/charts/Network/bundle.d.ts +67 -0
  439. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  440. package/types/src/charts/Network/clusters.d.ts +115 -0
  441. package/types/src/charts/Network/graph.d.ts +65 -0
  442. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  443. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  444. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  445. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  446. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  447. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  448. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  449. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  450. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  451. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  452. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  453. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  454. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  455. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  456. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  457. package/types/src/charts/Plot/axisHover.d.ts +68 -0
  458. package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
  459. package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
  460. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  461. package/types/src/charts/Plot/barHitArea.d.ts +59 -0
  462. package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
  463. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  464. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  465. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  466. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  467. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  468. package/types/src/charts/Plot/index.d.ts +28 -8
  469. package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
  470. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  471. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  472. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  473. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  474. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  475. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  476. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  477. package/types/src/charts/Plot/plotInit.d.ts +23 -2
  478. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  479. package/types/src/charts/Plot/plotZoom.d.ts +2 -0
  480. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  481. package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
  482. package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
  483. package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
  484. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  485. package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
  486. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  487. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  488. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  489. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  490. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  491. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  492. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  493. package/types/src/charts/Rings/emit.d.ts +50 -0
  494. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  495. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  496. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  497. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  498. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  499. package/types/src/charts/Sankey/emit.d.ts +58 -0
  500. package/types/src/charts/Sankey/labels.d.ts +19 -0
  501. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  502. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  503. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  504. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  505. package/types/src/charts/Scatter/index.d.ts +15 -0
  506. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  507. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  508. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  509. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  510. package/types/src/charts/Treemap/emit.d.ts +2 -1
  511. package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
  512. package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
  513. package/types/src/charts/Treemap/index.d.ts +2 -0
  514. package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
  515. package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
  516. package/types/src/charts/definition/makeChart.d.ts +5 -3
  517. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  518. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  519. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  520. package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
  521. package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
  522. package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
  523. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
  524. package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
  525. package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
  526. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  527. package/types/src/charts/events/click.legend.d.ts +2 -1
  528. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  529. package/types/src/charts/facet/facetData.d.ts +1 -1
  530. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  531. package/types/src/charts/features/annotationText.d.ts +57 -0
  532. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  533. package/types/src/charts/features/axesMeasure.d.ts +13 -1
  534. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  535. package/types/src/charts/features/calloutScene.d.ts +40 -0
  536. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  537. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  538. package/types/src/charts/features/circleLabels.d.ts +130 -0
  539. package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
  540. package/types/src/charts/features/colorScaleHover.d.ts +32 -0
  541. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  542. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  543. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  544. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  545. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  546. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  547. package/types/src/charts/features/features.d.ts +8 -0
  548. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  549. package/types/src/charts/features/legendKeys.d.ts +34 -0
  550. package/types/src/charts/features/lineLabels.d.ts +15 -12
  551. package/types/src/charts/features/linkBundle.d.ts +16 -0
  552. package/types/src/charts/features/linkColor.d.ts +48 -0
  553. package/types/src/charts/features/linkFields.d.ts +16 -0
  554. package/types/src/charts/features/linkFocus.d.ts +51 -0
  555. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  556. package/types/src/charts/features/linkKeys.d.ts +11 -0
  557. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  558. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  559. package/types/src/charts/features/linkLabels.d.ts +77 -0
  560. package/types/src/charts/features/linkWidths.d.ts +19 -0
  561. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  562. package/types/src/charts/features/pathLabels.d.ts +41 -0
  563. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  564. package/types/src/charts/features/plotPaint.d.ts +19 -0
  565. package/types/src/charts/features/polyline.d.ts +32 -0
  566. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  567. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  568. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  569. package/types/src/charts/features/ringLabels.d.ts +164 -0
  570. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  571. package/types/src/charts/features/selfLoops.d.ts +165 -0
  572. package/types/src/charts/features/shapeEmit.d.ts +5 -1
  573. package/types/src/charts/features/shareKey.d.ts +9 -0
  574. package/types/src/charts/features/sharedFields.d.ts +11 -2
  575. package/types/src/charts/features/textHalo.d.ts +14 -0
  576. package/types/src/charts/features/thresholdMembers.d.ts +38 -0
  577. package/types/src/charts/helpers/valueTitle.d.ts +4 -2
  578. package/types/src/charts/index.d.ts +8 -0
  579. package/types/src/charts/partition/interaction.d.ts +6 -3
  580. package/types/src/charts/partition/zoom.d.ts +4 -4
  581. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  582. package/types/src/charts/pipeline/stages.d.ts +9 -0
  583. package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
  584. package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
  585. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  586. package/types/src/charts/viz/Viz.d.ts +44 -6
  587. package/types/src/charts/viz/VizBase.d.ts +16 -7
  588. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  589. package/types/src/charts/viz/dataPoller.d.ts +28 -0
  590. package/types/src/charts/viz/focusRing.d.ts +25 -0
  591. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  592. package/types/src/charts/viz/groupRow.d.ts +24 -0
  593. package/types/src/charts/viz/history.d.ts +35 -0
  594. package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
  595. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  596. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  597. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  598. package/types/src/charts/viz/missingFields.d.ts +57 -0
  599. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  600. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  601. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  602. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  603. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  604. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  605. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  606. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  607. package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
  608. package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
  609. package/types/src/charts/viz/simpleHover.d.ts +2 -1
  610. package/types/src/charts/viz/vizClassName.d.ts +23 -0
  611. package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
  612. package/types/src/charts/viz/vizDefaults.d.ts +49 -9
  613. package/types/src/charts/viz/vizFields.d.ts +47 -0
  614. package/types/src/charts/viz/vizRender.d.ts +2 -1
  615. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  616. package/types/src/charts/viz/vizTypes.d.ts +117 -8
  617. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  618. package/types/src/components/Axis/Axis.d.ts +37 -8
  619. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  620. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  621. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  622. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  623. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  624. package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
  625. package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
  626. package/types/src/components/Axis/axisLayout.d.ts +5 -0
  627. package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
  628. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  629. package/types/src/components/Axis/axisRounding.d.ts +6 -3
  630. package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
  631. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  632. package/types/src/components/Axis/powTicks.d.ts +29 -0
  633. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  634. package/types/src/components/Axis/timeValues.d.ts +1 -1
  635. package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
  636. package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
  637. package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
  638. package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
  639. package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
  640. package/types/src/components/Legend/Legend.d.ts +1 -0
  641. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  642. package/types/src/components/TextBox.d.ts +1 -0
  643. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  644. package/types/src/components/Timeline/brushSpan.d.ts +41 -0
  645. package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
  646. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  647. package/types/src/components/Timeline/timelineRender.d.ts +8 -0
  648. package/types/src/components/Tooltip.d.ts +12 -3
  649. package/types/src/components/fontStack.d.ts +10 -0
  650. package/types/src/components/textBoxLayout.d.ts +18 -9
  651. package/types/src/components/textBoxPath.d.ts +59 -0
  652. package/types/src/components/textBoxScene.d.ts +51 -0
  653. package/types/src/components/textBoxWords.d.ts +33 -0
  654. package/types/src/shapes/Area.d.ts +1 -0
  655. package/types/src/shapes/Bar.d.ts +1 -0
  656. package/types/src/shapes/Box.d.ts +2 -8
  657. package/types/src/shapes/Circle.d.ts +1 -0
  658. package/types/src/shapes/Line.d.ts +1 -0
  659. package/types/src/shapes/Path.d.ts +1 -0
  660. package/types/src/shapes/Rect.d.ts +1 -0
  661. package/types/src/shapes/Shape.d.ts +1 -0
  662. package/types/src/shapes/Whisker.d.ts +1 -0
  663. package/types/src/shapes/boxOutlierShape.d.ts +9 -0
  664. package/types/src/shapes/boxStats.d.ts +19 -0
  665. package/types/src/shapes/boxStyle.d.ts +25 -0
  666. package/types/src/shapes/boxSummary.d.ts +66 -0
  667. package/types/src/shapes/emitLabels.d.ts +1 -1
  668. package/types/src/shapes/shapeConfig.d.ts +42 -4
  669. package/types/src/utils/BaseClass.d.ts +32 -0
  670. package/types/src/utils/D3Scale.d.ts +3 -0
  671. package/types/src/utils/D3plusConfig.d.ts +1240 -33
  672. package/types/src/utils/className.d.ts +64 -0
  673. package/types/src/utils/configPrep.d.ts +2 -0
  674. package/types/src/utils/configWarnings.d.ts +21 -2
  675. package/types/src/utils/constant.d.ts +8 -0
  676. package/types/src/utils/displayName.d.ts +10 -0
  677. package/types/src/utils/fieldAccessor.d.ts +24 -0
  678. package/types/src/utils/index.d.ts +1 -1
  679. package/types/src/utils/paintComponentScene.d.ts +3 -1
  680. package/types/src/utils/theme.d.ts +170 -0
  681. package/types/src/utils/themeInk.d.ts +56 -0
  682. package/umd/d3plus-core.full.js +87388 -56271
  683. package/umd/d3plus-core.full.min.js +2 -2
  684. package/umd/d3plus-core.js +37988 -11768
  685. package/umd/d3plus-core.min.js +2 -2
  686. package/es/src/components/Axis/gridStroke.js +0 -10
  687. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -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
  /**
@@ -27,6 +28,18 @@ export default class Plot extends Viz {
27
28
  @private
28
29
  */
29
30
  _preDraw(): void;
31
+ /**
32
+ The legend rows with a stacked chart's threshold bucket folded into
33
+ one entry (see `stackThreshold.ts`).
34
+ @private
35
+ */
36
+ _thresholdLegend(legendData: DataPoint[]): DataPoint[];
37
+ /**
38
+ Folds a stacked chart's small series into one threshold bucket (see
39
+ `stackThreshold.ts`).
40
+ @private
41
+ */
42
+ _thresholdFunction(data: DataPoint[], _tree?: unknown, all?: DataPoint[]): DataPoint[];
30
43
  /**
31
44
  Composes the chart's scene graph: the native shape scenes from Viz.toScene
32
45
  (bars/lines/areas + labels) plus snapshots of the rendered axes, so a Plot
@@ -65,6 +78,12 @@ export default class Plot extends Viz {
65
78
  i: number;
66
79
  x: unknown;
67
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;
68
87
  /**
69
88
  Picks the interaction point closest to a surface-local cursor position
70
89
  along the discrete axis. `event.point` is post-zoom surface space while the
@@ -79,6 +98,7 @@ export default class Plot extends Viz {
79
98
  inside the plot area, snaps to the nearest discrete position and, when
80
99
  two or more series share it, shows them all in one tooltip (suppressing
81
100
  the single-shape tooltip). Clears on leaving the plot area or the chart.
101
+ Then tracks the hovered point's axis guides and badges (`axisHover`).
82
102
  @private
83
103
  */
84
104
  _sharedHover(event: SceneEvent): void;
@@ -121,7 +141,9 @@ export default class Plot extends Viz {
121
141
  /**
122
142
  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).
123
143
 
124
- 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.
144
+ 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 ("front" for callouts).
145
+
146
+ Three more kinds draw chart notes: `"Callout"` anchors wrapped text in a box at each data row's `x`/`y` (in data units, or plot-area fractions with `xRef`/`yRef: "plot"`), offset by `dx`/`dy` pixels and joined to its anchor by a connector ending in an arrowhead or dot (see `CalloutAnnotation`); `"ReferenceLine"` and `"ReferenceBand"` draw what `referenceLines` and `referenceBands` entries expand into. All annotations follow zoom and never respond to the pointer or keyboard.
125
147
  */
126
148
  annotations(_?: unknown): this | unknown[];
127
149
  /**
@@ -177,10 +199,6 @@ export default class Plot extends Viz {
177
199
  The d3plus-shape config used on the Line shapes created to connect lineLabels to the end of their associated Line path.
178
200
  */
179
201
  labelConnectorConfig(_?: Record<string, unknown>): this | Record<string, unknown>;
180
- /**
181
- 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.
182
- */
183
- labelPosition(_?: string | ((d: DataPoint, i: number) => string)): this | ((d: DataPoint, i: number) => string);
184
202
  /**
185
203
  Paint for the shared tooltip's crosshair guide line (`stroke`,
186
204
  `strokeWidth`, `strokeDasharray`, `strokeOpacity`, …). Merged into the
@@ -237,8 +255,10 @@ export default class Plot extends Viz {
237
255
  - a value accessor, or a `{value, order}` config, to rank series by an
238
256
  aggregate of any data field.
239
257
 
240
- Unknown named strings warn and fall back to `"descending"`. If *value*
241
- is not specified, returns the current stack order.
258
+ Unknown named strings warn and fall back to `"descending"`. The
259
+ default legend lists the series in the order they stack, from the
260
+ baseline outward. If *value* is not specified, returns the current
261
+ stack order.
242
262
  */
243
263
  stackOrder(_?: StackOrderInput): this | StackOrderFn | string[];
244
264
  /**
@@ -9,6 +9,11 @@ import type { VizInstance } from "../viz/vizTypes.js";
9
9
  Default shape size, routed through the chart's internal sizeScale.
10
10
  */
11
11
  export declare function defaultSize(this: VizInstance, d: DataPoint): number;
12
+ /**
13
+ Whether a bar grows back along its value axis: a negative value, or a
14
+ positive one on a `reverse` axis (down a y axis, left along an x axis).
15
+ */
16
+ export declare function growsBack(viz: VizInstance, valueAxis: string, d: DataPoint, i: number): boolean;
12
17
  /**
13
18
  Determines if a Bar label should be placed outside of the Bar.
14
19
  */
@@ -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[];
@@ -0,0 +1,116 @@
1
+ import type { SceneNode } from "@d3plus/render";
2
+ import type { Edges, Pt } from "../features/pathLabelGeometry.js";
3
+ import type { VizInstance } from "../viz/vizTypes.js";
4
+ /**
5
+ Obstacle points, bucketed by cell for nearest-distance lookups. Each
6
+ point may carry a tag, so a lookup can ignore the points of the line a
7
+ label sits on.
8
+ */
9
+ export declare class PointGrid {
10
+ private cell;
11
+ private cells;
12
+ /** @param cell The cell size: lookups see obstacles this far away. */
13
+ constructor(cell: number);
14
+ /** A cell's key: its column and row, packed into one number. */
15
+ private static key;
16
+ /**
17
+ Adds obstacle points.
18
+ @param points The points.
19
+ @param tag A tag `nearest` can ignore them by.
20
+ */
21
+ add(points: Pt[], tag?: number): void;
22
+ /**
23
+ The distance from `p` to its nearest obstacle within one cell, or `Infinity`.
24
+ @param p The point.
25
+ @param ignore A tag whose points are left out.
26
+ */
27
+ nearest(p: Pt, ignore?: number): number;
28
+ }
29
+ /**
30
+ Points every `step` pixels along a polyline.
31
+ @param points The polyline.
32
+ @param step The spacing.
33
+ */
34
+ export declare function resample(points: Pt[], step: number): Pt[];
35
+ /**
36
+ How much a stretch bends: the sum of its turns, in radians.
37
+ @param points The stretch.
38
+ */
39
+ export declare function curvature(points: Pt[]): number;
40
+ /** What scoring a stretch needs. */
41
+ export interface StretchContext {
42
+ grid: PointGrid;
43
+ rect: Edges;
44
+ fontSize: number;
45
+ /** How far above the line the text's baseline sits (below it when negative). */
46
+ lift: number;
47
+ /** The least room a label needs from every obstacle. Defaults to `2`. */
48
+ minClearance?: number;
49
+ /** The room past which a stretch scores no better. Defaults to the font size. */
50
+ roomReach?: number;
51
+ /** How much room counts against bends and slope. Defaults to `0.5`. */
52
+ roomWeight?: number;
53
+ /** How steep a stretch reads bottom to top (see `uprightPoints`). */
54
+ steep?: number;
55
+ /** A grid tag to ignore: the points of the line the label sits on. */
56
+ ignore?: number;
57
+ /** The most a stretch may turn in all, in radians (default a right angle). */
58
+ maxTurn?: number;
59
+ }
60
+ /**
61
+ The points a label along `points` would cover: its baseline and two rows
62
+ above it, up to its letters' height.
63
+ @param points The upright stretch.
64
+ @param ctx The font size and lift.
65
+ */
66
+ export declare function labelBand(points: Pt[], ctx: StretchContext): Pt[];
67
+ /**
68
+ A stretch's score, lower being better: how much it bends and slopes, less
69
+ a bonus for room around its label (up to `roomReach`, weighted by
70
+ `roomWeight`); null when its label would leave the
71
+ plot or come within `minClearance` of an obstacle (another line or
72
+ label, or the edges of the band it runs in).
73
+ @param points The upright stretch.
74
+ @param ctx The obstacles, plot area, and font.
75
+ */
76
+ export declare function scoreStretch(points: Pt[], ctx: StretchContext): number | null;
77
+ /** A stretch `bestStretchAt` found: its points, its piece, and where along the piece it starts. */
78
+ export interface StretchSpot {
79
+ points: Pt[];
80
+ piece: number;
81
+ from: number;
82
+ }
83
+ /**
84
+ The best-scoring stretch of `length` pixels along any of a line's
85
+ pieces, upright, with where it lies, or null when every stretch is
86
+ blocked or too bent.
87
+ @param pieces The line's pieces (where its data has gaps), in pixels.
88
+ @param length The stretch's length.
89
+ @param ctx The obstacles, plot area, and font.
90
+ @param allow Which stretches may be taken, by their piece and start.
91
+ */
92
+ export declare function bestStretchAt(pieces: Pt[][], length: number, ctx: StretchContext, allow?: (from: number, piece: number) => boolean): StretchSpot | null;
93
+ /**
94
+ The best-scoring stretch of `length` pixels along any of a line's
95
+ pieces, upright, or null when every stretch is blocked or too bent.
96
+ @param pieces The line's pieces (where its data has gaps), in pixels.
97
+ @param length The stretch's length.
98
+ @param ctx The obstacles, plot area, and font.
99
+ */
100
+ export declare function bestStretch(pieces: Pt[][], length: number, ctx: StretchContext): Pt[] | null;
101
+ /**
102
+ The label font a shape's labelConfig sets, as plain values.
103
+ @param viz The chart.
104
+ @param shape The shape whose labelConfig to read.
105
+ */
106
+ export declare function labelFont(viz: VizInstance, shape?: string): Record<string, unknown>;
107
+ /**
108
+ The labels for every series `lineLabels` runs along its line, placed one
109
+ by one so each stays clear of the lines and the labels before it. A
110
+ plot (or panel) with a single line labels none. Counts the lines and
111
+ labels into `viz._alongStats`, for the legend (see `alongLegend.ts`).
112
+ @param viz The chart.
113
+ @param marks The plot's drawn marks, its Lines among them.
114
+ @param rect The plot area.
115
+ */
116
+ export declare function emitAlongLabels(viz: VizInstance, marks: SceneNode[], rect: Edges): SceneNode[];
@@ -9,9 +9,23 @@ export { preparePlotAxisLayout } from "./pipelineAxisLayout.js";
9
9
  /**
10
10
  The bubble radius scale: `sizeScale` over the extent of `sizes`, ranging
11
11
  from `sizeMin` (capped at half of `sizeMax`) to `sizeMax`. A single-value
12
- extent maps everything to `sizeMax`.
12
+ extent maps everything to `sizeMax`. With `sizeZero`, the smallest value's
13
+ radius is where a scale anchored at zero puts it instead (see
14
+ `zeroAnchoredRadius`).
13
15
  */
14
16
  export declare function plotSizeScale(viz: Parameters<TransformStage>[0]["viz"], sizes: number[]): D3Scale;
17
+ /**
18
+ The radius a size scale anchored at zero (domain `[0, max]`, range
19
+ `[0, sizeMax]`) gives the smallest of `[min, max]`. A scale over
20
+ `[min, max]` starting at this radius draws every value where the anchored
21
+ one does: with a `"sqrt"` scale, each mark's area is proportional to its
22
+ value; with `"linear"`, its radius. NaN when the extent can't be anchored
23
+ at zero (a negative or non-positive extent, or a log scale).
24
+ @param make The size scale's constructor.
25
+ @param extent The size values' `[min, max]`.
26
+ @param sizeMax The largest radius.
27
+ */
28
+ export declare function zeroAnchoredRadius(make: () => D3Scale, [lo, hi]: [number, number], sizeMax: number): number;
15
29
  /**
16
30
  Plot's size-legend scale, available before layout: the same scale
17
31
  `formatPlotData` builds, over the plottable rows. Null when there's no
@@ -1,2 +1,70 @@
1
1
  import type { TransformStage } from "../pipeline/stages.js";
2
+ import { type LineLabelSide } from "./lineLabelSides.js";
3
+ /** A d3plus config value: a constant or a `(datum, index)` accessor. */
4
+ type ConfigAccessor<T> = T | ((d: Record<string, unknown>, i?: number) => T);
5
+ interface LineLabelCtx {
6
+ labelFunction: ConfigAccessor<string>;
7
+ fontColorAccessor: ConfigAccessor<string>;
8
+ fontSizeAccessor: ConfigAccessor<number>;
9
+ fontWeightAccessor: ConfigAccessor<number | string>;
10
+ fontFamilyAccessor: ConfigAccessor<string | string[]>;
11
+ paddingAccessor: ConfigAccessor<number>;
12
+ xEstimate: (d: unknown) => number;
13
+ yEstimate: (d: unknown) => number;
14
+ /** The value text for a label's point, or `undefined` without one. */
15
+ valueText: (value: unknown, d: Record<string, unknown>) => string | undefined;
16
+ /** The most room a label may take past its line's end, padding included. */
17
+ maxSpace?: number;
18
+ }
19
+ /**
20
+ Shortens a label to fit `maxWidth`: the name and value when both fit,
21
+ else the name alone, else the name cut short with an ellipsis, else
22
+ `null` (no room for even one letter).
23
+ */
24
+ export declare function fitLineLabelText(name: string, value: string | undefined, maxWidth: number, measure: (text: string) => number): {
25
+ name: string;
26
+ value?: string;
27
+ } | null;
28
+ /**
29
+ The most room the labels at one end of a line chart may take: a quarter
30
+ of its `width` past its y axis (`yWidth`), so labels at both ends leave
31
+ the plot at least half of that, and labels never crowd the plot out of a
32
+ narrow chart or a small-multiples panel.
33
+ */
34
+ export declare function lineLabelCap(width: number, yWidth?: number): number;
35
+ /**
36
+ Measures one end of a line's label (width, position, overlap coords): its
37
+ right end (`"end"`, the last point across) or its left end (`"start"`).
38
+ */
39
+ export declare function measureLineLabel([lineKey, lineValues]: [unknown, Record<string, unknown>[]], ctx: LineLabelCtx, side?: LineLabelSide): {
40
+ id: unknown;
41
+ side: LineLabelSide;
42
+ name: string | undefined;
43
+ valueText: string | undefined;
44
+ labelWidth: number;
45
+ spaceNeeded: number;
46
+ value: unknown;
47
+ yEstimate: number;
48
+ padding: number;
49
+ fontSize: number;
50
+ fontColor: string;
51
+ edgeX: number;
52
+ xValue: unknown;
53
+ coords: number[][];
54
+ } | null;
55
+ /** A measured line label (see `measureLineLabel`). */
56
+ type LineLabel = NonNullable<ReturnType<typeof measureLineLabel>>;
57
+ /**
58
+ Whether another line passes through the space `label` would occupy past
59
+ its line's end: right of its last point, or left of its first point for a
60
+ `"start"` label.
61
+ */
62
+ export declare function labelOverlapsLine(label: LineLabel, labels: LineLabel[]): boolean;
63
+ /**
64
+ The room the labels at one end of the plot claim: the widest label among
65
+ the lines that end at the x range's `edge`, at most `cap`; 0 when no line
66
+ reaches that edge.
67
+ */
68
+ export declare function lineLabelSpace(labels: Pick<LineLabel, "edgeX" | "spaceNeeded">[], edge: number, cap: number): number;
2
69
  export declare const measurePlotLineLabels: TransformStage;
70
+ export {};
@@ -14,6 +14,11 @@ import type { DomainValue, PlotFacetScales } from "./facetScales.js";
14
14
  export declare function listAxis(viz: VizInstance, axis: string): boolean;
15
15
  /** The `[min, max]` covering every extent (dates stay dates); undefined when none are numeric. */
16
16
  export declare function unionExtent(extents: DomainValue[][]): DomainValue[] | undefined;
17
+ /**
18
+ Orders a stacked chart's legend by every panel's stacks, pooled (see
19
+ `stackLegendOrder.ts`), before the chrome lays the legend out.
20
+ */
21
+ export declare function plotFacetChrome(viz: VizInstance, panels: DataPoint[][]): void;
17
22
  /**
18
23
  The domains (and size scale) that fit every panel's rows: a category axis
19
24
  lists every panel's categories, in the order one chart of all the rows
@@ -1,4 +1,5 @@
1
1
  import type Plot from "./index.js";
2
+ import { axisHoverDefaults } from "./axisHoverScene.js";
2
3
  import { fillBetweenDefaults } from "./fillBetween.js";
3
4
  /**
4
5
  Plot's identity-coerce accessor schema. `installFluent` installs it on
@@ -7,13 +8,19 @@ import { fillBetweenDefaults } from "./fillBetween.js";
7
8
  export declare const plotSchema: ({
8
9
  key: string;
9
10
  coerce: "identity";
10
- default?: undefined;
11
+ default: boolean;
11
12
  merge?: undefined;
12
13
  factory?: undefined;
14
+ } | {
15
+ key: string;
16
+ merge: boolean;
17
+ factory: typeof axisHoverDefaults;
18
+ coerce?: undefined;
19
+ default?: undefined;
13
20
  } | {
14
21
  key: string;
15
22
  coerce: "identity";
16
- default: boolean;
23
+ default?: undefined;
17
24
  merge?: undefined;
18
25
  factory?: undefined;
19
26
  } | {
@@ -22,6 +29,20 @@ export declare const plotSchema: ({
22
29
  factory: typeof fillBetweenDefaults;
23
30
  coerce?: undefined;
24
31
  default?: undefined;
32
+ } | {
33
+ key: string;
34
+ merge: boolean;
35
+ factory: () => {
36
+ value: boolean;
37
+ };
38
+ coerce?: undefined;
39
+ default?: undefined;
40
+ } | {
41
+ key: string;
42
+ coerce: "identity";
43
+ factory: () => never[];
44
+ default?: undefined;
45
+ merge?: undefined;
25
46
  } | {
26
47
  key: string;
27
48
  coerce: "identity";
@@ -0,0 +1,35 @@
1
+ import { type RangeBreakRule } from "../../components/Axis/rangeBreaks.js";
2
+ import type { D3Scale } from "../../utils/index.js";
3
+ import type { TransformStage } from "../pipeline/stages.js";
4
+ /** The viz a Plot pipeline stage reads. */
5
+ type PlotViz = Parameters<TransformStage>[0]["viz"];
6
+ /** The axes a Plot can draw time on. */
7
+ declare const AXES: readonly ["x", "x2", "y", "y2"];
8
+ /** One of a Plot's four axes. */
9
+ export type AxisName = (typeof AXES)[number];
10
+ /** An axis's `rangeBreaks` rules, from its axis config, when it plots time. */
11
+ export declare function plotRangeBreaks(viz: PlotViz, axis: AxisName): RangeBreakRule[];
12
+ /**
13
+ Whether an axis's `rangeBreaks` make it a time axis without `time`: the
14
+ axis config has rules, and `value` (the first row's) reads as a date — a
15
+ Date, a timestamp, or a date string.
16
+ */
17
+ export declare function rangeBreaksTimeAxis(viz: PlotViz, axis: AxisName, value: unknown): boolean;
18
+ /**
19
+ The `rangeBreaks` a chart's timeline takes by default: those of the axis
20
+ that plots the chart's `time` values (the first row's time equals that
21
+ axis's value), else none.
22
+ */
23
+ export declare function timelineRangeBreaks(viz: PlotViz): RangeBreakRule[];
24
+ /**
25
+ The rows to draw: those whose time every time axis shows. Rows inside
26
+ an axis's `rangeBreaks` are dropped, with a warning naming the axis.
27
+ */
28
+ export declare function dropHiddenRows<T extends Record<string, unknown>>(viz: PlotViz, rows: T[]): T[];
29
+ /**
30
+ A Plot pipeline scale for `axis`: a broken time scale over the same
31
+ domain and range when the axis plots time with `rangeBreaks`, else the
32
+ scale as given.
33
+ */
34
+ export declare function plotTimeScale(viz: PlotViz, axis: AxisName, scale: D3Scale): D3Scale;
35
+ export {};
@@ -44,6 +44,8 @@ export interface PlotZoomBase {
44
44
  labelSpace: Partial<Record<AxisName, number>>;
45
45
  /** Axes drawn with a baseline break; a zoom keeps the break only on these. */
46
46
  breaks: Partial<Record<AxisName, boolean>>;
47
+ /** Axes drawn `reverse`d, whose scales run the other way to their domains. */
48
+ reversed: Partial<Record<AxisName, boolean>>;
47
49
  }
48
50
  /**
49
51
  Paints a Plot at its natural (unzoomed) scale and records what a zoom
@@ -0,0 +1,49 @@
1
+ import type { Annotation } from "../features/annotationTypes.js";
2
+ import type { TransformStage } from "../pipeline/stages.js";
3
+ import type { DomainValue } from "./pipelineScales.js";
4
+ /** The viz a Plot pipeline stage reads. */
5
+ type PlotViz = Parameters<TransformStage>[0]["viz"];
6
+ /** The four Plot axes. */
7
+ type AxisKey = "x" | "y" | "x2" | "y2";
8
+ /**
9
+ The data-unit values reference lines and bands place on each axis, from
10
+ a list of annotations (`"plot"`-fraction entries and other kinds left
11
+ out).
12
+ @param annotations The chart's annotations, with `referenceLines` and `referenceBands` expanded.
13
+ */
14
+ export declare function referenceDomainValues(annotations: Annotation[]): Record<AxisKey, unknown[]>;
15
+ /**
16
+ A continuous or time domain stretched to take in `values`, keeping its
17
+ orientation. Only the ends marked `open` move (an end the user set stays
18
+ put), and a log axis ignores values at or below zero. Returns the domain
19
+ itself when nothing changes.
20
+ @param domain The axis's `[start, end]` domain.
21
+ @param values The values to take in.
22
+ @param options Whether the axis is a time or log axis, and which ends may move.
23
+ */
24
+ export declare function widenToValues(domain: DomainValue[], values: unknown[], options?: {
25
+ time?: boolean;
26
+ log?: boolean;
27
+ open?: [boolean, boolean];
28
+ }): DomainValue[];
29
+ /**
30
+ Which ends of an axis's domain may widen: those the user's domain leaves
31
+ unset (both, without one; the end, for a one-value `[start]`).
32
+ @param user The user's domain for the axis, if any.
33
+ */
34
+ export declare function openDomainEnds(user: unknown): [boolean, boolean];
35
+ /**
36
+ Widens a Plot's auto domains to take in its reference lines and bands
37
+ (from `referenceLines`, `referenceBands`, and `"ReferenceLine"`/
38
+ `"ReferenceBand"` annotations), on continuous and time axes only. An
39
+ end set by the user's domain (`xDomain`, `xConfig.domain`, …) stays put.
40
+ @param viz The chart.
41
+ @param autoDomains Each axis's domain before the baseline is applied.
42
+ @param scales Each axis's scale type (`"Linear"`, `"Time"`, `"Point"`, …) and configured scale (`"log"`, …).
43
+ @param user The user's x and y domains, as `computePlotScales` reads them.
44
+ */
45
+ export declare function widenReferenceDomains(viz: PlotViz, autoDomains: Record<AxisKey, DomainValue[] | undefined>, scales: Record<AxisKey, {
46
+ type: string;
47
+ config: string;
48
+ }>, user: Record<string, DomainValue[] | undefined>): Record<AxisKey, DomainValue[] | undefined>;
49
+ export {};
@@ -1,8 +1,8 @@
1
1
  import type { Scene } from "@d3plus/render";
2
2
  import type { VizInstance } from "../viz/vizTypes.js";
3
3
  /**
4
- Adds the snapped hover's scene nodes (see `decorateBody`) to the chart
5
- body group (content space, so they track zoom) — to each panel's body
6
- when the chart is drawn as small multiples.
4
+ Adds the hover's scene nodes (see `decorateBody`) to the chart body group
5
+ (content space, so they track zoom) — to each panel's body when the chart
6
+ is drawn as small multiples.
7
7
  */
8
8
  export declare function appendSharedHoverNodes(viz: VizInstance, scene: Scene): void;
@@ -12,7 +12,7 @@ export declare function axisName(viz: VizInstance, k: Axis): string;
12
12
  axis of years, matching its tick labels), and anything else (e.g. a numeric
13
13
  year on the discrete axis) as-is.
14
14
  */
15
- export declare function axisValue(viz: VizInstance, k: Axis, value: unknown): string;
15
+ export declare function axisValue(viz: VizInstance, k: Axis | "x2" | "y2", value: unknown): string;
16
16
  /**
17
17
  Holds the tooltip's own arrow/thead/tbody to restore once the snapped
18
18
  hover ends (see `restoreTooltip`), so the next legend or default tooltip
@@ -23,19 +23,26 @@ export declare function axisValue(viz: VizInstance, k: Axis, value: unknown): st
23
23
  export declare function prepareTooltip(viz: VizInstance): any;
24
24
  /** Puts back what `prepareTooltip` held. */
25
25
  export declare function restoreTooltip(viz: VizInstance): void;
26
+ /**
27
+ How many of a threshold bucket's series the shared tooltip lists under
28
+ its row: fewer than a single-mark tooltip, since every other series has
29
+ a row of its own beside them.
30
+ */
31
+ export declare const SHARED_MEMBER_LIMIT = 5;
26
32
  /**
27
33
  The shared tooltip: title from the continuous axis, a header row naming
28
34
  the hovered discrete value, then one `[name, value]` row per series, the
29
35
  name led by a swatch in its series stroke and the value followed by its
30
- `confidence` range. User `tooltipConfig` styles apply first; the shared
31
- title/rows win.
36
+ `confidence` range, and a threshold bucket's series listed under its row.
37
+ User `tooltipConfig` styles apply first; the shared title/rows win.
32
38
  */
33
39
  export declare function renderSharedTooltip(viz: VizInstance, hover: SharedHover, event: SceneEvent): void;
34
40
  /**
35
41
  The single-mark tooltip (one series, `tooltipShared(false)`, or a
36
42
  side-by-side bar): the default title (the mark's label, unless
37
43
  `tooltipConfig` sets one), its x and y values, its `confidence` bounds,
38
- then any rows the chart's `tooltipConfig` adds.
44
+ then any rows the chart's `tooltipConfig` adds, and a threshold bucket's
45
+ series.
39
46
  */
40
47
  export declare function renderSingleTooltip(viz: VizInstance, hover: SharedHover, event: SceneEvent): void;
41
48
  export {};