@d3plus/core 4.10.0 → 4.12.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 (711) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +178 -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 +176 -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 +101 -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 +192 -0
  17. package/es/src/charts/ArcDiagram/events.js +148 -0
  18. package/es/src/charts/ArcDiagram/index.js +217 -0
  19. package/es/src/charts/BarChart/index.js +12 -7
  20. package/es/src/charts/BoxWhisker/index.js +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +5 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +6 -11
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +160 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +137 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +206 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +6 -4
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Matrix/applyLayout.js +20 -9
  70. package/es/src/charts/Matrix/index.js +19 -1
  71. package/es/src/charts/Network/applyLayout.js +171 -96
  72. package/es/src/charts/Network/bundle.js +82 -0
  73. package/es/src/charts/Network/clusterLabels.js +423 -0
  74. package/es/src/charts/Network/clusters.js +290 -0
  75. package/es/src/charts/Network/emit.js +257 -75
  76. package/es/src/charts/Network/graph.js +146 -0
  77. package/es/src/charts/Network/graphFluent.js +81 -0
  78. package/es/src/charts/Network/index.js +91 -106
  79. package/es/src/charts/Network/minNodeDistance.js +64 -0
  80. package/es/src/charts/Network/polygonRows.js +44 -0
  81. package/es/src/charts/Pack/applyLayout.js +16 -5
  82. package/es/src/charts/Pack/emit.js +15 -8
  83. package/es/src/charts/Pack/groupRows.js +61 -0
  84. package/es/src/charts/Pack/index.js +8 -1
  85. package/es/src/charts/Pack/neutralPaint.js +20 -0
  86. package/es/src/charts/Pack/nodeNames.js +35 -0
  87. package/es/src/charts/ParallelCoordinates/axes.js +22 -22
  88. package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
  89. package/es/src/charts/ParallelCoordinates/index.js +3 -1
  90. package/es/src/charts/ParallelCoordinates/titles.js +17 -9
  91. package/es/src/charts/Pie/applyLayout.js +86 -27
  92. package/es/src/charts/Pie/arcFit.js +152 -0
  93. package/es/src/charts/Pie/curvedLabels.js +134 -0
  94. package/es/src/charts/Pie/emit.js +51 -96
  95. package/es/src/charts/Pie/index.js +74 -31
  96. package/es/src/charts/Pie/labelRoom.js +154 -0
  97. package/es/src/charts/Pie/outsideLabels.js +224 -0
  98. package/es/src/charts/Pie/outsideNodes.js +267 -0
  99. package/es/src/charts/Pie/pieLabels.js +137 -0
  100. package/es/src/charts/Pie/sectorBox.js +223 -0
  101. package/es/src/charts/Pie/straightLabels.js +96 -0
  102. package/es/src/charts/Pie/straightLayout.js +215 -0
  103. package/es/src/charts/Plot/alongLegend.js +76 -0
  104. package/es/src/charts/Plot/areaEnter.js +68 -0
  105. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  106. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  107. package/es/src/charts/Plot/axisValues.js +43 -0
  108. package/es/src/charts/Plot/barWidth.js +59 -11
  109. package/es/src/charts/Plot/circleLabels.js +98 -0
  110. package/es/src/charts/Plot/connectGaps.js +237 -0
  111. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  112. package/es/src/charts/Plot/draw.js +34 -14
  113. package/es/src/charts/Plot/fillBetween.js +2 -1
  114. package/es/src/charts/Plot/forecastScene.js +3 -4
  115. package/es/src/charts/Plot/index.js +19 -17
  116. package/es/src/charts/Plot/labelPlacement.js +1 -1
  117. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  118. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  119. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  120. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  121. package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
  122. package/es/src/charts/Plot/pipeline.js +66 -19
  123. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  124. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  125. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  126. package/es/src/charts/Plot/pipelineScales.js +40 -8
  127. package/es/src/charts/Plot/plotFacet.js +12 -1
  128. package/es/src/charts/Plot/plotInit.js +40 -5
  129. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  130. package/es/src/charts/Plot/referenceDomains.js +133 -0
  131. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  132. package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
  133. package/es/src/charts/Plot/sharedHover.js +2 -1
  134. package/es/src/charts/Plot/sharedTooltip.js +13 -3
  135. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  136. package/es/src/charts/Plot/trendLabels.js +183 -0
  137. package/es/src/charts/Plot/trendLines.js +1 -0
  138. package/es/src/charts/Plot/trendScene.js +6 -3
  139. package/es/src/charts/Plot/trendTooltip.js +5 -1
  140. package/es/src/charts/PolarArea/index.js +4 -3
  141. package/es/src/charts/Priestley/applyLayout.js +21 -23
  142. package/es/src/charts/Priestley/index.js +4 -37
  143. package/es/src/charts/Priestley/timeAxis.js +103 -0
  144. package/es/src/charts/Pyramid/gutter.js +52 -16
  145. package/es/src/charts/Pyramid/index.js +55 -7
  146. package/es/src/charts/Pyramid/scene.js +4 -4
  147. package/es/src/charts/Radar/applyLayout.js +31 -33
  148. package/es/src/charts/Radar/axisDecorations.js +62 -13
  149. package/es/src/charts/Radar/curvedLabels.js +228 -0
  150. package/es/src/charts/Radar/emit.js +30 -15
  151. package/es/src/charts/Radar/index.js +43 -5
  152. package/es/src/charts/Radar/points.js +85 -0
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +9 -1
  155. package/es/src/charts/RadialBar/index.js +26 -9
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
  158. package/es/src/charts/RadialMatrix/index.js +18 -9
  159. package/es/src/charts/Rings/applyLayout.js +39 -161
  160. package/es/src/charts/Rings/emit.js +219 -63
  161. package/es/src/charts/Rings/index.js +88 -32
  162. package/es/src/charts/Rings/ringsCurves.js +156 -0
  163. package/es/src/charts/Rings/ringsGraph.js +28 -9
  164. package/es/src/charts/Rings/ringsLoops.js +73 -0
  165. package/es/src/charts/Rings/ringsParallel.js +183 -0
  166. package/es/src/charts/Rings/ringsPlacement.js +152 -0
  167. package/es/src/charts/Rings/ringsSizing.js +61 -38
  168. package/es/src/charts/Sankey/applyLayout.js +130 -39
  169. package/es/src/charts/Sankey/circularLayout.js +208 -0
  170. package/es/src/charts/Sankey/circularLinks.js +301 -0
  171. package/es/src/charts/Sankey/emit.js +164 -94
  172. package/es/src/charts/Sankey/index.js +78 -75
  173. package/es/src/charts/Sankey/labels.js +80 -0
  174. package/es/src/charts/Sankey/ribbons.js +88 -0
  175. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  176. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  177. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  178. package/es/src/charts/Scatter/index.js +25 -0
  179. package/es/src/charts/SlopeChart/index.js +116 -0
  180. package/es/src/charts/SlopeChart/slope.js +95 -0
  181. package/es/src/charts/Streamgraph/index.js +51 -0
  182. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  183. package/es/src/charts/Sunburst/emit.js +83 -64
  184. package/es/src/charts/Sunburst/index.js +16 -4
  185. package/es/src/charts/Tree/applyLayout.js +44 -14
  186. package/es/src/charts/Tree/emit.js +5 -5
  187. package/es/src/charts/Tree/index.js +12 -18
  188. package/es/src/charts/Tree/keys.js +33 -0
  189. package/es/src/charts/Tree/nodeLabel.js +15 -0
  190. package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
  191. package/es/src/charts/Treemap/index.js +2 -5
  192. package/es/src/charts/Violin/inner.js +3 -5
  193. package/es/src/charts/definition/makeChart.js +14 -2
  194. package/es/src/charts/drawSteps/backControl.js +17 -5
  195. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  196. package/es/src/charts/drawSteps/minimap.js +10 -25
  197. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  198. package/es/src/charts/drawSteps/searchControls.js +2 -1
  199. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  200. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  201. package/es/src/charts/drawSteps/zoomActions.js +36 -0
  202. package/es/src/charts/drawSteps/zoomControls.js +52 -23
  203. package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
  204. package/es/src/charts/drawSteps/zoomDrag.js +188 -0
  205. package/es/src/charts/drawSteps/zoomFit.js +69 -0
  206. package/es/src/charts/events/click.legend.js +11 -4
  207. package/es/src/charts/events/click.shape.js +13 -4
  208. package/es/src/charts/events/mouseenter.js +6 -16
  209. package/es/src/charts/events/mouseleave.js +9 -2
  210. package/es/src/charts/events/mousemove.legend.js +28 -32
  211. package/es/src/charts/events/mousemove.shape.js +45 -42
  212. package/es/src/charts/facet/drawFacets.js +14 -5
  213. package/es/src/charts/features/annotationFrame.js +179 -0
  214. package/es/src/charts/features/annotationText.js +83 -0
  215. package/es/src/charts/features/annotationTypes.js +10 -0
  216. package/es/src/charts/features/attributionFeature.js +6 -11
  217. package/es/src/charts/features/axes.js +17 -5
  218. package/es/src/charts/features/axesFinal.js +10 -3
  219. package/es/src/charts/features/axesMeasure.js +33 -12
  220. package/es/src/charts/features/axisTooltip.js +138 -0
  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/centerLabel.js +177 -0
  224. package/es/src/charts/features/chartGeometry.js +1 -1
  225. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  226. package/es/src/charts/features/circleLabels.js +207 -0
  227. package/es/src/charts/features/colorScaleBivariate.js +83 -0
  228. package/es/src/charts/features/colorScaleBucket.js +20 -1
  229. package/es/src/charts/features/colorScaleHover.js +33 -7
  230. package/es/src/charts/features/colorScaleLimit.js +73 -0
  231. package/es/src/charts/features/colorScaleTooltip.js +77 -0
  232. package/es/src/charts/features/colorScaleTop.js +61 -0
  233. package/es/src/charts/features/colorScaleValue.js +97 -0
  234. package/es/src/charts/features/curvedArrows.js +191 -0
  235. package/es/src/charts/features/depthKey.js +26 -0
  236. package/es/src/charts/features/edgeArrows.js +220 -5
  237. package/es/src/charts/features/edgeBundling.js +442 -0
  238. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  239. package/es/src/charts/features/ensureZoomDom.js +32 -8
  240. package/es/src/charts/features/features.js +32 -14
  241. package/es/src/charts/features/featuresColorScale.js +75 -20
  242. package/es/src/charts/features/featuresLegend.js +15 -24
  243. package/es/src/charts/features/hoverTicks.js +41 -0
  244. package/es/src/charts/features/idleQueue.js +72 -0
  245. package/es/src/charts/features/legendKeys.js +64 -0
  246. package/es/src/charts/features/lineLabels.js +55 -46
  247. package/es/src/charts/features/linkBundle.js +19 -0
  248. package/es/src/charts/features/linkColor.js +72 -0
  249. package/es/src/charts/features/linkFields.js +86 -0
  250. package/es/src/charts/features/linkFocus.js +118 -0
  251. package/es/src/charts/features/linkInteraction.js +364 -0
  252. package/es/src/charts/features/linkKeys.js +20 -0
  253. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  254. package/es/src/charts/features/linkLabelPath.js +162 -0
  255. package/es/src/charts/features/linkLabels.js +340 -0
  256. package/es/src/charts/features/linkWidths.js +32 -0
  257. package/es/src/charts/features/networkMeasures.js +241 -0
  258. package/es/src/charts/features/nodeStats.js +309 -0
  259. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  260. package/es/src/charts/features/pathLabels.js +50 -0
  261. package/es/src/charts/features/plotAnnotations.js +68 -17
  262. package/es/src/charts/features/plotEndLabels.js +28 -7
  263. package/es/src/charts/features/plotPaint.js +46 -12
  264. package/es/src/charts/features/polyline.js +129 -0
  265. package/es/src/charts/features/referenceAnnotations.js +403 -0
  266. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  267. package/es/src/charts/features/ringLabelNodes.js +93 -0
  268. package/es/src/charts/features/ringLabels.js +222 -0
  269. package/es/src/charts/features/sceneBounds.js +26 -6
  270. package/es/src/charts/features/selfLoops.js +306 -0
  271. package/es/src/charts/features/shapeEmit.js +54 -32
  272. package/es/src/charts/features/sharedFields.js +15 -2
  273. package/es/src/charts/features/textHalo.js +30 -0
  274. package/es/src/charts/index.js +8 -0
  275. package/es/src/charts/partition/chartFields.js +14 -5
  276. package/es/src/charts/partition/interaction.js +19 -10
  277. package/es/src/charts/partition/zoom.js +7 -6
  278. package/es/src/charts/pipeline/insetPlacement.js +22 -9
  279. package/es/src/charts/pipeline/preDrawData.js +46 -3
  280. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  281. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  282. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  283. package/es/src/charts/polar/chrome.js +81 -9
  284. package/es/src/charts/polar/config.js +6 -3
  285. package/es/src/charts/polar/wedgeLayout.js +2 -1
  286. package/es/src/charts/viz/Viz.js +61 -49
  287. package/es/src/charts/viz/VizBase.js +57 -14
  288. package/es/src/charts/viz/backgroundInk.js +23 -7
  289. package/es/src/charts/viz/emphasis.js +14 -0
  290. package/es/src/charts/viz/fillStroke.js +10 -0
  291. package/es/src/charts/viz/focusRing.js +104 -0
  292. package/es/src/charts/viz/focusTargets.js +208 -0
  293. package/es/src/charts/viz/history.js +74 -0
  294. package/es/src/charts/viz/interactionOpacity.js +115 -32
  295. package/es/src/charts/viz/keyboardNav.js +297 -0
  296. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  297. package/es/src/charts/viz/loaderFormat.js +114 -0
  298. package/es/src/charts/viz/missingFields.js +2 -1
  299. package/es/src/charts/viz/mountTarget.js +9 -0
  300. package/es/src/charts/viz/nearestHover.js +183 -0
  301. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  302. package/es/src/charts/viz/ordinalColor.js +14 -12
  303. package/es/src/charts/viz/pageTheme.js +83 -0
  304. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  305. package/es/src/charts/viz/pointVoronoi.js +124 -0
  306. package/es/src/charts/viz/reducedMotion.js +27 -0
  307. package/es/src/charts/viz/reportDrawError.js +15 -0
  308. package/es/src/charts/viz/setCursor.js +29 -0
  309. package/es/src/charts/viz/tooltipEnabled.js +38 -0
  310. package/es/src/charts/viz/userClick.js +34 -0
  311. package/es/src/charts/viz/vizDataPolling.js +8 -4
  312. package/es/src/charts/viz/vizDefaults.js +28 -57
  313. package/es/src/charts/viz/vizFields.js +41 -1
  314. package/es/src/charts/viz/vizRender.js +76 -31
  315. package/es/src/charts/viz/vizTheme.js +96 -0
  316. package/es/src/charts/viz/vizVisibility.js +26 -2
  317. package/es/src/components/Axis/Axis.js +35 -2
  318. package/es/src/components/Axis/AxisBottom.js +1 -0
  319. package/es/src/components/Axis/AxisLeft.js +1 -0
  320. package/es/src/components/Axis/AxisRight.js +1 -0
  321. package/es/src/components/Axis/AxisTop.js +1 -0
  322. package/es/src/components/Axis/axisBreak.js +33 -8
  323. package/es/src/components/Axis/axisDefaults.js +16 -9
  324. package/es/src/components/Axis/axisLabelKinds.js +36 -0
  325. package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
  326. package/es/src/components/Axis/axisLabelRoom.js +37 -0
  327. package/es/src/components/Axis/axisLabelSize.js +171 -0
  328. package/es/src/components/Axis/axisLabelThinning.js +98 -4
  329. package/es/src/components/Axis/axisLayout.js +71 -46
  330. package/es/src/components/Axis/axisLayoutLabels.js +82 -140
  331. package/es/src/components/Axis/axisLayoutScale.js +16 -11
  332. package/es/src/components/Axis/axisLimit.js +27 -0
  333. package/es/src/components/Axis/axisMaxSize.js +39 -0
  334. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  335. package/es/src/components/Axis/axisRender.js +20 -8
  336. package/es/src/components/Axis/axisRounding.js +16 -1
  337. package/es/src/components/Axis/axisScene.js +11 -2
  338. package/es/src/components/Axis/axisTitle.js +53 -0
  339. package/es/src/components/Axis/axisTooltipTargets.js +128 -0
  340. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  341. package/es/src/components/Axis/rangeBreaks.js +201 -0
  342. package/es/src/components/Axis/timeValues.js +19 -4
  343. package/es/src/components/ColorScale/ColorScale.js +77 -27
  344. package/es/src/components/ColorScale/bivariateRender.js +353 -0
  345. package/es/src/components/ColorScale/bivariateScale.js +150 -0
  346. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  347. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  348. package/es/src/components/ColorScale/colorScaleRender.js +32 -2
  349. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  350. package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
  351. package/es/src/components/Legend/Legend.js +13 -2
  352. package/es/src/components/Legend/legendConfig.js +2 -6
  353. package/es/src/components/Legend/legendCut.js +108 -0
  354. package/es/src/components/Legend/legendRender.js +38 -13
  355. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  356. package/es/src/components/TextBox.js +34 -67
  357. package/es/src/components/Timeline/Timeline.js +12 -3
  358. package/es/src/components/Timeline/timelineConfig.js +20 -10
  359. package/es/src/components/Timeline/timelineMode.js +26 -0
  360. package/es/src/components/Timeline/timelineRender.js +9 -4
  361. package/es/src/components/Tooltip.js +15 -5
  362. package/es/src/components/fontStack.js +20 -0
  363. package/es/src/components/textBoxLayout.js +58 -21
  364. package/es/src/components/textBoxPath.js +73 -0
  365. package/es/src/components/textBoxScene.js +226 -0
  366. package/es/src/components/textBoxWords.js +70 -0
  367. package/es/src/components/textEllipsis.js +7 -0
  368. package/es/src/components/tooltipDom.js +8 -5
  369. package/es/src/fluent.js +48 -0
  370. package/es/src/shapes/Area.js +1 -0
  371. package/es/src/shapes/Bar.js +1 -0
  372. package/es/src/shapes/Box.js +1 -0
  373. package/es/src/shapes/Circle.js +1 -0
  374. package/es/src/shapes/Line.js +1 -0
  375. package/es/src/shapes/Path.js +1 -0
  376. package/es/src/shapes/Rect.js +1 -0
  377. package/es/src/shapes/Shape.js +1 -0
  378. package/es/src/shapes/Whisker.js +1 -0
  379. package/es/src/utils/BaseClass.js +30 -12
  380. package/es/src/utils/configPrep.js +2 -1
  381. package/es/src/utils/configValue.js +9 -0
  382. package/es/src/utils/constant.js +13 -1
  383. package/es/src/utils/displayName.js +12 -0
  384. package/es/src/utils/theme.js +190 -0
  385. package/es/src/utils/themeInk.js +68 -0
  386. package/package.json +14 -11
  387. package/types/index.d.ts +6 -2
  388. package/types/internal.d.ts +268 -9
  389. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  390. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  391. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  392. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  393. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  394. package/types/src/charts/Alluvial/index.d.ts +27 -0
  395. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  396. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  397. package/types/src/charts/Alluvial/titles.d.ts +46 -0
  398. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  399. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  400. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  401. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  402. package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
  403. package/types/src/charts/ArcDiagram/events.d.ts +29 -0
  404. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  405. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  406. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  407. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  408. package/types/src/charts/Chord/labels.d.ts +66 -0
  409. package/types/src/charts/Donut/index.d.ts +2 -1
  410. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  411. package/types/src/charts/Gantt/emit.d.ts +17 -0
  412. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  413. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  414. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  415. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  416. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  417. package/types/src/charts/Gantt/index.d.ts +36 -0
  418. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  419. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  420. package/types/src/charts/Geomap/emit.d.ts +2 -2
  421. package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
  422. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  423. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  424. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  425. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  426. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  427. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  428. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  429. package/types/src/charts/Geomap/index.d.ts +3 -0
  430. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  431. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  432. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  433. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  434. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  435. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  436. package/types/src/charts/Hexbin/index.d.ts +25 -0
  437. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  438. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  439. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  440. package/types/src/charts/Histogram/binData.d.ts +20 -1
  441. package/types/src/charts/Histogram/index.d.ts +3 -2
  442. package/types/src/charts/Histogram/labels.d.ts +7 -0
  443. package/types/src/charts/Marimekko/index.d.ts +2 -1
  444. package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
  445. package/types/src/charts/Network/applyLayout.d.ts +11 -0
  446. package/types/src/charts/Network/bundle.d.ts +69 -0
  447. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  448. package/types/src/charts/Network/clusters.d.ts +115 -0
  449. package/types/src/charts/Network/graph.d.ts +73 -0
  450. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  451. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  452. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  453. package/types/src/charts/Pack/applyLayout.d.ts +2 -0
  454. package/types/src/charts/Pack/groupRows.d.ts +46 -0
  455. package/types/src/charts/Pack/index.d.ts +3 -0
  456. package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
  457. package/types/src/charts/Pack/nodeNames.d.ts +23 -0
  458. package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
  459. package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
  460. package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
  461. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  462. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  463. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  464. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  465. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  466. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  467. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  468. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  469. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  470. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  471. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  472. package/types/src/charts/Plot/areaEnter.d.ts +34 -0
  473. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  474. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  475. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  476. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  477. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  478. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  479. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  480. package/types/src/charts/Plot/index.d.ts +16 -15
  481. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  482. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  483. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  484. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  485. package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
  486. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  487. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  488. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  489. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  490. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  491. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  492. package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
  493. package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
  494. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  495. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  496. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  497. package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
  498. package/types/src/charts/Pyramid/gutter.d.ts +28 -6
  499. package/types/src/charts/Pyramid/scene.d.ts +1 -1
  500. package/types/src/charts/Radar/applyLayout.d.ts +2 -3
  501. package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
  502. package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
  503. package/types/src/charts/Radar/emit.d.ts +5 -2
  504. package/types/src/charts/Radar/index.d.ts +7 -2
  505. package/types/src/charts/Radar/points.d.ts +50 -0
  506. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  507. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  508. package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
  509. package/types/src/charts/Rings/emit.d.ts +72 -0
  510. package/types/src/charts/Rings/index.d.ts +4 -2
  511. package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
  512. package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
  513. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  514. package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
  515. package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
  516. package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
  517. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  518. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  519. package/types/src/charts/Sankey/emit.d.ts +58 -0
  520. package/types/src/charts/Sankey/labels.d.ts +19 -0
  521. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  522. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  523. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  524. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  525. package/types/src/charts/Scatter/index.d.ts +15 -0
  526. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  527. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  528. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  529. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  530. package/types/src/charts/Tree/applyLayout.d.ts +20 -0
  531. package/types/src/charts/Tree/keys.d.ts +25 -0
  532. package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
  533. package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
  534. package/types/src/charts/definition/makeChart.d.ts +3 -2
  535. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  536. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  537. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  538. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  539. package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
  540. package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
  541. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
  542. package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
  543. package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
  544. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  545. package/types/src/charts/events/click.legend.d.ts +2 -1
  546. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  547. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  548. package/types/src/charts/features/annotationText.d.ts +57 -0
  549. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  550. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  551. package/types/src/charts/features/axisTooltip.d.ts +49 -0
  552. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  553. package/types/src/charts/features/calloutScene.d.ts +40 -0
  554. package/types/src/charts/features/centerLabel.d.ts +75 -0
  555. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  556. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  557. package/types/src/charts/features/circleLabels.d.ts +130 -0
  558. package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
  559. package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
  560. package/types/src/charts/features/colorScaleHover.d.ts +13 -3
  561. package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
  562. package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
  563. package/types/src/charts/features/colorScaleTop.d.ts +30 -0
  564. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  565. package/types/src/charts/features/curvedArrows.d.ts +119 -0
  566. package/types/src/charts/features/depthKey.d.ts +19 -0
  567. package/types/src/charts/features/edgeArrows.d.ts +103 -4
  568. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  569. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  570. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  571. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  572. package/types/src/charts/features/hoverTicks.d.ts +30 -0
  573. package/types/src/charts/features/idleQueue.d.ts +46 -0
  574. package/types/src/charts/features/legendKeys.d.ts +34 -0
  575. package/types/src/charts/features/lineLabels.d.ts +15 -12
  576. package/types/src/charts/features/linkBundle.d.ts +16 -0
  577. package/types/src/charts/features/linkColor.d.ts +48 -0
  578. package/types/src/charts/features/linkFields.d.ts +16 -0
  579. package/types/src/charts/features/linkFocus.d.ts +51 -0
  580. package/types/src/charts/features/linkInteraction.d.ts +192 -0
  581. package/types/src/charts/features/linkKeys.d.ts +11 -0
  582. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  583. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  584. package/types/src/charts/features/linkLabels.d.ts +77 -0
  585. package/types/src/charts/features/linkWidths.d.ts +19 -0
  586. package/types/src/charts/features/networkMeasures.d.ts +53 -0
  587. package/types/src/charts/features/nodeStats.d.ts +93 -0
  588. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  589. package/types/src/charts/features/pathLabels.d.ts +41 -0
  590. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  591. package/types/src/charts/features/plotEndLabels.d.ts +14 -1
  592. package/types/src/charts/features/plotPaint.d.ts +17 -0
  593. package/types/src/charts/features/polyline.d.ts +32 -0
  594. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  595. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  596. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  597. package/types/src/charts/features/ringLabels.d.ts +164 -0
  598. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  599. package/types/src/charts/features/selfLoops.d.ts +165 -0
  600. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  601. package/types/src/charts/features/sharedFields.d.ts +11 -2
  602. package/types/src/charts/features/textHalo.d.ts +15 -0
  603. package/types/src/charts/index.d.ts +8 -0
  604. package/types/src/charts/partition/chartFields.d.ts +6 -1
  605. package/types/src/charts/partition/interaction.d.ts +6 -3
  606. package/types/src/charts/partition/zoom.d.ts +4 -4
  607. package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
  608. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  609. package/types/src/charts/pipeline/stages.d.ts +7 -0
  610. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  611. package/types/src/charts/polar/chrome.d.ts +19 -6
  612. package/types/src/charts/viz/Viz.d.ts +25 -4
  613. package/types/src/charts/viz/VizBase.d.ts +37 -8
  614. package/types/src/charts/viz/backgroundInk.d.ts +19 -4
  615. package/types/src/charts/viz/emphasis.d.ts +17 -0
  616. package/types/src/charts/viz/fillStroke.d.ts +7 -0
  617. package/types/src/charts/viz/focusRing.d.ts +25 -0
  618. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  619. package/types/src/charts/viz/history.d.ts +35 -0
  620. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  621. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  622. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  623. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  624. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  625. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  626. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  627. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  628. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  629. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  630. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  631. package/types/src/charts/viz/reportDrawError.d.ts +12 -0
  632. package/types/src/charts/viz/setCursor.d.ts +26 -0
  633. package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
  634. package/types/src/charts/viz/userClick.d.ts +35 -0
  635. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  636. package/types/src/charts/viz/vizFields.d.ts +37 -0
  637. package/types/src/charts/viz/vizRender.d.ts +2 -1
  638. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  639. package/types/src/charts/viz/vizTypes.d.ts +100 -7
  640. package/types/src/charts/viz/vizVisibility.d.ts +13 -0
  641. package/types/src/components/Axis/Axis.d.ts +34 -3
  642. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  643. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  644. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  645. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  646. package/types/src/components/Axis/axisBreak.d.ts +21 -3
  647. package/types/src/components/Axis/axisDefaults.d.ts +12 -0
  648. package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
  649. package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
  650. package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
  651. package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
  652. package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
  653. package/types/src/components/Axis/axisLayout.d.ts +9 -2
  654. package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
  655. package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
  656. package/types/src/components/Axis/axisLimit.d.ts +18 -0
  657. package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
  658. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  659. package/types/src/components/Axis/axisRounding.d.ts +8 -0
  660. package/types/src/components/Axis/axisTitle.d.ts +30 -0
  661. package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
  662. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  663. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  664. package/types/src/components/Axis/timeValues.d.ts +1 -1
  665. package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
  666. package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
  667. package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
  668. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  669. package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
  670. package/types/src/components/Legend/Legend.d.ts +6 -0
  671. package/types/src/components/Legend/legendCut.d.ts +31 -0
  672. package/types/src/components/Legend/legendRender.d.ts +6 -1
  673. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  674. package/types/src/components/TextBox.d.ts +5 -0
  675. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  676. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  677. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  678. package/types/src/components/Tooltip.d.ts +4 -3
  679. package/types/src/components/fontStack.d.ts +10 -0
  680. package/types/src/components/textBoxLayout.d.ts +18 -9
  681. package/types/src/components/textBoxPath.d.ts +59 -0
  682. package/types/src/components/textBoxScene.d.ts +51 -0
  683. package/types/src/components/textBoxWords.d.ts +33 -0
  684. package/types/src/components/textEllipsis.d.ts +6 -0
  685. package/types/src/fluent.d.ts +18 -0
  686. package/types/src/shapes/Area.d.ts +1 -0
  687. package/types/src/shapes/Bar.d.ts +1 -0
  688. package/types/src/shapes/Box.d.ts +1 -0
  689. package/types/src/shapes/Circle.d.ts +1 -0
  690. package/types/src/shapes/Line.d.ts +1 -0
  691. package/types/src/shapes/Path.d.ts +1 -0
  692. package/types/src/shapes/Rect.d.ts +1 -0
  693. package/types/src/shapes/Shape.d.ts +1 -0
  694. package/types/src/shapes/Whisker.d.ts +1 -0
  695. package/types/src/shapes/emitLabels.d.ts +1 -1
  696. package/types/src/utils/BaseClass.d.ts +9 -0
  697. package/types/src/utils/D3plusConfig.d.ts +1093 -266
  698. package/types/src/utils/configPrep.d.ts +2 -0
  699. package/types/src/utils/configValue.d.ts +8 -0
  700. package/types/src/utils/constant.d.ts +8 -0
  701. package/types/src/utils/displayName.d.ts +10 -0
  702. package/types/src/utils/index.d.ts +1 -1
  703. package/types/src/utils/theme.d.ts +170 -0
  704. package/types/src/utils/themeInk.d.ts +56 -0
  705. package/types/umd-entry.d.ts +4 -0
  706. package/umd/d3plus-core.full.js +72239 -41465
  707. package/umd/d3plus-core.full.min.js +2 -2
  708. package/umd/d3plus-core.js +46249 -19519
  709. package/umd/d3plus-core.min.js +2 -2
  710. package/es/src/components/Axis/gridStroke.js +0 -10
  711. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -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
  });
@@ -10,12 +10,8 @@ import { computeTimeFilter } from "../pipeline/preDrawData.js";
10
10
  import Plot from "../Plot/index.js";
11
11
  import { fieldAccessor } from "../../utils/fieldAccessor.js";
12
12
  import { autoTitle, keyedAccessor, valueKeyOf } from "../helpers/valueTitle.js";
13
- import binData from "./binData.js";
14
- const yTitles = {
15
- count: "Count",
16
- density: "Density",
17
- relative: "Relative Frequency"
18
- };
13
+ import binData, { cumulativeNormalize } from "./binData.js";
14
+ import { heightLabel } from "./labels.js";
19
15
  /** Walks Plot's `__d3plus__` wrappers down to the bin row. */ function binRow(d) {
20
16
  while(d && d.__d3plus__ && d.data)d = d.data;
21
17
  return d;
@@ -58,7 +54,8 @@ const yTitles = {
58
54
  thresholds: viz.schema.binThresholds,
59
55
  domain: viz.schema.binDomain,
60
56
  width: viz.schema.binWidth,
61
- normalize: viz.schema.binNormalize
57
+ normalize: viz.schema.binNormalize,
58
+ cumulative: viz.schema.cumulative
62
59
  });
63
60
  // Ungrouped observations become one series named after the value, so it
64
61
  // colors and labels like any other series.
@@ -76,7 +73,7 @@ const yTitles = {
76
73
  ...offstage
77
74
  ] : bins;
78
75
  state.binned = new Set(bins);
79
- const yTitle = viz.schema.translate(yTitles[viz.schema.binNormalize] ?? yTitles.count);
76
+ const yTitle = viz.schema.translate(heightLabel(viz.schema.binNormalize, viz.schema.cumulative));
80
77
  autoTitle(viz._yConfig, state.yTitle, yTitle);
81
78
  state.yTitle = yTitle;
82
79
  autoTitle(viz._xConfig, state.xTitle, valueKey);
@@ -172,6 +169,19 @@ export const histogramDef = {
172
169
  key: "binNormalize",
173
170
  default: "count"
174
171
  },
172
+ /**
173
+ Accumulates each bar's height across the bins: `true` shows, at each
174
+ bin, everything up to that bin's end (a running count, or with
175
+ `binNormalize("relative")` an empirical CDF that ends at 1), and
176
+ `"reverse"` everything from that bin's start up (a survival curve).
177
+ A cumulative `"density"` is the running share of observations, so it
178
+ draws like `"relative"`. Each `groupBy` series accumulates its own
179
+ counts, so stacked bars show the running total of every series.
180
+ @type {boolean | "reverse"}
181
+ */ {
182
+ key: "cumulative",
183
+ default: false
184
+ },
175
185
  {
176
186
  key: "discrete",
177
187
  default: "x"
@@ -199,24 +209,30 @@ export const histogramDef = {
199
209
  title: (d, i)=>hasGroups(d, i) ? viz._drawLabel(binRow(d), i) : range(d),
200
210
  tbody: (d, i)=>{
201
211
  const b = binRow(d);
212
+ const t = viz.schema.translate;
202
213
  const rows = [];
203
214
  if (isSeries(b)) return [
204
215
  [
205
- viz.schema.translate(yTitles.count),
216
+ t("Count"),
206
217
  fmt(b.count)
207
218
  ]
208
219
  ];
209
220
  if (hasGroups(d, i)) rows.push([
210
- viz.schema.translate("Range"),
221
+ t("Range"),
211
222
  range(d)
212
223
  ]);
213
224
  rows.push([
214
- viz.schema.translate(yTitles.count),
225
+ t("Count"),
215
226
  fmt(b.count)
216
227
  ]);
228
+ const cumulative = viz.schema.cumulative;
229
+ if (cumulative) rows.push([
230
+ t("Cumulative Count"),
231
+ fmt(Number(b.cumulativeCount))
232
+ ]);
217
233
  const normalize = viz.schema.binNormalize;
218
- if (normalize !== "count") rows.push([
219
- viz.schema.translate(yTitles[normalize]),
234
+ if (cumulativeNormalize(normalize, cumulative) !== "count") rows.push([
235
+ t(heightLabel(normalize, cumulative)),
220
236
  fmt(b.y)
221
237
  ]);
222
238
  return rows;
@@ -237,6 +253,7 @@ export const histogramDef = {
237
253
  /**
238
254
  Creates a histogram from an array of raw observations: the `value` of each
239
255
  row is binned along a linear x axis, and bar heights show each bin's
240
- count (or density / relative frequency via `binNormalize`). Series set by
241
- `groupBy` share bin edges and are stacked.
256
+ count (or density / relative frequency via `binNormalize`, and running
257
+ totals via `cumulative`). Series set by `groupBy` share bin edges and are
258
+ stacked.
242
259
  */ export default makeChart(histogramDef, Plot);
@@ -0,0 +1,18 @@
1
+ /** The English labels Histogram translates for its y axis and tooltip rows. */ import { cumulativeNormalize } from "./binData.js";
2
+ const labels = {
3
+ count: "Count",
4
+ density: "Density",
5
+ relative: "Relative Frequency"
6
+ };
7
+ const cumulativeLabels = {
8
+ count: "Cumulative Count",
9
+ density: "Cumulative Relative Frequency",
10
+ relative: "Cumulative Relative Frequency"
11
+ };
12
+ /**
13
+ The (untranslated) label for what a bar's height measures under
14
+ `binNormalize` and `cumulative`, used as the default y-axis title.
15
+ */ export function heightLabel(normalize = "count", cumulative = false) {
16
+ const n = cumulativeNormalize(labels[normalize] ? normalize : "count", cumulative);
17
+ return (cumulative ? cumulativeLabels : labels)[n];
18
+ }
@@ -12,15 +12,15 @@
12
12
  - `enterStagger.ts` — where and when entering rectangles grow in.
13
13
  - `interaction.ts` — the zoom origin and node lookup for the shared
14
14
  partition interaction.
15
- */ import { backgroundColor } from "@d3plus/dom";
16
- import accessor from "../../utils/accessor.js";
15
+ */ import accessor from "../../utils/accessor.js";
17
16
  import { makeChart } from "../definition/makeChart.js";
18
17
  import { rowLegend, shareRow } from "../features/sharedFields.js";
19
- import { partitionDefaultSort, partitionLegendSort, partitionSetup, partitionSortDecorate, partitionSumCoerce, partitionSumOnSet, partitionThreshold } from "../partition/chartFields.js";
18
+ import { partitionDefaultSort, partitionLegendSort, partitionSetup, partitionShapeDepth, partitionSortDecorate, partitionSumCoerce, partitionSumOnSet, partitionThreshold } from "../partition/chartFields.js";
20
19
  import { partitionShadeDefaults } from "../partition/shade.js";
21
20
  import { applyIcicleLayout } from "./applyLayout.js";
22
21
  import { icicleEmit } from "./emit.js";
23
22
  import { icicleInteraction } from "./interaction.js";
23
+ import { chartBackground } from "../viz/backgroundInk.js";
24
24
  export const icicleDef = {
25
25
  name: "Icicle",
26
26
  layoutStage: applyIcicleLayout,
@@ -28,6 +28,8 @@ export const icicleDef = {
28
28
  thresholdFunction: partitionThreshold,
29
29
  // Shading applies only while the default colors stay in place.
30
30
  setup: (viz)=>partitionSetup(viz, icicleInteraction),
31
+ // Each node reports its own `groupBy` level to the `tooltip` accessor.
32
+ shapeDepth: partitionShapeDepth(icicleInteraction),
31
33
  ctx: {},
32
34
  fields: [
33
35
  /**
@@ -91,7 +93,7 @@ export const icicleDef = {
91
93
  },
92
94
  // A thin outline in the chart's background color separates
93
95
  // neighboring rectangles and levels by the same width everywhere.
94
- stroke: ()=>backgroundColor(viz._select?.node()),
96
+ stroke: ()=>chartBackground(viz),
95
97
  strokeWidth: 1
96
98
  })
97
99
  },
@@ -12,6 +12,13 @@ export const linePlotDef = {
12
12
  key: "discrete",
13
13
  default: "x"
14
14
  },
15
+ /**
16
+ LinePlot names each series along its own line by default (see
17
+ `lineLabels`), and its legend hides when every line got a name.
18
+ */ {
19
+ key: "lineLabels",
20
+ default: "along"
21
+ },
15
22
  {
16
23
  key: "shape",
17
24
  default: constant("Line"),
@@ -47,13 +47,15 @@ export const marimekkoDef = {
47
47
  factory: barTotal
48
48
  },
49
49
  /**
50
- Marimekko shows the shares by default ("Retail" over "50%"); `false`
51
- shows the name alone. The tooltip always shows the share. In small
50
+ Marimekko shows the shares above the bars by default (`"opposite"`),
51
+ leaving the names alone beneath them; `true` puts each share
52
+ beneath its name ("Retail" over "50%"), and `false` shows the name
53
+ alone. The tooltip always shows the share. In small
52
54
  multiples (`facet`), each panel's shares add to 100%, even when
53
55
  shared scales (the default) draw a smaller panel narrower.
54
56
  */ {
55
57
  key: "barWidthShare",
56
- default: true
58
+ default: "opposite"
57
59
  },
58
60
  {
59
61
  key: "stacked",
@@ -70,7 +72,8 @@ export const marimekkoDef = {
70
72
  Creates a Marimekko (mosaic) chart from an array of data: one bar per
71
73
  discrete value (`x`), as wide as its `barWidth` (by default its total),
72
74
  with the bar's `groupBy` segments stacked to 100% of its height. Each
73
- category's label shows its bar's share of the total width, and tooltips
75
+ category is named beneath its bar, with the bar's share of the total
76
+ width above it (see `barWidthShare`), and tooltips
74
77
  show each segment's value, its share of the bar, and the bar's width and
75
78
  share of the total width. Set `stackOffset("none")` to stack absolute
76
79
  values instead.