@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,67 @@
1
+ /**
2
+ A KPI tile's history, for a chart with `time` set: the tile's rows split
3
+ into periods in time order, the period(s) the timeline selects as
4
+ current, and the previous value they are compared with.
5
+ */ import { date } from "@d3plus/dom";
6
+ /** A time value as a timestamp, or `NaN` when it doesn't read as a date. */ function timestamp(value) {
7
+ if (value === undefined || value === null || value === "") return NaN;
8
+ const parsed = date(value);
9
+ return parsed ? +parsed : NaN;
10
+ }
11
+ /**
12
+ Splits rows into periods by their `time` value, in time order (data
13
+ order for values that don't read as dates, after those that do).
14
+ */ export function kpiPeriods(rows, time) {
15
+ const byKey = new Map();
16
+ for (const r of rows){
17
+ const t = time(r.row, r.i);
18
+ const key = t instanceof Date ? `${+t}` : `${t}`;
19
+ let period = byKey.get(key);
20
+ if (!period) byKey.set(key, period = {
21
+ time: t,
22
+ rows: []
23
+ });
24
+ period.rows.push(r);
25
+ }
26
+ const periods = [
27
+ ...byKey.values()
28
+ ].map((p, order)=>({
29
+ p,
30
+ order,
31
+ ms: timestamp(p.time)
32
+ }));
33
+ periods.sort((a, b)=>{
34
+ const da = Number.isFinite(a.ms), db = Number.isFinite(b.ms);
35
+ if (da && db && a.ms !== b.ms) return a.ms - b.ms;
36
+ if (da !== db) return da ? -1 : 1;
37
+ return a.order - b.order;
38
+ });
39
+ return periods.map((d)=>d.p);
40
+ }
41
+ /**
42
+ A tile's sparkline points and previous value. `current` picks the
43
+ selected periods; the previous value covers as many periods, just before
44
+ the first selected one, and is `NaN` when there aren't that many.
45
+ `valueOf` reads one value from a set of rows (merging them the way the
46
+ chart rolls rows up).
47
+ */ export function kpiSeries(periods, current, valueOf) {
48
+ const flags = periods.map(current);
49
+ const points = periods.map((p, k)=>({
50
+ time: p.time,
51
+ value: valueOf(p.rows),
52
+ current: flags[k]
53
+ }));
54
+ const first = flags.indexOf(true);
55
+ const count = flags.filter(Boolean).length;
56
+ if (first < 0 || first < count) return {
57
+ points,
58
+ previous: NaN,
59
+ previousTimes: []
60
+ };
61
+ const before = periods.slice(first - count, first);
62
+ return {
63
+ points,
64
+ previous: valueOf(before.flatMap((p)=>p.rows)),
65
+ previousTimes: before.map((p)=>p.time)
66
+ };
67
+ }
@@ -0,0 +1,134 @@
1
+ /**
2
+ Where KPI tiles go: the grid of tiles in the chart area, the label,
3
+ value, delta, and sparkline inside each tile, and the sparkline's
4
+ points. Pure layout math, no chart state.
5
+ */ import { facetGrid } from "../facet/facetGrid.js";
6
+ /** The tile width/height ratio the grid aims for by default. */ export const TILE_ASPECT = 1.75;
7
+ /** The space between tiles by default, in pixels. */ export const TILE_PADDING = 12;
8
+ /**
9
+ The boxes of `count` tiles, left to right and top to bottom, filling
10
+ `area`: the column count that draws `aspect`-shaped tiles largest wins,
11
+ as it does for small multiples.
12
+ */ export function kpiGrid(count, area, opts) {
13
+ return facetGrid(count, area, {
14
+ ...opts,
15
+ titleHeight: 0
16
+ }).map((c)=>({
17
+ x: c.x,
18
+ y: c.y,
19
+ width: c.width,
20
+ height: c.height
21
+ }));
22
+ }
23
+ /** The largest the value is drawn, in pixels. */ export const MAX_VALUE_SIZE = 64;
24
+ /** The shortest a sparkline is drawn; a tile with less room drops it. */ export const MIN_SPARKLINE_HEIGHT = 16;
25
+ /** The smallest value a tile keeps room for beside a sparkline, in pixels. */ export const MIN_VALUE_SIZE = 18;
26
+ /** The smallest any text in a tile is drawn; text that would be smaller is left out. */ export const MIN_TEXT_SIZE = 8;
27
+ /** The line height, as a multiple of the font size. */ const LEADING = 1.25;
28
+ const clamp = (v, lo, hi)=>Math.max(lo, Math.min(hi, v));
29
+ /** The height of lines of these font sizes, `gap` apart. */ const blockHeight = (sizes, gap)=>sizes.reduce((sum, s)=>sum + s * LEADING, 0) + Math.max(0, sizes.length - 1) * gap;
30
+ /**
31
+ Lays out a `width` × `height` tile: the label, the value, and the delta
32
+ stacked from the top, and the sparkline filling the bottom. Font sizes
33
+ grow with the tile. A tile without a sparkline centers its text. In a
34
+ tile too short for its text, the value shrinks first; then the label and
35
+ delta shrink and the comparison words go, then the label, then the
36
+ delta, and last the value, so nothing is drawn outside the tile.
37
+ */ export function tileContent(width, height, parts) {
38
+ const pad = Math.min(clamp(Math.min(width, height) * 0.08, 6, 18), Math.min(width, height) * 0.15);
39
+ const inner = Math.max(0, height - pad * 2);
40
+ const gap = clamp(height * 0.03, 2, 8);
41
+ let labelSize = parts.label ? clamp(height * 0.085, 10, 15) : 0;
42
+ let deltaSize = parts.delta ? clamp(height * 0.08, 10, 14) : 0;
43
+ const lines = ()=>[
44
+ labelSize,
45
+ deltaSize
46
+ ].filter((s)=>s > 0);
47
+ // The room left for the value beside the other lines, as a font size.
48
+ const valueRoom = (extra = 0)=>(inner - blockHeight(lines(), gap) - (lines().length ? gap : 0) - extra) / LEADING;
49
+ let spark = parts.sparkline ? Math.min(inner * 0.32, 96) : 0;
50
+ // A sparkline gives way when it would leave the value too little room.
51
+ if (spark < MIN_SPARKLINE_HEIGHT || valueRoom(spark + gap) < MIN_VALUE_SIZE) spark = 0;
52
+ const cap = spark ? MAX_VALUE_SIZE : Math.min(MAX_VALUE_SIZE, inner * 0.45);
53
+ const preferred = clamp(valueRoom(spark ? spark + gap : 0), 12, cap);
54
+ let valueSize = Math.min(preferred, valueRoom(spark ? spark + gap : 0));
55
+ let comparison = true;
56
+ if (!spark && valueSize < 12) {
57
+ comparison = false;
58
+ if (labelSize) labelSize = MIN_TEXT_SIZE;
59
+ if (deltaSize) deltaSize = MIN_TEXT_SIZE;
60
+ valueSize = Math.min(preferred, valueRoom());
61
+ if (valueSize < 10 && labelSize) {
62
+ labelSize = 0;
63
+ valueSize = Math.min(preferred, valueRoom());
64
+ }
65
+ if (valueSize < 10 && deltaSize) {
66
+ deltaSize = 0;
67
+ valueSize = Math.min(preferred, valueRoom());
68
+ }
69
+ }
70
+ const hasValue = valueSize >= MIN_TEXT_SIZE;
71
+ const sizes = [
72
+ labelSize,
73
+ hasValue ? valueSize : 0,
74
+ deltaSize
75
+ ].filter((v)=>v > 0);
76
+ const block = blockHeight(sizes, gap);
77
+ let y = spark ? pad : pad + Math.max(0, (inner - block) / 2);
78
+ const line = (size)=>{
79
+ const out = {
80
+ y: y + size * LEADING / 2,
81
+ size
82
+ };
83
+ y += size * LEADING + gap;
84
+ return out;
85
+ };
86
+ const out = {
87
+ pad,
88
+ comparison
89
+ };
90
+ if (labelSize) out.label = line(labelSize);
91
+ if (hasValue) out.value = line(valueSize);
92
+ if (deltaSize) out.delta = line(deltaSize);
93
+ if (spark) out.sparkline = {
94
+ x: pad,
95
+ y: height - pad - spark,
96
+ width: Math.max(0, width - pad * 2),
97
+ height: spark
98
+ };
99
+ return out;
100
+ }
101
+ /** Coerces a `sparkline` setting to a type, or false for none. */ export function sparklineType(value) {
102
+ if (value === false) return false;
103
+ return value === "line" || value === "bar" ? value : "area";
104
+ }
105
+ /**
106
+ Places a series of `values` in `box`, evenly spaced in order: points
107
+ spanning the box's width for a line or area, the centers of equal bands
108
+ for bars. Bars read from zero; lines and areas fit the values' range. A
109
+ point with no value gets `NaN` coordinates.
110
+ */ export function sparklinePoints(values, box, type) {
111
+ const n = values.length;
112
+ const finite = values.filter(Number.isFinite);
113
+ if (!n || !finite.length) return [];
114
+ let lo = Math.min(...finite), hi = Math.max(...finite);
115
+ if (type === "bar") {
116
+ lo = Math.min(lo, 0);
117
+ hi = Math.max(hi, 0);
118
+ }
119
+ const span = hi - lo;
120
+ const bottom = box.y + box.height;
121
+ // Equal values sit mid-height on a line; bars that are all zero stay flat.
122
+ const y = (v)=>span > 0 ? bottom - (v - lo) / span * box.height : type === "bar" ? bottom : box.y + box.height / 2;
123
+ const base = type === "bar" ? y(0) : bottom;
124
+ const x = (k)=>type === "bar" ? box.x + (k + 0.5) / n * box.width : n > 1 ? box.x + k / (n - 1) * box.width : box.x + box.width / 2;
125
+ return values.map((v, k)=>Number.isFinite(v) ? {
126
+ x: x(k),
127
+ y: y(v),
128
+ base
129
+ } : {
130
+ x: NaN,
131
+ y: NaN,
132
+ base
133
+ });
134
+ }
@@ -15,9 +15,10 @@ import { collectComputed, makeShape, shapeConfigFor } from "../features/emitHelp
15
15
  import { shapeEmitters } from "../features/shapeEmit.js";
16
16
  import { markSharedConfig } from "../../utils/configWarnings.js";
17
17
  import { STEM_KEY_SUFFIX, stemFromBar, stemPoints } from "./stemLayout.js";
18
+ import { vizDiscrete } from "../viz/discrete.js";
18
19
  /** Each row's lollipop, measured from the bars painted for `ctx.values`. */ function measure(ctx, bars) {
19
20
  const { viz } = ctx;
20
- const discrete = viz.schema.discrete === "y" ? "y" : "x";
21
+ const discrete = vizDiscrete(viz) === "y" ? "y" : "x";
21
22
  const opp = discrete === "x" ? "y" : "x";
22
23
  const scale = discrete === "x" ? ctx.y : ctx.x;
23
24
  const layouts = new Map();
@@ -9,9 +9,10 @@ import { barWidthAccessor, labelBarWidth } from "../Plot/barWidth.js";
9
9
  import { resolveStackOffset } from "../Plot/stackHelpers.js";
10
10
  import { pyramidStackOrder } from "../Pyramid/stackOrder.js";
11
11
  import { marimekkoAxisDefaults, marimekkoFacetAxes, marimekkoFixedAxes } from "./axis.js";
12
+ import { vizDiscrete } from "../viz/discrete.js";
12
13
  /** Each bar's total along the value axis, labeled "Bar Total" in tooltips. */ function barTotal(viz) {
13
14
  return labelBarWidth((d, i)=>{
14
- const value = viz.schema.discrete === "y" ? viz._x : viz._y;
15
+ const value = vizDiscrete(viz) === "y" ? viz._x : viz._y;
15
16
  return value ? value(d, i ?? 0) : undefined;
16
17
  }, "Bar Total");
17
18
  }
@@ -5,18 +5,23 @@
5
5
  render that absorbs row/column axis scenes into `_chartScene` as chrome
6
6
  (see `inertAxis`), their labels following the hover (see
7
7
  `tagHoverTicks`). Stashes `columnScale`/`rowScale`/`cellWidth`/
8
- `cellHeight` on `viz.ctx`.
8
+ `cellHeight`, and for circle cells `maxRadius`/`radiusScale`, on
9
+ `viz.ctx`.
9
10
  */ import { inertAxis } from "../../components/Axis/axisTooltipTargets.js";
10
11
  import { defaultMaxSize } from "../../components/Axis/axisMaxSize.js";
11
12
  import { chartBounds } from "../features/chartGeometry.js";
12
13
  import { tagHoverTicks } from "../features/hoverTicks.js";
13
14
  import matrixPrepData from "../helpers/matrixData.js";
15
+ import { layoutMatrixBubbles } from "./bubbles.js";
14
16
  export const applyMatrixLayout = ({ viz })=>{
15
17
  const prep = matrixPrepData.bind(viz)(viz._filteredData);
16
18
  const { rowValues, columnValues, shapeData } = prep;
17
- if (!rowValues.length || !columnValues.length) return {
18
- shapeData: []
19
- };
19
+ if (!rowValues.length || !columnValues.length) {
20
+ viz._sizeLegendFinal = null;
21
+ return {
22
+ shapeData: []
23
+ };
24
+ }
20
25
  const { width, height } = chartBounds(viz);
21
26
  // Force rotation when columns are too narrow for horizontal labels; otherwise
22
27
  // pass `undefined` so the axis auto-rotates whenever its labels would overlap
@@ -92,6 +97,7 @@ export const applyMatrixLayout = ({ viz })=>{
92
97
  viz.ctx.rowScale = rowScale;
93
98
  viz.ctx.cellWidth = cellWidth;
94
99
  viz.ctx.cellHeight = cellHeight;
100
+ layoutMatrixBubbles(viz, shapeData);
95
101
  return {
96
102
  shapeData
97
103
  };
@@ -0,0 +1,133 @@
1
+ /**
2
+ Bubble cells for Matrix: a cell whose `shape` is `"Circle"` draws as a
3
+ circle centered in its cell, sized by the absolute value of `size` so the
4
+ largest fills the cell, or filling the cell when `size` is unset.
5
+ */ import { formatAbbreviate } from "@d3plus/format";
6
+ import { max, min } from "d3-array";
7
+ import { colorScaleValueLabel } from "../features/colorScaleTooltip.js";
8
+ import { scaleConstructors } from "../Plot/pipelineScales.js";
9
+ import { zeroAnchoredRadius } from "../Plot/pipeline.js";
10
+ /**
11
+ Whether a cell draws as a circle: its `shape` is `"Circle"`.
12
+ @param viz The chart.
13
+ @param d The cell.
14
+ @param i Its index.
15
+ */ export function matrixCellIsCircle(viz, d, i) {
16
+ const shape = viz.schema.shape;
17
+ return typeof shape === "function" && shape(d.data ?? d, d.i ?? i) === "Circle";
18
+ }
19
+ /**
20
+ A row's size magnitude: the absolute value of its `size`, or NaN when it
21
+ has none (or `size` is unset).
22
+ @param viz The chart.
23
+ @param d The source row.
24
+ @param i Its index.
25
+ */ export function matrixSizeValue(viz, d, i) {
26
+ if (!viz._size) return NaN;
27
+ const raw = viz._size(d, i);
28
+ if (raw === null || raw === undefined || raw === "") return NaN;
29
+ const value = Number(raw);
30
+ return Number.isFinite(value) ? Math.abs(value) : NaN;
31
+ }
32
+ /**
33
+ The radius a circle may reach in a cell: half the cell's shorter side,
34
+ less the padding between cells.
35
+ @param cellWidth The cell's width.
36
+ @param cellHeight The cell's height.
37
+ @param cellPadding The pixel gap between neighboring cells.
38
+ */ export function matrixMaxRadius(cellWidth, cellHeight, cellPadding) {
39
+ const side = Math.min(cellWidth, cellHeight) - cellPadding;
40
+ return Number.isFinite(side) ? Math.max(0, side / 2) : 0;
41
+ }
42
+ /**
43
+ The value → radius scale for bubble cells, anchored at zero so the
44
+ largest value draws at `maxRadius` and smaller ones draw as small as they
45
+ are: with `"sqrt"`, a circle's area is proportional to its value, and
46
+ with `"linear"`, its radius. Its domain is the extent of the values above
47
+ zero (a zero draws no circle), which the size legend reads. Null when no
48
+ value is above zero.
49
+ @param scale The scale type (`"sqrt"`, `"linear"`, …).
50
+ @param values The size magnitudes.
51
+ @param maxRadius The largest radius.
52
+ */ export function matrixRadiusScale(scale, values, maxRadius) {
53
+ const positive = values.filter((v)=>Number.isFinite(v) && v > 0);
54
+ const hi = max(positive);
55
+ if (hi === undefined || !(maxRadius > 0)) return null;
56
+ const lo = min(positive);
57
+ const name = `scale${scale.charAt(0).toUpperCase()}${scale.slice(1)}`;
58
+ const make = scaleConstructors[name] ?? scaleConstructors.scaleSqrt;
59
+ const anchored = zeroAnchoredRadius(make, [
60
+ lo,
61
+ hi
62
+ ], maxRadius);
63
+ return make().domain([
64
+ lo,
65
+ hi
66
+ ]).range([
67
+ Number.isFinite(anchored) ? anchored : maxRadius / 4,
68
+ maxRadius
69
+ ]);
70
+ }
71
+ /**
72
+ Sizes a laid-out Matrix's circle cells against the cell size stashed on
73
+ `viz.ctx` (`cellWidth`/`cellHeight`): stashes the largest radius as
74
+ `maxRadius` and the value → radius scale as `radiusScale` (null without
75
+ a `size`), which the size legend paints as `viz._sizeLegendFinal`.
76
+ Small multiples size every panel's circles against every panel's values
77
+ (`viz.ctx.sharedSizeValues`).
78
+ @param viz The chart.
79
+ @param cells The cells.
80
+ */ export function layoutMatrixBubbles(viz, cells) {
81
+ const maxRadius = matrixMaxRadius(viz.ctx.cellWidth, viz.ctx.cellHeight, viz.schema.cellPadding ?? 0);
82
+ const circles = cells.filter((d, i)=>matrixCellIsCircle(viz, d, i));
83
+ const values = viz.ctx.sharedSizeValues ?? circles.map((d, i)=>matrixSizeValue(viz, d.data ?? d, d.i ?? i)).filter(Number.isFinite);
84
+ const radiusScale = viz._size && circles.length ? matrixRadiusScale(viz.schema.sizeScale, values, maxRadius) : null;
85
+ viz.ctx.maxRadius = maxRadius;
86
+ viz.ctx.radiusScale = radiusScale;
87
+ viz._sizeLegendFinal = radiusScale;
88
+ }
89
+ /**
90
+ The size magnitudes of the rows a chart draws as circles.
91
+ @param viz The chart.
92
+ @param rows The rows.
93
+ */ export function matrixSizeValues(viz, rows) {
94
+ const shape = viz.schema.shape;
95
+ return rows.filter((d, i)=>!shape || shape(d, i) === "Circle").map((d, i)=>matrixSizeValue(viz, d, i)).filter(Number.isFinite);
96
+ }
97
+ /**
98
+ The radius scale before layout, for the size legend to reserve room:
99
+ each cell's share of `available`, before the axis labels take theirs.
100
+ Null without a `size`, or when no row draws as a sized circle.
101
+ @param viz The chart.
102
+ @param available The chart area, in pixels.
103
+ */ export function matrixSizeLegendScale(viz, available) {
104
+ if (!viz._size) return null;
105
+ const rows = viz._filteredData ?? [];
106
+ const values = viz.ctx.sharedSizeValues ?? matrixSizeValues(viz, rows);
107
+ if (!values.length) return null;
108
+ const count = (key)=>new Set(rows.map((d, i)=>viz.schema[key](d, i))).size || 1;
109
+ const radius = matrixMaxRadius(available.width / count("column"), available.height / count("row"), viz.schema.cellPadding ?? 0);
110
+ return matrixRadiusScale(viz.schema.sizeScale, values, radius);
111
+ }
112
+ /**
113
+ The tooltip row showing a sized circle's signed `size` value, named by
114
+ the `size` key (or "Value"). None when the cell isn't a sized circle, or
115
+ the colorScale already shows a row under the same name.
116
+ @param viz The chart.
117
+ @param d The hovered row.
118
+ @param i Its index.
119
+ */ export function matrixSizeTooltipRows(viz, d, i) {
120
+ if (!viz._size || !d || typeof d !== "object") return [];
121
+ const shape = viz.schema.shape;
122
+ if (shape && shape(d, i) !== "Circle") return [];
123
+ if (!Number.isFinite(matrixSizeValue(viz, d, i))) return [];
124
+ const label = viz._sizeKey ?? viz.schema.translate("Value");
125
+ if (viz.schema.colorScale && colorScaleValueLabel(viz) === label) return [];
126
+ const value = Number(viz._size(d, i));
127
+ return [
128
+ [
129
+ label,
130
+ formatAbbreviate(value, viz.schema.locale)
131
+ ]
132
+ ];
133
+ }
@@ -1,9 +1,24 @@
1
1
  /**
2
- `matrixEmit` — Rect cells positioned by the row/column scales stashed
3
- on `viz.ctx`.
2
+ `matrixEmit` — cells positioned by the row/column scales stashed on
3
+ `viz.ctx`: Rects, or Circles for cells whose `shape` is `"Circle"` (see
4
+ `bubbles.ts`).
4
5
  */ import { textureFill, shapeConfigFor, resolveAccessor } from "../features/emitHelpers.js";
5
6
  import { backgroundImageNodes } from "../features/backgroundImageEmit.js";
6
- export const matrixEmit = ({ viz, shapeData })=>{
7
+ import { matrixCellIsCircle, matrixSizeValue } from "./bubbles.js";
8
+ import { pairLabels } from "../features/labelLayering.js";
9
+ /**
10
+ A circle cell's radius: its size value through the radius scale, or the
11
+ cell's full radius without a `size`. Null when it has no size to draw.
12
+ */ function circleRadius(viz, d, i) {
13
+ const maxRadius = viz.ctx.maxRadius;
14
+ if (!viz._size) return maxRadius;
15
+ const radius = viz.ctx.radiusScale;
16
+ const value = matrixSizeValue(viz, d.data ?? d, d.i ?? i);
17
+ if (!radius || !Number.isFinite(value)) return null;
18
+ const r = radius(value);
19
+ return r > 0 ? Math.min(r, maxRadius) : null;
20
+ }
21
+ export const matrixEmit = pairLabels(({ viz, shapeData })=>{
7
22
  const cells = shapeData ?? [];
8
23
  if (!cells.length) return [];
9
24
  const columnScale = viz.ctx.columnScale;
@@ -11,40 +26,68 @@ export const matrixEmit = ({ viz, shapeData })=>{
11
26
  const cellWidth = viz.ctx.cellWidth;
12
27
  const cellHeight = viz.ctx.cellHeight;
13
28
  const cellPadding = viz.schema.cellPadding ?? 0;
14
- const sc = shapeConfigFor(viz, "Rect");
29
+ const rectConfig = shapeConfigFor(viz, "Rect");
30
+ const circleConfig = shapeConfigFor(viz, "Circle");
15
31
  const colorScale = viz.schema.colorScale;
16
- const cellNodes = cells.map((d, i)=>{
32
+ const cellNodes = [];
33
+ const cellData = [];
34
+ cells.forEach((d, i)=>{
35
+ const circle = matrixCellIsCircle(viz, d, i);
36
+ const r = circle ? circleRadius(viz, d, i) : 0;
37
+ if (r === null) return;
38
+ const sc = circle ? circleConfig : rectConfig;
17
39
  const fill = resolveAccessor(sc.fill, d, i);
18
40
  const stroke = resolveAccessor(sc.stroke, d, i);
19
41
  const strokeWidth = resolveAccessor(sc.strokeWidth, d, i);
42
+ const cx = columnScale(d.column) + cellWidth / 2;
43
+ const cy = rowScale(d.row) + cellHeight / 2;
44
+ const validColorScale = colorScale ? `, ${colorScale(d.data ?? d, i)}` : "";
45
+ const paint = {
46
+ fill: textureFill(sc, d, i, fill),
47
+ stroke,
48
+ strokeWidth
49
+ };
50
+ const aria = {
51
+ label: `${d.row}, ${d.column}${validColorScale}.`
52
+ };
20
53
  const w = cellWidth - cellPadding;
21
54
  const h = cellHeight - cellPadding;
22
- const x = columnScale(d.column) + cellWidth / 2 - w / 2;
23
- const y = rowScale(d.row) + cellHeight / 2 - h / 2;
24
- const validColorScale = colorScale ? `, ${colorScale(d.data ?? d, i)}` : "";
25
- return {
55
+ cellData.push([
56
+ d,
57
+ i
58
+ ]);
59
+ cellNodes.push(circle ? {
60
+ type: "circle",
61
+ key: `matrix-circle-${i}`,
62
+ cx,
63
+ cy,
64
+ r,
65
+ datum: d,
66
+ paint,
67
+ aria
68
+ } : {
26
69
  type: "rect",
27
70
  key: `matrix-${i}`,
28
- x,
29
- y,
71
+ x: cx - w / 2,
72
+ y: cy - h / 2,
30
73
  width: w,
31
74
  height: h,
32
75
  datum: d,
33
- paint: {
34
- fill: textureFill(sc, d, i, fill),
35
- stroke,
36
- strokeWidth
37
- },
38
- aria: {
39
- label: `${d.row}, ${d.column}${validColorScale}.`
40
- }
41
- };
76
+ paint,
77
+ aria
78
+ });
42
79
  });
80
+ // Each shape's `backgroundImage` fills the cells drawn as that shape.
81
+ const images = (type, sc)=>{
82
+ const picked = cellNodes.map((node, k)=>[
83
+ node,
84
+ k
85
+ ]).filter(([node])=>node.type === type);
86
+ return backgroundImageNodes(sc, picked.map(([node])=>node), (k)=>cellData[picked[k][1]]);
87
+ };
43
88
  return [
44
89
  ...cellNodes,
45
- ...backgroundImageNodes(sc, cellNodes, (k)=>[
46
- cells[k],
47
- k
48
- ])
90
+ ...images("rect", rectConfig),
91
+ ...images("circle", circleConfig)
49
92
  ];
50
- };
93
+ });
@@ -3,7 +3,8 @@
3
3
 
4
4
  Implementation files in this folder:
5
5
  - `applyLayout.ts` — `TransformStage` that runs the row+column axes.
6
- - `emit.ts` — Rect cells positioned by the stashed scales.
6
+ - `emit.ts` — Rect (or Circle) cells positioned by the stashed scales.
7
+ - `bubbles.ts` — Circle cells sized by `size`.
7
8
  */ import accessor from "../../utils/accessor.js";
8
9
  import { fieldAccessor } from "../../utils/fieldAccessor.js";
9
10
  import { Axis } from "../../components/index.js";
@@ -11,11 +12,12 @@ import { colorScaleBucketOf } from "../features/colorScaleBucket.js";
11
12
  import { getProp } from "../../utils/index.js";
12
13
  import { makeChart } from "../definition/makeChart.js";
13
14
  import { applyMatrixLayout } from "./applyLayout.js";
15
+ import { matrixSizeLegendScale, matrixSizeTooltipRows, matrixSizeValues } from "./bubbles.js";
14
16
  import { matrixEmit } from "./emit.js";
15
17
  const defaultAxisConfig = {
16
18
  align: "start",
17
19
  barConfig: {
18
- stroke: 0
20
+ stroke: "transparent"
19
21
  },
20
22
  gridSize: 0,
21
23
  padding: 5,
@@ -28,12 +30,26 @@ const localeCompare = (a, b)=>`${a}`.localeCompare(`${b}`);
28
30
  export const matrixDef = {
29
31
  name: "Matrix",
30
32
  layoutStage: applyMatrixLayout,
33
+ sizeLegendScale: matrixSizeLegendScale,
31
34
  emit: matrixEmit,
32
35
  chartTransform: (viz)=>({
33
36
  x: 0,
34
37
  y: viz._margin.top
35
38
  }),
36
39
  setup: (viz)=>{
40
+ /**
41
+ Sizes each circle cell (a cell whose `shape` is `"Circle"`) by the
42
+ absolute value of a data key or accessor function, so the largest
43
+ circle fills its cell (see `sizeScale`) and the size legend keys
44
+ the sizes. A cell without a value draws no circle. When unset,
45
+ every circle fills its cell.
46
+ @type {string | function}
47
+ */ viz.size = function(_) {
48
+ if (!arguments.length) return this._size;
49
+ this._size = typeof _ === "function" || !_ ? _ : fieldAccessor(_);
50
+ this._sizeKey = typeof _ === "string" ? _ : undefined;
51
+ return this;
52
+ };
37
53
  const baseMouseMoveShape = viz.schema.on["mousemove.shape"];
38
54
  viz.schema.on["mousemove.shape"] = (d, i, x, event)=>{
39
55
  baseMouseMoveShape(d, i, x, event);
@@ -66,9 +82,18 @@ export const matrixDef = {
66
82
  viz.hover(hover);
67
83
  };
68
84
  },
69
- // Small-multiple panels as close to square as the grid allows.
70
85
  facet: {
71
- aspect: 1
86
+ // Panels as close to square as the grid allows.
87
+ aspect: 1,
88
+ // Every panel's circles share one size scale.
89
+ share: (viz, panels)=>viz._size ? matrixSizeValues(viz, panels.flat()) : undefined,
90
+ panel: (viz, { shared, scales })=>{
91
+ const previous = viz.ctx.sharedSizeValues;
92
+ if (shared && scales) viz.ctx.sharedSizeValues = scales;
93
+ return ()=>{
94
+ viz.ctx.sharedSizeValues = previous;
95
+ };
96
+ }
72
97
  },
73
98
  ctx: {
74
99
  rowAxis: new Axis(),
@@ -137,6 +162,22 @@ export const matrixDef = {
137
162
  ...defaultAxisConfig
138
163
  }
139
164
  },
165
+ /**
166
+ How circle cells scale their `size` values to radii, anchored at
167
+ zero: `"sqrt"` (the default) makes each circle's area proportional
168
+ to its value, and `"linear"` its radius.
169
+ @type {"sqrt" | "linear"}
170
+ */ {
171
+ key: "sizeScale",
172
+ default: "sqrt"
173
+ },
174
+ {
175
+ key: "tooltipConfig",
176
+ merge: true,
177
+ factory: (viz)=>({
178
+ tbody: (d, i)=>matrixSizeTooltipRows(viz, d, i)
179
+ })
180
+ },
140
181
  {
141
182
  key: "label",
142
183
  coerce: "const",