@d3plus/core 4.10.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 (548) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +167 -8
  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 +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 +3 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +2 -1
  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 +162 -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 +132 -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 +204 -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 +3 -3
  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/Network/applyLayout.js +138 -94
  70. package/es/src/charts/Network/bundle.js +81 -0
  71. package/es/src/charts/Network/clusterLabels.js +423 -0
  72. package/es/src/charts/Network/clusters.js +290 -0
  73. package/es/src/charts/Network/emit.js +253 -70
  74. package/es/src/charts/Network/graph.js +117 -0
  75. package/es/src/charts/Network/graphFluent.js +79 -0
  76. package/es/src/charts/Network/index.js +86 -106
  77. package/es/src/charts/Network/minNodeDistance.js +64 -0
  78. package/es/src/charts/Network/polygonRows.js +44 -0
  79. package/es/src/charts/Pack/index.js +5 -1
  80. package/es/src/charts/Pie/applyLayout.js +86 -27
  81. package/es/src/charts/Pie/arcFit.js +152 -0
  82. package/es/src/charts/Pie/curvedLabels.js +134 -0
  83. package/es/src/charts/Pie/emit.js +43 -96
  84. package/es/src/charts/Pie/index.js +64 -31
  85. package/es/src/charts/Pie/labelRoom.js +154 -0
  86. package/es/src/charts/Pie/outsideLabels.js +224 -0
  87. package/es/src/charts/Pie/outsideNodes.js +267 -0
  88. package/es/src/charts/Pie/pieLabels.js +137 -0
  89. package/es/src/charts/Pie/sectorBox.js +223 -0
  90. package/es/src/charts/Pie/straightLabels.js +96 -0
  91. package/es/src/charts/Pie/straightLayout.js +215 -0
  92. package/es/src/charts/Plot/alongLegend.js +76 -0
  93. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  94. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  95. package/es/src/charts/Plot/axisValues.js +43 -0
  96. package/es/src/charts/Plot/barWidth.js +59 -11
  97. package/es/src/charts/Plot/circleLabels.js +98 -0
  98. package/es/src/charts/Plot/connectGaps.js +237 -0
  99. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  100. package/es/src/charts/Plot/draw.js +8 -2
  101. package/es/src/charts/Plot/fillBetween.js +2 -1
  102. package/es/src/charts/Plot/forecastScene.js +3 -4
  103. package/es/src/charts/Plot/index.js +18 -10
  104. package/es/src/charts/Plot/labelPlacement.js +1 -1
  105. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  106. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  107. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  108. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  109. package/es/src/charts/Plot/pipeline.js +66 -19
  110. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  111. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  112. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  113. package/es/src/charts/Plot/pipelineScales.js +40 -8
  114. package/es/src/charts/Plot/plotFacet.js +12 -1
  115. package/es/src/charts/Plot/plotInit.js +34 -5
  116. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  117. package/es/src/charts/Plot/referenceDomains.js +133 -0
  118. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  119. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  120. package/es/src/charts/Plot/trendLabels.js +183 -0
  121. package/es/src/charts/Plot/trendLines.js +1 -0
  122. package/es/src/charts/Plot/trendScene.js +6 -3
  123. package/es/src/charts/Plot/trendTooltip.js +5 -1
  124. package/es/src/charts/PolarArea/index.js +2 -2
  125. package/es/src/charts/Priestley/applyLayout.js +14 -20
  126. package/es/src/charts/Priestley/index.js +4 -35
  127. package/es/src/charts/Priestley/timeAxis.js +100 -0
  128. package/es/src/charts/Radar/axisDecorations.js +49 -12
  129. package/es/src/charts/Radar/curvedLabels.js +187 -0
  130. package/es/src/charts/Radar/index.js +2 -3
  131. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  132. package/es/src/charts/RadialBar/emit.js +4 -1
  133. package/es/src/charts/RadialBar/index.js +16 -9
  134. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  135. package/es/src/charts/RadialMatrix/index.js +3 -7
  136. package/es/src/charts/Rings/applyLayout.js +41 -24
  137. package/es/src/charts/Rings/emit.js +174 -58
  138. package/es/src/charts/Rings/index.js +61 -28
  139. package/es/src/charts/Rings/ringsGraph.js +28 -9
  140. package/es/src/charts/Rings/ringsLoops.js +73 -0
  141. package/es/src/charts/Rings/ringsParallel.js +166 -0
  142. package/es/src/charts/Sankey/applyLayout.js +116 -39
  143. package/es/src/charts/Sankey/circularLayout.js +208 -0
  144. package/es/src/charts/Sankey/circularLinks.js +301 -0
  145. package/es/src/charts/Sankey/emit.js +164 -94
  146. package/es/src/charts/Sankey/index.js +72 -75
  147. package/es/src/charts/Sankey/labels.js +80 -0
  148. package/es/src/charts/Sankey/ribbons.js +88 -0
  149. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  150. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  151. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  152. package/es/src/charts/Scatter/index.js +25 -0
  153. package/es/src/charts/SlopeChart/index.js +116 -0
  154. package/es/src/charts/SlopeChart/slope.js +95 -0
  155. package/es/src/charts/Streamgraph/index.js +51 -0
  156. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  157. package/es/src/charts/Sunburst/emit.js +74 -63
  158. package/es/src/charts/Sunburst/index.js +3 -3
  159. package/es/src/charts/Tree/index.js +2 -6
  160. package/es/src/charts/Treemap/index.js +2 -5
  161. package/es/src/charts/Violin/inner.js +3 -5
  162. package/es/src/charts/definition/makeChart.js +10 -2
  163. package/es/src/charts/drawSteps/backControl.js +17 -5
  164. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  165. package/es/src/charts/drawSteps/minimap.js +6 -5
  166. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  167. package/es/src/charts/drawSteps/searchControls.js +2 -1
  168. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  169. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  170. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  171. package/es/src/charts/events/click.legend.js +7 -2
  172. package/es/src/charts/events/click.shape.js +8 -1
  173. package/es/src/charts/events/mousemove.shape.js +5 -2
  174. package/es/src/charts/facet/drawFacets.js +14 -5
  175. package/es/src/charts/features/annotationFrame.js +179 -0
  176. package/es/src/charts/features/annotationText.js +83 -0
  177. package/es/src/charts/features/annotationTypes.js +10 -0
  178. package/es/src/charts/features/attributionFeature.js +6 -11
  179. package/es/src/charts/features/axes.js +2 -1
  180. package/es/src/charts/features/axesFinal.js +3 -1
  181. package/es/src/charts/features/axesMeasure.js +7 -4
  182. package/es/src/charts/features/calloutLayout.js +121 -0
  183. package/es/src/charts/features/calloutScene.js +155 -0
  184. package/es/src/charts/features/chartGeometry.js +1 -1
  185. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  186. package/es/src/charts/features/circleLabels.js +207 -0
  187. package/es/src/charts/features/colorScaleBucket.js +2 -1
  188. package/es/src/charts/features/colorScaleHover.js +3 -2
  189. package/es/src/charts/features/colorScaleValue.js +97 -0
  190. package/es/src/charts/features/curvedArrows.js +158 -0
  191. package/es/src/charts/features/edgeArrows.js +160 -4
  192. package/es/src/charts/features/edgeBundling.js +442 -0
  193. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  194. package/es/src/charts/features/ensureZoomDom.js +32 -8
  195. package/es/src/charts/features/features.js +32 -14
  196. package/es/src/charts/features/featuresColorScale.js +20 -6
  197. package/es/src/charts/features/featuresLegend.js +15 -24
  198. package/es/src/charts/features/legendKeys.js +64 -0
  199. package/es/src/charts/features/lineLabels.js +55 -46
  200. package/es/src/charts/features/linkBundle.js +19 -0
  201. package/es/src/charts/features/linkColor.js +72 -0
  202. package/es/src/charts/features/linkFields.js +86 -0
  203. package/es/src/charts/features/linkFocus.js +118 -0
  204. package/es/src/charts/features/linkInteraction.js +312 -0
  205. package/es/src/charts/features/linkKeys.js +20 -0
  206. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  207. package/es/src/charts/features/linkLabelPath.js +162 -0
  208. package/es/src/charts/features/linkLabels.js +340 -0
  209. package/es/src/charts/features/linkWidths.js +32 -0
  210. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  211. package/es/src/charts/features/pathLabels.js +50 -0
  212. package/es/src/charts/features/plotAnnotations.js +68 -17
  213. package/es/src/charts/features/plotPaint.js +38 -11
  214. package/es/src/charts/features/polyline.js +129 -0
  215. package/es/src/charts/features/referenceAnnotations.js +403 -0
  216. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  217. package/es/src/charts/features/ringLabelNodes.js +93 -0
  218. package/es/src/charts/features/ringLabels.js +222 -0
  219. package/es/src/charts/features/sceneBounds.js +26 -6
  220. package/es/src/charts/features/selfLoops.js +306 -0
  221. package/es/src/charts/features/shapeEmit.js +47 -31
  222. package/es/src/charts/features/sharedFields.js +15 -2
  223. package/es/src/charts/features/textHalo.js +29 -0
  224. package/es/src/charts/index.js +8 -0
  225. package/es/src/charts/partition/chartFields.js +2 -2
  226. package/es/src/charts/partition/interaction.js +9 -5
  227. package/es/src/charts/partition/zoom.js +7 -6
  228. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  229. package/es/src/charts/pipeline/preDrawData.js +46 -3
  230. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  231. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  232. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  233. package/es/src/charts/polar/config.js +2 -3
  234. package/es/src/charts/viz/Viz.js +39 -36
  235. package/es/src/charts/viz/VizBase.js +18 -10
  236. package/es/src/charts/viz/backgroundInk.js +13 -7
  237. package/es/src/charts/viz/focusRing.js +104 -0
  238. package/es/src/charts/viz/focusTargets.js +208 -0
  239. package/es/src/charts/viz/history.js +74 -0
  240. package/es/src/charts/viz/keyboardNav.js +297 -0
  241. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  242. package/es/src/charts/viz/loaderFormat.js +114 -0
  243. package/es/src/charts/viz/missingFields.js +2 -1
  244. package/es/src/charts/viz/mountTarget.js +9 -0
  245. package/es/src/charts/viz/nearestHover.js +183 -0
  246. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  247. package/es/src/charts/viz/ordinalColor.js +14 -12
  248. package/es/src/charts/viz/pageTheme.js +83 -0
  249. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  250. package/es/src/charts/viz/pointVoronoi.js +124 -0
  251. package/es/src/charts/viz/reducedMotion.js +27 -0
  252. package/es/src/charts/viz/vizDataPolling.js +8 -3
  253. package/es/src/charts/viz/vizDefaults.js +15 -23
  254. package/es/src/charts/viz/vizFields.js +35 -0
  255. package/es/src/charts/viz/vizRender.js +43 -28
  256. package/es/src/charts/viz/vizTheme.js +96 -0
  257. package/es/src/charts/viz/vizVisibility.js +14 -0
  258. package/es/src/components/Axis/Axis.js +6 -0
  259. package/es/src/components/Axis/AxisBottom.js +1 -0
  260. package/es/src/components/Axis/AxisLeft.js +1 -0
  261. package/es/src/components/Axis/AxisRight.js +1 -0
  262. package/es/src/components/Axis/AxisTop.js +1 -0
  263. package/es/src/components/Axis/axisBreak.js +4 -1
  264. package/es/src/components/Axis/axisDefaults.js +5 -9
  265. package/es/src/components/Axis/axisLayoutScale.js +7 -1
  266. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  267. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  268. package/es/src/components/Axis/rangeBreaks.js +201 -0
  269. package/es/src/components/Axis/timeValues.js +19 -4
  270. package/es/src/components/ColorScale/ColorScale.js +15 -9
  271. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  272. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  273. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  274. package/es/src/components/Legend/Legend.js +3 -0
  275. package/es/src/components/Legend/legendConfig.js +2 -6
  276. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  277. package/es/src/components/TextBox.js +29 -65
  278. package/es/src/components/Timeline/Timeline.js +12 -3
  279. package/es/src/components/Timeline/timelineConfig.js +20 -10
  280. package/es/src/components/Timeline/timelineMode.js +26 -0
  281. package/es/src/components/Timeline/timelineRender.js +7 -3
  282. package/es/src/components/Tooltip.js +15 -5
  283. package/es/src/components/fontStack.js +20 -0
  284. package/es/src/components/textBoxLayout.js +58 -21
  285. package/es/src/components/textBoxPath.js +73 -0
  286. package/es/src/components/textBoxScene.js +223 -0
  287. package/es/src/components/textBoxWords.js +70 -0
  288. package/es/src/shapes/Area.js +1 -0
  289. package/es/src/shapes/Bar.js +1 -0
  290. package/es/src/shapes/Box.js +1 -0
  291. package/es/src/shapes/Circle.js +1 -0
  292. package/es/src/shapes/Line.js +1 -0
  293. package/es/src/shapes/Path.js +1 -0
  294. package/es/src/shapes/Rect.js +1 -0
  295. package/es/src/shapes/Shape.js +1 -0
  296. package/es/src/shapes/Whisker.js +1 -0
  297. package/es/src/utils/BaseClass.js +25 -12
  298. package/es/src/utils/configPrep.js +2 -1
  299. package/es/src/utils/constant.js +13 -1
  300. package/es/src/utils/displayName.js +12 -0
  301. package/es/src/utils/theme.js +190 -0
  302. package/es/src/utils/themeInk.js +68 -0
  303. package/package.json +14 -11
  304. package/types/index.d.ts +6 -2
  305. package/types/internal.d.ts +250 -8
  306. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  307. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  308. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  309. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  310. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  311. package/types/src/charts/Alluvial/index.d.ts +27 -0
  312. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  313. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  314. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  315. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  316. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  317. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  318. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  319. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  320. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  321. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  322. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  323. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  324. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  325. package/types/src/charts/Chord/labels.d.ts +66 -0
  326. package/types/src/charts/Donut/index.d.ts +2 -1
  327. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  328. package/types/src/charts/Gantt/emit.d.ts +17 -0
  329. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  330. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  331. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  332. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  333. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  334. package/types/src/charts/Gantt/index.d.ts +36 -0
  335. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  336. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  337. package/types/src/charts/Geomap/emit.d.ts +2 -2
  338. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  339. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  340. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  341. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  342. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  343. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  344. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  345. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  346. package/types/src/charts/Geomap/index.d.ts +3 -0
  347. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  348. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  349. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  350. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  351. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  352. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  353. package/types/src/charts/Hexbin/index.d.ts +25 -0
  354. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  355. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  356. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  357. package/types/src/charts/Histogram/binData.d.ts +20 -1
  358. package/types/src/charts/Histogram/index.d.ts +3 -2
  359. package/types/src/charts/Histogram/labels.d.ts +7 -0
  360. package/types/src/charts/Marimekko/index.d.ts +2 -1
  361. package/types/src/charts/Network/bundle.d.ts +67 -0
  362. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  363. package/types/src/charts/Network/clusters.d.ts +115 -0
  364. package/types/src/charts/Network/graph.d.ts +65 -0
  365. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  366. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  367. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  368. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  369. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  370. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  371. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  372. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  373. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  374. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  375. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  376. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  377. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  378. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  379. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  380. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  381. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  382. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  383. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  384. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  385. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  386. package/types/src/charts/Plot/index.d.ts +15 -8
  387. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  388. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  389. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  390. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  391. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  392. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  393. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  394. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  395. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  396. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  397. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  398. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  399. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  400. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  401. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  402. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  403. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  404. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  405. package/types/src/charts/Rings/emit.d.ts +50 -0
  406. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  407. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  408. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  409. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  410. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  411. package/types/src/charts/Sankey/emit.d.ts +58 -0
  412. package/types/src/charts/Sankey/labels.d.ts +19 -0
  413. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  414. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  415. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  416. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  417. package/types/src/charts/Scatter/index.d.ts +15 -0
  418. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  419. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  420. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  421. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  422. package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
  423. package/types/src/charts/definition/makeChart.d.ts +3 -2
  424. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  425. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  426. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  427. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  428. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  429. package/types/src/charts/events/click.legend.d.ts +2 -1
  430. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  431. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  432. package/types/src/charts/features/annotationText.d.ts +57 -0
  433. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  434. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  435. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  436. package/types/src/charts/features/calloutScene.d.ts +40 -0
  437. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  438. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  439. package/types/src/charts/features/circleLabels.d.ts +130 -0
  440. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  441. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  442. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  443. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  444. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  445. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  446. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  447. package/types/src/charts/features/legendKeys.d.ts +34 -0
  448. package/types/src/charts/features/lineLabels.d.ts +15 -12
  449. package/types/src/charts/features/linkBundle.d.ts +16 -0
  450. package/types/src/charts/features/linkColor.d.ts +48 -0
  451. package/types/src/charts/features/linkFields.d.ts +16 -0
  452. package/types/src/charts/features/linkFocus.d.ts +51 -0
  453. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  454. package/types/src/charts/features/linkKeys.d.ts +11 -0
  455. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  456. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  457. package/types/src/charts/features/linkLabels.d.ts +77 -0
  458. package/types/src/charts/features/linkWidths.d.ts +19 -0
  459. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  460. package/types/src/charts/features/pathLabels.d.ts +41 -0
  461. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  462. package/types/src/charts/features/plotPaint.d.ts +17 -0
  463. package/types/src/charts/features/polyline.d.ts +32 -0
  464. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  465. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  466. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  467. package/types/src/charts/features/ringLabels.d.ts +164 -0
  468. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  469. package/types/src/charts/features/selfLoops.d.ts +165 -0
  470. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  471. package/types/src/charts/features/sharedFields.d.ts +11 -2
  472. package/types/src/charts/features/textHalo.d.ts +14 -0
  473. package/types/src/charts/index.d.ts +8 -0
  474. package/types/src/charts/partition/interaction.d.ts +6 -3
  475. package/types/src/charts/partition/zoom.d.ts +4 -4
  476. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  477. package/types/src/charts/pipeline/stages.d.ts +7 -0
  478. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  479. package/types/src/charts/viz/Viz.d.ts +16 -2
  480. package/types/src/charts/viz/VizBase.d.ts +6 -6
  481. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  482. package/types/src/charts/viz/focusRing.d.ts +25 -0
  483. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  484. package/types/src/charts/viz/history.d.ts +35 -0
  485. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  486. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  487. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  488. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  489. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  490. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  491. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  492. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  493. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  494. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  495. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  496. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  497. package/types/src/charts/viz/vizFields.d.ts +32 -0
  498. package/types/src/charts/viz/vizRender.d.ts +2 -1
  499. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  500. package/types/src/charts/viz/vizTypes.d.ts +84 -7
  501. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  502. package/types/src/components/Axis/Axis.d.ts +1 -0
  503. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  504. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  505. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  506. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  507. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  508. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  509. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  510. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  511. package/types/src/components/Axis/timeValues.d.ts +1 -1
  512. package/types/src/components/ColorScale/ColorScale.d.ts +1 -0
  513. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  514. package/types/src/components/Legend/Legend.d.ts +1 -0
  515. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  516. package/types/src/components/TextBox.d.ts +1 -0
  517. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  518. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  519. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  520. package/types/src/components/Tooltip.d.ts +4 -3
  521. package/types/src/components/fontStack.d.ts +10 -0
  522. package/types/src/components/textBoxLayout.d.ts +18 -9
  523. package/types/src/components/textBoxPath.d.ts +59 -0
  524. package/types/src/components/textBoxScene.d.ts +51 -0
  525. package/types/src/components/textBoxWords.d.ts +33 -0
  526. package/types/src/shapes/Area.d.ts +1 -0
  527. package/types/src/shapes/Bar.d.ts +1 -0
  528. package/types/src/shapes/Box.d.ts +1 -0
  529. package/types/src/shapes/Circle.d.ts +1 -0
  530. package/types/src/shapes/Line.d.ts +1 -0
  531. package/types/src/shapes/Path.d.ts +1 -0
  532. package/types/src/shapes/Rect.d.ts +1 -0
  533. package/types/src/shapes/Shape.d.ts +1 -0
  534. package/types/src/shapes/Whisker.d.ts +1 -0
  535. package/types/src/utils/BaseClass.d.ts +9 -0
  536. package/types/src/utils/D3plusConfig.d.ts +981 -30
  537. package/types/src/utils/configPrep.d.ts +2 -0
  538. package/types/src/utils/constant.d.ts +8 -0
  539. package/types/src/utils/displayName.d.ts +10 -0
  540. package/types/src/utils/index.d.ts +1 -1
  541. package/types/src/utils/theme.d.ts +170 -0
  542. package/types/src/utils/themeInk.d.ts +56 -0
  543. package/umd/d3plus-core.full.js +86811 -61031
  544. package/umd/d3plus-core.full.min.js +2 -2
  545. package/umd/d3plus-core.js +28392 -6498
  546. package/umd/d3plus-core.min.js +2 -2
  547. package/es/src/components/Axis/gridStroke.js +0 -10
  548. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -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,
@@ -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
+ }