@d3plus/core 4.9.0 → 4.11.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 (687) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +170 -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 +170 -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 +81 -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 +178 -0
  17. package/es/src/charts/ArcDiagram/events.js +144 -0
  18. package/es/src/charts/ArcDiagram/index.js +215 -0
  19. package/es/src/charts/BarChart/index.js +14 -2
  20. package/es/src/charts/BoxWhisker/index.js +95 -4
  21. package/es/src/charts/BoxWhisker/outliers.js +68 -0
  22. package/es/src/charts/BoxWhisker/summary.js +83 -0
  23. package/es/src/charts/BoxWhisker/tooltip.js +122 -0
  24. package/es/src/charts/BubbleChart/emit.js +31 -0
  25. package/es/src/charts/BubbleChart/index.js +54 -0
  26. package/es/src/charts/Bullet/index.js +2 -1
  27. package/es/src/charts/BumpChart/index.js +5 -0
  28. package/es/src/charts/Calendar/emit.js +1 -1
  29. package/es/src/charts/Calendar/index.js +5 -3
  30. package/es/src/charts/Candlestick/aggregate.js +11 -1
  31. package/es/src/charts/Candlestick/buffer.js +6 -4
  32. package/es/src/charts/Candlestick/index.js +7 -6
  33. package/es/src/charts/Chord/applyLayout.js +56 -69
  34. package/es/src/charts/Chord/emit.js +55 -24
  35. package/es/src/charts/Chord/index.js +17 -12
  36. package/es/src/charts/Chord/labels.js +105 -0
  37. package/es/src/charts/Donut/index.js +5 -11
  38. package/es/src/charts/Dumbbell/index.js +2 -4
  39. package/es/src/charts/Funnel/index.js +2 -1
  40. package/es/src/charts/Gantt/applyLayout.js +162 -0
  41. package/es/src/charts/Gantt/emit.js +142 -0
  42. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  43. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  44. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  45. package/es/src/charts/Gantt/ganttRows.js +111 -0
  46. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  47. package/es/src/charts/Gantt/index.js +219 -0
  48. package/es/src/charts/Gauge/index.js +2 -1
  49. package/es/src/charts/Geomap/applyLayout.js +90 -49
  50. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  51. package/es/src/charts/Geomap/emit.js +19 -2
  52. package/es/src/charts/Geomap/flowEmit.js +132 -0
  53. package/es/src/charts/Geomap/flowEvents.js +86 -0
  54. package/es/src/charts/Geomap/flowFields.js +91 -0
  55. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  56. package/es/src/charts/Geomap/flowLinks.js +239 -0
  57. package/es/src/charts/Geomap/geoCache.js +180 -0
  58. package/es/src/charts/Geomap/globeKeys.js +131 -0
  59. package/es/src/charts/Geomap/globeRotate.js +208 -0
  60. package/es/src/charts/Geomap/index.js +60 -19
  61. package/es/src/charts/Geomap/pointLabels.js +107 -0
  62. package/es/src/charts/Hexbin/binning.js +103 -0
  63. package/es/src/charts/Hexbin/buffer.js +33 -0
  64. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  65. package/es/src/charts/Hexbin/contours.js +48 -0
  66. package/es/src/charts/Hexbin/emit.js +142 -0
  67. package/es/src/charts/Hexbin/index.js +204 -0
  68. package/es/src/charts/Hexbin/layers.js +212 -0
  69. package/es/src/charts/Hexbin/settings.js +86 -0
  70. package/es/src/charts/Hexbin/tooltip.js +77 -0
  71. package/es/src/charts/Histogram/binData.js +31 -4
  72. package/es/src/charts/Histogram/index.js +37 -16
  73. package/es/src/charts/Histogram/labels.js +18 -0
  74. package/es/src/charts/Icicle/index.js +3 -3
  75. package/es/src/charts/LinePlot/index.js +7 -0
  76. package/es/src/charts/Marimekko/index.js +7 -4
  77. package/es/src/charts/Matrix/index.js +3 -2
  78. package/es/src/charts/Network/applyLayout.js +138 -94
  79. package/es/src/charts/Network/bundle.js +81 -0
  80. package/es/src/charts/Network/clusterLabels.js +423 -0
  81. package/es/src/charts/Network/clusters.js +290 -0
  82. package/es/src/charts/Network/emit.js +253 -70
  83. package/es/src/charts/Network/graph.js +117 -0
  84. package/es/src/charts/Network/graphFluent.js +79 -0
  85. package/es/src/charts/Network/index.js +93 -108
  86. package/es/src/charts/Network/minNodeDistance.js +64 -0
  87. package/es/src/charts/Network/polygonRows.js +44 -0
  88. package/es/src/charts/Pack/index.js +7 -2
  89. package/es/src/charts/Pie/applyLayout.js +86 -27
  90. package/es/src/charts/Pie/arcFit.js +152 -0
  91. package/es/src/charts/Pie/curvedLabels.js +134 -0
  92. package/es/src/charts/Pie/emit.js +43 -96
  93. package/es/src/charts/Pie/index.js +66 -32
  94. package/es/src/charts/Pie/labelRoom.js +154 -0
  95. package/es/src/charts/Pie/outsideLabels.js +224 -0
  96. package/es/src/charts/Pie/outsideNodes.js +267 -0
  97. package/es/src/charts/Pie/pieLabels.js +137 -0
  98. package/es/src/charts/Pie/sectorBox.js +223 -0
  99. package/es/src/charts/Pie/straightLabels.js +96 -0
  100. package/es/src/charts/Pie/straightLayout.js +215 -0
  101. package/es/src/charts/Plot/alongLegend.js +76 -0
  102. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  103. package/es/src/charts/Plot/axisHover.js +180 -0
  104. package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
  105. package/es/src/charts/Plot/axisHoverScene.js +203 -0
  106. package/es/src/charts/Plot/axisValues.js +43 -0
  107. package/es/src/charts/Plot/barHitArea.js +81 -0
  108. package/es/src/charts/Plot/barLabelFit.js +123 -0
  109. package/es/src/charts/Plot/barWidth.js +61 -13
  110. package/es/src/charts/Plot/circleLabels.js +98 -0
  111. package/es/src/charts/Plot/confidenceConfig.js +2 -2
  112. package/es/src/charts/Plot/connectGaps.js +237 -0
  113. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  114. package/es/src/charts/Plot/draw.js +14 -4
  115. package/es/src/charts/Plot/fillBetween.js +2 -1
  116. package/es/src/charts/Plot/forecastScene.js +3 -4
  117. package/es/src/charts/Plot/index.js +42 -15
  118. package/es/src/charts/Plot/labelPlacement.js +10 -2
  119. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  120. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  121. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  122. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  123. package/es/src/charts/Plot/openDomainEnds.js +2 -5
  124. package/es/src/charts/Plot/pipeline.js +71 -22
  125. package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
  126. package/es/src/charts/Plot/pipelineDomains.js +23 -6
  127. package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
  128. package/es/src/charts/Plot/pipelineScales.js +40 -8
  129. package/es/src/charts/Plot/plotFacet.js +12 -1
  130. package/es/src/charts/Plot/plotInit.js +49 -5
  131. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  132. package/es/src/charts/Plot/plotZoom.js +15 -6
  133. package/es/src/charts/Plot/referenceDomains.js +133 -0
  134. package/es/src/charts/Plot/shapeDefaults.js +14 -9
  135. package/es/src/charts/Plot/sharedHoverScene.js +50 -31
  136. package/es/src/charts/Plot/sharedTooltip.js +19 -7
  137. package/es/src/charts/Plot/stackHelpers.js +13 -1
  138. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  139. package/es/src/charts/Plot/stackShareTooltip.js +9 -4
  140. package/es/src/charts/Plot/stackThreshold.js +154 -0
  141. package/es/src/charts/Plot/trendLabels.js +183 -0
  142. package/es/src/charts/Plot/trendLines.js +1 -0
  143. package/es/src/charts/Plot/trendScene.js +6 -3
  144. package/es/src/charts/Plot/trendTooltip.js +5 -1
  145. package/es/src/charts/PolarArea/index.js +5 -4
  146. package/es/src/charts/Priestley/applyLayout.js +14 -20
  147. package/es/src/charts/Priestley/index.js +4 -34
  148. package/es/src/charts/Priestley/timeAxis.js +100 -0
  149. package/es/src/charts/Pyramid/index.js +4 -2
  150. package/es/src/charts/Radar/axisDecorations.js +49 -12
  151. package/es/src/charts/Radar/curvedLabels.js +187 -0
  152. package/es/src/charts/Radar/index.js +5 -5
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +4 -1
  155. package/es/src/charts/RadialBar/index.js +18 -10
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/index.js +6 -9
  158. package/es/src/charts/Rings/applyLayout.js +41 -24
  159. package/es/src/charts/Rings/emit.js +174 -58
  160. package/es/src/charts/Rings/index.js +65 -30
  161. package/es/src/charts/Rings/ringsGraph.js +28 -9
  162. package/es/src/charts/Rings/ringsLoops.js +73 -0
  163. package/es/src/charts/Rings/ringsParallel.js +166 -0
  164. package/es/src/charts/Sankey/applyLayout.js +116 -39
  165. package/es/src/charts/Sankey/circularLayout.js +208 -0
  166. package/es/src/charts/Sankey/circularLinks.js +301 -0
  167. package/es/src/charts/Sankey/emit.js +164 -94
  168. package/es/src/charts/Sankey/index.js +75 -77
  169. package/es/src/charts/Sankey/labels.js +80 -0
  170. package/es/src/charts/Sankey/ribbons.js +88 -0
  171. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  172. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  173. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  174. package/es/src/charts/Scatter/index.js +25 -0
  175. package/es/src/charts/SlopeChart/index.js +116 -0
  176. package/es/src/charts/SlopeChart/slope.js +95 -0
  177. package/es/src/charts/Streamgraph/index.js +51 -0
  178. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  179. package/es/src/charts/Sunburst/emit.js +74 -63
  180. package/es/src/charts/Sunburst/index.js +3 -3
  181. package/es/src/charts/Tree/index.js +2 -6
  182. package/es/src/charts/Treemap/applyLayout.js +14 -1
  183. package/es/src/charts/Treemap/emit.js +8 -2
  184. package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
  185. package/es/src/charts/Treemap/groupHeaders.js +95 -0
  186. package/es/src/charts/Treemap/index.js +17 -7
  187. package/es/src/charts/Treemap/thresholdFunction.js +11 -9
  188. package/es/src/charts/Violin/inner.js +3 -5
  189. package/es/src/charts/Waffle/index.js +4 -2
  190. package/es/src/charts/Waffle/tooltip.js +6 -2
  191. package/es/src/charts/Waterfall/index.js +4 -2
  192. package/es/src/charts/definition/makeChart.js +20 -5
  193. package/es/src/charts/drawSteps/backControl.js +17 -5
  194. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  195. package/es/src/charts/drawSteps/minimap.js +6 -5
  196. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  197. package/es/src/charts/drawSteps/saveChart.js +176 -0
  198. package/es/src/charts/drawSteps/saveControl.js +148 -0
  199. package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
  200. package/es/src/charts/drawSteps/searchControls.js +2 -1
  201. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  202. package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
  203. package/es/src/charts/drawSteps/topLeftControls.js +3 -1
  204. package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
  205. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  206. package/es/src/charts/events/click.legend.js +7 -2
  207. package/es/src/charts/events/click.shape.js +38 -2
  208. package/es/src/charts/events/mouseenter.js +9 -0
  209. package/es/src/charts/events/mousemove.legend.js +3 -0
  210. package/es/src/charts/events/mousemove.shape.js +12 -4
  211. package/es/src/charts/facet/drawFacets.js +14 -5
  212. package/es/src/charts/facet/facetConfig.js +2 -2
  213. package/es/src/charts/facet/facetData.js +2 -2
  214. package/es/src/charts/features/annotationFrame.js +179 -0
  215. package/es/src/charts/features/annotationText.js +83 -0
  216. package/es/src/charts/features/annotationTypes.js +10 -0
  217. package/es/src/charts/features/attributionFeature.js +6 -11
  218. package/es/src/charts/features/axes.js +9 -7
  219. package/es/src/charts/features/axesFinal.js +26 -4
  220. package/es/src/charts/features/axesMeasure.js +61 -6
  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/chartGeometry.js +1 -1
  224. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  225. package/es/src/charts/features/circleLabels.js +207 -0
  226. package/es/src/charts/features/colorScaleBucket.js +19 -1
  227. package/es/src/charts/features/colorScaleHover.js +70 -0
  228. package/es/src/charts/features/colorScaleValue.js +97 -0
  229. package/es/src/charts/features/curvedArrows.js +158 -0
  230. package/es/src/charts/features/edgeArrows.js +160 -4
  231. package/es/src/charts/features/edgeBundling.js +442 -0
  232. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  233. package/es/src/charts/features/ensureZoomDom.js +32 -8
  234. package/es/src/charts/features/features.js +45 -15
  235. package/es/src/charts/features/featuresColorScale.js +62 -8
  236. package/es/src/charts/features/featuresLegend.js +21 -32
  237. package/es/src/charts/features/legendKeys.js +64 -0
  238. package/es/src/charts/features/lineLabels.js +55 -46
  239. package/es/src/charts/features/linkBundle.js +19 -0
  240. package/es/src/charts/features/linkColor.js +72 -0
  241. package/es/src/charts/features/linkFields.js +86 -0
  242. package/es/src/charts/features/linkFocus.js +118 -0
  243. package/es/src/charts/features/linkInteraction.js +312 -0
  244. package/es/src/charts/features/linkKeys.js +20 -0
  245. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  246. package/es/src/charts/features/linkLabelPath.js +162 -0
  247. package/es/src/charts/features/linkLabels.js +340 -0
  248. package/es/src/charts/features/linkWidths.js +32 -0
  249. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  250. package/es/src/charts/features/pathLabels.js +50 -0
  251. package/es/src/charts/features/plotAnnotations.js +68 -17
  252. package/es/src/charts/features/plotPaint.js +42 -15
  253. package/es/src/charts/features/polyline.js +129 -0
  254. package/es/src/charts/features/referenceAnnotations.js +403 -0
  255. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  256. package/es/src/charts/features/ringLabelNodes.js +93 -0
  257. package/es/src/charts/features/ringLabels.js +222 -0
  258. package/es/src/charts/features/sceneBounds.js +26 -6
  259. package/es/src/charts/features/selfLoops.js +306 -0
  260. package/es/src/charts/features/shapeEmit.js +67 -30
  261. package/es/src/charts/features/shareKey.js +15 -0
  262. package/es/src/charts/features/sharedFields.js +15 -2
  263. package/es/src/charts/features/textHalo.js +29 -0
  264. package/es/src/charts/features/thresholdMembers.js +71 -0
  265. package/es/src/charts/helpers/densityChart.js +3 -1
  266. package/es/src/charts/helpers/valueTitle.js +6 -3
  267. package/es/src/charts/index.js +8 -0
  268. package/es/src/charts/partition/chartFields.js +6 -5
  269. package/es/src/charts/partition/hierarchy.js +2 -0
  270. package/es/src/charts/partition/interaction.js +9 -5
  271. package/es/src/charts/partition/zoom.js +7 -6
  272. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  273. package/es/src/charts/pipeline/preDrawData.js +77 -13
  274. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  275. package/es/src/charts/pipeline/vizDraw.js +40 -29
  276. package/es/src/charts/pipeline/vizPreDraw.js +29 -18
  277. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  278. package/es/src/charts/polar/config.js +2 -3
  279. package/es/src/charts/viz/Viz.js +82 -44
  280. package/es/src/charts/viz/VizBase.js +47 -19
  281. package/es/src/charts/viz/backgroundInk.js +13 -7
  282. package/es/src/charts/viz/dataPoller.js +52 -0
  283. package/es/src/charts/viz/focusRing.js +104 -0
  284. package/es/src/charts/viz/focusTargets.js +208 -0
  285. package/es/src/charts/viz/groupRow.js +35 -0
  286. package/es/src/charts/viz/history.js +74 -0
  287. package/es/src/charts/viz/interactionOpacity.js +19 -5
  288. package/es/src/charts/viz/keyboardNav.js +297 -0
  289. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  290. package/es/src/charts/viz/loaderFormat.js +114 -0
  291. package/es/src/charts/viz/missingFields.js +123 -0
  292. package/es/src/charts/viz/mountTarget.js +9 -0
  293. package/es/src/charts/viz/nearestHover.js +183 -0
  294. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  295. package/es/src/charts/viz/ordinalColor.js +14 -12
  296. package/es/src/charts/viz/pageTheme.js +83 -0
  297. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  298. package/es/src/charts/viz/pointVoronoi.js +124 -0
  299. package/es/src/charts/viz/reducedMotion.js +27 -0
  300. package/es/src/charts/viz/reportHandlerError.js +10 -0
  301. package/es/src/charts/viz/shapeClassTargets.js +18 -2
  302. package/es/src/charts/viz/simpleHover.js +2 -0
  303. package/es/src/charts/viz/vizClassName.js +31 -0
  304. package/es/src/charts/viz/vizDataPolling.js +172 -0
  305. package/es/src/charts/viz/vizDefaults.js +81 -23
  306. package/es/src/charts/viz/vizFields.js +53 -2
  307. package/es/src/charts/viz/vizRender.js +49 -28
  308. package/es/src/charts/viz/vizTheme.js +96 -0
  309. package/es/src/charts/viz/vizVisibility.js +14 -0
  310. package/es/src/components/Axis/Axis.js +34 -0
  311. package/es/src/components/Axis/AxisBottom.js +1 -0
  312. package/es/src/components/Axis/AxisLeft.js +1 -0
  313. package/es/src/components/Axis/AxisRight.js +1 -0
  314. package/es/src/components/Axis/AxisTop.js +1 -0
  315. package/es/src/components/Axis/axisBreak.js +4 -1
  316. package/es/src/components/Axis/axisDefaults.js +8 -10
  317. package/es/src/components/Axis/axisLabelAngle.js +175 -0
  318. package/es/src/components/Axis/axisLabelThinning.js +13 -4
  319. package/es/src/components/Axis/axisLayout.js +86 -19
  320. package/es/src/components/Axis/axisLayoutLabels.js +66 -13
  321. package/es/src/components/Axis/axisLayoutScale.js +10 -1
  322. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  323. package/es/src/components/Axis/axisRender.js +38 -9
  324. package/es/src/components/Axis/axisRounding.js +15 -4
  325. package/es/src/components/Axis/axisSlantWrap.js +39 -0
  326. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  327. package/es/src/components/Axis/powTicks.js +73 -0
  328. package/es/src/components/Axis/rangeBreaks.js +201 -0
  329. package/es/src/components/Axis/timeValues.js +19 -4
  330. package/es/src/components/ColorScale/ColorScale.js +42 -36
  331. package/es/src/components/ColorScale/bucketBounds.js +64 -0
  332. package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
  333. package/es/src/components/ColorScale/colorScaleRender.js +25 -1
  334. package/es/src/components/ColorScale/colorScaleScale.js +43 -24
  335. package/es/src/components/ColorScale/colorScaleType.js +26 -0
  336. package/es/src/components/Legend/Legend.js +3 -0
  337. package/es/src/components/Legend/legendConfig.js +2 -6
  338. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  339. package/es/src/components/TextBox.js +31 -65
  340. package/es/src/components/Timeline/Timeline.js +54 -54
  341. package/es/src/components/Timeline/brushSpan.js +78 -0
  342. package/es/src/components/Timeline/timelineConfig.js +27 -10
  343. package/es/src/components/Timeline/timelineMode.js +26 -0
  344. package/es/src/components/Timeline/timelineRender.js +51 -9
  345. package/es/src/components/Tooltip.js +28 -13
  346. package/es/src/components/fontStack.js +20 -0
  347. package/es/src/components/textBoxLayout.js +58 -21
  348. package/es/src/components/textBoxPath.js +73 -0
  349. package/es/src/components/textBoxScene.js +223 -0
  350. package/es/src/components/textBoxWords.js +70 -0
  351. package/es/src/shapes/Area.js +1 -0
  352. package/es/src/shapes/Bar.js +1 -0
  353. package/es/src/shapes/Box.js +67 -79
  354. package/es/src/shapes/Circle.js +1 -0
  355. package/es/src/shapes/Line.js +1 -0
  356. package/es/src/shapes/Path.js +1 -0
  357. package/es/src/shapes/Rect.js +1 -0
  358. package/es/src/shapes/Shape.js +1 -0
  359. package/es/src/shapes/Whisker.js +1 -0
  360. package/es/src/shapes/boxOutlierShape.js +19 -0
  361. package/es/src/shapes/boxStats.js +35 -0
  362. package/es/src/shapes/boxStyle.js +78 -0
  363. package/es/src/shapes/boxSummary.js +174 -0
  364. package/es/src/shapes/shapeStandalone.js +2 -0
  365. package/es/src/utils/BaseClass.js +44 -12
  366. package/es/src/utils/className.js +78 -0
  367. package/es/src/utils/configPrep.js +2 -1
  368. package/es/src/utils/configWarnings.js +25 -0
  369. package/es/src/utils/constant.js +13 -1
  370. package/es/src/utils/displayName.js +12 -0
  371. package/es/src/utils/fieldAccessor.js +31 -0
  372. package/es/src/utils/paintComponentScene.js +2 -0
  373. package/es/src/utils/theme.js +190 -0
  374. package/es/src/utils/themeInk.js +68 -0
  375. package/package.json +14 -10
  376. package/types/index.d.ts +8 -2
  377. package/types/internal.d.ts +253 -9
  378. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  379. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  380. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  381. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  382. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  383. package/types/src/charts/Alluvial/index.d.ts +27 -0
  384. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  385. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  386. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  387. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  388. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  389. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  390. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  391. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  392. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  393. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  394. package/types/src/charts/BoxWhisker/index.d.ts +3 -1
  395. package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
  396. package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
  397. package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
  398. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  399. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  400. package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
  401. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  402. package/types/src/charts/Chord/labels.d.ts +66 -0
  403. package/types/src/charts/Donut/index.d.ts +2 -1
  404. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  405. package/types/src/charts/Gantt/emit.d.ts +17 -0
  406. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  407. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  408. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  409. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  410. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  411. package/types/src/charts/Gantt/index.d.ts +36 -0
  412. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  413. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  414. package/types/src/charts/Geomap/emit.d.ts +2 -2
  415. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  416. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  417. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  418. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  419. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  420. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  421. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  422. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  423. package/types/src/charts/Geomap/index.d.ts +3 -0
  424. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  425. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  426. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  427. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  428. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  429. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  430. package/types/src/charts/Hexbin/index.d.ts +25 -0
  431. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  432. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  433. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  434. package/types/src/charts/Histogram/binData.d.ts +20 -1
  435. package/types/src/charts/Histogram/index.d.ts +3 -2
  436. package/types/src/charts/Histogram/labels.d.ts +7 -0
  437. package/types/src/charts/Marimekko/index.d.ts +2 -1
  438. package/types/src/charts/Network/bundle.d.ts +67 -0
  439. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  440. package/types/src/charts/Network/clusters.d.ts +115 -0
  441. package/types/src/charts/Network/graph.d.ts +65 -0
  442. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  443. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  444. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  445. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  446. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  447. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  448. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  449. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  450. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  451. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  452. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  453. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  454. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  455. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  456. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  457. package/types/src/charts/Plot/axisHover.d.ts +68 -0
  458. package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
  459. package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
  460. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  461. package/types/src/charts/Plot/barHitArea.d.ts +59 -0
  462. package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
  463. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  464. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  465. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  466. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  467. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  468. package/types/src/charts/Plot/index.d.ts +28 -8
  469. package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
  470. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  471. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  472. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  473. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  474. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  475. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  476. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  477. package/types/src/charts/Plot/plotInit.d.ts +23 -2
  478. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  479. package/types/src/charts/Plot/plotZoom.d.ts +2 -0
  480. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  481. package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
  482. package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
  483. package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
  484. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  485. package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
  486. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  487. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  488. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  489. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  490. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  491. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  492. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  493. package/types/src/charts/Rings/emit.d.ts +50 -0
  494. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  495. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  496. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  497. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  498. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  499. package/types/src/charts/Sankey/emit.d.ts +58 -0
  500. package/types/src/charts/Sankey/labels.d.ts +19 -0
  501. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  502. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  503. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  504. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  505. package/types/src/charts/Scatter/index.d.ts +15 -0
  506. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  507. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  508. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  509. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  510. package/types/src/charts/Treemap/emit.d.ts +2 -1
  511. package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
  512. package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
  513. package/types/src/charts/Treemap/index.d.ts +2 -0
  514. package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
  515. package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
  516. package/types/src/charts/definition/makeChart.d.ts +5 -3
  517. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  518. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  519. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  520. package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
  521. package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
  522. package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
  523. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
  524. package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
  525. package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
  526. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  527. package/types/src/charts/events/click.legend.d.ts +2 -1
  528. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  529. package/types/src/charts/facet/facetData.d.ts +1 -1
  530. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  531. package/types/src/charts/features/annotationText.d.ts +57 -0
  532. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  533. package/types/src/charts/features/axesMeasure.d.ts +13 -1
  534. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  535. package/types/src/charts/features/calloutScene.d.ts +40 -0
  536. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  537. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  538. package/types/src/charts/features/circleLabels.d.ts +130 -0
  539. package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
  540. package/types/src/charts/features/colorScaleHover.d.ts +32 -0
  541. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  542. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  543. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  544. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  545. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  546. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  547. package/types/src/charts/features/features.d.ts +8 -0
  548. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  549. package/types/src/charts/features/legendKeys.d.ts +34 -0
  550. package/types/src/charts/features/lineLabels.d.ts +15 -12
  551. package/types/src/charts/features/linkBundle.d.ts +16 -0
  552. package/types/src/charts/features/linkColor.d.ts +48 -0
  553. package/types/src/charts/features/linkFields.d.ts +16 -0
  554. package/types/src/charts/features/linkFocus.d.ts +51 -0
  555. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  556. package/types/src/charts/features/linkKeys.d.ts +11 -0
  557. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  558. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  559. package/types/src/charts/features/linkLabels.d.ts +77 -0
  560. package/types/src/charts/features/linkWidths.d.ts +19 -0
  561. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  562. package/types/src/charts/features/pathLabels.d.ts +41 -0
  563. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  564. package/types/src/charts/features/plotPaint.d.ts +19 -0
  565. package/types/src/charts/features/polyline.d.ts +32 -0
  566. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  567. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  568. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  569. package/types/src/charts/features/ringLabels.d.ts +164 -0
  570. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  571. package/types/src/charts/features/selfLoops.d.ts +165 -0
  572. package/types/src/charts/features/shapeEmit.d.ts +5 -1
  573. package/types/src/charts/features/shareKey.d.ts +9 -0
  574. package/types/src/charts/features/sharedFields.d.ts +11 -2
  575. package/types/src/charts/features/textHalo.d.ts +14 -0
  576. package/types/src/charts/features/thresholdMembers.d.ts +38 -0
  577. package/types/src/charts/helpers/valueTitle.d.ts +4 -2
  578. package/types/src/charts/index.d.ts +8 -0
  579. package/types/src/charts/partition/interaction.d.ts +6 -3
  580. package/types/src/charts/partition/zoom.d.ts +4 -4
  581. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  582. package/types/src/charts/pipeline/stages.d.ts +9 -0
  583. package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
  584. package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
  585. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  586. package/types/src/charts/viz/Viz.d.ts +44 -6
  587. package/types/src/charts/viz/VizBase.d.ts +16 -7
  588. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  589. package/types/src/charts/viz/dataPoller.d.ts +28 -0
  590. package/types/src/charts/viz/focusRing.d.ts +25 -0
  591. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  592. package/types/src/charts/viz/groupRow.d.ts +24 -0
  593. package/types/src/charts/viz/history.d.ts +35 -0
  594. package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
  595. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  596. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  597. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  598. package/types/src/charts/viz/missingFields.d.ts +57 -0
  599. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  600. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  601. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  602. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  603. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  604. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  605. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  606. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  607. package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
  608. package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
  609. package/types/src/charts/viz/simpleHover.d.ts +2 -1
  610. package/types/src/charts/viz/vizClassName.d.ts +23 -0
  611. package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
  612. package/types/src/charts/viz/vizDefaults.d.ts +49 -9
  613. package/types/src/charts/viz/vizFields.d.ts +47 -0
  614. package/types/src/charts/viz/vizRender.d.ts +2 -1
  615. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  616. package/types/src/charts/viz/vizTypes.d.ts +117 -8
  617. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  618. package/types/src/components/Axis/Axis.d.ts +37 -8
  619. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  620. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  621. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  622. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  623. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  624. package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
  625. package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
  626. package/types/src/components/Axis/axisLayout.d.ts +5 -0
  627. package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
  628. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  629. package/types/src/components/Axis/axisRounding.d.ts +6 -3
  630. package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
  631. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  632. package/types/src/components/Axis/powTicks.d.ts +29 -0
  633. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  634. package/types/src/components/Axis/timeValues.d.ts +1 -1
  635. package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
  636. package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
  637. package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
  638. package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
  639. package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
  640. package/types/src/components/Legend/Legend.d.ts +1 -0
  641. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  642. package/types/src/components/TextBox.d.ts +1 -0
  643. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  644. package/types/src/components/Timeline/brushSpan.d.ts +41 -0
  645. package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
  646. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  647. package/types/src/components/Timeline/timelineRender.d.ts +8 -0
  648. package/types/src/components/Tooltip.d.ts +12 -3
  649. package/types/src/components/fontStack.d.ts +10 -0
  650. package/types/src/components/textBoxLayout.d.ts +18 -9
  651. package/types/src/components/textBoxPath.d.ts +59 -0
  652. package/types/src/components/textBoxScene.d.ts +51 -0
  653. package/types/src/components/textBoxWords.d.ts +33 -0
  654. package/types/src/shapes/Area.d.ts +1 -0
  655. package/types/src/shapes/Bar.d.ts +1 -0
  656. package/types/src/shapes/Box.d.ts +2 -8
  657. package/types/src/shapes/Circle.d.ts +1 -0
  658. package/types/src/shapes/Line.d.ts +1 -0
  659. package/types/src/shapes/Path.d.ts +1 -0
  660. package/types/src/shapes/Rect.d.ts +1 -0
  661. package/types/src/shapes/Shape.d.ts +1 -0
  662. package/types/src/shapes/Whisker.d.ts +1 -0
  663. package/types/src/shapes/boxOutlierShape.d.ts +9 -0
  664. package/types/src/shapes/boxStats.d.ts +19 -0
  665. package/types/src/shapes/boxStyle.d.ts +25 -0
  666. package/types/src/shapes/boxSummary.d.ts +66 -0
  667. package/types/src/shapes/emitLabels.d.ts +1 -1
  668. package/types/src/shapes/shapeConfig.d.ts +42 -4
  669. package/types/src/utils/BaseClass.d.ts +32 -0
  670. package/types/src/utils/D3Scale.d.ts +3 -0
  671. package/types/src/utils/D3plusConfig.d.ts +1240 -33
  672. package/types/src/utils/className.d.ts +64 -0
  673. package/types/src/utils/configPrep.d.ts +2 -0
  674. package/types/src/utils/configWarnings.d.ts +21 -2
  675. package/types/src/utils/constant.d.ts +8 -0
  676. package/types/src/utils/displayName.d.ts +10 -0
  677. package/types/src/utils/fieldAccessor.d.ts +24 -0
  678. package/types/src/utils/index.d.ts +1 -1
  679. package/types/src/utils/paintComponentScene.d.ts +3 -1
  680. package/types/src/utils/theme.d.ts +170 -0
  681. package/types/src/utils/themeInk.d.ts +56 -0
  682. package/umd/d3plus-core.full.js +87388 -56271
  683. package/umd/d3plus-core.full.min.js +2 -2
  684. package/umd/d3plus-core.js +37988 -11768
  685. package/umd/d3plus-core.min.js +2 -2
  686. package/es/src/components/Axis/gridStroke.js +0 -10
  687. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -0,0 +1,297 @@
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
+ */ import { pointVoronoi } from "../viz/pointVoronoi.js";
9
+ /** The sides in their default order, with each one's direction (y down). */ const SIDES = [
10
+ [
11
+ "right",
12
+ 1,
13
+ 0
14
+ ],
15
+ [
16
+ "left",
17
+ -1,
18
+ 0
19
+ ],
20
+ [
21
+ "top",
22
+ 0,
23
+ -1
24
+ ],
25
+ [
26
+ "bottom",
27
+ 0,
28
+ 1
29
+ ],
30
+ [
31
+ "top-right",
32
+ Math.SQRT1_2,
33
+ -Math.SQRT1_2
34
+ ],
35
+ [
36
+ "top-left",
37
+ -Math.SQRT1_2,
38
+ -Math.SQRT1_2
39
+ ],
40
+ [
41
+ "bottom-right",
42
+ Math.SQRT1_2,
43
+ Math.SQRT1_2
44
+ ],
45
+ [
46
+ "bottom-left",
47
+ -Math.SQRT1_2,
48
+ Math.SQRT1_2
49
+ ]
50
+ ];
51
+ /** Degrees added to a diagonal side's angle when ranking sides: straight sides read better. */ const DIAGONAL_PENALTY = 20;
52
+ /** Rounding slack for overlap and containment tests. */ const EPSILON = 1e-6;
53
+ /**
54
+ The box a `width` × `height` label takes on one side of a circle, `gap`
55
+ pixels clear of its edge: centered on the circle's axis for a straight
56
+ side, with its nearest corner on the circle's diagonal for a diagonal one.
57
+ */ export function sideBox(circle, side, width, height, gap = 0) {
58
+ const d = circle.r + gap;
59
+ const { x, y } = circle;
60
+ switch(side){
61
+ case "right":
62
+ return {
63
+ x: x + d,
64
+ y: y - height / 2,
65
+ width,
66
+ height
67
+ };
68
+ case "left":
69
+ return {
70
+ x: x - d - width,
71
+ y: y - height / 2,
72
+ width,
73
+ height
74
+ };
75
+ case "top":
76
+ return {
77
+ x: x - width / 2,
78
+ y: y - d - height,
79
+ width,
80
+ height
81
+ };
82
+ case "bottom":
83
+ return {
84
+ x: x - width / 2,
85
+ y: y + d,
86
+ width,
87
+ height
88
+ };
89
+ }
90
+ const o = d * Math.SQRT1_2;
91
+ const right = side.endsWith("right");
92
+ const top = side.startsWith("top");
93
+ return {
94
+ x: right ? x + o : x - o - width,
95
+ y: top ? y - o - height : y + o,
96
+ width,
97
+ height
98
+ };
99
+ }
100
+ /** The signed area of a ring (positive when its vertices run clockwise in y-down space). */ function ringArea(ring) {
101
+ let a = 0;
102
+ for(let i = 0, j = ring.length - 1; i < ring.length; j = i++)a += ring[j][0] * ring[i][1] - ring[i][0] * ring[j][1];
103
+ return a / 2;
104
+ }
105
+ /** A ring's centroid, or null when it has no area. */ export function ringCentroid(ring) {
106
+ const area = ringArea(ring);
107
+ if (Math.abs(area) < EPSILON) return null;
108
+ let cx = 0, cy = 0;
109
+ for(let i = 0, j = ring.length - 1; i < ring.length; j = i++){
110
+ const f = ring[j][0] * ring[i][1] - ring[i][0] * ring[j][1];
111
+ cx += (ring[j][0] + ring[i][0]) * f;
112
+ cy += (ring[j][1] + ring[i][1]) * f;
113
+ }
114
+ return [
115
+ cx / (6 * area),
116
+ cy / (6 * area)
117
+ ];
118
+ }
119
+ /**
120
+ The sides of a circle, most open first: ordered by how closely each
121
+ points toward the centroid of the circle's Voronoi cell (diagonals
122
+ slightly discounted), or in the default order (right, left, top, bottom,
123
+ then the diagonals) when the centroid is too close to the center to point
124
+ anywhere, which is the case for an evenly surrounded circle.
125
+ @param circle The circle.
126
+ @param cell Its Voronoi cell, or null.
127
+ */ export function sideOrder(circle, cell) {
128
+ const base = SIDES.map((s)=>s[0]);
129
+ const centroid = cell ? ringCentroid(cell) : null;
130
+ if (!centroid || !cell) return base;
131
+ const dx = centroid[0] - circle.x, dy = centroid[1] - circle.y;
132
+ const reach = Math.sqrt(Math.abs(ringArea(cell)));
133
+ if (Math.hypot(dx, dy) < reach * 0.1) return base;
134
+ const toward = Math.atan2(dy, dx);
135
+ const score = ([, sx, sy])=>{
136
+ let diff = Math.abs(Math.atan2(sy, sx) - toward);
137
+ if (diff > Math.PI) diff = 2 * Math.PI - diff;
138
+ const degrees = diff * 180 / Math.PI;
139
+ return degrees + (sx && sy ? DIAGONAL_PENALTY : 0);
140
+ };
141
+ return SIDES.map((s, i)=>({
142
+ side: s[0],
143
+ score: score(s),
144
+ i
145
+ })).sort((a, b)=>a.score - b.score || a.i - b.i).map((s)=>s.side);
146
+ }
147
+ /** Clips a ring to one half-plane of a box edge (Sutherland–Hodgman). */ function clipEdge(ring, inside, cross) {
148
+ const out = [];
149
+ for(let i = 0; i < ring.length; i++){
150
+ const cur = ring[i], prev = ring[(i + ring.length - 1) % ring.length];
151
+ if (inside(cur)) {
152
+ if (!inside(prev)) out.push(cross(prev, cur));
153
+ out.push(cur);
154
+ } else if (inside(prev)) out.push(cross(prev, cur));
155
+ }
156
+ return out;
157
+ }
158
+ /** Where the segment `a`–`b` crosses the vertical line at `x`. */ const atX = (a, b, x)=>[
159
+ x,
160
+ a[1] + (b[1] - a[1]) * (x - a[0]) / (b[0] - a[0])
161
+ ];
162
+ /** Where the segment `a`–`b` crosses the horizontal line at `y`. */ const atY = (a, b, y)=>[
163
+ a[0] + (b[0] - a[0]) * (y - a[1]) / (b[1] - a[1]),
164
+ y
165
+ ];
166
+ /** The share (0–1) of a box's area that lies inside a ring. */ export function boxCoverage(box, ring) {
167
+ const area = box.width * box.height;
168
+ if (!(area > 0) || ring.length < 3) return 0;
169
+ const x1 = box.x + box.width, y1 = box.y + box.height;
170
+ let r = clipEdge(ring, (p)=>p[0] >= box.x, (a, b)=>atX(a, b, box.x));
171
+ r = clipEdge(r, (p)=>p[0] <= x1, (a, b)=>atX(a, b, x1));
172
+ r = clipEdge(r, (p)=>p[1] >= box.y, (a, b)=>atY(a, b, box.y));
173
+ r = clipEdge(r, (p)=>p[1] <= y1, (a, b)=>atY(a, b, y1));
174
+ return r.length < 3 ? 0 : Math.min(1, Math.abs(ringArea(r)) / area);
175
+ }
176
+ /** Whether a box overlaps a circle's interior. */ export function boxHitsCircle(box, circle) {
177
+ const dx = Math.max(box.x - circle.x, 0, circle.x - (box.x + box.width));
178
+ const dy = Math.max(box.y - circle.y, 0, circle.y - (box.y + box.height));
179
+ return dx * dx + dy * dy < circle.r * circle.r - EPSILON;
180
+ }
181
+ /** Whether two boxes overlap (touching edges don't count). */ export function boxesOverlap(a, b) {
182
+ return a.x < b.x + b.width - EPSILON && b.x < a.x + a.width - EPSILON && a.y < b.y + b.height - EPSILON && b.y < a.y + a.height - EPSILON;
183
+ }
184
+ /** Whether a box lies inside the bounds. */ function inBounds(box, bounds) {
185
+ return box.x >= bounds.x - EPSILON && box.y >= bounds.y - EPSILON && box.x + box.width <= bounds.x + bounds.width + EPSILON && box.y + box.height <= bounds.y + bounds.height + EPSILON;
186
+ }
187
+ /** A uniform grid of buckets, so overlap tests only look at nearby items. */ class BoxGrid {
188
+ size;
189
+ cells = new Map();
190
+ constructor(size){
191
+ this.size = size;
192
+ }
193
+ keys(box) {
194
+ const s = this.size;
195
+ const out = [];
196
+ for(let i = Math.floor(box.x / s); i <= Math.floor((box.x + box.width) / s); i++)for(let j = Math.floor(box.y / s); j <= Math.floor((box.y + box.height) / s); j++)out.push(`${i},${j}`);
197
+ return out;
198
+ }
199
+ add(box, item) {
200
+ for (const k of this.keys(box)){
201
+ const list = this.cells.get(k);
202
+ if (list) list.push(item);
203
+ else this.cells.set(k, [
204
+ item
205
+ ]);
206
+ }
207
+ }
208
+ near(box) {
209
+ const out = new Set();
210
+ for (const k of this.keys(box))for (const item of this.cells.get(k) ?? [])out.add(item);
211
+ return out;
212
+ }
213
+ }
214
+ /** A circle's bounding box. */ const circleBox = (c)=>({
215
+ x: c.x - c.r,
216
+ y: c.y - c.r,
217
+ width: c.r * 2,
218
+ height: c.r * 2
219
+ });
220
+ /**
221
+ Places circle labels. A label in `"inside"` mode stays inside its circle;
222
+ in `"auto"` mode it stays inside when `fitsInside`, and otherwise (or in
223
+ `"outside"` mode) it takes the first side of its circle, most open first
224
+ (see `sideOrder`), where it lies mostly in the circle's Voronoi cell, stays
225
+ in `bounds`, and overlaps no circle and no label placed before it. A label
226
+ with no such side, or whose circle is centered outside `bounds`, is
227
+ hidden. Labels are placed largest circle first
228
+ (ties in input order), so big circles win the room; the result is in
229
+ input order and depends only on the input.
230
+ @param circles Every circle, labeled or not: each is an obstacle.
231
+ @param labels The labels to place.
232
+ @param bounds The box labels must stay in.
233
+ */ export function placeCircleLabels(circles, labels, bounds, options = {}) {
234
+ const gap = options.gap ?? 3;
235
+ const coverage = options.cellCoverage ?? 0.5;
236
+ const result = labels.map(()=>({
237
+ position: "hidden"
238
+ }));
239
+ const valid = (c)=>!!c && [
240
+ c.x,
241
+ c.y,
242
+ c.r
243
+ ].every(Number.isFinite);
244
+ const outside = [];
245
+ labels.forEach((label, i)=>{
246
+ if (!valid(circles[label.circle])) return;
247
+ if (label.position === "inside" || label.position !== "outside" && label.fitsInside) result[i] = {
248
+ position: "inside"
249
+ };
250
+ else if (label.width > 0 && label.height > 0) outside.push(i);
251
+ });
252
+ if (!outside.length) return result;
253
+ const voronoi = pointVoronoi(circles.map((c, i)=>({
254
+ x: c.x,
255
+ y: c.y,
256
+ r: c.r,
257
+ item: i
258
+ })), bounds);
259
+ const sizes = outside.map((i)=>Math.max(labels[i].width, labels[i].height));
260
+ const grid = new BoxGrid(Math.max(16, sizes.reduce((a, b)=>a + b, 0) / sizes.length));
261
+ circles.forEach((c, i)=>{
262
+ if (valid(c)) grid.add(circleBox(c), i);
263
+ });
264
+ const placed = new BoxGrid(grid.size);
265
+ outside.sort((a, b)=>circles[labels[b].circle].r - circles[labels[a].circle].r || a - b);
266
+ for (const i of outside){
267
+ const label = labels[i];
268
+ const circle = circles[label.circle];
269
+ const cell = voronoi.cell(label.circle);
270
+ // A circle centered outside the bounds (scrolled off by a zoom) is cut
271
+ // off there, so a label beside it would name nothing in view.
272
+ if (!cell || !inBounds({
273
+ ...circle,
274
+ width: 0,
275
+ height: 0
276
+ }, bounds)) continue;
277
+ for (const side of sideOrder(circle, cell)){
278
+ const box = sideBox(circle, side, label.width, label.height, gap);
279
+ if (!inBounds(box, bounds)) continue;
280
+ if ([
281
+ ...grid.near(box)
282
+ ].some((c)=>boxHitsCircle(box, circles[c]))) continue;
283
+ if ([
284
+ ...placed.near(box)
285
+ ].some((b)=>boxesOverlap(box, b))) continue;
286
+ if (boxCoverage(box, cell) < coverage - EPSILON) continue;
287
+ result[i] = {
288
+ position: "outside",
289
+ side,
290
+ box
291
+ };
292
+ placed.add(box, box);
293
+ break;
294
+ }
295
+ }
296
+ return result;
297
+ }
@@ -0,0 +1,207 @@
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
+ */ import { fontExists, parseSides, rtl, textWidth } from "@d3plus/dom";
9
+ import { fontFamily as defaultFontFamily, textWrap } from "@d3plus/text";
10
+ import { emitLabels } from "../../shapes/emitLabels.js";
11
+ import constant from "../../utils/constant.js";
12
+ import { backgroundInk } from "../viz/backgroundInk.js";
13
+ import { placeCircleLabels } from "./circleLabelPlacement.js";
14
+ /** The resolved CSS font family, as TextBox renders it. */ const familyOf = (family)=>fontExists(family ?? defaultFontFamily);
15
+ /**
16
+ Whether `text` fits inside a box at `font.size`, wrapped the way a label
17
+ TextBox wraps it, without being cut short.
18
+ @param text The label text.
19
+ @param box The box, with its wrapping shape and padding.
20
+ @param font The font, at the smallest size that counts as fitting.
21
+ */ export function labelFitsInside(text, box, font) {
22
+ const pad = parseSides(box.padding ?? 0);
23
+ const width = box.width - pad.left - pad.right;
24
+ const height = box.height - pad.top - pad.bottom;
25
+ const lineHeight = font.lineHeight ?? font.size * 1.2;
26
+ if (!text || width <= font.size || height < lineHeight) return false;
27
+ const wrapped = textWrap().fontFamily(familyOf(font.family)).fontSize(font.size).fontWeight(font.weight ?? 400).lineHeight(lineHeight).shape(box.shape ?? "square").width(width).height(height)(text);
28
+ return !wrapped.truncated && wrapped.lines.some((l)=>l !== "");
29
+ }
30
+ /**
31
+ The box a one-line label takes: its measured width, plus a pixel of slack
32
+ on each side so the TextBox drawing it never wraps it, by a line's height
33
+ plus a pixel.
34
+ */ export function measureLabel(text, font) {
35
+ const width = textWidth(text, {
36
+ "font-family": familyOf(font.family),
37
+ "font-size": font.size,
38
+ "font-weight": font.weight ?? 400
39
+ });
40
+ const lineHeight = font.lineHeight ?? font.size * 1.2;
41
+ return {
42
+ width: Math.ceil(width) + 2,
43
+ height: Math.ceil(lineHeight) + 1
44
+ };
45
+ }
46
+ /** Reads `pointLabelConfig`: numbers for fontMin/fontSize/padding, the rest as TextBox config. */ export function pointLabelSettings(viz) {
47
+ const cfg = viz.schema.pointLabelConfig ?? {};
48
+ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fallback;
49
+ const { fontMin, fontSize, padding, ...text } = cfg;
50
+ return {
51
+ fontMin: num(fontMin, 10),
52
+ fontSize: num(fontSize, 11),
53
+ padding: num(padding, 3),
54
+ text
55
+ };
56
+ }
57
+ /** A row's `labelPosition`, with anything unrecognized read as `"auto"`. */ export function labelPositionOf(viz, d, i) {
58
+ const fn = viz.schema.labelPosition;
59
+ const value = typeof fn === "function" ? fn(d, i) : fn;
60
+ return value === "inside" || value === "outside" ? value : "auto";
61
+ }
62
+ /**
63
+ Places every labeled circle's label (see `placeCircleLabels`), reading
64
+ each row's `labelPosition` and the chart's `pointLabelConfig`. An
65
+ `"auto"` label counts as fitting inside when it fits at
66
+ `pointLabelConfig.fontMin`.
67
+ @param viz The chart.
68
+ @param items Every circle, labeled or not.
69
+ @param bounds The box labels must stay in, in the circles' space.
70
+ */ export function layoutCircleLabels(viz, items, bounds) {
71
+ const settings = pointLabelSettings(viz);
72
+ const font = outsideFont(settings);
73
+ const labeled = [];
74
+ items.forEach((item, at)=>{
75
+ const t = item.text;
76
+ if (typeof t === "string" && t.trim() || typeof t === "number") labeled.push({
77
+ item,
78
+ at,
79
+ text: `${t}`.trim()
80
+ });
81
+ });
82
+ const requests = labeled.map(({ item, at, text })=>{
83
+ const mode = labelPositionOf(viz, item.datum, item.index);
84
+ const inside = item.inside ?? {
85
+ width: item.r * 2,
86
+ height: item.r * 2
87
+ };
88
+ const fitsInside = mode === "auto" && labelFitsInside(text, inside, {
89
+ ...inside.font,
90
+ size: settings.fontMin
91
+ });
92
+ // Only a label that may go beside its circle needs measuring.
93
+ const size = mode === "inside" || fitsInside ? {
94
+ width: 0,
95
+ height: 0
96
+ } : measureLabel(text, resolveFont(font, item));
97
+ return {
98
+ circle: at,
99
+ ...size,
100
+ position: mode,
101
+ fitsInside
102
+ };
103
+ });
104
+ const placements = placeCircleLabels(items.map(({ x, y, r })=>({
105
+ x,
106
+ y,
107
+ r: Number.isFinite(r) ? r : 0
108
+ })), requests, bounds, {
109
+ gap: settings.padding
110
+ });
111
+ const out = new Map();
112
+ labeled.forEach(({ item, text }, j)=>out.set(item.key, {
113
+ ...placements[j],
114
+ mode: requests[j].position,
115
+ text
116
+ }));
117
+ return out;
118
+ }
119
+ /** The font a label beside its circle is drawn in, as accessors of the row. */ function outsideFont(settings) {
120
+ const { fontFamily, fontWeight } = settings.text;
121
+ return {
122
+ size: settings.fontSize,
123
+ family: fontFamily,
124
+ weight: fontWeight
125
+ };
126
+ }
127
+ /** Resolves the outside font's accessors for one row. */ function resolveFont(font, item) {
128
+ const at = (v)=>typeof v === "function" ? v(item.datum, item.index) : v;
129
+ return {
130
+ size: font.size,
131
+ family: at(font.family),
132
+ weight: at(font.weight)
133
+ };
134
+ }
135
+ /** The text anchor that keeps a label flush against its circle. */ export function sideAnchor(side) {
136
+ const anchor = side.endsWith("right") ? "start" : side.endsWith("left") ? "end" : "middle";
137
+ // Right to left, TextBox reads "start" as the box's right edge.
138
+ if (anchor !== "middle" && rtl()) return anchor === "start" ? "end" : "start";
139
+ return anchor;
140
+ }
141
+ /**
142
+ Text nodes for labels placed beside their circles: one line each, in the
143
+ chart's ink (`backgroundInk`) at `pointLabelConfig.fontSize`, flush
144
+ against the circle, and inert to the pointer.
145
+ @param viz The chart.
146
+ @param labels The labels, each with its placed box.
147
+ @param config TextBox config layered under `pointLabelConfig` (such as a
148
+ `fontOpacity` that follows the shapes).
149
+ */ export function emitOutsideLabels(viz, labels, config = {}) {
150
+ if (!labels.length) return [];
151
+ const settings = pointLabelSettings(viz);
152
+ const byId = new Map(labels.map((l)=>[
153
+ `${l.id}_0`,
154
+ l
155
+ ]));
156
+ const sideOf = (rec)=>byId.get(String(rec.id))?.side ?? "right";
157
+ const lineHeight = settings.fontSize * 1.2;
158
+ return emitLabels({
159
+ data: labels,
160
+ label: (d)=>d.text,
161
+ labelBounds: (d)=>({
162
+ ...d.box
163
+ }),
164
+ x: constant(0),
165
+ y: constant(0),
166
+ aes: constant({}),
167
+ rotate: constant(0),
168
+ id: (d)=>d.id,
169
+ datum: (d)=>d.datum,
170
+ labelConfig: {
171
+ fontColor: ()=>backgroundInk(viz),
172
+ ...config,
173
+ fontResize: false,
174
+ fontSize: settings.fontSize,
175
+ lineHeight,
176
+ padding: 0,
177
+ pointerEvents: "none",
178
+ textAnchor: (rec)=>sideAnchor(sideOf(rec)),
179
+ verticalAlign: "middle",
180
+ ...settings.text
181
+ }
182
+ });
183
+ }
184
+ /**
185
+ Splits laid-out labels into the ones drawn beside their circles, with the
186
+ id and scene datum each takes.
187
+ */ export function outsideLabels(layout, describe) {
188
+ const out = [];
189
+ for (const [key, placed] of layout){
190
+ if (placed.position !== "outside") continue;
191
+ out.push({
192
+ ...describe(key),
193
+ text: placed.text,
194
+ side: placed.side,
195
+ box: placed.box
196
+ });
197
+ }
198
+ return out;
199
+ }
200
+ /**
201
+ The font size floor of an inside label: `pointLabelConfig.fontMin` when it
202
+ was placed in `"auto"` mode (so it never shrinks below the size it was
203
+ judged to fit at), else its own.
204
+ */ export function insideFontMin(viz, placed, own) {
205
+ if (!placed || placed.mode !== "auto" || placed.position !== "inside") return own;
206
+ return Math.max(own, pointLabelSettings(viz).fontMin);
207
+ }
@@ -1,10 +1,11 @@
1
+ import { colorScaleValue } from "./colorScaleValue.js";
1
2
  /**
2
3
  Resolves the colorScale's data + a value→bucket-color mapper from a viz, or
3
4
  null when there's no usable colorScale. Shared by the share and hover
4
5
  helpers so they bucket data identically.
5
6
  */ function bucketCtx(viz) {
6
7
  const cs = viz._colorScaleClass;
7
- const value = viz.schema.colorScale;
8
+ const value = colorScaleValue(viz);
8
9
  if (!cs || typeof cs._colorScale !== "function" || !value) return null;
9
10
  const colorScale = cs._colorScale;
10
11
  const colorOf = (d, i)=>{
@@ -86,3 +87,20 @@
86
87
  });
87
88
  return colors;
88
89
  }
90
+ /**
91
+ The first of the colorScale's rows in each bucket, keyed by bucket color,
92
+ with its index: the row a bucket's swatch takes the chart's shape styles
93
+ from. Null without a colorScale to read.
94
+ */ export function colorScaleBucketRows(viz) {
95
+ const ctx = bucketCtx(viz);
96
+ if (!ctx) return null;
97
+ const rows = new Map();
98
+ ctx.rows.forEach((row, i)=>{
99
+ const color = ctx.colorOf(row, i);
100
+ if (!rows.has(color)) rows.set(color, {
101
+ row,
102
+ i
103
+ });
104
+ });
105
+ return rows;
106
+ }
@@ -0,0 +1,70 @@
1
+ /**
2
+ Drives the colorScale's hover mark (#770): hovering a chart shape marks
3
+ its colorScale value on the colorScale (see `ColorScale.hover`), and
4
+ leaving it, or hovering anything else, clears the mark.
5
+ */ import { colorScaleBucketOf } from "./colorScaleBucket.js";
6
+ import { colorScaleValue } from "./colorScaleValue.js";
7
+ /**
8
+ The colorScale value of a hovered scene node: its datum unwrapped to the
9
+ source row (as the shapes' fill unwraps it), read through the chart's
10
+ `colorScale`. Null for chrome (legend, axes, the colorScale itself), a
11
+ node without a row, or a row without a finite value.
12
+ @param viz The chart.
13
+ @param node The hovered scene node.
14
+ */ export function colorScaleHoverValue(viz, node) {
15
+ const colorScale = colorScaleValue(viz);
16
+ if (!node || typeof colorScale !== "function") return null;
17
+ if (node.interactionGroup) return null;
18
+ if (colorScaleBucketOf(node.datum)) return null;
19
+ let d = node.datum;
20
+ let i = typeof node.index === "number" ? node.index : 0;
21
+ while(d && d.__d3plus__ && d.data){
22
+ d = d.data;
23
+ if (typeof d.i === "number") i = d.i;
24
+ }
25
+ if (!d || typeof d !== "object") return null;
26
+ const value = colorScale(d, i);
27
+ if (value === null || value === undefined || value === "") return null;
28
+ if (typeof value !== "number" && typeof value !== "string") return null;
29
+ const n = +value;
30
+ return Number.isFinite(n) ? n : null;
31
+ }
32
+ /**
33
+ Updates the colorScale's hover mark for a pointer event, repainting only
34
+ when the marked value changes. Moves are ignored while a transition is
35
+ in flight; leaving the chart always clears the mark.
36
+ @param viz The chart.
37
+ @param event The pointer event.
38
+ */ export function handleColorScaleHover(viz, event) {
39
+ const cs = viz._colorScaleClass;
40
+ if (!cs || !colorScaleValue(viz)) return;
41
+ let next = false;
42
+ if (event.type === "mousemove" || event.type === "mouseenter") {
43
+ if (viz._transitionEndsAt && Date.now() < viz._transitionEndsAt) return;
44
+ if (cs.hoverMark() === false) return;
45
+ next = colorScaleHoverValue(viz, event.pick?.node) ?? false;
46
+ } else if (event.type !== "mouseleave") return;
47
+ if ((cs.hover() ?? false) === next) return;
48
+ cs.hover(next);
49
+ viz._scheduleSceneRepaint();
50
+ }
51
+ /**
52
+ The swatch to keep lit for the colorScale's hovered value when the chart
53
+ has no hover predicate of its own (shape hover is off, as on Geomap,
54
+ Calendar, or past `dataCutoff`): the value's bucket color, and the
55
+ opacity the other swatches dim to (`hoverOpacity`, or 0.5 when that is
56
+ 1). Null when the chart's own hover drives the highlight, nothing is
57
+ marked, `hoverMark` is off, or the scale isn't drawn as swatches.
58
+ @param viz The chart.
59
+ */ export function hoveredSwatch(viz) {
60
+ const cs = viz._colorScaleClass;
61
+ if (!cs || typeof viz._hover === "function") return null;
62
+ const value = cs.hover();
63
+ if (typeof value !== "number" || !Number.isFinite(value) || cs.hoverMark() === false || cs._barGeometry || typeof cs._colorScale !== "function") return null;
64
+ const shapeConfig = viz.schema.shapeConfig;
65
+ const hoverOpacity = shapeConfig?.hoverOpacity;
66
+ return {
67
+ color: cs._colorScale(value),
68
+ dimOpacity: typeof hoverOpacity === "number" && hoverOpacity < 1 ? hoverOpacity : 0.5
69
+ };
70
+ }