@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,403 @@
1
+ /**
2
+ Reference lines and bands: `referenceLines`/`referenceBands` entries
3
+ expand into `"ReferenceLine"`/`"ReferenceBand"` annotations, drawn as a
4
+ line across the whole plot at one value, or a shaded span between two,
5
+ with an optional label. Both sit behind the data unless `layer: "front"`;
6
+ their labels draw above it, clear of the data labels (see
7
+ `placeReferenceLabels`).
8
+ */ import { parseDash } from "../../shapes/Shape.js";
9
+ import { axisPixel, axisSpan, clipSpan, isVertical } from "./annotationFrame.js";
10
+ import { annotationTextNode, annotationTextStyle, wrapAnnotationText } from "./annotationText.js";
11
+ import { LABEL_PAD as PAD, registerLabelSpots, slideSteps } from "./referenceLabelPlacement.js";
12
+ /** The annotation shape a `referenceLines` entry expands into. */ export const REFERENCE_LINE = "ReferenceLine";
13
+ /** The annotation shape a `referenceBands` entry expands into. */ export const REFERENCE_BAND = "ReferenceBand";
14
+ const AXES = [
15
+ "x",
16
+ "y",
17
+ "x2",
18
+ "y2"
19
+ ];
20
+ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fallback;
21
+ /** The entries of a `referenceLines`/`referenceBands` setting: a list, one entry, or nothing. */ function entries(setting) {
22
+ const list = Array.isArray(setting) ? setting : setting ? [
23
+ setting
24
+ ] : [];
25
+ return list.filter((d)=>!!d && typeof d === "object");
26
+ }
27
+ /**
28
+ Expands `referenceLines` into `"ReferenceLine"` annotations, in the back
29
+ layer unless an entry sets its own.
30
+ @param setting The `referenceLines` setting.
31
+ */ export function expandReferenceLines(setting) {
32
+ return entries(setting).map((d)=>({
33
+ layer: "back",
34
+ ...d,
35
+ shape: REFERENCE_LINE
36
+ }));
37
+ }
38
+ /**
39
+ Expands `referenceBands` into `"ReferenceBand"` annotations, in the back
40
+ layer unless an entry sets its own.
41
+ @param setting The `referenceBands` setting.
42
+ */ export function expandReferenceBands(setting) {
43
+ return entries(setting).map((d)=>({
44
+ layer: "back",
45
+ ...d,
46
+ shape: REFERENCE_BAND
47
+ }));
48
+ }
49
+ /**
50
+ The axis a reference entry is on: the first of `x`, `y`, `x2`, `y2` it
51
+ sets, or null.
52
+ @param entry The entry.
53
+ */ export function referenceAxis(entry) {
54
+ return AXES.find((a)=>entry[a] !== undefined && entry[a] !== null) ?? null;
55
+ }
56
+ /** The plot's pixel extent along an axis. */ const extent = (frame, axis)=>isVertical(axis) ? [
57
+ frame.plot.y0,
58
+ frame.plot.y1
59
+ ] : [
60
+ frame.plot.x0,
61
+ frame.plot.x1
62
+ ];
63
+ /**
64
+ Where a reference line runs: its axis, its pixel position `at` along that
65
+ axis, and its two end points across the plot (start first). Null when it
66
+ has no position or falls outside the plot area.
67
+ @param frame The plot area and its axes.
68
+ @param entry The reference line.
69
+ */ export function referenceLinePoints(frame, entry) {
70
+ const axis = referenceAxis(entry);
71
+ if (!axis) return null;
72
+ const at = axisPixel(frame, axis, entry[axis], entry.ref);
73
+ const [lo, hi] = extent(frame, axis);
74
+ if (!Number.isFinite(at) || at < lo - 0.5 || at > hi + 0.5) return null;
75
+ const { plot } = frame;
76
+ const points = isVertical(axis) ? [
77
+ [
78
+ plot.x0,
79
+ at
80
+ ],
81
+ [
82
+ plot.x1,
83
+ at
84
+ ]
85
+ ] : [
86
+ [
87
+ at,
88
+ plot.y1
89
+ ],
90
+ [
91
+ at,
92
+ plot.y0
93
+ ]
94
+ ];
95
+ return {
96
+ axis,
97
+ at,
98
+ points
99
+ };
100
+ }
101
+ /**
102
+ The rect a reference band shades, clipped to the plot area, and its
103
+ axis. Null when it has no position or lies wholly outside the plot.
104
+ @param frame The plot area and its axes.
105
+ @param entry The reference band.
106
+ */ export function referenceBandRect(frame, entry) {
107
+ const axis = referenceAxis(entry);
108
+ const values = axis ? entry[axis] : undefined;
109
+ if (!axis || !Array.isArray(values) || values.length < 2) return null;
110
+ const span = axisSpan(frame, axis, [
111
+ values[0],
112
+ values[1]
113
+ ], entry.ref);
114
+ const [lo, hi] = extent(frame, axis);
115
+ const clipped = span && clipSpan(span, lo, hi);
116
+ if (!clipped) return null;
117
+ const { plot } = frame;
118
+ const box = isVertical(axis) ? {
119
+ x: plot.x0,
120
+ y: clipped[0],
121
+ width: plot.x1 - plot.x0,
122
+ height: clipped[1] - clipped[0]
123
+ } : {
124
+ x: clipped[0],
125
+ y: plot.y0,
126
+ width: clipped[1] - clipped[0],
127
+ height: plot.y1 - plot.y0
128
+ };
129
+ return {
130
+ axis,
131
+ box
132
+ };
133
+ }
134
+ /**
135
+ Where a reference line's label goes (the top-left of its text block, and
136
+ its alignment): beside the line's `"end"` (the right of a horizontal line,
137
+ the top of a vertical one) or `"start"`, above a horizontal line (below
138
+ it near the plot's top) and right of a vertical one (left of it near the
139
+ plot's right edge).
140
+ @param frame The plot area and its axes.
141
+ @param line The line's axis and pixel position.
142
+ @param block The wrapped label.
143
+ @param position Which end of the line.
144
+ */ export function referenceLineLabelAt(frame, line, block, position = "end") {
145
+ const { plot } = frame;
146
+ if (isVertical(line.axis)) {
147
+ const above = line.at - PAD - block.height;
148
+ return {
149
+ x: position === "start" ? plot.x0 + PAD : plot.x1 - PAD,
150
+ y: above >= plot.y0 ? above : line.at + PAD,
151
+ align: position === "start" ? "start" : "end"
152
+ };
153
+ }
154
+ const right = line.at + PAD + block.width <= plot.x1;
155
+ return {
156
+ x: right ? line.at + PAD : line.at - PAD,
157
+ y: position === "start" ? plot.y1 - PAD - block.height : plot.y0 + PAD,
158
+ align: right ? "start" : "end"
159
+ };
160
+ }
161
+ /**
162
+ Where a reference band's label goes: inside its top-left corner
163
+ (`"start"`) or top-right (`"end"`).
164
+ @param box The band's rect.
165
+ @param position Which corner.
166
+ */ export function referenceBandLabelAt(box, position = "start") {
167
+ return position === "end" ? {
168
+ x: box.x + box.width - PAD,
169
+ y: box.y + PAD,
170
+ align: "end"
171
+ } : {
172
+ x: box.x + PAD,
173
+ y: box.y + PAD,
174
+ align: "start"
175
+ };
176
+ }
177
+ /** Each spot of `firsts` crossed with each of `seconds`, `firsts` varying slowest. */ const cross = (firsts, seconds)=>firsts.flatMap((a)=>seconds.map((b)=>[
178
+ a,
179
+ b
180
+ ]));
181
+ /**
182
+ Every spot a reference line's label may take, the one
183
+ `referenceLineLabelAt` picks first: then the other side of the line, then
184
+ the line's other end on either side, then along the line from the
185
+ preferred end on either side.
186
+ @param frame The plot area and its axes.
187
+ @param line The line's axis and pixel position.
188
+ @param block The wrapped label.
189
+ @param position Which end of the line is preferred.
190
+ */ export function referenceLineLabelSpots(frame, line, block, position = "end") {
191
+ const { plot } = frame;
192
+ const first = referenceLineLabelAt(frame, line, block, position);
193
+ const other = position === "start" ? "end" : "start";
194
+ if (isVertical(line.axis)) {
195
+ // A horizontal line: its ends are the plot's sides; its sides, above and below.
196
+ const sides = [
197
+ first.y,
198
+ first.y === line.at + PAD ? line.at - PAD - block.height : line.at + PAD
199
+ ];
200
+ const ends = [
201
+ [
202
+ first.x,
203
+ first.align
204
+ ],
205
+ other === "start" ? [
206
+ plot.x0 + PAD,
207
+ "start"
208
+ ] : [
209
+ plot.x1 - PAD,
210
+ "end"
211
+ ]
212
+ ];
213
+ const along = slideSteps(first.align === "end" ? plot.x1 - PAD - block.width : plot.x0 + PAD, first.align === "end" ? plot.x0 + PAD : plot.x1 - PAD - block.width);
214
+ return [
215
+ ...cross(ends, sides).map(([[x, align], y])=>({
216
+ x,
217
+ y,
218
+ align
219
+ })),
220
+ ...cross(along, sides).map(([x, y])=>({
221
+ x,
222
+ y,
223
+ align: "start"
224
+ }))
225
+ ];
226
+ }
227
+ // A vertical line: its ends are the plot's top and bottom; its sides, right and left.
228
+ const sides = [
229
+ [
230
+ first.x,
231
+ first.align
232
+ ],
233
+ first.align === "start" ? [
234
+ line.at - PAD,
235
+ "end"
236
+ ] : [
237
+ line.at + PAD,
238
+ "start"
239
+ ]
240
+ ];
241
+ const top = plot.y0 + PAD, bottom = plot.y1 - PAD - block.height;
242
+ const ends = [
243
+ first.y,
244
+ first.y === top ? bottom : top
245
+ ];
246
+ const along = slideSteps(first.y, first.y === top ? bottom : top);
247
+ return cross([
248
+ ...ends,
249
+ ...along
250
+ ], sides).map(([y, [x, align]])=>({
251
+ x,
252
+ y,
253
+ align
254
+ }));
255
+ }
256
+ /**
257
+ Every spot a reference band's label may take, inside the band: the
258
+ corner `referenceBandLabelAt` picks first, then the other top corner,
259
+ then the bottom corners, then along the band's length from its top (or,
260
+ across the plot, from its preferred side).
261
+ @param box The band's rect.
262
+ @param axis The band's axis.
263
+ @param block The wrapped label.
264
+ @param position Which top corner is preferred.
265
+ */ export function referenceBandLabelSpots(box, axis, block, position = "start") {
266
+ const startX = [
267
+ box.x + PAD,
268
+ "start"
269
+ ], endX = [
270
+ box.x + box.width - PAD,
271
+ "end"
272
+ ];
273
+ const xs = position === "end" ? [
274
+ endX,
275
+ startX
276
+ ] : [
277
+ startX,
278
+ endX
279
+ ];
280
+ const top = box.y + PAD, bottom = box.y + box.height - PAD - block.height;
281
+ const corners = cross([
282
+ top,
283
+ bottom
284
+ ], xs).map(([y, [x, align]])=>({
285
+ x,
286
+ y,
287
+ align
288
+ }));
289
+ if (isVertical(axis)) {
290
+ const [[x0], [x1]] = xs;
291
+ const fromX = position === "end" ? x0 - block.width : x0;
292
+ const toX = position === "end" ? x1 : x1 - block.width;
293
+ return [
294
+ ...corners,
295
+ ...cross(slideSteps(fromX, toX), [
296
+ top,
297
+ bottom
298
+ ]).map(([x, y])=>({
299
+ x,
300
+ y,
301
+ align: "start"
302
+ }))
303
+ ];
304
+ }
305
+ return [
306
+ ...corners,
307
+ ...cross(slideSteps(top, bottom), xs).map(([y, [x, align]])=>({
308
+ x,
309
+ y,
310
+ align
311
+ }))
312
+ ];
313
+ }
314
+ /**
315
+ The label's text node at its preferred spot, registered with the rest of
316
+ its spots (see `placeReferenceLabels`), or null when the entry has no label.
317
+ */ function labelNode(viz, annotation, key, spotsFor) {
318
+ const text = annotation.label;
319
+ if (text === undefined || text === null || text === false || text === "") return null;
320
+ const style = annotationTextStyle(viz, (k)=>annotation[k]);
321
+ const block = wrapAnnotationText(`${text}`, style);
322
+ if (!block.lines.length) return null;
323
+ const spots = spotsFor(block);
324
+ const node = annotationTextNode(block, style, {
325
+ key,
326
+ ...spots[0]
327
+ });
328
+ registerLabelSpots(node, block, spots);
329
+ return node;
330
+ }
331
+ /** A `dash` setting's pattern: `true` is "4 4". */ function dashOf(annotation) {
332
+ const dash = annotation.dash ?? annotation.strokeDasharray;
333
+ if (dash === true) return [
334
+ 4,
335
+ 4
336
+ ];
337
+ if (dash === false) return undefined;
338
+ return parseDash(dash);
339
+ }
340
+ /**
341
+ The scene nodes of a reference line: the line and its label.
342
+ @param viz The chart.
343
+ @param annotation The `"ReferenceLine"` annotation.
344
+ @param frame The plot area and its axes.
345
+ @param key The annotation's key, which prefixes its nodes'.
346
+ */ export function referenceLineNodes(viz, annotation, frame, key) {
347
+ const line = referenceLinePoints(frame, annotation);
348
+ if (!line) return [];
349
+ const style = annotationTextStyle(viz, (k)=>annotation[k]);
350
+ const paint = {
351
+ fill: "none",
352
+ stroke: annotation.stroke || style.fontColor,
353
+ strokeWidth: num(annotation.strokeWidth, 1),
354
+ strokeOpacity: num(annotation.strokeOpacity, 0.6)
355
+ };
356
+ const dash = dashOf(annotation);
357
+ if (dash) paint.strokeDasharray = dash;
358
+ const out = [
359
+ {
360
+ type: "line",
361
+ key: `${key}-line`,
362
+ interactive: false,
363
+ points: line.points,
364
+ curve: "linear",
365
+ paint
366
+ }
367
+ ];
368
+ const label = labelNode(viz, annotation, `${key}-label`, (block)=>referenceLineLabelSpots(frame, line, block, annotation.labelPosition === "start" ? "start" : "end"));
369
+ if (label) out.push(label);
370
+ return out;
371
+ }
372
+ /**
373
+ The scene nodes of a reference band: the shaded rect and its label.
374
+ @param viz The chart.
375
+ @param annotation The `"ReferenceBand"` annotation.
376
+ @param frame The plot area and its axes.
377
+ @param key The annotation's key, which prefixes its nodes'.
378
+ */ export function referenceBandNodes(viz, annotation, frame, key) {
379
+ const band = referenceBandRect(frame, annotation);
380
+ if (!band) return [];
381
+ const style = annotationTextStyle(viz, (k)=>annotation[k]);
382
+ const paint = {
383
+ fill: annotation.fill || style.fontColor,
384
+ fillOpacity: num(annotation.fillOpacity, 0.08)
385
+ };
386
+ if (annotation.stroke) {
387
+ paint.stroke = annotation.stroke;
388
+ paint.strokeWidth = num(annotation.strokeWidth, 1);
389
+ paint.strokeOpacity = num(annotation.strokeOpacity, 0.4);
390
+ }
391
+ const out = [
392
+ {
393
+ type: "rect",
394
+ key: `${key}-band`,
395
+ interactive: false,
396
+ ...band.box,
397
+ paint
398
+ }
399
+ ];
400
+ const label = labelNode(viz, annotation, `${key}-label`, (block)=>referenceBandLabelSpots(band.box, band.axis, block, annotation.labelPosition === "end" ? "end" : "start"));
401
+ if (label) out.push(label);
402
+ return out;
403
+ }
@@ -0,0 +1,106 @@
1
+ /**
2
+ Where reference line and band labels go once the data is drawn: each
3
+ label has a list of spots, its preferred one first, and takes the first
4
+ whose box is clear of the data labels and of the reference labels placed
5
+ before it, inside the plot. A label with no clear spot is hidden.
6
+ */ /** Gap between a reference label and its line or band edge, in pixels. */ export const LABEL_PAD = 4;
7
+ /** How far apart the spots along a line or band edge are, in pixels. */ const SLIDE_STEP = 6;
8
+ /** Each label node's block and spots, for `placeReferenceLabels`. */ const labelSpots = new WeakMap();
9
+ /**
10
+ Records the spots a reference label node may move to (its preferred spot
11
+ first, where it is drawn), for `placeReferenceLabels`.
12
+ @param node The label's text node.
13
+ @param block The wrapped label.
14
+ @param spots Its spots, preferred first.
15
+ */ export function registerLabelSpots(node, block, spots) {
16
+ labelSpots.set(node, {
17
+ block,
18
+ spots
19
+ });
20
+ }
21
+ /**
22
+ The box a label's block covers at a spot.
23
+ @param spot The spot.
24
+ @param block The wrapped label.
25
+ */ export function labelSpotBox(spot, block) {
26
+ const shift = spot.align === "end" ? block.width : spot.align === "middle" ? block.width / 2 : 0;
27
+ return {
28
+ x: spot.x - shift,
29
+ y: spot.y,
30
+ width: block.width,
31
+ height: block.height
32
+ };
33
+ }
34
+ /** Whether two boxes overlap by more than a hair. */ const overlaps = (a, b)=>a.x < b.x + b.width - 0.5 && b.x < a.x + a.width - 0.5 && a.y < b.y + b.height - 0.5 && b.y < a.y + a.height - 0.5;
35
+ /** Whether a box lies inside the plot, to half a pixel. */ const inside = (b, plot)=>b.x >= plot.x0 - 0.5 && b.y >= plot.y0 - 0.5 && b.x + b.width <= plot.x1 + 0.5 && b.y + b.height <= plot.y1 + 0.5;
36
+ /**
37
+ The first of `spots` whose box is clear of every obstacle and inside the
38
+ plot (the first spot, the preferred one, need only be clear), or null
39
+ when none is.
40
+ @param spots The spots, preferred first.
41
+ @param block The wrapped label.
42
+ @param obstacles The boxes to stay clear of.
43
+ @param plot The plot area.
44
+ */ export function pickLabelSpot(spots, block, obstacles, plot) {
45
+ return spots.find((spot, i)=>{
46
+ const b = labelSpotBox(spot, block);
47
+ return (!i || inside(b, plot)) && !obstacles.some((o)=>overlaps(b, o));
48
+ }) ?? null;
49
+ }
50
+ /**
51
+ Positions from `from` toward `to`, `SLIDE_STEP` apart, both ends included.
52
+ @param from The first position.
53
+ @param to The last.
54
+ */ export function slideSteps(from, to) {
55
+ const steps = Math.floor(Math.abs(to - from) / SLIDE_STEP);
56
+ const dir = to < from ? -1 : 1;
57
+ const out = Array.from({
58
+ length: steps + 1
59
+ }, (_, i)=>from + dir * i * SLIDE_STEP);
60
+ if (out[out.length - 1] !== to) out.push(to);
61
+ return out;
62
+ }
63
+ /**
64
+ Moves each registered reference label among `nodes` to its first clear
65
+ spot (see `pickLabelSpot`), in order, each placed label joining the
66
+ obstacles of the ones after it, and drops a label with no clear spot.
67
+ Returns the nodes with the labels moved; unregistered nodes pass through.
68
+ @param nodes Scene nodes holding reference labels, at any depth.
69
+ @param obstacles The boxes to keep clear of, such as the data labels'.
70
+ @param plot The plot area.
71
+ */ export function placeReferenceLabels(nodes, obstacles, plot) {
72
+ const taken = [
73
+ ...obstacles
74
+ ];
75
+ const visit = (list)=>list.flatMap((node)=>{
76
+ if (node.type === "group") return [
77
+ {
78
+ ...node,
79
+ children: visit(node.children)
80
+ }
81
+ ];
82
+ const entry = labelSpots.get(node);
83
+ if (!entry || node.type !== "text") return [
84
+ node
85
+ ];
86
+ const spot = pickLabelSpot(entry.spots, entry.block, taken, plot);
87
+ if (!spot) return [];
88
+ taken.push(labelSpotBox(spot, entry.block));
89
+ const moved = {
90
+ ...node,
91
+ transform: {
92
+ ...node.transform,
93
+ x: spot.x,
94
+ y: spot.y
95
+ },
96
+ font: {
97
+ ...node.font,
98
+ anchor: spot.align
99
+ }
100
+ };
101
+ return [
102
+ moved
103
+ ];
104
+ });
105
+ return visit(nodes);
106
+ }
@@ -0,0 +1,93 @@
1
+ /**
2
+ The scene nodes for curved ring labels (see `ringLabels.ts`): text along
3
+ each label's arc in a color that reads on what lies under it, carrying
4
+ its segment's datum so it dims with it, inert, and fading rather than
5
+ gliding when a redraw moves it.
6
+ */ import { fontExists, textWidth } from "@d3plus/dom";
7
+ import { fontFamily as defaultFontFamily } from "@d3plus/text";
8
+ import { labelsOverlap } from "./linkLabelGeometry.js";
9
+ import { textLineBoxes } from "./linkLabels.js";
10
+ import { pathLabelNodes } from "./pathLabels.js";
11
+ /**
12
+ How a curved label fades through a redraw that moves it: out over the
13
+ first 6% of the eased progress, back in over the last 6%, so it never
14
+ slides along the ring while its segment's arc tweens.
15
+ */ export const RING_LABEL_FADE = {
16
+ out: 0.06,
17
+ in: 0.06
18
+ };
19
+ /**
20
+ The label font a shape's labelConfig sets, as plain values (accessors
21
+ are left to the defaults).
22
+ @param config The labelConfig.
23
+ */ export function ringLabelFont(config) {
24
+ const out = {};
25
+ const { fontFamily, fontWeight } = config;
26
+ if (typeof fontFamily === "string" || Array.isArray(fontFamily)) out.fontFamily = fontFamily;
27
+ if (typeof fontWeight === "number" || typeof fontWeight === "string") out.fontWeight = fontWeight;
28
+ return out;
29
+ }
30
+ /**
31
+ A text's one-line width in a ring label font, by font size.
32
+ @param text The text.
33
+ @param font The label font.
34
+ */ export function ringTextWidth(text, font) {
35
+ const style = {
36
+ "font-family": fontExists(font.fontFamily ?? defaultFontFamily),
37
+ "font-size": 100,
38
+ "font-weight": font.fontWeight ?? 400
39
+ };
40
+ const at100 = textWidth(text, style);
41
+ return (fontSize)=>at100 * fontSize / 100;
42
+ }
43
+ /** Whether a text node shows more than its ellipsis. */ const hasText = (node)=>node.type === "text" && node.lines.some((l)=>l.text.replace(/(\.\.\.|…)$/, "").trim().length > 0);
44
+ /**
45
+ The text nodes for curved labels: one per label that keeps some text
46
+ after it is cut to its path, each in its own font size and color.
47
+ @param viz The chart, for its locale.
48
+ @param labels The labels.
49
+ @param font The label font.
50
+ */ export function ringLabelNodes(viz, labels, font = {}) {
51
+ if (!labels.length) return [];
52
+ const sizes = new Map(labels.map((l)=>[
53
+ l.key,
54
+ l.fit.fontSize
55
+ ]));
56
+ const pathLabels = labels.map((l)=>({
57
+ key: l.key,
58
+ text: l.text,
59
+ d: l.fit.d,
60
+ color: l.color,
61
+ anchor: "middle",
62
+ datum: l.datum,
63
+ index: l.index
64
+ }));
65
+ const nodes = pathLabelNodes(viz, pathLabels, {
66
+ fontWeight: 400,
67
+ ...font,
68
+ fontColor: (d)=>d.color,
69
+ fontSize: (d)=>sizes.get(d.key) ?? 10
70
+ }, {
71
+ halo: false
72
+ });
73
+ return nodes.filter(hasText).map((node)=>({
74
+ ...node,
75
+ fadeSwap: RING_LABEL_FADE
76
+ }));
77
+ }
78
+ /**
79
+ The labels that stay clear of each other and of `obstacles`, earlier
80
+ labels winning.
81
+ @param nodes The label nodes, in priority order.
82
+ @param obstacles Boxes they must stay clear of, such as other labels.
83
+ */ export function clearRingLabels(nodes, obstacles = []) {
84
+ const placed = obstacles.slice();
85
+ return nodes.filter((node)=>{
86
+ const boxes = textLineBoxes([
87
+ node
88
+ ]);
89
+ if (boxes.some((b)=>placed.some((o)=>labelsOverlap(b, o)))) return false;
90
+ placed.push(...boxes);
91
+ return true;
92
+ });
93
+ }