@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
@@ -21,17 +21,23 @@
21
21
  @module
22
22
  */
23
23
  import type { PlotZoomBase, ZoomState } from "../Plot/plotZoom.js";
24
+ import type { GestureHoverState, ZoomGesture } from "../drawSteps/zoomGesture.js";
24
25
  import type { TrendFit, TrendLineType } from "../Plot/trendLines.js";
25
26
  import type { SwarmState } from "../Plot/swarm.js";
26
27
  import type { ShapeEmitter } from "../features/shapeEmit.js";
27
28
  import type { BarSpanLayout } from "../Plot/barWidth.js";
28
29
  import type { ConfidenceBand } from "../Plot/confidenceBands.js";
29
30
  import type { PlotFacetScales } from "../Plot/facetScales.js";
31
+ import type { AxisHoverState } from "../Plot/axisHover.js";
30
32
  import type { ZoomControlIconKey } from "../drawSteps/zoomControlsMarkup.js";
31
33
  import type { BottomRightBox } from "../drawSteps/bottomRightControlsMarkup.js";
32
34
  import type { ZoomTransform } from "d3-zoom";
35
+ import type { KeyboardNavState } from "./keyboardNav.js";
36
+ import type { KeyboardGesture } from "./keyboardNavHost.js";
37
+ import type { NearestHoverState } from "./nearestHover.js";
38
+ import type { ResolvedTheme } from "../../utils/theme.js";
33
39
  import type { DataPoint } from "@d3plus/data";
34
- import type { ClipShape, Scene, SceneNode, Transform, TransitionRect } from "@d3plus/render";
40
+ import type { ClipShape, Scene, SceneEvent, SceneNode, Transform, TransitionRect } from "@d3plus/render";
35
41
  import type { Axis, ColorScale, Legend, Message, SizeLegend, TextBox, Timeline, Tooltip } from "../../components/index.js";
36
42
  import type { SizeLegendScale } from "../../components/SizeLegend/sizeLegendLayout.js";
37
43
  import type { InsetKey, InsetPlacement, InsetRegion } from "../features/insetState.js";
@@ -55,15 +61,29 @@ export interface Padding {
55
61
  left: number;
56
62
  right: number;
57
63
  }
58
- /** One entry on the drill-down history stack (`Viz._history`), pushed by a click.shape drill-down and popped by Back. */
64
+ /** A drill-down entry on the Back history (`Viz._history`), pushed by a click.shape drill-down or a partition zoom and popped by Back. */
59
65
  export interface DrillDownHistoryEntry {
66
+ kind?: "drill";
60
67
  depth: number;
61
68
  filter?: (d: DataPoint, i: number) => boolean;
62
69
  /** `groupBy[groupDepth]`'s value for the clicked node — identifies the reunion node the Back morph grows back into. */
63
70
  groupId?: unknown;
64
71
  /** The groupBy index `groupId` was read at (== `_drawDepth` when the node was clicked). */
65
72
  groupDepth?: number;
73
+ /** The legend's hide/solo state a drill to a deeper level cleared, which Back puts back. */
74
+ legend?: LegendState;
66
75
  }
76
+ /** The legend's hide/solo state: the legend ids hidden, and the ones shown alone. */
77
+ export interface LegendState {
78
+ hidden: (string | number)[];
79
+ solo: (string | number)[];
80
+ }
81
+ /** A legend entry on the Back history (`Viz._history`): the legend's hide/solo state before a legend click changed it. */
82
+ export interface LegendHistoryEntry extends LegendState {
83
+ kind: "legend";
84
+ }
85
+ /** One entry on the Back history (`Viz._history`). */
86
+ export type HistoryEntry = DrillDownHistoryEntry | LegendHistoryEntry;
67
87
  /**
68
88
  D3-style selection — deliberately loose. d3-selection's element/datum
69
89
  generics are invariant, so a single typed alias can't accept every
@@ -115,9 +135,21 @@ export interface VizInstance {
115
135
  _margin: Margin;
116
136
  _padding: Padding;
117
137
  _data: DataPoint[];
138
+ /**
139
+ The user's rows, when the chart replaces `_data` with rows it derives
140
+ from them (Histogram's bins) before pre-draw.
141
+ */
142
+ _sourceData?: DataPoint[];
118
143
  _filteredData: DataPoint[];
119
144
  _formattedData?: DataPoint[];
120
145
  _legendData: DataPoint[];
146
+ /**
147
+ The rows a chart's threshold weighs: every row of the whole chart (all
148
+ small-multiple panels), legend-hidden ones included.
149
+ */
150
+ _thresholdRows?: DataPoint[];
151
+ /** Formats a threshold bucket member's value in tooltips (default: abbreviated). */
152
+ _thresholdMemberFormat?: (value: number) => string;
121
153
  _hidden: (string | number)[];
122
154
  _solo: (string | number)[];
123
155
  /**
@@ -126,6 +158,17 @@ export interface VizInstance {
126
158
  passes such rows without running `filter` on them again.
127
159
  */
128
160
  _filterApplied?: (d: DataPoint) => boolean;
161
+ /**
162
+ Shapes whose rows the pipeline keeps one by one instead of merging the
163
+ rows that share a group (Hexbin's observations, which it bins).
164
+ */
165
+ _unmergedShapes?: string[];
166
+ /**
167
+ The rows the colorScale lays out from, for a chart whose colored marks
168
+ aren't its rows (Hexbin's bins). The chart's rows rolled up by group
169
+ when unset.
170
+ */
171
+ _colorScaleRows?: () => DataPoint[];
129
172
  _timeFilter?: (d: DataPoint, i: number) => boolean;
130
173
  _groupBy: ((d: DataPoint, i: number) => DataPoint[keyof DataPoint])[];
131
174
  _depth?: number;
@@ -155,6 +198,11 @@ export interface VizInstance {
155
198
  _x2Config?: Record<string, unknown>;
156
199
  _y2Config?: Record<string, unknown>;
157
200
  _backgroundConfig?: Record<string, unknown>;
201
+ /**
202
+ Whether a chart other than a Plot can name every series along it, so
203
+ its default legend may stand aside (see `Plot/alongLegend.ts`).
204
+ */
205
+ _alongLabelsPossible?: (viz: VizInstance) => boolean;
158
206
  _chartScene?: SceneNode[];
159
207
  /** The whole scene last painted (chart, legend, colorScale, chrome). */
160
208
  _paintedScene?: Scene;
@@ -183,6 +231,17 @@ export interface VizInstance {
183
231
  returns false to fall back to picture zoom (Plot rescales its axes).
184
232
  */
185
233
  _zoomRescale?: (t: ZoomState, duration?: number) => boolean;
234
+ /** Chart-specific handling of zoom gestures (Geomap turns a globe on a drag). */
235
+ _zoomGesture?: ZoomGesture;
236
+ /** The zoom gesture holding off tooltips and hover, while one is in progress. */
237
+ _gestureHover?: GestureHoverState;
238
+ /** Whether a globe drag is turning the map (Geomap skips refitting meanwhile). */
239
+ _globeDragging?: boolean;
240
+ /** The rotation a Geomap globe had before it was first dragged, with its projection. */
241
+ _globeHome?: {
242
+ projection: unknown;
243
+ rotate: number[];
244
+ };
186
245
  /** Cleanup functions returned by `zoomControlIcons`' mount functions, keyed by button. */
187
246
  _zoomIconCleanup?: Partial<Record<ZoomControlIconKey, () => void>>;
188
247
  /** Cleanup function returned by an `attributionIcon` mount function. */
@@ -192,6 +251,12 @@ export interface VizInstance {
192
251
  _duration: number;
193
252
  _renderer?: "svg" | "canvas";
194
253
  _focus?: string | number | undefined;
254
+ /**
255
+ Runs when a click lands on no mark, given its point on the chart's
256
+ surface (see `routePointerEvent`): a Network or ArcDiagram clears its
257
+ focus there.
258
+ */
259
+ _backgroundClick?: (point: [number, number]) => void;
195
260
  _active?: ((d: DataPoint, i?: number) => boolean) | false;
196
261
  _hover?: ((d: DataPoint, i?: number) => boolean) | false;
197
262
  /** True while the current hover came from a colorScale bucket swatch. */
@@ -218,6 +283,10 @@ export interface VizInstance {
218
283
  _hoverDatum?: DataPoint | null;
219
284
  /** Epoch ms until which an animated transition is in flight (pointer routing pauses). */
220
285
  _transitionEndsAt?: number;
286
+ /** Keyboard navigation's host element and focused mark (see `keyboardNav.ts`). */
287
+ _keyboardNav?: KeyboardNavState;
288
+ /** A chart's own keys, taken before mark navigation (Geomap's globe keys). */
289
+ _keyboardGesture?: KeyboardGesture;
221
290
  _userHover?: number;
222
291
  _userDuration?: number;
223
292
  _brushing?: boolean;
@@ -244,8 +313,8 @@ export interface VizInstance {
244
313
  _trailSeq?: number;
245
314
  /** The user-set data, retained to detect changes across `.data()` calls. */
246
315
  _userData?: DataPoint[] | string;
247
- /** Drill-down history stack (back button). */
248
- _history?: DrillDownHistoryEntry[];
316
+ /** The Back history: drill-downs and legend clicks, newest last. */
317
+ _history?: HistoryEntry[];
249
318
  /**
250
319
  The local, chart-family-defined "body rect" flip-morph fractions are
251
320
  measured against — e.g. Treemap/Pack's margin-adjusted chart area at
@@ -370,6 +439,8 @@ export interface VizInstance {
370
439
  /** The small-multiples panel the hover is in, by key. */
371
440
  panel?: string;
372
441
  } | null;
442
+ /** The hovered point's axis guides and badges (`axisHover`), if any. */
443
+ _axisHoverState?: AxisHoverState | null;
373
444
  /** True while the shared multi-series tooltip owns the tooltip. */
374
445
  _sharedHoverActive?: boolean;
375
446
  /** The tooltip's own `arrow`/`thead`/`tbody`, held while the shared tooltip replaces them. */
@@ -403,6 +474,8 @@ export interface VizInstance {
403
474
  _stackOffset?: (series: number[][][], order: number[]) => void;
404
475
  /** d3-stack order: an accessor, or an explicit array of series keys. */
405
476
  _stackOrder?: ((series: number[][][]) => number[]) | unknown[];
477
+ /** The series of the last stacked draw in reading order, which the default legend follows (see `Plot/stackLegendOrder.ts`). */
478
+ _stackLegendOrder?: string[];
406
479
  /** The `confidence` bounds as `[lower, upper]` accessors (either may be `false`), or `false` when off. */
407
480
  _confidence?: [
408
481
  ConfidenceAccessor | false,
@@ -414,7 +487,6 @@ export interface VizInstance {
414
487
  _groupPadding?: number;
415
488
  _annotations?: Record<string, unknown>[];
416
489
  _axisPersist?: boolean;
417
- _labelPosition?: (d: DataPoint, i: number) => "auto" | "inside" | "outside";
418
490
  _labelConnectorConfig?: Record<string, unknown>;
419
491
  _lineMarkerConfig?: Record<string, unknown>;
420
492
  _confidenceConfig?: Record<string, unknown>;
@@ -447,6 +519,20 @@ export interface VizInstance {
447
519
  x?: Record<string, unknown>;
448
520
  y?: Record<string, unknown>;
449
521
  };
522
+ /**
523
+ Values a chart adds to an axis's values, given the plotted rows and the
524
+ axis (`"x"`, `"x2"`, `"y"`, or `"y2"`), so its domain covers marks that
525
+ reach past each row's own value (e.g. BoxWhisker's precomputed whiskers
526
+ and outliers).
527
+ */
528
+ _plotAxisValues?: (rows: Record<string, unknown>[], axis: string) => unknown[];
529
+ /**
530
+ The rows that place an axis's values, given the plotted rows and the
531
+ axis (`"x"`, `"x2"`, `"y"`, or `"y2"`): a chart can leave out rows its
532
+ marks don't draw, or add rows at values they reach (e.g. BoxWhisker's
533
+ hidden outliers and the whisker ends past what remains).
534
+ */
535
+ _plotAxisRows?: (rows: Record<string, unknown>[], axis: string) => Record<string, unknown>[];
450
536
  /** Per-chart overrides of Plot's shape emitters, by shape key (see `emitShape`). */
451
537
  _plotShapeEmitters?: Record<string, ShapeEmitter>;
452
538
  /**
@@ -482,6 +568,16 @@ export interface VizInstance {
482
568
  _legendDepth?: number;
483
569
  /** The color category each legend entry stands for, when the legend is labelled by color rather than groupBy. */
484
570
  _legendCategories?: WeakMap<DataPoint, string>;
571
+ /** The legend setting the chart starts with, which along labels may hide (see `Plot/alongLegend.ts`). */
572
+ _defaultLegend?: unknown;
573
+ /** Whether this draw hides the default legend for along labels. */
574
+ _alongLegendHide?: boolean;
575
+ /** This draw's along label counts (see `Plot/alongLegend.ts`). */
576
+ _alongStats?: {
577
+ series: number;
578
+ requested: number;
579
+ placed: number;
580
+ };
485
581
  _colorScalePosition?: (config: VizInstance) => string | false;
486
582
  _colorScale?: false | string | ((d: DataPoint, i: number) => string);
487
583
  _timeline?: boolean;
@@ -501,8 +597,10 @@ export interface VizInstance {
501
597
  _zoomSet?: boolean;
502
598
  /** Whether a Geomap's themed basemap resolved dark on the latest draw. */
503
599
  _basemapDark?: boolean;
504
- /** Whether a Geomap is watching its backdrop for theme changes. */
505
- _themeWatch?: boolean;
600
+ /** The chart's theme, resolved on its latest draw (see `applyVizTheme`). */
601
+ _theme?: ResolvedTheme;
602
+ /** Stops the `"auto"` theme's page watcher, while one is installed. */
603
+ _themeWatch?: () => void;
506
604
  /** The attribution d3plus last set from the tile URL (vs. a user-set one). */
507
605
  _tileAttribution?: string | false;
508
606
  /** Whether a compact (ⓘ) attribution was clicked open. */
@@ -531,9 +629,16 @@ export interface VizInstance {
531
629
  /** Plot's paint phase: builds `_chartScene` from the measured context. */
532
630
  _paint?(pCtx: PlotPaintContext): VizInstance;
533
631
  _drawSceneToTarget(durationOverride?: number): void;
632
+ /** Whether a painted node is a point mark nearest-point hover resolves to (see `hoverDistance`). */
633
+ _pointMark?(node: SceneNode): boolean;
634
+ /** Nearest-point hover's cached diagrams and resolved mark (see `nearestHover.ts`). */
635
+ _nearestHover?: NearestHoverState;
636
+ /** Routes a renderer pointer event (or a replayed one) to the chart's handlers. */
637
+ _routeSceneEvent?(event: SceneEvent): void;
534
638
  _scheduleSceneRepaint(): void;
535
639
  _sceneRepaintRAF?: number;
536
- _thresholdFunction?(data: DataPoint[], tree?: unknown): DataPoint[];
640
+ _thresholdLegend?(legendData: DataPoint[]): DataPoint[];
641
+ _thresholdFunction?(data: DataPoint[], tree?: unknown, all?: DataPoint[]): DataPoint[];
537
642
  /** The chart's size-legend radius scale, estimated before layout for the given chart area (see `ChartDefinition.sizeLegendScale`). */
538
643
  _sizeLegendScale?(available: {
539
644
  width: number;
@@ -541,6 +646,10 @@ export interface VizInstance {
541
646
  }): SizeLegendScale | null;
542
647
  /** The region chart chrome may be drawn inside, with the chart's marks as obstacles (see `ChartDefinition.insetRegion`). */
543
648
  _insetRegion?(): InsetRegion | null;
649
+ /** The table view's rows in place of the chart's data (see `ChartDefinition.tableData`). */
650
+ _tableData?(): DataPoint[] | null;
651
+ /** The shape a colorScale row draws as (see `ChartDefinition.colorScaleShape`). */
652
+ _colorScaleShape?(d: DataPoint, i: number): string;
544
653
  /** The chart's small-multiple hooks (see `ChartDefinition.facet`). */
545
654
  _facetHooks?(): FacetHooks;
546
655
  toScene?(): SceneNode;
@@ -32,3 +32,9 @@ export declare function vizReload(viz: Viz): void;
32
32
  @private
33
33
  */
34
34
  export declare function syncUnloadObserver(viz: Viz): void;
35
+ /**
36
+ Stops a chart's visibility, resize, and scroll polling and its visibility
37
+ observers, so a destroyed chart leaves no timer or listener holding it.
38
+ @private
39
+ */
40
+ export declare function stopVisibilityWatch(viz: Viz): void;
@@ -11,6 +11,7 @@ import type { D3Scale } from "../../utils/index.js";
11
11
  Creates an SVG scale based on an array of data.
12
12
  */
13
13
  export default class Axis extends BaseClass {
14
+ static readonly _displayName: string;
14
15
  [key: string]: any;
15
16
  _select: D3Selection;
16
17
  _data: unknown[];
@@ -18,12 +19,22 @@ export default class Axis extends BaseClass {
18
19
  _scaleData: unknown[];
19
20
  /** Whether the last layout pass rotated the labels (see `labelRotation`). */
20
21
  _labelRotation: boolean | undefined;
22
+ /** The angle the last layout pass rotated the labels by (0 when flat). */
23
+ _labelAngle: number;
24
+ /** Whether the last layout pass slanted the labels (see `settingTurn`). */
25
+ _labelSlant: boolean;
21
26
  /** The configured `labelRotation`: `undefined` lets the layout decide. */
22
- _labelRotationSetting: boolean | undefined;
27
+ _labelRotationSetting: boolean | number | undefined;
23
28
  _margin: Record<string, number>;
24
29
  _outerBounds: Record<string, number>;
25
30
  /** The measured size of the tick-label/title space, before margins (see `fixedSize`). */
26
31
  _labelSpace?: number;
32
+ /**
33
+ How far slanted labels reach past the start and end of the range, set
34
+ by the layout pass (see `labelRotation`). A Plot makes room for them
35
+ when its range is fixed.
36
+ */
37
+ _labelOverflow: [number, number];
27
38
  _position: {
28
39
  horizontal: boolean;
29
40
  width: string;
@@ -75,6 +86,12 @@ export default class Axis extends BaseClass {
75
86
  @private
76
87
  */
77
88
  _getDomain(): unknown[];
89
+ /**
90
+ The scale's domain (or its negative log half's, with `negative`) in the
91
+ order it was given, undoing `reverse`.
92
+ @private
93
+ */
94
+ _givenDomain(negative?: boolean): unknown[];
78
95
  /**
79
96
  Returns a value's scale position, taking into account negative and positive log scales.
80
97
  @param d @private
@@ -150,14 +167,26 @@ export default class Axis extends BaseClass {
150
167
  gridConfig(): Record<string, unknown>;
151
168
  gridConfig(_: Record<string, unknown>): this;
152
169
  /**
153
- Whether to rotate horizontal axis labels -90 degrees. Left `undefined`
154
- (the default), a horizontal axis of categories rotates its labels when
155
- any label would not fit its share of the axis whole (a word dropped,
156
- cut off, or broken across lines) or would overlap its neighbor. Labels
157
- that still overlap once rotated are thinned evenly.
170
+ Whether to rotate the axis labels, and by how much. `true` rotates
171
+ them -90 degrees and `false` keeps them flat. Left `undefined` (the
172
+ default), a horizontal axis of categories rotates its labels when any
173
+ label would not fit its share of the axis whole (a word dropped, cut
174
+ off, or broken across lines) or would overlap its neighbor: they
175
+ slant 30 degrees (-30 on a bottom axis, 30 on a top one), or stand at
176
+ -90 when even slanted they would leave more labels cut short or
177
+ hidden. A vertical axis never rotates its labels on its own. A number
178
+ rotates them by that many degrees (clockwise, so `-45` rises to the
179
+ right): each label hangs off the axis from the end of its text
180
+ nearest the axis, which sits across from its tick, so on a bottom
181
+ axis a negative angle ends each label at its tick and a positive one
182
+ starts it there. Angles outside -90 to 90 turn a half turn to read
183
+ left to right (`135` draws as `-45`), and `0` keeps the labels flat.
184
+ Slanted labels wrap between words onto up to three lines, as many as
185
+ fit between neighboring labels, so they reach less far from the
186
+ axis. Labels that still overlap once rotated are thinned evenly.
158
187
  */
159
- labelRotation(): boolean | undefined;
160
- labelRotation(_: boolean | undefined): this;
188
+ labelRotation(): boolean | number | undefined;
189
+ labelRotation(_: boolean | number | undefined): this;
161
190
  /**
162
191
  The orientation of the shape.
163
192
  */
@@ -3,6 +3,7 @@ import { default as Axis } from "./Axis.js";
3
3
  Axis preset whose ticks are drawn below the horizontal domain path. Accepts everything the base Axis class does.
4
4
  */
5
5
  export default class AxisBottom extends Axis {
6
+ static readonly _displayName: string;
6
7
  /**
7
8
  Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
8
9
  @private
@@ -3,6 +3,7 @@ import { default as Axis } from "./Axis.js";
3
3
  Axis preset whose ticks are drawn to the left of the vertical domain path. Accepts everything the base Axis class does.
4
4
  */
5
5
  export default class AxisLeft extends Axis {
6
+ static readonly _displayName: string;
6
7
  /**
7
8
  Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
8
9
  @private
@@ -3,6 +3,7 @@ import { default as Axis } from "./Axis.js";
3
3
  Axis preset whose ticks are drawn to the right of the vertical domain path. Accepts everything the base Axis class does.
4
4
  */
5
5
  export default class AxisRight extends Axis {
6
+ static readonly _displayName: string;
6
7
  /**
7
8
  Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
8
9
  @private
@@ -3,6 +3,7 @@ import { default as Axis } from "./Axis.js";
3
3
  Axis preset whose ticks are drawn above the horizontal domain path. Accepts everything the base Axis class does.
4
4
  */
5
5
  export default class AxisTop extends Axis {
6
+ static readonly _displayName: string;
6
7
  /**
7
8
  Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
8
9
  @private
@@ -44,6 +44,8 @@ export interface BreakStyle {
44
44
  }
45
45
  /** Reads the glyph settings from one of an axis's break configs. */
46
46
  export declare function breakStyle(axis: Axis, key?: "breakConfig" | "baselineBreakConfig"): BreakStyle;
47
+ /** Reads break glyph settings from a break config object (see `breakStyle`). */
48
+ export declare function breakStyleOf(config: unknown): BreakStyle;
47
49
  /** Reads the baseline break's glyph settings (`baselineBreakConfig`). */
48
50
  export declare const baselineBreakStyle: (axis: Axis) => BreakStyle;
49
51
  /**
@@ -0,0 +1,110 @@
1
+ /**
2
+ Label angles for `labelRotation`. `true` rotates labels -90 degrees; a
3
+ number rotates them by that many degrees; left to the layout, crowded
4
+ labels slant 30 degrees (see `autoAngle`). Labels at an angle between the
5
+ two axis directions ("slanted", e.g. -45) hang off the axis from the end
6
+ of their text nearest it, so each one ends (or starts) at its tick.
7
+ */
8
+ /** The axis sides, as `Axis.orient` names them. */
9
+ export type AxisOrient = "top" | "right" | "bottom" | "left";
10
+ /** A point relative to a label's tick, on the axis line. */
11
+ export interface Point {
12
+ x: number;
13
+ y: number;
14
+ }
15
+ /**
16
+ `degrees` brought into [-90, 90], turning upside-down text a half turn
17
+ so it reads left to right: 135 becomes -45, 180 becomes 0.
18
+ */
19
+ export declare function normalizeAngle(degrees: number): number;
20
+ /**
21
+ The angle a `labelRotation` setting rotates labels by when they rotate:
22
+ a number (normalized, see `normalizeAngle`), else -90.
23
+ */
24
+ export declare function settingAngle(setting: unknown): number;
25
+ /** How an axis draws its labels: whether they rotate, by what angle, and whether they slant. */
26
+ export interface LabelTurn {
27
+ rotate: boolean;
28
+ /** Degrees, 0 when flat. */
29
+ angle: number;
30
+ /** Laid out at the angle (see `slantedLabelBox`), rather than upright as `true` stands them. */
31
+ slant: boolean;
32
+ }
33
+ /** No rotation. */
34
+ export declare const FLAT: LabelTurn;
35
+ /**
36
+ How a `labelRotation` setting draws an axis's labels before the layout
37
+ has its say: `true` upright (-90), a number at its angle, anything else
38
+ flat.
39
+ */
40
+ export declare function settingTurn(setting: unknown, horizontal: boolean): LabelTurn;
41
+ /**
42
+ The angle crowded labels slant at when the layout rotates them: -30 on
43
+ a bottom axis (rising to the right, ending at their ticks), 30 on a top
44
+ axis (the mirror image).
45
+ */
46
+ export declare const autoAngle: (orient: string) => number;
47
+ /**
48
+ Whether a `labelRotation` setting rotates the labels: `true`, or a
49
+ number that isn't a multiple of 180. `undefined` leaves it to the
50
+ layout, which this doesn't decide.
51
+ */
52
+ export declare function settingRotates(setting: unknown): boolean;
53
+ /**
54
+ Whether a `labelRotation` setting lays its labels out at their angle
55
+ (see `slantedLabelBox`): a number that rotates them, except ±90 on a
56
+ horizontal axis, which stands them upright as `true` does.
57
+ */
58
+ export declare function slantsLabels(setting: unknown, horizontal: boolean): boolean;
59
+ /**
60
+ The angle (in radians, 0 to π/2) between a label's text at `angle` and
61
+ the axis it labels: 0 when the text runs along the axis, π/2 when it
62
+ stands straight out from it.
63
+ */
64
+ export declare function axisCrossing(angle: number, horizontal: boolean): number;
65
+ /**
66
+ Which end of a rotated label's text sits at its tick: the end nearer the
67
+ axis. On a bottom axis, text rising to the right (a negative angle) ends
68
+ at its tick and text falling to the right starts at it; a top axis is
69
+ the reverse; a left axis's labels end at their ticks, a right axis's start
70
+ at them.
71
+ */
72
+ export declare function rotatedTextAnchor(orient: AxisOrient, angle: number): "start" | "middle" | "end";
73
+ /** A slanted label's box before rotation, and its corners once rotated. */
74
+ export interface SlantedLabelBox {
75
+ /** The unrotated box, relative to the tick; it rotates about its center. */
76
+ x: number;
77
+ y: number;
78
+ width: number;
79
+ height: number;
80
+ /** The rotated text's four corners, relative to the tick. */
81
+ corners: Point[];
82
+ }
83
+ /**
84
+ Where a slanted label goes: its text (`width` long, `textHeight` thick,
85
+ in a box `height` tall) rotated by `angle` about the box's center, with
86
+ the text's end nearest the axis (see `rotatedTextAnchor`) across from its
87
+ tick and every corner at least `gap` from the axis line.
88
+ */
89
+ export declare function slantedLabelBox(orient: AxisOrient, angle: number, width: number, textHeight: number, height: number, gap: number): SlantedLabelBox;
90
+ /**
91
+ How far a slanted label reaches from its tick along the axis, before and
92
+ after it (toward lower and higher positions).
93
+ */
94
+ export declare function slantedReach(orient: AxisOrient, angle: number, width: number, textHeight: number): [number, number];
95
+ /**
96
+ How far a slanted label reaches out from the axis line: its text's
97
+ length and thickness projected across the axis.
98
+ */
99
+ export declare function slantedDepth(angle: number, horizontal: boolean, width: number, textHeight: number): number;
100
+ /**
101
+ The longest and thickest a slanted label's text may be: as long as
102
+ reaches `depth` out from the axis (with one line of `lineHeight`), and
103
+ as thick as fits between labels `space` apart along the axis (at least
104
+ one line). Text running along the axis is `space` long and `depth`
105
+ thick.
106
+ */
107
+ export declare function slantedWrapSize(angle: number, horizontal: boolean, depth: number, space: number, lineHeight: number): {
108
+ width: number;
109
+ height: number;
110
+ };
@@ -1,8 +1,3 @@
1
- /**
2
- Label thinning for `createTextData` (see `axisLayoutLabels.ts`): the
3
- passes that hide labels crowding their neighbors, and the widening of
4
- labels that each wrap within their own share of the axis.
5
- */
6
1
  import type { AxisTextDatum } from "./axisLayoutLabels.js";
7
2
  /**
8
3
  A measured label's text extent along its axis, which the overlap pass
@@ -12,9 +7,10 @@ import type { AxisTextDatum } from "./axisLayoutLabels.js";
12
7
  The measured `height` also holds the label's padding (see
13
8
  `calculateLabelSize`) and the leading above and below the text, which this
14
9
  leaves out, so neighbors are spaced by their padding alone, as they are
15
- along a horizontal axis.
10
+ along a horizontal axis. Slanted labels span their glyphs' thickness where
11
+ it crosses the axis.
16
12
  */
17
- export declare function labelExtent(datum: Pick<AxisTextDatum, "fP" | "fS" | "height" | "lineHeight" | "lines" | "rotate" | "width">, horizontal: boolean): number;
13
+ export declare function labelExtent(datum: Pick<AxisTextDatum, "angle" | "slant" | "fP" | "fS" | "height" | "lineHeight" | "lines" | "rotate" | "width">, horizontal: boolean): number;
18
14
  /**
19
15
  Fits flat labels that each wrap within their own share of the axis (see
20
16
  `ownLabelSpaces`, which gives `spaces`). A label too long for its share,
@@ -27,6 +27,11 @@ export interface AxisLayoutResult {
27
27
  the instance afterward.
28
28
  */
29
29
  export declare function measureAxis(axis: Axis): AxisLayoutResult;
30
+ /**
31
+ How far the first and last slanted labels shown reach past the start and
32
+ end of `range`, along the axis (0 when they don't, or aren't slanted).
33
+ */
34
+ export declare function slantedOverflow(axis: Axis, textData: AxisTextDatum[], range: number[]): [number, number];
30
35
  /**
31
36
  Whether the axis may rotate its labels on its own: one label per category
32
37
  naming things rather than numbers or dates, which read in sequence even
@@ -18,6 +18,10 @@ export interface AxisTextDatum {
18
18
  lineHeight: number;
19
19
  position: number;
20
20
  rotate?: boolean;
21
+ /** The degrees a rotated label turns (see `labelRotation`), 0 when flat. */
22
+ angle?: number;
23
+ /** Whether the label is laid out at its angle (see `settingTurn`). */
24
+ slant?: boolean;
21
25
  space: number;
22
26
  lines: string[];
23
27
  widths: number[];
@@ -44,6 +48,8 @@ interface LabelLayoutCtx {
44
48
  `ownLabelSpaces`) rather than the widest share any label has.
45
49
  */
46
50
  ownSpace?: boolean;
51
+ /** The width slanted labels wrap at (see `slantedLineWidth`). */
52
+ slantWidth?: number;
47
53
  }
48
54
  /** Applies the axis title's wrapped height to the orient-side margin. */
49
55
  export declare function applyTitleMargin(axis: Axis, ctx: {
@@ -83,6 +89,13 @@ export declare function ownLabelSpaces(positions: number[], rangeOuter: number[]
83
89
  export declare function wholeLineLabels(axis: Axis, labels: unknown[]): boolean;
84
90
  /** Whether a scale places one tick per category (every value labeled in turn). */
85
91
  export declare function isDiscreteScale(scale: string): boolean;
92
+ /**
93
+ How far a measured label reaches out from the axis: its height when it
94
+ lies flat along a horizontal axis, its width when it stands out from the
95
+ axis, and for a slanted label, both projected across the axis (with its
96
+ padding on a horizontal axis, as its height holds).
97
+ */
98
+ export declare function labelDepth(t: AxisTextDatum, horizontal: boolean): number;
86
99
  /** Derives `_outerBounds` + axis margins from the measured text data. */
87
100
  export declare function computeAxisBounds(axis: Axis, ctx: {
88
101
  textData: AxisTextDatum[];
@@ -0,0 +1,25 @@
1
+ import type Axis from "./Axis.js";
2
+ /**
3
+ Replaces a time axis's scale with a broken time scale when it has
4
+ `rangeBreaks`, and adds each marked gap inside the domain to
5
+ `axis._breaks`. Marked gaps take `breakConfig.space` pixels each.
6
+ */
7
+ export declare function applyAxisRangeBreaks(axis: Axis): void;
8
+ /** Drops the values a broken time axis hides (from its ticks or labels). */
9
+ export declare function visibleTimeValues(axis: Axis, values: unknown[]): unknown[];
10
+ /**
11
+ The day a broken time axis's tick opens: when the tick is the first
12
+ shown time of its day (everything from midnight up to it hidden, such
13
+ as by an `hours` rule), that day's midnight, so the tick can be labeled
14
+ as the day it starts. Otherwise `undefined`.
15
+ */
16
+ export declare function rangeBreakOpenedDay(axis: Axis, value: unknown): Date | undefined;
17
+ /** The distinct days (as midnights, ascending) of a list of dates. */
18
+ export declare function datesDays(dates: Date[]): Date[];
19
+ /**
20
+ The day label for a broken time axis's ticks: given a tick that opens
21
+ its day (see `rangeBreakOpenedDay`), the day, labeled among the axis's
22
+ days in the current default time locale; given any other tick,
23
+ `undefined`. The day formatter is built once per set of axis dates.
24
+ */
25
+ export declare function rangeBreakDayLabel(axis: Axis): (value: unknown) => string | undefined;
@@ -6,9 +6,12 @@ export declare const floorPow: (d: number) => number;
6
6
  export declare const ceilPow: (d: number) => number;
7
7
  /** `d` with floating-point noise (runs of 0s or 9s) trimmed; tiny values become 0. */
8
8
  export declare const fixFloat: (d: number) => number;
9
+ /** The axis scales whose domains round to nice values (see `roundedDomain`). */
10
+ export declare const roundingScales: string[];
9
11
  /**
10
- A linear or log axis domain rounded the way an Axis with this `rounding`
11
- ("outside" or "inside") rounds it, or undefined when the axis leaves the
12
- domain as given (another scale, or nothing to round).
12
+ A linear, log or power axis domain rounded the way an Axis with this
13
+ `rounding` ("outside" or "inside") rounds it, or undefined when the axis
14
+ leaves the domain as given (another scale, or nothing to round). A power
15
+ scale's domain rounds as a linear one does.
13
16
  */
14
17
  export declare function roundedDomain(initialDomain: number[], rounding: string, scale: string): number[] | undefined;
@@ -0,0 +1,22 @@
1
+ /** The most lines a slanted label wraps onto. */
2
+ export declare const SLANTED_MAX_LINES = 3;
3
+ /** How many lines of `lineHeight` fit in a slanted label `thickness` thick: 1 to 3. */
4
+ export declare const slantedLines: (thickness: number, lineHeight: number) => number;
5
+ /**
6
+ The narrowest width, from `min` up to `max` in steps of `step` times the
7
+ last, at which text wraps onto at most `lines` lines, as `lineCount`
8
+ counts them at a width; `max` when none does.
9
+ */
10
+ export declare function narrowestWidth(lineCount: (width: number) => number, lines: number, min: number, max: number, step?: number): number;
11
+ /** A label to wrap: its text and font. */
12
+ export interface SlantedText {
13
+ text: string;
14
+ fontFamily: string;
15
+ fontSize: number;
16
+ lineHeight: number;
17
+ }
18
+ /**
19
+ The width slanted labels wrap at to fit on `lines` lines, at most `max`:
20
+ the widest any one of them needs, and never narrower than a word.
21
+ */
22
+ export declare function slantedLineWidth(labels: SlantedText[], lines: number, max: number): number;