@d3plus/core 4.10.0 → 4.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (711) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +178 -9
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +176 -0
  9. package/es/src/charts/Alluvial/layout.js +137 -0
  10. package/es/src/charts/Alluvial/meta.js +57 -0
  11. package/es/src/charts/Alluvial/titles.js +101 -0
  12. package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
  13. package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
  14. package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
  15. package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
  16. package/es/src/charts/ArcDiagram/emit.js +192 -0
  17. package/es/src/charts/ArcDiagram/events.js +148 -0
  18. package/es/src/charts/ArcDiagram/index.js +217 -0
  19. package/es/src/charts/BarChart/index.js +12 -7
  20. package/es/src/charts/BoxWhisker/index.js +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +5 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +6 -11
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +160 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +137 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +206 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +6 -4
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Matrix/applyLayout.js +20 -9
  70. package/es/src/charts/Matrix/index.js +19 -1
  71. package/es/src/charts/Network/applyLayout.js +171 -96
  72. package/es/src/charts/Network/bundle.js +82 -0
  73. package/es/src/charts/Network/clusterLabels.js +423 -0
  74. package/es/src/charts/Network/clusters.js +290 -0
  75. package/es/src/charts/Network/emit.js +257 -75
  76. package/es/src/charts/Network/graph.js +146 -0
  77. package/es/src/charts/Network/graphFluent.js +81 -0
  78. package/es/src/charts/Network/index.js +91 -106
  79. package/es/src/charts/Network/minNodeDistance.js +64 -0
  80. package/es/src/charts/Network/polygonRows.js +44 -0
  81. package/es/src/charts/Pack/applyLayout.js +16 -5
  82. package/es/src/charts/Pack/emit.js +15 -8
  83. package/es/src/charts/Pack/groupRows.js +61 -0
  84. package/es/src/charts/Pack/index.js +8 -1
  85. package/es/src/charts/Pack/neutralPaint.js +20 -0
  86. package/es/src/charts/Pack/nodeNames.js +35 -0
  87. package/es/src/charts/ParallelCoordinates/axes.js +22 -22
  88. package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
  89. package/es/src/charts/ParallelCoordinates/index.js +3 -1
  90. package/es/src/charts/ParallelCoordinates/titles.js +17 -9
  91. package/es/src/charts/Pie/applyLayout.js +86 -27
  92. package/es/src/charts/Pie/arcFit.js +152 -0
  93. package/es/src/charts/Pie/curvedLabels.js +134 -0
  94. package/es/src/charts/Pie/emit.js +51 -96
  95. package/es/src/charts/Pie/index.js +74 -31
  96. package/es/src/charts/Pie/labelRoom.js +154 -0
  97. package/es/src/charts/Pie/outsideLabels.js +224 -0
  98. package/es/src/charts/Pie/outsideNodes.js +267 -0
  99. package/es/src/charts/Pie/pieLabels.js +137 -0
  100. package/es/src/charts/Pie/sectorBox.js +223 -0
  101. package/es/src/charts/Pie/straightLabels.js +96 -0
  102. package/es/src/charts/Pie/straightLayout.js +215 -0
  103. package/es/src/charts/Plot/alongLegend.js +76 -0
  104. package/es/src/charts/Plot/areaEnter.js +68 -0
  105. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  106. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  107. package/es/src/charts/Plot/axisValues.js +43 -0
  108. package/es/src/charts/Plot/barWidth.js +59 -11
  109. package/es/src/charts/Plot/circleLabels.js +98 -0
  110. package/es/src/charts/Plot/connectGaps.js +237 -0
  111. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  112. package/es/src/charts/Plot/draw.js +34 -14
  113. package/es/src/charts/Plot/fillBetween.js +2 -1
  114. package/es/src/charts/Plot/forecastScene.js +3 -4
  115. package/es/src/charts/Plot/index.js +19 -17
  116. package/es/src/charts/Plot/labelPlacement.js +1 -1
  117. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  118. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  119. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  120. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  121. package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
  122. package/es/src/charts/Plot/pipeline.js +66 -19
  123. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  124. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  125. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  126. package/es/src/charts/Plot/pipelineScales.js +40 -8
  127. package/es/src/charts/Plot/plotFacet.js +12 -1
  128. package/es/src/charts/Plot/plotInit.js +40 -5
  129. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  130. package/es/src/charts/Plot/referenceDomains.js +133 -0
  131. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  132. package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
  133. package/es/src/charts/Plot/sharedHover.js +2 -1
  134. package/es/src/charts/Plot/sharedTooltip.js +13 -3
  135. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  136. package/es/src/charts/Plot/trendLabels.js +183 -0
  137. package/es/src/charts/Plot/trendLines.js +1 -0
  138. package/es/src/charts/Plot/trendScene.js +6 -3
  139. package/es/src/charts/Plot/trendTooltip.js +5 -1
  140. package/es/src/charts/PolarArea/index.js +4 -3
  141. package/es/src/charts/Priestley/applyLayout.js +21 -23
  142. package/es/src/charts/Priestley/index.js +4 -37
  143. package/es/src/charts/Priestley/timeAxis.js +103 -0
  144. package/es/src/charts/Pyramid/gutter.js +52 -16
  145. package/es/src/charts/Pyramid/index.js +55 -7
  146. package/es/src/charts/Pyramid/scene.js +4 -4
  147. package/es/src/charts/Radar/applyLayout.js +31 -33
  148. package/es/src/charts/Radar/axisDecorations.js +62 -13
  149. package/es/src/charts/Radar/curvedLabels.js +228 -0
  150. package/es/src/charts/Radar/emit.js +30 -15
  151. package/es/src/charts/Radar/index.js +43 -5
  152. package/es/src/charts/Radar/points.js +85 -0
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +9 -1
  155. package/es/src/charts/RadialBar/index.js +26 -9
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
  158. package/es/src/charts/RadialMatrix/index.js +18 -9
  159. package/es/src/charts/Rings/applyLayout.js +39 -161
  160. package/es/src/charts/Rings/emit.js +219 -63
  161. package/es/src/charts/Rings/index.js +88 -32
  162. package/es/src/charts/Rings/ringsCurves.js +156 -0
  163. package/es/src/charts/Rings/ringsGraph.js +28 -9
  164. package/es/src/charts/Rings/ringsLoops.js +73 -0
  165. package/es/src/charts/Rings/ringsParallel.js +183 -0
  166. package/es/src/charts/Rings/ringsPlacement.js +152 -0
  167. package/es/src/charts/Rings/ringsSizing.js +61 -38
  168. package/es/src/charts/Sankey/applyLayout.js +130 -39
  169. package/es/src/charts/Sankey/circularLayout.js +208 -0
  170. package/es/src/charts/Sankey/circularLinks.js +301 -0
  171. package/es/src/charts/Sankey/emit.js +164 -94
  172. package/es/src/charts/Sankey/index.js +78 -75
  173. package/es/src/charts/Sankey/labels.js +80 -0
  174. package/es/src/charts/Sankey/ribbons.js +88 -0
  175. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  176. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  177. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  178. package/es/src/charts/Scatter/index.js +25 -0
  179. package/es/src/charts/SlopeChart/index.js +116 -0
  180. package/es/src/charts/SlopeChart/slope.js +95 -0
  181. package/es/src/charts/Streamgraph/index.js +51 -0
  182. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  183. package/es/src/charts/Sunburst/emit.js +83 -64
  184. package/es/src/charts/Sunburst/index.js +16 -4
  185. package/es/src/charts/Tree/applyLayout.js +44 -14
  186. package/es/src/charts/Tree/emit.js +5 -5
  187. package/es/src/charts/Tree/index.js +12 -18
  188. package/es/src/charts/Tree/keys.js +33 -0
  189. package/es/src/charts/Tree/nodeLabel.js +15 -0
  190. package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
  191. package/es/src/charts/Treemap/index.js +2 -5
  192. package/es/src/charts/Violin/inner.js +3 -5
  193. package/es/src/charts/definition/makeChart.js +14 -2
  194. package/es/src/charts/drawSteps/backControl.js +17 -5
  195. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  196. package/es/src/charts/drawSteps/minimap.js +10 -25
  197. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  198. package/es/src/charts/drawSteps/searchControls.js +2 -1
  199. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  200. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  201. package/es/src/charts/drawSteps/zoomActions.js +36 -0
  202. package/es/src/charts/drawSteps/zoomControls.js +52 -23
  203. package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
  204. package/es/src/charts/drawSteps/zoomDrag.js +188 -0
  205. package/es/src/charts/drawSteps/zoomFit.js +69 -0
  206. package/es/src/charts/events/click.legend.js +11 -4
  207. package/es/src/charts/events/click.shape.js +13 -4
  208. package/es/src/charts/events/mouseenter.js +6 -16
  209. package/es/src/charts/events/mouseleave.js +9 -2
  210. package/es/src/charts/events/mousemove.legend.js +28 -32
  211. package/es/src/charts/events/mousemove.shape.js +45 -42
  212. package/es/src/charts/facet/drawFacets.js +14 -5
  213. package/es/src/charts/features/annotationFrame.js +179 -0
  214. package/es/src/charts/features/annotationText.js +83 -0
  215. package/es/src/charts/features/annotationTypes.js +10 -0
  216. package/es/src/charts/features/attributionFeature.js +6 -11
  217. package/es/src/charts/features/axes.js +17 -5
  218. package/es/src/charts/features/axesFinal.js +10 -3
  219. package/es/src/charts/features/axesMeasure.js +33 -12
  220. package/es/src/charts/features/axisTooltip.js +138 -0
  221. package/es/src/charts/features/calloutLayout.js +121 -0
  222. package/es/src/charts/features/calloutScene.js +155 -0
  223. package/es/src/charts/features/centerLabel.js +177 -0
  224. package/es/src/charts/features/chartGeometry.js +1 -1
  225. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  226. package/es/src/charts/features/circleLabels.js +207 -0
  227. package/es/src/charts/features/colorScaleBivariate.js +83 -0
  228. package/es/src/charts/features/colorScaleBucket.js +20 -1
  229. package/es/src/charts/features/colorScaleHover.js +33 -7
  230. package/es/src/charts/features/colorScaleLimit.js +73 -0
  231. package/es/src/charts/features/colorScaleTooltip.js +77 -0
  232. package/es/src/charts/features/colorScaleTop.js +61 -0
  233. package/es/src/charts/features/colorScaleValue.js +97 -0
  234. package/es/src/charts/features/curvedArrows.js +191 -0
  235. package/es/src/charts/features/depthKey.js +26 -0
  236. package/es/src/charts/features/edgeArrows.js +220 -5
  237. package/es/src/charts/features/edgeBundling.js +442 -0
  238. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  239. package/es/src/charts/features/ensureZoomDom.js +32 -8
  240. package/es/src/charts/features/features.js +32 -14
  241. package/es/src/charts/features/featuresColorScale.js +75 -20
  242. package/es/src/charts/features/featuresLegend.js +15 -24
  243. package/es/src/charts/features/hoverTicks.js +41 -0
  244. package/es/src/charts/features/idleQueue.js +72 -0
  245. package/es/src/charts/features/legendKeys.js +64 -0
  246. package/es/src/charts/features/lineLabels.js +55 -46
  247. package/es/src/charts/features/linkBundle.js +19 -0
  248. package/es/src/charts/features/linkColor.js +72 -0
  249. package/es/src/charts/features/linkFields.js +86 -0
  250. package/es/src/charts/features/linkFocus.js +118 -0
  251. package/es/src/charts/features/linkInteraction.js +364 -0
  252. package/es/src/charts/features/linkKeys.js +20 -0
  253. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  254. package/es/src/charts/features/linkLabelPath.js +162 -0
  255. package/es/src/charts/features/linkLabels.js +340 -0
  256. package/es/src/charts/features/linkWidths.js +32 -0
  257. package/es/src/charts/features/networkMeasures.js +241 -0
  258. package/es/src/charts/features/nodeStats.js +309 -0
  259. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  260. package/es/src/charts/features/pathLabels.js +50 -0
  261. package/es/src/charts/features/plotAnnotations.js +68 -17
  262. package/es/src/charts/features/plotEndLabels.js +28 -7
  263. package/es/src/charts/features/plotPaint.js +46 -12
  264. package/es/src/charts/features/polyline.js +129 -0
  265. package/es/src/charts/features/referenceAnnotations.js +403 -0
  266. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  267. package/es/src/charts/features/ringLabelNodes.js +93 -0
  268. package/es/src/charts/features/ringLabels.js +222 -0
  269. package/es/src/charts/features/sceneBounds.js +26 -6
  270. package/es/src/charts/features/selfLoops.js +306 -0
  271. package/es/src/charts/features/shapeEmit.js +54 -32
  272. package/es/src/charts/features/sharedFields.js +15 -2
  273. package/es/src/charts/features/textHalo.js +30 -0
  274. package/es/src/charts/index.js +8 -0
  275. package/es/src/charts/partition/chartFields.js +14 -5
  276. package/es/src/charts/partition/interaction.js +19 -10
  277. package/es/src/charts/partition/zoom.js +7 -6
  278. package/es/src/charts/pipeline/insetPlacement.js +22 -9
  279. package/es/src/charts/pipeline/preDrawData.js +46 -3
  280. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  281. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  282. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  283. package/es/src/charts/polar/chrome.js +81 -9
  284. package/es/src/charts/polar/config.js +6 -3
  285. package/es/src/charts/polar/wedgeLayout.js +2 -1
  286. package/es/src/charts/viz/Viz.js +61 -49
  287. package/es/src/charts/viz/VizBase.js +57 -14
  288. package/es/src/charts/viz/backgroundInk.js +23 -7
  289. package/es/src/charts/viz/emphasis.js +14 -0
  290. package/es/src/charts/viz/fillStroke.js +10 -0
  291. package/es/src/charts/viz/focusRing.js +104 -0
  292. package/es/src/charts/viz/focusTargets.js +208 -0
  293. package/es/src/charts/viz/history.js +74 -0
  294. package/es/src/charts/viz/interactionOpacity.js +115 -32
  295. package/es/src/charts/viz/keyboardNav.js +297 -0
  296. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  297. package/es/src/charts/viz/loaderFormat.js +114 -0
  298. package/es/src/charts/viz/missingFields.js +2 -1
  299. package/es/src/charts/viz/mountTarget.js +9 -0
  300. package/es/src/charts/viz/nearestHover.js +183 -0
  301. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  302. package/es/src/charts/viz/ordinalColor.js +14 -12
  303. package/es/src/charts/viz/pageTheme.js +83 -0
  304. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  305. package/es/src/charts/viz/pointVoronoi.js +124 -0
  306. package/es/src/charts/viz/reducedMotion.js +27 -0
  307. package/es/src/charts/viz/reportDrawError.js +15 -0
  308. package/es/src/charts/viz/setCursor.js +29 -0
  309. package/es/src/charts/viz/tooltipEnabled.js +38 -0
  310. package/es/src/charts/viz/userClick.js +34 -0
  311. package/es/src/charts/viz/vizDataPolling.js +8 -4
  312. package/es/src/charts/viz/vizDefaults.js +28 -57
  313. package/es/src/charts/viz/vizFields.js +41 -1
  314. package/es/src/charts/viz/vizRender.js +76 -31
  315. package/es/src/charts/viz/vizTheme.js +96 -0
  316. package/es/src/charts/viz/vizVisibility.js +26 -2
  317. package/es/src/components/Axis/Axis.js +35 -2
  318. package/es/src/components/Axis/AxisBottom.js +1 -0
  319. package/es/src/components/Axis/AxisLeft.js +1 -0
  320. package/es/src/components/Axis/AxisRight.js +1 -0
  321. package/es/src/components/Axis/AxisTop.js +1 -0
  322. package/es/src/components/Axis/axisBreak.js +33 -8
  323. package/es/src/components/Axis/axisDefaults.js +16 -9
  324. package/es/src/components/Axis/axisLabelKinds.js +36 -0
  325. package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
  326. package/es/src/components/Axis/axisLabelRoom.js +37 -0
  327. package/es/src/components/Axis/axisLabelSize.js +171 -0
  328. package/es/src/components/Axis/axisLabelThinning.js +98 -4
  329. package/es/src/components/Axis/axisLayout.js +71 -46
  330. package/es/src/components/Axis/axisLayoutLabels.js +82 -140
  331. package/es/src/components/Axis/axisLayoutScale.js +16 -11
  332. package/es/src/components/Axis/axisLimit.js +27 -0
  333. package/es/src/components/Axis/axisMaxSize.js +39 -0
  334. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  335. package/es/src/components/Axis/axisRender.js +20 -8
  336. package/es/src/components/Axis/axisRounding.js +16 -1
  337. package/es/src/components/Axis/axisScene.js +11 -2
  338. package/es/src/components/Axis/axisTitle.js +53 -0
  339. package/es/src/components/Axis/axisTooltipTargets.js +128 -0
  340. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  341. package/es/src/components/Axis/rangeBreaks.js +201 -0
  342. package/es/src/components/Axis/timeValues.js +19 -4
  343. package/es/src/components/ColorScale/ColorScale.js +77 -27
  344. package/es/src/components/ColorScale/bivariateRender.js +353 -0
  345. package/es/src/components/ColorScale/bivariateScale.js +150 -0
  346. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  347. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  348. package/es/src/components/ColorScale/colorScaleRender.js +32 -2
  349. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  350. package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
  351. package/es/src/components/Legend/Legend.js +13 -2
  352. package/es/src/components/Legend/legendConfig.js +2 -6
  353. package/es/src/components/Legend/legendCut.js +108 -0
  354. package/es/src/components/Legend/legendRender.js +38 -13
  355. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  356. package/es/src/components/TextBox.js +34 -67
  357. package/es/src/components/Timeline/Timeline.js +12 -3
  358. package/es/src/components/Timeline/timelineConfig.js +20 -10
  359. package/es/src/components/Timeline/timelineMode.js +26 -0
  360. package/es/src/components/Timeline/timelineRender.js +9 -4
  361. package/es/src/components/Tooltip.js +15 -5
  362. package/es/src/components/fontStack.js +20 -0
  363. package/es/src/components/textBoxLayout.js +58 -21
  364. package/es/src/components/textBoxPath.js +73 -0
  365. package/es/src/components/textBoxScene.js +226 -0
  366. package/es/src/components/textBoxWords.js +70 -0
  367. package/es/src/components/textEllipsis.js +7 -0
  368. package/es/src/components/tooltipDom.js +8 -5
  369. package/es/src/fluent.js +48 -0
  370. package/es/src/shapes/Area.js +1 -0
  371. package/es/src/shapes/Bar.js +1 -0
  372. package/es/src/shapes/Box.js +1 -0
  373. package/es/src/shapes/Circle.js +1 -0
  374. package/es/src/shapes/Line.js +1 -0
  375. package/es/src/shapes/Path.js +1 -0
  376. package/es/src/shapes/Rect.js +1 -0
  377. package/es/src/shapes/Shape.js +1 -0
  378. package/es/src/shapes/Whisker.js +1 -0
  379. package/es/src/utils/BaseClass.js +30 -12
  380. package/es/src/utils/configPrep.js +2 -1
  381. package/es/src/utils/configValue.js +9 -0
  382. package/es/src/utils/constant.js +13 -1
  383. package/es/src/utils/displayName.js +12 -0
  384. package/es/src/utils/theme.js +190 -0
  385. package/es/src/utils/themeInk.js +68 -0
  386. package/package.json +14 -11
  387. package/types/index.d.ts +6 -2
  388. package/types/internal.d.ts +268 -9
  389. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  390. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  391. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  392. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  393. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  394. package/types/src/charts/Alluvial/index.d.ts +27 -0
  395. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  396. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  397. package/types/src/charts/Alluvial/titles.d.ts +46 -0
  398. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  399. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  400. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  401. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  402. package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
  403. package/types/src/charts/ArcDiagram/events.d.ts +29 -0
  404. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  405. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  406. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  407. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  408. package/types/src/charts/Chord/labels.d.ts +66 -0
  409. package/types/src/charts/Donut/index.d.ts +2 -1
  410. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  411. package/types/src/charts/Gantt/emit.d.ts +17 -0
  412. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  413. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  414. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  415. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  416. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  417. package/types/src/charts/Gantt/index.d.ts +36 -0
  418. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  419. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  420. package/types/src/charts/Geomap/emit.d.ts +2 -2
  421. package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
  422. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  423. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  424. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  425. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  426. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  427. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  428. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  429. package/types/src/charts/Geomap/index.d.ts +3 -0
  430. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  431. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  432. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  433. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  434. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  435. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  436. package/types/src/charts/Hexbin/index.d.ts +25 -0
  437. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  438. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  439. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  440. package/types/src/charts/Histogram/binData.d.ts +20 -1
  441. package/types/src/charts/Histogram/index.d.ts +3 -2
  442. package/types/src/charts/Histogram/labels.d.ts +7 -0
  443. package/types/src/charts/Marimekko/index.d.ts +2 -1
  444. package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
  445. package/types/src/charts/Network/applyLayout.d.ts +11 -0
  446. package/types/src/charts/Network/bundle.d.ts +69 -0
  447. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  448. package/types/src/charts/Network/clusters.d.ts +115 -0
  449. package/types/src/charts/Network/graph.d.ts +73 -0
  450. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  451. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  452. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  453. package/types/src/charts/Pack/applyLayout.d.ts +2 -0
  454. package/types/src/charts/Pack/groupRows.d.ts +46 -0
  455. package/types/src/charts/Pack/index.d.ts +3 -0
  456. package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
  457. package/types/src/charts/Pack/nodeNames.d.ts +23 -0
  458. package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
  459. package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
  460. package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
  461. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  462. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  463. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  464. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  465. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  466. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  467. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  468. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  469. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  470. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  471. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  472. package/types/src/charts/Plot/areaEnter.d.ts +34 -0
  473. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  474. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  475. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  476. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  477. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  478. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  479. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  480. package/types/src/charts/Plot/index.d.ts +16 -15
  481. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  482. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  483. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  484. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  485. package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
  486. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  487. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  488. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  489. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  490. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  491. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  492. package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
  493. package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
  494. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  495. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  496. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  497. package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
  498. package/types/src/charts/Pyramid/gutter.d.ts +28 -6
  499. package/types/src/charts/Pyramid/scene.d.ts +1 -1
  500. package/types/src/charts/Radar/applyLayout.d.ts +2 -3
  501. package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
  502. package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
  503. package/types/src/charts/Radar/emit.d.ts +5 -2
  504. package/types/src/charts/Radar/index.d.ts +7 -2
  505. package/types/src/charts/Radar/points.d.ts +50 -0
  506. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  507. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  508. package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
  509. package/types/src/charts/Rings/emit.d.ts +72 -0
  510. package/types/src/charts/Rings/index.d.ts +4 -2
  511. package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
  512. package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
  513. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  514. package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
  515. package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
  516. package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
  517. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  518. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  519. package/types/src/charts/Sankey/emit.d.ts +58 -0
  520. package/types/src/charts/Sankey/labels.d.ts +19 -0
  521. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  522. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  523. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  524. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  525. package/types/src/charts/Scatter/index.d.ts +15 -0
  526. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  527. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  528. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  529. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  530. package/types/src/charts/Tree/applyLayout.d.ts +20 -0
  531. package/types/src/charts/Tree/keys.d.ts +25 -0
  532. package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
  533. package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
  534. package/types/src/charts/definition/makeChart.d.ts +3 -2
  535. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  536. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  537. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  538. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  539. package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
  540. package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
  541. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
  542. package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
  543. package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
  544. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  545. package/types/src/charts/events/click.legend.d.ts +2 -1
  546. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  547. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  548. package/types/src/charts/features/annotationText.d.ts +57 -0
  549. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  550. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  551. package/types/src/charts/features/axisTooltip.d.ts +49 -0
  552. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  553. package/types/src/charts/features/calloutScene.d.ts +40 -0
  554. package/types/src/charts/features/centerLabel.d.ts +75 -0
  555. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  556. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  557. package/types/src/charts/features/circleLabels.d.ts +130 -0
  558. package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
  559. package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
  560. package/types/src/charts/features/colorScaleHover.d.ts +13 -3
  561. package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
  562. package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
  563. package/types/src/charts/features/colorScaleTop.d.ts +30 -0
  564. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  565. package/types/src/charts/features/curvedArrows.d.ts +119 -0
  566. package/types/src/charts/features/depthKey.d.ts +19 -0
  567. package/types/src/charts/features/edgeArrows.d.ts +103 -4
  568. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  569. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  570. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  571. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  572. package/types/src/charts/features/hoverTicks.d.ts +30 -0
  573. package/types/src/charts/features/idleQueue.d.ts +46 -0
  574. package/types/src/charts/features/legendKeys.d.ts +34 -0
  575. package/types/src/charts/features/lineLabels.d.ts +15 -12
  576. package/types/src/charts/features/linkBundle.d.ts +16 -0
  577. package/types/src/charts/features/linkColor.d.ts +48 -0
  578. package/types/src/charts/features/linkFields.d.ts +16 -0
  579. package/types/src/charts/features/linkFocus.d.ts +51 -0
  580. package/types/src/charts/features/linkInteraction.d.ts +192 -0
  581. package/types/src/charts/features/linkKeys.d.ts +11 -0
  582. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  583. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  584. package/types/src/charts/features/linkLabels.d.ts +77 -0
  585. package/types/src/charts/features/linkWidths.d.ts +19 -0
  586. package/types/src/charts/features/networkMeasures.d.ts +53 -0
  587. package/types/src/charts/features/nodeStats.d.ts +93 -0
  588. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  589. package/types/src/charts/features/pathLabels.d.ts +41 -0
  590. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  591. package/types/src/charts/features/plotEndLabels.d.ts +14 -1
  592. package/types/src/charts/features/plotPaint.d.ts +17 -0
  593. package/types/src/charts/features/polyline.d.ts +32 -0
  594. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  595. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  596. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  597. package/types/src/charts/features/ringLabels.d.ts +164 -0
  598. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  599. package/types/src/charts/features/selfLoops.d.ts +165 -0
  600. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  601. package/types/src/charts/features/sharedFields.d.ts +11 -2
  602. package/types/src/charts/features/textHalo.d.ts +15 -0
  603. package/types/src/charts/index.d.ts +8 -0
  604. package/types/src/charts/partition/chartFields.d.ts +6 -1
  605. package/types/src/charts/partition/interaction.d.ts +6 -3
  606. package/types/src/charts/partition/zoom.d.ts +4 -4
  607. package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
  608. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  609. package/types/src/charts/pipeline/stages.d.ts +7 -0
  610. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  611. package/types/src/charts/polar/chrome.d.ts +19 -6
  612. package/types/src/charts/viz/Viz.d.ts +25 -4
  613. package/types/src/charts/viz/VizBase.d.ts +37 -8
  614. package/types/src/charts/viz/backgroundInk.d.ts +19 -4
  615. package/types/src/charts/viz/emphasis.d.ts +17 -0
  616. package/types/src/charts/viz/fillStroke.d.ts +7 -0
  617. package/types/src/charts/viz/focusRing.d.ts +25 -0
  618. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  619. package/types/src/charts/viz/history.d.ts +35 -0
  620. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  621. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  622. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  623. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  624. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  625. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  626. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  627. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  628. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  629. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  630. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  631. package/types/src/charts/viz/reportDrawError.d.ts +12 -0
  632. package/types/src/charts/viz/setCursor.d.ts +26 -0
  633. package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
  634. package/types/src/charts/viz/userClick.d.ts +35 -0
  635. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  636. package/types/src/charts/viz/vizFields.d.ts +37 -0
  637. package/types/src/charts/viz/vizRender.d.ts +2 -1
  638. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  639. package/types/src/charts/viz/vizTypes.d.ts +100 -7
  640. package/types/src/charts/viz/vizVisibility.d.ts +13 -0
  641. package/types/src/components/Axis/Axis.d.ts +34 -3
  642. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  643. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  644. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  645. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  646. package/types/src/components/Axis/axisBreak.d.ts +21 -3
  647. package/types/src/components/Axis/axisDefaults.d.ts +12 -0
  648. package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
  649. package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
  650. package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
  651. package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
  652. package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
  653. package/types/src/components/Axis/axisLayout.d.ts +9 -2
  654. package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
  655. package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
  656. package/types/src/components/Axis/axisLimit.d.ts +18 -0
  657. package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
  658. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  659. package/types/src/components/Axis/axisRounding.d.ts +8 -0
  660. package/types/src/components/Axis/axisTitle.d.ts +30 -0
  661. package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
  662. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  663. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  664. package/types/src/components/Axis/timeValues.d.ts +1 -1
  665. package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
  666. package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
  667. package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
  668. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  669. package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
  670. package/types/src/components/Legend/Legend.d.ts +6 -0
  671. package/types/src/components/Legend/legendCut.d.ts +31 -0
  672. package/types/src/components/Legend/legendRender.d.ts +6 -1
  673. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  674. package/types/src/components/TextBox.d.ts +5 -0
  675. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  676. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  677. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  678. package/types/src/components/Tooltip.d.ts +4 -3
  679. package/types/src/components/fontStack.d.ts +10 -0
  680. package/types/src/components/textBoxLayout.d.ts +18 -9
  681. package/types/src/components/textBoxPath.d.ts +59 -0
  682. package/types/src/components/textBoxScene.d.ts +51 -0
  683. package/types/src/components/textBoxWords.d.ts +33 -0
  684. package/types/src/components/textEllipsis.d.ts +6 -0
  685. package/types/src/fluent.d.ts +18 -0
  686. package/types/src/shapes/Area.d.ts +1 -0
  687. package/types/src/shapes/Bar.d.ts +1 -0
  688. package/types/src/shapes/Box.d.ts +1 -0
  689. package/types/src/shapes/Circle.d.ts +1 -0
  690. package/types/src/shapes/Line.d.ts +1 -0
  691. package/types/src/shapes/Path.d.ts +1 -0
  692. package/types/src/shapes/Rect.d.ts +1 -0
  693. package/types/src/shapes/Shape.d.ts +1 -0
  694. package/types/src/shapes/Whisker.d.ts +1 -0
  695. package/types/src/shapes/emitLabels.d.ts +1 -1
  696. package/types/src/utils/BaseClass.d.ts +9 -0
  697. package/types/src/utils/D3plusConfig.d.ts +1093 -266
  698. package/types/src/utils/configPrep.d.ts +2 -0
  699. package/types/src/utils/configValue.d.ts +8 -0
  700. package/types/src/utils/constant.d.ts +8 -0
  701. package/types/src/utils/displayName.d.ts +10 -0
  702. package/types/src/utils/index.d.ts +1 -1
  703. package/types/src/utils/theme.d.ts +170 -0
  704. package/types/src/utils/themeInk.d.ts +56 -0
  705. package/types/umd-entry.d.ts +4 -0
  706. package/umd/d3plus-core.full.js +72239 -41465
  707. package/umd/d3plus-core.full.min.js +2 -2
  708. package/umd/d3plus-core.js +46249 -19519
  709. package/umd/d3plus-core.min.js +2 -2
  710. package/es/src/components/Axis/gridStroke.js +0 -10
  711. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -0,0 +1,76 @@
1
+ /**
2
+ The legend a chart's along labels can stand in for: when every series is
3
+ named along its own line (`lineLabels: "along"`) or stacked band
4
+ (`labelPosition: "along"`, the stacked-area default), the color legend
5
+ repeats what the labels already say, so the default legend hides. Which
6
+ series got a label is only known once the plot is placed, so a draw that
7
+ could label every series first lays out without the legend, then lays
8
+ out again with it when any series went unlabeled.
9
+ */ import { labelsAlongBand } from "./areaLabelsAlong.js";
10
+ /** Fresh counts for a draw. */ export const emptyAlongStats = ()=>({
11
+ series: 0,
12
+ requested: 0,
13
+ placed: 0
14
+ });
15
+ /**
16
+ Whether a chart draws stacked areas whose labels can run along their
17
+ bands: it stacks, draws its first row as an Area, and `labelPosition`
18
+ can ask for along labels.
19
+ @param viz The chart.
20
+ */ export function bandLabelsPossible(viz) {
21
+ if (!viz.schema.stacked) return false;
22
+ const shape = viz.schema.shape;
23
+ const first = viz._filteredData?.[0] ?? {};
24
+ const drawn = typeof shape === "function" ? shape(first, 0) : shape;
25
+ if (drawn !== "Area") return false;
26
+ const position = viz.schema.labelPosition;
27
+ return typeof position === "function" || labelsAlongBand(position);
28
+ }
29
+ /**
30
+ Whether this chart's legend may stand aside for its along labels: it is
31
+ the default legend (a user's `legend` always wins), no series is hidden
32
+ or soloed from it (the legend is the way back to them), and `lineLabels`
33
+ or stacked areas can ask for along labels, or the chart says its own
34
+ along labels can name every series (`_alongLabelsPossible`, such as a
35
+ RadialBar's curved track labels).
36
+ @param viz The chart.
37
+ */ export function alongLegendAuto(viz) {
38
+ if (viz.schema.legend !== viz._defaultLegend) return false;
39
+ if (viz._hidden?.length || viz._solo?.length) return false;
40
+ const setting = viz.schema.lineLabels;
41
+ return setting === "along" || typeof setting === "function" || bandLabelsPossible(viz) || Boolean(viz._alongLabelsPossible?.(viz));
42
+ }
43
+ /**
44
+ Whether a draw labeled every series along it: more than one series (a
45
+ lone one has no label to stand in for the legend), each of which asked
46
+ for an along label and got one.
47
+ @param stats The draw's counts.
48
+ */ export function allAlongLabeled(stats) {
49
+ return !!stats && stats.series > 1 && stats.requested === stats.series && stats.placed === stats.requested;
50
+ }
51
+ /**
52
+ Runs a chart's draw, hiding its default legend when along labels name
53
+ every series: the first draw lays out without the legend, and when any
54
+ series goes unlabeled, the chart draws again, from the same margins,
55
+ with the legend.
56
+ @param viz The chart.
57
+ @param draw Draws the chart once.
58
+ */ export function drawWithAlongLegend(viz, draw) {
59
+ const auto = alongLegendAuto(viz);
60
+ viz._alongLegendHide = auto;
61
+ viz._alongStats = emptyAlongStats();
62
+ if (!auto) return draw();
63
+ const margin = {
64
+ ...viz._margin
65
+ };
66
+ const padding = {
67
+ ...viz._padding
68
+ };
69
+ draw();
70
+ if (allAlongLabeled(viz._alongStats)) return;
71
+ viz._alongLegendHide = false;
72
+ viz._alongStats = emptyAlongStats();
73
+ viz._margin = margin;
74
+ viz._padding = padding;
75
+ draw();
76
+ }
@@ -0,0 +1,68 @@
1
+ /**
2
+ How areas grow in: every band starts flat on the value axis's baseline
3
+ and rises into place. An unstacked area starts on its own baseline; a
4
+ stack starts on the zero line (or the `baseline`, kept inside the
5
+ domain), so its bands rise together, each riding on the one beneath it.
6
+ Their labels fade in as the bands finish growing, where the bands land.
7
+ */ import { growFromLine } from "../helpers/densityEnter.js";
8
+ /**
9
+ The pixel line, along the value axis, that areas grow out of.
10
+ @param ctx The Plot shape-emit context the areas were drawn with.
11
+ */ export function areaBaseline(ctx) {
12
+ const { viz } = ctx;
13
+ const axis = viz.schema.discrete === "y" ? "x" : "y";
14
+ const own = ctx.shapeConfig[`${axis}0`];
15
+ if (!viz.schema.stacked && typeof own === "number" && Number.isFinite(own)) return own;
16
+ const domain = (axis === "x" ? ctx.xDomain : ctx.yDomain).map(Number);
17
+ const baseline = viz.schema.baseline;
18
+ const value = typeof baseline === "number" ? baseline : 0;
19
+ const lo = Math.min(...domain);
20
+ const hi = Math.max(...domain);
21
+ if (!Number.isFinite(lo) || !Number.isFinite(hi)) return null;
22
+ const at = (axis === "x" ? ctx.x : ctx.y)(Math.max(lo, Math.min(hi, value)));
23
+ return Number.isFinite(at) ? at : null;
24
+ }
25
+ /**
26
+ The share of an area's enter its labels wait out: they fade in over the
27
+ last part, once the bands have nearly reached the places they name.
28
+ */ export const AREA_LABEL_ENTER = {
29
+ start: 0.7,
30
+ end: 1
31
+ };
32
+ /**
33
+ Holds every text node under `nodes` back until late in its enter (see
34
+ `AREA_LABEL_ENTER`), so a label doesn't show where its band has yet to
35
+ grow.
36
+ @param nodes The label nodes, or the groups holding them.
37
+ */ export function holdAreaLabels(nodes) {
38
+ for (const node of nodes){
39
+ if (node.type === "text") node.enterWindow = AREA_LABEL_ENTER;
40
+ else if (node.type === "group") holdAreaLabels(node.children);
41
+ }
42
+ return nodes;
43
+ }
44
+ /** Every Area path's key under `nodes`. */ function areaKeys(nodes, out = []) {
45
+ for (const node of nodes){
46
+ if (node.type === "group") areaKeys(node.children, out);
47
+ else if (node.type === "path" && node.shapeType === "Area") out.push(`${node.key}`);
48
+ }
49
+ return out;
50
+ }
51
+ /**
52
+ Sets each Area path's `enterD`: its outline flattened onto the baseline
53
+ (see `areaBaseline`), so it grows out of the axis and, on exit, sinks
54
+ back into it. The areas' own labels fade in late (see `holdAreaLabels`).
55
+ @param ctx The Plot shape-emit context the areas were drawn with.
56
+ @param nodes The areas' scene nodes.
57
+ */ export function growAreasFromBaseline(ctx, nodes) {
58
+ const line = areaBaseline(ctx);
59
+ if (line === null) return;
60
+ const axis = ctx.viz.schema.discrete === "y" ? "x" : "y";
61
+ const keys = areaKeys(nodes);
62
+ if (!keys.length) return;
63
+ growFromLine(nodes, axis, new Map(keys.map((key)=>[
64
+ key,
65
+ line
66
+ ])));
67
+ holdAreaLabels(nodes);
68
+ }
@@ -0,0 +1,333 @@
1
+ /**
2
+ Stacked area labels along their bands (`labelPosition: "along"`, the
3
+ default for stacked areas): each series' name runs along its band's
4
+ centerline, on the stretch where the band is thick enough for the text
5
+ and flattest, in a color that reads on the band's fill. The font shrinks
6
+ to fit a thinner band, and a band too thin for its name everywhere goes
7
+ unlabeled.
8
+ */ import { rgb } from "d3-color";
9
+ import { colorContrast } from "@d3plus/color";
10
+ import { fontExists, textWidth } from "@d3plus/dom";
11
+ import { fontFamily as defaultFontFamily } from "@d3plus/text";
12
+ import { samplePath } from "@d3plus/render";
13
+ import { shapeConfigFor, userLabelConfig } from "../features/emitHelpers.js";
14
+ import { offsetPolyline, polylineD } from "../features/pathLabelGeometry.js";
15
+ import { pathLabelNodes } from "../features/pathLabels.js";
16
+ import { chartBackground } from "../viz/backgroundInk.js";
17
+ import { outsideBaselineBreak } from "./baselineBreak.js";
18
+ import { bestStretch, labelFont, PointGrid } from "./lineLabelsAlong.js";
19
+ /** The room a label keeps from its band's edges, above and below it together. */ export const AREA_LABEL_PADDING = 4;
20
+ /** The along label's weight when the Area's labelConfig sets none: the box labels' regular weight. */ export const AREA_LABEL_FONT_WEIGHT = 400;
21
+ /** How far past a label, in font sizes, more room in its band still scores better. */ const ROOM_REACH = 1.5;
22
+ /** The largest along label when the Area's labelConfig sets no `fontSize` or `fontMax`. */ export const AREA_LABEL_FONT_MAX = 16;
23
+ /** The smallest along label, whatever lower `fontMin` the Area's labelConfig sets. */ export const AREA_LABEL_FONT_MIN = 8;
24
+ /**
25
+ Whether a `labelPosition` value runs a stacked area's label along its
26
+ band: `"along"` and `"auto"` (or anything unrecognized) do, `"inside"`
27
+ and `"outside"` keep it in the band's largest box.
28
+ @param position The row's `labelPosition`.
29
+ */ export function labelsAlongBand(position) {
30
+ return position !== "inside" && position !== "outside";
31
+ }
32
+ /**
33
+ The centerline of a band: at every `step` pixels along `axis` (0 for a
34
+ band running along x, 1 along y), the midpoint between the band's two
35
+ edges there, and the distance between them.
36
+ @param outline The band's closed outline.
37
+ @param axis The axis the band runs along.
38
+ @param step The spacing of the centerline's points.
39
+ */ export function bandSections(outline, axis = 0, step = 3) {
40
+ if (outline.length < 3) return [];
41
+ const other = axis ? 0 : 1;
42
+ let lo = Infinity, hi = -Infinity;
43
+ for (const p of outline){
44
+ lo = Math.min(lo, p[axis]);
45
+ hi = Math.max(hi, p[axis]);
46
+ }
47
+ if (!(hi > lo)) return [];
48
+ const count = Math.ceil((hi - lo) / step);
49
+ const gap = (hi - lo) / count;
50
+ const near = new Array(count + 1).fill(Infinity);
51
+ const far = new Array(count + 1).fill(-Infinity);
52
+ const mark = (k, v)=>{
53
+ near[k] = Math.min(near[k], v);
54
+ far[k] = Math.max(far[k], v);
55
+ };
56
+ for(let i = 1; i < outline.length; i++){
57
+ const a = outline[i - 1], b = outline[i];
58
+ const span = b[axis] - a[axis];
59
+ const from = Math.ceil((Math.min(a[axis], b[axis]) - lo) / gap - 1e-9);
60
+ const to = Math.floor((Math.max(a[axis], b[axis]) - lo) / gap + 1e-9);
61
+ for(let k = from; k <= to; k++){
62
+ if (!span) {
63
+ mark(k, a[other]);
64
+ mark(k, b[other]);
65
+ } else {
66
+ const t = (lo + k * gap - a[axis]) / span;
67
+ mark(k, a[other] + t * (b[other] - a[other]));
68
+ }
69
+ }
70
+ }
71
+ const out = [];
72
+ near.forEach((v, k)=>{
73
+ if (v > far[k]) return;
74
+ const mid = (v + far[k]) / 2;
75
+ const at = lo + k * gap;
76
+ out.push({
77
+ point: axis ? [
78
+ mid,
79
+ at
80
+ ] : [
81
+ at,
82
+ mid
83
+ ],
84
+ thickness: far[k] - v
85
+ });
86
+ });
87
+ return out;
88
+ }
89
+ /**
90
+ The runs of a band's centerline where the band is at least `min` thick:
91
+ the only places a label that needs that much room can sit.
92
+ @param sections The band's sections (see `bandSections`).
93
+ @param min The least thickness.
94
+ */ export function thickRuns(sections, min) {
95
+ const runs = [];
96
+ let run = [];
97
+ for (const s of sections){
98
+ if (s.thickness >= min) run.push(s.point);
99
+ else {
100
+ if (run.length > 1) runs.push(run);
101
+ run = [];
102
+ }
103
+ }
104
+ if (run.length > 1) runs.push(run);
105
+ return runs;
106
+ }
107
+ /**
108
+ The polyline with points added along every segment longer than `step`,
109
+ so no stretch of it is more than `step` pixels from a point.
110
+ @param points The polyline.
111
+ @param step The longest gap left between points.
112
+ */ export function densify(points, step) {
113
+ const out = points.slice(0, 1);
114
+ for(let i = 1; i < points.length; i++){
115
+ const [ax, ay] = points[i - 1];
116
+ const [bx, by] = points[i];
117
+ const n = Math.ceil(Math.hypot(bx - ax, by - ay) / step);
118
+ for(let k = 1; k <= n; k++)out.push([
119
+ ax + (bx - ax) * k / n,
120
+ ay + (by - ay) * k / n
121
+ ]);
122
+ }
123
+ return out;
124
+ }
125
+ /**
126
+ The font sizes to try for an along label, largest first: from `fontSize`
127
+ (or `fontMax`) down to `fontMin`, a pixel at a time, stopping at
128
+ `AREA_LABEL_FONT_MIN` however low `fontMin` goes (unless `fontSize`
129
+ itself is smaller).
130
+ @param config The Area's labelConfig.
131
+ */ export function labelSizes(config = {}) {
132
+ const num = (v)=>typeof v === "number" && Number.isFinite(v) && v > 0 ? v : undefined;
133
+ const max = num(config.fontSize) ?? num(config.fontMax) ?? AREA_LABEL_FONT_MAX;
134
+ const floor = Math.max(num(config.fontMin) ?? 0, AREA_LABEL_FONT_MIN);
135
+ const min = Math.min(max, floor);
136
+ const sizes = [];
137
+ for(let s = max; s >= min; s--)sizes.push(s);
138
+ if (sizes[sizes.length - 1] !== min) sizes.push(min);
139
+ return sizes;
140
+ }
141
+ /**
142
+ The text color of a band's label: the `fontColor` a user's labelConfig
143
+ sets (a color, or an accessor of the band's datum and index), else the
144
+ color that contrasts with the band.
145
+ @param fontColor The user's `fontColor`, if any.
146
+ @param datum The band's datum.
147
+ @param index The band's index.
148
+ @param fill The color the band shows.
149
+ @param colorDefaults The chart's `colorDefaults`, for the contrast.
150
+ */ export function bandTextColor(fontColor, datum, index, fill, colorDefaults) {
151
+ const own = typeof fontColor === "function" ? fontColor(datum, index) : fontColor;
152
+ if (typeof own === "string" && own) return own;
153
+ return colorContrast(fill, colorDefaults);
154
+ }
155
+ /**
156
+ The font weight of a band's label: the Area labelConfig's `fontWeight`
157
+ (a weight, or an accessor of the band's datum and index), the same one
158
+ its box label would take, else regular.
159
+ @param fontWeight The labelConfig's `fontWeight`, if any.
160
+ @param datum The band's datum.
161
+ @param index The band's index.
162
+ */ export function bandFontWeight(fontWeight, datum, index) {
163
+ const own = typeof fontWeight === "function" ? fontWeight(datum, index) : fontWeight;
164
+ return typeof own === "number" || typeof own === "string" && own ? own : AREA_LABEL_FONT_WEIGHT;
165
+ }
166
+ /**
167
+ The best stretch of a band's centerline for its label, at the largest
168
+ font size that fits: a stretch where the band is at least the font size
169
+ plus `AREA_LABEL_PADDING` thick under the whole label and inside the
170
+ plot, scored toward where the band is thickest and flattest. Null when
171
+ no size fits anywhere.
172
+ @param outlines The band's closed outlines (one per run of defined data).
173
+ @param width The label's width at a font size.
174
+ @param sizes The font sizes to try, largest first.
175
+ @param rect The plot area.
176
+ @param axis The axis the band runs along.
177
+ */ export function placeBandLabel(outlines, width, sizes, rect, axis = 0) {
178
+ const sections = outlines.map((o)=>bandSections(o, axis));
179
+ const thickest = Math.max(0, ...sections.flat().map((s)=>s.thickness));
180
+ if (!sizes.length) return null;
181
+ const grid = new PointGrid(Math.max(...sizes) * ROOM_REACH);
182
+ for (const outline of outlines)grid.add(densify(outline, 2));
183
+ for (const fontSize of sizes){
184
+ // A band is no thicker across its slope than straight across its axis,
185
+ // so only the runs that thick need scoring.
186
+ const need = fontSize + AREA_LABEL_PADDING;
187
+ if (need > thickest) continue;
188
+ const runs = sections.flatMap((s)=>thickRuns(s, need));
189
+ // The glyphs, 0.2em below the baseline to 0.8em above it, center on the
190
+ // centerline, and keep half the padding from either edge.
191
+ const ctx = {
192
+ grid,
193
+ rect,
194
+ fontSize,
195
+ lift: -0.3 * fontSize,
196
+ minClearance: 0.2 * fontSize + AREA_LABEL_PADDING / 2,
197
+ roomReach: fontSize * ROOM_REACH,
198
+ roomWeight: 1.5,
199
+ // Bands running up the chart read bottom to top within 25° of upright.
200
+ steep: axis ? Math.tan(25 * Math.PI / 180) : undefined
201
+ };
202
+ const stretch = bestStretch(runs, width(fontSize) + fontSize, ctx);
203
+ if (stretch) return {
204
+ points: offsetPolyline(stretch, ctx.lift),
205
+ fontSize
206
+ };
207
+ }
208
+ return null;
209
+ }
210
+ /**
211
+ The color a band shows: its fill, laid over the chart's background at
212
+ its opacity.
213
+ @param fill The band's fill.
214
+ @param opacity Its fill opacity.
215
+ @param background The chart's background.
216
+ */ export function bandColor(fill, opacity, background) {
217
+ if (opacity >= 1) return fill;
218
+ const f = rgb(fill), b = rgb(background);
219
+ if (Number.isNaN(f.r) || Number.isNaN(b.r)) return fill;
220
+ const mix = (x, y)=>x * opacity + y * (1 - opacity);
221
+ return rgb(mix(f.r, b.r), mix(f.g, b.g), mix(f.b, b.b)).formatHex();
222
+ }
223
+ /** Every drawn Area with a datum, sampled into outlines in the plot's coordinates. */ function drawnBands(nodes, background) {
224
+ const out = [];
225
+ const visit = (node, ox, oy)=>{
226
+ const t = node.transform ?? {};
227
+ const x = ox + (t.x ?? 0), y = oy + (t.y ?? 0);
228
+ if (node.type === "group") node.children.forEach((c)=>visit(c, x, y));
229
+ if (node.type !== "path" || node.shapeType !== "Area" || !node.datum || `${node.key}`.endsWith("::hit")) return;
230
+ const outlines = (node.d.match(/M[^M]*/g) ?? []).map((d)=>samplePath(d).points.map(([px, py])=>[
231
+ px + x,
232
+ py + y
233
+ ])).filter((points)=>points.length > 2);
234
+ const paint = node.paint ?? {};
235
+ const opacity = (typeof paint.fillOpacity === "number" ? paint.fillOpacity : 1) * (typeof paint.opacity === "number" ? paint.opacity : 1);
236
+ out.push({
237
+ datum: node.datum,
238
+ index: node.index ?? 0,
239
+ key: `${node.key}`,
240
+ outlines,
241
+ fill: bandColor(`${paint.fill ?? "#444"}`, opacity, background)
242
+ });
243
+ };
244
+ nodes.forEach((n)=>visit(n, 0, 0));
245
+ return out;
246
+ }
247
+ /** A label's text from the Area's `label` accessor, or null for none. */ function labelText(label, d, i) {
248
+ let text = typeof label === "function" ? label(d, i) : label;
249
+ if (Array.isArray(text)) text = text[0];
250
+ if (text === false || text === null || text === undefined || text === "") return null;
251
+ return `${text}`;
252
+ }
253
+ /**
254
+ The labels along every stacked area band whose `labelPosition` runs it
255
+ along (see `labelsAlongBand`), each in the text the Area's `label` gives.
256
+ Counts the bands and labels into `viz._alongStats`, for the legend.
257
+ @param viz The chart.
258
+ @param marks The plot's drawn marks, its Areas among them.
259
+ @param rect The plot area.
260
+ */ export function emitAreaLabels(viz, marks, rect) {
261
+ if (!viz.schema.stacked) return [];
262
+ const background = chartBackground(viz);
263
+ const bands = drawnBands(marks, background);
264
+ if (!bands.length) return [];
265
+ const config = shapeConfigFor(viz, "Area");
266
+ const { fontColor } = userLabelConfig(viz, "Area");
267
+ const font = labelFont(viz, "Area");
268
+ const labelConfig = config.labelConfig ?? {};
269
+ const sizes = labelSizes(labelConfig);
270
+ const family = fontExists(font.fontFamily ?? defaultFontFamily);
271
+ const axis = viz.schema.discrete === "y" ? 1 : 0;
272
+ const position = viz.schema.labelPosition;
273
+ // Counted for the legend (see `alongLegend.ts`).
274
+ const stats = viz._alongStats;
275
+ if (stats) stats.series += bands.length;
276
+ const labels = bands.flatMap((band)=>{
277
+ const row = band.datum.data ?? band.datum;
278
+ const where = typeof position === "function" ? position(row, band.index) : position;
279
+ if (!labelsAlongBand(where)) return [];
280
+ const text = labelText(config.label, band.datum, band.index);
281
+ if (!text) return [];
282
+ if (stats) stats.requested++;
283
+ const fontWeight = bandFontWeight(labelConfig.fontWeight, band.datum, band.index);
284
+ const style = {
285
+ "font-family": family,
286
+ "font-weight": fontWeight
287
+ };
288
+ const outlines = band.outlines.map((o)=>outsideBaselineBreak(viz, o));
289
+ const placed = placeBandLabel(outlines, (fontSize)=>textWidth(text, {
290
+ ...style,
291
+ "font-size": fontSize
292
+ }), sizes, rect, axis);
293
+ if (!placed) return [];
294
+ if (stats) stats.placed++;
295
+ return [
296
+ {
297
+ key: `area-label-along-${band.key}`,
298
+ text,
299
+ d: polylineD(placed.points),
300
+ color: bandTextColor(fontColor, band.datum, band.index, band.fill, viz.schema.colorDefaults),
301
+ anchor: "middle",
302
+ datum: band.datum,
303
+ index: band.index,
304
+ fontSize: placed.fontSize,
305
+ fontWeight
306
+ }
307
+ ];
308
+ });
309
+ return pathLabelNodes(viz, labels, {
310
+ ...font,
311
+ fontColor: (d)=>d.color,
312
+ fontSize: (d)=>d.fontSize,
313
+ fontWeight: (d)=>d.fontWeight
314
+ }, {
315
+ halo: false
316
+ });
317
+ }
318
+ /**
319
+ Wraps a stacked Area's `label` accessor so the bands labeled along their
320
+ centerline (see `emitAreaLabels`) draw no label of their own.
321
+ @param viz The chart.
322
+ @param label The Area's `label` accessor.
323
+ */ export function boxLabelsOnly(viz, label) {
324
+ return (d, i)=>{
325
+ const wrapped = d;
326
+ const row = wrapped.__d3plus__ && wrapped.data ? wrapped.data : d;
327
+ const index = typeof wrapped.i === "number" ? wrapped.i : i;
328
+ const position = viz.schema.labelPosition;
329
+ const where = typeof position === "function" ? position(row, index) : position;
330
+ if (labelsAlongBand(where)) return false;
331
+ return typeof label === "function" ? label(d, i) : label;
332
+ };
333
+ }
@@ -5,6 +5,7 @@
5
5
  */ import { colorContrast, colorGray } from "@d3plus/color";
6
6
  import { textWidth } from "@d3plus/dom";
7
7
  import { parseDash } from "../../shapes/Shape.js";
8
+ import { themed } from "../../utils/theme.js";
8
9
  /** `axisHoverConfig`'s defaults. */ export function axisHoverDefaults() {
9
10
  return {
10
11
  guideConfig: {
@@ -194,7 +195,7 @@ import { parseDash } from "../../shapes/Shape.js";
194
195
  badges: []
195
196
  };
196
197
  const edges = plotEdges(area);
197
- const color = state.color || colorGray[500];
198
+ const color = state.color || themed(viz._theme, (t)=>t.textMuted, colorGray[500]);
198
199
  return {
199
200
  guides: guideNodes(viz, state, edges, color),
200
201
  badges: state.badges.map((b)=>badgeNode(viz, state, b, edges, color))
@@ -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
+ }
@@ -59,15 +59,14 @@ import { fieldAccessor } from "../../utils/fieldAccessor.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 { fieldAccessor } from "../../utils/fieldAccessor.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 { fieldAccessor } from "../../utils/fieldAccessor.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,