@d3plus/core 4.10.0 → 4.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (711) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +178 -9
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +176 -0
  9. package/es/src/charts/Alluvial/layout.js +137 -0
  10. package/es/src/charts/Alluvial/meta.js +57 -0
  11. package/es/src/charts/Alluvial/titles.js +101 -0
  12. package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
  13. package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
  14. package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
  15. package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
  16. package/es/src/charts/ArcDiagram/emit.js +192 -0
  17. package/es/src/charts/ArcDiagram/events.js +148 -0
  18. package/es/src/charts/ArcDiagram/index.js +217 -0
  19. package/es/src/charts/BarChart/index.js +12 -7
  20. package/es/src/charts/BoxWhisker/index.js +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +5 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +6 -11
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +160 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +137 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +206 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +6 -4
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Matrix/applyLayout.js +20 -9
  70. package/es/src/charts/Matrix/index.js +19 -1
  71. package/es/src/charts/Network/applyLayout.js +171 -96
  72. package/es/src/charts/Network/bundle.js +82 -0
  73. package/es/src/charts/Network/clusterLabels.js +423 -0
  74. package/es/src/charts/Network/clusters.js +290 -0
  75. package/es/src/charts/Network/emit.js +257 -75
  76. package/es/src/charts/Network/graph.js +146 -0
  77. package/es/src/charts/Network/graphFluent.js +81 -0
  78. package/es/src/charts/Network/index.js +91 -106
  79. package/es/src/charts/Network/minNodeDistance.js +64 -0
  80. package/es/src/charts/Network/polygonRows.js +44 -0
  81. package/es/src/charts/Pack/applyLayout.js +16 -5
  82. package/es/src/charts/Pack/emit.js +15 -8
  83. package/es/src/charts/Pack/groupRows.js +61 -0
  84. package/es/src/charts/Pack/index.js +8 -1
  85. package/es/src/charts/Pack/neutralPaint.js +20 -0
  86. package/es/src/charts/Pack/nodeNames.js +35 -0
  87. package/es/src/charts/ParallelCoordinates/axes.js +22 -22
  88. package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
  89. package/es/src/charts/ParallelCoordinates/index.js +3 -1
  90. package/es/src/charts/ParallelCoordinates/titles.js +17 -9
  91. package/es/src/charts/Pie/applyLayout.js +86 -27
  92. package/es/src/charts/Pie/arcFit.js +152 -0
  93. package/es/src/charts/Pie/curvedLabels.js +134 -0
  94. package/es/src/charts/Pie/emit.js +51 -96
  95. package/es/src/charts/Pie/index.js +74 -31
  96. package/es/src/charts/Pie/labelRoom.js +154 -0
  97. package/es/src/charts/Pie/outsideLabels.js +224 -0
  98. package/es/src/charts/Pie/outsideNodes.js +267 -0
  99. package/es/src/charts/Pie/pieLabels.js +137 -0
  100. package/es/src/charts/Pie/sectorBox.js +223 -0
  101. package/es/src/charts/Pie/straightLabels.js +96 -0
  102. package/es/src/charts/Pie/straightLayout.js +215 -0
  103. package/es/src/charts/Plot/alongLegend.js +76 -0
  104. package/es/src/charts/Plot/areaEnter.js +68 -0
  105. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  106. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  107. package/es/src/charts/Plot/axisValues.js +43 -0
  108. package/es/src/charts/Plot/barWidth.js +59 -11
  109. package/es/src/charts/Plot/circleLabels.js +98 -0
  110. package/es/src/charts/Plot/connectGaps.js +237 -0
  111. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  112. package/es/src/charts/Plot/draw.js +34 -14
  113. package/es/src/charts/Plot/fillBetween.js +2 -1
  114. package/es/src/charts/Plot/forecastScene.js +3 -4
  115. package/es/src/charts/Plot/index.js +19 -17
  116. package/es/src/charts/Plot/labelPlacement.js +1 -1
  117. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  118. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  119. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  120. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  121. package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
  122. package/es/src/charts/Plot/pipeline.js +66 -19
  123. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  124. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  125. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  126. package/es/src/charts/Plot/pipelineScales.js +40 -8
  127. package/es/src/charts/Plot/plotFacet.js +12 -1
  128. package/es/src/charts/Plot/plotInit.js +40 -5
  129. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  130. package/es/src/charts/Plot/referenceDomains.js +133 -0
  131. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  132. package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
  133. package/es/src/charts/Plot/sharedHover.js +2 -1
  134. package/es/src/charts/Plot/sharedTooltip.js +13 -3
  135. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  136. package/es/src/charts/Plot/trendLabels.js +183 -0
  137. package/es/src/charts/Plot/trendLines.js +1 -0
  138. package/es/src/charts/Plot/trendScene.js +6 -3
  139. package/es/src/charts/Plot/trendTooltip.js +5 -1
  140. package/es/src/charts/PolarArea/index.js +4 -3
  141. package/es/src/charts/Priestley/applyLayout.js +21 -23
  142. package/es/src/charts/Priestley/index.js +4 -37
  143. package/es/src/charts/Priestley/timeAxis.js +103 -0
  144. package/es/src/charts/Pyramid/gutter.js +52 -16
  145. package/es/src/charts/Pyramid/index.js +55 -7
  146. package/es/src/charts/Pyramid/scene.js +4 -4
  147. package/es/src/charts/Radar/applyLayout.js +31 -33
  148. package/es/src/charts/Radar/axisDecorations.js +62 -13
  149. package/es/src/charts/Radar/curvedLabels.js +228 -0
  150. package/es/src/charts/Radar/emit.js +30 -15
  151. package/es/src/charts/Radar/index.js +43 -5
  152. package/es/src/charts/Radar/points.js +85 -0
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +9 -1
  155. package/es/src/charts/RadialBar/index.js +26 -9
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
  158. package/es/src/charts/RadialMatrix/index.js +18 -9
  159. package/es/src/charts/Rings/applyLayout.js +39 -161
  160. package/es/src/charts/Rings/emit.js +219 -63
  161. package/es/src/charts/Rings/index.js +88 -32
  162. package/es/src/charts/Rings/ringsCurves.js +156 -0
  163. package/es/src/charts/Rings/ringsGraph.js +28 -9
  164. package/es/src/charts/Rings/ringsLoops.js +73 -0
  165. package/es/src/charts/Rings/ringsParallel.js +183 -0
  166. package/es/src/charts/Rings/ringsPlacement.js +152 -0
  167. package/es/src/charts/Rings/ringsSizing.js +61 -38
  168. package/es/src/charts/Sankey/applyLayout.js +130 -39
  169. package/es/src/charts/Sankey/circularLayout.js +208 -0
  170. package/es/src/charts/Sankey/circularLinks.js +301 -0
  171. package/es/src/charts/Sankey/emit.js +164 -94
  172. package/es/src/charts/Sankey/index.js +78 -75
  173. package/es/src/charts/Sankey/labels.js +80 -0
  174. package/es/src/charts/Sankey/ribbons.js +88 -0
  175. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  176. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  177. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  178. package/es/src/charts/Scatter/index.js +25 -0
  179. package/es/src/charts/SlopeChart/index.js +116 -0
  180. package/es/src/charts/SlopeChart/slope.js +95 -0
  181. package/es/src/charts/Streamgraph/index.js +51 -0
  182. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  183. package/es/src/charts/Sunburst/emit.js +83 -64
  184. package/es/src/charts/Sunburst/index.js +16 -4
  185. package/es/src/charts/Tree/applyLayout.js +44 -14
  186. package/es/src/charts/Tree/emit.js +5 -5
  187. package/es/src/charts/Tree/index.js +12 -18
  188. package/es/src/charts/Tree/keys.js +33 -0
  189. package/es/src/charts/Tree/nodeLabel.js +15 -0
  190. package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
  191. package/es/src/charts/Treemap/index.js +2 -5
  192. package/es/src/charts/Violin/inner.js +3 -5
  193. package/es/src/charts/definition/makeChart.js +14 -2
  194. package/es/src/charts/drawSteps/backControl.js +17 -5
  195. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  196. package/es/src/charts/drawSteps/minimap.js +10 -25
  197. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  198. package/es/src/charts/drawSteps/searchControls.js +2 -1
  199. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  200. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  201. package/es/src/charts/drawSteps/zoomActions.js +36 -0
  202. package/es/src/charts/drawSteps/zoomControls.js +52 -23
  203. package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
  204. package/es/src/charts/drawSteps/zoomDrag.js +188 -0
  205. package/es/src/charts/drawSteps/zoomFit.js +69 -0
  206. package/es/src/charts/events/click.legend.js +11 -4
  207. package/es/src/charts/events/click.shape.js +13 -4
  208. package/es/src/charts/events/mouseenter.js +6 -16
  209. package/es/src/charts/events/mouseleave.js +9 -2
  210. package/es/src/charts/events/mousemove.legend.js +28 -32
  211. package/es/src/charts/events/mousemove.shape.js +45 -42
  212. package/es/src/charts/facet/drawFacets.js +14 -5
  213. package/es/src/charts/features/annotationFrame.js +179 -0
  214. package/es/src/charts/features/annotationText.js +83 -0
  215. package/es/src/charts/features/annotationTypes.js +10 -0
  216. package/es/src/charts/features/attributionFeature.js +6 -11
  217. package/es/src/charts/features/axes.js +17 -5
  218. package/es/src/charts/features/axesFinal.js +10 -3
  219. package/es/src/charts/features/axesMeasure.js +33 -12
  220. package/es/src/charts/features/axisTooltip.js +138 -0
  221. package/es/src/charts/features/calloutLayout.js +121 -0
  222. package/es/src/charts/features/calloutScene.js +155 -0
  223. package/es/src/charts/features/centerLabel.js +177 -0
  224. package/es/src/charts/features/chartGeometry.js +1 -1
  225. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  226. package/es/src/charts/features/circleLabels.js +207 -0
  227. package/es/src/charts/features/colorScaleBivariate.js +83 -0
  228. package/es/src/charts/features/colorScaleBucket.js +20 -1
  229. package/es/src/charts/features/colorScaleHover.js +33 -7
  230. package/es/src/charts/features/colorScaleLimit.js +73 -0
  231. package/es/src/charts/features/colorScaleTooltip.js +77 -0
  232. package/es/src/charts/features/colorScaleTop.js +61 -0
  233. package/es/src/charts/features/colorScaleValue.js +97 -0
  234. package/es/src/charts/features/curvedArrows.js +191 -0
  235. package/es/src/charts/features/depthKey.js +26 -0
  236. package/es/src/charts/features/edgeArrows.js +220 -5
  237. package/es/src/charts/features/edgeBundling.js +442 -0
  238. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  239. package/es/src/charts/features/ensureZoomDom.js +32 -8
  240. package/es/src/charts/features/features.js +32 -14
  241. package/es/src/charts/features/featuresColorScale.js +75 -20
  242. package/es/src/charts/features/featuresLegend.js +15 -24
  243. package/es/src/charts/features/hoverTicks.js +41 -0
  244. package/es/src/charts/features/idleQueue.js +72 -0
  245. package/es/src/charts/features/legendKeys.js +64 -0
  246. package/es/src/charts/features/lineLabels.js +55 -46
  247. package/es/src/charts/features/linkBundle.js +19 -0
  248. package/es/src/charts/features/linkColor.js +72 -0
  249. package/es/src/charts/features/linkFields.js +86 -0
  250. package/es/src/charts/features/linkFocus.js +118 -0
  251. package/es/src/charts/features/linkInteraction.js +364 -0
  252. package/es/src/charts/features/linkKeys.js +20 -0
  253. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  254. package/es/src/charts/features/linkLabelPath.js +162 -0
  255. package/es/src/charts/features/linkLabels.js +340 -0
  256. package/es/src/charts/features/linkWidths.js +32 -0
  257. package/es/src/charts/features/networkMeasures.js +241 -0
  258. package/es/src/charts/features/nodeStats.js +309 -0
  259. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  260. package/es/src/charts/features/pathLabels.js +50 -0
  261. package/es/src/charts/features/plotAnnotations.js +68 -17
  262. package/es/src/charts/features/plotEndLabels.js +28 -7
  263. package/es/src/charts/features/plotPaint.js +46 -12
  264. package/es/src/charts/features/polyline.js +129 -0
  265. package/es/src/charts/features/referenceAnnotations.js +403 -0
  266. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  267. package/es/src/charts/features/ringLabelNodes.js +93 -0
  268. package/es/src/charts/features/ringLabels.js +222 -0
  269. package/es/src/charts/features/sceneBounds.js +26 -6
  270. package/es/src/charts/features/selfLoops.js +306 -0
  271. package/es/src/charts/features/shapeEmit.js +54 -32
  272. package/es/src/charts/features/sharedFields.js +15 -2
  273. package/es/src/charts/features/textHalo.js +30 -0
  274. package/es/src/charts/index.js +8 -0
  275. package/es/src/charts/partition/chartFields.js +14 -5
  276. package/es/src/charts/partition/interaction.js +19 -10
  277. package/es/src/charts/partition/zoom.js +7 -6
  278. package/es/src/charts/pipeline/insetPlacement.js +22 -9
  279. package/es/src/charts/pipeline/preDrawData.js +46 -3
  280. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  281. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  282. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  283. package/es/src/charts/polar/chrome.js +81 -9
  284. package/es/src/charts/polar/config.js +6 -3
  285. package/es/src/charts/polar/wedgeLayout.js +2 -1
  286. package/es/src/charts/viz/Viz.js +61 -49
  287. package/es/src/charts/viz/VizBase.js +57 -14
  288. package/es/src/charts/viz/backgroundInk.js +23 -7
  289. package/es/src/charts/viz/emphasis.js +14 -0
  290. package/es/src/charts/viz/fillStroke.js +10 -0
  291. package/es/src/charts/viz/focusRing.js +104 -0
  292. package/es/src/charts/viz/focusTargets.js +208 -0
  293. package/es/src/charts/viz/history.js +74 -0
  294. package/es/src/charts/viz/interactionOpacity.js +115 -32
  295. package/es/src/charts/viz/keyboardNav.js +297 -0
  296. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  297. package/es/src/charts/viz/loaderFormat.js +114 -0
  298. package/es/src/charts/viz/missingFields.js +2 -1
  299. package/es/src/charts/viz/mountTarget.js +9 -0
  300. package/es/src/charts/viz/nearestHover.js +183 -0
  301. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  302. package/es/src/charts/viz/ordinalColor.js +14 -12
  303. package/es/src/charts/viz/pageTheme.js +83 -0
  304. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  305. package/es/src/charts/viz/pointVoronoi.js +124 -0
  306. package/es/src/charts/viz/reducedMotion.js +27 -0
  307. package/es/src/charts/viz/reportDrawError.js +15 -0
  308. package/es/src/charts/viz/setCursor.js +29 -0
  309. package/es/src/charts/viz/tooltipEnabled.js +38 -0
  310. package/es/src/charts/viz/userClick.js +34 -0
  311. package/es/src/charts/viz/vizDataPolling.js +8 -4
  312. package/es/src/charts/viz/vizDefaults.js +28 -57
  313. package/es/src/charts/viz/vizFields.js +41 -1
  314. package/es/src/charts/viz/vizRender.js +76 -31
  315. package/es/src/charts/viz/vizTheme.js +96 -0
  316. package/es/src/charts/viz/vizVisibility.js +26 -2
  317. package/es/src/components/Axis/Axis.js +35 -2
  318. package/es/src/components/Axis/AxisBottom.js +1 -0
  319. package/es/src/components/Axis/AxisLeft.js +1 -0
  320. package/es/src/components/Axis/AxisRight.js +1 -0
  321. package/es/src/components/Axis/AxisTop.js +1 -0
  322. package/es/src/components/Axis/axisBreak.js +33 -8
  323. package/es/src/components/Axis/axisDefaults.js +16 -9
  324. package/es/src/components/Axis/axisLabelKinds.js +36 -0
  325. package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
  326. package/es/src/components/Axis/axisLabelRoom.js +37 -0
  327. package/es/src/components/Axis/axisLabelSize.js +171 -0
  328. package/es/src/components/Axis/axisLabelThinning.js +98 -4
  329. package/es/src/components/Axis/axisLayout.js +71 -46
  330. package/es/src/components/Axis/axisLayoutLabels.js +82 -140
  331. package/es/src/components/Axis/axisLayoutScale.js +16 -11
  332. package/es/src/components/Axis/axisLimit.js +27 -0
  333. package/es/src/components/Axis/axisMaxSize.js +39 -0
  334. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  335. package/es/src/components/Axis/axisRender.js +20 -8
  336. package/es/src/components/Axis/axisRounding.js +16 -1
  337. package/es/src/components/Axis/axisScene.js +11 -2
  338. package/es/src/components/Axis/axisTitle.js +53 -0
  339. package/es/src/components/Axis/axisTooltipTargets.js +128 -0
  340. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  341. package/es/src/components/Axis/rangeBreaks.js +201 -0
  342. package/es/src/components/Axis/timeValues.js +19 -4
  343. package/es/src/components/ColorScale/ColorScale.js +77 -27
  344. package/es/src/components/ColorScale/bivariateRender.js +353 -0
  345. package/es/src/components/ColorScale/bivariateScale.js +150 -0
  346. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  347. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  348. package/es/src/components/ColorScale/colorScaleRender.js +32 -2
  349. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  350. package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
  351. package/es/src/components/Legend/Legend.js +13 -2
  352. package/es/src/components/Legend/legendConfig.js +2 -6
  353. package/es/src/components/Legend/legendCut.js +108 -0
  354. package/es/src/components/Legend/legendRender.js +38 -13
  355. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  356. package/es/src/components/TextBox.js +34 -67
  357. package/es/src/components/Timeline/Timeline.js +12 -3
  358. package/es/src/components/Timeline/timelineConfig.js +20 -10
  359. package/es/src/components/Timeline/timelineMode.js +26 -0
  360. package/es/src/components/Timeline/timelineRender.js +9 -4
  361. package/es/src/components/Tooltip.js +15 -5
  362. package/es/src/components/fontStack.js +20 -0
  363. package/es/src/components/textBoxLayout.js +58 -21
  364. package/es/src/components/textBoxPath.js +73 -0
  365. package/es/src/components/textBoxScene.js +226 -0
  366. package/es/src/components/textBoxWords.js +70 -0
  367. package/es/src/components/textEllipsis.js +7 -0
  368. package/es/src/components/tooltipDom.js +8 -5
  369. package/es/src/fluent.js +48 -0
  370. package/es/src/shapes/Area.js +1 -0
  371. package/es/src/shapes/Bar.js +1 -0
  372. package/es/src/shapes/Box.js +1 -0
  373. package/es/src/shapes/Circle.js +1 -0
  374. package/es/src/shapes/Line.js +1 -0
  375. package/es/src/shapes/Path.js +1 -0
  376. package/es/src/shapes/Rect.js +1 -0
  377. package/es/src/shapes/Shape.js +1 -0
  378. package/es/src/shapes/Whisker.js +1 -0
  379. package/es/src/utils/BaseClass.js +30 -12
  380. package/es/src/utils/configPrep.js +2 -1
  381. package/es/src/utils/configValue.js +9 -0
  382. package/es/src/utils/constant.js +13 -1
  383. package/es/src/utils/displayName.js +12 -0
  384. package/es/src/utils/theme.js +190 -0
  385. package/es/src/utils/themeInk.js +68 -0
  386. package/package.json +14 -11
  387. package/types/index.d.ts +6 -2
  388. package/types/internal.d.ts +268 -9
  389. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  390. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  391. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  392. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  393. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  394. package/types/src/charts/Alluvial/index.d.ts +27 -0
  395. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  396. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  397. package/types/src/charts/Alluvial/titles.d.ts +46 -0
  398. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  399. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  400. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  401. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  402. package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
  403. package/types/src/charts/ArcDiagram/events.d.ts +29 -0
  404. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  405. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  406. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  407. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  408. package/types/src/charts/Chord/labels.d.ts +66 -0
  409. package/types/src/charts/Donut/index.d.ts +2 -1
  410. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  411. package/types/src/charts/Gantt/emit.d.ts +17 -0
  412. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  413. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  414. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  415. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  416. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  417. package/types/src/charts/Gantt/index.d.ts +36 -0
  418. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  419. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  420. package/types/src/charts/Geomap/emit.d.ts +2 -2
  421. package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
  422. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  423. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  424. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  425. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  426. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  427. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  428. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  429. package/types/src/charts/Geomap/index.d.ts +3 -0
  430. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  431. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  432. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  433. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  434. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  435. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  436. package/types/src/charts/Hexbin/index.d.ts +25 -0
  437. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  438. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  439. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  440. package/types/src/charts/Histogram/binData.d.ts +20 -1
  441. package/types/src/charts/Histogram/index.d.ts +3 -2
  442. package/types/src/charts/Histogram/labels.d.ts +7 -0
  443. package/types/src/charts/Marimekko/index.d.ts +2 -1
  444. package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
  445. package/types/src/charts/Network/applyLayout.d.ts +11 -0
  446. package/types/src/charts/Network/bundle.d.ts +69 -0
  447. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  448. package/types/src/charts/Network/clusters.d.ts +115 -0
  449. package/types/src/charts/Network/graph.d.ts +73 -0
  450. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  451. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  452. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  453. package/types/src/charts/Pack/applyLayout.d.ts +2 -0
  454. package/types/src/charts/Pack/groupRows.d.ts +46 -0
  455. package/types/src/charts/Pack/index.d.ts +3 -0
  456. package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
  457. package/types/src/charts/Pack/nodeNames.d.ts +23 -0
  458. package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
  459. package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
  460. package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
  461. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  462. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  463. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  464. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  465. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  466. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  467. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  468. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  469. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  470. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  471. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  472. package/types/src/charts/Plot/areaEnter.d.ts +34 -0
  473. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  474. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  475. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  476. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  477. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  478. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  479. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  480. package/types/src/charts/Plot/index.d.ts +16 -15
  481. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  482. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  483. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  484. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  485. package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
  486. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  487. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  488. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  489. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  490. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  491. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  492. package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
  493. package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
  494. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  495. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  496. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  497. package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
  498. package/types/src/charts/Pyramid/gutter.d.ts +28 -6
  499. package/types/src/charts/Pyramid/scene.d.ts +1 -1
  500. package/types/src/charts/Radar/applyLayout.d.ts +2 -3
  501. package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
  502. package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
  503. package/types/src/charts/Radar/emit.d.ts +5 -2
  504. package/types/src/charts/Radar/index.d.ts +7 -2
  505. package/types/src/charts/Radar/points.d.ts +50 -0
  506. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  507. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  508. package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
  509. package/types/src/charts/Rings/emit.d.ts +72 -0
  510. package/types/src/charts/Rings/index.d.ts +4 -2
  511. package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
  512. package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
  513. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  514. package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
  515. package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
  516. package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
  517. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  518. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  519. package/types/src/charts/Sankey/emit.d.ts +58 -0
  520. package/types/src/charts/Sankey/labels.d.ts +19 -0
  521. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  522. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  523. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  524. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  525. package/types/src/charts/Scatter/index.d.ts +15 -0
  526. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  527. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  528. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  529. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  530. package/types/src/charts/Tree/applyLayout.d.ts +20 -0
  531. package/types/src/charts/Tree/keys.d.ts +25 -0
  532. package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
  533. package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
  534. package/types/src/charts/definition/makeChart.d.ts +3 -2
  535. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  536. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  537. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  538. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  539. package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
  540. package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
  541. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
  542. package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
  543. package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
  544. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  545. package/types/src/charts/events/click.legend.d.ts +2 -1
  546. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  547. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  548. package/types/src/charts/features/annotationText.d.ts +57 -0
  549. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  550. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  551. package/types/src/charts/features/axisTooltip.d.ts +49 -0
  552. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  553. package/types/src/charts/features/calloutScene.d.ts +40 -0
  554. package/types/src/charts/features/centerLabel.d.ts +75 -0
  555. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  556. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  557. package/types/src/charts/features/circleLabels.d.ts +130 -0
  558. package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
  559. package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
  560. package/types/src/charts/features/colorScaleHover.d.ts +13 -3
  561. package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
  562. package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
  563. package/types/src/charts/features/colorScaleTop.d.ts +30 -0
  564. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  565. package/types/src/charts/features/curvedArrows.d.ts +119 -0
  566. package/types/src/charts/features/depthKey.d.ts +19 -0
  567. package/types/src/charts/features/edgeArrows.d.ts +103 -4
  568. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  569. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  570. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  571. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  572. package/types/src/charts/features/hoverTicks.d.ts +30 -0
  573. package/types/src/charts/features/idleQueue.d.ts +46 -0
  574. package/types/src/charts/features/legendKeys.d.ts +34 -0
  575. package/types/src/charts/features/lineLabels.d.ts +15 -12
  576. package/types/src/charts/features/linkBundle.d.ts +16 -0
  577. package/types/src/charts/features/linkColor.d.ts +48 -0
  578. package/types/src/charts/features/linkFields.d.ts +16 -0
  579. package/types/src/charts/features/linkFocus.d.ts +51 -0
  580. package/types/src/charts/features/linkInteraction.d.ts +192 -0
  581. package/types/src/charts/features/linkKeys.d.ts +11 -0
  582. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  583. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  584. package/types/src/charts/features/linkLabels.d.ts +77 -0
  585. package/types/src/charts/features/linkWidths.d.ts +19 -0
  586. package/types/src/charts/features/networkMeasures.d.ts +53 -0
  587. package/types/src/charts/features/nodeStats.d.ts +93 -0
  588. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  589. package/types/src/charts/features/pathLabels.d.ts +41 -0
  590. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  591. package/types/src/charts/features/plotEndLabels.d.ts +14 -1
  592. package/types/src/charts/features/plotPaint.d.ts +17 -0
  593. package/types/src/charts/features/polyline.d.ts +32 -0
  594. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  595. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  596. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  597. package/types/src/charts/features/ringLabels.d.ts +164 -0
  598. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  599. package/types/src/charts/features/selfLoops.d.ts +165 -0
  600. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  601. package/types/src/charts/features/sharedFields.d.ts +11 -2
  602. package/types/src/charts/features/textHalo.d.ts +15 -0
  603. package/types/src/charts/index.d.ts +8 -0
  604. package/types/src/charts/partition/chartFields.d.ts +6 -1
  605. package/types/src/charts/partition/interaction.d.ts +6 -3
  606. package/types/src/charts/partition/zoom.d.ts +4 -4
  607. package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
  608. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  609. package/types/src/charts/pipeline/stages.d.ts +7 -0
  610. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  611. package/types/src/charts/polar/chrome.d.ts +19 -6
  612. package/types/src/charts/viz/Viz.d.ts +25 -4
  613. package/types/src/charts/viz/VizBase.d.ts +37 -8
  614. package/types/src/charts/viz/backgroundInk.d.ts +19 -4
  615. package/types/src/charts/viz/emphasis.d.ts +17 -0
  616. package/types/src/charts/viz/fillStroke.d.ts +7 -0
  617. package/types/src/charts/viz/focusRing.d.ts +25 -0
  618. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  619. package/types/src/charts/viz/history.d.ts +35 -0
  620. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  621. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  622. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  623. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  624. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  625. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  626. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  627. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  628. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  629. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  630. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  631. package/types/src/charts/viz/reportDrawError.d.ts +12 -0
  632. package/types/src/charts/viz/setCursor.d.ts +26 -0
  633. package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
  634. package/types/src/charts/viz/userClick.d.ts +35 -0
  635. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  636. package/types/src/charts/viz/vizFields.d.ts +37 -0
  637. package/types/src/charts/viz/vizRender.d.ts +2 -1
  638. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  639. package/types/src/charts/viz/vizTypes.d.ts +100 -7
  640. package/types/src/charts/viz/vizVisibility.d.ts +13 -0
  641. package/types/src/components/Axis/Axis.d.ts +34 -3
  642. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  643. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  644. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  645. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  646. package/types/src/components/Axis/axisBreak.d.ts +21 -3
  647. package/types/src/components/Axis/axisDefaults.d.ts +12 -0
  648. package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
  649. package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
  650. package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
  651. package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
  652. package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
  653. package/types/src/components/Axis/axisLayout.d.ts +9 -2
  654. package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
  655. package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
  656. package/types/src/components/Axis/axisLimit.d.ts +18 -0
  657. package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
  658. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  659. package/types/src/components/Axis/axisRounding.d.ts +8 -0
  660. package/types/src/components/Axis/axisTitle.d.ts +30 -0
  661. package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
  662. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  663. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  664. package/types/src/components/Axis/timeValues.d.ts +1 -1
  665. package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
  666. package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
  667. package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
  668. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  669. package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
  670. package/types/src/components/Legend/Legend.d.ts +6 -0
  671. package/types/src/components/Legend/legendCut.d.ts +31 -0
  672. package/types/src/components/Legend/legendRender.d.ts +6 -1
  673. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  674. package/types/src/components/TextBox.d.ts +5 -0
  675. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  676. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  677. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  678. package/types/src/components/Tooltip.d.ts +4 -3
  679. package/types/src/components/fontStack.d.ts +10 -0
  680. package/types/src/components/textBoxLayout.d.ts +18 -9
  681. package/types/src/components/textBoxPath.d.ts +59 -0
  682. package/types/src/components/textBoxScene.d.ts +51 -0
  683. package/types/src/components/textBoxWords.d.ts +33 -0
  684. package/types/src/components/textEllipsis.d.ts +6 -0
  685. package/types/src/fluent.d.ts +18 -0
  686. package/types/src/shapes/Area.d.ts +1 -0
  687. package/types/src/shapes/Bar.d.ts +1 -0
  688. package/types/src/shapes/Box.d.ts +1 -0
  689. package/types/src/shapes/Circle.d.ts +1 -0
  690. package/types/src/shapes/Line.d.ts +1 -0
  691. package/types/src/shapes/Path.d.ts +1 -0
  692. package/types/src/shapes/Rect.d.ts +1 -0
  693. package/types/src/shapes/Shape.d.ts +1 -0
  694. package/types/src/shapes/Whisker.d.ts +1 -0
  695. package/types/src/shapes/emitLabels.d.ts +1 -1
  696. package/types/src/utils/BaseClass.d.ts +9 -0
  697. package/types/src/utils/D3plusConfig.d.ts +1093 -266
  698. package/types/src/utils/configPrep.d.ts +2 -0
  699. package/types/src/utils/configValue.d.ts +8 -0
  700. package/types/src/utils/constant.d.ts +8 -0
  701. package/types/src/utils/displayName.d.ts +10 -0
  702. package/types/src/utils/index.d.ts +1 -1
  703. package/types/src/utils/theme.d.ts +170 -0
  704. package/types/src/utils/themeInk.d.ts +56 -0
  705. package/types/umd-entry.d.ts +4 -0
  706. package/umd/d3plus-core.full.js +72239 -41465
  707. package/umd/d3plus-core.full.min.js +2 -2
  708. package/umd/d3plus-core.js +46249 -19519
  709. package/umd/d3plus-core.min.js +2 -2
  710. package/es/src/components/Axis/gridStroke.js +0 -10
  711. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -10,11 +10,16 @@
10
10
  `vizDraw` via `runLayout(ctx, [...features])`.
11
11
  */ import { extent, sum } from "d3-array";
12
12
  import { unique } from "@d3plus/data";
13
- import { date, elem } from "@d3plus/dom";
13
+ import { date, elem, rtl as detectRTL } from "@d3plus/dom";
14
+ import { textBoxLines } from "../../components/textBoxScene.js";
14
15
  import { wholeWordFit, wholeWords } from "../../utils/wholeWords.js";
15
16
  import { zoomControlsBox, zoomControlsReach } from "../drawSteps/zoomControlsMarkup.js";
16
17
  import { getTopLeftContributions } from "../drawSteps/topLeftControls.js";
17
18
  import { topLeftControlsInset as topLeftControlsInsetRaw, topLeftControlsReach } from "../drawSteps/topLeftControlsMarkup.js";
19
+ import { effectiveDuration } from "../viz/reducedMotion.js";
20
+ import { timelineRangeBreaks } from "../Plot/plotRangeBreaks.js";
21
+ import { startingSelection } from "../pipeline/preDrawData.js";
22
+ import { classTimelineMode } from "../../components/Timeline/timelineMode.js";
18
23
  const VALID_POSITIONS = new Set([
19
24
  false,
20
25
  "top",
@@ -113,7 +118,7 @@ const VALID_POSITIONS = new Set([
113
118
  margin: claims
114
119
  };
115
120
  }
116
- /**
121
+ /* --------------------------- text-block features --------------------------- */ /** A TextBox `_textData()` row, as the text-block features read it. */ /**
117
122
  A little breathing room added to a NON-zero corner inset, on top of the
118
123
  exact pixel width the corner panel measured at. Without it, content
119
124
  insets to EXACTLY the corner box's edge — any tiny discrepancy between
@@ -300,11 +305,11 @@ const VALID_POSITIONS = new Set([
300
305
  // the title sat at the top of its claim regardless, reading noticeably
301
306
  // higher than the same-row zoom/back/search buttons beside it.
302
307
  const y = layoutMargin.top + drop + blockPadding;
303
- const lines = box.lines.map((str, i)=>({
304
- text: str,
305
- x: box.tA === "middle" ? width / 2 : box.tA === "end" ? width : 0,
306
- y: (i + 1) * lineHeight - (lineHeight - box.fS),
307
- width: box.widths?.[i] ?? 0
308
+ const rtl = detectRTL();
309
+ const placed = textBoxLines(box, width, rtl);
310
+ const lines = placed.lines.map((ln, i)=>({
311
+ ...ln,
312
+ y: (i + 1) * lineHeight - (lineHeight - box.fS)
308
313
  }));
309
314
  const panel = {
310
315
  type: "text",
@@ -315,8 +320,11 @@ const VALID_POSITIONS = new Set([
315
320
  font: {
316
321
  family: box.fF,
317
322
  size: box.fS,
318
- anchor: box.tA === "middle" || box.tA === "end" || box.tA === "start" ? box.tA : "start",
319
- baseline: "alphabetic"
323
+ anchor: placed.anchor,
324
+ baseline: "alphabetic",
325
+ ...rtl ? {
326
+ dir: "rtl"
327
+ } : {}
320
328
  },
321
329
  paint: {
322
330
  fill: box.fC,
@@ -416,14 +424,14 @@ const VALID_POSITIONS = new Set([
416
424
  condition: timelinePossible,
417
425
  enter: transform,
418
426
  parent: viz._select,
419
- duration: viz.schema.duration,
427
+ duration: effectiveDuration(viz),
420
428
  update: transform
421
429
  }).node();
422
430
  if (!timelinePossible) return {
423
431
  panel: null,
424
432
  margin: {}
425
433
  };
426
- const timeline = viz._timelineClass.renderMode("compute").domain(extent(ticks)).duration(viz.schema.duration).height(viz.schema.height - layoutMargin.bottom).locale(viz.schema.locale).select(timelineGroup).ticks(ticks.sort((a, b)=>+a - +b)).width(viz.schema.width - (layoutMargin.left + layoutMargin.right + padding.left + padding.right));
434
+ const timeline = viz._timelineClass.renderMode("compute").domain(extent(ticks)).duration(effectiveDuration(viz)).height(viz.schema.height - layoutMargin.bottom).locale(viz.schema.locale).select(timelineGroup).ticks(ticks.sort((a, b)=>+a - +b)).width(viz.schema.width - (layoutMargin.left + layoutMargin.right + padding.left + padding.right));
427
435
  // Clamp bound = the full time range (every tick); it never goes stale
428
436
  // mid-render. Clamping to `viz._filteredData`'s extent instead collapsed a
429
437
  // freshly-committed range down to the previous selection — the release
@@ -432,10 +440,10 @@ const VALID_POSITIONS = new Set([
432
440
  if (!viz._timelineSelection) {
433
441
  // First render only: default to the *filtered* extent, which the
434
442
  // synthesized default timeFilter pins to the latest period (see
435
- // vizPreDraw) — the historical default. `timelineDefault` overrides it.
443
+ // vizPreDraw). `timelineDefault` or `timelineConfig.selection` overrides it.
436
444
  // A row merged across periods holds each of their times.
437
445
  const filtered = extent((viz._filteredData || []).flatMap((d, i)=>viz.schema.time(d, i)).map((d)=>date(d)));
438
- viz._timelineSelection = viz.schema.timelineDefault || (filtered[0] ? filtered : fullExtent);
446
+ viz._timelineSelection = startingSelection(viz) || (filtered[0] ? filtered : fullExtent);
439
447
  } else {
440
448
  if (viz._timelineSelection[0] < fullExtent[0]) viz._timelineSelection[0] = fullExtent[0];
441
449
  if (viz._timelineSelection[1] > fullExtent[1]) viz._timelineSelection[1] = fullExtent[1];
@@ -444,7 +452,16 @@ const VALID_POSITIONS = new Set([
444
452
  // Repaint the scene when playback toggles without moving the selection
445
453
  // (e.g. a manual pause), so the play/pause glyph refreshes immediately.
446
454
  timeline._onPlayToggle = ()=>viz._scheduleSceneRepaint();
447
- const config = viz.schema.timelineConfig;
455
+ // The timeline hides what its time axis hides, unless `timelineConfig`
456
+ // sets its own `rangeBreaks`.
457
+ const inherited = timelineRangeBreaks(viz);
458
+ timeline.rangeBreaks(inherited.length ? inherited : false);
459
+ // `timelineConfig.selection` is where the timeline starts (see
460
+ // `startingSelection`); after that the viewer's selection stands.
461
+ const config = {
462
+ ...viz.schema.timelineConfig
463
+ };
464
+ delete config.selection;
448
465
  timeline.config(config).on("brush", (s)=>{
449
466
  // Filter on "end", not on every brush move. Re-rendering the whole Viz
450
467
  // mid-drag re-creates the d3-brush (and starts a brush transition),
@@ -458,6 +475,7 @@ const VALID_POSITIONS = new Set([
458
475
  setTimeFilter(viz, s);
459
476
  if (config.on && config.on.end) config.on.end(s);
460
477
  }).render();
478
+ classTimelineMode(timelineGroup, "d3plus-viz-timeline", timeline._buttonBehaviorCurrent);
461
479
  return {
462
480
  panel: null,
463
481
  margin: {
@@ -12,12 +12,27 @@ import { sanitizePosition, sideControlsDrop } from "./features.js";
12
12
  import { insetFrame, insetOrient, isInsetPending } from "./insetState.js";
13
13
  import { facetKey } from "../facet/facetData.js";
14
14
  import { colorScaleBucketRows } from "./colorScaleBucket.js";
15
+ import { colorScaleValue, linkColorScaleRows } from "./colorScaleValue.js";
16
+ import { bivariateFieldNames, bivariateSpec } from "./colorScaleBivariate.js";
17
+ import { axisRoom, configSize, isWide, sideFrame, swatchFrame } from "./colorScaleLimit.js";
18
+ import { paintTopColorScale } from "./colorScaleTop.js";
15
19
  import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
20
+ import { effectiveDuration } from "../viz/reducedMotion.js";
21
+ import { resetKeys } from "../../fluent.js";
16
22
  /**
17
23
  The colorScale's data: the chart's data rolled up per time/id (and per
18
24
  small-multiples panel, the values the panels color by), keeping rows with
19
- a colorScale value.
25
+ a colorScale value, then any links colored by number.
20
26
  */ function colorScaleData(viz) {
27
+ const links = linkColorScaleRows(viz);
28
+ if (typeof viz.schema.colorScale !== "function") return links;
29
+ const own = viz._colorScaleRows ? viz._colorScaleRows() : dataRows(viz);
30
+ return links.length ? [
31
+ ...own,
32
+ ...links
33
+ ] : own;
34
+ }
35
+ /** The chart's data rolled up per time/id/panel, keeping rows with a colorScale value. */ function dataRows(viz) {
21
36
  const facet = viz.schema.facet;
22
37
  const data = Array.from(rollup(viz._data, (leaves)=>merge(leaves, viz.schema.aggs), (d, i)=>`${viz.schema.time ? viz.schema.time(d, i) : "all"}-${facet ? facetKey(facet(d, i)) : "all"}-${viz._ids(d, i).join("_")}`).values());
23
38
  return data.filter((d, i)=>{
@@ -25,6 +40,13 @@ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
25
40
  return c !== undefined && c !== null;
26
41
  });
27
42
  }
43
+ /** The config a ColorScale merges each render's into, rather than replaces. */ const CONFIG_BAGS = [
44
+ "axisConfig",
45
+ "labelConfig",
46
+ "legendConfig",
47
+ "rectConfig"
48
+ ];
49
+ /** The `colorScaleConfig` keys each chart's ColorScale was last given. */ const configKeys = new WeakMap();
28
50
  /** The paint a bucket swatch takes from the chart's shapes: all but its fill. */ const SWATCH_STYLES = [
29
51
  "fillOpacity",
30
52
  "opacity",
@@ -62,7 +84,9 @@ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
62
84
  /**
63
85
  Configures and lays out the chart's `_colorScaleClass` into `frame`. It
64
86
  always runs in compute mode: Viz.toScene composes its scene, so the
65
- colorScale never paints a DOM copy of its own.
87
+ colorScale never paints a DOM copy of its own. The frame sets the
88
+ scale's width and height over the chart's `colorScaleConfig`, which
89
+ sizes the frame instead.
66
90
  */ function paintColorScale(viz, frame, show) {
67
91
  const transform = {
68
92
  opacity: frame.orient ? 1 : 0,
@@ -77,10 +101,28 @@ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
77
101
  duration: 0,
78
102
  update: transform
79
103
  }).node();
80
- if (!viz.schema.colorScale) return;
81
- viz._colorScaleClass.renderMode("compute").align(frame.align).duration(viz.schema.duration).data(colorScaleData(viz)).height(frame.height).locale(viz.schema.locale).orient(frame.orient).select(scaleGroup).value(viz.schema.colorScale).width(frame.width).legendConfig({
104
+ const value = colorScaleValue(viz);
105
+ if (!value) return;
106
+ const cs = viz._colorScaleClass;
107
+ // Each render starts from the ColorScale's defaults, so config the chart's
108
+ // colorScaleConfig gave it before and no longer gives it is dropped.
109
+ const config = viz.schema.colorScaleConfig;
110
+ cs.config(resetKeys(cs, [
111
+ ...CONFIG_BAGS,
112
+ ...configKeys.get(cs) ?? []
113
+ ]));
114
+ configKeys.set(cs, Object.keys(config));
115
+ const { limit } = frame;
116
+ const bivariate = bivariateSpec(viz);
117
+ cs._bivariateFields = bivariate ? bivariateFieldNames(viz, bivariate) : undefined;
118
+ cs.renderMode("compute").bivariate(Boolean(bivariate)).align(frame.align).duration(effectiveDuration(viz)).data(colorScaleData(viz)).locale(viz.schema.locale).orient(frame.orient).select(scaleGroup).value(value).legendConfig({
82
119
  shapeConfig: bucketSwatchConfig(viz)
83
- }).config(viz.schema.colorScaleConfig).hover(false).render();
120
+ })// Links colored by number are thin lines: keep the ramp's low end
121
+ // visible against a light background.
122
+ .ordinalRamp(linkColorScaleRows(viz).length > 0)// Read as the axis is laid out, once the chart's own config is applied.
123
+ .axisConfig({
124
+ maxSize: limit === undefined ? undefined : ()=>axisRoom(limit, cs.size(), cs.padding())
125
+ }).config(config).width(frame.width).height(frame.height).hover(false).render();
84
126
  }
85
127
  /** The colorScale's sanitized position side (false when hidden). */ function colorScalePosition(viz) {
86
128
  return sanitizePosition(viz.schema.colorScalePosition.bind(viz)(resolveSpec(viz)), viz);
@@ -91,20 +133,21 @@ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
91
133
  horizontally (`"row"`), sized against the chart area `area`. Returns its
92
134
  measured size, or null when it isn't showing.
93
135
  */ export function paintColorScaleInset(viz, orient, area) {
94
- const show = Boolean(viz.schema.colorScale) && colorScalePosition(viz) !== false && !viz.schema.colorScaleConfig.select;
136
+ const show = Boolean(colorScaleValue(viz)) && colorScalePosition(viz) !== false && !viz.schema.colorScaleConfig.select;
95
137
  const frame = insetFrame(orient, area);
96
138
  const maxSize = viz.schema.colorScaleMaxSize;
139
+ const config = viz.schema.colorScaleConfig;
97
140
  paintColorScale(viz, {
98
141
  x: 0,
99
142
  y: 0,
100
- width: orient === "row" ? min([
143
+ width: configSize(config, "width") ?? (orient === "row" ? min([
101
144
  maxSize,
102
145
  frame.width
103
- ]) : frame.width,
104
- height: orient === "column" ? min([
146
+ ]) : frame.width),
147
+ height: configSize(config, "height") ?? (orient === "column" ? min([
105
148
  maxSize,
106
149
  frame.height
107
- ]) : frame.height,
150
+ ]) : frame.height),
108
151
  orient: orient === "column" ? "right" : "bottom",
109
152
  align: "start"
110
153
  }, show);
@@ -142,11 +185,8 @@ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
142
185
  };
143
186
  }
144
187
  const position = colorScalePosition(viz);
145
- const wide = [
146
- "top",
147
- "bottom"
148
- ].includes(position);
149
- const showColorScale = viz.schema.colorScale && position;
188
+ const wide = isWide(position);
189
+ const showColorScale = colorScaleValue(viz) && position;
150
190
  const padding = viz.schema.colorScalePadding(viz) ? viz._padding : {
151
191
  top: 0,
152
192
  right: 0,
@@ -158,17 +198,23 @@ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
158
198
  // Share the bottom band with the bottom-right corner panel (size legend):
159
199
  // a bottom colorScale fits beside it, a side one ends above it.
160
200
  const corner = bottomRightClearance(viz, position, layoutMargin.bottom + padding.bottom, layoutMargin.right + padding.right);
201
+ // The `width` or `height` a chart's colorScaleConfig sets is the scale's
202
+ // length along its side, in place of colorScaleMaxSize, and its limit
203
+ // across it.
204
+ const config = viz.schema.colorScaleConfig;
205
+ const setWidth = configSize(config, "width");
206
+ const setHeight = configSize(config, "height");
161
207
  const availableWidth = viz.schema.width - (layoutMargin.left + layoutMargin.right + padding.left + padding.right) - corner.inset;
162
208
  const width = wide ? min([
163
- viz.schema.colorScaleMaxSize,
209
+ setWidth ?? viz.schema.colorScaleMaxSize,
164
210
  availableWidth
165
211
  ]) : viz.schema.width - (layoutMargin.left + layoutMargin.right);
166
212
  const availableHeight = viz.schema.height - (layoutMargin.bottom + layoutMargin.top + padding.bottom + padding.top) - drop - corner.drop;
167
213
  const height = !wide ? min([
168
- viz.schema.colorScaleMaxSize,
214
+ setHeight ?? viz.schema.colorScaleMaxSize,
169
215
  availableHeight
170
216
  ]) : viz.schema.height - (layoutMargin.bottom + layoutMargin.top);
171
- paintColorScale(viz, {
217
+ const frame = sideFrame({
172
218
  x: wide ? layoutMargin.left + padding.left + (availableWidth - width) / 2 : layoutMargin.left,
173
219
  y: wide ? layoutMargin.top : layoutMargin.top + padding.top + drop + (availableHeight - height) / 2,
174
220
  width,
@@ -180,7 +226,16 @@ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
180
226
  right: "end",
181
227
  top: "start"
182
228
  }[position] || "bottom"
183
- }, Boolean(showColorScale));
229
+ }, wide ? setHeight : setWidth);
230
+ const placed = showColorScale && !viz.schema.colorScaleConfig.select;
231
+ const paint = (at)=>{
232
+ paintColorScale(viz, at, Boolean(showColorScale));
233
+ // A Legend lays the swatches out within its own width and height.
234
+ const swatches = placed ? swatchFrame(viz._colorScaleClass, at) : undefined;
235
+ if (swatches) paintColorScale(viz, swatches, true);
236
+ };
237
+ // A scale at the top keeps clear of the corner control panels.
238
+ const topDrop = placed && position === "top" ? paintTopColorScale(viz, frame, height, paint) : (paint(frame), 0);
184
239
  const margin = {};
185
240
  if (showColorScale) {
186
241
  const scaleBounds = viz._colorScaleClass.outerBounds();
@@ -190,7 +245,7 @@ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
190
245
  // colorScale's claim when the legend is hidden. The colorScale
191
246
  // class is the source of truth.
192
247
  const csPadding = typeof viz._colorScaleClass.padding === "function" ? viz._colorScaleClass.padding() : viz._legendClass.padding();
193
- if (wide) margin[position] = scaleBounds.height + csPadding * 2;
248
+ if (wide) margin[position] = topDrop + scaleBounds.height + csPadding * 2;
194
249
  else margin[position] = scaleBounds.width + csPadding * 2;
195
250
  }
196
251
  }
@@ -6,43 +6,34 @@
6
6
  */ import { merge } from "@d3plus/data";
7
7
  import { elem } from "@d3plus/dom";
8
8
  import { configPrep } from "../../utils/index.js";
9
+ import { constantValue } from "../../utils/constant.js";
9
10
  import { cornerPlacements, sanitizePosition, sideControlsDrop } from "./features.js";
10
11
  import { bottomRightClearance } from "../drawSteps/bottomRightControlsMarkup.js";
11
12
  import { resolveSpec } from "../pipeline/resolveSpec.js";
12
13
  import { insetFrame, insetOrient, isInsetPending } from "./insetState.js";
13
14
  import { legendCategories, legendMergesIds } from "./legendCategory.js";
15
+ import { legendKeys, legendRows } from "./legendKeys.js";
16
+ import { effectiveDuration } from "../viz/reducedMotion.js";
14
17
  /**
15
18
  Rolls filtered legend data up by paint attributes, computes
16
19
  `viz._legendDepth` (the lowest groupBy level whose values are unique) and
17
20
  `viz._legendCategories` (see `legendCategory.ts`), then sorts it.
18
21
  Returns the `legendData` array plus the `fill`/`getAttr` accessors the
19
- render step reuses.
22
+ render step reuses. A legend set to a constant false (`legend(false)`)
23
+ gets no entries, and its depth and categories stay as they were.
20
24
  */ export function buildLegendData(viz) {
21
25
  // Source: `_legendData` from the rollupAndFilter pipeline stage — same
22
26
  // arg drawLegend received via `drawLegend.bind(this)(this._legendData)`.
23
- const data = viz._legendData || [];
24
- const getAttr = (d, i, attr)=>{
25
- const shape = viz.schema.shape(d, i);
26
- if (attr === "fill" && shape === "Line") attr = "stroke";
27
- const value = viz.schema.shapeConfig[shape] && viz.schema.shapeConfig[shape][attr] ? viz.schema.shapeConfig[shape][attr] : viz.schema.shapeConfig[attr];
28
- return typeof value === "function" ? value.bind(viz)(d, i) : value;
29
- };
30
- // Legend grouping key: the color *encoding* input, so categories keep their
31
- // own entry even when two resolve to the same hex (#788), while
32
- // opacity/texture still split entries that differ on those secondary
33
- // encodings. Falls back to the resolved fill when there's no color accessor
34
- // to key on (e.g. `.color(false)` with a custom `shapeConfig.fill`).
35
- const colorOf = (d, i)=>typeof viz.schema.color === "function" ? viz.schema.color(d, i) : undefined;
36
- const keyOf = (d, i, c)=>{
37
- const colorKey = c === undefined || c === null ? getAttr(d, i, "fill") : typeof c === "string" ? c : JSON.stringify(c);
38
- return [
39
- colorKey,
40
- getAttr(d, i, "opacity"),
41
- getAttr(d, i, "texture")
42
- ].join("_");
43
- };
27
+ const { getAttr, colorOf, keyOf } = legendKeys(viz);
44
28
  const legendKey = (d, i)=>keyOf(d, i, colorOf(d, i));
45
- const rollupData = viz.schema.colorScale ? data.filter((d, i)=>viz.schema.colorScale(d, i) === undefined) : data;
29
+ // A legend set to a constant false never shows, so it needs no entries.
30
+ const never = constantValue(viz.schema.legend);
31
+ if (never && !never.value) return {
32
+ legendData: [],
33
+ legendKey,
34
+ getAttr
35
+ };
36
+ const rollupData = legendRows(viz);
46
37
  const groups = new Map();
47
38
  rollupData.forEach((d, i)=>{
48
39
  const c = colorOf(d, i);
@@ -129,7 +120,7 @@ import { legendCategories, legendMergesIds } from "./legendCategory.js";
129
120
  duration: 0,
130
121
  update: transform
131
122
  }).node();
132
- viz._legendClass.renderMode("compute").id(legendKey).align(frame.align).direction(frame.direction).duration(viz.schema.duration).data(frame.visible ? legendData : []).height(frame.height).locale(viz.schema.locale).parent(viz).select(legendGroup).shape((d, i)=>{
123
+ viz._legendClass.renderMode("compute").id(legendKey).align(frame.align).direction(frame.direction).duration(effectiveDuration(viz)).data(frame.visible ? legendData : []).height(frame.height).locale(viz.schema.locale).parent(viz).select(legendGroup).shape((d, i)=>{
133
124
  const shape = viz.schema.shape(d, i);
134
125
  return shape === "Circle" || shape === "Line" ? shape : "Rect";
135
126
  }).verticalAlign(frame.verticalAlign).width(frame.width).shapeConfig(configPrep.bind(viz)(viz.schema.shapeConfig, "legend")).shapeConfig({
@@ -0,0 +1,41 @@
1
+ /**
2
+ Discrete axis ticks that follow the hover: each tick label is stamped
3
+ with the value it stands for (see `hoverMatch`), so while marks are
4
+ hovered the labels of their buckets stay at full opacity and the rest dim
5
+ with the other marks. Continuous axes show a hover badge instead (see
6
+ `Plot/axisHover.ts`).
7
+ */ /** Whether an Axis draws discrete buckets (a band, ordinal, or point scale). */ export const discreteAxis = (axis)=>[
8
+ "band",
9
+ "ordinal",
10
+ "point"
11
+ ].includes(`${axis?.schema?.scale}`);
12
+ /**
13
+ Stamps every tick label in an axis scene with `hoverMatch`: the tick's
14
+ value, matched against `field` on the hovered marks' data.
15
+ @param node The axis scene (or any subtree of it).
16
+ @param field The datum key a mark keeps the axis value under.
17
+ */ export function tagHoverTicks(node, field) {
18
+ const tick = node.datum?.data;
19
+ if (node.type === "text" && tick && "tick" in tick && "id" in tick) node.hoverMatch = {
20
+ field,
21
+ value: tick.id
22
+ };
23
+ const kids = node.children;
24
+ if (kids) for (const child of kids)tagHoverTicks(child, field);
25
+ }
26
+ /**
27
+ The values under `field` in a datum or any datum it wraps (the first one
28
+ that has it), as strings; an array value gives each of its items.
29
+ */ export function datumValues(datum, field) {
30
+ let d = datum;
31
+ while(d && typeof d === "object"){
32
+ if (Object.prototype.hasOwnProperty.call(d, field)) {
33
+ const v = d[field];
34
+ return (Array.isArray(v) ? v : [
35
+ v
36
+ ]).map(String);
37
+ }
38
+ d = d.data;
39
+ }
40
+ return [];
41
+ }
@@ -0,0 +1,72 @@
1
+ /**
2
+ Work spread over the browser's idle time: jobs run in short turns from
3
+ `requestIdleCallback` (or `setTimeout` where it is missing), so no turn
4
+ keeps the main thread busy for long.
5
+ */ /** What `requestIdleCallback` hands its callback. */ /** The longest a turn runs, in milliseconds, however long the browser stays idle. */ export const IDLE_BUDGET = 12;
6
+ /** The longest a job waits for an idle moment before it runs anyway, in milliseconds. */ const IDLE_TIMEOUT = 2000;
7
+ /** Calls `fn` at the next idle moment, or soon after when the browser has no idle callbacks. */ export function requestIdle(fn) {
8
+ const ric = globalThis.requestIdleCallback;
9
+ if (typeof ric === "function") ric(fn, {
10
+ timeout: IDLE_TIMEOUT
11
+ });
12
+ else setTimeout(()=>fn(undefined), 1);
13
+ }
14
+ const now = ()=>typeof performance !== "undefined" ? performance.now() : Date.now();
15
+ /**
16
+ Jobs keyed by name, run one after another in idle turns. Callbacks
17
+ passed to `beforeNext` run at the start of the next turn, before any job.
18
+ */ export class IdleQueue {
19
+ jobs = new Map();
20
+ before = [];
21
+ waiting = false;
22
+ /** How many jobs are waiting or running. */ get size() {
23
+ return this.jobs.size;
24
+ }
25
+ /** Whether a job named `key` is waiting or running. */ has(key) {
26
+ return this.jobs.has(key);
27
+ }
28
+ /** Queues `job` under `key`, unless a job of that name is already queued. */ add(key, job) {
29
+ if (this.jobs.has(key)) return;
30
+ this.jobs.set(key, job);
31
+ this.wake();
32
+ }
33
+ /** Cancels every job whose name isn't in `keys`. */ keep(keys) {
34
+ for (const key of [
35
+ ...this.jobs.keys()
36
+ ])if (!keys.has(key)) this.jobs.delete(key);
37
+ }
38
+ /** Cancels every job and every `beforeNext` callback. */ clear() {
39
+ this.jobs.clear();
40
+ this.before.length = 0;
41
+ }
42
+ /** Runs `fn` at the start of the next idle turn. */ beforeNext(fn) {
43
+ this.before.push(fn);
44
+ this.wake();
45
+ }
46
+ wake() {
47
+ if (this.waiting) return;
48
+ this.waiting = true;
49
+ requestIdle((deadline)=>this.turn(deadline));
50
+ }
51
+ /** One idle turn: the `beforeNext` callbacks, then jobs until the turn's time is up. */ turn(deadline) {
52
+ this.waiting = false;
53
+ const start = now();
54
+ const budget = Math.min(IDLE_BUDGET, deadline ? deadline.timeRemaining() : IDLE_BUDGET);
55
+ for (const fn of this.before.splice(0))fn();
56
+ for (const [key, job] of this.jobs){
57
+ const left = budget - (now() - start);
58
+ if (job.step(left) && this.jobs.get(key) === job) this.jobs.delete(key);
59
+ if (now() - start >= budget) break;
60
+ }
61
+ if (this.jobs.size || this.before.length) this.wake();
62
+ }
63
+ }
64
+ const queues = new WeakMap();
65
+ /** The idle queue of `owner` (a chart), made on first use. */ export function idleQueue(owner) {
66
+ let queue = queues.get(owner);
67
+ if (!queue) queues.set(owner, queue = new IdleQueue());
68
+ return queue;
69
+ }
70
+ /** Cancels the idle work of `owner` (a chart), if it has any. */ export function cancelIdleWork(owner) {
71
+ queues.get(owner)?.clear();
72
+ }
@@ -0,0 +1,64 @@
1
+ /**
2
+ How the legend groups rows into entries: by the color each row encodes,
3
+ its opacity and its texture.
4
+ */ import { constantValue } from "../../utils/constant.js";
5
+ /**
6
+ The legend's key functions for a chart.
7
+ @param viz The chart.
8
+ */ export function legendKeys(viz) {
9
+ const getAttr = (d, i, attr)=>{
10
+ const shape = viz.schema.shape(d, i);
11
+ if (attr === "fill" && shape === "Line") attr = "stroke";
12
+ const value = viz.schema.shapeConfig[shape] && viz.schema.shapeConfig[shape][attr] ? viz.schema.shapeConfig[shape][attr] : viz.schema.shapeConfig[attr];
13
+ return typeof value === "function" ? value.bind(viz)(d, i) : value;
14
+ };
15
+ // Legend grouping key: the color *encoding* input, so categories keep their
16
+ // own entry even when two resolve to the same hex (#788), while
17
+ // opacity/texture still split entries that differ on those secondary
18
+ // encodings. Falls back to the resolved fill when there's no color accessor
19
+ // to key on (e.g. `.color(false)` with a custom `shapeConfig.fill`).
20
+ const colorOf = (d, i)=>typeof viz.schema.color === "function" ? viz.schema.color(d, i) : undefined;
21
+ const keyOf = (d, i, c)=>{
22
+ const colorKey = c === undefined || c === null ? getAttr(d, i, "fill") : typeof c === "string" ? c : JSON.stringify(c);
23
+ return [
24
+ colorKey,
25
+ getAttr(d, i, "opacity"),
26
+ getAttr(d, i, "texture")
27
+ ].join("_");
28
+ };
29
+ return {
30
+ getAttr,
31
+ colorOf,
32
+ keyOf
33
+ };
34
+ }
35
+ /**
36
+ The rows the legend rolls up: `_legendData`, less the rows a colorScale
37
+ colors.
38
+ @param viz The chart.
39
+ */ export function legendRows(viz) {
40
+ const data = viz._legendData || [];
41
+ return viz.schema.colorScale ? data.filter((d, i)=>viz.schema.colorScale(d, i) === undefined) : data;
42
+ }
43
+ /**
44
+ How many entries the legend has (the number `buildLegendData` rolls its
45
+ rows into), counting no further than `limit + 1`: enough to tell whether
46
+ there are more than `limit`. A legend set to a constant false has none.
47
+ @param viz The chart.
48
+ @param limit The count past which to stop.
49
+ */ export function legendEntryCount(viz, limit = Infinity) {
50
+ const never = constantValue(viz.schema.legend);
51
+ if (never && !never.value) return 0;
52
+ const { colorOf, keyOf } = legendKeys(viz);
53
+ const keys = new Set();
54
+ const data = viz._legendData || [];
55
+ const scaled = Boolean(viz.schema.colorScale);
56
+ let j = 0;
57
+ for(let i = 0; i < data.length && keys.size <= limit; i++){
58
+ const d = data[i];
59
+ if (scaled && viz.schema.colorScale(d, i) !== undefined) continue;
60
+ keys.add(keyOf(d, j, colorOf(d, j)));
61
+ j++;
62
+ }
63
+ return keys.size;
64
+ }