@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
@@ -1,13 +1,25 @@
1
1
  import { deviation, extent, min, quantile, range } from "d3-array";
2
2
  import { interpolateRgb } from "d3-interpolate";
3
3
  import { scaleLinear, scaleThreshold } from "d3-scale";
4
- import { colorLighter, colorRamp } from "@d3plus/color";
4
+ import { colorLighter } from "@d3plus/color";
5
5
  import { unique } from "@d3plus/data";
6
6
  import { ckmeans } from "@d3plus/math";
7
+ import { themeRamp, themeScaleColor } from "../../utils/theme.js";
7
8
  import { resolveColorScaleType } from "./colorScaleType.js";
8
- /** The scale's poles, with unset ones taken from its `colorDefaults`. */ const colorMin = (cs)=>cs.schema.colorMin ?? cs.schema.colorDefaults.off;
9
- const colorMid = (cs)=>cs.schema.colorMid ?? cs.schema.colorDefaults.light;
10
- const colorMax = (cs)=>cs.schema.colorMax ?? cs.schema.colorDefaults.sequential;
9
+ /**
10
+ The scale's poles: unset ones come from the theme's `colorScale` tokens on
11
+ a dark or custom theme, and from its `colorDefaults` otherwise.
12
+ */ const colorMin = (cs)=>cs.schema.colorMin ?? themeScaleColor(cs._theme, "min", cs.schema.colorDefaults.off);
13
+ const colorMid = (cs)=>cs.schema.colorMid ?? themeScaleColor(cs._theme, "mid", cs.schema.colorDefaults.light);
14
+ const colorMax = (cs)=>cs.schema.colorMax ?? themeScaleColor(cs._theme, "max", cs.schema.colorDefaults.sequential);
15
+ /**
16
+ A single-hue low→high ramp toward `base` that reads on the scale's theme,
17
+ its palest step held darker on a light theme with `ordinalRamp`.
18
+ */ const ramp = (cs, base, n)=>themeRamp(cs._theme, base, n, Boolean(cs.schema.ordinalRamp) && !cs._theme?.dark);
19
+ /**
20
+ Steps a diverging pole `t` of the way back toward the midpoint: lighter on
21
+ a light theme, and mixed into the dark midpoint on a dark one.
22
+ */ const towardMid = (cs, pole, t)=>cs._theme?.dark ? interpolateRgb.gamma(2.2)(pole, colorMid(cs))(t) : colorLighter(pole, t);
11
23
  /** Builds the jenks (ckmeans) threshold scale and assigns it to the instance. */ function computeJenksScale(cs, ctx) {
12
24
  const { allValues, diverging, numBuckets } = ctx;
13
25
  let { colors } = ctx;
@@ -57,13 +69,13 @@ const colorMax = (cs)=>cs.schema.colorMax ?? cs.schema.colorDefaults.sequential;
57
69
  const negatives = ticks.slice(0, buckets).filter((d, i)=>d < cs.schema.midpoint && ticks[i + 1] <= cs.schema.midpoint);
58
70
  const spanning = ticks.slice(0, buckets).filter((d, i)=>d <= cs.schema.midpoint && ticks[i + 1] > cs.schema.midpoint);
59
71
  const positives = ticks.slice(0, buckets).filter((d)=>d > cs.schema.midpoint);
60
- const negativeColors = negatives.map((_d, i)=>!i ? base[0] : colorLighter(base[0], i / negatives.length));
72
+ const negativeColors = negatives.map((_d, i)=>!i ? base[0] : towardMid(cs, base[0], i / negatives.length));
61
73
  const spanningColors = spanning.map(()=>base[1]);
62
- const positiveColors = positives.map((_d, i)=>i === positives.length - 1 ? base[2] : colorLighter(base[2], 1 - (i + 1) / positives.length));
74
+ const positiveColors = positives.map((_d, i)=>i === positives.length - 1 ? base[2] : towardMid(cs, base[2], 1 - (i + 1) / positives.length));
63
75
  colors = negativeColors.concat(spanningColors).concat(positiveColors);
64
76
  } else {
65
- // Single-hue light→dark ramp, stepped in OKLab (see @d3plus/color).
66
- colors = colorRamp(colorMax(cs), numBuckets);
77
+ // Single-hue low→high ramp, stepped in OKLab (see @d3plus/color).
78
+ colors = ramp(cs, colorMax(cs), numBuckets);
67
79
  }
68
80
  }
69
81
  if (ticks.length <= buckets) colors = colors.slice(-ticks.length);
@@ -103,14 +115,15 @@ const colorMax = (cs)=>cs.schema.colorMax ?? cs.schema.colorDefaults.sequential;
103
115
  const { allValues, domain, negative, positive, diverging, numBuckets, scale } = ctx;
104
116
  let { colors } = ctx;
105
117
  if (!colors) {
106
- // Single-hue ramp of the relevant pole, stepped in OKLab (light→dark).
107
- // Negative-only scales read dark→light, so the ramp is reversed.
118
+ // Single-hue ramp of the relevant pole, stepped in OKLab (low→high).
119
+ // Negative-only scales put the pole on the most negative value, so the
120
+ // ramp is reversed.
108
121
  const base = negative ? colorMin(cs) : colorMax(cs);
109
122
  if (scale === "buckets" || scale === "quantile") {
110
- const ramp = colorRamp(base, numBuckets);
111
- colors = positive ? ramp : ramp.slice().reverse();
123
+ const steps = ramp(cs, base, numBuckets);
124
+ colors = positive ? steps : steps.slice().reverse();
112
125
  } else {
113
- const two = colorRamp(base, 2);
126
+ const two = ramp(cs, base, 2);
114
127
  colors = negative ? two.slice().reverse() : two;
115
128
  }
116
129
  }
@@ -196,8 +209,8 @@ const colorMax = (cs)=>cs.schema.colorMax ?? cs.schema.colorDefaults.sequential;
196
209
  ]);
197
210
  let colors = diverging && (!cs.schema.color || cs.schema.color instanceof Array && !cs.schema.color.includes(colorMid(cs))) ? undefined : cs.schema.color;
198
211
  if (colors && !(colors instanceof Array)) {
199
- // A single hue expands to a light→dark ramp, stepped in OKLab.
200
- colors = colorRamp(colors, numBuckets);
212
+ // A single hue expands to a low→high ramp, stepped in OKLab.
213
+ colors = ramp(cs, colors, numBuckets);
201
214
  }
202
215
  const ctx = {
203
216
  scale,
@@ -0,0 +1,77 @@
1
+ /**
2
+ The axis tooltips of a color scale drawn as swatches: the legend's title
3
+ takes the scale's `axisConfig.titleTooltip`, and each swatch label its
4
+ `axisConfig.tickTooltip`, given the same value and index as the label at
5
+ that bucket's start on a `bucketAxis` bar. A label drawn cut short shows
6
+ its whole text. The swatches keep their bucket's tooltip and highlight,
7
+ and a label showing its tooltip lights its bucket too (see
8
+ `handleSwatchLabelHover`).
9
+ */ import { canShow, inertAxis, labelCut, stampTitleTooltip } from "../Axis/axisTooltipTargets.js";
10
+ /** The legend row a swatch label draws, if `node` is one. */ const rowOf = (node)=>node.datum?.data?.data;
11
+ /**
12
+ Stamps swatch label nodes with their tooltip target: the bucket's tick for
13
+ the value, its place from the lowest for the index, and the label's whole
14
+ text. A label no tooltip could show for is left unstamped.
15
+ @param nodes The swatch labels' text nodes.
16
+ @param option The scale's `axisConfig.tickTooltip`.
17
+ @param buckets Each swatch's legend row, with its bucket.
18
+ */ export function stampSwatchLabels(nodes, option, buckets) {
19
+ if (option === false) return;
20
+ for (const node of nodes){
21
+ const bucket = buckets.get(rowOf(node));
22
+ if (node.type !== "text" || !bucket) continue;
23
+ const swatch = node.datum.data;
24
+ const text = `${swatch?.label ?? swatch?.id ?? ""}`;
25
+ const truncated = labelCut(node, text);
26
+ if (canShow(option, truncated)) node.axisTooltip = {
27
+ part: "tick",
28
+ value: bucket.value,
29
+ index: bucket.index,
30
+ text,
31
+ truncated,
32
+ option
33
+ };
34
+ }
35
+ }
36
+ /** A copy of a scene subtree, each node copied. */ const copy = (node)=>node.type === "group" ? {
37
+ ...node,
38
+ children: node.children.map(copy)
39
+ } : {
40
+ ...node
41
+ };
42
+ /**
43
+ A swatch-drawn scale's legend scene with its axis tooltips: the title is
44
+ chrome (see `inertAxis`) that takes the pointer only to show its tooltip,
45
+ a swatch label with a tooltip to show takes the pointer as axis chrome,
46
+ and every other node is left as the legend drew it.
47
+ @param scene The legend's scene.
48
+ @param options What the labels take their tooltips from.
49
+ */ export function swatchTooltips(scene, options) {
50
+ const next = copy(scene);
51
+ const titles = new Set();
52
+ const labels = [];
53
+ const collect = (node)=>{
54
+ if (node.type === "group") node.children.forEach(collect);
55
+ else if (node.type !== "text") return;
56
+ else if (options.titleDatum !== undefined && node.datum === options.titleDatum) titles.add(node);
57
+ else if (options.buckets.has(rowOf(node))) labels.push(node);
58
+ };
59
+ collect(next);
60
+ stampTitleTooltip([
61
+ ...titles
62
+ ], options.title, options.titleTooltip);
63
+ stampSwatchLabels(labels, options.tickTooltip, options.buckets);
64
+ const finish = (node)=>{
65
+ if (node.type === "group") return {
66
+ ...node,
67
+ children: node.children.map(finish)
68
+ };
69
+ if (titles.has(node)) return inertAxis(node);
70
+ return node.axisTooltip ? {
71
+ ...node,
72
+ interactive: true,
73
+ interactionGroup: "axis"
74
+ } : node;
75
+ };
76
+ return finish(next);
77
+ }
@@ -4,8 +4,10 @@ import { elem, rtl as detectRTL } from "@d3plus/dom";
4
4
  import { TextBox } from "../index.js";
5
5
  import { accessor, BaseClass, constant, paintComponentScene } from "../../utils/index.js";
6
6
  import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
7
+ import { labelLineHeight } from "../Axis/axisLabelLineHeight.js";
7
8
  import { buildLegendShapeConfig } from "./legendConfig.js";
8
9
  import { clearLegend, computeLegendBounds, computeLegendLineData, measureLegendTitle, renderLegendShapes, renderLegendTitle, wrapLegendRows } from "./legendRender.js";
10
+ import { inkText } from "../../utils/themeInk.js";
9
11
  /** Legend's fluent accessor schema. Config storage lives on `this.schema.<key>`. */ const legendSchema = [
10
12
  {
11
13
  key: "align",
@@ -70,6 +72,7 @@ import { clearLegend, computeLegendBounds, computeLegendLineData, measureLegendT
70
72
  /**
71
73
  Creates an SVG legend based on an array of data.
72
74
  */ export default class Legend extends BaseClass {
75
+ static _displayName = "Legend";
73
76
  _titleClass;
74
77
  _data;
75
78
  _lineData;
@@ -83,6 +86,10 @@ import { clearLegend, computeLegendBounds, computeLegendLineData, measureLegendT
83
86
  _titleHeight;
84
87
  _titleWidth;
85
88
  _wrapLines;
89
+ /**
90
+ Whether labels that don't fit whole are cut short with "..." rather
91
+ than left out, as a ColorScale's swatches are (see `legendCut.ts`).
92
+ */ _cutLabels = false;
86
93
  _wrapRows;
87
94
  // Standalone scene renderer (used when rendered on its own, not inside a
88
95
  // Viz). Reused across re-renders by paintComponentScene().
@@ -105,6 +112,7 @@ import { clearLegend, computeLegendBounds, computeLegendLineData, measureLegendT
105
112
  this._shapes = [];
106
113
  this.schema.shapeConfig = buildLegendShapeConfig(this);
107
114
  this.schema.titleConfig = {
115
+ fontColor: ()=>inkText(this),
108
116
  fontSize: 12
109
117
  };
110
118
  this._rtl = false;
@@ -118,8 +126,9 @@ import { clearLegend, computeLegendBounds, computeLegendLineData, measureLegendT
118
126
  @private
119
127
  */ _fetchConfig(key, d, i) {
120
128
  const labelConfig = this.schema.shapeConfig.labelConfig;
129
+ // Labels are measured at the line height their TextBoxes paint with.
130
+ if (key === "lineHeight") return labelLineHeight(this.schema.shapeConfig, d, i, this._fetchConfig("fontSize", d, i));
121
131
  const val = this.schema.shapeConfig[key] !== undefined ? this.schema.shapeConfig[key] : labelConfig?.[key];
122
- if (!val && key === "lineHeight") return this._fetchConfig("fontSize", d, i) * 1.4;
123
132
  return typeof val === "function" ? val(d, i) : val;
124
133
  }
125
134
  /**
@@ -207,7 +216,9 @@ import { clearLegend, computeLegendBounds, computeLegendLineData, measureLegendT
207
216
  this._lineData = computeLegendLineData(this, availableHeight);
208
217
  let spaceNeeded = this._rowWidth(this._lineData);
209
218
  const availableWidth = this.schema.width - this.schema.padding * 2;
210
- if (this.schema.direction === "column" || spaceNeeded > availableWidth) spaceNeeded = wrapLegendRows(this, availableWidth, availableHeight);
219
+ // A single row fits when it is no wider and no taller than the room left.
220
+ const rowFits = spaceNeeded <= availableWidth && (!this._lineData.length || this._rowHeight(this._lineData) + this.schema.padding <= availableHeight);
221
+ if (this.schema.direction === "column" || !rowFits) spaceNeeded = wrapLegendRows(this, availableWidth, availableHeight);
211
222
  if (spaceNeeded === false) clearLegend(this);
212
223
  else {
213
224
  computeLegendBounds(this, spaceNeeded);
@@ -1,7 +1,6 @@
1
1
  import { max } from "d3-array";
2
- import { colorContrast } from "@d3plus/color";
3
- import { backgroundColor } from "@d3plus/dom";
4
2
  import { accessor, constant } from "../../utils/index.js";
3
+ import { inkText } from "../../utils/themeInk.js";
5
4
  const padding = 5;
6
5
  const positionCache = new WeakMap();
7
6
  /**
@@ -117,10 +116,7 @@ const positionCache = new WeakMap();
117
116
  };
118
117
  },
119
118
  labelConfig: {
120
- fontColor: ()=>{
121
- const bg = legend._select ? backgroundColor(legend._select.node()) : "rgb(255, 255, 255)";
122
- return colorContrast(bg, legend.schema.colorDefaults);
123
- },
119
+ fontColor: ()=>inkText(legend),
124
120
  fontFamily: legend._titleClass.fontFamily(),
125
121
  fontResize: false,
126
122
  fontSize: constant(10),
@@ -0,0 +1,108 @@
1
+ /**
2
+ Lays out labels that don't fit a Legend whole in the room it has left,
3
+ for its TextBoxes to wrap within and cut short with "...": a Legend that
4
+ a ColorScale draws its swatches with (`_cutLabels`) cuts its labels short
5
+ rather than leaving them out.
6
+ */ import { max } from "d3-array";
7
+ import { textWrap } from "@d3plus/text";
8
+ import { TEXTBOX_LINE_HEIGHT, textBoxEllipsis } from "../TextBox.js";
9
+ /** The narrowest room a cut label keeps beside its swatch, for a letter or two and "...". */ const MIN_WIDTH = 24;
10
+ /**
11
+ The room each label of `legend` has with its swatches in `rows` rows of
12
+ as many each as fit (`rows` 1 to the count of swatches), or in one
13
+ column.
14
+ */ export function labelRoom(legend, availableWidth, availableHeight, rows = 1) {
15
+ const lines = legend._lineData;
16
+ const pad = legend.schema.padding;
17
+ const shape = max(lines, (d)=>d.shapeWidth) ?? 0;
18
+ const n = lines.length;
19
+ // As `buildRows` packs them: each swatch, its label and the padding
20
+ // between take less than the available width, and the rows, each its
21
+ // tallest label or swatch and the padding below, no more than its height.
22
+ if (legend.schema.direction === "column") return {
23
+ width: availableWidth - shape - pad * 2 - 1,
24
+ height: Math.floor((availableHeight - pad) / n - pad)
25
+ };
26
+ const perRow = Math.ceil(n / rows);
27
+ return {
28
+ width: Math.floor((availableWidth - 1) / perRow) - shape - pad * 2,
29
+ height: Math.floor((availableHeight - pad) / rows - pad)
30
+ };
31
+ }
32
+ /** Lays the label `d` out in `room`, or null when the room can't hold a line of it. */ function fitLabel(d, room) {
33
+ const step = d.lh + 1;
34
+ const most = Math.floor(room.height / step);
35
+ if (room.width < MIN_WIDTH || most < 1) return null;
36
+ const wrap = textWrap().fontFamily(d.f).fontSize(d.s).lineHeight(d.lh).width(room.width).height(most * step)(d.sentence);
37
+ const cut = wrap.truncated;
38
+ // A label cut down to nothing doesn't fit.
39
+ if (cut && !wrap.lines.length) return null;
40
+ return {
41
+ cut,
42
+ shown: cut ? wrap.lines.join("").length : `${d.sentence}`.length,
43
+ width: cut ? room.width : Math.min(room.width, Math.ceil(max(wrap.widths) ?? 0) + 10),
44
+ height: (cut ? most : wrap.lines.length) * step
45
+ };
46
+ }
47
+ /**
48
+ The lines the TextBox of the label `d` paints in the room it was given:
49
+ wrapped with the line height and ellipsis of the legend's labels (a
50
+ TextBox's own by default), as `renderLegendShapes` draws it.
51
+ */ export function paintedLines(legend, d) {
52
+ const label = legend.schema.shapeConfig.labelConfig ?? {};
53
+ const value = (v, fallback)=>v === undefined ? fallback : typeof v === "function" ? v(d.data, d.i) : v;
54
+ const size = d.s;
55
+ const ellipsis = typeof label.ellipsis === "function" ? label.ellipsis : textBoxEllipsis;
56
+ const wrap = textWrap().fontFamily(d.f).fontSize(size).lineHeight(value(label.lineHeight, size * TEXTBOX_LINE_HEIGHT)).width(d.width).height(Math.max(d.height, d.shapeHeight)).ellipsis(ellipsis)(d.sentence);
57
+ const lines = wrap.lines.filter((line)=>line !== "");
58
+ return lines.length ? lines : [
59
+ ellipsis("", 0)
60
+ ];
61
+ }
62
+ /**
63
+ Gives each label of `legend` the room it has in the layout of its
64
+ swatches that shows the most of its labels, its whole text when that
65
+ fits there and else as many lines as fit, marking it `cut`, with the
66
+ lines it paints there. In a row, the swatches try each count of rows
67
+ within the height, keeping the layout that cuts the fewest labels short,
68
+ then shows the most of their text, then is the shortest. In a column,
69
+ they keep to one column, which reads in order from top to bottom.
70
+ Returns false, changing nothing, when no layout can hold a line of a
71
+ few letters.
72
+ */ export function cutLegendLabels(legend, availableWidth, availableHeight) {
73
+ const lines = legend._lineData;
74
+ const labeled = lines.filter((d)=>d.sentence);
75
+ if (!labeled.length) return false;
76
+ const counts = legend.schema.direction === "column" ? [
77
+ 1
78
+ ] : Array.from({
79
+ length: lines.length
80
+ }, (_, i)=>i + 1);
81
+ const shape = max(lines, (d)=>d.shapeHeight) ?? 0;
82
+ const pad = legend.schema.padding;
83
+ let best;
84
+ for (const rows of counts){
85
+ const room = labelRoom(legend, availableWidth, availableHeight, rows);
86
+ const fits = labeled.map((d)=>fitLabel(d, room));
87
+ if (fits.some((fit)=>!fit)) continue;
88
+ const all = fits;
89
+ const cut = all.filter((fit)=>fit.cut).length;
90
+ const shown = all.reduce((total, fit)=>total + fit.shown, 0);
91
+ const height = rows * (Math.max(shape, ...all.map((fit)=>fit.height)) + pad) + pad;
92
+ if (!best || cut < best.cut || cut === best.cut && (shown > best.shown || shown === best.shown && height < best.height)) best = {
93
+ fits: all,
94
+ cut,
95
+ shown,
96
+ height
97
+ };
98
+ }
99
+ if (!best) return false;
100
+ labeled.forEach((d, i)=>{
101
+ const fit = best.fits[i];
102
+ d.cut = fit.cut;
103
+ d.width = fit.width;
104
+ d.height = fit.height;
105
+ d.lines = paintedLines(legend, d);
106
+ });
107
+ return true;
108
+ }
@@ -3,16 +3,26 @@ import { textWidth } from "@d3plus/dom";
3
3
  import { textWrap } from "@d3plus/text";
4
4
  import * as shapes from "../../shapes/index.js";
5
5
  import { configPrep } from "../../utils/index.js";
6
+ import { labelLineHeight } from "../Axis/axisLabelLineHeight.js";
7
+ import { cutLegendLabels } from "./legendCut.js";
6
8
  const padding = 5;
7
- /** Wraps + measures the title, setting `_titleHeight` / `_titleWidth`. */ export function measureLegendTitle(legend) {
9
+ /**
10
+ Wraps + measures the title, setting `_titleHeight` / `_titleWidth`: it
11
+ wraps within the width the title is drawn in, the legend's less its
12
+ padding on both sides, and is left out (both zero) when it doesn't fit
13
+ there whole.
14
+ */ export function measureLegendTitle(legend) {
8
15
  legend._titleHeight = 0;
9
16
  legend._titleWidth = 0;
10
17
  if (legend.schema.title) {
11
18
  const f = legend.schema.titleConfig.fontFamily || legend._titleClass.fontFamily()(), s = legend.schema.titleConfig.fontSize || legend._titleClass.fontSize()();
12
- let lH = legend.schema.titleConfig.lineHeight || legend._titleClass.lineHeight();
13
- lH = typeof lH === "function" ? lH() : lH ?? s * 1.4;
14
- const res = textWrap().fontFamily(f).fontSize(s).lineHeight(lH).width(legend.schema.width).height(legend.schema.height)(legend.schema.title);
15
- legend._titleHeight = lH + res.lines.length + legend.schema.padding;
19
+ // Measured at the line height its TextBox paints with.
20
+ const lH = labelLineHeight(legend.schema.titleConfig, {
21
+ text: legend.schema.title
22
+ }, 0, s);
23
+ const res = textWrap().fontFamily(f).fontSize(s).lineHeight(lH).width(legend.schema.width - legend.schema.padding * 2).height(legend.schema.height)(legend.schema.title);
24
+ if (res.truncated || !res.lines.length) return;
25
+ legend._titleHeight = res.lines.length * (lH + 1) + legend.schema.padding;
16
26
  legend._titleWidth = max(res.widths);
17
27
  }
18
28
  }
@@ -61,10 +71,16 @@ const padding = 5;
61
71
  return res;
62
72
  });
63
73
  }
74
+ /**
75
+ An item's width as `_rowWidth` reports it when it ends a row: its swatch
76
+ and label, without the padding that only separates it from a next item.
77
+ */ function itemWidth(d) {
78
+ return d.width + d.shapeWidth;
79
+ }
64
80
  /** Attempts to wrap labels onto an additional line, recursing into rows. */ function tryWrapLines(legend, state, availableWidth, availableHeight) {
65
81
  state.lines++;
66
82
  if (state.lines > state.maxLines) return;
67
- const wrappable = state.lines === 1 ? legend._lineData.slice() : legend._lineData.filter((d)=>d.width + d.shapeWidth + legend.schema.padding * (d.width ? 2 : 1) > availableWidth && d.words.length >= state.lines).sort((a, b)=>b.sentence.length - a.sentence.length);
83
+ const wrappable = state.lines === 1 ? legend._lineData.slice() : legend._lineData.filter((d)=>itemWidth(d) > availableWidth && d.words.length >= state.lines).sort((a, b)=>b.sentence.length - a.sentence.length);
68
84
  if (wrappable.length && availableHeight > wrappable[0].height * state.lines) {
69
85
  let truncated = false;
70
86
  for(let x = 0; x < wrappable.length; x++){
@@ -73,10 +89,13 @@ const padding = 5;
73
89
  const h = og.height * state.lines, w = og.width * (1.5 * (1 / state.lines));
74
90
  const res = textWrap().fontFamily(label.f).fontSize(label.s).lineHeight(label.lh).width(w).height(h)(label.sentence);
75
91
  if (!res.truncated) {
92
+ // Measured as `computeLegendLineData` measures a label: the lines
93
+ // its TextBox paints, and the widest with the padding either side.
94
+ label.lines = res.lines;
76
95
  label.width = Math.ceil(max(res.lines.map((t)=>textWidth(t, {
77
96
  "font-family": label.f,
78
97
  "font-size": label.s
79
- })))) + label.s;
98
+ })))) + padding * 2;
80
99
  label.height = res.lines.length * (label.lh + 1);
81
100
  } else {
82
101
  truncated = true;
@@ -93,7 +112,8 @@ const padding = 5;
93
112
  state.newRows = [];
94
113
  let row = 1, rowWidth = 0;
95
114
  for(let i = 0; i < legend._lineData.length; i++){
96
- const d = legend._lineData[i], w = d.width + legend.schema.padding * (d.width ? 2 : 1) + d.shapeWidth;
115
+ const d = legend._lineData[i], // The padding after an item counts only when another follows it.
116
+ w = itemWidth(d) + legend.schema.padding * (d.width ? 2 : 1);
97
117
  if (sum(state.newRows.map((row)=>max(row, (d)=>max([
98
118
  d.height,
99
119
  d.shapeHeight
@@ -101,11 +121,11 @@ const padding = 5;
101
121
  state.newRows = [];
102
122
  break;
103
123
  }
104
- if (w > availableWidth) {
124
+ if (itemWidth(d) > availableWidth) {
105
125
  state.newRows = [];
106
126
  legend._wrapLines();
107
127
  break;
108
- } else if (rowWidth + w < availableWidth) {
128
+ } else if (rowWidth + itemWidth(d) <= availableWidth) {
109
129
  rowWidth += w;
110
130
  } else if (legend.schema.direction !== "column") {
111
131
  rowWidth = w;
@@ -131,15 +151,19 @@ const padding = 5;
131
151
  };
132
152
  legend._wrapLines = ()=>tryWrapLines(legend, state, availableWidth, availableHeight);
133
153
  legend._wrapRows = ()=>buildRows(legend, state, availableWidth, availableHeight);
154
+ const overflows = ()=>!state.newRows.length || sum(state.newRows, legend._rowHeight.bind(legend)) + legend.schema.padding > availableHeight;
134
155
  legend._wrapRows();
135
- if (!state.newRows.length || sum(state.newRows, legend._rowHeight.bind(legend)) + legend.schema.padding > availableHeight) {
156
+ // Labels that don't fit whole are cut short (a ColorScale's Legend), or
157
+ // else left out.
158
+ if (overflows() && !(legend._cutLabels && cutLegendLabels(legend, availableWidth, availableHeight) && (legend._wrapRows(), !overflows()))) {
136
159
  for(let i = 0; i < legend._lineData.length; i++){
137
160
  legend._lineData[i].width = 0;
138
161
  legend._lineData[i].height = 0;
162
+ legend._lineData[i].cut = false;
139
163
  }
140
164
  legend._wrapRows();
141
165
  }
142
- if (!state.newRows.length || sum(state.newRows, legend._rowHeight.bind(legend)) + legend.schema.padding > availableHeight) return false;
166
+ if (overflows()) return false;
143
167
  state.newRows.forEach((row, i)=>{
144
168
  row.forEach((d)=>{
145
169
  if (i) {
@@ -181,7 +205,8 @@ const padding = 5;
181
205
  legend._outerBounds.y = yOffset;
182
206
  }
183
207
  /** Renders the title TextBox into the legend's title group. */ export function renderLegendTitle(legend) {
184
- legend._titleClass.renderMode("compute").data(legend.schema.title ? [
208
+ legend._titleClass.renderMode("compute")// A title left out for want of room measures no height.
209
+ .data(legend._titleHeight ? [
185
210
  {
186
211
  text: legend.schema.title
187
212
  }
@@ -61,6 +61,7 @@ new SizeLegend()
61
61
  .select("#container")
62
62
  .render();
63
63
  */ export default class SizeLegend extends BaseClass {
64
+ static _displayName = "SizeLegend";
64
65
  _layout;
65
66
  /** Drops values whose circles would outgrow this radius; set by a zoomed chart. */ _maxRadius;
66
67
  _select;
@@ -1,17 +1,21 @@
1
1
  import { select } from "d3-selection";
2
2
  import { rtl as detectRTL } from "@d3plus/dom";
3
- import { fontFamily, strip, textSplit } from "@d3plus/text";
3
+ import { fontFamily, textSplit } from "@d3plus/text";
4
4
  import { SvgRenderer } from "@d3plus/render";
5
5
  import { accessor, BaseClass, constant } from "../utils/index.js";
6
6
  import { applyClassName } from "../utils/className.js";
7
7
  import { installFluent } from "../fluent.js";
8
8
  import { computeTextBoxDatum } from "./textBoxLayout.js";
9
+ import { textBoxNodes } from "./textBoxScene.js";
10
+ import { textEllipsis } from "./textEllipsis.js";
9
11
  const defaultHtmlLookup = {
10
12
  i: "font-style: italic;",
11
13
  em: "font-style: italic;",
12
14
  b: "font-weight: bold;",
13
15
  strong: "font-weight: bold;"
14
16
  };
17
+ /** The ellipsis a TextBox ends a cut line with by default: none for a line with nothing kept. */ export const textBoxEllipsis = (text, line)=>line ? textEllipsis(text) : "";
18
+ /** A TextBox's default line height, as a multiple of its font size. */ export const TEXTBOX_LINE_HEIGHT = 1.2;
15
19
  /** TextBox's fluent accessor schema. Config storage lives on `this.schema.<key>`. */ const textBoxSchema = [
16
20
  {
17
21
  key: "ariaHidden",
@@ -31,7 +35,7 @@ const defaultHtmlLookup = {
31
35
  {
32
36
  key: "ellipsis",
33
37
  coerce: "const",
34
- default: (text, line)=>line ? `${text.replace(/\.|,$/g, "")}...` : ""
38
+ default: textBoxEllipsis
35
39
  },
36
40
  {
37
41
  key: "fontColor",
@@ -88,6 +92,11 @@ const defaultHtmlLookup = {
88
92
  coerce: "const",
89
93
  default: accessor("height", 200)
90
94
  },
95
+ {
96
+ key: "hitbox",
97
+ coerce: "const",
98
+ default: constant(false)
99
+ },
91
100
  {
92
101
  key: "id",
93
102
  coerce: "const",
@@ -146,11 +155,21 @@ const defaultHtmlLookup = {
146
155
  coerce: "const",
147
156
  default: (d)=>d.__d3plusWrapShape__ ?? "square"
148
157
  },
158
+ {
159
+ key: "side",
160
+ coerce: "const",
161
+ default: constant("left")
162
+ },
149
163
  {
150
164
  key: "split",
151
165
  coerce: "identity",
152
166
  default: textSplit
153
167
  },
168
+ {
169
+ key: "startOffset",
170
+ coerce: "const",
171
+ default: constant(0)
172
+ },
154
173
  {
155
174
  key: "text",
156
175
  coerce: "const",
@@ -161,6 +180,16 @@ const defaultHtmlLookup = {
161
180
  coerce: "const",
162
181
  default: constant("start")
163
182
  },
183
+ {
184
+ key: "textPath",
185
+ coerce: "const",
186
+ default: constant(false)
187
+ },
188
+ {
189
+ key: "truncateWord",
190
+ coerce: "const",
191
+ default: constant(false)
192
+ },
164
193
  {
165
194
  key: "verticalAlign",
166
195
  coerce: "const",
@@ -185,6 +214,7 @@ const defaultHtmlLookup = {
185
214
  /**
186
215
  Creates a wrapped text box for each point in an array of data.
187
216
  */ export default class TextBox extends BaseClass {
217
+ static _displayName = "TextBox";
188
218
  _select;
189
219
  _data;
190
220
  /**
@@ -193,7 +223,7 @@ const defaultHtmlLookup = {
193
223
  */ constructor(){
194
224
  super();
195
225
  installFluent(this, textBoxSchema);
196
- this.schema.lineHeight = (d, i)=>this.schema.fontSize(d, i) * 1.2;
226
+ this.schema.lineHeight = (d, i)=>this.schema.fontSize(d, i) * TEXTBOX_LINE_HEIGHT;
197
227
  this.schema.html = defaultHtmlLookup;
198
228
  }
199
229
  /**
@@ -213,70 +243,7 @@ const defaultHtmlLookup = {
213
243
  layout (_textData) and per-line positioning render() applies to the DOM.
214
244
  */ toScene() {
215
245
  const rtl = detectRTL();
216
- const children = this._textData().map((d)=>{
217
- const anchor = d.tA === "middle" ? "middle" : d.tA === "end" ? "end" : "start";
218
- const lineX = d.tA === "middle" ? d.w / 2 : rtl ? d.tA === "start" ? d.w : 0 : d.tA === "end" ? d.w : 2 * Math.sin(Math.PI * d.r / 180);
219
- const lines = d.lines.map((text, i)=>{
220
- const y = d.r === 0 || d.vA === "top" ? (i + 1) * d.lH - (d.lH - d.fS) : d.vA === "middle" ? (d.h + d.fS) / 2 - (d.lH - d.fS) + (i - d.lines.length / 2 + 0.5) * d.lH : d.h - 2 * (d.lH - d.fS) - (d.lines.length - (i + 1)) * d.lH + 2 * Math.cos(Math.PI * d.r / 180);
221
- const width = d.widths ? d.widths[i] ?? 0 : 0;
222
- const runs = d.lineRuns ? d.lineRuns[i] : undefined;
223
- return runs ? {
224
- text,
225
- x: lineX,
226
- y,
227
- width,
228
- runs
229
- } : {
230
- text,
231
- x: lineX,
232
- y,
233
- width
234
- };
235
- });
236
- const rotateAnchor = this.schema.rotateAnchor(d, d.i);
237
- const ariaHidden = d.aH === "true" || d.aH === true;
238
- const interactive = d.pE !== "none";
239
- return {
240
- type: "text",
241
- key: d.id,
242
- id: `d3plus-textBox-${strip(d.id)}`,
243
- datum: d.data,
244
- index: d.i,
245
- x: 0,
246
- y: 0,
247
- width: d.w,
248
- height: d.h,
249
- lines,
250
- font: {
251
- family: d.fF,
252
- size: d.fS,
253
- weight: d.fW,
254
- anchor,
255
- baseline: "alphabetic",
256
- dir: rtl ? "rtl" : "ltr"
257
- },
258
- paint: {
259
- fill: d.fC,
260
- opacity: d.fO,
261
- ...d.fStroke && d.fStroke !== "transparent" ? {
262
- stroke: d.fStroke
263
- } : {},
264
- ...d.fSW ? {
265
- strokeWidth: d.fSW
266
- } : {}
267
- },
268
- transform: {
269
- x: d.x,
270
- y: d.y,
271
- rotate: d.r,
272
- rotateAnchor
273
- },
274
- aria: ariaHidden ? {
275
- hidden: true
276
- } : undefined,
277
- interactive
278
- };
279
- });
246
+ const children = this._textData().flatMap((d)=>textBoxNodes(d, this.schema.rotateAnchor(d, d.i), rtl));
280
247
  return {
281
248
  type: "group",
282
249
  key: "textBox-group",