@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
@@ -6,8 +6,12 @@
6
6
  everything here is non-interactive scenery drawn beneath the marks.
7
7
  */ import { textWidth } from "@d3plus/dom";
8
8
  import { emitLabels } from "../../shapes/emitLabels.js";
9
+ import { textLineBoxes } from "../features/linkLabels.js";
10
+ import { clearRingLabels } from "../features/ringLabelNodes.js";
11
+ import { ringLabelPosition } from "../features/ringLabels.js";
9
12
  import { radarAxisLabelLayout, RADAR_EDGE_GAP, RADAR_LABEL_MAX_LINES } from "../Radar/axisLabels.js";
10
13
  import { labelFont, radarLevelLabelNodes, radarRingNodes } from "../Radar/axisDecorations.js";
14
+ import { radarCurveNodes, radarCurvedLayout, radarCurvesAt } from "../Radar/curvedLabels.js";
11
15
  import { textWrap } from "@d3plus/text";
12
16
  import { POLAR_LABEL_PADDING, polarHorizontalLayout, polarLabelPlacement, polarLabelsCollide, polarSpokeRotation } from "./labels.js";
13
17
  /** The narrowest box a category label is laid out in, in pixels. */ const LABEL_MIN_WIDTH = 12;
@@ -62,17 +66,61 @@ const alignFor = (uy)=>uy < -0.3 ? "bottom" : uy > 0.3 ? "top" : "middle";
62
66
  }
63
67
  /**
64
68
  Lays out the category labels around a circle centered in `width` ×
65
- `height`, and the circle's radius. `outerPadding` "auto" sizes both from
66
- the measured labels; a number reserves that many pixels around the
67
- circle. With `show` false, the circle fills the area.
69
+ `height`, and the circle's radius. `outerPadding` "auto" curves every
70
+ label just outside the circle when they all fit (see `labelPosition`),
71
+ which leaves the circle the most room, and otherwise sizes both from the
72
+ measured straight labels; a number reserves that many pixels around the
73
+ circle. Either way, a label that fits along the circle curves. With
74
+ `show` false, the circle fills the area.
68
75
  */ export function polarCategoryLayout(viz, categories, width, height, show = true) {
69
76
  const half = Math.max(0, Math.min(width, height) / 2);
70
77
  if (!show || !categories.length) return {
71
78
  radius: half,
72
- labels: []
79
+ labels: [],
80
+ curves: []
73
81
  };
74
- const outerPadding = viz.schema.outerPadding;
75
82
  const fonts = categories.map((c, i)=>labelFont(viz, c.text, c.data, i));
83
+ const inputs = categories.map((c, i)=>({
84
+ text: c.text,
85
+ data: c.data,
86
+ angle: c.angle - Math.PI / 2,
87
+ span: c.span,
88
+ font: fonts[i]
89
+ }));
90
+ const curveLabels = (curves)=>categories.flatMap((c, i)=>{
91
+ const curve = curves[i];
92
+ return curve ? [
93
+ {
94
+ key: c.key,
95
+ data: c.data,
96
+ i,
97
+ curve
98
+ }
99
+ ] : [];
100
+ });
101
+ const room = Math.max(0, half - RADAR_EDGE_GAP);
102
+ if (typeof viz.schema.outerPadding !== "number") {
103
+ const curved = radarCurvedLayout(viz, inputs, room);
104
+ if (curved) return {
105
+ radius: curved.radius,
106
+ labels: [],
107
+ curves: curveLabels(curved.curves)
108
+ };
109
+ }
110
+ const straight = straightLayout(viz, categories, fonts, width, height);
111
+ const curves = radarCurvesAt(viz, inputs, straight.radius, room);
112
+ return {
113
+ radius: straight.radius,
114
+ labels: straight.labels.filter((l, i)=>!curves[i] && ringLabelPosition(viz, l.data, i) !== "along"),
115
+ curves: curveLabels(curves)
116
+ };
117
+ }
118
+ /**
119
+ The straight category labels: read horizontally, or along their spokes
120
+ when neighbors would overlap that way.
121
+ */ function straightLayout(viz, categories, fonts, width, height) {
122
+ const half = Math.max(0, Math.min(width, height) / 2);
123
+ const outerPadding = viz.schema.outerPadding;
76
124
  const style = (i)=>({
77
125
  "font-family": fonts[i].fontFamily,
78
126
  "font-size": fonts[i].fontSize,
@@ -131,11 +179,24 @@ const alignFor = (uy)=>uy < -0.3 ? "bottom" : uy > 0.3 ? "top" : "middle";
131
179
  outerPadding
132
180
  });
133
181
  }
134
- /** Builds the category label nodes laid out by `polarCategoryLayout`. */ export function polarCategoryNodes(viz, labels, key) {
135
- if (!labels.length) return [];
182
+ /**
183
+ Builds the category label nodes laid out by `polarCategoryLayout`: the
184
+ curved ones, and the straight ones that stay clear of them.
185
+ */ export function polarCategoryNodes(viz, { labels, curves }, key) {
186
+ if (!labels.length && !curves.length) return [];
136
187
  const axisConfig = viz.schema.axisConfig;
188
+ const labelConfig = axisConfig.shapeConfig?.labelConfig ?? {};
189
+ // Each label follows the hover of its slot's marks (see `hoverKeys`).
190
+ const curved = radarCurveNodes(viz, curves.map((c)=>({
191
+ ...c,
192
+ key: `${key}-label-${c.key}`,
193
+ hoverMatch: {
194
+ field: "slot",
195
+ value: c.key
196
+ }
197
+ })), labelConfig);
137
198
  const asLabel = (d)=>d;
138
- const nodes = emitLabels({
199
+ const straight = emitLabels({
139
200
  data: labels,
140
201
  label: (d)=>asLabel(d).text,
141
202
  x: (d)=>asLabel(d).x,
@@ -145,10 +206,21 @@ const alignFor = (uy)=>uy < -0.3 ? "bottom" : uy > 0.3 ? "top" : "middle";
145
206
  id: (d)=>`${key}-label-${asLabel(d).id}`,
146
207
  labelBounds: (d)=>asLabel(d).labelBounds,
147
208
  labelConfig: {
148
- ...axisConfig.shapeConfig?.labelConfig ?? {},
209
+ ...labelConfig,
149
210
  verticalAlign: (d)=>d.data?.verticalAlign ?? "middle"
150
211
  }
151
212
  });
213
+ for (const n of straight){
214
+ const slot = n.datum?.data?.id;
215
+ if (slot !== undefined) n.hoverMatch = {
216
+ field: "slot",
217
+ value: slot
218
+ };
219
+ }
220
+ const nodes = [
221
+ ...curved,
222
+ ...clearRingLabels(straight, textLineBoxes(curved))
223
+ ];
152
224
  for (const n of nodes)n.interactive = false;
153
225
  return nodes.length ? [
154
226
  {
@@ -4,10 +4,9 @@
4
4
  */ import { formatAbbreviate } from "@d3plus/format";
5
5
  import { arcPath } from "@d3plus/render";
6
6
  import constant from "../../utils/constant.js";
7
- import { gridStroke } from "../../components/Axis/gridStroke.js";
8
7
  import { backgroundImageNodes } from "../features/backgroundImageEmit.js";
9
8
  import { paintFromShapeConfig, shapeConfigFor } from "../features/emitHelpers.js";
10
- import { backgroundInk } from "../viz/backgroundInk.js";
9
+ import { backgroundInk, chartGridline } from "../viz/backgroundInk.js";
11
10
  /**
12
11
  The axis styles, named after the parts of a Plot axis like Radar's: the
13
12
  inner value rings are gridlines (`gridConfig`), the outer ring is the axis
@@ -20,7 +19,7 @@ import { backgroundInk } from "../viz/backgroundInk.js";
20
19
  strokeWidth: 1
21
20
  },
22
21
  gridConfig: {
23
- stroke: ()=>gridStroke(viz._select?.node(), viz.schema.colorDefaults),
22
+ stroke: ()=>chartGridline(viz),
24
23
  strokeWidth: 1
25
24
  },
26
25
  shapeConfig: {
@@ -61,6 +60,10 @@ import { backgroundInk } from "../viz/backgroundInk.js";
61
60
  arc: w.arc,
62
61
  datum: w.data,
63
62
  index: w.i,
63
+ // Its category's labels stay bright while it's hovered.
64
+ hoverKeys: {
65
+ slot: w.slot
66
+ },
64
67
  // Explicit, so an exiting wedge fades from a real starting opacity.
65
68
  paint: {
66
69
  ...paint,
@@ -92,6 +92,7 @@ import { polarSharedExtent } from "./polarFacet.js";
92
92
  key: s.key,
93
93
  text: opts.slotLabel(s.key, members),
94
94
  angle: s.angle,
95
+ span: s.endAngle - s.startAngle,
95
96
  data: members.length === 1 ? members[0] : merge(members, aggs)
96
97
  };
97
98
  });
@@ -123,7 +124,7 @@ import { polarSharedExtent } from "./polarFacet.js";
123
124
  const chrome = polarLevelNodes(viz, levels, outer, toRadius, opts.key);
124
125
  const scene = Array.isArray(viz._chartScene) ? viz._chartScene : viz._chartScene = [];
125
126
  if (opts.trackPaint) scene.push(trackGroup(opts.key, slots, tracks, opts.trackPaint));
126
- scene.push(...chrome.rings, ...polarCategoryNodes(viz, layout.labels, opts.key), ...chrome.labels);
127
+ scene.push(...chrome.rings, ...polarCategoryNodes(viz, layout, opts.key), ...chrome.labels);
127
128
  const frame = {
128
129
  inner,
129
130
  outer,
@@ -12,13 +12,22 @@ import { unregisterLink } from "./linkGroup.js";
12
12
  import { stopDataPolling } from "./vizDataPolling.js";
13
13
  import { facetPanelAt, withFacetPanel } from "../facet/facetPanel.js";
14
14
  import { vizRender } from "./vizRender.js";
15
+ import { motionReduced } from "./reducedMotion.js";
15
16
  import { vizDraw } from "../pipeline/vizDraw.js";
16
17
  import { vizPreDraw } from "../pipeline/vizPreDraw.js";
17
18
  import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
18
19
  import { reportHandlerError } from "./reportHandlerError.js";
19
20
  import { vizClassNameTargets } from "./vizClassName.js";
21
+ import { themeBackground, unwatchPageTheme } from "./vizTheme.js";
22
+ import { releaseScene, stopVisibilityWatch } from "./vizVisibility.js";
20
23
  import { applyClassName, withRootClasses } from "../../utils/className.js";
21
- import { handleColorScaleHover } from "../features/colorScaleHover.js";
24
+ import { handleAxisTooltip } from "../features/axisTooltip.js";
25
+ import { handleColorScaleHover, handleSwatchLabelHover } from "../features/colorScaleHover.js";
26
+ import { appendFocusRing, syncKeyboardNav, teardownKeyboardNav } from "./keyboardNav.js";
27
+ import { mountTargetFor } from "./mountTarget.js";
28
+ import { resetCursor } from "./setCursor.js";
29
+ import { routePointerEvent } from "./nearestHover.js";
30
+ import { nearestHoverSurface } from "./nearestHoverSurface.js";
22
31
  /**
23
32
  Stamps `interactionGroup` onto a component's scene subtree so the pointer
24
33
  bridge can route its nodes to component-scoped handlers (e.g. legend) on
@@ -28,18 +37,10 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
28
37
  const kids = node.children;
29
38
  if (kids) for (const child of kids)tagInteractionGroup(child, group);
30
39
  }
31
- /**
32
- Resolves the element a renderer mounts into. A `<canvas>` cannot paint inside
33
- an `<svg>`, so when the scene target is the compute svg, the canvas mounts
34
- into that svg's parent (the user's element); the emptied, position:absolute
35
- compute svg overlays the same top-left box. SVG mounts into the target as-is.
36
- */ function mountTargetFor(kind, target) {
37
- if (kind === "canvas" && typeof Element !== "undefined" && target instanceof Element && target.tagName.toLowerCase() === "svg") return target.parentNode ?? target;
38
- return target;
39
- }
40
40
  /**
41
41
  The base class every d3plus chart extends. Owns the shared configuration surface (data, groupBy, size and color accessors, title, legend, tooltip, timeline, zoom, table view) and the render lifecycle that each chart type's definition plugs its layout into. Not used directly; see the chart classes (BarChart, Treemap, …).
42
42
  */ export default class Viz extends VizBase {
43
+ static _displayName = "Viz";
43
44
  /**
44
45
  Invoked when creating a new class instance, and sets any default parameters.
45
46
  @private
@@ -62,7 +63,7 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
62
63
  - chart-level components (Legend/ColorScale/Timeline) via their toScene
63
64
  - `_featurePanels` (from FeatureModule layouts) wrapped in viz-features
64
65
  */ toScene() {
65
- const children = [];
66
+ const children = themeBackground(this);
66
67
  // Chart cells stashed on _chartScene — via `chartDef.emit(ctx)` for
67
68
  // data-driven charts, or `Plot._paint` for the paint-driven Plot family.
68
69
  // Wraps in three groups:
@@ -169,6 +170,8 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
169
170
  children: this._featurePanels
170
171
  });
171
172
  }
173
+ // Keyboard navigation's focus ring, above everything else.
174
+ appendFocusRing(this, children);
172
175
  return {
173
176
  width: this.schema.width,
174
177
  height: this.schema.height,
@@ -200,6 +203,13 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
200
203
  */ _insetRegion() {
201
204
  return null;
202
205
  }
206
+ /**
207
+ The table view's rows, when the chart shows more than its data (see
208
+ `ChartDefinition.tableData`). The base chart shows its data.
209
+ @private
210
+ */ _tableData() {
211
+ return null;
212
+ }
203
213
  /**
204
214
  The shape a colorScale row draws as (see
205
215
  `ChartDefinition.colorScaleShape`): the row's `shape`, unless the chart
@@ -248,8 +258,8 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
248
258
  }
249
259
  }
250
260
  /**
251
- Draws the visualization given the specified configuration.
252
- @param callback Optional callback invoked after rendering completes.
261
+ Draws the visualization given the specified configuration. An error thrown while the chart draws (by an accessor in its config, say) is logged with `console.error`, and the chart keeps what it last painted.
262
+ @param callback Optional callback invoked after rendering completes. It also runs after every later redraw that doesn't pass a callback of its own, including the ones the chart starts itself (legend clicks, resizes, reloading after scrolling back into view), so it can redraw anything it adds to the chart. It still runs when the draw throws.
253
263
  */ render(callback) {
254
264
  return vizRender(this, callback);
255
265
  }
@@ -301,8 +311,9 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
301
311
  // `durationOverride` defaults to the chart's `_duration` for normal
302
312
  // re-renders. Interaction handlers (zoomed, hover, etc.) pass 0 to
303
313
  // skip the transition machinery — animating every wheel/drag tick
304
- // accumulates `setTimeout(duration+10)` per event.
305
- const drawDuration = durationOverride !== undefined ? durationOverride : this._instantNextDraw ? 0 : this.schema.duration;
314
+ // accumulates `setTimeout(duration+10)` per event. Reduced motion
315
+ // zeroes every draw, overrides included.
316
+ const drawDuration = motionReduced(this) ? 0 : durationOverride !== undefined ? durationOverride : this._instantNextDraw ? 0 : this.schema.duration;
306
317
  // A duration>0 render (drill-down, zoom, re-center) must win over any
307
318
  // pending coalesced duration-0 repaint — otherwise that repaint fires on
308
319
  // the next frame and interrupts this transition, snapping shapes to their
@@ -375,6 +386,8 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
375
386
  applyZoomPointerEvents(this);
376
387
  if (this._select && kind === "canvas") this._select.selectAll("g.d3plus-viz-timeline, g.d3plus-viz-brush").style("pointer-events", "auto");
377
388
  if (kind === "canvas") bindCanvasZoom(this);
389
+ nearestHoverSurface(this);
390
+ syncKeyboardNav(this);
378
391
  // The timeline brush (d3-brush DOM, mounted in `g.d3plus-viz-timeline` in
379
392
  // the outer svg) must paint above the scene-rendered timeline buttons/ticks
380
393
  // so its selection tint + handles sit on top of them (matching v3). The
@@ -403,6 +416,22 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
403
416
  */ _interactionDatum(pick, _event) {
404
417
  return handlerDatum(pick.datum, pick.index ?? 0);
405
418
  }
419
+ /**
420
+ The `groupBy` level a shape's row stands for (see
421
+ `ChartDefinition.shapeDepth`): undefined in the base chart, where every
422
+ shape sits at the level the chart draws.
423
+ @private
424
+ */ _shapeDepth(_d) {
425
+ return undefined;
426
+ }
427
+ /**
428
+ Whether a painted scene node is a point mark that nearest-point hover
429
+ (`hoverDistance`) resolves the pointer to. None in the base chart;
430
+ charts drawn with points (Plot, Network, Geomap) accept theirs.
431
+ @private
432
+ */ _pointMark(_node) {
433
+ return false;
434
+ }
406
435
  /**
407
436
  Pointer hook run by `_routeSceneEvent` before any handler routing, for
408
437
  every event including ones over empty space. No-op here; Plot overrides
@@ -441,6 +470,8 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
441
470
  // transition timers; without this, switching kind (svg<->canvas) or
442
471
  // container orphans that DOM in the user's element, stacking the old
443
472
  // mode's output behind the new one and accumulating on every switch.
473
+ // The surface it leaves behind drops the hand cursor it may hold.
474
+ if (this._sceneRenderer) resetCursor(this);
444
475
  if (this._sceneRenderer && typeof this._sceneRenderer.destroy === "function") this._sceneRenderer.destroy();
445
476
  const Ctor = kind === "canvas" ? CanvasRenderer : SvgRenderer;
446
477
  this._sceneRenderer = new Ctor();
@@ -457,13 +488,12 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
457
488
  // tooltips never fire on the v4 scene-rendered path because
458
489
  // `shape.on(evt, fn)` in plotPaint only wires d3-selection
459
490
  // listeners on DOM nodes the scene renderer doesn't create.
460
- // Renderer events carry the picked scene node; the routing lives in
461
- // `_routeSceneEvent` (kept out of this method so the mount path stays
462
- // readable). `_lastScenePick` remembers the most recently hovered node
491
+ // Renderer events carry the picked scene node; `routePointerEvent`
492
+ // resolves nearest-point hover, then `_routeSceneEvent` routes them. `_lastScenePick` remembers the most recently hovered node
463
493
  // so `mouseleave` — fired with a null pick — can still tell the matching
464
494
  // handlers which shape/legend item was left (so the tooltip clears).
465
495
  this._lastScenePick = null;
466
- this._sceneRenderer.on((event)=>this._routeSceneEvent(event));
496
+ this._sceneRenderer.on((event)=>routePointerEvent(this, event));
467
497
  } else {
468
498
  this._sceneRenderer.resize(w, h);
469
499
  }
@@ -500,6 +530,12 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
500
530
  // the transition guard below, so leaving mid-transition still clears it.
501
531
  this._sharedHover(event);
502
532
  handleColorScaleHover(this, event);
533
+ // An axis title or tick label with a tooltip of its own (see
534
+ // `handleAxisTooltip`), shown last so nothing above replaces it; a
535
+ // swatch label showing one also lights its bucket.
536
+ const axisTip = handleAxisTooltip(this, event);
537
+ handleSwatchLabelHover(this, event, axisTip);
538
+ if (axisTip) return;
503
539
  if (this._transitionEndsAt && Date.now() < this._transitionEndsAt) return;
504
540
  const pick = event.pick;
505
541
  // Dispatch helper shared by the live-pick path and the leave path.
@@ -601,44 +637,20 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
601
637
  });
602
638
  }
603
639
  /**
604
- Tears down the visualization: disconnects the ResizeObserver, stops listening for web font loads and polling for data, and removes DOM event listeners. Call this when unmounting to avoid memory leaks.
640
+ Tears down the visualization: disconnects the ResizeObserver, stops listening for web font loads and polling for data, cancels work waiting for idle time, and removes DOM event listeners. Call this when unmounting to avoid memory leaks.
605
641
  */ destroy() {
606
642
  unregisterLink(this);
643
+ teardownKeyboardNav(this);
644
+ nearestHoverSurface(this, true);
645
+ unwatchPageTheme(this);
607
646
  stopDataPolling(this);
608
647
  this._resizeObserver?.disconnect();
609
648
  this._fontsUnsubscribe?.();
610
649
  this._fontsUnsubscribe = undefined;
611
650
  this._tooltipClass.data([]).render();
612
651
  select("body").on(`touchstart.${this._uuid}`, null);
613
- // Clear the visibility/resize/scroll poll timers + scroll listener
614
- // so a destroyed chart doesn't keep firing intervals/timeouts that
615
- // hold the entire viz instance alive. Without this, an SPA that
616
- // mounts/unmounts charts on tab switches leaks the scene tree +
617
- // a 200ms-interval timer per leaked chart.
618
- if (this._visiblePoll) {
619
- this._visiblePoll = clearInterval(this._visiblePoll);
620
- }
621
- if (this._resizePoll) {
622
- this._resizePoll = clearTimeout(this._resizePoll);
623
- }
624
- if (this._scrollPoll) {
625
- this._scrollPoll = clearTimeout(this._scrollPoll);
626
- }
627
- this._visibleUnobserve?.();
628
- this._visibleUnobserve = undefined;
629
- this._unloadUnobserve?.();
630
- this._unloadUnobserve = undefined;
631
- if (this._sceneRepaintRAF != null) {
632
- if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(this._sceneRepaintRAF);
633
- this._sceneRepaintRAF = undefined;
634
- }
635
- if (this.schema.scrollContainer) select(this.schema.scrollContainer).on(`scroll.${this._uuid}`, null);
636
- // Destroy the active scene renderer (clears its own pointer-rect
637
- // listeners, overlay host, canvas/svg DOM, timers).
638
- if (this._sceneRenderer && typeof this._sceneRenderer.destroy === "function") {
639
- this._sceneRenderer.destroy();
640
- this._sceneRenderer = undefined;
641
- }
652
+ stopVisibilityWatch(this);
653
+ releaseScene(this);
642
654
  return this;
643
655
  }
644
656
  }
@@ -1,21 +1,27 @@
1
1
  import { select } from "d3-selection";
2
- import { addToQueue, unique } from "@d3plus/data";
2
+ import { unique } from "@d3plus/data";
3
3
  import { fontFamilyStringify } from "@d3plus/text";
4
4
  import { date } from "@d3plus/dom";
5
5
  import { BaseClass, constant } from "../../utils/index.js";
6
6
  import { fieldAccessor } from "../../utils/fieldAccessor.js";
7
7
  import { coerceFacet } from "../facet/facetConfig.js";
8
8
  import { groupDepthOf } from "./groupRow.js";
9
+ import { dropLegendHistory } from "./history.js";
9
10
  import { broadcastLink } from "./linkGroup.js";
10
11
  import { shapeHoverEnabled } from "./shapeHover.js";
12
+ import { setLoaderValue } from "./loaderFormat.js";
11
13
  import { stopDataPolling } from "./vizDataPolling.js";
14
+ import { setZoomBrush, zoomBy } from "../drawSteps/zoomActions.js";
15
+ import { isBrushing } from "../drawSteps/zoomControlsMarkup.js";
12
16
  import { isPlainObject, mergeConfigBag, resolvesReset } from "../../fluent.js";
13
17
  import validateShapeConfig from "../../shapes/validateShapeConfig.js";
18
+ import { displayName } from "../../utils/displayName.js";
14
19
  /**
15
20
  The fluent config accessors shared by every Viz chart that need more than
16
- storing their value (most are generated from `vizFields.ts`); `Viz` adds
17
- the render lifecycle.
21
+ storing their value (most are generated from `vizFields.ts`), and the
22
+ zoom actions; `Viz` adds the render lifecycle.
18
23
  */ class VizBase extends BaseClass {
24
+ static _displayName = "VizBase";
19
25
  /**
20
26
  The active callback function for highlighting shapes.
21
27
  */ active(_) {
@@ -35,25 +41,29 @@ import validateShapeConfig from "../../shapes/validateShapeConfig.js";
35
41
 
36
42
  If your data URL needs specific headers to be set, an Object with a "url" and "headers" (or any other `fetch` request option) may also be passed. An Object with any other key is a data row, not a request.
37
43
 
38
- Additionally, a custom formatting function can be passed as a second argument to this method. This custom function will be passed the data that has been loaded, as long as there are no errors. This function should return the final array of obejcts to be used as the primary data array. For example, some JSON APIs return the headers split from the data values to save bandwidth. These would need be joined using a custom formatter.
44
+ To transform the data before it is drawn (for example, a JSON API that returns its headers split from its values), set `dataFormat`. Passing a formatter as a second argument to this method sets `dataFormat`; calling it with only data keeps the current `dataFormat`.
39
45
 
40
- If you would like to specify certain configuration options based on the yet-to-be-loaded data, you can also return a full `config` object from the data formatter (including the new `data` array as a key in the object).
41
-
42
- To re-fetch a URL on an interval and redraw when its data changes, set `dataPollingInterval`; each poll runs the same formatter.
46
+ To re-fetch a URL on an interval and redraw when its data changes, set `dataPollingInterval`; each poll runs `dataFormat`.
43
47
 
44
48
  Defaults to an empty array (`[]`).
45
- @param f The data array or a URL string to load data from.
49
+ @param _ The data array or a URL string to load data from.
50
+ @param f Sets `dataFormat`.
46
51
  */ data(_, f) {
47
52
  if (arguments.length) {
48
- addToQueue.bind(this)(_, f, "data");
53
+ setLoaderValue(this, "data", arguments.length > 1 ? [
54
+ _,
55
+ f
56
+ ] : [
57
+ _
58
+ ]);
49
59
  this._hidden = [];
50
60
  this._solo = [];
61
+ dropLegendHistory(this);
51
62
  if (this._userData && JSON.stringify(_) !== JSON.stringify(this._userData)) {
52
63
  this.schema.timeFilter = false;
53
64
  this._timelineSelection = false;
54
65
  }
55
66
  this._userData = _;
56
- this._userDataFormat = f;
57
67
  this._dataSignature = undefined;
58
68
  stopDataPolling(this);
59
69
  return this;
@@ -146,6 +156,7 @@ Defaults to an empty array (`[]`).
146
156
  }
147
157
  hover(_) {
148
158
  if (!arguments.length) return this._hover;
159
+ const hadHover = typeof this._hover === "function";
149
160
  let hoverFunction = this._hover = _;
150
161
  if (this.schema.shapeConfig.hoverOpacity !== 1 && _ !== undefined) {
151
162
  if (typeof _ === "function") {
@@ -178,8 +189,10 @@ Defaults to an empty array (`[]`).
178
189
  // (`hoverOpacity: 1`, e.g. Geomap): the bucket highlight is applied by that
179
190
  // same pass, so without a repaint the map would never re-compose. Coalesced
180
191
  // to one paint per frame so a fast pointer sweep doesn't saturate the main
181
- // thread.
182
- if (this._sceneRenderer && _ !== undefined && (shapeHoverEnabled(this) || this._hoverBucket)) this._scheduleSceneRepaint();
192
+ // thread. Clearing a highlight always repaints: leaving a colorScale
193
+ // swatch clears its highlight a moment after the next shape's hover has
194
+ // already reset `_hoverBucket`.
195
+ if (this._sceneRenderer && _ !== undefined && (shapeHoverEnabled(this) || this._hoverBucket || hadHover)) this._scheduleSceneRepaint();
183
196
  broadcastLink(this, "hover", _);
184
197
  return this;
185
198
  }
@@ -205,7 +218,7 @@ Defaults to an empty array (`[]`).
205
218
  }
206
219
  shapeConfig(_) {
207
220
  if (!arguments.length) return this.schema.shapeConfig;
208
- if (isPlainObject(_)) validateShapeConfig(this.constructor.name, _);
221
+ if (isPlainObject(_)) validateShapeConfig(displayName(this), _);
209
222
  this.schema.shapeConfig = mergeConfigBag(this, "shapeConfig", _);
210
223
  return this;
211
224
  }
@@ -269,7 +282,7 @@ Defaults to an empty array (`[]`).
269
282
  } else return this.schema.time;
270
283
  }
271
284
  /**
272
- The starting time or range for the timeline. Can be a single Date/String, or an Array of 2 values representing the min and max.
285
+ The starting time or range for the timeline, which the chart starts on too. Can be a single Date/String, or an Array of 2 values representing the min and max. A viewer's pick on the timeline replaces it.
273
286
  */ timelineDefault(_) {
274
287
  if (arguments.length) {
275
288
  if (!(_ instanceof Array)) _ = [
@@ -290,6 +303,36 @@ Defaults to an empty array (`[]`).
290
303
  return this;
291
304
  } else return this.schema.total;
292
305
  }
306
+ /**
307
+ Zooms the chart in by `zoomFactor` about the center of the chart area,
308
+ as the zoom-in button does. Works whether or not the zoom-control
309
+ buttons show (see `zoomControls`), so a page's own button can call it;
310
+ does nothing while `zoom` is off or before the chart first renders.
311
+ */ zoomIn() {
312
+ zoomBy(this, this.schema.zoomFactor);
313
+ return this;
314
+ }
315
+ /**
316
+ Zooms the chart out by `zoomFactor` about the center of the chart
317
+ area, as the zoom-out button does. Does nothing while `zoom` is off or
318
+ before the chart first renders.
319
+ */ zoomOut() {
320
+ zoomBy(this, 1 / this.schema.zoomFactor);
321
+ return this;
322
+ }
323
+ /**
324
+ Returns the chart to its initial, unzoomed view, as the reset button
325
+ does. Does nothing while `zoom` is off or before the chart first
326
+ renders.
327
+ */ zoomReset() {
328
+ zoomBy(this, 0);
329
+ return this;
330
+ }
331
+ zoomBrush(_) {
332
+ if (!arguments.length) return isBrushing(this);
333
+ setZoomBrush(this, Boolean(_));
334
+ return this;
335
+ }
293
336
  }
294
337
  resolvesReset(VizBase.prototype, "facetConfig", "shapeConfig");
295
338
  export default VizBase; /* eslint-enable @typescript-eslint/no-unsafe-declaration-merging */
@@ -1,17 +1,33 @@
1
- import { colorContrast } from "@d3plus/color";
2
- import { backgroundColor } from "@d3plus/dom";
1
+ import { interpolateRgb } from "d3-interpolate";
2
+ import { inkBackground, inkGrid, inkText } from "../../utils/themeInk.js";
3
3
  /**
4
- The chart's background color, as detected behind its container (white
4
+ The chart's background: its theme's (the page's own in `"auto"` mode), or,
5
+ before the chart has drawn, the one detected behind its container (white
5
6
  before the chart is mounted).
6
7
  @private
7
8
  */ export function chartBackground(viz) {
8
- const node = viz._select && typeof viz._select.node === "function" ? viz._select.node() : null;
9
- return node ? backgroundColor(node) : "rgb(255, 255, 255)";
9
+ return inkBackground(viz);
10
10
  }
11
11
  /**
12
12
  The text color that reads against the chart's own background: dark on a
13
- light page, light on a dark one.
13
+ light page, light on a dark one, or the theme's `text`.
14
14
  @private
15
15
  */ export function backgroundInk(viz) {
16
- return colorContrast(chartBackground(viz), viz.schema.colorDefaults);
16
+ return inkText(viz);
17
+ }
18
+ /**
19
+ The chart's gridline color: the theme's `gridline`, a faint step off the
20
+ chart's background.
21
+ @private
22
+ */ export function chartGridline(viz) {
23
+ return inkGrid(viz);
24
+ }
25
+ /**
26
+ A neutral fill between the chart's background and its ink, for a mark
27
+ that stands for a group rather than one value: Treemap's group headers
28
+ and Pack's group circles while a colorScale colors the rest, and Pack's
29
+ outermost circle.
30
+ @private
31
+ */ export function neutralFill(viz) {
32
+ return interpolateRgb(chartBackground(viz), backgroundInk(viz))(0.7);
17
33
  }
@@ -0,0 +1,14 @@
1
+ /**
2
+ How hover and active emphasize a matched mark (see
3
+ `applyInteractionOpacity`): its stroke darkened by `darken` and drawn
4
+ `width` times as wide.
5
+ */ export const STROKE_EMPHASIS = {
6
+ hover: {
7
+ darken: 0.5,
8
+ width: 2
9
+ },
10
+ active: {
11
+ darken: 1,
12
+ width: 3
13
+ }
14
+ };
@@ -0,0 +1,10 @@
1
+ import { color } from "d3-color";
2
+ /**
3
+ The stroke the chart's default `shapeConfig.stroke` draws around `fill`:
4
+ a shade darker, or the fill itself when it doesn't parse as a color (e.g.
5
+ "none"/"transparent" on a confidence band), which has no darker shade.
6
+ @private
7
+ */ export function fillStroke(fill) {
8
+ const c = color(fill);
9
+ return c ? c.darker(0.25).toString() : fill;
10
+ }