@d3plus/core 4.11.0 → 4.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (988) hide show
  1. package/es/index.js +2 -2
  2. package/es/internal.js +167 -23
  3. package/es/src/charts/Alluvial/emit.js +5 -4
  4. package/es/src/charts/Alluvial/index.js +7 -1
  5. package/es/src/charts/Alluvial/titles.js +24 -4
  6. package/es/src/charts/ArcDiagram/applyLayout.js +17 -10
  7. package/es/src/charts/ArcDiagram/arcGeometry.js +21 -8
  8. package/es/src/charts/ArcDiagram/arcLoops.js +5 -2
  9. package/es/src/charts/ArcDiagram/arcNodeBox.js +89 -0
  10. package/es/src/charts/ArcDiagram/emit.js +81 -38
  11. package/es/src/charts/ArcDiagram/events.js +16 -8
  12. package/es/src/charts/ArcDiagram/index.js +3 -1
  13. package/es/src/charts/BarChart/index.js +14 -10
  14. package/es/src/charts/BoxWhisker/extras.js +95 -0
  15. package/es/src/charts/BoxWhisker/index.js +77 -6
  16. package/es/src/charts/BoxWhisker/outliers.js +3 -2
  17. package/es/src/charts/BoxWhisker/summary.js +14 -3
  18. package/es/src/charts/BoxWhisker/tooltip.js +114 -29
  19. package/es/src/charts/BubbleChart/emit.js +9 -5
  20. package/es/src/charts/BubbleMatrix/colorDefaults.js +58 -0
  21. package/es/src/charts/BubbleMatrix/index.js +52 -0
  22. package/es/src/charts/Bullet/emit.js +3 -2
  23. package/es/src/charts/BumpChart/areaBump.js +175 -0
  24. package/es/src/charts/BumpChart/index.js +84 -18
  25. package/es/src/charts/Calendar/applyLayout.js +1 -1
  26. package/es/src/charts/Calendar/calendarDates.js +21 -7
  27. package/es/src/charts/Calendar/emit.js +3 -2
  28. package/es/src/charts/Calendar/index.js +16 -1
  29. package/es/src/charts/Candlestick/index.js +6 -11
  30. package/es/src/charts/Candlestick/periods.js +52 -29
  31. package/es/src/charts/Candlestick/tooltip.js +5 -7
  32. package/es/src/charts/Chord/emit.js +3 -2
  33. package/es/src/charts/ConnectedScatter/index.js +39 -0
  34. package/es/src/charts/CyclePlot/cycleFacet.js +162 -0
  35. package/es/src/charts/CyclePlot/cycleMeans.js +54 -0
  36. package/es/src/charts/CyclePlot/cyclePeriods.js +99 -0
  37. package/es/src/charts/CyclePlot/cycleTooltip.js +67 -0
  38. package/es/src/charts/CyclePlot/index.js +197 -0
  39. package/es/src/charts/DensityPlot/densityCurves.js +139 -0
  40. package/es/src/charts/DensityPlot/densityPoint.js +10 -0
  41. package/es/src/charts/DensityPlot/index.js +235 -0
  42. package/es/src/charts/DensityPlot/rug.js +144 -0
  43. package/es/src/charts/DotPlot/dotLayout.js +165 -0
  44. package/es/src/charts/DotPlot/facetSize.js +40 -0
  45. package/es/src/charts/DotPlot/index.js +173 -0
  46. package/es/src/charts/DotPlot/placements.js +121 -0
  47. package/es/src/charts/DotPlot/tooltip.js +68 -0
  48. package/es/src/charts/Dumbbell/arrowGrays.js +46 -0
  49. package/es/src/charts/Dumbbell/categoryChange.js +124 -0
  50. package/es/src/charts/Dumbbell/changeEmit.js +291 -0
  51. package/es/src/charts/Dumbbell/changes.js +87 -0
  52. package/es/src/charts/Dumbbell/connectors.js +46 -0
  53. package/es/src/charts/Dumbbell/emit.js +51 -50
  54. package/es/src/charts/Dumbbell/gapSort.js +2 -1
  55. package/es/src/charts/Dumbbell/index.js +121 -5
  56. package/es/src/charts/Funnel/emit.js +3 -2
  57. package/es/src/charts/Gantt/applyLayout.js +33 -13
  58. package/es/src/charts/Gantt/criticalPath.js +202 -0
  59. package/es/src/charts/Gantt/emit.js +49 -15
  60. package/es/src/charts/Gantt/ganttCalendar.js +54 -0
  61. package/es/src/charts/Gantt/ganttCritical.js +106 -0
  62. package/es/src/charts/Gantt/ganttDecor.js +183 -60
  63. package/es/src/charts/Gantt/ganttSlack.js +14 -0
  64. package/es/src/charts/Gantt/ganttTooltip.js +91 -36
  65. package/es/src/charts/Gantt/index.js +59 -10
  66. package/es/src/charts/Gauge/emit.js +3 -2
  67. package/es/src/charts/Geomap/applyLayout.js +177 -19
  68. package/es/src/charts/Geomap/cartogram.js +50 -0
  69. package/es/src/charts/Geomap/cartogramContiguous.js +196 -0
  70. package/es/src/charts/Geomap/cartogramFields.js +63 -0
  71. package/es/src/charts/Geomap/cartogramLabels.js +109 -0
  72. package/es/src/charts/Geomap/cartogramLayout.js +186 -0
  73. package/es/src/charts/Geomap/cartogramLegend.js +73 -0
  74. package/es/src/charts/Geomap/cartogramRelax.js +251 -0
  75. package/es/src/charts/Geomap/densityEmit.js +93 -0
  76. package/es/src/charts/Geomap/densityFields.js +69 -0
  77. package/es/src/charts/Geomap/densityLayout.js +90 -0
  78. package/es/src/charts/Geomap/densityTooltip.js +98 -0
  79. package/es/src/charts/Geomap/dotDensity.js +157 -0
  80. package/es/src/charts/Geomap/dotDensityLayout.js +116 -0
  81. package/es/src/charts/Geomap/dotRenderer.js +49 -0
  82. package/es/src/charts/Geomap/drillDown.js +216 -0
  83. package/es/src/charts/Geomap/drillEmit.js +64 -0
  84. package/es/src/charts/Geomap/drillEvents.js +108 -0
  85. package/es/src/charts/Geomap/emit.js +64 -42
  86. package/es/src/charts/Geomap/flowEmit.js +36 -15
  87. package/es/src/charts/Geomap/flowEvents.js +3 -1
  88. package/es/src/charts/Geomap/flowFields.js +2 -2
  89. package/es/src/charts/Geomap/flowLinks.js +18 -10
  90. package/es/src/charts/Geomap/geoHexbin.js +144 -0
  91. package/es/src/charts/Geomap/geoHexbinZoom.js +110 -0
  92. package/es/src/charts/Geomap/index.js +71 -116
  93. package/es/src/charts/Geomap/pointCluster.js +246 -0
  94. package/es/src/charts/Geomap/pointClusterEmit.js +385 -0
  95. package/es/src/charts/Geomap/pointClusterLayout.js +170 -0
  96. package/es/src/charts/Geomap/pointClusterLinks.js +95 -0
  97. package/es/src/charts/Geomap/pointClusterZoom.js +253 -0
  98. package/es/src/charts/Geomap/pointLabels.js +12 -4
  99. package/es/src/charts/Geomap/pointRows.js +25 -0
  100. package/es/src/charts/Geomap/tileGrid.js +468 -0
  101. package/es/src/charts/Geomap/tileState.js +41 -0
  102. package/es/src/charts/Geomap/topojsonFluent.js +96 -0
  103. package/es/src/charts/Geomap/topojsonLevels.js +16 -0
  104. package/es/src/charts/Hexbin/contourLabels.js +25 -17
  105. package/es/src/charts/Hexbin/index.js +4 -1
  106. package/es/src/charts/Histogram/binData.js +5 -1
  107. package/es/src/charts/Histogram/index.js +4 -26
  108. package/es/src/charts/HorizonChart/emit.js +147 -0
  109. package/es/src/charts/HorizonChart/horizonBands.js +117 -0
  110. package/es/src/charts/HorizonChart/horizonColors.js +30 -0
  111. package/es/src/charts/HorizonChart/hover.js +147 -0
  112. package/es/src/charts/HorizonChart/index.js +220 -0
  113. package/es/src/charts/HorizonChart/measure.js +91 -0
  114. package/es/src/charts/HorizonChart/rowFilter.js +250 -0
  115. package/es/src/charts/HorizonChart/state.js +64 -0
  116. package/es/src/charts/Icicle/emit.js +3 -2
  117. package/es/src/charts/Icicle/index.js +3 -1
  118. package/es/src/charts/KPI/applyLayout.js +119 -0
  119. package/es/src/charts/KPI/delta.js +74 -0
  120. package/es/src/charts/KPI/emit.js +303 -0
  121. package/es/src/charts/KPI/index.js +192 -0
  122. package/es/src/charts/KPI/series.js +67 -0
  123. package/es/src/charts/KPI/tileLayout.js +134 -0
  124. package/es/src/charts/Lollipop/emit.js +2 -1
  125. package/es/src/charts/Marimekko/index.js +2 -1
  126. package/es/src/charts/Matrix/applyLayout.js +29 -12
  127. package/es/src/charts/Matrix/bubbles.js +133 -0
  128. package/es/src/charts/Matrix/emit.js +68 -25
  129. package/es/src/charts/Matrix/index.js +64 -5
  130. package/es/src/charts/Network/applyLayout.js +206 -84
  131. package/es/src/charts/Network/bundle.js +29 -8
  132. package/es/src/charts/Network/circleLayout.js +281 -0
  133. package/es/src/charts/Network/containNodes.js +72 -0
  134. package/es/src/charts/Network/emit.js +109 -50
  135. package/es/src/charts/Network/forceLayout.js +111 -0
  136. package/es/src/charts/Network/graph.js +76 -8
  137. package/es/src/charts/Network/graphFluent.js +5 -3
  138. package/es/src/charts/Network/index.js +117 -3
  139. package/es/src/charts/Network/liveForce.js +312 -0
  140. package/es/src/charts/Network/livePositions.js +180 -0
  141. package/es/src/charts/Network/networkDrag.js +156 -0
  142. package/es/src/charts/Pack/applyLayout.js +16 -5
  143. package/es/src/charts/Pack/emit.js +18 -10
  144. package/es/src/charts/Pack/groupRows.js +61 -0
  145. package/es/src/charts/Pack/index.js +3 -14
  146. package/es/src/charts/Pack/neutralPaint.js +20 -0
  147. package/es/src/charts/Pack/nodeNames.js +35 -0
  148. package/es/src/charts/ParallelCoordinates/axes.js +22 -22
  149. package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
  150. package/es/src/charts/ParallelCoordinates/emit.js +3 -2
  151. package/es/src/charts/ParallelCoordinates/index.js +3 -1
  152. package/es/src/charts/ParallelCoordinates/titles.js +17 -9
  153. package/es/src/charts/Pareto/color.js +46 -0
  154. package/es/src/charts/Pareto/hover.js +54 -0
  155. package/es/src/charts/Pareto/index.js +170 -0
  156. package/es/src/charts/Pareto/labels.js +91 -0
  157. package/es/src/charts/Pareto/order.js +61 -0
  158. package/es/src/charts/Pareto/paretoSteps.js +84 -0
  159. package/es/src/charts/Pareto/state.js +158 -0
  160. package/es/src/charts/Parliament/index.js +68 -0
  161. package/es/src/charts/Pie/emit.js +12 -3
  162. package/es/src/charts/Pie/index.js +10 -0
  163. package/es/src/charts/Plot/areaEnter.js +70 -0
  164. package/es/src/charts/Plot/areaLabelsAlong.js +10 -2
  165. package/es/src/charts/Plot/aspectRatio.js +92 -0
  166. package/es/src/charts/Plot/axisHover.js +4 -2
  167. package/es/src/charts/Plot/axisHoverAnchors.js +2 -1
  168. package/es/src/charts/Plot/axisHoverScene.js +138 -5
  169. package/es/src/charts/Plot/barConfidence.js +7 -6
  170. package/es/src/charts/Plot/barHitArea.js +121 -7
  171. package/es/src/charts/Plot/barLabelConfidence.js +50 -0
  172. package/es/src/charts/Plot/barLabelFit.js +2 -1
  173. package/es/src/charts/Plot/barWidth.js +10 -5
  174. package/es/src/charts/Plot/baselineBreak.js +15 -6
  175. package/es/src/charts/Plot/baselineDomain.js +13 -4
  176. package/es/src/charts/Plot/circleLabels.js +26 -16
  177. package/es/src/charts/Plot/confidenceAxes.js +100 -0
  178. package/es/src/charts/Plot/confidenceConfig.js +7 -2
  179. package/es/src/charts/Plot/confidenceTooltip.js +47 -4
  180. package/es/src/charts/Plot/connectGapsScene.js +2 -1
  181. package/es/src/charts/Plot/discreteDomain.js +27 -5
  182. package/es/src/charts/Plot/discreteSpan.js +10 -1
  183. package/es/src/charts/Plot/domainClip.js +74 -44
  184. package/es/src/charts/Plot/downsample.js +26 -0
  185. package/es/src/charts/Plot/draw.js +41 -14
  186. package/es/src/charts/Plot/fillBetween.js +2 -1
  187. package/es/src/charts/Plot/forecast.js +8 -4
  188. package/es/src/charts/Plot/forecastScene.js +6 -5
  189. package/es/src/charts/Plot/index.js +52 -27
  190. package/es/src/charts/Plot/inferDiscrete.js +72 -0
  191. package/es/src/charts/Plot/jitter.js +50 -0
  192. package/es/src/charts/Plot/labelPlacement.js +4 -3
  193. package/es/src/charts/Plot/lineBands.js +6 -1
  194. package/es/src/charts/Plot/lineLabelEmit.js +4 -3
  195. package/es/src/charts/Plot/lineLabelSides.js +8 -0
  196. package/es/src/charts/Plot/lineLabelsAlong.js +45 -31
  197. package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
  198. package/es/src/charts/Plot/marginalHover.js +141 -0
  199. package/es/src/charts/Plot/marginalLayout.js +102 -0
  200. package/es/src/charts/Plot/marginalPaint.js +105 -0
  201. package/es/src/charts/Plot/marginalScene.js +272 -0
  202. package/es/src/charts/Plot/marginalSeries.js +73 -0
  203. package/es/src/charts/Plot/marginalStats.js +219 -0
  204. package/es/src/charts/Plot/openDomainEnds.js +60 -0
  205. package/es/src/charts/Plot/orderPath.js +137 -0
  206. package/es/src/charts/Plot/orderPathScene.js +253 -0
  207. package/es/src/charts/Plot/outlierDetect.js +179 -0
  208. package/es/src/charts/Plot/outlierLabels.js +327 -0
  209. package/es/src/charts/Plot/outlierLines.js +93 -0
  210. package/es/src/charts/Plot/outlierScene.js +308 -0
  211. package/es/src/charts/Plot/outlierTooltip.js +69 -0
  212. package/es/src/charts/Plot/periodLabels.js +27 -0
  213. package/es/src/charts/Plot/pipeline.js +62 -24
  214. package/es/src/charts/Plot/pipelineAxisLayout.js +9 -7
  215. package/es/src/charts/Plot/pipelineDomains.js +64 -27
  216. package/es/src/charts/Plot/pipelineScales.js +37 -28
  217. package/es/src/charts/Plot/plotBreaks.js +38 -18
  218. package/es/src/charts/Plot/plotFacet.js +3 -1
  219. package/es/src/charts/Plot/plotInit.js +65 -3
  220. package/es/src/charts/Plot/plotLevels.js +183 -0
  221. package/es/src/charts/Plot/plotRangeBreaks.js +46 -9
  222. package/es/src/charts/Plot/plotShapes.js +60 -0
  223. package/es/src/charts/Plot/pointConfidence.js +186 -0
  224. package/es/src/charts/Plot/pointKey.js +10 -0
  225. package/es/src/charts/Plot/referenceDomains.js +11 -6
  226. package/es/src/charts/Plot/shapeAccessors.js +52 -0
  227. package/es/src/charts/Plot/shapeDefaults.js +32 -17
  228. package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
  229. package/es/src/charts/Plot/sharedHover.js +42 -13
  230. package/es/src/charts/Plot/sharedHoverScene.js +49 -13
  231. package/es/src/charts/Plot/sharedTooltip.js +68 -25
  232. package/es/src/charts/Plot/stackEnter.js +7 -3
  233. package/es/src/charts/Plot/stackLegendOrder.js +5 -2
  234. package/es/src/charts/Plot/stackNeutral.js +154 -0
  235. package/es/src/charts/Plot/stackShareTooltip.js +2 -1
  236. package/es/src/charts/Plot/stackThreshold.js +2 -1
  237. package/es/src/charts/Plot/swarm.js +8 -5
  238. package/es/src/charts/Plot/timeNestKeys.js +37 -0
  239. package/es/src/charts/Plot/trendLabels.js +45 -18
  240. package/es/src/charts/Plot/trendLines.js +78 -34
  241. package/es/src/charts/Plot/trendMovingAverage.js +135 -0
  242. package/es/src/charts/Plot/trendProjection.js +18 -6
  243. package/es/src/charts/Plot/trendScene.js +4 -1
  244. package/es/src/charts/Plot/trendTooltip.js +75 -20
  245. package/es/src/charts/PolarArea/emit.js +3 -2
  246. package/es/src/charts/PolarArea/index.js +2 -1
  247. package/es/src/charts/Priestley/applyLayout.js +20 -12
  248. package/es/src/charts/Priestley/emit.js +3 -2
  249. package/es/src/charts/Priestley/index.js +0 -2
  250. package/es/src/charts/Priestley/timeAxis.js +24 -13
  251. package/es/src/charts/Pyramid/gutter.js +52 -16
  252. package/es/src/charts/Pyramid/index.js +55 -7
  253. package/es/src/charts/Pyramid/scene.js +4 -4
  254. package/es/src/charts/Radar/applyLayout.js +31 -33
  255. package/es/src/charts/Radar/axisDecorations.js +29 -17
  256. package/es/src/charts/Radar/curvedLabels.js +43 -2
  257. package/es/src/charts/Radar/emit.js +33 -17
  258. package/es/src/charts/Radar/index.js +41 -2
  259. package/es/src/charts/Radar/points.js +85 -0
  260. package/es/src/charts/RadialArea/index.js +51 -0
  261. package/es/src/charts/RadialBar/emit.js +9 -3
  262. package/es/src/charts/RadialBar/index.js +10 -0
  263. package/es/src/charts/RadialLine/angles.js +117 -0
  264. package/es/src/charts/RadialLine/applyLayout.js +204 -0
  265. package/es/src/charts/RadialLine/emit.js +66 -0
  266. package/es/src/charts/RadialLine/index.js +228 -0
  267. package/es/src/charts/RadialLine/paths.js +55 -0
  268. package/es/src/charts/RadialLine/points.js +80 -0
  269. package/es/src/charts/RadialLine/series.js +84 -0
  270. package/es/src/charts/RadialLine/seriesLabelNodes.js +116 -0
  271. package/es/src/charts/RadialLine/seriesLabels.js +91 -0
  272. package/es/src/charts/RadialLine/spokes.js +32 -0
  273. package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
  274. package/es/src/charts/RadialMatrix/emit.js +3 -2
  275. package/es/src/charts/RadialMatrix/index.js +15 -2
  276. package/es/src/charts/RadialTree/index.js +33 -0
  277. package/es/src/charts/Rings/applyLayout.js +28 -151
  278. package/es/src/charts/Rings/emit.js +120 -60
  279. package/es/src/charts/Rings/index.js +28 -5
  280. package/es/src/charts/Rings/ringsCurves.js +158 -0
  281. package/es/src/charts/Rings/ringsLoops.js +4 -2
  282. package/es/src/charts/Rings/ringsParallel.js +20 -3
  283. package/es/src/charts/Rings/ringsPlacement.js +152 -0
  284. package/es/src/charts/Rings/ringsSizing.js +82 -51
  285. package/es/src/charts/Sankey/applyLayout.js +22 -4
  286. package/es/src/charts/Sankey/circularLayout.js +14 -6
  287. package/es/src/charts/Sankey/emit.js +3 -2
  288. package/es/src/charts/Sankey/index.js +50 -1
  289. package/es/src/charts/Sankey/sankeyDrag.js +225 -0
  290. package/es/src/charts/Sankey/sankeyLayout.js +12 -0
  291. package/es/src/charts/Scatter/index.js +3 -2
  292. package/es/src/charts/ScatterMatrix/binEmit.js +59 -0
  293. package/es/src/charts/ScatterMatrix/index.js +253 -0
  294. package/es/src/charts/ScatterMatrix/matrixData.js +161 -0
  295. package/es/src/charts/ScatterMatrix/matrixFacet.js +76 -0
  296. package/es/src/charts/ScatterMatrix/matrixHover.js +36 -0
  297. package/es/src/charts/ScatterMatrix/matrixTooltip.js +45 -0
  298. package/es/src/charts/StripPlot/index.js +53 -0
  299. package/es/src/charts/Sunburst/emit.js +12 -3
  300. package/es/src/charts/Sunburst/index.js +13 -1
  301. package/es/src/charts/TileGridMap/index.js +29 -0
  302. package/es/src/charts/Tree/applyLayout.js +135 -32
  303. package/es/src/charts/Tree/emit.js +61 -8
  304. package/es/src/charts/Tree/index.js +34 -15
  305. package/es/src/charts/Tree/keys.js +33 -0
  306. package/es/src/charts/Tree/nodeHeight.js +58 -0
  307. package/es/src/charts/Tree/nodeLabel.js +15 -0
  308. package/es/src/charts/Tree/radialLabels.js +61 -0
  309. package/es/src/charts/Tree/radialLayout.js +210 -0
  310. package/es/src/charts/Treemap/emit.js +3 -2
  311. package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
  312. package/es/src/charts/Venn/applyLayout.js +176 -0
  313. package/es/src/charts/Venn/circles.js +192 -0
  314. package/es/src/charts/Venn/ellipseFrame.js +57 -0
  315. package/es/src/charts/Venn/emit.js +142 -0
  316. package/es/src/charts/Venn/index.js +178 -0
  317. package/es/src/charts/Venn/nelderMead.js +59 -0
  318. package/es/src/charts/Venn/tooltip.js +22 -0
  319. package/es/src/charts/Venn/vennData.js +99 -0
  320. package/es/src/charts/Venn/vennEllipses.js +291 -0
  321. package/es/src/charts/Venn/vennFit.js +169 -0
  322. package/es/src/charts/Venn/vennLayout.js +252 -0
  323. package/es/src/charts/Venn/vennRegions.js +133 -0
  324. package/es/src/charts/Violin/emit.js +2 -1
  325. package/es/src/charts/Violin/index.js +2 -1
  326. package/es/src/charts/Waffle/applyLayout.js +45 -22
  327. package/es/src/charts/Waffle/arcEmit.js +153 -0
  328. package/es/src/charts/Waffle/arcLayout.js +122 -0
  329. package/es/src/charts/Waffle/arcStage.js +79 -0
  330. package/es/src/charts/Waffle/emit.js +9 -4
  331. package/es/src/charts/Waffle/index.js +88 -4
  332. package/es/src/charts/Waffle/tooltip.js +7 -2
  333. package/es/src/charts/Waterfall/connectors.js +5 -3
  334. package/es/src/charts/Waterfall/state.js +2 -1
  335. package/es/src/charts/WordCloud/applyLayout.js +157 -0
  336. package/es/src/charts/WordCloud/cloudLayout.js +128 -0
  337. package/es/src/charts/WordCloud/emit.js +96 -0
  338. package/es/src/charts/WordCloud/fontScale.js +34 -0
  339. package/es/src/charts/WordCloud/glyphMask.js +298 -0
  340. package/es/src/charts/WordCloud/index.js +174 -0
  341. package/es/src/charts/WordCloud/occupancy.js +99 -0
  342. package/es/src/charts/WordCloud/rotation.js +44 -0
  343. package/es/src/charts/WordCloud/size.js +15 -0
  344. package/es/src/charts/WordCloud/spiral.js +72 -0
  345. package/es/src/charts/definition/applyDefinition.js +6 -1
  346. package/es/src/charts/definition/declaresField.js +14 -0
  347. package/es/src/charts/definition/makeChart.js +15 -3
  348. package/es/src/charts/drawSteps/bottomRightControls.js +1 -1
  349. package/es/src/charts/drawSteps/bottomRightControlsMarkup.js +1 -1
  350. package/es/src/charts/drawSteps/gestureHover.js +10 -6
  351. package/es/src/charts/drawSteps/leavesSurface.js +12 -0
  352. package/es/src/charts/drawSteps/minimap.js +5 -21
  353. package/es/src/charts/drawSteps/selectActions.js +105 -0
  354. package/es/src/charts/drawSteps/selectGesture.js +318 -0
  355. package/es/src/charts/drawSteps/selectRegion.js +222 -0
  356. package/es/src/charts/drawSteps/selectState.js +118 -0
  357. package/es/src/charts/drawSteps/topLeftControls.js +4 -1
  358. package/es/src/charts/drawSteps/zoomActions.js +36 -0
  359. package/es/src/charts/drawSteps/zoomControls.js +90 -37
  360. package/es/src/charts/drawSteps/zoomControlsMarkup.js +228 -36
  361. package/es/src/charts/drawSteps/zoomControlsMenu.js +140 -0
  362. package/es/src/charts/drawSteps/zoomDrag.js +190 -0
  363. package/es/src/charts/drawSteps/zoomFit.js +69 -0
  364. package/es/src/charts/events/click.legend.js +4 -2
  365. package/es/src/charts/events/click.shape.js +5 -3
  366. package/es/src/charts/events/mouseenter.js +6 -16
  367. package/es/src/charts/events/mouseleave.js +15 -5
  368. package/es/src/charts/events/mousemove.legend.js +35 -34
  369. package/es/src/charts/events/mousemove.shape.js +53 -44
  370. package/es/src/charts/facet/drawFacets.js +61 -22
  371. package/es/src/charts/facet/facetConfig.js +3 -1
  372. package/es/src/charts/facet/facetData.js +10 -2
  373. package/es/src/charts/facet/facetGrid.js +5 -1
  374. package/es/src/charts/facet/facetGutter.js +36 -7
  375. package/es/src/charts/facet/facetLayout.js +136 -0
  376. package/es/src/charts/facet/facetLayouts.js +574 -0
  377. package/es/src/charts/facet/facetScene.js +10 -3
  378. package/es/src/charts/features/annotationFrame.js +8 -3
  379. package/es/src/charts/features/axes.js +19 -6
  380. package/es/src/charts/features/axesFinal.js +99 -10
  381. package/es/src/charts/features/axesMeasure.js +31 -10
  382. package/es/src/charts/features/axisTooltip.js +138 -0
  383. package/es/src/charts/features/bareRegion.js +24 -0
  384. package/es/src/charts/features/boxGrid.js +39 -0
  385. package/es/src/charts/features/centerLabel.js +196 -0
  386. package/es/src/charts/features/circleLabelPlacement.js +288 -83
  387. package/es/src/charts/features/circleLabels.js +66 -14
  388. package/es/src/charts/features/colorScaleBivariate.js +83 -0
  389. package/es/src/charts/features/colorScaleBucket.js +18 -0
  390. package/es/src/charts/features/colorScaleHover.js +35 -5
  391. package/es/src/charts/features/colorScaleLimit.js +73 -0
  392. package/es/src/charts/features/colorScaleTooltip.js +62 -0
  393. package/es/src/charts/features/colorScaleTop.js +71 -0
  394. package/es/src/charts/features/colorScaleValue.js +10 -1
  395. package/es/src/charts/features/curvedArrows.js +74 -23
  396. package/es/src/charts/features/depthKey.js +26 -0
  397. package/es/src/charts/features/edgeArrows.js +107 -18
  398. package/es/src/charts/features/emitHelpers.js +7 -2
  399. package/es/src/charts/features/features.js +25 -5
  400. package/es/src/charts/features/featuresColorScale.js +64 -20
  401. package/es/src/charts/features/featuresLegend.js +20 -0
  402. package/es/src/charts/features/hoverTicks.js +46 -0
  403. package/es/src/charts/features/idleQueue.js +72 -0
  404. package/es/src/charts/features/keyHold.js +115 -0
  405. package/es/src/charts/features/keyTooltip.js +91 -0
  406. package/es/src/charts/features/labelLayering.js +149 -0
  407. package/es/src/charts/features/labelSlots.js +112 -0
  408. package/es/src/charts/features/linkInteraction.js +62 -7
  409. package/es/src/charts/features/linkLabelPath.js +2 -39
  410. package/es/src/charts/features/networkMeasures.js +241 -0
  411. package/es/src/charts/features/nodeDrag.js +175 -0
  412. package/es/src/charts/features/nodeKeys.js +117 -0
  413. package/es/src/charts/features/nodeOutline.js +41 -0
  414. package/es/src/charts/features/nodeStats.js +309 -0
  415. package/es/src/charts/features/pathLabelBends.js +191 -0
  416. package/es/src/charts/features/plotAnnotations.js +8 -5
  417. package/es/src/charts/features/plotEndLabels.js +28 -7
  418. package/es/src/charts/features/plotPaint.js +52 -13
  419. package/es/src/charts/features/rectNodeSize.js +41 -0
  420. package/es/src/charts/features/ringLabels.js +3 -1
  421. package/es/src/charts/features/selfLoops.js +33 -23
  422. package/es/src/charts/features/shapeEmit.js +110 -32
  423. package/es/src/charts/features/sharedFields.js +10 -5
  424. package/es/src/charts/features/spokeLabels.js +178 -0
  425. package/es/src/charts/features/swatchPaint.js +68 -0
  426. package/es/src/charts/features/textHalo.js +3 -2
  427. package/es/src/charts/features/thresholdMembers.js +8 -12
  428. package/es/src/charts/features/tooltipRows.js +76 -0
  429. package/es/src/charts/features/tooltipSwatch.js +81 -24
  430. package/es/src/charts/features/xAxisConfig.js +2 -1
  431. package/es/src/charts/helpers/densityChart.js +2 -7
  432. package/es/src/charts/helpers/valueTitle.js +13 -1
  433. package/es/src/charts/index.js +17 -0
  434. package/es/src/charts/partition/chartFields.js +12 -3
  435. package/es/src/charts/partition/interaction.js +10 -5
  436. package/es/src/charts/pipeline/insetPlacement.js +19 -7
  437. package/es/src/charts/pipeline/preDrawData.js +80 -11
  438. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  439. package/es/src/charts/pipeline/stages.js +3 -2
  440. package/es/src/charts/pipeline/vizPreDraw.js +4 -0
  441. package/es/src/charts/plotBuffers/Circle.js +3 -2
  442. package/es/src/charts/plotBuffers/Line.js +6 -5
  443. package/es/src/charts/plotBuffers/Rect.js +3 -2
  444. package/es/src/charts/plotBuffers/Tick.js +12 -0
  445. package/es/src/charts/plotBuffers/defaultBuffers.js +3 -1
  446. package/es/src/charts/plotBuffers/rectLikeBuffer.js +4 -3
  447. package/es/src/charts/polar/chrome.js +81 -9
  448. package/es/src/charts/polar/config.js +4 -0
  449. package/es/src/charts/polar/wedgeLayout.js +2 -1
  450. package/es/src/charts/viz/Viz.js +56 -33
  451. package/es/src/charts/viz/VizBase.js +78 -42
  452. package/es/src/charts/viz/appendRows.js +90 -0
  453. package/es/src/charts/viz/backgroundInk.js +10 -0
  454. package/es/src/charts/viz/dataChanged.js +19 -0
  455. package/es/src/charts/viz/discrete.js +9 -0
  456. package/es/src/charts/viz/emphasis.js +14 -0
  457. package/es/src/charts/viz/fillStroke.js +10 -0
  458. package/es/src/charts/viz/focusTargets.js +25 -5
  459. package/es/src/charts/viz/groupByLevels.js +48 -0
  460. package/es/src/charts/viz/groupRow.js +27 -0
  461. package/es/src/charts/viz/hoverBand.js +40 -0
  462. package/es/src/charts/viz/interactionOpacity.js +240 -52
  463. package/es/src/charts/viz/keyboardNav.js +39 -9
  464. package/es/src/charts/viz/liftRaised.js +84 -0
  465. package/es/src/charts/viz/nearestHover.js +9 -2
  466. package/es/src/charts/viz/reportDrawError.js +15 -0
  467. package/es/src/charts/viz/setCursor.js +41 -0
  468. package/es/src/charts/viz/simpleHover.js +3 -4
  469. package/es/src/charts/viz/tooltipEnabled.js +38 -0
  470. package/es/src/charts/viz/userClick.js +45 -0
  471. package/es/src/charts/viz/vizDataPolling.js +0 -1
  472. package/es/src/charts/viz/vizDefaults.js +23 -34
  473. package/es/src/charts/viz/vizFields.js +13 -1
  474. package/es/src/charts/viz/vizRender.js +35 -5
  475. package/es/src/charts/viz/vizTypes.js +1 -1
  476. package/es/src/charts/viz/vizVisibility.js +12 -2
  477. package/es/src/components/Axis/Axis.js +114 -14
  478. package/es/src/components/Axis/AxisBottom.js +1 -0
  479. package/es/src/components/Axis/AxisLeft.js +1 -0
  480. package/es/src/components/Axis/AxisRight.js +1 -0
  481. package/es/src/components/Axis/AxisTop.js +1 -0
  482. package/es/src/components/Axis/axisBreak.js +29 -7
  483. package/es/src/components/Axis/axisDefaults.js +18 -0
  484. package/es/src/components/Axis/axisEndLabels.js +4 -1
  485. package/es/src/components/Axis/axisLabelKinds.js +36 -0
  486. package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
  487. package/es/src/components/Axis/axisLabelRoom.js +37 -0
  488. package/es/src/components/Axis/axisLabelSize.js +195 -0
  489. package/es/src/components/Axis/axisLabelThinning.js +167 -10
  490. package/es/src/components/Axis/axisLayout.js +76 -46
  491. package/es/src/components/Axis/axisLayoutLabels.js +93 -145
  492. package/es/src/components/Axis/axisLayoutScale.js +79 -34
  493. package/es/src/components/Axis/axisLevels.js +271 -0
  494. package/es/src/components/Axis/axisLimit.js +33 -0
  495. package/es/src/components/Axis/axisMaxSize.js +39 -0
  496. package/es/src/components/Axis/axisMinorTicks.js +280 -0
  497. package/es/src/components/Axis/axisPeriods.js +144 -0
  498. package/es/src/components/Axis/axisRangeBreaks.js +19 -10
  499. package/es/src/components/Axis/axisRender.js +90 -36
  500. package/es/src/components/Axis/axisRounding.js +38 -1
  501. package/es/src/components/Axis/axisScaleType.js +55 -0
  502. package/es/src/components/Axis/axisScene.js +100 -6
  503. package/es/src/components/Axis/axisTickLookups.js +30 -0
  504. package/es/src/components/Axis/axisTitle.js +53 -0
  505. package/es/src/components/Axis/axisTooltipTargets.js +151 -0
  506. package/es/src/components/Axis/labelSizeSession.js +23 -0
  507. package/es/src/components/Axis/rangeBreaks.js +10 -4
  508. package/es/src/components/Axis/timeValues.js +116 -19
  509. package/es/src/components/ColorScale/ColorScale.js +63 -18
  510. package/es/src/components/ColorScale/bivariateRender.js +353 -0
  511. package/es/src/components/ColorScale/bivariateScale.js +150 -0
  512. package/es/src/components/ColorScale/colorScaleRender.js +32 -2
  513. package/es/src/components/ColorScale/colorScaleScale.js +139 -41
  514. package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
  515. package/es/src/components/Legend/Legend.js +11 -2
  516. package/es/src/components/Legend/legendCut.js +108 -0
  517. package/es/src/components/Legend/legendRender.js +38 -13
  518. package/es/src/components/SizeLegend/SizeLegend.js +20 -1
  519. package/es/src/components/TextBox.js +6 -2
  520. package/es/src/components/Timeline/Timeline.js +11 -3
  521. package/es/src/components/Timeline/timelineRender.js +25 -14
  522. package/es/src/components/Tooltip.js +8 -1
  523. package/es/src/components/textBoxScene.js +3 -0
  524. package/es/src/components/textEllipsis.js +7 -0
  525. package/es/src/components/tooltipDom.js +80 -18
  526. package/es/src/fluent.js +124 -9
  527. package/es/src/shapes/Area.js +32 -1
  528. package/es/src/shapes/Bar.js +22 -1
  529. package/es/src/shapes/Box.js +72 -13
  530. package/es/src/shapes/Circle.js +1 -0
  531. package/es/src/shapes/Image.js +8 -1
  532. package/es/src/shapes/Line.js +45 -1
  533. package/es/src/shapes/Path.js +1 -0
  534. package/es/src/shapes/Rect.js +1 -0
  535. package/es/src/shapes/Shape.js +29 -8
  536. package/es/src/shapes/Tick.js +54 -0
  537. package/es/src/shapes/Whisker.js +1 -0
  538. package/es/src/shapes/boxExtraShapes.js +72 -0
  539. package/es/src/shapes/boxExtras.js +212 -0
  540. package/es/src/shapes/boxStyle.js +38 -5
  541. package/es/src/shapes/buildLabelData.js +2 -0
  542. package/es/src/shapes/downsample.js +150 -0
  543. package/es/src/shapes/hitAreaNode.js +6 -2
  544. package/es/src/shapes/index.js +1 -0
  545. package/es/src/shapes/pathSeries.js +51 -0
  546. package/es/src/utils/BaseClass.js +59 -52
  547. package/es/src/utils/configValue.js +9 -0
  548. package/es/src/utils/jitter.js +33 -0
  549. package/es/src/utils/resetSetters.js +66 -0
  550. package/package.json +10 -10
  551. package/types/index.d.ts +5 -4
  552. package/types/internal.d.ts +272 -29
  553. package/types/src/charts/Alluvial/titles.d.ts +16 -3
  554. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +7 -3
  555. package/types/src/charts/ArcDiagram/arcLoops.d.ts +3 -1
  556. package/types/src/charts/ArcDiagram/arcNodeBox.d.ts +60 -0
  557. package/types/src/charts/ArcDiagram/emit.d.ts +6 -4
  558. package/types/src/charts/ArcDiagram/events.d.ts +2 -1
  559. package/types/src/charts/BoxWhisker/extras.d.ts +41 -0
  560. package/types/src/charts/BoxWhisker/summary.d.ts +1 -1
  561. package/types/src/charts/BoxWhisker/tooltip.d.ts +33 -4
  562. package/types/src/charts/BubbleChart/emit.d.ts +3 -3
  563. package/types/src/charts/BubbleMatrix/colorDefaults.d.ts +19 -0
  564. package/types/src/charts/BubbleMatrix/index.d.ts +18 -0
  565. package/types/src/charts/BumpChart/areaBump.d.ts +86 -0
  566. package/types/src/charts/BumpChart/index.d.ts +19 -1
  567. package/types/src/charts/Calendar/calendarDates.d.ts +8 -1
  568. package/types/src/charts/Candlestick/periods.d.ts +19 -8
  569. package/types/src/charts/ConnectedScatter/index.d.ts +17 -0
  570. package/types/src/charts/CyclePlot/cycleFacet.d.ts +61 -0
  571. package/types/src/charts/CyclePlot/cycleMeans.d.ts +32 -0
  572. package/types/src/charts/CyclePlot/cyclePeriods.d.ts +37 -0
  573. package/types/src/charts/CyclePlot/cycleTooltip.d.ts +47 -0
  574. package/types/src/charts/CyclePlot/index.d.ts +75 -0
  575. package/types/src/charts/DensityPlot/densityCurves.d.ts +84 -0
  576. package/types/src/charts/DensityPlot/densityPoint.d.ts +16 -0
  577. package/types/src/charts/DensityPlot/index.d.ts +33 -0
  578. package/types/src/charts/DensityPlot/rug.d.ts +57 -0
  579. package/types/src/charts/DotPlot/dotLayout.d.ts +95 -0
  580. package/types/src/charts/DotPlot/facetSize.d.ts +33 -0
  581. package/types/src/charts/DotPlot/index.d.ts +22 -0
  582. package/types/src/charts/DotPlot/placements.d.ts +28 -0
  583. package/types/src/charts/DotPlot/tooltip.d.ts +27 -0
  584. package/types/src/charts/Dumbbell/arrowGrays.d.ts +33 -0
  585. package/types/src/charts/Dumbbell/categoryChange.d.ts +66 -0
  586. package/types/src/charts/Dumbbell/changeEmit.d.ts +71 -0
  587. package/types/src/charts/Dumbbell/changes.d.ts +64 -0
  588. package/types/src/charts/Dumbbell/connectors.d.ts +43 -0
  589. package/types/src/charts/Dumbbell/emit.d.ts +17 -19
  590. package/types/src/charts/Dumbbell/index.d.ts +6 -2
  591. package/types/src/charts/Gantt/applyLayout.d.ts +14 -1
  592. package/types/src/charts/Gantt/criticalPath.d.ts +100 -0
  593. package/types/src/charts/Gantt/emit.d.ts +17 -1
  594. package/types/src/charts/Gantt/ganttCalendar.d.ts +37 -0
  595. package/types/src/charts/Gantt/ganttCritical.d.ts +53 -0
  596. package/types/src/charts/Gantt/ganttDecor.d.ts +32 -2
  597. package/types/src/charts/Gantt/ganttRows.d.ts +2 -0
  598. package/types/src/charts/Gantt/ganttSlack.d.ts +21 -0
  599. package/types/src/charts/Gantt/ganttTooltip.d.ts +35 -15
  600. package/types/src/charts/Gantt/index.d.ts +12 -6
  601. package/types/src/charts/Geomap/applyLayout.d.ts +19 -0
  602. package/types/src/charts/Geomap/cartogram.d.ts +58 -0
  603. package/types/src/charts/Geomap/cartogramContiguous.d.ts +59 -0
  604. package/types/src/charts/Geomap/cartogramFields.d.ts +16 -0
  605. package/types/src/charts/Geomap/cartogramLabels.d.ts +48 -0
  606. package/types/src/charts/Geomap/cartogramLayout.d.ts +71 -0
  607. package/types/src/charts/Geomap/cartogramLegend.d.ts +36 -0
  608. package/types/src/charts/Geomap/cartogramRelax.d.ts +29 -0
  609. package/types/src/charts/Geomap/densityEmit.d.ts +29 -0
  610. package/types/src/charts/Geomap/densityFields.d.ts +27 -0
  611. package/types/src/charts/Geomap/densityLayout.d.ts +49 -0
  612. package/types/src/charts/Geomap/densityTooltip.d.ts +48 -0
  613. package/types/src/charts/Geomap/dotDensity.d.ts +80 -0
  614. package/types/src/charts/Geomap/dotDensityLayout.d.ts +97 -0
  615. package/types/src/charts/Geomap/dotRenderer.d.ts +27 -0
  616. package/types/src/charts/Geomap/drillDown.d.ts +128 -0
  617. package/types/src/charts/Geomap/drillEmit.d.ts +37 -0
  618. package/types/src/charts/Geomap/drillEvents.d.ts +33 -0
  619. package/types/src/charts/Geomap/emit.d.ts +7 -0
  620. package/types/src/charts/Geomap/flowEmit.d.ts +6 -4
  621. package/types/src/charts/Geomap/flowLinks.d.ts +12 -1
  622. package/types/src/charts/Geomap/geoHexbin.d.ts +91 -0
  623. package/types/src/charts/Geomap/geoHexbinZoom.d.ts +76 -0
  624. package/types/src/charts/Geomap/index.d.ts +7 -0
  625. package/types/src/charts/Geomap/pointCluster.d.ts +108 -0
  626. package/types/src/charts/Geomap/pointClusterEmit.d.ts +106 -0
  627. package/types/src/charts/Geomap/pointClusterLayout.d.ts +123 -0
  628. package/types/src/charts/Geomap/pointClusterLinks.d.ts +21 -0
  629. package/types/src/charts/Geomap/pointClusterZoom.d.ts +89 -0
  630. package/types/src/charts/Geomap/pointLabels.d.ts +21 -3
  631. package/types/src/charts/Geomap/pointRows.d.ts +24 -0
  632. package/types/src/charts/Geomap/tileGrid.d.ts +98 -0
  633. package/types/src/charts/Geomap/tileState.d.ts +18 -0
  634. package/types/src/charts/Geomap/topojsonFluent.d.ts +9 -0
  635. package/types/src/charts/Geomap/topojsonLevels.d.ts +14 -0
  636. package/types/src/charts/Hexbin/contourLabels.d.ts +6 -5
  637. package/types/src/charts/Hexbin/settings.d.ts +7 -1
  638. package/types/src/charts/Histogram/binData.d.ts +6 -0
  639. package/types/src/charts/HorizonChart/emit.d.ts +20 -0
  640. package/types/src/charts/HorizonChart/horizonBands.d.ts +42 -0
  641. package/types/src/charts/HorizonChart/horizonColors.d.ts +25 -0
  642. package/types/src/charts/HorizonChart/hover.d.ts +52 -0
  643. package/types/src/charts/HorizonChart/index.d.ts +32 -0
  644. package/types/src/charts/HorizonChart/measure.d.ts +24 -0
  645. package/types/src/charts/HorizonChart/rowFilter.d.ts +88 -0
  646. package/types/src/charts/HorizonChart/state.d.ts +71 -0
  647. package/types/src/charts/KPI/applyLayout.d.ts +64 -0
  648. package/types/src/charts/KPI/delta.d.ts +62 -0
  649. package/types/src/charts/KPI/emit.d.ts +55 -0
  650. package/types/src/charts/KPI/index.d.ts +34 -0
  651. package/types/src/charts/KPI/series.d.ts +45 -0
  652. package/types/src/charts/KPI/tileLayout.d.ts +90 -0
  653. package/types/src/charts/Matrix/applyLayout.d.ts +5 -2
  654. package/types/src/charts/Matrix/bubbles.d.ts +87 -0
  655. package/types/src/charts/Matrix/emit.d.ts +3 -2
  656. package/types/src/charts/Matrix/index.d.ts +2 -1
  657. package/types/src/charts/Network/applyLayout.d.ts +35 -0
  658. package/types/src/charts/Network/bundle.d.ts +24 -15
  659. package/types/src/charts/Network/circleLayout.d.ts +149 -0
  660. package/types/src/charts/Network/containNodes.d.ts +35 -0
  661. package/types/src/charts/Network/emit.d.ts +20 -0
  662. package/types/src/charts/Network/forceLayout.d.ts +49 -0
  663. package/types/src/charts/Network/graph.d.ts +29 -5
  664. package/types/src/charts/Network/liveForce.d.ts +133 -0
  665. package/types/src/charts/Network/livePositions.d.ts +90 -0
  666. package/types/src/charts/Network/networkDrag.d.ts +55 -0
  667. package/types/src/charts/Pack/applyLayout.d.ts +2 -0
  668. package/types/src/charts/Pack/groupRows.d.ts +46 -0
  669. package/types/src/charts/Pack/index.d.ts +3 -0
  670. package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
  671. package/types/src/charts/Pack/nodeNames.d.ts +23 -0
  672. package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
  673. package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
  674. package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
  675. package/types/src/charts/Pareto/color.d.ts +21 -0
  676. package/types/src/charts/Pareto/hover.d.ts +38 -0
  677. package/types/src/charts/Pareto/index.d.ts +22 -0
  678. package/types/src/charts/Pareto/labels.d.ts +40 -0
  679. package/types/src/charts/Pareto/order.d.ts +30 -0
  680. package/types/src/charts/Pareto/paretoSteps.d.ts +65 -0
  681. package/types/src/charts/Pareto/state.d.ts +93 -0
  682. package/types/src/charts/Parliament/index.d.ts +18 -0
  683. package/types/src/charts/Plot/areaEnter.d.ts +34 -0
  684. package/types/src/charts/Plot/areaLabelsAlong.d.ts +7 -0
  685. package/types/src/charts/Plot/aspectRatio.d.ts +68 -0
  686. package/types/src/charts/Plot/axisHover.d.ts +2 -0
  687. package/types/src/charts/Plot/axisHoverScene.d.ts +44 -1
  688. package/types/src/charts/Plot/barConfidence.d.ts +14 -1
  689. package/types/src/charts/Plot/barHitArea.d.ts +34 -7
  690. package/types/src/charts/Plot/barLabelConfidence.d.ts +25 -0
  691. package/types/src/charts/Plot/baselineBreak.d.ts +2 -1
  692. package/types/src/charts/Plot/baselineDomain.d.ts +5 -0
  693. package/types/src/charts/Plot/circleLabels.d.ts +8 -7
  694. package/types/src/charts/Plot/confidenceAxes.d.ts +63 -0
  695. package/types/src/charts/Plot/confidenceTooltip.d.ts +22 -0
  696. package/types/src/charts/Plot/discreteDomain.d.ts +13 -2
  697. package/types/src/charts/Plot/discreteSpan.d.ts +5 -0
  698. package/types/src/charts/Plot/domainClip.d.ts +15 -5
  699. package/types/src/charts/Plot/downsample.d.ts +16 -0
  700. package/types/src/charts/Plot/index.d.ts +20 -17
  701. package/types/src/charts/Plot/inferDiscrete.d.ts +31 -0
  702. package/types/src/charts/Plot/jitter.d.ts +45 -0
  703. package/types/src/charts/Plot/lineLabelSides.d.ts +19 -0
  704. package/types/src/charts/Plot/lineLabelsAlong.d.ts +19 -6
  705. package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
  706. package/types/src/charts/Plot/marginalHover.d.ts +26 -0
  707. package/types/src/charts/Plot/marginalLayout.d.ts +95 -0
  708. package/types/src/charts/Plot/marginalPaint.d.ts +54 -0
  709. package/types/src/charts/Plot/marginalScene.d.ts +67 -0
  710. package/types/src/charts/Plot/marginalSeries.d.ts +38 -0
  711. package/types/src/charts/Plot/marginalStats.d.ts +115 -0
  712. package/types/src/charts/Plot/openDomainEnds.d.ts +25 -0
  713. package/types/src/charts/Plot/orderPath.d.ts +100 -0
  714. package/types/src/charts/Plot/orderPathScene.d.ts +49 -0
  715. package/types/src/charts/Plot/outlierDetect.d.ts +87 -0
  716. package/types/src/charts/Plot/outlierLabels.d.ts +103 -0
  717. package/types/src/charts/Plot/outlierLines.d.ts +30 -0
  718. package/types/src/charts/Plot/outlierScene.d.ts +103 -0
  719. package/types/src/charts/Plot/outlierTooltip.d.ts +44 -0
  720. package/types/src/charts/Plot/periodLabels.d.ts +14 -0
  721. package/types/src/charts/Plot/pipeline.d.ts +2 -1
  722. package/types/src/charts/Plot/plotBreaks.d.ts +21 -6
  723. package/types/src/charts/Plot/plotInit.d.ts +7 -25
  724. package/types/src/charts/Plot/plotLevels.d.ts +120 -0
  725. package/types/src/charts/Plot/plotRangeBreaks.d.ts +28 -2
  726. package/types/src/charts/Plot/plotShapes.d.ts +42 -0
  727. package/types/src/charts/Plot/pointConfidence.d.ts +73 -0
  728. package/types/src/charts/Plot/pointKey.d.ts +9 -0
  729. package/types/src/charts/Plot/referenceDomains.d.ts +2 -1
  730. package/types/src/charts/Plot/shapeAccessors.d.ts +24 -0
  731. package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
  732. package/types/src/charts/Plot/sharedHover.d.ts +5 -0
  733. package/types/src/charts/Plot/sharedTooltip.d.ts +31 -7
  734. package/types/src/charts/Plot/stackEnter.d.ts +1 -1
  735. package/types/src/charts/Plot/stackLegendOrder.d.ts +4 -1
  736. package/types/src/charts/Plot/stackNeutral.d.ts +85 -0
  737. package/types/src/charts/Plot/swarm.d.ts +8 -4
  738. package/types/src/charts/Plot/timeNestKeys.d.ts +20 -0
  739. package/types/src/charts/Plot/trendLabels.d.ts +15 -6
  740. package/types/src/charts/Plot/trendLines.d.ts +40 -8
  741. package/types/src/charts/Plot/trendMovingAverage.d.ts +78 -0
  742. package/types/src/charts/Plot/trendProjection.d.ts +4 -2
  743. package/types/src/charts/Plot/trendTooltip.d.ts +24 -2
  744. package/types/src/charts/Priestley/timeAxis.d.ts +13 -7
  745. package/types/src/charts/Pyramid/gutter.d.ts +28 -6
  746. package/types/src/charts/Pyramid/scene.d.ts +1 -1
  747. package/types/src/charts/Radar/applyLayout.d.ts +2 -3
  748. package/types/src/charts/Radar/axisDecorations.d.ts +5 -2
  749. package/types/src/charts/Radar/curvedLabels.d.ts +35 -0
  750. package/types/src/charts/Radar/emit.d.ts +5 -2
  751. package/types/src/charts/Radar/index.d.ts +7 -2
  752. package/types/src/charts/Radar/points.d.ts +50 -0
  753. package/types/src/charts/RadialArea/index.d.ts +17 -0
  754. package/types/src/charts/RadialLine/angles.d.ts +67 -0
  755. package/types/src/charts/RadialLine/applyLayout.d.ts +70 -0
  756. package/types/src/charts/RadialLine/emit.d.ts +13 -0
  757. package/types/src/charts/RadialLine/index.d.ts +28 -0
  758. package/types/src/charts/RadialLine/paths.d.ts +37 -0
  759. package/types/src/charts/RadialLine/points.d.ts +43 -0
  760. package/types/src/charts/RadialLine/series.d.ts +63 -0
  761. package/types/src/charts/RadialLine/seriesLabelNodes.d.ts +26 -0
  762. package/types/src/charts/RadialLine/seriesLabels.d.ts +80 -0
  763. package/types/src/charts/RadialLine/spokes.d.ts +15 -0
  764. package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
  765. package/types/src/charts/RadialTree/index.d.ts +16 -0
  766. package/types/src/charts/Rings/emit.d.ts +28 -5
  767. package/types/src/charts/Rings/index.d.ts +4 -2
  768. package/types/src/charts/Rings/ringsCurves.d.ts +46 -0
  769. package/types/src/charts/Rings/ringsGraph.d.ts +32 -5
  770. package/types/src/charts/Rings/ringsParallel.d.ts +4 -2
  771. package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
  772. package/types/src/charts/Rings/ringsSizing.d.ts +41 -11
  773. package/types/src/charts/Sankey/circularLayout.d.ts +3 -0
  774. package/types/src/charts/Sankey/sankeyDrag.d.ts +112 -0
  775. package/types/src/charts/Sankey/sankeyLayout.d.ts +8 -0
  776. package/types/src/charts/Scatter/index.d.ts +3 -2
  777. package/types/src/charts/ScatterMatrix/binEmit.d.ts +22 -0
  778. package/types/src/charts/ScatterMatrix/index.d.ts +80 -0
  779. package/types/src/charts/ScatterMatrix/matrixData.d.ts +93 -0
  780. package/types/src/charts/ScatterMatrix/matrixFacet.d.ts +32 -0
  781. package/types/src/charts/ScatterMatrix/matrixHover.d.ts +21 -0
  782. package/types/src/charts/ScatterMatrix/matrixTooltip.d.ts +32 -0
  783. package/types/src/charts/StripPlot/index.d.ts +16 -0
  784. package/types/src/charts/TileGridMap/index.d.ts +14 -0
  785. package/types/src/charts/Tree/applyLayout.d.ts +20 -0
  786. package/types/src/charts/Tree/index.d.ts +2 -2
  787. package/types/src/charts/Tree/keys.d.ts +25 -0
  788. package/types/src/charts/Tree/nodeHeight.d.ts +41 -0
  789. package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
  790. package/types/src/charts/Tree/radialLabels.d.ts +24 -0
  791. package/types/src/charts/Tree/radialLayout.d.ts +129 -0
  792. package/types/src/charts/Venn/applyLayout.d.ts +91 -0
  793. package/types/src/charts/Venn/circles.d.ts +87 -0
  794. package/types/src/charts/Venn/ellipseFrame.d.ts +37 -0
  795. package/types/src/charts/Venn/emit.d.ts +36 -0
  796. package/types/src/charts/Venn/index.d.ts +30 -0
  797. package/types/src/charts/Venn/nelderMead.d.ts +28 -0
  798. package/types/src/charts/Venn/tooltip.d.ts +8 -0
  799. package/types/src/charts/Venn/vennData.d.ts +56 -0
  800. package/types/src/charts/Venn/vennEllipses.d.ts +93 -0
  801. package/types/src/charts/Venn/vennFit.d.ts +39 -0
  802. package/types/src/charts/Venn/vennLayout.d.ts +52 -0
  803. package/types/src/charts/Venn/vennRegions.d.ts +58 -0
  804. package/types/src/charts/Waffle/applyLayout.d.ts +4 -1
  805. package/types/src/charts/Waffle/arcEmit.d.ts +45 -0
  806. package/types/src/charts/Waffle/arcLayout.d.ts +82 -0
  807. package/types/src/charts/Waffle/arcStage.d.ts +60 -0
  808. package/types/src/charts/Waffle/emit.d.ts +2 -1
  809. package/types/src/charts/Waffle/index.d.ts +8 -2
  810. package/types/src/charts/Waffle/tooltip.d.ts +7 -2
  811. package/types/src/charts/Waterfall/connectors.d.ts +3 -2
  812. package/types/src/charts/WordCloud/applyLayout.d.ts +51 -0
  813. package/types/src/charts/WordCloud/cloudLayout.d.ts +95 -0
  814. package/types/src/charts/WordCloud/emit.d.ts +27 -0
  815. package/types/src/charts/WordCloud/fontScale.d.ts +20 -0
  816. package/types/src/charts/WordCloud/glyphMask.d.ts +95 -0
  817. package/types/src/charts/WordCloud/index.d.ts +31 -0
  818. package/types/src/charts/WordCloud/occupancy.d.ts +59 -0
  819. package/types/src/charts/WordCloud/rotation.d.ts +31 -0
  820. package/types/src/charts/WordCloud/size.d.ts +16 -0
  821. package/types/src/charts/WordCloud/spiral.d.ts +47 -0
  822. package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
  823. package/types/src/charts/definition/declaresField.d.ts +9 -0
  824. package/types/src/charts/definition/makeChart.d.ts +3 -3
  825. package/types/src/charts/drawSteps/gestureHover.d.ts +2 -2
  826. package/types/src/charts/drawSteps/leavesSurface.d.ts +11 -0
  827. package/types/src/charts/drawSteps/selectActions.d.ts +58 -0
  828. package/types/src/charts/drawSteps/selectGesture.d.ts +60 -0
  829. package/types/src/charts/drawSteps/selectRegion.d.ts +86 -0
  830. package/types/src/charts/drawSteps/selectState.d.ts +51 -0
  831. package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
  832. package/types/src/charts/drawSteps/zoomControls.d.ts +32 -7
  833. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +104 -16
  834. package/types/src/charts/drawSteps/zoomControlsMenu.d.ts +30 -0
  835. package/types/src/charts/drawSteps/zoomDrag.d.ts +73 -0
  836. package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
  837. package/types/src/charts/facet/drawFacets.d.ts +6 -3
  838. package/types/src/charts/facet/facetConfig.d.ts +35 -1
  839. package/types/src/charts/facet/facetData.d.ts +8 -2
  840. package/types/src/charts/facet/facetGrid.d.ts +12 -0
  841. package/types/src/charts/facet/facetGutter.d.ts +19 -5
  842. package/types/src/charts/facet/facetLayout.d.ts +79 -0
  843. package/types/src/charts/facet/facetLayouts.d.ts +21 -0
  844. package/types/src/charts/facet/facetScene.d.ts +4 -1
  845. package/types/src/charts/features/annotationFrame.d.ts +2 -0
  846. package/types/src/charts/features/axesFinal.d.ts +5 -2
  847. package/types/src/charts/features/axisTooltip.d.ts +49 -0
  848. package/types/src/charts/features/bareRegion.d.ts +18 -0
  849. package/types/src/charts/features/boxGrid.d.ts +28 -0
  850. package/types/src/charts/features/centerLabel.d.ts +89 -0
  851. package/types/src/charts/features/circleLabelPlacement.d.ts +81 -11
  852. package/types/src/charts/features/circleLabels.d.ts +33 -3
  853. package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
  854. package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
  855. package/types/src/charts/features/colorScaleHover.d.ts +14 -3
  856. package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
  857. package/types/src/charts/features/colorScaleTooltip.d.ts +38 -0
  858. package/types/src/charts/features/colorScaleTop.d.ts +30 -0
  859. package/types/src/charts/features/colorScaleValue.d.ts +6 -0
  860. package/types/src/charts/features/curvedArrows.d.ts +42 -12
  861. package/types/src/charts/features/depthKey.d.ts +19 -0
  862. package/types/src/charts/features/edgeArrows.d.ts +68 -31
  863. package/types/src/charts/features/emitHelpers.d.ts +6 -1
  864. package/types/src/charts/features/featuresColorScale.d.ts +6 -0
  865. package/types/src/charts/features/hoverTicks.d.ts +33 -0
  866. package/types/src/charts/features/idleQueue.d.ts +46 -0
  867. package/types/src/charts/features/keyHold.d.ts +41 -0
  868. package/types/src/charts/features/keyTooltip.d.ts +44 -0
  869. package/types/src/charts/features/labelLayering.d.ts +38 -0
  870. package/types/src/charts/features/labelSlots.d.ts +53 -0
  871. package/types/src/charts/features/linkInteraction.d.ts +13 -4
  872. package/types/src/charts/features/linkLabelPath.d.ts +0 -7
  873. package/types/src/charts/features/networkMeasures.d.ts +53 -0
  874. package/types/src/charts/features/nodeDrag.d.ts +51 -0
  875. package/types/src/charts/features/nodeKeys.d.ts +53 -0
  876. package/types/src/charts/features/nodeOutline.d.ts +34 -0
  877. package/types/src/charts/features/nodeStats.d.ts +93 -0
  878. package/types/src/charts/features/pathLabelBends.d.ts +78 -0
  879. package/types/src/charts/features/plotAnnotations.d.ts +2 -1
  880. package/types/src/charts/features/plotEndLabels.d.ts +14 -1
  881. package/types/src/charts/features/plotPaint.d.ts +5 -0
  882. package/types/src/charts/features/rectNodeSize.d.ts +42 -0
  883. package/types/src/charts/features/ringLabels.d.ts +3 -1
  884. package/types/src/charts/features/selfLoops.d.ts +10 -9
  885. package/types/src/charts/features/shapeEmit.d.ts +2 -0
  886. package/types/src/charts/features/sharedFields.d.ts +8 -4
  887. package/types/src/charts/features/spokeLabels.d.ts +123 -0
  888. package/types/src/charts/features/swatchPaint.d.ts +58 -0
  889. package/types/src/charts/features/textHalo.d.ts +4 -3
  890. package/types/src/charts/features/thresholdMembers.d.ts +6 -6
  891. package/types/src/charts/features/tooltipRows.d.ts +50 -0
  892. package/types/src/charts/features/tooltipSwatch.d.ts +25 -11
  893. package/types/src/charts/helpers/valueTitle.d.ts +7 -0
  894. package/types/src/charts/index.d.ts +17 -0
  895. package/types/src/charts/partition/chartFields.d.ts +6 -1
  896. package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
  897. package/types/src/charts/pipeline/preDrawData.d.ts +26 -0
  898. package/types/src/charts/plotBuffers/Circle.d.ts +2 -1
  899. package/types/src/charts/plotBuffers/Rect.d.ts +2 -1
  900. package/types/src/charts/plotBuffers/Tick.d.ts +9 -0
  901. package/types/src/charts/plotBuffers/defaultBuffers.d.ts +2 -0
  902. package/types/src/charts/polar/chrome.d.ts +19 -6
  903. package/types/src/charts/viz/Viz.d.ts +10 -3
  904. package/types/src/charts/viz/VizBase.d.ts +63 -3
  905. package/types/src/charts/viz/appendRows.d.ts +49 -0
  906. package/types/src/charts/viz/backgroundInk.d.ts +8 -0
  907. package/types/src/charts/viz/dataChanged.d.ts +11 -0
  908. package/types/src/charts/viz/discrete.d.ts +19 -0
  909. package/types/src/charts/viz/emphasis.d.ts +17 -0
  910. package/types/src/charts/viz/fillStroke.d.ts +7 -0
  911. package/types/src/charts/viz/focusTargets.d.ts +15 -1
  912. package/types/src/charts/viz/groupByLevels.d.ts +36 -0
  913. package/types/src/charts/viz/groupRow.d.ts +6 -0
  914. package/types/src/charts/viz/hoverBand.d.ts +28 -0
  915. package/types/src/charts/viz/interactionOpacity.d.ts +23 -2
  916. package/types/src/charts/viz/keyboardNav.d.ts +13 -0
  917. package/types/src/charts/viz/liftRaised.d.ts +23 -0
  918. package/types/src/charts/viz/reportDrawError.d.ts +12 -0
  919. package/types/src/charts/viz/setCursor.d.ts +38 -0
  920. package/types/src/charts/viz/simpleHover.d.ts +3 -3
  921. package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
  922. package/types/src/charts/viz/userClick.d.ts +43 -0
  923. package/types/src/charts/viz/vizFields.d.ts +12 -0
  924. package/types/src/charts/viz/vizTypes.d.ts +132 -2
  925. package/types/src/charts/viz/vizVisibility.d.ts +7 -0
  926. package/types/src/components/Axis/Axis.d.ts +68 -3
  927. package/types/src/components/Axis/axisBreak.d.ts +19 -3
  928. package/types/src/components/Axis/axisDefaults.d.ts +14 -0
  929. package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
  930. package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
  931. package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
  932. package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
  933. package/types/src/components/Axis/axisLabelThinning.d.ts +57 -3
  934. package/types/src/components/Axis/axisLayout.d.ts +9 -2
  935. package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
  936. package/types/src/components/Axis/axisLayoutScale.d.ts +16 -2
  937. package/types/src/components/Axis/axisLevels.d.ts +137 -0
  938. package/types/src/components/Axis/axisLimit.d.ts +18 -0
  939. package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
  940. package/types/src/components/Axis/axisMinorTicks.d.ts +83 -0
  941. package/types/src/components/Axis/axisPeriods.d.ts +45 -0
  942. package/types/src/components/Axis/axisRangeBreaks.d.ts +6 -2
  943. package/types/src/components/Axis/axisRounding.d.ts +22 -0
  944. package/types/src/components/Axis/axisScaleType.d.ts +32 -0
  945. package/types/src/components/Axis/axisScene.d.ts +15 -7
  946. package/types/src/components/Axis/axisTickLookups.d.ts +26 -0
  947. package/types/src/components/Axis/axisTitle.d.ts +30 -0
  948. package/types/src/components/Axis/axisTooltipTargets.d.ts +94 -0
  949. package/types/src/components/Axis/labelSizeSession.d.ts +16 -0
  950. package/types/src/components/Axis/rangeBreaks.d.ts +6 -2
  951. package/types/src/components/Axis/timeValues.d.ts +48 -2
  952. package/types/src/components/ColorScale/ColorScale.d.ts +21 -11
  953. package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
  954. package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
  955. package/types/src/components/ColorScale/colorScaleScale.d.ts +45 -0
  956. package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
  957. package/types/src/components/Legend/Legend.d.ts +5 -0
  958. package/types/src/components/Legend/legendCut.d.ts +31 -0
  959. package/types/src/components/Legend/legendRender.d.ts +6 -1
  960. package/types/src/components/TextBox.d.ts +4 -0
  961. package/types/src/components/Tooltip.d.ts +11 -2
  962. package/types/src/components/textEllipsis.d.ts +6 -0
  963. package/types/src/components/tooltipDom.d.ts +24 -0
  964. package/types/src/fluent.d.ts +48 -1
  965. package/types/src/shapes/Bar.d.ts +7 -0
  966. package/types/src/shapes/Box.d.ts +15 -0
  967. package/types/src/shapes/Shape.d.ts +11 -0
  968. package/types/src/shapes/Tick.d.ts +20 -0
  969. package/types/src/shapes/boxExtraShapes.d.ts +40 -0
  970. package/types/src/shapes/boxExtras.d.ts +85 -0
  971. package/types/src/shapes/boxStyle.d.ts +25 -4
  972. package/types/src/shapes/downsample.d.ts +68 -0
  973. package/types/src/shapes/emitLabels.d.ts +1 -1
  974. package/types/src/shapes/hitAreaNode.d.ts +2 -1
  975. package/types/src/shapes/index.d.ts +1 -0
  976. package/types/src/shapes/pathSeries.d.ts +35 -0
  977. package/types/src/shapes/shapeConfig.d.ts +70 -2
  978. package/types/src/utils/BaseClass.d.ts +18 -4
  979. package/types/src/utils/D3plusConfig.d.ts +1458 -676
  980. package/types/src/utils/configValue.d.ts +8 -0
  981. package/types/src/utils/index.d.ts +1 -1
  982. package/types/src/utils/jitter.d.ts +23 -0
  983. package/types/src/utils/resetSetters.d.ts +23 -0
  984. package/types/umd-entry.d.ts +4 -0
  985. package/umd/d3plus-core.full.js +109828 -74615
  986. package/umd/d3plus-core.full.min.js +2 -2
  987. package/umd/d3plus-core.js +90460 -56685
  988. package/umd/d3plus-core.min.js +2 -2
@@ -1,56 +1,65 @@
1
1
  import { configPrep } from "../../utils/index.js";
2
- import clickShape from "./click.shape.js";
3
2
  import { groupDepthOf, groupNarrows, groupPath } from "../viz/groupRow.js";
4
3
  import { appendThresholdMembers } from "../features/thresholdMembers.js";
4
+ import { appendPointConfidence } from "../Plot/confidenceTooltip.js";
5
+ import { appendOutlier } from "../Plot/outlierTooltip.js";
6
+ import { leadWithColorScaleRows } from "../features/colorScaleTooltip.js";
7
+ import { keyTooltipAnchor } from "../features/keyTooltip.js";
5
8
  import { leadTitleWithSwatch, pickSwatch } from "../features/tooltipSwatch.js";
6
9
  import { pointTooltipAnchor } from "../viz/pointTooltipAnchor.js";
10
+ import { setMarkCursor } from "../viz/setCursor.js";
11
+ import { tooltipEnabled } from "../viz/tooltipEnabled.js";
12
+ import { hasOwnClick, hasUserClick } from "../viz/userClick.js";
7
13
  /**
8
14
  @module mouseMoveShape
9
15
  Tooltip logic for a specified data point.
10
16
  @param config Optional configuration methods for the Tooltip class.
11
17
  @private
12
18
  */ export default function(d, i, x, event) {
13
- if (d && this.schema.tooltip(d, i)) {
14
- const defaultClick = clickShape.bind(this).toString();
15
- // does the shape have any user-defined click events?
16
- const hasUserClick = Object.keys(this.schema.on).some((e)=>// all valid click event keys,
17
- [
18
- "click",
19
- "click.shape"
20
- ].includes(e) && // truthy values (no nulls),
21
- this.schema.on[e] && // and it is not our default click.shape function
22
- this.schema.on[e].toString() !== defaultClick);
23
- // does the shape still have our default "click.shape" event?
24
- // (if the user only sets "click", both functions will fire)
25
- const hasDefaultClick = this.schema.on["click.shape"] && this.schema.on["click.shape"].toString() === defaultClick;
26
- // can the viz show deeper data? A group row zooms into its group.
27
- const groupDepth = groupDepthOf(d);
28
- const hasDeeperLevel = groupDepth === undefined ? this._drawDepth < this.schema.groupBy.length - 1 : groupNarrows(this.schema.groupBy, groupPath(this.schema.groupBy, d, groupDepth), this._filteredData ?? []);
29
- // only show the hand cursor when the shape has a click event
30
- this._select.style("cursor", hasUserClick || hasDefaultClick && hasDeeperLevel ? "pointer" : "auto");
31
- // Plot's snapped hover (shared or single) owns the tooltip while active.
32
- if (this._sharedHoverActive) return;
33
- // A point mark's tooltip points at the mark, wherever the pointer is
34
- // within reach of it; anything else follows the pointer.
35
- const position = pointTooltipAnchor(this, this._lastScenePick?.node) ?? (event.touches ? [
36
- event.touches[0].clientX,
37
- event.touches[0].clientY
38
- ] : [
39
- event.clientX,
40
- event.clientY
41
- ]);
42
- // Unwrap to the underlying source row so tooltip cell accessors (e.g.
43
- // the Treemap "share" column) resolve regardless of whether the hovered
44
- // scene node was the shape (datum = row) or its text label (datum = a
45
- // wrapper whose `.data` chain leads back to the row).
46
- let tooltipDatum = x || d;
47
- while(tooltipDatum && tooltipDatum.__d3plus__ && tooltipDatum.data)tooltipDatum = tooltipDatum.data;
48
- this._tooltipClass.data([
49
- tooltipDatum
50
- ]).footer(hasDefaultClick && hasDeeperLevel ? this.schema.translate("Click to Expand") : false).title((dd, ii)=>this._drawLabel(dd, ii)).titleSwatch(true).position(position).config(configPrep.bind(this)(this.schema.tooltipConfig));
51
- // A threshold bucket lists what it holds.
52
- appendThresholdMembers(this._tooltipClass, this, tooltipDatum);
53
- // The title leads with a swatch of the hovered mark, as in the legend.
54
- leadTitleWithSwatch(this._tooltipClass, pickSwatch(this, this._lastScenePick)).render();
55
- }
19
+ if (!d) return;
20
+ // does the shape have any user-defined click events?
21
+ const userClick = hasUserClick(this, "click.shape");
22
+ // does the shape still have our default "click.shape" event?
23
+ // (if the user only sets "click", both functions will fire)
24
+ const hasDefaultClick = hasOwnClick(this, "click.shape");
25
+ // can the viz show deeper data? A group row zooms into its group.
26
+ const groupDepth = groupDepthOf(d);
27
+ const hasDeeperLevel = groupDepth === undefined ? this._drawDepth < this.schema.groupBy.length - 1 : groupNarrows(this.schema.groupBy, groupPath(this.schema.groupBy, d, groupDepth), this._filteredData ?? []);
28
+ // only show the hand cursor while the pointer is on a shape with a click
29
+ // event, whether or not it shows a tooltip
30
+ setMarkCursor(this, userClick || hasDefaultClick && hasDeeperLevel);
31
+ if (!tooltipEnabled(this, d, i)) return;
32
+ // Plot's snapped hover (shared or single) owns the tooltip while active.
33
+ if (this._sharedHoverActive) return;
34
+ // A point mark's tooltip points at the mark, wherever the pointer is
35
+ // within reach of it, and a colorScale swatch's opens beside the key;
36
+ // anything else follows the pointer.
37
+ const node = this._lastScenePick?.node;
38
+ const position = pointTooltipAnchor(this, node) ?? keyTooltipAnchor(this, node) ?? (event.touches ? [
39
+ event.touches[0].clientX,
40
+ event.touches[0].clientY
41
+ ] : [
42
+ event.clientX,
43
+ event.clientY
44
+ ]);
45
+ // Unwrap to the underlying source row so tooltip cell accessors (e.g.
46
+ // the Treemap "share" column) resolve regardless of whether the hovered
47
+ // scene node was the shape (datum = row) or its text label (datum = a
48
+ // wrapper whose `.data` chain leads back to the row).
49
+ let tooltipDatum = x || d;
50
+ while(tooltipDatum && tooltipDatum.__d3plus__ && tooltipDatum.data)tooltipDatum = tooltipDatum.data;
51
+ this._tooltipClass.data([
52
+ tooltipDatum
53
+ ]).footer(hasDefaultClick && hasDeeperLevel ? this.schema.translate("Click to Expand") : false).title((dd, ii)=>this._drawLabel(dd, ii)).titleSwatch(true).position(position).config(configPrep.bind(this)(this.schema.tooltipConfig));
54
+ // The row's colorScale value (or a bivariate colorScale's two) leads
55
+ // the rows.
56
+ leadWithColorScaleRows(this._tooltipClass, this, tooltipDatum, i);
57
+ // A Plot's point lists its `confidence` bounds.
58
+ appendPointConfidence(this._tooltipClass, this, this._lastScenePick?.node?.shapeType);
59
+ // An outlier says so.
60
+ appendOutlier(this._tooltipClass, this);
61
+ // A threshold bucket lists what it holds.
62
+ appendThresholdMembers(this._tooltipClass, this, tooltipDatum);
63
+ // The title leads with a swatch of the hovered mark, as in the legend.
64
+ leadTitleWithSwatch(this._tooltipClass, pickSwatch(this, this._lastScenePick)).render();
56
65
  }
@@ -16,11 +16,14 @@
16
16
  @module
17
17
  */ import { drawWithInset } from "../pipeline/insetPlacement.js";
18
18
  import { drawWithAlongLegend } from "../Plot/alongLegend.js";
19
+ import { warnConfigOnce } from "../../utils/configWarnings.js";
20
+ import { chartUtc } from "../Plot/plotRangeBreaks.js";
19
21
  import { backgroundInk } from "../viz/backgroundInk.js";
20
22
  import { FACET_ASPECT, facetActive, facetOuterAxes, facetScalesShared, resolveFacetConfig } from "./facetConfig.js";
21
23
  import { facetFilteredData, facetGroups, facetTimeFilter, formatFacetValue } from "./facetData.js";
22
24
  import { facetGrid } from "./facetGrid.js";
23
- import { alignInsets, expandArea, LABEL_COMBOS, labelExpansions, labelGutter, labelKey, labelOverhang, NO_SIDES, panelBase } from "./facetGutter.js";
25
+ import { layoutDimensions, layoutTitleTexts, layoutTitleTooltips, missingFacetMessage, placeFacets } from "./facetLayout.js";
26
+ import { alignInsets, expandArea, settleExpansion, LABEL_COMBOS, labelExpansions, labelGutter, labelKey, labelOverhang, NO_SIDES, panelBase } from "./facetGutter.js";
24
27
  import { clearPanelSlots } from "./facetPanel.js";
25
28
  import { facetBodyNode, facetPanelNode, facetTitleNodes, measureFacetTitles, prefixKeys } from "./facetScene.js";
26
29
  /** Margins that make `area` the chart area of a `viz`-sized surface. */ export function facetAreaMargin(viz, area) {
@@ -91,10 +94,13 @@ import { facetBodyNode, facetPanelNode, facetTitleNodes, measureFacetTitles, pre
91
94
  fontColor: backgroundInk(viz)
92
95
  };
93
96
  }
94
- /** Each panel's title text (empty when titles are off). */ export function facetTitleTexts(config, panels) {
97
+ /**
98
+ Each panel's title text (empty when titles are off), with dates written
99
+ in UTC with `utc`.
100
+ */ export function facetTitleTexts(config, panels, utc = false) {
95
101
  const { title } = config;
96
102
  const values = panels.map((p)=>p.value);
97
- return panels.map((p)=>title === false ? "" : title ? `${title(p.value, p.data)}` : formatFacetValue(p.value, values));
103
+ return panels.map((p)=>title === false ? "" : title ? `${title(p.value, p.data)}` : formatFacetValue(p.value, values, utc));
98
104
  }
99
105
  /** The height every panel reserves for its title: the tallest title at its cell's width. */ export function facetTitleBand(viz, texts, cells, style) {
100
106
  const titles = texts.map((text, i)=>({
@@ -107,23 +113,36 @@ import { facetBodyNode, facetPanelNode, facetTitleNodes, measureFacetTitles, pre
107
113
  }
108
114
  /**
109
115
  Measures how much room each combination of axis labels takes, by drawing
110
- a probe panel with each (see `facet/facetGutter.ts`).
116
+ a probe panel with each (see `facet/facetGutter.ts`). A labeled panel
117
+ draws in its base area grown by that room, where its axes can take more
118
+ than in the base area (a narrow panel's axis drops its title to fit), so
119
+ each combination is measured again in the area it grows to, until its
120
+ room settles (see `settleExpansion`).
111
121
  */ function measureLabels(viz, plan, cell, area, outer) {
112
122
  const data = plan.panels.find((p)=>p.data.length)?.data;
113
123
  const insets = plan.hooks.insets;
114
124
  if (!data || !insets) return {};
115
- const measured = {};
116
- // An axis labeled on every panel is labeled in every probe.
117
- for (const labels of LABEL_COMBOS.filter((l)=>(outer.x || l.x) && (outer.y || l.y))){
118
- drawPanel(viz, plan, data, area, {
125
+ const probe = (labels, grown)=>{
126
+ drawPanel(viz, plan, data, expandArea(area, grown), {
119
127
  cell,
120
128
  shared: plan.shared,
121
129
  labels,
122
130
  scales: plan.scales
123
131
  });
124
- measured[labelKey(labels)] = insets(viz);
132
+ return insets(viz);
133
+ };
134
+ const measured = {};
135
+ // An axis labeled on every panel is labeled in every probe.
136
+ const combos = LABEL_COMBOS.filter((l)=>(outer.x || l.x) && (outer.y || l.y));
137
+ for (const labels of combos)measured[labelKey(labels)] = probe(labels, NO_SIDES);
138
+ const baseline = baselineLabels(outer);
139
+ const bare = measured[labelKey(baseline)] ?? NO_SIDES;
140
+ const expansions = labelExpansions(measured, baseline);
141
+ for (const labels of combos){
142
+ const key = labelKey(labels);
143
+ expansions[key] = settleExpansion(expansions[key], bare, (grown)=>probe(labels, grown));
125
144
  }
126
- return labelExpansions(measured, baselineLabels(outer));
145
+ return expansions;
127
146
  }
128
147
  /**
129
148
  With one axis labeled on every panel and the other only on the grid's
@@ -133,11 +152,11 @@ import { facetBodyNode, facetPanelNode, facetTitleNodes, measureFacetTitles, pre
133
152
  and returns how far each area must grow (never positive) so that every
134
153
  plot area comes out the same size and in the same place in its cell,
135
154
  which the edge panels' axes then hold for all. Empty unless the axes
136
- are split that way.
155
+ are split that way, or the chart asks for it (`FacetHooks.align`).
137
156
  */ function panelAlignment(viz, plan, cells, areas, labels, layout) {
138
157
  const insets = plan.hooks.insets;
139
158
  const { outer, expansions } = layout;
140
- if (!insets || outer.x === outer.y) return [];
159
+ if (!insets || outer.x === outer.y && !plan.hooks.align) return [];
141
160
  const drawn = plan.panels.map((panel, i)=>{
142
161
  if (!panel.data.length) return undefined;
143
162
  drawPanel(viz, plan, panel.data, areas[i], {
@@ -174,6 +193,10 @@ import { facetBodyNode, facetPanelNode, facetTitleNodes, measureFacetTitles, pre
174
193
  titleHeight: 0,
175
194
  aspect: (typeof hooks.aspect === "function" ? hooks.aspect(viz) : hooks.aspect) ?? FACET_ASPECT
176
195
  };
196
+ if (plan.places && config.layout) {
197
+ opts.places = plan.places;
198
+ opts.grid = layoutDimensions(config.layout);
199
+ }
177
200
  const titleHeight = facetTitleBand(viz, texts, facetGrid(panels.length, area, opts), style);
178
201
  opts.titleHeight = titleHeight;
179
202
  const first = facetGrid(panels.length, area, opts)[0];
@@ -191,7 +214,7 @@ import { facetBodyNode, facetPanelNode, facetTitleNodes, measureFacetTitles, pre
191
214
  opts.columnPadding = config.padding + labelOverhang(expansions);
192
215
  opts.titleHeight = titleHeight + gutter.top;
193
216
  const cells = facetGrid(panels.length, area, opts);
194
- const columns = Math.max(1, ...cells.map((c)=>c.column + 1));
217
+ const columns = opts.grid?.columns ?? Math.max(1, ...cells.map((c)=>c.column + 1));
195
218
  return {
196
219
  cells,
197
220
  columns,
@@ -201,21 +224,25 @@ import { facetBodyNode, facetPanelNode, facetTitleNodes, measureFacetTitles, pre
201
224
  expansions
202
225
  };
203
226
  }
204
- /** Where a panel's title goes: above its cell, across its base area. */ export function panelTitle(text, cell, base) {
227
+ /** Where a panel's title goes: above its cell, across its base area. */ export function panelTitle(text, cell, base, tooltip) {
205
228
  return {
206
229
  text,
207
230
  x: base.x,
208
231
  y: cell.y,
209
- width: base.width
232
+ width: base.width,
233
+ ...tooltip ? {
234
+ tooltip
235
+ } : {}
210
236
  };
211
237
  }
212
238
  /** Draws every panel and composes them into the chart's scene; returns the per-panel state and every panel's data shapes. */ function drawPanels(viz, plan) {
213
239
  const style = facetTitleStyle(viz, plan.config);
214
- const texts = facetTitleTexts(plan.config, plan.panels);
240
+ const texts = plan.places ? layoutTitleTexts(plan.config, plan.panels, plan.places) : facetTitleTexts(plan.config, plan.panels, chartUtc(viz));
241
+ const tooltips = plan.places ? layoutTitleTooltips(texts, plan.places) : [];
215
242
  const layout = layoutGrid(viz, plan, texts, style);
216
243
  const { cells, expansions } = layout;
217
244
  const bases = cells.map((cell)=>panelBase(cell, layout.titleHeight, layout.gutter, layout.columns));
218
- const titles = facetTitleNodes(cells.map((cell, i)=>panelTitle(texts[i], cell, bases[i])).filter((t)=>t.text), style, viz.schema.locale);
245
+ const titles = facetTitleNodes(cells.map((cell, i)=>panelTitle(texts[i], cell, bases[i], tooltips[i])).filter((t)=>t.text), style, viz.schema.locale);
219
246
  const labels = cells.map((cell)=>panelLabels(cell, layout.outer));
220
247
  const areas = cells.map((_cell, i)=>expandArea(bases[i], expansions[labelKey(labels[i])] ?? NO_SIDES));
221
248
  const aligned = panelAlignment(viz, plan, cells, areas, labels, layout);
@@ -247,7 +274,10 @@ import { facetBodyNode, facetPanelNode, facetTitleNodes, measureFacetTitles, pre
247
274
  area,
248
275
  chartTransform: drawn.chartTransform,
249
276
  scene: drawn.scene,
250
- state: drawn.state
277
+ state: drawn.state,
278
+ ...plan.places?.[i]?.name ? {
279
+ name: plan.places[i].name
280
+ } : {}
251
281
  });
252
282
  });
253
283
  viz._chartScene = scene;
@@ -262,7 +292,12 @@ import { facetBodyNode, facetPanelNode, facetTitleNodes, measureFacetTitles, pre
262
292
  chart's filters.
263
293
  */ export function drawFacets(viz) {
264
294
  const config = resolveFacetConfig(viz.schema.facetConfig);
265
- const groups = facetGroups(viz, config.sort);
295
+ let groups = facetGroups(viz, config.sort);
296
+ const placed = config.layout && placeFacets(groups, config.layout);
297
+ if (placed) {
298
+ if (placed.missing.length) warnConfigOnce(viz, "facetLayoutMissing", `facetConfig.layout has no cell for ${missingFacetMessage(placed.missing.map((g)=>g.value))}; those panels are left out.`);
299
+ groups = placed.placed.map((p)=>p.group);
300
+ } else if (viz.schema.facetConfig?.layout) warnConfigOnce(viz, "facetLayoutUnknown", `facetConfig.layout is not a known layout ("us-states", "eu-countries", "world-regions") or a {value: [row, column]} map; panels fill rows instead.`);
266
301
  if (!groups.length || !(viz._filteredData || []).length) return false;
267
302
  const timeFilter = facetTimeFilter(viz);
268
303
  const panels = groups.map((g)=>({
@@ -303,15 +338,19 @@ import { facetBodyNode, facetPanelNode, facetTitleNodes, measureFacetTitles, pre
303
338
  height: viz.schema.height - margin.top - margin.bottom
304
339
  };
305
340
  const shared = facetScalesShared(config, hooks);
306
- const { states, zoomShapes } = drawPanels(viz, {
341
+ const plan = {
307
342
  config,
308
343
  hooks,
309
344
  panels,
310
345
  area,
311
346
  shared,
312
347
  scales: undefined,
313
- padding
314
- });
348
+ padding,
349
+ places: placed ? placed.placed.map((p)=>p.cell) : undefined
350
+ };
351
+ let drawn = drawPanels(viz, plan);
352
+ if (hooks.redraw?.(viz)) drawn = drawPanels(viz, plan);
353
+ const { states, zoomShapes } = drawn;
315
354
  viz._filteredData = all;
316
355
  viz._margin = margin;
317
356
  viz._padding = padding;
@@ -4,6 +4,7 @@
4
4
 
5
5
  @module
6
6
  */ import { fieldAccessor } from "../../utils/fieldAccessor.js";
7
+ import { resolveFacetLayout } from "./facetLayout.js";
7
8
  /** Default panel title style: smaller than the chart title, centered over its panel. */ export const FACET_TITLE_DEFAULTS = {
8
9
  fontSize: 12,
9
10
  fontWeight: 600,
@@ -34,7 +35,8 @@
34
35
  titleConfig: {
35
36
  ...FACET_TITLE_DEFAULTS,
36
37
  ...c.titleConfig ?? {}
37
- }
38
+ },
39
+ layout: resolveFacetLayout(c.layout)
38
40
  };
39
41
  }
40
42
  /** Whether `value` is an axes mode. */ const isAxesMode = (value)=>value === "outer" || value === "all";
@@ -88,10 +88,18 @@ import { computeFilteredData, computeTimeFilter, dataFilter } from "../pipeline/
88
88
  /** The time filter every panel shares (see `facetFilteredData`). */ export function facetTimeFilter(viz) {
89
89
  return computeTimeFilter(viz);
90
90
  }
91
- /** A panel's default title: its facet value, with dates formatted against every panel's date. */ export function formatFacetValue(value, values) {
91
+ /**
92
+ A panel's default title: its facet value, with dates formatted against
93
+ every panel's date.
94
+ @param value The panel's facet value.
95
+ @param values Every panel's facet value.
96
+ @param utc Write dates in UTC instead of local time (see `chartUtc`).
97
+ */ export function formatFacetValue(value, values, utc = false) {
92
98
  if (value instanceof Date) {
93
99
  const dates = values.filter((v)=>v instanceof Date).sort((a, b)=>+a - +b);
94
- return formatDate(value, dates);
100
+ return formatDate(value, dates, {
101
+ utc
102
+ });
95
103
  }
96
104
  return `${value}`;
97
105
  }
@@ -2,7 +2,8 @@
2
2
  Small multiples: the panel grid. Pure layout math — no chart state.
3
3
 
4
4
  @module
5
- */ /**
5
+ */ import { layoutGridCells } from "./facetLayout.js";
6
+ /**
6
7
  How large a chart of `aspect` can draw in a `width` × `height` box: the
7
8
  area of the biggest `aspect`-shaped rect that fits.
8
9
  */ export function fittedArea(width, height, aspect) {
@@ -70,7 +71,10 @@
70
71
  edge (those with no panel below them) are deepened by `gutter.bottom`, so
71
72
  panels that draw axis labels the others skip keep the same plot area. A
72
73
  bottom-edge panel above an empty cell reaches into that cell's space.
74
+ With `places`, lays the panels out on that map-shaped grid instead (see
75
+ `layoutGridCells`).
73
76
  */ export function facetGrid(count, area, opts) {
77
+ if (opts.places && opts.grid) return layoutGridCells(opts.places, opts.grid, area, opts);
74
78
  const { columns, rows } = facetDimensions(count, area, opts);
75
79
  if (!columns) return [];
76
80
  const gutter = opts.gutter ?? {
@@ -39,14 +39,15 @@
39
39
  }
40
40
  /**
41
41
  How far each label combination's plot insets (measured from probe panels,
42
- keyed by `labelKey`) exceed the `baseline` panel's, per side, never
43
- negative. The baseline is the bare panel, or, when an axis is labeled on
44
- every panel, the panel labeling that axis alone.
42
+ keyed by `labelKey`) exceed the `baseline` panel's (or `bareInsets`, when
43
+ given), per side, never negative. The baseline is the bare panel, or,
44
+ when an axis is labeled on every panel, the panel labeling that axis
45
+ alone.
45
46
  */ export function labelExpansions(insets, baseline = {
46
47
  x: false,
47
48
  y: false
48
- }) {
49
- const bare = insets[labelKey(baseline)] ?? NO_SIDES;
49
+ }, bareInsets) {
50
+ const bare = bareInsets ?? insets[labelKey(baseline)] ?? NO_SIDES;
50
51
  const out = {};
51
52
  for (const [key, sides] of Object.entries(insets)){
52
53
  out[key] = {
@@ -58,6 +59,33 @@
58
59
  }
59
60
  return out;
60
61
  }
62
+ /** The most two sides' amounts differ by, on any side. */ const sidesApart = (a, b)=>Math.max(Math.abs(a.top - b.top), Math.abs(a.right - b.right), Math.abs(a.bottom - b.bottom), Math.abs(a.left - b.left));
63
+ /**
64
+ The room a label combination takes once its panel draws in the area
65
+ that room grows it to: starting from `room` (measured in the base
66
+ area), measures the panel's insets in the area grown by it (`measure`)
67
+ and takes how far they exceed a bare panel's (`bare`) as the new room,
68
+ until it moves less than half a pixel, or after `passes` measures.
69
+ @param room The room measured in the base area.
70
+ @param bare A bare panel's insets.
71
+ @param measure The panel's insets in its base area grown by some room.
72
+ @param passes The most measures to take.
73
+ */ export function settleExpansion(room, bare, measure, passes = 3) {
74
+ let current = room;
75
+ for(let pass = 0; pass < passes; pass++){
76
+ if (sidesApart(current, NO_SIDES) === 0) return current;
77
+ const [next] = Object.values(labelExpansions({
78
+ k: measure(current)
79
+ }, {
80
+ x: false,
81
+ y: false
82
+ }, bare));
83
+ const settled = sidesApart(next, current) < 0.5;
84
+ current = next;
85
+ if (settled) break;
86
+ }
87
+ return current;
88
+ }
61
89
  /**
62
90
  The room the grid reserves on its outer edges: the y-labeled panels'
63
91
  extra room on the left, the x-labeled panels' on the bottom, and the most
@@ -75,9 +103,10 @@
75
103
  }
76
104
  /**
77
105
  A panel's base area, the same size for every panel: its cell below the
78
- title band, less the gutter the grid added to the cell's outer edges.
106
+ title band, less the gutter the grid added to the cell's outer edges
107
+ (its left and bottom edges, and the grid's last column).
79
108
  */ export function panelBase(cell, titleHeight, gutter, columns) {
80
- const left = cell.column === 0 ? gutter.left : 0;
109
+ const left = cell.edges.left ? gutter.left : 0;
81
110
  const right = cell.column === columns - 1 ? gutter.right : 0;
82
111
  const top = titleHeight + gutter.top;
83
112
  const bottom = cell.edges.bottom ? gutter.bottom : 0;
@@ -0,0 +1,136 @@
1
+ /**
2
+ Small multiples on a map-shaped grid (`facetConfig.layout`): placing
3
+ each facet value in its cell, and laying the cells out, with empty cells
4
+ left empty. Pure layout math, no chart state.
5
+
6
+ @module
7
+ */ import { FACET_LAYOUTS } from "./facetLayouts.js";
8
+ /** Whether `v` is a whole number of at least 0. */ const isPlace = (v)=>typeof v === "number" && Number.isInteger(v) && v >= 0;
9
+ /**
10
+ The cells a `layout` setting describes: a named layout's, or one cell
11
+ per entry of a `{[value]: [row, column]}` map (its value as the code).
12
+ Undefined for anything else, including a name no layout has.
13
+ */ export function resolveFacetLayout(layout) {
14
+ if (typeof layout === "string") return FACET_LAYOUTS[layout];
15
+ if (!layout || typeof layout !== "object" || Array.isArray(layout)) return undefined;
16
+ const out = [];
17
+ for (const [code, place] of Object.entries(layout)){
18
+ if (!Array.isArray(place)) continue;
19
+ const [row, column] = place;
20
+ if (isPlace(row) && isPlace(column)) out.push({
21
+ code,
22
+ row,
23
+ column
24
+ });
25
+ }
26
+ return out.length ? out : undefined;
27
+ }
28
+ /** A value as the text a layout matches it by: trimmed and lower-cased. */ const matchKey = (value)=>`${value}`.trim().toLowerCase();
29
+ /**
30
+ Finds a facet value's cell: the cell whose code, name, or alias it
31
+ equals, ignoring case and surrounding space.
32
+ */ export function layoutMatcher(cells) {
33
+ const index = new Map();
34
+ for (const cell of cells)for (const name of [
35
+ cell.code,
36
+ cell.name,
37
+ ...cell.aliases ?? []
38
+ ])if (name !== undefined && !index.has(matchKey(name))) index.set(matchKey(name), cell);
39
+ return (value)=>index.get(matchKey(value));
40
+ }
41
+ /**
42
+ Places each group in its cell, in the order given. Groups whose value no
43
+ cell matches, and groups whose cell an earlier group took, are left out
44
+ and returned as `missing`.
45
+ */ export function placeFacets(groups, cells) {
46
+ const match = layoutMatcher(cells);
47
+ const taken = new Set();
48
+ const placed = [];
49
+ const missing = [];
50
+ for (const group of groups){
51
+ const cell = match(group.value);
52
+ if (!cell || taken.has(cell)) missing.push(group);
53
+ else {
54
+ taken.add(cell);
55
+ placed.push({
56
+ group,
57
+ cell
58
+ });
59
+ }
60
+ }
61
+ return {
62
+ placed,
63
+ missing
64
+ };
65
+ }
66
+ /** The grid's row and column counts: enough for every cell of the layout. */ export function layoutDimensions(cells) {
67
+ return {
68
+ rows: Math.max(0, ...cells.map((c)=>c.row + 1)),
69
+ columns: Math.max(0, ...cells.map((c)=>c.column + 1))
70
+ };
71
+ }
72
+ /**
73
+ Lays panels out on a map-shaped grid: panel `i` in the cell at
74
+ `places[i]`, every cell the same size, empty cells left empty. A panel
75
+ with no panel directly to its left or below it is on that edge: it is
76
+ widened by `gutter.left`, or deepened by `gutter.bottom`, reaching into
77
+ the empty cell beside it (or the grid's gutter) for the axis labels only
78
+ edge panels draw. The rightmost column is widened by `gutter.right`.
79
+ @param places Each panel's row and column.
80
+ @param grid The grid's row and column counts (see `layoutDimensions`).
81
+ @param area The box the grid fills.
82
+ @param opts The padding and gutters (see `facetGrid`).
83
+ */ export function layoutGridCells(places, grid, area, opts) {
84
+ const { rows, columns } = grid;
85
+ if (!rows || !columns) return [];
86
+ const gutter = opts.gutter ?? {
87
+ left: 0,
88
+ right: 0,
89
+ bottom: 0
90
+ };
91
+ const pad = opts.padding, padX = opts.columnPadding ?? pad;
92
+ const cellW = Math.max(0, (area.width - gutter.left - gutter.right - (columns - 1) * padX) / columns);
93
+ const cellH = Math.max(0, (area.height - gutter.bottom - (rows - 1) * pad) / rows);
94
+ const filled = new Set(places.map((p)=>`${p.row},${p.column}`));
95
+ const has = (row, column)=>filled.has(`${row},${column}`);
96
+ return places.map(({ row, column }, index)=>{
97
+ const edges = {
98
+ top: !has(row - 1, column),
99
+ right: !has(row, column + 1),
100
+ bottom: !has(row + 1, column),
101
+ left: !has(row, column - 1)
102
+ };
103
+ const x = area.x + gutter.left + column * (cellW + padX);
104
+ return {
105
+ index,
106
+ row,
107
+ column,
108
+ x: edges.left ? x - gutter.left : x,
109
+ y: area.y + row * (cellH + pad),
110
+ width: cellW + (edges.left ? gutter.left : 0) + (column === columns - 1 ? gutter.right : 0),
111
+ height: cellH + (edges.bottom ? gutter.bottom : 0),
112
+ edges
113
+ };
114
+ });
115
+ }
116
+ /**
117
+ Each placed panel's title: its cell's short code (`"CA"`), or what
118
+ `facetConfig.title` returns, or nothing with titles off.
119
+ */ export function layoutTitleTexts(config, panels, places) {
120
+ const { title } = config;
121
+ return panels.map((p, i)=>title === false ? "" : title ? `${title(p.value, p.data)}` : places[i]?.code ?? "");
122
+ }
123
+ /** What hovering each panel's title shows: its place's full name, unless the title already reads it. */ export function layoutTitleTooltips(texts, places) {
124
+ return texts.map((text, i)=>{
125
+ const name = places[i]?.name;
126
+ return text && name && name !== text ? name : undefined;
127
+ });
128
+ }
129
+ /**
130
+ The values left out of a map-shaped grid, for a warning: up to `limit`
131
+ of them, then how many more.
132
+ */ export function missingFacetMessage(values, limit = 5) {
133
+ const shown = values.slice(0, limit).map((v)=>`"${v}"`);
134
+ const more = values.length - shown.length;
135
+ return `${shown.join(", ")}${more > 0 ? ` and ${more} more` : ""}`;
136
+ }