@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,52 @@
1
+ /**
2
+ Small multiples: draws a chart as a grid of panels, one per distinct
3
+ `facet` value, sharing one set of chart chrome.
4
+
5
+ Each panel's rows go through the chart's own data prep (rollup, legend
6
+ hide/solo, threshold) separately. The chart then draws once with no body,
7
+ to lay out its chrome (title, legend, colorScale, timeline, …) against
8
+ every panel's rows; the area left over is split into a grid; then the
9
+ chart's own body draw runs once per panel, against that panel's rows and
10
+ with the panel's chart area as its margins.
11
+ Each panel's nodes are wrapped in a group of their own (keys prefixed so
12
+ panels never collide) and the groups become the chart's scene. Because
13
+ every panel is drawn by the same chart instance, colors, hover, legend
14
+ hide/solo, and tooltips work across panels exactly as within one chart.
15
+
16
+ @module
17
+ */
18
+ import type { DataPoint } from "@d3plus/data";
19
+ import type { VizInstance } from "../viz/vizTypes.js";
20
+ import type { FacetCell, FacetValue, ResolvedFacetConfig } from "./facetConfig.js";
21
+ import type { FacetArea } from "./facetGrid.js";
22
+ import type { FacetLabels } from "./facetGutter.js";
23
+ import type { FacetTitle } from "./facetScene.js";
24
+ /** Margins that make `area` the chart area of a `viz`-sized surface. */
25
+ export declare function facetAreaMargin(viz: Pick<VizInstance, "schema">, area: FacetArea): VizInstance["_margin"];
26
+ /**
27
+ Which axes a panel labels: every axis labeled on every panel, and each
28
+ outer one (`true` for both) only along the grid's left/bottom edges.
29
+ */
30
+ export declare function panelLabels(cell: FacetCell, outer: boolean | FacetLabels): FacetLabels;
31
+ /** The panel titles' style: `titleConfig`, defaulting its color to contrast with the chart's background. */
32
+ export declare function facetTitleStyle(viz: Pick<VizInstance, "schema" | "_select">, config: ResolvedFacetConfig): Record<string, unknown>;
33
+ /** Each panel's title text (empty when titles are off). */
34
+ export declare function facetTitleTexts(config: Pick<ResolvedFacetConfig, "title">, panels: {
35
+ value: FacetValue;
36
+ data: DataPoint[];
37
+ }[]): string[];
38
+ /** The height every panel reserves for its title: the tallest title at its cell's width. */
39
+ export declare function facetTitleBand(viz: Pick<VizInstance, "schema">, texts: string[], cells: FacetCell[], style: Record<string, unknown>): number;
40
+ /** Where a panel's title goes: above its cell, across its base area. */
41
+ export declare function panelTitle(text: string, cell: FacetCell, base: FacetArea): FacetTitle;
42
+ /**
43
+ Draws `viz` as small multiples. Returns false (drawing nothing) when
44
+ there's nothing to split: no facet values, or no rows passing the
45
+ chart's filters.
46
+ */
47
+ export declare function drawFacets(viz: VizInstance): boolean;
48
+ /**
49
+ Draws the chart for this render: as small multiples when `facet` is set,
50
+ otherwise as one chart (with chrome placed inside it when it fits).
51
+ */
52
+ export declare function drawChart(viz: VizInstance): void;
@@ -0,0 +1,178 @@
1
+ /**
2
+ Small multiples: the `facet` / `facetConfig` config surface and the hooks a
3
+ chart can supply to tune how its panels are laid out and drawn.
4
+
5
+ @module
6
+ */
7
+ import type { DataPoint } from "@d3plus/data";
8
+ import type { SceneNode, Transform } from "@d3plus/render";
9
+ import type { FacetSides } from "./facetGutter.js";
10
+ import type { VizInstance } from "../viz/vizTypes.js";
11
+ /** A value that splits the data into panels. */
12
+ export type FacetValue = string | number | boolean | Date;
13
+ /** Reads a row's facet value. */
14
+ export type FacetAccessor = (d: DataPoint, i: number) => unknown;
15
+ /** Panel ordering: a named order, a comparator over facet values, or an explicit list of values. */
16
+ export type FacetSort = "ascending" | "descending" | "data" | ((a: FacetValue, b: FacetValue) => number) | FacetValue[];
17
+ /** Whether an axis is labeled only along the grid's outer edges (`"outer"`) or on every panel (`"all"`). */
18
+ export type FacetAxesMode = "outer" | "all";
19
+ /** `facetConfig.axes`: one mode for both axes, or a mode per axis. */
20
+ export type FacetAxes = FacetAxesMode | {
21
+ x?: FacetAxesMode;
22
+ y?: FacetAxesMode;
23
+ };
24
+ /** The object form of `facetConfig`. */
25
+ export type FacetConfig = {
26
+ /** Number of panel columns. Chosen automatically by default, to make the panels as large as the chart's shape allows. */
27
+ columns?: number;
28
+ /** Number of panel rows. Chosen automatically by default. */
29
+ rows?: number;
30
+ /** Space between panels, in pixels. */
31
+ padding?: number;
32
+ /** Panel order. Defaults to `"ascending"`. */
33
+ sort?: FacetSort;
34
+ /** Whether every panel shares one set of scales (`"shared"`) or fits its own (`"independent"`). Applies to charts with axes, where it defaults to `"shared"`, and to Funnel's stage widths and the value domains of PolarArea and RadialBar, where it defaults to `"independent"`. */
35
+ scales?: "shared" | "independent";
36
+ /** With shared scales, `"outer"` labels axes only along the grid's left and bottom edges; `"all"` labels every panel. An object sets each axis on its own (`{x: "all", y: "outer"}`): every panel then labels its x axis, only the left column labels its y axis, and the panels' plot areas line up. Defaults to `"outer"`, except on charts whose axis labels differ from panel to panel: BumpChart labels every axis on every panel, and Marimekko labels its categories on every panel and its 0–100% share axis only on the outer edge, even with independent scales. */
37
+ axes?: FacetAxes;
38
+ /** Each panel's title: a function of the panel's facet value and rows, or `false` to hide panel titles. */
39
+ title?: false | ((value: FacetValue, data: DataPoint[]) => string);
40
+ /** TextBox config for the panel titles (`fontSize`, `fontColor`, `fontWeight`, `textAnchor`, `padding`, …). */
41
+ titleConfig?: Record<string, unknown>;
42
+ };
43
+ /** `facetConfig` with every option resolved. */
44
+ export interface ResolvedFacetConfig {
45
+ columns?: number;
46
+ rows?: number;
47
+ padding: number;
48
+ sort: FacetSort;
49
+ /** Undefined defers to the chart's default (`FacetHooks.scales`). */
50
+ scales?: "shared" | "independent";
51
+ /** Undefined (or an axis left out) defers to the chart's default (`FacetHooks.axes`). */
52
+ axes?: FacetAxes;
53
+ /** `false` hides panel titles; undefined draws the default (the formatted facet value). */
54
+ title?: false | ((value: FacetValue, data: DataPoint[]) => string);
55
+ titleConfig: Record<string, unknown>;
56
+ }
57
+ /** Which edges of the grid a panel sits on. A panel with no panel below it is on the bottom edge. */
58
+ export interface FacetEdges {
59
+ top: boolean;
60
+ right: boolean;
61
+ bottom: boolean;
62
+ left: boolean;
63
+ }
64
+ /** One panel's place in the grid, in surface pixels (title included). */
65
+ export interface FacetCell {
66
+ index: number;
67
+ row: number;
68
+ column: number;
69
+ x: number;
70
+ y: number;
71
+ width: number;
72
+ height: number;
73
+ edges: FacetEdges;
74
+ }
75
+ /** What a chart's per-panel hook is told about the panel about to draw. */
76
+ export interface FacetPanelContext {
77
+ cell: FacetCell;
78
+ /** Whether panels share scales this draw. */
79
+ shared: boolean;
80
+ /** Whether this panel labels its axes (see `FacetConfig.axes`). */
81
+ labels: {
82
+ x: boolean;
83
+ y: boolean;
84
+ };
85
+ /** The value `FacetHooks.share` returned, when it ran. */
86
+ scales: unknown;
87
+ }
88
+ /**
89
+ Chart-specific small-multiple behavior. Every hook is optional: a chart
90
+ with none draws each panel exactly as it draws a whole chart, at the
91
+ default panel aspect.
92
+ */
93
+ export interface FacetHooks {
94
+ /** The panel width/height ratio the chart reads best at, used to pick the grid shape. */
95
+ aspect?: number;
96
+ /** The chart's default for `FacetConfig.scales` (`"shared"` when unset). */
97
+ scales?: "shared" | "independent";
98
+ /** The chart's default for `FacetConfig.axes` (`"outer"` when unset), or a function of the chart returning it. */
99
+ axes?: FacetAxes | ((viz: VizInstance) => FacetAxes);
100
+ /**
101
+ The axes that read the same in every panel even when panels fit their
102
+ own scales (`scales: "independent"`), such as Marimekko's 0–100% share
103
+ axis. Set to `"outer"`, these still label only the grid's outer edges.
104
+ */
105
+ fixedAxes?: (viz: VizInstance) => {
106
+ x?: boolean;
107
+ y?: boolean;
108
+ };
109
+ /** Computes the scales every panel shares from each panel's rows (one array per panel). Runs before any panel draws, when scales are shared. */
110
+ share?: (viz: VizInstance, panels: DataPoint[][]) => unknown;
111
+ /** Applies a panel's overrides before it draws; returns a function undoing them. */
112
+ panel?: (viz: VizInstance, ctx: FacetPanelContext) => () => void;
113
+ /**
114
+ The plot area's insets from the chart area (pixels, per side) for the
115
+ panel just drawn. With shared scales and outer axis labels, probe
116
+ panels drawn with each combination of labeled axes are measured with
117
+ it, so every panel's plot area comes out the same size (see
118
+ `facet/facetGutter.ts`).
119
+ */
120
+ insets?: (viz: VizInstance) => FacetSides;
121
+ /**
122
+ Adds the chart's own nodes to a panel's chart nodes, right after the
123
+ panel draws (with its state still in place), and returns the panel's
124
+ nodes. For chrome a chart layers onto its scene outside `_chartScene`
125
+ (in a `toScene` override), which the composed small-multiples scene
126
+ would otherwise draw once for the whole chart, or not at all.
127
+ */
128
+ scene?: (viz: VizInstance, nodes: SceneNode[]) => SceneNode[];
129
+ /** Captures the chart state (viz slots, by name) a panel puts back while the pointer is over it, for hover and tooltips (see `facet/facetPanel.ts`). */
130
+ capture?: (viz: VizInstance) => Record<string, unknown>;
131
+ }
132
+ /** State held for each drawn panel, read back while the pointer is over it. */
133
+ export interface FacetPanelState {
134
+ key: string;
135
+ value: FacetValue;
136
+ cell: FacetCell;
137
+ /** The chart area the panel drew in, in surface pixels. */
138
+ area: {
139
+ x: number;
140
+ y: number;
141
+ width: number;
142
+ height: number;
143
+ };
144
+ chartTransform?: Transform;
145
+ /** The panel's own chart nodes (before key prefixing). */
146
+ scene: SceneNode[];
147
+ /** Chart state captured by `FacetHooks.capture`. */
148
+ state: Record<string, unknown>;
149
+ }
150
+ /** Default panel title style: smaller than the chart title, centered over its panel. */
151
+ export declare const FACET_TITLE_DEFAULTS: Record<string, unknown>;
152
+ /** Default space between panels, in pixels. */
153
+ export declare const FACET_PADDING = 20;
154
+ /** Default panel aspect (width / height) for charts that don't set one. */
155
+ export declare const FACET_ASPECT: number;
156
+ /**
157
+ Coerces a `facet` setter argument: a string becomes a key accessor, a
158
+ function is kept, and anything else (`false`, `undefined`) turns faceting off.
159
+ */
160
+ export declare function coerceFacet(value: unknown): FacetAccessor | undefined;
161
+ /** `facetConfig` with defaults filled in. */
162
+ export declare function resolveFacetConfig(config: FacetConfig | undefined): ResolvedFacetConfig;
163
+ /** A `facetConfig.axes` value with invalid modes dropped (an object keeps its valid axes). */
164
+ export declare function resolveFacetAxes(value: unknown): FacetAxes | undefined;
165
+ /**
166
+ Which axes label only the grid's outer edges this draw, per axis:
167
+ `facetConfig.axes`, else the chart's default, else `"outer"`, and only
168
+ while panels share scales or the chart says the axis reads the same in
169
+ every panel anyway (`FacetHooks.fixedAxes`).
170
+ */
171
+ export declare function facetOuterAxes(viz: VizInstance, config: Pick<ResolvedFacetConfig, "axes">, hooks: Pick<FacetHooks, "axes" | "fixedAxes">, shared: boolean): {
172
+ x: boolean;
173
+ y: boolean;
174
+ };
175
+ /** Whether panels share scales: `facetConfig.scales`, else the chart's default, else shared. */
176
+ export declare function facetScalesShared(config: Pick<ResolvedFacetConfig, "scales">, hooks: Pick<FacetHooks, "scales">): boolean;
177
+ /** Whether `viz` splits its data into small multiples this draw. */
178
+ export declare function facetActive(viz: Pick<VizInstance, "schema">): boolean;
@@ -0,0 +1,47 @@
1
+ /**
2
+ Small multiples: splitting a chart's data into one group of rows per facet
3
+ value, in panel order, and preparing each group the way the chart prepares
4
+ its whole dataset.
5
+
6
+ @module
7
+ */
8
+ import type { DataPoint } from "@d3plus/data";
9
+ import { computeTimeFilter } from "../pipeline/preDrawData.js";
10
+ import type { VizInstance } from "../viz/vizTypes.js";
11
+ import type { FacetAccessor, FacetSort, FacetValue } from "./facetConfig.js";
12
+ /** One panel's facet value and raw rows. */
13
+ export interface FacetGroup {
14
+ key: string;
15
+ value: FacetValue;
16
+ rows: DataPoint[];
17
+ }
18
+ /** A facet value as a comparable string key (dates compare by time). */
19
+ export declare function facetKey(value: unknown): string;
20
+ /** Narrows an accessor result to a facet value; arrays and objects become text. */
21
+ export declare function toFacetValue(value: unknown): FacetValue | undefined;
22
+ /** Natural order: numbers and dates numerically, text alphabetically (with embedded numbers compared as numbers). */
23
+ export declare function compareFacetValues(a: FacetValue, b: FacetValue): number;
24
+ /** Orders facet values (given in data order) by a `FacetSort`. */
25
+ export declare function sortFacetValues(values: FacetValue[], sort: FacetSort): FacetValue[];
26
+ /**
27
+ Groups `rows` by facet value, in panel order. Rows without a facet value
28
+ are left out of every panel.
29
+ */
30
+ export declare function groupFacets(rows: DataPoint[], facet: FacetAccessor, sort: FacetSort): FacetGroup[];
31
+ /**
32
+ The facet groups for `viz`: every facet value in its data (after the
33
+ chart's own `filter`, so the grid doesn't reflow as the timeline moves or
34
+ legend items are toggled).
35
+ */
36
+ export declare function facetGroups(viz: VizInstance, sort: FacetSort): FacetGroup[];
37
+ /**
38
+ One panel's drawable rows: `rows` run through the same time filter,
39
+ rollup, legend hide/solo, and threshold the chart applies to its whole
40
+ dataset. `timeFilter` is computed once from the whole dataset, so every
41
+ panel shows the same period.
42
+ */
43
+ export declare function facetFilteredData(viz: VizInstance, rows: DataPoint[], timeFilter: ReturnType<typeof computeTimeFilter>): DataPoint[];
44
+ /** The time filter every panel shares (see `facetFilteredData`). */
45
+ export declare function facetTimeFilter(viz: VizInstance): ReturnType<typeof computeTimeFilter>;
46
+ /** A panel's default title: its facet value, with dates formatted against every panel's date. */
47
+ export declare function formatFacetValue(value: FacetValue, values: FacetValue[]): string;
@@ -0,0 +1,62 @@
1
+ /**
2
+ Small multiples: the panel grid. Pure layout math — no chart state.
3
+
4
+ @module
5
+ */
6
+ import type { FacetCell } from "./facetConfig.js";
7
+ /** The box the grid fills, in surface pixels. */
8
+ export interface FacetArea {
9
+ x: number;
10
+ y: number;
11
+ width: number;
12
+ height: number;
13
+ }
14
+ /** Inputs to the grid layout. */
15
+ export interface FacetGridOptions {
16
+ /** Fixed column count, if any. */
17
+ columns?: number;
18
+ /** Fixed row count, if any. */
19
+ rows?: number;
20
+ /** Space between panels. */
21
+ padding: number;
22
+ /** Space between columns, when it differs from `padding` (room for axis labels that overhang a panel's sides). */
23
+ columnPadding?: number;
24
+ /** Height of each panel's title band (part of the panel). */
25
+ titleHeight: number;
26
+ /** The panel width/height ratio the chart reads best at. */
27
+ aspect: number;
28
+ /** Extra width for the left and right columns and extra height for the bottom edge (axis labels only those panels draw). */
29
+ gutter?: {
30
+ left: number;
31
+ right: number;
32
+ bottom: number;
33
+ };
34
+ }
35
+ /**
36
+ How large a chart of `aspect` can draw in a `width` × `height` box: the
37
+ area of the biggest `aspect`-shaped rect that fits.
38
+ */
39
+ export declare function fittedArea(width: number, height: number, aspect: number): number;
40
+ /**
41
+ The grid's column and row counts for `count` panels. A fixed `columns`
42
+ and/or `rows` is honored (rows grow if the two can't hold every panel);
43
+ otherwise the column count that lets an `aspect`-shaped chart draw
44
+ largest wins, preferring fewer empty cells, then the panel shape closest
45
+ to `aspect`.
46
+ */
47
+ export declare function facetDimensions(count: number, area: {
48
+ width: number;
49
+ height: number;
50
+ }, opts: FacetGridOptions): {
51
+ columns: number;
52
+ rows: number;
53
+ };
54
+ /**
55
+ Lays `count` panels out left-to-right, top-to-bottom in `area`. Every
56
+ panel is the same size, except that the left and right columns are
57
+ widened by `gutter.left` and `gutter.right` and the panels on the bottom
58
+ edge (those with no panel below them) are deepened by `gutter.bottom`, so
59
+ panels that draw axis labels the others skip keep the same plot area. A
60
+ bottom-edge panel above an empty cell reaches into that cell's space.
61
+ */
62
+ export declare function facetGrid(count: number, area: FacetArea, opts: FacetGridOptions): FacetCell[];
@@ -0,0 +1,68 @@
1
+ /**
2
+ Small multiples: keeping every panel's plot area the same size when only
3
+ some panels label their axes. Pure layout math over measured insets.
4
+
5
+ A panel that labels an axis needs room for those labels (and for tick
6
+ labels that overhang the plot's ends) that a bare panel doesn't. The grid
7
+ reserves that room on its outer edges (the gutter), every panel gets the
8
+ same base area, and a panel drawing labels takes a chart area grown past
9
+ its base by exactly the room its labels need, so its plot area lands on
10
+ the base area's plot area.
11
+
12
+ @module
13
+ */
14
+ import type { FacetCell } from "./facetConfig.js";
15
+ import type { FacetArea } from "./facetGrid.js";
16
+ /** A pixel amount for each side of a box. */
17
+ export interface FacetSides {
18
+ top: number;
19
+ right: number;
20
+ bottom: number;
21
+ left: number;
22
+ }
23
+ /** Which axes a panel labels. */
24
+ export interface FacetLabels {
25
+ x: boolean;
26
+ y: boolean;
27
+ }
28
+ /** No room on any side. */
29
+ export declare const NO_SIDES: FacetSides;
30
+ /** Every combination of labeled axes a panel can draw. */
31
+ export declare const LABEL_COMBOS: FacetLabels[];
32
+ /** A label combination as a lookup key. */
33
+ export declare function labelKey(labels: FacetLabels): string;
34
+ /**
35
+ How far each label combination's plot insets (measured from probe panels,
36
+ keyed by `labelKey`) exceed the `baseline` panel's, per side, never
37
+ negative. The baseline is the bare panel, or, when an axis is labeled on
38
+ every panel, the panel labeling that axis alone.
39
+ */
40
+ export declare function labelExpansions(insets: Record<string, FacetSides>, baseline?: FacetLabels): Record<string, FacetSides>;
41
+ /**
42
+ The room the grid reserves on its outer edges: the y-labeled panels'
43
+ extra room on the left, the x-labeled panels' on the bottom, and the most
44
+ any panel needs above and to the right (tick labels overhanging the
45
+ plot's top and right ends).
46
+ */
47
+ export declare function labelGutter(expansions: Record<string, FacetSides>): FacetSides;
48
+ /**
49
+ A panel's base area, the same size for every panel: its cell below the
50
+ title band, less the gutter the grid added to the cell's outer edges.
51
+ */
52
+ export declare function panelBase(cell: FacetCell, titleHeight: number, gutter: FacetSides, columns: number): FacetArea;
53
+ /**
54
+ Per-panel room that lines up the panels' plot areas when each panel
55
+ labels an axis of its own (see `FacetConfig.axes`): from how far each
56
+ panel's plot sits in from its base area on each side (`insets`), how far
57
+ each panel's chart area must grow (never positive) for every plot to sit
58
+ as far in as the furthest.
59
+ */
60
+ export declare function alignInsets(insets: FacetSides[]): FacetSides[];
61
+ /** `area` grown by `sides`. */
62
+ export declare function expandArea(area: FacetArea, sides: FacetSides): FacetArea;
63
+ /**
64
+ The extra space between columns that keeps x-axis labels overhanging a
65
+ panel's left and right ends (a point scale's first and last labels) clear
66
+ of the next panel's: the most any x-labeled panel overhangs on each side.
67
+ */
68
+ export declare function labelOverhang(expansions: Record<string, FacetSides>): number;
@@ -0,0 +1,24 @@
1
+ /**
2
+ Small multiples at interaction time: finding the panel under the pointer
3
+ and temporarily restoring that panel's chart state, so hover, tooltip,
4
+ and click code written for a single chart reads the panel it's over.
5
+
6
+ @module
7
+ */
8
+ import type { VizInstance } from "../viz/vizTypes.js";
9
+ import type { FacetPanelState } from "./facetConfig.js";
10
+ /**
11
+ The drawn panel whose cell contains `point` (surface pixels, before any
12
+ zoom transform), or undefined over the gaps between panels or when the
13
+ chart isn't faceted.
14
+ */
15
+ export declare function facetPanelAt(viz: Pick<VizInstance, "_facetPanels" | "_zoomTransform">, point: [number, number] | undefined): FacetPanelState | undefined;
16
+ /**
17
+ Runs `fn` with `panel`'s chart state in place of the composed chart's,
18
+ then puts the composed state back — except in slots `fn` itself
19
+ reassigned (a handler that redraws the chart keeps its new draw).
20
+ Without a panel, just runs `fn`.
21
+ */
22
+ export declare function withFacetPanel<T>(viz: VizInstance, panel: FacetPanelState | undefined, fn: () => T): T;
23
+ /** Clears the per-panel slots on the composed chart, so nothing reads one panel's state as the whole chart's. */
24
+ export declare function clearPanelSlots(viz: VizInstance, panels: FacetPanelState[]): void;
@@ -0,0 +1,39 @@
1
+ /**
2
+ Small multiples: the scene nodes for each panel — its title and its chart
3
+ nodes — composed into one group per panel.
4
+
5
+ @module
6
+ */
7
+ import type { ClipShape, SceneNode, Transform } from "@d3plus/render";
8
+ /** A panel's title, ready to measure and draw. */
9
+ export interface FacetTitle {
10
+ text: string;
11
+ x: number;
12
+ y: number;
13
+ width: number;
14
+ }
15
+ /**
16
+ Returns a copy of `nodes` with every key (at any depth) prefixed by
17
+ `prefix` (or mapped through it, when it's a function), so panels drawing
18
+ the same series keep distinct keys: the renderers key clip paths,
19
+ overlays, and hover state by node key.
20
+ */
21
+ export declare function prefixKeys(nodes: SceneNode[], prefix: string | ((key: string) => string)): SceneNode[];
22
+ /**
23
+ The height of the tallest panel title (lines × line height, plus the
24
+ title's padding above and below), or 0 when there are none.
25
+ */
26
+ export declare function measureFacetTitles(titles: FacetTitle[], config: Record<string, unknown>, locale?: string): number;
27
+ /**
28
+ One text node per panel title, offset by the title padding. Titles are
29
+ chrome: they carry no datum and take no pointer events.
30
+ */
31
+ export declare function facetTitleNodes(titles: FacetTitle[], config: Record<string, unknown>, locale?: string): SceneNode[];
32
+ /**
33
+ Wraps one panel's chart nodes the way `Viz.toScene` wraps a whole chart's:
34
+ an untransformed group carrying the chart's clip (in surface pixels)
35
+ around a group carrying its chart transform.
36
+ */
37
+ export declare function facetBodyNode(key: string, nodes: SceneNode[], transform?: Transform, clip?: ClipShape): SceneNode;
38
+ /** A panel's group: its chart nodes, then its title, with the panel title as its accessible name. */
39
+ export declare function facetPanelNode(key: string, title: SceneNode | undefined, body: SceneNode | undefined, label: string): SceneNode;
@@ -13,9 +13,9 @@
13
13
 
14
14
  The module exposes the joint solve as two halves:
15
15
 
16
- - `measureAxes` — the MEASURE half: throwaway test axes measure label
17
- widths/heights, the coupled offsets are solved
18
- (`xOffsetLeft = max([yWidth, …])`, `x2Height`, `topOffset`,
16
+ - `measureAxes` (in `axesMeasure.ts`) — the MEASURE half: throwaway
17
+ test axes measure label widths/heights, the coupled offsets are
18
+ solved (`xOffsetLeft = max([yWidth, …])`, `x2Height`, `topOffset`,
19
19
  `xHeight`), and the four-side claim is written to `viz._padding.*`
20
20
  and returned. Runs BEFORE the base `Viz` draw finalizes margins.
21
21
  The line-label width measure interleaves mid-solve via an injected
@@ -35,92 +35,8 @@
35
35
 
36
36
  @module
37
37
  */
38
- import type Axis from "../../components/Axis/Axis.js";
39
- import type { LabelWidth, PlotMeasureResult, PlotPaintContext } from "./plotPaint.js";
38
+ import type { PlotMeasureResult, PlotPaintContext } from "./plotPaint.js";
40
39
  import type { VizInstance as Viz } from "../viz/vizTypes.js";
41
- /** A measured axis's outer bounding box. */
42
- type AxisBounds = {
43
- width: number;
44
- height: number;
45
- x: number;
46
- y: number;
47
- };
48
- /**
49
- The line-label measurement the joint solve interleaves between the first
50
- and second x-axis measure passes. Plot supplies this via a callback that
51
- runs the `measurePlotLineLabels` pipeline stage; a consumer with no line
52
- labels returns empty widths and an undefined `xRangeMax`.
53
- */
54
- export interface LineLabelMeasurement {
55
- labelWidths: LabelWidth[];
56
- largestLabel: number | undefined;
57
- xRangeMax: number | undefined;
58
- }
59
- /**
60
- The stable per-draw inputs the joint margin solve reads — exactly the
61
- values the Plot pipeline stages (`computePlotScales`,
62
- `preparePlotAxisLayout`) already produce. The four `*Test` axes are
63
- throwaway instances the caller allocates per draw; `measureAxes`
64
- configures and measures them, then the caller discards them.
65
- */
66
- export interface AxisMeasureInputs {
67
- xTest: Axis;
68
- yTest: Axis;
69
- x2Test: Axis;
70
- y2Test: Axis;
71
- xDomain: number[];
72
- x2Domain: number[];
73
- yDomain: number[];
74
- y2Domain: number[];
75
- xTicks: unknown[] | null;
76
- x2Ticks: unknown[] | null;
77
- yTicks: unknown[] | null;
78
- y2Ticks: unknown[] | null;
79
- xConfigScale: string;
80
- x2ConfigScale: string;
81
- yConfigScale: string;
82
- y2ConfigScale: string;
83
- defaultX2Config: Record<string, unknown>;
84
- defaultY2Config: Record<string, unknown>;
85
- yC: Record<string, unknown>;
86
- showX: boolean;
87
- showY: boolean;
88
- x2Exists: boolean;
89
- y2Exists: boolean;
90
- height: number;
91
- width: number;
92
- xData: unknown[];
93
- /** `x.padding()` when the x scale is banded, else 0 — feeds the x config. */
94
- xScalePadding: number;
95
- }
96
- /** The four-side margin claim + offsets the joint solve produces. */
97
- export interface AxisMeasureResult {
98
- yBounds: AxisBounds;
99
- y2Bounds: AxisBounds;
100
- yWidth: number | undefined;
101
- y2Width: number | undefined;
102
- xC: Record<string, unknown>;
103
- xRangeMax: number | undefined;
104
- labelWidths: LabelWidth[];
105
- largestLabel: number | undefined;
106
- xTestRange: number[];
107
- x2TestRange: number[];
108
- x2Height: number;
109
- xOffsetLeft: number;
110
- xOffsetRight: number;
111
- topOffset: number;
112
- xHeight: number;
113
- }
114
- /**
115
- MEASURE half of the joint axis solve. Configures + measures the four
116
- throwaway test axes, solves the coupled offsets, writes the resulting
117
- four-side claim to `viz._padding.*`, and returns the offsets + the
118
- measured bounds + the line-label measurement for the paint phase.
119
-
120
- `measureLineLabels` is invoked once, after the first x-axis measure and
121
- before the re-measure, so its `xRangeMax` can re-bound the x range.
122
- */
123
- export declare function measureAxes(viz: Viz, inputs: AxisMeasureInputs, measureLineLabels: () => LineLabelMeasurement): AxisMeasureResult;
124
40
  /**
125
41
  Render the production axes and solve the final ranges/offsets.
126
42
 
@@ -131,4 +47,3 @@ export declare function measureAxes(viz: Viz, inputs: AxisMeasureInputs, measure
131
47
  Returns everything `plotEmit` needs to consume.
132
48
  */
133
49
  export declare function renderAxes(viz: Viz, pCtx: PlotPaintContext, frozen?: PlotMeasureResult): PlotMeasureResult;
134
- export {};
@@ -0,0 +1,66 @@
1
+ /**
2
+ The final half of the Plot-family axes' joint solve (see `axes.ts`): once
3
+ the chrome has taken its margins, the y/y2 axes are measured again
4
+ against the plot's height, and the x axis's labels against its final
5
+ width, so the plot and its axes meet.
6
+
7
+ @module
8
+ */
9
+ import type Axis from "../../components/Axis/Axis.js";
10
+ import type { PlotMeasureResult, PlotPaintContext } from "./plotPaint.js";
11
+ import type { VizInstance as Viz } from "../viz/vizTypes.js";
12
+ /** A measured axis's outer bounding box. */
13
+ export type AxisBounds = {
14
+ width: number;
15
+ height: number;
16
+ x: number;
17
+ y: number;
18
+ };
19
+ /** The y/y2 bounds + claimed widths a y-axis measure pass produces. */
20
+ export type YAxisMeasure = {
21
+ yBounds: AxisBounds;
22
+ yWidth: number | undefined;
23
+ y2Bounds: AxisBounds;
24
+ y2Width: number | undefined;
25
+ };
26
+ /** The final y-axis solve: its bounds and widths, and the x range's offsets. */
27
+ type FinalYAxes = YAxisMeasure & {
28
+ xOffsetLeft: number;
29
+ xOffsetRight: number;
30
+ };
31
+ /**
32
+ The room the plot leaves on its right for the y2 axis and for the x/x2
33
+ axes' last labels, once those axes start at `xOffsetLeft`. The x and x2
34
+ test axes are re-measured from there: where an axis starts decides its
35
+ ticks, and so which label is last and how far it reaches past the
36
+ range's end.
37
+ */
38
+ export declare function xRightInset(axes: {
39
+ xTest: Axis;
40
+ x2Test: Axis;
41
+ showX: boolean;
42
+ x2Exists: boolean;
43
+ xRangeMax: number | undefined;
44
+ width: number;
45
+ }, xOffsetLeft: number, y2Width: number | undefined): number;
46
+ /**
47
+ The y/y2 axes' final solve, and the plot's y range, once the chrome has
48
+ taken its margins. A `frozen` layout (a zoom repaint) keeps the previous
49
+ draw's axis sizes and plot rect, so changing tick labels can't make the
50
+ plot area jump mid-gesture; the axes still re-render their ticks for the
51
+ new domains.
52
+
53
+ The x labels claimed their height across the chart area as it stood
54
+ before the chrome (a legend beside the plot) took its margins. Measured
55
+ again across the final range, labels that wrap onto more or fewer lines
56
+ resize the plot, so the x axis sits right beneath it; the returned
57
+ `pCtx` carries that height.
58
+ */
59
+ export declare function solveFinalAxes(viz: Viz, pCtx: PlotPaintContext, frozen?: PlotMeasureResult): {
60
+ pCtx: PlotPaintContext;
61
+ yRange: number[];
62
+ yBottom: number;
63
+ insetBottom: number;
64
+ solved: FinalYAxes;
65
+ };
66
+ export {};