@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,133 @@
1
+ /**
2
+ Reference lines and bands count toward the axis domains they sit on, so
3
+ a target above the data (or a band below it) widens its continuous or
4
+ time axis into view. A domain end the user set stays put.
5
+ */ import { date } from "@d3plus/dom";
6
+ import { expandReferenceBands, expandReferenceLines, REFERENCE_BAND, REFERENCE_LINE, referenceAxis } from "../features/referenceAnnotations.js";
7
+ /**
8
+ The data-unit values reference lines and bands place on each axis, from
9
+ a list of annotations (`"plot"`-fraction entries and other kinds left
10
+ out).
11
+ @param annotations The chart's annotations, with `referenceLines` and `referenceBands` expanded.
12
+ */ export function referenceDomainValues(annotations) {
13
+ const out = {
14
+ x: [],
15
+ y: [],
16
+ x2: [],
17
+ y2: []
18
+ };
19
+ annotations.forEach((a)=>{
20
+ if (a.shape !== REFERENCE_LINE && a.shape !== REFERENCE_BAND) return;
21
+ if (a.ref === "plot") return;
22
+ const axis = referenceAxis(a);
23
+ if (!axis) return;
24
+ const value = a[axis];
25
+ if (a.shape === REFERENCE_BAND) {
26
+ if (Array.isArray(value)) out[axis].push(value[0], value[1]);
27
+ } else out[axis].push(value);
28
+ });
29
+ return out;
30
+ }
31
+ /** A value as a number on a continuous or time axis, or NaN. */ function numeric(value, time) {
32
+ if (value === undefined || value === null || value === "") return NaN;
33
+ if (time) {
34
+ const d = value instanceof Date ? value : date(value);
35
+ return d instanceof Date ? +d : NaN;
36
+ }
37
+ return typeof value === "number" || typeof value === "string" ? Number(value) : NaN;
38
+ }
39
+ /**
40
+ A continuous or time domain stretched to take in `values`, keeping its
41
+ orientation. Only the ends marked `open` move (an end the user set stays
42
+ put), and a log axis ignores values at or below zero. Returns the domain
43
+ itself when nothing changes.
44
+ @param domain The axis's `[start, end]` domain.
45
+ @param values The values to take in.
46
+ @param options Whether the axis is a time or log axis, and which ends may move.
47
+ */ export function widenToValues(domain, values, options = {}) {
48
+ const { time = false, log = false, open = [
49
+ true,
50
+ true
51
+ ] } = options;
52
+ if (!domain || domain.length !== 2 || !values.length) return domain;
53
+ const ends = domain.map((d)=>numeric(d, time));
54
+ if (!ends.every(Number.isFinite)) return domain;
55
+ const nums = values.map((v)=>numeric(v, time)).filter((n)=>Number.isFinite(n) && (!log || n > 0));
56
+ if (!nums.length) return domain;
57
+ const ascending = ends[0] <= ends[1];
58
+ const [loAt, hiAt] = ascending ? [
59
+ 0,
60
+ 1
61
+ ] : [
62
+ 1,
63
+ 0
64
+ ];
65
+ const lo = Math.min(...nums), hi = Math.max(...nums);
66
+ const out = domain.slice();
67
+ let changed = false;
68
+ if (open[loAt] && lo < ends[loAt]) {
69
+ out[loAt] = time ? new Date(lo) : lo;
70
+ changed = true;
71
+ }
72
+ if (open[hiAt] && hi > ends[hiAt]) {
73
+ out[hiAt] = time ? new Date(hi) : hi;
74
+ changed = true;
75
+ }
76
+ return changed ? out : domain;
77
+ }
78
+ /**
79
+ Which ends of an axis's domain may widen: those the user's domain leaves
80
+ unset (both, without one; the end, for a one-value `[start]`).
81
+ @param user The user's domain for the axis, if any.
82
+ */ export function openDomainEnds(user) {
83
+ if (!Array.isArray(user)) return [
84
+ true,
85
+ true
86
+ ];
87
+ const unset = (v)=>v === undefined || v === null;
88
+ return [
89
+ unset(user[0]),
90
+ user.length < 2 || unset(user[1])
91
+ ];
92
+ }
93
+ /** Scale types whose domain is a continuous extent. */ const CONTINUOUS = new Set([
94
+ "Linear",
95
+ "Time"
96
+ ]);
97
+ /**
98
+ Widens a Plot's auto domains to take in its reference lines and bands
99
+ (from `referenceLines`, `referenceBands`, and `"ReferenceLine"`/
100
+ `"ReferenceBand"` annotations), on continuous and time axes only. An
101
+ end set by the user's domain (`xDomain`, `xConfig.domain`, …) stays put.
102
+ @param viz The chart.
103
+ @param autoDomains Each axis's domain before the baseline is applied.
104
+ @param scales Each axis's scale type (`"Linear"`, `"Time"`, `"Point"`, …) and configured scale (`"log"`, …).
105
+ @param user The user's x and y domains, as `computePlotScales` reads them.
106
+ */ export function widenReferenceDomains(viz, autoDomains, scales, user) {
107
+ const values = referenceDomainValues([
108
+ ...expandReferenceBands(viz.schema.referenceBands),
109
+ ...expandReferenceLines(viz.schema.referenceLines),
110
+ ...viz._annotations || []
111
+ ]);
112
+ const out = {
113
+ ...autoDomains
114
+ };
115
+ [
116
+ "x",
117
+ "y",
118
+ "x2",
119
+ "y2"
120
+ ].forEach((axis)=>{
121
+ const domain = autoDomains[axis];
122
+ if (!domain || !values[axis].length) return;
123
+ if (!CONTINUOUS.has(scales[axis].type)) return;
124
+ const config = viz[`_${axis}Config`]?.domain;
125
+ const given = axis.length === 1 ? user[axis] ?? config : viz.schema[`${axis}Domain`] ?? config;
126
+ out[axis] = widenToValues(domain, values[axis], {
127
+ time: scales[axis].type === "Time",
128
+ log: scales[axis].config === "log",
129
+ open: openDomainEnds(given)
130
+ });
131
+ });
132
+ return out;
133
+ }
@@ -7,14 +7,17 @@
7
7
  their dynamic call-time `this` binding — identical to when this object
8
8
  lived inline in the constructor.
9
9
  */ import { max, min, range } from "d3-array";
10
- import { colorContrast, colorLegible } from "@d3plus/color";
11
- import { backgroundColor, rtl } from "@d3plus/dom";
10
+ import { colorContrast } from "@d3plus/color";
11
+ import { rtl } from "@d3plus/dom";
12
12
  import { largestRect } from "@d3plus/math";
13
13
  import { isValidDate } from "../../components/Axis/timeValues.js";
14
14
  import { constant } from "../../utils/index.js";
15
15
  import { outsideBaselineBreak } from "./baselineBreak.js";
16
16
  import { defaultSize, growsBack, outside } from "./labelPlacement.js";
17
17
  import { axisValue } from "./sharedTooltip.js";
18
+ import { chartBackground } from "../viz/backgroundInk.js";
19
+ import { legibleOn } from "../../utils/themeInk.js";
20
+ import { themed } from "../../utils/theme.js";
18
21
  /** Builds the `Area` shape config; `self` is the Plot instance. */ function areaConfig(self) {
19
22
  return {
20
23
  label: (d, i)=>self.schema.stacked ? self._drawLabel(d, i) : false,
@@ -68,14 +71,14 @@ import { axisValue } from "./sharedTooltip.js";
68
71
  fontResize: true,
69
72
  fontColor (d, i) {
70
73
  if (outside.bind(this)(d, i)) {
71
- const bg = this._backgroundConfig.fill === "transparent" ? backgroundColor(this._select.node()) : this._backgroundConfig.fill;
74
+ const bg = this._backgroundConfig.fill === "transparent" ? chartBackground(this) : this._backgroundConfig.fill;
72
75
  return colorContrast(bg, this.schema.colorDefaults);
73
76
  }
74
77
  return colorContrast(typeof this.schema.shapeConfig.fill === "function" ? this.schema.shapeConfig.fill(d, i) : this.schema.shapeConfig.fill, this.schema.colorDefaults);
75
78
  },
76
79
  fontStroke (d, i) {
77
80
  if (outside.bind(this)(d, i)) {
78
- const bg = this._backgroundConfig.fill === "transparent" ? backgroundColor(this._select.node()) : this._backgroundConfig.fill;
81
+ const bg = this._backgroundConfig.fill === "transparent" ? chartBackground(this) : this._backgroundConfig.fill;
79
82
  return colorContrast(bg, this.schema.colorDefaults);
80
83
  }
81
84
  return "transparent";
@@ -139,7 +142,9 @@ import { axisValue } from "./sharedTooltip.js";
139
142
  labelConfig: {
140
143
  fontColor: (d, i)=>{
141
144
  const c = typeof self.schema.shapeConfig.Line.stroke === "function" ? self.schema.shapeConfig.Line.stroke(d, i) : self.schema.shapeConfig.Line.stroke;
142
- return colorLegible(c);
145
+ // Without a Line stroke of its own, a label reads in the theme's text.
146
+ if (c == null) return themed(self._theme, (t)=>t.text, "rgb(0, 0, 0)");
147
+ return legibleOn(c, Boolean(self._theme?.dark));
143
148
  },
144
149
  fontResize: false,
145
150
  padding: 5,
@@ -0,0 +1,176 @@
1
+ /**
2
+ A stacked Plot's legend order: its series in stacking order, from the
3
+ baseline outward, so the default `"descending"` order lists the largest
4
+ series first. The order is d3-stack's own (each drawn series' `index`),
5
+ which the chart's `stackOrder` sets, whatever the `stackOffset` does
6
+ with it: a diverging stack's negative series and a streamgraph's
7
+ centered layers keep the order they were stacked in.
8
+
9
+ @module
10
+ */ /**
11
+ Where each series sits in the drawn stacks. Each stack (one per discrete
12
+ group) lists its non-empty segments in stacking order (each series'
13
+ d3-stack `index`, else its place in `stackData`), and each segment adds
14
+ its fractional position, `(rank + 0.5) / segments`, to its series. A
15
+ stacked bar keys each segment as its own series, so this also averages
16
+ bars that stack in different orders.
17
+ @param stackData The d3-stack output, `[series][group] = [start, end]`.
18
+ @param stackKeys Each series' stack key, in `stackData` order.
19
+ @param seriesOf The legend series a stack key belongs to; undefined skips it.
20
+ */ export function stackPositions(stackData, stackKeys, seriesOf) {
21
+ const positions = new Map();
22
+ const groups = Math.max(0, ...stackData.map((s)=>s.length));
23
+ for(let j = 0; j < groups; j++){
24
+ const segments = [];
25
+ stackData.forEach((s, i)=>{
26
+ const segment = s[j];
27
+ const series = seriesOf(`${stackKeys[i]}`);
28
+ if (!segment || series === undefined) return;
29
+ const [start, end] = [
30
+ +segment[0],
31
+ +segment[1]
32
+ ];
33
+ if (!Number.isFinite(start) || !Number.isFinite(end) || start === end) return;
34
+ segments.push({
35
+ series,
36
+ order: s.index ?? i
37
+ });
38
+ });
39
+ segments.sort((a, b)=>a.order - b.order);
40
+ segments.forEach(({ series }, rank)=>{
41
+ const entry = positions.get(series) ?? {
42
+ total: 0,
43
+ count: 0
44
+ };
45
+ entry.total += (rank + 0.5) / segments.length;
46
+ entry.count += 1;
47
+ positions.set(series, entry);
48
+ });
49
+ }
50
+ return positions;
51
+ }
52
+ /**
53
+ Combines the positions of several sets of stacks (such as each small
54
+ multiple's) into one.
55
+ @param all Each set's positions.
56
+ */ export function poolStackPositions(all) {
57
+ const pooled = new Map();
58
+ for (const positions of all){
59
+ positions.forEach(({ total, count }, series)=>{
60
+ const entry = pooled.get(series) ?? {
61
+ total: 0,
62
+ count: 0
63
+ };
64
+ pooled.set(series, {
65
+ total: entry.total + total,
66
+ count: entry.count + count
67
+ });
68
+ });
69
+ }
70
+ return pooled;
71
+ }
72
+ /**
73
+ The series in reading order: by mean position, ties in the order the
74
+ positions list them.
75
+ @param positions Each series' stack positions.
76
+ */ export function stackReadingOrder(positions) {
77
+ const mean = (s)=>{
78
+ const { total, count } = positions.get(s);
79
+ return total / count;
80
+ };
81
+ return Array.from(positions.keys()).sort((a, b)=>mean(a) - mean(b));
82
+ }
83
+ /**
84
+ The drawn order with the series it left out (hidden or soloed away)
85
+ kept in their previous place: each follows the series it followed
86
+ before, so hiding a series doesn't move it in the legend.
87
+ @param previous The order of the previous draw.
88
+ @param drawn The order of this draw.
89
+ @param keep The series still in the legend; others in `previous` drop out.
90
+ */ export function mergeStackOrder(previous, drawn, keep) {
91
+ const out = drawn.slice();
92
+ const placed = new Set(drawn);
93
+ let anchor;
94
+ for (const series of previous){
95
+ if (!placed.has(series)) {
96
+ if (!keep.has(series)) continue;
97
+ const at = anchor === undefined ? 0 : out.indexOf(anchor) + 1;
98
+ out.splice(at, 0, series);
99
+ placed.add(series);
100
+ }
101
+ anchor = series;
102
+ }
103
+ return out;
104
+ }
105
+ /**
106
+ The ids of the Plot series a row or legend entry stands for: its groupBy
107
+ values down to the drawn depth, joined like a Plot row's `id`. A legend
108
+ entry merging several series (an array at some level) stands for each
109
+ combination.
110
+ @param viz The chart.
111
+ @param d A row or legend entry.
112
+ @param i Its index.
113
+ */ export function plotSeriesIds(viz, d, i) {
114
+ let ids = [
115
+ []
116
+ ];
117
+ const depth = viz._drawDepth ?? 0;
118
+ for(let level = 0; level <= depth; level++){
119
+ const groupBy = viz.schema.groupBy?.[level];
120
+ if (typeof groupBy !== "function") break;
121
+ const value = groupBy.bind(viz)(d, i);
122
+ const values = (Array.isArray(value) ? value : [
123
+ value
124
+ ]).map((v)=>`${v}`).filter(Boolean);
125
+ if (!values.length) continue;
126
+ ids = ids.flatMap((path)=>values.map((v)=>[
127
+ ...path,
128
+ v
129
+ ]));
130
+ }
131
+ return ids.map((path)=>path.join("_"));
132
+ }
133
+ /**
134
+ Records a draw's stack positions as the legend's order (see
135
+ `stackLegendSort`), keeping series the draw left out where they were.
136
+ Undefined positions (an unstacked draw) clear it.
137
+ @param viz The chart.
138
+ @param positions The draw's stack positions.
139
+ */ export function recordStackLegendOrder(viz, positions) {
140
+ if (!positions?.size) {
141
+ viz._stackLegendOrder = undefined;
142
+ return;
143
+ }
144
+ const keep = new Set((viz._legendData ?? []).flatMap((d, i)=>plotSeriesIds(viz, d, i)));
145
+ viz._stackLegendOrder = mergeStackOrder(viz._stackLegendOrder ?? [], stackReadingOrder(positions), keep);
146
+ }
147
+ /**
148
+ A stacked Plot's default legend comparator: entries in the order of
149
+ `viz._stackLegendOrder` (an entry merging several series sits at their
150
+ mean place), then the entries the stacks don't place, with ties broken
151
+ by `fallback`. An unstacked chart sorts by `fallback` alone.
152
+ @param viz The chart.
153
+ @param fallback The comparator for everything the stack order doesn't settle.
154
+ */ export function stackLegendSort(viz, fallback) {
155
+ let cached;
156
+ let index = new Map();
157
+ const place = (d)=>{
158
+ const ranks = plotSeriesIds(viz, d, 0).map((id)=>index.get(id)).filter((r)=>r !== undefined);
159
+ return ranks.length ? ranks.reduce((a, b)=>a + b, 0) / ranks.length : Infinity;
160
+ };
161
+ return (a, b)=>{
162
+ const order = viz.schema.stacked ? viz._stackLegendOrder : undefined;
163
+ if (order?.length) {
164
+ if (order !== cached) {
165
+ cached = order;
166
+ index = new Map(order.map((id, rank)=>[
167
+ id,
168
+ rank
169
+ ]));
170
+ }
171
+ const pa = place(a), pb = place(b);
172
+ if (pa !== pb) return pa < pb ? -1 : 1;
173
+ }
174
+ return fallback(a, b);
175
+ };
176
+ }
@@ -0,0 +1,183 @@
1
+ /**
2
+ Trend line labels (`trendLineConfig.label`): text along each fitted line,
3
+ near its end and just above it, kept upright, in the line's color over a
4
+ halo of the chart's background. A label too long for its line is cut
5
+ short with an ellipsis; a line too short for a label gets none.
6
+ */ import { fontExists, textWidth } from "@d3plus/dom";
7
+ import { pathTextBoxes } from "@d3plus/render";
8
+ import { fontFamily as defaultFontFamily } from "@d3plus/text";
9
+ import { labelsOverlap } from "../features/linkLabelGeometry.js";
10
+ import { textLineBoxes } from "../features/linkLabels.js";
11
+ import { offsetPolyline, polylineD, polylineLength, trimPolyline, uprightPoints, visibleRun } from "../features/pathLabelGeometry.js";
12
+ import { PATH_LABEL_FONT_SIZE, pathLabelNodes } from "../features/pathLabels.js";
13
+ import { coefficientFormat, trendEquation } from "./trendTooltip.js";
14
+ /** How far a label stops short of its line's end, in pixels. */ const END_INSET = 6;
15
+ /**
16
+ A fit's equation and R² as label text, e.g. `y = 2.1x + 3.4, R² = 0.84`,
17
+ its coefficients abbreviated as the axes abbreviate numbers. A fit along
18
+ a time axis shows only its R² (an equation in milliseconds since 1970
19
+ says nothing a reader can use).
20
+ @param fit The fitted trend line.
21
+ @param locale The chart's locale.
22
+ @param time Whether the fit runs along a time axis.
23
+ */ export function trendEquationLabel(fit, locale, time = false) {
24
+ const r2 = `R² = ${fit.fit.r2.toFixed(2)}`;
25
+ if (time) return r2;
26
+ return `${trendEquation(fit.fit, coefficientFormat(locale), fit.axis)}, ${r2}`;
27
+ }
28
+ /**
29
+ A fit's label text for a `trendLineConfig.label` setting, or null for
30
+ none: `true` names the series ("Trend" for a line fit to every point),
31
+ `"equation"` gives its equation and R², and a function returns any text.
32
+ @param viz The chart.
33
+ @param fit The fitted trend line.
34
+ @param setting The configured label.
35
+ */ export function trendLabelText(viz, fit, setting) {
36
+ if (!setting) return null;
37
+ if (typeof setting === "function") {
38
+ const text = setting(fit);
39
+ return text === false || text === null || text === undefined || text === "" ? null : `${text}`;
40
+ }
41
+ if (setting === "equation") return trendEquationLabel(fit, viz.schema.locale, Boolean(viz[`_${fit.axis}Time`]));
42
+ return fit.row ? fit.label : viz.schema.translate("Trend");
43
+ }
44
+ /** The boxes a label covers along `d`, `width` long from its start. */ function pathBoxes(d, width, fontSize) {
45
+ return pathTextBoxes({
46
+ type: "text",
47
+ key: "",
48
+ x: 0,
49
+ y: 0,
50
+ font: {
51
+ size: fontSize,
52
+ anchor: "start"
53
+ },
54
+ lines: [
55
+ {
56
+ text: " ",
57
+ x: 0,
58
+ y: 0,
59
+ width
60
+ }
61
+ ],
62
+ path: {
63
+ d
64
+ }
65
+ });
66
+ }
67
+ /** Whether a box comes within a few pixels of any obstacle (more along the text, so neighbors read apart). */ const blocked = (box, obstacles)=>{
68
+ const grown = {
69
+ ...box,
70
+ width: box.width + 12,
71
+ height: box.height + 4
72
+ };
73
+ return obstacles.some((o)=>labelsOverlap(grown, o));
74
+ };
75
+ /**
76
+ The path a fit's label follows and the boxes it covers, or null when its
77
+ line has no clear spot for it: the drawn (not projected) stretch inside
78
+ the plot, upright, stopped short of its end. The label prefers the end of
79
+ the line, just above it; when that spot overlaps an earlier label it
80
+ slides back along the line to the nearest clear stretch, then tries the
81
+ same below the line. A line too short for a few letters gets none.
82
+ @param points The fitted stretch's points, in pixels.
83
+ @param rect The plot area.
84
+ @param place The font, lift, text width, and labels to clear.
85
+ */ export function trendLabelSpot(points, rect, place) {
86
+ const { fontSize, lift, width, obstacles } = place;
87
+ const run = uprightPoints(visibleRun(points, rect));
88
+ const end = polylineLength(run) - END_INSET;
89
+ // Room for a few letters and their ellipsis, at least.
90
+ if (end < fontSize * 4) return null;
91
+ const span = Math.min(width, end);
92
+ const step = fontSize / 2;
93
+ // Above the line, then below it (its baseline a letter's height lower).
94
+ for (const baseline of [
95
+ lift,
96
+ -(lift + fontSize * 0.75)
97
+ ])for(let to = end; to - span >= -1e-9; to -= step){
98
+ const d = polylineD(offsetPolyline(trimPolyline(run, Math.max(0, to - span), to), baseline));
99
+ const boxes = pathBoxes(d, span, fontSize);
100
+ if (!boxes.some((b)=>blocked(b, obstacles))) return {
101
+ d,
102
+ boxes
103
+ };
104
+ if (span >= end) break;
105
+ }
106
+ return null;
107
+ }
108
+ /**
109
+ The boxes of the labels a trend label must clear: the line labels at the
110
+ lines' ends and along them, and Hexbin's contour labels, wherever they
111
+ sit among the marks.
112
+ @param marks The plot's marks.
113
+ */ export function lineLabelBoxes(marks) {
114
+ const out = [];
115
+ const visit = (node, ox, oy)=>{
116
+ const x = ox + (node.transform?.x ?? 0), y = oy + (node.transform?.y ?? 0);
117
+ if (node.type === "group") node.children.forEach((c)=>visit(c, x, y));
118
+ if (node.type !== "text") return;
119
+ const row = node.datum;
120
+ const along = /^(line-label-along|contour-label)-/.test(`${node.key}`);
121
+ if (!along && row?.data?.shape !== "Line") return;
122
+ for (const box of textLineBoxes([
123
+ node
124
+ ]))out.push({
125
+ ...box,
126
+ x: box.x + ox,
127
+ y: box.y + oy
128
+ });
129
+ };
130
+ marks.forEach((n)=>visit(n, 0, 0));
131
+ return out;
132
+ }
133
+ /**
134
+ The label nodes for every fitted trend line, when `trendLineConfig.label`
135
+ asks for them, placed one at a time (in series order) so none overlaps
136
+ another or the plot's line labels.
137
+ @param viz The chart.
138
+ @param x Maps an x value to pixels.
139
+ @param y Maps a y value to pixels.
140
+ @param rect The plot area.
141
+ @param marks The plot's marks, for the line labels to clear.
142
+ */ export function emitTrendLabels(viz, x, y, rect, marks = []) {
143
+ const config = viz._trendLineConfig || {};
144
+ const setting = config.label;
145
+ const fits = viz._trendFits || [];
146
+ if (!setting || !fits.length) return [];
147
+ const labelConfig = config.labelConfig || {};
148
+ const fontSize = typeof labelConfig.fontSize === "number" ? labelConfig.fontSize : PATH_LABEL_FONT_SIZE;
149
+ const strokeWidth = typeof config.strokeWidth === "number" ? config.strokeWidth : 2;
150
+ const style = {
151
+ "font-family": fontExists(labelConfig.fontFamily ?? defaultFontFamily),
152
+ "font-size": fontSize,
153
+ "font-weight": labelConfig.fontWeight ?? 600
154
+ };
155
+ const obstacles = lineLabelBoxes(marks);
156
+ const labels = fits.flatMap((fit)=>{
157
+ const text = trendLabelText(viz, fit, setting);
158
+ if (!text) return [];
159
+ const points = fit.samples.filter((s)=>!s.projected).map((s)=>[
160
+ x(s.x),
161
+ y(s.y)
162
+ ]);
163
+ const spot = trendLabelSpot(points, rect, {
164
+ fontSize,
165
+ lift: strokeWidth / 2 + 2,
166
+ // A little past the measured text, for the ellipsis's rounding.
167
+ width: textWidth(text, style) + 2,
168
+ obstacles
169
+ });
170
+ if (!spot) return [];
171
+ obstacles.push(...spot.boxes);
172
+ return [
173
+ {
174
+ key: `trend-label-${fit.id}`,
175
+ text,
176
+ d: spot.d,
177
+ color: fit.color,
178
+ anchor: "end"
179
+ }
180
+ ];
181
+ });
182
+ return pathLabelNodes(viz, labels, labelConfig);
183
+ }
@@ -23,6 +23,7 @@ import { projectionPositions } from "./trendProjection.js";
23
23
  },
24
24
  confidenceLevel: 0.95,
25
25
  group: "series",
26
+ label: "equation",
26
27
  order: 2,
27
28
  projection: 0,
28
29
  projectionConfig: {
@@ -4,6 +4,7 @@
4
4
  projection past the data, styled by `projectionConfig`), in one
5
5
  stably-keyed group so frames tween rather than re-enter.
6
6
  */ import { collectComputed, makeShape } from "../features/emitHelpers.js";
7
+ import { effectiveDuration } from "../viz/reducedMotion.js";
7
8
  /** `trendLineConfig` keys that drive the fit or band; the rest style the Line. */ const FIT_KEYS = [
8
9
  "group",
9
10
  "order",
@@ -13,7 +14,9 @@
13
14
  "projection",
14
15
  "projectionConfig",
15
16
  "tooltip",
16
- "stroke"
17
+ "stroke",
18
+ "label",
19
+ "labelConfig"
17
20
  ];
18
21
  /**
19
22
  Stamps a subtree as trend chrome: pickable only when it carries a tooltip
@@ -52,7 +55,7 @@
52
55
  const children = [];
53
56
  const id = ()=>`trend-${fit.id}`;
54
57
  if (fit.samples[0].lci !== undefined) {
55
- const band = makeShape("Area").renderMode("compute").duration(viz.schema.duration).data(fit.samples).config({
58
+ const band = makeShape("Area").renderMode("compute").duration(effectiveDuration(viz)).data(fit.samples).config({
56
59
  id,
57
60
  label: false,
58
61
  fill: fit.color,
@@ -64,7 +67,7 @@
64
67
  const paint = Object.fromEntries(Object.entries(config).filter(([key])=>!FIT_KEYS.includes(key)));
65
68
  const line = (samples, key, style)=>{
66
69
  if (samples.length < 2) return;
67
- const shape = makeShape("Line").renderMode("compute").duration(viz.schema.duration).data(samples).config({
70
+ const shape = makeShape("Line").renderMode("compute").duration(effectiveDuration(viz)).data(samples).config({
68
71
  ...paint,
69
72
  id: key,
70
73
  label: false,
@@ -59,7 +59,11 @@ const SUPERSCRIPTS = {
59
59
  }
60
60
  return `${y} = ${rhs}`;
61
61
  }
62
- /** Abbreviates a coefficient, keeping three significant digits on tiny values. */ function coefficientFormat(locale) {
62
+ /**
63
+ Abbreviates a coefficient as the axes abbreviate their numbers, keeping
64
+ three significant digits on tiny values.
65
+ @param locale The chart's locale.
66
+ */ export function coefficientFormat(locale) {
63
67
  return (n)=>n !== 0 && Math.abs(n) < 1e-3 ? n.toPrecision(3) : formatAbbreviate(n, locale);
64
68
  }
65
69
  /**
@@ -11,12 +11,12 @@ import { fieldAccessor } from "../../utils/fieldAccessor.js";
11
11
  import { centerChartTransform, chartBounds } from "../features/chartGeometry.js";
12
12
  import { makeChart } from "../definition/makeChart.js";
13
13
  import { sceneInsetRegion } from "../pipeline/insetPlacement.js";
14
- import { backgroundColor } from "@d3plus/dom";
15
14
  import { rowLegend } from "../features/sharedFields.js";
16
15
  import { polarAxisConfig, polarValueRow } from "../polar/config.js";
17
16
  import { polarFacetHooks } from "../polar/polarFacet.js";
18
17
  import { applyPolarAreaLayout, polarAreaDomainValues } from "./applyLayout.js";
19
18
  import { polarAreaEmit } from "./emit.js";
19
+ import { chartBackground } from "../viz/backgroundInk.js";
20
20
  export const polarAreaDef = {
21
21
  name: "PolarArea",
22
22
  layoutStage: applyPolarAreaLayout,
@@ -145,7 +145,7 @@ export const polarAreaDef = {
145
145
  factory: (viz)=>({
146
146
  // A thin outline in the chart's background color separates
147
147
  // neighboring wedges by the same width everywhere.
148
- stroke: ()=>backgroundColor(viz._select?.node()),
148
+ stroke: ()=>chartBackground(viz),
149
149
  strokeWidth: 1
150
150
  })
151
151
  },
@@ -9,6 +9,7 @@
9
9
  import * as scales from "d3-scale";
10
10
  import { date } from "@d3plus/dom";
11
11
  import { nestGroups } from "@d3plus/data";
12
+ import { measureTimeAxis, renderTimeAxis } from "./timeAxis.js";
12
13
  /** Greedy first-fit lane packer; mutates `d.lane` and returns total lane count. */ const packLanes = (nested)=>{
13
14
  let maxLane = 0;
14
15
  nested.forEach((g)=>{
@@ -29,7 +30,7 @@ import { nestGroups } from "@d3plus/data";
29
30
  return maxLane;
30
31
  };
31
32
  /** Runs both axes, pushes the axis scene, and stashes scales/bandWidth on `viz.ctx`. */ const runAxesAndScales = (viz, data, maxLane)=>{
32
- const cfg = {
33
+ const frame = {
33
34
  domain: [
34
35
  min(data, (d)=>Number(d.start)) ?? 0,
35
36
  max(data, (d)=>Number(d.end)) ?? 0
@@ -37,27 +38,20 @@ import { nestGroups } from "@d3plus/data";
37
38
  height: viz.schema.height - viz._margin.top - viz._margin.bottom,
38
39
  width: viz.schema.width - viz._margin.left - viz._margin.right
39
40
  };
40
- const axisTest = viz.ctx.axisTest;
41
- const axis = viz.ctx.axis;
42
- axisTest.config(cfg).config(viz.schema.axisConfig).measure();
43
- axis.config(cfg).config(viz.schema.axisConfig).renderMode("compute").select(undefined).render();
44
- const axisScene = axis.toScene();
45
- if (axisScene) {
46
- (viz._chartScene ||= []).push({
47
- type: "group",
48
- key: "priestley-axis",
49
- transform: {
50
- x: viz._margin.left,
51
- y: viz._margin.top
52
- },
53
- children: axisScene.children ?? []
54
- });
55
- }
41
+ const axis = measureTimeAxis(viz, frame);
42
+ const xScale = renderTimeAxis(viz, {
43
+ ...frame,
44
+ transform: {
45
+ x: viz._margin.left,
46
+ y: viz._margin.top
47
+ },
48
+ key: "priestley-axis"
49
+ });
56
50
  const yScale = scales.scaleBand().domain(range(0, maxLane, 1).map(String)).paddingInner(viz.schema.paddingInner).paddingOuter(viz.schema.paddingOuter).rangeRound([
57
- viz.schema.height - viz._margin.bottom - axisTest.outerBounds().height - axisTest.schema.padding,
58
- viz._margin.top + axisTest.schema.padding
51
+ viz.schema.height - viz._margin.bottom - axis.height - axis.padding,
52
+ viz._margin.top + axis.padding
59
53
  ]);
60
- viz.ctx.xScale = axis._d3Scale;
54
+ viz.ctx.xScale = xScale;
61
55
  viz.ctx.yScale = yScale;
62
56
  viz.ctx.bandWidth = yScale.bandwidth();
63
57
  };