@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
@@ -0,0 +1,30 @@
1
+ /**
2
+ The zoom-control buttons' actions, for a chart's `zoomIn`, `zoomOut`,
3
+ `zoomReset`, and `zoomBrush` methods: buttons of a page's own can zoom a
4
+ chart exactly as the built-in ones do, shown or not.
5
+
6
+ @module
7
+ */
8
+ import type Viz from "../viz/Viz.js";
9
+ /**
10
+ Whether a chart can zoom right now: `zoom` is on and it has rendered, so
11
+ its zoom surface and brush are in place.
12
+ @param viz The chart.
13
+ */
14
+ export declare function canZoom(viz: Viz): boolean;
15
+ /**
16
+ Zooms by `factor` about the chart area's center, as the zoom-in (`factor`
17
+ is `zoomFactor`) and zoom-out (`1 / zoomFactor`) buttons do, or resets to
18
+ the initial view for `0`, as the reset button does. Does nothing while
19
+ the chart can't zoom (see `canZoom`).
20
+ @param viz The chart.
21
+ @param factor The zoom multiplier, or 0 to reset.
22
+ */
23
+ export declare function zoomBy(viz: Viz, factor: number): void;
24
+ /**
25
+ Turns brush mode on or off, as the brush button does, and has the button
26
+ (when it shows) report it. Does nothing while the chart can't zoom.
27
+ @param viz The chart.
28
+ @param on Whether brush mode is on.
29
+ */
30
+ export declare function setZoomBrush(viz: Viz, on: boolean): void;
@@ -1,6 +1,7 @@
1
1
  import type { ZoomTransform } from "d3-zoom";
2
2
  import type { FeatureModule } from "../features/features.js";
3
3
  import type Viz from "../viz/Viz.js";
4
+ import type { SelectTool } from "./selectRegion.js";
4
5
  /**
5
6
  @name zoomFeature
6
7
  Sets up zoom + brush event behaviors and the zoom-control buttons.
@@ -15,7 +16,7 @@ import type Viz from "../viz/Viz.js";
15
16
  1. Installs stateful D3 zoom + brush behaviors (`viz._zoomBehavior`,
16
17
  `viz._zoomBrush`) and wires `viz._zoomToBounds`. d3-zoom binds to
17
18
  the SVG element directly via `viz._container.call(zoomBehavior)`.
18
- 2. Returns the four control buttons (in/out/reset/brush) as an
19
+ 2. Returns the control buttons (in/out/reset/brush/box/lasso) as an
19
20
  `htmlOverlay` scene-node panel; `runVizPipeline` appends it to
20
21
  `viz._featurePanels`. `onUpdate` is the scene's interactive-HTML
21
22
  escape hook: it wires the hover handlers + applies the user's
@@ -41,12 +42,13 @@ export declare const zoomFeature: FeatureModule;
41
42
  */
42
43
  export declare function bindCanvasZoom(viz: Viz): void;
43
44
  /**
44
- Routes pointer events between the chart surface and the zoom brush.
45
- While brush mode is on, the outer <svg> goes transparent to pointer
46
- events and only the brush group opts back in, so a drag anywhere over the
47
- chart (shapes included) reaches the brush rather than a shape. On the
48
- Canvas backend the compute <svg> stays transparent otherwise, so the
49
- <canvas> beneath is the interaction surface.
45
+ Routes pointer events between the chart surface, the zoom brush, and
46
+ box and lasso selection (see `syncSelectSurface`). While brush mode is
47
+ on, the outer <svg> goes transparent to pointer events and only the
48
+ brush group opts back in, so a drag anywhere over the chart (shapes
49
+ included) reaches the brush rather than a shape. On the Canvas backend
50
+ the compute <svg> stays transparent otherwise, so the <canvas> beneath
51
+ is the interaction surface.
50
52
  */
51
53
  export declare function applyZoomPointerEvents(viz: Viz): void;
52
54
  /**
@@ -55,6 +57,29 @@ export declare function applyZoomPointerEvents(viz: Viz): void;
55
57
  the zoom behavior measures from (Geomap's imperative tile layer).
56
58
  */
57
59
  export declare function tileZoomTransform(viz: Viz): ZoomTransform;
60
+ /**
61
+ @name zoomEvents
62
+ Turns brush mode on or off, binding the zoom gestures to match: brush
63
+ mode hands every press to the zoom brush, and otherwise d3-zoom takes the
64
+ wheel, pinch, and pan (as `zoomScroll` and `zoomPan` allow) and the
65
+ `zoomDrag`/`zoomDoubleClick` gestures are bound beside it.
66
+ */
67
+ export declare function zoomEvents(this: Viz, brush?: boolean): void;
68
+ /**
69
+ Turns a select tool on (a drag draws a box or lasso, see
70
+ `selectGesture.ts`), or off again when it's the one already on, as the
71
+ box and lasso select buttons do. Turning one on leaves brush mode.
72
+ @param viz The chart.
73
+ @param tool The tool the button stands for.
74
+ */
75
+ export declare function toggleSelectTool(viz: Viz, tool: SelectTool): void;
76
+ /**
77
+ @name zoomMath
78
+ Zooms in or out by a multiplier about the chart area's center, as the
79
+ zoom-in and zoom-out buttons do; `0` resets to the initial view.
80
+ @param factor
81
+ */
82
+ export declare function zoomMath(this: Viz, factor?: number): void;
58
83
  /**
59
84
  Applies a programmatic zoom: clamps the scale to `scaleExtent` and the
60
85
  translate to `translateExtent` (the constraint d3-zoom enforces for
@@ -15,6 +15,12 @@ export { kebab };
15
15
  */
16
16
  export declare function isBrushing(viz: Viz): boolean;
17
17
  export declare function setBrushing(viz: Viz, value: boolean): void;
18
+ /**
19
+ Resets the select tool a drag uses to `selectMode` whenever `selectMode`
20
+ changes, so the config sets the tool a chart starts with and the
21
+ toolbar buttons switch it from there.
22
+ */
23
+ export declare function syncSelectTool(viz: Pick<Viz, "schema"> & Partial<Pick<Viz, "_selectTool" | "_selectModeSeen">>): void;
18
24
  /** Paints a zoom-control button's inline style for its current state (base/hover/active) — see `paintControlButton`. */
19
25
  export declare function paintZoomButton(viz: Viz, btn: HTMLElement, hovered?: boolean): void;
20
26
  /**
@@ -81,7 +87,7 @@ export declare const ICON_ATTRS = "viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"
81
87
  */
82
88
  export type ZoomControlIconRenderer = (el: HTMLElement) => void | (() => void);
83
89
  export type ZoomControlIconValue = string | ZoomControlIconRenderer;
84
- export type ZoomControlIconKey = "zoomIn" | "zoomOut" | "zoomReset" | "zoomBrush";
90
+ export type ZoomControlIconKey = "zoomIn" | "zoomOut" | "zoomReset" | "zoomBrush" | "selectBox" | "selectLasso";
85
91
  export type ZoomControlIcons = Partial<Record<ZoomControlIconKey, ZoomControlIconValue>>;
86
92
  /** How far the zoom buttons sit in from the chart's top and right edges. */
87
93
  export declare const ZOOM_PANEL_PADDING = 4;
@@ -93,18 +99,54 @@ export declare const ZOOM_PANEL_PADDING = 4;
93
99
  `padding` (with `box-sizing: border-box`) one 4px inset from the chart's
94
100
  top/right edge. This isn't part of the auto-disable `zoomControlClassName`
95
101
  triggers, so a host page never has to re-add its own spacing utility.
102
+ The panel spans the chart's width, so it lets the pointer through to
103
+ whatever it covers (a color scale's axis, a title) and only its buttons
104
+ (see `zoomControlsHtml`) take it.
96
105
  */
97
106
  export declare const ZOOM_PANEL_STYLE: Record<string, string>;
98
107
  /**
99
- The four buttons' markup. Real <button>s (not <div>s) so a host page's own
100
- button styling (Tailwind, Bootstrap, a design system's global `button`
101
- reset) applies through the cascade once a `zoomControlClassName`
102
- auto-disables the inline defaults. `zoomControlClassName` layers a
103
- consumer's own class onto each button without losing the fixed classes
104
- event delegation depends on. The brush toggle carries `aria-pressed` (and
105
- the `.active` class frameworks like Bootstrap style) while brush mode is on.
108
+ Registers how wide the chart's top-left controls are, which the zoom
109
+ buttons keep clear of on a narrow chart by moving the ones that don't
110
+ fit into the "More Controls" menu. `topLeftControls.ts` registers it: it
111
+ can't be imported here, since the top-left controls' own modules import
112
+ this one.
113
+ @param fn The top-left controls' width for a chart, padding included.
114
+ */
115
+ export declare function reserveZoomControlsLeft(fn: (viz: Viz) => number): void;
116
+ /** One zoom-control button: its icon key, class, label, icon, and pressed state (for a toggle). */
117
+ export interface ZoomButtonSpec {
118
+ key: ZoomControlIconKey;
119
+ cls: string;
120
+ label: string;
121
+ icon: string;
122
+ pressed?: boolean;
123
+ }
124
+ /** The six buttons, in their order: zoom in, zoom out, reset, brush, box select, lasso select. */
125
+ export declare function zoomButtonSpecs(viz: Viz): ZoomButtonSpec[];
126
+ /** The "More Controls" button's icon: three dots in a row. */
127
+ export declare const ZOOM_MORE_ICON = "<svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" style=\"width:12px;height:12px;vertical-align:middle;flex-shrink:0\"><circle cx=\"5\" cy=\"12\" r=\"1\"/><circle cx=\"12\" cy=\"12\" r=\"1\"/><circle cx=\"19\" cy=\"12\" r=\"1\"/></svg>";
128
+ /** The label of the button that opens the menu of buttons that don't fit. */
129
+ export declare const ZOOM_MORE_LABEL = "More Controls";
130
+ /** The menu's fixed layout while closed; the menu shows by setting `display: flex`. */
131
+ export declare const ZOOM_MENU_STYLE: Record<string, string>;
132
+ /** Each menu item's fixed layout: its icon beside its label. */
133
+ export declare const ZOOM_MENU_ITEM_STYLE: Record<string, string>;
134
+ /**
135
+ The panel's markup: as many of the six buttons as fit beside the
136
+ top-left controls (`visible`, see `zoomControlsBox`), in order, and the
137
+ rest in a "More Controls" menu. Real <button>s (not <div>s) so a host
138
+ page's own button styling (Tailwind, Bootstrap, a design system's global
139
+ `button` reset) applies through the cascade once a
140
+ `zoomControlClassName` auto-disables the inline defaults.
141
+ `zoomControlClassName` layers a consumer's own class onto each button
142
+ without losing the fixed classes event delegation depends on. A toggle
143
+ (brush, box, lasso) carries `aria-pressed` (and the `.active` class
144
+ frameworks like Bootstrap style) while it is on. Each button takes the
145
+ pointer back from the panel (`ZOOM_PANEL_STYLE`).
146
+ @param viz The chart.
147
+ @param visible How many buttons show before the menu; all of them by default.
106
148
  */
107
- export declare function zoomControlsHtml(viz: Viz): string;
149
+ export declare function zoomControlsHtml(viz: Viz, visible?: number): string;
108
150
  /**
109
151
  Mounts each configured custom icon function into its button's reserved
110
152
  slot — called once per fresh button element (from the same `onUpdate`
@@ -124,17 +166,63 @@ export declare function overlayHost(viz: Viz): HTMLElement | null;
124
166
  a click on the button itself — e.g. leaving brush mode after a selection.
125
167
  */
126
168
  export declare function syncBrushButton(viz: Viz): void;
127
- /** Whether a chart shows the zoom-control panel. */
169
+ /** Reflects the select tool onto the box and lasso select buttons, as `syncBrushButton` does for brush mode. */
170
+ export declare function syncSelectButtons(viz: Viz): void;
171
+ /**
172
+ Shows the icon of a tool that is on while its button sits in the "More
173
+ Controls" menu on that menu's button (pressed), or three dots.
174
+ */
175
+ export declare function syncMoreButton(viz: Viz): void;
176
+ /** Whether a chart shows the zoom-control panel: it zooms, and `zoomControls` isn't false. */
128
177
  export declare function showsZoomControls(viz: Viz): boolean;
178
+ /**
179
+ The zoom-control panel's measured size (padding included); how many of
180
+ its six buttons show before the "More Controls" menu takes the rest; and
181
+ the width of its four zoom buttons alone (zoom in, zoom out, reset,
182
+ brush), which the minimap matches.
183
+ */
184
+ export interface ZoomControlsBox {
185
+ width: number;
186
+ height: number;
187
+ visible: number;
188
+ zoomWidth: number;
189
+ }
190
+ /** A measured panel: its buttons' widths, the "More Controls" button's, and its spacing. */
191
+ export interface ZoomPanelMetrics {
192
+ widths: number[];
193
+ more: number;
194
+ gap: number;
195
+ padLeft: number;
196
+ padRight: number;
197
+ height: number;
198
+ }
199
+ /**
200
+ Lays the panel out in `available` pixels: every button when they all
201
+ fit, else as many as fit (in order) beside the "More Controls" button,
202
+ which takes the rest. Returns the panel's size and how many buttons show.
203
+ @param m The measured panel (see `ZoomPanelMetrics`).
204
+ @param available The room from the chart's right edge to the top-left controls.
205
+ */
206
+ export declare function fitZoomPanel(m: ZoomPanelMetrics, available: number): ZoomControlsBox;
129
207
  /**
130
208
  The zoom-control panel's size (padding included) as it will render in the
131
- chart's page, so top-positioned content can leave room for it. Measured
132
- by mounting a hidden copy beside the chart — the buttons' size depends on
133
- the host page's CSS (a `zoomControlClassName`, a global `button` reset) —
134
- and cached until the markup or styling changes. Returns null when the
135
- chart shows no controls.
209
+ chart's page, so top-positioned content can leave room for it, and how
210
+ many buttons fit beside the top-left controls (see `fitZoomPanel`).
211
+ Measured by mounting a hidden copy of every button beside the chart — the
212
+ buttons' size depends on the host page's CSS (a `zoomControlClassName`, a
213
+ global `button` reset) — and cached until the markup, styling, or room
214
+ changes. Returns null when the chart shows no controls.
215
+ */
216
+ export declare function zoomControlsBox(viz: Viz): ZoomControlsBox | null;
217
+ /**
218
+ The box the minimap hangs beneath: as wide as the zoom-control panel's
219
+ four zoom buttons (it sits flush with the panel's right edge) and as tall
220
+ as the panel, or, with the buttons hidden (`zoomControls: false`), a
221
+ strip as wide as the default zoom buttons down to the chart area's top, so the minimap overlays the chart
222
+ area rather than the title and other top content that take the
223
+ buttons' room. Null when the chart doesn't zoom.
136
224
  */
137
- export declare function zoomControlsBox(viz: Viz): {
225
+ export declare function minimapAnchor(viz: Viz): {
138
226
  width: number;
139
227
  height: number;
140
228
  } | null;
@@ -0,0 +1,30 @@
1
+ /**
2
+ The "More Controls" menu of the zoom controls: on a chart too narrow
3
+ for all six buttons beside the top-left controls, the ones that don't fit
4
+ move into it (see `zoomControlsHtml`). A menu button, as the download
5
+ button's is: a click or Enter opens it, the arrow keys, Home, and End
6
+ move between its items, Escape closes it and returns focus to the
7
+ button, and a click outside or Tab away closes it. Picking an item runs
8
+ its button's action (the panel's own delegated handlers match the item
9
+ by the same class) and closes the menu.
10
+
11
+ The menu's open state lives only in the DOM (its `display` and the
12
+ button's `aria-expanded`), never in the generated html, so opening it
13
+ neither changes the panel's measured size nor makes the next repaint
14
+ rewrite the open menu.
15
+
16
+ @module
17
+ */
18
+ import type Viz from "../viz/Viz.js";
19
+ /** Whether the menu inside `root` is open. */
20
+ export declare function isZoomMenuOpen(root: HTMLElement): boolean;
21
+ /** Closes the menu inside `root`, returning focus to its button when `refocus`. */
22
+ export declare function closeZoomMenu(viz: Viz, root: HTMLElement, refocus?: boolean): void;
23
+ /** Opens the menu inside `root` and focuses its first (or last) item. */
24
+ export declare function openZoomMenu(viz: Viz, root: HTMLElement, focus?: "first" | "last"): void;
25
+ /**
26
+ The menu's delegated event handlers, merged into the zoom panel's (after
27
+ the buttons' own, so an item runs its action before the menu closes).
28
+ @param viz The chart.
29
+ */
30
+ export declare function zoomMenuEvents(viz: Viz): Record<string, Record<string, (e: Event) => void>>;
@@ -0,0 +1,73 @@
1
+ /**
2
+ The pointer gestures a chart zooms by beyond d3-zoom's own pan and wheel:
3
+ a mouse drag that draws a box to zoom into (`zoomDrag: "brush"`), and
4
+ what a double-click does (`zoomDoubleClick`).
5
+
6
+ The drawn box needs no brush overlay over the chart: the press listens on
7
+ the zoom surface beside the chart's own pointer listeners, so a click
8
+ that doesn't drag still reaches the shape under it, and hover still
9
+ works until a drag begins. Once one does, it reuses the brush mode's
10
+ pieces: the zoom brush shows the box (with its styles), and releasing
11
+ zooms to it through `viz._zoomToBounds`.
12
+
13
+ @module
14
+ */
15
+ import type Viz from "../viz/Viz.js";
16
+ /** A point in the zoom surface's coordinates. */
17
+ export type Point = [number, number];
18
+ /** A box's top-left and bottom-right corners. */
19
+ export type Box = [Point, Point];
20
+ /** How far (px) a press moves before it draws a box instead of clicking. */
21
+ export declare const BOX_DRAG_DISTANCE = 3;
22
+ /**
23
+ Clamps a point into a box.
24
+ @param point The point.
25
+ @param box The box.
26
+ */
27
+ export declare function clampPoint([x, y]: Point, [[x0, y0], [x1, y1]]: Box): Point;
28
+ /**
29
+ The box two corners span, whichever way the drag went.
30
+ @param a One corner.
31
+ @param b The opposite corner.
32
+ */
33
+ export declare function spanBox(a: Point, b: Point): Box;
34
+ /**
35
+ Whether a point lies in a box, edges included.
36
+ @param point The point.
37
+ @param box The box.
38
+ */
39
+ export declare function inBox([x, y]: Point, [[x0, y0], [x1, y1]]: Box): boolean;
40
+ /**
41
+ Whether a press at `at` may draw a zoom box: the primary button with no
42
+ modifier key (Shift + drag pans), the first press of a click (not the
43
+ second of a double-click), inside the chart area, and not on a brush
44
+ (the timeline's).
45
+ @param event The mousedown.
46
+ @param at The press, in the zoom surface's coordinates.
47
+ @param area The chart area, in the same coordinates.
48
+ */
49
+ export declare function startsBoxDrag(event: MouseEvent, at: Point, area: Box): boolean;
50
+ /**
51
+ Whether a move from `from` to `to` (client pixels) has gone far enough
52
+ to be a drag rather than a click.
53
+ @param from Where the press began.
54
+ @param to Where the pointer is now.
55
+ */
56
+ export declare function dragsFar(from: Point, to: Point): boolean;
57
+ /** Swallows the click a drag ends with, so it reaches no shape. */
58
+ export declare function suppressClick(view: Window): void;
59
+ /**
60
+ Binds the gestures this module adds to the zoom surface, after d3-zoom's
61
+ own: the drawn zoom box for `zoomDrag: "brush"`, and the double-click
62
+ for `zoomDoubleClick`.
63
+ @param viz The chart.
64
+ @param tgt The element d3-zoom is bound to.
65
+ @param reset Returns the chart to its initial view.
66
+ */
67
+ export declare function bindZoomGestures(viz: Viz, tgt: NonNullable<Viz["_zoomEventTarget"]>, reset: () => void): void;
68
+ /**
69
+ Removes the gestures `bindZoomGestures` added (d3-zoom's own listeners,
70
+ the double-click included, go with `.on(".zoom", null)`).
71
+ @param tgt The element they were bound to.
72
+ */
73
+ export declare function unbindZoomGestures(tgt: NonNullable<Viz["_zoomEventTarget"]>): void;
@@ -0,0 +1,30 @@
1
+ import type Viz from "../viz/Viz.js";
2
+ /** Bounds in the zoom surface's unzoomed coordinates: top-left, bottom-right. */
3
+ export type Bounds = [[number, number], [number, number]];
4
+ /** A zoom transform: scale `k`, then translate by `x`, `y`. */
5
+ export interface FitTransform {
6
+ k: number;
7
+ x: number;
8
+ y: number;
9
+ }
10
+ /**
11
+ Which screen dimensions the zoom actually scales. Every chart zooms its
12
+ picture uniformly, except a Plot, which rescales only its linear and time
13
+ axes: a LinePlot or a bar chart with a discrete x axis zooms vertically
14
+ alone.
15
+ @param viz The chart.
16
+ */
17
+ export declare function zoomedDims(viz: Viz): {
18
+ x: boolean;
19
+ y: boolean;
20
+ };
21
+ /**
22
+ The zoom transform that fits `bounds` (unzoomed surface coordinates) to
23
+ the chart's zoom area along each dimension the zoom scales (see
24
+ `zoomedDims`): the dimension with less room fills the area, and the other
25
+ is centered in it. A dimension the zoom doesn't scale (a Plot's discrete
26
+ axis) has no say in the scale.
27
+ @param viz The chart.
28
+ @param bounds The bounds to show.
29
+ */
30
+ export declare function fitBounds(viz: Viz, bounds: Bounds): FitTransform;
@@ -30,15 +30,18 @@ export declare function facetAreaMargin(viz: Pick<VizInstance, "schema">, area:
30
30
  export declare function panelLabels(cell: FacetCell, outer: boolean | FacetLabels): FacetLabels;
31
31
  /** The panel titles' style: `titleConfig`, defaulting its color to contrast with the chart's background. */
32
32
  export declare function facetTitleStyle(viz: Pick<VizInstance, "schema" | "_select">, config: ResolvedFacetConfig): Record<string, unknown>;
33
- /** Each panel's title text (empty when titles are off). */
33
+ /**
34
+ Each panel's title text (empty when titles are off), with dates written
35
+ in UTC with `utc`.
36
+ */
34
37
  export declare function facetTitleTexts(config: Pick<ResolvedFacetConfig, "title">, panels: {
35
38
  value: FacetValue;
36
39
  data: DataPoint[];
37
- }[]): string[];
40
+ }[], utc?: boolean): string[];
38
41
  /** The height every panel reserves for its title: the tallest title at its cell's width. */
39
42
  export declare function facetTitleBand(viz: Pick<VizInstance, "schema">, texts: string[], cells: FacetCell[], style: Record<string, unknown>): number;
40
43
  /** Where a panel's title goes: above its cell, across its base area. */
41
- export declare function panelTitle(text: string, cell: FacetCell, base: FacetArea): FacetTitle;
44
+ export declare function panelTitle(text: string, cell: FacetCell, base: FacetArea, tooltip?: string): FacetTitle;
42
45
  /**
43
46
  Draws `viz` as small multiples. Returns false (drawing nothing) when
44
47
  there's nothing to split: no facet values, or no rows passing the
@@ -7,6 +7,8 @@
7
7
  import type { DataPoint } from "@d3plus/data";
8
8
  import type { SceneNode, Transform } from "@d3plus/render";
9
9
  import type { FacetSides } from "./facetGutter.js";
10
+ import type { FacetLayout } from "./facetLayout.js";
11
+ import type { FacetLayoutCell } from "./facetLayouts.js";
10
12
  import type { VizInstance } from "../viz/vizTypes.js";
11
13
  /** A value that splits the data into panels. */
12
14
  export type FacetValue = string | number | boolean | Date;
@@ -31,7 +33,7 @@ export type FacetConfig = {
31
33
  padding?: number;
32
34
  /** Panel order. Defaults to `"ascending"`. */
33
35
  sort?: FacetSort;
34
- /** Whether every panel shares one set of scales (`"shared"`) or fits its own (`"independent"`). Applies to charts with axes, where it defaults to `"shared"`, and to Funnel's stage widths and the value domains of PolarArea and RadialBar, where it defaults to `"independent"`. */
36
+ /** Whether every panel shares one set of scales (`"shared"`) or fits its own (`"independent"`). Applies to charts with axes, where it defaults to `"shared"`, and to Funnel's stage widths and the value domains of PolarArea, RadialBar, RadialLine and RadialArea, where it defaults to `"independent"`. */
35
37
  scales?: "shared" | "independent";
36
38
  /** With shared scales, `"outer"` labels axes only along the grid's left and bottom edges; `"all"` labels every panel. An object sets each axis on its own (`{x: "all", y: "outer"}`): every panel then labels its x axis, only the left column labels its y axis, and the panels' plot areas line up. Defaults to `"outer"`, except on charts whose axis labels differ from panel to panel: BumpChart labels every axis on every panel, and Marimekko labels its categories on every panel and its 0–100% share axis only on the outer edge, even with independent scales. */
37
39
  axes?: FacetAxes;
@@ -39,6 +41,20 @@ export type FacetConfig = {
39
41
  title?: false | ((value: FacetValue, data: DataPoint[]) => string);
40
42
  /** TextBox config for the panel titles (`fontSize`, `fontColor`, `fontWeight`, `textAnchor`, `padding`, …). */
41
43
  titleConfig?: Record<string, unknown>;
44
+ /**
45
+ Places each panel on a map-shaped grid instead of filling rows: a
46
+ named grid, `"us-states"` (the 50 states and DC), `"eu-countries"`
47
+ (the 27 EU members), or `"world-regions"` (the World Bank's seven
48
+ regions), or a grid of your own as `{[value]: [row, column]}` (from
49
+ 0, top left). A facet value takes the cell whose code or name it
50
+ matches (ignoring case): a state's postal code or name, a country's
51
+ ISO alpha-2 or alpha-3 code or name. Cells without a panel stay empty,
52
+ values the grid doesn't hold are left out (with a warning), and
53
+ `columns`, `rows`, and `sort` don't apply. A named grid titles each
54
+ panel with its short code and shows the full name when the title is
55
+ hovered, and above the title of each of its marks' tooltips.
56
+ */
57
+ layout?: FacetLayout;
42
58
  };
43
59
  /** `facetConfig` with every option resolved. */
44
60
  export interface ResolvedFacetConfig {
@@ -53,6 +69,8 @@ export interface ResolvedFacetConfig {
53
69
  /** `false` hides panel titles; undefined draws the default (the formatted facet value). */
54
70
  title?: false | ((value: FacetValue, data: DataPoint[]) => string);
55
71
  titleConfig: Record<string, unknown>;
72
+ /** The map-shaped grid's cells (see `FacetConfig.layout`), when it names a valid one. */
73
+ layout?: FacetLayoutCell[];
56
74
  }
57
75
  /** Which edges of the grid a panel sits on. A panel with no panel below it is on the bottom edge. */
58
76
  export interface FacetEdges {
@@ -128,6 +146,20 @@ export interface FacetHooks {
128
146
  would otherwise draw once for the whole chart, or not at all.
129
147
  */
130
148
  scene?: (viz: VizInstance, nodes: SceneNode[]) => SceneNode[];
149
+ /**
150
+ Whether every panel's plot area is lined up with the others' even
151
+ when both axes label only the grid's outer edges: for a chart whose
152
+ edge panels label different scales (a ScatterMatrix's rows), so
153
+ their labels take different room. Every panel is then probed before
154
+ it draws (see `panelAlignment` in `facet/drawFacets.ts`).
155
+ */
156
+ align?: boolean;
157
+ /**
158
+ Runs after every panel has drawn; returning true draws the panels
159
+ again, for a chart that sizes its marks to fit every panel (DotPlot's
160
+ dots).
161
+ */
162
+ redraw?: (viz: VizInstance) => boolean;
131
163
  /** Captures the chart state (viz slots, by name) a panel puts back while the pointer is over it, for hover and tooltips (see `facet/facetPanel.ts`). */
132
164
  capture?: (viz: VizInstance) => Record<string, unknown>;
133
165
  }
@@ -148,6 +180,8 @@ export interface FacetPanelState {
148
180
  scene: SceneNode[];
149
181
  /** Chart state captured by `FacetHooks.capture`. */
150
182
  state: Record<string, unknown>;
183
+ /** The panel's place name on a named map-shaped grid (see `FacetConfig.layout`), which heads its marks' tooltips. */
184
+ name?: string;
151
185
  }
152
186
  /** Default panel title style: smaller than the chart title, centered over its panel. */
153
187
  export declare const FACET_TITLE_DEFAULTS: Record<string, unknown>;
@@ -43,5 +43,11 @@ export declare function facetGroups(viz: VizInstance, sort: FacetSort): FacetGro
43
43
  export declare function facetFilteredData(viz: VizInstance, rows: DataPoint[], timeFilter: ReturnType<typeof computeTimeFilter>): DataPoint[];
44
44
  /** The time filter every panel shares (see `facetFilteredData`). */
45
45
  export declare function facetTimeFilter(viz: VizInstance): ReturnType<typeof computeTimeFilter>;
46
- /** A panel's default title: its facet value, with dates formatted against every panel's date. */
47
- export declare function formatFacetValue(value: FacetValue, values: FacetValue[]): string;
46
+ /**
47
+ A panel's default title: its facet value, with dates formatted against
48
+ every panel's date.
49
+ @param value The panel's facet value.
50
+ @param values Every panel's facet value.
51
+ @param utc Write dates in UTC instead of local time (see `chartUtc`).
52
+ */
53
+ export declare function formatFacetValue(value: FacetValue, values: FacetValue[], utc?: boolean): string;
@@ -31,6 +31,16 @@ export interface FacetGridOptions {
31
31
  right: number;
32
32
  bottom: number;
33
33
  };
34
+ /** Each panel's cell on a map-shaped grid (see `FacetConfig.layout`), in place of filling rows. */
35
+ places?: {
36
+ row: number;
37
+ column: number;
38
+ }[];
39
+ /** The map-shaped grid's row and column counts. */
40
+ grid?: {
41
+ rows: number;
42
+ columns: number;
43
+ };
34
44
  }
35
45
  /**
36
46
  How large a chart of `aspect` can draw in a `width` × `height` box: the
@@ -58,5 +68,7 @@ export declare function facetDimensions(count: number, area: {
58
68
  edge (those with no panel below them) are deepened by `gutter.bottom`, so
59
69
  panels that draw axis labels the others skip keep the same plot area. A
60
70
  bottom-edge panel above an empty cell reaches into that cell's space.
71
+ With `places`, lays the panels out on that map-shaped grid instead (see
72
+ `layoutGridCells`).
61
73
  */
62
74
  export declare function facetGrid(count: number, area: FacetArea, opts: FacetGridOptions): FacetCell[];
@@ -33,11 +33,24 @@ export declare const LABEL_COMBOS: FacetLabels[];
33
33
  export declare function labelKey(labels: FacetLabels): string;
34
34
  /**
35
35
  How far each label combination's plot insets (measured from probe panels,
36
- keyed by `labelKey`) exceed the `baseline` panel's, per side, never
37
- negative. The baseline is the bare panel, or, when an axis is labeled on
38
- every panel, the panel labeling that axis alone.
36
+ keyed by `labelKey`) exceed the `baseline` panel's (or `bareInsets`, when
37
+ given), per side, never negative. The baseline is the bare panel, or,
38
+ when an axis is labeled on every panel, the panel labeling that axis
39
+ alone.
39
40
  */
40
- export declare function labelExpansions(insets: Record<string, FacetSides>, baseline?: FacetLabels): Record<string, FacetSides>;
41
+ export declare function labelExpansions(insets: Record<string, FacetSides>, baseline?: FacetLabels, bareInsets?: FacetSides): Record<string, FacetSides>;
42
+ /**
43
+ The room a label combination takes once its panel draws in the area
44
+ that room grows it to: starting from `room` (measured in the base
45
+ area), measures the panel's insets in the area grown by it (`measure`)
46
+ and takes how far they exceed a bare panel's (`bare`) as the new room,
47
+ until it moves less than half a pixel, or after `passes` measures.
48
+ @param room The room measured in the base area.
49
+ @param bare A bare panel's insets.
50
+ @param measure The panel's insets in its base area grown by some room.
51
+ @param passes The most measures to take.
52
+ */
53
+ export declare function settleExpansion(room: FacetSides, bare: FacetSides, measure: (grown: FacetSides) => FacetSides, passes?: number): FacetSides;
41
54
  /**
42
55
  The room the grid reserves on its outer edges: the y-labeled panels'
43
56
  extra room on the left, the x-labeled panels' on the bottom, and the most
@@ -47,7 +60,8 @@ export declare function labelExpansions(insets: Record<string, FacetSides>, base
47
60
  export declare function labelGutter(expansions: Record<string, FacetSides>): FacetSides;
48
61
  /**
49
62
  A panel's base area, the same size for every panel: its cell below the
50
- title band, less the gutter the grid added to the cell's outer edges.
63
+ title band, less the gutter the grid added to the cell's outer edges
64
+ (its left and bottom edges, and the grid's last column).
51
65
  */
52
66
  export declare function panelBase(cell: FacetCell, titleHeight: number, gutter: FacetSides, columns: number): FacetArea;
53
67
  /**