@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
@@ -5,7 +5,8 @@ import { Axis } from "../index.js";
5
5
  import { constant } from "../../utils/index.js";
6
6
  import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
7
7
  import { fitBrush, timelineBrushSpan } from "./brushSpan.js";
8
- import { byValue, initTimelineDefaults } from "./timelineConfig.js";
8
+ import { brushOverlayCursor, byValue, initTimelineDefaults } from "./timelineConfig.js";
9
+ import { classTimelineMode } from "./timelineMode.js";
9
10
  import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, renderPlayButton, setupBrush } from "./timelineRender.js";
10
11
  /** Timeline's fluent accessor schema. Config storage lives on `this.schema.<key>`. */ const timelineSchema = [
11
12
  {
@@ -13,6 +14,11 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
13
14
  coerce: "identity",
14
15
  default: 10
15
16
  },
17
+ {
18
+ key: "brushCursor",
19
+ coerce: "identity",
20
+ default: "pointer"
21
+ },
16
22
  {
17
23
  key: "brushing",
18
24
  coerce: "identity",
@@ -74,6 +80,7 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
74
80
  /**
75
81
  Creates an interactive timeline brush component for selecting time periods within a visualization.
76
82
  */ export default class Timeline extends Axis {
83
+ static _displayName = "Timeline";
77
84
  _buttonBehaviorCurrent;
78
85
  _hiddenHandles;
79
86
  _playButtonClass;
@@ -162,8 +169,9 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
162
169
  // would animate from d3-brush's internal drag bounds (the anchored edge), so
163
170
  // the lone handle would jump back to where the drag began and slide to the
164
171
  // release point; duration 0 applies the final period on the first frame.
172
+ // A timeline without a duration (reduced motion) snaps too.
165
173
  const move = this._brushGroup.transition(this._transition);
166
- if (!this.schema.brushing) move.duration(0);
174
+ if (!this.schema.brushing || !this.schema.duration) move.duration(0);
167
175
  move.call(this._brush.move, this._updateBrushLimit(domain));
168
176
  if (this.schema.on.end) this.schema.on.end(this.schema.selection);
169
177
  }
@@ -218,7 +226,7 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
218
226
  const sw = +brushSelection.attr("width") || 0;
219
227
  brushHandle.filter((d)=>d.type === "e").attr("x", sx + sw / 2 - this.schema.handleSize / 2);
220
228
  }
221
- this._brushGroup.selectAll(".overlay").attr("x", this._paddingLeft).attr("cursor", "pointer").attr("transform", `translate(0,${this._buttonBehaviorCurrent === "buttons" ? this.schema.buttonHeight / 2 : -this.schema.handleSize})`).attr("width", this._buttonBehaviorCurrent === "buttons" ? this._ticksWidth : this.schema.width).attr("height", this._buttonBehaviorCurrent === "buttons" ? this.schema.buttonHeight : this.schema.handleSize * 2);
229
+ this._brushGroup.selectAll(".overlay").attr("x", this._paddingLeft).attr("cursor", brushOverlayCursor(this)).attr("transform", `translate(0,${this._buttonBehaviorCurrent === "buttons" ? this.schema.buttonHeight / 2 : -this.schema.handleSize})`).attr("width", this._buttonBehaviorCurrent === "buttons" ? this._ticksWidth : this.schema.width).attr("height", this._buttonBehaviorCurrent === "buttons" ? this.schema.buttonHeight : this.schema.handleSize * 2);
222
230
  if (this._buttonBehaviorCurrent === "buttons") {
223
231
  const yTransform = this.schema.align === "middle" ? this.schema.height / 2 - this.schema.buttonHeight / 2 : this.schema.align === "start" ? this._margin.top : this.schema.height - this.schema.buttonHeight - this._margin.bottom;
224
232
  brushHandle.attr("y", yTransform);
@@ -419,6 +427,7 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
419
427
  super.render(callback);
420
428
  setupBrush(this, hiddenHandles, height, y);
421
429
  renderPlayButton(this, playButtonWidth);
430
+ classTimelineMode(this._group?.node(), "d3plus-Timeline", this._buttonBehaviorCurrent);
422
431
  // Standalone (non-Viz) use: a parent Viz normally composes the timeline's
423
432
  // scene via toScene(), but on its own `_managesOwnScenePaint` made
424
433
  // Axis.render() skip the paint, leaving only the brush/play DOM. Paint the
@@ -1,7 +1,13 @@
1
- import { colorContrast } from "@d3plus/color";
2
- import { assign, backgroundColor } from "@d3plus/dom";
1
+ import { assign } from "@d3plus/dom";
2
+ import { inkBackground, inkText } from "../../utils/themeInk.js";
3
+ import { themed } from "../../utils/theme.js";
3
4
  import TextBox from "../TextBox.js";
4
5
  const colorMid = "#bbb";
6
+ const accentDefault = "#228be6";
7
+ /** A button's fill: white, or the theme's background once it is forced or dark. */ function buttonFill(tl) {
8
+ return tl._theme?.painted || tl._theme?.dark ? inkBackground(tl) : "#fff";
9
+ }
10
+ /** The selection and handle color: the theme's `accent`. */ const accent = (tl)=>()=>themed(tl._theme, (t)=>t.accent, accentDefault);
5
11
  /**
6
12
  A copy of `values` (dates, years or pixel positions) in ascending order.
7
13
  A `reverse` timeline lays its ticks out from latest to earliest, but its
@@ -9,6 +15,13 @@ const colorMid = "#bbb";
9
15
  */ export function byValue(values) {
10
16
  return values.slice().sort((a, b)=>Number(a) - Number(b));
11
17
  }
18
+ /**
19
+ The brush overlay's cursor: `brushCursor`, or what it returns when given
20
+ the presentation drawn (`"ticks"` or `"buttons"`).
21
+ */ export function brushOverlayCursor(tl) {
22
+ const cursor = tl.schema.brushCursor;
23
+ return typeof cursor === "function" ? cursor(tl._buttonBehaviorCurrent) : cursor ?? null;
24
+ }
12
25
  /**
13
26
  Builds the play/pause TextBox. The button's visual is composed into the
14
27
  scene in compute mode; its click is wired to `Timeline._togglePlay` via a
@@ -26,14 +39,11 @@ const colorMid = "#bbb";
26
39
  height: tl.schema.buttonHeight
27
40
  } : d.labelBounds,
28
41
  labelConfig: {
29
- fontColor: ()=>{
30
- const bg = tl._select ? backgroundColor(tl._select.node()) : "rgb(255, 255, 255)";
31
- return colorContrast(bg, tl.schema.colorDefaults);
32
- },
42
+ fontColor: ()=>inkText(tl),
33
43
  fontSize: ()=>12,
34
44
  verticalAlign: ()=>tl._buttonBehaviorCurrent === "buttons" ? "middle" : "top"
35
45
  },
36
- fill: ()=>tl._buttonBehaviorCurrent === "buttons" ? "#fff" : colorMid,
46
+ fill: ()=>tl._buttonBehaviorCurrent === "buttons" ? buttonFill(tl) : colorMid,
37
47
  stroke: ()=>tl._buttonBehaviorCurrent === "buttons" ? colorMid : "transparent",
38
48
  height: (d)=>tl._buttonBehaviorCurrent === "buttons" ? tl.schema.buttonHeight : d.tick ? tl.schema.handleSize : 0,
39
49
  width: (d)=>tl._buttonBehaviorCurrent === "buttons" ? tl._ticksWidth / tl._availableTicks.length : d.tick ? tl.schema.domain.map(Number).includes(d.id) ? 2 : 1 : 0,
@@ -57,7 +67,7 @@ const colorMid = "#bbb";
57
67
  tl.schema.gridSize = 0;
58
68
  tl.schema.handleConfig = {
59
69
  fill: ()=>tl.schema.colorDefaults.light,
60
- stroke: "#228be6",
70
+ stroke: accent(tl),
61
71
  "stroke-width": 2,
62
72
  rx: 2,
63
73
  ry: 2
@@ -69,14 +79,14 @@ const colorMid = "#bbb";
69
79
  tl.orient("bottom");
70
80
  tl._playButtonClass = buildPlayButton();
71
81
  tl.schema.playButtonConfig = {
72
- fontColor: ()=>tl.schema.colorDefaults.dark,
82
+ fontColor: ()=>inkText(tl),
73
83
  fontSize: 15,
74
84
  text: ()=>tl._playTimer ? "\u23F8" : "\u23F5",
75
85
  textAnchor: "middle",
76
86
  verticalAlign: "middle"
77
87
  };
78
88
  tl.schema.selectionConfig = {
79
- fill: "#228be6",
89
+ fill: accent(tl),
80
90
  "fill-opacity": ()=>tl._buttonBehaviorCurrent === "buttons" ? 0.3 : 1,
81
91
  "stroke-width": 0
82
92
  };
@@ -0,0 +1,26 @@
1
+ /** How a Timeline draws its periods: tick marks along an axis, or a row of buttons. */ const MODES = [
2
+ "ticks",
3
+ "buttons"
4
+ ];
5
+ /**
6
+ The class naming how a Timeline is drawn, `<prefix>-ticks` or
7
+ `<prefix>-buttons`, or none before it resolves a mode.
8
+ @param prefix The element's own class, such as `d3plus-viz-timeline`.
9
+ @param mode The Timeline's resolved `buttonBehavior`.
10
+ */ export function timelineModeClass(prefix, mode) {
11
+ return MODES.includes(mode) ? `${prefix}-${mode}` : null;
12
+ }
13
+ /**
14
+ Adds `timelineModeClass(prefix, mode)` to `el` and removes the other
15
+ mode's class, so the element names the presentation drawn last.
16
+ @param el The element to mark.
17
+ @param prefix The element's own class.
18
+ @param mode The Timeline's resolved `buttonBehavior`.
19
+ */ export function classTimelineMode(el, prefix, mode) {
20
+ if (!el) return;
21
+ const current = timelineModeClass(prefix, mode);
22
+ for (const m of MODES){
23
+ const name = `${prefix}-${m}`;
24
+ el.classList.toggle(name, name === current);
25
+ }
26
+ }
@@ -9,6 +9,7 @@ import { SvgRenderer } from "@d3plus/render";
9
9
  import { textWrap } from "@d3plus/text";
10
10
  import { configPrep } from "../../utils/index.js";
11
11
  import { applyClassName } from "../../utils/className.js";
12
+ import { labelLineHeight } from "../Axis/axisLabelLineHeight.js";
12
13
  import { parseTimeValues } from "../Axis/timeValues.js";
13
14
  import { nearestIndex, spanIndices, timelineBrushSpan } from "./brushSpan.js";
14
15
  import { byValue } from "./timelineConfig.js";
@@ -90,7 +91,7 @@ import { byValue } from "./timelineConfig.js";
90
91
  ticks.forEach((d, i)=>{
91
92
  const { fontFamily, fontSize } = tl.schema.shapeConfig.labelConfig;
92
93
  const f = typeof fontFamily === "function" ? fontFamily(d, i) : fontFamily, s = typeof fontSize === "function" ? fontSize(d, i) : fontSize;
93
- const wrap = textWrap().fontFamily(f).fontSize(s).lineHeight(tl.schema.shapeConfig.lineHeight ? tl.schema.shapeConfig.lineHeight(d, i) : undefined);
94
+ const wrap = textWrap().fontFamily(f).fontSize(s).lineHeight(labelLineHeight(tl.schema.shapeConfig, d, i, s));
94
95
  const res = wrap(tickFormat(d));
95
96
  let width = res.lines.length ? Math.ceil(max(res.lines.map((line)=>textWidth(line, {
96
97
  "font-family": f,
@@ -108,8 +109,9 @@ import { byValue } from "./timelineConfig.js";
108
109
  const hiddenHandles = tl._hiddenHandles = tl._buttonBehaviorCurrent === "buttons" && !tl.schema.brushing;
109
110
  if (tl._buttonBehaviorCurrent === "buttons") {
110
111
  tl.schema.scale = "ordinal";
111
- const domain = scaleTime().domain(tl.schema.domain.map(date)).ticks().map(Number);
112
- tl.schema.domain = tl.schema.ticks ? tl.schema.ticks : Array.from(Array(domain[domain.length - 1] - domain[0] + 1), (_, x)=>domain[0] + x).map(date);
112
+ // One button per tick: the `ticks` given, or the time scale's own (the
113
+ // ones `measureTicksWidth` sized the buttons for).
114
+ tl.schema.domain = tl.schema.ticks ? tl.schema.ticks : ticks;
113
115
  tl.schema.ticks = tl.schema.domain;
114
116
  const buttonMargin = 0.5 * tl._ticksWidth / tl.schema.ticks.length;
115
117
  const emptySpace = tl.schema.width - tl._ticksWidth - playButtonWidth;
@@ -205,7 +207,10 @@ import { byValue } from "./timelineConfig.js";
205
207
  tl._brushGroup = elem("g.brushGroup", {
206
208
  parent: tl._group
207
209
  });
208
- tl._brushGroup.call(brush).transition(tl._transition).call(brush.move, tl._buttonBehaviorCurrent === "ticks" ? tl._updateBrushLimit(selection) : selection);
210
+ const brushMove = tl._brushGroup.call(brush).transition(tl._transition);
211
+ // Without a duration (reduced motion), the brush jumps to the selection.
212
+ if (!tl.schema.duration) brushMove.duration(0);
213
+ brushMove.call(brush.move, tl._buttonBehaviorCurrent === "ticks" ? tl._updateBrushLimit(selection) : selection);
209
214
  tl._outerBounds.y -= tl.schema.handleSize / 2;
210
215
  tl._outerBounds.height += tl.schema.handleSize / 2;
211
216
  }
@@ -5,8 +5,17 @@ import { resetInjectedBoxes } from "@d3plus/render";
5
5
  import { fontFamily, fontFamilyStringify } from "@d3plus/text";
6
6
  import { accessor, BaseClass, constant } from "../utils/index.js";
7
7
  import { setUserClasses } from "../utils/className.js";
8
+ import { themed, themeLight } from "../utils/theme.js";
8
9
  import { installFluent, mergeConfigBag, resolvesReset } from "../fluent.js";
9
10
  import { bindTooltips, buildTable, divElement, resolvePortal, TOOLTIP_SELECTORS } from "./tooltipDom.js";
11
+ /** The tooltip colors of the theme of the chart showing it (light when shown alone). */ const tokens = (t)=>(t._theme ?? themeLight).tooltip;
12
+ /**
13
+ The tooltip's text: the theme's while the fill is the theme's own, and
14
+ otherwise whichever of `colorDefaults`' dark and light reads on the fill.
15
+ */ function tooltipText(t, background) {
16
+ const contrast = colorContrast(background, t.schema.colorDefaults);
17
+ return t._theme && background === t._theme.tooltip.background ? themed(t._theme, (x)=>x.tooltip.text, contrast) : contrast;
18
+ }
10
19
  /** Tooltip's fluent accessor schema. Config storage lives on `this.schema.<key>`. */ /** Every tooltip element's fixed class; `className` adds classes beside it. */ const TOOLTIP_CLASS = "d3plus-tooltip";
11
20
  const tooltipSchema = [
12
21
  {
@@ -17,7 +26,7 @@ const tooltipSchema = [
17
26
  {
18
27
  key: "background",
19
28
  coerce: "const",
20
- factory: (t)=>()=>t.schema.colorDefaults.light
29
+ factory: (t)=>()=>themed(t._theme, (x)=>x.tooltip.background, t.schema.colorDefaults.light)
21
30
  },
22
31
  {
23
32
  key: "body",
@@ -27,7 +36,7 @@ const tooltipSchema = [
27
36
  {
28
37
  key: "border",
29
38
  coerce: "const",
30
- default: constant("1px solid rgba(0, 0, 0, 0.25)")
39
+ factory: (t)=>()=>`1px solid ${tokens(t).border}`
31
40
  },
32
41
  {
33
42
  key: "borderRadius",
@@ -103,6 +112,7 @@ const tooltipSchema = [
103
112
  /**
104
113
  Creates HTML tooltips in the body of a webpage.
105
114
  */ export default class Tooltip extends BaseClass {
115
+ static _displayName = "Tooltip";
106
116
  _data;
107
117
  /** v4: optional per-chart parent element (default: global #d3plus-portal). */ _parentEl;
108
118
  /**
@@ -166,12 +176,12 @@ const tooltipSchema = [
166
176
  "text-align": "center"
167
177
  };
168
178
  this.schema.tooltipStyle = {
169
- "box-shadow": "0 1px 5px rgba(0, 0, 0, 0.25)",
170
- color: (d, i)=>colorContrast(this.schema.background(d, i), this.schema.colorDefaults),
179
+ "box-shadow": ()=>tokens(this).shadow,
180
+ color: (d, i)=>tooltipText(this, this.schema.background(d, i)),
171
181
  "font-family": fontFamilyStringify(fontFamily)
172
182
  };
173
183
  this.schema.trStyle = {
174
- "border-top": (d, i)=>i ? "1px solid rgba(0, 0, 0, 0.1)" : "none"
184
+ "border-top": (d, i)=>i ? `1px solid ${tokens(this).divider}` : "none"
175
185
  };
176
186
  // First column (labels) left-aligned, value columns right-aligned.
177
187
  const cellAlign = (_d, i)=>i ? "right" : "left";
@@ -0,0 +1,20 @@
1
+ import { fontFamilyStringify } from "@d3plus/text";
2
+ /** A family name without the quotes CSS lets it carry. */ const unquote = (family)=>family.trim().replace(/^(['"])(.*)\1$/, "$2");
3
+ /**
4
+ The CSS `font-family` a label is drawn with: the family its layout measured
5
+ (the first one in the configured list that is installed), then the families
6
+ listed after it. A renderer without the measured family then falls back
7
+ down the same list rather than to its default font, as when a chart drawn
8
+ on a server is opened in a browser that has different fonts.
9
+ @param configured The label's configured families, as an Array or a CSS list.
10
+ @param measured The family the layout measured with, from `fontExists`, or `false` when none was found.
11
+ */ export function fontStack(configured, measured) {
12
+ const list = (Array.isArray(configured) ? configured : configured.split(",")).map(unquote).filter(Boolean);
13
+ if (!measured) return fontFamilyStringify(list);
14
+ const family = unquote(measured);
15
+ const at = list.indexOf(family);
16
+ return fontFamilyStringify(at < 0 ? [
17
+ family,
18
+ ...list
19
+ ] : list.slice(at));
20
+ }
@@ -5,6 +5,9 @@
5
5
  */ import { max, min, sum } from "d3-array";
6
6
  import { fontExists, parseSides, textWidth } from "@d3plus/dom";
7
7
  import { textWrap } from "@d3plus/text";
8
+ import { fontStack } from "./fontStack.js";
9
+ import { hitboxPadding, textBoxPath, textBoxRoom } from "./textBoxPath.js";
10
+ import { justifyWords } from "./textBoxWords.js";
8
11
  /** Parses a "style: foo; …" string from defaultHtmlLookup into TextRun style. */ function parseStyleString(styleStr) {
9
12
  const out = {};
10
13
  for (const decl of styleStr.split(";")){
@@ -107,41 +110,68 @@ import { textWrap } from "@d3plus/text";
107
110
  return fS;
108
111
  }
109
112
  /** Assembles the final TextBoxDatum from the resolved layout values. */ function assembleTextBoxDatum(box, d, i, layout) {
110
- const { lineData, line, fS, lH, w, h, vA, style, widths, truncated, padding } = layout;
113
+ const { lineData, line, fS, lH, w, h, vA, style, wrap, kept, padding, path } = layout;
111
114
  const tH = line * lH;
112
115
  const r = box.schema.rotate(d, i);
113
- let yP = r === 0 ? vA === "top" ? 0 : vA === "middle" ? h / 2 - tH / 2 : h - tH : 0;
114
- yP -= lH * 0.1;
116
+ let yP = path || r === 0 ? vA === "top" ? 0 : vA === "middle" ? h / 2 - tH / 2 : h - tH : 0;
117
+ if (path) yP = 0;
118
+ else yP -= lH * 0.1;
115
119
  // Pre-compute per-line runs from HTML markup, carrying open-tag state
116
120
  // across lines so a multi-line <b> continues to bold subsequent lines.
117
121
  const lineRuns = buildLineRuns(box, lineData);
122
+ const tA = box.schema.textAnchor(d, i);
123
+ // A line the wrap didn't produce (the ellipsis drawn when nothing fit) has
124
+ // no wrap data, so it reads as a plain, paragraph-ending line.
125
+ const wrapped = kept.length === lineData.length;
126
+ const pick = (arr, fallback)=>lineData.map((_, l)=>wrapped ? arr[kept[l]] ?? fallback : fallback);
118
127
  return {
119
128
  aH: box.schema.ariaHidden(d, i),
120
129
  data: d,
121
130
  i,
122
131
  lines: lineData,
123
132
  lineRuns,
133
+ hardBreaks: pick(wrap.hardBreaks, true),
134
+ lineWords: tA === "justify" ? justifyWords(pick(wrap.lineWords, []), lineRuns, style) : null,
124
135
  fC: box.schema.fontColor(d, i),
125
136
  fStroke: box.schema.fontStroke(d, i),
126
137
  fSW: box.schema.fontStrokeWidth(d, i),
127
- fF: style["font-family"],
138
+ fF: fontStack(box.schema.fontFamily(d, i), style["font-family"]),
128
139
  fO: box.schema.fontOpacity(d, i),
129
140
  fW: style["font-weight"],
130
141
  id: box.schema.id(d, i),
131
142
  pE: box.schema.pointerEvents(d, i),
132
- tA: box.schema.textAnchor(d, i),
143
+ tA,
133
144
  vA: box.schema.verticalAlign(d, i),
134
- widths,
135
- truncated,
145
+ widths: pick(wrap.widths, 0),
146
+ truncated: wrap.truncated,
136
147
  fS,
137
148
  lH,
138
149
  w,
139
150
  h,
140
151
  r,
141
- x: box.schema.x(d, i) + padding.left,
142
- y: box.schema.y(d, i) + yP + padding.top
152
+ // Text on a path is placed by the path, relative to the box's x/y.
153
+ x: box.schema.x(d, i) + (path ? 0 : padding.left),
154
+ y: box.schema.y(d, i) + (path ? 0 : yP + padding.top),
155
+ path: path ? {
156
+ d: path.d,
157
+ side: path.side,
158
+ offset: path.offset
159
+ } : null,
160
+ pad: padding,
161
+ yP,
162
+ hit: hitboxPadding(box.schema.hitbox(d, i))
143
163
  };
144
164
  }
165
+ /** The wrap result of a box too small to wrap into. */ const EMPTY_WRAP = {
166
+ hardBreaks: [],
167
+ lines: [],
168
+ lineWords: [],
169
+ nextWord: 0,
170
+ sentence: "",
171
+ truncated: false,
172
+ widths: [],
173
+ words: []
174
+ };
145
175
  /**
146
176
  Computes the laid-out text box for a single data point, or null when the
147
177
  text is undefined or wraps to no visible lines.
@@ -152,11 +182,11 @@ import { textWrap } from "@d3plus/text";
152
182
  t = `${t}`.trim();
153
183
  const resize = box.schema.fontResize(d, i);
154
184
  const lHRatio = box.schema.lineHeight(d, i) / box.schema.fontSize(d, i);
155
- let fS = resize ? box.schema.fontMax(d, i) : box.schema.fontSize(d, i), lH = resize ? fS * lHRatio : box.schema.lineHeight(d, i), line = 1, lineData = [], wrapResults = {
156
- lines: [],
157
- truncated: false,
158
- widths: []
159
- };
185
+ let fS = resize ? box.schema.fontMax(d, i) : box.schema.fontSize(d, i), lH = resize ? fS * lHRatio : box.schema.lineHeight(d, i), line = 1, lineData = [], kept = [], wrapResults = EMPTY_WRAP;
186
+ // Text is measured with the one family fontExists finds installed, never a
187
+ // list: a list would measure with whichever family the browser picks, which
188
+ // can change under the wrap as web fonts load. Only the drawn label (`fF`)
189
+ // names the families after it, as fallbacks for other machines.
160
190
  const style = {
161
191
  "font-family": fontExists(box.schema.fontFamily(d, i)),
162
192
  "font-size": fS,
@@ -164,18 +194,21 @@ import { textWrap } from "@d3plus/text";
164
194
  "line-height": lH
165
195
  };
166
196
  const padding = parseSides(box.schema.padding(d, i));
167
- const h = box.schema.height(d, i) - (padding.top + padding.bottom), w = box.schema.width(d, i) - (padding.left + padding.right), shape = box.schema.shape(d, i);
168
- const wrapper = textWrap().fontFamily(style["font-family"]).fontSize(fS).fontWeight(style["font-weight"]).lineHeight(lH).maxLines(box.schema.maxLines(d, i)).height(h).overflow(box.schema.overflow(d, i)).shape(shape).width(w).split(box.schema.split);
197
+ const path = textBoxPath(box, d, i);
198
+ const { w, h } = textBoxRoom(box, d, i, padding, path, lH);
199
+ const shape = box.schema.shape(d, i);
200
+ const wrapper = textWrap().fontFamily(style["font-family"]).fontSize(fS).fontWeight(style["font-weight"]).lineHeight(lH).maxLines(path ? 1 : box.schema.maxLines(d, i)).height(h).overflow(box.schema.overflow(d, i)).shape(shape).width(w).split(box.schema.split).ellipsis((text, n)=>box.schema.ellipsis(text, n)).truncateWord(!!box.schema.truncateWord(d, i));
169
201
  const fMax = box.schema.fontMax(d, i), fMin = box.schema.fontMin(d, i), vA = box.schema.verticalAlign(d, i), words = box.schema.split(t, i);
170
202
  /**
171
203
  Figures out the lineData to be used for wrapping.
172
204
  @private
173
205
  */ function checkSize() {
206
+ // The wrap ends a truncated last line with the ellipsis itself, measured
207
+ // to fit; when nothing fit, the ellipsis decides what to draw instead.
174
208
  const truncate = ()=>{
175
209
  if (line < 1) lineData = [
176
210
  that.schema.ellipsis("", line)
177
211
  ];
178
- else lineData[line - 1] = that.schema.ellipsis(lineData[line - 1], line);
179
212
  };
180
213
  if (resize) {
181
214
  // fontMin/fontMax bound the resize search; a fixed fontSize is used as given.
@@ -193,7 +226,10 @@ import { textWrap } from "@d3plus/text";
193
226
  style["line-height"] = lH;
194
227
  }
195
228
  wrapResults = wrapper(t);
196
- lineData = wrapResults.lines.filter((l)=>l !== "");
229
+ kept = wrapResults.lines.flatMap((l, k)=>l !== "" ? [
230
+ k
231
+ ] : []);
232
+ lineData = kept.map((k)=>wrapResults.lines[k]);
197
233
  line = lineData.length;
198
234
  if (wrapResults.truncated) {
199
235
  if (resize) {
@@ -223,8 +259,9 @@ import { textWrap } from "@d3plus/text";
223
259
  h,
224
260
  vA,
225
261
  style,
226
- widths: wrapResults.widths,
227
- truncated: wrapResults.truncated,
228
- padding
262
+ wrap: wrapResults,
263
+ kept,
264
+ padding,
265
+ path
229
266
  });
230
267
  }
@@ -0,0 +1,73 @@
1
+ /**
2
+ TextBox options that change where its text sits: a path the text follows
3
+ (`textPath`, `startOffset`, `side`), and the transparent `hitbox` behind it.
4
+ */ import { parseSides } from "@d3plus/dom";
5
+ import { samplePath } from "@d3plus/render";
6
+ /**
7
+ Reads a `startOffset`: a distance in pixels, or a percentage of the path's
8
+ length, clamped to the path.
9
+ @param value The configured offset.
10
+ @param length The path's length.
11
+ */ export function resolveOffset(value, length) {
12
+ let px = 0;
13
+ if (typeof value === "number") px = value;
14
+ else if (typeof value === "string") {
15
+ const n = parseFloat(value);
16
+ if (Number.isFinite(n)) px = value.trim().endsWith("%") ? n / 100 * length : n;
17
+ }
18
+ return Math.max(0, Math.min(length, Number.isFinite(px) ? px : 0));
19
+ }
20
+ /**
21
+ The path a datum's text follows, or null when `textPath` gives none.
22
+ @param box The TextBox.
23
+ @param d The datum.
24
+ @param i Its index.
25
+ */ export function textBoxPath(box, d, i) {
26
+ const path = box.schema.textPath(d, i);
27
+ if (typeof path !== "string" || !path.trim()) return null;
28
+ const length = samplePath(path).total;
29
+ if (!length) return null;
30
+ return {
31
+ d: path,
32
+ side: box.schema.side(d, i) === "right" ? "right" : "left",
33
+ offset: resolveOffset(box.schema.startOffset(d, i), length),
34
+ length
35
+ };
36
+ }
37
+ /**
38
+ The room a datum's text wraps into: the box less its padding, or along a
39
+ path, the path from its start offset to its end (one line, which the
40
+ height always fits).
41
+ @param box The TextBox.
42
+ @param d The datum.
43
+ @param i Its index.
44
+ @param padding The box's padding.
45
+ @param path The path the text follows, if any.
46
+ @param lineHeight The line height the wrap starts at.
47
+ */ export function textBoxRoom(box, d, i, padding, path, lineHeight) {
48
+ const h = box.schema.height(d, i) - (padding.top + padding.bottom);
49
+ if (path) return {
50
+ w: path.length - path.offset,
51
+ h: Math.max(h, lineHeight + 1)
52
+ };
53
+ return {
54
+ w: box.schema.width(d, i) - (padding.left + padding.right),
55
+ h
56
+ };
57
+ }
58
+ /**
59
+ The extra room a `hitbox` config adds around the box, or null when the
60
+ box has no hitbox: `true` adds none, and `{padding}` takes a number or CSS
61
+ shorthand string.
62
+ @param value The configured hitbox.
63
+ */ export function hitboxPadding(value) {
64
+ if (!value) return null;
65
+ if (value === true) return {
66
+ top: 0,
67
+ right: 0,
68
+ bottom: 0,
69
+ left: 0
70
+ };
71
+ const padding = value.padding;
72
+ return parseSides(padding ?? 0);
73
+ }