@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,234 @@
1
+ /**
2
+ Hexbin's contour labels: each labelled level's value written along its
3
+ contour lines, the way a topographic map labels elevation. Labels sit
4
+ centered on the line, read upright, break the line beneath them, and
5
+ keep clear of the other contours and labels; long rings take several,
6
+ `labelSpacing` apart, and dense levels are labelled every `labelStep`-th.
7
+
8
+ @module
9
+ */ import { fontExists, textWidth } from "@d3plus/dom";
10
+ import { fontFamily as defaultFontFamily } from "@d3plus/text";
11
+ import { offsetPolyline, polylineD, polylineLength, trimPolyline } from "../features/pathLabelGeometry.js";
12
+ import { pathLabelNodes } from "../features/pathLabels.js";
13
+ import { bestStretchAt, labelBand, PointGrid, resample } from "../Plot/lineLabelsAlong.js";
14
+ import { backgroundInk, chartBackground } from "../viz/backgroundInk.js";
15
+ import { hexbinMeta } from "./settings.js";
16
+ import { contourLevelText } from "./tooltip.js";
17
+ /** The labels' font size when `labelConfig` sets none. */ export const CONTOUR_LABEL_FONT_SIZE = 10;
18
+ /** With more levels than this, `labelStep: "auto"` labels every other level. */ export const CONTOUR_LABEL_MAX_LEVELS = 5;
19
+ /** How far below the line a label's baseline sits, in ems, so its digits' middles sit on the line. */ const BASELINE_DROP = 0.3;
20
+ /** The gap the line breaks for at each end of a label, in ems. */ const END_GAP = 0.4;
21
+ /** The least room a label keeps from the other lines and labels, in ems. */ const CLEARANCE = 0.3;
22
+ /** The most a label's stretch may turn in all, in radians. */ const MAX_TURN = Math.PI / 3;
23
+ /**
24
+ A contour path's rings as closed polylines (the last point repeats the
25
+ first).
26
+ @param d The contour's path: `M x,y L x,y … Z` per ring.
27
+ */ export function contourRings(d) {
28
+ return (d.match(/M[^MZ]*/g) ?? []).map((ring)=>ring.slice(1).split("L").map((pair)=>pair.split(",").map(Number)).filter(([x, y])=>Number.isFinite(x) && Number.isFinite(y))).filter((points)=>points.length > 2).map((points)=>[
29
+ ...points,
30
+ points[0]
31
+ ]);
32
+ }
33
+ /**
34
+ How many levels apart labelled levels are (see `contourConfig.labelStep`):
35
+ a whole number of at least 1, or with `"auto"` (or anything else), 1
36
+ with up to `CONTOUR_LABEL_MAX_LEVELS` levels and 2 with more.
37
+ @param option The `labelStep` option.
38
+ @param count How many levels there are.
39
+ */ export function contourLabelStep(option, count) {
40
+ if (typeof option === "number" && Number.isFinite(option)) return Math.max(1, Math.round(option));
41
+ return count > CONTOUR_LABEL_MAX_LEVELS ? 2 : 1;
42
+ }
43
+ /**
44
+ Which levels take labels: every `step`-th one, keeping the levels at
45
+ multiples of `step` times their spacing (the "index" contours), or
46
+ every `step`-th position, from the `step`-th lowest, when the levels
47
+ aren't evenly spaced from zero.
48
+ @param levels The levels, lowest first.
49
+ @param step How many levels apart labelled levels are (see `contourLabelStep`).
50
+ */ export function labelledLevels(levels, step = contourLabelStep("auto", levels.length)) {
51
+ if (step <= 1) return levels.map(()=>true);
52
+ const spacing = levels[1] - levels[0];
53
+ const even = spacing > 0 && levels.every((l, i)=>!i || Math.abs(l - levels[i - 1] - spacing) < 1e-9);
54
+ const multiple = (l)=>Math.round(l / spacing) % step === 0;
55
+ if (even && Math.abs(levels[0] / spacing - Math.round(levels[0] / spacing)) < 1e-9) return levels.map(multiple);
56
+ return levels.map((_, i)=>(i + 1) % step === 0);
57
+ }
58
+ /**
59
+ The least distance between two labels' middles along one contour line,
60
+ in pixels (see `contourConfig.labelSpacing`): a positive number as
61
+ given, or with `"auto"` (or anything else), 20 ems or half the plot's
62
+ mean side, whichever is longer.
63
+ @param option The `labelSpacing` option.
64
+ @param fontSize The labels' font size.
65
+ @param frame The plot area.
66
+ */ export function contourLabelSpacing(option, fontSize, frame) {
67
+ if (typeof option === "number" && option > 0 && Number.isFinite(option)) return option;
68
+ return Math.max(fontSize * 20, (frame.width + frame.height) / 4);
69
+ }
70
+ /**
71
+ The distance between two points along a closed ring of length `total`,
72
+ whichever way round is shorter.
73
+ @param a How far along the ring the first point lies.
74
+ @param b How far along the ring the second point lies.
75
+ @param total The ring's length.
76
+ */ export function ringDistance(a, b, total) {
77
+ const d = Math.abs(((a - b) % total + total) % total);
78
+ return Math.min(d, total - d);
79
+ }
80
+ /**
81
+ The points a placed label keeps other labels from: its band (see
82
+ `labelBand`), widened by half an em above and below, so stacked labels
83
+ on neighboring contours keep a gap between them.
84
+ @param points The label's upright stretch.
85
+ @param ctx The font size and lift.
86
+ */ export function paddedBand(points, ctx) {
87
+ const pad = ctx.fontSize / 2;
88
+ return [
89
+ -pad,
90
+ 0,
91
+ pad
92
+ ].flatMap((d)=>labelBand(points, {
93
+ ...ctx,
94
+ lift: ctx.lift + d
95
+ }));
96
+ }
97
+ /**
98
+ The stretches labels along a closed ring take: as many as its length
99
+ allows at `spacing` pixels apart (at least one), each the best-scoring
100
+ stretch left that is clear of the obstacles and at least `spacing` along
101
+ the ring from the others. Each one's padded band (see `paddedBand`) is
102
+ added to the obstacles.
103
+ @param ring The closed ring.
104
+ @param length Each label's length.
105
+ @param ctx The obstacles (ignoring the ring's own points), plot area, and font.
106
+ @param spacing The least distance between two labels' middles along the ring (at least a label's length).
107
+ */ export function ringLabelStretches(ring, length, ctx, spacing) {
108
+ const total = polylineLength(ring);
109
+ if (!(total > length * 2)) return [];
110
+ // Labels closer than their own length would overlap.
111
+ const gap = Math.max(spacing, length);
112
+ // Twice round, so a stretch can cross where the ring starts and ends.
113
+ const loop = trimPolyline([
114
+ ...ring,
115
+ ...ring.slice(1)
116
+ ], 0, total + length);
117
+ const count = Math.max(1, Math.floor(total / gap));
118
+ const middles = [];
119
+ const out = [];
120
+ while(out.length < count){
121
+ const spot = bestStretchAt([
122
+ loop
123
+ ], length, ctx, (from)=>from < total && middles.every((m)=>ringDistance(from + length / 2, m, total) >= gap));
124
+ if (!spot) break;
125
+ middles.push(spot.from + length / 2);
126
+ out.push(spot.points);
127
+ ctx.grid.add(paddedBand(spot.points, ctx));
128
+ }
129
+ return out;
130
+ }
131
+ /** Each contour level's drawn color, by its index: its stroke, or for filled contours its fill. */ function levelColors(nodes) {
132
+ const colors = new Map();
133
+ for (const node of nodes){
134
+ const meta = hexbinMeta(node.datum);
135
+ if (meta?.kind !== "contour") continue;
136
+ const paint = node.paint ?? {};
137
+ const color = (paint.strokeWidth ?? 0) > 0 ? paint.stroke : paint.fill;
138
+ if (color) colors.set(meta.index, color);
139
+ }
140
+ return colors;
141
+ }
142
+ /**
143
+ The labels along a Hexbin's contour lines (`contourConfig.labels`): for
144
+ each labelled level, its formatted value along its rings, centered on
145
+ the line, upright, on a pad of the chart's background that breaks the
146
+ line beneath (when the contours are lines). Inert: no hover, click, or
147
+ keyboard stop.
148
+ @param viz The chart.
149
+ @param rows The contour rows, lowest level first.
150
+ @param nodes The contours' drawn nodes, for their colors.
151
+ @param frame The plot area.
152
+ @param settings The chart's resolved options.
153
+ @param obstacles Other lines to keep clear of, such as trend lines.
154
+ */ export function emitContourLabels(viz, rows, nodes, frame, settings, obstacles = []) {
155
+ const { labels, labelConfig, labelSpacing, labelStep, strokeWidth } = settings.contourConfig;
156
+ if (!labels || !rows.length) return [];
157
+ const metas = rows.map((row)=>hexbinMeta(row)).filter((m)=>m?.kind === "contour");
158
+ const rings = metas.map((meta)=>contourRings(meta.path));
159
+ const fontSize = typeof labelConfig.fontSize === "number" ? labelConfig.fontSize : CONTOUR_LABEL_FONT_SIZE;
160
+ const style = {
161
+ "font-family": fontExists(labelConfig.fontFamily ?? defaultFontFamily),
162
+ "font-size": fontSize,
163
+ "font-weight": labelConfig.fontWeight ?? 600
164
+ };
165
+ const rect = {
166
+ x0: frame.left,
167
+ y0: frame.top,
168
+ x1: frame.left + frame.width,
169
+ y1: frame.top + frame.height
170
+ };
171
+ const grid = new PointGrid(fontSize);
172
+ for (const line of obstacles)grid.add(resample(line, 2));
173
+ let tag = 0;
174
+ const tags = rings.map((level)=>level.map((ring)=>{
175
+ grid.add(resample(ring, 2), tag);
176
+ return tag++;
177
+ }));
178
+ const ctx = {
179
+ grid,
180
+ rect,
181
+ fontSize,
182
+ lift: -BASELINE_DROP * fontSize,
183
+ maxTurn: MAX_TURN,
184
+ // Wide enough that no line slips between the band's rows.
185
+ minClearance: Math.max(2, CLEARANCE * fontSize)
186
+ };
187
+ const spacing = contourLabelSpacing(labelSpacing, fontSize, frame);
188
+ const colors = levelColors(nodes);
189
+ const lines = settings.contours === "lines" && strokeWidth > 0;
190
+ const labelled = labelledLevels(metas.map((m)=>m.level), contourLabelStep(labelStep, metas.length));
191
+ const pads = [];
192
+ const texts = [];
193
+ metas.forEach((meta, l)=>{
194
+ if (!labelled[l]) return;
195
+ const text = contourLevelText(viz, meta.level);
196
+ if (!text) return;
197
+ const length = textWidth(text, style) + 2 * END_GAP * fontSize;
198
+ rings[l].forEach((ring, r)=>{
199
+ ctx.ignore = tags[l][r];
200
+ ringLabelStretches(ring, length, ctx, spacing).forEach((stretch, k)=>{
201
+ const key = `contour-label-${meta.index}-${r}-${k}`;
202
+ if (lines) pads.push({
203
+ type: "path",
204
+ key: `${key}-pad`,
205
+ d: polylineD(stretch),
206
+ interactive: false,
207
+ aria: {
208
+ hidden: true
209
+ },
210
+ paint: {
211
+ fill: "none",
212
+ stroke: chartBackground(viz),
213
+ strokeWidth: strokeWidth + 2,
214
+ strokeLinecap: "butt"
215
+ }
216
+ });
217
+ texts.push({
218
+ key,
219
+ text,
220
+ d: polylineD(offsetPolyline(stretch, ctx.lift)),
221
+ color: colors.get(meta.index) ?? backgroundInk(viz),
222
+ anchor: "middle"
223
+ });
224
+ });
225
+ });
226
+ });
227
+ return [
228
+ ...pads,
229
+ ...pathLabelNodes(viz, texts, {
230
+ fontSize,
231
+ ...labelConfig
232
+ })
233
+ ];
234
+ }
@@ -0,0 +1,48 @@
1
+ /**
2
+ Hexbin's pure density-contour helpers: a kernel density estimate of the
3
+ points in pixel space (d3-contour's `contourDensity`), cut at threshold
4
+ levels, each level's region as an SVG path.
5
+
6
+ Levels are in points per bin: the density (points per square pixel)
7
+ times the area of one bin, so a level reads as the count a bin would
8
+ hold there and shares the bins' color scale.
9
+
10
+ @module
11
+ */ import { contourDensity } from "d3-contour";
12
+ import { ticks } from "d3-array";
13
+ /**
14
+ The levels to cut a density whose peak is `max` at: the given levels
15
+ above zero (sorted), or about `thresholds` nice values between zero and
16
+ the peak.
17
+ */ export function contourLevels(max, thresholds) {
18
+ if (Array.isArray(thresholds)) return thresholds.filter((t)=>Number.isFinite(t) && t > 0).sort((a, b)=>a - b);
19
+ if (!(max > 0) || !(thresholds > 0)) return [];
20
+ return ticks(0, max, thresholds).filter((t)=>t > 0 && t < max);
21
+ }
22
+ /** A MultiPolygon's rings as one absolute SVG path, shifted by `[dx, dy]`. */ export function contourPath(coordinates, [dx, dy] = [
23
+ 0,
24
+ 0
25
+ ]) {
26
+ const round = (n)=>Math.round(n * 100) / 100;
27
+ return coordinates.flatMap((polygon)=>polygon.map((ring)=>`M${ring.map(([x, y])=>`${round(x + dx)},${round(y + dy)}`).join("L")}Z`)).join("");
28
+ }
29
+ /**
30
+ The density contours of `points`, one per level that encloses any area,
31
+ lowest level first.
32
+ */ export function densityContours(points, options) {
33
+ const { left, top, width, height, bandwidth, unit } = options;
34
+ const valid = points.filter((p)=>Number.isFinite(p.x) && Number.isFinite(p.y));
35
+ if (!valid.length || !(width > 0) || !(height > 0) || !(unit > 0)) return [];
36
+ const density = contourDensity().x((p)=>p.x - left).y((p)=>p.y - top).weight((p)=>typeof p.weight === "number" && Number.isFinite(p.weight) ? p.weight : 1).size([
37
+ Math.ceil(width),
38
+ Math.ceil(height)
39
+ ]).bandwidth(Math.max(bandwidth, 0.5));
40
+ const contours = density.contours(valid);
41
+ return contourLevels(contours.max * unit, options.thresholds).map((level)=>({
42
+ level,
43
+ path: contourPath(contours(level / unit).coordinates, [
44
+ left,
45
+ top
46
+ ])
47
+ })).filter((c)=>c.path.length);
48
+ }
@@ -0,0 +1,142 @@
1
+ /**
2
+ Hexbin's Plot shape emitter: the observations binned in pixel space and
3
+ drawn as hexagons or squares, with optional density contours and the raw
4
+ observations beneath. Bins and contours are Paths stamped as `"Hexbin"`
5
+ marks, each carrying a bin or contour row as its datum, so tooltips,
6
+ hover, events and keyboard navigation treat them like any other mark.
7
+
8
+ @module
9
+ */ import { collectComputed, makeShape, shapeConfigFor } from "../features/emitHelpers.js";
10
+ import { backgroundInk } from "../viz/backgroundInk.js";
11
+ import { binPoints } from "./binning.js";
12
+ import { emitContourLabels } from "./contourLabels.js";
13
+ import { binRows, binsInView, contourRows, hexbinState, plotFrame, pointPath, refreshColorScale, sharedColorRows } from "./layers.js";
14
+ import { binAriaLabel, contourAriaLabel } from "./tooltip.js";
15
+ import { HEXBIN_SHAPE, hexbinMeta, hexbinSettings } from "./settings.js";
16
+ /** An axis's pixel-to-value function for this paint, or `NaN` without one. */ function pixelInverse(viz, axis, offset) {
17
+ const scale = (axis === "x" ? viz._xAxis : viz._yAxis)?._d3Scale;
18
+ return (px)=>scale && scale.invert ? Number(scale.invert(px + offset)) : NaN;
19
+ }
20
+ /** The observations of a shape group, placed in pixels. */ export function pixelPoints(ctx, settings) {
21
+ const rows = ctx.values;
22
+ const { weight } = settings;
23
+ return rows.map((d)=>({
24
+ x: ctx.x(d.x),
25
+ y: ctx.y(d.y),
26
+ row: d.data,
27
+ weight: weight ? Number(weight(d.data, d.i)) : undefined
28
+ }));
29
+ }
30
+ /** The paint a level's contour takes: colored by level, filled with an opacity ramp. */ function contourStyle(viz, settings, fill) {
31
+ const { strokeWidth, fillOpacity } = settings.contourConfig;
32
+ const overBins = Boolean(settings.shape);
33
+ const ramp = (d)=>{
34
+ const meta = hexbinMeta(d);
35
+ return meta && meta.kind === "contour" ? fillOpacity * (meta.index + 1) / meta.levels : fillOpacity;
36
+ };
37
+ if (settings.contours === "filled") return {
38
+ fillOpacity: ramp,
39
+ stroke: fill,
40
+ strokeWidth: 0
41
+ };
42
+ // Lines over bins take the chart's ink, so they show against the bins'
43
+ // colors. The fill stays, invisible, so a region hovers anywhere inside.
44
+ return {
45
+ fillOpacity: 0,
46
+ stroke: overBins ? ()=>backgroundInk(viz) : fill,
47
+ strokeWidth
48
+ };
49
+ }
50
+ /** Draws bin or contour rows as `"Hexbin"` Paths. */ function emitPaths(ctx, rows, style, interactive) {
51
+ if (!rows.length) return [];
52
+ const { viz } = ctx;
53
+ const base = shapeConfigFor(viz, HEXBIN_SHAPE);
54
+ const path = makeShape("Path").renderMode("compute").config(base).config(style(base)).config({
55
+ ariaLabel: (d)=>hexbinMeta(d)?.kind === "contour" ? contourAriaLabel(viz, d) : binAriaLabel(viz, d),
56
+ d: (d)=>hexbinMeta(d)?.path ?? "",
57
+ id: (d)=>d.id,
58
+ label: false,
59
+ x: 0,
60
+ y: 0
61
+ }).data(rows);
62
+ if (interactive) viz._wirePlotShapeEvents(path, HEXBIN_SHAPE, ctx.events);
63
+ return collectComputed(path).map((node)=>({
64
+ ...node,
65
+ shapeType: HEXBIN_SHAPE,
66
+ ...interactive ? {} : {
67
+ interactive: false
68
+ }
69
+ }));
70
+ }
71
+ /** The observations as one inert path of dots beneath the bins and contours. */ function emitPoints(viz, points, settings) {
72
+ const d = pointPath(points, settings.pointConfig.r);
73
+ if (!d) return [];
74
+ return [
75
+ {
76
+ type: "path",
77
+ key: "hexbin-points",
78
+ d,
79
+ interactive: false,
80
+ aria: {
81
+ hidden: true
82
+ },
83
+ paint: {
84
+ fill: settings.pointConfig.fill ?? backgroundInk(viz),
85
+ fillOpacity: settings.pointConfig.fillOpacity
86
+ }
87
+ }
88
+ ];
89
+ }
90
+ /** The trend lines in pixels, for the contour labels to keep clear of. */ function trendPoints(ctx) {
91
+ return (ctx.viz._trendFits ?? []).map((fit)=>fit.samples.map((s)=>[
92
+ ctx.x(s.x),
93
+ ctx.y(s.y)
94
+ ]).filter(([x, y])=>Number.isFinite(x) && Number.isFinite(y)));
95
+ }
96
+ /** Where the bin grid is anchored: the smallest observation, so a pan moves the grid with the data. */ function gridOrigin(ctx, frame) {
97
+ const anchor = hexbinState(ctx.viz).anchor;
98
+ const ox = anchor ? ctx.x(anchor[0]) : NaN;
99
+ const oy = anchor ? ctx.y(anchor[1]) : NaN;
100
+ return [
101
+ Number.isFinite(ox) ? ox : frame.left,
102
+ Number.isFinite(oy) ? oy : frame.top + frame.height
103
+ ];
104
+ }
105
+ /**
106
+ Emits a Hexbin's observations: the raw points (`points`), the bins
107
+ (`binShape`), then the density contours (`contours`) and their level
108
+ labels. Each paint, zoomed
109
+ or not, refits the colorScale to the bins in view (or the contour
110
+ levels), so the fills and the colorScale agree and the densest bin in
111
+ view takes the top color.
112
+ */ export const hexbinEmit = (ctx)=>{
113
+ const { viz } = ctx;
114
+ const settings = hexbinSettings(viz);
115
+ const frame = plotFrame(ctx);
116
+ const points = pixelPoints(ctx, settings);
117
+ const invert = {
118
+ x: pixelInverse(viz, "x", 0),
119
+ y: pixelInverse(viz, "y", ctx.x2Height ?? 0)
120
+ };
121
+ const origin = gridOrigin(ctx, frame);
122
+ const pixelBins = settings.shape ? binPoints(points, {
123
+ shape: settings.shape,
124
+ size: settings.size,
125
+ origin
126
+ }) : [];
127
+ const bins = binRows(pixelBins, settings, invert);
128
+ const contours = settings.contours ? contourRows(points, frame, settings) : [];
129
+ const inView = new Set(binsInView(pixelBins, frame, settings).map((b)=>`bin-${b.key}`));
130
+ refreshColorScale(viz, sharedColorRows(ctx, settings.shape ? bins.filter((r)=>inView.has(String(r.id))) : contours, frame, origin, settings));
131
+ const fillOf = (base)=>{
132
+ const fill = base.fill;
133
+ return (d, i)=>typeof fill === "function" ? fill(d, i) : fill;
134
+ };
135
+ const contourNodes = emitPaths(ctx, contours, (base)=>contourStyle(viz, settings, fillOf(base)), !settings.shape);
136
+ return [
137
+ ...settings.points ? emitPoints(viz, points, settings) : [],
138
+ ...emitPaths(ctx, bins, ()=>({}), true),
139
+ ...contourNodes,
140
+ ...emitContourLabels(viz, contours, contourNodes, frame, settings, trendPoints(ctx))
141
+ ];
142
+ };
@@ -0,0 +1,206 @@
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
+ // Its tooltip title reads each bin's measure, its colorScale value.
74
+ colorScaleTooltip: false,
75
+ ctx: {},
76
+ fields: [
77
+ /**
78
+ The bin shape: `"hex"` (default) for hexagons, `"square"` for
79
+ squares, or `false` to draw no bins (for contours alone).
80
+ @type {"hex" | "square" | false}
81
+ */ {
82
+ key: "binShape",
83
+ default: "hex"
84
+ },
85
+ /**
86
+ The bin size in pixels: a hexagon's radius, or a square's side.
87
+ Bins keep this size at any zoom: the observations are binned again
88
+ for each view, and the colorScale refits to the bins in view.
89
+ Defaults to 12.
90
+ */ {
91
+ key: "binSize",
92
+ default: BIN_SIZE
93
+ },
94
+ /**
95
+ What each bin measures, which its color shows: `"count"` (default),
96
+ the number of observations in the bin; or `{value, agg, label}`,
97
+ the `"sum"` (default) or `"mean"` of `value` (a data key or
98
+ accessor) over the bin's observations, named `label` in the
99
+ tooltip.
100
+ @type {"count" | {value: string | function, agg?: "sum" | "mean", label?: string}}
101
+ */ {
102
+ key: "binValue",
103
+ default: "count"
104
+ },
105
+ /**
106
+ Draws density contours: `"lines"` (or `true`) outlines each density
107
+ level in its color, and `"filled"` fills each level with an opacity
108
+ ramp. Levels are in observations per bin (the count a bin would hold
109
+ there), so contours share the bins' colorScale. Contours over bins
110
+ are drawn in the chart's text color and don't take hover. Defaults to
111
+ `false`.
112
+ @type {boolean | "lines" | "filled"}
113
+ */ {
114
+ key: "contours",
115
+ default: false
116
+ },
117
+ /**
118
+ Contour options: `bandwidth`, the density kernel's standard deviation
119
+ in pixels (default 20); `thresholds`, about how many levels to draw
120
+ (default 8, rounded to nice values) or the levels themselves;
121
+ `strokeWidth`, the outline width of `"lines"` (default 1.5);
122
+ `fillOpacity`, the opacity of the highest `"filled"` level (default
123
+ 0.8); `labels`, which writes each level's value along its contour
124
+ (default `true`); `labelConfig`, TextBox config for those labels
125
+ (`fontSize` defaults to 10); `labelSpacing`, the least distance
126
+ between two labels along a line, in pixels (default `"auto"`); and
127
+ `labelStep`, which labels every n-th level (default `"auto"`: all of
128
+ up to five levels, else every other one).
129
+ @type {{bandwidth?: number, thresholds?: number | number[], strokeWidth?: number, fillOpacity?: number, labels?: boolean, labelConfig?: object, labelSpacing?: number | "auto", labelStep?: number | "auto"}}
130
+ */ {
131
+ key: "contourConfig",
132
+ merge: true,
133
+ default: CONTOUR_DEFAULTS
134
+ },
135
+ /** Formats the contour labels' and tooltips' level values. Defaults to the abbreviated number format (`1.5k`). */ {
136
+ key: "levelFormat"
137
+ },
138
+ /** Draws the raw observations as small dots beneath the bins and contours. Defaults to `false`. */ {
139
+ key: "points",
140
+ default: false
141
+ },
142
+ /**
143
+ The raw observations' style: `r`, the dot radius in pixels (default
144
+ 1.5); `fill` (defaults to the chart's text color); and `fillOpacity`
145
+ (default 0.35).
146
+ @type {{r?: number, fill?: string, fillOpacity?: number}}
147
+ */ {
148
+ key: "pointConfig",
149
+ merge: true,
150
+ default: POINT_DEFAULTS
151
+ },
152
+ {
153
+ key: "colorScale",
154
+ coerce: optionalAccessor,
155
+ default: hexbinValue
156
+ },
157
+ /** A continuous color scale: bins and contours shade smoothly by value. */ {
158
+ key: "colorScaleConfig",
159
+ merge: true,
160
+ default: {
161
+ scale: "linear"
162
+ }
163
+ },
164
+ {
165
+ key: "legend",
166
+ default: false,
167
+ coerce: "const"
168
+ },
169
+ {
170
+ key: "shape",
171
+ default: constant(HEXBIN_SHAPE),
172
+ coerce: "const"
173
+ },
174
+ /**
175
+ Bins are outlined in the chart's background color, so neighbors stay
176
+ distinct.
177
+ */ {
178
+ key: "shapeConfig",
179
+ merge: true,
180
+ factory: (viz)=>({
181
+ [HEXBIN_SHAPE]: {
182
+ stroke: ()=>chartBackground(viz),
183
+ strokeWidth: constant(0.5)
184
+ }
185
+ })
186
+ },
187
+ {
188
+ key: "tooltipConfig",
189
+ merge: true,
190
+ factory: (viz)=>({
191
+ title: (d)=>hexbinTooltipTitle(viz, d),
192
+ tbody: (d)=>hexbinTooltipRows(viz, d)
193
+ })
194
+ }
195
+ ]
196
+ };
197
+ /**
198
+ Creates a 2D binned density chart from raw observations: each row is a
199
+ point at its `x` and `y` values (rows without numeric values are
200
+ skipped), and the points are grouped into hexagons (`binShape`) of
201
+ `binSize` pixels, colored on the colorScale by how many each holds (or by
202
+ `binValue`). Empty bins aren't drawn. `contours` adds density contours,
203
+ and `points` draws the observations beneath. `groupBy` names the
204
+ observations for `filter` and the legend (off by default), and `facet`
205
+ bins each panel on its own, on one shared colorScale.
206
+ */ export default makeChart(hexbinDef, Plot);