@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,40 @@
1
+ /**
2
+ The scene of a callout annotation: per row, a connector from the box to
3
+ the anchor, an arrowhead or dot at the anchor, the box, and its wrapped
4
+ text, all inert.
5
+ */
6
+ import type { SceneNode } from "@d3plus/render";
7
+ import type { VizInstance } from "../viz/vizTypes.js";
8
+ import { type AnnotationFrame } from "./annotationFrame.js";
9
+ import type { Annotation } from "./annotationTypes.js";
10
+ type Row = Record<string, unknown>;
11
+ /**
12
+ Reads one style key for a callout row: an accessor on the annotation
13
+ called with the row, else the row's own value, else the annotation's.
14
+ @param annotation The callout annotation.
15
+ @param d The row.
16
+ @param i The row's index.
17
+ */
18
+ export declare function calloutPicker(annotation: Annotation, d: Row, i: number): (key: string) => unknown;
19
+ /**
20
+ The scene nodes of one callout row, or nothing when it has no label or
21
+ its anchor lies outside the plot area (a zoom that pans it out of view).
22
+ @param viz The chart.
23
+ @param annotation The callout annotation.
24
+ @param frame The plot area and its axes.
25
+ @param row The row, its index, and its key.
26
+ */
27
+ export declare function calloutRowNodes(viz: VizInstance, annotation: Annotation, frame: AnnotationFrame, row: {
28
+ d: Row;
29
+ i: number;
30
+ key: string;
31
+ }): SceneNode[];
32
+ /**
33
+ The scene nodes of a callout annotation's rows.
34
+ @param viz The chart.
35
+ @param annotation The callout annotation.
36
+ @param frame The plot area and its axes.
37
+ @param key The annotation's key, which prefixes its nodes'.
38
+ */
39
+ export declare function calloutNodes(viz: VizInstance, annotation: Annotation, frame: AnnotationFrame, key: string): SceneNode[];
40
+ export {};
@@ -0,0 +1,75 @@
1
+ /**
2
+ The text a ring chart (Pie with a hole, Donut, Sunburst, RadialBar) draws
3
+ in its empty middle when `centerLabel` is set: the chart's total, a
4
+ string, or what a function returns, wrapped and shrunk to fit the largest
5
+ box in the hole (see `centerLabelBoxes`). It is chrome: it carries no
6
+ datum, takes no pointer events, and draws nothing when it can't fit whole.
7
+ */
8
+ import type { DataPoint } from "@d3plus/data";
9
+ import type { SceneNode } from "@d3plus/render";
10
+ import type { VizInstance } from "../viz/vizTypes.js";
11
+ /** The `centerLabel` setting: the total (`true`), a string, or a function of the drawn data and their total. */
12
+ export type CenterLabelSetting = boolean | string | ((data: DataPoint[], total: number) => unknown) | null | undefined;
13
+ /** A chart's empty middle: a circle of `radius` around the origin, or the slice of it a partial sweep spans (radians, 0 at 12 o'clock, clockwise). */
14
+ export interface CenterHole {
15
+ radius: number;
16
+ startAngle?: number;
17
+ endAngle?: number;
18
+ }
19
+ /** A box the text may fill, around the origin. */
20
+ export interface CenterLabelBox {
21
+ x: number;
22
+ y: number;
23
+ width: number;
24
+ height: number;
25
+ /** The outline the text wraps within. */
26
+ shape: "circle" | "square";
27
+ }
28
+ /** The scene key of the center label's group. */
29
+ export declare const CENTER_LABEL_KEY = "center-label";
30
+ /**
31
+ The `centerLabelConfig` defaults: the chart's text color, sized between
32
+ 10 and 40 pixels, 5 pixels clear of the ring.
33
+ @param viz The chart.
34
+ */
35
+ export declare function centerLabelDefaults(viz: VizInstance): Record<string, unknown>;
36
+ /**
37
+ The sum of `value` over `data`, leaving out values that aren't numbers.
38
+ @param data The drawn rows.
39
+ @param value The chart's value accessor.
40
+ */
41
+ export declare function centerLabelTotal(data: DataPoint[], value: (d: DataPoint, i: number) => unknown): number;
42
+ /**
43
+ The text a `centerLabel` setting draws: the total, formatted the way the
44
+ chart's tooltips format values, for `true`; the string itself; or a
45
+ function's return value. Empty for a falsy setting or return value.
46
+ @param setting The `centerLabel` setting.
47
+ @param data The drawn rows.
48
+ @param total Their total.
49
+ @param locale The chart's locale.
50
+ */
51
+ export declare function centerLabelText(setting: CenterLabelSetting, data: DataPoint[], total: number, locale?: string): string;
52
+ /**
53
+ The boxes the text may fill in a hole: the whole circle (its text wrapped
54
+ to the circle) for a full turn, or, for a partial sweep, the largest box
55
+ of each of a few shapes that fits in the slice of the circle it spans.
56
+ Empty when the hole has no room.
57
+ @param hole The hole.
58
+ */
59
+ export declare function centerLabelBoxes(hole: CenterHole): CenterLabelBox[];
60
+ /**
61
+ The TextBox config the label is drawn with: the user's `centerLabelConfig`
62
+ over the centered defaults. A `fontSize` without `fontResize` fixes the
63
+ size; otherwise the text shrinks from `fontMax` to fit.
64
+ @param config The `centerLabelConfig`.
65
+ */
66
+ export declare function centerLabelStyle(config: Record<string, unknown>): Record<string, unknown>;
67
+ /**
68
+ The center label's scene nodes: one inert group holding the text, at the
69
+ largest size that fits the hole whole, centered in it. Empty when
70
+ `centerLabel` is unset or the text fits nowhere.
71
+ @param viz The chart.
72
+ @param hole The chart's empty middle, around its origin.
73
+ @param value The chart's value accessor, summed for the total.
74
+ */
75
+ export declare function centerLabelNodes(viz: VizInstance, hole: CenterHole, value: (d: DataPoint, i: number) => unknown): SceneNode[];
@@ -53,7 +53,7 @@ export declare function marginOriginTransform(viz: Viz): Transform;
53
53
 
54
54
  Width and height are the margin-adjusted chart-area dimensions —
55
55
  callers usually have them on hand from `chartBounds(viz)` or from
56
- fields a stage stashed (e.g. `_pieWidth` / `_radialMatrixWidth`).
56
+ fields a stage stashed (e.g. `_radialMatrixWidth`).
57
57
  */
58
58
  export declare function centerChartTransform(viz: Viz, width: number, height: number): Transform;
59
59
  /**
@@ -0,0 +1,97 @@
1
+ /**
2
+ Placement of circle labels: each label sits inside its circle when it fits
3
+ there at a readable size, otherwise beside the circle on the side with the
4
+ most open room (Moritz Stefaner's Voronoi labeling), otherwise nowhere.
5
+ Pure geometry: text is measured by the caller.
6
+
7
+ @module
8
+ */
9
+ import type { Bounds } from "@d3plus/math";
10
+ /** Where a circle's label goes: `"auto"` picks inside, beside, or hidden. */
11
+ export type LabelPosition = "auto" | "inside" | "outside";
12
+ /** A circle, in the same space as the bounds. */
13
+ export interface LabelCircle {
14
+ x: number;
15
+ y: number;
16
+ r: number;
17
+ }
18
+ /** An axis-aligned box: its top-left corner and size. */
19
+ export interface CircleLabelBox {
20
+ x: number;
21
+ y: number;
22
+ width: number;
23
+ height: number;
24
+ }
25
+ /** The sides of a circle a label can sit on. */
26
+ export type LabelSide = "right" | "left" | "top" | "bottom" | "top-right" | "top-left" | "bottom-right" | "bottom-left";
27
+ /** One label to place. */
28
+ export interface CircleLabelRequest {
29
+ /** The index, in the circles array, of the circle the label names. */
30
+ circle: number;
31
+ /** The label's size when it sits beside the circle. */
32
+ width: number;
33
+ height: number;
34
+ position: LabelPosition;
35
+ /** Whether the label fits inside its circle at a readable size. */
36
+ fitsInside: boolean;
37
+ }
38
+ /** Where a label went. */
39
+ export type CircleLabelPlacement = {
40
+ position: "inside";
41
+ } | {
42
+ position: "outside";
43
+ side: LabelSide;
44
+ box: CircleLabelBox;
45
+ } | {
46
+ position: "hidden";
47
+ };
48
+ /** Tuning for `placeCircleLabels`. */
49
+ export interface PlaceCircleLabelsOptions {
50
+ /** The space between a circle's edge and a label beside it (default 3). */
51
+ gap?: number;
52
+ /**
53
+ The share of a label's area that must lie in its circle's Voronoi cell,
54
+ the region closer to that circle's center than to any other (default
55
+ 0.5): a label mostly in a neighbor's cell would read as the neighbor's.
56
+ */
57
+ cellCoverage?: number;
58
+ }
59
+ /**
60
+ The box a `width` × `height` label takes on one side of a circle, `gap`
61
+ pixels clear of its edge: centered on the circle's axis for a straight
62
+ side, with its nearest corner on the circle's diagonal for a diagonal one.
63
+ */
64
+ export declare function sideBox(circle: LabelCircle, side: LabelSide, width: number, height: number, gap?: number): CircleLabelBox;
65
+ /** A ring's centroid, or null when it has no area. */
66
+ export declare function ringCentroid(ring: [number, number][]): [number, number] | null;
67
+ /**
68
+ The sides of a circle, most open first: ordered by how closely each
69
+ points toward the centroid of the circle's Voronoi cell (diagonals
70
+ slightly discounted), or in the default order (right, left, top, bottom,
71
+ then the diagonals) when the centroid is too close to the center to point
72
+ anywhere, which is the case for an evenly surrounded circle.
73
+ @param circle The circle.
74
+ @param cell Its Voronoi cell, or null.
75
+ */
76
+ export declare function sideOrder(circle: LabelCircle, cell: [number, number][] | null): LabelSide[];
77
+ /** The share (0–1) of a box's area that lies inside a ring. */
78
+ export declare function boxCoverage(box: CircleLabelBox, ring: [number, number][]): number;
79
+ /** Whether a box overlaps a circle's interior. */
80
+ export declare function boxHitsCircle(box: CircleLabelBox, circle: LabelCircle): boolean;
81
+ /** Whether two boxes overlap (touching edges don't count). */
82
+ export declare function boxesOverlap(a: CircleLabelBox, b: CircleLabelBox): boolean;
83
+ /**
84
+ Places circle labels. A label in `"inside"` mode stays inside its circle;
85
+ in `"auto"` mode it stays inside when `fitsInside`, and otherwise (or in
86
+ `"outside"` mode) it takes the first side of its circle, most open first
87
+ (see `sideOrder`), where it lies mostly in the circle's Voronoi cell, stays
88
+ in `bounds`, and overlaps no circle and no label placed before it. A label
89
+ with no such side, or whose circle is centered outside `bounds`, is
90
+ hidden. Labels are placed largest circle first
91
+ (ties in input order), so big circles win the room; the result is in
92
+ input order and depends only on the input.
93
+ @param circles Every circle, labeled or not: each is an obstacle.
94
+ @param labels The labels to place.
95
+ @param bounds The box labels must stay in.
96
+ */
97
+ export declare function placeCircleLabels(circles: readonly LabelCircle[], labels: readonly CircleLabelRequest[], bounds: Bounds, options?: PlaceCircleLabelsOptions): CircleLabelPlacement[];
@@ -0,0 +1,130 @@
1
+ /**
2
+ Circle labels on a chart: resolves each label's `labelPosition`, measures
3
+ its text, places it (see `circleLabelPlacement.ts`), and emits the labels
4
+ that sit beside their circles. Shared by Plot's point marks, Network's
5
+ nodes, and Geomap's coordinate points.
6
+
7
+ @module
8
+ */
9
+ import type { DataPoint } from "@d3plus/data";
10
+ import type { Bounds } from "@d3plus/math";
11
+ import type { SceneNode } from "@d3plus/render";
12
+ import type { VizInstance } from "../viz/vizTypes.js";
13
+ import type { CircleLabelPlacement, CircleLabelBox, LabelPosition, LabelSide } from "./circleLabelPlacement.js";
14
+ /** A font to measure or wrap text in. */
15
+ export interface LabelFont {
16
+ family?: string | string[];
17
+ size: number;
18
+ weight?: string | number;
19
+ /** The line height, in pixels (default 1.2 × `size`). */
20
+ lineHeight?: number;
21
+ }
22
+ /** The box an inside label wraps in, before padding. */
23
+ export interface InsideLabelBox {
24
+ width: number;
25
+ height: number;
26
+ /** `"circle"` wraps lines as chords of the circle the box holds. */
27
+ shape?: "circle" | "square";
28
+ /** CSS-style padding inside the box (default 0). */
29
+ padding?: number | string;
30
+ }
31
+ /**
32
+ Whether `text` fits inside a box at `font.size`, wrapped the way a label
33
+ TextBox wraps it, without being cut short.
34
+ @param text The label text.
35
+ @param box The box, with its wrapping shape and padding.
36
+ @param font The font, at the smallest size that counts as fitting.
37
+ */
38
+ export declare function labelFitsInside(text: string, box: InsideLabelBox, font: LabelFont): boolean;
39
+ /**
40
+ The box a one-line label takes: its measured width, plus a pixel of slack
41
+ on each side so the TextBox drawing it never wraps it, by a line's height
42
+ plus a pixel.
43
+ */
44
+ export declare function measureLabel(text: string, font: LabelFont): {
45
+ width: number;
46
+ height: number;
47
+ };
48
+ /** The resolved `pointLabelConfig`. */
49
+ export interface PointLabelSettings {
50
+ /** The smallest font size an inside label may shrink to before it moves outside. */
51
+ fontMin: number;
52
+ /** The font size of a label beside its circle. */
53
+ fontSize: number;
54
+ /** The space between a circle's edge and a label beside it. */
55
+ padding: number;
56
+ /** The TextBox config of a label beside its circle (font, color, …). */
57
+ text: Record<string, unknown>;
58
+ }
59
+ /** Reads `pointLabelConfig`: numbers for fontMin/fontSize/padding, the rest as TextBox config. */
60
+ export declare function pointLabelSettings(viz: VizInstance): PointLabelSettings;
61
+ /** A row's `labelPosition`, with anything unrecognized read as `"auto"`. */
62
+ export declare function labelPositionOf(viz: VizInstance, d: DataPoint, i: number): LabelPosition;
63
+ /** One circle on a chart, and its label. */
64
+ export interface CircleLabelItem<K> {
65
+ /** What the result is keyed by (the scene datum or layout node). */
66
+ key: K;
67
+ /** The data row, and its index, handed to `labelPosition` and the label config. */
68
+ datum: DataPoint;
69
+ index: number;
70
+ x: number;
71
+ y: number;
72
+ r: number;
73
+ /** The label text; anything but a string or number leaves the circle unlabeled (an obstacle only). */
74
+ text?: unknown;
75
+ /** How an inside label wraps (default: the circle itself, unpadded). */
76
+ inside?: InsideLabelBox & {
77
+ font?: Pick<LabelFont, "family" | "weight">;
78
+ };
79
+ }
80
+ /** A label's placement, with the mode it was placed in and its text. */
81
+ export type CircleLabelLayout = CircleLabelPlacement & {
82
+ mode: LabelPosition;
83
+ text: string;
84
+ };
85
+ /**
86
+ Places every labeled circle's label (see `placeCircleLabels`), reading
87
+ each row's `labelPosition` and the chart's `pointLabelConfig`. An
88
+ `"auto"` label counts as fitting inside when it fits at
89
+ `pointLabelConfig.fontMin`.
90
+ @param viz The chart.
91
+ @param items Every circle, labeled or not.
92
+ @param bounds The box labels must stay in, in the circles' space.
93
+ */
94
+ export declare function layoutCircleLabels<K>(viz: VizInstance, items: readonly CircleLabelItem<K>[], bounds: Bounds): Map<K, CircleLabelLayout>;
95
+ /** The text anchor that keeps a label flush against its circle. */
96
+ export declare function sideAnchor(side: LabelSide): "start" | "middle" | "end";
97
+ /** A label to draw beside its circle. */
98
+ export interface OutsideLabel {
99
+ /** The id the label's scene key is built from (`${id}_0`). */
100
+ id: string;
101
+ /** The scene datum the label carries (hover and active match on it). */
102
+ datum: DataPoint;
103
+ text: string;
104
+ side: LabelSide;
105
+ box: CircleLabelBox;
106
+ }
107
+ /**
108
+ Text nodes for labels placed beside their circles: one line each, in the
109
+ chart's ink (`backgroundInk`) at `pointLabelConfig.fontSize`, flush
110
+ against the circle, and inert to the pointer.
111
+ @param viz The chart.
112
+ @param labels The labels, each with its placed box.
113
+ @param config TextBox config layered under `pointLabelConfig` (such as a
114
+ `fontOpacity` that follows the shapes).
115
+ */
116
+ export declare function emitOutsideLabels(viz: VizInstance, labels: readonly OutsideLabel[], config?: Record<string, unknown>): SceneNode[];
117
+ /**
118
+ Splits laid-out labels into the ones drawn beside their circles, with the
119
+ id and scene datum each takes.
120
+ */
121
+ export declare function outsideLabels<K>(layout: Map<K, CircleLabelLayout>, describe: (key: K) => {
122
+ id: string;
123
+ datum: DataPoint;
124
+ }): OutsideLabel[];
125
+ /**
126
+ The font size floor of an inside label: `pointLabelConfig.fontMin` when it
127
+ was placed in `"auto"` mode (so it never shrinks below the size it was
128
+ judged to fit at), else its own.
129
+ */
130
+ export declare function insideFontMin(viz: VizInstance, placed: CircleLabelLayout | undefined, own: number): number;
@@ -0,0 +1,50 @@
1
+ /**
2
+ A bivariate `colorScale`: two fields (`colorScale: ["a", "b"]`) read as
3
+ one accessor that returns each row's pair of values, which the chart's
4
+ ColorScale bins and colors from a grid (see
5
+ `components/ColorScale/bivariateScale.ts`). Rows missing either value
6
+ have no colorScale value, like a row missing the one field of a
7
+ single-variable colorScale.
8
+ */
9
+ import type { DataPoint } from "@d3plus/data";
10
+ import type { VizInstance } from "../viz/vizTypes.js";
11
+ type Accessor = (d: DataPoint, i: number) => unknown;
12
+ /** What a bivariate accessor reads: its two accessors and the field names behind them. */
13
+ export interface BivariateSpec {
14
+ accessors: [Accessor, Accessor];
15
+ fields: [string | undefined, string | undefined];
16
+ }
17
+ /** `value` as a finite number, or null (null, undefined, "", and non-numbers have none). */
18
+ export declare function toNumber(value: unknown): number | null;
19
+ /** Whether `value` names a bivariate `colorScale`: two keys or accessors. */
20
+ export declare function isBivariateSetting(value: unknown): value is unknown[];
21
+ /**
22
+ The accessor a bivariate `colorScale` stores: each row's two values as a
23
+ `[first, second]` pair of numbers, or undefined when either is missing.
24
+ @param fields The two data keys or accessors.
25
+ */
26
+ export declare function bivariateAccessor(fields: unknown[]): (d: DataPoint, i: number) => [number, number] | undefined;
27
+ /** The bivariate setting behind a stored `colorScale`, or null for any other. */
28
+ export declare function bivariateOf(fn: unknown): BivariateSpec | null;
29
+ /** The chart's bivariate `colorScale` setting, or null when it has none. */
30
+ export declare function bivariateSpec(viz: VizInstance): BivariateSpec | null;
31
+ /**
32
+ The names a chart gives its bivariate scale's variables when
33
+ `bivariateLabels` doesn't: each field's name, or "Value 1" / "Value 2"
34
+ for an accessor.
35
+ @param viz The chart.
36
+ @param spec Its bivariate setting.
37
+ */
38
+ export declare function bivariateFieldNames(viz: VizInstance, spec: BivariateSpec): [string, string];
39
+ /**
40
+ The tooltip rows a chart's bivariate `colorScale` adds for a row: each
41
+ variable's name (as the key labels it) and the row's value, formatted
42
+ as the key formats its ranges. A variable the row has no value for gets
43
+ no row; a colorScale cell, or a chart without a bivariate scale, gets
44
+ none at all.
45
+ @param viz The chart.
46
+ @param d The hovered row.
47
+ @param i Its index.
48
+ */
49
+ export declare function bivariateTooltipRows(viz: VizInstance, d: DataPoint, i: number): [string, string][];
50
+ export {};
@@ -32,6 +32,16 @@ export declare function colorScaleBucketOf(d: unknown): (DataPoint & {
32
32
  legend). Returns null when there's no colorScale to read.
33
33
  */
34
34
  export declare function colorScaleBucketPredicate(viz: VizInstance, bucketColor: unknown): ((d: DataPoint, i: number) => boolean) | null;
35
+ /**
36
+ Highlights a colorScale bucket's data shapes, as hovering its swatch does:
37
+ every datum whose colorScale value falls in the bucket's color range stays
38
+ bright while the rest dim, and `_hoverBucket` marks the hover as a
39
+ bucket's.
40
+ @param viz The chart.
41
+ @param d A swatch's datum, or its label's, at any depth of wrapping.
42
+ @returns Whether `d` is a bucket's, highlighted or not.
43
+ */
44
+ export declare function hoverColorScaleBucket(viz: VizInstance, d: unknown): boolean;
35
45
  /**
36
46
  The set of bucket colors that contain at least one datum satisfying
37
47
  `predicate` — i.e. the swatches that should stay bright while the rest dim.
@@ -3,12 +3,13 @@ import type { VizInstance } from "../viz/vizTypes.js";
3
3
  /**
4
4
  The colorScale value of a hovered scene node: its datum unwrapped to the
5
5
  source row (as the shapes' fill unwraps it), read through the chart's
6
- `colorScale`. Null for chrome (legend, axes, the colorScale itself), a
7
- node without a row, or a row without a finite value.
6
+ `colorScale`: a pair of values on a bivariate colorScale. Null for
7
+ chrome (legend, axes, the colorScale itself), a node without a row, or a
8
+ row without a finite value.
8
9
  @param viz The chart.
9
10
  @param node The hovered scene node.
10
11
  */
11
- export declare function colorScaleHoverValue(viz: VizInstance, node: SceneNode | undefined): number | null;
12
+ export declare function colorScaleHoverValue(viz: VizInstance, node: SceneNode | undefined): number | [number, number] | null;
12
13
  /**
13
14
  Updates the colorScale's hover mark for a pointer event, repainting only
14
15
  when the marked value changes. Moves are ignored while a transition is
@@ -30,3 +31,12 @@ export declare function hoveredSwatch(viz: VizInstance): {
30
31
  color: unknown;
31
32
  dimOpacity: number;
32
33
  } | null;
34
+ /**
35
+ A swatch label showing its axis tooltip lights its bucket, as hovering its
36
+ swatch does (see `hoverColorScaleBucket`); moving off it, or onto a label
37
+ with nothing to show, clears that highlight.
38
+ @param viz The chart.
39
+ @param event The pointer event.
40
+ @param shown Whether an axis tooltip shows for the event (see `handleAxisTooltip`).
41
+ */
42
+ export declare function handleSwatchLabelHover(viz: VizInstance, event: SceneEvent, shown: boolean): void;
@@ -0,0 +1,60 @@
1
+ /**
2
+ The share of a chart a colorScale along one of its sides takes at most:
3
+ a third of the chart across the scale, its bar, padding, ticks, labels
4
+ and title together.
5
+ */
6
+ import type ColorScale from "../../components/ColorScale/ColorScale.js";
7
+ /** The most of a chart, across the scale, that a colorScale along one of its sides takes. */
8
+ export declare const MAX_SHARE: number;
9
+ /** The part of a colorScale's frame that `limitFrame` reads. */
10
+ interface LimitedFrame {
11
+ x: number;
12
+ y: number;
13
+ width: number;
14
+ height: number;
15
+ /** The side of the chart the scale sits on. */
16
+ orient: string | false;
17
+ /** `"end"` for a scale that sits against the far edge of its frame. */
18
+ align: string;
19
+ }
20
+ /** Whether a colorScale on the `orient` side of a chart runs along its width. */
21
+ export declare function isWide(orient: string | false): boolean;
22
+ /**
23
+ The room left for a scale's axis (its ticks, labels and title) when the
24
+ whole scale takes at most `limit`: what its bar, `size` thick, and the
25
+ `padding` on either side of the scale leave, in whole pixels.
26
+ */
27
+ export declare function axisRoom(limit: number, size: number, padding: number): number;
28
+ /**
29
+ Whether the ColorScale last drew a swatch per bucket, the form a Legend
30
+ lays out, rather than a bar along an axis or a bivariate key.
31
+ */
32
+ export declare function drawsSwatches(cs: ColorScale): boolean;
33
+ /**
34
+ `frame` cut down to `limit` across the scale, still against the edge of
35
+ the chart its scale is aligned to.
36
+ */
37
+ export declare function limitFrame<T extends LimitedFrame>(frame: T, limit: number): T;
38
+ /**
39
+ `frame` with the `limit` a colorScale along a side of the chart keeps to:
40
+ `set`, the size across the scale its `colorScaleConfig` gives it (its
41
+ `width` at the left or right, its `height` at the top or bottom), up to
42
+ the frame's own, with the frame cut down to it against its edge; else a
43
+ third of the frame across the scale.
44
+ */
45
+ export declare function sideFrame<T extends LimitedFrame>(frame: T, set: number | undefined): T & {
46
+ limit: number;
47
+ };
48
+ /** The number `config` sets for `key`, or undefined when it sets none. */
49
+ export declare function configSize(config: Record<string, unknown>, key: "width" | "height"): number | undefined;
50
+ /**
51
+ The frame a scale drawn as swatches is laid out in again, or undefined
52
+ when it keeps `frame`: one as far across the scale as its Legend may
53
+ reach, the size the scale's `legendConfig` gives it there or else the
54
+ frame's `limit`, once its swatches claim more than that limit (a frame
55
+ already cut down to the limit keeps it).
56
+ */
57
+ export declare function swatchFrame<T extends LimitedFrame & {
58
+ limit?: number;
59
+ }>(cs: ColorScale, frame: T): T | undefined;
60
+ export {};
@@ -0,0 +1,43 @@
1
+ /**
2
+ The rows a chart's `colorScale` adds to its shape tooltips: the row's
3
+ colorScale value, named and formatted as the colorScale shows it (two
4
+ rows for a bivariate colorScale, one per variable).
5
+ */
6
+ import type { DataPoint } from "@d3plus/data";
7
+ import type { VizInstance } from "../viz/vizTypes.js";
8
+ /**
9
+ The name a tooltip gives a single-variable colorScale's value: the
10
+ colorScale's `axisConfig.title`, else the field it reads, else the
11
+ translated "Value".
12
+ @param viz The chart.
13
+ */
14
+ export declare function colorScaleValueLabel(viz: VizInstance): string;
15
+ /**
16
+ The tooltip rows a chart's `colorScale` adds for a row: its value, named
17
+ (see `colorScaleValueLabel`) and formatted (see `colorScaleValueFormat`)
18
+ as the colorScale shows it, or, for a bivariate colorScale, each
19
+ variable's (see `bivariateTooltipRows`). None for a row without a value,
20
+ a colorScale bucket or key cell, a chart without a colorScale, one
21
+ whose tooltip already shows the value (`ChartDefinition.colorScaleTooltip`),
22
+ or one whose `tooltipConfig.tbody` the user has set.
23
+ @param viz The chart.
24
+ @param d The hovered row.
25
+ @param i Its index.
26
+ */
27
+ export declare function colorScaleTooltipRows(viz: VizInstance, d: DataPoint, i: number): [string, string][];
28
+ /** A tooltip whose `tbody` can be read and replaced. */
29
+ interface TbodyHost {
30
+ tbody(): unknown;
31
+ tbody(_: unknown): unknown;
32
+ }
33
+ /**
34
+ Leads `tooltip`'s `tbody` with the row's colorScale value rows (see
35
+ `colorScaleTooltipRows`), ahead of the chart's own rows. A `tbody` led on an earlier
36
+ hover is unwrapped first, so the rows never stack.
37
+ @param tooltip The chart's tooltip.
38
+ @param viz The chart.
39
+ @param d The hovered row.
40
+ @param i Its index.
41
+ */
42
+ export declare function leadWithColorScaleRows<T extends TbodyHost>(tooltip: T, viz: VizInstance, d: DataPoint, i: number): T;
43
+ export {};
@@ -0,0 +1,30 @@
1
+ import type { VizInstance } from "../viz/vizTypes.js";
2
+ /** The part of a colorScale's frame a top placement moves. */
3
+ interface TopFrame {
4
+ x: number;
5
+ y: number;
6
+ width: number;
7
+ height: number;
8
+ }
9
+ /** What a laid-out colorScale shows: the room it claims across it and its text. */
10
+ interface ScaleShown {
11
+ claim: number;
12
+ labels: string[];
13
+ }
14
+ /**
15
+ Whether a colorScale laid out beside the corner panels draws as well as
16
+ it does across the whole width (`whole`): no taller, its swatches with
17
+ every label they had, or its bar, shorter, with at least half as many
18
+ labels and no more of them cut short.
19
+ */
20
+ export declare function drawsAsWell(swatches: boolean, beside: ScaleShown, whole: ScaleShown): boolean;
21
+ /**
22
+ Paints a colorScale at the top of the chart with `paint`, into the first
23
+ of `cornerPlacements` it draws as well in as across all of `frame` (see
24
+ `drawsAsWell`): between the corner panels, then inset from each by its
25
+ own amount, and last across the whole width below them. `room` is the
26
+ height the chart has below `frame.y`. Returns how far the scale dropped
27
+ below `frame.y`.
28
+ */
29
+ export declare function paintTopColorScale<T extends TopFrame>(viz: VizInstance, frame: T, room: number, paint: (frame: T) => void): number;
30
+ export {};
@@ -0,0 +1,35 @@
1
+ /**
2
+ The value the chart's colorScale reads from a row: the chart's own
3
+ `colorScale` for its data rows, and, on the node-link charts, each link's
4
+ numeric `linkColor` value for its link rows (see `linkColorScaleRows`).
5
+ */
6
+ import type { DataPoint } from "@d3plus/data";
7
+ import type { VizInstance } from "../viz/vizTypes.js";
8
+ type Accessor = (d: DataPoint, i: number) => unknown;
9
+ /** Whether `v` is a number the colorScale can place. */
10
+ export declare function isScaleValue(v: unknown): v is number;
11
+ /**
12
+ Notes a drawn link datum's numeric `linkColor` value, so the colorScale
13
+ reads it for that link (hovering it marks the value on the colorScale,
14
+ and hovering a colorScale bucket highlights the links in it).
15
+ */
16
+ export declare function noteLinkValue(viz: VizInstance, datum: object, value: number): void;
17
+ /**
18
+ The `links` entries whose `linkColor` value is a number: the rows the
19
+ chart's colorScale adds to its own. Empty when `linkColor` isn't a key or
20
+ accessor, or no link has a numeric value.
21
+ */
22
+ export declare function linkColorScaleRows(viz: VizInstance): DataPoint[];
23
+ /**
24
+ The accessor the chart's colorScale reads values with: the chart's own
25
+ `colorScale`, which also reads each link row's numeric `linkColor`
26
+ value when it has links colored by number. Undefined when neither
27
+ gives the colorScale anything to show.
28
+ */
29
+ export declare function colorScaleValue(viz: VizInstance): Accessor | undefined;
30
+ /**
31
+ The color the chart's colorScale gives `value`: the scale's color for it,
32
+ or the scale's last color while it has no domain yet.
33
+ */
34
+ export declare function colorScaleColor(viz: VizInstance, value: unknown): unknown;
35
+ export {};