@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
@@ -0,0 +1,96 @@
1
+ /**
2
+ Resolves a chart's `theme` once per draw and hands it to the chart's
3
+ components, and paints a forced theme's background into the scene.
4
+
5
+ @module
6
+ */ import { resolveTheme, themed, themeStyle } from "../../utils/theme.js";
7
+ import { cascadeTheme } from "../../utils/themeInk.js";
8
+ import { pageTheme, unwatchPageTheme, watchPageTheme } from "./pageTheme.js";
9
+ export { unwatchPageTheme };
10
+ /**
11
+ Resolves the chart's theme for this draw onto `viz._theme` and its
12
+ components, and keeps an `"auto"` chart watching its page for a flip
13
+ between light and dark (a forced theme stops watching).
14
+ */ export function applyVizTheme(viz) {
15
+ const setting = viz.schema.theme;
16
+ const theme = resolveTheme(setting, pageTheme(viz), viz.schema.colorDefaults);
17
+ viz._theme = theme;
18
+ cascadeTheme(viz, theme);
19
+ if (theme.painted) unwatchPageTheme(viz);
20
+ else watchPageTheme(viz);
21
+ return theme;
22
+ }
23
+ /**
24
+ The chart area a Geomap's ocean and tiles cover in the page, beneath the
25
+ painted scene (a server render paints them in the scene instead).
26
+ */ function underlay(viz) {
27
+ if (viz._ssr || !viz._tileGroup || !viz._margin) return undefined;
28
+ const { top, right, bottom, left } = viz._margin;
29
+ const { width, height } = viz.schema;
30
+ return {
31
+ x: left,
32
+ y: top,
33
+ width: width - left - right,
34
+ height: height - top - bottom
35
+ };
36
+ }
37
+ /**
38
+ The scene node a forced theme paints behind the chart, if it has one: a
39
+ rect over the whole chart, framing (not covering) a Geomap's basemap.
40
+ */ export function themeBackgroundNode(viz) {
41
+ const theme = viz._theme;
42
+ if (!theme?.painted) return undefined;
43
+ const { width, height } = viz.schema;
44
+ const base = {
45
+ key: "viz-background",
46
+ interactive: false,
47
+ paint: {
48
+ fill: theme.background
49
+ }
50
+ };
51
+ const hole = underlay(viz);
52
+ if (!hole) return {
53
+ ...base,
54
+ type: "rect",
55
+ x: 0,
56
+ y: 0,
57
+ width,
58
+ height
59
+ };
60
+ // The hole winds the other way, so the nonzero fill leaves it empty.
61
+ const { x, y } = hole;
62
+ return {
63
+ ...base,
64
+ type: "path",
65
+ d: `M0,0H${width}V${height}H0Z` + `M${x},${y}V${y + hole.height}H${x + hole.width}V${y}Z`
66
+ };
67
+ }
68
+ /** The forced theme's background rect, as the scene's first children. */ export function themeBackground(viz) {
69
+ const node = themeBackgroundNode(viz);
70
+ return node ? [
71
+ node
72
+ ] : [];
73
+ }
74
+ /**
75
+ The `color-scheme` the chart's overlays use, so their native controls
76
+ (buttons, the search input, the download menu) match the theme: the
77
+ theme's own when forced or dark, and the page's otherwise.
78
+ */ export function themeColorScheme(theme) {
79
+ if (!theme || !(theme.painted || theme.dark)) return "";
80
+ return theme.dark ? "dark" : "light";
81
+ }
82
+ /** Sets the chart's overlay host's `color-scheme` (see `themeColorScheme`). */ export function applyOverlayColorScheme(viz) {
83
+ const scheme = themeColorScheme(viz._theme);
84
+ const elements = viz._sceneRenderer?.elements?.() ?? [];
85
+ for (const el of elements)if (el.localName === "div" && "style" in el) el.style.colorScheme = scheme;
86
+ }
87
+ /**
88
+ An overlay style with each entry still at its built-in default swapped for
89
+ the theme's overlay color: `keys` maps a CSS property to the overlay token
90
+ it takes, and `format` wraps a token (`1px solid …`). Light charts keep
91
+ the built-in style (see `themed`).
92
+ */ export function themeOverlayStyle(viz, style, defaults, keys) {
93
+ const overrides = {};
94
+ for (const [key, pick] of Object.entries(keys))overrides[key] = themed(viz._theme, (t)=>pick(t.overlay), undefined);
95
+ return themeStyle(style, defaults, overrides);
96
+ }
@@ -1,4 +1,5 @@
1
1
  import { select } from "d3-selection";
2
+ import { cancelIdleWork } from "../features/idleQueue.js";
2
3
  /** Vertical buffer around the scroll root, so charts start rendering just before they scroll into view. */ const ROOT_MARGIN = "25% 0px";
3
4
  const WINDOW_ROOT = {};
4
5
  const entries = new WeakMap();
@@ -90,15 +91,24 @@ const entries = new WeakMap();
90
91
  const parent = viz._select.node()?.parentNode;
91
92
  if (parent) viz._resizeObserver?.unobserve(parent);
92
93
  viz._tooltipClass.data([]).render();
94
+ releaseScene(viz);
95
+ viz._select.selectAll("g.data-table").remove();
96
+ }
97
+ /**
98
+ Stops what a chart's drawn scene keeps running: its idle work (network
99
+ measures, queued again when it redraws), a pending repaint, and the
100
+ scene renderer with its DOM, listeners, and timers.
101
+ @private
102
+ */ export function releaseScene(viz) {
103
+ cancelIdleWork(viz);
93
104
  if (viz._sceneRepaintRAF != null) {
94
- cancelAnimationFrame(viz._sceneRepaintRAF);
105
+ if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(viz._sceneRepaintRAF);
95
106
  viz._sceneRepaintRAF = undefined;
96
107
  }
97
108
  if (viz._sceneRenderer && typeof viz._sceneRenderer.destroy === "function") {
98
109
  viz._sceneRenderer.destroy();
99
110
  viz._sceneRenderer = undefined;
100
111
  }
101
- viz._select.selectAll("g.data-table").remove();
102
112
  }
103
113
  /**
104
114
  Redraws an unloaded chart without an entrance animation.
@@ -124,3 +134,17 @@ const entries = new WeakMap();
124
134
  if (viz._unloadUnobserve) return;
125
135
  viz._unloadUnobserve = observeVisibility(viz._select.node(), viz.schema.scrollContainer, ()=>vizReload(viz), 0, ()=>vizUnload(viz));
126
136
  }
137
+ /**
138
+ Stops a chart's visibility, resize, and scroll polling and its visibility
139
+ observers, so a destroyed chart leaves no timer or listener holding it.
140
+ @private
141
+ */ export function stopVisibilityWatch(viz) {
142
+ if (viz._visiblePoll) viz._visiblePoll = clearInterval(viz._visiblePoll);
143
+ if (viz._resizePoll) viz._resizePoll = clearTimeout(viz._resizePoll);
144
+ if (viz._scrollPoll) viz._scrollPoll = clearTimeout(viz._scrollPoll);
145
+ viz._visibleUnobserve?.();
146
+ viz._visibleUnobserve = undefined;
147
+ viz._unloadUnobserve?.();
148
+ viz._unloadUnobserve = undefined;
149
+ if (viz.schema.scrollContainer) select(viz.schema.scrollContainer).on(`scroll.${viz._uuid}`, null);
150
+ }
@@ -2,7 +2,7 @@ import { extent, min } from "d3-array";
2
2
  import { select } from "d3-selection";
3
3
  import { elem } from "@d3plus/dom";
4
4
  import { TextBox } from "../index.js";
5
- import { measureAxis } from "./axisLayout.js";
5
+ import { measureAxis } from "./axisLimit.js";
6
6
  import { axisBarConfig, axisBreakConfig, axisGridConfig, axisShapeConfig, axisTitleConfig } from "./axisDefaults.js";
7
7
  import { timeDataInDomain } from "./timeValues.js";
8
8
  import { axisToScene } from "./axisScene.js";
@@ -112,6 +112,11 @@ import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
112
112
  key: "range",
113
113
  coerce: "identity"
114
114
  },
115
+ {
116
+ key: "rangeBreaks",
117
+ coerce: "identity",
118
+ default: false
119
+ },
115
120
  {
116
121
  key: "renderMode",
117
122
  coerce: "identity",
@@ -189,6 +194,10 @@ import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
189
194
  coerce: "identity",
190
195
  default: "normal"
191
196
  },
197
+ {
198
+ key: "tickTooltip",
199
+ coerce: "identity"
200
+ },
192
201
  {
193
202
  key: "timeLocale",
194
203
  coerce: "identity",
@@ -198,6 +207,10 @@ import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
198
207
  key: "title",
199
208
  coerce: "identity"
200
209
  },
210
+ {
211
+ key: "titleTooltip",
212
+ coerce: "identity"
213
+ },
201
214
  {
202
215
  key: "width",
203
216
  coerce: "identity",
@@ -207,6 +220,7 @@ import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
207
220
  /**
208
221
  Creates an SVG scale based on an array of data.
209
222
  */ export default class Axis extends BaseClass {
223
+ static _displayName = "Axis";
210
224
  _select;
211
225
  _data;
212
226
  /** The `data` values the scale reads, set by the layout pass (see `axisScaleData`). */ _scaleData = [];
@@ -225,6 +239,20 @@ import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
225
239
  0,
226
240
  0
227
241
  ];
242
+ /**
243
+ Whether the `maxSize` is the chart's own default limit (see
244
+ `defaultMaxSize`), which lets one line of labels and the title take
245
+ more than it.
246
+ */ _softMaxSize = false;
247
+ /**
248
+ Whether a vertical axis hides labels to give the ones it shows more
249
+ lines (see `thinForLines`): a bucketed ColorScale's.
250
+ */ _thinForLines = false;
251
+ /** Whether the last layout pass left the title out to fit `maxSize` (see `measureAxis`). */ _dropTitle = false;
252
+ /**
253
+ How the last layout pass fit `maxSize`: how many shown labels it left
254
+ out, and the room the labels had (see `limitLabels`).
255
+ */ _limited;
228
256
  _position;
229
257
  _tickUnit;
230
258
  _titleClass;
@@ -235,6 +263,11 @@ import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
235
263
  _gridLineData;
236
264
  _d3Scale = null;
237
265
  _d3ScaleNegative = null;
266
+ /**
267
+ Whether the domain is handed over last value first, as a Plot hands its
268
+ y axes theirs (they run bottom to top). Tick tooltips count a
269
+ categorical axis's labels from the domain's start (see `tickRank`).
270
+ */ _domainEndFirst = false;
238
271
  /** The active baseline break, set by the layout pass (see `baselineBreak`). */ _baselineBreak = null;
239
272
  /** Every active break (baseline and explicit), set by the layout pass. */ _breaks = [];
240
273
  _group;
@@ -560,4 +593,4 @@ export function computeAxisLayout(axis) {
560
593
  resolvesReset(Axis.prototype, "barConfig", "breakConfig", "baselineBreakConfig", "gridConfig", "shapeConfig", "titleConfig");
561
594
  // Re-export the standalone `measureAxis` and its result type so consumers
562
595
  // can import them from the same module as the Axis class.
563
- export { measureAxis } from "./axisLayout.js";
596
+ export { measureAxis } from "./axisLimit.js";
@@ -2,6 +2,7 @@ import { default as Axis } from "./Axis.js";
2
2
  /**
3
3
  Axis preset whose ticks are drawn below the horizontal domain path. Accepts everything the base Axis class does.
4
4
  */ export default class AxisBottom extends Axis {
5
+ static _displayName = "AxisBottom";
5
6
  /**
6
7
  Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
7
8
  @private
@@ -2,6 +2,7 @@ import { default as Axis } from "./Axis.js";
2
2
  /**
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
  */ export default class AxisLeft extends Axis {
5
+ static _displayName = "AxisLeft";
5
6
  /**
6
7
  Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
7
8
  @private
@@ -2,6 +2,7 @@ import { default as Axis } from "./Axis.js";
2
2
  /**
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
  */ export default class AxisRight extends Axis {
5
+ static _displayName = "AxisRight";
5
6
  /**
6
7
  Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
7
8
  @private
@@ -2,6 +2,7 @@ import { default as Axis } from "./Axis.js";
2
2
  /**
3
3
  Axis preset whose ticks are drawn above the horizontal domain path. Accepts everything the base Axis class does.
4
4
  */ export default class AxisTop extends Axis {
5
+ static _displayName = "AxisTop";
5
6
  /**
6
7
  Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
7
8
  @private
@@ -9,7 +9,10 @@
9
9
  export { brokenScaleTicks, isBrokenScale } from "./brokenScale.js";
10
10
  const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fallback;
11
11
  /** Reads the glyph settings from one of an axis's break configs. */ export function breakStyle(axis, key = "breakConfig") {
12
- const cfg = axis.schema[key] || {};
12
+ return breakStyleOf(axis.schema[key]);
13
+ }
14
+ /** Reads break glyph settings from a break config object (see `breakStyle`). */ export function breakStyleOf(config) {
15
+ const cfg = config || {};
13
16
  return {
14
17
  angle: num(cfg.angle, 30),
15
18
  gap: Math.max(0, num(cfg.gap, 5)),
@@ -49,11 +52,23 @@ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fal
49
52
  edgePosition
50
53
  };
51
54
  }
55
+ /**
56
+ The pixels each of `count` explicit breaks takes on an axis `length`
57
+ pixels long: `space`, or less when the axis can't hold that and still
58
+ leave twice a break's room for the data, down to `spaceMin`. `null` when
59
+ even `spaceMin` doesn't fit, and the breaks are dropped.
60
+ */ export function fitBreakSpace(length, count, space, spaceMin = space) {
61
+ if (!count) return space;
62
+ const room = length / (count + 2);
63
+ if (room >= space) return space;
64
+ return room >= Math.min(spaceMin, space) ? room : null;
65
+ }
52
66
  /**
53
67
  Replaces a linear axis's scale with a broken one when it has a baseline
54
68
  break or any `break` ranges inside its domain, and records the resolved
55
- breaks on `axis._breaks`. Explicit breaks are dropped when the range
56
- can't hold them and still leave twice a break's space for the data.
69
+ breaks on `axis._breaks`. Explicit breaks shrink when the range can't
70
+ hold them and still leave twice a break's space for the data (down to
71
+ `breakConfig.spaceMin`), and are dropped below that.
57
72
  */ export function applyAxisBreaks(axis, range) {
58
73
  axis._baselineBreak = resolveBaselineBreak(axis, range);
59
74
  axis._breaks = [];
@@ -61,9 +76,12 @@ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fal
61
76
  const edge = axis._baselineBreak;
62
77
  const domain = axis._d3Scale.domain().map(Number);
63
78
  const inner = range.slice(0, 2).map((r)=>edge && r === edge.position ? edge.edgePosition : r);
64
- const { space, mask } = breakStyle(axis);
79
+ const style = breakStyle(axis);
65
80
  let breaks = normalizeBreaks(axis.schema.break, Math.min(...domain), Math.max(...domain));
66
- if (Math.abs(inner[1] - inner[0]) - breaks.length * space < space * 2) breaks = [];
81
+ const config = axis.schema.breakConfig || {};
82
+ const fitted = fitBreakSpace(Math.abs(inner[1] - inner[0]), breaks.length, style.space, Math.max(0, num(config.spaceMin, style.space)));
83
+ if (fitted === null) breaks = [];
84
+ const space = fitted ?? style.space;
67
85
  if (!edge && !breaks.length) return;
68
86
  const scale = brokenScale({
69
87
  domain,
@@ -96,7 +114,10 @@ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fal
96
114
  startPosition: scale(start),
97
115
  endPosition: scale(end),
98
116
  baseline: false,
99
- mask
117
+ mask: style.mask,
118
+ ...space < style.space ? {
119
+ fit: space / style.space
120
+ } : {}
100
121
  });
101
122
  });
102
123
  }
@@ -116,8 +137,12 @@ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fal
116
137
  }
117
138
  return kept;
118
139
  }
119
- /** The pixel gap (`[from, to]`, ascending) a break leaves in the axis line. */ export function breakGap(axis, brk) {
120
- const { gap } = breakStyle(axis, brk.baseline ? "baselineBreakConfig" : "breakConfig");
140
+ /**
141
+ The pixel gap (`[from, to]`, ascending) a break leaves in the axis line,
142
+ shrunk with a break shrunk to fit the axis.
143
+ */ export function breakGap(axis, brk) {
144
+ const { gap: full } = breakStyle(axis, brk.baseline ? "baselineBreakConfig" : "breakConfig");
145
+ const gap = full * (brk.fit ?? 1);
121
146
  const center = (brk.startPosition + brk.endPosition) / 2;
122
147
  return [
123
148
  center - gap / 2,
@@ -1,13 +1,10 @@
1
- import { colorContrast } from "@d3plus/color";
2
- import { backgroundColor, rtl as detectRTL } from "@d3plus/dom";
1
+ import { rtl as detectRTL } from "@d3plus/dom";
3
2
  import { constant } from "../../utils/index.js";
4
- import { gridStroke } from "./gridStroke.js";
3
+ import { inkAxis, inkGrid } from "../../utils/themeInk.js";
5
4
  import { rotatedTextAnchor } from "./axisLabelAngle.js";
6
- /** A color that contrasts with the background behind the axis's container. */ function contrastInk(axis) {
7
- return ()=>{
8
- const bg = axis._select ? backgroundColor(axis._select.node()) : "rgb(255, 255, 255)";
9
- return colorContrast(bg, axis.schema.colorDefaults);
10
- };
5
+ import { textEllipsis } from "../textEllipsis.js";
6
+ /** The axis color of the axis's chart theme, or one that contrasts with the background behind it. */ function contrastInk(axis) {
7
+ return ()=>inkAxis(axis);
11
8
  }
12
9
  /** The default `barConfig` (the domain line). */ export function axisBarConfig(axis) {
13
10
  return {
@@ -30,10 +27,20 @@ import { rotatedTextAnchor } from "./axisLabelAngle.js";
30
27
  }
31
28
  /** The default `gridConfig`. */ export function axisGridConfig(axis) {
32
29
  return {
33
- stroke: ()=>gridStroke(axis._select?.node(), axis.schema.colorDefaults),
30
+ stroke: ()=>inkGrid(axis),
34
31
  "stroke-width": 1
35
32
  };
36
33
  }
34
+ /** How a cut tick label ends: as a TextBox line does, or nothing when no text fits. */ export const axisLabelEllipsis = (d)=>d && d.length ? textEllipsis(`${d}`) : "";
35
+ /**
36
+ The ellipsis a cut tick label is measured and painted with: the label
37
+ config's `ellipsis` (a string standing in for the cut line, as TextBox
38
+ reads one), else `axisLabelEllipsis`.
39
+ */ export function labelEllipsis(shapeConfig) {
40
+ const ellipsis = shapeConfig?.labelConfig?.ellipsis;
41
+ if (typeof ellipsis === "function") return ellipsis;
42
+ return typeof ellipsis === "string" ? ()=>ellipsis : axisLabelEllipsis;
43
+ }
37
44
  /** The default `shapeConfig` (tick marks and their labels). */ export function axisShapeConfig(axis) {
38
45
  return {
39
46
  fill: contrastInk(axis),
@@ -0,0 +1,36 @@
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
+ Each label's own share of an axis whose labels sit unevenly, such as one
6
+ label per variable-width bar (see `Plot/barWidth.ts`): reaching halfway to
7
+ the nearer of its neighbors on either side, so labels wrapped within their
8
+ shares never meet, while one between far-off neighbors keeps the room
9
+ they leave it. A lone label spans the whole range.
10
+ */ export function ownLabelSpaces(positions, rangeOuter) {
11
+ if (positions.length < 2) return positions.map(()=>Math.abs(rangeOuter[rangeOuter.length - 1] - rangeOuter[0]));
12
+ return positions.map((position, i)=>{
13
+ const gaps = [
14
+ positions[i - 1],
15
+ positions[i + 1]
16
+ ].filter((n)=>n !== undefined).map((n)=>Math.abs(position - n));
17
+ return Math.min(...gaps);
18
+ });
19
+ }
20
+ /**
21
+ Whether a horizontal axis's labels are values read in sequence (dates, or
22
+ numbers on a category axis) that are drawn whole on one line: thinned
23
+ rather than wrapped or cut short, since any one of them reads alone.
24
+ Labels naming categories wrap or rotate instead (see `rotatesLabels`).
25
+ */ export function wholeLineLabels(axis, labels) {
26
+ const { scale } = axis.schema;
27
+ if (scale === "time") return true;
28
+ return isDiscreteScale(scale) && labels.length > 0 && labels.every((d)=>d instanceof Date || !isNaN(d));
29
+ }
30
+ /** Whether a scale places one tick per category (every value labeled in turn). */ export function isDiscreteScale(scale) {
31
+ return [
32
+ "band",
33
+ "ordinal",
34
+ "point"
35
+ ].includes(scale);
36
+ }
@@ -0,0 +1,19 @@
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
+ */ import configValue from "../../utils/configValue.js";
5
+ /** How many times its font size a label's line height is by default (TextBox's default). */ export const LABEL_LINE_HEIGHT = 1.2;
6
+ /**
7
+ The line height of the axis label for tick `d`: the label config's
8
+ `lineHeight` when set, else the shape config's, else 1.2 times the
9
+ label's `fontSize`, as the label's TextBox draws it by default.
10
+ @param shapeConfig The axis's `shapeConfig`.
11
+ @param d The tick value.
12
+ @param i The tick's index.
13
+ @param fontSize The label's font size, read from the label config when
14
+ not given.
15
+ */ export function labelLineHeight(shapeConfig, d, i, fontSize = configValue(shapeConfig?.labelConfig?.fontSize ?? 12, d, i)) {
16
+ const value = shapeConfig?.labelConfig?.lineHeight ?? shapeConfig?.lineHeight;
17
+ const lineHeight = value === undefined ? undefined : configValue(value, d, i);
18
+ return typeof lineHeight === "number" && lineHeight > 0 ? lineHeight : fontSize * LABEL_LINE_HEIGHT;
19
+ }
@@ -0,0 +1,37 @@
1
+ /**
2
+ The box a vertical axis's flat labels wrap in, so each label is cut
3
+ where it is painted.
4
+ */ import { max } from "d3-array";
5
+ /**
6
+ A vertical axis paints its flat labels in a box as wide as the widest
7
+ one (see `buildTickData`), narrower than the room they were measured
8
+ in. Where a cut label's line breaks decides where it is cut, so each
9
+ label that doesn't fit is wrapped again in that box (by `measure`, which
10
+ wraps a label within its `room`) until the widest label holds; a label
11
+ that fits wraps the same in any box as wide as it, and a label whose
12
+ first word no longer fits is cut short in it (see `cutLabel`). Records
13
+ the box on each label as its `room`.
14
+ @param textData The axis's measured labels.
15
+ @param measure Wraps a label within its `room`.
16
+ */ export function fitLabelRoom(textData, measure) {
17
+ const widest = ()=>max(textData, (t)=>t.width) || 0;
18
+ let room = widest();
19
+ // A label wrapped in the box is no wider than it, so the box only
20
+ // narrows, and settles.
21
+ for(;;){
22
+ textData.forEach((t)=>t.room = room);
23
+ textData.filter((t)=>!t.fits).forEach((t)=>{
24
+ const { lines, widths, width, height, cut } = measure(t);
25
+ Object.assign(t, {
26
+ lines,
27
+ widths,
28
+ width,
29
+ height,
30
+ cut
31
+ });
32
+ });
33
+ const next = widest();
34
+ if (next >= room) return;
35
+ room = next;
36
+ }
37
+ }
@@ -0,0 +1,171 @@
1
+ /**
2
+ Measures a single axis label for `createTextData` (see
3
+ `axisLayoutLabels.ts`): wrapped with `textWrap` within the room its axis
4
+ gives it. Pure compute, no DOM.
5
+ */ import { max, min } from "d3-array";
6
+ import { textWrap } from "@d3plus/text";
7
+ import { wholeWordFit, wholeWordSplit } from "../../utils/wholeWords.js";
8
+ import { axisLabelEllipsis, labelEllipsis } from "./axisDefaults.js";
9
+ import { axisCrossing, slantedWrapSize } from "./axisLabelAngle.js";
10
+ import { axisMaxSize } from "./axisMaxSize.js";
11
+ /**
12
+ Cuts a label short to fit `width`: for a label whose first word is wider
13
+ than its room, which wraps to nothing. The word is cut to as many
14
+ characters as fit with the ellipsis after them (the wrap's own, else
15
+ `axisLabelEllipsis`), on one line; with no room for even one, the label
16
+ has no lines.
17
+ */ export function cutLabel(wrap, text, width) {
18
+ return wrap.width(width).truncateWord(true).ellipsis(wrap.ellipsis() ?? axisLabelEllipsis)(text);
19
+ }
20
+ /**
21
+ Measures a flat label whose first word is wider than its room (`space`),
22
+ which wraps to nothing there. On a horizontal axis, where `space` is the
23
+ label's share of the axis: across the whole axis (`across` wide) instead,
24
+ so the overlap pass thins the labels out, or when it is too wide for that
25
+ as well, cut short within its share (see `cutLabel`). Labels in their own
26
+ shares are cut only when none fits whole (`keepShare`, see
27
+ `fitOwnSpaces`). On a vertical axis, where `space` is how far labels
28
+ reach out from the axis, the label is cut short within it (`keepShare`).
29
+ */ export function longWordLabel(wrap, text, space, across, ctx) {
30
+ if (!ctx.keepShare) {
31
+ const wide = wrap.width(across)(text);
32
+ if (ctx.ownSpace || wide.lines.some((l)=>l !== "")) return {
33
+ res: wide,
34
+ cut: false
35
+ };
36
+ }
37
+ const res = cutLabel(wrap, text, space);
38
+ return {
39
+ res,
40
+ cut: res.lines.length > 0
41
+ };
42
+ }
43
+ /**
44
+ Wraps a slanted label onto fewer lines, each as long as the lines left
45
+ leave room for, until it reaches no further out from the axis than
46
+ `depth`. A label's every line adds its height to how far it reaches,
47
+ across the slant, so giving one up lets the others run further out. A
48
+ wrap that leaves no lines (a word too long for the line) doesn't count:
49
+ the next, longer line is tried, and a label cut short is measured with
50
+ the ellipsis its TextBox ends it with (the wrap's own, else
51
+ `axisLabelEllipsis`). `width` caps how long a line may be; `res` is the
52
+ label as first wrapped.
53
+ */ export function slantWithin(wrap, text, res, slant) {
54
+ const phi = axisCrossing(slant.angle, slant.horizontal);
55
+ const sin = Math.sin(phi), cos = Math.cos(phi);
56
+ const lineHeight = wrap.lineHeight();
57
+ const count = (r)=>r.lines.filter((l)=>l !== "").length;
58
+ const fits = (r)=>{
59
+ const lines = count(r);
60
+ const width = Math.ceil(Math.max(0, ...r.widths.slice(0, lines)));
61
+ return width * sin + Math.ceil(lines * lineHeight) * cos <= slant.depth;
62
+ };
63
+ if (!count(res) || fits(res)) return res;
64
+ // Measured as drawn: a label cut short ends in an ellipsis.
65
+ wrap.ellipsis(wrap.ellipsis() ?? axisLabelEllipsis);
66
+ for(let n = count(res) - 1; n >= 1; n--){
67
+ const room = (slant.depth - Math.ceil(n * lineHeight) * cos) / sin;
68
+ wrap.height(n * lineHeight).width(Math.max(0, Math.min(slant.width, room)));
69
+ res = wrap(text);
70
+ if (count(res) && fits(res)) return res;
71
+ }
72
+ return res;
73
+ }
74
+ /** How far labels may reach out from the axis, past its ticks and margins. */ export function labelRoom(axis, horizontal, hBuff, p) {
75
+ const maxSize = axisMaxSize(axis.schema, horizontal);
76
+ return horizontal ? min([
77
+ maxSize,
78
+ axis.schema.height
79
+ ]) - hBuff - p - axis._margin.top - axis._margin.bottom : min([
80
+ maxSize,
81
+ axis.schema.width
82
+ ]) - hBuff - p - axis._margin.left - axis._margin.right;
83
+ }
84
+ /** What a label's measurement depends on, to tell two labels measure alike. */ function labelSizeKey(text, datum, ctx) {
85
+ const { fF, fP, fS, lineHeight, rotate, space, angle, slant, room } = datum;
86
+ return JSON.stringify([
87
+ text,
88
+ fF,
89
+ fP,
90
+ fS,
91
+ lineHeight,
92
+ rotate,
93
+ slant && angle,
94
+ slant && ctx.slantWidth,
95
+ space,
96
+ room,
97
+ ctx.keepShare
98
+ ]);
99
+ }
100
+ /**
101
+ Wraps + measures a single label, returning its sized text result. Given a
102
+ `cache`, a label whose text, font, and space match one measured before
103
+ reuses that measurement.
104
+ */ export function calculateLabelSize(axis, datum, ctx, cache) {
105
+ const { horizontal, hBuff, p, tickFormat } = ctx;
106
+ const { d, fF, fP, fS, lineHeight, rotate, space, angle, slant } = datum;
107
+ const h = rotate ? "width" : "height", w = rotate ? "height" : "width";
108
+ const text = tickFormat(d);
109
+ const wSize = min([
110
+ axisMaxSize(axis.schema, horizontal),
111
+ axis.schema.width
112
+ ]);
113
+ const depth = datum.room ?? labelRoom(axis, horizontal, hBuff, p);
114
+ const slanted = slant ? slantedWrapSize(angle, horizontal, depth, space, lineHeight) : undefined;
115
+ const key = cache && labelSizeKey(text, datum, ctx);
116
+ const cached = key ? cache.get(key) : undefined;
117
+ if (cached) return {
118
+ ...cached,
119
+ lines: cached.lines.slice(),
120
+ widths: cached.widths.slice()
121
+ };
122
+ // A cut label ends with the ellipsis it is painted with.
123
+ const wrap = textWrap().fontFamily(fF).fontSize(fS).lineHeight(lineHeight).ellipsis(labelEllipsis(axis.schema.shapeConfig));
124
+ if (slanted) {
125
+ // Slanted labels wrap between words, never mid-word.
126
+ wrap.split(wholeWordSplit).width(Math.min(slanted.width, ctx.slantWidth ?? Infinity)).height(slanted.height);
127
+ } else {
128
+ wrap[w](horizontal ? space : depth);
129
+ // A flat label's lines share its room with its padding (see `res.height`).
130
+ wrap[h](horizontal ? depth - (rotate ? 0 : fP) : space);
131
+ }
132
+ let res, fits;
133
+ let cut = false;
134
+ if (ctx.wholeLine) {
135
+ // Measured across the whole axis (`maxSize` caps its depth, not its
136
+ // length), a label that still breaks onto a second line can't be drawn
137
+ // whole on one.
138
+ wrap.width(axis.schema.width - p * 2);
139
+ res = wrap(text);
140
+ fits = !res.truncated && res.lines.filter((l)=>l !== "").length <= 1;
141
+ } else {
142
+ res = wrap(text);
143
+ // Within a strict `maxSize`, a slanted label reaches out no further
144
+ // than the room it has, its padding with it.
145
+ if (slanted && ctx.strict) res = slantWithin(wrap, text, res, {
146
+ angle: angle,
147
+ horizontal,
148
+ depth: Math.floor(depth - (horizontal ? fP : 0)),
149
+ width: Math.min(slanted.width, ctx.slantWidth ?? Infinity)
150
+ });
151
+ // A label that only fits by breaking a word mid-word doesn't fit.
152
+ fits = wholeWordFit(res, ()=>wrap.split(wholeWordSplit)(text)).fits;
153
+ if (!rotate && `${text}`.trim() && !res.lines.some((l)=>l !== "")) ({ res, cut } = horizontal ? longWordLabel(wrap, text, space, wSize - p * 2, ctx) : longWordLabel(wrap, text, depth, depth, {
154
+ keepShare: true
155
+ }));
156
+ }
157
+ res.fits = fits;
158
+ res.cut = cut;
159
+ res.lines = res.lines.filter((d)=>d !== "");
160
+ res.width = res.lines.length ? Math.ceil(max(res.widths)) : 0;
161
+ res.height = res.lines.length ? Math.ceil(res.lines.length * wrap.lineHeight()) + fP : 0;
162
+ if (key) cache.set(key, {
163
+ lines: res.lines.slice(),
164
+ widths: res.widths.slice(),
165
+ width: res.width,
166
+ height: res.height,
167
+ fits,
168
+ cut
169
+ });
170
+ return res;
171
+ }