@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,51 @@
1
+ /**
2
+ What a selection holds: a predicate over rows, the way `hover`, `active`,
3
+ and `highlight` are, so it lights marks through the same
4
+ interaction-opacity pass and outlives the redraws that replace the rows
5
+ it was made from.
6
+
7
+ @module
8
+ */
9
+ import type { DataPoint } from "@d3plus/data";
10
+ import type { SceneNode } from "@d3plus/render";
11
+ /** A selection: whether a row (and its index) is selected. */
12
+ export type SelectPredicate = (d: DataPoint, i?: number) => boolean;
13
+ /**
14
+ A row's content signature: its own fields that hold a string, number,
15
+ boolean, or Date, sorted by name. Fields starting with an underscore
16
+ (the chart's own bookkeeping) are left out. Two rows with the same values
17
+ share a signature, so a selection still finds its rows once a redraw
18
+ rebuilds them.
19
+ @param row The row.
20
+ */
21
+ export declare function rowKey(row: DataPoint): string;
22
+ /**
23
+ A predicate matching `rows`: the same objects, or rows with the same
24
+ content (see `rowKey`).
25
+ @param rows The rows to match.
26
+ */
27
+ export declare function rowMatcher(rows: DataPoint[]): SelectPredicate;
28
+ /**
29
+ The rows a selection holds among a chart's marks, in drawing order:
30
+ each mark's row, or for a Line or Area, each of its points' rows.
31
+ @param nodes The chart's scene (`viz._chartScene`).
32
+ @param predicate The selection.
33
+ */
34
+ export declare function selectedRows(nodes: SceneNode[], predicate: SelectPredicate): DataPoint[];
35
+ /**
36
+ The rows of the Lines and Areas (marks drawn through several points)
37
+ that hold any of `rows`, so a series stays lit while any of its points is
38
+ selected.
39
+ @param nodes The chart's scene (`viz._chartScene`).
40
+ @param rows The selected rows.
41
+ */
42
+ export declare function seriesRows(nodes: SceneNode[], rows: DataPoint[]): DataPoint[];
43
+ /**
44
+ The rows a selection holds after a gesture: `hits` alone, `hits` added
45
+ to `current`, or `current` with `hits` toggled (each hit removed when
46
+ already selected, else added).
47
+ @param current The rows selected before.
48
+ @param hits The rows the gesture picked.
49
+ @param mode How the gesture combines with the selection.
50
+ */
51
+ export declare function combineRows(current: DataPoint[], hits: DataPoint[], mode: "replace" | "add" | "toggle"): DataPoint[];
@@ -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
  /**
@@ -63,6 +65,14 @@ export declare function tileZoomTransform(viz: Viz): ZoomTransform;
63
65
  `zoomDrag`/`zoomDoubleClick` gestures are bound beside it.
64
66
  */
65
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;
66
76
  /**
67
77
  @name zoomMath
68
78
  Zooms in or out by a multiplier about the chart area's center, as the
@@ -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;
@@ -99,16 +105,48 @@ export declare const ZOOM_PANEL_PADDING = 4;
99
105
  */
100
106
  export declare const ZOOM_PANEL_STYLE: Record<string, string>;
101
107
  /**
102
- The four buttons' markup. Real <button>s (not <div>s) so a host page's own
103
- button styling (Tailwind, Bootstrap, a design system's global `button`
104
- reset) applies through the cascade once a `zoomControlClassName`
105
- auto-disables the inline defaults. `zoomControlClassName` layers a
106
- consumer's own class onto each button without losing the fixed classes
107
- event delegation depends on. The brush toggle carries `aria-pressed` (and
108
- the `.active` class frameworks like Bootstrap style) while brush mode is on.
109
- Each button takes the pointer back from the panel (`ZOOM_PANEL_STYLE`).
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.
110
148
  */
111
- export declare function zoomControlsHtml(viz: Viz): string;
149
+ export declare function zoomControlsHtml(viz: Viz, visible?: number): string;
112
150
  /**
113
151
  Mounts each configured custom icon function into its button's reserved
114
152
  slot — called once per fresh button element (from the same `onUpdate`
@@ -128,24 +166,59 @@ export declare function overlayHost(viz: Viz): HTMLElement | null;
128
166
  a click on the button itself — e.g. leaving brush mode after a selection.
129
167
  */
130
168
  export declare function syncBrushButton(viz: Viz): void;
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;
131
176
  /** Whether a chart shows the zoom-control panel: it zooms, and `zoomControls` isn't false. */
132
177
  export declare function showsZoomControls(viz: Viz): boolean;
133
178
  /**
134
- The zoom-control panel's size (padding included) as it will render in the
135
- chart's page, so top-positioned content can leave room for it. Measured
136
- by mounting a hidden copy beside the chart — the buttons' size depends on
137
- the host page's CSS (a `zoomControlClassName`, a global `button` reset) —
138
- and cached until the markup or styling changes. Returns null when the
139
- chart shows no controls.
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.
140
183
  */
141
- export declare function zoomControlsBox(viz: Viz): {
184
+ export interface ZoomControlsBox {
142
185
  width: number;
143
186
  height: number;
144
- } | null;
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;
207
+ /**
208
+ The zoom-control panel's size (padding included) as it will render in the
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;
145
217
  /**
146
- The box the minimap hangs beneath: the zoom-control panel, or, with the
147
- buttons hidden (`zoomControls: false`), a strip as wide as the default
148
- panel down to the chart area's top, so the minimap overlays the chart
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
149
222
  area rather than the title and other top content that take the
150
223
  buttons' room. Null when the chart doesn't zoom.
151
224
  */
@@ -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>>;
@@ -54,6 +54,8 @@ export declare function startsBoxDrag(event: MouseEvent, at: Point, area: Box):
54
54
  @param to Where the pointer is now.
55
55
  */
56
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;
57
59
  /**
58
60
  Binds the gestures this module adds to the zoom surface, after d3-zoom's
59
61
  own: the drawn zoom box for `zoomDrag: "brush"`, and the double-click
@@ -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
  /**
@@ -0,0 +1,79 @@
1
+ /**
2
+ Small multiples on a map-shaped grid (`facetConfig.layout`): placing
3
+ each facet value in its cell, and laying the cells out, with empty cells
4
+ left empty. Pure layout math, no chart state.
5
+
6
+ @module
7
+ */
8
+ import type { DataPoint } from "@d3plus/data";
9
+ import type { FacetCell, FacetValue, ResolvedFacetConfig } from "./facetConfig.js";
10
+ import type { FacetGroup } from "./facetData.js";
11
+ import type { FacetArea, FacetGridOptions } from "./facetGrid.js";
12
+ import type { FacetLayoutCell } from "./facetLayouts.js";
13
+ /**
14
+ `facetConfig.layout`: a named map-shaped grid (`"us-states"`,
15
+ `"eu-countries"`, `"world-regions"`), or a grid of your own mapping each
16
+ facet value to its `[row, column]` (from 0, top left).
17
+ */
18
+ export type FacetLayout = string | Record<string, [number, number]>;
19
+ /**
20
+ The cells a `layout` setting describes: a named layout's, or one cell
21
+ per entry of a `{[value]: [row, column]}` map (its value as the code).
22
+ Undefined for anything else, including a name no layout has.
23
+ */
24
+ export declare function resolveFacetLayout(layout: unknown): FacetLayoutCell[] | undefined;
25
+ /**
26
+ Finds a facet value's cell: the cell whose code, name, or alias it
27
+ equals, ignoring case and surrounding space.
28
+ */
29
+ export declare function layoutMatcher(cells: FacetLayoutCell[]): (value: unknown) => FacetLayoutCell | undefined;
30
+ /** A facet group placed in its cell. */
31
+ export interface PlacedFacet<G> {
32
+ group: G;
33
+ cell: FacetLayoutCell;
34
+ }
35
+ /**
36
+ Places each group in its cell, in the order given. Groups whose value no
37
+ cell matches, and groups whose cell an earlier group took, are left out
38
+ and returned as `missing`.
39
+ */
40
+ export declare function placeFacets<G extends Pick<FacetGroup, "value">>(groups: G[], cells: FacetLayoutCell[]): {
41
+ placed: PlacedFacet<G>[];
42
+ missing: G[];
43
+ };
44
+ /** The grid's row and column counts: enough for every cell of the layout. */
45
+ export declare function layoutDimensions(cells: Pick<FacetLayoutCell, "row" | "column">[]): {
46
+ rows: number;
47
+ columns: number;
48
+ };
49
+ /**
50
+ Lays panels out on a map-shaped grid: panel `i` in the cell at
51
+ `places[i]`, every cell the same size, empty cells left empty. A panel
52
+ with no panel directly to its left or below it is on that edge: it is
53
+ widened by `gutter.left`, or deepened by `gutter.bottom`, reaching into
54
+ the empty cell beside it (or the grid's gutter) for the axis labels only
55
+ edge panels draw. The rightmost column is widened by `gutter.right`.
56
+ @param places Each panel's row and column.
57
+ @param grid The grid's row and column counts (see `layoutDimensions`).
58
+ @param area The box the grid fills.
59
+ @param opts The padding and gutters (see `facetGrid`).
60
+ */
61
+ export declare function layoutGridCells(places: Pick<FacetLayoutCell, "row" | "column">[], grid: {
62
+ rows: number;
63
+ columns: number;
64
+ }, area: FacetArea, opts: Pick<FacetGridOptions, "padding" | "columnPadding" | "gutter">): FacetCell[];
65
+ /**
66
+ Each placed panel's title: its cell's short code (`"CA"`), or what
67
+ `facetConfig.title` returns, or nothing with titles off.
68
+ */
69
+ export declare function layoutTitleTexts(config: Pick<ResolvedFacetConfig, "title">, panels: {
70
+ value: FacetValue;
71
+ data: DataPoint[];
72
+ }[], places: Pick<FacetLayoutCell, "code">[]): string[];
73
+ /** What hovering each panel's title shows: its place's full name, unless the title already reads it. */
74
+ export declare function layoutTitleTooltips(texts: string[], places: Pick<FacetLayoutCell, "name">[]): (string | undefined)[];
75
+ /**
76
+ The values left out of a map-shaped grid, for a warning: up to `limit`
77
+ of them, then how many more.
78
+ */
79
+ export declare function missingFacetMessage(values: unknown[], limit?: number): string;
@@ -0,0 +1,21 @@
1
+ /**
2
+ Small multiples: the map-shaped grids `facetConfig.layout` names. Each
3
+ place takes one cell, roughly where it sits on a map: its short code
4
+ (the panel title), its full name (the title's tooltip), any other
5
+ names data may give it, and its row and column (from 0, top left).
6
+
7
+ @module
8
+ */
9
+ /** One place in a map-shaped grid. */
10
+ export interface FacetLayoutCell {
11
+ /** Its short code, which titles its panel. */
12
+ code: string;
13
+ /** Its full name, shown when its panel title is hovered. */
14
+ name?: string;
15
+ /** Other values that place a row here (such as an ISO alpha-3 code). */
16
+ aliases?: string[];
17
+ row: number;
18
+ column: number;
19
+ }
20
+ /** Every named layout `facetConfig.layout` takes. */
21
+ export declare const FACET_LAYOUTS: Record<string, FacetLayoutCell[]>;
@@ -11,6 +11,8 @@ export interface FacetTitle {
11
11
  x: number;
12
12
  y: number;
13
13
  width: number;
14
+ /** What hovering the title shows (a map-shaped grid's full place name), if anything. */
15
+ tooltip?: string;
14
16
  }
15
17
  /**
16
18
  Returns a copy of `nodes` with every key (at any depth) prefixed by
@@ -26,7 +28,8 @@ export declare function prefixKeys(nodes: SceneNode[], prefix: string | ((key: s
26
28
  export declare function measureFacetTitles(titles: FacetTitle[], config: Record<string, unknown>, locale?: string): number;
27
29
  /**
28
30
  One text node per panel title, offset by the title padding. Titles are
29
- chrome: they carry no datum and take no pointer events.
31
+ chrome: they carry no datum, and take pointer events only to show their
32
+ `tooltip` (see `handleAxisTooltip`).
30
33
  */
31
34
  export declare function facetTitleNodes(titles: FacetTitle[], config: Record<string, unknown>, locale?: string): SceneNode[];
32
35
  /**
@@ -16,6 +16,8 @@ export interface AxisFrame {
16
16
  scale: (value: unknown) => number;
17
17
  /** Whether the axis plots dates, so values parse as dates. */
18
18
  time?: boolean;
19
+ /** Whether dates that name no time zone parse as UTC (the axis's `utc`). */
20
+ utc?: boolean;
19
21
  /** A category axis's categories, which values must match (or fall between, when numeric). */
20
22
  categories?: unknown[];
21
23
  /** Whether each category fills a slot along the axis (bars), which spans take in whole. */
@@ -29,8 +29,9 @@ type FinalYAxes = YAxisMeasure & {
29
29
  xOffsetRight: number;
30
30
  };
31
31
  /**
32
- The room the plot leaves on its right for the y2 axis and for the x/x2
33
- axes' last labels, once those axes start at `xOffsetLeft`. The x and x2
32
+ The room the plot leaves on its right for the y2 axis (and any
33
+ `insetRight` a chart reserves beyond it) and for the x/x2 axes' last
34
+ labels, once those axes start at `xOffsetLeft`. The x and x2
34
35
  test axes are re-measured from there: where an axis starts decides its
35
36
  ticks, and so which label is last and how far it reaches past the
36
37
  range's end.
@@ -42,6 +43,7 @@ export declare function xRightInset(axes: {
42
43
  x2Exists: boolean;
43
44
  xRangeMax: number | undefined;
44
45
  width: number;
46
+ insetRight?: number;
45
47
  }, xOffsetLeft: number, y2Width: number | undefined): number;
46
48
  /**
47
49
  The y/y2 axes' final solve, and the plot's y range, once the chrome has
@@ -62,5 +64,6 @@ export declare function solveFinalAxes(viz: Viz, pCtx: PlotPaintContext, frozen?
62
64
  yBottom: number;
63
65
  insetBottom: number;
64
66
  solved: FinalYAxes;
67
+ aspectInsetY: number;
65
68
  };
66
69
  export {};