@d3plus/core 4.7.0 → 4.9.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 (963) hide show
  1. package/README.md +1 -26117
  2. package/es/index.js +1 -3
  3. package/es/internal.js +148 -7
  4. package/es/src/charts/AreaPlot/index.js +7 -10
  5. package/es/src/charts/BarChart/index.js +50 -17
  6. package/es/src/charts/Beeswarm/index.js +39 -0
  7. package/es/src/charts/BoxWhisker/index.js +6 -16
  8. package/es/src/charts/Bullet/applyLayout.js +157 -0
  9. package/es/src/charts/Bullet/bulletGeometry.js +215 -0
  10. package/es/src/charts/Bullet/bulletLayout.js +111 -0
  11. package/es/src/charts/Bullet/bulletStyle.js +44 -0
  12. package/es/src/charts/Bullet/emit.js +258 -0
  13. package/es/src/charts/Bullet/index.js +268 -0
  14. package/es/src/charts/BumpChart/index.js +21 -49
  15. package/es/src/charts/Calendar/applyLayout.js +120 -0
  16. package/es/src/charts/Calendar/calendarDates.js +151 -0
  17. package/es/src/charts/Calendar/calendarFormat.js +40 -0
  18. package/es/src/charts/Calendar/calendarGrid.js +138 -0
  19. package/es/src/charts/Calendar/calendarInset.js +22 -0
  20. package/es/src/charts/Calendar/calendarLayout.js +242 -0
  21. package/es/src/charts/Calendar/emit.js +179 -0
  22. package/es/src/charts/Calendar/index.js +206 -0
  23. package/es/src/charts/Candlestick/aggregate.js +154 -0
  24. package/es/src/charts/Candlestick/buffer.js +83 -0
  25. package/es/src/charts/Candlestick/emit.js +198 -0
  26. package/es/src/charts/Candlestick/index.js +257 -0
  27. package/es/src/charts/Candlestick/ohlc.js +114 -0
  28. package/es/src/charts/Candlestick/periods.js +191 -0
  29. package/es/src/charts/Candlestick/tooltip.js +116 -0
  30. package/es/src/charts/Candlestick/volume.js +278 -0
  31. package/es/src/charts/Chord/applyLayout.js +75 -111
  32. package/es/src/charts/Chord/emit.js +82 -173
  33. package/es/src/charts/Chord/index.js +92 -106
  34. package/es/src/charts/Donut/index.js +6 -12
  35. package/es/src/charts/Dumbbell/emit.js +106 -0
  36. package/es/src/charts/Dumbbell/gapSort.js +79 -0
  37. package/es/src/charts/Dumbbell/index.js +84 -0
  38. package/es/src/charts/FanChart/index.js +28 -0
  39. package/es/src/charts/Funnel/applyLayout.js +103 -0
  40. package/es/src/charts/Funnel/emit.js +99 -0
  41. package/es/src/charts/Funnel/funnelFacet.js +53 -0
  42. package/es/src/charts/Funnel/funnelGeometry.js +171 -0
  43. package/es/src/charts/Funnel/funnelLabels.js +118 -0
  44. package/es/src/charts/Funnel/index.js +180 -0
  45. package/es/src/charts/Funnel/labelNodes.js +202 -0
  46. package/es/src/charts/Gauge/applyLayout.js +70 -0
  47. package/es/src/charts/Gauge/dialLayout.js +106 -0
  48. package/es/src/charts/Gauge/emit.js +214 -0
  49. package/es/src/charts/Gauge/emitDial.js +167 -0
  50. package/es/src/charts/Gauge/gaugeGeometry.js +157 -0
  51. package/es/src/charts/Gauge/index.js +148 -0
  52. package/es/src/charts/Geomap/applyLayout.js +42 -73
  53. package/es/src/charts/Geomap/basemapTheme.js +16 -31
  54. package/es/src/charts/Geomap/emit.js +94 -162
  55. package/es/src/charts/Geomap/index.js +186 -193
  56. package/es/src/charts/Geomap/projections.js +37 -0
  57. package/es/src/charts/Histogram/binData.js +60 -209
  58. package/es/src/charts/Histogram/index.js +104 -137
  59. package/es/src/charts/Icicle/applyLayout.js +124 -0
  60. package/es/src/charts/Icicle/emit.js +162 -0
  61. package/es/src/charts/Icicle/enterStagger.js +55 -0
  62. package/es/src/charts/Icicle/geometry.js +101 -0
  63. package/es/src/charts/Icicle/index.js +130 -0
  64. package/es/src/charts/Icicle/interaction.js +20 -0
  65. package/es/src/charts/Icicle/labelFit.js +55 -0
  66. package/es/src/charts/Icicle/layout.js +20 -0
  67. package/es/src/charts/LinePlot/index.js +1 -9
  68. package/es/src/charts/Lollipop/emit.js +85 -0
  69. package/es/src/charts/Lollipop/index.js +97 -0
  70. package/es/src/charts/Lollipop/stemLayout.js +97 -0
  71. package/es/src/charts/Marimekko/axis.js +46 -0
  72. package/es/src/charts/Marimekko/index.js +77 -0
  73. package/es/src/charts/Matrix/applyLayout.js +22 -27
  74. package/es/src/charts/Matrix/emit.js +33 -34
  75. package/es/src/charts/Matrix/index.js +56 -80
  76. package/es/src/charts/Network/applyLayout.js +95 -172
  77. package/es/src/charts/Network/emit.js +132 -266
  78. package/es/src/charts/Network/index.js +148 -132
  79. package/es/src/charts/Pack/applyLayout.js +12 -17
  80. package/es/src/charts/Pack/emit.js +44 -106
  81. package/es/src/charts/Pack/index.js +63 -107
  82. package/es/src/charts/Pack/recursionCircles.js +2 -5
  83. package/es/src/charts/ParallelCoordinates/applyLayout.js +99 -0
  84. package/es/src/charts/ParallelCoordinates/axes.js +213 -0
  85. package/es/src/charts/ParallelCoordinates/brushDom.js +187 -0
  86. package/es/src/charts/ParallelCoordinates/brushFilter.js +79 -0
  87. package/es/src/charts/ParallelCoordinates/dimensions.js +102 -0
  88. package/es/src/charts/ParallelCoordinates/emit.js +72 -0
  89. package/es/src/charts/ParallelCoordinates/format.js +23 -0
  90. package/es/src/charts/ParallelCoordinates/index.js +190 -0
  91. package/es/src/charts/ParallelCoordinates/lineStates.js +62 -0
  92. package/es/src/charts/ParallelCoordinates/paths.js +31 -0
  93. package/es/src/charts/ParallelCoordinates/titles.js +56 -0
  94. package/es/src/charts/Pie/applyLayout.js +20 -28
  95. package/es/src/charts/Pie/emit.js +109 -219
  96. package/es/src/charts/Pie/index.js +49 -78
  97. package/es/src/charts/Plot/axisInk.js +31 -0
  98. package/es/src/charts/Plot/barConfidence.js +273 -0
  99. package/es/src/charts/Plot/barWidth.js +255 -0
  100. package/es/src/charts/Plot/baselineBreak.js +139 -0
  101. package/es/src/charts/Plot/baselineDomain.js +120 -0
  102. package/es/src/charts/Plot/columnHighlight.js +39 -0
  103. package/es/src/charts/Plot/confidenceBands.js +143 -0
  104. package/es/src/charts/Plot/confidenceConfig.js +50 -0
  105. package/es/src/charts/Plot/confidenceTooltip.js +102 -0
  106. package/es/src/charts/Plot/curveLength.js +97 -0
  107. package/es/src/charts/Plot/discreteDomain.js +19 -0
  108. package/es/src/charts/Plot/discreteSpan.js +6 -24
  109. package/es/src/charts/Plot/domainClip.js +190 -0
  110. package/es/src/charts/Plot/draw.js +164 -295
  111. package/es/src/charts/Plot/facetScales.js +27 -0
  112. package/es/src/charts/Plot/fillBetween.js +233 -0
  113. package/es/src/charts/Plot/forecast.js +211 -0
  114. package/es/src/charts/Plot/forecastScene.js +316 -0
  115. package/es/src/charts/Plot/index.js +355 -930
  116. package/es/src/charts/Plot/insetRegion.js +5 -10
  117. package/es/src/charts/Plot/labelPlacement.js +12 -14
  118. package/es/src/charts/Plot/lineBands.js +48 -0
  119. package/es/src/charts/Plot/lineCurve.js +25 -0
  120. package/es/src/charts/Plot/openDomainEnds.js +92 -0
  121. package/es/src/charts/Plot/pipeline.js +143 -480
  122. package/es/src/charts/Plot/pipelineAxisLayout.js +132 -0
  123. package/es/src/charts/Plot/pipelineDomains.js +121 -239
  124. package/es/src/charts/Plot/pipelineLineLabels.js +81 -147
  125. package/es/src/charts/Plot/pipelineScales.js +177 -0
  126. package/es/src/charts/Plot/plotBreaks.js +223 -0
  127. package/es/src/charts/Plot/plotFacet.js +172 -0
  128. package/es/src/charts/Plot/plotInit.js +252 -0
  129. package/es/src/charts/Plot/plotZoom.js +105 -206
  130. package/es/src/charts/Plot/shapeDefaults.js +66 -81
  131. package/es/src/charts/Plot/sharedHover.js +185 -308
  132. package/es/src/charts/Plot/sharedHoverScene.js +115 -157
  133. package/es/src/charts/Plot/sharedTooltip.js +96 -104
  134. package/es/src/charts/Plot/stackEnter.js +87 -0
  135. package/es/src/charts/Plot/stackHelpers.js +36 -69
  136. package/es/src/charts/Plot/stackShareLabels.js +34 -88
  137. package/es/src/charts/Plot/stackShareTooltip.js +10 -15
  138. package/es/src/charts/Plot/swarm.js +96 -0
  139. package/es/src/charts/Plot/swarmLayout.js +102 -0
  140. package/es/src/charts/Plot/trendLines.js +105 -321
  141. package/es/src/charts/Plot/trendProjection.js +27 -69
  142. package/es/src/charts/Plot/trendScene.js +27 -171
  143. package/es/src/charts/Plot/trendTooltip.js +50 -132
  144. package/es/src/charts/PolarArea/applyLayout.js +26 -0
  145. package/es/src/charts/PolarArea/emit.js +12 -0
  146. package/es/src/charts/PolarArea/index.js +183 -0
  147. package/es/src/charts/Priestley/applyLayout.js +33 -53
  148. package/es/src/charts/Priestley/emit.js +50 -111
  149. package/es/src/charts/Priestley/index.js +35 -35
  150. package/es/src/charts/Pyramid/gutter.js +208 -0
  151. package/es/src/charts/Pyramid/index.js +373 -0
  152. package/es/src/charts/Pyramid/pyramidData.js +65 -0
  153. package/es/src/charts/Pyramid/scene.js +224 -0
  154. package/es/src/charts/Pyramid/stackOrder.js +39 -0
  155. package/es/src/charts/Radar/applyLayout.js +52 -291
  156. package/es/src/charts/Radar/axisDecorations.js +200 -0
  157. package/es/src/charts/Radar/axisLabels.js +109 -0
  158. package/es/src/charts/Radar/emit.js +23 -19
  159. package/es/src/charts/Radar/index.js +64 -45
  160. package/es/src/charts/Radar/levels.js +136 -0
  161. package/es/src/charts/Radar/rings.js +72 -0
  162. package/es/src/charts/RadialBar/applyLayout.js +47 -0
  163. package/es/src/charts/RadialBar/emit.js +38 -0
  164. package/es/src/charts/RadialBar/index.js +221 -0
  165. package/es/src/charts/RadialBar/trackLayout.js +330 -0
  166. package/es/src/charts/RadialBar/tracks.js +53 -0
  167. package/es/src/charts/RadialMatrix/applyLayout.js +42 -80
  168. package/es/src/charts/RadialMatrix/emit.js +23 -23
  169. package/es/src/charts/RadialMatrix/index.js +65 -67
  170. package/es/src/charts/Ridgeline/emit.js +75 -0
  171. package/es/src/charts/Ridgeline/index.js +55 -0
  172. package/es/src/charts/Rings/applyLayout.js +124 -266
  173. package/es/src/charts/Rings/emit.js +127 -236
  174. package/es/src/charts/Rings/index.js +118 -98
  175. package/es/src/charts/Rings/ringsGraph.js +88 -0
  176. package/es/src/charts/Rings/ringsSizing.js +41 -89
  177. package/es/src/charts/Sankey/applyLayout.js +32 -60
  178. package/es/src/charts/Sankey/emit.js +94 -150
  179. package/es/src/charts/Sankey/index.js +130 -104
  180. package/es/src/charts/Sankey/sankeyLayout.js +283 -0
  181. package/es/src/charts/StackedArea/index.js +3 -10
  182. package/es/src/charts/Sunburst/applyLayout.js +116 -0
  183. package/es/src/charts/Sunburst/emit.js +181 -0
  184. package/es/src/charts/Sunburst/geometry.js +98 -0
  185. package/es/src/charts/Sunburst/index.js +168 -0
  186. package/es/src/charts/Sunburst/interaction.js +23 -0
  187. package/es/src/charts/Sunburst/labelFit.js +159 -0
  188. package/es/src/charts/Sunburst/partition.js +32 -0
  189. package/es/src/charts/Tree/applyLayout.js +78 -130
  190. package/es/src/charts/Tree/emit.js +76 -184
  191. package/es/src/charts/Tree/index.js +26 -37
  192. package/es/src/charts/Treemap/applyLayout.js +34 -57
  193. package/es/src/charts/Treemap/emit.js +57 -136
  194. package/es/src/charts/Treemap/index.js +57 -95
  195. package/es/src/charts/Treemap/thresholdFunction.js +14 -75
  196. package/es/src/charts/Violin/emit.js +80 -0
  197. package/es/src/charts/Violin/index.js +88 -0
  198. package/es/src/charts/Violin/inner.js +196 -0
  199. package/es/src/charts/Violin/violinLayout.js +80 -0
  200. package/es/src/charts/Waffle/applyLayout.js +90 -0
  201. package/es/src/charts/Waffle/emit.js +89 -0
  202. package/es/src/charts/Waffle/index.js +170 -0
  203. package/es/src/charts/Waffle/tooltip.js +37 -0
  204. package/es/src/charts/Waffle/waffleLayout.js +104 -0
  205. package/es/src/charts/Waterfall/buffer.js +65 -0
  206. package/es/src/charts/Waterfall/connectors.js +103 -0
  207. package/es/src/charts/Waterfall/index.js +211 -0
  208. package/es/src/charts/Waterfall/labels.js +82 -0
  209. package/es/src/charts/Waterfall/state.js +147 -0
  210. package/es/src/charts/Waterfall/steps.js +138 -0
  211. package/es/src/charts/definition/ChartDefinition.js +2 -4
  212. package/es/src/charts/definition/applyDefinition.js +4 -88
  213. package/es/src/charts/definition/makeChart.js +35 -141
  214. package/es/src/charts/drawSteps/backControl.js +15 -14
  215. package/es/src/charts/drawSteps/bottomRightControls.js +39 -115
  216. package/es/src/charts/drawSteps/bottomRightControlsMarkup.js +60 -174
  217. package/es/src/charts/drawSteps/controlButtonStyle.js +39 -63
  218. package/es/src/charts/drawSteps/minimap.js +82 -139
  219. package/es/src/charts/drawSteps/minimapMarkup.js +13 -93
  220. package/es/src/charts/drawSteps/searchControls.js +48 -105
  221. package/es/src/charts/drawSteps/searchControlsMarkup.js +62 -176
  222. package/es/src/charts/drawSteps/tableView.js +23 -40
  223. package/es/src/charts/drawSteps/tableViewControl.js +2 -8
  224. package/es/src/charts/drawSteps/tableViewMarkup.js +152 -233
  225. package/es/src/charts/drawSteps/topLeftControls.js +8 -28
  226. package/es/src/charts/drawSteps/topLeftControlsMarkup.js +49 -119
  227. package/es/src/charts/drawSteps/zoomControls.js +72 -145
  228. package/es/src/charts/drawSteps/zoomControlsMarkup.js +59 -124
  229. package/es/src/charts/drawSteps/zoomGesture.js +17 -0
  230. package/es/src/charts/drawSteps/zoomShown.js +40 -0
  231. package/es/src/charts/events/click.legend.js +12 -23
  232. package/es/src/charts/events/click.shape.js +6 -11
  233. package/es/src/charts/events/mouseenter.js +14 -24
  234. package/es/src/charts/events/mouseleave.js +29 -14
  235. package/es/src/charts/events/mousemove.legend.js +20 -30
  236. package/es/src/charts/events/mousemove.shape.js +12 -21
  237. package/es/src/charts/events/touchstart.body.js +0 -2
  238. package/es/src/charts/facet/drawFacets.js +332 -0
  239. package/es/src/charts/facet/facetConfig.js +72 -0
  240. package/es/src/charts/facet/facetData.js +97 -0
  241. package/es/src/charts/facet/facetGrid.js +107 -0
  242. package/es/src/charts/facet/facetGutter.js +131 -0
  243. package/es/src/charts/facet/facetPanel.js +56 -0
  244. package/es/src/charts/facet/facetScene.js +111 -0
  245. package/es/src/charts/features/attributionFeature.js +38 -38
  246. package/es/src/charts/features/axes.js +105 -304
  247. package/es/src/charts/features/axesFinal.js +134 -0
  248. package/es/src/charts/features/axesMeasure.js +138 -0
  249. package/es/src/charts/features/backgroundImageEmit.js +61 -0
  250. package/es/src/charts/features/chartGeometry.js +3 -5
  251. package/es/src/charts/features/colorScaleBucket.js +17 -21
  252. package/es/src/charts/features/edgeArrows.js +36 -70
  253. package/es/src/charts/features/emitHelpers.js +42 -137
  254. package/es/src/charts/features/ensureZoomDom.js +27 -40
  255. package/es/src/charts/features/features.js +216 -256
  256. package/es/src/charts/features/featuresColorScale.js +40 -39
  257. package/es/src/charts/features/featuresLegend.js +152 -188
  258. package/es/src/charts/features/frozenAxis.js +14 -0
  259. package/es/src/charts/features/insetState.js +25 -90
  260. package/es/src/charts/features/legendCategory.js +61 -0
  261. package/es/src/charts/features/legendLabel.js +5 -9
  262. package/es/src/charts/features/lineLabels.js +20 -87
  263. package/es/src/charts/features/plotAnnotations.js +105 -0
  264. package/es/src/charts/features/plotEndLabels.js +209 -0
  265. package/es/src/charts/features/plotPaint.js +192 -404
  266. package/es/src/charts/features/sceneBounds.js +57 -164
  267. package/es/src/charts/features/shapeEmit.js +183 -184
  268. package/es/src/charts/features/shareKey.js +32 -0
  269. package/es/src/charts/features/sharedFields.js +38 -0
  270. package/es/src/charts/features/tooltipSwatch.js +99 -42
  271. package/es/src/charts/features/xAxisConfig.js +19 -0
  272. package/es/src/charts/features/zoomExtent.js +23 -108
  273. package/es/src/charts/helpers/densityChart.js +267 -0
  274. package/es/src/charts/helpers/densityData.js +116 -0
  275. package/es/src/charts/helpers/densityEnter.js +64 -0
  276. package/es/src/charts/helpers/matrixData.js +11 -82
  277. package/es/src/charts/helpers/tileAttributions.js +1 -3
  278. package/es/src/charts/helpers/valueTitle.js +29 -0
  279. package/es/src/charts/index.js +20 -2
  280. package/es/src/charts/partition/chartFields.js +43 -0
  281. package/es/src/charts/partition/hierarchy.js +174 -0
  282. package/es/src/charts/partition/interaction.js +158 -0
  283. package/es/src/charts/partition/labelWords.js +95 -0
  284. package/es/src/charts/partition/shade.js +56 -0
  285. package/es/src/charts/partition/zoom.js +80 -0
  286. package/es/src/charts/pipeline/drillMorph.js +16 -37
  287. package/es/src/charts/pipeline/insetPlacement.js +95 -188
  288. package/es/src/charts/pipeline/preDrawData.js +74 -0
  289. package/es/src/charts/pipeline/resolveSpec.js +1 -3
  290. package/es/src/charts/pipeline/runChartDraw.js +14 -69
  291. package/es/src/charts/pipeline/runVizPipeline.js +13 -35
  292. package/es/src/charts/pipeline/stages.js +24 -61
  293. package/es/src/charts/pipeline/vizDraw.js +165 -30
  294. package/es/src/charts/pipeline/vizPreDraw.js +145 -106
  295. package/es/src/charts/plotBuffers/Bar.js +7 -108
  296. package/es/src/charts/plotBuffers/Box.js +6 -102
  297. package/es/src/charts/plotBuffers/Circle.js +11 -14
  298. package/es/src/charts/plotBuffers/Line.js +7 -13
  299. package/es/src/charts/plotBuffers/Rect.js +11 -15
  300. package/es/src/charts/plotBuffers/defaultBuffers.js +12 -0
  301. package/es/src/charts/plotBuffers/discreteBuffer.js +5 -9
  302. package/es/src/charts/plotBuffers/numericBuffer.js +24 -33
  303. package/es/src/charts/plotBuffers/rectLikeBuffer.js +39 -0
  304. package/es/src/charts/polar/chrome.js +170 -0
  305. package/es/src/charts/polar/config.js +82 -0
  306. package/es/src/charts/polar/geometry.js +92 -0
  307. package/es/src/charts/polar/labels.js +124 -0
  308. package/es/src/charts/polar/polarFacet.js +43 -0
  309. package/es/src/charts/polar/wedgeLayout.js +140 -0
  310. package/es/src/charts/viz/Viz.js +503 -991
  311. package/es/src/charts/viz/VizBase.js +260 -613
  312. package/es/src/charts/viz/backgroundInk.js +17 -0
  313. package/es/src/charts/viz/interactionOpacity.js +92 -135
  314. package/es/src/charts/viz/labelDefaults.js +61 -0
  315. package/es/src/charts/viz/linkGroup.js +63 -237
  316. package/es/src/charts/viz/ordinalColor.js +12 -44
  317. package/es/src/charts/viz/reserveContainerSize.js +49 -0
  318. package/es/src/charts/viz/resetChromeBoxes.js +41 -0
  319. package/es/src/charts/viz/sceneRows.js +7 -9
  320. package/es/src/charts/viz/shapeClassTargets.js +33 -0
  321. package/es/src/charts/viz/shapeHover.js +9 -0
  322. package/es/src/charts/viz/simpleHover.js +14 -0
  323. package/es/src/charts/viz/trailCatchup.js +28 -87
  324. package/es/src/charts/viz/vizDefaults.js +113 -385
  325. package/es/src/charts/viz/vizFields.js +197 -0
  326. package/es/src/charts/viz/vizRender.js +84 -78
  327. package/es/src/charts/viz/vizTypes.js +1 -3
  328. package/es/src/charts/viz/vizVisibility.js +32 -51
  329. package/es/src/components/Axis/Axis.js +304 -469
  330. package/es/src/components/Axis/AxisBottom.js +9 -74
  331. package/es/src/components/Axis/AxisLeft.js +9 -74
  332. package/es/src/components/Axis/AxisRight.js +9 -74
  333. package/es/src/components/Axis/AxisTop.js +9 -74
  334. package/es/src/components/Axis/axisBreak.js +243 -0
  335. package/es/src/components/Axis/axisDefaults.js +65 -0
  336. package/es/src/components/Axis/axisEndLabels.js +60 -0
  337. package/es/src/components/Axis/axisLabelThinning.js +123 -0
  338. package/es/src/components/Axis/axisLayout.js +211 -160
  339. package/es/src/components/Axis/axisLayoutLabels.js +187 -108
  340. package/es/src/components/Axis/axisLayoutScale.js +130 -247
  341. package/es/src/components/Axis/axisRender.js +82 -411
  342. package/es/src/components/Axis/axisRounding.js +68 -0
  343. package/es/src/components/Axis/axisScene.js +184 -0
  344. package/es/src/components/Axis/brokenScale.js +183 -0
  345. package/es/src/components/Axis/gridStroke.js +10 -0
  346. package/es/src/components/Axis/timeValues.js +155 -0
  347. package/es/src/components/Axis/yearValues.js +32 -0
  348. package/es/src/components/ColorScale/ColorScale.js +187 -345
  349. package/es/src/components/ColorScale/colorScaleRender.js +72 -108
  350. package/es/src/components/ColorScale/colorScaleScale.js +101 -164
  351. package/es/src/components/Legend/Legend.js +164 -352
  352. package/es/src/components/Legend/legendConfig.js +43 -55
  353. package/es/src/components/Legend/legendRender.js +61 -109
  354. package/es/src/components/Message.js +50 -98
  355. package/es/src/components/SizeLegend/SizeLegend.js +188 -330
  356. package/es/src/components/SizeLegend/sizeLegendLayout.js +65 -161
  357. package/es/src/components/TextBox.js +156 -615
  358. package/es/src/components/Timeline/Timeline.js +345 -554
  359. package/es/src/components/Timeline/timelineConfig.js +23 -56
  360. package/es/src/components/Timeline/timelineRender.js +58 -112
  361. package/es/src/components/Tooltip.js +128 -607
  362. package/es/src/components/index.js +0 -2
  363. package/es/src/components/textBoxLayout.js +230 -0
  364. package/es/src/components/tooltipDom.js +218 -0
  365. package/es/src/fluent.js +177 -203
  366. package/es/src/shapes/Area.js +128 -329
  367. package/es/src/shapes/Bar.js +92 -245
  368. package/es/src/shapes/Box.js +231 -405
  369. package/es/src/shapes/Circle.js +46 -199
  370. package/es/src/shapes/Image.js +98 -210
  371. package/es/src/shapes/Line.js +73 -251
  372. package/es/src/shapes/Path.js +34 -149
  373. package/es/src/shapes/Rect.js +57 -210
  374. package/es/src/shapes/Shape.js +328 -655
  375. package/es/src/shapes/Whisker.js +166 -371
  376. package/es/src/shapes/buildLabelData.js +31 -80
  377. package/es/src/shapes/emitLabels.js +17 -49
  378. package/es/src/shapes/hitAreaNode.js +8 -10
  379. package/es/src/shapes/index.js +0 -2
  380. package/es/src/shapes/interactionPoints.js +5 -7
  381. package/es/src/shapes/sceneSort.js +61 -161
  382. package/es/src/shapes/shapeConfig.js +0 -2
  383. package/es/src/shapes/shapeOwners.js +37 -0
  384. package/es/src/shapes/shapeStandalone.js +71 -0
  385. package/es/src/shapes/textureKey.js +11 -61
  386. package/es/src/shapes/uniqueIds.js +19 -0
  387. package/es/src/shapes/validateShapeConfig.js +23 -119
  388. package/es/src/utils/AccessorFn.js +0 -2
  389. package/es/src/utils/BaseClass.js +114 -262
  390. package/es/src/utils/D3Scale.js +0 -2
  391. package/es/src/utils/D3plusConfig.js +0 -2
  392. package/es/src/utils/RESET.js +1 -3
  393. package/es/src/utils/accessor.js +2 -8
  394. package/es/src/utils/configDefault.js +1 -3
  395. package/es/src/utils/configPrep.js +15 -35
  396. package/es/src/utils/configWarnings.js +11 -13
  397. package/es/src/utils/constant.js +0 -2
  398. package/es/src/utils/getProp.js +0 -2
  399. package/es/src/utils/index.js +0 -2
  400. package/es/src/utils/paintComponentScene.js +12 -23
  401. package/es/src/utils/wholeWords.js +44 -0
  402. package/package.json +16 -25
  403. package/types/index.d.ts +12 -4
  404. package/types/internal.d.ts +210 -12
  405. package/types/src/charts/AreaPlot/index.d.ts +2 -1
  406. package/types/src/charts/BarChart/index.d.ts +4 -2
  407. package/types/src/charts/Beeswarm/index.d.ts +15 -0
  408. package/types/src/charts/Bullet/applyLayout.d.ts +65 -0
  409. package/types/src/charts/Bullet/bulletGeometry.d.ts +91 -0
  410. package/types/src/charts/Bullet/bulletLayout.d.ts +54 -0
  411. package/types/src/charts/Bullet/bulletStyle.d.ts +33 -0
  412. package/types/src/charts/Bullet/emit.d.ts +25 -0
  413. package/types/src/charts/Bullet/index.d.ts +40 -0
  414. package/types/src/charts/Calendar/applyLayout.d.ts +37 -0
  415. package/types/src/charts/Calendar/calendarDates.d.ts +68 -0
  416. package/types/src/charts/Calendar/calendarFormat.d.ts +24 -0
  417. package/types/src/charts/Calendar/calendarGrid.d.ts +84 -0
  418. package/types/src/charts/Calendar/calendarInset.d.ts +13 -0
  419. package/types/src/charts/Calendar/calendarLayout.d.ts +84 -0
  420. package/types/src/charts/Calendar/emit.d.ts +31 -0
  421. package/types/src/charts/Calendar/index.d.ts +26 -0
  422. package/types/src/charts/Candlestick/aggregate.d.ts +91 -0
  423. package/types/src/charts/Candlestick/buffer.d.ts +37 -0
  424. package/types/src/charts/Candlestick/emit.d.ts +54 -0
  425. package/types/src/charts/Candlestick/index.d.ts +16 -0
  426. package/types/src/charts/Candlestick/ohlc.d.ts +94 -0
  427. package/types/src/charts/Candlestick/periods.d.ts +84 -0
  428. package/types/src/charts/Candlestick/tooltip.d.ts +50 -0
  429. package/types/src/charts/Candlestick/volume.d.ts +129 -0
  430. package/types/src/charts/Chord/emit.d.ts +2 -2
  431. package/types/src/charts/Dumbbell/emit.d.ts +34 -0
  432. package/types/src/charts/Dumbbell/gapSort.d.ts +47 -0
  433. package/types/src/charts/Dumbbell/index.d.ts +21 -0
  434. package/types/src/charts/FanChart/index.d.ts +17 -0
  435. package/types/src/charts/Funnel/applyLayout.d.ts +89 -0
  436. package/types/src/charts/Funnel/emit.d.ts +29 -0
  437. package/types/src/charts/Funnel/funnelFacet.d.ts +33 -0
  438. package/types/src/charts/Funnel/funnelGeometry.d.ts +78 -0
  439. package/types/src/charts/Funnel/funnelLabels.d.ts +101 -0
  440. package/types/src/charts/Funnel/index.d.ts +30 -0
  441. package/types/src/charts/Funnel/labelNodes.d.ts +57 -0
  442. package/types/src/charts/Gauge/applyLayout.d.ts +41 -0
  443. package/types/src/charts/Gauge/dialLayout.d.ts +78 -0
  444. package/types/src/charts/Gauge/emit.d.ts +22 -0
  445. package/types/src/charts/Gauge/emitDial.d.ts +41 -0
  446. package/types/src/charts/Gauge/gaugeGeometry.d.ts +89 -0
  447. package/types/src/charts/Gauge/index.d.ts +21 -0
  448. package/types/src/charts/Geomap/projections.d.ts +8 -0
  449. package/types/src/charts/Histogram/binData.d.ts +9 -1
  450. package/types/src/charts/Icicle/applyLayout.d.ts +54 -0
  451. package/types/src/charts/Icicle/emit.d.ts +20 -0
  452. package/types/src/charts/Icicle/enterStagger.d.ts +30 -0
  453. package/types/src/charts/Icicle/geometry.d.ts +72 -0
  454. package/types/src/charts/Icicle/index.d.ts +25 -0
  455. package/types/src/charts/Icicle/interaction.d.ts +16 -0
  456. package/types/src/charts/Icicle/labelFit.d.ts +37 -0
  457. package/types/src/charts/Icicle/layout.d.ts +21 -0
  458. package/types/src/charts/Lollipop/emit.d.ts +19 -0
  459. package/types/src/charts/Lollipop/index.d.ts +17 -0
  460. package/types/src/charts/Lollipop/stemLayout.d.ts +82 -0
  461. package/types/src/charts/Marimekko/axis.d.ts +27 -0
  462. package/types/src/charts/Marimekko/index.d.ts +19 -0
  463. package/types/src/charts/ParallelCoordinates/applyLayout.d.ts +27 -0
  464. package/types/src/charts/ParallelCoordinates/axes.d.ts +40 -0
  465. package/types/src/charts/ParallelCoordinates/brushDom.d.ts +47 -0
  466. package/types/src/charts/ParallelCoordinates/brushFilter.d.ts +39 -0
  467. package/types/src/charts/ParallelCoordinates/dimensions.d.ts +63 -0
  468. package/types/src/charts/ParallelCoordinates/emit.d.ts +27 -0
  469. package/types/src/charts/ParallelCoordinates/format.d.ts +13 -0
  470. package/types/src/charts/ParallelCoordinates/index.d.ts +27 -0
  471. package/types/src/charts/ParallelCoordinates/lineStates.d.ts +21 -0
  472. package/types/src/charts/ParallelCoordinates/paths.d.ts +27 -0
  473. package/types/src/charts/ParallelCoordinates/titles.d.ts +21 -0
  474. package/types/src/charts/Plot/axisInk.d.ts +8 -0
  475. package/types/src/charts/Plot/barConfidence.d.ts +120 -0
  476. package/types/src/charts/Plot/barWidth.d.ts +119 -0
  477. package/types/src/charts/Plot/baselineBreak.d.ts +52 -0
  478. package/types/src/charts/Plot/baselineDomain.d.ts +67 -0
  479. package/types/src/charts/Plot/columnHighlight.d.ts +23 -0
  480. package/types/src/charts/Plot/confidenceBands.d.ts +72 -0
  481. package/types/src/charts/Plot/confidenceConfig.d.ts +16 -0
  482. package/types/src/charts/Plot/confidenceTooltip.d.ts +70 -0
  483. package/types/src/charts/Plot/curveLength.d.ts +27 -0
  484. package/types/src/charts/Plot/discreteDomain.d.ts +14 -0
  485. package/types/src/charts/Plot/domainClip.d.ts +21 -0
  486. package/types/src/charts/Plot/facetScales.d.ts +27 -0
  487. package/types/src/charts/Plot/fillBetween.d.ts +69 -0
  488. package/types/src/charts/Plot/forecast.d.ts +102 -0
  489. package/types/src/charts/Plot/forecastScene.d.ts +88 -0
  490. package/types/src/charts/Plot/index.d.ts +24 -5
  491. package/types/src/charts/Plot/lineBands.d.ts +7 -0
  492. package/types/src/charts/Plot/lineCurve.d.ts +15 -0
  493. package/types/src/charts/Plot/openDomainEnds.d.ts +25 -0
  494. package/types/src/charts/Plot/pipeline.d.ts +5 -30
  495. package/types/src/charts/Plot/pipelineAxisLayout.d.ts +2 -0
  496. package/types/src/charts/Plot/pipelineScales.d.ts +20 -0
  497. package/types/src/charts/Plot/plotBreaks.d.ts +61 -0
  498. package/types/src/charts/Plot/plotFacet.d.ts +36 -0
  499. package/types/src/charts/Plot/plotInit.d.ts +44 -0
  500. package/types/src/charts/Plot/plotZoom.d.ts +14 -8
  501. package/types/src/charts/Plot/sharedHover.d.ts +5 -0
  502. package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -6
  503. package/types/src/charts/Plot/sharedTooltip.d.ts +13 -8
  504. package/types/src/charts/Plot/stackEnter.d.ts +42 -0
  505. package/types/src/charts/Plot/swarm.d.ts +66 -0
  506. package/types/src/charts/Plot/swarmLayout.d.ts +59 -0
  507. package/types/src/charts/PolarArea/applyLayout.d.ts +17 -0
  508. package/types/src/charts/PolarArea/emit.d.ts +3 -0
  509. package/types/src/charts/PolarArea/index.d.ts +19 -0
  510. package/types/src/charts/Pyramid/gutter.d.ts +76 -0
  511. package/types/src/charts/Pyramid/index.d.ts +19 -0
  512. package/types/src/charts/Pyramid/pyramidData.d.ts +48 -0
  513. package/types/src/charts/Pyramid/scene.d.ts +106 -0
  514. package/types/src/charts/Pyramid/stackOrder.d.ts +9 -0
  515. package/types/src/charts/Radar/applyLayout.d.ts +7 -5
  516. package/types/src/charts/Radar/axisDecorations.d.ts +67 -0
  517. package/types/src/charts/Radar/axisLabels.d.ts +79 -0
  518. package/types/src/charts/Radar/emit.d.ts +2 -2
  519. package/types/src/charts/Radar/index.d.ts +5 -1
  520. package/types/src/charts/Radar/levels.d.ts +68 -0
  521. package/types/src/charts/Radar/rings.d.ts +30 -0
  522. package/types/src/charts/RadialBar/applyLayout.d.ts +19 -0
  523. package/types/src/charts/RadialBar/emit.d.ts +6 -0
  524. package/types/src/charts/RadialBar/index.d.ts +21 -0
  525. package/types/src/charts/RadialBar/trackLayout.d.ts +46 -0
  526. package/types/src/charts/RadialBar/tracks.d.ts +32 -0
  527. package/types/src/charts/Ridgeline/emit.d.ts +11 -0
  528. package/types/src/charts/Ridgeline/index.d.ts +16 -0
  529. package/types/src/charts/Rings/index.d.ts +2 -0
  530. package/types/src/charts/Rings/ringsGraph.d.ts +72 -0
  531. package/types/src/charts/Sankey/applyLayout.d.ts +1 -1
  532. package/types/src/charts/Sankey/sankeyLayout.d.ts +57 -0
  533. package/types/src/charts/StackedArea/index.d.ts +2 -1
  534. package/types/src/charts/Sunburst/applyLayout.d.ts +67 -0
  535. package/types/src/charts/Sunburst/emit.d.ts +29 -0
  536. package/types/src/charts/Sunburst/geometry.d.ts +65 -0
  537. package/types/src/charts/Sunburst/index.d.ts +21 -0
  538. package/types/src/charts/Sunburst/interaction.d.ts +20 -0
  539. package/types/src/charts/Sunburst/labelFit.d.ts +73 -0
  540. package/types/src/charts/Sunburst/partition.d.ts +34 -0
  541. package/types/src/charts/Violin/emit.d.ts +4 -0
  542. package/types/src/charts/Violin/index.d.ts +16 -0
  543. package/types/src/charts/Violin/inner.d.ts +31 -0
  544. package/types/src/charts/Violin/violinLayout.d.ts +64 -0
  545. package/types/src/charts/Waffle/applyLayout.d.ts +36 -0
  546. package/types/src/charts/Waffle/emit.d.ts +29 -0
  547. package/types/src/charts/Waffle/index.d.ts +21 -0
  548. package/types/src/charts/Waffle/tooltip.d.ts +20 -0
  549. package/types/src/charts/Waffle/waffleLayout.d.ts +81 -0
  550. package/types/src/charts/Waterfall/buffer.d.ts +31 -0
  551. package/types/src/charts/Waterfall/connectors.d.ts +40 -0
  552. package/types/src/charts/Waterfall/index.d.ts +24 -0
  553. package/types/src/charts/Waterfall/labels.d.ts +59 -0
  554. package/types/src/charts/Waterfall/state.d.ts +62 -0
  555. package/types/src/charts/Waterfall/steps.d.ts +84 -0
  556. package/types/src/charts/definition/ChartDefinition.d.ts +28 -7
  557. package/types/src/charts/definition/makeChart.d.ts +3 -1
  558. package/types/src/charts/drawSteps/bottomRightControls.d.ts +19 -0
  559. package/types/src/charts/drawSteps/bottomRightControlsMarkup.d.ts +1 -1
  560. package/types/src/charts/drawSteps/controlButtonStyle.d.ts +21 -0
  561. package/types/src/charts/drawSteps/searchControlsMarkup.d.ts +2 -6
  562. package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +10 -2
  563. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +9 -0
  564. package/types/src/charts/drawSteps/zoomGesture.d.ts +17 -0
  565. package/types/src/charts/drawSteps/zoomShown.d.ts +32 -0
  566. package/types/src/charts/facet/drawFacets.d.ts +52 -0
  567. package/types/src/charts/facet/facetConfig.d.ts +178 -0
  568. package/types/src/charts/facet/facetData.d.ts +47 -0
  569. package/types/src/charts/facet/facetGrid.d.ts +62 -0
  570. package/types/src/charts/facet/facetGutter.d.ts +68 -0
  571. package/types/src/charts/facet/facetPanel.d.ts +24 -0
  572. package/types/src/charts/facet/facetScene.d.ts +39 -0
  573. package/types/src/charts/features/axes.d.ts +4 -89
  574. package/types/src/charts/features/axesFinal.d.ts +66 -0
  575. package/types/src/charts/features/axesMeasure.d.ts +88 -0
  576. package/types/src/charts/features/backgroundImageEmit.d.ts +32 -0
  577. package/types/src/charts/features/features.d.ts +40 -12
  578. package/types/src/charts/features/featuresLegend.d.ts +10 -2
  579. package/types/src/charts/features/frozenAxis.d.ts +8 -0
  580. package/types/src/charts/features/insetState.d.ts +3 -4
  581. package/types/src/charts/features/legendCategory.d.ts +36 -0
  582. package/types/src/charts/features/legendLabel.d.ts +3 -6
  583. package/types/src/charts/features/plotAnnotations.d.ts +38 -0
  584. package/types/src/charts/features/plotEndLabels.d.ts +108 -0
  585. package/types/src/charts/features/plotPaint.d.ts +10 -25
  586. package/types/src/charts/features/sceneBounds.d.ts +8 -2
  587. package/types/src/charts/features/shapeEmit.d.ts +14 -1
  588. package/types/src/charts/features/shareKey.d.ts +24 -0
  589. package/types/src/charts/features/sharedFields.d.ts +22 -0
  590. package/types/src/charts/features/tooltipSwatch.d.ts +36 -4
  591. package/types/src/charts/features/xAxisConfig.d.ts +6 -0
  592. package/types/src/charts/helpers/densityChart.d.ts +62 -0
  593. package/types/src/charts/helpers/densityData.d.ts +88 -0
  594. package/types/src/charts/helpers/densityEnter.d.ts +23 -0
  595. package/types/src/charts/helpers/valueTitle.d.ts +23 -0
  596. package/types/src/charts/index.d.ts +20 -0
  597. package/types/src/charts/partition/chartFields.d.ts +29 -0
  598. package/types/src/charts/partition/hierarchy.d.ts +109 -0
  599. package/types/src/charts/partition/interaction.d.ts +57 -0
  600. package/types/src/charts/partition/labelWords.d.ts +50 -0
  601. package/types/src/charts/partition/shade.d.ts +61 -0
  602. package/types/src/charts/partition/zoom.d.ts +51 -0
  603. package/types/src/charts/pipeline/preDrawData.d.ts +34 -0
  604. package/types/src/charts/pipeline/stages.d.ts +11 -3
  605. package/types/src/charts/pipeline/vizDraw.d.ts +25 -20
  606. package/types/src/charts/pipeline/vizPreDraw.d.ts +23 -17
  607. package/types/src/charts/plotBuffers/Bar.d.ts +9 -12
  608. package/types/src/charts/plotBuffers/Box.d.ts +8 -11
  609. package/types/src/charts/plotBuffers/defaultBuffers.d.ts +25 -0
  610. package/types/src/charts/plotBuffers/numericBuffer.d.ts +1 -1
  611. package/types/src/charts/plotBuffers/rectLikeBuffer.d.ts +25 -0
  612. package/types/src/charts/polar/chrome.d.ts +62 -0
  613. package/types/src/charts/polar/config.d.ts +21 -0
  614. package/types/src/charts/polar/geometry.d.ts +68 -0
  615. package/types/src/charts/polar/labels.d.ts +87 -0
  616. package/types/src/charts/polar/polarFacet.d.ts +33 -0
  617. package/types/src/charts/polar/wedgeLayout.d.ts +81 -0
  618. package/types/src/charts/viz/Viz.d.ts +24 -24
  619. package/types/src/charts/viz/VizBase.d.ts +59 -204
  620. package/types/src/charts/viz/backgroundInk.d.ts +15 -0
  621. package/types/src/charts/viz/labelDefaults.d.ts +11 -0
  622. package/types/src/charts/viz/reserveContainerSize.d.ts +15 -0
  623. package/types/src/charts/viz/resetChromeBoxes.d.ts +4 -0
  624. package/types/src/charts/viz/shapeClassTargets.d.ts +25 -0
  625. package/types/src/charts/viz/shapeHover.d.ts +10 -0
  626. package/types/src/charts/viz/simpleHover.d.ts +9 -0
  627. package/types/src/charts/viz/vizDefaults.d.ts +10 -0
  628. package/types/src/charts/viz/vizFields.d.ts +199 -0
  629. package/types/src/charts/viz/vizTypes.d.ts +107 -39
  630. package/types/src/components/Axis/Axis.d.ts +59 -4
  631. package/types/src/components/Axis/axisBreak.d.ts +86 -0
  632. package/types/src/components/Axis/axisDefaults.d.ts +11 -0
  633. package/types/src/components/Axis/axisEndLabels.d.ts +37 -0
  634. package/types/src/components/Axis/axisLabelThinning.d.ts +48 -0
  635. package/types/src/components/Axis/axisLayout.d.ts +10 -0
  636. package/types/src/components/Axis/axisLayoutLabels.d.ts +30 -0
  637. package/types/src/components/Axis/axisLayoutScale.d.ts +13 -2
  638. package/types/src/components/Axis/axisRender.d.ts +1 -30
  639. package/types/src/components/Axis/axisRounding.d.ts +14 -0
  640. package/types/src/components/Axis/axisScene.d.ts +33 -0
  641. package/types/src/components/Axis/brokenScale.d.ts +66 -0
  642. package/types/src/components/Axis/gridStroke.d.ts +8 -0
  643. package/types/src/components/Axis/timeValues.d.ts +63 -0
  644. package/types/src/components/Axis/yearValues.d.ts +21 -0
  645. package/types/src/components/TextBox.d.ts +1 -36
  646. package/types/src/components/textBoxLayout.d.ts +45 -0
  647. package/types/src/components/tooltipDom.d.ts +30 -0
  648. package/types/src/fluent.d.ts +103 -34
  649. package/types/src/shapes/Box.d.ts +12 -1
  650. package/types/src/shapes/Shape.d.ts +2 -3
  651. package/types/src/shapes/Whisker.d.ts +4 -1
  652. package/types/src/shapes/emitLabels.d.ts +15 -0
  653. package/types/src/shapes/shapeConfig.d.ts +35 -5
  654. package/types/src/shapes/shapeOwners.d.ts +10 -0
  655. package/types/src/shapes/shapeStandalone.d.ts +7 -0
  656. package/types/src/shapes/uniqueIds.d.ts +6 -0
  657. package/types/src/shapes/validateShapeConfig.d.ts +20 -3
  658. package/types/src/utils/BaseClass.d.ts +6 -0
  659. package/types/src/utils/D3Scale.d.ts +3 -0
  660. package/types/src/utils/D3plusConfig.d.ts +940 -99
  661. package/types/src/utils/configPrep.d.ts +3 -2
  662. package/types/src/utils/configWarnings.d.ts +5 -0
  663. package/types/src/utils/index.d.ts +1 -1
  664. package/types/src/utils/wholeWords.d.ts +28 -0
  665. package/umd/d3plus-core.full.js +74785 -75059
  666. package/umd/d3plus-core.full.min.js +2 -10702
  667. package/umd/d3plus-core.js +44707 -23629
  668. package/umd/d3plus-core.min.js +2 -6671
  669. package/es/index.js.map +0 -1
  670. package/es/internal.js.map +0 -1
  671. package/es/src/charts/AreaPlot/index.js.map +0 -1
  672. package/es/src/charts/BarChart/index.js.map +0 -1
  673. package/es/src/charts/BoxWhisker/index.js.map +0 -1
  674. package/es/src/charts/BumpChart/index.js.map +0 -1
  675. package/es/src/charts/Chord/applyLayout.js.map +0 -1
  676. package/es/src/charts/Chord/emit.js.map +0 -1
  677. package/es/src/charts/Chord/index.js.map +0 -1
  678. package/es/src/charts/Donut/index.js.map +0 -1
  679. package/es/src/charts/Geomap/applyLayout.js.map +0 -1
  680. package/es/src/charts/Geomap/basemapTheme.js.map +0 -1
  681. package/es/src/charts/Geomap/emit.js.map +0 -1
  682. package/es/src/charts/Geomap/index.js.map +0 -1
  683. package/es/src/charts/Histogram/binData.js.map +0 -1
  684. package/es/src/charts/Histogram/index.js.map +0 -1
  685. package/es/src/charts/LinePlot/index.js.map +0 -1
  686. package/es/src/charts/Matrix/applyLayout.js.map +0 -1
  687. package/es/src/charts/Matrix/emit.js.map +0 -1
  688. package/es/src/charts/Matrix/index.js.map +0 -1
  689. package/es/src/charts/Network/applyLayout.js.map +0 -1
  690. package/es/src/charts/Network/emit.js.map +0 -1
  691. package/es/src/charts/Network/index.js.map +0 -1
  692. package/es/src/charts/Pack/applyLayout.js.map +0 -1
  693. package/es/src/charts/Pack/emit.js.map +0 -1
  694. package/es/src/charts/Pack/index.js.map +0 -1
  695. package/es/src/charts/Pack/recursionCircles.js.map +0 -1
  696. package/es/src/charts/Pie/applyLayout.js.map +0 -1
  697. package/es/src/charts/Pie/emit.js.map +0 -1
  698. package/es/src/charts/Pie/index.js.map +0 -1
  699. package/es/src/charts/Plot/discreteSpan.js.map +0 -1
  700. package/es/src/charts/Plot/draw.js.map +0 -1
  701. package/es/src/charts/Plot/index.js.map +0 -1
  702. package/es/src/charts/Plot/insetRegion.js.map +0 -1
  703. package/es/src/charts/Plot/labelPlacement.js.map +0 -1
  704. package/es/src/charts/Plot/pipeline.js.map +0 -1
  705. package/es/src/charts/Plot/pipelineDomains.js.map +0 -1
  706. package/es/src/charts/Plot/pipelineLineLabels.js.map +0 -1
  707. package/es/src/charts/Plot/plotZoom.js.map +0 -1
  708. package/es/src/charts/Plot/shapeDefaults.js.map +0 -1
  709. package/es/src/charts/Plot/sharedHover.js.map +0 -1
  710. package/es/src/charts/Plot/sharedHoverScene.js.map +0 -1
  711. package/es/src/charts/Plot/sharedTooltip.js.map +0 -1
  712. package/es/src/charts/Plot/stackHelpers.js.map +0 -1
  713. package/es/src/charts/Plot/stackShareLabels.js.map +0 -1
  714. package/es/src/charts/Plot/stackShareTooltip.js.map +0 -1
  715. package/es/src/charts/Plot/trendLines.js.map +0 -1
  716. package/es/src/charts/Plot/trendProjection.js.map +0 -1
  717. package/es/src/charts/Plot/trendScene.js.map +0 -1
  718. package/es/src/charts/Plot/trendTooltip.js.map +0 -1
  719. package/es/src/charts/Priestley/applyLayout.js.map +0 -1
  720. package/es/src/charts/Priestley/emit.js.map +0 -1
  721. package/es/src/charts/Priestley/index.js.map +0 -1
  722. package/es/src/charts/Radar/applyLayout.js.map +0 -1
  723. package/es/src/charts/Radar/emit.js.map +0 -1
  724. package/es/src/charts/Radar/index.js.map +0 -1
  725. package/es/src/charts/RadialMatrix/applyLayout.js.map +0 -1
  726. package/es/src/charts/RadialMatrix/emit.js.map +0 -1
  727. package/es/src/charts/RadialMatrix/index.js.map +0 -1
  728. package/es/src/charts/Rings/applyLayout.js.map +0 -1
  729. package/es/src/charts/Rings/emit.js.map +0 -1
  730. package/es/src/charts/Rings/index.js.map +0 -1
  731. package/es/src/charts/Rings/ringsSizing.js.map +0 -1
  732. package/es/src/charts/Sankey/applyLayout.js.map +0 -1
  733. package/es/src/charts/Sankey/emit.js.map +0 -1
  734. package/es/src/charts/Sankey/index.js.map +0 -1
  735. package/es/src/charts/StackedArea/index.js.map +0 -1
  736. package/es/src/charts/Tree/applyLayout.js.map +0 -1
  737. package/es/src/charts/Tree/emit.js.map +0 -1
  738. package/es/src/charts/Tree/index.js.map +0 -1
  739. package/es/src/charts/Treemap/applyLayout.js.map +0 -1
  740. package/es/src/charts/Treemap/emit.js.map +0 -1
  741. package/es/src/charts/Treemap/index.js.map +0 -1
  742. package/es/src/charts/Treemap/thresholdFunction.js.map +0 -1
  743. package/es/src/charts/definition/ChartDefinition.js.map +0 -1
  744. package/es/src/charts/definition/applyDefinition.js.map +0 -1
  745. package/es/src/charts/definition/makeChart.js.map +0 -1
  746. package/es/src/charts/drawSteps/backControl.js.map +0 -1
  747. package/es/src/charts/drawSteps/bottomRightControls.js.map +0 -1
  748. package/es/src/charts/drawSteps/bottomRightControlsMarkup.js.map +0 -1
  749. package/es/src/charts/drawSteps/controlButtonStyle.js.map +0 -1
  750. package/es/src/charts/drawSteps/minimap.js.map +0 -1
  751. package/es/src/charts/drawSteps/minimapMarkup.js.map +0 -1
  752. package/es/src/charts/drawSteps/searchControls.js.map +0 -1
  753. package/es/src/charts/drawSteps/searchControlsMarkup.js.map +0 -1
  754. package/es/src/charts/drawSteps/tableView.js.map +0 -1
  755. package/es/src/charts/drawSteps/tableViewControl.js.map +0 -1
  756. package/es/src/charts/drawSteps/tableViewMarkup.js.map +0 -1
  757. package/es/src/charts/drawSteps/topLeftControls.js.map +0 -1
  758. package/es/src/charts/drawSteps/topLeftControlsMarkup.js.map +0 -1
  759. package/es/src/charts/drawSteps/zoomControls.js.map +0 -1
  760. package/es/src/charts/drawSteps/zoomControlsMarkup.js.map +0 -1
  761. package/es/src/charts/events/click.legend.js.map +0 -1
  762. package/es/src/charts/events/click.shape.js.map +0 -1
  763. package/es/src/charts/events/mouseenter.js.map +0 -1
  764. package/es/src/charts/events/mouseleave.js.map +0 -1
  765. package/es/src/charts/events/mousemove.legend.js.map +0 -1
  766. package/es/src/charts/events/mousemove.shape.js.map +0 -1
  767. package/es/src/charts/events/touchstart.body.js.map +0 -1
  768. package/es/src/charts/features/attributionFeature.js.map +0 -1
  769. package/es/src/charts/features/axes.js.map +0 -1
  770. package/es/src/charts/features/chartGeometry.js.map +0 -1
  771. package/es/src/charts/features/colorScaleBucket.js.map +0 -1
  772. package/es/src/charts/features/edgeArrows.js.map +0 -1
  773. package/es/src/charts/features/emitHelpers.js.map +0 -1
  774. package/es/src/charts/features/ensureZoomDom.js.map +0 -1
  775. package/es/src/charts/features/features.js.map +0 -1
  776. package/es/src/charts/features/featuresColorScale.js.map +0 -1
  777. package/es/src/charts/features/featuresLegend.js.map +0 -1
  778. package/es/src/charts/features/insetState.js.map +0 -1
  779. package/es/src/charts/features/legendLabel.js.map +0 -1
  780. package/es/src/charts/features/lineLabels.js.map +0 -1
  781. package/es/src/charts/features/plotPaint.js.map +0 -1
  782. package/es/src/charts/features/sceneBounds.js.map +0 -1
  783. package/es/src/charts/features/shapeEmit.js.map +0 -1
  784. package/es/src/charts/features/tooltipSwatch.js.map +0 -1
  785. package/es/src/charts/features/zoomExtent.js.map +0 -1
  786. package/es/src/charts/helpers/matrixData.js.map +0 -1
  787. package/es/src/charts/helpers/tileAttributions.js.map +0 -1
  788. package/es/src/charts/index.js.map +0 -1
  789. package/es/src/charts/pipeline/drillMorph.js.map +0 -1
  790. package/es/src/charts/pipeline/insetPlacement.js.map +0 -1
  791. package/es/src/charts/pipeline/resolveSpec.js.map +0 -1
  792. package/es/src/charts/pipeline/runChartDraw.js.map +0 -1
  793. package/es/src/charts/pipeline/runVizPipeline.js.map +0 -1
  794. package/es/src/charts/pipeline/stages.js.map +0 -1
  795. package/es/src/charts/pipeline/vizContext.js +0 -29
  796. package/es/src/charts/pipeline/vizContext.js.map +0 -1
  797. package/es/src/charts/pipeline/vizDraw.js.map +0 -1
  798. package/es/src/charts/pipeline/vizDrawPure.js +0 -220
  799. package/es/src/charts/pipeline/vizDrawPure.js.map +0 -1
  800. package/es/src/charts/pipeline/vizPreDraw.js.map +0 -1
  801. package/es/src/charts/pipeline/vizPreDrawPure.js +0 -279
  802. package/es/src/charts/pipeline/vizPreDrawPure.js.map +0 -1
  803. package/es/src/charts/plotBuffers/Bar.js.map +0 -1
  804. package/es/src/charts/plotBuffers/Box.js.map +0 -1
  805. package/es/src/charts/plotBuffers/Circle.js.map +0 -1
  806. package/es/src/charts/plotBuffers/Line.js.map +0 -1
  807. package/es/src/charts/plotBuffers/Rect.js.map +0 -1
  808. package/es/src/charts/plotBuffers/discreteBuffer.js.map +0 -1
  809. package/es/src/charts/plotBuffers/numericBuffer.js.map +0 -1
  810. package/es/src/charts/viz/Viz.js.map +0 -1
  811. package/es/src/charts/viz/VizBase.js.map +0 -1
  812. package/es/src/charts/viz/VizBaseConfig.js +0 -538
  813. package/es/src/charts/viz/VizBaseConfig.js.map +0 -1
  814. package/es/src/charts/viz/interactionOpacity.js.map +0 -1
  815. package/es/src/charts/viz/linkGroup.js.map +0 -1
  816. package/es/src/charts/viz/ordinalColor.js.map +0 -1
  817. package/es/src/charts/viz/sceneRows.js.map +0 -1
  818. package/es/src/charts/viz/trailCatchup.js.map +0 -1
  819. package/es/src/charts/viz/vizDefaults.js.map +0 -1
  820. package/es/src/charts/viz/vizRender.js.map +0 -1
  821. package/es/src/charts/viz/vizTypes.js.map +0 -1
  822. package/es/src/charts/viz/vizVisibility.js.map +0 -1
  823. package/es/src/components/Axis/Axis.js.map +0 -1
  824. package/es/src/components/Axis/AxisBottom.js.map +0 -1
  825. package/es/src/components/Axis/AxisLeft.js.map +0 -1
  826. package/es/src/components/Axis/AxisRight.js.map +0 -1
  827. package/es/src/components/Axis/AxisTop.js.map +0 -1
  828. package/es/src/components/Axis/axisLayout.js.map +0 -1
  829. package/es/src/components/Axis/axisLayoutLabels.js.map +0 -1
  830. package/es/src/components/Axis/axisLayoutScale.js.map +0 -1
  831. package/es/src/components/Axis/axisRender.js.map +0 -1
  832. package/es/src/components/ColorScale/ColorScale.js.map +0 -1
  833. package/es/src/components/ColorScale/colorScaleRender.js.map +0 -1
  834. package/es/src/components/ColorScale/colorScaleScale.js.map +0 -1
  835. package/es/src/components/Legend/Legend.js.map +0 -1
  836. package/es/src/components/Legend/legendConfig.js.map +0 -1
  837. package/es/src/components/Legend/legendRender.js.map +0 -1
  838. package/es/src/components/Message.js.map +0 -1
  839. package/es/src/components/SizeLegend/SizeLegend.js.map +0 -1
  840. package/es/src/components/SizeLegend/sizeLegendLayout.js.map +0 -1
  841. package/es/src/components/TextBox.js.map +0 -1
  842. package/es/src/components/Timeline/Timeline.js.map +0 -1
  843. package/es/src/components/Timeline/timelineConfig.js.map +0 -1
  844. package/es/src/components/Timeline/timelineRender.js.map +0 -1
  845. package/es/src/components/Tooltip.js.map +0 -1
  846. package/es/src/components/index.js.map +0 -1
  847. package/es/src/fluent.js.map +0 -1
  848. package/es/src/shapes/Area.js.map +0 -1
  849. package/es/src/shapes/Bar.js.map +0 -1
  850. package/es/src/shapes/Box.js.map +0 -1
  851. package/es/src/shapes/Circle.js.map +0 -1
  852. package/es/src/shapes/Image.js.map +0 -1
  853. package/es/src/shapes/Line.js.map +0 -1
  854. package/es/src/shapes/Path.js.map +0 -1
  855. package/es/src/shapes/Rect.js.map +0 -1
  856. package/es/src/shapes/Shape.js.map +0 -1
  857. package/es/src/shapes/Whisker.js.map +0 -1
  858. package/es/src/shapes/buildLabelData.js.map +0 -1
  859. package/es/src/shapes/emitLabels.js.map +0 -1
  860. package/es/src/shapes/hitAreaNode.js.map +0 -1
  861. package/es/src/shapes/index.js.map +0 -1
  862. package/es/src/shapes/interactionPoints.js.map +0 -1
  863. package/es/src/shapes/sceneSort.js.map +0 -1
  864. package/es/src/shapes/shapeConfig.js.map +0 -1
  865. package/es/src/shapes/textureKey.js.map +0 -1
  866. package/es/src/shapes/validateShapeConfig.js.map +0 -1
  867. package/es/src/utils/AccessorFn.js.map +0 -1
  868. package/es/src/utils/BaseClass.js.map +0 -1
  869. package/es/src/utils/D3Scale.js.map +0 -1
  870. package/es/src/utils/D3plusConfig.js.map +0 -1
  871. package/es/src/utils/RESET.js.map +0 -1
  872. package/es/src/utils/accessor.js.map +0 -1
  873. package/es/src/utils/configDefault.js.map +0 -1
  874. package/es/src/utils/configPrep.js.map +0 -1
  875. package/es/src/utils/configWarnings.js.map +0 -1
  876. package/es/src/utils/constant.js.map +0 -1
  877. package/es/src/utils/getProp.js.map +0 -1
  878. package/es/src/utils/index.js.map +0 -1
  879. package/es/src/utils/paintComponentScene.js.map +0 -1
  880. package/es/umd-entry.js +0 -16
  881. package/es/umd-entry.js.map +0 -1
  882. package/types/src/charts/AreaPlot.d.ts +0 -16
  883. package/types/src/charts/BarChart.d.ts +0 -16
  884. package/types/src/charts/BoxWhisker.d.ts +0 -11
  885. package/types/src/charts/BumpChart.d.ts +0 -36
  886. package/types/src/charts/ChartDefinition.d.ts +0 -75
  887. package/types/src/charts/Donut.d.ts +0 -11
  888. package/types/src/charts/Geomap.d.ts +0 -126
  889. package/types/src/charts/LinePlot.d.ts +0 -15
  890. package/types/src/charts/Matrix.d.ts +0 -48
  891. package/types/src/charts/Network.d.ts +0 -54
  892. package/types/src/charts/Pack.d.ts +0 -34
  893. package/types/src/charts/Pie.d.ts +0 -17
  894. package/types/src/charts/Plot.d.ts +0 -150
  895. package/types/src/charts/Priestley.d.ts +0 -37
  896. package/types/src/charts/Radar.d.ts +0 -38
  897. package/types/src/charts/RadialMatrix.d.ts +0 -63
  898. package/types/src/charts/Rings.d.ts +0 -61
  899. package/types/src/charts/Sankey.d.ts +0 -77
  900. package/types/src/charts/StackedArea.d.ts +0 -14
  901. package/types/src/charts/Tree.d.ts +0 -17
  902. package/types/src/charts/Treemap.d.ts +0 -42
  903. package/types/src/charts/Viz.d.ts +0 -90
  904. package/types/src/charts/VizBase.d.ts +0 -158
  905. package/types/src/charts/VizBaseConfig.d.ts +0 -148
  906. package/types/src/charts/applyDefinition.d.ts +0 -13
  907. package/types/src/charts/axes.d.ts +0 -134
  908. package/types/src/charts/chartGeometry.d.ts +0 -58
  909. package/types/src/charts/drawSteps/drawAttribution.d.ts +0 -7
  910. package/types/src/charts/drawSteps/drawBack.d.ts +0 -6
  911. package/types/src/charts/drawSteps/drawColorScale.d.ts +0 -6
  912. package/types/src/charts/drawSteps/drawLegend.d.ts +0 -12
  913. package/types/src/charts/drawSteps/drawSubtitle.d.ts +0 -7
  914. package/types/src/charts/drawSteps/drawTimeline.d.ts +0 -7
  915. package/types/src/charts/drawSteps/drawTitle.d.ts +0 -7
  916. package/types/src/charts/drawSteps/drawTotal.d.ts +0 -7
  917. package/types/src/charts/emitHelpers.d.ts +0 -122
  918. package/types/src/charts/ensureZoomDom.d.ts +0 -39
  919. package/types/src/charts/factories.d.ts +0 -73
  920. package/types/src/charts/features/colorScaleBucketShare.d.ts +0 -16
  921. package/types/src/charts/features.d.ts +0 -152
  922. package/types/src/charts/featuresLegend.d.ts +0 -12
  923. package/types/src/charts/legendLabel.d.ts +0 -11
  924. package/types/src/charts/lineLabels.d.ts +0 -40
  925. package/types/src/charts/makeChart.d.ts +0 -22
  926. package/types/src/charts/pipeline/vizContext.d.ts +0 -45
  927. package/types/src/charts/pipeline/vizDrawPure.d.ts +0 -46
  928. package/types/src/charts/pipeline/vizPreDrawPure.d.ts +0 -68
  929. package/types/src/charts/plotPaint.d.ts +0 -233
  930. package/types/src/charts/resolveSpec.d.ts +0 -50
  931. package/types/src/charts/runChartDraw.d.ts +0 -38
  932. package/types/src/charts/runVizPipeline.d.ts +0 -31
  933. package/types/src/charts/shapeEmit.d.ts +0 -61
  934. package/types/src/charts/stages.d.ts +0 -117
  935. package/types/src/charts/viz/VizBaseConfig.d.ts +0 -175
  936. package/types/src/charts/vizContext.d.ts +0 -46
  937. package/types/src/charts/vizDefaults.d.ts +0 -8
  938. package/types/src/charts/vizDraw.d.ts +0 -25
  939. package/types/src/charts/vizDrawPure.d.ts +0 -17
  940. package/types/src/charts/vizPreDraw.d.ts +0 -22
  941. package/types/src/charts/vizPreDrawPure.d.ts +0 -40
  942. package/types/src/charts/vizRender.d.ts +0 -8
  943. package/types/src/charts/vizTypes.d.ts +0 -202
  944. package/types/src/components/Axis.d.ts +0 -183
  945. package/types/src/components/AxisBottom.d.ts +0 -11
  946. package/types/src/components/AxisLeft.d.ts +0 -11
  947. package/types/src/components/AxisRight.d.ts +0 -11
  948. package/types/src/components/AxisTop.d.ts +0 -11
  949. package/types/src/components/ColorScale.d.ts +0 -80
  950. package/types/src/components/Legend.d.ts +0 -93
  951. package/types/src/components/Timeline.d.ts +0 -83
  952. package/types/src/components/axisLayout.d.ts +0 -27
  953. package/types/src/components/axisLayoutLabels.d.ts +0 -42
  954. package/types/src/components/axisLayoutScale.d.ts +0 -12
  955. package/types/src/components/axisRender.d.ts +0 -65
  956. package/types/src/components/colorScaleRender.d.ts +0 -15
  957. package/types/src/components/colorScaleScale.d.ts +0 -19
  958. package/types/src/components/legendConfig.d.ts +0 -7
  959. package/types/src/components/legendRender.d.ts +0 -16
  960. package/types/src/components/timelineConfig.d.ts +0 -6
  961. package/types/src/components/timelineRender.d.ts +0 -14
  962. package/umd/d3plus-core.full.js.map +0 -1
  963. package/umd/d3plus-core.js.map +0 -1
@@ -0,0 +1,170 @@
1
+ /**
2
+ Waffle — a grid of unit cells (10 × 10 by default, so each cell is 1%)
3
+ filled in order by `groupBy` category, each category getting a number of
4
+ cells proportional to its value.
5
+
6
+ Implementation files in this folder:
7
+ - `applyLayout.ts` — chart-specific `TransformStage`.
8
+ - `emit.ts` — cell rects/circles and their icons.
9
+ - `waffleLayout.ts` — pure allocation (largest remainder) and grid math.
10
+ - `tooltip.ts` — the "Value" and "Share" tooltip rows.
11
+ */ import accessor from "../../utils/accessor.js";
12
+ import { makeChart } from "../definition/makeChart.js";
13
+ import { sceneInsetRegion } from "../pipeline/insetPlacement.js";
14
+ import { thresholdFunction } from "../Treemap/thresholdFunction.js";
15
+ import { applyWaffleLayout } from "./applyLayout.js";
16
+ import { waffleEmit } from "./emit.js";
17
+ import { waffleTooltipRows } from "./tooltip.js";
18
+ /** Descending by the chart's current `sum`. */ const bySum = (viz)=>(a, b)=>{
19
+ const sumFn = viz.schema.sum;
20
+ return sumFn(b) - sumFn(a);
21
+ };
22
+ /** The chart's current `sort`, or the data order when `sort` is off. */ const fillOrder = (viz)=>(a, b)=>{
23
+ const sort = viz.schema.sort;
24
+ return typeof sort === "function" ? sort(a, b) : 0;
25
+ };
26
+ const isAggregated = (d)=>d._isAggregation === true;
27
+ export const waffleDef = {
28
+ name: "Waffle",
29
+ layoutStage: applyWaffleLayout,
30
+ emit: waffleEmit,
31
+ insetRegion: sceneInsetRegion,
32
+ thresholdFunction: (viz, data)=>thresholdFunction(data, {
33
+ aggs: viz.schema.aggs,
34
+ drawDepth: viz._drawDepth,
35
+ groupBy: viz.schema.groupBy,
36
+ threshold: viz.schema.threshold,
37
+ thresholdKey: viz.schema.thresholdKey
38
+ }),
39
+ // The default 10 × 10 grid is square.
40
+ facet: {
41
+ aspect: 1
42
+ },
43
+ ctx: {},
44
+ fields: [
45
+ /**
46
+ The gap between neighboring cells, in pixels. It shrinks on small grids
47
+ (such as small multiples) so the cells stay visible.
48
+ @type {number}
49
+ */ {
50
+ key: "cellPadding",
51
+ default: 2
52
+ },
53
+ /**
54
+ How each cell is drawn: `"square"`, `"rounded"` (a square with rounded
55
+ corners), or `"circle"`.
56
+ @type {"square" | "rounded" | "circle"}
57
+ */ {
58
+ key: "cellShape",
59
+ default: "square"
60
+ },
61
+ /**
62
+ The number of columns in the grid. With `unit`, a row-wise fill keeps
63
+ this many columns and adds rows as needed.
64
+ @type {number}
65
+ */ {
66
+ key: "columns",
67
+ default: 10
68
+ },
69
+ /**
70
+ The order cells fill the grid: `"row"` fills along each row, `"column"`
71
+ down each column.
72
+ @type {"row" | "column"}
73
+ */ {
74
+ key: "fillDirection",
75
+ default: "row"
76
+ },
77
+ /**
78
+ The corner of the grid the first cell sits in.
79
+ @type {"top-left" | "top-right" | "bottom-left" | "bottom-right"}
80
+ */ {
81
+ key: "fillStart",
82
+ default: "top-left"
83
+ },
84
+ /**
85
+ Draws an icon in every cell in place of its fill (a pictogram): an
86
+ image URL, or an accessor `(d, i) => url` returning one per category.
87
+ The icon fits inside its cell and dims with it on hover. A cell whose
88
+ icon resolves to nothing (e.g. `null`) draws as in plain mode: its
89
+ fill, `shapeConfig.texture`, and `shapeConfig.backgroundImage`.
90
+ @type {string | function}
91
+ */ {
92
+ key: "icon"
93
+ },
94
+ /**
95
+ The number of rows in the grid. With `unit` and a column-wise fill,
96
+ the grid keeps this many rows and adds columns as needed.
97
+ @type {number}
98
+ */ {
99
+ key: "rows",
100
+ default: 10
101
+ },
102
+ /**
103
+ Comparator for the order categories fill the grid, given two rows.
104
+ Defaults to descending by `sum`, with any threshold bucket last; `false`
105
+ keeps the data order.
106
+ @type {false | function}
107
+ */ {
108
+ key: "sort",
109
+ factory: (viz)=>bySum(viz),
110
+ decorate: (_viz, base)=>{
111
+ const baseSort = base;
112
+ return (a, b)=>{
113
+ const aggA = isAggregated(a);
114
+ const aggB = isAggregated(b);
115
+ return aggA && !aggB ? 1 : !aggA && aggB ? -1 : baseSort(a, b);
116
+ };
117
+ }
118
+ },
119
+ /**
120
+ Accessor function or string key for each category's value. The
121
+ categories get cells in proportion to it, allocated by the
122
+ largest-remainder method so the cells always add up to the grid.
123
+ @type {string | function}
124
+ */ {
125
+ key: "sum",
126
+ default: accessor("value"),
127
+ coerce: (v)=>typeof v === "function" ? v : accessor(v),
128
+ onSet: (viz, v)=>{
129
+ viz.schema.thresholdKey = v;
130
+ }
131
+ },
132
+ /**
133
+ The value one cell stands for. By default the categories share every
134
+ cell of the `rows` × `columns` grid, so each cell is a fixed share of
135
+ the total (1% for 10 × 10); with a `unit`, each cell counts `unit` of
136
+ the value and the grid grows to fit the total.
137
+ @type {number}
138
+ */ {
139
+ key: "unit"
140
+ },
141
+ {
142
+ key: "zoom",
143
+ default: false
144
+ },
145
+ {
146
+ key: "tooltipConfig",
147
+ merge: true,
148
+ factory: (viz)=>({
149
+ tbody: waffleTooltipRows(viz)
150
+ })
151
+ },
152
+ {
153
+ key: "legendTooltip",
154
+ merge: true,
155
+ factory: (viz)=>({
156
+ tbody: waffleTooltipRows(viz)
157
+ })
158
+ },
159
+ /** Lists the legend in the order the categories fill the grid (see `sort`). */ {
160
+ key: "legendSort",
161
+ factory: (viz)=>fillOrder(viz)
162
+ }
163
+ ]
164
+ };
165
+ /**
166
+ Draws a grid of unit cells filled in order by category, each category
167
+ getting cells in proportion to its value. By default the grid is 10 × 10,
168
+ so each cell is 1% of the total; set `unit` to make each cell a fixed
169
+ amount instead. Hover a cell to highlight its whole category.
170
+ */ export default makeChart(waffleDef);
@@ -0,0 +1,37 @@
1
+ /**
2
+ Waffle's "Value" and "Share" rows, shared by cell and legend tooltips.
3
+
4
+ @module
5
+ */ import { formatAbbreviate } from "@d3plus/format";
6
+ import { colorScaleBucketShare } from "../features/colorScaleBucket.js";
7
+ import { summedShare } from "../features/shareKey.js";
8
+ /** Formats a 0–1 share as an abbreviated percentage, or "" when not finite. */ export function formatShare(share, locale) {
9
+ return share == null || !Number.isFinite(share) ? "" : `${formatAbbreviate(share * 100, locale)}%`;
10
+ }
11
+ /**
12
+ The share a tooltip row reports for `x`: the summed share of a colorScale
13
+ swatch's range, or the share d3plus stamped on the row (summed over a
14
+ merged legend row's members).
15
+ */ export function waffleShare(viz, x) {
16
+ const sum = viz.schema.sum;
17
+ if (x._isColorScaleBucket) return colorScaleBucketShare(viz, x.color, sum);
18
+ return summedShare(x);
19
+ }
20
+ /** The `[label, value]` tooltip rows: the summed value, then its share. */ export function waffleTooltipRows(viz) {
21
+ const locale = ()=>viz.schema.locale;
22
+ return [
23
+ [
24
+ ()=>viz.schema.translate("Value"),
25
+ (d, i, x)=>{
26
+ if (x && x._isColorScaleBucket) return "";
27
+ const sum = viz.schema.sum;
28
+ const v = Number(sum(d, i));
29
+ return Number.isFinite(v) ? formatAbbreviate(v, locale()) : "";
30
+ }
31
+ ],
32
+ [
33
+ ()=>viz.schema.translate("Share"),
34
+ (_d, _i, x)=>formatShare(waffleShare(viz, x ?? {}), locale())
35
+ ]
36
+ ];
37
+ }
@@ -0,0 +1,104 @@
1
+ /**
2
+ Pure Waffle layout math: how many cells each category gets, the grid's
3
+ shape, and where each cell sits.
4
+
5
+ @module
6
+ */ /** The order cells fill the grid in: along each row, or down each column. */ const finitePositive = (v)=>Number.isFinite(v) && v > 0 ? v : 0;
7
+ /**
8
+ Splits `total` whole units among `values` in proportion to each value,
9
+ using the largest-remainder (Hamilton) method: every value first gets the
10
+ floor of its exact quota, then the units left over go one each to the
11
+ values with the largest fractional remainders. The counts always sum to
12
+ `total` (when any value is positive). Ties go to the larger value, then
13
+ to the earlier one. Non-finite and non-positive values get 0.
14
+ */ export function largestRemainder(values, total) {
15
+ const clean = values.map(finitePositive);
16
+ const sum = clean.reduce((a, b)=>a + b, 0);
17
+ const units = Math.max(0, Math.round(finitePositive(total)));
18
+ if (!sum || !units) return clean.map(()=>0);
19
+ const quotas = clean.map((v)=>v / sum * units);
20
+ const counts = quotas.map(Math.floor);
21
+ let left = units - counts.reduce((a, b)=>a + b, 0);
22
+ const order = quotas.map((q, i)=>({
23
+ i,
24
+ r: q - counts[i],
25
+ v: clean[i]
26
+ })).filter((d)=>d.v > 0).sort((a, b)=>b.r - a.r || b.v - a.v || a.i - b.i);
27
+ for(let k = 0; left > 0 && order.length; k = (k + 1) % order.length){
28
+ counts[order[k].i]++;
29
+ left--;
30
+ }
31
+ return counts;
32
+ }
33
+ /**
34
+ The number of cells each value fills. Without `unit`, the values share
35
+ all `cells` of the grid (each cell is `1 / cells` of the total). With a
36
+ positive `unit`, each cell stands for `unit` of the value, and the values
37
+ share `round(sum / unit)` cells.
38
+ */ export function waffleCounts(values, { cells, unit }) {
39
+ if (unit !== undefined && finitePositive(unit)) {
40
+ const sum = values.map(finitePositive).reduce((a, b)=>a + b, 0);
41
+ return largestRemainder(values, Math.round(sum / unit));
42
+ }
43
+ return largestRemainder(values, cells);
44
+ }
45
+ /**
46
+ The grid's rows and columns for `count` filled cells. Without `unit` the
47
+ grid is `rows × columns`. With `unit`, the count sets its size: a
48
+ row-wise fill keeps `columns` and adds rows as needed, a column-wise fill
49
+ keeps `rows` and adds columns.
50
+ */ export function waffleGrid(count, { rows, columns, fillDirection, unit }) {
51
+ const r = Math.max(1, Math.round(finitePositive(rows)) || 1);
52
+ const c = Math.max(1, Math.round(finitePositive(columns)) || 1);
53
+ if (unit === undefined || !finitePositive(unit)) return {
54
+ rows: r,
55
+ columns: c
56
+ };
57
+ const n = Math.max(1, count);
58
+ return fillDirection === "column" ? {
59
+ rows: r,
60
+ columns: Math.ceil(n / r)
61
+ } : {
62
+ rows: Math.ceil(n / c),
63
+ columns: c
64
+ };
65
+ }
66
+ /**
67
+ The grid position of the `k`th cell (0-based) in fill order: along each
68
+ row (or down each column for `"column"`), starting from `fillStart`.
69
+ */ export function waffleCellPosition(k, { rows, columns, fillDirection, fillStart }) {
70
+ let row = fillDirection === "column" ? k % rows : Math.floor(k / columns);
71
+ let column = fillDirection === "column" ? Math.floor(k / rows) : k % columns;
72
+ if (fillStart.startsWith("bottom")) row = rows - 1 - row;
73
+ if (fillStart.endsWith("right")) column = columns - 1 - column;
74
+ return {
75
+ row,
76
+ column
77
+ };
78
+ }
79
+ /**
80
+ Sizes a `rows × columns` grid of square cells to the largest that fits
81
+ `width × height` with `padding` pixels between cells, and centers it.
82
+ The gap shrinks to at most 40% of a cell's pitch, so tiny grids (small
83
+ multiples) keep visible cells.
84
+ */ export function waffleCellGeometry(width, height, { rows, columns, padding }) {
85
+ const w = finitePositive(width);
86
+ const h = finitePositive(height);
87
+ const r = Math.max(1, rows);
88
+ const c = Math.max(1, columns);
89
+ let pad = finitePositive(padding);
90
+ let pitch = Math.min((w + pad) / c, (h + pad) / r);
91
+ if (pad > pitch * 0.4) {
92
+ pad = 0.4 * Math.min(w / c, h / r);
93
+ pitch = Math.min((w + pad) / c, (h + pad) / r);
94
+ }
95
+ const size = Math.max(0, pitch - pad);
96
+ const gridWidth = c * size + (c - 1) * pad;
97
+ const gridHeight = r * size + (r - 1) * pad;
98
+ return {
99
+ size,
100
+ padding: pad,
101
+ x: (w - gridWidth) / 2,
102
+ y: (h - gridHeight) / 2
103
+ };
104
+ }
@@ -0,0 +1,65 @@
1
+ /**
2
+ Room on the value axis for the labels past each waterfall bar's end.
3
+ */ import { endsForward, LABEL_SPAN } from "./labels.js";
4
+ /**
5
+ Widens `domain` so a label `fraction` of the axis long fits past the
6
+ highest end of any bar ending forward and the lowest end of any bar ending
7
+ backward. `domain` is `[low, high]`.
8
+ */ export function labelHeadroom(domain, steps, fraction) {
9
+ let [lo, hi] = domain;
10
+ const f = Math.min(Math.max(fraction, 0), 0.45);
11
+ if (!f || !steps.length) return [
12
+ lo,
13
+ hi
14
+ ];
15
+ let top = -Infinity, bottom = Infinity;
16
+ for (const step of steps){
17
+ if (endsForward(step)) top = Math.max(top, step.end);
18
+ else bottom = Math.min(bottom, step.end);
19
+ }
20
+ // Each widening shrinks the scale, so settle on the span that fits both ends.
21
+ for(let k = 0; k < 8; k++){
22
+ const span = hi - lo;
23
+ if (Number.isFinite(top)) hi = Math.max(hi, top + f * span);
24
+ if (Number.isFinite(bottom)) lo = Math.min(lo, bottom - f * span);
25
+ }
26
+ return [
27
+ lo,
28
+ hi
29
+ ];
30
+ }
31
+ /**
32
+ Plot's Bar axis buffer for a waterfall: widens the value axis so every
33
+ value label fits inside the plot. Skipped for the secondary axes and when
34
+ bar labels are off.
35
+ */ export function waterfallBuffer(stepOf, options) {
36
+ return ({ data, x, y, x2 })=>{
37
+ if (x2 || !options.labels()) return [
38
+ x,
39
+ y
40
+ ];
41
+ const vertical = options.vertical();
42
+ const scale = vertical ? y : x;
43
+ const steps = data.map((d)=>d.data ? stepOf(d.data) : undefined).filter((s)=>!!s);
44
+ const range = scale.range();
45
+ const length = Math.abs(range[range.length - 1] - range[0]);
46
+ if (!steps.length || !length) return [
47
+ x,
48
+ y
49
+ ];
50
+ const domain = scale.domain().slice();
51
+ // A vertical value axis runs top-down, so its domain is stored high first.
52
+ if (vertical) domain.reverse();
53
+ const px = vertical ? LABEL_SPAN.height + LABEL_SPAN.gap : LABEL_SPAN.width + LABEL_SPAN.gap;
54
+ const next = labelHeadroom([
55
+ domain[0],
56
+ domain[1]
57
+ ], steps, px / length);
58
+ if (vertical) next.reverse();
59
+ scale.domain(next);
60
+ return [
61
+ x,
62
+ y
63
+ ];
64
+ };
65
+ }
@@ -0,0 +1,103 @@
1
+ /**
2
+ The thin lines that carry each waterfall bar's end level across the gap
3
+ to the next bar of its series.
4
+ */ import { dashArray } from "../Pyramid/scene.js";
5
+ /**
6
+ Each Bar rect in `nodes` with a step, with its pixel extent along the
7
+ discrete axis (x for vertical bars, y for horizontal ones).
8
+ */ export function connectorBars(nodes, stepOf, vertical) {
9
+ const bars = [];
10
+ const walk = (node)=>{
11
+ if (node.type === "rect" && node.shapeType === "Bar" && node.datum?.data) {
12
+ const datum = node.datum.data;
13
+ const step = stepOf(datum);
14
+ const offset = vertical ? (node.transform?.x ?? 0) + (node.x ?? 0) : (node.transform?.y ?? 0) + (node.y ?? 0);
15
+ const size = (vertical ? node.width : node.height) ?? 0;
16
+ if (step && Number.isFinite(offset) && Number.isFinite(size)) bars.push({
17
+ step,
18
+ datum,
19
+ lo: offset,
20
+ hi: offset + size
21
+ });
22
+ }
23
+ node.children?.forEach(walk);
24
+ };
25
+ nodes.forEach(walk);
26
+ return bars;
27
+ }
28
+ /**
29
+ The connectors between consecutive steps of each series: from the near
30
+ edge of one bar to the near edge of the next, at the level the first bar
31
+ ends. A step that doesn't continue from the previous one (a subtotal
32
+ resetting the running total) takes none.
33
+ */ export function connectorSegments(bars, level, vertical) {
34
+ const bySeries = new Map();
35
+ for (const bar of bars){
36
+ let steps = bySeries.get(bar.step.series);
37
+ if (!steps) bySeries.set(bar.step.series, steps = new Map());
38
+ if (!steps.has(bar.step.index)) steps.set(bar.step.index, bar);
39
+ }
40
+ const segments = [];
41
+ bySeries.forEach((steps)=>{
42
+ steps.forEach((bar)=>{
43
+ const prev = steps.get(bar.step.index - 1);
44
+ if (!prev || !bar.step.joins) return;
45
+ const p = level(prev.step.end);
46
+ if (!Number.isFinite(p)) return;
47
+ const forward = bar.lo + bar.hi >= prev.lo + prev.hi;
48
+ const a = forward ? prev.hi : prev.lo;
49
+ const b = forward ? bar.lo : bar.hi;
50
+ segments.push(vertical ? {
51
+ from: prev,
52
+ x1: a,
53
+ y1: p,
54
+ x2: b,
55
+ y2: p
56
+ } : {
57
+ from: prev,
58
+ x1: p,
59
+ y1: a,
60
+ x2: p,
61
+ y2: b
62
+ });
63
+ });
64
+ });
65
+ return segments;
66
+ }
67
+ /** A connector style value, optionally a function of the source row the connector leaves. */ function resolve(v, d, i) {
68
+ return typeof v === "function" ? v(d, i) : v;
69
+ }
70
+ /**
71
+ The connectors as inert scene lines, styled by `config` (`stroke`,
72
+ `strokeWidth`, `strokeOpacity`, `strokeDasharray`).
73
+ */ export function connectorNodes(segments, config) {
74
+ return segments.map((s, i)=>{
75
+ const d = s.from.datum;
76
+ const paint = {
77
+ fill: "none",
78
+ stroke: resolve(config.stroke, d, i),
79
+ strokeWidth: resolve(config.strokeWidth, d, i),
80
+ strokeOpacity: resolve(config.strokeOpacity, d, i)
81
+ };
82
+ const dash = dashArray(resolve(config.strokeDasharray, d, i));
83
+ if (dash) paint.strokeDasharray = dash;
84
+ return {
85
+ type: "line",
86
+ key: `waterfall-connector-${s.from.step.series}-${s.from.step.index}`,
87
+ points: [
88
+ [
89
+ s.x1,
90
+ s.y1
91
+ ],
92
+ [
93
+ s.x2,
94
+ s.y2
95
+ ]
96
+ ],
97
+ curve: "linear",
98
+ paint,
99
+ interactive: false,
100
+ interactionGroup: "axis"
101
+ };
102
+ });
103
+ }
@@ -0,0 +1,211 @@
1
+ /**
2
+ Waterfall — a stacked BarChart whose bars float: each change starts where
3
+ the running total before it ended, and subtotal rows draw from zero to the
4
+ running total. Bars are colored by whether they increase, decrease, or
5
+ total, with thin connectors carrying each bar's end level to the next.
6
+ */ import accessor from "../../utils/accessor.js";
7
+ import { makeChart } from "../definition/makeChart.js";
8
+ import BarChart from "../BarChart/index.js";
9
+ import { backgroundInk } from "../viz/backgroundInk.js";
10
+ import { waterfallBuffer } from "./buffer.js";
11
+ import { connectorBars, connectorNodes, connectorSegments } from "./connectors.js";
12
+ import { KIND_LABELS, kindColor, labelAlign, labelBox, stepLabel, tooltipRows } from "./labels.js";
13
+ import { categoryAxis, interceptAxes, KIND_KEY, kindOf, legendKind, resetSteps, sourceRow, stepOf, syncCategorySort, valueFormat } from "./state.js";
14
+ import { WATERFALL_KINDS, waterfallKinds, waterfallStackOffset } from "./steps.js";
15
+ /** A kind's display name, translated. */ const kindText = (viz, d)=>{
16
+ const kind = kindOf(viz, d);
17
+ return kind ? viz.schema.translate(KIND_LABELS[kind]) : undefined;
18
+ };
19
+ /** Whether bars stand upright (categories along x). */ const vertical = (viz)=>categoryAxis(viz) === "x";
20
+ /** A bar's tooltip title: its series, or its kind when the bars have no series. */ function tooltipTitle(viz, d, i) {
21
+ const row = sourceRow(d);
22
+ if (legendKind(row)) return kindText(viz, row) ?? "";
23
+ const label = viz._drawLabel(row, i);
24
+ return label === "undefined" ? kindText(viz, row) ?? label : label;
25
+ }
26
+ /** Bars: kind colors, value labels past each bar's end, and a plain-language aria label. */ function configureBars(viz) {
27
+ const baseFill = viz.schema.shapeConfig.fill;
28
+ viz.schema.shapeConfig.fill = (d, i)=>{
29
+ const kind = kindOf(viz, d);
30
+ return kind ? kindColor(kind, viz.schema, viz.schema.colorDefaults) : baseFill(d, i);
31
+ };
32
+ const align = (d, key, fallback)=>{
33
+ const step = stepOf(viz, d);
34
+ return step ? labelAlign(step, vertical(viz))[key] : fallback;
35
+ };
36
+ const bar = viz.schema.shapeConfig.Bar ?? {};
37
+ viz.schema.shapeConfig.Bar = {
38
+ ...bar,
39
+ ariaLabel: (d, i)=>{
40
+ const step = stepOf(viz, d);
41
+ if (!step) return viz._drawLabel(sourceRow(d), i);
42
+ return `${step.category}, ${kindText(viz, d)}: ${stepLabel(step, valueFormat(viz))}.`;
43
+ },
44
+ label: (d)=>{
45
+ const step = stepOf(viz, d);
46
+ return step ? stepLabel(step, valueFormat(viz)) : false;
47
+ },
48
+ labelBounds: (d, _i, s)=>{
49
+ const step = stepOf(viz, d);
50
+ return step ? labelBox(step, s, vertical(viz)) : false;
51
+ },
52
+ labelConfig: {
53
+ ...bar.labelConfig ?? {},
54
+ fontColor: ()=>backgroundInk(viz),
55
+ fontResize: false,
56
+ fontSize: 12,
57
+ fontStroke: "transparent",
58
+ fontStrokeWidth: 0,
59
+ padding: 0,
60
+ textAnchor: (d)=>align(d, "textAnchor", "middle"),
61
+ verticalAlign: (d)=>align(d, "verticalAlign", "middle")
62
+ }
63
+ };
64
+ }
65
+ /** The legend: one entry per kind drawn, which highlights that kind's bars. */ function configureLegend(viz) {
66
+ const label = (d, i)=>kindText(viz, d) ?? viz._drawLabel(d, i);
67
+ const legendConfig = viz.schema.legendConfig;
68
+ viz.schema.legendConfig = {
69
+ ...legendConfig,
70
+ label,
71
+ shapeConfig: {
72
+ ...legendConfig.shapeConfig ?? {},
73
+ ariaLabel: label
74
+ }
75
+ };
76
+ viz.schema.legendSort = (a, b)=>WATERFALL_KINDS.indexOf(kindOf(viz, a)) - WATERFALL_KINDS.indexOf(kindOf(viz, b));
77
+ // Hiding a kind would rewrite every running total, so entries are a key only.
78
+ delete viz.schema.on["click.legend"];
79
+ const enter = viz.schema.on.mouseenter;
80
+ viz.schema.on.mouseenter = function(d, i, x, event) {
81
+ const kind = legendKind(d);
82
+ if (!kind) return enter.call(this, d, i, x, event);
83
+ if (viz.schema.shapeConfig.hoverOpacity === 1) return;
84
+ viz.hover((h)=>kindOf(viz, h) === kind);
85
+ };
86
+ }
87
+ export const waterfallDef = {
88
+ name: "Waterfall",
89
+ paintDriven: true,
90
+ setup: (viz)=>{
91
+ viz.ctx.waterfall = {
92
+ accessors: {
93
+ x: viz._x,
94
+ y: viz._y
95
+ },
96
+ steps: new WeakMap(),
97
+ laidOut: new WeakSet()
98
+ };
99
+ interceptAxes(viz);
100
+ viz._stackOffset = waterfallStackOffset((row)=>stepOf(viz, row));
101
+ // Each series keeps its own running total, drawn side by side.
102
+ viz._stackGroup = (d, i)=>viz._ids(d, i).slice(0, viz._drawDepth + 1).join("_");
103
+ // Each bar is alone in its stack, so a share would always be 100%.
104
+ viz._stackShares = false;
105
+ viz.schema.color = (d)=>kindOf(viz, d);
106
+ configureBars(viz);
107
+ configureLegend(viz);
108
+ viz._buffer = {
109
+ ...viz._buffer,
110
+ Bar: waterfallBuffer((row)=>stepOf(viz, row), {
111
+ vertical: ()=>vertical(viz),
112
+ labels: ()=>viz.schema.shapeConfig.Bar?.label !== false
113
+ })
114
+ };
115
+ viz._plotUnderlay = (shapes, x, y)=>{
116
+ if (!viz.schema.connectors) return [];
117
+ const upright = vertical(viz);
118
+ const bars = connectorBars(shapes, (row)=>stepOf(viz, row), upright);
119
+ const level = upright ? (v)=>y(v) : (v)=>x(v);
120
+ return connectorNodes(connectorSegments(bars, level, upright), viz.schema.connectorConfig);
121
+ };
122
+ const preDraw = viz._preDraw.bind(viz);
123
+ viz._preDraw = ()=>{
124
+ resetSteps(viz);
125
+ syncCategorySort(viz);
126
+ preDraw();
127
+ const rows = viz._filteredData || [];
128
+ viz._legendData = waterfallKinds(rows.map((d)=>stepOf(viz, d))).map((kind)=>({
129
+ [KIND_KEY]: kind
130
+ }));
131
+ };
132
+ },
133
+ ctx: {},
134
+ fields: [
135
+ /** Draws a thin line from the end of each bar to the start of the next. */ {
136
+ key: "connectors",
137
+ default: true
138
+ },
139
+ /**
140
+ Fill for bars that lower the running total. Defaults to `colorDefaults.off`.
141
+ @type {CssColor | function}
142
+ */ {
143
+ key: "decreaseColor"
144
+ },
145
+ /**
146
+ Fill for bars that raise the running total. Defaults to `colorDefaults.on`.
147
+ @type {CssColor | function}
148
+ */ {
149
+ key: "increaseColor"
150
+ },
151
+ /** Shows the legend when it has more than one kind of bar. */ {
152
+ key: "legend",
153
+ coerce: "const",
154
+ factory: ()=>(_config, arr)=>arr.length > 1
155
+ },
156
+ {
157
+ key: "stacked",
158
+ default: true
159
+ },
160
+ /**
161
+ Marks subtotal rows (a data key or accessor; truthy marks the row).
162
+ A subtotal bar draws from zero to the running total. When the row
163
+ has its own value, the running total resets to that value.
164
+ */ {
165
+ key: "subtotal",
166
+ coerce: (v)=>typeof v === "string" ? accessor(v) : typeof v === "function" ? v : undefined
167
+ },
168
+ /**
169
+ Fill for subtotal bars. Defaults to `colorDefaults.sequential`.
170
+ @type {CssColor | function}
171
+ */ {
172
+ key: "totalColor"
173
+ },
174
+ /**
175
+ Line styles for the connectors: `stroke`, `strokeWidth`,
176
+ `strokeOpacity`, and `strokeDasharray`. Each may be a function of the
177
+ row the connector leaves and its index.
178
+ */ {
179
+ key: "connectorConfig",
180
+ merge: true,
181
+ factory: (viz)=>({
182
+ stroke: ()=>backgroundInk(viz),
183
+ strokeDasharray: "",
184
+ strokeOpacity: 0.6,
185
+ strokeWidth: 1
186
+ })
187
+ },
188
+ {
189
+ key: "tooltipConfig",
190
+ merge: true,
191
+ factory: (viz)=>({
192
+ title: (d, i)=>tooltipTitle(viz, d, i),
193
+ tbody: (d)=>tooltipRows(stepOf(viz, d), valueFormat(viz), viz.schema.translate)
194
+ })
195
+ }
196
+ ]
197
+ };
198
+ /**
199
+ Creates a waterfall chart: one bar per category (`x`, or `y` with
200
+ `discrete("y")` for horizontal bars) whose value is the change it makes
201
+ to a running total. Each bar floats from where the previous bar ended;
202
+ rows marked by `subtotal` draw from zero to the running total. Bars are
203
+ colored as increases, decreases, or totals, and labeled with their change.
204
+ Each `groupBy` series keeps its own running total, drawn side by side.
205
+
206
+ The value axis includes zero by default. To zoom in on a bridge between
207
+ large totals (say 1,000 to 1,020), set a `yDomain` (`xDomain` for
208
+ horizontal bars) that stops short of zero, e.g. `yDomain([980])`: the
209
+ axis keeps zero behind a break, as BarChart does, and subtotal bars rise
210
+ from zero through it.
211
+ */ export default makeChart(waterfallDef, BarChart);