@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,237 @@
1
+ /**
2
+ Pure helpers behind a Plot's `connectGaps`: reading the setting, finding
3
+ where a line skips a missing value, measuring how far along its curve each
4
+ point lies, and the dash arrays that break a line at its gaps or draw a
5
+ bridge across them.
6
+ */ import { line as d3Line } from "d3-shape";
7
+ import { parseDash } from "../../shapes/Shape.js";
8
+ import { curveFactory } from "./lineCurve.js";
9
+ /** The dash pattern `"dashed"` bridges a gap with: short and sparse, unlike a forecast's `"6 4"`. */ export const GAP_DASH = [
10
+ 2,
11
+ 4
12
+ ];
13
+ /**
14
+ What a `connectGaps` setting asks for: null when lines run through their
15
+ gaps as one continuous line (`true`, `"solid"`, unset), otherwise lines
16
+ break at each gap and `bridge` is the style of the line drawn across it,
17
+ or null to leave the gap empty (`false`).
18
+ @param value The setting.
19
+ */ export function resolveConnectGaps(value) {
20
+ if (value === false) return {
21
+ bridge: null
22
+ };
23
+ if (value === "dashed") return {
24
+ bridge: {
25
+ strokeDasharray: GAP_DASH,
26
+ opacity: 1
27
+ }
28
+ };
29
+ if (!value || typeof value !== "object" || Array.isArray(value)) return null;
30
+ const config = value;
31
+ const dash = config.strokeDasharray === undefined ? GAP_DASH : config.strokeDasharray === false ? undefined : parseDash(Array.isArray(config.strokeDasharray) ? config.strokeDasharray.join(" ") : config.strokeDasharray);
32
+ const bridge = {
33
+ opacity: typeof config.opacity === "number" && Number.isFinite(config.opacity) ? config.opacity : 1
34
+ };
35
+ if (dash && dash.some((v)=>v > 0)) bridge.strokeDasharray = dash;
36
+ if (typeof config.stroke === "string" && config.stroke) bridge.stroke = config.stroke;
37
+ if (typeof config.strokeWidth === "number") bridge.strokeWidth = config.strokeWidth;
38
+ return {
39
+ bridge
40
+ };
41
+ }
42
+ /**
43
+ The indices `k` of a line's points that a gap follows: some missing value
44
+ lies strictly between point `k` and point `k + 1` along the discrete axis.
45
+ A missing value before the first point or after the last makes no gap.
46
+ @param ranks Each drawn point's position along the discrete axis, in drawn order.
47
+ @param missing The positions with no value: every step any line has, and
48
+ the line's own rows with no plottable value.
49
+ */ export function gapsAfter(ranks, missing) {
50
+ const steps = Array.from(new Set(missing.filter(Number.isFinite))).sort((a, b)=>a - b);
51
+ const out = [];
52
+ for(let k = 0; k < ranks.length - 1; k++){
53
+ const lo = Math.min(ranks[k], ranks[k + 1]);
54
+ const hi = Math.max(ranks[k], ranks[k + 1]);
55
+ if (!Number.isFinite(lo) || !Number.isFinite(hi)) continue;
56
+ // The first step above lo, by binary search.
57
+ let a = 0, b = steps.length;
58
+ while(a < b){
59
+ const m = a + b >> 1;
60
+ if (steps[m] <= lo) a = m + 1;
61
+ else b = m;
62
+ }
63
+ if (a < steps.length && steps[a] < hi) out.push(k);
64
+ }
65
+ return out;
66
+ }
67
+ /**
68
+ How far along a polyline it first reaches each of `targets` along one
69
+ axis, searching on from where it reached the one before, and its total
70
+ length. A target it never reaches lies at its full length.
71
+ @param line The polyline (see `curvePolyline`).
72
+ @param axis `0` to measure along x, `1` along y.
73
+ @param targets The positions to reach, in order along the line.
74
+ */ export function pointLengths(line, axis, targets) {
75
+ const cumulative = [
76
+ 0
77
+ ];
78
+ for(let k = 1; k < line.length; k++)cumulative.push(cumulative[k - 1] + Math.hypot(line[k][0] - line[k - 1][0], line[k][1] - line[k - 1][1]));
79
+ const total = cumulative[cumulative.length - 1] ?? 0;
80
+ let j = 0;
81
+ const at = targets.map((target)=>{
82
+ for(; j < line.length - 1; j++){
83
+ const p = line[j][axis], q = line[j + 1][axis];
84
+ if (p === target) return cumulative[j];
85
+ if ((p - target) * (q - target) < 0) {
86
+ const t = (target - p) / (q - p);
87
+ return cumulative[j] + t * (cumulative[j + 1] - cumulative[j]);
88
+ }
89
+ }
90
+ return total;
91
+ });
92
+ return {
93
+ at,
94
+ total
95
+ };
96
+ }
97
+ /**
98
+ The stretches a dash pattern draws between `from` and `to`, starting the
99
+ pattern at `from`. No pattern (or one that draws nothing) draws the
100
+ whole stretch.
101
+ @param dash The pattern, as `[dash, gap, …]`.
102
+ @param from Where the stretch starts.
103
+ @param to Where it ends.
104
+ */ export function patternIntervals(dash, from, to) {
105
+ if (!(to > from)) return [];
106
+ const pattern = dash && dash.length % 2 ? dash.concat(dash) : dash;
107
+ const period = pattern ? pattern.reduce((a, b)=>a + b, 0) : 0;
108
+ if (!pattern || !(period > 0) || !pattern.some((v, k)=>!(k % 2) && v > 0)) return [
109
+ [
110
+ from,
111
+ to
112
+ ]
113
+ ];
114
+ const out = [];
115
+ let at = from;
116
+ for(let k = 0; at < to; k = (k + 1) % pattern.length){
117
+ const end = Math.min(to, at + pattern[k]);
118
+ if (!(k % 2) && end > at) out.push([
119
+ at,
120
+ end
121
+ ]);
122
+ at = end;
123
+ }
124
+ return out;
125
+ }
126
+ /**
127
+ Where two lists of stretches overlap.
128
+ @param a Sorted, non-overlapping stretches.
129
+ @param b Sorted, non-overlapping stretches.
130
+ */ export function intersectIntervals(a, b) {
131
+ const out = [];
132
+ let i = 0, j = 0;
133
+ while(i < a.length && j < b.length){
134
+ const start = Math.max(a[i][0], b[j][0]);
135
+ const end = Math.min(a[i][1], b[j][1]);
136
+ if (end > start) out.push([
137
+ start,
138
+ end
139
+ ]);
140
+ if (a[i][1] < b[j][1]) i++;
141
+ else j++;
142
+ }
143
+ return out;
144
+ }
145
+ /**
146
+ The stretches of `[0, total]` a list of stretches leaves out.
147
+ @param intervals Sorted, non-overlapping stretches.
148
+ @param total The path's length.
149
+ */ export function complementIntervals(intervals, total) {
150
+ const out = [];
151
+ let at = 0;
152
+ intervals.forEach(([start, end])=>{
153
+ if (start > at) out.push([
154
+ at,
155
+ start
156
+ ]);
157
+ at = Math.max(at, end);
158
+ });
159
+ if (total > at) out.push([
160
+ at,
161
+ total
162
+ ]);
163
+ return out;
164
+ }
165
+ /**
166
+ The dash array that draws a path along exactly the given stretches and
167
+ nothing else, ending in a gap long enough that the pattern never repeats.
168
+ @param intervals Sorted, non-overlapping stretches to draw.
169
+ @param total The path's length.
170
+ */ export function intervalsDash(intervals, total) {
171
+ const round = (v)=>+Math.max(0, v).toFixed(2);
172
+ const out = [];
173
+ let at = 0;
174
+ intervals.forEach(([start, end], k)=>{
175
+ // A zero-length first dash opens with the gap before the first stretch.
176
+ if (k) out.push(round(start - at));
177
+ else if (round(start) > 0) out.push(0, round(start));
178
+ out.push(round(end - start));
179
+ at = end;
180
+ });
181
+ if (!out.length) return [
182
+ 0,
183
+ round(total) + 1
184
+ ];
185
+ out.push(round(total - at) + round(total) + 1);
186
+ return out;
187
+ }
188
+ /**
189
+ A line's path with a separate subpath for each run of points between its
190
+ gaps, so nothing spans a gap. A point between two gaps gets a short tick
191
+ along the discrete axis.
192
+ @param points The line's points, in drawn order.
193
+ @param gaps The indices a gap follows (see `gapsAfter`).
194
+ @param curve The line's curve name.
195
+ @param axis `0` when the discrete axis is x, `1` when it is y.
196
+ @param stub Half the length of a lone point's tick.
197
+ */ export function runPath(points, gaps, curve, axis, stub = 3) {
198
+ const breaks = new Set(gaps);
199
+ const runs = [
200
+ []
201
+ ];
202
+ points.forEach((p, k)=>{
203
+ runs[runs.length - 1].push(p);
204
+ if (breaks.has(k) && k < points.length - 1) runs.push([]);
205
+ });
206
+ const gen = d3Line().curve(curveFactory(curve));
207
+ return runs.map((run)=>{
208
+ if (run.length > 1) return gen(run) || "";
209
+ const [x, y] = run[0];
210
+ return axis ? `M${x},${y - stub}L${x},${y + stub}` : `M${x - stub},${y}L${x + stub},${y}`;
211
+ }).join("");
212
+ }
213
+ /**
214
+ Each run of points between a line's gaps, as its `[first, last]` point
215
+ indices.
216
+ @param count The line's point count.
217
+ @param gaps The indices a gap follows (see `gapsAfter`).
218
+ */ export function runIndices(count, gaps) {
219
+ if (!count) return [];
220
+ const out = [];
221
+ let start = 0;
222
+ [
223
+ ...gaps
224
+ ].sort((a, b)=>a - b).forEach((k)=>{
225
+ if (k < start || k >= count - 1) return;
226
+ out.push([
227
+ start,
228
+ k
229
+ ]);
230
+ start = k + 1;
231
+ });
232
+ out.push([
233
+ start,
234
+ count - 1
235
+ ]);
236
+ return out;
237
+ }
@@ -0,0 +1,188 @@
1
+ /**
2
+ The scene side of a Plot's `connectGaps`: each line's gaps, read from its
3
+ rows, and the edits that break the line there. A line keeps its one path
4
+ through every point, so it follows its curve across a gap; its dash array
5
+ leaves the gaps out, its hit area stops at them, and a bridge (the same
6
+ path, drawn only across the gaps) is decoration that takes no pointer or
7
+ keyboard focus. Confidence bands are clipped to the runs between gaps.
8
+ */ import { parseDash } from "../../shapes/Shape.js";
9
+ import { complementIntervals, gapsAfter, intersectIntervals, intervalsDash, patternIntervals, pointLengths, resolveConnectGaps, runIndices, runPath } from "./connectGaps.js";
10
+ import { curvePolyline } from "./curveLength.js";
11
+ import { discreteRank } from "./forecast.js";
12
+ import { lineCurve } from "./lineCurve.js";
13
+ /** Far enough past the plot that a clip band reaches every edge. */ const FAR = 1e5;
14
+ /**
15
+ The gaps in each line of a Line group, or null when `connectGaps` draws
16
+ lines straight through them or no line has one. A gap is a step of the
17
+ discrete axis that some line in the group has and this one skips, or one
18
+ of this line's own rows whose value can't be plotted (`null`, `NaN`).
19
+ @param ctx The Line group's emit context.
20
+ */ export function lineGaps(ctx) {
21
+ const { viz, values } = ctx;
22
+ const setting = resolveConnectGaps(viz.schema.connectGaps);
23
+ if (!setting || !values.length) return null;
24
+ const rows = values;
25
+ const missing = ctx.missingRows ?? [];
26
+ const discrete = viz.schema.discrete === "y" ? "y" : "x";
27
+ const axis = discrete === "y" ? 1 : 0;
28
+ const rank = discreteRank([
29
+ ...rows.map((d)=>d[discrete]),
30
+ ...missing.map((d)=>d[discrete])
31
+ ]);
32
+ const steps = rows.map((d)=>rank(d[discrete]));
33
+ const ownMissing = new Map();
34
+ missing.forEach((d)=>{
35
+ const id = `${d.id}`;
36
+ if (!ownMissing.has(id)) ownMissing.set(id, []);
37
+ ownMissing.get(id).push(rank(d[discrete]));
38
+ });
39
+ const bySeries = new Map();
40
+ rows.forEach((d)=>{
41
+ const id = `${d.id}`;
42
+ if (!bySeries.has(id)) bySeries.set(id, []);
43
+ bySeries.get(id).push(d);
44
+ });
45
+ const px = ctx.shapeConfig.x;
46
+ const py = ctx.shapeConfig.y;
47
+ const curve = lineCurve(viz, rows[0]);
48
+ const series = new Map();
49
+ bySeries.forEach((list, id)=>{
50
+ const gaps = gapsAfter(list.map((d)=>rank(d[discrete])), steps.concat(ownMissing.get(id) ?? []));
51
+ if (!gaps.length) return;
52
+ const points = list.map((d)=>[
53
+ px(d),
54
+ py(d)
55
+ ]);
56
+ const { at, total } = pointLengths(curvePolyline(points, curve), axis, points.map((p)=>p[axis]));
57
+ const gapIntervals = gaps.map((k)=>[
58
+ at[k],
59
+ at[k + 1]
60
+ ]);
61
+ series.set(id, {
62
+ points,
63
+ gaps,
64
+ gapIntervals,
65
+ total
66
+ });
67
+ });
68
+ if (!series.size) return null;
69
+ return {
70
+ series,
71
+ bridge: setting.bridge,
72
+ curve,
73
+ axis
74
+ };
75
+ }
76
+ /** The series id a Line or Area node draws, read from its first point's row. */ function seriesOf(node) {
77
+ const first = node.interactionPoints?.[0]?.datum;
78
+ return first ? `${first.id}` : undefined;
79
+ }
80
+ /** The dash array that draws `own`'s pattern along a line's runs and leaves its gaps empty. */ function brokenDash(own, line) {
81
+ const runs = complementIntervals(line.gapIntervals, line.total);
82
+ return intervalsDash(intersectIntervals(patternIntervals(own, 0, line.total), runs), line.total);
83
+ }
84
+ /** A non-interactive copy of a line drawn only across its gaps, in the bridge's style. */ function bridgeNode(node, line, bridge) {
85
+ const paint = node.paint ?? {};
86
+ const dash = intervalsDash(line.gapIntervals.flatMap(([start, end])=>patternIntervals(bridge.strokeDasharray, start, end)), line.total);
87
+ return {
88
+ ...node,
89
+ key: `${node.key}::gap`,
90
+ interactive: false,
91
+ interactionPoints: undefined,
92
+ aria: {
93
+ hidden: true
94
+ },
95
+ paint: {
96
+ ...paint,
97
+ stroke: bridge.stroke ?? paint.stroke,
98
+ strokeWidth: bridge.strokeWidth ?? paint.strokeWidth,
99
+ strokeDasharray: dash,
100
+ opacity: (paint.opacity ?? 1) * bridge.opacity
101
+ }
102
+ };
103
+ }
104
+ /**
105
+ Breaks each gapped line among a Line group's nodes: the line's dash array
106
+ leaves its gaps empty, its hit area stops at them, and a bridge follows
107
+ it when `connectGaps` asks for one.
108
+ @param nodes The Line shape's computed nodes.
109
+ @param gaps The group's gaps (see `lineGaps`).
110
+ */ export function breakLines(nodes, gaps) {
111
+ return nodes.flatMap((node)=>{
112
+ if (node.type !== "path" || node.shapeType !== "Line") return [
113
+ node
114
+ ];
115
+ const id = seriesOf(node);
116
+ const line = id === undefined ? undefined : gaps.series.get(id);
117
+ if (!line) return [
118
+ node
119
+ ];
120
+ const tx = node.transform?.x ?? 0, ty = node.transform?.y ?? 0;
121
+ if (String(node.key).endsWith("::hit")) {
122
+ const local = line.points.map(([x, y])=>[
123
+ x - tx,
124
+ y - ty
125
+ ]);
126
+ return [
127
+ {
128
+ ...node,
129
+ d: runPath(local, line.gaps, gaps.curve, gaps.axis)
130
+ }
131
+ ];
132
+ }
133
+ const own = parseDash(node.paint?.strokeDasharray);
134
+ const broken = {
135
+ ...node,
136
+ paint: {
137
+ ...node.paint,
138
+ strokeDasharray: brokenDash(own, line)
139
+ }
140
+ };
141
+ return gaps.bridge ? [
142
+ broken,
143
+ bridgeNode(node, line, gaps.bridge)
144
+ ] : [
145
+ broken
146
+ ];
147
+ });
148
+ }
149
+ /** A clip path covering a line's runs along the discrete axis, open past its ends. */ function runsClip(line, axis) {
150
+ const { points } = line;
151
+ const runs = runIndices(points.length, line.gaps);
152
+ // Which way the line runs in pixels: `false` on a reversed axis.
153
+ const forward = points[points.length - 1][axis] >= points[0][axis];
154
+ return runs.map(([first, last], k)=>{
155
+ const a = points[first][axis], b = points[last][axis];
156
+ let lo = Math.min(a, b), hi = Math.max(a, b);
157
+ // The first run reaches back past the line's start, the last on past its end.
158
+ if (!k && forward) lo = -FAR;
159
+ if (!k && !forward) hi = FAR;
160
+ if (k === runs.length - 1 && forward) hi = FAR;
161
+ if (k === runs.length - 1 && !forward) lo = -FAR;
162
+ return axis ? `M${-FAR},${lo}H${FAR}V${hi}H${-FAR}Z` : `M${lo},${-FAR}H${hi}V${FAR}H${lo}Z`;
163
+ }).join("");
164
+ }
165
+ /**
166
+ Clips each gapped line's confidence bands to the runs between its gaps,
167
+ so no band spans a stretch with no value.
168
+ @param nodes The band Areas' computed nodes.
169
+ @param gaps The group's gaps (see `lineGaps`).
170
+ */ export function clipBands(nodes, gaps) {
171
+ return nodes.map((node)=>{
172
+ const id = seriesOf(node);
173
+ const line = id === undefined ? undefined : gaps.series.get(id);
174
+ if (!line || node.shapeType !== "Area") return node;
175
+ const group = {
176
+ type: "group",
177
+ key: `${node.key}::gaps`,
178
+ clip: {
179
+ type: "path",
180
+ d: runsClip(line, gaps.axis)
181
+ },
182
+ children: [
183
+ node
184
+ ]
185
+ };
186
+ return group;
187
+ });
188
+ }
@@ -12,6 +12,7 @@ import Viz from "../viz/Viz.js";
12
12
  import { runStages } from "../pipeline/stages.js";
13
13
  import { computePlotAxisValues, computePlotInitialDomains, computePlotScales, extendPlotOppScales, formatPlotData, measurePlotLineLabels, preparePlotAxisLayout } from "./pipeline.js";
14
14
  import { roundPlotOpenEnds } from "./openDomainEnds.js";
15
+ import { recordStackLegendOrder } from "./stackLegendOrder.js";
15
16
  import { computePlotTrendFits } from "./trendLines.js";
16
17
  const testLineShape = new shapes.Line();
17
18
  const testTextBox = new TextBox();
@@ -35,7 +36,8 @@ const superDraw = (viz, callback)=>Viz.prototype._draw.call(viz, callback);
35
36
  x2Data: plotCtx.x2Data,
36
37
  yData: plotCtx.yData,
37
38
  y2Data: plotCtx.y2Data,
38
- stackGroup: plotCtx.plotStackGroup
39
+ stackGroup: plotCtx.plotStackGroup,
40
+ missingRows: plotCtx.plotMissingRows ?? []
39
41
  };
40
42
  }
41
43
  /** Runs domain + scale stages; returns domains, stack data, and scale bundles. */ function runPlotLayoutStages(viz, data, axisData, stackGroup, axisValues) {
@@ -56,6 +58,9 @@ const superDraw = (viz, callback)=>Viz.prototype._draw.call(viz, callback);
56
58
  computePlotInitialDomains,
57
59
  computePlotScales
58
60
  ]);
61
+ // The legend reads in the stacks' order. A small multiple's panel draws
62
+ // after the legend, which the facet chrome hook orders instead.
63
+ if (viz._facetStep !== "panel") recordStackLegendOrder(viz, layoutCtx.plotStackPositions);
59
64
  return {
60
65
  plotInitialDomains: layoutCtx.plotInitialDomains,
61
66
  plotDiscreteKeys: layoutCtx.plotDiscreteKeys,
@@ -187,7 +192,8 @@ const superDraw = (viz, callback)=>Viz.prototype._draw.call(viz, callback);
187
192
  return {
188
193
  labelWidths: lineLabelCtx.plotLabelWidths,
189
194
  largestLabel: lineLabelCtx.plotLargestLabel,
190
- xRangeMax: lineLabelCtx.plotXRangeMax
195
+ xRangeMax: lineLabelCtx.plotXRangeMax,
196
+ startLabelSpace: lineLabelCtx.plotStartLabelSpace ?? 0
191
197
  };
192
198
  };
193
199
  }
@@ -6,6 +6,7 @@
6
6
  */ import { area as d3Area } from "d3-shape";
7
7
  import { collectComputed, makeShape, shapeConfigFor } from "../features/emitHelpers.js";
8
8
  import { curveFactory, lineCurve } from "./lineCurve.js";
9
+ import { effectiveDuration } from "../viz/reducedMotion.js";
9
10
  /** Key prefix of a fill-between group. */ export const FILL_BETWEEN_KEY = "fill-between";
10
11
  /** How far past the plot a clip's open side reaches, in pixels. */ const CLIP_REACH = 1e5;
11
12
  /** The `fillBetweenConfig` defaults. */ export function fillBetweenDefaults() {
@@ -155,7 +156,7 @@ import { curveFactory, lineCurve } from "./lineCurve.js";
155
156
  const shape = makeShape("Area").renderMode("compute").data(data).config({
156
157
  ...place,
157
158
  curve: geo.curve,
158
- duration: viz.schema.duration,
159
+ duration: effectiveDuration(viz),
159
160
  label: false,
160
161
  fill: lineColor(viz),
161
162
  strokeWidth: 0
@@ -2,19 +2,18 @@
2
2
  The scene for a Plot's `forecast`: a shaded backdrop over the forecast
3
3
  stretch with a rule at its start and a label, and the dash array that
4
4
  draws each line's forecast stretch dashed.
5
- */ import { colorContrast } from "@d3plus/color";
6
- import { backgroundColor, textWidth } from "@d3plus/dom";
5
+ */ import { textWidth } from "@d3plus/dom";
7
6
  import { parseDash } from "../../shapes/Shape.js";
8
7
  import { textureKey } from "../../shapes/textureKey.js";
9
8
  import { backgroundImageNode } from "../features/backgroundImageEmit.js";
10
9
  import { curvePolyline, splitDash, splitLength } from "./curveLength.js";
11
10
  import { lineCurve } from "./lineCurve.js";
12
11
  import { discreteRank, forecastStart } from "./forecast.js";
12
+ import { backgroundInk } from "../viz/backgroundInk.js";
13
13
  /** Key of the forecast backdrop group. */ export const FORECAST_KEY = "plot-forecast";
14
14
  const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fallback;
15
15
  /** The text color of the chart's background, which the backdrop, rule, and label default to. */ function inkColor(viz) {
16
- const bg = backgroundColor(viz._select?.node());
17
- return colorContrast(bg, viz.schema.colorDefaults);
16
+ return backgroundInk(viz);
18
17
  }
19
18
  /** The pixel position of a discrete-axis value. */ function discretePixel(viz, frame, value) {
20
19
  return (viz.schema.discrete || "x") === "x" ? frame.x(value) : frame.y(value);
@@ -1,6 +1,5 @@
1
1
  /* eslint no-cond-assign: 0*/ import { zoomTransform } from "d3-zoom";
2
2
  import { assign } from "@d3plus/dom";
3
- import { constant } from "../../utils/index.js";
4
3
  import { fieldAccessor } from "../../utils/fieldAccessor.js";
5
4
  import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
6
5
  import { baselineValue, setBaseline } from "./baselineDomain.js";
@@ -19,7 +18,9 @@ import Viz from "../viz/Viz.js";
19
18
  import { plotInsetRegion } from "./insetRegion.js";
20
19
  import { plotFacetHooks } from "./plotFacet.js";
21
20
  import { plotStackThreshold, plotStackThresholdLegend } from "./stackThreshold.js";
21
+ import { isPointShape } from "../viz/nearestHover.js";
22
22
  import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
23
+ import { displayName } from "../../utils/displayName.js";
23
24
  /** A y-axis config patch with its `domain` array reversed (y scales run top-down). */ function reverseDomain(patch) {
24
25
  const domain = patch?.domain;
25
26
  return Array.isArray(domain) ? {
@@ -30,6 +31,7 @@ import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
30
31
  /**
31
32
  Creates an x/y plot based on an array of data.
32
33
  */ export default class Plot extends Viz {
34
+ static _displayName = "Plot";
33
35
  _trendLine = plotDef.defaults.trendLine;
34
36
  _trendLineConfig = trendLineDefaults();
35
37
  /**
@@ -175,6 +177,13 @@ import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
175
177
  }
176
178
  return super._interactionDatum(pick, event);
177
179
  }
180
+ /**
181
+ A Plot's point marks are its Circle and Rect shapes (scatter and
182
+ bubble points, Beeswarm circles), for `hoverDistance`.
183
+ @private
184
+ */ _pointMark(node) {
185
+ return isPointShape(node);
186
+ }
178
187
  /**
179
188
  Picks the interaction point closest to a surface-local cursor position
180
189
  along the discrete axis. `event.point` is post-zoom surface space while the
@@ -266,7 +275,9 @@ import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
266
275
  /**
267
276
  Allows drawing custom shapes to be used as annotations in the provided x/y plot. This method accepts custom config objects for the [Shape](http://d3plus.org/docs/#Shape) class, either a single config object or an array of config objects. Each config object requires an additional parameter, the "shape", which denotes which [Shape](http://d3plus.org/docs/#Shape) sub-class to use ([Rect](http://d3plus.org/docs/#Rect), [Line](http://d3plus.org/docs/#Line), etc).
268
277
 
269
- Additionally, each config object can also contain an optional "layer" key, which defines whether the annotations will be displayed in "front" or in "back" of the primary visualization shapes. This value defaults to "back" if not present.
278
+ Additionally, each config object can also contain an optional "layer" key, which defines whether the annotations will be displayed in "front" or in "back" of the primary visualization shapes. This value defaults to "back" if not present ("front" for callouts).
279
+
280
+ Three more kinds draw chart notes: `"Callout"` anchors wrapped text in a box at each data row's `x`/`y` (in data units, or plot-area fractions with `xRef`/`yRef: "plot"`), offset by `dx`/`dy` pixels and joined to its anchor by a connector ending in an arrowhead or dot (see `CalloutAnnotation`); `"ReferenceLine"` and `"ReferenceBand"` draw what `referenceLines` and `referenceBands` entries expand into. All annotations follow zoom and never respond to the pointer or keyboard.
270
281
  */ annotations(_) {
271
282
  return arguments.length ? (this._annotations = _ instanceof Array ? _ : [
272
283
  _
@@ -336,7 +347,7 @@ Additionally, each config object can also contain an optional "layer" key, which
336
347
  .confidenceConfig({Bar: {stroke: "#333", capWidth: 8}, tooltip: false})
337
348
  */ confidenceConfig(_) {
338
349
  if (!arguments.length) return this._confidenceConfig;
339
- validateConfidenceConfig(this.constructor.name, _);
350
+ validateConfidenceConfig(displayName(this), _);
340
351
  this._confidenceConfig = mergeConfigBag(this, "confidenceConfig", _, this._confidenceConfig);
341
352
  return this;
342
353
  }
@@ -355,11 +366,6 @@ Additionally, each config object can also contain an optional "layer" key, which
355
366
  */ labelConnectorConfig(_) {
356
367
  return arguments.length ? (this._labelConnectorConfig = mergeConfigBag(this, "labelConnectorConfig", _, this._labelConnectorConfig), this) : this._labelConnectorConfig;
357
368
  }
358
- /**
359
- The behavior to be used when calculating the position and size of each shape's label(s). The value passed can either be the _String_ name of the behavior to be used for all shapes, or an accessor _Function_ that will be provided each data point and will be expected to return the behavior to be used for that data point. The availability and options for this method depend on the default logic for each Shape. As an example, the values "outside" or "inside" can be set for Bar shapes, whose "auto" default will calculate the best position dynamically based on the available space.
360
- */ labelPosition(_) {
361
- return arguments.length ? (this._labelPosition = typeof _ === "function" ? _ : constant(_), this) : this._labelPosition;
362
- }
363
369
  /**
364
370
  Paint for the shared tooltip's crosshair guide line (`stroke`,
365
371
  `strokeWidth`, `strokeDasharray`, `strokeOpacity`, …). Merged into the
@@ -426,8 +432,10 @@ Stacked charts always fit one line to the stack totals.
426
432
  - a value accessor, or a `{value, order}` config, to rank series by an
427
433
  aggregate of any data field.
428
434
 
429
- Unknown named strings warn and fall back to `"descending"`. If *value*
430
- is not specified, returns the current stack order.
435
+ Unknown named strings warn and fall back to `"descending"`. The
436
+ default legend lists the series in the order they stack, from the
437
+ baseline outward. If *value* is not specified, returns the current
438
+ stack order.
431
439
  */ stackOrder(_) {
432
440
  return arguments.length ? (this._stackOrder = resolveStackOrder(_), this) : this._stackOrder;
433
441
  }
@@ -23,7 +23,7 @@
23
23
  // Force all Stacked Bars to use "inside" labels.
24
24
  if (this.schema.stacked) return false;
25
25
  // Detect user "outside" or "inside" override.
26
- const labelPosition = this._labelPosition(d, i);
26
+ const labelPosition = this.schema.labelPosition(d, i);
27
27
  if (labelPosition === "outside") return true;
28
28
  else if (labelPosition === "inside") return false;
29
29
  // Run "auto" logic based on available space, against the non-discrete axis.
@@ -0,0 +1,82 @@
1
+ /**
2
+ The Line shape's label config for a Plot's `lineLabels`: the text and
3
+ bounds of each line's labels past its right end, its left end, or both,
4
+ after their collisions have been bumped apart (see
5
+ `features/lineLabels.ts`).
6
+
7
+ @module
8
+ */ import { max } from "d3-array";
9
+ import { formatAbbreviate } from "@d3plus/format";
10
+ import { lineLabelKey, lineLabelText, rowLineLabelSides } from "./lineLabelSides.js";
11
+ /**
12
+ The text one measured label shows: the series name (and its value), or,
13
+ where the plot had no room for every label, `"+N more"` on the last that
14
+ fit and nothing on the rest.
15
+ */ function entryText(inputs, measure, d, i) {
16
+ const { viz } = inputs;
17
+ if (measure.hidden) return false;
18
+ if (measure.collapsed) return `+${formatAbbreviate(measure.collapsed, viz.schema.locale)} ${viz.schema.translate("more")}`;
19
+ // A label shortened to fit its room keeps its shortened name.
20
+ const name = measure.name !== undefined ? measure.name : inputs.name === undefined || inputs.name === null ? viz._drawLabel(d, i) : typeof inputs.name === "function" ? inputs.name(d, i) : inputs.name;
21
+ return measure.valueText === undefined ? name : lineLabelText(name, measure.valueText);
22
+ }
23
+ /** The labels a line shows, left end first. */ function lineEntries(inputs, d, i) {
24
+ const { viz, labelWidths } = inputs;
25
+ if (!rowLineLabelSides(viz.schema.lineLabels, d.data, d.i).length) return [];
26
+ const entries = [];
27
+ for (const side of [
28
+ "start",
29
+ "end"
30
+ ]){
31
+ const measure = labelWidths.find((l)=>l.id === d.id && (l.side ?? "end") === side);
32
+ if (!measure) continue;
33
+ const text = entryText(inputs, measure, d, i);
34
+ if (text !== false) entries.push({
35
+ side,
36
+ text,
37
+ measure
38
+ });
39
+ }
40
+ return entries;
41
+ }
42
+ /**
43
+ The bounds of a line's label past its `side` end: right of its rightmost
44
+ point (`largest` wide, text starting there) or left of its leftmost point
45
+ (text ending there), as tall as a quarter of the chart and centered on
46
+ the label's bumped y.
47
+ */ export function lineLabelBox(points, side, largest, chartHeight, bumpedY) {
48
+ const [firstX, firstY] = points[0];
49
+ const [edgeX, edgeY] = points.reduce((a, b)=>side === "end" ? b[0] >= a[0] ? b : a : b[0] < a[0] ? b : a);
50
+ const height = chartHeight / 4;
51
+ const mod = bumpedY ? edgeY - bumpedY : 0;
52
+ return {
53
+ x: edgeX - firstX - (side === "start" ? largest : 0),
54
+ y: edgeY - firstY - height / 2 - mod,
55
+ width: largest,
56
+ height
57
+ };
58
+ }
59
+ /**
60
+ The Line shape's `label` and `labelBounds` for its line labels, and the
61
+ `textAnchor` that right-aligns the labels left of a line. A line with
62
+ one label keeps a single label; one labeled at both ends takes two.
63
+ */ export function lineLabelConfig(inputs) {
64
+ const { viz, labelWidths, largestLabel, labelPositions } = inputs;
65
+ const largestStart = max(labelWidths.filter((l)=>l.side === "start"), (l)=>l.labelWidth) ?? 0;
66
+ const sidesById = new Map();
67
+ const pick = (list)=>list.length === 1 ? list[0] : list;
68
+ return {
69
+ label: (d, i)=>{
70
+ const entries = lineEntries(inputs, d, i);
71
+ sidesById.set(d.id, entries.map((e)=>e.side));
72
+ return entries.length ? pick(entries.map((e)=>e.text)) : false;
73
+ },
74
+ labelBounds: (d, i, s)=>pick(lineEntries(inputs, d, i).map(({ side })=>lineLabelBox(s.points, side, side === "start" ? largestStart : largestLabel, viz.schema.height, labelPositions[lineLabelKey(side, d.id)]))),
75
+ textAnchor: (base)=>(d, i)=>{
76
+ const rec = d.l === undefined ? d.data : d;
77
+ const id = rec?.data?.id;
78
+ if (sidesById.get(id)?.[rec?.l] === "start") return "end";
79
+ return typeof base === "function" ? base(d, i) : base;
80
+ }
81
+ };
82
+ }