@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,203 @@
1
+ /**
2
+ Scene nodes for Plot's axis hover (#782): a dashed guide from the hovered
3
+ point to each axis, and a badge on each axis holding the point's value
4
+ there.
5
+ */ import { colorContrast, colorGray } from "@d3plus/color";
6
+ import { textWidth } from "@d3plus/dom";
7
+ import { parseDash } from "../../shapes/Shape.js";
8
+ import { themed } from "../../utils/theme.js";
9
+ /** `axisHoverConfig`'s defaults. */ export function axisHoverDefaults() {
10
+ return {
11
+ guideConfig: {
12
+ strokeDasharray: "4 3",
13
+ strokeWidth: 1
14
+ },
15
+ badgeConfig: {
16
+ fontSize: 12,
17
+ fontWeight: 400,
18
+ padding: 4,
19
+ rx: 2
20
+ }
21
+ };
22
+ }
23
+ /**
24
+ The plot area's edges: the x axis along the bottom, x2 along the top, y
25
+ on the left, and y2 on the right.
26
+ @param area The plot area.
27
+ */ export function plotEdges(area) {
28
+ return {
29
+ left: area.x,
30
+ right: area.x + area.width,
31
+ top: area.y,
32
+ bottom: area.y + area.height
33
+ };
34
+ }
35
+ /**
36
+ The guide from a point straight across to an axis line.
37
+ @param axis The axis the guide runs to.
38
+ @param point The hovered point.
39
+ @param edges The plot area's edges.
40
+ */ export function guidePoints(axis, point, edges) {
41
+ const to = axis === "x" ? [
42
+ point.x,
43
+ edges.bottom
44
+ ] : axis === "x2" ? [
45
+ point.x,
46
+ edges.top
47
+ ] : axis === "y" ? [
48
+ edges.left,
49
+ point.y
50
+ ] : [
51
+ edges.right,
52
+ point.y
53
+ ];
54
+ return [
55
+ [
56
+ point.x,
57
+ point.y
58
+ ],
59
+ to
60
+ ];
61
+ }
62
+ /**
63
+ A badge's box: centered on `at` along its axis, and set just outside the
64
+ axis line, over the tick labels.
65
+ @param axis The axis the badge labels.
66
+ @param at The badge's center along the axis.
67
+ @param size The badge's width and height.
68
+ @param edges The plot area's edges.
69
+ */ export function badgeBox(axis, at, size, edges) {
70
+ const { width, height } = size;
71
+ if (axis === "x") return {
72
+ x: at - width / 2,
73
+ y: edges.bottom,
74
+ width,
75
+ height
76
+ };
77
+ if (axis === "x2") return {
78
+ x: at - width / 2,
79
+ y: edges.top - height,
80
+ width,
81
+ height
82
+ };
83
+ if (axis === "y") return {
84
+ x: edges.left - width,
85
+ y: at - height / 2,
86
+ width,
87
+ height
88
+ };
89
+ return {
90
+ x: edges.right,
91
+ y: at - height / 2,
92
+ width,
93
+ height
94
+ };
95
+ }
96
+ /** Resolves a style value against the hovered row. */ function style(value, state) {
97
+ return typeof value === "function" ? value(state.datum, state.index) : value;
98
+ }
99
+ /** Stamps a node inert chrome: no hit-testing, never dimmed by hover. */ function inert(node) {
100
+ const n = node;
101
+ n.interactive = false;
102
+ n.interactionGroup = "axis";
103
+ return node;
104
+ }
105
+ /** The guide lines from the hovered point to each badged axis. */ function guideNodes(viz, state, edges, color) {
106
+ const config = viz.schema.axisHoverConfig.guideConfig;
107
+ const c = config || {};
108
+ const dash = style(c.strokeDasharray, state);
109
+ return state.badges.filter((b)=>b.guide).map((b)=>inert({
110
+ type: "line",
111
+ key: `plot-axis-hover-guide-${b.axis}`,
112
+ points: guidePoints(b.axis, state.point, edges),
113
+ paint: {
114
+ fill: "none",
115
+ stroke: style(c.stroke, state) ?? color,
116
+ strokeWidth: style(c.strokeWidth, state) ?? 1,
117
+ strokeOpacity: style(c.strokeOpacity, state) ?? 1,
118
+ strokeDasharray: Array.isArray(dash) ? dash : parseDash(dash)
119
+ }
120
+ }));
121
+ }
122
+ /** One axis's badge: a filled box with the value centered in it. */ function badgeNode(viz, state, badge, edges, color) {
123
+ const config = viz.schema.axisHoverConfig.badgeConfig;
124
+ const c = config || {};
125
+ const size = style(c.fontSize, state) ?? 12;
126
+ const family = style(c.fontFamily, state) || `${viz.schema.fontFamily}`;
127
+ const weight = style(c.fontWeight, state) ?? 400;
128
+ const pad = style(c.padding, state) ?? 4;
129
+ const fill = style(c.fill, state) ?? color;
130
+ const ink = style(c.fontColor, state) ?? colorContrast(fill, viz.schema.colorDefaults);
131
+ const width = textWidth(badge.text, {
132
+ "font-family": family,
133
+ "font-size": size,
134
+ "font-weight": weight
135
+ });
136
+ const box = badgeBox(badge.axis, badge.at, {
137
+ width: width + pad * 2,
138
+ height: size + pad * 2
139
+ }, edges);
140
+ const key = `plot-axis-hover-badge-${badge.axis}`;
141
+ return inert({
142
+ type: "group",
143
+ key,
144
+ children: [
145
+ inert({
146
+ type: "rect",
147
+ key: `${key}-box`,
148
+ ...box,
149
+ rx: style(c.rx, state) ?? 0,
150
+ paint: {
151
+ fill
152
+ }
153
+ }),
154
+ inert({
155
+ type: "text",
156
+ key: `${key}-text`,
157
+ x: 0,
158
+ y: 0,
159
+ transform: {
160
+ x: box.x + box.width / 2,
161
+ y: box.y + box.height / 2
162
+ },
163
+ lines: [
164
+ {
165
+ text: badge.text,
166
+ x: 0,
167
+ y: 0,
168
+ width
169
+ }
170
+ ],
171
+ font: {
172
+ family,
173
+ size,
174
+ weight,
175
+ anchor: "middle",
176
+ baseline: "middle"
177
+ },
178
+ paint: {
179
+ fill: ink
180
+ }
181
+ })
182
+ ]
183
+ });
184
+ }
185
+ /**
186
+ The axis hover's scene nodes, in chart content space: `guides` to draw
187
+ with the plot's marks (inside its zoom clip), and `badges` to draw over
188
+ the axes.
189
+ @param viz The Plot, with the hovered panel's state in place.
190
+ @param state The active axis hover.
191
+ */ export function axisHoverNodes(viz, state) {
192
+ const area = viz._plotArea;
193
+ if (!area) return {
194
+ guides: [],
195
+ badges: []
196
+ };
197
+ const edges = plotEdges(area);
198
+ const color = state.color || themed(viz._theme, (t)=>t.textMuted, colorGray[500]);
199
+ return {
200
+ guides: guideNodes(viz, state, edges, color),
201
+ badges: state.badges.map((b)=>badgeNode(viz, state, b, edges, color))
202
+ };
203
+ }
@@ -0,0 +1,43 @@
1
+ /**
2
+ The sorted values a continuous Plot axis spans.
3
+
4
+ @module
5
+ */ import { unique } from "@d3plus/data";
6
+ /**
7
+ `numbers` sorted ascending (stably, as `sort((a, b) => a - b)`) without
8
+ repeats, keeping the first of each. Sorted as a Float64Array, which
9
+ orders them the same way, unless NaN (which that comparator leaves in
10
+ place) or both zeros (which it keeps in their order, where a Float64Array
11
+ puts -0 first) are among them.
12
+ */ export function uniqueSortedNumbers(numbers) {
13
+ let nan = false, zero = false, negativeZero = false;
14
+ for (const n of numbers){
15
+ if (n !== n) nan = true;
16
+ else if (n === 0) {
17
+ if (Object.is(n, -0)) negativeZero = true;
18
+ else zero = true;
19
+ }
20
+ }
21
+ if (nan || zero && negativeZero) return unique([
22
+ ...numbers
23
+ ].sort((a, b)=>a - b));
24
+ const sorted = Float64Array.from(numbers).sort();
25
+ const out = [];
26
+ for(let i = 0; i < sorted.length; i++)if (i === 0 || sorted[i] !== sorted[i - 1]) out.push(sorted[i]);
27
+ return out;
28
+ }
29
+ /**
30
+ The values of `axis` across `rows`, sorted (by `sort`, else ascending)
31
+ and without repeats (compared as strings, the
32
+ first of each kept). Sorts `rows` in place, except when every value is a
33
+ number and there is no `sort`: those values are sorted on their own,
34
+ which gives the same list.
35
+ */ export function sortedAxisValues(rows, axis, sort) {
36
+ if (!sort) {
37
+ const values = rows.map((d)=>d[axis]);
38
+ // Two numbers share a string form only when they are equal (0 and -0),
39
+ // which is also when `unique` takes them as one.
40
+ if (values.every((v)=>typeof v === "number")) return uniqueSortedNumbers(values);
41
+ }
42
+ return unique(rows.sort(sort ?? ((a, b)=>a[axis] - b[axis])).map((d)=>d[axis]), (d)=>`${d}`);
43
+ }
@@ -0,0 +1,81 @@
1
+ /**
2
+ Bar hit areas: a transparent hover target behind each side-by-side bar
3
+ that fills the bar's slot along the discrete axis and the whole plot along
4
+ the value axis, so a short bar is as easy to hover and click as a tall
5
+ one. Grouped bars each take their own column of the slot. Stacked bars
6
+ already fill their slot and take none. `shapeConfig.Bar.hitArea: false`
7
+ turns them off.
8
+
9
+ @module
10
+ */ /**
11
+ A bar's column of its slot along the discrete axis, as offsets from the
12
+ bar's own center. A lone bar takes the whole slot. Grouped bars split it
13
+ at the midpoints between their centers, and the outermost reach the
14
+ slot's edges, so no column overlaps a neighboring bar.
15
+ @param step The slot's width: the distance between neighboring categories.
16
+ @param count How many bars share the slot.
17
+ @param index The bar's position in the slot.
18
+ @param reach How far the outermost bars' centers sit from the slot's center.
19
+ */ export function hitColumn(step, count, index, reach) {
20
+ const half = step / 2;
21
+ if (count < 2) return [
22
+ -half,
23
+ half
24
+ ];
25
+ const gap = 2 * reach / (count - 1);
26
+ const center = -reach + index * gap;
27
+ const lo = index <= 0 ? -half : center - gap / 2;
28
+ const hi = index >= count - 1 ? half : center + gap / 2;
29
+ return [
30
+ lo - center,
31
+ hi - center
32
+ ];
33
+ }
34
+ /**
35
+ A bar's hit rect in its own coordinates: its `column` along the discrete
36
+ axis, and the plot's `valueExtent` along the value axis, both sides of
37
+ the baseline.
38
+ @param discrete The discrete axis.
39
+ @param column The column, as offsets from the bar's center (see `hitColumn`).
40
+ @param valueExtent The value axis's pixel span, in shape coordinates.
41
+ @param origin The bar's transform.
42
+ */ export function hitBounds(discrete, column, valueExtent, origin) {
43
+ const [lo, hi] = column;
44
+ const [vlo, vhi] = valueExtent;
45
+ return discrete === "x" ? {
46
+ x: lo,
47
+ y: vlo - (origin.y ?? 0),
48
+ width: hi - lo,
49
+ height: vhi - vlo
50
+ } : {
51
+ x: vlo - (origin.x ?? 0),
52
+ y: lo,
53
+ width: vhi - vlo,
54
+ height: hi - lo
55
+ };
56
+ }
57
+ /**
58
+ Gives a Bar shape its slot-filling hit areas (see `hitBounds`). Set
59
+ before the user's `shapeConfig`, so `hitArea` there (or `false`) wins.
60
+ @param s The Bar shape.
61
+ @param discrete The discrete axis.
62
+ @param valueExtent The value axis's pixel span, in shape coordinates.
63
+ @param column Each bar's column (see `hitColumn`).
64
+ */ export function applyBarHitArea(s, discrete, valueExtent, column) {
65
+ if (!valueExtent) return;
66
+ s.config({
67
+ hitArea: (d, i)=>hitBounds(discrete, column(d, i), valueExtent, s._sceneTransform(d, i))
68
+ });
69
+ }
70
+ /** Whether a scene node is a Bar's hit area. */ const isBarHit = (node)=>node.shapeType === "Bar" && String(node.key).endsWith("::hit");
71
+ /**
72
+ `nodes` with every Bar hit area moved to the front (painted first), so
73
+ each sits behind every mark: a bar's slot never covers another bar, nor
74
+ the lines, points, and areas drawn over it.
75
+ */ export function barHitsFirst(nodes) {
76
+ if (!nodes.some(isBarHit)) return nodes;
77
+ return [
78
+ ...nodes.filter(isBarHit),
79
+ ...nodes.filter((node)=>!isBarHit(node))
80
+ ];
81
+ }
@@ -0,0 +1,123 @@
1
+ /**
2
+ Whether a Plot's in-bar category labels fit their bars. A BarChart whose
3
+ bars are labeled with their own categories hides the category axis's
4
+ tick labels; when the bars are too narrow for those labels, the axis
5
+ keeps its ticks instead (and the bars drop theirs), so every category
6
+ stays named. Decided during the axis measure, before the category axis
7
+ is measured, by fitting each label the way its bar would: the same
8
+ TextBox fitting, in the room the bar will have along the category axis
9
+ and at least half the plot along the value axis.
10
+
11
+ @module
12
+ */ import { max } from "d3-array";
13
+ import TextBox from "../../components/TextBox.js";
14
+ import { computeTextBoxDatum } from "../../components/textBoxLayout.js";
15
+ import { shapeConfigFor } from "../features/emitHelpers.js";
16
+ /** The label config keys that decide whether a label fits. */ const FIT_KEYS = [
17
+ "ellipsis",
18
+ "fontFamily",
19
+ "fontMax",
20
+ "fontMin",
21
+ "fontResize",
22
+ "fontSize",
23
+ "fontWeight",
24
+ "lineHeight",
25
+ "maxLines",
26
+ "overflow",
27
+ "padding",
28
+ "split"
29
+ ];
30
+ /**
31
+ The room each bar has for its label, in pixels: along the category axis,
32
+ the axis length split evenly among its `categories` (less `groupPadding`),
33
+ then among the `perCategory` bars sharing a category (less
34
+ `barPadding`); along the value axis, half the plot, which a bar's label
35
+ always has inside or beyond it.
36
+ @param discrete The category axis.
37
+ @param plot The plot area's size.
38
+ @param categories How many categories the axis holds.
39
+ @param perCategory How many bars share a category.
40
+ @param padding `groupPadding` and `barPadding`.
41
+ */ export function barLabelRoom(discrete, plot, categories, perCategory, padding) {
42
+ const along = discrete === "x" ? plot.width : plot.height;
43
+ const across = (discrete === "x" ? plot.height : plot.width) / 2;
44
+ let band = along / Math.max(1, categories);
45
+ if (padding.group < band) band -= padding.group;
46
+ if (perCategory > 1) band = (band - padding.bar * perCategory - 1) / perCategory;
47
+ band = Math.max(0, band);
48
+ return discrete === "x" ? {
49
+ width: band,
50
+ height: across
51
+ } : {
52
+ width: across,
53
+ height: band
54
+ };
55
+ }
56
+ /**
57
+ A TextBox configured with the fitting keys of a bar `labelConfig`; each
58
+ function value is read per row, against the row's source data.
59
+ */ function fitBox(labelConfig, rows) {
60
+ const box = new TextBox();
61
+ for (const key of FIT_KEYS){
62
+ const value = labelConfig[key];
63
+ if (value === undefined) continue;
64
+ if (key === "split" || typeof value !== "function") box[key](value);
65
+ else {
66
+ const fn = value;
67
+ box[key]((_, i)=>fn(rows[i].data, rows[i].i));
68
+ }
69
+ }
70
+ return box;
71
+ }
72
+ /**
73
+ Whether every label in `labels` (one per row in `rows`) fits, whole and
74
+ untruncated, in a `room`-sized box laid out with the bar `labelConfig`.
75
+ @param labels Each row's label text.
76
+ @param rows The rows the labels belong to.
77
+ @param room The box each label has (see `barLabelRoom`).
78
+ @param labelConfig The bars' resolved `labelConfig`.
79
+ */ export function barLabelsFit(labels, rows, room, labelConfig) {
80
+ if (!labels.length) return true;
81
+ const box = fitBox(labelConfig, rows);
82
+ return labels.every((text, i)=>{
83
+ const fitted = computeTextBoxDatum(box, {
84
+ text,
85
+ width: room.width,
86
+ height: room.height
87
+ }, i);
88
+ return !!fitted && !fitted.truncated && fitted.lines.join("") !== "";
89
+ });
90
+ }
91
+ /**
92
+ Whether the bars of `rows` have room for their category `labels` in a
93
+ plot of `plot` size (see `barLabelRoom` and `barLabelsFit`).
94
+ @param viz The chart.
95
+ @param rows The bar rows the labels belong to.
96
+ @param labels Each row's label text.
97
+ @param plot The plot area's size.
98
+ @param labelConfig The bars' resolved `labelConfig`.
99
+ */ export function barCategoryLabelsFit(viz, rows, labels, plot, labelConfig) {
100
+ const discrete = viz.schema.discrete === "y" ? "y" : "x";
101
+ const byCategory = new Map();
102
+ for (const row of rows){
103
+ const key = String(row[discrete]);
104
+ byCategory.set(key, (byCategory.get(key) ?? 0) + 1);
105
+ }
106
+ const perCategory = viz.schema.stacked ? 1 : max(Array.from(byCategory.values())) ?? 1;
107
+ const room = barLabelRoom(discrete, plot, byCategory.size, perCategory, {
108
+ group: viz._groupPadding ?? 0,
109
+ bar: viz.schema.barPadding ?? 0
110
+ });
111
+ return barLabelsFit(labels, rows, room, labelConfig);
112
+ }
113
+ /**
114
+ Whether a category axis keeps the tick labels its bars carry (see
115
+ `BarLabelCheck`): when the bars, in a plot of `plot` size, have no room
116
+ for those labels.
117
+ @param viz The chart.
118
+ @param check The bars' category labels.
119
+ @param plot The plot area's size.
120
+ */ export function barLabelsNeedAxis(viz, check, plot) {
121
+ const labelConfig = shapeConfigFor(viz, "Bar").labelConfig || {};
122
+ return !barCategoryLabelsFit(viz, check.rows, check.labels, plot, labelConfig);
123
+ }
@@ -6,7 +6,7 @@
6
6
  labeled at its bar's center, the way a category axis is.
7
7
  */ import { merge } from "@d3plus/data";
8
8
  import { formatAbbreviate, formatDate } from "@d3plus/format";
9
- import accessor from "../../utils/accessor.js";
9
+ import { fieldAccessor } from "../../utils/fieldAccessor.js";
10
10
  /** Labels for `barWidth` accessors that aren't a plain data key. */ const accessorLabels = new WeakMap();
11
11
  /** `discreteExtent` functions installed by this module, so others are left alone. */ const ownExtents = new WeakSet();
12
12
  /** A discrete value's identity: dates by time, everything else by its string. */ export const barKey = (v)=>v instanceof Date ? String(v.getTime()) : String(v);
@@ -17,7 +17,7 @@ import accessor from "../../utils/accessor.js";
17
17
  */ export function barWidthAccessor(value) {
18
18
  if (typeof value === "function") return value;
19
19
  if (typeof value === "string" && value) {
20
- const fn = accessor(value);
20
+ const fn = fieldAccessor(value);
21
21
  accessorLabels.set(fn, {
22
22
  key: value
23
23
  });
@@ -59,15 +59,14 @@ import accessor from "../../utils/accessor.js";
59
59
  });
60
60
  }
61
61
  /**
62
- Lays bars end to end from zero, in order. Bars without a positive, finite
63
- width are dropped.
62
+ Lays bars end to end from zero, in order, keeping each bar's merged
63
+ `data`. Bars without a positive, finite width are dropped.
64
64
  */ export function layoutBarSpans(bars) {
65
65
  let start = 0;
66
- return bars.filter((b)=>Number.isFinite(b.size) && b.size > 0).map(({ value, size })=>{
67
- const end = start + size;
66
+ return bars.filter((b)=>Number.isFinite(b.size) && b.size > 0).map((bar)=>{
67
+ const end = start + bar.size;
68
68
  const span = {
69
- value,
70
- size,
69
+ ...bar,
71
70
  start,
72
71
  end,
73
72
  mid: (start + end) / 2
@@ -154,6 +153,22 @@ import accessor from "../../utils/accessor.js";
154
153
  */ export function widthShareText(layout, span, locale) {
155
154
  return layout.total ? `${formatAbbreviate(span.size / layout.total * 100, locale)}%` : "";
156
155
  }
156
+ /**
157
+ A bar's width-share label: `barWidthShareFormat` called with the bar's
158
+ merged datum and its share, else the share as a percentage.
159
+ */ export function shareText(viz, layout, span) {
160
+ const text = widthShareText(layout, span, viz.schema.locale);
161
+ const format = viz.schema.barWidthShareFormat;
162
+ if (typeof format !== "function" || !span.data) return text;
163
+ const share = layout.total ? span.size / layout.total : 0;
164
+ const label = format(span.data, {
165
+ share,
166
+ size: span.size,
167
+ total: layout.total,
168
+ text
169
+ });
170
+ return label === undefined || label === null ? "" : String(label);
171
+ }
157
172
  /**
158
173
  A category's axis label with its bar's width share: on a second line
159
174
  beneath the name along a horizontal axis, after it in parentheses along
@@ -163,29 +178,62 @@ import accessor from "../../utils/accessor.js";
163
178
  if (!share) return name;
164
179
  return axis === "x" ? `${name}\n${share}` : `${name} (${share})`;
165
180
  }
181
+ /**
182
+ The secondary axis that carries the width shares when `barWidthShare` is
183
+ "opposite": `x2` (above the bars) for bars along `x`, `y2` (right of them)
184
+ for bars along `y`. Undefined otherwise, or without variable widths.
185
+ */ export function shareAxis(viz) {
186
+ const layout = viz._barSpans;
187
+ if (!layout || viz.schema.barWidthShare !== "opposite") return undefined;
188
+ return layout.axis === "x" ? "x2" : "y2";
189
+ }
190
+ /**
191
+ Axis config for the axis opposite a variable-width discrete axis when
192
+ `barWidthShare` is "opposite": each bar's width share labeled at its
193
+ center, with no line, ticks, gridlines, or title. Empty for any other
194
+ axis.
195
+ */ export function barShareAxisConfig(viz, axis) {
196
+ const layout = viz._barSpans;
197
+ if (!layout || shareAxis(viz) !== axis) return {};
198
+ const mids = layout.spans.map((s)=>s.mid);
199
+ const shares = new Map(layout.spans.map((s)=>[
200
+ s.mid,
201
+ shareText(viz, layout, s)
202
+ ]));
203
+ return {
204
+ barConfig: {
205
+ "stroke-width": 0
206
+ },
207
+ gridSize: 0,
208
+ labels: mids,
209
+ tickFormat: (v)=>shares.get(v) ?? "",
210
+ tickSize: 0,
211
+ ticks: mids,
212
+ title: false
213
+ };
214
+ }
166
215
  /**
167
216
  Axis config for a variable-width discrete axis: each category ticked and
168
217
  labeled at its bar's center, and nowhere else, with its width share when
169
- `barWidthShare` is on. Labels the axis rotates show the name alone. Empty
170
- for any other axis.
218
+ `barWidthShare` is `true`. Labels the axis rotates show the name alone.
219
+ Empty for any other axis.
171
220
  */ export function barSpanAxisConfig(viz, axis) {
172
221
  const layout = viz._barSpans;
173
222
  if (!layout || layout.axis !== axis) return {};
174
- const locale = viz.schema.locale;
175
223
  const mids = layout.spans.map((s)=>s.mid);
176
224
  const names = new Map(layout.spans.map((s)=>[
177
225
  s.mid,
178
226
  categoryLabel(s.value)
179
227
  ]));
180
228
  const name = (v)=>names.get(v) ?? "";
181
- if (!viz.schema.barWidthShare) return {
229
+ if (viz.schema.barWidthShare !== true) return {
182
230
  labels: mids,
183
231
  ticks: mids,
184
232
  tickFormat: name
185
233
  };
186
234
  const shared = new Map(layout.spans.map((s)=>[
187
235
  s.mid,
188
- shareLabel(categoryLabel(s.value), widthShareText(layout, s, locale), axis)
236
+ shareLabel(categoryLabel(s.value), shareText(viz, layout, s), axis)
189
237
  ]));
190
238
  return {
191
239
  labels: mids,
@@ -0,0 +1,98 @@
1
+ /**
2
+ Labels of a Plot's Circle marks (scatter, bubble, beeswarm points): each
3
+ stays inside its circle when it fits there, else moves beside it where
4
+ there's room, else hides (see `labelPosition` and `features/circleLabels.ts`).
5
+
6
+ @module
7
+ */ import { emitOutsideLabels, insideFontMin, layoutCircleLabels, outsideLabels } from "../features/circleLabels.js";
8
+ /** A value, or an accessor's value for a row. */ const valueOf = (v, d, i)=>typeof v === "function" ? v(d, i) : v;
9
+ /** The plot rect the labels stay in, in shape coordinates. */ function plotBounds(ctx) {
10
+ const xs = ctx.xRange.slice(0, 2).map(Number);
11
+ const ys = ctx.yRange.slice(0, 2).map((r)=>Number(r) - (ctx.x2Height ?? 0));
12
+ const x = Math.min(...xs), y = Math.min(...ys);
13
+ return {
14
+ x,
15
+ y,
16
+ width: Math.max(...xs) - x,
17
+ height: Math.max(...ys) - y
18
+ };
19
+ }
20
+ /**
21
+ Places the labels of a configured Circle shape before it renders: the
22
+ shape keeps the labels that stay inside (an `"auto"` one no smaller than
23
+ `pointLabelConfig.fontMin`), and the returned function emits the ones that
24
+ sit beside their circles, to paint over the circles. Returns null, leaving
25
+ the shape's labels alone, when the user gave the Circles their own
26
+ `labelBounds`.
27
+ @param ctx The shape group's emit context.
28
+ @param s The Circle shape, configured but not yet rendered.
29
+ @param userConfig The user's merged Circle shapeConfig.
30
+ */ export function plotCircleLabels(ctx, s, userConfig) {
31
+ if (userConfig.labelBounds) return null;
32
+ const { viz, values } = ctx;
33
+ const schema = s.schema;
34
+ const labelConfig = schema.labelConfig;
35
+ const items = values.map((d, i)=>{
36
+ const row = d;
37
+ const r = Number(schema.r(d, i));
38
+ return {
39
+ key: d,
40
+ datum: row.data ?? d,
41
+ index: typeof row.i === "number" ? row.i : i,
42
+ x: Number(schema.x(d, i)),
43
+ y: Number(schema.y(d, i)),
44
+ r,
45
+ text: schema.label(d, i),
46
+ inside: {
47
+ width: r * 2,
48
+ height: r * 2,
49
+ shape: "circle",
50
+ padding: valueOf(labelConfig.padding, d, i),
51
+ font: {
52
+ family: valueOf(labelConfig.fontFamily, d, i),
53
+ weight: valueOf(labelConfig.fontWeight, d, i)
54
+ }
55
+ }
56
+ };
57
+ });
58
+ const layout = layoutCircleLabels(viz, items, plotBounds(ctx));
59
+ if (!layout.size) return null;
60
+ const bounds = schema.labelBounds;
61
+ const fontMin = labelConfig.fontMin;
62
+ // A label placed beside its circle, or hidden, has no bounds inside it.
63
+ schema.labelBounds = function(d, i, aes) {
64
+ const placed = layout.get(d);
65
+ if (placed && placed.position !== "inside") return null;
66
+ return bounds.call(this, d, i, aes);
67
+ };
68
+ s.config({
69
+ labelConfig: {
70
+ fontMin: (rec, i)=>insideFontMin(viz, layout.get(rec.data), valueOf(fontMin, rec, i) ?? 8)
71
+ }
72
+ });
73
+ const indexOf = new Map(values.map((d, i)=>[
74
+ d,
75
+ i
76
+ ]));
77
+ const labels = outsideLabels(layout, (d)=>({
78
+ id: `${valueOf(schema.id, d, indexOf.get(d) ?? 0)}`,
79
+ datum: d
80
+ }));
81
+ return ()=>emitOutsideLabels(viz, labels, {
82
+ fontOpacity: labelConfig.fontOpacity
83
+ });
84
+ }
85
+ /**
86
+ Lifts a Circle group's labels over every circle. Sized circles are layered
87
+ by a `z` rank (largest behind), and a node without one sorts as 0, so
88
+ without this a label would paint beneath the circles layered over its own.
89
+ @param nodes The group's circles and labels.
90
+ */ export function labelsOverCircles(nodes) {
91
+ let top = -Infinity;
92
+ for (const n of nodes)if (typeof n.z === "number") top = Math.max(top, n.z);
93
+ if (top === -Infinity) return nodes;
94
+ return nodes.map((n)=>n.type === "text" ? {
95
+ ...n,
96
+ z: top + 1
97
+ } : n);
98
+ }