@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
@@ -10,20 +10,23 @@ import { dateFormatter, formatAbbreviate } from "@d3plus/format";
10
10
  import { formatLocale } from "@d3plus/locales";
11
11
  import { closest } from "@d3plus/math";
12
12
  import { applyAxisBreaks, breakTickValues } from "./axisBreak.js";
13
+ import { applyAxisRangeBreaks, rangeBreakDayLabel, visibleTimeValues } from "./axisRangeBreaks.js";
13
14
  import { axisDateCategories, axisShownDates, axisTimeDomain, axisTimeReference, isCategoryAxis, isValidDate, parseTimeValues } from "./timeValues.js";
14
15
  import { axisIsYearLike, formatYear } from "./yearValues.js";
15
- import { floorPow, isNegative, roundedDomain } from "./axisRounding.js";
16
+ import { floorPow, isNegative, openEnd, roundedDomain } from "./axisRounding.js";
16
17
  import { powExponent } from "./powTicks.js";
17
18
  /**
18
19
  Builds the tick label formatter (user-supplied or scale-derived). With a
19
20
  `rotatedTickFormat`, the formatter reads `axis._labelRotation` on every
20
21
  call, so labels measured and painted rotated use that one instead.
21
- */ export function buildTickFormat(axis, timeLocaleObj, getTicks) {
22
- const format = baseTickFormat(axis, timeLocaleObj, getTicks);
22
+ `getLabels` returns the values the axis labels, which decide the
23
+ open-ended labels of an axis rounded "inside".
24
+ */ export function buildTickFormat(axis, timeLocaleObj, getLabels) {
25
+ const format = baseTickFormat(axis, timeLocaleObj, getLabels);
23
26
  const rotated = axis.schema.rotatedTickFormat;
24
27
  return rotated ? (d)=>(axis._labelRotation ? rotated : format)(d) : format;
25
28
  }
26
- /** The tick label formatter for unrotated labels: `tickFormat`, else the scale's default. */ function baseTickFormat(axis, timeLocaleObj, getTicks) {
29
+ /** The tick label formatter for unrotated labels: `tickFormat`, else the scale's default. */ function baseTickFormat(axis, timeLocaleObj, getLabels) {
27
30
  let years;
28
31
  let categories;
29
32
  // Every label reads all of the axis's dates, so they are read once per set
@@ -37,6 +40,7 @@ import { powExponent } from "./powTicks.js";
37
40
  };
38
41
  return memo.label(d, axisShownDates(axis)).replace(/^Q/g, timeLocaleObj.quarter);
39
42
  };
43
+ const dayLabel = rangeBreakDayLabel(axis);
40
44
  const format = axis.schema.tickFormat;
41
45
  // A tickFormat may read the axis it labels as `this` (such as which labels it shows).
42
46
  return format ? (d)=>format.call(axis, d) : (d)=>{
@@ -49,7 +53,7 @@ import { powExponent } from "./powTicks.js";
49
53
  ].includes(axis.schema.scale)) {
50
54
  return d;
51
55
  } else if (axis.schema.scale === "time") {
52
- return dateLabel(axisTimeReference(axis), d);
56
+ return dayLabel(d) ?? dateLabel(axisTimeReference(axis), d);
53
57
  } else if (axis.schema.scale === "linear" && axis.schema.tickSuffix === "smallest") {
54
58
  const loc = typeof axis.schema.locale === "object" ? axis.schema.locale : formatLocale[axis.schema.locale];
55
59
  const { separator, suffixes } = loc;
@@ -58,12 +62,9 @@ import { powExponent } from "./powTicks.js";
58
62
  const number = formatAbbreviate(tick, loc, `,.${tick.toString().length}r`);
59
63
  return `${number}${separator}${suff}`;
60
64
  } else {
61
- const ticks = getTicks();
62
- const inverted = ticks[1] < ticks[0];
63
- const minTick = inverted ? ticks.length - 1 : 0;
64
- const maxTick = inverted ? 0 : ticks.length - 1;
65
- const prefix = axis.schema.rounding === "inside" ? ticks.indexOf(d) === minTick ? axis.schema.roundingInsideMinPrefix : ticks.indexOf(d) === maxTick ? axis.schema.roundingInsideMaxPrefix : "" : "";
66
- const suffix = axis.schema.rounding === "inside" ? ticks.indexOf(d) === minTick ? axis.schema.roundingInsideMinSuffix : ticks.indexOf(d) === maxTick ? axis.schema.roundingInsideMaxSuffix : "" : "";
65
+ const end = axis.schema.rounding === "inside" ? openEnd(d, getLabels(), axis.schema.domain) : undefined;
66
+ const prefix = end === "min" ? axis.schema.roundingInsideMinPrefix : end === "max" ? axis.schema.roundingInsideMaxPrefix : "";
67
+ const suffix = end === "min" ? axis.schema.roundingInsideMinSuffix : end === "max" ? axis.schema.roundingInsideMaxSuffix : "";
67
68
  years ??= axisIsYearLike(axis);
68
69
  const number = years ? formatYear(d, axis.schema.locale) : formatAbbreviate(d, axis.schema.locale);
69
70
  return `${prefix}${number}${suffix}`;
@@ -177,6 +178,8 @@ import { powExponent } from "./powTicks.js";
177
178
  ticks = ticks.map(Number);
178
179
  labels = labels.map(Number);
179
180
  }
181
+ ticks = visibleTimeValues(axis, ticks);
182
+ labels = visibleTimeValues(axis, labels);
180
183
  if (axis._breaks.length) {
181
184
  ticks = breakTickValues(axis._breaks, ticks);
182
185
  // An explicit `labels` list labels just those values (an empty one, none).
@@ -249,6 +252,8 @@ import { powExponent } from "./powTicks.js";
249
252
  // Breaks (an automatic baseline break and any `break` ranges) swap the
250
253
  // linear scale for a broken one that skips the removed values.
251
254
  applyAxisBreaks(axis, range);
255
+ // A time axis's `rangeBreaks` swap its time scale for one that hides them.
256
+ applyAxisRangeBreaks(axis);
252
257
  const { ticks: rawTicks, labels } = resolveTicksLabels(axis);
253
258
  applyTickSuffixUnit(axis, labels);
254
259
  const ticks = filterVisibleTicks(axis, rawTicks, tickGet);
@@ -0,0 +1,27 @@
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
+ */ import { layoutAxis } from "./axisLayout.js";
6
+ /**
7
+ Lays out `axis` (see `layoutAxis`) and returns the layout the paint
8
+ phase draws. A label that reaches further out from the axis than its
9
+ `maxSize` leaves room for is left out (see `limitLabels`). When that
10
+ leaves out any label shown, a title is left out instead if every label
11
+ then fits; otherwise the labels are left out and the title stays, unless
12
+ the title alone takes more than the `maxSize` too. The ticks, the axis
13
+ line and its bar still draw, and the axis claims only the room of what
14
+ it draws.
15
+ */ export function measureAxis(axis) {
16
+ axis._dropTitle = false;
17
+ const titled = layoutAxis(axis);
18
+ const limited = axis._limited;
19
+ if (!limited || !limited.dropped && limited.room >= 0) return titled;
20
+ if (!axis.schema.title) return titled;
21
+ axis._dropTitle = true;
22
+ const bare = layoutAxis(axis);
23
+ // Without the title every label fits, or the title doesn't fit alone.
24
+ if (!axis._limited?.dropped || limited.room < 0) return bare;
25
+ axis._dropTitle = false;
26
+ return layoutAxis(axis);
27
+ }
@@ -0,0 +1,39 @@
1
+ /** The limit a `maxSize` sets: a function is called with `size`, a number is the limit itself. */ export function resolveMaxSize(maxSize, size) {
2
+ return typeof maxSize === "function" ? maxSize(size) : maxSize;
3
+ }
4
+ /**
5
+ The limit an axis's `maxSize` sets, read against the room the axis has
6
+ across its labels: its height when it lies `horizontal`, else its width.
7
+ */ export function axisMaxSize(schema, horizontal) {
8
+ const size = horizontal ? schema.height : schema.width;
9
+ return resolveMaxSize(schema.maxSize, size);
10
+ }
11
+ /**
12
+ Replaces a function `maxSize` on `axis` with the limit it sets for `size`,
13
+ so an axis drawn at another size than it was measured at keeps the limit
14
+ it was measured with.
15
+ */ export function pinMaxSize(axis, size) {
16
+ const { maxSize } = axis.schema;
17
+ if (typeof maxSize === "function") axis.schema.maxSize = maxSize(size);
18
+ return axis;
19
+ }
20
+ /**
21
+ Marks the `maxSize` a chart gives `axis` as the chart's own default
22
+ limit, unless one of `configs` (the configs the chart applies to the
23
+ axis, the user's among them) sets a `maxSize`. A default limit wraps the
24
+ labels within it, but lets the axis take more than it to draw one line
25
+ of labels and the title (see `strictMaxSize`).
26
+ */ export function defaultMaxSize(axis, ...configs) {
27
+ axis._softMaxSize = !configs.some((config)=>!!config && typeof config === "object" && config.maxSize !== undefined);
28
+ return axis;
29
+ }
30
+ /**
31
+ Whether `axis` keeps all it claims across its labels within its
32
+ `maxSize`, however its labels are laid out (wrapped, slanted, upright or
33
+ staggered), leaving out the labels and title that don't fit: any finite
34
+ `maxSize` but a chart's own default (see `defaultMaxSize`).
35
+ */ export function strictMaxSize(axis, horizontal) {
36
+ if (axis._softMaxSize) return false;
37
+ const limit = axisMaxSize(axis.schema, horizontal);
38
+ return limit !== undefined && Number.isFinite(limit);
39
+ }
@@ -0,0 +1,77 @@
1
+ /**
2
+ A time axis's `rangeBreaks`: the axis swaps its time scale for a broken
3
+ one that hides the rules' time, keeps hidden times out of its ticks and
4
+ labels, and records each marked gap as an axis break so it draws the
5
+ break marker (and, in a Plot, the break lines) like `break` does.
6
+ */ import { timeDay } from "d3-time";
7
+ import { timeFormat } from "d3-time-format";
8
+ import { dateFormatter } from "@d3plus/format";
9
+ import { breakStyle } from "./axisBreak.js";
10
+ import { brokenTimeScale, isBrokenTimeScale } from "./brokenTimeScale.js";
11
+ import { normalizeRangeBreaks } from "./rangeBreaks.js";
12
+ import { axisShownDates, axisTimeReference } from "./timeValues.js";
13
+ /**
14
+ Replaces a time axis's scale with a broken time scale when it has
15
+ `rangeBreaks`, and adds each marked gap inside the domain to
16
+ `axis._breaks`. Marked gaps take `breakConfig.space` pixels each.
17
+ */ export function applyAxisRangeBreaks(axis) {
18
+ const current = axis._d3Scale;
19
+ if (axis.schema.scale !== "time" || !current) return;
20
+ const rules = normalizeRangeBreaks(axis.schema.rangeBreaks);
21
+ if (!rules.length) return;
22
+ const { space, mask } = breakStyle(axis);
23
+ const scale = brokenTimeScale(rules, {
24
+ space
25
+ });
26
+ scale.domain(current.domain());
27
+ scale.range(current.range());
28
+ axis._d3Scale = scale;
29
+ scale.gaps().filter((g)=>g.space > 0).forEach((g)=>axis._breaks.push({
30
+ start: g.start,
31
+ end: g.end,
32
+ startPosition: scale(g.start),
33
+ endPosition: scale(g.end),
34
+ baseline: false,
35
+ mask
36
+ }));
37
+ }
38
+ /** Drops the values a broken time axis hides (from its ticks or labels). */ export function visibleTimeValues(axis, values) {
39
+ const scale = axis._d3Scale;
40
+ return isBrokenTimeScale(scale) ? values.filter((v)=>!scale.isHidden(Number(v))) : values;
41
+ }
42
+ /**
43
+ The day a broken time axis's tick opens: when the tick is the first
44
+ shown time of its day (everything from midnight up to it hidden, such
45
+ as by an `hours` rule), that day's midnight, so the tick can be labeled
46
+ as the day it starts. Otherwise `undefined`.
47
+ */ export function rangeBreakOpenedDay(axis, value) {
48
+ const scale = axis._d3Scale;
49
+ const t = Number(value instanceof Date ? +value : value);
50
+ if (!isBrokenTimeScale(scale) || !Number.isFinite(t)) return undefined;
51
+ const start = timeDay.floor(new Date(t));
52
+ if (+start === t) return undefined;
53
+ return scale.visible(start, t) === 0 ? start : undefined;
54
+ }
55
+ /** The distinct days (as midnights, ascending) of a list of dates. */ export function datesDays(dates) {
56
+ const seen = new Set();
57
+ return dates.map((d)=>timeDay.floor(d)).filter((d)=>!seen.has(+d) && !!seen.add(+d)).sort((a, b)=>+a - +b);
58
+ }
59
+ /**
60
+ The day label for a broken time axis's ticks: given a tick that opens
61
+ its day (see `rangeBreakOpenedDay`), the day, labeled among the axis's
62
+ days in the current default time locale; given any other tick,
63
+ `undefined`. The day formatter is built once per set of axis dates.
64
+ */ export function rangeBreakDayLabel(axis) {
65
+ let memo;
66
+ return (value)=>{
67
+ const day = rangeBreakOpenedDay(axis, value);
68
+ if (!day) return undefined;
69
+ const dates = axisTimeReference(axis);
70
+ if (!memo || memo.dates !== dates || memo.format !== timeFormat) memo = {
71
+ dates,
72
+ format: timeFormat,
73
+ label: dateFormatter(datesDays(dates), timeFormat)
74
+ };
75
+ return memo.label(day, axisShownDates(axis));
76
+ };
77
+ }
@@ -10,6 +10,9 @@ import { ceilPow, fixFloat, floorPow, isNegative } from "./axisRounding.js";
10
10
  import { powTicks } from "./powTicks.js";
11
11
  import { timeDataInDomain } from "./timeValues.js";
12
12
  import { slantedLabelBox } from "./axisLabelAngle.js";
13
+ import { labelLineHeight } from "./axisLabelLineHeight.js";
14
+ import { configureTitle } from "./axisTitle.js";
15
+ import { axisLabelEllipsis } from "./axisDefaults.js";
13
16
  const maxTimezoneOffset = 1000 * 60 * 60 * 26;
14
17
  /**
15
18
  * Calculates ticks from a given scale (negative and/or positive)
@@ -154,7 +157,9 @@ const maxTimezoneOffset = 1000 * 60 * 60 * 26;
154
157
  const space = data ? data.space : 0;
155
158
  const fP = data ? data.fP : 0;
156
159
  const labelOffset = data && axis.schema.labelOffset ? data.offset ?? 0 : 0;
157
- const fitWidth = horizontal ? space : bounds.width - margin[axis._position.opposite] - hBuff - margin[axis.schema.orient] + p;
160
+ // A vertical axis's flat label is painted in the box it was measured
161
+ // in (see `fitLabelRoom`).
162
+ const fitWidth = horizontal ? space : data?.room ?? bounds.width - margin[axis._position.opposite] - hBuff - margin[axis.schema.orient] + p;
158
163
  // A `fixedSize` label space can be narrower than a label: widen that
159
164
  // label's box (outward, away from the axis line) instead of dropping it.
160
165
  const labelWidth = !horizontal && data && typeof axis.schema.fixedSize === "number" ? Math.max(fitWidth, Math.ceil(data.width) + p) : fitWidth;
@@ -169,6 +174,8 @@ const maxTimezoneOffset = 1000 * 60 * 60 * 26;
169
174
  },
170
175
  rotate: data ? data.rotate : false,
171
176
  angle: data ? data.angle : 0,
177
+ cut: !!data?.cut,
178
+ lineHeight: data?.lineHeight,
172
179
  size: labels.includes(d) || axis.schema.scale === "log" && Math.log10(Math.abs(d)) % 1 === 0 ? size : ticks.includes(d) ? Math.ceil(size / 2) : axis._scaleData.find((t)=>+t === d) ? Math.ceil(size / 4) : 0,
173
180
  text: !data?.truncated && labels.includes(d) ? tickFormat(d) : false,
174
181
  tick: ticks.includes(d),
@@ -198,7 +205,9 @@ const maxTimezoneOffset = 1000 * 60 * 60 * 26;
198
205
  // moves the body-div fallback above the compute-mode early-return
199
206
  // would silently leak one <div> per tick render.
200
207
  .renderMode("compute").select(null).data(tickData).duration(axis.schema.duration).labelConfig({
201
- ellipsis: (d)=>d && d.length ? `${d}...` : "",
208
+ ellipsis: axisLabelEllipsis,
209
+ // A label measured cut short mid-word (see `cutLabel`) is drawn so.
210
+ truncateWord: (d)=>!!(d.cut !== undefined ? d : d.data)?.cut,
202
211
  // Slanted labels wrap between words, as they were measured.
203
212
  ...axis._labelRotation && axis._labelSlant ? {
204
213
  split: wholeWordSplit
@@ -214,6 +223,11 @@ const maxTimezoneOffset = 1000 * 60 * 60 * 26;
214
223
  // v4 scene-only: tick shape stays compute-mode; toScene() composes ticks.
215
224
  // No `g.ticks` DOM wrapper needed in the detached compute.
216
225
  axis._tickShape.config(configPrep.bind(axis)(axis.schema.shapeConfig)).labelConfig({
226
+ // Each label is painted with the line height it was measured with.
227
+ lineHeight: (d, i)=>{
228
+ const datum = d.lineHeight !== undefined ? d : d.data;
229
+ return typeof datum?.lineHeight === "number" ? datum.lineHeight : labelLineHeight(axis.schema.shapeConfig, datum?.id, i);
230
+ },
217
231
  padding: 0
218
232
  }).render();
219
233
  }
@@ -229,11 +243,9 @@ const maxTimezoneOffset = 1000 * 60 * 60 * 26;
229
243
  // Title TextBox runs in compute mode regardless. When there's no
230
244
  // parent group (standaloneCompute path above), skip the title's
231
245
  // DOM mount — its scene comes via toScene() anyway.
232
- axis._titleClass.renderMode("compute").data(axis.schema.title ? [
233
- {
234
- text: axis.schema.title
235
- }
236
- ] : []).duration(axis.schema.duration).height(margin[axis.schema.orient]).rotate(axis.schema.orient === "left" ? -90 : axis.schema.orient === "right" ? 90 : 0).select(!group ? null : elem("g.d3plus-Axis-title", {
246
+ axis._titleClass.renderMode("compute").duration(axis.schema.duration).select(!group ? null : elem("g.d3plus-Axis-title", {
237
247
  parent: group
238
- }).node()).text((d)=>d.text).verticalAlign("middle").width(range[range.length - 1] - range[0]).x(horizontal ? range[0] : axis.schema.orient === "left" ? bounds.x + margin.left / 2 - (range[range.length - 1] - range[0]) / 2 : bounds.x + bounds.width - margin.right / 2 - (range[range.length - 1] - range[0]) / 2).y(horizontal ? axis.schema.orient === "bottom" ? bounds.y + bounds.height - margin.bottom : bounds.y : range[0] + (range[range.length - 1] - range[0]) / 2 - margin[axis.schema.orient] / 2).config(configPrep.bind(axis)(axis.schema.titleConfig)).render();
248
+ }).node()).x(horizontal ? range[0] : axis.schema.orient === "left" ? bounds.x + margin.left / 2 - (range[range.length - 1] - range[0]) / 2 : bounds.x + bounds.width - margin.right / 2 - (range[range.length - 1] - range[0]) / 2).y(horizontal ? axis.schema.orient === "bottom" ? bounds.y + bounds.height - margin.bottom : bounds.y : range[0] + (range[range.length - 1] - range[0]) / 2 - margin[axis.schema.orient] / 2);
249
+ // Wrapped as it was measured (see `titleRoom`), in the room it claimed.
250
+ configureTitle(axis._titleClass, axis, range, margin[axis.schema.orient]).render();
239
251
  }
@@ -3,7 +3,7 @@
3
3
  widens or narrows a linear or log domain to "nice" values. Pure.
4
4
 
5
5
  @module
6
- */ import { max } from "d3-array";
6
+ */ import { extent, max } from "d3-array";
7
7
  /** Whether `d` is negative, counting -0. */ export const isNegative = (d)=>d < 0 || Object.is(d, -0);
8
8
  /** The power of ten at or below `|d|`, carrying `d`'s sign. */ export const floorPow = (d)=>Math.pow(10, Math.floor(Math.log10(Math.abs(d)))) * Math.pow(-1, isNegative(d) ? 1 : 0);
9
9
  /** The power of ten at or above `|d|`, carrying `d`'s sign. */ export const ceilPow = (d)=>Math.pow(10, Math.ceil(Math.log10(Math.abs(d)))) * Math.pow(-1, isNegative(d) ? 1 : 0);
@@ -77,3 +77,18 @@
77
77
  }
78
78
  return undefined;
79
79
  }
80
+ /**
81
+ The open end of an axis rounded "inside" that the value `d` labels, if
82
+ any: "min" when `d` is the lowest of the `values` the axis labels and
83
+ the `domain` reaches down to it, "max" when it is the highest and the
84
+ domain reaches up to it. A value beyond the domain has nothing past it,
85
+ so it is not open-ended.
86
+ */ export function openEnd(d, values, domain) {
87
+ const value = Number(d);
88
+ const [low, high] = extent(values, Number);
89
+ const [from, to] = extent(domain, Number);
90
+ if (low === undefined || from === undefined) return undefined;
91
+ if (value === low && from <= low) return "min";
92
+ if (value === high && to >= high) return "max";
93
+ return undefined;
94
+ }
@@ -2,6 +2,7 @@
2
2
  The axis's backend-agnostic scene: gridlines and the domain bar emitted
3
3
  natively, composed with the tick Shape's and title TextBox's scenes.
4
4
  */ import { axisBarNodes } from "./axisBreak.js";
5
+ import { stampTickTooltips, stampTitleTooltip, tickRank } from "./axisTooltipTargets.js";
5
6
  /**
6
7
  Converts an attribute-style config (e.g. gridConfig, barConfig) into a Paint.
7
8
  @private
@@ -151,13 +152,21 @@
151
152
  const lbl = axis._tickShape._labelClass;
152
153
  if (lbl && typeof lbl.toScene === "function" && lbl._data && lbl._data.length) {
153
154
  const lblScene = lbl.toScene();
154
- if (lblScene && Array.isArray(lblScene.children)) children.push(...lblScene.children);
155
+ if (lblScene && Array.isArray(lblScene.children)) {
156
+ const labels = lblScene.children;
157
+ stampTickTooltips(labels, axis.schema.tickTooltip, tickRank(axis));
158
+ children.push(...labels);
159
+ }
155
160
  }
156
161
  }
157
162
  const bar = barLinePoints(axis);
158
163
  if (bar) children.push(...axisBarNodes(axis, bar.points, (cfg)=>configToPaint(axis, cfg)));
159
164
  if (axis._titleClass && typeof axis._titleClass.toScene === "function" && axis._titleClass._data && axis._titleClass._data.length) {
160
- children.push(axis._titleClass.toScene());
165
+ const title = axis._titleClass.toScene();
166
+ stampTitleTooltip([
167
+ title
168
+ ], axis.schema.title, axis.schema.titleTooltip);
169
+ children.push(title);
161
170
  }
162
171
  // The axis was placed inside a container the caller positioned (e.g. Plot's
163
172
  // xGroup); preserve that placement on the scene root.
@@ -0,0 +1,53 @@
1
+ /**
2
+ The axis title, configured once for both the measure and the paint, so
3
+ the title claims exactly the room it draws.
4
+ */ import { fontExists, parseSides, textWidth } from "@d3plus/dom";
5
+ import { softHyphen } from "@d3plus/text";
6
+ import TextBox from "../TextBox.js";
7
+ import { configPrep } from "../../utils/index.js";
8
+ /**
9
+ Whether the first word of `box`'s text is wider than its line on its
10
+ own, as the wrap measures it. The wrap can't place such a word on any
11
+ line, so the box would draw nothing.
12
+ */ export function firstWordOverflows(box, d, i) {
13
+ const text = box.schema.text(d, i);
14
+ if (text === undefined) return false;
15
+ const [first] = box.schema.split(`${text}`.trim(), i);
16
+ if (!first) return false;
17
+ // A syllable ending in a soft hyphen is drawn with a hyphen at a break.
18
+ const word = first.endsWith(softHyphen) ? `${first.slice(0, -1)}-` : first;
19
+ const padding = parseSides(box.schema.padding(d, i));
20
+ const width = textWidth(word, {
21
+ "font-family": fontExists(box.schema.fontFamily(d, i)),
22
+ "font-size": box.schema.fontSize(d, i),
23
+ "font-weight": box.schema.fontWeight(d, i)
24
+ });
25
+ return width > box.schema.width(d, i) - padding.left - padding.right;
26
+ }
27
+ /**
28
+ Configures `box` as the axis title wrapped across `range`, in a box
29
+ `height` tall: its text, width, rotation, and `titleConfig`. A first
30
+ word too wide for the axis is cut mid-word with the ellipsis
31
+ (`truncateWord`), so the title still draws; any other title cut short
32
+ ends at a word break. A `truncateWord` in `titleConfig` overrides both.
33
+ A title left out (see `measureAxis` in `axisLimit.ts`) has no data, so
34
+ draws nothing.
35
+ */ export function configureTitle(box, axis, range, height) {
36
+ const { orient } = axis.schema;
37
+ return box.data(axis.schema.title && !axis._dropTitle ? [
38
+ {
39
+ text: axis.schema.title
40
+ }
41
+ ] : []).height(height).rotate(orient === "left" ? -90 : orient === "right" ? 90 : 0).text((d)=>d.text).verticalAlign("middle").width(range[range.length - 1] - range[0]).truncateWord((d, i)=>firstWordOverflows(box, d, i)).config(configPrep.bind(axis)(axis.schema.titleConfig));
42
+ }
43
+ /**
44
+ The room the axis title claims on the axis's side: its lines as the
45
+ title TextBox wraps them across `range`, within `height`, to the whole
46
+ pixel, plus the axis's padding. A title that draws nothing claims no
47
+ room.
48
+ */ export function titleRoom(axis, range, height) {
49
+ const box = configureTitle(new TextBox().renderMode("compute"), axis, range, height);
50
+ const [datum] = box._textData();
51
+ if (!datum?.lines.some((line)=>line)) return 0;
52
+ return Math.ceil(datum.lines.length * datum.lH) + axis.schema.padding;
53
+ }
@@ -0,0 +1,128 @@
1
+ /**
2
+ What an axis's title and tick labels carry for a chart's axis tooltips
3
+ (see `charts/features/axisTooltip.ts`): each label's scene nodes are
4
+ stamped with the label's value, its whole text, whether it is drawn cut
5
+ short, and the axis's `titleTooltip` or `tickTooltip`. A label no tooltip
6
+ could show for is left unstamped.
7
+ */ /**
8
+ The axis label a scene node was stamped as, if any.
9
+ @param node A picked scene node.
10
+ */ export function axisTooltipTarget(node) {
11
+ return node?.axisTooltip;
12
+ }
13
+ /** `text` without its whitespace, which a wrap moves between lines. */ const solid = (text)=>text.replace(/\s+/g, "");
14
+ /**
15
+ Whether a text node draws less than `text`: its layout cut it short (see
16
+ `TextNode.truncated`) and its lines don't spell the whole text.
17
+ @param node A label's scene node.
18
+ @param text The label's whole text.
19
+ */ export function labelCut(node, text) {
20
+ if (node.type !== "text" || !node.truncated) return false;
21
+ return solid(node.lines.map((line)=>line.text).join("")) !== solid(text);
22
+ }
23
+ /**
24
+ Whether a label with `option` for its tooltip option could show one.
25
+ @param option An axis's `titleTooltip` or `tickTooltip`.
26
+ @param truncated Whether the label is drawn cut short.
27
+ */ export const canShow = (option, truncated)=>option !== false && (truncated || option !== undefined && option !== null);
28
+ /** Every node of a scene subtree, depth-first. */ function flatten(nodes) {
29
+ return nodes.flatMap((node)=>[
30
+ node,
31
+ ...flatten(node.children ?? [])
32
+ ]);
33
+ }
34
+ /** The tick config a label node's datum wraps, if the node is a tick label. */ function tickOf(node) {
35
+ const tick = node.datum?.data;
36
+ return tick && typeof tick === "object" && "tick" in tick && "id" in tick ? tick : undefined;
37
+ }
38
+ /** The scales whose domain lists categories. */ const CATEGORICAL = [
39
+ "band",
40
+ "ordinal",
41
+ "point"
42
+ ];
43
+ /** A category as a map key: a date by its time. */ const category = (value)=>value instanceof Date ? +value : value;
44
+ /**
45
+ Where a tick's value falls along an axis's domain, counted from the
46
+ domain's start: the lowest value of a value or time axis, the first
47
+ category of a categorical one (its last when the axis holds its domain
48
+ end first). Neither `reverse` nor a descending domain moves a value's
49
+ place.
50
+ @param axis A laid-out axis.
51
+ */ export function tickRank(axis) {
52
+ if (!CATEGORICAL.includes(`${axis.schema.scale}`)) return (value)=>Number(value);
53
+ const domain = axis._givenDomain().slice();
54
+ if (axis._domainEndFirst) domain.reverse();
55
+ const places = new Map(domain.map((d, i)=>[
56
+ category(d),
57
+ i
58
+ ]));
59
+ return (value)=>places.get(category(value)) ?? domain.length;
60
+ }
61
+ /**
62
+ Stamps an axis's tick label nodes (each label's text, and its hitbox when
63
+ it has one) with their tooltip target.
64
+ @param nodes The tick labels' scene nodes.
65
+ @param option The axis's `tickTooltip`.
66
+ @param rank Each tick value's place along the axis (see `tickRank`):
67
+ labels are indexed in that order, or in the order of `nodes` without it.
68
+ */ export function stampTickTooltips(nodes, option, rank) {
69
+ if (option === false) return;
70
+ const all = flatten(nodes);
71
+ const targets = new Map();
72
+ for (const node of all){
73
+ const tick = tickOf(node);
74
+ if (node.type !== "text" || !tick || targets.has(node.datum)) continue;
75
+ const text = `${tick.text}`;
76
+ targets.set(node.datum, {
77
+ part: "tick",
78
+ value: tick.id,
79
+ index: 0,
80
+ text,
81
+ truncated: labelCut(node, text),
82
+ option
83
+ });
84
+ }
85
+ const ordered = Array.from(targets.values());
86
+ if (rank) ordered.sort((a, b)=>rank(a.value) - rank(b.value));
87
+ ordered.forEach((target, index)=>target.index = index);
88
+ for (const node of all){
89
+ const target = targets.get(node.datum);
90
+ if (target && canShow(option, target.truncated)) node.axisTooltip = target;
91
+ }
92
+ }
93
+ /**
94
+ Stamps an axis's title nodes with their tooltip target.
95
+ @param nodes The title's scene nodes.
96
+ @param title The axis's title.
97
+ @param option The axis's `titleTooltip`.
98
+ */ export function stampTitleTooltip(nodes, title, option) {
99
+ if (option === false) return;
100
+ const all = flatten(nodes);
101
+ const text = `${title}`;
102
+ const truncated = all.some((node)=>labelCut(node, text));
103
+ if (!canShow(option, truncated)) return;
104
+ const target = {
105
+ part: "title",
106
+ value: title,
107
+ index: 0,
108
+ text,
109
+ truncated,
110
+ option
111
+ };
112
+ for (const node of all)if (node.datum !== undefined) node.axisTooltip = target;
113
+ }
114
+ /**
115
+ An axis's scene as chrome under a chart's marks: every node takes the
116
+ "axis" interaction group, and each one that draws leaves hit-testing
117
+ unless it is stamped with a tooltip target, so the pointer reaches the
118
+ axis only on a label with a tooltip to show.
119
+ @param node An axis's scene, or a node in it.
120
+ */ export function inertAxis(node) {
121
+ const next = {
122
+ ...node,
123
+ interactionGroup: "axis"
124
+ };
125
+ if (next.type === "group") next.children = next.children.map(inertAxis);
126
+ else if (!next.axisTooltip) next.interactive = false;
127
+ return next;
128
+ }