@d3plus/core 4.11.0 → 4.13.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 (988) hide show
  1. package/es/index.js +2 -2
  2. package/es/internal.js +167 -23
  3. package/es/src/charts/Alluvial/emit.js +5 -4
  4. package/es/src/charts/Alluvial/index.js +7 -1
  5. package/es/src/charts/Alluvial/titles.js +24 -4
  6. package/es/src/charts/ArcDiagram/applyLayout.js +17 -10
  7. package/es/src/charts/ArcDiagram/arcGeometry.js +21 -8
  8. package/es/src/charts/ArcDiagram/arcLoops.js +5 -2
  9. package/es/src/charts/ArcDiagram/arcNodeBox.js +89 -0
  10. package/es/src/charts/ArcDiagram/emit.js +81 -38
  11. package/es/src/charts/ArcDiagram/events.js +16 -8
  12. package/es/src/charts/ArcDiagram/index.js +3 -1
  13. package/es/src/charts/BarChart/index.js +14 -10
  14. package/es/src/charts/BoxWhisker/extras.js +95 -0
  15. package/es/src/charts/BoxWhisker/index.js +77 -6
  16. package/es/src/charts/BoxWhisker/outliers.js +3 -2
  17. package/es/src/charts/BoxWhisker/summary.js +14 -3
  18. package/es/src/charts/BoxWhisker/tooltip.js +114 -29
  19. package/es/src/charts/BubbleChart/emit.js +9 -5
  20. package/es/src/charts/BubbleMatrix/colorDefaults.js +58 -0
  21. package/es/src/charts/BubbleMatrix/index.js +52 -0
  22. package/es/src/charts/Bullet/emit.js +3 -2
  23. package/es/src/charts/BumpChart/areaBump.js +175 -0
  24. package/es/src/charts/BumpChart/index.js +84 -18
  25. package/es/src/charts/Calendar/applyLayout.js +1 -1
  26. package/es/src/charts/Calendar/calendarDates.js +21 -7
  27. package/es/src/charts/Calendar/emit.js +3 -2
  28. package/es/src/charts/Calendar/index.js +16 -1
  29. package/es/src/charts/Candlestick/index.js +6 -11
  30. package/es/src/charts/Candlestick/periods.js +52 -29
  31. package/es/src/charts/Candlestick/tooltip.js +5 -7
  32. package/es/src/charts/Chord/emit.js +3 -2
  33. package/es/src/charts/ConnectedScatter/index.js +39 -0
  34. package/es/src/charts/CyclePlot/cycleFacet.js +162 -0
  35. package/es/src/charts/CyclePlot/cycleMeans.js +54 -0
  36. package/es/src/charts/CyclePlot/cyclePeriods.js +99 -0
  37. package/es/src/charts/CyclePlot/cycleTooltip.js +67 -0
  38. package/es/src/charts/CyclePlot/index.js +197 -0
  39. package/es/src/charts/DensityPlot/densityCurves.js +139 -0
  40. package/es/src/charts/DensityPlot/densityPoint.js +10 -0
  41. package/es/src/charts/DensityPlot/index.js +235 -0
  42. package/es/src/charts/DensityPlot/rug.js +144 -0
  43. package/es/src/charts/DotPlot/dotLayout.js +165 -0
  44. package/es/src/charts/DotPlot/facetSize.js +40 -0
  45. package/es/src/charts/DotPlot/index.js +173 -0
  46. package/es/src/charts/DotPlot/placements.js +121 -0
  47. package/es/src/charts/DotPlot/tooltip.js +68 -0
  48. package/es/src/charts/Dumbbell/arrowGrays.js +46 -0
  49. package/es/src/charts/Dumbbell/categoryChange.js +124 -0
  50. package/es/src/charts/Dumbbell/changeEmit.js +291 -0
  51. package/es/src/charts/Dumbbell/changes.js +87 -0
  52. package/es/src/charts/Dumbbell/connectors.js +46 -0
  53. package/es/src/charts/Dumbbell/emit.js +51 -50
  54. package/es/src/charts/Dumbbell/gapSort.js +2 -1
  55. package/es/src/charts/Dumbbell/index.js +121 -5
  56. package/es/src/charts/Funnel/emit.js +3 -2
  57. package/es/src/charts/Gantt/applyLayout.js +33 -13
  58. package/es/src/charts/Gantt/criticalPath.js +202 -0
  59. package/es/src/charts/Gantt/emit.js +49 -15
  60. package/es/src/charts/Gantt/ganttCalendar.js +54 -0
  61. package/es/src/charts/Gantt/ganttCritical.js +106 -0
  62. package/es/src/charts/Gantt/ganttDecor.js +183 -60
  63. package/es/src/charts/Gantt/ganttSlack.js +14 -0
  64. package/es/src/charts/Gantt/ganttTooltip.js +91 -36
  65. package/es/src/charts/Gantt/index.js +59 -10
  66. package/es/src/charts/Gauge/emit.js +3 -2
  67. package/es/src/charts/Geomap/applyLayout.js +177 -19
  68. package/es/src/charts/Geomap/cartogram.js +50 -0
  69. package/es/src/charts/Geomap/cartogramContiguous.js +196 -0
  70. package/es/src/charts/Geomap/cartogramFields.js +63 -0
  71. package/es/src/charts/Geomap/cartogramLabels.js +109 -0
  72. package/es/src/charts/Geomap/cartogramLayout.js +186 -0
  73. package/es/src/charts/Geomap/cartogramLegend.js +73 -0
  74. package/es/src/charts/Geomap/cartogramRelax.js +251 -0
  75. package/es/src/charts/Geomap/densityEmit.js +93 -0
  76. package/es/src/charts/Geomap/densityFields.js +69 -0
  77. package/es/src/charts/Geomap/densityLayout.js +90 -0
  78. package/es/src/charts/Geomap/densityTooltip.js +98 -0
  79. package/es/src/charts/Geomap/dotDensity.js +157 -0
  80. package/es/src/charts/Geomap/dotDensityLayout.js +116 -0
  81. package/es/src/charts/Geomap/dotRenderer.js +49 -0
  82. package/es/src/charts/Geomap/drillDown.js +216 -0
  83. package/es/src/charts/Geomap/drillEmit.js +64 -0
  84. package/es/src/charts/Geomap/drillEvents.js +108 -0
  85. package/es/src/charts/Geomap/emit.js +64 -42
  86. package/es/src/charts/Geomap/flowEmit.js +36 -15
  87. package/es/src/charts/Geomap/flowEvents.js +3 -1
  88. package/es/src/charts/Geomap/flowFields.js +2 -2
  89. package/es/src/charts/Geomap/flowLinks.js +18 -10
  90. package/es/src/charts/Geomap/geoHexbin.js +144 -0
  91. package/es/src/charts/Geomap/geoHexbinZoom.js +110 -0
  92. package/es/src/charts/Geomap/index.js +71 -116
  93. package/es/src/charts/Geomap/pointCluster.js +246 -0
  94. package/es/src/charts/Geomap/pointClusterEmit.js +385 -0
  95. package/es/src/charts/Geomap/pointClusterLayout.js +170 -0
  96. package/es/src/charts/Geomap/pointClusterLinks.js +95 -0
  97. package/es/src/charts/Geomap/pointClusterZoom.js +253 -0
  98. package/es/src/charts/Geomap/pointLabels.js +12 -4
  99. package/es/src/charts/Geomap/pointRows.js +25 -0
  100. package/es/src/charts/Geomap/tileGrid.js +468 -0
  101. package/es/src/charts/Geomap/tileState.js +41 -0
  102. package/es/src/charts/Geomap/topojsonFluent.js +96 -0
  103. package/es/src/charts/Geomap/topojsonLevels.js +16 -0
  104. package/es/src/charts/Hexbin/contourLabels.js +25 -17
  105. package/es/src/charts/Hexbin/index.js +4 -1
  106. package/es/src/charts/Histogram/binData.js +5 -1
  107. package/es/src/charts/Histogram/index.js +4 -26
  108. package/es/src/charts/HorizonChart/emit.js +147 -0
  109. package/es/src/charts/HorizonChart/horizonBands.js +117 -0
  110. package/es/src/charts/HorizonChart/horizonColors.js +30 -0
  111. package/es/src/charts/HorizonChart/hover.js +147 -0
  112. package/es/src/charts/HorizonChart/index.js +220 -0
  113. package/es/src/charts/HorizonChart/measure.js +91 -0
  114. package/es/src/charts/HorizonChart/rowFilter.js +250 -0
  115. package/es/src/charts/HorizonChart/state.js +64 -0
  116. package/es/src/charts/Icicle/emit.js +3 -2
  117. package/es/src/charts/Icicle/index.js +3 -1
  118. package/es/src/charts/KPI/applyLayout.js +119 -0
  119. package/es/src/charts/KPI/delta.js +74 -0
  120. package/es/src/charts/KPI/emit.js +303 -0
  121. package/es/src/charts/KPI/index.js +192 -0
  122. package/es/src/charts/KPI/series.js +67 -0
  123. package/es/src/charts/KPI/tileLayout.js +134 -0
  124. package/es/src/charts/Lollipop/emit.js +2 -1
  125. package/es/src/charts/Marimekko/index.js +2 -1
  126. package/es/src/charts/Matrix/applyLayout.js +29 -12
  127. package/es/src/charts/Matrix/bubbles.js +133 -0
  128. package/es/src/charts/Matrix/emit.js +68 -25
  129. package/es/src/charts/Matrix/index.js +64 -5
  130. package/es/src/charts/Network/applyLayout.js +206 -84
  131. package/es/src/charts/Network/bundle.js +29 -8
  132. package/es/src/charts/Network/circleLayout.js +281 -0
  133. package/es/src/charts/Network/containNodes.js +72 -0
  134. package/es/src/charts/Network/emit.js +109 -50
  135. package/es/src/charts/Network/forceLayout.js +111 -0
  136. package/es/src/charts/Network/graph.js +76 -8
  137. package/es/src/charts/Network/graphFluent.js +5 -3
  138. package/es/src/charts/Network/index.js +117 -3
  139. package/es/src/charts/Network/liveForce.js +312 -0
  140. package/es/src/charts/Network/livePositions.js +180 -0
  141. package/es/src/charts/Network/networkDrag.js +156 -0
  142. package/es/src/charts/Pack/applyLayout.js +16 -5
  143. package/es/src/charts/Pack/emit.js +18 -10
  144. package/es/src/charts/Pack/groupRows.js +61 -0
  145. package/es/src/charts/Pack/index.js +3 -14
  146. package/es/src/charts/Pack/neutralPaint.js +20 -0
  147. package/es/src/charts/Pack/nodeNames.js +35 -0
  148. package/es/src/charts/ParallelCoordinates/axes.js +22 -22
  149. package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
  150. package/es/src/charts/ParallelCoordinates/emit.js +3 -2
  151. package/es/src/charts/ParallelCoordinates/index.js +3 -1
  152. package/es/src/charts/ParallelCoordinates/titles.js +17 -9
  153. package/es/src/charts/Pareto/color.js +46 -0
  154. package/es/src/charts/Pareto/hover.js +54 -0
  155. package/es/src/charts/Pareto/index.js +170 -0
  156. package/es/src/charts/Pareto/labels.js +91 -0
  157. package/es/src/charts/Pareto/order.js +61 -0
  158. package/es/src/charts/Pareto/paretoSteps.js +84 -0
  159. package/es/src/charts/Pareto/state.js +158 -0
  160. package/es/src/charts/Parliament/index.js +68 -0
  161. package/es/src/charts/Pie/emit.js +12 -3
  162. package/es/src/charts/Pie/index.js +10 -0
  163. package/es/src/charts/Plot/areaEnter.js +70 -0
  164. package/es/src/charts/Plot/areaLabelsAlong.js +10 -2
  165. package/es/src/charts/Plot/aspectRatio.js +92 -0
  166. package/es/src/charts/Plot/axisHover.js +4 -2
  167. package/es/src/charts/Plot/axisHoverAnchors.js +2 -1
  168. package/es/src/charts/Plot/axisHoverScene.js +138 -5
  169. package/es/src/charts/Plot/barConfidence.js +7 -6
  170. package/es/src/charts/Plot/barHitArea.js +121 -7
  171. package/es/src/charts/Plot/barLabelConfidence.js +50 -0
  172. package/es/src/charts/Plot/barLabelFit.js +2 -1
  173. package/es/src/charts/Plot/barWidth.js +10 -5
  174. package/es/src/charts/Plot/baselineBreak.js +15 -6
  175. package/es/src/charts/Plot/baselineDomain.js +13 -4
  176. package/es/src/charts/Plot/circleLabels.js +26 -16
  177. package/es/src/charts/Plot/confidenceAxes.js +100 -0
  178. package/es/src/charts/Plot/confidenceConfig.js +7 -2
  179. package/es/src/charts/Plot/confidenceTooltip.js +47 -4
  180. package/es/src/charts/Plot/connectGapsScene.js +2 -1
  181. package/es/src/charts/Plot/discreteDomain.js +27 -5
  182. package/es/src/charts/Plot/discreteSpan.js +10 -1
  183. package/es/src/charts/Plot/domainClip.js +74 -44
  184. package/es/src/charts/Plot/downsample.js +26 -0
  185. package/es/src/charts/Plot/draw.js +41 -14
  186. package/es/src/charts/Plot/fillBetween.js +2 -1
  187. package/es/src/charts/Plot/forecast.js +8 -4
  188. package/es/src/charts/Plot/forecastScene.js +6 -5
  189. package/es/src/charts/Plot/index.js +52 -27
  190. package/es/src/charts/Plot/inferDiscrete.js +72 -0
  191. package/es/src/charts/Plot/jitter.js +50 -0
  192. package/es/src/charts/Plot/labelPlacement.js +4 -3
  193. package/es/src/charts/Plot/lineBands.js +6 -1
  194. package/es/src/charts/Plot/lineLabelEmit.js +4 -3
  195. package/es/src/charts/Plot/lineLabelSides.js +8 -0
  196. package/es/src/charts/Plot/lineLabelsAlong.js +45 -31
  197. package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
  198. package/es/src/charts/Plot/marginalHover.js +141 -0
  199. package/es/src/charts/Plot/marginalLayout.js +102 -0
  200. package/es/src/charts/Plot/marginalPaint.js +105 -0
  201. package/es/src/charts/Plot/marginalScene.js +272 -0
  202. package/es/src/charts/Plot/marginalSeries.js +73 -0
  203. package/es/src/charts/Plot/marginalStats.js +219 -0
  204. package/es/src/charts/Plot/openDomainEnds.js +60 -0
  205. package/es/src/charts/Plot/orderPath.js +137 -0
  206. package/es/src/charts/Plot/orderPathScene.js +253 -0
  207. package/es/src/charts/Plot/outlierDetect.js +179 -0
  208. package/es/src/charts/Plot/outlierLabels.js +327 -0
  209. package/es/src/charts/Plot/outlierLines.js +93 -0
  210. package/es/src/charts/Plot/outlierScene.js +308 -0
  211. package/es/src/charts/Plot/outlierTooltip.js +69 -0
  212. package/es/src/charts/Plot/periodLabels.js +27 -0
  213. package/es/src/charts/Plot/pipeline.js +62 -24
  214. package/es/src/charts/Plot/pipelineAxisLayout.js +9 -7
  215. package/es/src/charts/Plot/pipelineDomains.js +64 -27
  216. package/es/src/charts/Plot/pipelineScales.js +37 -28
  217. package/es/src/charts/Plot/plotBreaks.js +38 -18
  218. package/es/src/charts/Plot/plotFacet.js +3 -1
  219. package/es/src/charts/Plot/plotInit.js +65 -3
  220. package/es/src/charts/Plot/plotLevels.js +183 -0
  221. package/es/src/charts/Plot/plotRangeBreaks.js +46 -9
  222. package/es/src/charts/Plot/plotShapes.js +60 -0
  223. package/es/src/charts/Plot/pointConfidence.js +186 -0
  224. package/es/src/charts/Plot/pointKey.js +10 -0
  225. package/es/src/charts/Plot/referenceDomains.js +11 -6
  226. package/es/src/charts/Plot/shapeAccessors.js +52 -0
  227. package/es/src/charts/Plot/shapeDefaults.js +32 -17
  228. package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
  229. package/es/src/charts/Plot/sharedHover.js +42 -13
  230. package/es/src/charts/Plot/sharedHoverScene.js +49 -13
  231. package/es/src/charts/Plot/sharedTooltip.js +68 -25
  232. package/es/src/charts/Plot/stackEnter.js +7 -3
  233. package/es/src/charts/Plot/stackLegendOrder.js +5 -2
  234. package/es/src/charts/Plot/stackNeutral.js +154 -0
  235. package/es/src/charts/Plot/stackShareTooltip.js +2 -1
  236. package/es/src/charts/Plot/stackThreshold.js +2 -1
  237. package/es/src/charts/Plot/swarm.js +8 -5
  238. package/es/src/charts/Plot/timeNestKeys.js +37 -0
  239. package/es/src/charts/Plot/trendLabels.js +45 -18
  240. package/es/src/charts/Plot/trendLines.js +78 -34
  241. package/es/src/charts/Plot/trendMovingAverage.js +135 -0
  242. package/es/src/charts/Plot/trendProjection.js +18 -6
  243. package/es/src/charts/Plot/trendScene.js +4 -1
  244. package/es/src/charts/Plot/trendTooltip.js +75 -20
  245. package/es/src/charts/PolarArea/emit.js +3 -2
  246. package/es/src/charts/PolarArea/index.js +2 -1
  247. package/es/src/charts/Priestley/applyLayout.js +20 -12
  248. package/es/src/charts/Priestley/emit.js +3 -2
  249. package/es/src/charts/Priestley/index.js +0 -2
  250. package/es/src/charts/Priestley/timeAxis.js +24 -13
  251. package/es/src/charts/Pyramid/gutter.js +52 -16
  252. package/es/src/charts/Pyramid/index.js +55 -7
  253. package/es/src/charts/Pyramid/scene.js +4 -4
  254. package/es/src/charts/Radar/applyLayout.js +31 -33
  255. package/es/src/charts/Radar/axisDecorations.js +29 -17
  256. package/es/src/charts/Radar/curvedLabels.js +43 -2
  257. package/es/src/charts/Radar/emit.js +33 -17
  258. package/es/src/charts/Radar/index.js +41 -2
  259. package/es/src/charts/Radar/points.js +85 -0
  260. package/es/src/charts/RadialArea/index.js +51 -0
  261. package/es/src/charts/RadialBar/emit.js +9 -3
  262. package/es/src/charts/RadialBar/index.js +10 -0
  263. package/es/src/charts/RadialLine/angles.js +117 -0
  264. package/es/src/charts/RadialLine/applyLayout.js +204 -0
  265. package/es/src/charts/RadialLine/emit.js +66 -0
  266. package/es/src/charts/RadialLine/index.js +228 -0
  267. package/es/src/charts/RadialLine/paths.js +55 -0
  268. package/es/src/charts/RadialLine/points.js +80 -0
  269. package/es/src/charts/RadialLine/series.js +84 -0
  270. package/es/src/charts/RadialLine/seriesLabelNodes.js +116 -0
  271. package/es/src/charts/RadialLine/seriesLabels.js +91 -0
  272. package/es/src/charts/RadialLine/spokes.js +32 -0
  273. package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
  274. package/es/src/charts/RadialMatrix/emit.js +3 -2
  275. package/es/src/charts/RadialMatrix/index.js +15 -2
  276. package/es/src/charts/RadialTree/index.js +33 -0
  277. package/es/src/charts/Rings/applyLayout.js +28 -151
  278. package/es/src/charts/Rings/emit.js +120 -60
  279. package/es/src/charts/Rings/index.js +28 -5
  280. package/es/src/charts/Rings/ringsCurves.js +158 -0
  281. package/es/src/charts/Rings/ringsLoops.js +4 -2
  282. package/es/src/charts/Rings/ringsParallel.js +20 -3
  283. package/es/src/charts/Rings/ringsPlacement.js +152 -0
  284. package/es/src/charts/Rings/ringsSizing.js +82 -51
  285. package/es/src/charts/Sankey/applyLayout.js +22 -4
  286. package/es/src/charts/Sankey/circularLayout.js +14 -6
  287. package/es/src/charts/Sankey/emit.js +3 -2
  288. package/es/src/charts/Sankey/index.js +50 -1
  289. package/es/src/charts/Sankey/sankeyDrag.js +225 -0
  290. package/es/src/charts/Sankey/sankeyLayout.js +12 -0
  291. package/es/src/charts/Scatter/index.js +3 -2
  292. package/es/src/charts/ScatterMatrix/binEmit.js +59 -0
  293. package/es/src/charts/ScatterMatrix/index.js +253 -0
  294. package/es/src/charts/ScatterMatrix/matrixData.js +161 -0
  295. package/es/src/charts/ScatterMatrix/matrixFacet.js +76 -0
  296. package/es/src/charts/ScatterMatrix/matrixHover.js +36 -0
  297. package/es/src/charts/ScatterMatrix/matrixTooltip.js +45 -0
  298. package/es/src/charts/StripPlot/index.js +53 -0
  299. package/es/src/charts/Sunburst/emit.js +12 -3
  300. package/es/src/charts/Sunburst/index.js +13 -1
  301. package/es/src/charts/TileGridMap/index.js +29 -0
  302. package/es/src/charts/Tree/applyLayout.js +135 -32
  303. package/es/src/charts/Tree/emit.js +61 -8
  304. package/es/src/charts/Tree/index.js +34 -15
  305. package/es/src/charts/Tree/keys.js +33 -0
  306. package/es/src/charts/Tree/nodeHeight.js +58 -0
  307. package/es/src/charts/Tree/nodeLabel.js +15 -0
  308. package/es/src/charts/Tree/radialLabels.js +61 -0
  309. package/es/src/charts/Tree/radialLayout.js +210 -0
  310. package/es/src/charts/Treemap/emit.js +3 -2
  311. package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
  312. package/es/src/charts/Venn/applyLayout.js +176 -0
  313. package/es/src/charts/Venn/circles.js +192 -0
  314. package/es/src/charts/Venn/ellipseFrame.js +57 -0
  315. package/es/src/charts/Venn/emit.js +142 -0
  316. package/es/src/charts/Venn/index.js +178 -0
  317. package/es/src/charts/Venn/nelderMead.js +59 -0
  318. package/es/src/charts/Venn/tooltip.js +22 -0
  319. package/es/src/charts/Venn/vennData.js +99 -0
  320. package/es/src/charts/Venn/vennEllipses.js +291 -0
  321. package/es/src/charts/Venn/vennFit.js +169 -0
  322. package/es/src/charts/Venn/vennLayout.js +252 -0
  323. package/es/src/charts/Venn/vennRegions.js +133 -0
  324. package/es/src/charts/Violin/emit.js +2 -1
  325. package/es/src/charts/Violin/index.js +2 -1
  326. package/es/src/charts/Waffle/applyLayout.js +45 -22
  327. package/es/src/charts/Waffle/arcEmit.js +153 -0
  328. package/es/src/charts/Waffle/arcLayout.js +122 -0
  329. package/es/src/charts/Waffle/arcStage.js +79 -0
  330. package/es/src/charts/Waffle/emit.js +9 -4
  331. package/es/src/charts/Waffle/index.js +88 -4
  332. package/es/src/charts/Waffle/tooltip.js +7 -2
  333. package/es/src/charts/Waterfall/connectors.js +5 -3
  334. package/es/src/charts/Waterfall/state.js +2 -1
  335. package/es/src/charts/WordCloud/applyLayout.js +157 -0
  336. package/es/src/charts/WordCloud/cloudLayout.js +128 -0
  337. package/es/src/charts/WordCloud/emit.js +96 -0
  338. package/es/src/charts/WordCloud/fontScale.js +34 -0
  339. package/es/src/charts/WordCloud/glyphMask.js +298 -0
  340. package/es/src/charts/WordCloud/index.js +174 -0
  341. package/es/src/charts/WordCloud/occupancy.js +99 -0
  342. package/es/src/charts/WordCloud/rotation.js +44 -0
  343. package/es/src/charts/WordCloud/size.js +15 -0
  344. package/es/src/charts/WordCloud/spiral.js +72 -0
  345. package/es/src/charts/definition/applyDefinition.js +6 -1
  346. package/es/src/charts/definition/declaresField.js +14 -0
  347. package/es/src/charts/definition/makeChart.js +15 -3
  348. package/es/src/charts/drawSteps/bottomRightControls.js +1 -1
  349. package/es/src/charts/drawSteps/bottomRightControlsMarkup.js +1 -1
  350. package/es/src/charts/drawSteps/gestureHover.js +10 -6
  351. package/es/src/charts/drawSteps/leavesSurface.js +12 -0
  352. package/es/src/charts/drawSteps/minimap.js +5 -21
  353. package/es/src/charts/drawSteps/selectActions.js +105 -0
  354. package/es/src/charts/drawSteps/selectGesture.js +318 -0
  355. package/es/src/charts/drawSteps/selectRegion.js +222 -0
  356. package/es/src/charts/drawSteps/selectState.js +118 -0
  357. package/es/src/charts/drawSteps/topLeftControls.js +4 -1
  358. package/es/src/charts/drawSteps/zoomActions.js +36 -0
  359. package/es/src/charts/drawSteps/zoomControls.js +90 -37
  360. package/es/src/charts/drawSteps/zoomControlsMarkup.js +228 -36
  361. package/es/src/charts/drawSteps/zoomControlsMenu.js +140 -0
  362. package/es/src/charts/drawSteps/zoomDrag.js +190 -0
  363. package/es/src/charts/drawSteps/zoomFit.js +69 -0
  364. package/es/src/charts/events/click.legend.js +4 -2
  365. package/es/src/charts/events/click.shape.js +5 -3
  366. package/es/src/charts/events/mouseenter.js +6 -16
  367. package/es/src/charts/events/mouseleave.js +15 -5
  368. package/es/src/charts/events/mousemove.legend.js +35 -34
  369. package/es/src/charts/events/mousemove.shape.js +53 -44
  370. package/es/src/charts/facet/drawFacets.js +61 -22
  371. package/es/src/charts/facet/facetConfig.js +3 -1
  372. package/es/src/charts/facet/facetData.js +10 -2
  373. package/es/src/charts/facet/facetGrid.js +5 -1
  374. package/es/src/charts/facet/facetGutter.js +36 -7
  375. package/es/src/charts/facet/facetLayout.js +136 -0
  376. package/es/src/charts/facet/facetLayouts.js +574 -0
  377. package/es/src/charts/facet/facetScene.js +10 -3
  378. package/es/src/charts/features/annotationFrame.js +8 -3
  379. package/es/src/charts/features/axes.js +19 -6
  380. package/es/src/charts/features/axesFinal.js +99 -10
  381. package/es/src/charts/features/axesMeasure.js +31 -10
  382. package/es/src/charts/features/axisTooltip.js +138 -0
  383. package/es/src/charts/features/bareRegion.js +24 -0
  384. package/es/src/charts/features/boxGrid.js +39 -0
  385. package/es/src/charts/features/centerLabel.js +196 -0
  386. package/es/src/charts/features/circleLabelPlacement.js +288 -83
  387. package/es/src/charts/features/circleLabels.js +66 -14
  388. package/es/src/charts/features/colorScaleBivariate.js +83 -0
  389. package/es/src/charts/features/colorScaleBucket.js +18 -0
  390. package/es/src/charts/features/colorScaleHover.js +35 -5
  391. package/es/src/charts/features/colorScaleLimit.js +73 -0
  392. package/es/src/charts/features/colorScaleTooltip.js +62 -0
  393. package/es/src/charts/features/colorScaleTop.js +71 -0
  394. package/es/src/charts/features/colorScaleValue.js +10 -1
  395. package/es/src/charts/features/curvedArrows.js +74 -23
  396. package/es/src/charts/features/depthKey.js +26 -0
  397. package/es/src/charts/features/edgeArrows.js +107 -18
  398. package/es/src/charts/features/emitHelpers.js +7 -2
  399. package/es/src/charts/features/features.js +25 -5
  400. package/es/src/charts/features/featuresColorScale.js +64 -20
  401. package/es/src/charts/features/featuresLegend.js +20 -0
  402. package/es/src/charts/features/hoverTicks.js +46 -0
  403. package/es/src/charts/features/idleQueue.js +72 -0
  404. package/es/src/charts/features/keyHold.js +115 -0
  405. package/es/src/charts/features/keyTooltip.js +91 -0
  406. package/es/src/charts/features/labelLayering.js +149 -0
  407. package/es/src/charts/features/labelSlots.js +112 -0
  408. package/es/src/charts/features/linkInteraction.js +62 -7
  409. package/es/src/charts/features/linkLabelPath.js +2 -39
  410. package/es/src/charts/features/networkMeasures.js +241 -0
  411. package/es/src/charts/features/nodeDrag.js +175 -0
  412. package/es/src/charts/features/nodeKeys.js +117 -0
  413. package/es/src/charts/features/nodeOutline.js +41 -0
  414. package/es/src/charts/features/nodeStats.js +309 -0
  415. package/es/src/charts/features/pathLabelBends.js +191 -0
  416. package/es/src/charts/features/plotAnnotations.js +8 -5
  417. package/es/src/charts/features/plotEndLabels.js +28 -7
  418. package/es/src/charts/features/plotPaint.js +52 -13
  419. package/es/src/charts/features/rectNodeSize.js +41 -0
  420. package/es/src/charts/features/ringLabels.js +3 -1
  421. package/es/src/charts/features/selfLoops.js +33 -23
  422. package/es/src/charts/features/shapeEmit.js +110 -32
  423. package/es/src/charts/features/sharedFields.js +10 -5
  424. package/es/src/charts/features/spokeLabels.js +178 -0
  425. package/es/src/charts/features/swatchPaint.js +68 -0
  426. package/es/src/charts/features/textHalo.js +3 -2
  427. package/es/src/charts/features/thresholdMembers.js +8 -12
  428. package/es/src/charts/features/tooltipRows.js +76 -0
  429. package/es/src/charts/features/tooltipSwatch.js +81 -24
  430. package/es/src/charts/features/xAxisConfig.js +2 -1
  431. package/es/src/charts/helpers/densityChart.js +2 -7
  432. package/es/src/charts/helpers/valueTitle.js +13 -1
  433. package/es/src/charts/index.js +17 -0
  434. package/es/src/charts/partition/chartFields.js +12 -3
  435. package/es/src/charts/partition/interaction.js +10 -5
  436. package/es/src/charts/pipeline/insetPlacement.js +19 -7
  437. package/es/src/charts/pipeline/preDrawData.js +80 -11
  438. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  439. package/es/src/charts/pipeline/stages.js +3 -2
  440. package/es/src/charts/pipeline/vizPreDraw.js +4 -0
  441. package/es/src/charts/plotBuffers/Circle.js +3 -2
  442. package/es/src/charts/plotBuffers/Line.js +6 -5
  443. package/es/src/charts/plotBuffers/Rect.js +3 -2
  444. package/es/src/charts/plotBuffers/Tick.js +12 -0
  445. package/es/src/charts/plotBuffers/defaultBuffers.js +3 -1
  446. package/es/src/charts/plotBuffers/rectLikeBuffer.js +4 -3
  447. package/es/src/charts/polar/chrome.js +81 -9
  448. package/es/src/charts/polar/config.js +4 -0
  449. package/es/src/charts/polar/wedgeLayout.js +2 -1
  450. package/es/src/charts/viz/Viz.js +56 -33
  451. package/es/src/charts/viz/VizBase.js +78 -42
  452. package/es/src/charts/viz/appendRows.js +90 -0
  453. package/es/src/charts/viz/backgroundInk.js +10 -0
  454. package/es/src/charts/viz/dataChanged.js +19 -0
  455. package/es/src/charts/viz/discrete.js +9 -0
  456. package/es/src/charts/viz/emphasis.js +14 -0
  457. package/es/src/charts/viz/fillStroke.js +10 -0
  458. package/es/src/charts/viz/focusTargets.js +25 -5
  459. package/es/src/charts/viz/groupByLevels.js +48 -0
  460. package/es/src/charts/viz/groupRow.js +27 -0
  461. package/es/src/charts/viz/hoverBand.js +40 -0
  462. package/es/src/charts/viz/interactionOpacity.js +240 -52
  463. package/es/src/charts/viz/keyboardNav.js +39 -9
  464. package/es/src/charts/viz/liftRaised.js +84 -0
  465. package/es/src/charts/viz/nearestHover.js +9 -2
  466. package/es/src/charts/viz/reportDrawError.js +15 -0
  467. package/es/src/charts/viz/setCursor.js +41 -0
  468. package/es/src/charts/viz/simpleHover.js +3 -4
  469. package/es/src/charts/viz/tooltipEnabled.js +38 -0
  470. package/es/src/charts/viz/userClick.js +45 -0
  471. package/es/src/charts/viz/vizDataPolling.js +0 -1
  472. package/es/src/charts/viz/vizDefaults.js +23 -34
  473. package/es/src/charts/viz/vizFields.js +13 -1
  474. package/es/src/charts/viz/vizRender.js +35 -5
  475. package/es/src/charts/viz/vizTypes.js +1 -1
  476. package/es/src/charts/viz/vizVisibility.js +12 -2
  477. package/es/src/components/Axis/Axis.js +114 -14
  478. package/es/src/components/Axis/AxisBottom.js +1 -0
  479. package/es/src/components/Axis/AxisLeft.js +1 -0
  480. package/es/src/components/Axis/AxisRight.js +1 -0
  481. package/es/src/components/Axis/AxisTop.js +1 -0
  482. package/es/src/components/Axis/axisBreak.js +29 -7
  483. package/es/src/components/Axis/axisDefaults.js +18 -0
  484. package/es/src/components/Axis/axisEndLabels.js +4 -1
  485. package/es/src/components/Axis/axisLabelKinds.js +36 -0
  486. package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
  487. package/es/src/components/Axis/axisLabelRoom.js +37 -0
  488. package/es/src/components/Axis/axisLabelSize.js +195 -0
  489. package/es/src/components/Axis/axisLabelThinning.js +167 -10
  490. package/es/src/components/Axis/axisLayout.js +76 -46
  491. package/es/src/components/Axis/axisLayoutLabels.js +93 -145
  492. package/es/src/components/Axis/axisLayoutScale.js +79 -34
  493. package/es/src/components/Axis/axisLevels.js +271 -0
  494. package/es/src/components/Axis/axisLimit.js +33 -0
  495. package/es/src/components/Axis/axisMaxSize.js +39 -0
  496. package/es/src/components/Axis/axisMinorTicks.js +280 -0
  497. package/es/src/components/Axis/axisPeriods.js +144 -0
  498. package/es/src/components/Axis/axisRangeBreaks.js +19 -10
  499. package/es/src/components/Axis/axisRender.js +90 -36
  500. package/es/src/components/Axis/axisRounding.js +38 -1
  501. package/es/src/components/Axis/axisScaleType.js +55 -0
  502. package/es/src/components/Axis/axisScene.js +100 -6
  503. package/es/src/components/Axis/axisTickLookups.js +30 -0
  504. package/es/src/components/Axis/axisTitle.js +53 -0
  505. package/es/src/components/Axis/axisTooltipTargets.js +151 -0
  506. package/es/src/components/Axis/labelSizeSession.js +23 -0
  507. package/es/src/components/Axis/rangeBreaks.js +10 -4
  508. package/es/src/components/Axis/timeValues.js +116 -19
  509. package/es/src/components/ColorScale/ColorScale.js +63 -18
  510. package/es/src/components/ColorScale/bivariateRender.js +353 -0
  511. package/es/src/components/ColorScale/bivariateScale.js +150 -0
  512. package/es/src/components/ColorScale/colorScaleRender.js +32 -2
  513. package/es/src/components/ColorScale/colorScaleScale.js +139 -41
  514. package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
  515. package/es/src/components/Legend/Legend.js +11 -2
  516. package/es/src/components/Legend/legendCut.js +108 -0
  517. package/es/src/components/Legend/legendRender.js +38 -13
  518. package/es/src/components/SizeLegend/SizeLegend.js +20 -1
  519. package/es/src/components/TextBox.js +6 -2
  520. package/es/src/components/Timeline/Timeline.js +11 -3
  521. package/es/src/components/Timeline/timelineRender.js +25 -14
  522. package/es/src/components/Tooltip.js +8 -1
  523. package/es/src/components/textBoxScene.js +3 -0
  524. package/es/src/components/textEllipsis.js +7 -0
  525. package/es/src/components/tooltipDom.js +80 -18
  526. package/es/src/fluent.js +124 -9
  527. package/es/src/shapes/Area.js +32 -1
  528. package/es/src/shapes/Bar.js +22 -1
  529. package/es/src/shapes/Box.js +72 -13
  530. package/es/src/shapes/Circle.js +1 -0
  531. package/es/src/shapes/Image.js +8 -1
  532. package/es/src/shapes/Line.js +45 -1
  533. package/es/src/shapes/Path.js +1 -0
  534. package/es/src/shapes/Rect.js +1 -0
  535. package/es/src/shapes/Shape.js +29 -8
  536. package/es/src/shapes/Tick.js +54 -0
  537. package/es/src/shapes/Whisker.js +1 -0
  538. package/es/src/shapes/boxExtraShapes.js +72 -0
  539. package/es/src/shapes/boxExtras.js +212 -0
  540. package/es/src/shapes/boxStyle.js +38 -5
  541. package/es/src/shapes/buildLabelData.js +2 -0
  542. package/es/src/shapes/downsample.js +150 -0
  543. package/es/src/shapes/hitAreaNode.js +6 -2
  544. package/es/src/shapes/index.js +1 -0
  545. package/es/src/shapes/pathSeries.js +51 -0
  546. package/es/src/utils/BaseClass.js +59 -52
  547. package/es/src/utils/configValue.js +9 -0
  548. package/es/src/utils/jitter.js +33 -0
  549. package/es/src/utils/resetSetters.js +66 -0
  550. package/package.json +10 -10
  551. package/types/index.d.ts +5 -4
  552. package/types/internal.d.ts +272 -29
  553. package/types/src/charts/Alluvial/titles.d.ts +16 -3
  554. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +7 -3
  555. package/types/src/charts/ArcDiagram/arcLoops.d.ts +3 -1
  556. package/types/src/charts/ArcDiagram/arcNodeBox.d.ts +60 -0
  557. package/types/src/charts/ArcDiagram/emit.d.ts +6 -4
  558. package/types/src/charts/ArcDiagram/events.d.ts +2 -1
  559. package/types/src/charts/BoxWhisker/extras.d.ts +41 -0
  560. package/types/src/charts/BoxWhisker/summary.d.ts +1 -1
  561. package/types/src/charts/BoxWhisker/tooltip.d.ts +33 -4
  562. package/types/src/charts/BubbleChart/emit.d.ts +3 -3
  563. package/types/src/charts/BubbleMatrix/colorDefaults.d.ts +19 -0
  564. package/types/src/charts/BubbleMatrix/index.d.ts +18 -0
  565. package/types/src/charts/BumpChart/areaBump.d.ts +86 -0
  566. package/types/src/charts/BumpChart/index.d.ts +19 -1
  567. package/types/src/charts/Calendar/calendarDates.d.ts +8 -1
  568. package/types/src/charts/Candlestick/periods.d.ts +19 -8
  569. package/types/src/charts/ConnectedScatter/index.d.ts +17 -0
  570. package/types/src/charts/CyclePlot/cycleFacet.d.ts +61 -0
  571. package/types/src/charts/CyclePlot/cycleMeans.d.ts +32 -0
  572. package/types/src/charts/CyclePlot/cyclePeriods.d.ts +37 -0
  573. package/types/src/charts/CyclePlot/cycleTooltip.d.ts +47 -0
  574. package/types/src/charts/CyclePlot/index.d.ts +75 -0
  575. package/types/src/charts/DensityPlot/densityCurves.d.ts +84 -0
  576. package/types/src/charts/DensityPlot/densityPoint.d.ts +16 -0
  577. package/types/src/charts/DensityPlot/index.d.ts +33 -0
  578. package/types/src/charts/DensityPlot/rug.d.ts +57 -0
  579. package/types/src/charts/DotPlot/dotLayout.d.ts +95 -0
  580. package/types/src/charts/DotPlot/facetSize.d.ts +33 -0
  581. package/types/src/charts/DotPlot/index.d.ts +22 -0
  582. package/types/src/charts/DotPlot/placements.d.ts +28 -0
  583. package/types/src/charts/DotPlot/tooltip.d.ts +27 -0
  584. package/types/src/charts/Dumbbell/arrowGrays.d.ts +33 -0
  585. package/types/src/charts/Dumbbell/categoryChange.d.ts +66 -0
  586. package/types/src/charts/Dumbbell/changeEmit.d.ts +71 -0
  587. package/types/src/charts/Dumbbell/changes.d.ts +64 -0
  588. package/types/src/charts/Dumbbell/connectors.d.ts +43 -0
  589. package/types/src/charts/Dumbbell/emit.d.ts +17 -19
  590. package/types/src/charts/Dumbbell/index.d.ts +6 -2
  591. package/types/src/charts/Gantt/applyLayout.d.ts +14 -1
  592. package/types/src/charts/Gantt/criticalPath.d.ts +100 -0
  593. package/types/src/charts/Gantt/emit.d.ts +17 -1
  594. package/types/src/charts/Gantt/ganttCalendar.d.ts +37 -0
  595. package/types/src/charts/Gantt/ganttCritical.d.ts +53 -0
  596. package/types/src/charts/Gantt/ganttDecor.d.ts +32 -2
  597. package/types/src/charts/Gantt/ganttRows.d.ts +2 -0
  598. package/types/src/charts/Gantt/ganttSlack.d.ts +21 -0
  599. package/types/src/charts/Gantt/ganttTooltip.d.ts +35 -15
  600. package/types/src/charts/Gantt/index.d.ts +12 -6
  601. package/types/src/charts/Geomap/applyLayout.d.ts +19 -0
  602. package/types/src/charts/Geomap/cartogram.d.ts +58 -0
  603. package/types/src/charts/Geomap/cartogramContiguous.d.ts +59 -0
  604. package/types/src/charts/Geomap/cartogramFields.d.ts +16 -0
  605. package/types/src/charts/Geomap/cartogramLabels.d.ts +48 -0
  606. package/types/src/charts/Geomap/cartogramLayout.d.ts +71 -0
  607. package/types/src/charts/Geomap/cartogramLegend.d.ts +36 -0
  608. package/types/src/charts/Geomap/cartogramRelax.d.ts +29 -0
  609. package/types/src/charts/Geomap/densityEmit.d.ts +29 -0
  610. package/types/src/charts/Geomap/densityFields.d.ts +27 -0
  611. package/types/src/charts/Geomap/densityLayout.d.ts +49 -0
  612. package/types/src/charts/Geomap/densityTooltip.d.ts +48 -0
  613. package/types/src/charts/Geomap/dotDensity.d.ts +80 -0
  614. package/types/src/charts/Geomap/dotDensityLayout.d.ts +97 -0
  615. package/types/src/charts/Geomap/dotRenderer.d.ts +27 -0
  616. package/types/src/charts/Geomap/drillDown.d.ts +128 -0
  617. package/types/src/charts/Geomap/drillEmit.d.ts +37 -0
  618. package/types/src/charts/Geomap/drillEvents.d.ts +33 -0
  619. package/types/src/charts/Geomap/emit.d.ts +7 -0
  620. package/types/src/charts/Geomap/flowEmit.d.ts +6 -4
  621. package/types/src/charts/Geomap/flowLinks.d.ts +12 -1
  622. package/types/src/charts/Geomap/geoHexbin.d.ts +91 -0
  623. package/types/src/charts/Geomap/geoHexbinZoom.d.ts +76 -0
  624. package/types/src/charts/Geomap/index.d.ts +7 -0
  625. package/types/src/charts/Geomap/pointCluster.d.ts +108 -0
  626. package/types/src/charts/Geomap/pointClusterEmit.d.ts +106 -0
  627. package/types/src/charts/Geomap/pointClusterLayout.d.ts +123 -0
  628. package/types/src/charts/Geomap/pointClusterLinks.d.ts +21 -0
  629. package/types/src/charts/Geomap/pointClusterZoom.d.ts +89 -0
  630. package/types/src/charts/Geomap/pointLabels.d.ts +21 -3
  631. package/types/src/charts/Geomap/pointRows.d.ts +24 -0
  632. package/types/src/charts/Geomap/tileGrid.d.ts +98 -0
  633. package/types/src/charts/Geomap/tileState.d.ts +18 -0
  634. package/types/src/charts/Geomap/topojsonFluent.d.ts +9 -0
  635. package/types/src/charts/Geomap/topojsonLevels.d.ts +14 -0
  636. package/types/src/charts/Hexbin/contourLabels.d.ts +6 -5
  637. package/types/src/charts/Hexbin/settings.d.ts +7 -1
  638. package/types/src/charts/Histogram/binData.d.ts +6 -0
  639. package/types/src/charts/HorizonChart/emit.d.ts +20 -0
  640. package/types/src/charts/HorizonChart/horizonBands.d.ts +42 -0
  641. package/types/src/charts/HorizonChart/horizonColors.d.ts +25 -0
  642. package/types/src/charts/HorizonChart/hover.d.ts +52 -0
  643. package/types/src/charts/HorizonChart/index.d.ts +32 -0
  644. package/types/src/charts/HorizonChart/measure.d.ts +24 -0
  645. package/types/src/charts/HorizonChart/rowFilter.d.ts +88 -0
  646. package/types/src/charts/HorizonChart/state.d.ts +71 -0
  647. package/types/src/charts/KPI/applyLayout.d.ts +64 -0
  648. package/types/src/charts/KPI/delta.d.ts +62 -0
  649. package/types/src/charts/KPI/emit.d.ts +55 -0
  650. package/types/src/charts/KPI/index.d.ts +34 -0
  651. package/types/src/charts/KPI/series.d.ts +45 -0
  652. package/types/src/charts/KPI/tileLayout.d.ts +90 -0
  653. package/types/src/charts/Matrix/applyLayout.d.ts +5 -2
  654. package/types/src/charts/Matrix/bubbles.d.ts +87 -0
  655. package/types/src/charts/Matrix/emit.d.ts +3 -2
  656. package/types/src/charts/Matrix/index.d.ts +2 -1
  657. package/types/src/charts/Network/applyLayout.d.ts +35 -0
  658. package/types/src/charts/Network/bundle.d.ts +24 -15
  659. package/types/src/charts/Network/circleLayout.d.ts +149 -0
  660. package/types/src/charts/Network/containNodes.d.ts +35 -0
  661. package/types/src/charts/Network/emit.d.ts +20 -0
  662. package/types/src/charts/Network/forceLayout.d.ts +49 -0
  663. package/types/src/charts/Network/graph.d.ts +29 -5
  664. package/types/src/charts/Network/liveForce.d.ts +133 -0
  665. package/types/src/charts/Network/livePositions.d.ts +90 -0
  666. package/types/src/charts/Network/networkDrag.d.ts +55 -0
  667. package/types/src/charts/Pack/applyLayout.d.ts +2 -0
  668. package/types/src/charts/Pack/groupRows.d.ts +46 -0
  669. package/types/src/charts/Pack/index.d.ts +3 -0
  670. package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
  671. package/types/src/charts/Pack/nodeNames.d.ts +23 -0
  672. package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
  673. package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
  674. package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
  675. package/types/src/charts/Pareto/color.d.ts +21 -0
  676. package/types/src/charts/Pareto/hover.d.ts +38 -0
  677. package/types/src/charts/Pareto/index.d.ts +22 -0
  678. package/types/src/charts/Pareto/labels.d.ts +40 -0
  679. package/types/src/charts/Pareto/order.d.ts +30 -0
  680. package/types/src/charts/Pareto/paretoSteps.d.ts +65 -0
  681. package/types/src/charts/Pareto/state.d.ts +93 -0
  682. package/types/src/charts/Parliament/index.d.ts +18 -0
  683. package/types/src/charts/Plot/areaEnter.d.ts +34 -0
  684. package/types/src/charts/Plot/areaLabelsAlong.d.ts +7 -0
  685. package/types/src/charts/Plot/aspectRatio.d.ts +68 -0
  686. package/types/src/charts/Plot/axisHover.d.ts +2 -0
  687. package/types/src/charts/Plot/axisHoverScene.d.ts +44 -1
  688. package/types/src/charts/Plot/barConfidence.d.ts +14 -1
  689. package/types/src/charts/Plot/barHitArea.d.ts +34 -7
  690. package/types/src/charts/Plot/barLabelConfidence.d.ts +25 -0
  691. package/types/src/charts/Plot/baselineBreak.d.ts +2 -1
  692. package/types/src/charts/Plot/baselineDomain.d.ts +5 -0
  693. package/types/src/charts/Plot/circleLabels.d.ts +8 -7
  694. package/types/src/charts/Plot/confidenceAxes.d.ts +63 -0
  695. package/types/src/charts/Plot/confidenceTooltip.d.ts +22 -0
  696. package/types/src/charts/Plot/discreteDomain.d.ts +13 -2
  697. package/types/src/charts/Plot/discreteSpan.d.ts +5 -0
  698. package/types/src/charts/Plot/domainClip.d.ts +15 -5
  699. package/types/src/charts/Plot/downsample.d.ts +16 -0
  700. package/types/src/charts/Plot/index.d.ts +20 -17
  701. package/types/src/charts/Plot/inferDiscrete.d.ts +31 -0
  702. package/types/src/charts/Plot/jitter.d.ts +45 -0
  703. package/types/src/charts/Plot/lineLabelSides.d.ts +19 -0
  704. package/types/src/charts/Plot/lineLabelsAlong.d.ts +19 -6
  705. package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
  706. package/types/src/charts/Plot/marginalHover.d.ts +26 -0
  707. package/types/src/charts/Plot/marginalLayout.d.ts +95 -0
  708. package/types/src/charts/Plot/marginalPaint.d.ts +54 -0
  709. package/types/src/charts/Plot/marginalScene.d.ts +67 -0
  710. package/types/src/charts/Plot/marginalSeries.d.ts +38 -0
  711. package/types/src/charts/Plot/marginalStats.d.ts +115 -0
  712. package/types/src/charts/Plot/openDomainEnds.d.ts +25 -0
  713. package/types/src/charts/Plot/orderPath.d.ts +100 -0
  714. package/types/src/charts/Plot/orderPathScene.d.ts +49 -0
  715. package/types/src/charts/Plot/outlierDetect.d.ts +87 -0
  716. package/types/src/charts/Plot/outlierLabels.d.ts +103 -0
  717. package/types/src/charts/Plot/outlierLines.d.ts +30 -0
  718. package/types/src/charts/Plot/outlierScene.d.ts +103 -0
  719. package/types/src/charts/Plot/outlierTooltip.d.ts +44 -0
  720. package/types/src/charts/Plot/periodLabels.d.ts +14 -0
  721. package/types/src/charts/Plot/pipeline.d.ts +2 -1
  722. package/types/src/charts/Plot/plotBreaks.d.ts +21 -6
  723. package/types/src/charts/Plot/plotInit.d.ts +7 -25
  724. package/types/src/charts/Plot/plotLevels.d.ts +120 -0
  725. package/types/src/charts/Plot/plotRangeBreaks.d.ts +28 -2
  726. package/types/src/charts/Plot/plotShapes.d.ts +42 -0
  727. package/types/src/charts/Plot/pointConfidence.d.ts +73 -0
  728. package/types/src/charts/Plot/pointKey.d.ts +9 -0
  729. package/types/src/charts/Plot/referenceDomains.d.ts +2 -1
  730. package/types/src/charts/Plot/shapeAccessors.d.ts +24 -0
  731. package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
  732. package/types/src/charts/Plot/sharedHover.d.ts +5 -0
  733. package/types/src/charts/Plot/sharedTooltip.d.ts +31 -7
  734. package/types/src/charts/Plot/stackEnter.d.ts +1 -1
  735. package/types/src/charts/Plot/stackLegendOrder.d.ts +4 -1
  736. package/types/src/charts/Plot/stackNeutral.d.ts +85 -0
  737. package/types/src/charts/Plot/swarm.d.ts +8 -4
  738. package/types/src/charts/Plot/timeNestKeys.d.ts +20 -0
  739. package/types/src/charts/Plot/trendLabels.d.ts +15 -6
  740. package/types/src/charts/Plot/trendLines.d.ts +40 -8
  741. package/types/src/charts/Plot/trendMovingAverage.d.ts +78 -0
  742. package/types/src/charts/Plot/trendProjection.d.ts +4 -2
  743. package/types/src/charts/Plot/trendTooltip.d.ts +24 -2
  744. package/types/src/charts/Priestley/timeAxis.d.ts +13 -7
  745. package/types/src/charts/Pyramid/gutter.d.ts +28 -6
  746. package/types/src/charts/Pyramid/scene.d.ts +1 -1
  747. package/types/src/charts/Radar/applyLayout.d.ts +2 -3
  748. package/types/src/charts/Radar/axisDecorations.d.ts +5 -2
  749. package/types/src/charts/Radar/curvedLabels.d.ts +35 -0
  750. package/types/src/charts/Radar/emit.d.ts +5 -2
  751. package/types/src/charts/Radar/index.d.ts +7 -2
  752. package/types/src/charts/Radar/points.d.ts +50 -0
  753. package/types/src/charts/RadialArea/index.d.ts +17 -0
  754. package/types/src/charts/RadialLine/angles.d.ts +67 -0
  755. package/types/src/charts/RadialLine/applyLayout.d.ts +70 -0
  756. package/types/src/charts/RadialLine/emit.d.ts +13 -0
  757. package/types/src/charts/RadialLine/index.d.ts +28 -0
  758. package/types/src/charts/RadialLine/paths.d.ts +37 -0
  759. package/types/src/charts/RadialLine/points.d.ts +43 -0
  760. package/types/src/charts/RadialLine/series.d.ts +63 -0
  761. package/types/src/charts/RadialLine/seriesLabelNodes.d.ts +26 -0
  762. package/types/src/charts/RadialLine/seriesLabels.d.ts +80 -0
  763. package/types/src/charts/RadialLine/spokes.d.ts +15 -0
  764. package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
  765. package/types/src/charts/RadialTree/index.d.ts +16 -0
  766. package/types/src/charts/Rings/emit.d.ts +28 -5
  767. package/types/src/charts/Rings/index.d.ts +4 -2
  768. package/types/src/charts/Rings/ringsCurves.d.ts +46 -0
  769. package/types/src/charts/Rings/ringsGraph.d.ts +32 -5
  770. package/types/src/charts/Rings/ringsParallel.d.ts +4 -2
  771. package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
  772. package/types/src/charts/Rings/ringsSizing.d.ts +41 -11
  773. package/types/src/charts/Sankey/circularLayout.d.ts +3 -0
  774. package/types/src/charts/Sankey/sankeyDrag.d.ts +112 -0
  775. package/types/src/charts/Sankey/sankeyLayout.d.ts +8 -0
  776. package/types/src/charts/Scatter/index.d.ts +3 -2
  777. package/types/src/charts/ScatterMatrix/binEmit.d.ts +22 -0
  778. package/types/src/charts/ScatterMatrix/index.d.ts +80 -0
  779. package/types/src/charts/ScatterMatrix/matrixData.d.ts +93 -0
  780. package/types/src/charts/ScatterMatrix/matrixFacet.d.ts +32 -0
  781. package/types/src/charts/ScatterMatrix/matrixHover.d.ts +21 -0
  782. package/types/src/charts/ScatterMatrix/matrixTooltip.d.ts +32 -0
  783. package/types/src/charts/StripPlot/index.d.ts +16 -0
  784. package/types/src/charts/TileGridMap/index.d.ts +14 -0
  785. package/types/src/charts/Tree/applyLayout.d.ts +20 -0
  786. package/types/src/charts/Tree/index.d.ts +2 -2
  787. package/types/src/charts/Tree/keys.d.ts +25 -0
  788. package/types/src/charts/Tree/nodeHeight.d.ts +41 -0
  789. package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
  790. package/types/src/charts/Tree/radialLabels.d.ts +24 -0
  791. package/types/src/charts/Tree/radialLayout.d.ts +129 -0
  792. package/types/src/charts/Venn/applyLayout.d.ts +91 -0
  793. package/types/src/charts/Venn/circles.d.ts +87 -0
  794. package/types/src/charts/Venn/ellipseFrame.d.ts +37 -0
  795. package/types/src/charts/Venn/emit.d.ts +36 -0
  796. package/types/src/charts/Venn/index.d.ts +30 -0
  797. package/types/src/charts/Venn/nelderMead.d.ts +28 -0
  798. package/types/src/charts/Venn/tooltip.d.ts +8 -0
  799. package/types/src/charts/Venn/vennData.d.ts +56 -0
  800. package/types/src/charts/Venn/vennEllipses.d.ts +93 -0
  801. package/types/src/charts/Venn/vennFit.d.ts +39 -0
  802. package/types/src/charts/Venn/vennLayout.d.ts +52 -0
  803. package/types/src/charts/Venn/vennRegions.d.ts +58 -0
  804. package/types/src/charts/Waffle/applyLayout.d.ts +4 -1
  805. package/types/src/charts/Waffle/arcEmit.d.ts +45 -0
  806. package/types/src/charts/Waffle/arcLayout.d.ts +82 -0
  807. package/types/src/charts/Waffle/arcStage.d.ts +60 -0
  808. package/types/src/charts/Waffle/emit.d.ts +2 -1
  809. package/types/src/charts/Waffle/index.d.ts +8 -2
  810. package/types/src/charts/Waffle/tooltip.d.ts +7 -2
  811. package/types/src/charts/Waterfall/connectors.d.ts +3 -2
  812. package/types/src/charts/WordCloud/applyLayout.d.ts +51 -0
  813. package/types/src/charts/WordCloud/cloudLayout.d.ts +95 -0
  814. package/types/src/charts/WordCloud/emit.d.ts +27 -0
  815. package/types/src/charts/WordCloud/fontScale.d.ts +20 -0
  816. package/types/src/charts/WordCloud/glyphMask.d.ts +95 -0
  817. package/types/src/charts/WordCloud/index.d.ts +31 -0
  818. package/types/src/charts/WordCloud/occupancy.d.ts +59 -0
  819. package/types/src/charts/WordCloud/rotation.d.ts +31 -0
  820. package/types/src/charts/WordCloud/size.d.ts +16 -0
  821. package/types/src/charts/WordCloud/spiral.d.ts +47 -0
  822. package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
  823. package/types/src/charts/definition/declaresField.d.ts +9 -0
  824. package/types/src/charts/definition/makeChart.d.ts +3 -3
  825. package/types/src/charts/drawSteps/gestureHover.d.ts +2 -2
  826. package/types/src/charts/drawSteps/leavesSurface.d.ts +11 -0
  827. package/types/src/charts/drawSteps/selectActions.d.ts +58 -0
  828. package/types/src/charts/drawSteps/selectGesture.d.ts +60 -0
  829. package/types/src/charts/drawSteps/selectRegion.d.ts +86 -0
  830. package/types/src/charts/drawSteps/selectState.d.ts +51 -0
  831. package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
  832. package/types/src/charts/drawSteps/zoomControls.d.ts +32 -7
  833. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +104 -16
  834. package/types/src/charts/drawSteps/zoomControlsMenu.d.ts +30 -0
  835. package/types/src/charts/drawSteps/zoomDrag.d.ts +73 -0
  836. package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
  837. package/types/src/charts/facet/drawFacets.d.ts +6 -3
  838. package/types/src/charts/facet/facetConfig.d.ts +35 -1
  839. package/types/src/charts/facet/facetData.d.ts +8 -2
  840. package/types/src/charts/facet/facetGrid.d.ts +12 -0
  841. package/types/src/charts/facet/facetGutter.d.ts +19 -5
  842. package/types/src/charts/facet/facetLayout.d.ts +79 -0
  843. package/types/src/charts/facet/facetLayouts.d.ts +21 -0
  844. package/types/src/charts/facet/facetScene.d.ts +4 -1
  845. package/types/src/charts/features/annotationFrame.d.ts +2 -0
  846. package/types/src/charts/features/axesFinal.d.ts +5 -2
  847. package/types/src/charts/features/axisTooltip.d.ts +49 -0
  848. package/types/src/charts/features/bareRegion.d.ts +18 -0
  849. package/types/src/charts/features/boxGrid.d.ts +28 -0
  850. package/types/src/charts/features/centerLabel.d.ts +89 -0
  851. package/types/src/charts/features/circleLabelPlacement.d.ts +81 -11
  852. package/types/src/charts/features/circleLabels.d.ts +33 -3
  853. package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
  854. package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
  855. package/types/src/charts/features/colorScaleHover.d.ts +14 -3
  856. package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
  857. package/types/src/charts/features/colorScaleTooltip.d.ts +38 -0
  858. package/types/src/charts/features/colorScaleTop.d.ts +30 -0
  859. package/types/src/charts/features/colorScaleValue.d.ts +6 -0
  860. package/types/src/charts/features/curvedArrows.d.ts +42 -12
  861. package/types/src/charts/features/depthKey.d.ts +19 -0
  862. package/types/src/charts/features/edgeArrows.d.ts +68 -31
  863. package/types/src/charts/features/emitHelpers.d.ts +6 -1
  864. package/types/src/charts/features/featuresColorScale.d.ts +6 -0
  865. package/types/src/charts/features/hoverTicks.d.ts +33 -0
  866. package/types/src/charts/features/idleQueue.d.ts +46 -0
  867. package/types/src/charts/features/keyHold.d.ts +41 -0
  868. package/types/src/charts/features/keyTooltip.d.ts +44 -0
  869. package/types/src/charts/features/labelLayering.d.ts +38 -0
  870. package/types/src/charts/features/labelSlots.d.ts +53 -0
  871. package/types/src/charts/features/linkInteraction.d.ts +13 -4
  872. package/types/src/charts/features/linkLabelPath.d.ts +0 -7
  873. package/types/src/charts/features/networkMeasures.d.ts +53 -0
  874. package/types/src/charts/features/nodeDrag.d.ts +51 -0
  875. package/types/src/charts/features/nodeKeys.d.ts +53 -0
  876. package/types/src/charts/features/nodeOutline.d.ts +34 -0
  877. package/types/src/charts/features/nodeStats.d.ts +93 -0
  878. package/types/src/charts/features/pathLabelBends.d.ts +78 -0
  879. package/types/src/charts/features/plotAnnotations.d.ts +2 -1
  880. package/types/src/charts/features/plotEndLabels.d.ts +14 -1
  881. package/types/src/charts/features/plotPaint.d.ts +5 -0
  882. package/types/src/charts/features/rectNodeSize.d.ts +42 -0
  883. package/types/src/charts/features/ringLabels.d.ts +3 -1
  884. package/types/src/charts/features/selfLoops.d.ts +10 -9
  885. package/types/src/charts/features/shapeEmit.d.ts +2 -0
  886. package/types/src/charts/features/sharedFields.d.ts +8 -4
  887. package/types/src/charts/features/spokeLabels.d.ts +123 -0
  888. package/types/src/charts/features/swatchPaint.d.ts +58 -0
  889. package/types/src/charts/features/textHalo.d.ts +4 -3
  890. package/types/src/charts/features/thresholdMembers.d.ts +6 -6
  891. package/types/src/charts/features/tooltipRows.d.ts +50 -0
  892. package/types/src/charts/features/tooltipSwatch.d.ts +25 -11
  893. package/types/src/charts/helpers/valueTitle.d.ts +7 -0
  894. package/types/src/charts/index.d.ts +17 -0
  895. package/types/src/charts/partition/chartFields.d.ts +6 -1
  896. package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
  897. package/types/src/charts/pipeline/preDrawData.d.ts +26 -0
  898. package/types/src/charts/plotBuffers/Circle.d.ts +2 -1
  899. package/types/src/charts/plotBuffers/Rect.d.ts +2 -1
  900. package/types/src/charts/plotBuffers/Tick.d.ts +9 -0
  901. package/types/src/charts/plotBuffers/defaultBuffers.d.ts +2 -0
  902. package/types/src/charts/polar/chrome.d.ts +19 -6
  903. package/types/src/charts/viz/Viz.d.ts +10 -3
  904. package/types/src/charts/viz/VizBase.d.ts +63 -3
  905. package/types/src/charts/viz/appendRows.d.ts +49 -0
  906. package/types/src/charts/viz/backgroundInk.d.ts +8 -0
  907. package/types/src/charts/viz/dataChanged.d.ts +11 -0
  908. package/types/src/charts/viz/discrete.d.ts +19 -0
  909. package/types/src/charts/viz/emphasis.d.ts +17 -0
  910. package/types/src/charts/viz/fillStroke.d.ts +7 -0
  911. package/types/src/charts/viz/focusTargets.d.ts +15 -1
  912. package/types/src/charts/viz/groupByLevels.d.ts +36 -0
  913. package/types/src/charts/viz/groupRow.d.ts +6 -0
  914. package/types/src/charts/viz/hoverBand.d.ts +28 -0
  915. package/types/src/charts/viz/interactionOpacity.d.ts +23 -2
  916. package/types/src/charts/viz/keyboardNav.d.ts +13 -0
  917. package/types/src/charts/viz/liftRaised.d.ts +23 -0
  918. package/types/src/charts/viz/reportDrawError.d.ts +12 -0
  919. package/types/src/charts/viz/setCursor.d.ts +38 -0
  920. package/types/src/charts/viz/simpleHover.d.ts +3 -3
  921. package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
  922. package/types/src/charts/viz/userClick.d.ts +43 -0
  923. package/types/src/charts/viz/vizFields.d.ts +12 -0
  924. package/types/src/charts/viz/vizTypes.d.ts +132 -2
  925. package/types/src/charts/viz/vizVisibility.d.ts +7 -0
  926. package/types/src/components/Axis/Axis.d.ts +68 -3
  927. package/types/src/components/Axis/axisBreak.d.ts +19 -3
  928. package/types/src/components/Axis/axisDefaults.d.ts +14 -0
  929. package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
  930. package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
  931. package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
  932. package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
  933. package/types/src/components/Axis/axisLabelThinning.d.ts +57 -3
  934. package/types/src/components/Axis/axisLayout.d.ts +9 -2
  935. package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
  936. package/types/src/components/Axis/axisLayoutScale.d.ts +16 -2
  937. package/types/src/components/Axis/axisLevels.d.ts +137 -0
  938. package/types/src/components/Axis/axisLimit.d.ts +18 -0
  939. package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
  940. package/types/src/components/Axis/axisMinorTicks.d.ts +83 -0
  941. package/types/src/components/Axis/axisPeriods.d.ts +45 -0
  942. package/types/src/components/Axis/axisRangeBreaks.d.ts +6 -2
  943. package/types/src/components/Axis/axisRounding.d.ts +22 -0
  944. package/types/src/components/Axis/axisScaleType.d.ts +32 -0
  945. package/types/src/components/Axis/axisScene.d.ts +15 -7
  946. package/types/src/components/Axis/axisTickLookups.d.ts +26 -0
  947. package/types/src/components/Axis/axisTitle.d.ts +30 -0
  948. package/types/src/components/Axis/axisTooltipTargets.d.ts +94 -0
  949. package/types/src/components/Axis/labelSizeSession.d.ts +16 -0
  950. package/types/src/components/Axis/rangeBreaks.d.ts +6 -2
  951. package/types/src/components/Axis/timeValues.d.ts +48 -2
  952. package/types/src/components/ColorScale/ColorScale.d.ts +21 -11
  953. package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
  954. package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
  955. package/types/src/components/ColorScale/colorScaleScale.d.ts +45 -0
  956. package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
  957. package/types/src/components/Legend/Legend.d.ts +5 -0
  958. package/types/src/components/Legend/legendCut.d.ts +31 -0
  959. package/types/src/components/Legend/legendRender.d.ts +6 -1
  960. package/types/src/components/TextBox.d.ts +4 -0
  961. package/types/src/components/Tooltip.d.ts +11 -2
  962. package/types/src/components/textEllipsis.d.ts +6 -0
  963. package/types/src/components/tooltipDom.d.ts +24 -0
  964. package/types/src/fluent.d.ts +48 -1
  965. package/types/src/shapes/Bar.d.ts +7 -0
  966. package/types/src/shapes/Box.d.ts +15 -0
  967. package/types/src/shapes/Shape.d.ts +11 -0
  968. package/types/src/shapes/Tick.d.ts +20 -0
  969. package/types/src/shapes/boxExtraShapes.d.ts +40 -0
  970. package/types/src/shapes/boxExtras.d.ts +85 -0
  971. package/types/src/shapes/boxStyle.d.ts +25 -4
  972. package/types/src/shapes/downsample.d.ts +68 -0
  973. package/types/src/shapes/emitLabels.d.ts +1 -1
  974. package/types/src/shapes/hitAreaNode.d.ts +2 -1
  975. package/types/src/shapes/index.d.ts +1 -0
  976. package/types/src/shapes/pathSeries.d.ts +35 -0
  977. package/types/src/shapes/shapeConfig.d.ts +70 -2
  978. package/types/src/utils/BaseClass.d.ts +18 -4
  979. package/types/src/utils/D3plusConfig.d.ts +1458 -676
  980. package/types/src/utils/configValue.d.ts +8 -0
  981. package/types/src/utils/index.d.ts +1 -1
  982. package/types/src/utils/jitter.d.ts +23 -0
  983. package/types/src/utils/resetSetters.d.ts +23 -0
  984. package/types/umd-entry.d.ts +4 -0
  985. package/umd/d3plus-core.full.js +109828 -74615
  986. package/umd/d3plus-core.full.min.js +2 -2
  987. package/umd/d3plus-core.js +90460 -56685
  988. package/umd/d3plus-core.min.js +2 -2
@@ -2,14 +2,15 @@
2
2
  Bar hit areas: a transparent hover target behind each side-by-side bar
3
3
  that fills the bar's slot along the discrete axis and the whole plot along
4
4
  the value axis, so a short bar is as easy to hover and click as a tall
5
- one. Grouped bars each take their own column of the slot. Stacked bars
6
- already fill their slot and take none. `shapeConfig.Bar.hitArea: false`
7
- turns them off.
5
+ one. Grouped bars each take their own column of the slot. A hovered
6
+ bar's hit area shows as a band (`shapeConfig.Bar.hitAreaStyle`). Stacked
7
+ bars, which fill their slot, take a band over it that the pointer passes
8
+ through. `shapeConfig.Bar.hitArea: false` turns them off.
8
9
 
9
10
  @module
10
11
  */
11
12
  import type { DataPoint } from "@d3plus/data";
12
- import type { SceneNode } from "@d3plus/render";
13
+ import type { Paint, SceneNode } from "@d3plus/render";
13
14
  import type { Shape } from "../../shapes/index.js";
14
15
  /** Rect bounds in a bar's own coordinates (relative to its transform). */
15
16
  export interface HitBounds {
@@ -42,15 +43,41 @@ export declare function hitBounds(discrete: "x" | "y", column: [number, number],
42
43
  x?: number;
43
44
  y?: number;
44
45
  }): HitBounds;
46
+ /** How `applyBarHitArea` shows and targets the hit areas. */
47
+ export interface BarHitOptions {
48
+ /** The band a hovered bar's hit area shows (`hitAreaStyle`). */
49
+ band?: Paint;
50
+ /** Whether the pointer passes through them: a band, but no target. */
51
+ inert?: boolean;
52
+ }
53
+ /**
54
+ The band a hovered bar's hit area shows by default: the theme's text
55
+ color at 10% opacity.
56
+ @param text The theme's text color.
57
+ */
58
+ export declare function barHitBand(text: string): Paint;
45
59
  /**
46
- Gives a Bar shape its slot-filling hit areas (see `hitBounds`). Set
47
- before the user's `shapeConfig`, so `hitArea` there (or `false`) wins.
60
+ Gives a Bar shape its slot-filling hit areas (see `hitBounds`) and their
61
+ hover band. Set before the user's `shapeConfig`, so `hitArea` there (or
62
+ `false`) wins, and its `hitAreaStyle` merges over the band.
48
63
  @param s The Bar shape.
49
64
  @param discrete The discrete axis.
50
65
  @param valueExtent The value axis's pixel span, in shape coordinates.
51
66
  @param column Each bar's column (see `hitColumn`).
67
+ @param options The band, and whether the pointer passes through.
68
+ */
69
+ export declare function applyBarHitArea(s: Shape, discrete: "x" | "y", valueExtent: [number, number] | undefined, column: (d: DataPoint, i: number) => [number, number], { band, inert }?: BarHitOptions): void;
70
+ /**
71
+ The pointer targets in the empty part of each stacked column: its slot
72
+ beyond either end of the stack, where a single bar's hit area would
73
+ reach (a pixel or more of it). Each reaches the segment nearest it, the
74
+ stack's outermost at that end, and draws nothing (the segments' own bands show the slot).
75
+ Read off the stacked bars' slot-wide bands (inert `::hit` rects), and
76
+ returned ahead of `nodes`.
77
+ @param nodes A stacked Bar shape's scene nodes.
78
+ @param discrete The discrete axis.
52
79
  */
53
- export declare function applyBarHitArea(s: Shape, discrete: "x" | "y", valueExtent: [number, number] | undefined, column: (d: DataPoint, i: number) => [number, number]): void;
80
+ export declare function stackSlotTargets(nodes: SceneNode[], discrete: "x" | "y"): SceneNode[];
54
81
  /**
55
82
  `nodes` with every Bar hit area moved to the front (painted first), so
56
83
  each sits behind every mark: a bar's slot never covers another bar, nor
@@ -0,0 +1,25 @@
1
+ /**
2
+ Bar labels beside an error bar: a bar with a `confidence` bound draws a
3
+ whisker over its end, so its label anchors at the bar's base instead
4
+ (the left end of a horizontal bar, the bottom of an upright one), and a
5
+ label outside the bar starts past the whisker's far end.
6
+
7
+ @module
8
+ */
9
+ import type { DataPoint } from "@d3plus/data";
10
+ import type { VizInstance } from "../viz/vizTypes.js";
11
+ /**
12
+ How far a bar's error bar reaches past the bar's end, in pixels along the
13
+ way the bar grows (0 when it stops short); null when the bar has no
14
+ finite bound, so draws no error bar. Read from the source row.
15
+ @param viz The chart.
16
+ @param d The bar's source row.
17
+ @param i The row's index.
18
+ */
19
+ export declare function barErrorReach(viz: VizInstance, d: DataPoint, i: number): number | null;
20
+ /**
21
+ Flips a bar label's anchor from the bar's end to its base: `"start"` ↔
22
+ `"end"` (and `"top"` ↔ `"bottom"`); `"middle"` stays.
23
+ @param anchor The anchor the label takes without an error bar.
24
+ */
25
+ export declare function anchorAtBase(anchor: string): string;
@@ -8,7 +8,8 @@ import type { VizInstance } from "../viz/vizTypes.js";
8
8
  clearing `yBreak` clears it from a reused axis; a `break` inside `yConfig`
9
9
  wins. When the user's domain leaves an end open, Plot hands the axis the
10
10
  domain with that end filled and rounded (see `openDomainEnds.ts`), so the
11
- axis gets no `rounding` or one-sided `domain` of the user's.
11
+ axis gets no `rounding` or one-sided `domain` of the user's. Bars on
12
+ the axis keep its labels at their ticks (see `periodAxisConfig`).
12
13
  */
13
14
  export declare function plotAxisConfig(viz: VizInstance, axis: "x" | "y"): Record<string, unknown>;
14
15
  export { valueAxis };
@@ -12,6 +12,11 @@ export declare function isOneSided(domain: unknown): domain is DomainValue[];
12
12
  reversed, so a set maximum comes back second.)
13
13
  */
14
14
  export declare function configOpenDomain(viz: VizInstance, axis: string): DomainValue[] | undefined;
15
+ /**
16
+ Where a Plot's bars and areas start: the chart's own baseline (BarChart's
17
+ `0`), else `0` under bars or areas (see `shapeBaseline`), else undefined.
18
+ */
19
+ export declare function plotBaseline(viz: VizInstance): number | undefined;
15
20
  /** `Plot.baseline()`: the user's baseline, or the chart's own when none is set. */
16
21
  export declare function baselineValue(viz: VizInstance): number | undefined;
17
22
  /** `Plot.baseline(_)`: stores the user's baseline; `RESET` and `undefined` clear it. */
@@ -1,7 +1,9 @@
1
1
  /**
2
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`).
3
+ stays inside its circle when it fits there and no point drawn over it
4
+ covers it, else moves beside it where there's room, else stays inside
5
+ when it fits there, else hides (see `labelPosition` and
6
+ `features/circleLabels.ts`).
5
7
 
6
8
  @module
7
9
  */
@@ -21,9 +23,8 @@ import type { ShapeEmitContext } from "../features/shapeEmit.js";
21
23
  */
22
24
  export declare function plotCircleLabels(ctx: ShapeEmitContext, s: Shape, userConfig: Record<string, unknown>): (() => SceneNode[]) | null;
23
25
  /**
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.
26
+ The paint position of each circle drawn largest first (see
27
+ `largestFirst`): larger radii first, equal radii in input order.
28
+ @param radii Each circle's radius, in input order.
28
29
  */
29
- export declare function labelsOverCircles(nodes: SceneNode[]): SceneNode[];
30
+ export declare function largestFirstRanks(radii: readonly number[]): number[];
@@ -0,0 +1,63 @@
1
+ /**
2
+ `confidence` by axis: `{x: [lower, upper], y: [lower, upper]}` gives each
3
+ axis its own bounds. At each draw, the bounds along the value axis (y,
4
+ or x when `discrete` is `"y"`) become the chart's `confidence` pair,
5
+ which lines and bars draw as before, and the bounds along the other axis
6
+ become its cross bounds, which points draw as horizontal (or vertical)
7
+ error bars and which widen that axis.
8
+ */
9
+ import type { DataPoint } from "@d3plus/data";
10
+ import type { VizInstance } from "../viz/vizTypes.js";
11
+ import type { ConfidenceBounds } from "./barConfidence.js";
12
+ import type { ConfidenceBand } from "./confidenceBands.js";
13
+ /** Each axis's bounds from a `{x, y}` setting; either may be absent. */
14
+ export interface ConfidenceAxes {
15
+ x?: ConfidenceBand;
16
+ y?: ConfidenceBand;
17
+ }
18
+ /**
19
+ The bounds of a `{x: [lower, upper], y: [lower, upper]}` setting, by
20
+ axis (each axis also takes `{lower, upper}`); null for any other
21
+ setting, including `{lower, upper}` itself. An axis without a bound is
22
+ left out.
23
+ @param value The `confidence` setter's argument.
24
+ */
25
+ export declare function resolveConfidenceAxes(value: unknown): ConfidenceAxes | null;
26
+ /** The axis a Plot's `confidence` pair bounds: y, or x when `discrete` is `"y"`. */
27
+ export declare const confidenceValueAxis: (viz: VizInstance) => "x" | "y";
28
+ /** The other axis, which a `{x, y}` setting's cross bounds run along. */
29
+ export declare const confidenceCrossAxis: (viz: VizInstance) => "x" | "y";
30
+ /**
31
+ Applies a `{x, y}` setting for one draw: the value axis's bounds become
32
+ the chart's `confidence` pair and its cross axis's become
33
+ `_confidenceCross`. Without a `{x, y}` setting there are no cross bounds.
34
+ @param viz The chart.
35
+ */
36
+ export declare function syncConfidenceAxes(viz: VizInstance): void;
37
+ /**
38
+ A source row's finite cross bounds, read through `_confidenceCross`.
39
+ Empty when there are none.
40
+ @param viz The chart.
41
+ @param d The source data row.
42
+ @param i The row's index.
43
+ */
44
+ export declare function rowCrossConfidence(viz: VizInstance, d: DataPoint, i: number): ConfidenceBounds;
45
+ /**
46
+ A row's cross bounds as the PlotDatum fields `clci` and `chci` (unset
47
+ when the chart has none).
48
+ @param viz The chart.
49
+ @param d The source data row.
50
+ @param i The row's index.
51
+ */
52
+ export declare function crossBounds(viz: VizInstance, d: DataPoint, i: number): {
53
+ clci?: unknown;
54
+ chci?: unknown;
55
+ };
56
+ /**
57
+ The cross bounds that widen `axis` (an `x`/`x2` or `y`/`y2` axis):
58
+ every plotted row's `clci` and `chci` when `axis` is the cross axis.
59
+ @param viz The chart.
60
+ @param rows The plotted rows.
61
+ @param axis The axis being measured.
62
+ */
63
+ export declare function crossAxisValues(viz: VizInstance, rows: Record<string, unknown>[], axis: string): number[];
@@ -11,6 +11,7 @@
11
11
  import type { DataPoint } from "@d3plus/data";
12
12
  import type { VizInstance } from "../viz/vizTypes.js";
13
13
  import type { ConfidenceBounds } from "./barConfidence.js";
14
+ import { type TbodyHost } from "../features/tooltipRows.js";
14
15
  /** Formats a bound the way the tooltip formats the value it bounds. */
15
16
  type Format = (value: number) => string;
16
17
  /** Whether tooltips list the confidence bounds (`confidenceConfig.tooltip`, default `true`). */
@@ -32,6 +33,16 @@ export declare function rowConfidence(viz: VizInstance, d: DataPoint, i: number)
32
33
  @param format Formats a bound like the row's value.
33
34
  */
34
35
  export declare function confidenceRows(viz: VizInstance, d: DataPoint, i: number, format: Format): string[][];
36
+ /**
37
+ The bound rows of a `{x, y}` setting: each axis's bounds, x first, each
38
+ labeled with its axis's name, as "Lower Bound (Weight)", and formatted
39
+ like that axis's values.
40
+ @param viz The chart.
41
+ @param d The source data row.
42
+ @param i The row's index.
43
+ @param format Formats a value-axis bound.
44
+ */
45
+ export declare function axisBoundRows(viz: VizInstance, d: DataPoint, i: number, format: Format): string[][];
35
46
  /**
36
47
  The single-mark tooltip rows for nested bands: `[label, range]` for each
37
48
  band with a bound, outermost first.
@@ -67,4 +78,15 @@ export declare function rangeSuffix(lower: number | undefined, upper: number | u
67
78
  @param format Formats each bound.
68
79
  */
69
80
  export declare function rangeText(lower: number | undefined, upper: number | undefined, format: Format): string;
81
+ /**
82
+ Adds a hovered point's bounds (see `confidenceRows`) after the rows its
83
+ tooltip already lists, each formatted like its axis's values and read
84
+ from the row the tooltip renders. Only a point mark (a Circle or Rect,
85
+ or its error bar) takes them: bars and lines list theirs in Plot's
86
+ snapped tooltips.
87
+ @param tooltip The tooltip being rendered.
88
+ @param viz The chart.
89
+ @param shapeType The hovered mark's shape type.
90
+ */
91
+ export declare function appendPointConfidence<T extends TbodyHost>(tooltip: T, viz: VizInstance, shapeType: string | undefined): T;
70
92
  export {};
@@ -2,13 +2,24 @@
2
2
  A user domain on a discrete axis. The axis is a point scale, so its
3
3
  domain is the list of categories it shows, in order: `xDomain([2016,
4
4
  2019])` shows those two categories. Rows whose category isn't listed
5
- have no position on that axis, so `formatPlotData` drops them.
5
+ have no position on that axis, so `formatPlotData` drops them. An axis
6
+ config `scale` that draws a continuous range (`xConfig.scale("linear")`)
7
+ makes the domain `[min, max]`, as on any continuous axis: every row
8
+ stays, and the marks past it are clipped (see `domainClip.ts`).
6
9
  */
7
10
  import { InternSet } from "d3-array";
8
11
  import type { VizInstance } from "../viz/vizTypes.js";
12
+ /**
13
+ Whether an axis config's `scale` draws a continuous range of values
14
+ (`"linear"`, `"log"`, `"time"`, …) rather than leaving a discrete axis
15
+ its categories (unset, `"auto"`, `"band"`, `"ordinal"` or `"point"`).
16
+ @param scale The axis config's `scale`.
17
+ */
18
+ export declare function isContinuousScale(scale: unknown): boolean;
9
19
  /**
10
20
  The categories a user domain (`<axis>Config.domain`, else `<axis>Domain`)
11
21
  lists for the discrete axis, or `null` when that axis has no user domain
12
- or isn't a point scale (a time or span axis).
22
+ or isn't a point scale (a time or span axis, or one whose axis config
23
+ `scale` draws a continuous range).
13
24
  */
14
25
  export declare function discreteDomainCategories(viz: VizInstance): InternSet<unknown> | null;
@@ -7,3 +7,8 @@ export declare function rowSpan(viz: VizInstance, row: Record<string, unknown>):
7
7
  export declare function spanDomain(viz: VizInstance, rows: Record<string, unknown>[]): number[];
8
8
  /** Every unique span boundary, ascending — the tick values for a span axis. */
9
9
  export declare function spanEdges(viz: VizInstance, rows: Record<string, unknown>[]): number[];
10
+ /**
11
+ A span axis's tick values: every span boundary, or null (the axis's own
12
+ ticks) when every span is a single point, as along a sampled curve.
13
+ */
14
+ export declare function spanTicks(viz: VizInstance, rows: Record<string, unknown>[]): number[] | null;
@@ -8,14 +8,24 @@ export interface ClipFrame extends MaskFrame {
8
8
  yOffset?: number;
9
9
  }
10
10
  /**
11
- Wraps each run of `nodes` that reaches past the plot rect in a group
12
- clipped to it (see the module docs). Returns `nodes` itself when nothing
13
- is cut off.
11
+ Wraps each run of `nodes` in a group, clipped to the plot rect when the
12
+ run reaches past it (see the module docs).
14
13
  @param nodes The plot's data marks and their labels, in paint order.
15
- @param frame The plot rect, in shape coordinates.
14
+ @param frame The plot rect, in shape coordinates, or none to clip no run
15
+ (a zoomed view clips its content itself).
16
+ @param gaps The gaps masked axis breaks cut (see `maskedGaps`): a label
17
+ crossing one paints whole, over its run, outside every clip.
16
18
  */
17
- export declare function clipToPlotArea(nodes: SceneNode[], frame: ClipFrame): SceneNode[];
19
+ export declare function clipToPlotArea(nodes: SceneNode[], frame?: ClipFrame, gaps?: readonly Box[]): SceneNode[];
20
+ /** An axis-aligned box. */
21
+ type Box = {
22
+ x: number;
23
+ y: number;
24
+ width: number;
25
+ height: number;
26
+ };
18
27
  /** Whether a node is a group `clipToPlotArea` wrapped marks in. */
19
28
  export declare const isDomainClip: (node: SceneNode) => boolean;
20
29
  /** `nodes` with each of `clipToPlotArea`'s clip groups replaced by the marks inside it. */
21
30
  export declare function unwrapDomainClips(nodes: SceneNode[]): SceneNode[];
31
+ export {};
@@ -0,0 +1,16 @@
1
+ import type { VizInstance } from "../viz/vizTypes.js";
2
+ /** How many points per pixel of plot a line or area draws before it is thinned. */
3
+ export declare const DOWNSAMPLE_DENSITY = 2;
4
+ /**
5
+ The Line and Area config that thins a Plot's dense series (see the
6
+ chart's `downsample`): the most points each draws, and the pixel range
7
+ along the discrete axis that shows, so a zoomed plot thins only what it
8
+ shows. Empty when `downsample` is `false`, or with no plot range.
9
+ @param viz The chart.
10
+ @param xRange The plot's x range, in pixels.
11
+ @param yRange The plot's y range, in pixels.
12
+ */
13
+ export declare function plotDownsample(viz: VizInstance, xRange: number[] | undefined, yRange: number[] | undefined): {
14
+ downsample?: number;
15
+ downsampleExtent?: [number, number];
16
+ };
@@ -1,6 +1,7 @@
1
1
  import { type StackOffsetFn, type StackOrderFn, type StackOrderInput } from "./stackHelpers.js";
2
2
  import type { PlotPaintContext } from "../features/plotPaint.js";
3
3
  import { type ZoomState } from "./plotZoom.js";
4
+ import type { ConfidenceAxes } from "./confidenceAxes.js";
4
5
  import { type ConfidenceBand } from "./confidenceBands.js";
5
6
  import { type TrendLineType } from "./trendLines.js";
6
7
  import Viz from "../viz/Viz.js";
@@ -11,6 +12,8 @@ import type { VizInstance } from "../viz/vizTypes.js";
11
12
  type PlotAccessor = (d: DataPoint, i: number) => number | Date | string;
12
13
  /** Function-or-string-key value accepted by accessor setters. */
13
14
  type PlotAccessorArg = string | PlotAccessor;
15
+ /** An `x`/`y` setting: one level, or the levels of a multi-level axis. */
16
+ type PlotAxisArg = PlotAccessorArg | PlotAccessorArg[];
14
17
  /**
15
18
  Creates an x/y plot based on an array of data.
16
19
  */
@@ -139,11 +142,7 @@ export default class Plot extends Viz {
139
142
  */
140
143
  _zoomRescale(t: ZoomState, duration?: number): boolean;
141
144
  /**
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).
143
-
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.
145
+ 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).
147
146
  */
148
147
  annotations(_?: unknown): this | unknown[];
149
148
  /**
@@ -151,7 +150,7 @@ export default class Plot extends Viz {
151
150
  */
152
151
  axisPersist(_?: boolean): this | boolean;
153
152
  /**
154
- 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.
153
+ 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.
155
154
  */
156
155
  baseline(_?: number): this | number | undefined;
157
156
  /**
@@ -163,9 +162,7 @@ export default class Plot extends Viz {
163
162
  */
164
163
  buffer(_?: boolean | Record<string, boolean>): this | Record<string, unknown>;
165
164
  /**
166
- 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.
167
-
168
- 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.
165
+ The confidence interval as `[lower, upper]` bounds (keys or accessors): lines draw a shaded band, bars and points 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). Pass `{x: [lower, upper], y: [lower, upper]}` to bound each axis: the value axis's bounds (y, or x when `discrete` is `"y"`) draw as above, and the other axis's draw on points, as a cross where a point has both. Labels beside points keep clear of error bars, and a bar with an error bar anchors its label at its base (or, outside the bar, past the whisker). `false` turns it off.
169
166
 
170
167
  @example <caption>Can be called with accessor functions or static keys:</caption>
171
168
  var data = {id: "alpha", value: 10, lci: 9, hci: 11};
@@ -178,10 +175,13 @@ export default class Plot extends Viz {
178
175
 
179
176
  // Or nested bands, outermost first
180
177
  .confidence([["p5", "p95", "90%"], ["p25", "p75", "50%"]])
178
+
179
+ // Or bounds on each axis
180
+ .confidence({x: ["xLow", "xHigh"], y: ["yLow", "yHigh"]})
181
181
  */
182
- confidence(_?: unknown): this | VizInstance["_confidence"] | ConfidenceBand[];
182
+ confidence(_?: unknown): this | VizInstance["_confidence"] | ConfidenceBand[] | ConfidenceAxes;
183
183
  /**
184
- 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.
184
+ 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.
185
185
 
186
186
  @example
187
187
  .confidenceConfig({Bar: {stroke: "#333", capWidth: 8}, tooltip: false})
@@ -206,17 +206,20 @@ export default class Plot extends Viz {
206
206
  */
207
207
  crosshairConfig(_?: Record<string, unknown>): this | Record<string, unknown>;
208
208
  /**
209
- Draws an automatic trend line fit to the plotted data: `true` (or `"linear"`) for a least-squares line, or one of `"exponential"`, `"logarithmic"`, `"power"`, or `"polynomial"`. By default each series gets its own line in its color; see `trendLineConfig` for grouping, a confidence band, and styling. On a chart with a discrete axis, the line runs along that axis, fitting categories by their order. Set to `false` (the default) to remove.
209
+ Draws an automatic trend line fit to the plotted data: `true` (or `"linear"`) for a least-squares line, one of `"exponential"`, `"logarithmic"`, `"power"`, or `"polynomial"`, or `"movingAverage"` for a rolling mean through the data with bands either side. By default each series gets its own line in its color; see `trendLineConfig` for grouping, a confidence band, and styling. On a chart with a discrete axis, the line runs along that axis, fitting categories by their order. Set to `false` (the default) to remove.
210
210
  */
211
211
  trendLine(_?: TrendLineType): this | TrendLineType;
212
212
  /**
213
213
  Options for the trend lines drawn by `trendLine`, merged into the current config:
214
214
  - `group`: `"series"` (default) fits one line per series, colored to match it; `"all"` fits a single line to every point.
215
215
  - `order`: the polynomial degree when `trendLine` is `"polynomial"` (default `2`).
216
+ - `window`: how many points a moving average spans (default `7`; the first `window − 1` points have no average), or on a time axis a span of time such as `{days: 30}` (`seconds`, `minutes`, `hours`, `days`, `weeks`, `months`, `years`), which averages the points in the span ending at each point, so gaps and uneven spacing average over the same length of time. A span starts at the first point, averaging the points it holds so far; on any other axis it falls back to 7 points, with a console warning.
217
+ - `center`: centers a moving average's window on each point instead of ending it there (default `false`).
218
+ - `bands`: a moving average's bands (Bollinger bands), as how many standard deviations of each window they sit from the average (default `2`); `false` drops them. `confidenceConfig` styles them.
216
219
  - `confidence`: draws a confidence band around a linear fit (default `false`).
217
220
  - `confidenceLevel`: the band's confidence level (default `0.95`).
218
221
  - `confidenceConfig`: Area shape config for the band (default `{fillOpacity: 0.15}`; fill defaults to the line color).
219
- - `projection`: extends each line past the end of its data, by a number of steps at the data's own spacing (e.g. `5` more years), or to an end value with `{to: 2030}` (default `0`, off). The axis widens to fit, and a linear fit's band becomes a prediction interval that fans out over the projection. Hovering a projected step lists each series' projected value. Ignored on a category axis.
222
+ - `projection`: extends each regression line (not a moving average) past the end of its data, by a number of steps at the data's own spacing (e.g. `5` more years), or to an end value with `{to: 2030}` (default `0`, off). The axis widens to fit, and a linear fit's band becomes a prediction interval that fans out over the projection. Hovering a projected step lists each series' projected value. Ignored on a category axis.
220
223
  - `projectionConfig`: Line shape config for the projected stretch, over the line's own styles (default `{strokeDasharray: "2 4"}`).
221
224
  - `tooltip`: shows the fitted equation and R² when hovering a line (default `true`).
222
225
  - Any other key (`stroke`, `strokeWidth`, `strokeDasharray`, …) styles the Line shape.
@@ -262,9 +265,9 @@ export default class Plot extends Viz {
262
265
  */
263
266
  stackOrder(_?: StackOrderInput): this | StackOrderFn | string[];
264
267
  /**
265
- Accessor function or string key for the x-axis value of each data point.
268
+ Accessor function or string key for the x-axis value of each data point. An Array of keys or accessors, outermost first, plots a multi-level category axis: `["year", "quarter"]` places each row at its quarter within its year, labels each tick with its quarter, and labels each year once, centered under its quarters, with a divider between neighboring years. The axis is the chart's discrete axis (a chart without `discrete` infers it, as for any text values); tooltips name every level. See `xConfig`'s `levelConfig`, `levelDividerConfig`, and `levelFormat` for their style and text.
266
269
  */
267
- x(_?: PlotAccessorArg): this | PlotAccessor;
270
+ x(_?: PlotAxisArg): this | PlotAccessor;
268
271
  /**
269
272
  Accessor function or string key for the secondary x-axis value of each data point.
270
273
  */
@@ -278,9 +281,9 @@ export default class Plot extends Viz {
278
281
  */
279
282
  x2Config(_?: Record<string, unknown>): this | Record<string, unknown>;
280
283
  /**
281
- Accessor function or string key for the y-axis value of each data point.
284
+ Accessor function or string key for the y-axis value of each data point. An Array of keys or accessors, outermost first, plots a multi-level category axis: `["year", "quarter"]` places each row at its quarter within its year, labels each tick with its quarter, and labels each year once, centered under its quarters, with a divider between neighboring years. The axis is the chart's discrete axis (a chart without `discrete` infers it, as for any text values); tooltips name every level. See `yConfig`'s `levelConfig`, `levelDividerConfig`, and `levelFormat` for their style and text.
282
285
  */
283
- y(_?: PlotAccessorArg): this | PlotAccessor;
286
+ y(_?: PlotAxisArg): this | PlotAccessor;
284
287
  /**
285
288
  Accessor function or string key for the secondary y-axis value of each data point.
286
289
  */
@@ -0,0 +1,31 @@
1
+ import type { VizInstance } from "../viz/vizTypes.js";
2
+ /**
3
+ Whether any of an axis's values is text: a string that doesn't read as a
4
+ number (`"2019"` and `"1.5"` read as numbers).
5
+ @param values The axis's values.
6
+ */
7
+ export declare function hasCategoryValues(values: readonly unknown[]): boolean;
8
+ /**
9
+ The axis a Plot with no `discrete` setting draws as discrete: the axis
10
+ whose values include text (see `hasCategoryValues`), or, when both do,
11
+ the one with fewer distinct values (`"x"` on a tie). With no text on
12
+ either axis (or only on a time axis, one that plots `time` or reads
13
+ dates through a time scale or `rangeBreaks`), `"x"` when any row draws
14
+ a Bar, Area, or Box (see `drawsDiscreteShapes`). Beside a swarm along
15
+ `"x"` or `"y"`, those shapes stand across it, on the other axis.
16
+ Undefined when `discrete` is set, when a Plot of only circles swarms (a
17
+ swarm lays out its own categories; `"auto"` swarms only a single axis
18
+ of numbers, which has no text), or when neither axis has text and no
19
+ row draws a Bar, Area, or Box.
20
+ @param viz The Plot.
21
+ */
22
+ export declare function inferDiscrete(viz: VizInstance): "x" | "y" | undefined;
23
+ /**
24
+ Notes the discrete axis a Plot infers for this draw (`viz._discrete`,
25
+ see `inferDiscrete`), which `vizDiscrete` reads when `discrete` is unset,
26
+ and the baseline its bars and areas grow from when it sets none
27
+ (`viz._shapeBaseline`,
28
+ see `shapeBaseline`).
29
+ @param viz The Plot.
30
+ */
31
+ export declare function resolveDiscrete(viz: VizInstance): void;
@@ -0,0 +1,45 @@
1
+ /**
2
+ Plot's `jitter`: point marks on a category axis spread across their
3
+ category's band, each by an offset seeded from its id, so a redraw, a
4
+ resize, or a filter never moves a point within its band. The same band
5
+ sizes the ticks of a barcode plot (the Tick shape).
6
+ */
7
+ import type { DataPoint } from "@d3plus/data";
8
+ import type { PlotAxisFn } from "../features/plotPaint.js";
9
+ import type { VizInstance } from "../viz/vizTypes.js";
10
+ /** The share of its band a Tick spans unless `shapeConfig.Tick.length` sets it. */
11
+ export declare const DEFAULT_TICK_LENGTH = 0.6;
12
+ /** What `plotBand` reads from a Plot shape emit. */
13
+ export interface BandInputs {
14
+ viz: VizInstance;
15
+ values: DataPoint[];
16
+ x: PlotAxisFn;
17
+ y: PlotAxisFn;
18
+ xDomain: unknown[];
19
+ yDomain: unknown[];
20
+ xRange: number[];
21
+ yRange: number[];
22
+ }
23
+ /** A Plot's band: the axis it runs across and its width in pixels. */
24
+ export interface Band {
25
+ axis: "x" | "y";
26
+ step: number;
27
+ }
28
+ /**
29
+ The band a Plot's point marks sit in: across its `discrete` axis, as
30
+ wide as the gap between neighboring categories (or neighboring values,
31
+ on a continuous discrete axis). Null without a `discrete` axis.
32
+ @param inputs The shape emit's rows, scales, domains, and ranges.
33
+ */
34
+ export declare function plotBand(inputs: BandInputs): Band | null;
35
+ /**
36
+ Each jittered row's position across its band: its category's center plus
37
+ its seeded offset times `width` of the band. Null when `jitter` is off or
38
+ the Plot has no band.
39
+ @param inputs The shape emit's rows, scales, domains, and ranges.
40
+ @param setting The `jitter` setting.
41
+ */
42
+ export declare function jitterAccessor(inputs: BandInputs, setting: unknown): {
43
+ axis: "x" | "y";
44
+ at: (d: DataPoint) => number;
45
+ } | null;
@@ -19,6 +19,19 @@ export interface LineLabelConfig {
19
19
  value?: boolean;
20
20
  /** Formats the value (defaults to the y axis's tick format). */
21
21
  valueFormat?: LineLabelValueFormat;
22
+ /**
23
+ For `lineLabels: "along"`: the tightest a label may bend toward its
24
+ text (where its letters' tops crowd together), as a radius in ems; it
25
+ may bend away from its text twice as tightly. A line with no stretch
26
+ that gentle goes unlabeled. `0` sets no limit. Defaults to `4`.
27
+ */
28
+ minRadius?: number;
29
+ /**
30
+ For `lineLabels: "along"`: the steepest a label's stretch may climb or
31
+ fall from end to end, in degrees. A line with no stretch that level
32
+ goes unlabeled. `90` or more sets no limit. Defaults to `45`.
33
+ */
34
+ maxSlope?: number;
22
35
  }
23
36
  /**
24
37
  The ends a `lineLabels` value labels, left end first: `true` and `"end"`
@@ -41,6 +54,12 @@ export declare function rowLabelsAlong(setting: LineLabelsSetting | null | undef
41
54
  off: `valueFormat` when set, else `format` (the y axis's own).
42
55
  */
43
56
  export declare function lineLabelValue(config: LineLabelConfig | undefined, value: unknown, d: DataPoint, i: number, format: (value: unknown) => string): string | undefined;
57
+ /**
58
+ The series name a line label shows: `name` (the Line shape's own `label`,
59
+ a value or a function of the row) when it is set, else `fallback()`.
60
+ False when `name` is, or returns, `false`: that line goes unlabeled.
61
+ */
62
+ export declare function lineLabelName<D>(name: unknown, d: D, i: number, fallback: () => unknown): unknown;
44
63
  /** A line label's text: the series name, followed by its value when there is one. */
45
64
  export declare function lineLabelText(name: unknown, value?: string): string;
46
65
  /**
@@ -1,6 +1,15 @@
1
1
  import type { SceneNode } from "@d3plus/render";
2
2
  import type { Edges, Pt } from "../features/pathLabelGeometry.js";
3
3
  import type { VizInstance } from "../viz/vizTypes.js";
4
+ /** The steepest stretch a line's label runs along by default, in degrees: past 45°, it would read more up than across. */
5
+ export declare const LINE_LABEL_MAX_SLOPE = 45;
6
+ /**
7
+ Reads `lineLabelConfig.maxSlope` (in degrees) as the radians a stretch
8
+ may climb or fall: undefined, for no limit, at 90° or more, and
9
+ `LINE_LABEL_MAX_SLOPE` when it is missing or not a positive number.
10
+ @param value The configured `maxSlope`.
11
+ */
12
+ export declare function lineLabelMaxSlope(value: unknown): number | undefined;
4
13
  /**
5
14
  Obstacle points, bucketed by cell for nearest-distance lookups. Each
6
15
  point may carry a tag, so a lookup can ignore the points of the line a
@@ -32,11 +41,6 @@ export declare class PointGrid {
32
41
  @param step The spacing.
33
42
  */
34
43
  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
44
  /** What scoring a stretch needs. */
41
45
  export interface StretchContext {
42
46
  grid: PointGrid;
@@ -56,6 +60,10 @@ export interface StretchContext {
56
60
  ignore?: number;
57
61
  /** The most a stretch may turn in all, in radians (default a right angle). */
58
62
  maxTurn?: number;
63
+ /** The tightest its text's baseline may bend toward the text, in ems (see `bendStrain`). Defaults to `PATH_LABEL_INNER_RADIUS`. */
64
+ minRadius?: number;
65
+ /** The steepest a stretch may climb or fall from end to end, in radians (see `stretchSlope`). No limit by default. */
66
+ maxSlope?: number;
59
67
  }
60
68
  /**
61
69
  The points a label along `points` would cover: its baseline and two rows
@@ -83,7 +91,12 @@ export interface StretchSpot {
83
91
  /**
84
92
  The best-scoring stretch of `length` pixels along any of a line's
85
93
  pieces, upright, with where it lies, or null when every stretch is
86
- blocked or too bent.
94
+ blocked, too steep, or too bent: climbing or falling more steeply than
95
+ `maxSlope`, turning more than `maxTurn` in all, or with its text's
96
+ baseline bending tighter than `minRadius` allows (see `textFollows`).
97
+ Pass the
98
+ pieces through `smoothPolyline` first, so kinks shorter than a letter
99
+ don't rule a stretch out.
87
100
  @param pieces The line's pieces (where its data has gaps), in pixels.
88
101
  @param length The stretch's length.
89
102
  @param ctx The obstacles, plot area, and font.