@d3plus/core 4.12.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 (839) hide show
  1. package/es/index.js +2 -2
  2. package/es/internal.js +155 -21
  3. package/es/src/charts/Alluvial/emit.js +3 -2
  4. package/es/src/charts/ArcDiagram/applyLayout.js +17 -10
  5. package/es/src/charts/ArcDiagram/arcGeometry.js +21 -8
  6. package/es/src/charts/ArcDiagram/arcLoops.js +5 -2
  7. package/es/src/charts/ArcDiagram/arcNodeBox.js +89 -0
  8. package/es/src/charts/ArcDiagram/emit.js +56 -27
  9. package/es/src/charts/ArcDiagram/events.js +10 -6
  10. package/es/src/charts/ArcDiagram/index.js +1 -1
  11. package/es/src/charts/BarChart/index.js +11 -0
  12. package/es/src/charts/BoxWhisker/extras.js +95 -0
  13. package/es/src/charts/BoxWhisker/index.js +77 -6
  14. package/es/src/charts/BoxWhisker/outliers.js +3 -2
  15. package/es/src/charts/BoxWhisker/summary.js +14 -3
  16. package/es/src/charts/BoxWhisker/tooltip.js +114 -29
  17. package/es/src/charts/BubbleChart/emit.js +9 -5
  18. package/es/src/charts/BubbleMatrix/colorDefaults.js +58 -0
  19. package/es/src/charts/BubbleMatrix/index.js +52 -0
  20. package/es/src/charts/Bullet/emit.js +3 -2
  21. package/es/src/charts/BumpChart/areaBump.js +175 -0
  22. package/es/src/charts/BumpChart/index.js +84 -18
  23. package/es/src/charts/Calendar/applyLayout.js +1 -1
  24. package/es/src/charts/Calendar/calendarDates.js +21 -7
  25. package/es/src/charts/Calendar/emit.js +3 -2
  26. package/es/src/charts/Calendar/index.js +14 -1
  27. package/es/src/charts/Candlestick/index.js +2 -1
  28. package/es/src/charts/Candlestick/periods.js +52 -29
  29. package/es/src/charts/Candlestick/tooltip.js +5 -7
  30. package/es/src/charts/Chord/emit.js +3 -2
  31. package/es/src/charts/ConnectedScatter/index.js +39 -0
  32. package/es/src/charts/CyclePlot/cycleFacet.js +162 -0
  33. package/es/src/charts/CyclePlot/cycleMeans.js +54 -0
  34. package/es/src/charts/CyclePlot/cyclePeriods.js +99 -0
  35. package/es/src/charts/CyclePlot/cycleTooltip.js +67 -0
  36. package/es/src/charts/CyclePlot/index.js +197 -0
  37. package/es/src/charts/DensityPlot/densityCurves.js +139 -0
  38. package/es/src/charts/DensityPlot/densityPoint.js +10 -0
  39. package/es/src/charts/DensityPlot/index.js +235 -0
  40. package/es/src/charts/DensityPlot/rug.js +144 -0
  41. package/es/src/charts/DotPlot/dotLayout.js +165 -0
  42. package/es/src/charts/DotPlot/facetSize.js +40 -0
  43. package/es/src/charts/DotPlot/index.js +173 -0
  44. package/es/src/charts/DotPlot/placements.js +121 -0
  45. package/es/src/charts/DotPlot/tooltip.js +68 -0
  46. package/es/src/charts/Dumbbell/arrowGrays.js +46 -0
  47. package/es/src/charts/Dumbbell/categoryChange.js +124 -0
  48. package/es/src/charts/Dumbbell/changeEmit.js +291 -0
  49. package/es/src/charts/Dumbbell/changes.js +87 -0
  50. package/es/src/charts/Dumbbell/connectors.js +46 -0
  51. package/es/src/charts/Dumbbell/emit.js +51 -50
  52. package/es/src/charts/Dumbbell/gapSort.js +2 -1
  53. package/es/src/charts/Dumbbell/index.js +121 -5
  54. package/es/src/charts/Funnel/emit.js +3 -2
  55. package/es/src/charts/Gantt/applyLayout.js +31 -9
  56. package/es/src/charts/Gantt/criticalPath.js +202 -0
  57. package/es/src/charts/Gantt/emit.js +49 -15
  58. package/es/src/charts/Gantt/ganttCalendar.js +54 -0
  59. package/es/src/charts/Gantt/ganttCritical.js +106 -0
  60. package/es/src/charts/Gantt/ganttDecor.js +183 -60
  61. package/es/src/charts/Gantt/ganttSlack.js +14 -0
  62. package/es/src/charts/Gantt/ganttTooltip.js +91 -36
  63. package/es/src/charts/Gantt/index.js +59 -10
  64. package/es/src/charts/Gauge/emit.js +3 -2
  65. package/es/src/charts/Geomap/applyLayout.js +177 -19
  66. package/es/src/charts/Geomap/cartogram.js +50 -0
  67. package/es/src/charts/Geomap/cartogramContiguous.js +196 -0
  68. package/es/src/charts/Geomap/cartogramFields.js +63 -0
  69. package/es/src/charts/Geomap/cartogramLabels.js +109 -0
  70. package/es/src/charts/Geomap/cartogramLayout.js +186 -0
  71. package/es/src/charts/Geomap/cartogramLegend.js +73 -0
  72. package/es/src/charts/Geomap/cartogramRelax.js +251 -0
  73. package/es/src/charts/Geomap/densityEmit.js +93 -0
  74. package/es/src/charts/Geomap/densityFields.js +69 -0
  75. package/es/src/charts/Geomap/densityLayout.js +90 -0
  76. package/es/src/charts/Geomap/densityTooltip.js +98 -0
  77. package/es/src/charts/Geomap/dotDensity.js +157 -0
  78. package/es/src/charts/Geomap/dotDensityLayout.js +116 -0
  79. package/es/src/charts/Geomap/dotRenderer.js +49 -0
  80. package/es/src/charts/Geomap/drillDown.js +216 -0
  81. package/es/src/charts/Geomap/drillEmit.js +64 -0
  82. package/es/src/charts/Geomap/drillEvents.js +108 -0
  83. package/es/src/charts/Geomap/emit.js +64 -42
  84. package/es/src/charts/Geomap/flowEmit.js +27 -11
  85. package/es/src/charts/Geomap/flowEvents.js +3 -1
  86. package/es/src/charts/Geomap/flowFields.js +2 -2
  87. package/es/src/charts/Geomap/flowLinks.js +18 -10
  88. package/es/src/charts/Geomap/geoHexbin.js +144 -0
  89. package/es/src/charts/Geomap/geoHexbinZoom.js +110 -0
  90. package/es/src/charts/Geomap/index.js +71 -116
  91. package/es/src/charts/Geomap/pointCluster.js +246 -0
  92. package/es/src/charts/Geomap/pointClusterEmit.js +385 -0
  93. package/es/src/charts/Geomap/pointClusterLayout.js +170 -0
  94. package/es/src/charts/Geomap/pointClusterLinks.js +95 -0
  95. package/es/src/charts/Geomap/pointClusterZoom.js +253 -0
  96. package/es/src/charts/Geomap/pointLabels.js +12 -4
  97. package/es/src/charts/Geomap/pointRows.js +25 -0
  98. package/es/src/charts/Geomap/tileGrid.js +468 -0
  99. package/es/src/charts/Geomap/tileState.js +41 -0
  100. package/es/src/charts/Geomap/topojsonFluent.js +96 -0
  101. package/es/src/charts/Geomap/topojsonLevels.js +16 -0
  102. package/es/src/charts/Hexbin/contourLabels.js +25 -17
  103. package/es/src/charts/Hexbin/index.js +2 -1
  104. package/es/src/charts/Histogram/binData.js +5 -1
  105. package/es/src/charts/Histogram/index.js +4 -26
  106. package/es/src/charts/HorizonChart/emit.js +147 -0
  107. package/es/src/charts/HorizonChart/horizonBands.js +117 -0
  108. package/es/src/charts/HorizonChart/horizonColors.js +30 -0
  109. package/es/src/charts/HorizonChart/hover.js +147 -0
  110. package/es/src/charts/HorizonChart/index.js +220 -0
  111. package/es/src/charts/HorizonChart/measure.js +91 -0
  112. package/es/src/charts/HorizonChart/rowFilter.js +250 -0
  113. package/es/src/charts/HorizonChart/state.js +64 -0
  114. package/es/src/charts/Icicle/emit.js +3 -2
  115. package/es/src/charts/KPI/applyLayout.js +119 -0
  116. package/es/src/charts/KPI/delta.js +74 -0
  117. package/es/src/charts/KPI/emit.js +303 -0
  118. package/es/src/charts/KPI/index.js +192 -0
  119. package/es/src/charts/KPI/series.js +67 -0
  120. package/es/src/charts/KPI/tileLayout.js +134 -0
  121. package/es/src/charts/Lollipop/emit.js +2 -1
  122. package/es/src/charts/Marimekko/index.js +2 -1
  123. package/es/src/charts/Matrix/applyLayout.js +10 -4
  124. package/es/src/charts/Matrix/bubbles.js +133 -0
  125. package/es/src/charts/Matrix/emit.js +68 -25
  126. package/es/src/charts/Matrix/index.js +45 -4
  127. package/es/src/charts/Network/applyLayout.js +173 -82
  128. package/es/src/charts/Network/bundle.js +26 -6
  129. package/es/src/charts/Network/circleLayout.js +281 -0
  130. package/es/src/charts/Network/containNodes.js +72 -0
  131. package/es/src/charts/Network/emit.js +78 -18
  132. package/es/src/charts/Network/forceLayout.js +111 -0
  133. package/es/src/charts/Network/graph.js +45 -6
  134. package/es/src/charts/Network/index.js +111 -2
  135. package/es/src/charts/Network/liveForce.js +312 -0
  136. package/es/src/charts/Network/livePositions.js +180 -0
  137. package/es/src/charts/Network/networkDrag.js +156 -0
  138. package/es/src/charts/Pack/emit.js +3 -2
  139. package/es/src/charts/Pack/index.js +0 -14
  140. package/es/src/charts/ParallelCoordinates/emit.js +3 -2
  141. package/es/src/charts/Pareto/color.js +46 -0
  142. package/es/src/charts/Pareto/hover.js +54 -0
  143. package/es/src/charts/Pareto/index.js +170 -0
  144. package/es/src/charts/Pareto/labels.js +91 -0
  145. package/es/src/charts/Pareto/order.js +61 -0
  146. package/es/src/charts/Pareto/paretoSteps.js +84 -0
  147. package/es/src/charts/Pareto/state.js +158 -0
  148. package/es/src/charts/Parliament/index.js +68 -0
  149. package/es/src/charts/Pie/emit.js +3 -2
  150. package/es/src/charts/Plot/areaEnter.js +5 -3
  151. package/es/src/charts/Plot/areaLabelsAlong.js +10 -2
  152. package/es/src/charts/Plot/aspectRatio.js +92 -0
  153. package/es/src/charts/Plot/axisHover.js +4 -2
  154. package/es/src/charts/Plot/axisHoverAnchors.js +2 -1
  155. package/es/src/charts/Plot/axisHoverScene.js +138 -5
  156. package/es/src/charts/Plot/barConfidence.js +7 -6
  157. package/es/src/charts/Plot/barHitArea.js +121 -7
  158. package/es/src/charts/Plot/barLabelConfidence.js +50 -0
  159. package/es/src/charts/Plot/barLabelFit.js +2 -1
  160. package/es/src/charts/Plot/barWidth.js +10 -5
  161. package/es/src/charts/Plot/baselineBreak.js +15 -6
  162. package/es/src/charts/Plot/baselineDomain.js +13 -4
  163. package/es/src/charts/Plot/circleLabels.js +26 -16
  164. package/es/src/charts/Plot/confidenceAxes.js +100 -0
  165. package/es/src/charts/Plot/confidenceConfig.js +7 -2
  166. package/es/src/charts/Plot/confidenceTooltip.js +47 -4
  167. package/es/src/charts/Plot/connectGapsScene.js +2 -1
  168. package/es/src/charts/Plot/discreteDomain.js +27 -5
  169. package/es/src/charts/Plot/discreteSpan.js +10 -1
  170. package/es/src/charts/Plot/domainClip.js +74 -44
  171. package/es/src/charts/Plot/downsample.js +26 -0
  172. package/es/src/charts/Plot/draw.js +15 -2
  173. package/es/src/charts/Plot/fillBetween.js +2 -1
  174. package/es/src/charts/Plot/forecast.js +8 -4
  175. package/es/src/charts/Plot/forecastScene.js +6 -5
  176. package/es/src/charts/Plot/index.js +49 -18
  177. package/es/src/charts/Plot/inferDiscrete.js +72 -0
  178. package/es/src/charts/Plot/jitter.js +50 -0
  179. package/es/src/charts/Plot/labelPlacement.js +4 -3
  180. package/es/src/charts/Plot/lineBands.js +6 -1
  181. package/es/src/charts/Plot/lineLabelEmit.js +4 -3
  182. package/es/src/charts/Plot/lineLabelSides.js +8 -0
  183. package/es/src/charts/Plot/lineLabelsAlong.js +45 -31
  184. package/es/src/charts/Plot/marginalHover.js +141 -0
  185. package/es/src/charts/Plot/marginalLayout.js +102 -0
  186. package/es/src/charts/Plot/marginalPaint.js +105 -0
  187. package/es/src/charts/Plot/marginalScene.js +272 -0
  188. package/es/src/charts/Plot/marginalSeries.js +73 -0
  189. package/es/src/charts/Plot/marginalStats.js +219 -0
  190. package/es/src/charts/Plot/openDomainEnds.js +60 -0
  191. package/es/src/charts/Plot/orderPath.js +137 -0
  192. package/es/src/charts/Plot/orderPathScene.js +253 -0
  193. package/es/src/charts/Plot/outlierDetect.js +179 -0
  194. package/es/src/charts/Plot/outlierLabels.js +327 -0
  195. package/es/src/charts/Plot/outlierLines.js +93 -0
  196. package/es/src/charts/Plot/outlierScene.js +308 -0
  197. package/es/src/charts/Plot/outlierTooltip.js +69 -0
  198. package/es/src/charts/Plot/periodLabels.js +27 -0
  199. package/es/src/charts/Plot/pipeline.js +62 -24
  200. package/es/src/charts/Plot/pipelineAxisLayout.js +9 -7
  201. package/es/src/charts/Plot/pipelineDomains.js +64 -27
  202. package/es/src/charts/Plot/pipelineScales.js +37 -28
  203. package/es/src/charts/Plot/plotBreaks.js +38 -18
  204. package/es/src/charts/Plot/plotFacet.js +3 -1
  205. package/es/src/charts/Plot/plotInit.js +59 -3
  206. package/es/src/charts/Plot/plotLevels.js +183 -0
  207. package/es/src/charts/Plot/plotRangeBreaks.js +46 -9
  208. package/es/src/charts/Plot/plotShapes.js +60 -0
  209. package/es/src/charts/Plot/pointConfidence.js +186 -0
  210. package/es/src/charts/Plot/pointKey.js +10 -0
  211. package/es/src/charts/Plot/referenceDomains.js +11 -6
  212. package/es/src/charts/Plot/shapeAccessors.js +52 -0
  213. package/es/src/charts/Plot/shapeDefaults.js +32 -17
  214. package/es/src/charts/Plot/sharedHover.js +40 -12
  215. package/es/src/charts/Plot/sharedHoverScene.js +49 -13
  216. package/es/src/charts/Plot/sharedTooltip.js +55 -22
  217. package/es/src/charts/Plot/stackEnter.js +7 -3
  218. package/es/src/charts/Plot/stackLegendOrder.js +5 -2
  219. package/es/src/charts/Plot/stackNeutral.js +154 -0
  220. package/es/src/charts/Plot/stackShareTooltip.js +2 -1
  221. package/es/src/charts/Plot/stackThreshold.js +2 -1
  222. package/es/src/charts/Plot/swarm.js +8 -5
  223. package/es/src/charts/Plot/timeNestKeys.js +37 -0
  224. package/es/src/charts/Plot/trendLabels.js +45 -18
  225. package/es/src/charts/Plot/trendLines.js +78 -34
  226. package/es/src/charts/Plot/trendMovingAverage.js +135 -0
  227. package/es/src/charts/Plot/trendProjection.js +18 -6
  228. package/es/src/charts/Plot/trendScene.js +4 -1
  229. package/es/src/charts/Plot/trendTooltip.js +75 -20
  230. package/es/src/charts/PolarArea/emit.js +3 -2
  231. package/es/src/charts/Priestley/applyLayout.js +9 -5
  232. package/es/src/charts/Priestley/emit.js +3 -2
  233. package/es/src/charts/Priestley/timeAxis.js +13 -5
  234. package/es/src/charts/Radar/emit.js +3 -2
  235. package/es/src/charts/RadialArea/index.js +51 -0
  236. package/es/src/charts/RadialBar/emit.js +3 -2
  237. package/es/src/charts/RadialLine/angles.js +117 -0
  238. package/es/src/charts/RadialLine/applyLayout.js +204 -0
  239. package/es/src/charts/RadialLine/emit.js +66 -0
  240. package/es/src/charts/RadialLine/index.js +228 -0
  241. package/es/src/charts/RadialLine/paths.js +55 -0
  242. package/es/src/charts/RadialLine/points.js +80 -0
  243. package/es/src/charts/RadialLine/series.js +84 -0
  244. package/es/src/charts/RadialLine/seriesLabelNodes.js +116 -0
  245. package/es/src/charts/RadialLine/seriesLabels.js +91 -0
  246. package/es/src/charts/RadialLine/spokes.js +32 -0
  247. package/es/src/charts/RadialMatrix/emit.js +3 -2
  248. package/es/src/charts/RadialTree/index.js +33 -0
  249. package/es/src/charts/Rings/applyLayout.js +22 -6
  250. package/es/src/charts/Rings/emit.js +43 -23
  251. package/es/src/charts/Rings/index.js +1 -1
  252. package/es/src/charts/Rings/ringsCurves.js +10 -8
  253. package/es/src/charts/Rings/ringsLoops.js +4 -2
  254. package/es/src/charts/Rings/ringsSizing.js +21 -13
  255. package/es/src/charts/Sankey/applyLayout.js +4 -0
  256. package/es/src/charts/Sankey/circularLayout.js +14 -6
  257. package/es/src/charts/Sankey/emit.js +3 -2
  258. package/es/src/charts/Sankey/index.js +43 -0
  259. package/es/src/charts/Sankey/sankeyDrag.js +225 -0
  260. package/es/src/charts/Sankey/sankeyLayout.js +12 -0
  261. package/es/src/charts/Scatter/index.js +3 -2
  262. package/es/src/charts/ScatterMatrix/binEmit.js +59 -0
  263. package/es/src/charts/ScatterMatrix/index.js +253 -0
  264. package/es/src/charts/ScatterMatrix/matrixData.js +161 -0
  265. package/es/src/charts/ScatterMatrix/matrixFacet.js +76 -0
  266. package/es/src/charts/ScatterMatrix/matrixHover.js +36 -0
  267. package/es/src/charts/ScatterMatrix/matrixTooltip.js +45 -0
  268. package/es/src/charts/StripPlot/index.js +53 -0
  269. package/es/src/charts/Sunburst/emit.js +3 -2
  270. package/es/src/charts/TileGridMap/index.js +29 -0
  271. package/es/src/charts/Tree/applyLayout.js +91 -18
  272. package/es/src/charts/Tree/emit.js +56 -3
  273. package/es/src/charts/Tree/index.js +24 -3
  274. package/es/src/charts/Tree/nodeHeight.js +58 -0
  275. package/es/src/charts/Tree/radialLabels.js +61 -0
  276. package/es/src/charts/Tree/radialLayout.js +210 -0
  277. package/es/src/charts/Treemap/emit.js +3 -2
  278. package/es/src/charts/Venn/applyLayout.js +176 -0
  279. package/es/src/charts/Venn/circles.js +192 -0
  280. package/es/src/charts/Venn/ellipseFrame.js +57 -0
  281. package/es/src/charts/Venn/emit.js +142 -0
  282. package/es/src/charts/Venn/index.js +178 -0
  283. package/es/src/charts/Venn/nelderMead.js +59 -0
  284. package/es/src/charts/Venn/tooltip.js +22 -0
  285. package/es/src/charts/Venn/vennData.js +99 -0
  286. package/es/src/charts/Venn/vennEllipses.js +291 -0
  287. package/es/src/charts/Venn/vennFit.js +169 -0
  288. package/es/src/charts/Venn/vennLayout.js +252 -0
  289. package/es/src/charts/Venn/vennRegions.js +133 -0
  290. package/es/src/charts/Violin/emit.js +2 -1
  291. package/es/src/charts/Violin/index.js +2 -1
  292. package/es/src/charts/Waffle/applyLayout.js +45 -22
  293. package/es/src/charts/Waffle/arcEmit.js +153 -0
  294. package/es/src/charts/Waffle/arcLayout.js +122 -0
  295. package/es/src/charts/Waffle/arcStage.js +79 -0
  296. package/es/src/charts/Waffle/emit.js +9 -4
  297. package/es/src/charts/Waffle/index.js +88 -4
  298. package/es/src/charts/Waffle/tooltip.js +7 -2
  299. package/es/src/charts/Waterfall/connectors.js +5 -3
  300. package/es/src/charts/Waterfall/state.js +2 -1
  301. package/es/src/charts/WordCloud/applyLayout.js +157 -0
  302. package/es/src/charts/WordCloud/cloudLayout.js +128 -0
  303. package/es/src/charts/WordCloud/emit.js +96 -0
  304. package/es/src/charts/WordCloud/fontScale.js +34 -0
  305. package/es/src/charts/WordCloud/glyphMask.js +298 -0
  306. package/es/src/charts/WordCloud/index.js +174 -0
  307. package/es/src/charts/WordCloud/occupancy.js +99 -0
  308. package/es/src/charts/WordCloud/rotation.js +44 -0
  309. package/es/src/charts/WordCloud/size.js +15 -0
  310. package/es/src/charts/WordCloud/spiral.js +72 -0
  311. package/es/src/charts/definition/applyDefinition.js +6 -1
  312. package/es/src/charts/definition/declaresField.js +14 -0
  313. package/es/src/charts/definition/makeChart.js +10 -2
  314. package/es/src/charts/drawSteps/bottomRightControls.js +1 -1
  315. package/es/src/charts/drawSteps/bottomRightControlsMarkup.js +1 -1
  316. package/es/src/charts/drawSteps/gestureHover.js +10 -6
  317. package/es/src/charts/drawSteps/leavesSurface.js +12 -0
  318. package/es/src/charts/drawSteps/minimap.js +1 -1
  319. package/es/src/charts/drawSteps/selectActions.js +105 -0
  320. package/es/src/charts/drawSteps/selectGesture.js +318 -0
  321. package/es/src/charts/drawSteps/selectRegion.js +222 -0
  322. package/es/src/charts/drawSteps/selectState.js +118 -0
  323. package/es/src/charts/drawSteps/topLeftControls.js +4 -1
  324. package/es/src/charts/drawSteps/zoomControls.js +59 -19
  325. package/es/src/charts/drawSteps/zoomControlsMarkup.js +212 -39
  326. package/es/src/charts/drawSteps/zoomControlsMenu.js +140 -0
  327. package/es/src/charts/drawSteps/zoomDrag.js +3 -1
  328. package/es/src/charts/events/mouseleave.js +6 -3
  329. package/es/src/charts/events/mousemove.legend.js +10 -5
  330. package/es/src/charts/events/mousemove.shape.js +15 -6
  331. package/es/src/charts/facet/drawFacets.js +61 -22
  332. package/es/src/charts/facet/facetConfig.js +3 -1
  333. package/es/src/charts/facet/facetData.js +10 -2
  334. package/es/src/charts/facet/facetGrid.js +5 -1
  335. package/es/src/charts/facet/facetGutter.js +36 -7
  336. package/es/src/charts/facet/facetLayout.js +136 -0
  337. package/es/src/charts/facet/facetLayouts.js +574 -0
  338. package/es/src/charts/facet/facetScene.js +10 -3
  339. package/es/src/charts/features/annotationFrame.js +8 -3
  340. package/es/src/charts/features/axes.js +4 -2
  341. package/es/src/charts/features/axesFinal.js +92 -8
  342. package/es/src/charts/features/axesMeasure.js +7 -4
  343. package/es/src/charts/features/bareRegion.js +24 -0
  344. package/es/src/charts/features/boxGrid.js +39 -0
  345. package/es/src/charts/features/centerLabel.js +36 -17
  346. package/es/src/charts/features/circleLabelPlacement.js +288 -83
  347. package/es/src/charts/features/circleLabels.js +66 -14
  348. package/es/src/charts/features/colorScaleHover.js +7 -2
  349. package/es/src/charts/features/colorScaleTooltip.js +6 -21
  350. package/es/src/charts/features/colorScaleTop.js +12 -2
  351. package/es/src/charts/features/colorScaleValue.js +10 -1
  352. package/es/src/charts/features/curvedArrows.js +46 -28
  353. package/es/src/charts/features/edgeArrows.js +48 -18
  354. package/es/src/charts/features/emitHelpers.js +7 -2
  355. package/es/src/charts/features/features.js +25 -5
  356. package/es/src/charts/features/featuresColorScale.js +7 -4
  357. package/es/src/charts/features/featuresLegend.js +20 -0
  358. package/es/src/charts/features/hoverTicks.js +12 -7
  359. package/es/src/charts/features/keyHold.js +115 -0
  360. package/es/src/charts/features/keyTooltip.js +91 -0
  361. package/es/src/charts/features/labelLayering.js +149 -0
  362. package/es/src/charts/features/labelSlots.js +112 -0
  363. package/es/src/charts/features/linkInteraction.js +4 -1
  364. package/es/src/charts/features/linkLabelPath.js +2 -39
  365. package/es/src/charts/features/nodeDrag.js +175 -0
  366. package/es/src/charts/features/nodeKeys.js +117 -0
  367. package/es/src/charts/features/nodeOutline.js +41 -0
  368. package/es/src/charts/features/pathLabelBends.js +191 -0
  369. package/es/src/charts/features/plotAnnotations.js +8 -5
  370. package/es/src/charts/features/plotPaint.js +45 -13
  371. package/es/src/charts/features/rectNodeSize.js +41 -0
  372. package/es/src/charts/features/ringLabels.js +3 -1
  373. package/es/src/charts/features/selfLoops.js +33 -23
  374. package/es/src/charts/features/shapeEmit.js +104 -32
  375. package/es/src/charts/features/sharedFields.js +10 -5
  376. package/es/src/charts/features/spokeLabels.js +178 -0
  377. package/es/src/charts/features/swatchPaint.js +68 -0
  378. package/es/src/charts/features/thresholdMembers.js +8 -12
  379. package/es/src/charts/features/tooltipRows.js +76 -0
  380. package/es/src/charts/features/tooltipSwatch.js +81 -24
  381. package/es/src/charts/features/xAxisConfig.js +2 -1
  382. package/es/src/charts/helpers/densityChart.js +2 -7
  383. package/es/src/charts/helpers/valueTitle.js +13 -1
  384. package/es/src/charts/index.js +17 -0
  385. package/es/src/charts/partition/interaction.js +2 -2
  386. package/es/src/charts/pipeline/insetPlacement.js +13 -6
  387. package/es/src/charts/pipeline/preDrawData.js +80 -11
  388. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  389. package/es/src/charts/pipeline/stages.js +3 -2
  390. package/es/src/charts/pipeline/vizPreDraw.js +4 -0
  391. package/es/src/charts/plotBuffers/Circle.js +3 -2
  392. package/es/src/charts/plotBuffers/Line.js +6 -5
  393. package/es/src/charts/plotBuffers/Rect.js +3 -2
  394. package/es/src/charts/plotBuffers/Tick.js +12 -0
  395. package/es/src/charts/plotBuffers/defaultBuffers.js +3 -1
  396. package/es/src/charts/plotBuffers/rectLikeBuffer.js +4 -3
  397. package/es/src/charts/viz/Viz.js +32 -18
  398. package/es/src/charts/viz/VizBase.js +39 -38
  399. package/es/src/charts/viz/appendRows.js +90 -0
  400. package/es/src/charts/viz/dataChanged.js +19 -0
  401. package/es/src/charts/viz/discrete.js +9 -0
  402. package/es/src/charts/viz/focusTargets.js +25 -5
  403. package/es/src/charts/viz/groupByLevels.js +48 -0
  404. package/es/src/charts/viz/groupRow.js +27 -0
  405. package/es/src/charts/viz/hoverBand.js +40 -0
  406. package/es/src/charts/viz/interactionOpacity.js +134 -29
  407. package/es/src/charts/viz/keyboardNav.js +39 -9
  408. package/es/src/charts/viz/liftRaised.js +84 -0
  409. package/es/src/charts/viz/nearestHover.js +9 -2
  410. package/es/src/charts/viz/setCursor.js +12 -0
  411. package/es/src/charts/viz/simpleHover.js +3 -4
  412. package/es/src/charts/viz/userClick.js +11 -0
  413. package/es/src/charts/viz/vizDefaults.js +10 -0
  414. package/es/src/charts/viz/vizFields.js +7 -0
  415. package/es/src/charts/viz/vizTypes.js +1 -1
  416. package/es/src/components/Axis/Axis.js +85 -12
  417. package/es/src/components/Axis/AxisBottom.js +1 -0
  418. package/es/src/components/Axis/AxisLeft.js +1 -0
  419. package/es/src/components/Axis/AxisRight.js +1 -0
  420. package/es/src/components/Axis/AxisTop.js +1 -0
  421. package/es/src/components/Axis/axisDefaults.js +7 -0
  422. package/es/src/components/Axis/axisEndLabels.js +4 -1
  423. package/es/src/components/Axis/axisLabelSize.js +40 -16
  424. package/es/src/components/Axis/axisLabelThinning.js +69 -6
  425. package/es/src/components/Axis/axisLayout.js +5 -0
  426. package/es/src/components/Axis/axisLayoutLabels.js +11 -5
  427. package/es/src/components/Axis/axisLayoutScale.js +71 -25
  428. package/es/src/components/Axis/axisLevels.js +271 -0
  429. package/es/src/components/Axis/axisLimit.js +6 -0
  430. package/es/src/components/Axis/axisMinorTicks.js +280 -0
  431. package/es/src/components/Axis/axisPeriods.js +144 -0
  432. package/es/src/components/Axis/axisRangeBreaks.js +19 -10
  433. package/es/src/components/Axis/axisRender.js +71 -29
  434. package/es/src/components/Axis/axisRounding.js +24 -2
  435. package/es/src/components/Axis/axisScaleType.js +55 -0
  436. package/es/src/components/Axis/axisScene.js +90 -5
  437. package/es/src/components/Axis/axisTickLookups.js +30 -0
  438. package/es/src/components/Axis/axisTooltipTargets.js +23 -0
  439. package/es/src/components/Axis/labelSizeSession.js +23 -0
  440. package/es/src/components/Axis/rangeBreaks.js +10 -4
  441. package/es/src/components/Axis/timeValues.js +116 -19
  442. package/es/src/components/ColorScale/ColorScale.js +1 -0
  443. package/es/src/components/ColorScale/colorScaleScale.js +139 -41
  444. package/es/src/components/Legend/Legend.js +1 -0
  445. package/es/src/components/SizeLegend/SizeLegend.js +20 -1
  446. package/es/src/components/TextBox.js +1 -0
  447. package/es/src/components/Timeline/Timeline.js +11 -3
  448. package/es/src/components/Timeline/timelineRender.js +23 -13
  449. package/es/src/components/Tooltip.js +8 -1
  450. package/es/src/components/tooltipDom.js +73 -14
  451. package/es/src/fluent.js +77 -10
  452. package/es/src/shapes/Area.js +32 -1
  453. package/es/src/shapes/Bar.js +22 -1
  454. package/es/src/shapes/Box.js +72 -13
  455. package/es/src/shapes/Circle.js +1 -0
  456. package/es/src/shapes/Image.js +8 -1
  457. package/es/src/shapes/Line.js +45 -1
  458. package/es/src/shapes/Path.js +1 -0
  459. package/es/src/shapes/Rect.js +1 -0
  460. package/es/src/shapes/Shape.js +29 -8
  461. package/es/src/shapes/Tick.js +54 -0
  462. package/es/src/shapes/Whisker.js +1 -0
  463. package/es/src/shapes/boxExtraShapes.js +72 -0
  464. package/es/src/shapes/boxExtras.js +212 -0
  465. package/es/src/shapes/boxStyle.js +38 -5
  466. package/es/src/shapes/buildLabelData.js +2 -0
  467. package/es/src/shapes/downsample.js +150 -0
  468. package/es/src/shapes/hitAreaNode.js +6 -2
  469. package/es/src/shapes/index.js +1 -0
  470. package/es/src/shapes/pathSeries.js +51 -0
  471. package/es/src/utils/BaseClass.js +59 -57
  472. package/es/src/utils/jitter.js +33 -0
  473. package/es/src/utils/resetSetters.js +66 -0
  474. package/package.json +10 -10
  475. package/types/index.d.ts +5 -4
  476. package/types/internal.d.ts +253 -27
  477. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +7 -3
  478. package/types/src/charts/ArcDiagram/arcLoops.d.ts +3 -1
  479. package/types/src/charts/ArcDiagram/arcNodeBox.d.ts +60 -0
  480. package/types/src/charts/ArcDiagram/emit.d.ts +5 -4
  481. package/types/src/charts/BoxWhisker/extras.d.ts +41 -0
  482. package/types/src/charts/BoxWhisker/summary.d.ts +1 -1
  483. package/types/src/charts/BoxWhisker/tooltip.d.ts +33 -4
  484. package/types/src/charts/BubbleChart/emit.d.ts +3 -3
  485. package/types/src/charts/BubbleMatrix/colorDefaults.d.ts +19 -0
  486. package/types/src/charts/BubbleMatrix/index.d.ts +18 -0
  487. package/types/src/charts/BumpChart/areaBump.d.ts +86 -0
  488. package/types/src/charts/BumpChart/index.d.ts +19 -1
  489. package/types/src/charts/Calendar/calendarDates.d.ts +8 -1
  490. package/types/src/charts/Candlestick/periods.d.ts +19 -8
  491. package/types/src/charts/ConnectedScatter/index.d.ts +17 -0
  492. package/types/src/charts/CyclePlot/cycleFacet.d.ts +61 -0
  493. package/types/src/charts/CyclePlot/cycleMeans.d.ts +32 -0
  494. package/types/src/charts/CyclePlot/cyclePeriods.d.ts +37 -0
  495. package/types/src/charts/CyclePlot/cycleTooltip.d.ts +47 -0
  496. package/types/src/charts/CyclePlot/index.d.ts +75 -0
  497. package/types/src/charts/DensityPlot/densityCurves.d.ts +84 -0
  498. package/types/src/charts/DensityPlot/densityPoint.d.ts +16 -0
  499. package/types/src/charts/DensityPlot/index.d.ts +33 -0
  500. package/types/src/charts/DensityPlot/rug.d.ts +57 -0
  501. package/types/src/charts/DotPlot/dotLayout.d.ts +95 -0
  502. package/types/src/charts/DotPlot/facetSize.d.ts +33 -0
  503. package/types/src/charts/DotPlot/index.d.ts +22 -0
  504. package/types/src/charts/DotPlot/placements.d.ts +28 -0
  505. package/types/src/charts/DotPlot/tooltip.d.ts +27 -0
  506. package/types/src/charts/Dumbbell/arrowGrays.d.ts +33 -0
  507. package/types/src/charts/Dumbbell/categoryChange.d.ts +66 -0
  508. package/types/src/charts/Dumbbell/changeEmit.d.ts +71 -0
  509. package/types/src/charts/Dumbbell/changes.d.ts +64 -0
  510. package/types/src/charts/Dumbbell/connectors.d.ts +43 -0
  511. package/types/src/charts/Dumbbell/emit.d.ts +17 -19
  512. package/types/src/charts/Dumbbell/index.d.ts +6 -2
  513. package/types/src/charts/Gantt/applyLayout.d.ts +14 -1
  514. package/types/src/charts/Gantt/criticalPath.d.ts +100 -0
  515. package/types/src/charts/Gantt/emit.d.ts +17 -1
  516. package/types/src/charts/Gantt/ganttCalendar.d.ts +37 -0
  517. package/types/src/charts/Gantt/ganttCritical.d.ts +53 -0
  518. package/types/src/charts/Gantt/ganttDecor.d.ts +32 -2
  519. package/types/src/charts/Gantt/ganttRows.d.ts +2 -0
  520. package/types/src/charts/Gantt/ganttSlack.d.ts +21 -0
  521. package/types/src/charts/Gantt/ganttTooltip.d.ts +35 -15
  522. package/types/src/charts/Gantt/index.d.ts +12 -6
  523. package/types/src/charts/Geomap/applyLayout.d.ts +19 -0
  524. package/types/src/charts/Geomap/cartogram.d.ts +58 -0
  525. package/types/src/charts/Geomap/cartogramContiguous.d.ts +59 -0
  526. package/types/src/charts/Geomap/cartogramFields.d.ts +16 -0
  527. package/types/src/charts/Geomap/cartogramLabels.d.ts +48 -0
  528. package/types/src/charts/Geomap/cartogramLayout.d.ts +71 -0
  529. package/types/src/charts/Geomap/cartogramLegend.d.ts +36 -0
  530. package/types/src/charts/Geomap/cartogramRelax.d.ts +29 -0
  531. package/types/src/charts/Geomap/densityEmit.d.ts +29 -0
  532. package/types/src/charts/Geomap/densityFields.d.ts +27 -0
  533. package/types/src/charts/Geomap/densityLayout.d.ts +49 -0
  534. package/types/src/charts/Geomap/densityTooltip.d.ts +48 -0
  535. package/types/src/charts/Geomap/dotDensity.d.ts +80 -0
  536. package/types/src/charts/Geomap/dotDensityLayout.d.ts +97 -0
  537. package/types/src/charts/Geomap/dotRenderer.d.ts +27 -0
  538. package/types/src/charts/Geomap/drillDown.d.ts +128 -0
  539. package/types/src/charts/Geomap/drillEmit.d.ts +37 -0
  540. package/types/src/charts/Geomap/drillEvents.d.ts +33 -0
  541. package/types/src/charts/Geomap/emit.d.ts +7 -0
  542. package/types/src/charts/Geomap/flowEmit.d.ts +5 -4
  543. package/types/src/charts/Geomap/flowLinks.d.ts +12 -1
  544. package/types/src/charts/Geomap/geoHexbin.d.ts +91 -0
  545. package/types/src/charts/Geomap/geoHexbinZoom.d.ts +76 -0
  546. package/types/src/charts/Geomap/index.d.ts +7 -0
  547. package/types/src/charts/Geomap/pointCluster.d.ts +108 -0
  548. package/types/src/charts/Geomap/pointClusterEmit.d.ts +106 -0
  549. package/types/src/charts/Geomap/pointClusterLayout.d.ts +123 -0
  550. package/types/src/charts/Geomap/pointClusterLinks.d.ts +21 -0
  551. package/types/src/charts/Geomap/pointClusterZoom.d.ts +89 -0
  552. package/types/src/charts/Geomap/pointLabels.d.ts +21 -3
  553. package/types/src/charts/Geomap/pointRows.d.ts +24 -0
  554. package/types/src/charts/Geomap/tileGrid.d.ts +98 -0
  555. package/types/src/charts/Geomap/tileState.d.ts +18 -0
  556. package/types/src/charts/Geomap/topojsonFluent.d.ts +9 -0
  557. package/types/src/charts/Geomap/topojsonLevels.d.ts +14 -0
  558. package/types/src/charts/Hexbin/contourLabels.d.ts +6 -5
  559. package/types/src/charts/Hexbin/settings.d.ts +7 -1
  560. package/types/src/charts/Histogram/binData.d.ts +6 -0
  561. package/types/src/charts/HorizonChart/emit.d.ts +20 -0
  562. package/types/src/charts/HorizonChart/horizonBands.d.ts +42 -0
  563. package/types/src/charts/HorizonChart/horizonColors.d.ts +25 -0
  564. package/types/src/charts/HorizonChart/hover.d.ts +52 -0
  565. package/types/src/charts/HorizonChart/index.d.ts +32 -0
  566. package/types/src/charts/HorizonChart/measure.d.ts +24 -0
  567. package/types/src/charts/HorizonChart/rowFilter.d.ts +88 -0
  568. package/types/src/charts/HorizonChart/state.d.ts +71 -0
  569. package/types/src/charts/KPI/applyLayout.d.ts +64 -0
  570. package/types/src/charts/KPI/delta.d.ts +62 -0
  571. package/types/src/charts/KPI/emit.d.ts +55 -0
  572. package/types/src/charts/KPI/index.d.ts +34 -0
  573. package/types/src/charts/KPI/series.d.ts +45 -0
  574. package/types/src/charts/KPI/tileLayout.d.ts +90 -0
  575. package/types/src/charts/Matrix/applyLayout.d.ts +2 -1
  576. package/types/src/charts/Matrix/bubbles.d.ts +87 -0
  577. package/types/src/charts/Matrix/emit.d.ts +3 -2
  578. package/types/src/charts/Matrix/index.d.ts +2 -1
  579. package/types/src/charts/Network/applyLayout.d.ts +24 -0
  580. package/types/src/charts/Network/bundle.d.ts +23 -16
  581. package/types/src/charts/Network/circleLayout.d.ts +149 -0
  582. package/types/src/charts/Network/containNodes.d.ts +35 -0
  583. package/types/src/charts/Network/emit.d.ts +20 -0
  584. package/types/src/charts/Network/forceLayout.d.ts +49 -0
  585. package/types/src/charts/Network/graph.d.ts +18 -2
  586. package/types/src/charts/Network/liveForce.d.ts +133 -0
  587. package/types/src/charts/Network/livePositions.d.ts +90 -0
  588. package/types/src/charts/Network/networkDrag.d.ts +55 -0
  589. package/types/src/charts/Pareto/color.d.ts +21 -0
  590. package/types/src/charts/Pareto/hover.d.ts +38 -0
  591. package/types/src/charts/Pareto/index.d.ts +22 -0
  592. package/types/src/charts/Pareto/labels.d.ts +40 -0
  593. package/types/src/charts/Pareto/order.d.ts +30 -0
  594. package/types/src/charts/Pareto/paretoSteps.d.ts +65 -0
  595. package/types/src/charts/Pareto/state.d.ts +93 -0
  596. package/types/src/charts/Parliament/index.d.ts +18 -0
  597. package/types/src/charts/Plot/areaLabelsAlong.d.ts +7 -0
  598. package/types/src/charts/Plot/aspectRatio.d.ts +68 -0
  599. package/types/src/charts/Plot/axisHover.d.ts +2 -0
  600. package/types/src/charts/Plot/axisHoverScene.d.ts +44 -1
  601. package/types/src/charts/Plot/barConfidence.d.ts +14 -1
  602. package/types/src/charts/Plot/barHitArea.d.ts +34 -7
  603. package/types/src/charts/Plot/barLabelConfidence.d.ts +25 -0
  604. package/types/src/charts/Plot/baselineBreak.d.ts +2 -1
  605. package/types/src/charts/Plot/baselineDomain.d.ts +5 -0
  606. package/types/src/charts/Plot/circleLabels.d.ts +8 -7
  607. package/types/src/charts/Plot/confidenceAxes.d.ts +63 -0
  608. package/types/src/charts/Plot/confidenceTooltip.d.ts +22 -0
  609. package/types/src/charts/Plot/discreteDomain.d.ts +13 -2
  610. package/types/src/charts/Plot/discreteSpan.d.ts +5 -0
  611. package/types/src/charts/Plot/domainClip.d.ts +15 -5
  612. package/types/src/charts/Plot/downsample.d.ts +16 -0
  613. package/types/src/charts/Plot/index.d.ts +17 -8
  614. package/types/src/charts/Plot/inferDiscrete.d.ts +31 -0
  615. package/types/src/charts/Plot/jitter.d.ts +45 -0
  616. package/types/src/charts/Plot/lineLabelSides.d.ts +19 -0
  617. package/types/src/charts/Plot/lineLabelsAlong.d.ts +19 -6
  618. package/types/src/charts/Plot/marginalHover.d.ts +26 -0
  619. package/types/src/charts/Plot/marginalLayout.d.ts +95 -0
  620. package/types/src/charts/Plot/marginalPaint.d.ts +54 -0
  621. package/types/src/charts/Plot/marginalScene.d.ts +67 -0
  622. package/types/src/charts/Plot/marginalSeries.d.ts +38 -0
  623. package/types/src/charts/Plot/marginalStats.d.ts +115 -0
  624. package/types/src/charts/Plot/openDomainEnds.d.ts +25 -0
  625. package/types/src/charts/Plot/orderPath.d.ts +100 -0
  626. package/types/src/charts/Plot/orderPathScene.d.ts +49 -0
  627. package/types/src/charts/Plot/outlierDetect.d.ts +87 -0
  628. package/types/src/charts/Plot/outlierLabels.d.ts +103 -0
  629. package/types/src/charts/Plot/outlierLines.d.ts +30 -0
  630. package/types/src/charts/Plot/outlierScene.d.ts +103 -0
  631. package/types/src/charts/Plot/outlierTooltip.d.ts +44 -0
  632. package/types/src/charts/Plot/periodLabels.d.ts +14 -0
  633. package/types/src/charts/Plot/pipeline.d.ts +2 -1
  634. package/types/src/charts/Plot/plotBreaks.d.ts +21 -6
  635. package/types/src/charts/Plot/plotInit.d.ts +7 -25
  636. package/types/src/charts/Plot/plotLevels.d.ts +120 -0
  637. package/types/src/charts/Plot/plotRangeBreaks.d.ts +28 -2
  638. package/types/src/charts/Plot/plotShapes.d.ts +42 -0
  639. package/types/src/charts/Plot/pointConfidence.d.ts +73 -0
  640. package/types/src/charts/Plot/pointKey.d.ts +9 -0
  641. package/types/src/charts/Plot/referenceDomains.d.ts +2 -1
  642. package/types/src/charts/Plot/shapeAccessors.d.ts +24 -0
  643. package/types/src/charts/Plot/sharedHover.d.ts +5 -0
  644. package/types/src/charts/Plot/sharedTooltip.d.ts +24 -6
  645. package/types/src/charts/Plot/stackEnter.d.ts +1 -1
  646. package/types/src/charts/Plot/stackLegendOrder.d.ts +4 -1
  647. package/types/src/charts/Plot/stackNeutral.d.ts +85 -0
  648. package/types/src/charts/Plot/swarm.d.ts +8 -4
  649. package/types/src/charts/Plot/timeNestKeys.d.ts +20 -0
  650. package/types/src/charts/Plot/trendLabels.d.ts +15 -6
  651. package/types/src/charts/Plot/trendLines.d.ts +40 -8
  652. package/types/src/charts/Plot/trendMovingAverage.d.ts +78 -0
  653. package/types/src/charts/Plot/trendProjection.d.ts +4 -2
  654. package/types/src/charts/Plot/trendTooltip.d.ts +24 -2
  655. package/types/src/charts/Priestley/timeAxis.d.ts +6 -3
  656. package/types/src/charts/RadialArea/index.d.ts +17 -0
  657. package/types/src/charts/RadialLine/angles.d.ts +67 -0
  658. package/types/src/charts/RadialLine/applyLayout.d.ts +70 -0
  659. package/types/src/charts/RadialLine/emit.d.ts +13 -0
  660. package/types/src/charts/RadialLine/index.d.ts +28 -0
  661. package/types/src/charts/RadialLine/paths.d.ts +37 -0
  662. package/types/src/charts/RadialLine/points.d.ts +43 -0
  663. package/types/src/charts/RadialLine/series.d.ts +63 -0
  664. package/types/src/charts/RadialLine/seriesLabelNodes.d.ts +26 -0
  665. package/types/src/charts/RadialLine/seriesLabels.d.ts +80 -0
  666. package/types/src/charts/RadialLine/spokes.d.ts +15 -0
  667. package/types/src/charts/RadialTree/index.d.ts +16 -0
  668. package/types/src/charts/Rings/emit.d.ts +6 -5
  669. package/types/src/charts/Rings/ringsCurves.d.ts +10 -14
  670. package/types/src/charts/Rings/ringsGraph.d.ts +3 -0
  671. package/types/src/charts/Rings/ringsSizing.d.ts +5 -2
  672. package/types/src/charts/Sankey/circularLayout.d.ts +3 -0
  673. package/types/src/charts/Sankey/sankeyDrag.d.ts +112 -0
  674. package/types/src/charts/Sankey/sankeyLayout.d.ts +8 -0
  675. package/types/src/charts/Scatter/index.d.ts +3 -2
  676. package/types/src/charts/ScatterMatrix/binEmit.d.ts +22 -0
  677. package/types/src/charts/ScatterMatrix/index.d.ts +80 -0
  678. package/types/src/charts/ScatterMatrix/matrixData.d.ts +93 -0
  679. package/types/src/charts/ScatterMatrix/matrixFacet.d.ts +32 -0
  680. package/types/src/charts/ScatterMatrix/matrixHover.d.ts +21 -0
  681. package/types/src/charts/ScatterMatrix/matrixTooltip.d.ts +32 -0
  682. package/types/src/charts/StripPlot/index.d.ts +16 -0
  683. package/types/src/charts/TileGridMap/index.d.ts +14 -0
  684. package/types/src/charts/Tree/index.d.ts +2 -2
  685. package/types/src/charts/Tree/nodeHeight.d.ts +41 -0
  686. package/types/src/charts/Tree/radialLabels.d.ts +24 -0
  687. package/types/src/charts/Tree/radialLayout.d.ts +129 -0
  688. package/types/src/charts/Venn/applyLayout.d.ts +91 -0
  689. package/types/src/charts/Venn/circles.d.ts +87 -0
  690. package/types/src/charts/Venn/ellipseFrame.d.ts +37 -0
  691. package/types/src/charts/Venn/emit.d.ts +36 -0
  692. package/types/src/charts/Venn/index.d.ts +30 -0
  693. package/types/src/charts/Venn/nelderMead.d.ts +28 -0
  694. package/types/src/charts/Venn/tooltip.d.ts +8 -0
  695. package/types/src/charts/Venn/vennData.d.ts +56 -0
  696. package/types/src/charts/Venn/vennEllipses.d.ts +93 -0
  697. package/types/src/charts/Venn/vennFit.d.ts +39 -0
  698. package/types/src/charts/Venn/vennLayout.d.ts +52 -0
  699. package/types/src/charts/Venn/vennRegions.d.ts +58 -0
  700. package/types/src/charts/Waffle/applyLayout.d.ts +4 -1
  701. package/types/src/charts/Waffle/arcEmit.d.ts +45 -0
  702. package/types/src/charts/Waffle/arcLayout.d.ts +82 -0
  703. package/types/src/charts/Waffle/arcStage.d.ts +60 -0
  704. package/types/src/charts/Waffle/emit.d.ts +2 -1
  705. package/types/src/charts/Waffle/index.d.ts +8 -2
  706. package/types/src/charts/Waffle/tooltip.d.ts +7 -2
  707. package/types/src/charts/Waterfall/connectors.d.ts +3 -2
  708. package/types/src/charts/WordCloud/applyLayout.d.ts +51 -0
  709. package/types/src/charts/WordCloud/cloudLayout.d.ts +95 -0
  710. package/types/src/charts/WordCloud/emit.d.ts +27 -0
  711. package/types/src/charts/WordCloud/fontScale.d.ts +20 -0
  712. package/types/src/charts/WordCloud/glyphMask.d.ts +95 -0
  713. package/types/src/charts/WordCloud/index.d.ts +31 -0
  714. package/types/src/charts/WordCloud/occupancy.d.ts +59 -0
  715. package/types/src/charts/WordCloud/rotation.d.ts +31 -0
  716. package/types/src/charts/WordCloud/size.d.ts +16 -0
  717. package/types/src/charts/WordCloud/spiral.d.ts +47 -0
  718. package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
  719. package/types/src/charts/definition/declaresField.d.ts +9 -0
  720. package/types/src/charts/definition/makeChart.d.ts +2 -2
  721. package/types/src/charts/drawSteps/gestureHover.d.ts +2 -2
  722. package/types/src/charts/drawSteps/leavesSurface.d.ts +11 -0
  723. package/types/src/charts/drawSteps/selectActions.d.ts +58 -0
  724. package/types/src/charts/drawSteps/selectGesture.d.ts +60 -0
  725. package/types/src/charts/drawSteps/selectRegion.d.ts +86 -0
  726. package/types/src/charts/drawSteps/selectState.d.ts +51 -0
  727. package/types/src/charts/drawSteps/zoomControls.d.ts +17 -7
  728. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +94 -21
  729. package/types/src/charts/drawSteps/zoomControlsMenu.d.ts +30 -0
  730. package/types/src/charts/drawSteps/zoomDrag.d.ts +2 -0
  731. package/types/src/charts/facet/drawFacets.d.ts +6 -3
  732. package/types/src/charts/facet/facetConfig.d.ts +35 -1
  733. package/types/src/charts/facet/facetData.d.ts +8 -2
  734. package/types/src/charts/facet/facetGrid.d.ts +12 -0
  735. package/types/src/charts/facet/facetGutter.d.ts +19 -5
  736. package/types/src/charts/facet/facetLayout.d.ts +79 -0
  737. package/types/src/charts/facet/facetLayouts.d.ts +21 -0
  738. package/types/src/charts/facet/facetScene.d.ts +4 -1
  739. package/types/src/charts/features/annotationFrame.d.ts +2 -0
  740. package/types/src/charts/features/axesFinal.d.ts +5 -2
  741. package/types/src/charts/features/bareRegion.d.ts +18 -0
  742. package/types/src/charts/features/boxGrid.d.ts +28 -0
  743. package/types/src/charts/features/centerLabel.d.ts +16 -2
  744. package/types/src/charts/features/circleLabelPlacement.d.ts +81 -11
  745. package/types/src/charts/features/circleLabels.d.ts +33 -3
  746. package/types/src/charts/features/colorScaleHover.d.ts +3 -2
  747. package/types/src/charts/features/colorScaleTooltip.d.ts +4 -9
  748. package/types/src/charts/features/colorScaleValue.d.ts +6 -0
  749. package/types/src/charts/features/curvedArrows.d.ts +28 -12
  750. package/types/src/charts/features/edgeArrows.d.ts +40 -30
  751. package/types/src/charts/features/emitHelpers.d.ts +6 -1
  752. package/types/src/charts/features/featuresColorScale.d.ts +6 -0
  753. package/types/src/charts/features/hoverTicks.d.ts +5 -2
  754. package/types/src/charts/features/keyHold.d.ts +41 -0
  755. package/types/src/charts/features/keyTooltip.d.ts +44 -0
  756. package/types/src/charts/features/labelLayering.d.ts +38 -0
  757. package/types/src/charts/features/labelSlots.d.ts +53 -0
  758. package/types/src/charts/features/linkLabelPath.d.ts +0 -7
  759. package/types/src/charts/features/nodeDrag.d.ts +51 -0
  760. package/types/src/charts/features/nodeKeys.d.ts +53 -0
  761. package/types/src/charts/features/nodeOutline.d.ts +34 -0
  762. package/types/src/charts/features/pathLabelBends.d.ts +78 -0
  763. package/types/src/charts/features/plotAnnotations.d.ts +2 -1
  764. package/types/src/charts/features/plotPaint.d.ts +5 -0
  765. package/types/src/charts/features/rectNodeSize.d.ts +42 -0
  766. package/types/src/charts/features/ringLabels.d.ts +3 -1
  767. package/types/src/charts/features/selfLoops.d.ts +10 -9
  768. package/types/src/charts/features/shapeEmit.d.ts +2 -0
  769. package/types/src/charts/features/sharedFields.d.ts +8 -4
  770. package/types/src/charts/features/spokeLabels.d.ts +123 -0
  771. package/types/src/charts/features/swatchPaint.d.ts +58 -0
  772. package/types/src/charts/features/thresholdMembers.d.ts +6 -6
  773. package/types/src/charts/features/tooltipRows.d.ts +50 -0
  774. package/types/src/charts/features/tooltipSwatch.d.ts +25 -11
  775. package/types/src/charts/helpers/valueTitle.d.ts +7 -0
  776. package/types/src/charts/index.d.ts +17 -0
  777. package/types/src/charts/pipeline/preDrawData.d.ts +26 -0
  778. package/types/src/charts/plotBuffers/Circle.d.ts +2 -1
  779. package/types/src/charts/plotBuffers/Rect.d.ts +2 -1
  780. package/types/src/charts/plotBuffers/Tick.d.ts +9 -0
  781. package/types/src/charts/plotBuffers/defaultBuffers.d.ts +2 -0
  782. package/types/src/charts/viz/VizBase.d.ts +32 -1
  783. package/types/src/charts/viz/appendRows.d.ts +49 -0
  784. package/types/src/charts/viz/dataChanged.d.ts +11 -0
  785. package/types/src/charts/viz/discrete.d.ts +19 -0
  786. package/types/src/charts/viz/focusTargets.d.ts +15 -1
  787. package/types/src/charts/viz/groupByLevels.d.ts +36 -0
  788. package/types/src/charts/viz/groupRow.d.ts +6 -0
  789. package/types/src/charts/viz/hoverBand.d.ts +28 -0
  790. package/types/src/charts/viz/interactionOpacity.d.ts +23 -2
  791. package/types/src/charts/viz/keyboardNav.d.ts +13 -0
  792. package/types/src/charts/viz/liftRaised.d.ts +23 -0
  793. package/types/src/charts/viz/setCursor.d.ts +12 -0
  794. package/types/src/charts/viz/simpleHover.d.ts +3 -3
  795. package/types/src/charts/viz/userClick.d.ts +8 -0
  796. package/types/src/charts/viz/vizFields.d.ts +7 -0
  797. package/types/src/charts/viz/vizTypes.d.ts +116 -2
  798. package/types/src/components/Axis/Axis.d.ts +35 -0
  799. package/types/src/components/Axis/axisDefaults.d.ts +2 -0
  800. package/types/src/components/Axis/axisLabelSize.d.ts +3 -3
  801. package/types/src/components/Axis/axisLabelThinning.d.ts +19 -1
  802. package/types/src/components/Axis/axisLayoutScale.d.ts +14 -2
  803. package/types/src/components/Axis/axisLevels.d.ts +137 -0
  804. package/types/src/components/Axis/axisMinorTicks.d.ts +83 -0
  805. package/types/src/components/Axis/axisPeriods.d.ts +45 -0
  806. package/types/src/components/Axis/axisRangeBreaks.d.ts +6 -2
  807. package/types/src/components/Axis/axisRounding.d.ts +15 -1
  808. package/types/src/components/Axis/axisScaleType.d.ts +32 -0
  809. package/types/src/components/Axis/axisScene.d.ts +15 -7
  810. package/types/src/components/Axis/axisTickLookups.d.ts +26 -0
  811. package/types/src/components/Axis/axisTooltipTargets.d.ts +16 -4
  812. package/types/src/components/Axis/labelSizeSession.d.ts +16 -0
  813. package/types/src/components/Axis/rangeBreaks.d.ts +6 -2
  814. package/types/src/components/Axis/timeValues.d.ts +48 -2
  815. package/types/src/components/ColorScale/colorScaleScale.d.ts +45 -0
  816. package/types/src/components/Tooltip.d.ts +11 -2
  817. package/types/src/components/tooltipDom.d.ts +24 -0
  818. package/types/src/fluent.d.ts +30 -1
  819. package/types/src/shapes/Bar.d.ts +7 -0
  820. package/types/src/shapes/Box.d.ts +15 -0
  821. package/types/src/shapes/Shape.d.ts +11 -0
  822. package/types/src/shapes/Tick.d.ts +20 -0
  823. package/types/src/shapes/boxExtraShapes.d.ts +40 -0
  824. package/types/src/shapes/boxExtras.d.ts +85 -0
  825. package/types/src/shapes/boxStyle.d.ts +25 -4
  826. package/types/src/shapes/downsample.d.ts +68 -0
  827. package/types/src/shapes/hitAreaNode.d.ts +2 -1
  828. package/types/src/shapes/index.d.ts +1 -0
  829. package/types/src/shapes/pathSeries.d.ts +35 -0
  830. package/types/src/shapes/shapeConfig.d.ts +70 -2
  831. package/types/src/utils/BaseClass.d.ts +18 -4
  832. package/types/src/utils/D3plusConfig.d.ts +991 -85
  833. package/types/src/utils/index.d.ts +1 -1
  834. package/types/src/utils/jitter.d.ts +23 -0
  835. package/types/src/utils/resetSetters.d.ts +23 -0
  836. package/umd/d3plus-core.full.js +98950 -68731
  837. package/umd/d3plus-core.full.min.js +2 -2
  838. package/umd/d3plus-core.js +77484 -48545
  839. package/umd/d3plus-core.min.js +2 -2
@@ -0,0 +1,68 @@
1
+ /**
2
+ A Plot's fixed aspect ratio (`aspectRatio`): one unit of y is drawn
3
+ `aspectRatio` times as long as one unit of x, so the plot area shrinks
4
+ along one side, centered, while the axes keep their domains.
5
+ */
6
+ import type Axis from "../../components/Axis/Axis.js";
7
+ import type { VizInstance } from "../viz/vizTypes.js";
8
+ /** How far a plot area shrinks along each side, in pixels. */
9
+ export interface AspectInset {
10
+ x: number;
11
+ y: number;
12
+ }
13
+ /**
14
+ How many units an axis's domain spans for its aspect ratio: the
15
+ difference of its ends on a linear or time axis (in milliseconds), the
16
+ powers of ten between them on a log axis (one decade is one unit), or
17
+ `undefined` on an axis with no even unit (a category, pow, or sqrt
18
+ axis, or a log axis spanning zero).
19
+ @param scale The axis's scale (`"linear"`, `"log"`, `"time"`, …).
20
+ @param domain The ends of its domain.
21
+ */
22
+ export declare function axisUnits(scale: string, domain: unknown[]): number | undefined;
23
+ /**
24
+ How far to shrink a plot area along x or y so one unit of y is drawn
25
+ `ratio` times as long as one unit of x: only the side that is too long
26
+ shrinks, the other keeps its length.
27
+ @param units The units each axis's domain spans (see `axisUnits`).
28
+ @param lengths The plot area's width (x) and height (y), in pixels.
29
+ @param ratio The length of one y unit over one x unit.
30
+ */
31
+ export declare function aspectInset(units: {
32
+ x: number;
33
+ y: number;
34
+ }, lengths: {
35
+ x: number;
36
+ y: number;
37
+ }, ratio: number): AspectInset;
38
+ /**
39
+ A Plot's `aspectRatio` when it holds one: a positive number, and the x
40
+ and y axes both measure in even units (see `axisUnits`). Otherwise
41
+ `undefined`, with a warning for a ratio it can't hold.
42
+ @param viz The Plot.
43
+ @param scales Each axis's scale, a category axis's as `"point"`.
44
+ */
45
+ export declare function plotAspectRatio(viz: VizInstance, scales: {
46
+ x: string;
47
+ y: string;
48
+ }): number | undefined;
49
+ /**
50
+ The units the x and y axes' drawn domains span (see `axisUnits`), read
51
+ from the measured test axes, or `undefined` when either has none.
52
+ @param axes The x and y test axes, measured against their ranges.
53
+ @param scales Each axis's scale.
54
+ @param fallback The domains of axes not measured (hidden).
55
+ */
56
+ export declare function plotAxisUnits(axes: {
57
+ x: Axis;
58
+ y: Axis;
59
+ }, scales: {
60
+ x: string;
61
+ y: string;
62
+ }, fallback: {
63
+ x: unknown[];
64
+ y: unknown[];
65
+ }): {
66
+ x: number;
67
+ y: number;
68
+ } | undefined;
@@ -16,6 +16,8 @@ export interface AxisHoverBadge {
16
16
  /** The badge's center along the axis, in chart content space. */
17
17
  at: number;
18
18
  text: string;
19
+ /** The value the badge shows, whose tick label it covers. */
20
+ value?: unknown;
19
21
  /** Whether a guide runs from the point to this axis (the crosshair is the discrete axis's guide). */
20
22
  guide: boolean;
21
23
  }
@@ -74,14 +74,57 @@ export declare function badgeBox(axis: AxisName, at: number, size: {
74
74
  width: number;
75
75
  height: number;
76
76
  }, edges: PlotEdges): BadgeBox;
77
+ /** Whether a tick's value is `value`: the same number or date, or the same text. */
78
+ export declare function sameTick(tick: unknown, value: unknown): boolean;
79
+ /**
80
+ The box, in the space of `nodes`, around the tick labels `axis` draws for
81
+ `value` (an axis's labels sit in its `plot-<axis>-axis` group), or null
82
+ when it draws none.
83
+ @param nodes The chart body's scene nodes.
84
+ @param axis The badged axis.
85
+ @param value The badged value.
86
+ */
87
+ export declare function tickLabelBox(nodes: SceneNode[], axis: AxisName, value: unknown): BadgeBox | null;
88
+ /**
89
+ A badge's box grown to cover the tick label under it, with `pad` to
90
+ spare around the label, so none of the label shows around the badge.
91
+ @param box The badge's own box.
92
+ @param label The box around the tick label at the badge's value.
93
+ @param pad The badge's padding.
94
+ */
95
+ export declare function coverLabel(box: BadgeBox, label: BadgeBox | null, pad: number): BadgeBox;
96
+ /** A drawn badge's box, and the badge's key. */
97
+ export type KeyedBox = BadgeBox & {
98
+ key?: string;
99
+ };
100
+ /** A drawn badge's box: its group's rect (see `badgeNode`), with the badge's key. */
101
+ export declare function badgeRect(badge: SceneNode): KeyedBox;
102
+ /** Whether boxes `a` and `b` overlap by more than half a pixel each way. */
103
+ export declare function boxesOverlap(a: BadgeBox, b: BadgeBox): boolean;
104
+ /** A tick label hidden under a badge: `coveredBy` names the badge's key. */
105
+ export type CoveredTick = SceneNode & {
106
+ coveredBy?: string;
107
+ };
108
+ /**
109
+ `nodes` with every axis tick label that overlaps one of `boxes` (the
110
+ badges' boxes, in the space of `nodes`) hidden: the label a badge grows
111
+ over, and any neighbor it reaches, so only the badge's value reads there.
112
+ Rotated labels are tested by their bounding box. A hidden label's
113
+ `coveredBy` names the badge over it. Returns copies along the changed
114
+ paths; `nodes` is left as it is.
115
+ @param nodes The chart body's scene nodes.
116
+ @param boxes The drawn badges' boxes.
117
+ */
118
+ export declare function hideOverlappedTicks(nodes: SceneNode[], boxes: KeyedBox[]): SceneNode[];
77
119
  /**
78
120
  The axis hover's scene nodes, in chart content space: `guides` to draw
79
121
  with the plot's marks (inside its zoom clip), and `badges` to draw over
80
122
  the axes.
81
123
  @param viz The Plot, with the hovered panel's state in place.
82
124
  @param state The active axis hover.
125
+ @param nodes The chart body's scene nodes, holding the axes whose labels the badges cover.
83
126
  */
84
- export declare function axisHoverNodes(viz: VizInstance, state: AxisHoverState): {
127
+ export declare function axisHoverNodes(viz: VizInstance, state: AxisHoverState, nodes?: SceneNode[]): {
85
128
  guides: SceneNode[];
86
129
  badges: SceneNode[];
87
130
  };
@@ -13,8 +13,9 @@
13
13
  @module
14
14
  */
15
15
  import type { SceneNode } from "@d3plus/render";
16
- import type { PlotDatum } from "../features/plotPaint.js";
16
+ import type { PlotAxisFn, PlotDatum } from "../features/plotPaint.js";
17
17
  import type { ShapeEmitContext } from "../features/shapeEmit.js";
18
+ import type { VizInstance as Viz } from "../viz/vizTypes.js";
18
19
  /** Key suffix of a bar's error-bar node. */
19
20
  export declare const CONFIDENCE_KEY_SUFFIX = "::confidence";
20
21
  /** A stack segment's `[start, end]` values, as d3-stack produces them. */
@@ -99,6 +100,18 @@ export declare function errorBarPath(discrete: "x" | "y", center: number, cap: n
99
100
  lower?: boolean;
100
101
  upper?: boolean;
101
102
  }): string;
103
+ /**
104
+ The library's error-bar styling, layered under the user's
105
+ `confidenceConfig`: a stroke a shade darker than the bar's own fill.
106
+ */
107
+ export declare function errorBarDefaults(viz: Viz, shape?: string): Record<string, unknown>;
108
+ /**
109
+ The pixel span error bars stay within: the value axis's domain, inside the
110
+ plot's own clamp. A baseline break leaves the axis running past its
111
+ domain down to the baseline; a bound in that broken-away stretch has no
112
+ true position, so it is cut at the domain's edge like one past the axis.
113
+ */
114
+ export declare function errorBarExtent(ctx: ShapeEmitContext, opp: "x" | "y", scale: PlotAxisFn): [number, number] | undefined;
102
115
  /**
103
116
  Whether `value` falls inside one of an axis's breaks, the value range it
104
117
  leaves out. A bound there has no true position, so its cap is dropped.
@@ -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
  */
@@ -159,7 +162,7 @@ export default class Plot extends Viz {
159
162
  */
160
163
  buffer(_?: boolean | Record<string, boolean>): this | Record<string, unknown>;
161
164
  /**
162
- The confidence interval as `[lower, upper]` bounds (keys or accessors): lines draw a shaded band, bars an error bar. Either bound may be `false` for a one-sided interval, and the value axis widens to fit. Pass an array of bands, outermost first (`[lower, upper, label]` or `{lower, upper, label}`), to draw nested bands (a fan). `false` turns it off.
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.
163
166
 
164
167
  @example <caption>Can be called with accessor functions or static keys:</caption>
165
168
  var data = {id: "alpha", value: 10, lci: 9, hci: 11};
@@ -172,8 +175,11 @@ export default class Plot extends Viz {
172
175
 
173
176
  // Or nested bands, outermost first
174
177
  .confidence([["p5", "p95", "90%"], ["p25", "p75", "50%"]])
178
+
179
+ // Or bounds on each axis
180
+ .confidence({x: ["xLow", "xHigh"], y: ["yLow", "yHigh"]})
175
181
  */
176
- confidence(_?: unknown): this | VizInstance["_confidence"] | ConfidenceBand[];
182
+ confidence(_?: unknown): this | VizInstance["_confidence"] | ConfidenceBand[] | ConfidenceAxes;
177
183
  /**
178
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.
179
185
 
@@ -200,17 +206,20 @@ export default class Plot extends Viz {
200
206
  */
201
207
  crosshairConfig(_?: Record<string, unknown>): this | Record<string, unknown>;
202
208
  /**
203
- 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.
204
210
  */
205
211
  trendLine(_?: TrendLineType): this | TrendLineType;
206
212
  /**
207
213
  Options for the trend lines drawn by `trendLine`, merged into the current config:
208
214
  - `group`: `"series"` (default) fits one line per series, colored to match it; `"all"` fits a single line to every point.
209
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.
210
219
  - `confidence`: draws a confidence band around a linear fit (default `false`).
211
220
  - `confidenceLevel`: the band's confidence level (default `0.95`).
212
221
  - `confidenceConfig`: Area shape config for the band (default `{fillOpacity: 0.15}`; fill defaults to the line color).
213
- - `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.
214
223
  - `projectionConfig`: Line shape config for the projected stretch, over the line's own styles (default `{strokeDasharray: "2 4"}`).
215
224
  - `tooltip`: shows the fitted equation and R² when hovering a line (default `true`).
216
225
  - Any other key (`stroke`, `strokeWidth`, `strokeDasharray`, …) styles the Line shape.
@@ -256,9 +265,9 @@ export default class Plot extends Viz {
256
265
  */
257
266
  stackOrder(_?: StackOrderInput): this | StackOrderFn | string[];
258
267
  /**
259
- 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.
260
269
  */
261
- x(_?: PlotAccessorArg): this | PlotAccessor;
270
+ x(_?: PlotAxisArg): this | PlotAccessor;
262
271
  /**
263
272
  Accessor function or string key for the secondary x-axis value of each data point.
264
273
  */
@@ -272,9 +281,9 @@ export default class Plot extends Viz {
272
281
  */
273
282
  x2Config(_?: Record<string, unknown>): this | Record<string, unknown>;
274
283
  /**
275
- 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.
276
285
  */
277
- y(_?: PlotAccessorArg): this | PlotAccessor;
286
+ y(_?: PlotAxisArg): this | PlotAccessor;
278
287
  /**
279
288
  Accessor function or string key for the secondary y-axis value of each data point.
280
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;