@d3plus/core 4.9.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 (687) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +170 -9
  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 +95 -4
  21. package/es/src/charts/BoxWhisker/outliers.js +68 -0
  22. package/es/src/charts/BoxWhisker/summary.js +83 -0
  23. package/es/src/charts/BoxWhisker/tooltip.js +122 -0
  24. package/es/src/charts/BubbleChart/emit.js +31 -0
  25. package/es/src/charts/BubbleChart/index.js +54 -0
  26. package/es/src/charts/Bullet/index.js +2 -1
  27. package/es/src/charts/BumpChart/index.js +5 -0
  28. package/es/src/charts/Calendar/emit.js +1 -1
  29. package/es/src/charts/Calendar/index.js +5 -3
  30. package/es/src/charts/Candlestick/aggregate.js +11 -1
  31. package/es/src/charts/Candlestick/buffer.js +6 -4
  32. package/es/src/charts/Candlestick/index.js +7 -6
  33. package/es/src/charts/Chord/applyLayout.js +56 -69
  34. package/es/src/charts/Chord/emit.js +55 -24
  35. package/es/src/charts/Chord/index.js +17 -12
  36. package/es/src/charts/Chord/labels.js +105 -0
  37. package/es/src/charts/Donut/index.js +5 -11
  38. package/es/src/charts/Dumbbell/index.js +2 -4
  39. package/es/src/charts/Funnel/index.js +2 -1
  40. package/es/src/charts/Gantt/applyLayout.js +162 -0
  41. package/es/src/charts/Gantt/emit.js +142 -0
  42. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  43. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  44. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  45. package/es/src/charts/Gantt/ganttRows.js +111 -0
  46. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  47. package/es/src/charts/Gantt/index.js +219 -0
  48. package/es/src/charts/Gauge/index.js +2 -1
  49. package/es/src/charts/Geomap/applyLayout.js +90 -49
  50. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  51. package/es/src/charts/Geomap/emit.js +19 -2
  52. package/es/src/charts/Geomap/flowEmit.js +132 -0
  53. package/es/src/charts/Geomap/flowEvents.js +86 -0
  54. package/es/src/charts/Geomap/flowFields.js +91 -0
  55. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  56. package/es/src/charts/Geomap/flowLinks.js +239 -0
  57. package/es/src/charts/Geomap/geoCache.js +180 -0
  58. package/es/src/charts/Geomap/globeKeys.js +131 -0
  59. package/es/src/charts/Geomap/globeRotate.js +208 -0
  60. package/es/src/charts/Geomap/index.js +60 -19
  61. package/es/src/charts/Geomap/pointLabels.js +107 -0
  62. package/es/src/charts/Hexbin/binning.js +103 -0
  63. package/es/src/charts/Hexbin/buffer.js +33 -0
  64. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  65. package/es/src/charts/Hexbin/contours.js +48 -0
  66. package/es/src/charts/Hexbin/emit.js +142 -0
  67. package/es/src/charts/Hexbin/index.js +204 -0
  68. package/es/src/charts/Hexbin/layers.js +212 -0
  69. package/es/src/charts/Hexbin/settings.js +86 -0
  70. package/es/src/charts/Hexbin/tooltip.js +77 -0
  71. package/es/src/charts/Histogram/binData.js +31 -4
  72. package/es/src/charts/Histogram/index.js +37 -16
  73. package/es/src/charts/Histogram/labels.js +18 -0
  74. package/es/src/charts/Icicle/index.js +3 -3
  75. package/es/src/charts/LinePlot/index.js +7 -0
  76. package/es/src/charts/Marimekko/index.js +7 -4
  77. package/es/src/charts/Matrix/index.js +3 -2
  78. package/es/src/charts/Network/applyLayout.js +138 -94
  79. package/es/src/charts/Network/bundle.js +81 -0
  80. package/es/src/charts/Network/clusterLabels.js +423 -0
  81. package/es/src/charts/Network/clusters.js +290 -0
  82. package/es/src/charts/Network/emit.js +253 -70
  83. package/es/src/charts/Network/graph.js +117 -0
  84. package/es/src/charts/Network/graphFluent.js +79 -0
  85. package/es/src/charts/Network/index.js +93 -108
  86. package/es/src/charts/Network/minNodeDistance.js +64 -0
  87. package/es/src/charts/Network/polygonRows.js +44 -0
  88. package/es/src/charts/Pack/index.js +7 -2
  89. package/es/src/charts/Pie/applyLayout.js +86 -27
  90. package/es/src/charts/Pie/arcFit.js +152 -0
  91. package/es/src/charts/Pie/curvedLabels.js +134 -0
  92. package/es/src/charts/Pie/emit.js +43 -96
  93. package/es/src/charts/Pie/index.js +66 -32
  94. package/es/src/charts/Pie/labelRoom.js +154 -0
  95. package/es/src/charts/Pie/outsideLabels.js +224 -0
  96. package/es/src/charts/Pie/outsideNodes.js +267 -0
  97. package/es/src/charts/Pie/pieLabels.js +137 -0
  98. package/es/src/charts/Pie/sectorBox.js +223 -0
  99. package/es/src/charts/Pie/straightLabels.js +96 -0
  100. package/es/src/charts/Pie/straightLayout.js +215 -0
  101. package/es/src/charts/Plot/alongLegend.js +76 -0
  102. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  103. package/es/src/charts/Plot/axisHover.js +180 -0
  104. package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
  105. package/es/src/charts/Plot/axisHoverScene.js +203 -0
  106. package/es/src/charts/Plot/axisValues.js +43 -0
  107. package/es/src/charts/Plot/barHitArea.js +81 -0
  108. package/es/src/charts/Plot/barLabelFit.js +123 -0
  109. package/es/src/charts/Plot/barWidth.js +61 -13
  110. package/es/src/charts/Plot/circleLabels.js +98 -0
  111. package/es/src/charts/Plot/confidenceConfig.js +2 -2
  112. package/es/src/charts/Plot/connectGaps.js +237 -0
  113. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  114. package/es/src/charts/Plot/draw.js +14 -4
  115. package/es/src/charts/Plot/fillBetween.js +2 -1
  116. package/es/src/charts/Plot/forecastScene.js +3 -4
  117. package/es/src/charts/Plot/index.js +42 -15
  118. package/es/src/charts/Plot/labelPlacement.js +10 -2
  119. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  120. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  121. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  122. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  123. package/es/src/charts/Plot/openDomainEnds.js +2 -5
  124. package/es/src/charts/Plot/pipeline.js +71 -22
  125. package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
  126. package/es/src/charts/Plot/pipelineDomains.js +23 -6
  127. package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
  128. package/es/src/charts/Plot/pipelineScales.js +40 -8
  129. package/es/src/charts/Plot/plotFacet.js +12 -1
  130. package/es/src/charts/Plot/plotInit.js +49 -5
  131. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  132. package/es/src/charts/Plot/plotZoom.js +15 -6
  133. package/es/src/charts/Plot/referenceDomains.js +133 -0
  134. package/es/src/charts/Plot/shapeDefaults.js +14 -9
  135. package/es/src/charts/Plot/sharedHoverScene.js +50 -31
  136. package/es/src/charts/Plot/sharedTooltip.js +19 -7
  137. package/es/src/charts/Plot/stackHelpers.js +13 -1
  138. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  139. package/es/src/charts/Plot/stackShareTooltip.js +9 -4
  140. package/es/src/charts/Plot/stackThreshold.js +154 -0
  141. package/es/src/charts/Plot/trendLabels.js +183 -0
  142. package/es/src/charts/Plot/trendLines.js +1 -0
  143. package/es/src/charts/Plot/trendScene.js +6 -3
  144. package/es/src/charts/Plot/trendTooltip.js +5 -1
  145. package/es/src/charts/PolarArea/index.js +5 -4
  146. package/es/src/charts/Priestley/applyLayout.js +14 -20
  147. package/es/src/charts/Priestley/index.js +4 -34
  148. package/es/src/charts/Priestley/timeAxis.js +100 -0
  149. package/es/src/charts/Pyramid/index.js +4 -2
  150. package/es/src/charts/Radar/axisDecorations.js +49 -12
  151. package/es/src/charts/Radar/curvedLabels.js +187 -0
  152. package/es/src/charts/Radar/index.js +5 -5
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +4 -1
  155. package/es/src/charts/RadialBar/index.js +18 -10
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/index.js +6 -9
  158. package/es/src/charts/Rings/applyLayout.js +41 -24
  159. package/es/src/charts/Rings/emit.js +174 -58
  160. package/es/src/charts/Rings/index.js +65 -30
  161. package/es/src/charts/Rings/ringsGraph.js +28 -9
  162. package/es/src/charts/Rings/ringsLoops.js +73 -0
  163. package/es/src/charts/Rings/ringsParallel.js +166 -0
  164. package/es/src/charts/Sankey/applyLayout.js +116 -39
  165. package/es/src/charts/Sankey/circularLayout.js +208 -0
  166. package/es/src/charts/Sankey/circularLinks.js +301 -0
  167. package/es/src/charts/Sankey/emit.js +164 -94
  168. package/es/src/charts/Sankey/index.js +75 -77
  169. package/es/src/charts/Sankey/labels.js +80 -0
  170. package/es/src/charts/Sankey/ribbons.js +88 -0
  171. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  172. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  173. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  174. package/es/src/charts/Scatter/index.js +25 -0
  175. package/es/src/charts/SlopeChart/index.js +116 -0
  176. package/es/src/charts/SlopeChart/slope.js +95 -0
  177. package/es/src/charts/Streamgraph/index.js +51 -0
  178. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  179. package/es/src/charts/Sunburst/emit.js +74 -63
  180. package/es/src/charts/Sunburst/index.js +3 -3
  181. package/es/src/charts/Tree/index.js +2 -6
  182. package/es/src/charts/Treemap/applyLayout.js +14 -1
  183. package/es/src/charts/Treemap/emit.js +8 -2
  184. package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
  185. package/es/src/charts/Treemap/groupHeaders.js +95 -0
  186. package/es/src/charts/Treemap/index.js +17 -7
  187. package/es/src/charts/Treemap/thresholdFunction.js +11 -9
  188. package/es/src/charts/Violin/inner.js +3 -5
  189. package/es/src/charts/Waffle/index.js +4 -2
  190. package/es/src/charts/Waffle/tooltip.js +6 -2
  191. package/es/src/charts/Waterfall/index.js +4 -2
  192. package/es/src/charts/definition/makeChart.js +20 -5
  193. package/es/src/charts/drawSteps/backControl.js +17 -5
  194. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  195. package/es/src/charts/drawSteps/minimap.js +6 -5
  196. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  197. package/es/src/charts/drawSteps/saveChart.js +176 -0
  198. package/es/src/charts/drawSteps/saveControl.js +148 -0
  199. package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
  200. package/es/src/charts/drawSteps/searchControls.js +2 -1
  201. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  202. package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
  203. package/es/src/charts/drawSteps/topLeftControls.js +3 -1
  204. package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
  205. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  206. package/es/src/charts/events/click.legend.js +7 -2
  207. package/es/src/charts/events/click.shape.js +38 -2
  208. package/es/src/charts/events/mouseenter.js +9 -0
  209. package/es/src/charts/events/mousemove.legend.js +3 -0
  210. package/es/src/charts/events/mousemove.shape.js +12 -4
  211. package/es/src/charts/facet/drawFacets.js +14 -5
  212. package/es/src/charts/facet/facetConfig.js +2 -2
  213. package/es/src/charts/facet/facetData.js +2 -2
  214. package/es/src/charts/features/annotationFrame.js +179 -0
  215. package/es/src/charts/features/annotationText.js +83 -0
  216. package/es/src/charts/features/annotationTypes.js +10 -0
  217. package/es/src/charts/features/attributionFeature.js +6 -11
  218. package/es/src/charts/features/axes.js +9 -7
  219. package/es/src/charts/features/axesFinal.js +26 -4
  220. package/es/src/charts/features/axesMeasure.js +61 -6
  221. package/es/src/charts/features/calloutLayout.js +121 -0
  222. package/es/src/charts/features/calloutScene.js +155 -0
  223. package/es/src/charts/features/chartGeometry.js +1 -1
  224. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  225. package/es/src/charts/features/circleLabels.js +207 -0
  226. package/es/src/charts/features/colorScaleBucket.js +19 -1
  227. package/es/src/charts/features/colorScaleHover.js +70 -0
  228. package/es/src/charts/features/colorScaleValue.js +97 -0
  229. package/es/src/charts/features/curvedArrows.js +158 -0
  230. package/es/src/charts/features/edgeArrows.js +160 -4
  231. package/es/src/charts/features/edgeBundling.js +442 -0
  232. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  233. package/es/src/charts/features/ensureZoomDom.js +32 -8
  234. package/es/src/charts/features/features.js +45 -15
  235. package/es/src/charts/features/featuresColorScale.js +62 -8
  236. package/es/src/charts/features/featuresLegend.js +21 -32
  237. package/es/src/charts/features/legendKeys.js +64 -0
  238. package/es/src/charts/features/lineLabels.js +55 -46
  239. package/es/src/charts/features/linkBundle.js +19 -0
  240. package/es/src/charts/features/linkColor.js +72 -0
  241. package/es/src/charts/features/linkFields.js +86 -0
  242. package/es/src/charts/features/linkFocus.js +118 -0
  243. package/es/src/charts/features/linkInteraction.js +312 -0
  244. package/es/src/charts/features/linkKeys.js +20 -0
  245. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  246. package/es/src/charts/features/linkLabelPath.js +162 -0
  247. package/es/src/charts/features/linkLabels.js +340 -0
  248. package/es/src/charts/features/linkWidths.js +32 -0
  249. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  250. package/es/src/charts/features/pathLabels.js +50 -0
  251. package/es/src/charts/features/plotAnnotations.js +68 -17
  252. package/es/src/charts/features/plotPaint.js +42 -15
  253. package/es/src/charts/features/polyline.js +129 -0
  254. package/es/src/charts/features/referenceAnnotations.js +403 -0
  255. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  256. package/es/src/charts/features/ringLabelNodes.js +93 -0
  257. package/es/src/charts/features/ringLabels.js +222 -0
  258. package/es/src/charts/features/sceneBounds.js +26 -6
  259. package/es/src/charts/features/selfLoops.js +306 -0
  260. package/es/src/charts/features/shapeEmit.js +67 -30
  261. package/es/src/charts/features/shareKey.js +15 -0
  262. package/es/src/charts/features/sharedFields.js +15 -2
  263. package/es/src/charts/features/textHalo.js +29 -0
  264. package/es/src/charts/features/thresholdMembers.js +71 -0
  265. package/es/src/charts/helpers/densityChart.js +3 -1
  266. package/es/src/charts/helpers/valueTitle.js +6 -3
  267. package/es/src/charts/index.js +8 -0
  268. package/es/src/charts/partition/chartFields.js +6 -5
  269. package/es/src/charts/partition/hierarchy.js +2 -0
  270. package/es/src/charts/partition/interaction.js +9 -5
  271. package/es/src/charts/partition/zoom.js +7 -6
  272. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  273. package/es/src/charts/pipeline/preDrawData.js +77 -13
  274. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  275. package/es/src/charts/pipeline/vizDraw.js +40 -29
  276. package/es/src/charts/pipeline/vizPreDraw.js +29 -18
  277. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  278. package/es/src/charts/polar/config.js +2 -3
  279. package/es/src/charts/viz/Viz.js +82 -44
  280. package/es/src/charts/viz/VizBase.js +47 -19
  281. package/es/src/charts/viz/backgroundInk.js +13 -7
  282. package/es/src/charts/viz/dataPoller.js +52 -0
  283. package/es/src/charts/viz/focusRing.js +104 -0
  284. package/es/src/charts/viz/focusTargets.js +208 -0
  285. package/es/src/charts/viz/groupRow.js +35 -0
  286. package/es/src/charts/viz/history.js +74 -0
  287. package/es/src/charts/viz/interactionOpacity.js +19 -5
  288. package/es/src/charts/viz/keyboardNav.js +297 -0
  289. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  290. package/es/src/charts/viz/loaderFormat.js +114 -0
  291. package/es/src/charts/viz/missingFields.js +123 -0
  292. package/es/src/charts/viz/mountTarget.js +9 -0
  293. package/es/src/charts/viz/nearestHover.js +183 -0
  294. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  295. package/es/src/charts/viz/ordinalColor.js +14 -12
  296. package/es/src/charts/viz/pageTheme.js +83 -0
  297. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  298. package/es/src/charts/viz/pointVoronoi.js +124 -0
  299. package/es/src/charts/viz/reducedMotion.js +27 -0
  300. package/es/src/charts/viz/reportHandlerError.js +10 -0
  301. package/es/src/charts/viz/shapeClassTargets.js +18 -2
  302. package/es/src/charts/viz/simpleHover.js +2 -0
  303. package/es/src/charts/viz/vizClassName.js +31 -0
  304. package/es/src/charts/viz/vizDataPolling.js +172 -0
  305. package/es/src/charts/viz/vizDefaults.js +81 -23
  306. package/es/src/charts/viz/vizFields.js +53 -2
  307. package/es/src/charts/viz/vizRender.js +49 -28
  308. package/es/src/charts/viz/vizTheme.js +96 -0
  309. package/es/src/charts/viz/vizVisibility.js +14 -0
  310. package/es/src/components/Axis/Axis.js +34 -0
  311. package/es/src/components/Axis/AxisBottom.js +1 -0
  312. package/es/src/components/Axis/AxisLeft.js +1 -0
  313. package/es/src/components/Axis/AxisRight.js +1 -0
  314. package/es/src/components/Axis/AxisTop.js +1 -0
  315. package/es/src/components/Axis/axisBreak.js +4 -1
  316. package/es/src/components/Axis/axisDefaults.js +8 -10
  317. package/es/src/components/Axis/axisLabelAngle.js +175 -0
  318. package/es/src/components/Axis/axisLabelThinning.js +13 -4
  319. package/es/src/components/Axis/axisLayout.js +86 -19
  320. package/es/src/components/Axis/axisLayoutLabels.js +66 -13
  321. package/es/src/components/Axis/axisLayoutScale.js +10 -1
  322. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  323. package/es/src/components/Axis/axisRender.js +38 -9
  324. package/es/src/components/Axis/axisRounding.js +15 -4
  325. package/es/src/components/Axis/axisSlantWrap.js +39 -0
  326. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  327. package/es/src/components/Axis/powTicks.js +73 -0
  328. package/es/src/components/Axis/rangeBreaks.js +201 -0
  329. package/es/src/components/Axis/timeValues.js +19 -4
  330. package/es/src/components/ColorScale/ColorScale.js +42 -36
  331. package/es/src/components/ColorScale/bucketBounds.js +64 -0
  332. package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
  333. package/es/src/components/ColorScale/colorScaleRender.js +25 -1
  334. package/es/src/components/ColorScale/colorScaleScale.js +43 -24
  335. package/es/src/components/ColorScale/colorScaleType.js +26 -0
  336. package/es/src/components/Legend/Legend.js +3 -0
  337. package/es/src/components/Legend/legendConfig.js +2 -6
  338. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  339. package/es/src/components/TextBox.js +31 -65
  340. package/es/src/components/Timeline/Timeline.js +54 -54
  341. package/es/src/components/Timeline/brushSpan.js +78 -0
  342. package/es/src/components/Timeline/timelineConfig.js +27 -10
  343. package/es/src/components/Timeline/timelineMode.js +26 -0
  344. package/es/src/components/Timeline/timelineRender.js +51 -9
  345. package/es/src/components/Tooltip.js +28 -13
  346. package/es/src/components/fontStack.js +20 -0
  347. package/es/src/components/textBoxLayout.js +58 -21
  348. package/es/src/components/textBoxPath.js +73 -0
  349. package/es/src/components/textBoxScene.js +223 -0
  350. package/es/src/components/textBoxWords.js +70 -0
  351. package/es/src/shapes/Area.js +1 -0
  352. package/es/src/shapes/Bar.js +1 -0
  353. package/es/src/shapes/Box.js +67 -79
  354. package/es/src/shapes/Circle.js +1 -0
  355. package/es/src/shapes/Line.js +1 -0
  356. package/es/src/shapes/Path.js +1 -0
  357. package/es/src/shapes/Rect.js +1 -0
  358. package/es/src/shapes/Shape.js +1 -0
  359. package/es/src/shapes/Whisker.js +1 -0
  360. package/es/src/shapes/boxOutlierShape.js +19 -0
  361. package/es/src/shapes/boxStats.js +35 -0
  362. package/es/src/shapes/boxStyle.js +78 -0
  363. package/es/src/shapes/boxSummary.js +174 -0
  364. package/es/src/shapes/shapeStandalone.js +2 -0
  365. package/es/src/utils/BaseClass.js +44 -12
  366. package/es/src/utils/className.js +78 -0
  367. package/es/src/utils/configPrep.js +2 -1
  368. package/es/src/utils/configWarnings.js +25 -0
  369. package/es/src/utils/constant.js +13 -1
  370. package/es/src/utils/displayName.js +12 -0
  371. package/es/src/utils/fieldAccessor.js +31 -0
  372. package/es/src/utils/paintComponentScene.js +2 -0
  373. package/es/src/utils/theme.js +190 -0
  374. package/es/src/utils/themeInk.js +68 -0
  375. package/package.json +14 -10
  376. package/types/index.d.ts +8 -2
  377. package/types/internal.d.ts +253 -9
  378. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  379. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  380. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  381. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  382. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  383. package/types/src/charts/Alluvial/index.d.ts +27 -0
  384. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  385. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  386. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  387. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  388. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  389. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  390. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  391. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  392. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  393. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  394. package/types/src/charts/BoxWhisker/index.d.ts +3 -1
  395. package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
  396. package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
  397. package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
  398. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  399. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  400. package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
  401. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  402. package/types/src/charts/Chord/labels.d.ts +66 -0
  403. package/types/src/charts/Donut/index.d.ts +2 -1
  404. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  405. package/types/src/charts/Gantt/emit.d.ts +17 -0
  406. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  407. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  408. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  409. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  410. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  411. package/types/src/charts/Gantt/index.d.ts +36 -0
  412. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  413. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  414. package/types/src/charts/Geomap/emit.d.ts +2 -2
  415. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  416. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  417. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  418. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  419. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  420. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  421. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  422. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  423. package/types/src/charts/Geomap/index.d.ts +3 -0
  424. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  425. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  426. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  427. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  428. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  429. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  430. package/types/src/charts/Hexbin/index.d.ts +25 -0
  431. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  432. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  433. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  434. package/types/src/charts/Histogram/binData.d.ts +20 -1
  435. package/types/src/charts/Histogram/index.d.ts +3 -2
  436. package/types/src/charts/Histogram/labels.d.ts +7 -0
  437. package/types/src/charts/Marimekko/index.d.ts +2 -1
  438. package/types/src/charts/Network/bundle.d.ts +67 -0
  439. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  440. package/types/src/charts/Network/clusters.d.ts +115 -0
  441. package/types/src/charts/Network/graph.d.ts +65 -0
  442. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  443. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  444. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  445. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  446. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  447. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  448. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  449. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  450. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  451. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  452. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  453. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  454. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  455. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  456. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  457. package/types/src/charts/Plot/axisHover.d.ts +68 -0
  458. package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
  459. package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
  460. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  461. package/types/src/charts/Plot/barHitArea.d.ts +59 -0
  462. package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
  463. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  464. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  465. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  466. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  467. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  468. package/types/src/charts/Plot/index.d.ts +28 -8
  469. package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
  470. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  471. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  472. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  473. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  474. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  475. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  476. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  477. package/types/src/charts/Plot/plotInit.d.ts +23 -2
  478. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  479. package/types/src/charts/Plot/plotZoom.d.ts +2 -0
  480. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  481. package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
  482. package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
  483. package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
  484. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  485. package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
  486. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  487. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  488. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  489. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  490. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  491. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  492. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  493. package/types/src/charts/Rings/emit.d.ts +50 -0
  494. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  495. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  496. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  497. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  498. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  499. package/types/src/charts/Sankey/emit.d.ts +58 -0
  500. package/types/src/charts/Sankey/labels.d.ts +19 -0
  501. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  502. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  503. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  504. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  505. package/types/src/charts/Scatter/index.d.ts +15 -0
  506. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  507. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  508. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  509. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  510. package/types/src/charts/Treemap/emit.d.ts +2 -1
  511. package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
  512. package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
  513. package/types/src/charts/Treemap/index.d.ts +2 -0
  514. package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
  515. package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
  516. package/types/src/charts/definition/makeChart.d.ts +5 -3
  517. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  518. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  519. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  520. package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
  521. package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
  522. package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
  523. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
  524. package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
  525. package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
  526. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  527. package/types/src/charts/events/click.legend.d.ts +2 -1
  528. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  529. package/types/src/charts/facet/facetData.d.ts +1 -1
  530. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  531. package/types/src/charts/features/annotationText.d.ts +57 -0
  532. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  533. package/types/src/charts/features/axesMeasure.d.ts +13 -1
  534. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  535. package/types/src/charts/features/calloutScene.d.ts +40 -0
  536. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  537. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  538. package/types/src/charts/features/circleLabels.d.ts +130 -0
  539. package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
  540. package/types/src/charts/features/colorScaleHover.d.ts +32 -0
  541. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  542. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  543. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  544. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  545. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  546. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  547. package/types/src/charts/features/features.d.ts +8 -0
  548. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  549. package/types/src/charts/features/legendKeys.d.ts +34 -0
  550. package/types/src/charts/features/lineLabels.d.ts +15 -12
  551. package/types/src/charts/features/linkBundle.d.ts +16 -0
  552. package/types/src/charts/features/linkColor.d.ts +48 -0
  553. package/types/src/charts/features/linkFields.d.ts +16 -0
  554. package/types/src/charts/features/linkFocus.d.ts +51 -0
  555. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  556. package/types/src/charts/features/linkKeys.d.ts +11 -0
  557. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  558. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  559. package/types/src/charts/features/linkLabels.d.ts +77 -0
  560. package/types/src/charts/features/linkWidths.d.ts +19 -0
  561. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  562. package/types/src/charts/features/pathLabels.d.ts +41 -0
  563. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  564. package/types/src/charts/features/plotPaint.d.ts +19 -0
  565. package/types/src/charts/features/polyline.d.ts +32 -0
  566. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  567. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  568. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  569. package/types/src/charts/features/ringLabels.d.ts +164 -0
  570. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  571. package/types/src/charts/features/selfLoops.d.ts +165 -0
  572. package/types/src/charts/features/shapeEmit.d.ts +5 -1
  573. package/types/src/charts/features/shareKey.d.ts +9 -0
  574. package/types/src/charts/features/sharedFields.d.ts +11 -2
  575. package/types/src/charts/features/textHalo.d.ts +14 -0
  576. package/types/src/charts/features/thresholdMembers.d.ts +38 -0
  577. package/types/src/charts/helpers/valueTitle.d.ts +4 -2
  578. package/types/src/charts/index.d.ts +8 -0
  579. package/types/src/charts/partition/interaction.d.ts +6 -3
  580. package/types/src/charts/partition/zoom.d.ts +4 -4
  581. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  582. package/types/src/charts/pipeline/stages.d.ts +9 -0
  583. package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
  584. package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
  585. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  586. package/types/src/charts/viz/Viz.d.ts +44 -6
  587. package/types/src/charts/viz/VizBase.d.ts +16 -7
  588. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  589. package/types/src/charts/viz/dataPoller.d.ts +28 -0
  590. package/types/src/charts/viz/focusRing.d.ts +25 -0
  591. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  592. package/types/src/charts/viz/groupRow.d.ts +24 -0
  593. package/types/src/charts/viz/history.d.ts +35 -0
  594. package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
  595. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  596. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  597. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  598. package/types/src/charts/viz/missingFields.d.ts +57 -0
  599. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  600. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  601. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  602. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  603. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  604. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  605. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  606. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  607. package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
  608. package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
  609. package/types/src/charts/viz/simpleHover.d.ts +2 -1
  610. package/types/src/charts/viz/vizClassName.d.ts +23 -0
  611. package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
  612. package/types/src/charts/viz/vizDefaults.d.ts +49 -9
  613. package/types/src/charts/viz/vizFields.d.ts +47 -0
  614. package/types/src/charts/viz/vizRender.d.ts +2 -1
  615. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  616. package/types/src/charts/viz/vizTypes.d.ts +117 -8
  617. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  618. package/types/src/components/Axis/Axis.d.ts +37 -8
  619. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  620. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  621. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  622. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  623. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  624. package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
  625. package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
  626. package/types/src/components/Axis/axisLayout.d.ts +5 -0
  627. package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
  628. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  629. package/types/src/components/Axis/axisRounding.d.ts +6 -3
  630. package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
  631. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  632. package/types/src/components/Axis/powTicks.d.ts +29 -0
  633. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  634. package/types/src/components/Axis/timeValues.d.ts +1 -1
  635. package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
  636. package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
  637. package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
  638. package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
  639. package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
  640. package/types/src/components/Legend/Legend.d.ts +1 -0
  641. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  642. package/types/src/components/TextBox.d.ts +1 -0
  643. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  644. package/types/src/components/Timeline/brushSpan.d.ts +41 -0
  645. package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
  646. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  647. package/types/src/components/Timeline/timelineRender.d.ts +8 -0
  648. package/types/src/components/Tooltip.d.ts +12 -3
  649. package/types/src/components/fontStack.d.ts +10 -0
  650. package/types/src/components/textBoxLayout.d.ts +18 -9
  651. package/types/src/components/textBoxPath.d.ts +59 -0
  652. package/types/src/components/textBoxScene.d.ts +51 -0
  653. package/types/src/components/textBoxWords.d.ts +33 -0
  654. package/types/src/shapes/Area.d.ts +1 -0
  655. package/types/src/shapes/Bar.d.ts +1 -0
  656. package/types/src/shapes/Box.d.ts +2 -8
  657. package/types/src/shapes/Circle.d.ts +1 -0
  658. package/types/src/shapes/Line.d.ts +1 -0
  659. package/types/src/shapes/Path.d.ts +1 -0
  660. package/types/src/shapes/Rect.d.ts +1 -0
  661. package/types/src/shapes/Shape.d.ts +1 -0
  662. package/types/src/shapes/Whisker.d.ts +1 -0
  663. package/types/src/shapes/boxOutlierShape.d.ts +9 -0
  664. package/types/src/shapes/boxStats.d.ts +19 -0
  665. package/types/src/shapes/boxStyle.d.ts +25 -0
  666. package/types/src/shapes/boxSummary.d.ts +66 -0
  667. package/types/src/shapes/emitLabels.d.ts +1 -1
  668. package/types/src/shapes/shapeConfig.d.ts +42 -4
  669. package/types/src/utils/BaseClass.d.ts +32 -0
  670. package/types/src/utils/D3Scale.d.ts +3 -0
  671. package/types/src/utils/D3plusConfig.d.ts +1240 -33
  672. package/types/src/utils/className.d.ts +64 -0
  673. package/types/src/utils/configPrep.d.ts +2 -0
  674. package/types/src/utils/configWarnings.d.ts +21 -2
  675. package/types/src/utils/constant.d.ts +8 -0
  676. package/types/src/utils/displayName.d.ts +10 -0
  677. package/types/src/utils/fieldAccessor.d.ts +24 -0
  678. package/types/src/utils/index.d.ts +1 -1
  679. package/types/src/utils/paintComponentScene.d.ts +3 -1
  680. package/types/src/utils/theme.d.ts +170 -0
  681. package/types/src/utils/themeInk.d.ts +56 -0
  682. package/umd/d3plus-core.full.js +87388 -56271
  683. package/umd/d3plus-core.full.min.js +2 -2
  684. package/umd/d3plus-core.js +37988 -11768
  685. package/umd/d3plus-core.min.js +2 -2
  686. package/es/src/components/Axis/gridStroke.js +0 -10
  687. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -0,0 +1,68 @@
1
+ /**
2
+ Axis hover for Plot charts (#782): hovering a mark draws a dashed guide
3
+ from its point to each axis and a badge on the axis with the point's
4
+ value there, formatted as the tooltip formats that axis. With a discrete
5
+ axis it follows the snapped hover (see `sharedHover.ts`): the crosshair is
6
+ the discrete axis's guide, and the value axis gets the hovered (or
7
+ nearest) series' point.
8
+ */
9
+ import type { DataPoint } from "@d3plus/data";
10
+ import type { SceneEvent } from "@d3plus/render";
11
+ import type { VizInstance } from "../viz/vizTypes.js";
12
+ import { type AxisName } from "./axisHoverAnchors.js";
13
+ /** One axis's badge: where it sits along the axis, and its text. */
14
+ export interface AxisHoverBadge {
15
+ axis: AxisName;
16
+ /** The badge's center along the axis, in chart content space. */
17
+ at: number;
18
+ text: string;
19
+ /** Whether a guide runs from the point to this axis (the crosshair is the discrete axis's guide). */
20
+ guide: boolean;
21
+ }
22
+ /** The active axis hover: the hovered point, its color and row, and its badges. */
23
+ export interface AxisHoverState {
24
+ point: {
25
+ x: number;
26
+ y: number;
27
+ };
28
+ color?: string;
29
+ datum: DataPoint;
30
+ index: number;
31
+ badges: AxisHoverBadge[];
32
+ /** The small-multiples panel the hover is in, by key. */
33
+ panel?: string;
34
+ }
35
+ /**
36
+ The value an axis reads at `pixel`: the record's own value when it is
37
+ drawn there, else the scale inverted at the pixel (a stacked mark's top
38
+ sits at the stack's running total, not its own value).
39
+ @param value The record's value on the axis.
40
+ @param position Where `value` lands on the axis.
41
+ @param pixel Where the anchor sits on the axis.
42
+ @param invert The axis's pixel → value mapping, when it has one.
43
+ */
44
+ export declare function axisValueAt(value: unknown, position: number, pixel: number, invert?: (px: number) => unknown): unknown;
45
+ /**
46
+ A badge's text for `value`, as plain text: `value` run through `format`,
47
+ with any markup removed. Empty for a missing value.
48
+ @param format The axis's value formatter.
49
+ @param value The value to label.
50
+ */
51
+ export declare function formatAxisValue(format: ((d: unknown) => string) | undefined, value: unknown): string;
52
+ /**
53
+ Resolves the axis hover for a pointer event (see the module notes), or
54
+ null when nothing is hovered, the point is outside the plot area, or no
55
+ axis has a value to show.
56
+ @param viz The Plot.
57
+ @param event The pointer event.
58
+ @param cursor The pointer in chart content space.
59
+ */
60
+ export declare function resolveAxisHover(viz: VizInstance, event: SceneEvent, cursor: [number, number]): AxisHoverState | null;
61
+ /**
62
+ Plot's axis hover handler, run after the snapped hover resolves: tracks
63
+ the hovered point across moves and clears when the pointer leaves it,
64
+ repainting only when what it draws changes. Off with `axisHover(false)`.
65
+ @param viz The Plot.
66
+ @param event The pointer event.
67
+ */
68
+ export declare function handleAxisHover(viz: VizInstance, event: SceneEvent): void;
@@ -0,0 +1,88 @@
1
+ /**
2
+ The points a Plot's axis hover (#782) can snap to: a Line/Area's points, a
3
+ Circle's center, and a Bar's end, read from the painted chart scene.
4
+ */
5
+ import type { DataPoint } from "@d3plus/data";
6
+ import type { VizInstance } from "../viz/vizTypes.js";
7
+ import type { ShapeNode } from "./sharedHover.js";
8
+ /** One of a Plot's four axes. */
9
+ export type AxisName = "x" | "x2" | "y" | "y2";
10
+ /** A plotted record as Plot wraps it: its axis values plus the source row. */
11
+ export type AnchorDatum = DataPoint & {
12
+ data?: DataPoint;
13
+ i?: number;
14
+ id?: unknown;
15
+ x?: unknown;
16
+ x2?: unknown;
17
+ y?: unknown;
18
+ y2?: unknown;
19
+ };
20
+ /** A point a mark draws a value at, in chart content space. */
21
+ export interface AxisHoverAnchor {
22
+ x: number;
23
+ y: number;
24
+ datum: AnchorDatum;
25
+ color?: string;
26
+ shape?: string;
27
+ /** A bar's extent along its value axis, from its base to its end. */
28
+ span?: [number, number];
29
+ }
30
+ /**
31
+ Which edge of a bar's rect is its end: the edge farther from the bar's
32
+ base, which its transform sits on (a negative bar runs the other way).
33
+ @param offset The rect's start along the value axis, relative to the base.
34
+ @param length The rect's size along the value axis.
35
+ */
36
+ export declare function barEndOffset(offset: number, length: number): number;
37
+ /**
38
+ Moves an anchor along its value axis to `end`, spanning from where it was
39
+ (an Area's points sit on its baseline; its value is drawn at its top edge).
40
+ @param anchor The anchor.
41
+ @param end Its end along the value axis.
42
+ @param valueAxis The axis the mark's values run along.
43
+ */
44
+ export declare function liftAnchor(anchor: AxisHoverAnchor, end: number, valueAxis: "x" | "y"): AxisHoverAnchor;
45
+ /**
46
+ The anchors one mark node draws: each of a Line/Area's interaction points
47
+ (an Area's sit on its baseline, see `liftAnchor`), a circle's center, a Bar's end (along `valueAxis`), or another rect's
48
+ center. Nodes without a source datum, and those drawn for another mark,
49
+ have none.
50
+ @param node The mark's scene node.
51
+ @param valueAxis The axis a Bar's length runs along.
52
+ @param color The mark's color.
53
+ */
54
+ export declare function markAnchors(node: ShapeNode, valueAxis: "x" | "y", color?: string): AxisHoverAnchor[];
55
+ /** Whether a scene node is a data mark the axis hover reads. */
56
+ export declare function isAnchorMark(node: ShapeNode | undefined): node is ShapeNode;
57
+ /** Every anchor the chart's marks draw (see `markAnchors`). */
58
+ export declare function collectAnchors(viz: VizInstance): AxisHoverAnchor[];
59
+ /**
60
+ The anchor nearest `target` along one axis. A bar holding the target
61
+ within its span counts as no distance away.
62
+ @param anchors The candidates.
63
+ @param axis The axis the distance is measured along.
64
+ @param target The position, in chart content space.
65
+ */
66
+ export declare function nearestAnchor(anchors: AxisHoverAnchor[], axis: "x" | "y", target: number): AxisHoverAnchor | null;
67
+ /**
68
+ The anchor nearest a point in both directions.
69
+ @param anchors The candidates.
70
+ @param point The position, in chart content space.
71
+ */
72
+ export declare function closestAnchor(anchors: AxisHoverAnchor[], point: [number, number]): AxisHoverAnchor | null;
73
+ /**
74
+ The axes a hovered anchor gets a guide and badge on: x and y, each the
75
+ secondary axis when the record is plotted against it. A bar leaves out its
76
+ discrete axis (its band is labeled already), a swarm leaves out the axis
77
+ its circles are packed along, and `only` keeps just one direction.
78
+ @param datum The anchor's record.
79
+ @param options `discrete`: the chart's discrete axis; `bar`: whether the
80
+ anchor is a Bar's end; `cross`: a swarm's packing axis; `only`: the one
81
+ direction to keep (`axisHover: "x"` or `"y"`).
82
+ */
83
+ export declare function anchorAxes(datum: AnchorDatum, options: {
84
+ discrete?: "x" | "y";
85
+ bar?: boolean;
86
+ cross?: "x" | "y";
87
+ only?: "x" | "y";
88
+ }): AxisName[];
@@ -0,0 +1,88 @@
1
+ import type { DataPoint } from "@d3plus/data";
2
+ import type { SceneNode } from "@d3plus/render";
3
+ import type { VizInstance } from "../viz/vizTypes.js";
4
+ import type { AxisHoverState } from "./axisHover.js";
5
+ import type { AxisName } from "./axisHoverAnchors.js";
6
+ /** The plot area's edges in chart content space, where each axis line sits. */
7
+ export interface PlotEdges {
8
+ left: number;
9
+ right: number;
10
+ top: number;
11
+ bottom: number;
12
+ }
13
+ /** A badge's box, in chart content space. */
14
+ export interface BadgeBox {
15
+ x: number;
16
+ y: number;
17
+ width: number;
18
+ height: number;
19
+ }
20
+ /** A style value: a constant, or an accessor of the hovered row. */
21
+ type Style<T> = T | ((d: DataPoint, i: number) => T);
22
+ /** The `axisHoverConfig` options. */
23
+ export interface AxisHoverConfig {
24
+ /** Paint for the guide lines; `stroke` defaults to the hovered mark's color. */
25
+ guideConfig?: {
26
+ stroke?: Style<string>;
27
+ strokeDasharray?: Style<string | number[]>;
28
+ strokeOpacity?: Style<number>;
29
+ strokeWidth?: Style<number>;
30
+ };
31
+ /** The value badges; `fill` defaults to the hovered mark's color, `fontColor` to a contrasting ink. */
32
+ badgeConfig?: {
33
+ fill?: Style<string>;
34
+ fontColor?: Style<string>;
35
+ fontFamily?: Style<string>;
36
+ fontSize?: Style<number>;
37
+ fontWeight?: Style<number | string>;
38
+ padding?: Style<number>;
39
+ rx?: Style<number>;
40
+ };
41
+ }
42
+ /** `axisHoverConfig`'s defaults. */
43
+ export declare function axisHoverDefaults(): AxisHoverConfig;
44
+ /**
45
+ The plot area's edges: the x axis along the bottom, x2 along the top, y
46
+ on the left, and y2 on the right.
47
+ @param area The plot area.
48
+ */
49
+ export declare function plotEdges(area: {
50
+ x: number;
51
+ y: number;
52
+ width: number;
53
+ height: number;
54
+ }): PlotEdges;
55
+ /**
56
+ The guide from a point straight across to an axis line.
57
+ @param axis The axis the guide runs to.
58
+ @param point The hovered point.
59
+ @param edges The plot area's edges.
60
+ */
61
+ export declare function guidePoints(axis: AxisName, point: {
62
+ x: number;
63
+ y: number;
64
+ }, edges: PlotEdges): [number, number][];
65
+ /**
66
+ A badge's box: centered on `at` along its axis, and set just outside the
67
+ axis line, over the tick labels.
68
+ @param axis The axis the badge labels.
69
+ @param at The badge's center along the axis.
70
+ @param size The badge's width and height.
71
+ @param edges The plot area's edges.
72
+ */
73
+ export declare function badgeBox(axis: AxisName, at: number, size: {
74
+ width: number;
75
+ height: number;
76
+ }, edges: PlotEdges): BadgeBox;
77
+ /**
78
+ The axis hover's scene nodes, in chart content space: `guides` to draw
79
+ with the plot's marks (inside its zoom clip), and `badges` to draw over
80
+ the axes.
81
+ @param viz The Plot, with the hovered panel's state in place.
82
+ @param state The active axis hover.
83
+ */
84
+ export declare function axisHoverNodes(viz: VizInstance, state: AxisHoverState): {
85
+ guides: SceneNode[];
86
+ badges: SceneNode[];
87
+ };
88
+ export {};
@@ -0,0 +1,24 @@
1
+ /**
2
+ The sorted values a continuous Plot axis spans.
3
+
4
+ @module
5
+ */
6
+ /** A row of Plot's axis data: its axis values, and the row they came from. */
7
+ type AxisRow = Record<string, unknown>;
8
+ /**
9
+ `numbers` sorted ascending (stably, as `sort((a, b) => a - b)`) without
10
+ repeats, keeping the first of each. Sorted as a Float64Array, which
11
+ orders them the same way, unless NaN (which that comparator leaves in
12
+ place) or both zeros (which it keeps in their order, where a Float64Array
13
+ puts -0 first) are among them.
14
+ */
15
+ export declare function uniqueSortedNumbers(numbers: number[]): number[];
16
+ /**
17
+ The values of `axis` across `rows`, sorted (by `sort`, else ascending)
18
+ and without repeats (compared as strings, the
19
+ first of each kept). Sorts `rows` in place, except when every value is a
20
+ number and there is no `sort`: those values are sorted on their own,
21
+ which gives the same list.
22
+ */
23
+ export declare function sortedAxisValues(rows: AxisRow[], axis: string, sort?: (a: AxisRow, b: AxisRow) => number): unknown[];
24
+ export {};
@@ -0,0 +1,59 @@
1
+ /**
2
+ Bar hit areas: a transparent hover target behind each side-by-side bar
3
+ that fills the bar's slot along the discrete axis and the whole plot along
4
+ the value axis, so a short bar is as easy to hover and click as a tall
5
+ one. Grouped bars each take their own column of the slot. Stacked bars
6
+ already fill their slot and take none. `shapeConfig.Bar.hitArea: false`
7
+ turns them off.
8
+
9
+ @module
10
+ */
11
+ import type { DataPoint } from "@d3plus/data";
12
+ import type { SceneNode } from "@d3plus/render";
13
+ import type { Shape } from "../../shapes/index.js";
14
+ /** Rect bounds in a bar's own coordinates (relative to its transform). */
15
+ export interface HitBounds {
16
+ x: number;
17
+ y: number;
18
+ width: number;
19
+ height: number;
20
+ }
21
+ /**
22
+ A bar's column of its slot along the discrete axis, as offsets from the
23
+ bar's own center. A lone bar takes the whole slot. Grouped bars split it
24
+ at the midpoints between their centers, and the outermost reach the
25
+ slot's edges, so no column overlaps a neighboring bar.
26
+ @param step The slot's width: the distance between neighboring categories.
27
+ @param count How many bars share the slot.
28
+ @param index The bar's position in the slot.
29
+ @param reach How far the outermost bars' centers sit from the slot's center.
30
+ */
31
+ export declare function hitColumn(step: number, count: number, index: number, reach: number): [number, number];
32
+ /**
33
+ A bar's hit rect in its own coordinates: its `column` along the discrete
34
+ axis, and the plot's `valueExtent` along the value axis, both sides of
35
+ the baseline.
36
+ @param discrete The discrete axis.
37
+ @param column The column, as offsets from the bar's center (see `hitColumn`).
38
+ @param valueExtent The value axis's pixel span, in shape coordinates.
39
+ @param origin The bar's transform.
40
+ */
41
+ export declare function hitBounds(discrete: "x" | "y", column: [number, number], valueExtent: [number, number], origin: {
42
+ x?: number;
43
+ y?: number;
44
+ }): HitBounds;
45
+ /**
46
+ Gives a Bar shape its slot-filling hit areas (see `hitBounds`). Set
47
+ before the user's `shapeConfig`, so `hitArea` there (or `false`) wins.
48
+ @param s The Bar shape.
49
+ @param discrete The discrete axis.
50
+ @param valueExtent The value axis's pixel span, in shape coordinates.
51
+ @param column Each bar's column (see `hitColumn`).
52
+ */
53
+ export declare function applyBarHitArea(s: Shape, discrete: "x" | "y", valueExtent: [number, number] | undefined, column: (d: DataPoint, i: number) => [number, number]): void;
54
+ /**
55
+ `nodes` with every Bar hit area moved to the front (painted first), so
56
+ each sits behind every mark: a bar's slot never covers another bar, nor
57
+ the lines, points, and areas drawn over it.
58
+ */
59
+ export declare function barHitsFirst(nodes: SceneNode[]): SceneNode[];
@@ -0,0 +1,81 @@
1
+ import type { VizInstance } from "../viz/vizTypes.js";
2
+ /** A formatted Plot row: its source `data`, index, and positions. */
3
+ type Row = Record<string, unknown>;
4
+ /** The category labels a Plot's bars carry in place of an axis's tick labels. */
5
+ export interface BarLabelCheck {
6
+ /** The category axis. */
7
+ axis: "x" | "y";
8
+ /** Each bar's label text. */
9
+ labels: string[];
10
+ /** The rows the labels belong to. */
11
+ rows: Row[];
12
+ }
13
+ /** The fields of the viz this module reads. */
14
+ interface FitViz {
15
+ schema: {
16
+ discrete?: string;
17
+ stacked?: unknown;
18
+ barPadding?: number;
19
+ };
20
+ _groupPadding?: number;
21
+ }
22
+ /**
23
+ The room each bar has for its label, in pixels: along the category axis,
24
+ the axis length split evenly among its `categories` (less `groupPadding`),
25
+ then among the `perCategory` bars sharing a category (less
26
+ `barPadding`); along the value axis, half the plot, which a bar's label
27
+ always has inside or beyond it.
28
+ @param discrete The category axis.
29
+ @param plot The plot area's size.
30
+ @param categories How many categories the axis holds.
31
+ @param perCategory How many bars share a category.
32
+ @param padding `groupPadding` and `barPadding`.
33
+ */
34
+ export declare function barLabelRoom(discrete: "x" | "y", plot: {
35
+ width: number;
36
+ height: number;
37
+ }, categories: number, perCategory: number, padding: {
38
+ group: number;
39
+ bar: number;
40
+ }): {
41
+ width: number;
42
+ height: number;
43
+ };
44
+ /**
45
+ Whether every label in `labels` (one per row in `rows`) fits, whole and
46
+ untruncated, in a `room`-sized box laid out with the bar `labelConfig`.
47
+ @param labels Each row's label text.
48
+ @param rows The rows the labels belong to.
49
+ @param room The box each label has (see `barLabelRoom`).
50
+ @param labelConfig The bars' resolved `labelConfig`.
51
+ */
52
+ export declare function barLabelsFit(labels: string[], rows: Row[], room: {
53
+ width: number;
54
+ height: number;
55
+ }, labelConfig: Record<string, unknown>): boolean;
56
+ /**
57
+ Whether the bars of `rows` have room for their category `labels` in a
58
+ plot of `plot` size (see `barLabelRoom` and `barLabelsFit`).
59
+ @param viz The chart.
60
+ @param rows The bar rows the labels belong to.
61
+ @param labels Each row's label text.
62
+ @param plot The plot area's size.
63
+ @param labelConfig The bars' resolved `labelConfig`.
64
+ */
65
+ export declare function barCategoryLabelsFit(viz: FitViz, rows: Row[], labels: string[], plot: {
66
+ width: number;
67
+ height: number;
68
+ }, labelConfig: Record<string, unknown>): boolean;
69
+ /**
70
+ Whether a category axis keeps the tick labels its bars carry (see
71
+ `BarLabelCheck`): when the bars, in a plot of `plot` size, have no room
72
+ for those labels.
73
+ @param viz The chart.
74
+ @param check The bars' category labels.
75
+ @param plot The plot area's size.
76
+ */
77
+ export declare function barLabelsNeedAxis(viz: VizInstance, check: BarLabelCheck, plot: {
78
+ width: number;
79
+ height: number;
80
+ }): boolean;
81
+ export {};
@@ -24,6 +24,8 @@ export interface BarSpan {
24
24
  end: number;
25
25
  /** The bar's center, where its rows are plotted and its label sits. */
26
26
  mid: number;
27
+ /** The merge of the bar's rows' data. */
28
+ data?: DataPoint;
27
29
  }
28
30
  /** A bar before layout: its category, width measure, and merged datum. */
29
31
  export interface MeasuredBar {
@@ -57,12 +59,13 @@ export declare function labelBarWidth(fn: BarWidthAccessor, text: string): BarWi
57
59
  */
58
60
  export declare function measureBars(rows: Row[], axis: "x" | "y", measure: BarWidthAccessor, aggs?: Aggs): MeasuredBar[];
59
61
  /**
60
- Lays bars end to end from zero, in order. Bars without a positive, finite
61
- width are dropped.
62
+ Lays bars end to end from zero, in order, keeping each bar's merged
63
+ `data`. Bars without a positive, finite width are dropped.
62
64
  */
63
65
  export declare function layoutBarSpans(bars: {
64
66
  value: unknown;
65
67
  size: number;
68
+ data?: DataPoint;
66
69
  }[]): BarSpan[];
67
70
  /**
68
71
  Applies `barWidth` to the formatted Plot rows: measures each bar over
@@ -77,6 +80,24 @@ export declare function applyBarWidths(viz: VizInstance, formattedData: Row[], a
77
80
  its own panel when faceted; empty without a total.
78
81
  */
79
82
  export declare function widthShareText(layout: BarSpanLayout, span: BarSpan, locale?: string): string;
83
+ /** What `barWidthShareFormat` receives about a bar, after its merged datum. */
84
+ export interface BarShareInfo {
85
+ /** The bar's share of the total width, from 0 to 1. */
86
+ share: number;
87
+ /** The bar's width measure. */
88
+ size: number;
89
+ /** Every bar's combined width (its own panel's, when faceted). */
90
+ total: number;
91
+ /** The default label: the share as a percentage, such as "23%". */
92
+ text: string;
93
+ }
94
+ /** A `barWidthShareFormat` function. */
95
+ export type BarShareFormat = (d: DataPoint, info: BarShareInfo) => unknown;
96
+ /**
97
+ A bar's width-share label: `barWidthShareFormat` called with the bar's
98
+ merged datum and its share, else the share as a percentage.
99
+ */
100
+ export declare function shareText(viz: VizInstance, layout: BarSpanLayout, span: BarSpan): string;
80
101
  /**
81
102
  A category's axis label with its bar's width share: on a second line
82
103
  beneath the name along a horizontal axis, after it in parentheses along
@@ -84,11 +105,24 @@ export declare function widthShareText(layout: BarSpanLayout, span: BarSpan, loc
84
105
  along the axis, so it never crowds a neighboring label out.
85
106
  */
86
107
  export declare function shareLabel(name: string, share: string, axis: "x" | "y"): string;
108
+ /**
109
+ The secondary axis that carries the width shares when `barWidthShare` is
110
+ "opposite": `x2` (above the bars) for bars along `x`, `y2` (right of them)
111
+ for bars along `y`. Undefined otherwise, or without variable widths.
112
+ */
113
+ export declare function shareAxis(viz: VizInstance): "x2" | "y2" | undefined;
114
+ /**
115
+ Axis config for the axis opposite a variable-width discrete axis when
116
+ `barWidthShare` is "opposite": each bar's width share labeled at its
117
+ center, with no line, ticks, gridlines, or title. Empty for any other
118
+ axis.
119
+ */
120
+ export declare function barShareAxisConfig(viz: VizInstance, axis: "x2" | "y2"): Record<string, unknown>;
87
121
  /**
88
122
  Axis config for a variable-width discrete axis: each category ticked and
89
123
  labeled at its bar's center, and nowhere else, with its width share when
90
- `barWidthShare` is on. Labels the axis rotates show the name alone. Empty
91
- for any other axis.
124
+ `barWidthShare` is `true`. Labels the axis rotates show the name alone.
125
+ Empty for any other axis.
92
126
  */
93
127
  export declare function barSpanAxisConfig(viz: VizInstance, axis: "x" | "y"): Record<string, unknown>;
94
128
  /** The tooltip name of the current `barWidth` measure. */
@@ -0,0 +1,29 @@
1
+ /**
2
+ Labels of a Plot's Circle marks (scatter, bubble, beeswarm points): each
3
+ stays inside its circle when it fits there, else moves beside it where
4
+ there's room, else hides (see `labelPosition` and `features/circleLabels.ts`).
5
+
6
+ @module
7
+ */
8
+ import type { SceneNode } from "@d3plus/render";
9
+ import type { Shape } from "../../shapes/index.js";
10
+ import type { ShapeEmitContext } from "../features/shapeEmit.js";
11
+ /**
12
+ Places the labels of a configured Circle shape before it renders: the
13
+ shape keeps the labels that stay inside (an `"auto"` one no smaller than
14
+ `pointLabelConfig.fontMin`), and the returned function emits the ones that
15
+ sit beside their circles, to paint over the circles. Returns null, leaving
16
+ the shape's labels alone, when the user gave the Circles their own
17
+ `labelBounds`.
18
+ @param ctx The shape group's emit context.
19
+ @param s The Circle shape, configured but not yet rendered.
20
+ @param userConfig The user's merged Circle shapeConfig.
21
+ */
22
+ export declare function plotCircleLabels(ctx: ShapeEmitContext, s: Shape, userConfig: Record<string, unknown>): (() => SceneNode[]) | null;
23
+ /**
24
+ Lifts a Circle group's labels over every circle. Sized circles are layered
25
+ by a `z` rank (largest behind), and a node without one sorts as 0, so
26
+ without this a label would paint beneath the circles layered over its own.
27
+ @param nodes The group's circles and labels.
28
+ */
29
+ export declare function labelsOverCircles(nodes: SceneNode[]): SceneNode[];
@@ -0,0 +1,99 @@
1
+ type Point = [number, number];
2
+ /** A stretch of a path, as `[start, end]` lengths along it. */
3
+ export type Interval = [number, number];
4
+ /** The style object `connectGaps` takes for a bridge. */
5
+ export interface ConnectGapsConfig {
6
+ stroke?: string;
7
+ strokeDasharray?: string | number | number[] | false;
8
+ strokeWidth?: number;
9
+ opacity?: number;
10
+ }
11
+ /** Everything `connectGaps` takes. */
12
+ export type ConnectGaps = boolean | "solid" | "dashed" | ConnectGapsConfig;
13
+ /** How a bridge across a gap is drawn. Unset keys take the line's own style. */
14
+ export interface GapBridge {
15
+ stroke?: string;
16
+ strokeDasharray?: number[];
17
+ strokeWidth?: number;
18
+ opacity: number;
19
+ }
20
+ /** The dash pattern `"dashed"` bridges a gap with: short and sparse, unlike a forecast's `"6 4"`. */
21
+ export declare const GAP_DASH: number[];
22
+ /**
23
+ What a `connectGaps` setting asks for: null when lines run through their
24
+ gaps as one continuous line (`true`, `"solid"`, unset), otherwise lines
25
+ break at each gap and `bridge` is the style of the line drawn across it,
26
+ or null to leave the gap empty (`false`).
27
+ @param value The setting.
28
+ */
29
+ export declare function resolveConnectGaps(value: unknown): {
30
+ bridge: GapBridge | null;
31
+ } | null;
32
+ /**
33
+ The indices `k` of a line's points that a gap follows: some missing value
34
+ lies strictly between point `k` and point `k + 1` along the discrete axis.
35
+ A missing value before the first point or after the last makes no gap.
36
+ @param ranks Each drawn point's position along the discrete axis, in drawn order.
37
+ @param missing The positions with no value: every step any line has, and
38
+ the line's own rows with no plottable value.
39
+ */
40
+ export declare function gapsAfter(ranks: number[], missing: number[]): number[];
41
+ /**
42
+ How far along a polyline it first reaches each of `targets` along one
43
+ axis, searching on from where it reached the one before, and its total
44
+ length. A target it never reaches lies at its full length.
45
+ @param line The polyline (see `curvePolyline`).
46
+ @param axis `0` to measure along x, `1` along y.
47
+ @param targets The positions to reach, in order along the line.
48
+ */
49
+ export declare function pointLengths(line: Point[], axis: 0 | 1, targets: number[]): {
50
+ at: number[];
51
+ total: number;
52
+ };
53
+ /**
54
+ The stretches a dash pattern draws between `from` and `to`, starting the
55
+ pattern at `from`. No pattern (or one that draws nothing) draws the
56
+ whole stretch.
57
+ @param dash The pattern, as `[dash, gap, …]`.
58
+ @param from Where the stretch starts.
59
+ @param to Where it ends.
60
+ */
61
+ export declare function patternIntervals(dash: number[] | undefined, from: number, to: number): Interval[];
62
+ /**
63
+ Where two lists of stretches overlap.
64
+ @param a Sorted, non-overlapping stretches.
65
+ @param b Sorted, non-overlapping stretches.
66
+ */
67
+ export declare function intersectIntervals(a: Interval[], b: Interval[]): Interval[];
68
+ /**
69
+ The stretches of `[0, total]` a list of stretches leaves out.
70
+ @param intervals Sorted, non-overlapping stretches.
71
+ @param total The path's length.
72
+ */
73
+ export declare function complementIntervals(intervals: Interval[], total: number): Interval[];
74
+ /**
75
+ The dash array that draws a path along exactly the given stretches and
76
+ nothing else, ending in a gap long enough that the pattern never repeats.
77
+ @param intervals Sorted, non-overlapping stretches to draw.
78
+ @param total The path's length.
79
+ */
80
+ export declare function intervalsDash(intervals: Interval[], total: number): number[];
81
+ /**
82
+ A line's path with a separate subpath for each run of points between its
83
+ gaps, so nothing spans a gap. A point between two gaps gets a short tick
84
+ along the discrete axis.
85
+ @param points The line's points, in drawn order.
86
+ @param gaps The indices a gap follows (see `gapsAfter`).
87
+ @param curve The line's curve name.
88
+ @param axis `0` when the discrete axis is x, `1` when it is y.
89
+ @param stub Half the length of a lone point's tick.
90
+ */
91
+ export declare function runPath(points: Point[], gaps: number[], curve: string, axis: 0 | 1, stub?: number): string;
92
+ /**
93
+ Each run of points between a line's gaps, as its `[first, last]` point
94
+ indices.
95
+ @param count The line's point count.
96
+ @param gaps The indices a gap follows (see `gapsAfter`).
97
+ */
98
+ export declare function runIndices(count: number, gaps: number[]): Interval[];
99
+ export {};
@@ -0,0 +1,55 @@
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
+ */
9
+ import type { SceneNode } from "@d3plus/render";
10
+ import type { ShapeEmitContext } from "../features/shapeEmit.js";
11
+ import { type GapBridge, type Interval } from "./connectGaps.js";
12
+ type Point = [number, number];
13
+ /** One line's gaps, measured along its path. */
14
+ export interface SeriesGaps {
15
+ /** The line's points, in plot space and drawn order. */
16
+ points: Point[];
17
+ /** The indices a gap follows. */
18
+ gaps: number[];
19
+ /** The stretches of the path that cross a gap. */
20
+ gapIntervals: Interval[];
21
+ /** The path's length. */
22
+ total: number;
23
+ }
24
+ /** Every gapped line of a Line group, by series id, and how to draw the gaps. */
25
+ export interface LineGaps {
26
+ series: Map<string, SeriesGaps>;
27
+ bridge: GapBridge | null;
28
+ curve: string;
29
+ /** `0` when the discrete axis is x, `1` when it is y. */
30
+ axis: 0 | 1;
31
+ }
32
+ /**
33
+ The gaps in each line of a Line group, or null when `connectGaps` draws
34
+ lines straight through them or no line has one. A gap is a step of the
35
+ discrete axis that some line in the group has and this one skips, or one
36
+ of this line's own rows whose value can't be plotted (`null`, `NaN`).
37
+ @param ctx The Line group's emit context.
38
+ */
39
+ export declare function lineGaps(ctx: ShapeEmitContext): LineGaps | null;
40
+ /**
41
+ Breaks each gapped line among a Line group's nodes: the line's dash array
42
+ leaves its gaps empty, its hit area stops at them, and a bridge follows
43
+ it when `connectGaps` asks for one.
44
+ @param nodes The Line shape's computed nodes.
45
+ @param gaps The group's gaps (see `lineGaps`).
46
+ */
47
+ export declare function breakLines(nodes: SceneNode[], gaps: LineGaps): SceneNode[];
48
+ /**
49
+ Clips each gapped line's confidence bands to the runs between its gaps,
50
+ so no band spans a stretch with no value.
51
+ @param nodes The band Areas' computed nodes.
52
+ @param gaps The group's gaps (see `lineGaps`).
53
+ */
54
+ export declare function clipBands(nodes: SceneNode[], gaps: LineGaps): SceneNode[];
55
+ export {};