@d3plus/core 4.10.0 → 4.12.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 (711) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +178 -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 +176 -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 +101 -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 +192 -0
  17. package/es/src/charts/ArcDiagram/events.js +148 -0
  18. package/es/src/charts/ArcDiagram/index.js +217 -0
  19. package/es/src/charts/BarChart/index.js +12 -7
  20. package/es/src/charts/BoxWhisker/index.js +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +5 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +6 -11
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +160 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +137 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +206 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +6 -4
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Matrix/applyLayout.js +20 -9
  70. package/es/src/charts/Matrix/index.js +19 -1
  71. package/es/src/charts/Network/applyLayout.js +171 -96
  72. package/es/src/charts/Network/bundle.js +82 -0
  73. package/es/src/charts/Network/clusterLabels.js +423 -0
  74. package/es/src/charts/Network/clusters.js +290 -0
  75. package/es/src/charts/Network/emit.js +257 -75
  76. package/es/src/charts/Network/graph.js +146 -0
  77. package/es/src/charts/Network/graphFluent.js +81 -0
  78. package/es/src/charts/Network/index.js +91 -106
  79. package/es/src/charts/Network/minNodeDistance.js +64 -0
  80. package/es/src/charts/Network/polygonRows.js +44 -0
  81. package/es/src/charts/Pack/applyLayout.js +16 -5
  82. package/es/src/charts/Pack/emit.js +15 -8
  83. package/es/src/charts/Pack/groupRows.js +61 -0
  84. package/es/src/charts/Pack/index.js +8 -1
  85. package/es/src/charts/Pack/neutralPaint.js +20 -0
  86. package/es/src/charts/Pack/nodeNames.js +35 -0
  87. package/es/src/charts/ParallelCoordinates/axes.js +22 -22
  88. package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
  89. package/es/src/charts/ParallelCoordinates/index.js +3 -1
  90. package/es/src/charts/ParallelCoordinates/titles.js +17 -9
  91. package/es/src/charts/Pie/applyLayout.js +86 -27
  92. package/es/src/charts/Pie/arcFit.js +152 -0
  93. package/es/src/charts/Pie/curvedLabels.js +134 -0
  94. package/es/src/charts/Pie/emit.js +51 -96
  95. package/es/src/charts/Pie/index.js +74 -31
  96. package/es/src/charts/Pie/labelRoom.js +154 -0
  97. package/es/src/charts/Pie/outsideLabels.js +224 -0
  98. package/es/src/charts/Pie/outsideNodes.js +267 -0
  99. package/es/src/charts/Pie/pieLabels.js +137 -0
  100. package/es/src/charts/Pie/sectorBox.js +223 -0
  101. package/es/src/charts/Pie/straightLabels.js +96 -0
  102. package/es/src/charts/Pie/straightLayout.js +215 -0
  103. package/es/src/charts/Plot/alongLegend.js +76 -0
  104. package/es/src/charts/Plot/areaEnter.js +68 -0
  105. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  106. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  107. package/es/src/charts/Plot/axisValues.js +43 -0
  108. package/es/src/charts/Plot/barWidth.js +59 -11
  109. package/es/src/charts/Plot/circleLabels.js +98 -0
  110. package/es/src/charts/Plot/connectGaps.js +237 -0
  111. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  112. package/es/src/charts/Plot/draw.js +34 -14
  113. package/es/src/charts/Plot/fillBetween.js +2 -1
  114. package/es/src/charts/Plot/forecastScene.js +3 -4
  115. package/es/src/charts/Plot/index.js +19 -17
  116. package/es/src/charts/Plot/labelPlacement.js +1 -1
  117. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  118. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  119. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  120. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  121. package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
  122. package/es/src/charts/Plot/pipeline.js +66 -19
  123. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  124. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  125. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  126. package/es/src/charts/Plot/pipelineScales.js +40 -8
  127. package/es/src/charts/Plot/plotFacet.js +12 -1
  128. package/es/src/charts/Plot/plotInit.js +40 -5
  129. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  130. package/es/src/charts/Plot/referenceDomains.js +133 -0
  131. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  132. package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
  133. package/es/src/charts/Plot/sharedHover.js +2 -1
  134. package/es/src/charts/Plot/sharedTooltip.js +13 -3
  135. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  136. package/es/src/charts/Plot/trendLabels.js +183 -0
  137. package/es/src/charts/Plot/trendLines.js +1 -0
  138. package/es/src/charts/Plot/trendScene.js +6 -3
  139. package/es/src/charts/Plot/trendTooltip.js +5 -1
  140. package/es/src/charts/PolarArea/index.js +4 -3
  141. package/es/src/charts/Priestley/applyLayout.js +21 -23
  142. package/es/src/charts/Priestley/index.js +4 -37
  143. package/es/src/charts/Priestley/timeAxis.js +103 -0
  144. package/es/src/charts/Pyramid/gutter.js +52 -16
  145. package/es/src/charts/Pyramid/index.js +55 -7
  146. package/es/src/charts/Pyramid/scene.js +4 -4
  147. package/es/src/charts/Radar/applyLayout.js +31 -33
  148. package/es/src/charts/Radar/axisDecorations.js +62 -13
  149. package/es/src/charts/Radar/curvedLabels.js +228 -0
  150. package/es/src/charts/Radar/emit.js +30 -15
  151. package/es/src/charts/Radar/index.js +43 -5
  152. package/es/src/charts/Radar/points.js +85 -0
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +9 -1
  155. package/es/src/charts/RadialBar/index.js +26 -9
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
  158. package/es/src/charts/RadialMatrix/index.js +18 -9
  159. package/es/src/charts/Rings/applyLayout.js +39 -161
  160. package/es/src/charts/Rings/emit.js +219 -63
  161. package/es/src/charts/Rings/index.js +88 -32
  162. package/es/src/charts/Rings/ringsCurves.js +156 -0
  163. package/es/src/charts/Rings/ringsGraph.js +28 -9
  164. package/es/src/charts/Rings/ringsLoops.js +73 -0
  165. package/es/src/charts/Rings/ringsParallel.js +183 -0
  166. package/es/src/charts/Rings/ringsPlacement.js +152 -0
  167. package/es/src/charts/Rings/ringsSizing.js +61 -38
  168. package/es/src/charts/Sankey/applyLayout.js +130 -39
  169. package/es/src/charts/Sankey/circularLayout.js +208 -0
  170. package/es/src/charts/Sankey/circularLinks.js +301 -0
  171. package/es/src/charts/Sankey/emit.js +164 -94
  172. package/es/src/charts/Sankey/index.js +78 -75
  173. package/es/src/charts/Sankey/labels.js +80 -0
  174. package/es/src/charts/Sankey/ribbons.js +88 -0
  175. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  176. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  177. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  178. package/es/src/charts/Scatter/index.js +25 -0
  179. package/es/src/charts/SlopeChart/index.js +116 -0
  180. package/es/src/charts/SlopeChart/slope.js +95 -0
  181. package/es/src/charts/Streamgraph/index.js +51 -0
  182. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  183. package/es/src/charts/Sunburst/emit.js +83 -64
  184. package/es/src/charts/Sunburst/index.js +16 -4
  185. package/es/src/charts/Tree/applyLayout.js +44 -14
  186. package/es/src/charts/Tree/emit.js +5 -5
  187. package/es/src/charts/Tree/index.js +12 -18
  188. package/es/src/charts/Tree/keys.js +33 -0
  189. package/es/src/charts/Tree/nodeLabel.js +15 -0
  190. package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
  191. package/es/src/charts/Treemap/index.js +2 -5
  192. package/es/src/charts/Violin/inner.js +3 -5
  193. package/es/src/charts/definition/makeChart.js +14 -2
  194. package/es/src/charts/drawSteps/backControl.js +17 -5
  195. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  196. package/es/src/charts/drawSteps/minimap.js +10 -25
  197. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  198. package/es/src/charts/drawSteps/searchControls.js +2 -1
  199. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  200. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  201. package/es/src/charts/drawSteps/zoomActions.js +36 -0
  202. package/es/src/charts/drawSteps/zoomControls.js +52 -23
  203. package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
  204. package/es/src/charts/drawSteps/zoomDrag.js +188 -0
  205. package/es/src/charts/drawSteps/zoomFit.js +69 -0
  206. package/es/src/charts/events/click.legend.js +11 -4
  207. package/es/src/charts/events/click.shape.js +13 -4
  208. package/es/src/charts/events/mouseenter.js +6 -16
  209. package/es/src/charts/events/mouseleave.js +9 -2
  210. package/es/src/charts/events/mousemove.legend.js +28 -32
  211. package/es/src/charts/events/mousemove.shape.js +45 -42
  212. package/es/src/charts/facet/drawFacets.js +14 -5
  213. package/es/src/charts/features/annotationFrame.js +179 -0
  214. package/es/src/charts/features/annotationText.js +83 -0
  215. package/es/src/charts/features/annotationTypes.js +10 -0
  216. package/es/src/charts/features/attributionFeature.js +6 -11
  217. package/es/src/charts/features/axes.js +17 -5
  218. package/es/src/charts/features/axesFinal.js +10 -3
  219. package/es/src/charts/features/axesMeasure.js +33 -12
  220. package/es/src/charts/features/axisTooltip.js +138 -0
  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/centerLabel.js +177 -0
  224. package/es/src/charts/features/chartGeometry.js +1 -1
  225. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  226. package/es/src/charts/features/circleLabels.js +207 -0
  227. package/es/src/charts/features/colorScaleBivariate.js +83 -0
  228. package/es/src/charts/features/colorScaleBucket.js +20 -1
  229. package/es/src/charts/features/colorScaleHover.js +33 -7
  230. package/es/src/charts/features/colorScaleLimit.js +73 -0
  231. package/es/src/charts/features/colorScaleTooltip.js +77 -0
  232. package/es/src/charts/features/colorScaleTop.js +61 -0
  233. package/es/src/charts/features/colorScaleValue.js +97 -0
  234. package/es/src/charts/features/curvedArrows.js +191 -0
  235. package/es/src/charts/features/depthKey.js +26 -0
  236. package/es/src/charts/features/edgeArrows.js +220 -5
  237. package/es/src/charts/features/edgeBundling.js +442 -0
  238. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  239. package/es/src/charts/features/ensureZoomDom.js +32 -8
  240. package/es/src/charts/features/features.js +32 -14
  241. package/es/src/charts/features/featuresColorScale.js +75 -20
  242. package/es/src/charts/features/featuresLegend.js +15 -24
  243. package/es/src/charts/features/hoverTicks.js +41 -0
  244. package/es/src/charts/features/idleQueue.js +72 -0
  245. package/es/src/charts/features/legendKeys.js +64 -0
  246. package/es/src/charts/features/lineLabels.js +55 -46
  247. package/es/src/charts/features/linkBundle.js +19 -0
  248. package/es/src/charts/features/linkColor.js +72 -0
  249. package/es/src/charts/features/linkFields.js +86 -0
  250. package/es/src/charts/features/linkFocus.js +118 -0
  251. package/es/src/charts/features/linkInteraction.js +364 -0
  252. package/es/src/charts/features/linkKeys.js +20 -0
  253. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  254. package/es/src/charts/features/linkLabelPath.js +162 -0
  255. package/es/src/charts/features/linkLabels.js +340 -0
  256. package/es/src/charts/features/linkWidths.js +32 -0
  257. package/es/src/charts/features/networkMeasures.js +241 -0
  258. package/es/src/charts/features/nodeStats.js +309 -0
  259. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  260. package/es/src/charts/features/pathLabels.js +50 -0
  261. package/es/src/charts/features/plotAnnotations.js +68 -17
  262. package/es/src/charts/features/plotEndLabels.js +28 -7
  263. package/es/src/charts/features/plotPaint.js +46 -12
  264. package/es/src/charts/features/polyline.js +129 -0
  265. package/es/src/charts/features/referenceAnnotations.js +403 -0
  266. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  267. package/es/src/charts/features/ringLabelNodes.js +93 -0
  268. package/es/src/charts/features/ringLabels.js +222 -0
  269. package/es/src/charts/features/sceneBounds.js +26 -6
  270. package/es/src/charts/features/selfLoops.js +306 -0
  271. package/es/src/charts/features/shapeEmit.js +54 -32
  272. package/es/src/charts/features/sharedFields.js +15 -2
  273. package/es/src/charts/features/textHalo.js +30 -0
  274. package/es/src/charts/index.js +8 -0
  275. package/es/src/charts/partition/chartFields.js +14 -5
  276. package/es/src/charts/partition/interaction.js +19 -10
  277. package/es/src/charts/partition/zoom.js +7 -6
  278. package/es/src/charts/pipeline/insetPlacement.js +22 -9
  279. package/es/src/charts/pipeline/preDrawData.js +46 -3
  280. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  281. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  282. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  283. package/es/src/charts/polar/chrome.js +81 -9
  284. package/es/src/charts/polar/config.js +6 -3
  285. package/es/src/charts/polar/wedgeLayout.js +2 -1
  286. package/es/src/charts/viz/Viz.js +61 -49
  287. package/es/src/charts/viz/VizBase.js +57 -14
  288. package/es/src/charts/viz/backgroundInk.js +23 -7
  289. package/es/src/charts/viz/emphasis.js +14 -0
  290. package/es/src/charts/viz/fillStroke.js +10 -0
  291. package/es/src/charts/viz/focusRing.js +104 -0
  292. package/es/src/charts/viz/focusTargets.js +208 -0
  293. package/es/src/charts/viz/history.js +74 -0
  294. package/es/src/charts/viz/interactionOpacity.js +115 -32
  295. package/es/src/charts/viz/keyboardNav.js +297 -0
  296. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  297. package/es/src/charts/viz/loaderFormat.js +114 -0
  298. package/es/src/charts/viz/missingFields.js +2 -1
  299. package/es/src/charts/viz/mountTarget.js +9 -0
  300. package/es/src/charts/viz/nearestHover.js +183 -0
  301. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  302. package/es/src/charts/viz/ordinalColor.js +14 -12
  303. package/es/src/charts/viz/pageTheme.js +83 -0
  304. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  305. package/es/src/charts/viz/pointVoronoi.js +124 -0
  306. package/es/src/charts/viz/reducedMotion.js +27 -0
  307. package/es/src/charts/viz/reportDrawError.js +15 -0
  308. package/es/src/charts/viz/setCursor.js +29 -0
  309. package/es/src/charts/viz/tooltipEnabled.js +38 -0
  310. package/es/src/charts/viz/userClick.js +34 -0
  311. package/es/src/charts/viz/vizDataPolling.js +8 -4
  312. package/es/src/charts/viz/vizDefaults.js +28 -57
  313. package/es/src/charts/viz/vizFields.js +41 -1
  314. package/es/src/charts/viz/vizRender.js +76 -31
  315. package/es/src/charts/viz/vizTheme.js +96 -0
  316. package/es/src/charts/viz/vizVisibility.js +26 -2
  317. package/es/src/components/Axis/Axis.js +35 -2
  318. package/es/src/components/Axis/AxisBottom.js +1 -0
  319. package/es/src/components/Axis/AxisLeft.js +1 -0
  320. package/es/src/components/Axis/AxisRight.js +1 -0
  321. package/es/src/components/Axis/AxisTop.js +1 -0
  322. package/es/src/components/Axis/axisBreak.js +33 -8
  323. package/es/src/components/Axis/axisDefaults.js +16 -9
  324. package/es/src/components/Axis/axisLabelKinds.js +36 -0
  325. package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
  326. package/es/src/components/Axis/axisLabelRoom.js +37 -0
  327. package/es/src/components/Axis/axisLabelSize.js +171 -0
  328. package/es/src/components/Axis/axisLabelThinning.js +98 -4
  329. package/es/src/components/Axis/axisLayout.js +71 -46
  330. package/es/src/components/Axis/axisLayoutLabels.js +82 -140
  331. package/es/src/components/Axis/axisLayoutScale.js +16 -11
  332. package/es/src/components/Axis/axisLimit.js +27 -0
  333. package/es/src/components/Axis/axisMaxSize.js +39 -0
  334. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  335. package/es/src/components/Axis/axisRender.js +20 -8
  336. package/es/src/components/Axis/axisRounding.js +16 -1
  337. package/es/src/components/Axis/axisScene.js +11 -2
  338. package/es/src/components/Axis/axisTitle.js +53 -0
  339. package/es/src/components/Axis/axisTooltipTargets.js +128 -0
  340. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  341. package/es/src/components/Axis/rangeBreaks.js +201 -0
  342. package/es/src/components/Axis/timeValues.js +19 -4
  343. package/es/src/components/ColorScale/ColorScale.js +77 -27
  344. package/es/src/components/ColorScale/bivariateRender.js +353 -0
  345. package/es/src/components/ColorScale/bivariateScale.js +150 -0
  346. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  347. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  348. package/es/src/components/ColorScale/colorScaleRender.js +32 -2
  349. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  350. package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
  351. package/es/src/components/Legend/Legend.js +13 -2
  352. package/es/src/components/Legend/legendConfig.js +2 -6
  353. package/es/src/components/Legend/legendCut.js +108 -0
  354. package/es/src/components/Legend/legendRender.js +38 -13
  355. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  356. package/es/src/components/TextBox.js +34 -67
  357. package/es/src/components/Timeline/Timeline.js +12 -3
  358. package/es/src/components/Timeline/timelineConfig.js +20 -10
  359. package/es/src/components/Timeline/timelineMode.js +26 -0
  360. package/es/src/components/Timeline/timelineRender.js +9 -4
  361. package/es/src/components/Tooltip.js +15 -5
  362. package/es/src/components/fontStack.js +20 -0
  363. package/es/src/components/textBoxLayout.js +58 -21
  364. package/es/src/components/textBoxPath.js +73 -0
  365. package/es/src/components/textBoxScene.js +226 -0
  366. package/es/src/components/textBoxWords.js +70 -0
  367. package/es/src/components/textEllipsis.js +7 -0
  368. package/es/src/components/tooltipDom.js +8 -5
  369. package/es/src/fluent.js +48 -0
  370. package/es/src/shapes/Area.js +1 -0
  371. package/es/src/shapes/Bar.js +1 -0
  372. package/es/src/shapes/Box.js +1 -0
  373. package/es/src/shapes/Circle.js +1 -0
  374. package/es/src/shapes/Line.js +1 -0
  375. package/es/src/shapes/Path.js +1 -0
  376. package/es/src/shapes/Rect.js +1 -0
  377. package/es/src/shapes/Shape.js +1 -0
  378. package/es/src/shapes/Whisker.js +1 -0
  379. package/es/src/utils/BaseClass.js +30 -12
  380. package/es/src/utils/configPrep.js +2 -1
  381. package/es/src/utils/configValue.js +9 -0
  382. package/es/src/utils/constant.js +13 -1
  383. package/es/src/utils/displayName.js +12 -0
  384. package/es/src/utils/theme.js +190 -0
  385. package/es/src/utils/themeInk.js +68 -0
  386. package/package.json +14 -11
  387. package/types/index.d.ts +6 -2
  388. package/types/internal.d.ts +268 -9
  389. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  390. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  391. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  392. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  393. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  394. package/types/src/charts/Alluvial/index.d.ts +27 -0
  395. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  396. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  397. package/types/src/charts/Alluvial/titles.d.ts +46 -0
  398. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  399. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  400. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  401. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  402. package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
  403. package/types/src/charts/ArcDiagram/events.d.ts +29 -0
  404. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  405. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  406. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  407. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  408. package/types/src/charts/Chord/labels.d.ts +66 -0
  409. package/types/src/charts/Donut/index.d.ts +2 -1
  410. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  411. package/types/src/charts/Gantt/emit.d.ts +17 -0
  412. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  413. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  414. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  415. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  416. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  417. package/types/src/charts/Gantt/index.d.ts +36 -0
  418. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  419. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  420. package/types/src/charts/Geomap/emit.d.ts +2 -2
  421. package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
  422. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  423. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  424. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  425. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  426. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  427. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  428. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  429. package/types/src/charts/Geomap/index.d.ts +3 -0
  430. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  431. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  432. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  433. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  434. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  435. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  436. package/types/src/charts/Hexbin/index.d.ts +25 -0
  437. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  438. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  439. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  440. package/types/src/charts/Histogram/binData.d.ts +20 -1
  441. package/types/src/charts/Histogram/index.d.ts +3 -2
  442. package/types/src/charts/Histogram/labels.d.ts +7 -0
  443. package/types/src/charts/Marimekko/index.d.ts +2 -1
  444. package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
  445. package/types/src/charts/Network/applyLayout.d.ts +11 -0
  446. package/types/src/charts/Network/bundle.d.ts +69 -0
  447. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  448. package/types/src/charts/Network/clusters.d.ts +115 -0
  449. package/types/src/charts/Network/graph.d.ts +73 -0
  450. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  451. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  452. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  453. package/types/src/charts/Pack/applyLayout.d.ts +2 -0
  454. package/types/src/charts/Pack/groupRows.d.ts +46 -0
  455. package/types/src/charts/Pack/index.d.ts +3 -0
  456. package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
  457. package/types/src/charts/Pack/nodeNames.d.ts +23 -0
  458. package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
  459. package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
  460. package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
  461. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  462. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  463. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  464. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  465. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  466. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  467. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  468. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  469. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  470. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  471. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  472. package/types/src/charts/Plot/areaEnter.d.ts +34 -0
  473. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  474. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  475. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  476. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  477. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  478. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  479. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  480. package/types/src/charts/Plot/index.d.ts +16 -15
  481. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  482. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  483. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  484. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  485. package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
  486. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  487. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  488. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  489. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  490. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  491. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  492. package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
  493. package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
  494. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  495. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  496. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  497. package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
  498. package/types/src/charts/Pyramid/gutter.d.ts +28 -6
  499. package/types/src/charts/Pyramid/scene.d.ts +1 -1
  500. package/types/src/charts/Radar/applyLayout.d.ts +2 -3
  501. package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
  502. package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
  503. package/types/src/charts/Radar/emit.d.ts +5 -2
  504. package/types/src/charts/Radar/index.d.ts +7 -2
  505. package/types/src/charts/Radar/points.d.ts +50 -0
  506. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  507. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  508. package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
  509. package/types/src/charts/Rings/emit.d.ts +72 -0
  510. package/types/src/charts/Rings/index.d.ts +4 -2
  511. package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
  512. package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
  513. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  514. package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
  515. package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
  516. package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
  517. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  518. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  519. package/types/src/charts/Sankey/emit.d.ts +58 -0
  520. package/types/src/charts/Sankey/labels.d.ts +19 -0
  521. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  522. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  523. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  524. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  525. package/types/src/charts/Scatter/index.d.ts +15 -0
  526. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  527. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  528. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  529. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  530. package/types/src/charts/Tree/applyLayout.d.ts +20 -0
  531. package/types/src/charts/Tree/keys.d.ts +25 -0
  532. package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
  533. package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
  534. package/types/src/charts/definition/makeChart.d.ts +3 -2
  535. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  536. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  537. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  538. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  539. package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
  540. package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
  541. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
  542. package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
  543. package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
  544. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  545. package/types/src/charts/events/click.legend.d.ts +2 -1
  546. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  547. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  548. package/types/src/charts/features/annotationText.d.ts +57 -0
  549. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  550. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  551. package/types/src/charts/features/axisTooltip.d.ts +49 -0
  552. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  553. package/types/src/charts/features/calloutScene.d.ts +40 -0
  554. package/types/src/charts/features/centerLabel.d.ts +75 -0
  555. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  556. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  557. package/types/src/charts/features/circleLabels.d.ts +130 -0
  558. package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
  559. package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
  560. package/types/src/charts/features/colorScaleHover.d.ts +13 -3
  561. package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
  562. package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
  563. package/types/src/charts/features/colorScaleTop.d.ts +30 -0
  564. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  565. package/types/src/charts/features/curvedArrows.d.ts +119 -0
  566. package/types/src/charts/features/depthKey.d.ts +19 -0
  567. package/types/src/charts/features/edgeArrows.d.ts +103 -4
  568. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  569. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  570. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  571. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  572. package/types/src/charts/features/hoverTicks.d.ts +30 -0
  573. package/types/src/charts/features/idleQueue.d.ts +46 -0
  574. package/types/src/charts/features/legendKeys.d.ts +34 -0
  575. package/types/src/charts/features/lineLabels.d.ts +15 -12
  576. package/types/src/charts/features/linkBundle.d.ts +16 -0
  577. package/types/src/charts/features/linkColor.d.ts +48 -0
  578. package/types/src/charts/features/linkFields.d.ts +16 -0
  579. package/types/src/charts/features/linkFocus.d.ts +51 -0
  580. package/types/src/charts/features/linkInteraction.d.ts +192 -0
  581. package/types/src/charts/features/linkKeys.d.ts +11 -0
  582. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  583. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  584. package/types/src/charts/features/linkLabels.d.ts +77 -0
  585. package/types/src/charts/features/linkWidths.d.ts +19 -0
  586. package/types/src/charts/features/networkMeasures.d.ts +53 -0
  587. package/types/src/charts/features/nodeStats.d.ts +93 -0
  588. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  589. package/types/src/charts/features/pathLabels.d.ts +41 -0
  590. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  591. package/types/src/charts/features/plotEndLabels.d.ts +14 -1
  592. package/types/src/charts/features/plotPaint.d.ts +17 -0
  593. package/types/src/charts/features/polyline.d.ts +32 -0
  594. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  595. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  596. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  597. package/types/src/charts/features/ringLabels.d.ts +164 -0
  598. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  599. package/types/src/charts/features/selfLoops.d.ts +165 -0
  600. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  601. package/types/src/charts/features/sharedFields.d.ts +11 -2
  602. package/types/src/charts/features/textHalo.d.ts +15 -0
  603. package/types/src/charts/index.d.ts +8 -0
  604. package/types/src/charts/partition/chartFields.d.ts +6 -1
  605. package/types/src/charts/partition/interaction.d.ts +6 -3
  606. package/types/src/charts/partition/zoom.d.ts +4 -4
  607. package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
  608. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  609. package/types/src/charts/pipeline/stages.d.ts +7 -0
  610. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  611. package/types/src/charts/polar/chrome.d.ts +19 -6
  612. package/types/src/charts/viz/Viz.d.ts +25 -4
  613. package/types/src/charts/viz/VizBase.d.ts +37 -8
  614. package/types/src/charts/viz/backgroundInk.d.ts +19 -4
  615. package/types/src/charts/viz/emphasis.d.ts +17 -0
  616. package/types/src/charts/viz/fillStroke.d.ts +7 -0
  617. package/types/src/charts/viz/focusRing.d.ts +25 -0
  618. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  619. package/types/src/charts/viz/history.d.ts +35 -0
  620. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  621. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  622. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  623. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  624. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  625. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  626. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  627. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  628. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  629. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  630. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  631. package/types/src/charts/viz/reportDrawError.d.ts +12 -0
  632. package/types/src/charts/viz/setCursor.d.ts +26 -0
  633. package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
  634. package/types/src/charts/viz/userClick.d.ts +35 -0
  635. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  636. package/types/src/charts/viz/vizFields.d.ts +37 -0
  637. package/types/src/charts/viz/vizRender.d.ts +2 -1
  638. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  639. package/types/src/charts/viz/vizTypes.d.ts +100 -7
  640. package/types/src/charts/viz/vizVisibility.d.ts +13 -0
  641. package/types/src/components/Axis/Axis.d.ts +34 -3
  642. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  643. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  644. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  645. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  646. package/types/src/components/Axis/axisBreak.d.ts +21 -3
  647. package/types/src/components/Axis/axisDefaults.d.ts +12 -0
  648. package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
  649. package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
  650. package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
  651. package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
  652. package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
  653. package/types/src/components/Axis/axisLayout.d.ts +9 -2
  654. package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
  655. package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
  656. package/types/src/components/Axis/axisLimit.d.ts +18 -0
  657. package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
  658. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  659. package/types/src/components/Axis/axisRounding.d.ts +8 -0
  660. package/types/src/components/Axis/axisTitle.d.ts +30 -0
  661. package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
  662. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  663. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  664. package/types/src/components/Axis/timeValues.d.ts +1 -1
  665. package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
  666. package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
  667. package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
  668. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  669. package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
  670. package/types/src/components/Legend/Legend.d.ts +6 -0
  671. package/types/src/components/Legend/legendCut.d.ts +31 -0
  672. package/types/src/components/Legend/legendRender.d.ts +6 -1
  673. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  674. package/types/src/components/TextBox.d.ts +5 -0
  675. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  676. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  677. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  678. package/types/src/components/Tooltip.d.ts +4 -3
  679. package/types/src/components/fontStack.d.ts +10 -0
  680. package/types/src/components/textBoxLayout.d.ts +18 -9
  681. package/types/src/components/textBoxPath.d.ts +59 -0
  682. package/types/src/components/textBoxScene.d.ts +51 -0
  683. package/types/src/components/textBoxWords.d.ts +33 -0
  684. package/types/src/components/textEllipsis.d.ts +6 -0
  685. package/types/src/fluent.d.ts +18 -0
  686. package/types/src/shapes/Area.d.ts +1 -0
  687. package/types/src/shapes/Bar.d.ts +1 -0
  688. package/types/src/shapes/Box.d.ts +1 -0
  689. package/types/src/shapes/Circle.d.ts +1 -0
  690. package/types/src/shapes/Line.d.ts +1 -0
  691. package/types/src/shapes/Path.d.ts +1 -0
  692. package/types/src/shapes/Rect.d.ts +1 -0
  693. package/types/src/shapes/Shape.d.ts +1 -0
  694. package/types/src/shapes/Whisker.d.ts +1 -0
  695. package/types/src/shapes/emitLabels.d.ts +1 -1
  696. package/types/src/utils/BaseClass.d.ts +9 -0
  697. package/types/src/utils/D3plusConfig.d.ts +1093 -266
  698. package/types/src/utils/configPrep.d.ts +2 -0
  699. package/types/src/utils/configValue.d.ts +8 -0
  700. package/types/src/utils/constant.d.ts +8 -0
  701. package/types/src/utils/displayName.d.ts +10 -0
  702. package/types/src/utils/index.d.ts +1 -1
  703. package/types/src/utils/theme.d.ts +170 -0
  704. package/types/src/utils/themeInk.d.ts +56 -0
  705. package/types/umd-entry.d.ts +4 -0
  706. package/umd/d3plus-core.full.js +72239 -41465
  707. package/umd/d3plus-core.full.min.js +2 -2
  708. package/umd/d3plus-core.js +46249 -19519
  709. package/umd/d3plus-core.min.js +2 -2
  710. package/es/src/components/Axis/gridStroke.js +0 -10
  711. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -21,6 +21,13 @@ export declare function observeVisibility(el: Element, scrollContainer: unknown,
21
21
  @private
22
22
  */
23
23
  export declare function vizUnload(viz: Viz): void;
24
+ /**
25
+ Stops what a chart's drawn scene keeps running: its idle work (network
26
+ measures, queued again when it redraws), a pending repaint, and the
27
+ scene renderer with its DOM, listeners, and timers.
28
+ @private
29
+ */
30
+ export declare function releaseScene(viz: Viz): void;
24
31
  /**
25
32
  Redraws an unloaded chart without an entrance animation.
26
33
  @private
@@ -32,3 +39,9 @@ export declare function vizReload(viz: Viz): void;
32
39
  @private
33
40
  */
34
41
  export declare function syncUnloadObserver(viz: Viz): void;
42
+ /**
43
+ Stops a chart's visibility, resize, and scroll polling and its visibility
44
+ observers, so a destroyed chart leaves no timer or listener holding it.
45
+ @private
46
+ */
47
+ 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[];
@@ -34,6 +35,27 @@ export default class Axis extends BaseClass {
34
35
  when its range is fixed.
35
36
  */
36
37
  _labelOverflow: [number, number];
38
+ /**
39
+ Whether the `maxSize` is the chart's own default limit (see
40
+ `defaultMaxSize`), which lets one line of labels and the title take
41
+ more than it.
42
+ */
43
+ _softMaxSize: boolean;
44
+ /**
45
+ Whether a vertical axis hides labels to give the ones it shows more
46
+ lines (see `thinForLines`): a bucketed ColorScale's.
47
+ */
48
+ _thinForLines: boolean;
49
+ /** Whether the last layout pass left the title out to fit `maxSize` (see `measureAxis`). */
50
+ _dropTitle: boolean;
51
+ /**
52
+ How the last layout pass fit `maxSize`: how many shown labels it left
53
+ out, and the room the labels had (see `limitLabels`).
54
+ */
55
+ _limited?: {
56
+ dropped: number;
57
+ room: number;
58
+ };
37
59
  _position: {
38
60
  horizontal: boolean;
39
61
  width: string;
@@ -50,6 +72,12 @@ export default class Axis extends BaseClass {
50
72
  }[];
51
73
  _d3Scale: D3Scale | null;
52
74
  _d3ScaleNegative: D3Scale | null;
75
+ /**
76
+ Whether the domain is handed over last value first, as a Plot hands its
77
+ y axes theirs (they run bottom to top). Tick tooltips count a
78
+ categorical axis's labels from the domain's start (see `tickRank`).
79
+ */
80
+ _domainEndFirst: boolean;
53
81
  /** The active baseline break, set by the layout pass (see `baselineBreak`). */
54
82
  _baselineBreak: AxisBaselineBreak | null;
55
83
  /** Every active break (baseline and explicit), set by the layout pass. */
@@ -129,8 +157,11 @@ export default class Axis extends BaseClass {
129
157
  barConfig(_: Record<string, unknown>): this;
130
158
  /**
131
159
  Style of the breaks set with `break`: `space` (pixels of axis each break
132
- occupies), `gap` (pixels between its two marks, where the axis line is
133
- not drawn), `size` (length of each mark, drawn outward from the axis
160
+ occupies), `spaceMin` (the least `space` a break shrinks to when the
161
+ axis is too short to hold `space` and leave twice that for the data;
162
+ by default such a break is dropped), `gap` (pixels between its two
163
+ marks, where the axis line is not drawn; it shrinks with the break),
164
+ `size` (length of each mark, drawn outward from the axis
134
165
  line on the tick side so it never reaches into the plot), `angle`
135
166
  (degrees each mark tilts from perpendicular), `lines` (whether a Plot
136
167
  runs a line across the plot from each mark, default `true`),
@@ -263,5 +294,5 @@ export interface AxisLayout {
263
294
  margin: Record<string, number>;
264
295
  }
265
296
  export declare function computeAxisLayout(axis: Axis): AxisLayout;
266
- export { measureAxis } from "./axisLayout.js";
297
+ export { measureAxis } from "./axisLimit.js";
267
298
  export type { AxisLayoutResult } from "./axisLayout.js";
@@ -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
@@ -26,6 +26,11 @@ export interface AxisBreak {
26
26
  baseline: boolean;
27
27
  /** Whether shapes crossing the break get a gap cut across them (see `mask`). */
28
28
  mask: boolean;
29
+ /**
30
+ The share of its `space` an explicit break takes when shrunk to fit the
31
+ axis (see `fitBreakSpace`); its gap shrinks by the same share.
32
+ */
33
+ fit?: number;
29
34
  }
30
35
  /** The style of a break glyph, read from `breakConfig`/`baselineBreakConfig`. */
31
36
  export interface BreakStyle {
@@ -44,6 +49,8 @@ export interface BreakStyle {
44
49
  }
45
50
  /** Reads the glyph settings from one of an axis's break configs. */
46
51
  export declare function breakStyle(axis: Axis, key?: "breakConfig" | "baselineBreakConfig"): BreakStyle;
52
+ /** Reads break glyph settings from a break config object (see `breakStyle`). */
53
+ export declare function breakStyleOf(config: unknown): BreakStyle;
47
54
  /** Reads the baseline break's glyph settings (`baselineBreakConfig`). */
48
55
  export declare const baselineBreakStyle: (axis: Axis) => BreakStyle;
49
56
  /**
@@ -53,11 +60,19 @@ export declare const baselineBreakStyle: (axis: Axis) => BreakStyle;
53
60
  and only when the range is long enough to hold it.
54
61
  */
55
62
  export declare function resolveBaselineBreak(axis: Axis, range: number[]): AxisBaselineBreak | null;
63
+ /**
64
+ The pixels each of `count` explicit breaks takes on an axis `length`
65
+ pixels long: `space`, or less when the axis can't hold that and still
66
+ leave twice a break's room for the data, down to `spaceMin`. `null` when
67
+ even `spaceMin` doesn't fit, and the breaks are dropped.
68
+ */
69
+ export declare function fitBreakSpace(length: number, count: number, space: number, spaceMin?: number): number | null;
56
70
  /**
57
71
  Replaces a linear axis's scale with a broken one when it has a baseline
58
72
  break or any `break` ranges inside its domain, and records the resolved
59
- breaks on `axis._breaks`. Explicit breaks are dropped when the range
60
- can't hold them and still leave twice a break's space for the data.
73
+ breaks on `axis._breaks`. Explicit breaks shrink when the range can't
74
+ hold them and still leave twice a break's space for the data (down to
75
+ `breakConfig.spaceMin`), and are dropped below that.
61
76
  */
62
77
  export declare function applyAxisBreaks(axis: Axis, range: number[]): void;
63
78
  /**
@@ -66,7 +81,10 @@ export declare function applyAxisBreaks(axis: Axis, range: number[]): void;
66
81
  "baseline, break, edge, …".
67
82
  */
68
83
  export declare function breakTickValues(breaks: AxisBreak[], values: unknown[], addBaseline?: boolean): unknown[];
69
- /** The pixel gap (`[from, to]`, ascending) a break leaves in the axis line. */
84
+ /**
85
+ The pixel gap (`[from, to]`, ascending) a break leaves in the axis line,
86
+ shrunk with a break shrunk to fit the axis.
87
+ */
70
88
  export declare function breakGap(axis: Axis, brk: AxisBreak): [number, number];
71
89
  /**
72
90
  The axis's domain bar: a single line, or — on a broken axis — the bar
@@ -5,6 +5,18 @@ export declare function axisBarConfig(axis: Axis): Record<string, unknown>;
5
5
  export declare function axisBreakConfig(axis: Axis): Record<string, unknown>;
6
6
  /** The default `gridConfig`. */
7
7
  export declare function axisGridConfig(axis: Axis): Record<string, unknown>;
8
+ /** How a cut tick label ends: as a TextBox line does, or nothing when no text fits. */
9
+ export declare const axisLabelEllipsis: (d: unknown) => string;
10
+ /**
11
+ The ellipsis a cut tick label is measured and painted with: the label
12
+ config's `ellipsis` (a string standing in for the cut line, as TextBox
13
+ reads one), else `axisLabelEllipsis`.
14
+ */
15
+ export declare function labelEllipsis(shapeConfig?: {
16
+ labelConfig?: {
17
+ ellipsis?: unknown;
18
+ };
19
+ }): (text: string, line: number) => string;
8
20
  /** The default `shapeConfig` (tick marks and their labels). */
9
21
  export declare function axisShapeConfig(axis: Axis): Record<string, unknown>;
10
22
  /** The default `titleConfig`. */
@@ -0,0 +1,22 @@
1
+ /**
2
+ Which kind of labels an axis draws: one per category or value read in
3
+ sequence, and how much room each label of an uneven axis has.
4
+ */
5
+ import type Axis from "./Axis.js";
6
+ /**
7
+ Each label's own share of an axis whose labels sit unevenly, such as one
8
+ label per variable-width bar (see `Plot/barWidth.ts`): reaching halfway to
9
+ the nearer of its neighbors on either side, so labels wrapped within their
10
+ shares never meet, while one between far-off neighbors keeps the room
11
+ they leave it. A lone label spans the whole range.
12
+ */
13
+ export declare function ownLabelSpaces(positions: number[], rangeOuter: number[]): number[];
14
+ /**
15
+ Whether a horizontal axis's labels are values read in sequence (dates, or
16
+ numbers on a category axis) that are drawn whole on one line: thinned
17
+ rather than wrapped or cut short, since any one of them reads alone.
18
+ Labels naming categories wrap or rotate instead (see `rotatesLabels`).
19
+ */
20
+ export declare function wholeLineLabels(axis: Axis, labels: unknown[]): boolean;
21
+ /** Whether a scale places one tick per category (every value labeled in turn). */
22
+ export declare function isDiscreteScale(scale: string): boolean;
@@ -0,0 +1,27 @@
1
+ /**
2
+ The line height axis labels are measured and painted with, so a label
3
+ measured as N lines paints as N lines in the room measured for it.
4
+ */
5
+ type Accessor<T> = T | ((d: unknown, i: number) => T);
6
+ /** The parts of an axis's `shapeConfig` that set its labels' line height. */
7
+ export interface LabelLineHeightConfig {
8
+ labelConfig?: {
9
+ fontSize?: Accessor<number>;
10
+ lineHeight?: Accessor<number>;
11
+ };
12
+ lineHeight?: Accessor<number>;
13
+ }
14
+ /** How many times its font size a label's line height is by default (TextBox's default). */
15
+ export declare const LABEL_LINE_HEIGHT = 1.2;
16
+ /**
17
+ The line height of the axis label for tick `d`: the label config's
18
+ `lineHeight` when set, else the shape config's, else 1.2 times the
19
+ label's `fontSize`, as the label's TextBox draws it by default.
20
+ @param shapeConfig The axis's `shapeConfig`.
21
+ @param d The tick value.
22
+ @param i The tick's index.
23
+ @param fontSize The label's font size, read from the label config when
24
+ not given.
25
+ */
26
+ export declare function labelLineHeight(shapeConfig: LabelLineHeightConfig | undefined, d: unknown, i: number, fontSize?: number): number;
27
+ export {};
@@ -0,0 +1,17 @@
1
+ import type { AxisTextDatum } from "./axisLayoutLabels.js";
2
+ /** A label's wrapped lines and size, as `measure` gives them. */
3
+ type Wrapped = Pick<AxisTextDatum, "lines" | "widths" | "width" | "height" | "cut">;
4
+ /**
5
+ A vertical axis paints its flat labels in a box as wide as the widest
6
+ one (see `buildTickData`), narrower than the room they were measured
7
+ in. Where a cut label's line breaks decides where it is cut, so each
8
+ label that doesn't fit is wrapped again in that box (by `measure`, which
9
+ wraps a label within its `room`) until the widest label holds; a label
10
+ that fits wraps the same in any box as wide as it, and a label whose
11
+ first word no longer fits is cut short in it (see `cutLabel`). Records
12
+ the box on each label as its `room`.
13
+ @param textData The axis's measured labels.
14
+ @param measure Wraps a label within its `room`.
15
+ */
16
+ export declare function fitLabelRoom(textData: AxisTextDatum[], measure: (t: AxisTextDatum) => Wrapped): void;
17
+ export {};
@@ -0,0 +1,82 @@
1
+ import type { TextWrapGenerator, TextWrapResult } from "@d3plus/text";
2
+ import type Axis from "./Axis.js";
3
+ import type { AxisTextDatum } from "./axisLayoutLabels.js";
4
+ export interface LabelLayoutCtx {
5
+ horizontal: boolean;
6
+ hBuff: number;
7
+ p: number;
8
+ tickFormat: (d: unknown) => string;
9
+ /** Whether each label is measured on a single line (see `wholeLineLabels`). */
10
+ wholeLine?: boolean;
11
+ /**
12
+ Whether each label wraps within its own share of the axis (see
13
+ `ownLabelSpaces`) rather than the widest share any label has.
14
+ */
15
+ ownSpace?: boolean;
16
+ /** The width slanted labels wrap at (see `slantedLineWidth`). */
17
+ slantWidth?: number;
18
+ /** Whether the labels keep within the axis's `maxSize` (see `strictMaxSize`). */
19
+ strict?: boolean;
20
+ /**
21
+ Whether a flat label too long for its share stays within it, cut short
22
+ (see `cutLabel`), rather than being measured across the axis.
23
+ */
24
+ keepShare?: boolean;
25
+ }
26
+ /**
27
+ Cuts a label short to fit `width`: for a label whose first word is wider
28
+ than its room, which wraps to nothing. The word is cut to as many
29
+ characters as fit with the ellipsis after them (the wrap's own, else
30
+ `axisLabelEllipsis`), on one line; with no room for even one, the label
31
+ has no lines.
32
+ */
33
+ export declare function cutLabel(wrap: TextWrapGenerator, text: string, width: number): TextWrapResult;
34
+ /**
35
+ Measures a flat label whose first word is wider than its room (`space`),
36
+ which wraps to nothing there. On a horizontal axis, where `space` is the
37
+ label's share of the axis: across the whole axis (`across` wide) instead,
38
+ so the overlap pass thins the labels out, or when it is too wide for that
39
+ as well, cut short within its share (see `cutLabel`). Labels in their own
40
+ shares are cut only when none fits whole (`keepShare`, see
41
+ `fitOwnSpaces`). On a vertical axis, where `space` is how far labels
42
+ reach out from the axis, the label is cut short within it (`keepShare`).
43
+ */
44
+ export declare function longWordLabel(wrap: TextWrapGenerator, text: string, space: number, across: number, ctx: Pick<LabelLayoutCtx, "keepShare" | "ownSpace">): {
45
+ res: TextWrapResult;
46
+ cut: boolean;
47
+ };
48
+ /**
49
+ Wraps a slanted label onto fewer lines, each as long as the lines left
50
+ leave room for, until it reaches no further out from the axis than
51
+ `depth`. A label's every line adds its height to how far it reaches,
52
+ across the slant, so giving one up lets the others run further out. A
53
+ wrap that leaves no lines (a word too long for the line) doesn't count:
54
+ the next, longer line is tried, and a label cut short is measured with
55
+ the ellipsis its TextBox ends it with (the wrap's own, else
56
+ `axisLabelEllipsis`). `width` caps how long a line may be; `res` is the
57
+ label as first wrapped.
58
+ */
59
+ export declare function slantWithin(wrap: TextWrapGenerator, text: string, res: TextWrapResult, slant: {
60
+ angle: number;
61
+ horizontal: boolean;
62
+ depth: number;
63
+ width: number;
64
+ }): TextWrapResult;
65
+ /** How far labels may reach out from the axis, past its ticks and margins. */
66
+ export declare function labelRoom(axis: Axis, horizontal: boolean, hBuff: number, p: number): number;
67
+ /** A label's wrapped lines and measured size (see `calculateLabelSize`). */
68
+ export type LabelSize = {
69
+ lines: string[];
70
+ widths: number[];
71
+ width: number;
72
+ height: number;
73
+ fits: boolean;
74
+ /** Whether the label is cut short mid-word to fit (see `cutLabel`). */
75
+ cut: boolean;
76
+ };
77
+ /**
78
+ Wraps + measures a single label, returning its sized text result. Given a
79
+ `cache`, a label whose text, font, and space match one measured before
80
+ reuses that measurement.
81
+ */
82
+ export declare function calculateLabelSize(axis: Axis, datum: AxisTextDatum, ctx: LabelLayoutCtx, cache?: Map<string, LabelSize>): LabelSize;
@@ -20,9 +20,45 @@ export declare function labelExtent(datum: Pick<AxisTextDatum, "angle" | "slant"
20
20
  scale's `range`, each tick at its slot's center: one bar each, for one
21
21
  label per bar), so where two narrow neighbors can't both fit, the
22
22
  narrower bar's label is the one hidden; every other label stays as it
23
- is. `resize` measures a label again at a given width.
23
+ is. A label with none shown beside it widens no further than the ends
24
+ of the axis (`bounds`, the scale's `range` by default) allow, centered
25
+ on its tick. When no label fits whole, each is drawn in its own share
26
+ instead, cut short if need be. `resize` measures a label again at a
27
+ given width, within that width when `keepShare`.
24
28
  */
25
- export declare function fitOwnSpaces(textData: AxisTextDatum[], spaces: number[], range: number[], resize: (datum: AxisTextDatum, space: number) => AxisTextDatum): void;
29
+ export declare function fitOwnSpaces(textData: AxisTextDatum[], spaces: number[], range: number[], resize: (datum: AxisTextDatum, space: number, keepShare?: boolean) => AxisTextDatum, bounds?: number[]): void;
30
+ /**
31
+ The widest a label centered on its tick at `position` can be without
32
+ reaching past either end of `bounds` (0 for a tick outside them).
33
+ */
34
+ export declare function roomAround(position: number, bounds: number[]): number;
35
+ /**
36
+ Measures each label left shown along a vertical axis again in the room
37
+ the hidden labels beside it leave: up to its padding short of the
38
+ nearest label shown on either side, and of the ends of the axis
39
+ (`bounds`), centered on its tick. Labels are first measured in room for
40
+ one at every tick, so the ones left shown after thinning could take more
41
+ lines. Only labels that don't fit whole are measured again, and only in
42
+ more room than they had; that room keeps them clear of their neighbors
43
+ and within the axis, so no two shown labels crowd and none reaches
44
+ further past an end than before.
45
+ */
46
+ export declare function regrowShown(textData: AxisTextDatum[], resize: (datum: AxisTextDatum, space: number) => AxisTextDatum, bounds: number[]): void;
47
+ /**
48
+ Picks which labels a vertical axis shows so that each takes as many
49
+ lines as it can, as a gradient color scale's few labels do: for a
50
+ bucketed color scale, whose every bucket has a label. While some label
51
+ shown is cut short, labels are hidden at an even interval, the first
52
+ and last always kept, until every label shown fits whole, or else as far
53
+ as gives the labels shown the most lines (the fewest any of them has),
54
+ hiding no more labels than that takes. Each label shown is measured in
55
+ the room between the nearest labels shown on either side, up to its
56
+ padding short of them (a label at an end, twice its distance to the one
57
+ beside it), and never less than every label had at first (`floor`):
58
+ one at an end reaching past the end of the axis narrows the axis's
59
+ range, as a gradient's do. `resize` measures a label again in a room.
60
+ */
61
+ export declare function thinForLines(textData: AxisTextDatum[], resize: (datum: AxisTextDatum, space: number) => AxisTextDatum, floor: number): void;
26
62
  /**
27
63
  Hides labels on a discrete axis at a regular interval: every label when
28
64
  they all fit side by side, otherwise every second label, or third, and so
@@ -24,14 +24,21 @@ export interface AxisLayoutResult {
24
24
  Axis-instance shape (the production `Axis` class is the canonical input).
25
25
  Pure compute — no DOM, no rendering. Mutates the input to set
26
26
  `_d3Scale`/`_outerBounds`/`_margin`/etc. for callers that read those off
27
- the instance afterward.
27
+ the instance afterward. `measureAxis` (see `axisLimit.ts`) runs it again
28
+ without the title when the labels don't fit `maxSize` beside it.
28
29
  */
29
- export declare function measureAxis(axis: Axis): AxisLayoutResult;
30
+ export declare function layoutAxis(axis: Axis): AxisLayoutResult;
30
31
  /**
31
32
  How far the first and last slanted labels shown reach past the start and
32
33
  end of `range`, along the axis (0 when they don't, or aren't slanted).
33
34
  */
34
35
  export declare function slantedOverflow(axis: Axis, textData: AxisTextDatum[], range: number[]): [number, number];
36
+ /**
37
+ Whether staggered labels, each row as deep as its labels and the second
38
+ row set out past the first, reach out from the axis no further than
39
+ `room`.
40
+ */
41
+ export declare function staggerFits(textData: AxisTextDatum[], room: number, horizontal: boolean): boolean;
35
42
  /**
36
43
  Whether the axis may rotate its labels on its own: one label per category
37
44
  naming things rather than numbers or dates, which read in sequence even
@@ -1,4 +1,6 @@
1
1
  import type Axis from "./Axis.js";
2
+ import type { LabelLayoutCtx } from "./axisLabelSize.js";
3
+ export { isDiscreteScale, ownLabelSpaces, wholeLineLabels, } from "./axisLabelKinds.js";
2
4
  /** Resolves a tick's pixel size from the shape config (or a constant). */
3
5
  export type TickGet = (d?: {
4
6
  tick?: boolean;
@@ -15,6 +17,7 @@ export interface AxisTextDatum {
15
17
  fF: string;
16
18
  fP: number;
17
19
  fS: number;
20
+ /** The label's line height, measured and painted (see `labelLineHeight`). */
18
21
  lineHeight: number;
19
22
  position: number;
20
23
  rotate?: boolean;
@@ -32,32 +35,31 @@ export interface AxisTextDatum {
32
35
  cut off, and none broken across lines with a hyphen.
33
36
  */
34
37
  fits: boolean;
38
+ /** Whether the label is drawn cut short mid-word (see `cutLabel`). */
39
+ cut?: boolean;
35
40
  /** Whether the overlap pass hides the label to make room for its neighbors. */
36
41
  truncated?: boolean;
37
42
  offset?: number;
38
- }
39
- interface LabelLayoutCtx {
40
- horizontal: boolean;
41
- hBuff: number;
42
- p: number;
43
- tickFormat: (d: unknown) => string;
44
- /** Whether each label is measured on a single line (see `wholeLineLabels`). */
45
- wholeLine?: boolean;
46
43
  /**
47
- Whether each label wraps within its own share of the axis (see
48
- `ownLabelSpaces`) rather than the widest share any label has.
44
+ The width a flat label on a vertical axis wraps in, and is painted in
45
+ (see `fitLabelRoom`); unset, it wraps in all the room the axis allows.
49
46
  */
50
- ownSpace?: boolean;
51
- /** The width slanted labels wrap at (see `slantedLineWidth`). */
52
- slantWidth?: number;
47
+ room?: number;
53
48
  }
54
- /** Applies the axis title's wrapped height to the orient-side margin. */
49
+ /**
50
+ Applies the axis title's wrapped height to the orient-side margin, as
51
+ the title TextBox draws it across `range` (see `titleRoom`). Given the
52
+ range it was `measured` across before, it measures again only when the
53
+ range has changed. Returns the range measured across. A title left out
54
+ (see `measureAxis` in `axisLimit.ts`) claims no room.
55
+ */
55
56
  export declare function applyTitleMargin(axis: Axis, ctx: {
56
57
  range: number[];
57
58
  p: number;
58
59
  height: string;
59
60
  margin: Record<string, number>;
60
- }): void;
61
+ measured?: number[];
62
+ }): number[];
61
63
  /** Resolves the tick height/width buffers from the shape config. */
62
64
  export declare function computeBuffers(axis: Axis, _ticks: unknown[], tickGet: TickGet, height: string): {
63
65
  hBuff: number;
@@ -71,24 +73,9 @@ export declare function createTextData(axis: Axis, ctx: LabelLayoutCtx & {
71
73
  labels: unknown[];
72
74
  rangeOuter: number[];
73
75
  offset?: number;
76
+ /** Whether the labels left shown take the room hidden ones leave (see `regrowShown`). */
77
+ regrow?: boolean;
74
78
  }): AxisTextDatum[];
75
- /**
76
- Each label's own share of an axis whose labels sit unevenly, such as one
77
- label per variable-width bar (see `Plot/barWidth.ts`): reaching halfway to
78
- the nearer of its neighbors on either side, so labels wrapped within their
79
- shares never meet, while one between far-off neighbors keeps the room
80
- they leave it. A lone label spans the whole range.
81
- */
82
- export declare function ownLabelSpaces(positions: number[], rangeOuter: number[]): number[];
83
- /**
84
- Whether a horizontal axis's labels are values read in sequence (dates, or
85
- numbers on a category axis) that are drawn whole on one line: thinned
86
- rather than wrapped or cut short, since any one of them reads alone.
87
- Labels naming categories wrap or rotate instead (see `rotatesLabels`).
88
- */
89
- export declare function wholeLineLabels(axis: Axis, labels: unknown[]): boolean;
90
- /** Whether a scale places one tick per category (every value labeled in turn). */
91
- export declare function isDiscreteScale(scale: string): boolean;
92
79
  /**
93
80
  How far a measured label reaches out from the axis: its height when it
94
81
  lies flat along a horizontal axis, its width when it stands out from the
@@ -96,6 +83,15 @@ export declare function isDiscreteScale(scale: string): boolean;
96
83
  padding on a horizontal axis, as its height holds).
97
84
  */
98
85
  export declare function labelDepth(t: AxisTextDatum, horizontal: boolean): number;
86
+ /**
87
+ Leaves out each label that reaches further out from the axis than
88
+ `room` (what its strict `maxSize` leaves the labels, see
89
+ `strictMaxSize`), a staggered one by its row's offset too: it is hidden,
90
+ and claims no room. A label with no lines left in that room is hidden
91
+ too. Returns how many of the labels shown it left out for reaching too
92
+ far.
93
+ */
94
+ export declare function limitLabels(textData: AxisTextDatum[], horizontal: boolean, room: number): number;
99
95
  /** Derives `_outerBounds` + axis margins from the measured text data. */
100
96
  export declare function computeAxisBounds(axis: Axis, ctx: {
101
97
  textData: AxisTextDatum[];
@@ -110,4 +106,3 @@ export declare function computeAxisBounds(axis: Axis, ctx: {
110
106
  opposite: string;
111
107
  margin: Record<string, number>;
112
108
  }): Record<string, number>;
113
- export {};
@@ -5,8 +5,10 @@ import type { TickGet } from "./axisLayoutLabels.js";
5
5
  Builds the tick label formatter (user-supplied or scale-derived). With a
6
6
  `rotatedTickFormat`, the formatter reads `axis._labelRotation` on every
7
7
  call, so labels measured and painted rotated use that one instead.
8
+ `getLabels` returns the values the axis labels, which decide the
9
+ open-ended labels of an axis rounded "inside".
8
10
  */
9
- export declare function buildTickFormat(axis: Axis, timeLocaleObj: TimeLocaleDefinition, getTicks: () => unknown[]): (d: unknown) => string;
11
+ export declare function buildTickFormat(axis: Axis, timeLocaleObj: TimeLocaleDefinition, getLabels: () => unknown[]): (d: unknown) => string;
10
12
  /**
11
13
  The label lists an axis chooses among, when its `labels` is a list of
12
14
  lists (from the most labels to the fewest): the layout labels the first
@@ -0,0 +1,18 @@
1
+ /**
2
+ Lays an axis out within its `maxSize` (see `strictMaxSize`): when the
3
+ labels can't fit beside the title, the title gives way, and when they
4
+ can't fit at all, the labels do. Pure compute, no DOM.
5
+ */
6
+ import type Axis from "./Axis.js";
7
+ import type { AxisLayoutResult } from "./axisLayout.js";
8
+ /**
9
+ Lays out `axis` (see `layoutAxis`) and returns the layout the paint
10
+ phase draws. A label that reaches further out from the axis than its
11
+ `maxSize` leaves room for is left out (see `limitLabels`). When that
12
+ leaves out any label shown, a title is left out instead if every label
13
+ then fits; otherwise the labels are left out and the title stays, unless
14
+ the title alone takes more than the `maxSize` too. The ticks, the axis
15
+ line and its bar still draw, and the axis claims only the room of what
16
+ it draws.
17
+ */
18
+ export declare function measureAxis(axis: Axis): AxisLayoutResult;
@@ -0,0 +1,48 @@
1
+ import type { AxisConfig } from "../../utils/D3plusConfig.js";
2
+ type MaxSize = AxisConfig["maxSize"];
3
+ /** The limit a `maxSize` sets: a function is called with `size`, a number is the limit itself. */
4
+ export declare function resolveMaxSize(maxSize: MaxSize, size: number): number | undefined;
5
+ /**
6
+ The limit an axis's `maxSize` sets, read against the room the axis has
7
+ across its labels: its height when it lies `horizontal`, else its width.
8
+ */
9
+ export declare function axisMaxSize(schema: {
10
+ maxSize?: MaxSize;
11
+ width?: number;
12
+ height?: number;
13
+ }, horizontal: boolean): number | undefined;
14
+ /**
15
+ Replaces a function `maxSize` on `axis` with the limit it sets for `size`,
16
+ so an axis drawn at another size than it was measured at keeps the limit
17
+ it was measured with.
18
+ */
19
+ export declare function pinMaxSize<T extends {
20
+ schema: {
21
+ maxSize?: MaxSize;
22
+ };
23
+ }>(axis: T, size: number): T;
24
+ /**
25
+ Marks the `maxSize` a chart gives `axis` as the chart's own default
26
+ limit, unless one of `configs` (the configs the chart applies to the
27
+ axis, the user's among them) sets a `maxSize`. A default limit wraps the
28
+ labels within it, but lets the axis take more than it to draw one line
29
+ of labels and the title (see `strictMaxSize`).
30
+ */
31
+ export declare function defaultMaxSize<T extends {
32
+ _softMaxSize?: boolean;
33
+ }>(axis: T, ...configs: unknown[]): T;
34
+ /**
35
+ Whether `axis` keeps all it claims across its labels within its
36
+ `maxSize`, however its labels are laid out (wrapped, slanted, upright or
37
+ staggered), leaving out the labels and title that don't fit: any finite
38
+ `maxSize` but a chart's own default (see `defaultMaxSize`).
39
+ */
40
+ export declare function strictMaxSize(axis: {
41
+ schema: {
42
+ maxSize?: MaxSize;
43
+ width?: number;
44
+ height?: number;
45
+ };
46
+ _softMaxSize?: boolean;
47
+ }, horizontal: boolean): boolean;
48
+ export {};
@@ -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;