@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,141 @@
1
+ /**
2
+ Hovering a marginal mark (see `marginalScene`): its own tooltip, named by
3
+ its series, and a linked hover that lights the points it summarizes,
4
+ along with every other marginal mark holding them.
5
+
6
+ @module
7
+ */ import { formatAbbreviate } from "@d3plus/format";
8
+ import { configPrep } from "../../utils/index.js";
9
+ import { swatchOutline } from "../features/swatchPaint.js";
10
+ import { leadTitleWithSwatch, tooltipSwatch } from "../features/tooltipSwatch.js";
11
+ import { chartBackground } from "../viz/backgroundInk.js";
12
+ import { shapeHoverEnabled } from "../viz/shapeHover.js";
13
+ import { axisName, axisValue, prepareTooltip } from "./sharedTooltip.js";
14
+ /** The tooltip's title: the mark's series, or for a single series its axis. */ export function marginalTitle(viz, mark) {
15
+ return mark.series.label || axisName(viz, mark.axis);
16
+ }
17
+ /**
18
+ The tooltip's rows for a marginal mark, its values formatted as its axis
19
+ formats them: a bin's range and count; a box's whisker ends, quartiles,
20
+ median and count; an outlier's value; a density curve's value under the
21
+ pointer (`value`, in marginal space) and count.
22
+ @param viz The chart.
23
+ @param mark The hovered mark.
24
+ @param value The marginal-space value under the pointer, for a curve.
25
+ */ export function marginalTooltipRows(viz, mark, value) {
26
+ const t = (s)=>viz.schema.translate(s);
27
+ const scale = viz._plotMarginals?.scales[mark.axis];
28
+ const at = (v)=>axisValue(viz, mark.axis, scale ? scale.from(v) : v);
29
+ const count = [
30
+ t(mark.kind === "histogram" ? "Count" : "Observations"),
31
+ formatAbbreviate(mark.rows.length, viz.schema.locale)
32
+ ];
33
+ const name = axisName(viz, mark.axis) || t("Value");
34
+ if (mark.outlier) return [
35
+ [
36
+ name,
37
+ at(mark.outlier.value)
38
+ ]
39
+ ];
40
+ if (mark.bin) return [
41
+ [
42
+ name,
43
+ `${at(mark.bin.x0)} – ${at(mark.bin.x1)}`
44
+ ],
45
+ count
46
+ ];
47
+ if (mark.box) {
48
+ const b = mark.box;
49
+ return [
50
+ [
51
+ t("Upper Whisker"),
52
+ at(b.upperLimit)
53
+ ],
54
+ [
55
+ t("Upper Quartile"),
56
+ at(b.third)
57
+ ],
58
+ [
59
+ t("Median"),
60
+ at(b.median)
61
+ ],
62
+ [
63
+ t("Lower Quartile"),
64
+ at(b.first)
65
+ ],
66
+ [
67
+ t("Lower Whisker"),
68
+ at(b.lowerLimit)
69
+ ],
70
+ count
71
+ ];
72
+ }
73
+ return value === undefined || !Number.isFinite(value) ? [
74
+ count
75
+ ] : [
76
+ [
77
+ name,
78
+ at(value)
79
+ ],
80
+ count
81
+ ];
82
+ }
83
+ /**
84
+ The marginal-space value under a content-space pointer along a mark's
85
+ axis, or undefined when the axis can't be read back.
86
+ */ function valueAt(viz, mark, cursor) {
87
+ const curve = mark.curve?.curve;
88
+ const scale = viz._plotMarginals?.scales[mark.axis];
89
+ const position = mark.axis === "x" ? viz._xFunc : viz._yFunc;
90
+ if (!curve || !curve.length || !scale || !position) return undefined;
91
+ const target = mark.axis === "x" ? cursor[0] : cursor[1];
92
+ let best = curve[0][0], gap = Infinity;
93
+ for (const [v] of curve){
94
+ const d = Math.abs(position(scale.from(v)) - target);
95
+ if (d < gap) [best, gap] = [
96
+ v,
97
+ d
98
+ ];
99
+ }
100
+ return best;
101
+ }
102
+ /** The predicate a marginal hover sets, by the hovered mark, so moving within it doesn't repaint. */ const hoverFilters = new WeakMap();
103
+ /**
104
+ Hovering a marginal mark: its tooltip replaces any other, and unless
105
+ shape hover is off, the points it summarizes stay lit while every other
106
+ point dims (with the marginal marks that hold none of them). The leave
107
+ path of `handleSharedHover` tears both down.
108
+ @param viz The chart.
109
+ @param mark The hovered mark.
110
+ @param event The pointer event.
111
+ @param cursor The pointer in content space.
112
+ */ export function handleMarginalHover(viz, mark, event, cursor) {
113
+ viz._sharedHoverActive = true;
114
+ viz._sharedHoverState = null;
115
+ const native = event.nativeEvent;
116
+ const position = native && native.touches && native.touches.length ? [
117
+ native.touches[0].clientX,
118
+ native.touches[0].clientY
119
+ ] : native ? [
120
+ native.clientX,
121
+ native.clientY
122
+ ] : event.point;
123
+ const tip = prepareTooltip(viz).data([
124
+ mark.rows[0] ?? {}
125
+ ]).config(configPrep.bind(viz)(viz.schema.tooltipConfig)).title(()=>marginalTitle(viz, mark));
126
+ const shape = mark.kind === "density" ? "Area" : "Rect";
127
+ leadTitleWithSwatch(tip, tooltipSwatch({
128
+ color: mark.swatch ?? mark.series.color,
129
+ outline: mark.swatchOutline && swatchOutline(mark.swatchOutline, {
130
+ background: chartBackground(viz)
131
+ })
132
+ }, shape)).thead([]).tbody(marginalTooltipRows(viz, mark, cursor ? valueAt(viz, mark, cursor) : undefined)).footer(false).position(position).render();
133
+ if (!shapeHoverEnabled(viz)) return;
134
+ let filter = hoverFilters.get(mark);
135
+ if (!filter) {
136
+ const rows = new Set(mark.rows);
137
+ filter = (d)=>rows.has(d);
138
+ hoverFilters.set(mark, filter);
139
+ }
140
+ if (viz._hover !== filter) viz.hover(filter);
141
+ }
@@ -0,0 +1,102 @@
1
+ /**
2
+ Where a Plot's marginal strips (`marginals`) go: the room the plot leaves
3
+ for them above its area (the x axis's distribution) and right of it (the
4
+ y axis's), and each strip's band once the axes have settled. The strips
5
+ sit outside any x2 or y2 axis, which keep hugging the plot.
6
+
7
+ @module
8
+ */ import { marginalScale, resolveMarginals } from "./marginalStats.js";
9
+ import { vizDiscrete } from "../viz/discrete.js";
10
+ /** A strip's default thickness, as a share of the chart area's shorter side. */ export const MARGINAL_SHARE = 0.15;
11
+ /** The thinnest and thickest a strip sized by a share gets, in pixels. */ export const MARGINAL_MIN = 16;
12
+ export const MARGINAL_MAX = 120;
13
+ /** The default gap between a strip and the plot (or its x2/y2 axis), in pixels. */ export const MARGINAL_PADDING = 8;
14
+ /**
15
+ A strip's thickness in pixels: `size` itself above 1, else that share
16
+ (by default `MARGINAL_SHARE`) of the chart area's shorter side, kept
17
+ between `MARGINAL_MIN` and `MARGINAL_MAX`.
18
+ @param size The configured size.
19
+ @param width The chart area's width.
20
+ @param height The chart area's height.
21
+ */ export function marginalSize(size, width, height) {
22
+ const value = typeof size === "number" && size > 0 ? size : MARGINAL_SHARE;
23
+ if (value > 1) return value;
24
+ const px = Math.round(value * Math.max(0, Math.min(width, height)));
25
+ return Math.max(MARGINAL_MIN, Math.min(MARGINAL_MAX, px));
26
+ }
27
+ /**
28
+ The marginal strips a Plot draws, or null for none: `marginals` names
29
+ them, and each axis gets its strip only while both axes are continuous
30
+ (no category axis or swarm) and that axis can place a distribution.
31
+ @param viz The chart.
32
+ @param area The chart area's width and height.
33
+ @param types Each axis's scale type (`"linear"`, `"log"`, `"time"`, …).
34
+ */ export function resolveMarginalLayout(viz, area, types) {
35
+ const asked = resolveMarginals(viz.schema.marginals);
36
+ if (!asked.x && !asked.y || vizDiscrete(viz) || viz._swarm) return null;
37
+ const scales = {
38
+ x: marginalScale(types.x),
39
+ y: marginalScale(types.y)
40
+ };
41
+ if (!scales.x || !scales.y) return null;
42
+ const config = viz.schema.marginalConfig ?? {};
43
+ const size = marginalSize(config.size, area.width, area.height);
44
+ const padding = typeof config.padding === "number" && config.padding >= 0 ? config.padding : MARGINAL_PADDING;
45
+ return {
46
+ axes: asked,
47
+ scales,
48
+ size,
49
+ padding,
50
+ top: asked.x ? size + padding : 0,
51
+ right: asked.y ? size + padding : 0
52
+ };
53
+ }
54
+ /**
55
+ The bands of the top (x) and right (y) strips, given the plot's final
56
+ ranges: the top strip runs above the plot and any x2 axis, and the right
57
+ strip right of the plot and any y2 axis, each `padding` clear of them.
58
+ @param layout The marginal layout.
59
+ @param plot The plot's x and y ranges in content space, and the x2
60
+ axis's height and y2 axis's width.
61
+ */ export function marginalBands(layout, plot) {
62
+ const { size, padding } = layout;
63
+ const top = plot.yRange[0] - plot.x2Height, bottom = plot.yRange[1] - plot.x2Height;
64
+ const right = plot.xRange[plot.xRange.length - 1];
65
+ const above = top - plot.x2Height - padding;
66
+ const beside = right + (plot.y2Width ?? 0) + padding;
67
+ return {
68
+ x: {
69
+ along: [
70
+ plot.xRange[0],
71
+ right
72
+ ],
73
+ across: [
74
+ above,
75
+ above - size
76
+ ]
77
+ },
78
+ y: {
79
+ along: [
80
+ top,
81
+ bottom
82
+ ],
83
+ across: [
84
+ beside,
85
+ beside + size
86
+ ]
87
+ }
88
+ };
89
+ }
90
+ /**
91
+ `resolveMarginalLayout` for a Plot draw, from its axes' scale types: a
92
+ point or band scale (a category axis), else the scale its axis draws.
93
+ @param viz The chart.
94
+ @param area The chart area's width and height.
95
+ @param scales The draw's `plotScales` and `plotConfigScales`.
96
+ */ export function plotMarginalLayout(viz, area, scales) {
97
+ const category = /^(point|band)$/i;
98
+ return resolveMarginalLayout(viz, area, {
99
+ x: category.test(scales.xScale) ? scales.xScale : scales.xConfigScale,
100
+ y: category.test(scales.yScale) ? scales.yScale : scales.yConfigScale
101
+ });
102
+ }
@@ -0,0 +1,105 @@
1
+ /**
2
+ How a Plot's marginal marks paint (`marginalConfig`): each kind's
3
+ defaults, layered under the user's keys for every mark, for the kind,
4
+ and for a box's part, then resolved for one mark.
5
+
6
+ @module
7
+ */ const FILL_KEYS = [
8
+ "fill",
9
+ "fillOpacity"
10
+ ];
11
+ const STROKE_KEYS = [
12
+ "stroke",
13
+ "strokeWidth",
14
+ "strokeOpacity",
15
+ "strokeDasharray"
16
+ ];
17
+ const PAINT_KEYS = [
18
+ ...FILL_KEYS,
19
+ ...STROKE_KEYS,
20
+ "opacity"
21
+ ];
22
+ const seriesColor = (d)=>d.series.color;
23
+ /**
24
+ Each kind's default paint, in its series' color: solid histogram bars;
25
+ boxes at 0.35 fill opacity with a 1px stroke, and solid, unstroked
26
+ outlier dots of radius 2; density curves filled at 0.3 opacity and
27
+ outlined 1.5px wide.
28
+ */ export function marginalPaintDefaults() {
29
+ return {
30
+ histogram: {
31
+ fill: seriesColor
32
+ },
33
+ box: {
34
+ fill: seriesColor,
35
+ fillOpacity: 0.35,
36
+ stroke: seriesColor,
37
+ strokeWidth: 1,
38
+ outlier: {
39
+ fillOpacity: 1,
40
+ stroke: "none",
41
+ r: 2
42
+ }
43
+ },
44
+ density: {
45
+ fill: seriesColor,
46
+ fillOpacity: 0.3,
47
+ stroke: seriesColor,
48
+ strokeWidth: 1.5
49
+ }
50
+ };
51
+ }
52
+ /**
53
+ The layers a mark's paint resolves through, lowest first: its kind's
54
+ defaults, the user's keys for every mark and for its kind, then its
55
+ part's defaults (so an outlier dot stays solid however the boxes are
56
+ filled) and the user's keys for its part.
57
+ @param config The chart's `marginalConfig`.
58
+ @param kind The mark's kind.
59
+ @param part A box's part.
60
+ */ export function marginalPaintLayers(config, kind, part) {
61
+ const defaults = marginalPaintDefaults()[kind];
62
+ const user = config[kind];
63
+ return [
64
+ defaults,
65
+ config,
66
+ user,
67
+ part ? defaults[part] : undefined,
68
+ part && user ? user[part] : undefined
69
+ ].filter((layer)=>!!layer && typeof layer === "object");
70
+ }
71
+ /** A `strokeDasharray` value as numbers: an array, or a space- or comma-separated string. */ function dashes(value) {
72
+ const list = Array.isArray(value) ? value : typeof value === "string" ? value.trim().split(/[\s,]+/) : [];
73
+ const numbers = list.map(Number).filter((n)=>Number.isFinite(n));
74
+ return numbers.length ? numbers : undefined;
75
+ }
76
+ /**
77
+ A mark's paint (and an outlier dot's radius) from its layers, each key
78
+ the last layer's that sets it, an accessor called with the mark and its
79
+ series' index. A line takes only stroke keys and no fill, and a density
80
+ curve's fill only fill keys.
81
+ @param layers The mark's layers (see `marginalPaintLayers`).
82
+ @param role Which keys the mark takes.
83
+ @param d The mark.
84
+ @param i Its series' index in its strip.
85
+ */ export function resolveMarginalPaint(layers, role, d, i) {
86
+ const value = (key)=>{
87
+ let v;
88
+ for (const layer of layers)if (layer[key] !== undefined) v = layer[key];
89
+ return typeof v === "function" ? v(d, i) : v;
90
+ };
91
+ const keys = PAINT_KEYS.filter((key)=>role === "line" ? !FILL_KEYS.includes(key) : role === "fill" ? !STROKE_KEYS.includes(key) : true);
92
+ const paint = {};
93
+ for (const key of keys){
94
+ const v = key === "strokeDasharray" ? dashes(value(key)) : value(key);
95
+ if (v !== undefined && v !== null) paint[key] = v;
96
+ }
97
+ if (role === "line") paint.fill = "none";
98
+ const r = Number(value("r"));
99
+ return {
100
+ paint: paint,
101
+ ...r > 0 ? {
102
+ r
103
+ } : {}
104
+ };
105
+ }
@@ -0,0 +1,272 @@
1
+ /**
2
+ Paints a Plot's marginal strips (`marginals`): the x axis's distribution
3
+ above the plot and the y axis's right of it, drawn along the plot's own
4
+ axes from the points it plots, one series per legend entry.
5
+
6
+ Each mark is drawn on behalf of the points it summarizes: it carries them
7
+ as `interactionPoints` instead of a datum of its own, so hovering a point
8
+ (or a legend entry) lights the bins, boxes and curves holding it, and its
9
+ `marginal` record feeds the tooltip and linked hover in `marginalHover`.
10
+
11
+ @module
12
+ */ import { swatchOutline } from "../features/swatchPaint.js";
13
+ import { marginalBands } from "./marginalLayout.js";
14
+ import { marginalPaintLayers, resolveMarginalPaint } from "./marginalPaint.js";
15
+ import { marginalSeries } from "./marginalSeries.js";
16
+ import { binMarginal, boxMarginal, densityMarginal } from "./marginalStats.js";
17
+ /** The interaction group marginal marks are stamped with. */ export const MARGINAL_GROUP = "marginal";
18
+ /** The gap between neighboring histogram bins, in pixels. */ export const MARGINAL_BIN_GAP = 1;
19
+ /**
20
+ A mark's paint (and an outlier dot's radius) from `marginalConfig` (see
21
+ `resolveMarginalPaint`), its accessors given the mark and its series'
22
+ index in the strip.
23
+ */ function paintOf(strip, mark, role, part) {
24
+ const i = [
25
+ ...strip.series.keys()
26
+ ].indexOf(mark.series.key);
27
+ const layers = marginalPaintLayers(strip.config, mark.kind, part);
28
+ return resolveMarginalPaint(layers, role, mark, i);
29
+ }
30
+ /** Notes the color a mark's tooltip swatch shows. */ function swatch(mark, paint) {
31
+ const fill = paint.fill && paint.fill !== "none" ? paint.fill : undefined;
32
+ mark.swatch = fill ?? paint.stroke ?? mark.series.color;
33
+ mark.swatchOutline = fill ? swatchOutline(paint) : undefined;
34
+ return paint;
35
+ }
36
+ /** The pixel position `share` (0–1) of the way out from the strip's inner edge. */ const across = (strip, share)=>{
37
+ const [inner, outer] = strip.band.across;
38
+ return inner + (outer - inner) * share;
39
+ };
40
+ /** A point `[along, across]` as `[x, y]` for the strip's axis. */ const xy = (strip, a, c)=>strip.axis === "x" ? [
41
+ a,
42
+ c
43
+ ] : [
44
+ c,
45
+ a
46
+ ];
47
+ /** A rect spanning `[a0, a1]` along the strip and `[c0, c1]` across it. */ function rectNode(strip, key, [a0, a1], [c0, c1], paint) {
48
+ const [x0, y0] = xy(strip, Math.min(a0, a1), Math.min(c0, c1));
49
+ const [w, h] = xy(strip, Math.abs(a1 - a0), Math.abs(c1 - c0));
50
+ return {
51
+ type: "rect",
52
+ key,
53
+ x: x0,
54
+ y: y0,
55
+ width: w,
56
+ height: h,
57
+ paint
58
+ };
59
+ }
60
+ /** Stamps a node as a marginal mark drawn on behalf of `mark.rows`. */ function stamp(node, mark) {
61
+ const n = node;
62
+ n.interactionGroup = MARGINAL_GROUP;
63
+ n.marginal = mark;
64
+ // A summary of marks a screen reader reaches on their own (and in the table view).
65
+ n.aria = {
66
+ hidden: true
67
+ };
68
+ const box = n.type === "rect" ? n : null;
69
+ const cx = box ? box.x + box.width / 2 : 0, cy = box ? box.y + box.height / 2 : 0;
70
+ n.interactionPoints = mark.rows.map((datum, index)=>({
71
+ x: cx,
72
+ y: cy,
73
+ datum,
74
+ index
75
+ }));
76
+ return n;
77
+ }
78
+ /** A histogram strip: each series' bins stacked out from the plot. */ function histogramNodes(strip, observations, domain, thresholds) {
79
+ const { bins, max } = binMarginal(observations, domain, [
80
+ ...strip.series.keys()
81
+ ], thresholds);
82
+ if (!max) return [];
83
+ return bins.map((bin)=>{
84
+ const series = strip.series.get(bin.group);
85
+ const a0 = strip.along(bin.x0), a1 = strip.along(bin.x1);
86
+ const lo = Math.min(a0, a1) + MARGINAL_BIN_GAP / 2, hi = Math.max(a0, a1) - MARGINAL_BIN_GAP / 2;
87
+ const mark = {
88
+ axis: strip.axis,
89
+ kind: "histogram",
90
+ series,
91
+ rows: bin.rows,
92
+ bin
93
+ };
94
+ const node = rectNode(strip, `marginal-${strip.axis}-bin-${series.key}-${bin.x0}`, [
95
+ lo,
96
+ Math.max(lo, hi)
97
+ ], [
98
+ across(strip, bin.y0 / max),
99
+ across(strip, (bin.y0 + bin.count) / max)
100
+ ], swatch(mark, paintOf(strip, mark, "shape").paint));
101
+ return stamp(node, mark);
102
+ });
103
+ }
104
+ /** A box strip: one box per series, side by side across the strip. */ function boxNodes(strip, observations, domain) {
105
+ const boxes = boxMarginal(observations, domain, [
106
+ ...strip.series.keys()
107
+ ]);
108
+ const lane = 1 / Math.max(1, boxes.length);
109
+ const thickness = Math.min(lane * strip.size * 0.7, 20);
110
+ return boxes.flatMap((box, k)=>{
111
+ const series = strip.series.get(box.group);
112
+ const mark = {
113
+ axis: strip.axis,
114
+ kind: "box",
115
+ series,
116
+ rows: box.rows,
117
+ box
118
+ };
119
+ const center = across(strip, lane * (k + 0.5));
120
+ const half = thickness / 2;
121
+ const key = `marginal-${strip.axis}-box-${series.key}`;
122
+ const whisker = paintOf(strip, mark, "line", "whisker").paint;
123
+ const line = (id, a0, a1, c0, c1, paint = whisker)=>stamp({
124
+ type: "line",
125
+ key: `${key}-${id}`,
126
+ points: [
127
+ xy(strip, a0, c0),
128
+ xy(strip, a1, c1)
129
+ ],
130
+ paint
131
+ }, mark);
132
+ const at = strip.along;
133
+ const nodes = [
134
+ line("whisker-low", at(box.lowerLimit), at(box.first), center, center),
135
+ line("whisker-high", at(box.third), at(box.upperLimit), center, center),
136
+ line("cap-low", at(box.lowerLimit), at(box.lowerLimit), center - half / 2, center + half / 2),
137
+ line("cap-high", at(box.upperLimit), at(box.upperLimit), center - half / 2, center + half / 2),
138
+ stamp(rectNode(strip, `${key}-rect`, [
139
+ at(box.first),
140
+ at(box.third)
141
+ ], [
142
+ center - half,
143
+ center + half
144
+ ], swatch(mark, paintOf(strip, mark, "shape").paint)), mark),
145
+ line("median", at(box.median), at(box.median), center - half, center + half, paintOf(strip, mark, "line", "median").paint)
146
+ ];
147
+ box.outliers.forEach((o, j)=>{
148
+ const [cx, cy] = xy(strip, at(o.value), center);
149
+ const dot = {
150
+ ...mark,
151
+ rows: [
152
+ o.row
153
+ ],
154
+ outlier: o
155
+ };
156
+ const { paint, r = 2 } = paintOf(strip, dot, "shape", "outlier");
157
+ const node = stamp({
158
+ type: "circle",
159
+ key: `${key}-outlier-${j}`,
160
+ cx,
161
+ cy,
162
+ r,
163
+ paint: swatch(dot, paint)
164
+ }, dot);
165
+ node.interactionPoints.forEach((p)=>(p.x = cx, p.y = cy));
166
+ nodes.push(node);
167
+ });
168
+ return nodes;
169
+ });
170
+ }
171
+ /**
172
+ The closed outline from `topline` back along `baseline`, as path data.
173
+ (An area node fills between y values only, so a vertical strip's
174
+ curve draws as a path.)
175
+ */ export function polygon(topline, baseline) {
176
+ const points = [
177
+ ...topline,
178
+ ...baseline.slice().reverse()
179
+ ];
180
+ return `M${points.map(([x, y])=>`${x},${y}`).join("L")}Z`;
181
+ }
182
+ /** A density strip: each series' curve, filled out from the plot. */ function densityNodes(strip, observations, domain) {
183
+ const { curves, max } = densityMarginal(observations, domain, [
184
+ ...strip.series.keys()
185
+ ]);
186
+ if (!max) return [];
187
+ return curves.flatMap((curve)=>{
188
+ const series = strip.series.get(curve.group);
189
+ const mark = {
190
+ axis: strip.axis,
191
+ kind: "density",
192
+ series,
193
+ rows: curve.rows,
194
+ curve
195
+ };
196
+ const key = `marginal-${strip.axis}-density-${series.key}`;
197
+ const topline = curve.curve.map(([v, d])=>xy(strip, strip.along(v), across(strip, d / max)));
198
+ const baseline = curve.curve.map(([v])=>xy(strip, strip.along(v), across(strip, 0)));
199
+ // The fill, then its outline along the curve only.
200
+ return [
201
+ stamp({
202
+ type: "path",
203
+ key,
204
+ d: polygon(topline, baseline),
205
+ // It grows out of the strip's inner edge.
206
+ enterD: polygon(baseline, baseline),
207
+ paint: swatch(mark, paintOf(strip, mark, "fill").paint)
208
+ }, mark),
209
+ stamp({
210
+ type: "line",
211
+ key: `${key}-line`,
212
+ points: topline,
213
+ paint: paintOf(strip, mark, "line").paint
214
+ }, mark)
215
+ ];
216
+ });
217
+ }
218
+ /**
219
+ The scene nodes of a Plot's marginal strips, in one group, or none when
220
+ the chart draws no strips this render (see `resolveMarginalLayout`).
221
+ @param viz The chart.
222
+ @param data The plotted rows.
223
+ @param frame The plot's position accessors and final ranges.
224
+ */ export function emitMarginals(viz, data, frame) {
225
+ const layout = viz._plotMarginals;
226
+ const domains = viz._plotAxisDomains;
227
+ if (!layout || !domains) return [];
228
+ const rows = data.filter((d)=>d.x !== undefined && d.y !== undefined);
229
+ const points = rows.map((d)=>({
230
+ row: d.data,
231
+ i: d.i
232
+ }));
233
+ const { series, groupOf } = marginalSeries(viz, points);
234
+ const byKey = new Map(series.map((s)=>[
235
+ s.key,
236
+ s
237
+ ]));
238
+ const bands = marginalBands(layout, frame);
239
+ const config = viz.schema.marginalConfig ?? {};
240
+ const children = [];
241
+ for (const axis of [
242
+ "x",
243
+ "y"
244
+ ]){
245
+ const kind = layout.axes[axis];
246
+ const scale = layout.scales[axis];
247
+ if (!kind) continue;
248
+ const position = frame[axis];
249
+ const strip = {
250
+ axis,
251
+ band: bands[axis],
252
+ size: layout.size,
253
+ along: (v)=>position(scale.from(v)),
254
+ series: byKey,
255
+ config
256
+ };
257
+ const domain = domains[axis].map(scale.to);
258
+ const observations = rows.map((d, k)=>({
259
+ value: scale.to(d[axis]),
260
+ group: groupOf(points[k]),
261
+ row: d.data
262
+ }));
263
+ children.push(...kind === "histogram" ? histogramNodes(strip, observations, domain, config.binThresholds) : kind === "box" ? boxNodes(strip, observations, domain) : densityNodes(strip, observations, domain));
264
+ }
265
+ return children.length ? [
266
+ {
267
+ type: "group",
268
+ key: "plot-marginals",
269
+ children
270
+ }
271
+ ] : [];
272
+ }
@@ -0,0 +1,73 @@
1
+ /**
2
+ The series a Plot's marginal strips split their points into: one per
3
+ legend entry, colored like its points, when the points fall into groups;
4
+ otherwise a single series of every point.
5
+
6
+ @module
7
+ */ import { colorGray } from "@d3plus/color";
8
+ import { themed } from "../../utils/theme.js";
9
+ import { colorCategory } from "../features/legendCategory.js";
10
+ import { legendKeys } from "../features/legendKeys.js";
11
+ /**
12
+ Whether points keyed by `keys` fall into groups: more than one key, and
13
+ at least one shared by several points. Points that each have a color of
14
+ their own (a Scatter whose only `groupBy` level is its ids) form one
15
+ series instead.
16
+ @param keys Each point's legend key.
17
+ */ export function marginalGrouped(keys) {
18
+ const distinct = new Set(keys).size;
19
+ return distinct > 1 && distinct < keys.length;
20
+ }
21
+ /**
22
+ Splits the plotted points into marginal series by legend entry (see
23
+ `marginalGrouped`), each painted with its first point's fill and named
24
+ by its color category or its label at the legend's depth. A chart
25
+ colored by `colorScale` draws a single series. A single series takes
26
+ the points' fill when they share one, else the theme's muted gray, and
27
+ the name of the one color category they share, if any.
28
+ @param viz The chart.
29
+ @param points The plotted points.
30
+ */ export function marginalSeries(viz, points) {
31
+ const { getAttr, colorOf, keyOf } = legendKeys(viz);
32
+ const keys = viz.schema.colorScale ? points.map(()=>"") : points.map(({ row, i })=>keyOf(row, i, colorOf(row, i)));
33
+ const index = new Map(points.map((p, k)=>[
34
+ p,
35
+ k
36
+ ]));
37
+ if (marginalGrouped(keys)) {
38
+ const series = new Map();
39
+ points.forEach(({ row, i }, k)=>{
40
+ if (series.has(keys[k])) return;
41
+ const label = colorCategory(colorOf(row, i)) ?? viz._drawLabel(row, i, viz._legendDepth ?? 0);
42
+ series.set(keys[k], {
43
+ key: keys[k],
44
+ color: getAttr(row, i, "fill"),
45
+ label
46
+ });
47
+ });
48
+ return {
49
+ series: [
50
+ ...series.values()
51
+ ],
52
+ groupOf: (p)=>keys[index.get(p)]
53
+ };
54
+ }
55
+ const fills = new Set(points.map(({ row, i })=>getAttr(row, i, "fill")));
56
+ const shared = fills.size === 1 && !viz.schema.colorScale;
57
+ const color = shared ? [
58
+ ...fills
59
+ ][0] : themed(viz._theme, (t)=>t.textMuted, colorGray[500]);
60
+ // Every point in one legend entry (the others hidden) keeps its name.
61
+ const first = points[0];
62
+ const label = shared && first && new Set(keys).size === 1 ? colorCategory(colorOf(first.row, first.i)) ?? "" : "";
63
+ return {
64
+ series: [
65
+ {
66
+ key: "",
67
+ color,
68
+ label
69
+ }
70
+ ],
71
+ groupOf: ()=>""
72
+ };
73
+ }