@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
@@ -15,3 +15,11 @@ export declare const roundingScales: string[];
15
15
  scale's domain rounds as a linear one does.
16
16
  */
17
17
  export declare function roundedDomain(initialDomain: number[], rounding: string, scale: string): number[] | undefined;
18
+ /**
19
+ The open end of an axis rounded "inside" that the value `d` labels, if
20
+ any: "min" when `d` is the lowest of the `values` the axis labels and
21
+ the `domain` reaches down to it, "max" when it is the highest and the
22
+ domain reaches up to it. A value beyond the domain has nothing past it,
23
+ so it is not open-ended.
24
+ */
25
+ export declare function openEnd(d: unknown, values: unknown[], domain: unknown[]): "min" | "max" | undefined;
@@ -0,0 +1,30 @@
1
+ /**
2
+ The axis title, configured once for both the measure and the paint, so
3
+ the title claims exactly the room it draws.
4
+ */
5
+ import type { DataPoint } from "@d3plus/data";
6
+ import TextBox from "../TextBox.js";
7
+ import type Axis from "./Axis.js";
8
+ /**
9
+ Whether the first word of `box`'s text is wider than its line on its
10
+ own, as the wrap measures it. The wrap can't place such a word on any
11
+ line, so the box would draw nothing.
12
+ */
13
+ export declare function firstWordOverflows(box: TextBox, d: DataPoint, i: number): boolean;
14
+ /**
15
+ Configures `box` as the axis title wrapped across `range`, in a box
16
+ `height` tall: its text, width, rotation, and `titleConfig`. A first
17
+ word too wide for the axis is cut mid-word with the ellipsis
18
+ (`truncateWord`), so the title still draws; any other title cut short
19
+ ends at a word break. A `truncateWord` in `titleConfig` overrides both.
20
+ A title left out (see `measureAxis` in `axisLimit.ts`) has no data, so
21
+ draws nothing.
22
+ */
23
+ export declare function configureTitle(box: TextBox, axis: Axis, range: number[], height: number): TextBox;
24
+ /**
25
+ The room the axis title claims on the axis's side: its lines as the
26
+ title TextBox wraps them across `range`, within `height`, to the whole
27
+ pixel, plus the axis's padding. A title that draws nothing claims no
28
+ room.
29
+ */
30
+ export declare function titleRoom(axis: Axis, range: number[], height: number): number;
@@ -0,0 +1,82 @@
1
+ /**
2
+ What an axis's title and tick labels carry for a chart's axis tooltips
3
+ (see `charts/features/axisTooltip.ts`): each label's scene nodes are
4
+ stamped with the label's value, its whole text, whether it is drawn cut
5
+ short, and the axis's `titleTooltip` or `tickTooltip`. A label no tooltip
6
+ could show for is left unstamped.
7
+ */
8
+ import type { SceneNode } from "@d3plus/render";
9
+ /** The label a pointer can show an axis tooltip for. */
10
+ export interface AxisTooltipTarget {
11
+ /** Which part of the axis the label is. */
12
+ part: "title" | "tick";
13
+ /** The tick's value, or the title. */
14
+ value: unknown;
15
+ /** The tick's index among the axis's labels, from the start of its domain (0 for a title). */
16
+ index: number;
17
+ /** The label's whole text. */
18
+ text: string;
19
+ /** Whether the label is drawn cut short. */
20
+ truncated: boolean;
21
+ /** The axis's `titleTooltip` or `tickTooltip`. */
22
+ option: unknown;
23
+ }
24
+ /**
25
+ The axis label a scene node was stamped as, if any.
26
+ @param node A picked scene node.
27
+ */
28
+ export declare function axisTooltipTarget(node: SceneNode | null | undefined): AxisTooltipTarget | undefined;
29
+ /**
30
+ Whether a text node draws less than `text`: its layout cut it short (see
31
+ `TextNode.truncated`) and its lines don't spell the whole text.
32
+ @param node A label's scene node.
33
+ @param text The label's whole text.
34
+ */
35
+ export declare function labelCut(node: SceneNode, text: string): boolean;
36
+ /**
37
+ Whether a label with `option` for its tooltip option could show one.
38
+ @param option An axis's `titleTooltip` or `tickTooltip`.
39
+ @param truncated Whether the label is drawn cut short.
40
+ */
41
+ export declare const canShow: (option: unknown, truncated: boolean) => boolean;
42
+ /** What `tickRank` reads of an axis. */
43
+ export interface RankedAxis {
44
+ schema: {
45
+ scale?: unknown;
46
+ };
47
+ _domainEndFirst?: boolean;
48
+ _givenDomain(): unknown[];
49
+ }
50
+ /**
51
+ Where a tick's value falls along an axis's domain, counted from the
52
+ domain's start: the lowest value of a value or time axis, the first
53
+ category of a categorical one (its last when the axis holds its domain
54
+ end first). Neither `reverse` nor a descending domain moves a value's
55
+ place.
56
+ @param axis A laid-out axis.
57
+ */
58
+ export declare function tickRank(axis: RankedAxis): (value: unknown) => number;
59
+ /**
60
+ Stamps an axis's tick label nodes (each label's text, and its hitbox when
61
+ it has one) with their tooltip target.
62
+ @param nodes The tick labels' scene nodes.
63
+ @param option The axis's `tickTooltip`.
64
+ @param rank Each tick value's place along the axis (see `tickRank`):
65
+ labels are indexed in that order, or in the order of `nodes` without it.
66
+ */
67
+ export declare function stampTickTooltips(nodes: SceneNode[], option: unknown, rank?: (value: unknown) => number): void;
68
+ /**
69
+ Stamps an axis's title nodes with their tooltip target.
70
+ @param nodes The title's scene nodes.
71
+ @param title The axis's title.
72
+ @param option The axis's `titleTooltip`.
73
+ */
74
+ export declare function stampTitleTooltip(nodes: SceneNode[], title: unknown, option: unknown): void;
75
+ /**
76
+ An axis's scene as chrome under a chart's marks: every node takes the
77
+ "axis" interaction group, and each one that draws leaves hit-testing
78
+ unless it is stamped with a tooltip target, so the pointer reaches the
79
+ axis only on a label with a tooltip to show.
80
+ @param node An axis's scene, or a node in it.
81
+ */
82
+ export declare function inertAxis(node: SceneNode): SceneNode;
@@ -0,0 +1,51 @@
1
+ import type { D3Scale } from "../../utils/index.js";
2
+ import { type RangeBreakRule, type TimeGap } from "./rangeBreaks.js";
3
+ /** Options for `brokenTimeScale`. */
4
+ export interface BrokenTimeScaleOptions {
5
+ /** Read the rules' calendar in UTC instead of local time. */
6
+ utc?: boolean;
7
+ /** Pixels each marked gap inside the domain occupies (default 0). */
8
+ space?: number;
9
+ }
10
+ /** A hidden stretch inside the scale's domain, with the pixels it occupies. */
11
+ export interface ScaleTimeGap extends TimeGap {
12
+ /** Pixels the gap occupies: `space` for a marked gap, else 0. */
13
+ space: number;
14
+ }
15
+ /** A continuous time scale whose mapping skips hidden time. */
16
+ export interface BrokenTimeScale extends D3Scale {
17
+ /** The rules the scale hides time by. */
18
+ rangeBreaks: RangeBreakRule[];
19
+ /** The hidden stretches inside the domain, clipped to it, ascending. */
20
+ gaps(): ScaleTimeGap[];
21
+ /** Whether a time is hidden. */
22
+ isHidden(t: number | Date): boolean;
23
+ /** The visible time (ms) between two times, signed like `b - a`. */
24
+ visible(a: number | Date, b: number | Date): number;
25
+ /** The time `ms` of visible time after (or, when negative, before) `t`. */
26
+ offset(t: number | Date, ms: number): Date;
27
+ /** A d3 time tick format for the scale's domain. */
28
+ tickFormat(count?: number, specifier?: string): (d: Date) => string;
29
+ }
30
+ /** Whether `scale` is a broken time scale. */
31
+ export declare const isBrokenTimeScale: (scale: unknown) => scale is BrokenTimeScale;
32
+ /**
33
+ The time between `a` and `b` on `scale` (`b - a`, in ms): on a broken
34
+ time scale, only the time it shows.
35
+ */
36
+ export declare const scaleTimeStep: (scale: unknown, a: number | Date, b: number | Date) => number;
37
+ /**
38
+ The time `ms` after `t` (before it, when negative) on `scale`: on a
39
+ broken time scale, stepping over the time it hides.
40
+ */
41
+ export declare const scaleTimeShift: (scale: unknown, t: number | Date, ms: number) => Date;
42
+ /**
43
+ Builds a time scale that hides the time `rules` describe. It reads like
44
+ d3's `scaleTime` — `domain`, `range`, `ticks`, `tickFormat`, `invert`,
45
+ and `copy` — but visible time shares one pixel rate and hidden time
46
+ takes none (or a marked gap's `space`). A hidden time maps to where its
47
+ gap sits; a pixel at a closed gap inverts to the time after it. Times
48
+ past the domain extrapolate through the rules' gaps, so a scale can be
49
+ padded or zoomed out.
50
+ */
51
+ export declare function brokenTimeScale(rules: RangeBreakRule[], options?: BrokenTimeScaleOptions): BrokenTimeScale;
@@ -0,0 +1,82 @@
1
+ /** A time value a rule reads: a Date, a timestamp, or a date string. */
2
+ export type RangeBreakTime = Date | number | string;
3
+ /**
4
+ One stretch of time a time axis hides:
5
+
6
+ - `"weekends"`: every Saturday and Sunday.
7
+ - `{days: [6, 0]}`: every day of the week listed (0 is Sunday, 6 is Saturday).
8
+ - `{hours: [17, 9]}`: the same hours of every day, from the first hour to
9
+ the second (fractions are minutes, so `9.5` is 9:30); a start after the
10
+ end wraps past midnight, so `[17, 9]` hides 5pm to 9am.
11
+ - `{values: [date, …]}`: each listed date's whole day, such as holidays.
12
+ - `{bounds: [start, end]}`: one explicit range, from `start` up to `end`.
13
+
14
+ An object rule's `marker` draws the axis's break marker where its time
15
+ was removed, leaving a short gap there. It defaults to `true` for
16
+ `bounds` and `false` for the others, which recur too often to mark.
17
+ */
18
+ export type RangeBreakRule = "weekends" | {
19
+ days: number[];
20
+ marker?: boolean;
21
+ } | {
22
+ hours: [number, number];
23
+ marker?: boolean;
24
+ } | {
25
+ values: RangeBreakTime[];
26
+ marker?: boolean;
27
+ } | {
28
+ bounds: [RangeBreakTime, RangeBreakTime];
29
+ marker?: boolean;
30
+ };
31
+ /** A hidden stretch of time, from `start` (hidden) up to `end` (shown), in ms. */
32
+ export interface TimeGap {
33
+ start: number;
34
+ end: number;
35
+ /** Whether the gap draws a break marker. */
36
+ marker: boolean;
37
+ }
38
+ /** A rule value read as a timestamp, or `NaN` when it doesn't parse. */
39
+ export declare function rangeBreakTime(value: unknown): number;
40
+ /** Whether `rule` is a rule a time axis can read. */
41
+ export declare function isRangeBreakRule(rule: unknown): rule is RangeBreakRule;
42
+ /**
43
+ Reads a `rangeBreaks` setting — one rule, a list of them, or a falsy
44
+ value — into the list of rules a time axis can use, dropping any it
45
+ can't read.
46
+ */
47
+ export declare function normalizeRangeBreaks(input: unknown): RangeBreakRule[];
48
+ /** Whether a rule draws a break marker (see `RangeBreakRule`). */
49
+ export declare const ruleMarker: (rule: RangeBreakRule) => boolean;
50
+ /**
51
+ The stretches of time `rules` hide that overlap `[lo, hi]`: sorted,
52
+ with overlapping and touching gaps merged (a merged gap draws a marker
53
+ when any of its rules does). Gaps are not clipped to `[lo, hi]`.
54
+ @param utc Read the calendar in UTC instead of local time.
55
+ */
56
+ export declare function rangeBreakGaps(rules: RangeBreakRule[], lo: number, hi: number, utc?: boolean): TimeGap[];
57
+ /** The last gap starting at or before `t` (gaps sorted by start), or -1. */
58
+ export declare function gapIndex(gaps: TimeGap[], t: number): number;
59
+ /**
60
+ A test for whether a time between `lo` and `hi` is hidden by `rules`:
61
+ the gaps are found once, so the test is cheap to run over many values.
62
+ A time outside `[lo, hi]` is tested on its own.
63
+ */
64
+ export declare function rangeBreakTest(rules: RangeBreakRule[], lo: number, hi: number, utc?: boolean): (t: number | Date) => boolean;
65
+ /** Whether `rules` hide the time `t`. */
66
+ export declare function isHiddenTime(rules: RangeBreakRule[], t: number | Date, utc?: boolean): boolean;
67
+ /**
68
+ The visible time between `a` and `b` (in ms, `a <= b`): their distance
69
+ less every hidden stretch between them.
70
+ */
71
+ export declare function visibleBetween(rules: RangeBreakRule[], a: number, b: number, utc?: boolean): number;
72
+ /**
73
+ Whether `rules` hide all of time: a week (plus a day for DST) with no
74
+ visible moment, which repeating rules then repeat forever.
75
+ */
76
+ export declare function hidesAllTime(rules: RangeBreakRule[], utc?: boolean): boolean;
77
+ /**
78
+ The time `ms` of visible time after `t` (or before it, when `ms` is
79
+ negative), stepping over every hidden stretch on the way. Rules that
80
+ hide all of time leave `t` where it is.
81
+ */
82
+ export declare function offsetVisible(rules: RangeBreakRule[], t: number, ms: number, utc?: boolean): number;
@@ -33,7 +33,7 @@ export declare function axisTimeDomain(axis: Axis): Date[];
33
33
  */
34
34
  export declare function axisTimeLocale(axis: Axis): TimeLocaleDefinition;
35
35
  /**
36
- The ordered Dates a time axis picks its label interval from: its parsed `data`, else its domain.
36
+ The ordered Dates a time axis picks its label interval from: its parsed `data`, else the labels its scale offers (when two or more), else its domain.
37
37
  @private
38
38
  */
39
39
  export declare function axisTimeReference(axis: Axis): Date[];
@@ -1,6 +1,6 @@
1
1
  import type { D3Selection } from "@d3plus/dom";
2
2
  import type { DataPoint } from "@d3plus/data";
3
- import type { GroupNode } from "@d3plus/render";
3
+ import type { GroupNode, SceneNode } from "@d3plus/render";
4
4
  import type { SvgRenderer } from "@d3plus/render";
5
5
  import { Axis, TextBox } from "../index.js";
6
6
  import { Rect } from "../../shapes/index.js";
@@ -8,11 +8,13 @@ import { BaseClass } from "../../utils/index.js";
8
8
  import type { D3Scale } from "../../utils/index.js";
9
9
  import Legend from "../Legend/Legend.js";
10
10
  import type { ColorScaleType } from "./colorScaleType.js";
11
+ import type { SwatchBucket } from "./colorScaleSwatchTooltips.js";
11
12
  import type { ColorScaleBarGeometry } from "./colorScaleHoverMark.js";
12
13
  /**
13
14
  Creates an SVG color scale based on an array of data.
14
15
  */
15
16
  export default class ColorScale extends BaseClass {
17
+ static readonly _displayName: string;
16
18
  [key: string]: any;
17
19
  _select: D3Selection;
18
20
  _axisClass: Axis;
@@ -30,8 +32,14 @@ export default class ColorScale extends BaseClass {
30
32
  _scaleType: ColorScaleType;
31
33
  /** Where the color bar sits, set when the bar variant renders (see colorScaleHoverMark). */
32
34
  _barGeometry?: ColorScaleBarGeometry;
33
- /** The value marked on the scale, set with `hover()`. */
34
- _hoverValue?: number | false;
35
+ /** The value marked on the scale, set with `hover()`: a pair of values on a bivariate scale. */
36
+ _hoverValue?: number | [number, number] | false;
37
+ /** The names a chart gives a bivariate scale's two variables (its field names), under `bivariateLabels`. */
38
+ _bivariateFields?: string[];
39
+ /** The bivariate key's nodes, laid out by the last render. */
40
+ _bivariateNodes?: SceneNode[];
41
+ /** Each swatch's legend row, with its bucket, set when the swatch variant renders. */
42
+ _swatchBuckets: Map<unknown, SwatchBucket>;
35
43
  /** Smooth-gradient fill token (`gradient:<json>`), set by renderGradientStops. */
36
44
  _gradientFill?: string;
37
45
  _sceneRenderer?: SvgRenderer;
@@ -48,10 +56,13 @@ export default class ColorScale extends BaseClass {
48
56
  /**
49
57
  Produces a backend-agnostic scene graph for this ColorScale with no DOM
50
58
  dependency. The discrete variant (jenks/buckets/quantile) delegates to the
51
- internal Legend's toScene(); the gradient variant composes the Rect, Axis,
52
- and label TextBox scenes. The scaleGroup's translate (set by the chart's
53
- colorScale feature on `g.d3plus-viz-colorScale`) is read off `_select` so
54
- the content lands at its on-screen position.
59
+ internal Legend's toScene(), its title and swatch labels taking the axis
60
+ tooltips (see `swatchTooltips`); the gradient variant composes the Rect,
61
+ Axis, and label TextBox scenes, all as chrome (see `inertAxis`): only an
62
+ axis label with a tooltip takes the pointer. The scaleGroup's
63
+ translate (set by the chart's colorScale feature on
64
+ `g.d3plus-viz-colorScale`) is read off `_select` so the content lands at
65
+ its on-screen position.
55
66
 
56
67
  A smooth (non-bucketed) gradient paints its Rect with a `gradient:<json>`
57
68
  fill token (see renderGradientStops); the backend materializes it into a
@@ -60,7 +71,7 @@ export default class ColorScale extends BaseClass {
60
71
  */
61
72
  toScene(): GroupNode;
62
73
  /**
63
- The ColorScale is constructed by combining an Axis for the ticks/labels and a Rect for the actual color box (or multiple boxes, as in a jenks scale). Because of this, there are separate configs for the Axis class used to display the text (axisConfig) and the Rect class used to draw the color breaks (rectConfig). This method acts as a pass-through to the config method of the Axis.
74
+ The ColorScale is constructed by combining an Axis for the ticks/labels and a Rect for the actual color box (or multiple boxes, as in a jenks scale). Because of this, there are separate configs for the Axis class used to display the text (axisConfig) and the Rect class used to draw the color breaks (rectConfig). This method acts as a pass-through to the config method of the Axis. A scale drawn as swatches has no Axis: its `title` and `titleTooltip` apply to the swatches' title, and its `tickTooltip` to each swatch's label, given the value and index of the label at that bucket's start on a `bucketAxis` bar.
64
75
  */
65
76
  axisConfig(): Record<string, unknown>;
66
77
  axisConfig(_: Record<string, unknown>): this;
@@ -70,10 +81,10 @@ export default class ColorScale extends BaseClass {
70
81
  data(): DataPoint[];
71
82
  data(_: DataPoint[]): this;
72
83
  /**
73
- Marks a value on the scale: an extra axis tick where the value falls on the color bar and a badge reading it where that tick's label would sit, plus an outline around its bucket on a bucketed bar (`bucketAxis`). A scale drawn as discrete swatches draws no mark. A chart sets this while one of its shapes is hovered. Pass `false` to clear it. Turned off with `hoverMark(false)`.
84
+ Marks a value on the scale: an extra axis tick where the value falls on the color bar and a badge reading it where that tick's label would sit, plus an outline around its bucket on a bucketed bar (`bucketAxis`). A scale drawn as discrete swatches draws no mark, and a bivariate scale takes a pair of values. A chart sets this while one of its shapes is hovered. Pass `false` to clear it. Turned off with `hoverMark(false)`.
74
85
  */
75
- hover(): number | false | undefined;
76
- hover(_: number | false): this;
86
+ hover(): number | [number, number] | false | undefined;
87
+ hover(_: number | [number, number] | false): this;
77
88
  /**
78
89
  A pass-through for the TextBox class used to style the labelMin and labelMax text.
79
90
  */
@@ -0,0 +1,53 @@
1
+ import type { SceneNode } from "@d3plus/render";
2
+ import type { DataPoint } from "@d3plus/data";
3
+ import type ColorScale from "./ColorScale.js";
4
+ import type { BivariateScale } from "./bivariateScale.js";
5
+ /** A bivariate key cell's datum: a colorScale bucket that is one cell of the grid. */
6
+ export interface BivariateCell extends DataPoint {
7
+ color: string;
8
+ id: string;
9
+ _isColorScaleBucket: true;
10
+ /** The cell's column: the first variable's bin. */
11
+ _bivariateX: number;
12
+ /** The cell's row: the second variable's bin. */
13
+ _bivariateY: number;
14
+ }
15
+ /** Where a laid-out bivariate key draws, in its own space. */
16
+ export interface BivariateLayout {
17
+ nodes: SceneNode[];
18
+ bounds: {
19
+ x: number;
20
+ y: number;
21
+ width: number;
22
+ height: number;
23
+ };
24
+ }
25
+ /**
26
+ The names the key gives its two variables: `bivariateLabels`, else the
27
+ names the chart passes (its field names).
28
+ @param cs The ColorScale.
29
+ */
30
+ export declare function bivariateAxisLabels(cs: ColorScale): [string, string];
31
+ /**
32
+ How a ColorScale's values read in a bivariate key's ranges and in a
33
+ chart's tooltip: `axisConfig.tickFormat`, else a variable whose values
34
+ all read as years as years, else abbreviated (`formatAbbreviate`).
35
+ @param cs The ColorScale.
36
+ @param values The variable's values.
37
+ */
38
+ export declare function colorScaleValueFormat(cs: ColorScale, values: number[]): (v: number) => string;
39
+ /**
40
+ Lays the key out within the ColorScale's `width` × `height`: its grid
41
+ shrinks from its full size to fit, and it sits along the side its labels
42
+ face (`orient`) at its `align`ment, as the swatch legend does.
43
+ @param cs The ColorScale.
44
+ @param scale Its bivariate scale.
45
+ */
46
+ export declare function layoutBivariate(cs: ColorScale, scale: BivariateScale): BivariateLayout;
47
+ /**
48
+ Builds a bivariate ColorScale's scale from its data (each row's `value`
49
+ a pair of numbers), assigns it as the ColorScale's `_colorScale`, and
50
+ lays out its diamond key.
51
+ @param cs The ColorScale.
52
+ */
53
+ export declare function renderBivariate(cs: ColorScale): BivariateLayout;
@@ -0,0 +1,92 @@
1
+ /**
2
+ Joshua Stevens' blue–red 3×3 scheme, from "Bivariate Choropleth Maps: A
3
+ How-to Guide" (joshuastevens.net/cartography/make-a-bivariate-choropleth-map/),
4
+ with the hex values as published in the R `pals` package
5
+ (`stevens.bluered`). Row-major from the low/low corner: each row is one
6
+ bin of the second variable (low to high), each column one bin of the
7
+ first (low to high). The first variable rises toward red (#c85a5a), the
8
+ second toward blue (#64acbe), and both together toward #574249. Each
9
+ inner color is the two ramps multiplied over the shared #e8e8e8 base.
10
+ */
11
+ export declare const BIVARIATE_COLORS: readonly string[];
12
+ /** The fewest and most bins a bivariate ColorScale splits each variable into. */
13
+ export declare const BIVARIATE_MIN_BUCKETS = 2;
14
+ export declare const BIVARIATE_MAX_BUCKETS = 4;
15
+ /** The bins per variable when none is set. */
16
+ export declare const BIVARIATE_BUCKETS = 3;
17
+ /**
18
+ The number of bins per variable: `value` rounded and held within 2–4, or
19
+ 3 when it isn't a number.
20
+ @param value The configured bin count.
21
+ */
22
+ export declare function bivariateBucketCount(value: unknown): number;
23
+ /**
24
+ Resamples a square grid of colors (row-major, `k×k`) to `n×n`: a grid
25
+ already `n×n` is returned as given, and any other is blended
26
+ bilinearly between its nearest colors, so its corners stay put. A 3×3
27
+ scheme resampled to 4×4 keeps its corners and blends its middle colors
28
+ across the new cells; one resampled to 2×2 keeps only its corners.
29
+ @param grid The colors, row-major.
30
+ @param n The side of the grid to return.
31
+ */
32
+ export declare function resampleGrid(grid: readonly string[], n: number): string[];
33
+ /**
34
+ The `n×n` colors a bivariate ColorScale paints with (row-major, as
35
+ `BIVARIATE_COLORS`): `colors` when it is a square grid of at least 2×2
36
+ color strings, resampled to `n×n` (see `resampleGrid`), else Stevens'
37
+ 3×3 scheme resampled the same way.
38
+ @param colors The configured grid.
39
+ @param n The bins per variable.
40
+ */
41
+ export declare function bivariatePalette(colors: unknown, n: number): string[];
42
+ /** One variable's bins, as `bivariateBins` returns them. */
43
+ export interface BivariateBins {
44
+ /** The bin (0 to `n - 1`) a value falls in. */
45
+ bin: (value: number) => number;
46
+ /** Each bin's lowest and highest value in the data, or null for a bin holding none. */
47
+ ranges: ([number, number] | null)[];
48
+ }
49
+ /**
50
+ Splits one variable's values into `n` quantile bins by rank: a value's
51
+ bin is its share of the values ranked below it (ties counted at their
52
+ middle rank), so each bin holds about as many values as the next, and
53
+ equal values always share a bin. A value outside the data ranks by
54
+ where it would sort.
55
+ @param values The variable's values (non-finite ones are ignored).
56
+ @param n The number of bins.
57
+ */
58
+ export declare function bivariateBins(values: number[], n: number): BivariateBins;
59
+ /** A value pair a bivariate ColorScale can place: two finite numbers. */
60
+ export type BivariatePair = [number, number];
61
+ /** Whether `value` is a pair of finite numbers. */
62
+ export declare function isBivariatePair(value: unknown): value is BivariatePair;
63
+ /**
64
+ A bivariate color scale: called with a value pair, it returns the color
65
+ of the cell the pair's bins pick (undefined for anything else).
66
+ */
67
+ export interface BivariateScale {
68
+ (value: unknown): string | undefined;
69
+ /** The cell `[column, row]` a pair falls in: its first variable's bin, then its second's. */
70
+ cell(value: unknown): [number, number] | null;
71
+ /** The bins per variable. */
72
+ size: number;
73
+ /** The first variable's bins. */
74
+ x: BivariateBins;
75
+ /** The second variable's bins. */
76
+ y: BivariateBins;
77
+ /** The `n×n` colors, row-major (see `BIVARIATE_COLORS`). */
78
+ colors: string[];
79
+ /** Every value pair the scale was built from. */
80
+ domain(): BivariatePair[];
81
+ /** The colors, as a d3 scale's `range`. */
82
+ range(): string[];
83
+ }
84
+ /**
85
+ Builds a bivariate color scale from the value pairs in the data: each
86
+ variable binned into `n` quantiles (see `bivariateBins`), colored from
87
+ `colors`, an `n×n` grid (see `bivariatePalette`).
88
+ @param pairs The data's value pairs.
89
+ @param n The bins per variable.
90
+ @param colors The `n×n` colors, row-major.
91
+ */
92
+ export declare function bivariateScale(pairs: BivariatePair[], n: number, colors: string[]): BivariateScale;
@@ -3,10 +3,24 @@
3
3
  significant digits so float noise (`0.1 + 0.2`) doesn't count.
4
4
  */
5
5
  export declare function decimalPlaces(value: number): number;
6
+ /** The number of significant digits `value` is written with, at 15 digits. */
7
+ export declare function significantDigits(value: number): number;
8
+ /**
9
+ The decimal places bucket labels step at: the most any value is written
10
+ with. A computed value (a mean such as `1 / 3`) carries float precision
11
+ no label should step at, so its own places count only to the data's
12
+ display precision: three significant digits of the values' span. A value
13
+ within float noise of zero (`-1.4e-14`) counts as zero.
14
+ */
15
+ export declare function labelPlaces(allValues: number[]): number;
16
+ /** `value` rounded to the places bucket labels step at (see `labelPlaces`). */
17
+ export declare function labelValue(value: number, allValues: number[]): number;
6
18
  /**
7
19
  The `[lower, upper]` values a ColorScale label shows for the bucket
8
20
  `[ticks[i], ticks[i + 1])`: the first and last values the data's own
9
- precision can write inside it, so integer data reads "1 - 2", "3 - 4".
21
+ precision (see `labelPlaces`) can write inside it, so integer data reads
22
+ "1 - 2", "3 - 4", and computed values such as means don't step at float
23
+ precision (a bucket ending at 0 reads "-9.5 - -0.1", not "-9.5 - -1f").
10
24
  When `format` prints the upper bound the same as the next bucket's lower
11
25
  one (an abbreviation like "1.5k"), the upper bound drops a decimal place
12
26
  at a time until it reads differently ("1.49k").
@@ -0,0 +1,48 @@
1
+ /**
2
+ The axis tooltips of a color scale drawn as swatches: the legend's title
3
+ takes the scale's `axisConfig.titleTooltip`, and each swatch label its
4
+ `axisConfig.tickTooltip`, given the same value and index as the label at
5
+ that bucket's start on a `bucketAxis` bar. A label drawn cut short shows
6
+ its whole text. The swatches keep their bucket's tooltip and highlight,
7
+ and a label showing its tooltip lights its bucket too (see
8
+ `handleSwatchLabelHover`).
9
+ */
10
+ import type { SceneNode } from "@d3plus/render";
11
+ /** The bucket a swatch stands for. */
12
+ export interface SwatchBucket {
13
+ /** The tick the bucket starts at. */
14
+ value: number;
15
+ /** The bucket's place from the lowest. */
16
+ index: number;
17
+ }
18
+ /** What a swatch-drawn scale's labels take their tooltips from. */
19
+ export interface SwatchTooltipOptions {
20
+ /** The legend's title. */
21
+ title: unknown;
22
+ /** The datum the legend's title nodes carry. */
23
+ titleDatum: unknown;
24
+ /** The scale's `axisConfig.titleTooltip`. */
25
+ titleTooltip: unknown;
26
+ /** The scale's `axisConfig.tickTooltip`. */
27
+ tickTooltip: unknown;
28
+ /** Each swatch's legend row, with its bucket. */
29
+ buckets: Map<unknown, SwatchBucket>;
30
+ }
31
+ /**
32
+ Stamps swatch label nodes with their tooltip target: the bucket's tick for
33
+ the value, its place from the lowest for the index, and the label's whole
34
+ text. A label no tooltip could show for is left unstamped.
35
+ @param nodes The swatch labels' text nodes.
36
+ @param option The scale's `axisConfig.tickTooltip`.
37
+ @param buckets Each swatch's legend row, with its bucket.
38
+ */
39
+ export declare function stampSwatchLabels(nodes: SceneNode[], option: unknown, buckets: Map<unknown, SwatchBucket>): void;
40
+ /**
41
+ A swatch-drawn scale's legend scene with its axis tooltips: the title is
42
+ chrome (see `inertAxis`) that takes the pointer only to show its tooltip,
43
+ a swatch label with a tooltip to show takes the pointer as axis chrome,
44
+ and every other node is left as the legend drew it.
45
+ @param scene The legend's scene.
46
+ @param options What the labels take their tooltips from.
47
+ */
48
+ export declare function swatchTooltips(scene: SceneNode, options: SwatchTooltipOptions): SceneNode;
@@ -8,6 +8,7 @@ import { BaseClass } from "../../utils/index.js";
8
8
  Creates an SVG legend based on an array of data.
9
9
  */
10
10
  export default class Legend extends BaseClass {
11
+ static readonly _displayName: string;
11
12
  [key: string]: any;
12
13
  _titleClass: TextBox;
13
14
  _data: DataPoint[];
@@ -22,6 +23,11 @@ export default class Legend extends BaseClass {
22
23
  _titleHeight: number;
23
24
  _titleWidth: number;
24
25
  _wrapLines: (() => void) | undefined;
26
+ /**
27
+ Whether labels that don't fit whole are cut short with "..." rather
28
+ than left out, as a ColorScale's swatches are (see `legendCut.ts`).
29
+ */
30
+ _cutLabels: boolean;
25
31
  _wrapRows: (() => void) | undefined;
26
32
  _sceneRenderer?: SvgRenderer;
27
33
  /**
@@ -0,0 +1,31 @@
1
+ import type Legend from "./Legend.js";
2
+ /** The room each label has in one layout of the swatches. */
3
+ interface Room {
4
+ width: number;
5
+ height: number;
6
+ }
7
+ /**
8
+ The room each label of `legend` has with its swatches in `rows` rows of
9
+ as many each as fit (`rows` 1 to the count of swatches), or in one
10
+ column.
11
+ */
12
+ export declare function labelRoom(legend: Legend, availableWidth: number, availableHeight: number, rows?: number): Room;
13
+ /**
14
+ The lines the TextBox of the label `d` paints in the room it was given:
15
+ wrapped with the line height and ellipsis of the legend's labels (a
16
+ TextBox's own by default), as `renderLegendShapes` draws it.
17
+ */
18
+ export declare function paintedLines(legend: Legend, d: Record<string, unknown>): string[];
19
+ /**
20
+ Gives each label of `legend` the room it has in the layout of its
21
+ swatches that shows the most of its labels, its whole text when that
22
+ fits there and else as many lines as fit, marking it `cut`, with the
23
+ lines it paints there. In a row, the swatches try each count of rows
24
+ within the height, keeping the layout that cuts the fewest labels short,
25
+ then shows the most of their text, then is the shortest. In a column,
26
+ they keep to one column, which reads in order from top to bottom.
27
+ Returns false, changing nothing, when no layout can hold a line of a
28
+ few letters.
29
+ */
30
+ export declare function cutLegendLabels(legend: Legend, availableWidth: number, availableHeight: number): boolean;
31
+ export {};
@@ -1,5 +1,10 @@
1
1
  import type Legend from "./Legend.js";
2
- /** Wraps + measures the title, setting `_titleHeight` / `_titleWidth`. */
2
+ /**
3
+ Wraps + measures the title, setting `_titleHeight` / `_titleWidth`: it
4
+ wraps within the width the title is drawn in, the legend's less its
5
+ padding on both sides, and is left out (both zero) when it doesn't fit
6
+ there whole.
7
+ */
3
8
  export declare function measureLegendTitle(legend: Legend): void;
4
9
  /** Measures each datum's swatch + wrapped label into the `_lineData` array. */
5
10
  export declare function computeLegendLineData(legend: Legend, availableHeight: number): Record<string, unknown>[];
@@ -41,6 +41,7 @@ new SizeLegend()
41
41
  .render();
42
42
  */
43
43
  export default class SizeLegend extends BaseClass {
44
+ static readonly _displayName: string;
44
45
  [key: string]: any;
45
46
  _layout: SizeLegendLayout;
46
47
  /** Drops values whose circles would outgrow this radius; set by a zoomed chart. */