@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,353 @@
1
+ /**
2
+ The bivariate ColorScale's key: its grid of colors turned 45° into a
3
+ diamond, low/low at the bottom corner and high/high at the top, the first
4
+ variable rising toward the right corner and the second toward the left,
5
+ each named along its lower edge.
6
+ */ import { textWidth } from "@d3plus/dom";
7
+ import { formatAbbreviate } from "@d3plus/format";
8
+ import { fontFamilyStringify, textWrap } from "@d3plus/text";
9
+ import { formatYear, isYearLike } from "../Axis/yearValues.js";
10
+ import { bivariateBucketCount, bivariatePalette, bivariateScale, isBivariatePair } from "./bivariateScale.js";
11
+ /** The side of the key's grid before it turns, in pixels, when it fits. */ const GRID_SIDE = 80;
12
+ /** The gap between the diamond's edge and its labels. */ const LABEL_GAP = 4;
13
+ /** Grid point `(u, v)` (`u` along the first variable, `v` the second) turned into the diamond, low/low at the origin. */ function toDiamond(u, v) {
14
+ return [
15
+ (u - v) * Math.SQRT1_2,
16
+ -(u + v) * Math.SQRT1_2
17
+ ];
18
+ }
19
+ /**
20
+ The names the key gives its two variables: `bivariateLabels`, else the
21
+ names the chart passes (its field names).
22
+ @param cs The ColorScale.
23
+ */ export function bivariateAxisLabels(cs) {
24
+ const own = cs.schema.bivariateLabels;
25
+ const fields = cs._bivariateFields ?? [];
26
+ const pick = (k)=>{
27
+ const label = Array.isArray(own) ? own[k] : undefined;
28
+ const value = label ?? fields[k];
29
+ return value === undefined || value === null ? "" : `${value}`;
30
+ };
31
+ return [
32
+ pick(0),
33
+ pick(1)
34
+ ];
35
+ }
36
+ /**
37
+ How a ColorScale's values read in a bivariate key's ranges and in a
38
+ chart's tooltip: `axisConfig.tickFormat`, else a variable whose values
39
+ all read as years as years, else abbreviated (`formatAbbreviate`).
40
+ @param cs The ColorScale.
41
+ @param values The variable's values.
42
+ */ export function colorScaleValueFormat(cs, values) {
43
+ const tickFormat = cs.schema.axisConfig?.tickFormat;
44
+ if (tickFormat) return tickFormat;
45
+ if (values.length && isYearLike(values)) return (v)=>formatYear(v, cs.schema.locale);
46
+ return (v)=>formatAbbreviate(v, cs.schema.locale);
47
+ }
48
+ /** A bin's range as text (`"lo - hi"`, or one value), or "" for an empty bin. */ function rangeText(cs, bins, b, format) {
49
+ const range = bins.ranges[b];
50
+ if (!range) return "";
51
+ return cs.schema.bucketJoiner(format(range[0]), format(range[1]));
52
+ }
53
+ /** A cell's title: each variable's name and the range of its bin. */ function cellTitle(cs, scale, [i, j], labels, formats) {
54
+ return [
55
+ [
56
+ labels[0],
57
+ rangeText(cs, scale.x, i, formats[0])
58
+ ],
59
+ [
60
+ labels[1],
61
+ rangeText(cs, scale.y, j, formats[1])
62
+ ]
63
+ ].filter(([, range])=>range).map(([label, range])=>label ? `${label}: ${range}` : range).join(", ");
64
+ }
65
+ /** The label font the key reads off `labelConfig`, for `text`. */ function labelFont(cs, text) {
66
+ const read = (key)=>{
67
+ const v = cs._labelClass[key]();
68
+ return typeof v === "function" ? v(text, 0) : v;
69
+ };
70
+ const family = read("fontFamily");
71
+ return {
72
+ family: fontFamilyStringify(family),
73
+ size: Number(read("fontSize")) || 12,
74
+ weight: read("fontWeight") ?? 400,
75
+ color: `${read("fontColor")}`
76
+ };
77
+ }
78
+ /**
79
+ One variable's name along its lower edge of the diamond: up to two lines
80
+ as long as the edge, an arrow pointing the way the variable rises.
81
+ */ function edgeLabel(cs, text, axis, side) {
82
+ if (!text) return null;
83
+ const font = labelFont(cs, text);
84
+ const style = {
85
+ "font-family": font.family,
86
+ "font-size": font.size,
87
+ "font-weight": font.weight
88
+ };
89
+ const arrow = axis === 0 ? " →" : "← ";
90
+ const arrowWidth = textWidth(arrow, style);
91
+ // Lines as long as the edge, never splitting a word.
92
+ const widest = Math.max(...text.split(/\s+/).map((word)=>textWidth(word, style)));
93
+ const wrapped = textWrap().fontFamily(font.family).fontSize(font.size).fontWeight(font.weight).lineHeight(font.size * 1.2).maxLines(2)// Whole words only: no hyphenating a long one across the lines.
94
+ .split((sentence)=>sentence.match(/\S+\s*/g) ?? []).width(Math.max(side - arrowWidth, widest + 1)).height(font.size * 1.2 * 2 + 1)(text);
95
+ const lines = wrapped.lines.length ? wrapped.lines.slice() : [
96
+ text
97
+ ];
98
+ // The arrow rides the line nearest the far corner: the first variable's
99
+ // reads toward its corner at the end of the last line, the second's
100
+ // toward its corner at the start of the first.
101
+ if (axis === 0) lines[lines.length - 1] += arrow;
102
+ else lines[0] = arrow + lines[0];
103
+ const lineHeight = font.size * 1.2;
104
+ const widths = lines.map((l)=>textWidth(l, style));
105
+ const width = Math.max(...widths);
106
+ // The edge's direction (x) and outward normal (y) the label's lines lie
107
+ // along, and the label's center: the edge's midpoint, or, for a label
108
+ // longer than the edge, past it toward the far corner, so the two labels
109
+ // never meet below the bottom corner.
110
+ const rotate = axis === 0 ? -45 : 45;
111
+ const ex = axis === 0 ? [
112
+ Math.SQRT1_2,
113
+ -Math.SQRT1_2
114
+ ] : [
115
+ Math.SQRT1_2,
116
+ Math.SQRT1_2
117
+ ];
118
+ const shift = (axis === 0 ? 1 : -1) * Math.max(0, width - side) / 2;
119
+ const [ox, oy] = axis === 0 ? toDiamond(side / 2, 0) : toDiamond(0, side / 2);
120
+ const mx = ox + ex[0] * shift;
121
+ const my = oy + ex[1] * shift;
122
+ const ey = axis === 0 ? [
123
+ Math.SQRT1_2,
124
+ Math.SQRT1_2
125
+ ] : [
126
+ -Math.SQRT1_2,
127
+ Math.SQRT1_2
128
+ ];
129
+ const depth = LABEL_GAP + lineHeight * lines.length;
130
+ const corners = [
131
+ [
132
+ -width / 2,
133
+ LABEL_GAP
134
+ ],
135
+ [
136
+ width / 2,
137
+ LABEL_GAP
138
+ ],
139
+ [
140
+ -width / 2,
141
+ depth
142
+ ],
143
+ [
144
+ width / 2,
145
+ depth
146
+ ]
147
+ ].map(([lx, ly])=>[
148
+ mx + ex[0] * lx + ey[0] * ly,
149
+ my + ex[1] * lx + ey[1] * ly
150
+ ]);
151
+ const node = {
152
+ type: "text",
153
+ key: `bivariate-label-${axis}`,
154
+ x: 0,
155
+ y: 0,
156
+ transform: {
157
+ x: mx,
158
+ y: my,
159
+ rotate
160
+ },
161
+ lines: lines.map((line, k)=>({
162
+ text: line,
163
+ x: 0,
164
+ y: LABEL_GAP + lineHeight * (k + 0.5),
165
+ width: widths[k]
166
+ })),
167
+ font: {
168
+ family: font.family,
169
+ size: font.size,
170
+ weight: font.weight,
171
+ anchor: "middle",
172
+ baseline: "middle"
173
+ },
174
+ paint: {
175
+ fill: font.color
176
+ },
177
+ interactive: false,
178
+ aria: {
179
+ hidden: true
180
+ }
181
+ };
182
+ return {
183
+ node,
184
+ corners
185
+ };
186
+ }
187
+ /**
188
+ A key cell's stroke: the one `legendConfig.shapeConfig` gives the
189
+ colorScale's swatches, which a chart sets to its own shapes' stroke.
190
+ */ function cellStroke(cs, datum, i) {
191
+ const sc = cs.schema.legendConfig?.shapeConfig ?? {};
192
+ const read = (key)=>{
193
+ const v = sc[key];
194
+ return typeof v === "function" ? v(datum, i) : v;
195
+ };
196
+ const stroke = read("stroke");
197
+ const strokeWidth = Number(read("strokeWidth"));
198
+ const strokeOpacity = read("strokeOpacity");
199
+ if (typeof stroke !== "string" || !stroke || !(strokeWidth > 0)) return {};
200
+ return {
201
+ stroke,
202
+ strokeWidth,
203
+ ...typeof strokeOpacity === "number" ? {
204
+ strokeOpacity
205
+ } : {}
206
+ };
207
+ }
208
+ /** The key's cells, a path each, and their corners. */ function cellNodes(cs, scale, side) {
209
+ const n = scale.size;
210
+ const step = side / n;
211
+ const labels = bivariateAxisLabels(cs);
212
+ const values = (bins)=>scale.domain().map((p)=>p[bins]);
213
+ const formats = [
214
+ colorScaleValueFormat(cs, values(0)),
215
+ colorScaleValueFormat(cs, values(1))
216
+ ];
217
+ const nodes = [];
218
+ for(let j = 0; j < n; j++)for(let i = 0; i < n; i++){
219
+ const points = [
220
+ toDiamond(i * step, j * step),
221
+ toDiamond((i + 1) * step, j * step),
222
+ toDiamond((i + 1) * step, (j + 1) * step),
223
+ toDiamond(i * step, (j + 1) * step)
224
+ ];
225
+ const datum = {
226
+ color: scale.colors[j * n + i],
227
+ id: cellTitle(cs, scale, [
228
+ i,
229
+ j
230
+ ], labels, formats),
231
+ _isColorScaleBucket: true,
232
+ _bivariateX: i,
233
+ _bivariateY: j
234
+ };
235
+ nodes.push({
236
+ type: "path",
237
+ key: `bivariate-cell-${i}-${j}`,
238
+ d: `M${points.map((p)=>p.map((v)=>+v.toFixed(3)).join(",")).join("L")}Z`,
239
+ datum,
240
+ index: j * n + i,
241
+ paint: {
242
+ fill: datum.color,
243
+ ...cellStroke(cs, datum, j * n + i)
244
+ },
245
+ aria: {
246
+ label: datum.id
247
+ }
248
+ });
249
+ }
250
+ return {
251
+ nodes,
252
+ corners: [
253
+ toDiamond(0, 0),
254
+ toDiamond(side, 0),
255
+ toDiamond(0, side),
256
+ toDiamond(side, side)
257
+ ]
258
+ };
259
+ }
260
+ /** Lays the key out with a grid `side` pixels across, low/low corner at the origin. */ function layoutAt(cs, scale, side) {
261
+ const cells = cellNodes(cs, scale, side);
262
+ const labels = bivariateAxisLabels(cs);
263
+ const edges = [
264
+ edgeLabel(cs, labels[0], 0, side),
265
+ edgeLabel(cs, labels[1], 1, side)
266
+ ].filter(Boolean);
267
+ const corners = cells.corners.concat(...edges.map((e)=>e.corners));
268
+ const xs = corners.map((c)=>c[0]);
269
+ const ys = corners.map((c)=>c[1]);
270
+ const x = Math.min(...xs);
271
+ const y = Math.min(...ys);
272
+ return {
273
+ nodes: [
274
+ ...cells.nodes,
275
+ ...edges.map((e)=>e.node)
276
+ ],
277
+ bounds: {
278
+ x,
279
+ y,
280
+ width: Math.max(...xs) - x,
281
+ height: Math.max(...ys) - y
282
+ }
283
+ };
284
+ }
285
+ /**
286
+ Lays the key out within the ColorScale's `width` × `height`: its grid
287
+ shrinks from its full size to fit, and it sits along the side its labels
288
+ face (`orient`) at its `align`ment, as the swatch legend does.
289
+ @param cs The ColorScale.
290
+ @param scale Its bivariate scale.
291
+ */ export function layoutBivariate(cs, scale) {
292
+ const width = Number(cs.schema.width) || 0;
293
+ const height = Number(cs.schema.height) || 0;
294
+ let side = GRID_SIDE;
295
+ let layout = layoutAt(cs, scale, side);
296
+ // Labels keep their size as the grid shrinks (and may wrap anew): shrink
297
+ // the grid by what the whole key overflows until it fits, down to a third
298
+ // of its size.
299
+ for(let tries = 0; tries < 4 && side > GRID_SIDE / 3; tries++){
300
+ const over = Math.max(layout.bounds.width - width, layout.bounds.height - height);
301
+ if (over <= 0 || !width || !height) break;
302
+ side = Math.max(GRID_SIDE / 3, side - over * Math.SQRT1_2 - 1);
303
+ layout = layoutAt(cs, scale, side);
304
+ }
305
+ const horizontal = [
306
+ "bottom",
307
+ "top"
308
+ ].includes(cs.schema.orient);
309
+ const spare = (room, size)=>{
310
+ const align = cs.schema.align;
311
+ const free = Math.max(0, room - size);
312
+ return align === "start" ? 0 : align === "end" ? free : free / 2;
313
+ };
314
+ const left = horizontal ? Math.max(0, width - layout.bounds.width) / 2 : spare(width, layout.bounds.width);
315
+ const top = horizontal ? spare(height, layout.bounds.height) : Math.max(0, height - layout.bounds.height) / 2;
316
+ const dx = left - layout.bounds.x;
317
+ const dy = top - layout.bounds.y;
318
+ return {
319
+ nodes: [
320
+ {
321
+ type: "group",
322
+ key: "bivariate-key",
323
+ transform: {
324
+ x: dx,
325
+ y: dy
326
+ },
327
+ children: layout.nodes
328
+ }
329
+ ],
330
+ bounds: {
331
+ x: left,
332
+ y: top,
333
+ width: layout.bounds.width,
334
+ height: layout.bounds.height
335
+ }
336
+ };
337
+ }
338
+ /**
339
+ Builds a bivariate ColorScale's scale from its data (each row's `value`
340
+ a pair of numbers), assigns it as the ColorScale's `_colorScale`, and
341
+ lays out its diamond key.
342
+ @param cs The ColorScale.
343
+ */ export function renderBivariate(cs) {
344
+ const n = bivariateBucketCount(cs.schema.bivariateBuckets);
345
+ const pairs = cs._data.map((d, i)=>cs.schema.value(d, i)).filter(isBivariatePair);
346
+ const scale = bivariateScale(pairs, n, bivariatePalette(cs.schema.bivariateColors, n));
347
+ cs._colorScale = scale;
348
+ cs._barGeometry = undefined;
349
+ cs._labelClass.config(cs.schema.labelConfig);
350
+ const layout = layoutBivariate(cs, scale);
351
+ cs._outerBounds = layout.bounds;
352
+ return layout;
353
+ }
@@ -0,0 +1,150 @@
1
+ /**
2
+ The scale behind a bivariate ColorScale: each of two variables split into
3
+ quantile bins, and the grid of colors the pair of bins picks from.
4
+ */ import { ascending, bisectLeft, bisectRight } from "d3-array";
5
+ import { rgb } from "d3-color";
6
+ import { interpolateRgb } from "d3-interpolate";
7
+ /**
8
+ Joshua Stevens' blue–red 3×3 scheme, from "Bivariate Choropleth Maps: A
9
+ How-to Guide" (joshuastevens.net/cartography/make-a-bivariate-choropleth-map/),
10
+ with the hex values as published in the R `pals` package
11
+ (`stevens.bluered`). Row-major from the low/low corner: each row is one
12
+ bin of the second variable (low to high), each column one bin of the
13
+ first (low to high). The first variable rises toward red (#c85a5a), the
14
+ second toward blue (#64acbe), and both together toward #574249. Each
15
+ inner color is the two ramps multiplied over the shared #e8e8e8 base.
16
+ */ export const BIVARIATE_COLORS = [
17
+ "#e8e8e8",
18
+ "#e4acac",
19
+ "#c85a5a",
20
+ "#b0d5df",
21
+ "#ad9ea5",
22
+ "#985356",
23
+ "#64acbe",
24
+ "#627f8c",
25
+ "#574249"
26
+ ];
27
+ /** The fewest and most bins a bivariate ColorScale splits each variable into. */ export const BIVARIATE_MIN_BUCKETS = 2;
28
+ export const BIVARIATE_MAX_BUCKETS = 4;
29
+ /** The bins per variable when none is set. */ export const BIVARIATE_BUCKETS = 3;
30
+ /**
31
+ The number of bins per variable: `value` rounded and held within 2–4, or
32
+ 3 when it isn't a number.
33
+ @param value The configured bin count.
34
+ */ export function bivariateBucketCount(value) {
35
+ if (typeof value !== "number" || !Number.isFinite(value)) return BIVARIATE_BUCKETS;
36
+ return Math.min(BIVARIATE_MAX_BUCKETS, Math.max(BIVARIATE_MIN_BUCKETS, Math.round(value)));
37
+ }
38
+ /** The side of a square grid of `length` colors, or 0 when it isn't one of at least 2×2. */ function gridSide(length) {
39
+ const side = Math.round(Math.sqrt(length));
40
+ return side >= 2 && side * side === length ? side : 0;
41
+ }
42
+ /**
43
+ Resamples a square grid of colors (row-major, `k×k`) to `n×n`: a grid
44
+ already `n×n` is returned as given, and any other is blended
45
+ bilinearly between its nearest colors, so its corners stay put. A 3×3
46
+ scheme resampled to 4×4 keeps its corners and blends its middle colors
47
+ across the new cells; one resampled to 2×2 keeps only its corners.
48
+ @param grid The colors, row-major.
49
+ @param n The side of the grid to return.
50
+ */ export function resampleGrid(grid, n) {
51
+ const k = gridSide(grid.length);
52
+ if (!k) return [];
53
+ if (k === n) return grid.slice();
54
+ const at = (x, y)=>grid[y * k + x];
55
+ const out = [];
56
+ const position = (step)=>{
57
+ const g = n > 1 ? step * (k - 1) / (n - 1) : 0;
58
+ const lo = Math.min(k - 2, Math.floor(g));
59
+ return [
60
+ lo,
61
+ g - lo
62
+ ];
63
+ };
64
+ for(let j = 0; j < n; j++){
65
+ const [y, ty] = position(j);
66
+ for(let i = 0; i < n; i++){
67
+ const [x, tx] = position(i);
68
+ const low = interpolateRgb(at(x, y), at(x + 1, y))(tx);
69
+ const high = interpolateRgb(at(x, y + 1), at(x + 1, y + 1))(tx);
70
+ out.push(rgb(interpolateRgb(low, high)(ty)).formatHex());
71
+ }
72
+ }
73
+ return out;
74
+ }
75
+ /**
76
+ The `n×n` colors a bivariate ColorScale paints with (row-major, as
77
+ `BIVARIATE_COLORS`): `colors` when it is a square grid of at least 2×2
78
+ color strings, resampled to `n×n` (see `resampleGrid`), else Stevens'
79
+ 3×3 scheme resampled the same way.
80
+ @param colors The configured grid.
81
+ @param n The bins per variable.
82
+ */ export function bivariatePalette(colors, n) {
83
+ const valid = Array.isArray(colors) && gridSide(colors.length) > 0 && colors.every((c)=>typeof c === "string" && rgb(c).displayable());
84
+ return resampleGrid(valid ? colors : BIVARIATE_COLORS, n);
85
+ }
86
+ /**
87
+ Splits one variable's values into `n` quantile bins by rank: a value's
88
+ bin is its share of the values ranked below it (ties counted at their
89
+ middle rank), so each bin holds about as many values as the next, and
90
+ equal values always share a bin. A value outside the data ranks by
91
+ where it would sort.
92
+ @param values The variable's values (non-finite ones are ignored).
93
+ @param n The number of bins.
94
+ */ export function bivariateBins(values, n) {
95
+ const sorted = values.filter(Number.isFinite).sort(ascending);
96
+ const count = sorted.length;
97
+ const bin = (value)=>{
98
+ if (!count || !Number.isFinite(value)) return 0;
99
+ // Twice the tie group's middle rank, in whole numbers so a value right
100
+ // on a bin's edge doesn't slip below it to float error.
101
+ const ranks = bisectLeft(sorted, value) + bisectRight(sorted, value);
102
+ return Math.min(n - 1, Math.floor(ranks * n / (2 * count)));
103
+ };
104
+ const ranges = Array.from({
105
+ length: n
106
+ }, ()=>null);
107
+ for (const v of sorted){
108
+ const b = bin(v);
109
+ const range = ranges[b];
110
+ if (!range) ranges[b] = [
111
+ v,
112
+ v
113
+ ];
114
+ else range[1] = v;
115
+ }
116
+ return {
117
+ bin,
118
+ ranges
119
+ };
120
+ }
121
+ /** Whether `value` is a pair of finite numbers. */ export function isBivariatePair(value) {
122
+ return Array.isArray(value) && value.length === 2 && Number.isFinite(value[0]) && Number.isFinite(value[1]);
123
+ }
124
+ /**
125
+ Builds a bivariate color scale from the value pairs in the data: each
126
+ variable binned into `n` quantiles (see `bivariateBins`), colored from
127
+ `colors`, an `n×n` grid (see `bivariatePalette`).
128
+ @param pairs The data's value pairs.
129
+ @param n The bins per variable.
130
+ @param colors The `n×n` colors, row-major.
131
+ */ export function bivariateScale(pairs, n, colors) {
132
+ const x = bivariateBins(pairs.map((p)=>p[0]), n);
133
+ const y = bivariateBins(pairs.map((p)=>p[1]), n);
134
+ const cell = (value)=>isBivariatePair(value) ? [
135
+ x.bin(value[0]),
136
+ y.bin(value[1])
137
+ ] : null;
138
+ const scale = (value)=>{
139
+ const c = cell(value);
140
+ return c ? colors[c[1] * n + c[0]] : undefined;
141
+ };
142
+ scale.cell = cell;
143
+ scale.size = n;
144
+ scale.x = x;
145
+ scale.y = y;
146
+ scale.colors = colors;
147
+ scale.domain = ()=>pairs;
148
+ scale.range = ()=>colors;
149
+ return scale;
150
+ }
@@ -8,17 +8,46 @@ import { max } from "d3-array";
8
8
  return Math.max(0, decimals.length - Number(exponent));
9
9
  }
10
10
  /** `value` counted in steps of `10^-places`, with float noise rounded off. */ const toSteps = (value, places)=>+(value * 10 ** places).toPrecision(15);
11
- /** The value of `steps` steps of `10^-places`. */ const fromSteps = (steps, places)=>+(steps / 10 ** places).toPrecision(15);
11
+ /** The value of `steps` steps of `10^-places` (never `-0`). */ const fromSteps = (steps, places)=>+(steps / 10 ** places).toPrecision(15) || 0;
12
+ /** Significant digits from which a value reads as computed rather than written. */ const COMPUTED_DIGITS = 12;
13
+ /** The number of significant digits `value` is written with, at 15 digits. */ export function significantDigits(value) {
14
+ const mantissa = value.toExponential(14).split("e")[0];
15
+ return mantissa.replace(/[-.]/g, "").replace(/0+$/, "").length || 1;
16
+ }
17
+ /** How small, as a share of the values' span, a value is float noise around zero. */ const NOISE = 1e-9;
18
+ /**
19
+ The decimal places bucket labels step at: the most any value is written
20
+ with. A computed value (a mean such as `1 / 3`) carries float precision
21
+ no label should step at, so its own places count only to the data's
22
+ display precision: three significant digits of the values' span. A value
23
+ within float noise of zero (`-1.4e-14`) counts as zero.
24
+ */ export function labelPlaces(allValues) {
25
+ const finite = allValues.filter(Number.isFinite);
26
+ if (!finite.length) return 0;
27
+ const span = max(finite) - Math.min(...finite) || Math.abs(finite[0]);
28
+ const values = finite.map((v)=>Math.abs(v) < span * NOISE ? 0 : v);
29
+ const written = values.filter((v)=>significantDigits(v) < COMPUTED_DIGITS);
30
+ const places = max(written.map(decimalPlaces)) ?? 0;
31
+ if (written.length === values.length) return places;
32
+ const display = span ? Math.max(0, 2 - Math.floor(Math.log10(span))) : 0;
33
+ return Math.max(places, display);
34
+ }
35
+ /** `value` rounded to the places bucket labels step at (see `labelPlaces`). */ export function labelValue(value, allValues) {
36
+ const places = labelPlaces(allValues);
37
+ return fromSteps(Math.round(toSteps(value, places)), places);
38
+ }
12
39
  /**
13
40
  The `[lower, upper]` values a ColorScale label shows for the bucket
14
41
  `[ticks[i], ticks[i + 1])`: the first and last values the data's own
15
- precision can write inside it, so integer data reads "1 - 2", "3 - 4".
42
+ precision (see `labelPlaces`) can write inside it, so integer data reads
43
+ "1 - 2", "3 - 4", and computed values such as means don't step at float
44
+ precision (a bucket ending at 0 reads "-9.5 - -0.1", not "-9.5 - -1f").
16
45
  When `format` prints the upper bound the same as the next bucket's lower
17
46
  one (an abbreviation like "1.5k"), the upper bound drops a decimal place
18
47
  at a time until it reads differently ("1.49k").
19
48
  */ export function bucketBounds(tick, i, ticks, allValues, format) {
20
49
  const next = ticks[i + 1];
21
- const places = max(allValues.filter(Number.isFinite).map(decimalPlaces)) ?? 0;
50
+ const places = labelPlaces(allValues);
22
51
  const tickSteps = toSteps(tick, places);
23
52
  // A repeated first tick labels its own value, so the bucket after it
24
53
  // starts one step above.
@@ -7,7 +7,8 @@
7
7
  (jenks, buckets, quantile without `bucketAxis`) get no mark: the value's
8
8
  swatch stays lit and the rest dim instead (see `hoveredSwatch`).
9
9
  */ import { colorContrast } from "@d3plus/color";
10
- import { backgroundColor, textWidth } from "@d3plus/dom";
10
+ import { textWidth } from "@d3plus/dom";
11
+ import { inkText } from "../../utils/themeInk.js";
11
12
  /** `hoverMarkConfig`'s defaults. */ export function hoverMarkDefaults() {
12
13
  return {
13
14
  tickConfig: {},
@@ -312,8 +313,7 @@ import { backgroundColor, textWidth } from "@d3plus/dom";
312
313
  const value = cs._hoverValue;
313
314
  const geometry = cs._barGeometry;
314
315
  if (cs.schema.hoverMark === false || typeof value !== "number" || !Number.isFinite(value) || !cs._colorScale || !geometry) return;
315
- const node = cs._select && typeof cs._select.node === "function" ? cs._select.node() : null;
316
- const ink = colorContrast(node ? backgroundColor(node) : "rgb(255, 255, 255)", cs.schema.colorDefaults);
316
+ const ink = inkText(cs);
317
317
  const mark = {
318
318
  cs,
319
319
  key: `${group.key}-hover`,
@@ -1,6 +1,12 @@
1
1
  import { scaleLinear } from "d3-scale";
2
2
  import { assign, elem, textWidth } from "@d3plus/dom";
3
3
  import { gradientToken } from "@d3plus/render";
4
+ import { resetKeys } from "../../fluent.js";
5
+ /** The config a Legend merges each render's into, rather than replaces. */ const LEGEND_BAGS = [
6
+ "shapeConfig",
7
+ "titleConfig"
8
+ ];
9
+ /** The config keys each ColorScale's Legend was last given. */ const legendKeys = new WeakMap();
4
10
  /** Builds the axis/label configs and trims the gradient for end labels. */ function prepareGradientAxis(cs, compute, offsets) {
5
11
  const { horizontal, height, width, domain, labels, ticks } = compute;
6
12
  const axisDomain = domain.slice();
@@ -68,6 +74,9 @@ import { gradientToken } from "@d3plus/render";
68
74
  }
69
75
  /** Renders the measurement + visible axes, returning bounds and the position scale. */ function renderGradientAxes(cs, compute, groups, axisConfig, offsets) {
70
76
  const { horizontal, height, width, x, y } = compute;
77
+ // A bucketed bar labels every bucket, and hides some to give the rest
78
+ // as many lines as a gradient's labels take.
79
+ cs._axisTest._thinForLines = cs._axisClass._thinForLines = !!cs.schema.bucketAxis;
71
80
  cs._axisTest.renderMode("compute").select(elem("g.d3plus-ColorScale-axisTest", {
72
81
  enter: {
73
82
  opacity: 0
@@ -219,22 +228,32 @@ import { gradientToken } from "@d3plus/render";
219
228
  });
220
229
  renderGradientLabels(cs, compute, groups, labelConfig, rectConfig, labelData);
221
230
  }
231
+ /** Whether the Legend's last render left out or cut short its swatches' labels, or drew nothing. */ function labelsLeftOut(legend) {
232
+ if (!legend.data().length) return false;
233
+ return !legend.outerBounds().width || legend._lineData.some((d)=>d.sentence && (!d.width || d.cut));
234
+ }
222
235
  /** Renders the discrete legend ColorScale variant (jenks/buckets/quantile). */ export function renderLegendVariant(cs, compute, groups) {
223
236
  const { horizontal, allValues, ticks, colors } = compute;
224
237
  cs._barGeometry = undefined;
225
238
  elem("g.d3plus-ColorScale-axis", Object.assign({
226
239
  condition: groups.gradient
227
240
  }, groups.groupParams));
241
+ cs._swatchBuckets = new Map();
228
242
  let legendData = ticks.reduce((arr, tick, i)=>{
229
243
  const label = cs.schema.bucketFormat.bind(cs)(tick, i, ticks, allValues);
230
244
  // `_isColorScaleBucket` marks these as range buckets (not groupBy rows)
231
245
  // so a parent Viz's `_drawLabel` titles their tooltip with the bucket
232
246
  // label (`id`) instead of resolving to "undefined" via groupBy.
233
- arr.push({
247
+ const row = {
234
248
  color: colors[i + 1],
235
249
  id: label,
236
250
  _isColorScaleBucket: true
251
+ };
252
+ cs._swatchBuckets.set(row, {
253
+ value: tick,
254
+ index: i
237
255
  });
256
+ arr.push(row);
238
257
  return arr;
239
258
  }, []);
240
259
  if (!horizontal) legendData = legendData.reverse();
@@ -260,6 +279,17 @@ import { gradientToken } from "@d3plus/render";
260
279
  end: "bottom"
261
280
  })[cs.schema.align] : "middle"
262
281
  }, cs.schema.legendConfig);
263
- cs._legendClass.renderMode("compute").data(legendData).select(groups.legendGroup.node()).config(legendConfig).render();
282
+ // Each render starts from the Legend's defaults, so config an earlier
283
+ // render gave it and this one doesn't is dropped.
284
+ const legend = cs._legendClass;
285
+ legend.config(resetKeys(legend, [
286
+ ...LEGEND_BAGS,
287
+ ...legendKeys.get(legend) ?? []
288
+ ]));
289
+ legendKeys.set(legend, Object.keys(legendConfig));
290
+ legend.renderMode("compute").data(legendData).select(groups.legendGroup.node()).config(legendConfig).render();
291
+ // Like the axis of a gradient, the swatches leave out their title before
292
+ // they cut short or leave out their labels.
293
+ if (legend.title() && labelsLeftOut(legend)) legend.title(undefined).render();
264
294
  cs._outerBounds = cs._legendClass.outerBounds();
265
295
  }