@d3plus/core 4.9.0 → 4.11.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 (687) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +170 -9
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +170 -0
  9. package/es/src/charts/Alluvial/layout.js +137 -0
  10. package/es/src/charts/Alluvial/meta.js +57 -0
  11. package/es/src/charts/Alluvial/titles.js +81 -0
  12. package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
  13. package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
  14. package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
  15. package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
  16. package/es/src/charts/ArcDiagram/emit.js +178 -0
  17. package/es/src/charts/ArcDiagram/events.js +144 -0
  18. package/es/src/charts/ArcDiagram/index.js +215 -0
  19. package/es/src/charts/BarChart/index.js +14 -2
  20. package/es/src/charts/BoxWhisker/index.js +95 -4
  21. package/es/src/charts/BoxWhisker/outliers.js +68 -0
  22. package/es/src/charts/BoxWhisker/summary.js +83 -0
  23. package/es/src/charts/BoxWhisker/tooltip.js +122 -0
  24. package/es/src/charts/BubbleChart/emit.js +31 -0
  25. package/es/src/charts/BubbleChart/index.js +54 -0
  26. package/es/src/charts/Bullet/index.js +2 -1
  27. package/es/src/charts/BumpChart/index.js +5 -0
  28. package/es/src/charts/Calendar/emit.js +1 -1
  29. package/es/src/charts/Calendar/index.js +5 -3
  30. package/es/src/charts/Candlestick/aggregate.js +11 -1
  31. package/es/src/charts/Candlestick/buffer.js +6 -4
  32. package/es/src/charts/Candlestick/index.js +7 -6
  33. package/es/src/charts/Chord/applyLayout.js +56 -69
  34. package/es/src/charts/Chord/emit.js +55 -24
  35. package/es/src/charts/Chord/index.js +17 -12
  36. package/es/src/charts/Chord/labels.js +105 -0
  37. package/es/src/charts/Donut/index.js +5 -11
  38. package/es/src/charts/Dumbbell/index.js +2 -4
  39. package/es/src/charts/Funnel/index.js +2 -1
  40. package/es/src/charts/Gantt/applyLayout.js +162 -0
  41. package/es/src/charts/Gantt/emit.js +142 -0
  42. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  43. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  44. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  45. package/es/src/charts/Gantt/ganttRows.js +111 -0
  46. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  47. package/es/src/charts/Gantt/index.js +219 -0
  48. package/es/src/charts/Gauge/index.js +2 -1
  49. package/es/src/charts/Geomap/applyLayout.js +90 -49
  50. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  51. package/es/src/charts/Geomap/emit.js +19 -2
  52. package/es/src/charts/Geomap/flowEmit.js +132 -0
  53. package/es/src/charts/Geomap/flowEvents.js +86 -0
  54. package/es/src/charts/Geomap/flowFields.js +91 -0
  55. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  56. package/es/src/charts/Geomap/flowLinks.js +239 -0
  57. package/es/src/charts/Geomap/geoCache.js +180 -0
  58. package/es/src/charts/Geomap/globeKeys.js +131 -0
  59. package/es/src/charts/Geomap/globeRotate.js +208 -0
  60. package/es/src/charts/Geomap/index.js +60 -19
  61. package/es/src/charts/Geomap/pointLabels.js +107 -0
  62. package/es/src/charts/Hexbin/binning.js +103 -0
  63. package/es/src/charts/Hexbin/buffer.js +33 -0
  64. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  65. package/es/src/charts/Hexbin/contours.js +48 -0
  66. package/es/src/charts/Hexbin/emit.js +142 -0
  67. package/es/src/charts/Hexbin/index.js +204 -0
  68. package/es/src/charts/Hexbin/layers.js +212 -0
  69. package/es/src/charts/Hexbin/settings.js +86 -0
  70. package/es/src/charts/Hexbin/tooltip.js +77 -0
  71. package/es/src/charts/Histogram/binData.js +31 -4
  72. package/es/src/charts/Histogram/index.js +37 -16
  73. package/es/src/charts/Histogram/labels.js +18 -0
  74. package/es/src/charts/Icicle/index.js +3 -3
  75. package/es/src/charts/LinePlot/index.js +7 -0
  76. package/es/src/charts/Marimekko/index.js +7 -4
  77. package/es/src/charts/Matrix/index.js +3 -2
  78. package/es/src/charts/Network/applyLayout.js +138 -94
  79. package/es/src/charts/Network/bundle.js +81 -0
  80. package/es/src/charts/Network/clusterLabels.js +423 -0
  81. package/es/src/charts/Network/clusters.js +290 -0
  82. package/es/src/charts/Network/emit.js +253 -70
  83. package/es/src/charts/Network/graph.js +117 -0
  84. package/es/src/charts/Network/graphFluent.js +79 -0
  85. package/es/src/charts/Network/index.js +93 -108
  86. package/es/src/charts/Network/minNodeDistance.js +64 -0
  87. package/es/src/charts/Network/polygonRows.js +44 -0
  88. package/es/src/charts/Pack/index.js +7 -2
  89. package/es/src/charts/Pie/applyLayout.js +86 -27
  90. package/es/src/charts/Pie/arcFit.js +152 -0
  91. package/es/src/charts/Pie/curvedLabels.js +134 -0
  92. package/es/src/charts/Pie/emit.js +43 -96
  93. package/es/src/charts/Pie/index.js +66 -32
  94. package/es/src/charts/Pie/labelRoom.js +154 -0
  95. package/es/src/charts/Pie/outsideLabels.js +224 -0
  96. package/es/src/charts/Pie/outsideNodes.js +267 -0
  97. package/es/src/charts/Pie/pieLabels.js +137 -0
  98. package/es/src/charts/Pie/sectorBox.js +223 -0
  99. package/es/src/charts/Pie/straightLabels.js +96 -0
  100. package/es/src/charts/Pie/straightLayout.js +215 -0
  101. package/es/src/charts/Plot/alongLegend.js +76 -0
  102. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  103. package/es/src/charts/Plot/axisHover.js +180 -0
  104. package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
  105. package/es/src/charts/Plot/axisHoverScene.js +203 -0
  106. package/es/src/charts/Plot/axisValues.js +43 -0
  107. package/es/src/charts/Plot/barHitArea.js +81 -0
  108. package/es/src/charts/Plot/barLabelFit.js +123 -0
  109. package/es/src/charts/Plot/barWidth.js +61 -13
  110. package/es/src/charts/Plot/circleLabels.js +98 -0
  111. package/es/src/charts/Plot/confidenceConfig.js +2 -2
  112. package/es/src/charts/Plot/connectGaps.js +237 -0
  113. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  114. package/es/src/charts/Plot/draw.js +14 -4
  115. package/es/src/charts/Plot/fillBetween.js +2 -1
  116. package/es/src/charts/Plot/forecastScene.js +3 -4
  117. package/es/src/charts/Plot/index.js +42 -15
  118. package/es/src/charts/Plot/labelPlacement.js +10 -2
  119. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  120. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  121. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  122. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  123. package/es/src/charts/Plot/openDomainEnds.js +2 -5
  124. package/es/src/charts/Plot/pipeline.js +71 -22
  125. package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
  126. package/es/src/charts/Plot/pipelineDomains.js +23 -6
  127. package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
  128. package/es/src/charts/Plot/pipelineScales.js +40 -8
  129. package/es/src/charts/Plot/plotFacet.js +12 -1
  130. package/es/src/charts/Plot/plotInit.js +49 -5
  131. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  132. package/es/src/charts/Plot/plotZoom.js +15 -6
  133. package/es/src/charts/Plot/referenceDomains.js +133 -0
  134. package/es/src/charts/Plot/shapeDefaults.js +14 -9
  135. package/es/src/charts/Plot/sharedHoverScene.js +50 -31
  136. package/es/src/charts/Plot/sharedTooltip.js +19 -7
  137. package/es/src/charts/Plot/stackHelpers.js +13 -1
  138. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  139. package/es/src/charts/Plot/stackShareTooltip.js +9 -4
  140. package/es/src/charts/Plot/stackThreshold.js +154 -0
  141. package/es/src/charts/Plot/trendLabels.js +183 -0
  142. package/es/src/charts/Plot/trendLines.js +1 -0
  143. package/es/src/charts/Plot/trendScene.js +6 -3
  144. package/es/src/charts/Plot/trendTooltip.js +5 -1
  145. package/es/src/charts/PolarArea/index.js +5 -4
  146. package/es/src/charts/Priestley/applyLayout.js +14 -20
  147. package/es/src/charts/Priestley/index.js +4 -34
  148. package/es/src/charts/Priestley/timeAxis.js +100 -0
  149. package/es/src/charts/Pyramid/index.js +4 -2
  150. package/es/src/charts/Radar/axisDecorations.js +49 -12
  151. package/es/src/charts/Radar/curvedLabels.js +187 -0
  152. package/es/src/charts/Radar/index.js +5 -5
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +4 -1
  155. package/es/src/charts/RadialBar/index.js +18 -10
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/index.js +6 -9
  158. package/es/src/charts/Rings/applyLayout.js +41 -24
  159. package/es/src/charts/Rings/emit.js +174 -58
  160. package/es/src/charts/Rings/index.js +65 -30
  161. package/es/src/charts/Rings/ringsGraph.js +28 -9
  162. package/es/src/charts/Rings/ringsLoops.js +73 -0
  163. package/es/src/charts/Rings/ringsParallel.js +166 -0
  164. package/es/src/charts/Sankey/applyLayout.js +116 -39
  165. package/es/src/charts/Sankey/circularLayout.js +208 -0
  166. package/es/src/charts/Sankey/circularLinks.js +301 -0
  167. package/es/src/charts/Sankey/emit.js +164 -94
  168. package/es/src/charts/Sankey/index.js +75 -77
  169. package/es/src/charts/Sankey/labels.js +80 -0
  170. package/es/src/charts/Sankey/ribbons.js +88 -0
  171. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  172. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  173. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  174. package/es/src/charts/Scatter/index.js +25 -0
  175. package/es/src/charts/SlopeChart/index.js +116 -0
  176. package/es/src/charts/SlopeChart/slope.js +95 -0
  177. package/es/src/charts/Streamgraph/index.js +51 -0
  178. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  179. package/es/src/charts/Sunburst/emit.js +74 -63
  180. package/es/src/charts/Sunburst/index.js +3 -3
  181. package/es/src/charts/Tree/index.js +2 -6
  182. package/es/src/charts/Treemap/applyLayout.js +14 -1
  183. package/es/src/charts/Treemap/emit.js +8 -2
  184. package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
  185. package/es/src/charts/Treemap/groupHeaders.js +95 -0
  186. package/es/src/charts/Treemap/index.js +17 -7
  187. package/es/src/charts/Treemap/thresholdFunction.js +11 -9
  188. package/es/src/charts/Violin/inner.js +3 -5
  189. package/es/src/charts/Waffle/index.js +4 -2
  190. package/es/src/charts/Waffle/tooltip.js +6 -2
  191. package/es/src/charts/Waterfall/index.js +4 -2
  192. package/es/src/charts/definition/makeChart.js +20 -5
  193. package/es/src/charts/drawSteps/backControl.js +17 -5
  194. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  195. package/es/src/charts/drawSteps/minimap.js +6 -5
  196. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  197. package/es/src/charts/drawSteps/saveChart.js +176 -0
  198. package/es/src/charts/drawSteps/saveControl.js +148 -0
  199. package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
  200. package/es/src/charts/drawSteps/searchControls.js +2 -1
  201. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  202. package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
  203. package/es/src/charts/drawSteps/topLeftControls.js +3 -1
  204. package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
  205. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  206. package/es/src/charts/events/click.legend.js +7 -2
  207. package/es/src/charts/events/click.shape.js +38 -2
  208. package/es/src/charts/events/mouseenter.js +9 -0
  209. package/es/src/charts/events/mousemove.legend.js +3 -0
  210. package/es/src/charts/events/mousemove.shape.js +12 -4
  211. package/es/src/charts/facet/drawFacets.js +14 -5
  212. package/es/src/charts/facet/facetConfig.js +2 -2
  213. package/es/src/charts/facet/facetData.js +2 -2
  214. package/es/src/charts/features/annotationFrame.js +179 -0
  215. package/es/src/charts/features/annotationText.js +83 -0
  216. package/es/src/charts/features/annotationTypes.js +10 -0
  217. package/es/src/charts/features/attributionFeature.js +6 -11
  218. package/es/src/charts/features/axes.js +9 -7
  219. package/es/src/charts/features/axesFinal.js +26 -4
  220. package/es/src/charts/features/axesMeasure.js +61 -6
  221. package/es/src/charts/features/calloutLayout.js +121 -0
  222. package/es/src/charts/features/calloutScene.js +155 -0
  223. package/es/src/charts/features/chartGeometry.js +1 -1
  224. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  225. package/es/src/charts/features/circleLabels.js +207 -0
  226. package/es/src/charts/features/colorScaleBucket.js +19 -1
  227. package/es/src/charts/features/colorScaleHover.js +70 -0
  228. package/es/src/charts/features/colorScaleValue.js +97 -0
  229. package/es/src/charts/features/curvedArrows.js +158 -0
  230. package/es/src/charts/features/edgeArrows.js +160 -4
  231. package/es/src/charts/features/edgeBundling.js +442 -0
  232. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  233. package/es/src/charts/features/ensureZoomDom.js +32 -8
  234. package/es/src/charts/features/features.js +45 -15
  235. package/es/src/charts/features/featuresColorScale.js +62 -8
  236. package/es/src/charts/features/featuresLegend.js +21 -32
  237. package/es/src/charts/features/legendKeys.js +64 -0
  238. package/es/src/charts/features/lineLabels.js +55 -46
  239. package/es/src/charts/features/linkBundle.js +19 -0
  240. package/es/src/charts/features/linkColor.js +72 -0
  241. package/es/src/charts/features/linkFields.js +86 -0
  242. package/es/src/charts/features/linkFocus.js +118 -0
  243. package/es/src/charts/features/linkInteraction.js +312 -0
  244. package/es/src/charts/features/linkKeys.js +20 -0
  245. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  246. package/es/src/charts/features/linkLabelPath.js +162 -0
  247. package/es/src/charts/features/linkLabels.js +340 -0
  248. package/es/src/charts/features/linkWidths.js +32 -0
  249. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  250. package/es/src/charts/features/pathLabels.js +50 -0
  251. package/es/src/charts/features/plotAnnotations.js +68 -17
  252. package/es/src/charts/features/plotPaint.js +42 -15
  253. package/es/src/charts/features/polyline.js +129 -0
  254. package/es/src/charts/features/referenceAnnotations.js +403 -0
  255. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  256. package/es/src/charts/features/ringLabelNodes.js +93 -0
  257. package/es/src/charts/features/ringLabels.js +222 -0
  258. package/es/src/charts/features/sceneBounds.js +26 -6
  259. package/es/src/charts/features/selfLoops.js +306 -0
  260. package/es/src/charts/features/shapeEmit.js +67 -30
  261. package/es/src/charts/features/shareKey.js +15 -0
  262. package/es/src/charts/features/sharedFields.js +15 -2
  263. package/es/src/charts/features/textHalo.js +29 -0
  264. package/es/src/charts/features/thresholdMembers.js +71 -0
  265. package/es/src/charts/helpers/densityChart.js +3 -1
  266. package/es/src/charts/helpers/valueTitle.js +6 -3
  267. package/es/src/charts/index.js +8 -0
  268. package/es/src/charts/partition/chartFields.js +6 -5
  269. package/es/src/charts/partition/hierarchy.js +2 -0
  270. package/es/src/charts/partition/interaction.js +9 -5
  271. package/es/src/charts/partition/zoom.js +7 -6
  272. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  273. package/es/src/charts/pipeline/preDrawData.js +77 -13
  274. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  275. package/es/src/charts/pipeline/vizDraw.js +40 -29
  276. package/es/src/charts/pipeline/vizPreDraw.js +29 -18
  277. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  278. package/es/src/charts/polar/config.js +2 -3
  279. package/es/src/charts/viz/Viz.js +82 -44
  280. package/es/src/charts/viz/VizBase.js +47 -19
  281. package/es/src/charts/viz/backgroundInk.js +13 -7
  282. package/es/src/charts/viz/dataPoller.js +52 -0
  283. package/es/src/charts/viz/focusRing.js +104 -0
  284. package/es/src/charts/viz/focusTargets.js +208 -0
  285. package/es/src/charts/viz/groupRow.js +35 -0
  286. package/es/src/charts/viz/history.js +74 -0
  287. package/es/src/charts/viz/interactionOpacity.js +19 -5
  288. package/es/src/charts/viz/keyboardNav.js +297 -0
  289. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  290. package/es/src/charts/viz/loaderFormat.js +114 -0
  291. package/es/src/charts/viz/missingFields.js +123 -0
  292. package/es/src/charts/viz/mountTarget.js +9 -0
  293. package/es/src/charts/viz/nearestHover.js +183 -0
  294. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  295. package/es/src/charts/viz/ordinalColor.js +14 -12
  296. package/es/src/charts/viz/pageTheme.js +83 -0
  297. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  298. package/es/src/charts/viz/pointVoronoi.js +124 -0
  299. package/es/src/charts/viz/reducedMotion.js +27 -0
  300. package/es/src/charts/viz/reportHandlerError.js +10 -0
  301. package/es/src/charts/viz/shapeClassTargets.js +18 -2
  302. package/es/src/charts/viz/simpleHover.js +2 -0
  303. package/es/src/charts/viz/vizClassName.js +31 -0
  304. package/es/src/charts/viz/vizDataPolling.js +172 -0
  305. package/es/src/charts/viz/vizDefaults.js +81 -23
  306. package/es/src/charts/viz/vizFields.js +53 -2
  307. package/es/src/charts/viz/vizRender.js +49 -28
  308. package/es/src/charts/viz/vizTheme.js +96 -0
  309. package/es/src/charts/viz/vizVisibility.js +14 -0
  310. package/es/src/components/Axis/Axis.js +34 -0
  311. package/es/src/components/Axis/AxisBottom.js +1 -0
  312. package/es/src/components/Axis/AxisLeft.js +1 -0
  313. package/es/src/components/Axis/AxisRight.js +1 -0
  314. package/es/src/components/Axis/AxisTop.js +1 -0
  315. package/es/src/components/Axis/axisBreak.js +4 -1
  316. package/es/src/components/Axis/axisDefaults.js +8 -10
  317. package/es/src/components/Axis/axisLabelAngle.js +175 -0
  318. package/es/src/components/Axis/axisLabelThinning.js +13 -4
  319. package/es/src/components/Axis/axisLayout.js +86 -19
  320. package/es/src/components/Axis/axisLayoutLabels.js +66 -13
  321. package/es/src/components/Axis/axisLayoutScale.js +10 -1
  322. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  323. package/es/src/components/Axis/axisRender.js +38 -9
  324. package/es/src/components/Axis/axisRounding.js +15 -4
  325. package/es/src/components/Axis/axisSlantWrap.js +39 -0
  326. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  327. package/es/src/components/Axis/powTicks.js +73 -0
  328. package/es/src/components/Axis/rangeBreaks.js +201 -0
  329. package/es/src/components/Axis/timeValues.js +19 -4
  330. package/es/src/components/ColorScale/ColorScale.js +42 -36
  331. package/es/src/components/ColorScale/bucketBounds.js +64 -0
  332. package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
  333. package/es/src/components/ColorScale/colorScaleRender.js +25 -1
  334. package/es/src/components/ColorScale/colorScaleScale.js +43 -24
  335. package/es/src/components/ColorScale/colorScaleType.js +26 -0
  336. package/es/src/components/Legend/Legend.js +3 -0
  337. package/es/src/components/Legend/legendConfig.js +2 -6
  338. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  339. package/es/src/components/TextBox.js +31 -65
  340. package/es/src/components/Timeline/Timeline.js +54 -54
  341. package/es/src/components/Timeline/brushSpan.js +78 -0
  342. package/es/src/components/Timeline/timelineConfig.js +27 -10
  343. package/es/src/components/Timeline/timelineMode.js +26 -0
  344. package/es/src/components/Timeline/timelineRender.js +51 -9
  345. package/es/src/components/Tooltip.js +28 -13
  346. package/es/src/components/fontStack.js +20 -0
  347. package/es/src/components/textBoxLayout.js +58 -21
  348. package/es/src/components/textBoxPath.js +73 -0
  349. package/es/src/components/textBoxScene.js +223 -0
  350. package/es/src/components/textBoxWords.js +70 -0
  351. package/es/src/shapes/Area.js +1 -0
  352. package/es/src/shapes/Bar.js +1 -0
  353. package/es/src/shapes/Box.js +67 -79
  354. package/es/src/shapes/Circle.js +1 -0
  355. package/es/src/shapes/Line.js +1 -0
  356. package/es/src/shapes/Path.js +1 -0
  357. package/es/src/shapes/Rect.js +1 -0
  358. package/es/src/shapes/Shape.js +1 -0
  359. package/es/src/shapes/Whisker.js +1 -0
  360. package/es/src/shapes/boxOutlierShape.js +19 -0
  361. package/es/src/shapes/boxStats.js +35 -0
  362. package/es/src/shapes/boxStyle.js +78 -0
  363. package/es/src/shapes/boxSummary.js +174 -0
  364. package/es/src/shapes/shapeStandalone.js +2 -0
  365. package/es/src/utils/BaseClass.js +44 -12
  366. package/es/src/utils/className.js +78 -0
  367. package/es/src/utils/configPrep.js +2 -1
  368. package/es/src/utils/configWarnings.js +25 -0
  369. package/es/src/utils/constant.js +13 -1
  370. package/es/src/utils/displayName.js +12 -0
  371. package/es/src/utils/fieldAccessor.js +31 -0
  372. package/es/src/utils/paintComponentScene.js +2 -0
  373. package/es/src/utils/theme.js +190 -0
  374. package/es/src/utils/themeInk.js +68 -0
  375. package/package.json +14 -10
  376. package/types/index.d.ts +8 -2
  377. package/types/internal.d.ts +253 -9
  378. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  379. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  380. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  381. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  382. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  383. package/types/src/charts/Alluvial/index.d.ts +27 -0
  384. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  385. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  386. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  387. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  388. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  389. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  390. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  391. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  392. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  393. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  394. package/types/src/charts/BoxWhisker/index.d.ts +3 -1
  395. package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
  396. package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
  397. package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
  398. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  399. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  400. package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
  401. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  402. package/types/src/charts/Chord/labels.d.ts +66 -0
  403. package/types/src/charts/Donut/index.d.ts +2 -1
  404. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  405. package/types/src/charts/Gantt/emit.d.ts +17 -0
  406. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  407. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  408. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  409. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  410. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  411. package/types/src/charts/Gantt/index.d.ts +36 -0
  412. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  413. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  414. package/types/src/charts/Geomap/emit.d.ts +2 -2
  415. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  416. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  417. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  418. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  419. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  420. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  421. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  422. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  423. package/types/src/charts/Geomap/index.d.ts +3 -0
  424. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  425. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  426. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  427. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  428. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  429. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  430. package/types/src/charts/Hexbin/index.d.ts +25 -0
  431. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  432. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  433. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  434. package/types/src/charts/Histogram/binData.d.ts +20 -1
  435. package/types/src/charts/Histogram/index.d.ts +3 -2
  436. package/types/src/charts/Histogram/labels.d.ts +7 -0
  437. package/types/src/charts/Marimekko/index.d.ts +2 -1
  438. package/types/src/charts/Network/bundle.d.ts +67 -0
  439. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  440. package/types/src/charts/Network/clusters.d.ts +115 -0
  441. package/types/src/charts/Network/graph.d.ts +65 -0
  442. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  443. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  444. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  445. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  446. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  447. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  448. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  449. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  450. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  451. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  452. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  453. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  454. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  455. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  456. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  457. package/types/src/charts/Plot/axisHover.d.ts +68 -0
  458. package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
  459. package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
  460. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  461. package/types/src/charts/Plot/barHitArea.d.ts +59 -0
  462. package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
  463. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  464. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  465. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  466. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  467. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  468. package/types/src/charts/Plot/index.d.ts +28 -8
  469. package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
  470. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  471. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  472. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  473. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  474. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  475. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  476. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  477. package/types/src/charts/Plot/plotInit.d.ts +23 -2
  478. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  479. package/types/src/charts/Plot/plotZoom.d.ts +2 -0
  480. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  481. package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
  482. package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
  483. package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
  484. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  485. package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
  486. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  487. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  488. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  489. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  490. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  491. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  492. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  493. package/types/src/charts/Rings/emit.d.ts +50 -0
  494. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  495. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  496. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  497. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  498. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  499. package/types/src/charts/Sankey/emit.d.ts +58 -0
  500. package/types/src/charts/Sankey/labels.d.ts +19 -0
  501. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  502. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  503. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  504. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  505. package/types/src/charts/Scatter/index.d.ts +15 -0
  506. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  507. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  508. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  509. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  510. package/types/src/charts/Treemap/emit.d.ts +2 -1
  511. package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
  512. package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
  513. package/types/src/charts/Treemap/index.d.ts +2 -0
  514. package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
  515. package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
  516. package/types/src/charts/definition/makeChart.d.ts +5 -3
  517. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  518. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  519. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  520. package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
  521. package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
  522. package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
  523. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
  524. package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
  525. package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
  526. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  527. package/types/src/charts/events/click.legend.d.ts +2 -1
  528. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  529. package/types/src/charts/facet/facetData.d.ts +1 -1
  530. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  531. package/types/src/charts/features/annotationText.d.ts +57 -0
  532. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  533. package/types/src/charts/features/axesMeasure.d.ts +13 -1
  534. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  535. package/types/src/charts/features/calloutScene.d.ts +40 -0
  536. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  537. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  538. package/types/src/charts/features/circleLabels.d.ts +130 -0
  539. package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
  540. package/types/src/charts/features/colorScaleHover.d.ts +32 -0
  541. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  542. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  543. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  544. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  545. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  546. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  547. package/types/src/charts/features/features.d.ts +8 -0
  548. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  549. package/types/src/charts/features/legendKeys.d.ts +34 -0
  550. package/types/src/charts/features/lineLabels.d.ts +15 -12
  551. package/types/src/charts/features/linkBundle.d.ts +16 -0
  552. package/types/src/charts/features/linkColor.d.ts +48 -0
  553. package/types/src/charts/features/linkFields.d.ts +16 -0
  554. package/types/src/charts/features/linkFocus.d.ts +51 -0
  555. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  556. package/types/src/charts/features/linkKeys.d.ts +11 -0
  557. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  558. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  559. package/types/src/charts/features/linkLabels.d.ts +77 -0
  560. package/types/src/charts/features/linkWidths.d.ts +19 -0
  561. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  562. package/types/src/charts/features/pathLabels.d.ts +41 -0
  563. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  564. package/types/src/charts/features/plotPaint.d.ts +19 -0
  565. package/types/src/charts/features/polyline.d.ts +32 -0
  566. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  567. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  568. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  569. package/types/src/charts/features/ringLabels.d.ts +164 -0
  570. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  571. package/types/src/charts/features/selfLoops.d.ts +165 -0
  572. package/types/src/charts/features/shapeEmit.d.ts +5 -1
  573. package/types/src/charts/features/shareKey.d.ts +9 -0
  574. package/types/src/charts/features/sharedFields.d.ts +11 -2
  575. package/types/src/charts/features/textHalo.d.ts +14 -0
  576. package/types/src/charts/features/thresholdMembers.d.ts +38 -0
  577. package/types/src/charts/helpers/valueTitle.d.ts +4 -2
  578. package/types/src/charts/index.d.ts +8 -0
  579. package/types/src/charts/partition/interaction.d.ts +6 -3
  580. package/types/src/charts/partition/zoom.d.ts +4 -4
  581. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  582. package/types/src/charts/pipeline/stages.d.ts +9 -0
  583. package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
  584. package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
  585. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  586. package/types/src/charts/viz/Viz.d.ts +44 -6
  587. package/types/src/charts/viz/VizBase.d.ts +16 -7
  588. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  589. package/types/src/charts/viz/dataPoller.d.ts +28 -0
  590. package/types/src/charts/viz/focusRing.d.ts +25 -0
  591. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  592. package/types/src/charts/viz/groupRow.d.ts +24 -0
  593. package/types/src/charts/viz/history.d.ts +35 -0
  594. package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
  595. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  596. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  597. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  598. package/types/src/charts/viz/missingFields.d.ts +57 -0
  599. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  600. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  601. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  602. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  603. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  604. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  605. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  606. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  607. package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
  608. package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
  609. package/types/src/charts/viz/simpleHover.d.ts +2 -1
  610. package/types/src/charts/viz/vizClassName.d.ts +23 -0
  611. package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
  612. package/types/src/charts/viz/vizDefaults.d.ts +49 -9
  613. package/types/src/charts/viz/vizFields.d.ts +47 -0
  614. package/types/src/charts/viz/vizRender.d.ts +2 -1
  615. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  616. package/types/src/charts/viz/vizTypes.d.ts +117 -8
  617. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  618. package/types/src/components/Axis/Axis.d.ts +37 -8
  619. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  620. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  621. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  622. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  623. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  624. package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
  625. package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
  626. package/types/src/components/Axis/axisLayout.d.ts +5 -0
  627. package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
  628. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  629. package/types/src/components/Axis/axisRounding.d.ts +6 -3
  630. package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
  631. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  632. package/types/src/components/Axis/powTicks.d.ts +29 -0
  633. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  634. package/types/src/components/Axis/timeValues.d.ts +1 -1
  635. package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
  636. package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
  637. package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
  638. package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
  639. package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
  640. package/types/src/components/Legend/Legend.d.ts +1 -0
  641. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  642. package/types/src/components/TextBox.d.ts +1 -0
  643. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  644. package/types/src/components/Timeline/brushSpan.d.ts +41 -0
  645. package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
  646. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  647. package/types/src/components/Timeline/timelineRender.d.ts +8 -0
  648. package/types/src/components/Tooltip.d.ts +12 -3
  649. package/types/src/components/fontStack.d.ts +10 -0
  650. package/types/src/components/textBoxLayout.d.ts +18 -9
  651. package/types/src/components/textBoxPath.d.ts +59 -0
  652. package/types/src/components/textBoxScene.d.ts +51 -0
  653. package/types/src/components/textBoxWords.d.ts +33 -0
  654. package/types/src/shapes/Area.d.ts +1 -0
  655. package/types/src/shapes/Bar.d.ts +1 -0
  656. package/types/src/shapes/Box.d.ts +2 -8
  657. package/types/src/shapes/Circle.d.ts +1 -0
  658. package/types/src/shapes/Line.d.ts +1 -0
  659. package/types/src/shapes/Path.d.ts +1 -0
  660. package/types/src/shapes/Rect.d.ts +1 -0
  661. package/types/src/shapes/Shape.d.ts +1 -0
  662. package/types/src/shapes/Whisker.d.ts +1 -0
  663. package/types/src/shapes/boxOutlierShape.d.ts +9 -0
  664. package/types/src/shapes/boxStats.d.ts +19 -0
  665. package/types/src/shapes/boxStyle.d.ts +25 -0
  666. package/types/src/shapes/boxSummary.d.ts +66 -0
  667. package/types/src/shapes/emitLabels.d.ts +1 -1
  668. package/types/src/shapes/shapeConfig.d.ts +42 -4
  669. package/types/src/utils/BaseClass.d.ts +32 -0
  670. package/types/src/utils/D3Scale.d.ts +3 -0
  671. package/types/src/utils/D3plusConfig.d.ts +1240 -33
  672. package/types/src/utils/className.d.ts +64 -0
  673. package/types/src/utils/configPrep.d.ts +2 -0
  674. package/types/src/utils/configWarnings.d.ts +21 -2
  675. package/types/src/utils/constant.d.ts +8 -0
  676. package/types/src/utils/displayName.d.ts +10 -0
  677. package/types/src/utils/fieldAccessor.d.ts +24 -0
  678. package/types/src/utils/index.d.ts +1 -1
  679. package/types/src/utils/paintComponentScene.d.ts +3 -1
  680. package/types/src/utils/theme.d.ts +170 -0
  681. package/types/src/utils/themeInk.d.ts +56 -0
  682. package/umd/d3plus-core.full.js +87388 -56271
  683. package/umd/d3plus-core.full.min.js +2 -2
  684. package/umd/d3plus-core.js +37988 -11768
  685. package/umd/d3plus-core.min.js +2 -2
  686. package/es/src/components/Axis/gridStroke.js +0 -10
  687. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -0,0 +1,204 @@
1
+ /**
2
+ Hexbin — a Plot of 2D binned density: raw observations on two continuous
3
+ axes, grouped into hexagons (or squares) of a fixed pixel size and
4
+ colored by how many each holds, with optional density contours.
5
+ */ import constant from "../../utils/constant.js";
6
+ import { makeChart } from "../definition/makeChart.js";
7
+ import Plot from "../Plot/index.js";
8
+ import { chartBackground } from "../viz/backgroundInk.js";
9
+ import { optionalAccessor } from "../viz/vizFields.js";
10
+ import { hexbinBuffer } from "./buffer.js";
11
+ import { hexbinEmit } from "./emit.js";
12
+ import { colorScaleRows, hexbinState, isNumeric, noteDrawRows } from "./layers.js";
13
+ import { BIN_SIZE, CONTOUR_DEFAULTS, HEXBIN_SHAPE, POINT_DEFAULTS, hexbinMeta, hexbinValue, unwrapHexbinRow } from "./settings.js";
14
+ import { hexbinTooltipRows, hexbinTooltipTitle } from "./tooltip.js";
15
+ /**
16
+ Keeps the rows with numeric x and y as the chart's data; the rest are
17
+ skipped. The user's rows stay the chart's source data.
18
+ */ export function keepNumericRows(viz) {
19
+ const state = hexbinState(viz);
20
+ if (viz._data !== state.rows) state.raw = viz._data;
21
+ viz._sourceData = state.raw;
22
+ const valid = state.raw.filter((d, i)=>isNumeric(viz._x(d, i)) && isNumeric(viz._y(d, i)));
23
+ state.rows = viz._data = valid.length === state.raw.length ? state.raw : valid;
24
+ }
25
+ /** Hovering a bin or contour highlights just that mark. */ function installHover(viz) {
26
+ const base = viz.schema.on.mouseenter;
27
+ viz.schema.on.mouseenter = (d, i, ...rest)=>{
28
+ if (!hexbinMeta(d) || viz.schema.shapeConfig.hoverOpacity === 1) return base(d, i, ...rest);
29
+ const target = unwrapHexbinRow(d);
30
+ viz._hoverBucket = false;
31
+ viz.hover((h)=>unwrapHexbinRow(h) === target);
32
+ };
33
+ }
34
+ export const hexbinDef = {
35
+ name: "Hexbin",
36
+ paintDriven: true,
37
+ setup: (viz)=>{
38
+ viz.ctx.hexbin = {
39
+ raw: [],
40
+ rows: []
41
+ };
42
+ viz._buffer = {
43
+ ...viz._buffer,
44
+ [HEXBIN_SHAPE]: hexbinBuffer
45
+ };
46
+ viz._plotShapeEmitters = {
47
+ [HEXBIN_SHAPE]: hexbinEmit
48
+ };
49
+ // Every observation is binned on its own, whatever its groupBy id.
50
+ viz._unmergedShapes = [
51
+ HEXBIN_SHAPE
52
+ ];
53
+ // The colorScale reads the bins, which are measured in the plot area.
54
+ viz._colorScaleRows = ()=>colorScaleRows(viz);
55
+ // The tooltip's own rows give a bin's ranges.
56
+ viz._tooltipAxisRows = false;
57
+ // A bin has no single point to snap a tooltip to.
58
+ viz._sharedHover = ()=>undefined;
59
+ installHover(viz);
60
+ const preDraw = viz._preDraw.bind(viz);
61
+ viz._preDraw = ()=>{
62
+ keepNumericRows(viz);
63
+ preDraw();
64
+ };
65
+ const draw = viz._draw.bind(viz);
66
+ viz._draw = (callback)=>{
67
+ // Small-multiples panels share the grid anchor and colorScale noted
68
+ // from every panel's rows.
69
+ if (viz._facetStep !== "panel") noteDrawRows(viz);
70
+ return draw(callback);
71
+ };
72
+ },
73
+ ctx: {},
74
+ fields: [
75
+ /**
76
+ The bin shape: `"hex"` (default) for hexagons, `"square"` for
77
+ squares, or `false` to draw no bins (for contours alone).
78
+ @type {"hex" | "square" | false}
79
+ */ {
80
+ key: "binShape",
81
+ default: "hex"
82
+ },
83
+ /**
84
+ The bin size in pixels: a hexagon's radius, or a square's side.
85
+ Bins keep this size at any zoom: the observations are binned again
86
+ for each view, and the colorScale refits to the bins in view.
87
+ Defaults to 12.
88
+ */ {
89
+ key: "binSize",
90
+ default: BIN_SIZE
91
+ },
92
+ /**
93
+ What each bin measures, which its color shows: `"count"` (default),
94
+ the number of observations in the bin; or `{value, agg, label}`,
95
+ the `"sum"` (default) or `"mean"` of `value` (a data key or
96
+ accessor) over the bin's observations, named `label` in the
97
+ tooltip.
98
+ @type {"count" | {value: string | function, agg?: "sum" | "mean", label?: string}}
99
+ */ {
100
+ key: "binValue",
101
+ default: "count"
102
+ },
103
+ /**
104
+ Draws density contours: `"lines"` (or `true`) outlines each density
105
+ level in its color, and `"filled"` fills each level with an opacity
106
+ ramp. Levels are in observations per bin (the count a bin would hold
107
+ there), so contours share the bins' colorScale. Contours over bins
108
+ are drawn in the chart's text color and don't take hover. Defaults to
109
+ `false`.
110
+ @type {boolean | "lines" | "filled"}
111
+ */ {
112
+ key: "contours",
113
+ default: false
114
+ },
115
+ /**
116
+ Contour options: `bandwidth`, the density kernel's standard deviation
117
+ in pixels (default 20); `thresholds`, about how many levels to draw
118
+ (default 8, rounded to nice values) or the levels themselves;
119
+ `strokeWidth`, the outline width of `"lines"` (default 1.5);
120
+ `fillOpacity`, the opacity of the highest `"filled"` level (default
121
+ 0.8); `labels`, which writes each level's value along its contour
122
+ (default `true`); `labelConfig`, TextBox config for those labels
123
+ (`fontSize` defaults to 10); `labelSpacing`, the least distance
124
+ between two labels along a line, in pixels (default `"auto"`); and
125
+ `labelStep`, which labels every n-th level (default `"auto"`: all of
126
+ up to five levels, else every other one).
127
+ @type {{bandwidth?: number, thresholds?: number | number[], strokeWidth?: number, fillOpacity?: number, labels?: boolean, labelConfig?: object, labelSpacing?: number | "auto", labelStep?: number | "auto"}}
128
+ */ {
129
+ key: "contourConfig",
130
+ merge: true,
131
+ default: CONTOUR_DEFAULTS
132
+ },
133
+ /** Formats the contour labels' and tooltips' level values. Defaults to the abbreviated number format (`1.5k`). */ {
134
+ key: "levelFormat"
135
+ },
136
+ /** Draws the raw observations as small dots beneath the bins and contours. Defaults to `false`. */ {
137
+ key: "points",
138
+ default: false
139
+ },
140
+ /**
141
+ The raw observations' style: `r`, the dot radius in pixels (default
142
+ 1.5); `fill` (defaults to the chart's text color); and `fillOpacity`
143
+ (default 0.35).
144
+ @type {{r?: number, fill?: string, fillOpacity?: number}}
145
+ */ {
146
+ key: "pointConfig",
147
+ merge: true,
148
+ default: POINT_DEFAULTS
149
+ },
150
+ {
151
+ key: "colorScale",
152
+ coerce: optionalAccessor,
153
+ default: hexbinValue
154
+ },
155
+ /** A continuous color scale: bins and contours shade smoothly by value. */ {
156
+ key: "colorScaleConfig",
157
+ merge: true,
158
+ default: {
159
+ scale: "linear"
160
+ }
161
+ },
162
+ {
163
+ key: "legend",
164
+ default: false,
165
+ coerce: "const"
166
+ },
167
+ {
168
+ key: "shape",
169
+ default: constant(HEXBIN_SHAPE),
170
+ coerce: "const"
171
+ },
172
+ /**
173
+ Bins are outlined in the chart's background color, so neighbors stay
174
+ distinct.
175
+ */ {
176
+ key: "shapeConfig",
177
+ merge: true,
178
+ factory: (viz)=>({
179
+ [HEXBIN_SHAPE]: {
180
+ stroke: ()=>chartBackground(viz),
181
+ strokeWidth: constant(0.5)
182
+ }
183
+ })
184
+ },
185
+ {
186
+ key: "tooltipConfig",
187
+ merge: true,
188
+ factory: (viz)=>({
189
+ title: (d)=>hexbinTooltipTitle(viz, d),
190
+ tbody: (d)=>hexbinTooltipRows(viz, d)
191
+ })
192
+ }
193
+ ]
194
+ };
195
+ /**
196
+ Creates a 2D binned density chart from raw observations: each row is a
197
+ point at its `x` and `y` values (rows without numeric values are
198
+ skipped), and the points are grouped into hexagons (`binShape`) of
199
+ `binSize` pixels, colored on the colorScale by how many each holds (or by
200
+ `binValue`). Empty bins aren't drawn. `contours` adds density contours,
201
+ and `points` draws the observations beneath. `groupBy` names the
202
+ observations for `filter` and the legend (off by default), and `facet`
203
+ bins each panel on its own, on one shared colorScale.
204
+ */ export default makeChart(hexbinDef, Plot);
@@ -0,0 +1,212 @@
1
+ /**
2
+ Hexbin's per-draw state and the rows its emitter draws: bins and contour
3
+ levels measured from points in pixel space, and the rows the colorScale
4
+ is laid out from (estimated before the plot area is known, then measured
5
+ against it).
6
+
7
+ @module
8
+ */ import { extent, groups } from "d3-array";
9
+ import { scaleLinear } from "d3-scale";
10
+ import { facetActive } from "../facet/facetConfig.js";
11
+ import { facetKey, toFacetValue } from "../facet/facetData.js";
12
+ import { binArea, binBounds, binMeasure, binPath, binPoints } from "./binning.js";
13
+ import { densityContours } from "./contours.js";
14
+ import { hexbinRow, hexbinSettings } from "./settings.js";
15
+ /** A Hexbin's state. */ export function hexbinState(viz) {
16
+ return viz.ctx.hexbin;
17
+ }
18
+ /** Whether a value is a finite number. */ export const isNumeric = (v)=>typeof v === "number" && Number.isFinite(v);
19
+ /** The plot area an emitter draws in. */ export function plotFrame(ctx) {
20
+ const { xRange, yRange } = ctx;
21
+ return {
22
+ left: xRange[0],
23
+ top: yRange[0] - (ctx.x2Height ?? 0),
24
+ width: xRange[xRange.length - 1] - xRange[0],
25
+ height: yRange[yRange.length - 1] - yRange[0]
26
+ };
27
+ }
28
+ /**
29
+ One row per bin, measured: its count and value, its bounds in data units
30
+ (through `invert`), and its outline. Bins whose value isn't a number (a
31
+ `mean` with nothing to average) are left out.
32
+ */ export function binRows(bins, settings, invert) {
33
+ const shape = settings.shape || "hex";
34
+ const rows = [];
35
+ for (const bin of bins){
36
+ const value = binMeasure(bin.points, settings.agg);
37
+ if (!Number.isFinite(value)) continue;
38
+ const b = binBounds(bin, shape, settings.size);
39
+ const [x0, x1] = [
40
+ invert.x(b.x0),
41
+ invert.x(b.x1)
42
+ ].sort((a, c)=>a - c);
43
+ const [y0, y1] = [
44
+ invert.y(b.y0),
45
+ invert.y(b.y1)
46
+ ].sort((a, c)=>a - c);
47
+ rows.push(hexbinRow(`bin-${bin.key}`, {
48
+ kind: "bin",
49
+ count: bin.points.length,
50
+ value,
51
+ x0,
52
+ x1,
53
+ y0,
54
+ y1,
55
+ path: binPath(bin, shape, settings.size),
56
+ rows: bin.points.map((p)=>p.row)
57
+ }));
58
+ }
59
+ return rows;
60
+ }
61
+ /**
62
+ One row per contour level, lowest first. Levels are in points per bin, so
63
+ they share the bins' color scale; a `mean` measure contours the points'
64
+ density, unweighted.
65
+ */ export function contourRows(points, frame, settings) {
66
+ const { bandwidth, thresholds } = settings.contourConfig;
67
+ const weighted = settings.agg === "sum" ? points : points.map((p)=>({
68
+ ...p,
69
+ weight: 1
70
+ }));
71
+ const levels = densityContours(weighted, {
72
+ ...frame,
73
+ bandwidth,
74
+ thresholds,
75
+ unit: binArea(settings.shape || "hex", settings.size)
76
+ });
77
+ return levels.map((c, index)=>hexbinRow(`contour-${index}`, {
78
+ kind: "contour",
79
+ level: c.level,
80
+ next: levels[index + 1]?.level,
81
+ index,
82
+ levels: levels.length,
83
+ path: c.path
84
+ }));
85
+ }
86
+ /** The bins that reach into the plot area: the ones a zoomed view shows. */ export function binsInView(bins, frame, settings) {
87
+ const shape = settings.shape || "hex";
88
+ return bins.filter((bin)=>{
89
+ const b = binBounds(bin, shape, settings.size);
90
+ return b.x1 > frame.left && b.x0 < frame.left + frame.width && b.y1 > frame.top && b.y0 < frame.top + frame.height;
91
+ });
92
+ }
93
+ /** The points as one path of `r`-pixel dots. */ export function pointPath(points, r) {
94
+ const round = (n)=>Math.round(n * 10) / 10;
95
+ let d = "";
96
+ for (const p of points){
97
+ if (!isNumeric(p.x) || !isNumeric(p.y)) continue;
98
+ d += `M${round(p.x - r)},${round(p.y)}a${r},${r} 0 1,0 ${2 * r},0a${r},${r} 0 1,0 ${-2 * r},0`;
99
+ }
100
+ return d;
101
+ }
102
+ /**
103
+ The rows the colorScale reads for some points: their bins in view, or
104
+ with no bins drawn, their contour levels.
105
+ */ export function colorRows(points, frame, origin, settings) {
106
+ const none = {
107
+ x: ()=>NaN,
108
+ y: ()=>NaN
109
+ };
110
+ if (settings.shape) return binRows(binsInView(binPoints(points, {
111
+ shape: settings.shape,
112
+ size: settings.size,
113
+ origin
114
+ }), frame, settings), settings, none);
115
+ return settings.contours ? contourRows(points, frame, settings) : [];
116
+ }
117
+ /** The user's rows placed through `toX`/`toY` (data value to pixel). */ function placeRows(viz, rows, toX, toY, settings) {
118
+ const { weight } = settings;
119
+ return rows.map((row, i)=>({
120
+ x: toX(Number(viz._x(row, i))),
121
+ y: toY(Number(viz._y(row, i))),
122
+ row,
123
+ weight: weight ? Number(weight(row, i)) : undefined
124
+ }));
125
+ }
126
+ /** The user's rows split into small-multiples panels (one group without facets). */ function panelRows(viz, rows) {
127
+ if (!facetActive(viz)) return [
128
+ rows
129
+ ];
130
+ const facet = viz.schema.facet;
131
+ return groups(rows, (d, i)=>facetKey(toFacetValue(facet(d, i)))).map(([, g])=>g);
132
+ }
133
+ /**
134
+ Notes what the emitter needs from the whole chart before a draw: where
135
+ the bin grid is anchored, and with small multiples, every panel's rows.
136
+ The colorScale rows measured by the last draw are dropped.
137
+ */ export function noteDrawRows(viz) {
138
+ const state = hexbinState(viz);
139
+ state.colorRows = undefined;
140
+ const rows = viz._filteredData ?? [];
141
+ const xs = rows.map((d, i)=>Number(viz._x(d, i))).filter(isNumeric);
142
+ const ys = rows.map((d, i)=>Number(viz._y(d, i))).filter(isNumeric);
143
+ const [x] = extent(xs);
144
+ const [y] = extent(ys);
145
+ state.anchor = x !== undefined && y !== undefined ? [
146
+ x,
147
+ y
148
+ ] : undefined;
149
+ state.panels = facetActive(viz) ? panelRows(viz, rows) : undefined;
150
+ }
151
+ /**
152
+ The colorScale's rows for a panel's paint: the rows it measured, or with
153
+ small multiples, every panel's, binned at this panel's scale so all of
154
+ them share one colorScale.
155
+ */ export function sharedColorRows(ctx, own, frame, origin, settings) {
156
+ const { viz } = ctx;
157
+ const panels = hexbinState(viz).panels;
158
+ if (viz._facetStep !== "panel" || !panels) return own;
159
+ return panels.flatMap((rows)=>colorRows(placeRows(viz, rows, (v)=>ctx.x(v), (v)=>ctx.y(v), settings), frame, origin, settings));
160
+ }
161
+ /**
162
+ The rows the colorScale lays out from: those this draw's paint measured,
163
+ or before the paint, an estimate (see `estimatedColorRows`).
164
+ */ export function colorScaleRows(viz) {
165
+ return hexbinState(viz).colorRows ?? estimatedColorRows(viz, hexbinSettings(viz));
166
+ }
167
+ /** The share of the chart's size the plot area is estimated to take. */ const ESTIMATED_PLOT = {
168
+ width: 0.8,
169
+ height: 0.7
170
+ };
171
+ /**
172
+ The colorScale's rows before the plot area is known (only its margin
173
+ depends on them): the observations measured in a plot area estimated
174
+ from the chart's size. The emitter refreshes the colorScale with the
175
+ rows it measures.
176
+ */ export function estimatedColorRows(viz, settings) {
177
+ const rows = viz._filteredData ?? [];
178
+ const xs = rows.map((d, i)=>Number(viz._x(d, i))).filter(isNumeric);
179
+ const ys = rows.map((d, i)=>Number(viz._y(d, i))).filter(isNumeric);
180
+ if (!xs.length || !ys.length) return [];
181
+ const panels = panelRows(viz, rows);
182
+ const frame = {
183
+ left: 0,
184
+ top: 0,
185
+ width: viz.schema.width * ESTIMATED_PLOT.width / Math.sqrt(panels.length),
186
+ height: viz.schema.height * ESTIMATED_PLOT.height / Math.sqrt(panels.length)
187
+ };
188
+ const toX = scaleLinear().domain(extent(xs)).range([
189
+ frame.left,
190
+ frame.left + frame.width
191
+ ]);
192
+ const toY = scaleLinear().domain(extent(ys)).range([
193
+ frame.top + frame.height,
194
+ frame.top
195
+ ]);
196
+ const origin = [
197
+ frame.left,
198
+ frame.top + frame.height
199
+ ];
200
+ return panels.flatMap((group)=>colorRows(placeRows(viz, group, toX, toY, settings), frame, origin, settings));
201
+ }
202
+ /**
203
+ Lays the colorScale out again with `rows`, in the frame it already
204
+ claimed, so its scale (which the bins' fills read) spans what's drawn.
205
+ The rows are kept for any later layout of the colorScale in this draw
206
+ (see `colorScaleRows`).
207
+ */ export function refreshColorScale(viz, rows) {
208
+ hexbinState(viz).colorRows = rows;
209
+ const cs = viz._colorScaleClass;
210
+ if (!cs || !viz.schema.colorScale) return;
211
+ cs.data(rows).render();
212
+ }
@@ -0,0 +1,86 @@
1
+ /**
2
+ Hexbin's resolved options and the rows it draws: one row per bin or
3
+ contour level, each carrying what it measures under `HEXBIN_META`.
4
+
5
+ @module
6
+ */ import { fieldAccessor, fieldNameOf } from "../../utils/fieldAccessor.js";
7
+ /** The shape key Hexbin's observations, bins and contours draw under. */ export const HEXBIN_SHAPE = "Hexbin";
8
+ /** The key a bin or contour row keeps its measure under. */ export const HEXBIN_META = "__d3plusHexbin";
9
+ /** `contourConfig`'s defaults. */ export const CONTOUR_DEFAULTS = {
10
+ bandwidth: 20,
11
+ thresholds: 8,
12
+ strokeWidth: 1.5,
13
+ fillOpacity: 0.8,
14
+ labels: true,
15
+ labelConfig: {},
16
+ labelSpacing: "auto",
17
+ labelStep: "auto"
18
+ };
19
+ /** `pointConfig`'s defaults (the fill follows the chart's text color). */ export const POINT_DEFAULTS = {
20
+ r: 1.5,
21
+ fillOpacity: 0.35
22
+ };
23
+ /** The default `binSize`, in pixels. */ export const BIN_SIZE = 12;
24
+ /** Walks Plot's `__d3plus__` wrappers down to the row. */ export function unwrapHexbinRow(d) {
25
+ while(d && d.__d3plus__ && d.data)d = d.data;
26
+ return d;
27
+ }
28
+ /** The measure a (possibly wrapped) bin or contour row carries, if any. */ export function hexbinMeta(d) {
29
+ const row = d ? unwrapHexbinRow(d) : undefined;
30
+ return row ? row[HEXBIN_META] : undefined;
31
+ }
32
+ /** A bin's measure or a contour's level: what Hexbin's colorScale reads. */ export function hexbinValue(d) {
33
+ const meta = hexbinMeta(d);
34
+ return meta ? meta.kind === "bin" ? meta.value : meta.level : undefined;
35
+ }
36
+ /** A row holding a bin's or contour's measure. */ export function hexbinRow(id, meta) {
37
+ return {
38
+ id,
39
+ [HEXBIN_META]: meta
40
+ };
41
+ }
42
+ /**
43
+ Resolves `binValue` to an aggregation, the accessor it aggregates, and
44
+ the name of what each bin measures.
45
+ */ export function resolveBinValue(option, translate) {
46
+ if (!option || option === "count" || typeof option !== "object") return {
47
+ agg: "count",
48
+ measure: translate("Count")
49
+ };
50
+ const { value, agg, label } = option;
51
+ const weight = typeof value === "function" ? value : typeof value === "string" ? fieldAccessor(value) : undefined;
52
+ if (!weight) return {
53
+ agg: "count",
54
+ measure: translate("Count")
55
+ };
56
+ const mode = agg === "mean" ? "mean" : "sum";
57
+ const key = typeof value === "string" ? value : fieldNameOf(weight) ?? undefined;
58
+ const name = translate(mode === "mean" ? "Mean" : "Total");
59
+ return {
60
+ agg: mode,
61
+ weight,
62
+ measure: label ?? (key ? `${name} ${key}` : name)
63
+ };
64
+ }
65
+ /** Hexbin's options, resolved from its config for one draw. */ export function hexbinSettings(viz) {
66
+ const s = viz.schema;
67
+ const translate = (k)=>s.translate(k);
68
+ const shape = s.binShape === "square" ? "square" : s.binShape === false ? false : "hex";
69
+ const size = Number(s.binSize);
70
+ const contours = s.contours === "filled" ? "filled" : s.contours === true || s.contours === "lines" ? "lines" : false;
71
+ return {
72
+ shape,
73
+ size: size > 0 ? size : BIN_SIZE,
74
+ ...resolveBinValue(s.binValue, translate),
75
+ contours,
76
+ contourConfig: {
77
+ ...CONTOUR_DEFAULTS,
78
+ ...s.contourConfig
79
+ },
80
+ points: Boolean(s.points),
81
+ pointConfig: {
82
+ ...POINT_DEFAULTS,
83
+ ...s.pointConfig
84
+ }
85
+ };
86
+ }
@@ -0,0 +1,77 @@
1
+ /**
2
+ Hexbin's tooltip and aria text: a bin's measure and its x and y ranges,
3
+ or a contour's density range.
4
+
5
+ @module
6
+ */ import { formatAbbreviate } from "@d3plus/format";
7
+ import { hexbinMeta, hexbinSettings } from "./settings.js";
8
+ const fmt = (viz, n)=>Number.isFinite(n) ? formatAbbreviate(n, viz.schema.locale) : "";
9
+ const range = (viz, lo, hi)=>`${fmt(viz, lo)} – ${fmt(viz, hi)}`;
10
+ /** The name an axis goes by: its data key, or the axis letter. */ function axisName(viz, axis) {
11
+ const key = viz[`_${axis}Key`];
12
+ return typeof key === "string" ? key : axis;
13
+ }
14
+ /**
15
+ A contour level's value as text: through `levelFormat` when set, or
16
+ abbreviated (`1.5k`).
17
+ @param viz The chart.
18
+ @param level The level.
19
+ */ export function contourLevelText(viz, level) {
20
+ const format = viz.schema.levelFormat;
21
+ return typeof format === "function" ? `${format(level)}` : fmt(viz, level);
22
+ }
23
+ /** A contour level's density range: up to the next level, or the level and up. */ function levelRange(viz, level, next) {
24
+ const text = (n)=>contourLevelText(viz, n);
25
+ return next === undefined ? `≥ ${text(level)}` : `${text(level)} – ${text(next)}`;
26
+ }
27
+ /** A bin's tooltip title: its measure, such as "Count: 42". */ export function hexbinTooltipTitle(viz, d) {
28
+ const meta = hexbinMeta(d);
29
+ if (!meta) return "";
30
+ const t = (s)=>viz.schema.translate(s);
31
+ if (meta.kind === "contour") return t("Density");
32
+ return `${hexbinSettings(viz).measure}: ${fmt(viz, meta.value)}`;
33
+ }
34
+ /**
35
+ A bin's tooltip rows: its x and y ranges, and its count when it measures
36
+ something else. A contour's: its density range, in points per bin.
37
+ */ export function hexbinTooltipRows(viz, d) {
38
+ const meta = hexbinMeta(d);
39
+ if (!meta) return [];
40
+ const t = (s)=>viz.schema.translate(s);
41
+ if (meta.kind === "contour") return [
42
+ [
43
+ t("Range"),
44
+ levelRange(viz, meta.level, meta.next)
45
+ ]
46
+ ];
47
+ const rows = [
48
+ [
49
+ axisName(viz, "x"),
50
+ range(viz, meta.x0, meta.x1)
51
+ ],
52
+ [
53
+ axisName(viz, "y"),
54
+ range(viz, meta.y0, meta.y1)
55
+ ]
56
+ ];
57
+ if (hexbinSettings(viz).agg !== "count") rows.push([
58
+ t("Count"),
59
+ fmt(viz, meta.count)
60
+ ]);
61
+ return rows;
62
+ }
63
+ /** A bin's accessible name: its measure, then its x and y ranges. */ export function binAriaLabel(viz, d) {
64
+ const meta = hexbinMeta(d);
65
+ if (!meta) return "";
66
+ return [
67
+ hexbinTooltipTitle(viz, d),
68
+ `${axisName(viz, "x")} ${range(viz, meta.x0, meta.x1)}`,
69
+ `${axisName(viz, "y")} ${range(viz, meta.y0, meta.y1)}`
70
+ ].join(", ");
71
+ }
72
+ /** A contour's accessible name: "Density" and its range. */ export function contourAriaLabel(viz, d) {
73
+ const meta = hexbinMeta(d);
74
+ if (!meta || meta.kind !== "contour") return "";
75
+ const t = (s)=>viz.schema.translate(s);
76
+ return `${t("Density")}: ${levelRange(viz, meta.level, meta.next)}`;
77
+ }
@@ -2,6 +2,24 @@
2
2
  Pure binning for Histogram: raw observation rows → one row per group per
3
3
  bin. Every group in a panel shares one set of bin edges.
4
4
  */ import { bin, extent, groups, range, thresholdSturges } from "d3-array";
5
+ /**
6
+ The normalization a cumulative histogram draws: the running sum of a
7
+ density is the share of observations so far, so `"density"` reads as
8
+ `"relative"` (an empirical CDF).
9
+ */ export function cumulativeNormalize(normalize = "count", cumulative = false) {
10
+ return cumulative && normalize === "density" ? "relative" : normalize;
11
+ }
12
+ /** Running sums of `counts`, from the first bin or, with `"reverse"`, the last. */ export function accumulate(counts, cumulative) {
13
+ if (!cumulative) return counts.slice();
14
+ const reverse = cumulative === "reverse";
15
+ const out = new Array(counts.length);
16
+ let total = 0;
17
+ for(let k = 0; k < counts.length; k++){
18
+ const i = reverse ? counts.length - 1 - k : k;
19
+ out[i] = total += counts[i];
20
+ }
21
+ return out;
22
+ }
5
23
  /** Evenly spaced edges of `width` covering `[lo, hi]`, anchored at multiples of `width`. */ function widthEdges(lo, hi, width) {
6
24
  const start = Math.floor(lo / width) * width;
7
25
  const end = Math.max(Math.ceil(hi / width) * width, start + width);
@@ -32,8 +50,12 @@
32
50
  ...bins.map((b)=>b.x1)
33
51
  ];
34
52
  }
35
- /** One row per group per bin for one panel's observations, normalized against the panel's total. */ function binPanel(observations, edges, options) {
36
- const { group = ()=>"", normalize = "count" } = options;
53
+ /**
54
+ One row per group per bin for one panel's observations, normalized against
55
+ the panel's total. With `cumulative`, each group accumulates its own counts.
56
+ */ function binPanel(observations, edges, options) {
57
+ const { group = ()=>"", cumulative = false } = options;
58
+ const normalize = cumulativeNormalize(options.normalize, cumulative);
37
59
  const perGroup = bin().domain([
38
60
  edges[0],
39
61
  edges[edges.length - 1]
@@ -43,16 +65,21 @@
43
65
  for (const [, members] of groups(observations, (o)=>group(o.d, o.i))){
44
66
  const binned = perGroup(members.map((o)=>o.v));
45
67
  const first = members[0].d;
46
- binned.forEach((b)=>{
68
+ const running = accumulate(binned.map((b)=>b.length), cumulative);
69
+ binned.forEach((b, i)=>{
47
70
  const x0 = b.x0, x1 = b.x1;
48
71
  const count = b.length;
49
- const y = normalize === "density" ? count / (total * (x1 - x0)) : normalize === "relative" ? count / total : count;
72
+ const height = running[i];
73
+ const y = normalize === "density" ? height / (total * (x1 - x0)) : normalize === "relative" ? height / total : height;
50
74
  out.push({
51
75
  ...first,
52
76
  x0,
53
77
  x1,
54
78
  x: (x0 + x1) / 2,
55
79
  count,
80
+ ...cumulative ? {
81
+ cumulativeCount: height
82
+ } : {},
56
83
  y
57
84
  });
58
85
  });