@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
@@ -9,18 +9,42 @@ import { accessor, BaseClass, paintComponentScene } from "../../utils/index.js";
9
9
  import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
10
10
  import { inkText } from "../../utils/themeInk.js";
11
11
  import Legend from "../Legend/Legend.js";
12
+ import { inertAxis } from "../Axis/axisTooltipTargets.js";
12
13
  import { formatYear, isYearLike } from "../Axis/yearValues.js";
13
14
  import { bucketBounds, labelValue } from "./bucketBounds.js";
14
15
  import { computeColorScale } from "./colorScaleScale.js";
15
16
  import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
16
17
  import { isBucketScale } from "./colorScaleType.js";
17
18
  import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
19
+ import { swatchTooltips } from "./colorScaleSwatchTooltips.js";
20
+ import { renderBivariate } from "./bivariateRender.js";
18
21
  /** ColorScale's fluent accessor schema. Config storage lives on `this.schema.<key>`. */ const colorScaleSchema = [
19
22
  {
20
23
  key: "align",
21
24
  coerce: "identity",
22
25
  default: "middle"
23
26
  },
27
+ // A bivariate scale reads a pair of values from each row and draws its
28
+ // grid of colors as a diamond key (see bivariateRender.ts).
29
+ {
30
+ key: "bivariate",
31
+ coerce: "identity",
32
+ default: false
33
+ },
34
+ {
35
+ key: "bivariateBuckets",
36
+ coerce: "identity",
37
+ default: 3
38
+ },
39
+ // No default grid: an unset one paints Stevens' blue–red scheme.
40
+ {
41
+ key: "bivariateColors",
42
+ coerce: "identity"
43
+ },
44
+ {
45
+ key: "bivariateLabels",
46
+ coerce: "identity"
47
+ },
24
48
  {
25
49
  key: "buckets",
26
50
  coerce: "identity",
@@ -158,7 +182,10 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
158
182
  _rectClass;
159
183
  /** The scale the last render built, with a `scale` function resolved. */ _scaleType = "linear";
160
184
  /** Where the color bar sits, set when the bar variant renders (see colorScaleHoverMark). */ _barGeometry;
161
- /** The value marked on the scale, set with `hover()`. */ _hoverValue;
185
+ /** The value marked on the scale, set with `hover()`: a pair of values on a bivariate scale. */ _hoverValue;
186
+ /** The names a chart gives a bivariate scale's two variables (its field names), under `bivariateLabels`. */ _bivariateFields;
187
+ /** The bivariate key's nodes, laid out by the last render. */ _bivariateNodes;
188
+ /** Each swatch's legend row, with its bucket, set when the swatch variant renders. */ _swatchBuckets = new Map();
162
189
  /** Smooth-gradient fill token (`gradient:<json>`), set by renderGradientStops. */ _gradientFill;
163
190
  // Standalone scene renderer (used when rendered on its own, not inside a
164
191
  // Viz). Reused across re-renders by paintComponentScene().
@@ -191,6 +218,8 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
191
218
  fontSize: 12
192
219
  };
193
220
  this._legendClass = new Legend();
221
+ // Swatch labels that don't fit whole are cut short, not left out.
222
+ this._legendClass._cutLabels = true;
194
223
  this.schema.legendConfig = {
195
224
  shapeConfig: {
196
225
  stroke: ()=>this.schema.colorDefaults.dark,
@@ -208,6 +237,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
208
237
  stroke: "#999",
209
238
  strokeWidth: 1
210
239
  };
240
+ this._constructed(new.target, ColorScale);
211
241
  }
212
242
  /**
213
243
  Renders the current ColorScale to the page.
@@ -222,8 +252,10 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
222
252
  this._group = elem("g.d3plus-ColorScale", {
223
253
  parent: this._select
224
254
  });
225
- const compute = computeColorScale(this);
226
- const gradient = this.schema.bucketAxis || !isBucketScale(compute.scale);
255
+ const bivariate = Boolean(this.schema.bivariate);
256
+ this._bivariateNodes = bivariate ? renderBivariate(this).nodes : undefined;
257
+ const compute = bivariate ? undefined : computeColorScale(this);
258
+ const gradient = !bivariate && (this.schema.bucketAxis || !isBucketScale(compute.scale));
227
259
  const t = transition().duration(this.schema.duration);
228
260
  const groupParams = {
229
261
  enter: {
@@ -245,7 +277,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
245
277
  condition: gradient
246
278
  }, groupParams));
247
279
  const legendGroup = elem("g.d3plus-ColorScale-legend", Object.assign({
248
- condition: !gradient
280
+ condition: !gradient && !bivariate
249
281
  }, groupParams));
250
282
  const groups = {
251
283
  labelGroup,
@@ -254,8 +286,10 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
254
286
  groupParams,
255
287
  gradient
256
288
  };
257
- if (gradient) renderGradient(this, compute, groups);
258
- else renderLegendVariant(this, compute, groups);
289
+ if (compute) {
290
+ if (gradient) renderGradient(this, compute, groups);
291
+ else renderLegendVariant(this, compute, groups);
292
+ }
259
293
  // Standalone render: paint the scene into the user's `_select`. Inside a
260
294
  // Viz the color scale runs in compute mode and the Viz composes its
261
295
  // toScene().
@@ -266,10 +300,13 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
266
300
  /**
267
301
  Produces a backend-agnostic scene graph for this ColorScale with no DOM
268
302
  dependency. The discrete variant (jenks/buckets/quantile) delegates to the
269
- internal Legend's toScene(); the gradient variant composes the Rect, Axis,
270
- and label TextBox scenes. The scaleGroup's translate (set by the chart's
271
- colorScale feature on `g.d3plus-viz-colorScale`) is read off `_select` so
272
- the content lands at its on-screen position.
303
+ internal Legend's toScene(), its title and swatch labels taking the axis
304
+ tooltips (see `swatchTooltips`); the gradient variant composes the Rect,
305
+ Axis, and label TextBox scenes, all as chrome (see `inertAxis`): only an
306
+ axis label with a tooltip takes the pointer. The scaleGroup's
307
+ translate (set by the chart's colorScale feature on
308
+ `g.d3plus-viz-colorScale`) is read off `_select` so the content lands at
309
+ its on-screen position.
273
310
 
274
311
  A smooth (non-bucketed) gradient paints its Rect with a `gradient:<json>`
275
312
  fill token (see renderGradientStops); the backend materializes it into a
@@ -278,18 +315,26 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
278
315
  */ toScene() {
279
316
  const children = [];
280
317
  const gradient = this.schema.bucketAxis || !isBucketScale(this._scaleType);
281
- const pushScene = (cls)=>{
318
+ const pushScene = (cls, finish = (scene)=>scene)=>{
282
319
  if (cls && typeof cls.toScene === "function") {
283
320
  const s = cls.toScene();
284
- if (s) children.push(s);
321
+ if (s) children.push(finish(s));
285
322
  }
286
323
  };
287
- if (gradient) {
288
- pushScene(this._rectClass);
289
- pushScene(this._axisClass);
290
- pushScene(this._labelClass);
324
+ if (this._bivariateNodes) {
325
+ children.push(...this._bivariateNodes);
326
+ } else if (gradient) {
327
+ pushScene(this._rectClass, inertAxis);
328
+ pushScene(this._axisClass, inertAxis);
329
+ pushScene(this._labelClass, inertAxis);
291
330
  } else {
292
- pushScene(this._legendClass);
331
+ pushScene(this._legendClass, (scene)=>swatchTooltips(scene, {
332
+ title: this._legendClass.schema.title,
333
+ titleDatum: this._legendClass._titleClass.data()[0],
334
+ titleTooltip: this.schema.axisConfig.titleTooltip,
335
+ tickTooltip: this.schema.axisConfig.tickTooltip,
336
+ buckets: this._swatchBuckets
337
+ }));
293
338
  }
294
339
  // Preserve the placement of the scaleGroup the chart's colorScale feature
295
340
  // positioned (translate on `g.d3plus-viz-colorScale`).
@@ -313,7 +358,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
313
358
  } : {},
314
359
  children
315
360
  };
316
- addHoverMark(this, group);
361
+ if (!this._bivariateNodes) addHoverMark(this, group);
317
362
  return group;
318
363
  }
319
364
  axisConfig(_) {
@@ -0,0 +1,353 @@
1
+ /**
2
+ The bivariate ColorScale's key: its grid of colors turned 45° into a
3
+ diamond, low/low at the bottom corner and high/high at the top, the first
4
+ variable rising toward the right corner and the second toward the left,
5
+ each named along its lower edge.
6
+ */ import { textWidth } from "@d3plus/dom";
7
+ import { formatAbbreviate } from "@d3plus/format";
8
+ import { fontFamilyStringify, textWrap } from "@d3plus/text";
9
+ import { formatYear, isYearLike } from "../Axis/yearValues.js";
10
+ import { bivariateBucketCount, bivariatePalette, bivariateScale, isBivariatePair } from "./bivariateScale.js";
11
+ /** The side of the key's grid before it turns, in pixels, when it fits. */ const GRID_SIDE = 80;
12
+ /** The gap between the diamond's edge and its labels. */ const LABEL_GAP = 4;
13
+ /** Grid point `(u, v)` (`u` along the first variable, `v` the second) turned into the diamond, low/low at the origin. */ function toDiamond(u, v) {
14
+ return [
15
+ (u - v) * Math.SQRT1_2,
16
+ -(u + v) * Math.SQRT1_2
17
+ ];
18
+ }
19
+ /**
20
+ The names the key gives its two variables: `bivariateLabels`, else the
21
+ names the chart passes (its field names).
22
+ @param cs The ColorScale.
23
+ */ export function bivariateAxisLabels(cs) {
24
+ const own = cs.schema.bivariateLabels;
25
+ const fields = cs._bivariateFields ?? [];
26
+ const pick = (k)=>{
27
+ const label = Array.isArray(own) ? own[k] : undefined;
28
+ const value = label ?? fields[k];
29
+ return value === undefined || value === null ? "" : `${value}`;
30
+ };
31
+ return [
32
+ pick(0),
33
+ pick(1)
34
+ ];
35
+ }
36
+ /**
37
+ How a ColorScale's values read in a bivariate key's ranges and in a
38
+ chart's tooltip: `axisConfig.tickFormat`, else a variable whose values
39
+ all read as years as years, else abbreviated (`formatAbbreviate`).
40
+ @param cs The ColorScale.
41
+ @param values The variable's values.
42
+ */ export function colorScaleValueFormat(cs, values) {
43
+ const tickFormat = cs.schema.axisConfig?.tickFormat;
44
+ if (tickFormat) return tickFormat;
45
+ if (values.length && isYearLike(values)) return (v)=>formatYear(v, cs.schema.locale);
46
+ return (v)=>formatAbbreviate(v, cs.schema.locale);
47
+ }
48
+ /** A bin's range as text (`"lo - hi"`, or one value), or "" for an empty bin. */ function rangeText(cs, bins, b, format) {
49
+ const range = bins.ranges[b];
50
+ if (!range) return "";
51
+ return cs.schema.bucketJoiner(format(range[0]), format(range[1]));
52
+ }
53
+ /** A cell's title: each variable's name and the range of its bin. */ function cellTitle(cs, scale, [i, j], labels, formats) {
54
+ return [
55
+ [
56
+ labels[0],
57
+ rangeText(cs, scale.x, i, formats[0])
58
+ ],
59
+ [
60
+ labels[1],
61
+ rangeText(cs, scale.y, j, formats[1])
62
+ ]
63
+ ].filter(([, range])=>range).map(([label, range])=>label ? `${label}: ${range}` : range).join(", ");
64
+ }
65
+ /** The label font the key reads off `labelConfig`, for `text`. */ function labelFont(cs, text) {
66
+ const read = (key)=>{
67
+ const v = cs._labelClass[key]();
68
+ return typeof v === "function" ? v(text, 0) : v;
69
+ };
70
+ const family = read("fontFamily");
71
+ return {
72
+ family: fontFamilyStringify(family),
73
+ size: Number(read("fontSize")) || 12,
74
+ weight: read("fontWeight") ?? 400,
75
+ color: `${read("fontColor")}`
76
+ };
77
+ }
78
+ /**
79
+ One variable's name along its lower edge of the diamond: up to two lines
80
+ as long as the edge, an arrow pointing the way the variable rises.
81
+ */ function edgeLabel(cs, text, axis, side) {
82
+ if (!text) return null;
83
+ const font = labelFont(cs, text);
84
+ const style = {
85
+ "font-family": font.family,
86
+ "font-size": font.size,
87
+ "font-weight": font.weight
88
+ };
89
+ const arrow = axis === 0 ? " →" : "← ";
90
+ const arrowWidth = textWidth(arrow, style);
91
+ // Lines as long as the edge, never splitting a word.
92
+ const widest = Math.max(...text.split(/\s+/).map((word)=>textWidth(word, style)));
93
+ const wrapped = textWrap().fontFamily(font.family).fontSize(font.size).fontWeight(font.weight).lineHeight(font.size * 1.2).maxLines(2)// Whole words only: no hyphenating a long one across the lines.
94
+ .split((sentence)=>sentence.match(/\S+\s*/g) ?? []).width(Math.max(side - arrowWidth, widest + 1)).height(font.size * 1.2 * 2 + 1)(text);
95
+ const lines = wrapped.lines.length ? wrapped.lines.slice() : [
96
+ text
97
+ ];
98
+ // The arrow rides the line nearest the far corner: the first variable's
99
+ // reads toward its corner at the end of the last line, the second's
100
+ // toward its corner at the start of the first.
101
+ if (axis === 0) lines[lines.length - 1] += arrow;
102
+ else lines[0] = arrow + lines[0];
103
+ const lineHeight = font.size * 1.2;
104
+ const widths = lines.map((l)=>textWidth(l, style));
105
+ const width = Math.max(...widths);
106
+ // The edge's direction (x) and outward normal (y) the label's lines lie
107
+ // along, and the label's center: the edge's midpoint, or, for a label
108
+ // longer than the edge, past it toward the far corner, so the two labels
109
+ // never meet below the bottom corner.
110
+ const rotate = axis === 0 ? -45 : 45;
111
+ const ex = axis === 0 ? [
112
+ Math.SQRT1_2,
113
+ -Math.SQRT1_2
114
+ ] : [
115
+ Math.SQRT1_2,
116
+ Math.SQRT1_2
117
+ ];
118
+ const shift = (axis === 0 ? 1 : -1) * Math.max(0, width - side) / 2;
119
+ const [ox, oy] = axis === 0 ? toDiamond(side / 2, 0) : toDiamond(0, side / 2);
120
+ const mx = ox + ex[0] * shift;
121
+ const my = oy + ex[1] * shift;
122
+ const ey = axis === 0 ? [
123
+ Math.SQRT1_2,
124
+ Math.SQRT1_2
125
+ ] : [
126
+ -Math.SQRT1_2,
127
+ Math.SQRT1_2
128
+ ];
129
+ const depth = LABEL_GAP + lineHeight * lines.length;
130
+ const corners = [
131
+ [
132
+ -width / 2,
133
+ LABEL_GAP
134
+ ],
135
+ [
136
+ width / 2,
137
+ LABEL_GAP
138
+ ],
139
+ [
140
+ -width / 2,
141
+ depth
142
+ ],
143
+ [
144
+ width / 2,
145
+ depth
146
+ ]
147
+ ].map(([lx, ly])=>[
148
+ mx + ex[0] * lx + ey[0] * ly,
149
+ my + ex[1] * lx + ey[1] * ly
150
+ ]);
151
+ const node = {
152
+ type: "text",
153
+ key: `bivariate-label-${axis}`,
154
+ x: 0,
155
+ y: 0,
156
+ transform: {
157
+ x: mx,
158
+ y: my,
159
+ rotate
160
+ },
161
+ lines: lines.map((line, k)=>({
162
+ text: line,
163
+ x: 0,
164
+ y: LABEL_GAP + lineHeight * (k + 0.5),
165
+ width: widths[k]
166
+ })),
167
+ font: {
168
+ family: font.family,
169
+ size: font.size,
170
+ weight: font.weight,
171
+ anchor: "middle",
172
+ baseline: "middle"
173
+ },
174
+ paint: {
175
+ fill: font.color
176
+ },
177
+ interactive: false,
178
+ aria: {
179
+ hidden: true
180
+ }
181
+ };
182
+ return {
183
+ node,
184
+ corners
185
+ };
186
+ }
187
+ /**
188
+ A key cell's stroke: the one `legendConfig.shapeConfig` gives the
189
+ colorScale's swatches, which a chart sets to its own shapes' stroke.
190
+ */ function cellStroke(cs, datum, i) {
191
+ const sc = cs.schema.legendConfig?.shapeConfig ?? {};
192
+ const read = (key)=>{
193
+ const v = sc[key];
194
+ return typeof v === "function" ? v(datum, i) : v;
195
+ };
196
+ const stroke = read("stroke");
197
+ const strokeWidth = Number(read("strokeWidth"));
198
+ const strokeOpacity = read("strokeOpacity");
199
+ if (typeof stroke !== "string" || !stroke || !(strokeWidth > 0)) return {};
200
+ return {
201
+ stroke,
202
+ strokeWidth,
203
+ ...typeof strokeOpacity === "number" ? {
204
+ strokeOpacity
205
+ } : {}
206
+ };
207
+ }
208
+ /** The key's cells, a path each, and their corners. */ function cellNodes(cs, scale, side) {
209
+ const n = scale.size;
210
+ const step = side / n;
211
+ const labels = bivariateAxisLabels(cs);
212
+ const values = (bins)=>scale.domain().map((p)=>p[bins]);
213
+ const formats = [
214
+ colorScaleValueFormat(cs, values(0)),
215
+ colorScaleValueFormat(cs, values(1))
216
+ ];
217
+ const nodes = [];
218
+ for(let j = 0; j < n; j++)for(let i = 0; i < n; i++){
219
+ const points = [
220
+ toDiamond(i * step, j * step),
221
+ toDiamond((i + 1) * step, j * step),
222
+ toDiamond((i + 1) * step, (j + 1) * step),
223
+ toDiamond(i * step, (j + 1) * step)
224
+ ];
225
+ const datum = {
226
+ color: scale.colors[j * n + i],
227
+ id: cellTitle(cs, scale, [
228
+ i,
229
+ j
230
+ ], labels, formats),
231
+ _isColorScaleBucket: true,
232
+ _bivariateX: i,
233
+ _bivariateY: j
234
+ };
235
+ nodes.push({
236
+ type: "path",
237
+ key: `bivariate-cell-${i}-${j}`,
238
+ d: `M${points.map((p)=>p.map((v)=>+v.toFixed(3)).join(",")).join("L")}Z`,
239
+ datum,
240
+ index: j * n + i,
241
+ paint: {
242
+ fill: datum.color,
243
+ ...cellStroke(cs, datum, j * n + i)
244
+ },
245
+ aria: {
246
+ label: datum.id
247
+ }
248
+ });
249
+ }
250
+ return {
251
+ nodes,
252
+ corners: [
253
+ toDiamond(0, 0),
254
+ toDiamond(side, 0),
255
+ toDiamond(0, side),
256
+ toDiamond(side, side)
257
+ ]
258
+ };
259
+ }
260
+ /** Lays the key out with a grid `side` pixels across, low/low corner at the origin. */ function layoutAt(cs, scale, side) {
261
+ const cells = cellNodes(cs, scale, side);
262
+ const labels = bivariateAxisLabels(cs);
263
+ const edges = [
264
+ edgeLabel(cs, labels[0], 0, side),
265
+ edgeLabel(cs, labels[1], 1, side)
266
+ ].filter(Boolean);
267
+ const corners = cells.corners.concat(...edges.map((e)=>e.corners));
268
+ const xs = corners.map((c)=>c[0]);
269
+ const ys = corners.map((c)=>c[1]);
270
+ const x = Math.min(...xs);
271
+ const y = Math.min(...ys);
272
+ return {
273
+ nodes: [
274
+ ...cells.nodes,
275
+ ...edges.map((e)=>e.node)
276
+ ],
277
+ bounds: {
278
+ x,
279
+ y,
280
+ width: Math.max(...xs) - x,
281
+ height: Math.max(...ys) - y
282
+ }
283
+ };
284
+ }
285
+ /**
286
+ Lays the key out within the ColorScale's `width` × `height`: its grid
287
+ shrinks from its full size to fit, and it sits along the side its labels
288
+ face (`orient`) at its `align`ment, as the swatch legend does.
289
+ @param cs The ColorScale.
290
+ @param scale Its bivariate scale.
291
+ */ export function layoutBivariate(cs, scale) {
292
+ const width = Number(cs.schema.width) || 0;
293
+ const height = Number(cs.schema.height) || 0;
294
+ let side = GRID_SIDE;
295
+ let layout = layoutAt(cs, scale, side);
296
+ // Labels keep their size as the grid shrinks (and may wrap anew): shrink
297
+ // the grid by what the whole key overflows until it fits, down to a third
298
+ // of its size.
299
+ for(let tries = 0; tries < 4 && side > GRID_SIDE / 3; tries++){
300
+ const over = Math.max(layout.bounds.width - width, layout.bounds.height - height);
301
+ if (over <= 0 || !width || !height) break;
302
+ side = Math.max(GRID_SIDE / 3, side - over * Math.SQRT1_2 - 1);
303
+ layout = layoutAt(cs, scale, side);
304
+ }
305
+ const horizontal = [
306
+ "bottom",
307
+ "top"
308
+ ].includes(cs.schema.orient);
309
+ const spare = (room, size)=>{
310
+ const align = cs.schema.align;
311
+ const free = Math.max(0, room - size);
312
+ return align === "start" ? 0 : align === "end" ? free : free / 2;
313
+ };
314
+ const left = horizontal ? Math.max(0, width - layout.bounds.width) / 2 : spare(width, layout.bounds.width);
315
+ const top = horizontal ? spare(height, layout.bounds.height) : Math.max(0, height - layout.bounds.height) / 2;
316
+ const dx = left - layout.bounds.x;
317
+ const dy = top - layout.bounds.y;
318
+ return {
319
+ nodes: [
320
+ {
321
+ type: "group",
322
+ key: "bivariate-key",
323
+ transform: {
324
+ x: dx,
325
+ y: dy
326
+ },
327
+ children: layout.nodes
328
+ }
329
+ ],
330
+ bounds: {
331
+ x: left,
332
+ y: top,
333
+ width: layout.bounds.width,
334
+ height: layout.bounds.height
335
+ }
336
+ };
337
+ }
338
+ /**
339
+ Builds a bivariate ColorScale's scale from its data (each row's `value`
340
+ a pair of numbers), assigns it as the ColorScale's `_colorScale`, and
341
+ lays out its diamond key.
342
+ @param cs The ColorScale.
343
+ */ export function renderBivariate(cs) {
344
+ const n = bivariateBucketCount(cs.schema.bivariateBuckets);
345
+ const pairs = cs._data.map((d, i)=>cs.schema.value(d, i)).filter(isBivariatePair);
346
+ const scale = bivariateScale(pairs, n, bivariatePalette(cs.schema.bivariateColors, n));
347
+ cs._colorScale = scale;
348
+ cs._barGeometry = undefined;
349
+ cs._labelClass.config(cs.schema.labelConfig);
350
+ const layout = layoutBivariate(cs, scale);
351
+ cs._outerBounds = layout.bounds;
352
+ return layout;
353
+ }
@@ -0,0 +1,150 @@
1
+ /**
2
+ The scale behind a bivariate ColorScale: each of two variables split into
3
+ quantile bins, and the grid of colors the pair of bins picks from.
4
+ */ import { ascending, bisectLeft, bisectRight } from "d3-array";
5
+ import { rgb } from "d3-color";
6
+ import { interpolateRgb } from "d3-interpolate";
7
+ /**
8
+ Joshua Stevens' blue–red 3×3 scheme, from "Bivariate Choropleth Maps: A
9
+ How-to Guide" (joshuastevens.net/cartography/make-a-bivariate-choropleth-map/),
10
+ with the hex values as published in the R `pals` package
11
+ (`stevens.bluered`). Row-major from the low/low corner: each row is one
12
+ bin of the second variable (low to high), each column one bin of the
13
+ first (low to high). The first variable rises toward red (#c85a5a), the
14
+ second toward blue (#64acbe), and both together toward #574249. Each
15
+ inner color is the two ramps multiplied over the shared #e8e8e8 base.
16
+ */ export const BIVARIATE_COLORS = [
17
+ "#e8e8e8",
18
+ "#e4acac",
19
+ "#c85a5a",
20
+ "#b0d5df",
21
+ "#ad9ea5",
22
+ "#985356",
23
+ "#64acbe",
24
+ "#627f8c",
25
+ "#574249"
26
+ ];
27
+ /** The fewest and most bins a bivariate ColorScale splits each variable into. */ export const BIVARIATE_MIN_BUCKETS = 2;
28
+ export const BIVARIATE_MAX_BUCKETS = 4;
29
+ /** The bins per variable when none is set. */ export const BIVARIATE_BUCKETS = 3;
30
+ /**
31
+ The number of bins per variable: `value` rounded and held within 2–4, or
32
+ 3 when it isn't a number.
33
+ @param value The configured bin count.
34
+ */ export function bivariateBucketCount(value) {
35
+ if (typeof value !== "number" || !Number.isFinite(value)) return BIVARIATE_BUCKETS;
36
+ return Math.min(BIVARIATE_MAX_BUCKETS, Math.max(BIVARIATE_MIN_BUCKETS, Math.round(value)));
37
+ }
38
+ /** The side of a square grid of `length` colors, or 0 when it isn't one of at least 2×2. */ function gridSide(length) {
39
+ const side = Math.round(Math.sqrt(length));
40
+ return side >= 2 && side * side === length ? side : 0;
41
+ }
42
+ /**
43
+ Resamples a square grid of colors (row-major, `k×k`) to `n×n`: a grid
44
+ already `n×n` is returned as given, and any other is blended
45
+ bilinearly between its nearest colors, so its corners stay put. A 3×3
46
+ scheme resampled to 4×4 keeps its corners and blends its middle colors
47
+ across the new cells; one resampled to 2×2 keeps only its corners.
48
+ @param grid The colors, row-major.
49
+ @param n The side of the grid to return.
50
+ */ export function resampleGrid(grid, n) {
51
+ const k = gridSide(grid.length);
52
+ if (!k) return [];
53
+ if (k === n) return grid.slice();
54
+ const at = (x, y)=>grid[y * k + x];
55
+ const out = [];
56
+ const position = (step)=>{
57
+ const g = n > 1 ? step * (k - 1) / (n - 1) : 0;
58
+ const lo = Math.min(k - 2, Math.floor(g));
59
+ return [
60
+ lo,
61
+ g - lo
62
+ ];
63
+ };
64
+ for(let j = 0; j < n; j++){
65
+ const [y, ty] = position(j);
66
+ for(let i = 0; i < n; i++){
67
+ const [x, tx] = position(i);
68
+ const low = interpolateRgb(at(x, y), at(x + 1, y))(tx);
69
+ const high = interpolateRgb(at(x, y + 1), at(x + 1, y + 1))(tx);
70
+ out.push(rgb(interpolateRgb(low, high)(ty)).formatHex());
71
+ }
72
+ }
73
+ return out;
74
+ }
75
+ /**
76
+ The `n×n` colors a bivariate ColorScale paints with (row-major, as
77
+ `BIVARIATE_COLORS`): `colors` when it is a square grid of at least 2×2
78
+ color strings, resampled to `n×n` (see `resampleGrid`), else Stevens'
79
+ 3×3 scheme resampled the same way.
80
+ @param colors The configured grid.
81
+ @param n The bins per variable.
82
+ */ export function bivariatePalette(colors, n) {
83
+ const valid = Array.isArray(colors) && gridSide(colors.length) > 0 && colors.every((c)=>typeof c === "string" && rgb(c).displayable());
84
+ return resampleGrid(valid ? colors : BIVARIATE_COLORS, n);
85
+ }
86
+ /**
87
+ Splits one variable's values into `n` quantile bins by rank: a value's
88
+ bin is its share of the values ranked below it (ties counted at their
89
+ middle rank), so each bin holds about as many values as the next, and
90
+ equal values always share a bin. A value outside the data ranks by
91
+ where it would sort.
92
+ @param values The variable's values (non-finite ones are ignored).
93
+ @param n The number of bins.
94
+ */ export function bivariateBins(values, n) {
95
+ const sorted = values.filter(Number.isFinite).sort(ascending);
96
+ const count = sorted.length;
97
+ const bin = (value)=>{
98
+ if (!count || !Number.isFinite(value)) return 0;
99
+ // Twice the tie group's middle rank, in whole numbers so a value right
100
+ // on a bin's edge doesn't slip below it to float error.
101
+ const ranks = bisectLeft(sorted, value) + bisectRight(sorted, value);
102
+ return Math.min(n - 1, Math.floor(ranks * n / (2 * count)));
103
+ };
104
+ const ranges = Array.from({
105
+ length: n
106
+ }, ()=>null);
107
+ for (const v of sorted){
108
+ const b = bin(v);
109
+ const range = ranges[b];
110
+ if (!range) ranges[b] = [
111
+ v,
112
+ v
113
+ ];
114
+ else range[1] = v;
115
+ }
116
+ return {
117
+ bin,
118
+ ranges
119
+ };
120
+ }
121
+ /** Whether `value` is a pair of finite numbers. */ export function isBivariatePair(value) {
122
+ return Array.isArray(value) && value.length === 2 && Number.isFinite(value[0]) && Number.isFinite(value[1]);
123
+ }
124
+ /**
125
+ Builds a bivariate color scale from the value pairs in the data: each
126
+ variable binned into `n` quantiles (see `bivariateBins`), colored from
127
+ `colors`, an `n×n` grid (see `bivariatePalette`).
128
+ @param pairs The data's value pairs.
129
+ @param n The bins per variable.
130
+ @param colors The `n×n` colors, row-major.
131
+ */ export function bivariateScale(pairs, n, colors) {
132
+ const x = bivariateBins(pairs.map((p)=>p[0]), n);
133
+ const y = bivariateBins(pairs.map((p)=>p[1]), n);
134
+ const cell = (value)=>isBivariatePair(value) ? [
135
+ x.bin(value[0]),
136
+ y.bin(value[1])
137
+ ] : null;
138
+ const scale = (value)=>{
139
+ const c = cell(value);
140
+ return c ? colors[c[1] * n + c[0]] : undefined;
141
+ };
142
+ scale.cell = cell;
143
+ scale.size = n;
144
+ scale.x = x;
145
+ scale.y = y;
146
+ scale.colors = colors;
147
+ scale.domain = ()=>pairs;
148
+ scale.range = ()=>colors;
149
+ return scale;
150
+ }