@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
@@ -10,14 +10,62 @@
10
10
  */ import { groups, max, min } from "d3-array";
11
11
  import { textWidth as d3plusTextWidth } from "@d3plus/dom";
12
12
  import { shapeConfigFor } from "../features/emitHelpers.js";
13
- /** Measures one line's label (width, position, overlap coords). */ function measureLineLabel([lineKey, lineValues], ctx) {
14
- const { labelFunction, fontColorAccessor, fontSizeAccessor, fontWeightAccessor, fontFamilyAccessor, paddingAccessor, xEstimate, yEstimate } = ctx;
15
- let d = lineValues[lineValues.length - 1];
13
+ import { axisValue } from "./sharedTooltip.js";
14
+ import { lineLabelText, lineLabelValue, rowLineLabelSides } from "./lineLabelSides.js";
15
+ /**
16
+ Shortens a label to fit `maxWidth`: the name and value when both fit,
17
+ else the name alone, else the name cut short with an ellipsis, else
18
+ `null` (no room for even one letter).
19
+ */ export function fitLineLabelText(name, value, maxWidth, measure) {
20
+ if (measure(value === undefined ? name : lineLabelText(name, value)) <= maxWidth) return value === undefined ? {
21
+ name
22
+ } : {
23
+ name,
24
+ value
25
+ };
26
+ if (value !== undefined && measure(name) <= maxWidth) return {
27
+ name
28
+ };
29
+ const cut = (n)=>`${name.slice(0, n).trimEnd()}\u2026`;
30
+ let lo = 1, hi = name.length - 1, best = 0;
31
+ while(lo <= hi){
32
+ const mid = lo + hi >> 1;
33
+ if (measure(cut(mid)) <= maxWidth) {
34
+ best = mid;
35
+ lo = mid + 1;
36
+ } else hi = mid - 1;
37
+ }
38
+ return best ? {
39
+ name: cut(best)
40
+ } : null;
41
+ }
42
+ /**
43
+ The most room the labels at one end of a line chart may take: a quarter
44
+ of its `width` past its y axis (`yWidth`), so labels at both ends leave
45
+ the plot at least half of that, and labels never crowd the plot out of a
46
+ narrow chart or a small-multiples panel.
47
+ */ export function lineLabelCap(width, yWidth = 0) {
48
+ return Math.max(0, width - yWidth) / 4;
49
+ }
50
+ /** Unwraps a formatted Plot row to its source datum and that datum's index. */ function sourceRow(row) {
51
+ let d = row;
16
52
  let i;
17
53
  while(d.__d3plus__ && d.data){
18
54
  d = d.data;
19
55
  i = d.i;
20
56
  }
57
+ return {
58
+ d,
59
+ i
60
+ };
61
+ }
62
+ /**
63
+ Measures one end of a line's label (width, position, overlap coords): its
64
+ right end (`"end"`, the last point across) or its left end (`"start"`).
65
+ */ export function measureLineLabel([lineKey, lineValues], ctx, side = "end") {
66
+ const { labelFunction, fontColorAccessor, fontSizeAccessor, fontWeightAccessor, fontFamilyAccessor, paddingAccessor, xEstimate, yEstimate } = ctx;
67
+ const end = side === "end";
68
+ const { d, i } = sourceRow(lineValues[end ? lineValues.length - 1 : 0]);
21
69
  const label = typeof labelFunction === "function" ? labelFunction(d, i) : labelFunction;
22
70
  const fontColor = typeof fontColorAccessor === "function" ? fontColorAccessor(d, i) : fontColorAccessor;
23
71
  const fontSize = typeof fontSizeAccessor === "function" ? fontSizeAccessor(d, i) : fontSizeAccessor;
@@ -25,20 +73,36 @@ import { shapeConfigFor } from "../features/emitHelpers.js";
25
73
  let fontFamily = typeof fontFamilyAccessor === "function" ? fontFamilyAccessor(d, i) : fontFamilyAccessor;
26
74
  if (Array.isArray(fontFamily)) fontFamily = fontFamily.map((f)=>`'${f}'`).join(", ");
27
75
  const labelPadding = typeof paddingAccessor === "function" ? paddingAccessor(d, i) : paddingAccessor;
28
- const labelWidth = d3plusTextWidth(label, {
29
- "font-size": fontSize,
30
- "font-family": fontFamily,
31
- "font-weight": fontWeight
32
- });
33
76
  const coords = lineValues.map((d)=>[
34
77
  xEstimate(d.x),
35
78
  yEstimate(d.y)
36
79
  ]);
37
- // A line always has values, so the max is defined.
38
- const myMaxX = max(lineValues.map((d)=>xEstimate(d.x)));
39
- const labelY = lineValues.find((d)=>xEstimate(d.x) === myMaxX).y;
80
+ // A line always has values, so the extent is defined.
81
+ const xs = lineValues.map((d)=>xEstimate(d.x));
82
+ const edgeX = end ? max(xs) : min(xs);
83
+ const edgeRow = lineValues.find((d)=>xEstimate(d.x) === edgeX);
84
+ const labelY = edgeRow.y;
85
+ let valueText = ctx.valueText(labelY, edgeRow);
86
+ const font = {
87
+ "font-size": fontSize,
88
+ "font-family": fontFamily,
89
+ "font-weight": fontWeight
90
+ };
91
+ let labelWidth = d3plusTextWidth(valueText === undefined ? label : lineLabelText(label, valueText), font);
92
+ // A label wider than its room drops its value, then shortens its name.
93
+ let name;
94
+ if (ctx.maxSpace !== undefined && labelWidth + labelPadding * 4 > ctx.maxSpace) {
95
+ const fit = fitLineLabelText(`${label}`, valueText, ctx.maxSpace - labelPadding * 4, (text)=>d3plusTextWidth(text, font));
96
+ if (!fit) return null;
97
+ name = fit.name;
98
+ valueText = fit.value;
99
+ labelWidth = d3plusTextWidth(valueText === undefined ? name : lineLabelText(name, valueText), font);
100
+ }
40
101
  return {
41
102
  id: lineKey,
103
+ side,
104
+ name,
105
+ valueText,
42
106
  labelWidth: labelWidth + labelPadding * 2,
43
107
  spaceNeeded: labelWidth + labelPadding * 4,
44
108
  value: labelY,
@@ -46,17 +110,21 @@ import { shapeConfigFor } from "../features/emitHelpers.js";
46
110
  padding: labelPadding,
47
111
  fontSize,
48
112
  fontColor,
49
- maxX: myMaxX,
50
- xValue: max(lineValues, (d)=>d.x),
113
+ edgeX,
114
+ // The x value at the labeled end, which the connectors and bumping
115
+ // group by: on a reversed or categorical axis, not the largest x.
116
+ xValue: edgeRow.x,
51
117
  coords
52
118
  };
53
119
  }
54
120
  /**
55
- Whether another line passes through the space `label` would occupy to the
56
- right of its line's last point.
57
- */ function labelOverlapsLine(label, labels) {
58
- const { fontSize, id, labelWidth, maxX, yEstimate } = label;
59
- const closeLabels = labels.filter((l)=>l.id !== id && l.coords.some((c)=>(c[0] > maxX || c[0] === maxX && l.maxX !== maxX) && c[0] <= maxX + labelWidth && c[1] <= yEstimate + fontSize * 0.75 && c[1] >= yEstimate - fontSize * 0.75));
121
+ Whether another line passes through the space `label` would occupy past
122
+ its line's end: right of its last point, or left of its first point for a
123
+ `"start"` label.
124
+ */ export function labelOverlapsLine(label, labels) {
125
+ const { fontSize, id, labelWidth, edgeX, side, yEstimate } = label;
126
+ const dir = side === "start" ? -1 : 1;
127
+ const closeLabels = labels.filter((l)=>l.id !== id && l.coords.some((c)=>((c[0] - edgeX) * dir > 0 || c[0] === edgeX && l.edgeX !== edgeX) && (edgeX + labelWidth * dir - c[0]) * dir >= 0 && c[1] <= yEstimate + fontSize * 0.75 && c[1] >= yEstimate - fontSize * 0.75));
60
128
  return closeLabels.length !== 0;
61
129
  }
62
130
  /**
@@ -91,27 +159,34 @@ import { shapeConfigFor } from "../features/emitHelpers.js";
91
159
  return test._getPosition.bind(test)(d);
92
160
  };
93
161
  }
162
+ /** The y-sorted labels for one end of every line, less those another line runs through. */ function measureSide(lineData, ctx, side, yDomain) {
163
+ return lineData.map((entry)=>measureLineLabel(entry, ctx, side)).filter((d)=>d !== null).sort((a, b)=>yDomain[1] > yDomain[0] ? a.value - b.value : b.value - a.value).filter((d, _i, arr)=>!labelOverlapsLine(d, arr));
164
+ }
165
+ /**
166
+ The room the labels at one end of the plot claim: the widest label among
167
+ the lines that end at the x range's `edge`, at most `cap`; 0 when no line
168
+ reaches that edge.
169
+ */ export function lineLabelSpace(labels, edge, cap) {
170
+ const spaceNeeded = max(labels.filter((d)=>d.edgeX === edge), (d)=>d.spaceNeeded);
171
+ return spaceNeeded ? min([
172
+ spaceNeeded,
173
+ cap
174
+ ]) : 0;
175
+ }
176
+ const noLabels = ()=>({
177
+ plotLabelWidths: [],
178
+ plotLargestLabel: undefined,
179
+ plotXRangeMax: undefined,
180
+ plotStartLabelSpace: 0
181
+ });
94
182
  export const measurePlotLineLabels = ({ viz, plotFormattedData, plotScales, plotConfigScales, plotTestAxes, plotLineLabelTest, y2Exists })=>{
95
183
  const data = plotFormattedData || [];
96
- if (!viz.schema.lineLabels || y2Exists) {
97
- return {
98
- plotLabelWidths: [],
99
- plotLargestLabel: undefined,
100
- plotXRangeMax: undefined
101
- };
102
- }
103
- const labelData = data.filter((d)=>{
104
- if (d.shape !== "Line") return false;
105
- return typeof viz.schema.lineLabels === "function" ? viz.schema.lineLabels(d.data, d.i) : true;
106
- });
184
+ const setting = viz.schema.lineLabels;
185
+ if (!setting || y2Exists) return noLabels();
186
+ const sidesOf = (d)=>rowLineLabelSides(setting, d.data, d.i);
187
+ const labelData = data.filter((d)=>d.shape === "Line" && sidesOf(d).length > 0);
107
188
  const lineData = groups(labelData, (d)=>d.id);
108
- if (!lineData.length) {
109
- return {
110
- plotLabelWidths: [],
111
- plotLargestLabel: undefined,
112
- plotXRangeMax: undefined
113
- };
114
- }
189
+ if (!lineData.length) return noLabels();
115
190
  const { testLineShape, testTextBox } = plotLineLabelTest;
116
191
  const { xTest, yTest } = plotTestAxes;
117
192
  const xDomain = plotScales.x.domain();
@@ -119,26 +194,43 @@ export const measurePlotLineLabels = ({ viz, plotFormattedData, plotScales, plot
119
194
  const xConfigScale = plotConfigScales.xConfigScale;
120
195
  const yConfigScale = plotConfigScales.yConfigScale;
121
196
  const width = viz.schema.width - viz._margin.left - viz._margin.right;
197
+ const config = viz.schema.lineLabelConfig;
122
198
  const labelCtx = {
123
199
  ...lineLabelStyle(viz, testLineShape, testTextBox),
124
200
  xEstimate: axisEstimate(xTest, xConfigScale, xDomain),
125
- yEstimate: axisEstimate(yTest, yConfigScale, yDomain)
201
+ yEstimate: axisEstimate(yTest, yConfigScale, yDomain),
202
+ valueText: (value, row)=>{
203
+ const { d, i } = sourceRow(row);
204
+ return lineLabelValue(config, value, d, i, (v)=>axisValue(viz, "y", v));
205
+ }
126
206
  };
127
- const labelWidths = lineData.map((entry)=>measureLineLabel(entry, labelCtx)).sort((a, b)=>yDomain[1] > yDomain[0] ? a.value - b.value : b.value - a.value).filter((d, _i, arr)=>!labelOverlapsLine(d, arr));
128
- const maxX = max(labelWidths, (d)=>d.maxX);
129
- const largestLabel = max(labelWidths.map((d)=>d.labelWidth));
130
- let xRangeMax;
131
- const spaceNeeded = maxX === xTest._getRange.bind(xTest)()[1] ? max(labelWidths.filter((d)=>d.maxX === maxX), (d)=>d.spaceNeeded) : 0;
132
- if (spaceNeeded) {
133
- const labelSpace = min([
134
- spaceNeeded,
135
- width / 4
136
- ]);
137
- xRangeMax = width - labelSpace - viz._margin.right;
138
- }
207
+ // Each end labels the lines whose row at that end asks for it.
208
+ const sideLines = (side)=>lineData.filter(([, values])=>{
209
+ const row = side === "end" ? values[values.length - 1] : values[0];
210
+ return sidesOf(row).includes(side);
211
+ });
212
+ const [startLines, endLines] = [
213
+ sideLines("start"),
214
+ sideLines("end")
215
+ ];
216
+ const yBounds = yTest.outerBounds();
217
+ const cap = lineLabelCap(width, yBounds.width ? yBounds.width + yTest.padding() : 0);
218
+ const sideCtx = {
219
+ ...labelCtx,
220
+ maxSpace: cap
221
+ };
222
+ const startLabels = measureSide(startLines, sideCtx, "start", yDomain);
223
+ const endLabels = measureSide(endLines, sideCtx, "end", yDomain);
224
+ const [rangeStart, rangeEnd] = xTest._getRange.bind(xTest)();
225
+ const endSpace = lineLabelSpace(endLabels, max(endLabels, (d)=>d.edgeX), cap);
226
+ const startSpace = lineLabelSpace(startLabels, min(startLabels, (d)=>d.edgeX), cap);
139
227
  return {
140
- plotLabelWidths: labelWidths,
141
- plotLargestLabel: largestLabel,
142
- plotXRangeMax: xRangeMax
228
+ plotLabelWidths: [
229
+ ...startLabels,
230
+ ...endLabels
231
+ ],
232
+ plotLargestLabel: max(endLabels.map((d)=>d.labelWidth)),
233
+ plotXRangeMax: endSpace && max(endLabels, (d)=>d.edgeX) === rangeEnd ? width - endSpace : undefined,
234
+ plotStartLabelSpace: startSpace && min(startLabels, (d)=>d.edgeX) === rangeStart ? startSpace : 0
143
235
  };
144
236
  };
@@ -9,6 +9,8 @@ import { userDomainBreaksBaseline } from "./baselineBreak.js";
9
9
  import { configOpenDomain, userAxisDomain } from "./baselineDomain.js";
10
10
  import { openEnd } from "./openDomainEnds.js";
11
11
  import { isSpanAxis } from "./discreteSpan.js";
12
+ import { widenReferenceDomains } from "./referenceDomains.js";
13
+ import { plotTimeScale } from "./plotRangeBreaks.js";
12
14
  /** d3-scale's scale constructors, indexed by the dynamic `scale<Type>` name. */ export const scaleConstructors = scales;
13
15
  /**
14
16
  A copy of a user `<axis>Domain`. On a time axis its set ends are parsed
@@ -86,6 +88,12 @@ import { isSpanAxis } from "./discreteSpan.js";
86
88
  }
87
89
  });
88
90
  }
91
+ /**
92
+ One plot axis's scale over `d` across `size` pixels. A time axis with
93
+ `rangeBreaks` hides the same time here as on the axis.
94
+ */ function plotAxisScale(viz, axis, type, d, size) {
95
+ return plotTimeScale(viz, axis, scaleConstructors[`scale${type}`]().domain(d).range(range(0, size + 1, size / (d.length - 1))));
96
+ }
89
97
  /**
90
98
  `computePlotScales` — fourth stage of Plot's pipeline. Takes the per-axis
91
99
  values + the chart's raw `domains` object (computed by the inline
@@ -126,29 +134,53 @@ import { isSpanAxis } from "./discreteSpan.js";
126
134
  const y2ConfigScale = autoScale(viz, axisData, "y2", y2Scale).toLowerCase();
127
135
  const xConfigScale = autoScale(viz, axisData, "x", xScale).toLowerCase();
128
136
  const x2ConfigScale = autoScale(viz, axisData, "x2", x2Scale).toLowerCase();
137
+ const widened = widenReferenceDomains(viz, {
138
+ x: xAutoDomain,
139
+ y: yAutoDomain,
140
+ x2: x2AutoDomain,
141
+ y2: y2AutoDomain
142
+ }, {
143
+ x: {
144
+ type: xScale,
145
+ config: xConfigScale
146
+ },
147
+ y: {
148
+ type: yScale,
149
+ config: yConfigScale
150
+ },
151
+ x2: {
152
+ type: x2Scale,
153
+ config: x2ConfigScale
154
+ },
155
+ y2: {
156
+ type: y2Scale,
157
+ config: y2ConfigScale
158
+ }
159
+ }, user);
129
160
  // `.slice()` the fallback so domains.x2 isn't ALIASED to domains.x
130
161
  // (and same for y2 ↔ y). Without the slice, later in this function
131
162
  // the baseline-extension loop does `domains[o][0] = b` — when `o`
132
163
  // is 'y2' aliased to y, that mutation hits domains.y too, silently
133
164
  // clobbering the y-axis bottom. Sibling of the d.reverse() fix.
134
165
  domains = {
135
- x: xAutoDomain,
136
- x2: x2AutoDomain || xAutoDomain.slice(),
137
- y: yAutoDomain,
138
- y2: y2AutoDomain || yAutoDomain.slice()
166
+ x: widened.x,
167
+ x2: widened.x2 || widened.x.slice(),
168
+ y: widened.y,
169
+ y2: widened.y2 || widened.y.slice()
139
170
  };
140
171
  avoidLogZero(viz, domains, data, axisData);
141
172
  applyOppDomains(viz, domains, opps, {
142
173
  x: xConfigScale,
143
174
  y: yConfigScale
144
175
  }, user);
145
- const x = scaleConstructors[`scale${xScale}`]().domain(domains.x).range(range(0, width + 1, width / (domains.x.length - 1)));
146
- const x2 = scaleConstructors[`scale${x2Scale}`]().domain(domains.x2).range(range(0, width + 1, width / (domains.x2.length - 1)));
176
+ const axisScale = (axis, type, d, size)=>plotAxisScale(viz, axis, type, d, size);
177
+ const x = axisScale("x", xScale, domains.x, width);
178
+ const x2 = axisScale("x2", x2Scale, domains.x2, width);
147
179
  // `.slice().reverse()` so the domain object isn't mutated under us if
148
180
  // it came from user config (covered by the slice above) OR from
149
181
  // domains.y being aliased into the user config via the slice above.
150
- const y = scaleConstructors[`scale${yScale}`]().domain(domains.y.slice().reverse()).range(range(0, height + 1, height / (domains.y.length - 1)));
151
- const y2 = scaleConstructors[`scale${y2Scale}`]().domain(domains.y2.slice().reverse()).range(range(0, height + 1, height / (domains.y2.length - 1)));
182
+ const y = axisScale("y", yScale, domains.y.slice().reverse(), height);
183
+ const y2 = axisScale("y2", y2Scale, domains.y2.slice().reverse(), height);
152
184
  return {
153
185
  plotDomains: domains,
154
186
  plotScales: {
@@ -8,6 +8,7 @@
8
8
  import { isSpanAxis } from "./discreteSpan.js";
9
9
  import { AXES } from "./facetScales.js";
10
10
  import { computePlotAxisValues, computePlotInitialDomains, computePlotScales, extendPlotOppScales, formatPlotData, plotSizeScale } from "./pipeline.js";
11
+ import { poolStackPositions, recordStackLegendOrder } from "./stackLegendOrder.js";
11
12
  import { computePlotTrendFits } from "./trendLines.js";
12
13
  /** Whether an axis's domain is a list of values (a category axis) rather than an extent. */ export function listAxis(viz, axis) {
13
14
  if (viz.schema[`${axis}Sort`]) return true;
@@ -41,9 +42,18 @@ import { computePlotTrendFits } from "./trendLines.js";
41
42
  ]);
42
43
  return {
43
44
  formatted: ctx.plotFormattedData || [],
44
- domains: ctx.plotInitialDomains || {}
45
+ domains: ctx.plotInitialDomains || {},
46
+ positions: ctx.plotStackPositions
45
47
  };
46
48
  }
49
+ /**
50
+ Orders a stacked chart's legend by every panel's stacks, pooled (see
51
+ `stackLegendOrder.ts`), before the chrome lays the legend out.
52
+ */ export function plotFacetChrome(viz, panels) {
53
+ if (!viz.schema.stacked) return recordStackLegendOrder(viz, undefined);
54
+ const positions = panels.filter((rows)=>rows.length).map((rows)=>panelDomains(viz, rows).positions).filter((p)=>p !== undefined);
55
+ recordStackLegendOrder(viz, poolStackPositions(positions));
56
+ }
47
57
  /**
48
58
  The domains (and size scale) that fit every panel's rows: a category axis
49
59
  lists every panel's categories, in the order one chart of all the rows
@@ -158,6 +168,7 @@ import { computePlotTrendFits } from "./trendLines.js";
158
168
  }
159
169
  /** Plot's small-multiple hooks. */ export const plotFacetHooks = {
160
170
  aspect: 4 / 3,
171
+ chrome: plotFacetChrome,
161
172
  share: sharePlotScales,
162
173
  panel: plotFacetPanel,
163
174
  insets: plotFacetInsets,
@@ -5,7 +5,6 @@
5
5
  */ import { colorAssign, colorGray } from "@d3plus/color";
6
6
  import { assign } from "@d3plus/dom";
7
7
  import { AxisBottom, AxisLeft, AxisRight, AxisTop } from "../../components/index.js";
8
- import { gridStroke } from "../../components/Axis/gridStroke.js";
9
8
  import { accessor, constant } from "../../utils/index.js";
10
9
  import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
11
10
  import { linkedColorDefaults } from "../viz/linkGroup.js";
@@ -16,6 +15,9 @@ import { plotDef } from "./pipeline.js";
16
15
  import { plotShapeDefaults } from "./shapeDefaults.js";
17
16
  import { axisValue } from "./sharedTooltip.js";
18
17
  import { stackOffsetDiverging, stackOrderTotalDescending } from "./stackHelpers.js";
18
+ import { stackLegendSort } from "./stackLegendOrder.js";
19
+ import { chartGridline } from "../viz/backgroundInk.js";
20
+ import { themed } from "../../utils/theme.js";
19
21
  /**
20
22
  Plot's identity-coerce accessor schema. `installFluent` installs it on
21
23
  the instance's prototype alongside vizSchema's accessors.
@@ -34,6 +36,11 @@ import { stackOffsetDiverging, stackOrderTotalDescending } from "./stackHelpers.
34
36
  key: "barPadding",
35
37
  coerce: "identity"
36
38
  },
39
+ {
40
+ key: "connectGaps",
41
+ coerce: "identity",
42
+ default: true
43
+ },
37
44
  {
38
45
  key: "baselineBreak",
39
46
  coerce: "identity"
@@ -61,6 +68,23 @@ import { stackOffsetDiverging, stackOrderTotalDescending } from "./stackHelpers.
61
68
  key: "lineLabels",
62
69
  coerce: "identity"
63
70
  },
71
+ {
72
+ key: "lineLabelConfig",
73
+ merge: true,
74
+ factory: ()=>({
75
+ value: false
76
+ })
77
+ },
78
+ {
79
+ key: "referenceBands",
80
+ coerce: "identity",
81
+ factory: ()=>[]
82
+ },
83
+ {
84
+ key: "referenceLines",
85
+ coerce: "identity",
86
+ factory: ()=>[]
87
+ },
64
88
  {
65
89
  key: "shapeSort",
66
90
  coerce: "identity"
@@ -77,6 +101,11 @@ import { stackOffsetDiverging, stackOrderTotalDescending } from "./stackHelpers.
77
101
  key: "sizeScale",
78
102
  coerce: "identity"
79
103
  },
104
+ {
105
+ key: "sizeZero",
106
+ coerce: "identity",
107
+ default: false
108
+ },
80
109
  {
81
110
  key: "stacked",
82
111
  coerce: "identity"
@@ -174,7 +203,7 @@ import { stackOffsetDiverging, stackOrderTotalDescending } from "./stackHelpers.
174
203
  fillOpacity: constant(0.5)
175
204
  };
176
205
  viz._crosshairConfig = {
177
- stroke: colorGray[500],
206
+ stroke: ()=>themed(viz._theme, (t)=>t.textMuted, colorGray[500]),
178
207
  strokeDasharray: "4 3",
179
208
  strokeWidth: 1
180
209
  };
@@ -183,7 +212,6 @@ import { stackOffsetDiverging, stackOrderTotalDescending } from "./stackHelpers.
183
212
  viz._labelConnectorConfig = {
184
213
  strokeDasharray: "1 1"
185
214
  };
186
- viz._labelPosition = constant("auto");
187
215
  viz._lineMarkerConfig = {
188
216
  fill: (d, i)=>colorAssign(viz._id(d, i), linkedColorDefaults(viz)),
189
217
  r: constant(3)
@@ -212,6 +240,7 @@ import { stackOffsetDiverging, stackOrderTotalDescending } from "./stackHelpers.
212
240
  viz.schema.sizeScale = "sqrt";
213
241
  viz._stackOffset = stackOffsetDiverging;
214
242
  viz._stackOrder = stackOrderTotalDescending;
243
+ viz.schema.legendSort = stackLegendSort(viz, viz.schema.legendSort);
215
244
  // Off until set: a stacked Plot's threshold folds whole series.
216
245
  viz.schema.threshold = constant(0);
217
246
  viz._thresholdMemberFormat = (v)=>axisValue(viz, viz.schema.discrete === "y" ? "x" : "y", v);
@@ -235,7 +264,7 @@ import { stackOffsetDiverging, stackOrderTotalDescending } from "./stackHelpers.
235
264
  const range = viz._xAxis.range();
236
265
  const position = viz._xAxis._getPosition.bind(viz._xAxis)(d.id);
237
266
  if (range[0] === position) return "transparent";
238
- return gridStroke(viz._select?.node(), viz.schema.colorDefaults);
267
+ return chartGridline(viz);
239
268
  }
240
269
  }
241
270
  };
@@ -255,7 +284,7 @@ import { stackOffsetDiverging, stackOrderTotalDescending } from "./stackHelpers.
255
284
  const range = viz._yAxis.range();
256
285
  const position = viz._yAxis._getPosition.bind(viz._yAxis)(d.id);
257
286
  if (range[range.length - 1] === position) return "transparent";
258
- return gridStroke(viz._select?.node(), viz.schema.colorDefaults);
287
+ return chartGridline(viz);
259
288
  }
260
289
  }
261
290
  };
@@ -0,0 +1,85 @@
1
+ /**
2
+ A Plot's side of time-axis `rangeBreaks`: rows whose time the axis
3
+ hides are left out of the drawing (with a warning), and the pipeline's
4
+ own time scales hide the same time as the axes do, so shape padding is
5
+ measured in the time that stays visible.
6
+ */ import { extent } from "d3-array";
7
+ import { breakStyleOf } from "../../components/Axis/axisBreak.js";
8
+ import { brokenTimeScale } from "../../components/Axis/brokenTimeScale.js";
9
+ import { normalizeRangeBreaks, rangeBreakTest, rangeBreakTime } from "../../components/Axis/rangeBreaks.js";
10
+ import { warnConfigOnce } from "../../utils/configWarnings.js";
11
+ /** The axes a Plot can draw time on. */ const AXES = [
12
+ "x",
13
+ "x2",
14
+ "y",
15
+ "y2"
16
+ ];
17
+ /** An axis's `rangeBreaks` rules, from its axis config, when it plots time. */ export function plotRangeBreaks(viz, axis) {
18
+ const config = viz[`_${axis}Config`];
19
+ if (!viz[`_${axis}Time`] && config?.scale !== "time") return [];
20
+ return normalizeRangeBreaks(config?.rangeBreaks);
21
+ }
22
+ /**
23
+ Whether an axis's `rangeBreaks` make it a time axis without `time`: the
24
+ axis config has rules, and `value` (the first row's) reads as a date — a
25
+ Date, a timestamp, or a date string.
26
+ */ export function rangeBreaksTimeAxis(viz, axis, value) {
27
+ const config = viz[`_${axis}Config`];
28
+ if (!normalizeRangeBreaks(config?.rangeBreaks).length) return false;
29
+ if (value instanceof Date) return !isNaN(+value);
30
+ if (typeof value === "number" && String(Math.abs(value)).length <= 5) return false;
31
+ return (typeof value === "string" || typeof value === "number") && Number.isFinite(rangeBreakTime(value));
32
+ }
33
+ /**
34
+ The `rangeBreaks` a chart's timeline takes by default: those of the axis
35
+ that plots the chart's `time` values (the first row's time equals that
36
+ axis's value), else none.
37
+ */ export function timelineRangeBreaks(viz) {
38
+ const row = viz._data?.[0];
39
+ const time = viz.schema.time;
40
+ if (!row || typeof time !== "function") return [];
41
+ const value = time(row, 0);
42
+ for (const axis of AXES){
43
+ const read = viz[`_${axis}`];
44
+ if (typeof read !== "function" || read(row, 0) !== value) continue;
45
+ const config = viz[`_${axis}Config`];
46
+ const rules = normalizeRangeBreaks(config?.rangeBreaks);
47
+ if (rules.length) return rules;
48
+ }
49
+ return [];
50
+ }
51
+ /** A plotted time value as a timestamp (`NaN` when it isn't one). */ const timeOf = (v)=>v instanceof Date || typeof v === "number" ? +v : NaN;
52
+ /**
53
+ The rows to draw: those whose time every time axis shows. Rows inside
54
+ an axis's `rangeBreaks` are dropped, with a warning naming the axis.
55
+ */ export function dropHiddenRows(viz, rows) {
56
+ let out = rows;
57
+ AXES.forEach((axis)=>{
58
+ const rules = plotRangeBreaks(viz, axis);
59
+ if (!rules.length || !out.length) return;
60
+ const times = out.map((d)=>timeOf(d[axis])).filter(Number.isFinite);
61
+ if (!times.length) return;
62
+ const [lo, hi] = extent(times);
63
+ const hidden = rangeBreakTest(rules, lo, hi);
64
+ const kept = out.filter((d)=>!hidden(timeOf(d[axis])));
65
+ if (kept.length < out.length) warnConfigOnce(viz, `rangeBreaks-${axis}`, `Some data falls inside ${axis}Config.rangeBreaks and is not drawn.`);
66
+ out = kept;
67
+ });
68
+ return out;
69
+ }
70
+ /**
71
+ A Plot pipeline scale for `axis`: a broken time scale over the same
72
+ domain and range when the axis plots time with `rangeBreaks`, else the
73
+ scale as given.
74
+ */ export function plotTimeScale(viz, axis, scale) {
75
+ const rules = plotRangeBreaks(viz, axis);
76
+ if (!rules.length) return scale;
77
+ const config = viz[`_${axis}Config`];
78
+ const { space } = breakStyleOf(config?.breakConfig);
79
+ const broken = brokenTimeScale(rules, {
80
+ space
81
+ });
82
+ broken.domain(scale.domain());
83
+ broken.range(scale.range());
84
+ return broken;
85
+ }