@d3plus/core 4.9.0 → 4.11.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 (687) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +170 -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 +170 -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 +81 -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 +178 -0
  17. package/es/src/charts/ArcDiagram/events.js +144 -0
  18. package/es/src/charts/ArcDiagram/index.js +215 -0
  19. package/es/src/charts/BarChart/index.js +14 -2
  20. package/es/src/charts/BoxWhisker/index.js +95 -4
  21. package/es/src/charts/BoxWhisker/outliers.js +68 -0
  22. package/es/src/charts/BoxWhisker/summary.js +83 -0
  23. package/es/src/charts/BoxWhisker/tooltip.js +122 -0
  24. package/es/src/charts/BubbleChart/emit.js +31 -0
  25. package/es/src/charts/BubbleChart/index.js +54 -0
  26. package/es/src/charts/Bullet/index.js +2 -1
  27. package/es/src/charts/BumpChart/index.js +5 -0
  28. package/es/src/charts/Calendar/emit.js +1 -1
  29. package/es/src/charts/Calendar/index.js +5 -3
  30. package/es/src/charts/Candlestick/aggregate.js +11 -1
  31. package/es/src/charts/Candlestick/buffer.js +6 -4
  32. package/es/src/charts/Candlestick/index.js +7 -6
  33. package/es/src/charts/Chord/applyLayout.js +56 -69
  34. package/es/src/charts/Chord/emit.js +55 -24
  35. package/es/src/charts/Chord/index.js +17 -12
  36. package/es/src/charts/Chord/labels.js +105 -0
  37. package/es/src/charts/Donut/index.js +5 -11
  38. package/es/src/charts/Dumbbell/index.js +2 -4
  39. package/es/src/charts/Funnel/index.js +2 -1
  40. package/es/src/charts/Gantt/applyLayout.js +162 -0
  41. package/es/src/charts/Gantt/emit.js +142 -0
  42. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  43. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  44. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  45. package/es/src/charts/Gantt/ganttRows.js +111 -0
  46. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  47. package/es/src/charts/Gantt/index.js +219 -0
  48. package/es/src/charts/Gauge/index.js +2 -1
  49. package/es/src/charts/Geomap/applyLayout.js +90 -49
  50. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  51. package/es/src/charts/Geomap/emit.js +19 -2
  52. package/es/src/charts/Geomap/flowEmit.js +132 -0
  53. package/es/src/charts/Geomap/flowEvents.js +86 -0
  54. package/es/src/charts/Geomap/flowFields.js +91 -0
  55. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  56. package/es/src/charts/Geomap/flowLinks.js +239 -0
  57. package/es/src/charts/Geomap/geoCache.js +180 -0
  58. package/es/src/charts/Geomap/globeKeys.js +131 -0
  59. package/es/src/charts/Geomap/globeRotate.js +208 -0
  60. package/es/src/charts/Geomap/index.js +60 -19
  61. package/es/src/charts/Geomap/pointLabels.js +107 -0
  62. package/es/src/charts/Hexbin/binning.js +103 -0
  63. package/es/src/charts/Hexbin/buffer.js +33 -0
  64. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  65. package/es/src/charts/Hexbin/contours.js +48 -0
  66. package/es/src/charts/Hexbin/emit.js +142 -0
  67. package/es/src/charts/Hexbin/index.js +204 -0
  68. package/es/src/charts/Hexbin/layers.js +212 -0
  69. package/es/src/charts/Hexbin/settings.js +86 -0
  70. package/es/src/charts/Hexbin/tooltip.js +77 -0
  71. package/es/src/charts/Histogram/binData.js +31 -4
  72. package/es/src/charts/Histogram/index.js +37 -16
  73. package/es/src/charts/Histogram/labels.js +18 -0
  74. package/es/src/charts/Icicle/index.js +3 -3
  75. package/es/src/charts/LinePlot/index.js +7 -0
  76. package/es/src/charts/Marimekko/index.js +7 -4
  77. package/es/src/charts/Matrix/index.js +3 -2
  78. package/es/src/charts/Network/applyLayout.js +138 -94
  79. package/es/src/charts/Network/bundle.js +81 -0
  80. package/es/src/charts/Network/clusterLabels.js +423 -0
  81. package/es/src/charts/Network/clusters.js +290 -0
  82. package/es/src/charts/Network/emit.js +253 -70
  83. package/es/src/charts/Network/graph.js +117 -0
  84. package/es/src/charts/Network/graphFluent.js +79 -0
  85. package/es/src/charts/Network/index.js +93 -108
  86. package/es/src/charts/Network/minNodeDistance.js +64 -0
  87. package/es/src/charts/Network/polygonRows.js +44 -0
  88. package/es/src/charts/Pack/index.js +7 -2
  89. package/es/src/charts/Pie/applyLayout.js +86 -27
  90. package/es/src/charts/Pie/arcFit.js +152 -0
  91. package/es/src/charts/Pie/curvedLabels.js +134 -0
  92. package/es/src/charts/Pie/emit.js +43 -96
  93. package/es/src/charts/Pie/index.js +66 -32
  94. package/es/src/charts/Pie/labelRoom.js +154 -0
  95. package/es/src/charts/Pie/outsideLabels.js +224 -0
  96. package/es/src/charts/Pie/outsideNodes.js +267 -0
  97. package/es/src/charts/Pie/pieLabels.js +137 -0
  98. package/es/src/charts/Pie/sectorBox.js +223 -0
  99. package/es/src/charts/Pie/straightLabels.js +96 -0
  100. package/es/src/charts/Pie/straightLayout.js +215 -0
  101. package/es/src/charts/Plot/alongLegend.js +76 -0
  102. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  103. package/es/src/charts/Plot/axisHover.js +180 -0
  104. package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
  105. package/es/src/charts/Plot/axisHoverScene.js +203 -0
  106. package/es/src/charts/Plot/axisValues.js +43 -0
  107. package/es/src/charts/Plot/barHitArea.js +81 -0
  108. package/es/src/charts/Plot/barLabelFit.js +123 -0
  109. package/es/src/charts/Plot/barWidth.js +61 -13
  110. package/es/src/charts/Plot/circleLabels.js +98 -0
  111. package/es/src/charts/Plot/confidenceConfig.js +2 -2
  112. package/es/src/charts/Plot/connectGaps.js +237 -0
  113. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  114. package/es/src/charts/Plot/draw.js +14 -4
  115. package/es/src/charts/Plot/fillBetween.js +2 -1
  116. package/es/src/charts/Plot/forecastScene.js +3 -4
  117. package/es/src/charts/Plot/index.js +42 -15
  118. package/es/src/charts/Plot/labelPlacement.js +10 -2
  119. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  120. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  121. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  122. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  123. package/es/src/charts/Plot/openDomainEnds.js +2 -5
  124. package/es/src/charts/Plot/pipeline.js +71 -22
  125. package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
  126. package/es/src/charts/Plot/pipelineDomains.js +23 -6
  127. package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
  128. package/es/src/charts/Plot/pipelineScales.js +40 -8
  129. package/es/src/charts/Plot/plotFacet.js +12 -1
  130. package/es/src/charts/Plot/plotInit.js +49 -5
  131. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  132. package/es/src/charts/Plot/plotZoom.js +15 -6
  133. package/es/src/charts/Plot/referenceDomains.js +133 -0
  134. package/es/src/charts/Plot/shapeDefaults.js +14 -9
  135. package/es/src/charts/Plot/sharedHoverScene.js +50 -31
  136. package/es/src/charts/Plot/sharedTooltip.js +19 -7
  137. package/es/src/charts/Plot/stackHelpers.js +13 -1
  138. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  139. package/es/src/charts/Plot/stackShareTooltip.js +9 -4
  140. package/es/src/charts/Plot/stackThreshold.js +154 -0
  141. package/es/src/charts/Plot/trendLabels.js +183 -0
  142. package/es/src/charts/Plot/trendLines.js +1 -0
  143. package/es/src/charts/Plot/trendScene.js +6 -3
  144. package/es/src/charts/Plot/trendTooltip.js +5 -1
  145. package/es/src/charts/PolarArea/index.js +5 -4
  146. package/es/src/charts/Priestley/applyLayout.js +14 -20
  147. package/es/src/charts/Priestley/index.js +4 -34
  148. package/es/src/charts/Priestley/timeAxis.js +100 -0
  149. package/es/src/charts/Pyramid/index.js +4 -2
  150. package/es/src/charts/Radar/axisDecorations.js +49 -12
  151. package/es/src/charts/Radar/curvedLabels.js +187 -0
  152. package/es/src/charts/Radar/index.js +5 -5
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +4 -1
  155. package/es/src/charts/RadialBar/index.js +18 -10
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/index.js +6 -9
  158. package/es/src/charts/Rings/applyLayout.js +41 -24
  159. package/es/src/charts/Rings/emit.js +174 -58
  160. package/es/src/charts/Rings/index.js +65 -30
  161. package/es/src/charts/Rings/ringsGraph.js +28 -9
  162. package/es/src/charts/Rings/ringsLoops.js +73 -0
  163. package/es/src/charts/Rings/ringsParallel.js +166 -0
  164. package/es/src/charts/Sankey/applyLayout.js +116 -39
  165. package/es/src/charts/Sankey/circularLayout.js +208 -0
  166. package/es/src/charts/Sankey/circularLinks.js +301 -0
  167. package/es/src/charts/Sankey/emit.js +164 -94
  168. package/es/src/charts/Sankey/index.js +75 -77
  169. package/es/src/charts/Sankey/labels.js +80 -0
  170. package/es/src/charts/Sankey/ribbons.js +88 -0
  171. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  172. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  173. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  174. package/es/src/charts/Scatter/index.js +25 -0
  175. package/es/src/charts/SlopeChart/index.js +116 -0
  176. package/es/src/charts/SlopeChart/slope.js +95 -0
  177. package/es/src/charts/Streamgraph/index.js +51 -0
  178. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  179. package/es/src/charts/Sunburst/emit.js +74 -63
  180. package/es/src/charts/Sunburst/index.js +3 -3
  181. package/es/src/charts/Tree/index.js +2 -6
  182. package/es/src/charts/Treemap/applyLayout.js +14 -1
  183. package/es/src/charts/Treemap/emit.js +8 -2
  184. package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
  185. package/es/src/charts/Treemap/groupHeaders.js +95 -0
  186. package/es/src/charts/Treemap/index.js +17 -7
  187. package/es/src/charts/Treemap/thresholdFunction.js +11 -9
  188. package/es/src/charts/Violin/inner.js +3 -5
  189. package/es/src/charts/Waffle/index.js +4 -2
  190. package/es/src/charts/Waffle/tooltip.js +6 -2
  191. package/es/src/charts/Waterfall/index.js +4 -2
  192. package/es/src/charts/definition/makeChart.js +20 -5
  193. package/es/src/charts/drawSteps/backControl.js +17 -5
  194. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  195. package/es/src/charts/drawSteps/minimap.js +6 -5
  196. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  197. package/es/src/charts/drawSteps/saveChart.js +176 -0
  198. package/es/src/charts/drawSteps/saveControl.js +148 -0
  199. package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
  200. package/es/src/charts/drawSteps/searchControls.js +2 -1
  201. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  202. package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
  203. package/es/src/charts/drawSteps/topLeftControls.js +3 -1
  204. package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
  205. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  206. package/es/src/charts/events/click.legend.js +7 -2
  207. package/es/src/charts/events/click.shape.js +38 -2
  208. package/es/src/charts/events/mouseenter.js +9 -0
  209. package/es/src/charts/events/mousemove.legend.js +3 -0
  210. package/es/src/charts/events/mousemove.shape.js +12 -4
  211. package/es/src/charts/facet/drawFacets.js +14 -5
  212. package/es/src/charts/facet/facetConfig.js +2 -2
  213. package/es/src/charts/facet/facetData.js +2 -2
  214. package/es/src/charts/features/annotationFrame.js +179 -0
  215. package/es/src/charts/features/annotationText.js +83 -0
  216. package/es/src/charts/features/annotationTypes.js +10 -0
  217. package/es/src/charts/features/attributionFeature.js +6 -11
  218. package/es/src/charts/features/axes.js +9 -7
  219. package/es/src/charts/features/axesFinal.js +26 -4
  220. package/es/src/charts/features/axesMeasure.js +61 -6
  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/chartGeometry.js +1 -1
  224. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  225. package/es/src/charts/features/circleLabels.js +207 -0
  226. package/es/src/charts/features/colorScaleBucket.js +19 -1
  227. package/es/src/charts/features/colorScaleHover.js +70 -0
  228. package/es/src/charts/features/colorScaleValue.js +97 -0
  229. package/es/src/charts/features/curvedArrows.js +158 -0
  230. package/es/src/charts/features/edgeArrows.js +160 -4
  231. package/es/src/charts/features/edgeBundling.js +442 -0
  232. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  233. package/es/src/charts/features/ensureZoomDom.js +32 -8
  234. package/es/src/charts/features/features.js +45 -15
  235. package/es/src/charts/features/featuresColorScale.js +62 -8
  236. package/es/src/charts/features/featuresLegend.js +21 -32
  237. package/es/src/charts/features/legendKeys.js +64 -0
  238. package/es/src/charts/features/lineLabels.js +55 -46
  239. package/es/src/charts/features/linkBundle.js +19 -0
  240. package/es/src/charts/features/linkColor.js +72 -0
  241. package/es/src/charts/features/linkFields.js +86 -0
  242. package/es/src/charts/features/linkFocus.js +118 -0
  243. package/es/src/charts/features/linkInteraction.js +312 -0
  244. package/es/src/charts/features/linkKeys.js +20 -0
  245. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  246. package/es/src/charts/features/linkLabelPath.js +162 -0
  247. package/es/src/charts/features/linkLabels.js +340 -0
  248. package/es/src/charts/features/linkWidths.js +32 -0
  249. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  250. package/es/src/charts/features/pathLabels.js +50 -0
  251. package/es/src/charts/features/plotAnnotations.js +68 -17
  252. package/es/src/charts/features/plotPaint.js +42 -15
  253. package/es/src/charts/features/polyline.js +129 -0
  254. package/es/src/charts/features/referenceAnnotations.js +403 -0
  255. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  256. package/es/src/charts/features/ringLabelNodes.js +93 -0
  257. package/es/src/charts/features/ringLabels.js +222 -0
  258. package/es/src/charts/features/sceneBounds.js +26 -6
  259. package/es/src/charts/features/selfLoops.js +306 -0
  260. package/es/src/charts/features/shapeEmit.js +67 -30
  261. package/es/src/charts/features/shareKey.js +15 -0
  262. package/es/src/charts/features/sharedFields.js +15 -2
  263. package/es/src/charts/features/textHalo.js +29 -0
  264. package/es/src/charts/features/thresholdMembers.js +71 -0
  265. package/es/src/charts/helpers/densityChart.js +3 -1
  266. package/es/src/charts/helpers/valueTitle.js +6 -3
  267. package/es/src/charts/index.js +8 -0
  268. package/es/src/charts/partition/chartFields.js +6 -5
  269. package/es/src/charts/partition/hierarchy.js +2 -0
  270. package/es/src/charts/partition/interaction.js +9 -5
  271. package/es/src/charts/partition/zoom.js +7 -6
  272. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  273. package/es/src/charts/pipeline/preDrawData.js +77 -13
  274. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  275. package/es/src/charts/pipeline/vizDraw.js +40 -29
  276. package/es/src/charts/pipeline/vizPreDraw.js +29 -18
  277. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  278. package/es/src/charts/polar/config.js +2 -3
  279. package/es/src/charts/viz/Viz.js +82 -44
  280. package/es/src/charts/viz/VizBase.js +47 -19
  281. package/es/src/charts/viz/backgroundInk.js +13 -7
  282. package/es/src/charts/viz/dataPoller.js +52 -0
  283. package/es/src/charts/viz/focusRing.js +104 -0
  284. package/es/src/charts/viz/focusTargets.js +208 -0
  285. package/es/src/charts/viz/groupRow.js +35 -0
  286. package/es/src/charts/viz/history.js +74 -0
  287. package/es/src/charts/viz/interactionOpacity.js +19 -5
  288. package/es/src/charts/viz/keyboardNav.js +297 -0
  289. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  290. package/es/src/charts/viz/loaderFormat.js +114 -0
  291. package/es/src/charts/viz/missingFields.js +123 -0
  292. package/es/src/charts/viz/mountTarget.js +9 -0
  293. package/es/src/charts/viz/nearestHover.js +183 -0
  294. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  295. package/es/src/charts/viz/ordinalColor.js +14 -12
  296. package/es/src/charts/viz/pageTheme.js +83 -0
  297. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  298. package/es/src/charts/viz/pointVoronoi.js +124 -0
  299. package/es/src/charts/viz/reducedMotion.js +27 -0
  300. package/es/src/charts/viz/reportHandlerError.js +10 -0
  301. package/es/src/charts/viz/shapeClassTargets.js +18 -2
  302. package/es/src/charts/viz/simpleHover.js +2 -0
  303. package/es/src/charts/viz/vizClassName.js +31 -0
  304. package/es/src/charts/viz/vizDataPolling.js +172 -0
  305. package/es/src/charts/viz/vizDefaults.js +81 -23
  306. package/es/src/charts/viz/vizFields.js +53 -2
  307. package/es/src/charts/viz/vizRender.js +49 -28
  308. package/es/src/charts/viz/vizTheme.js +96 -0
  309. package/es/src/charts/viz/vizVisibility.js +14 -0
  310. package/es/src/components/Axis/Axis.js +34 -0
  311. package/es/src/components/Axis/AxisBottom.js +1 -0
  312. package/es/src/components/Axis/AxisLeft.js +1 -0
  313. package/es/src/components/Axis/AxisRight.js +1 -0
  314. package/es/src/components/Axis/AxisTop.js +1 -0
  315. package/es/src/components/Axis/axisBreak.js +4 -1
  316. package/es/src/components/Axis/axisDefaults.js +8 -10
  317. package/es/src/components/Axis/axisLabelAngle.js +175 -0
  318. package/es/src/components/Axis/axisLabelThinning.js +13 -4
  319. package/es/src/components/Axis/axisLayout.js +86 -19
  320. package/es/src/components/Axis/axisLayoutLabels.js +66 -13
  321. package/es/src/components/Axis/axisLayoutScale.js +10 -1
  322. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  323. package/es/src/components/Axis/axisRender.js +38 -9
  324. package/es/src/components/Axis/axisRounding.js +15 -4
  325. package/es/src/components/Axis/axisSlantWrap.js +39 -0
  326. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  327. package/es/src/components/Axis/powTicks.js +73 -0
  328. package/es/src/components/Axis/rangeBreaks.js +201 -0
  329. package/es/src/components/Axis/timeValues.js +19 -4
  330. package/es/src/components/ColorScale/ColorScale.js +42 -36
  331. package/es/src/components/ColorScale/bucketBounds.js +64 -0
  332. package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
  333. package/es/src/components/ColorScale/colorScaleRender.js +25 -1
  334. package/es/src/components/ColorScale/colorScaleScale.js +43 -24
  335. package/es/src/components/ColorScale/colorScaleType.js +26 -0
  336. package/es/src/components/Legend/Legend.js +3 -0
  337. package/es/src/components/Legend/legendConfig.js +2 -6
  338. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  339. package/es/src/components/TextBox.js +31 -65
  340. package/es/src/components/Timeline/Timeline.js +54 -54
  341. package/es/src/components/Timeline/brushSpan.js +78 -0
  342. package/es/src/components/Timeline/timelineConfig.js +27 -10
  343. package/es/src/components/Timeline/timelineMode.js +26 -0
  344. package/es/src/components/Timeline/timelineRender.js +51 -9
  345. package/es/src/components/Tooltip.js +28 -13
  346. package/es/src/components/fontStack.js +20 -0
  347. package/es/src/components/textBoxLayout.js +58 -21
  348. package/es/src/components/textBoxPath.js +73 -0
  349. package/es/src/components/textBoxScene.js +223 -0
  350. package/es/src/components/textBoxWords.js +70 -0
  351. package/es/src/shapes/Area.js +1 -0
  352. package/es/src/shapes/Bar.js +1 -0
  353. package/es/src/shapes/Box.js +67 -79
  354. package/es/src/shapes/Circle.js +1 -0
  355. package/es/src/shapes/Line.js +1 -0
  356. package/es/src/shapes/Path.js +1 -0
  357. package/es/src/shapes/Rect.js +1 -0
  358. package/es/src/shapes/Shape.js +1 -0
  359. package/es/src/shapes/Whisker.js +1 -0
  360. package/es/src/shapes/boxOutlierShape.js +19 -0
  361. package/es/src/shapes/boxStats.js +35 -0
  362. package/es/src/shapes/boxStyle.js +78 -0
  363. package/es/src/shapes/boxSummary.js +174 -0
  364. package/es/src/shapes/shapeStandalone.js +2 -0
  365. package/es/src/utils/BaseClass.js +44 -12
  366. package/es/src/utils/className.js +78 -0
  367. package/es/src/utils/configPrep.js +2 -1
  368. package/es/src/utils/configWarnings.js +25 -0
  369. package/es/src/utils/constant.js +13 -1
  370. package/es/src/utils/displayName.js +12 -0
  371. package/es/src/utils/fieldAccessor.js +31 -0
  372. package/es/src/utils/paintComponentScene.js +2 -0
  373. package/es/src/utils/theme.js +190 -0
  374. package/es/src/utils/themeInk.js +68 -0
  375. package/package.json +14 -10
  376. package/types/index.d.ts +8 -2
  377. package/types/internal.d.ts +253 -9
  378. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  379. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  380. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  381. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  382. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  383. package/types/src/charts/Alluvial/index.d.ts +27 -0
  384. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  385. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  386. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  387. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  388. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  389. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  390. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  391. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  392. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  393. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  394. package/types/src/charts/BoxWhisker/index.d.ts +3 -1
  395. package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
  396. package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
  397. package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
  398. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  399. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  400. package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
  401. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  402. package/types/src/charts/Chord/labels.d.ts +66 -0
  403. package/types/src/charts/Donut/index.d.ts +2 -1
  404. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  405. package/types/src/charts/Gantt/emit.d.ts +17 -0
  406. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  407. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  408. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  409. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  410. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  411. package/types/src/charts/Gantt/index.d.ts +36 -0
  412. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  413. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  414. package/types/src/charts/Geomap/emit.d.ts +2 -2
  415. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  416. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  417. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  418. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  419. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  420. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  421. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  422. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  423. package/types/src/charts/Geomap/index.d.ts +3 -0
  424. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  425. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  426. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  427. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  428. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  429. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  430. package/types/src/charts/Hexbin/index.d.ts +25 -0
  431. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  432. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  433. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  434. package/types/src/charts/Histogram/binData.d.ts +20 -1
  435. package/types/src/charts/Histogram/index.d.ts +3 -2
  436. package/types/src/charts/Histogram/labels.d.ts +7 -0
  437. package/types/src/charts/Marimekko/index.d.ts +2 -1
  438. package/types/src/charts/Network/bundle.d.ts +67 -0
  439. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  440. package/types/src/charts/Network/clusters.d.ts +115 -0
  441. package/types/src/charts/Network/graph.d.ts +65 -0
  442. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  443. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  444. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  445. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  446. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  447. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  448. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  449. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  450. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  451. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  452. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  453. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  454. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  455. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  456. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  457. package/types/src/charts/Plot/axisHover.d.ts +68 -0
  458. package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
  459. package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
  460. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  461. package/types/src/charts/Plot/barHitArea.d.ts +59 -0
  462. package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
  463. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  464. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  465. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  466. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  467. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  468. package/types/src/charts/Plot/index.d.ts +28 -8
  469. package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
  470. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  471. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  472. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  473. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  474. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  475. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  476. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  477. package/types/src/charts/Plot/plotInit.d.ts +23 -2
  478. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  479. package/types/src/charts/Plot/plotZoom.d.ts +2 -0
  480. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  481. package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
  482. package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
  483. package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
  484. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  485. package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
  486. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  487. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  488. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  489. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  490. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  491. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  492. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  493. package/types/src/charts/Rings/emit.d.ts +50 -0
  494. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  495. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  496. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  497. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  498. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  499. package/types/src/charts/Sankey/emit.d.ts +58 -0
  500. package/types/src/charts/Sankey/labels.d.ts +19 -0
  501. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  502. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  503. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  504. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  505. package/types/src/charts/Scatter/index.d.ts +15 -0
  506. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  507. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  508. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  509. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  510. package/types/src/charts/Treemap/emit.d.ts +2 -1
  511. package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
  512. package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
  513. package/types/src/charts/Treemap/index.d.ts +2 -0
  514. package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
  515. package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
  516. package/types/src/charts/definition/makeChart.d.ts +5 -3
  517. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  518. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  519. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  520. package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
  521. package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
  522. package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
  523. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
  524. package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
  525. package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
  526. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  527. package/types/src/charts/events/click.legend.d.ts +2 -1
  528. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  529. package/types/src/charts/facet/facetData.d.ts +1 -1
  530. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  531. package/types/src/charts/features/annotationText.d.ts +57 -0
  532. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  533. package/types/src/charts/features/axesMeasure.d.ts +13 -1
  534. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  535. package/types/src/charts/features/calloutScene.d.ts +40 -0
  536. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  537. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  538. package/types/src/charts/features/circleLabels.d.ts +130 -0
  539. package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
  540. package/types/src/charts/features/colorScaleHover.d.ts +32 -0
  541. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  542. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  543. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  544. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  545. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  546. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  547. package/types/src/charts/features/features.d.ts +8 -0
  548. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  549. package/types/src/charts/features/legendKeys.d.ts +34 -0
  550. package/types/src/charts/features/lineLabels.d.ts +15 -12
  551. package/types/src/charts/features/linkBundle.d.ts +16 -0
  552. package/types/src/charts/features/linkColor.d.ts +48 -0
  553. package/types/src/charts/features/linkFields.d.ts +16 -0
  554. package/types/src/charts/features/linkFocus.d.ts +51 -0
  555. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  556. package/types/src/charts/features/linkKeys.d.ts +11 -0
  557. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  558. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  559. package/types/src/charts/features/linkLabels.d.ts +77 -0
  560. package/types/src/charts/features/linkWidths.d.ts +19 -0
  561. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  562. package/types/src/charts/features/pathLabels.d.ts +41 -0
  563. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  564. package/types/src/charts/features/plotPaint.d.ts +19 -0
  565. package/types/src/charts/features/polyline.d.ts +32 -0
  566. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  567. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  568. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  569. package/types/src/charts/features/ringLabels.d.ts +164 -0
  570. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  571. package/types/src/charts/features/selfLoops.d.ts +165 -0
  572. package/types/src/charts/features/shapeEmit.d.ts +5 -1
  573. package/types/src/charts/features/shareKey.d.ts +9 -0
  574. package/types/src/charts/features/sharedFields.d.ts +11 -2
  575. package/types/src/charts/features/textHalo.d.ts +14 -0
  576. package/types/src/charts/features/thresholdMembers.d.ts +38 -0
  577. package/types/src/charts/helpers/valueTitle.d.ts +4 -2
  578. package/types/src/charts/index.d.ts +8 -0
  579. package/types/src/charts/partition/interaction.d.ts +6 -3
  580. package/types/src/charts/partition/zoom.d.ts +4 -4
  581. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  582. package/types/src/charts/pipeline/stages.d.ts +9 -0
  583. package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
  584. package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
  585. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  586. package/types/src/charts/viz/Viz.d.ts +44 -6
  587. package/types/src/charts/viz/VizBase.d.ts +16 -7
  588. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  589. package/types/src/charts/viz/dataPoller.d.ts +28 -0
  590. package/types/src/charts/viz/focusRing.d.ts +25 -0
  591. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  592. package/types/src/charts/viz/groupRow.d.ts +24 -0
  593. package/types/src/charts/viz/history.d.ts +35 -0
  594. package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
  595. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  596. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  597. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  598. package/types/src/charts/viz/missingFields.d.ts +57 -0
  599. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  600. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  601. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  602. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  603. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  604. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  605. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  606. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  607. package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
  608. package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
  609. package/types/src/charts/viz/simpleHover.d.ts +2 -1
  610. package/types/src/charts/viz/vizClassName.d.ts +23 -0
  611. package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
  612. package/types/src/charts/viz/vizDefaults.d.ts +49 -9
  613. package/types/src/charts/viz/vizFields.d.ts +47 -0
  614. package/types/src/charts/viz/vizRender.d.ts +2 -1
  615. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  616. package/types/src/charts/viz/vizTypes.d.ts +117 -8
  617. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  618. package/types/src/components/Axis/Axis.d.ts +37 -8
  619. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  620. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  621. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  622. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  623. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  624. package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
  625. package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
  626. package/types/src/components/Axis/axisLayout.d.ts +5 -0
  627. package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
  628. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  629. package/types/src/components/Axis/axisRounding.d.ts +6 -3
  630. package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
  631. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  632. package/types/src/components/Axis/powTicks.d.ts +29 -0
  633. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  634. package/types/src/components/Axis/timeValues.d.ts +1 -1
  635. package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
  636. package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
  637. package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
  638. package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
  639. package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
  640. package/types/src/components/Legend/Legend.d.ts +1 -0
  641. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  642. package/types/src/components/TextBox.d.ts +1 -0
  643. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  644. package/types/src/components/Timeline/brushSpan.d.ts +41 -0
  645. package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
  646. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  647. package/types/src/components/Timeline/timelineRender.d.ts +8 -0
  648. package/types/src/components/Tooltip.d.ts +12 -3
  649. package/types/src/components/fontStack.d.ts +10 -0
  650. package/types/src/components/textBoxLayout.d.ts +18 -9
  651. package/types/src/components/textBoxPath.d.ts +59 -0
  652. package/types/src/components/textBoxScene.d.ts +51 -0
  653. package/types/src/components/textBoxWords.d.ts +33 -0
  654. package/types/src/shapes/Area.d.ts +1 -0
  655. package/types/src/shapes/Bar.d.ts +1 -0
  656. package/types/src/shapes/Box.d.ts +2 -8
  657. package/types/src/shapes/Circle.d.ts +1 -0
  658. package/types/src/shapes/Line.d.ts +1 -0
  659. package/types/src/shapes/Path.d.ts +1 -0
  660. package/types/src/shapes/Rect.d.ts +1 -0
  661. package/types/src/shapes/Shape.d.ts +1 -0
  662. package/types/src/shapes/Whisker.d.ts +1 -0
  663. package/types/src/shapes/boxOutlierShape.d.ts +9 -0
  664. package/types/src/shapes/boxStats.d.ts +19 -0
  665. package/types/src/shapes/boxStyle.d.ts +25 -0
  666. package/types/src/shapes/boxSummary.d.ts +66 -0
  667. package/types/src/shapes/emitLabels.d.ts +1 -1
  668. package/types/src/shapes/shapeConfig.d.ts +42 -4
  669. package/types/src/utils/BaseClass.d.ts +32 -0
  670. package/types/src/utils/D3Scale.d.ts +3 -0
  671. package/types/src/utils/D3plusConfig.d.ts +1240 -33
  672. package/types/src/utils/className.d.ts +64 -0
  673. package/types/src/utils/configPrep.d.ts +2 -0
  674. package/types/src/utils/configWarnings.d.ts +21 -2
  675. package/types/src/utils/constant.d.ts +8 -0
  676. package/types/src/utils/displayName.d.ts +10 -0
  677. package/types/src/utils/fieldAccessor.d.ts +24 -0
  678. package/types/src/utils/index.d.ts +1 -1
  679. package/types/src/utils/paintComponentScene.d.ts +3 -1
  680. package/types/src/utils/theme.d.ts +170 -0
  681. package/types/src/utils/themeInk.d.ts +56 -0
  682. package/umd/d3plus-core.full.js +87388 -56271
  683. package/umd/d3plus-core.full.min.js +2 -2
  684. package/umd/d3plus-core.js +37988 -11768
  685. package/umd/d3plus-core.min.js +2 -2
  686. package/es/src/components/Axis/gridStroke.js +0 -10
  687. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -9,11 +9,23 @@ import { initInsetDefaults, insetComponentScene } from "../features/insetState.j
9
9
  import { applyZoomPointerEvents, bindCanvasZoom } from "../drawSteps/zoomControls.js";
10
10
  import { initVizDefaults } from "./vizDefaults.js";
11
11
  import { unregisterLink } from "./linkGroup.js";
12
+ import { stopDataPolling } from "./vizDataPolling.js";
12
13
  import { facetPanelAt, withFacetPanel } from "../facet/facetPanel.js";
13
14
  import { vizRender } from "./vizRender.js";
15
+ import { motionReduced } from "./reducedMotion.js";
14
16
  import { vizDraw } from "../pipeline/vizDraw.js";
15
17
  import { vizPreDraw } from "../pipeline/vizPreDraw.js";
16
18
  import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
19
+ import { reportHandlerError } from "./reportHandlerError.js";
20
+ import { vizClassNameTargets } from "./vizClassName.js";
21
+ import { themeBackground, unwatchPageTheme } from "./vizTheme.js";
22
+ import { stopVisibilityWatch } from "./vizVisibility.js";
23
+ import { applyClassName, withRootClasses } from "../../utils/className.js";
24
+ import { handleColorScaleHover } from "../features/colorScaleHover.js";
25
+ import { appendFocusRing, syncKeyboardNav, teardownKeyboardNav } from "./keyboardNav.js";
26
+ import { mountTargetFor } from "./mountTarget.js";
27
+ import { routePointerEvent } from "./nearestHover.js";
28
+ import { nearestHoverSurface } from "./nearestHoverSurface.js";
17
29
  /**
18
30
  Stamps `interactionGroup` onto a component's scene subtree so the pointer
19
31
  bridge can route its nodes to component-scoped handlers (e.g. legend) on
@@ -23,18 +35,10 @@ import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
23
35
  const kids = node.children;
24
36
  if (kids) for (const child of kids)tagInteractionGroup(child, group);
25
37
  }
26
- /**
27
- Resolves the element a renderer mounts into. A `<canvas>` cannot paint inside
28
- an `<svg>`, so when the scene target is the compute svg, the canvas mounts
29
- into that svg's parent (the user's element); the emptied, position:absolute
30
- compute svg overlays the same top-left box. SVG mounts into the target as-is.
31
- */ function mountTargetFor(kind, target) {
32
- if (kind === "canvas" && typeof Element !== "undefined" && target instanceof Element && target.tagName.toLowerCase() === "svg") return target.parentNode ?? target;
33
- return target;
34
- }
35
38
  /**
36
39
  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, …).
37
40
  */ export default class Viz extends VizBase {
41
+ static _displayName = "Viz";
38
42
  /**
39
43
  Invoked when creating a new class instance, and sets any default parameters.
40
44
  @private
@@ -57,7 +61,7 @@ import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
57
61
  - chart-level components (Legend/ColorScale/Timeline) via their toScene
58
62
  - `_featurePanels` (from FeatureModule layouts) wrapped in viz-features
59
63
  */ toScene() {
60
- const children = [];
64
+ const children = themeBackground(this);
61
65
  // Chart cells stashed on _chartScene — via `chartDef.emit(ctx)` for
62
66
  // data-driven charts, or `Plot._paint` for the paint-driven Plot family.
63
67
  // Wraps in three groups:
@@ -164,6 +168,8 @@ import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
164
168
  children: this._featurePanels
165
169
  });
166
170
  }
171
+ // Keyboard navigation's focus ring, above everything else.
172
+ appendFocusRing(this, children);
167
173
  return {
168
174
  width: this.schema.width,
169
175
  height: this.schema.height,
@@ -195,14 +201,38 @@ import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
195
201
  */ _insetRegion() {
196
202
  return null;
197
203
  }
204
+ /**
205
+ The table view's rows, when the chart shows more than its data (see
206
+ `ChartDefinition.tableData`). The base chart shows its data.
207
+ @private
208
+ */ _tableData() {
209
+ return null;
210
+ }
211
+ /**
212
+ The shape a colorScale row draws as (see
213
+ `ChartDefinition.colorScaleShape`): the row's `shape`, unless the chart
214
+ draws it as something else.
215
+ @private
216
+ */ _colorScaleShape(d, i) {
217
+ return this.schema.shape(d, i);
218
+ }
198
219
  /**
199
220
  * Applies the threshold algorithm according to the type of chart used.
200
221
  * @param {Array} data The data to process.
222
+ * @param {Array} all Every row `data` was drawn from, legend-hidden ones included.
201
223
  * @private
202
- */ _thresholdFunction(data, _tree) {
224
+ */ _thresholdFunction(data, _tree, _all) {
203
225
  return data;
204
226
  }
205
227
  /**
228
+ * The legend rows with the chart's threshold bucket folded in, so the
229
+ * legend shows the bucket rather than the items it holds.
230
+ * @param {Array} legendData Every legend row, legend-hidden ones included.
231
+ * @private
232
+ */ _thresholdLegend(legendData) {
233
+ return legendData;
234
+ }
235
+ /**
206
236
  * Detects width and height and sets SVG properties
207
237
  * @private
208
238
  */ _setSVGSize(width, height) {
@@ -227,7 +257,7 @@ import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
227
257
  }
228
258
  /**
229
259
  Draws the visualization given the specified configuration.
230
- @param callback Optional callback invoked after rendering completes.
260
+ @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.
231
261
  */ render(callback) {
232
262
  return vizRender(this, callback);
233
263
  }
@@ -235,10 +265,12 @@ import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
235
265
  Serializes the most recently rendered output to an SVG string. Returns
236
266
  `""` if the chart has not been rendered yet. Both backends support this:
237
267
  the SVG backend returns its live `<svg>`, the canvas backend re-renders the
238
- retained scene through a throwaway SVG backend. Primarily used for
239
- server-side rendering (see `@d3plus/ssr`).
268
+ retained scene through a throwaway SVG backend. Its root element carries
269
+ the chart's `className`. Primarily used for server-side rendering (see
270
+ `@d3plus/ssr`).
240
271
  */ toSVGString() {
241
- return this._sceneRenderer?.toSVGString?.() ?? "";
272
+ const markup = this._sceneRenderer?.toSVGString?.() ?? "";
273
+ return withRootClasses(markup, this.schema.className);
242
274
  }
243
275
  /**
244
276
  Returns the underlying canvas element of the most recent render when the
@@ -273,11 +305,13 @@ import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
273
305
  const w = this.schema.width || 400;
274
306
  const h = this.schema.height || 300;
275
307
  this._ensureSceneRenderer(kind, mountTarget, w, h);
308
+ applyClassName(this);
276
309
  // `durationOverride` defaults to the chart's `_duration` for normal
277
310
  // re-renders. Interaction handlers (zoomed, hover, etc.) pass 0 to
278
311
  // skip the transition machinery — animating every wheel/drag tick
279
- // accumulates `setTimeout(duration+10)` per event.
280
- const drawDuration = durationOverride !== undefined ? durationOverride : this._instantNextDraw ? 0 : this.schema.duration;
312
+ // accumulates `setTimeout(duration+10)` per event. Reduced motion
313
+ // zeroes every draw, overrides included.
314
+ const drawDuration = motionReduced(this) ? 0 : durationOverride !== undefined ? durationOverride : this._instantNextDraw ? 0 : this.schema.duration;
281
315
  // A duration>0 render (drill-down, zoom, re-center) must win over any
282
316
  // pending coalesced duration-0 repaint — otherwise that repaint fires on
283
317
  // the next frame and interrupts this transition, snapping shapes to their
@@ -350,6 +384,8 @@ import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
350
384
  applyZoomPointerEvents(this);
351
385
  if (this._select && kind === "canvas") this._select.selectAll("g.d3plus-viz-timeline, g.d3plus-viz-brush").style("pointer-events", "auto");
352
386
  if (kind === "canvas") bindCanvasZoom(this);
387
+ nearestHoverSurface(this);
388
+ syncKeyboardNav(this);
353
389
  // The timeline brush (d3-brush DOM, mounted in `g.d3plus-viz-timeline` in
354
390
  // the outer svg) must paint above the scene-rendered timeline buttons/ticks
355
391
  // so its selection tint + handles sit on top of them (matching v3). The
@@ -378,12 +414,26 @@ import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
378
414
  */ _interactionDatum(pick, _event) {
379
415
  return handlerDatum(pick.datum, pick.index ?? 0);
380
416
  }
417
+ /**
418
+ Whether a painted scene node is a point mark that nearest-point hover
419
+ (`hoverDistance`) resolves the pointer to. None in the base chart;
420
+ charts drawn with points (Plot, Network, Geomap) accept theirs.
421
+ @private
422
+ */ _pointMark(_node) {
423
+ return false;
424
+ }
381
425
  /**
382
426
  Pointer hook run by `_routeSceneEvent` before any handler routing, for
383
427
  every event including ones over empty space. No-op here; Plot overrides
384
428
  it to drive the shared multi-series tooltip and crosshair.
385
429
  @private
386
430
  */ _sharedHover(_event) {}
431
+ /**
432
+ The element the chart draws on: its root svg, or its canvas.
433
+ @private
434
+ */ _classNameTargets() {
435
+ return vizClassNameTargets(this._select?.node?.(), this._sceneRenderer, this._renderer === "canvas" ? "canvas" : "svg");
436
+ }
387
437
  /**
388
438
  The chart's small-multiple hooks (see `ChartDefinition.facet`). The base
389
439
  chart has none: each panel draws the way the whole chart does.
@@ -426,13 +476,12 @@ import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
426
476
  // tooltips never fire on the v4 scene-rendered path because
427
477
  // `shape.on(evt, fn)` in plotPaint only wires d3-selection
428
478
  // listeners on DOM nodes the scene renderer doesn't create.
429
- // Renderer events carry the picked scene node; the routing lives in
430
- // `_routeSceneEvent` (kept out of this method so the mount path stays
431
- // readable). `_lastScenePick` remembers the most recently hovered node
479
+ // Renderer events carry the picked scene node; `routePointerEvent`
480
+ // resolves nearest-point hover, then `_routeSceneEvent` routes them. `_lastScenePick` remembers the most recently hovered node
432
481
  // so `mouseleave` — fired with a null pick — can still tell the matching
433
482
  // handlers which shape/legend item was left (so the tooltip clears).
434
483
  this._lastScenePick = null;
435
- this._sceneRenderer.on((event)=>this._routeSceneEvent(event));
484
+ this._sceneRenderer.on((event)=>routePointerEvent(this, event));
436
485
  } else {
437
486
  this._sceneRenderer.resize(w, h);
438
487
  }
@@ -468,6 +517,7 @@ import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
468
517
  // across empty space (Plot's shared tooltip + crosshair) — and ahead of
469
518
  // the transition guard below, so leaving mid-transition still clears it.
470
519
  this._sharedHover(event);
520
+ handleColorScaleHover(this, event);
471
521
  if (this._transitionEndsAt && Date.now() < this._transitionEndsAt) return;
472
522
  const pick = event.pick;
473
523
  // Dispatch helper shared by the live-pick path and the leave path.
@@ -476,9 +526,8 @@ import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
476
526
  if (typeof fn === "function") {
477
527
  try {
478
528
  fn.call(this, d, i, x, event.nativeEvent);
479
- } catch {
480
- // swallow per-event errors so one bad handler doesn't
481
- // break subsequent events.
529
+ } catch (error) {
530
+ reportHandlerError(error);
482
531
  }
483
532
  }
484
533
  };
@@ -518,6 +567,9 @@ import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
518
567
  // its source row; Plot overrides `_interactionDatum` to report the point
519
568
  // nearest the cursor for multi-point shapes (Line/Area).
520
569
  const { d: sourceDatum, i: sourceIndex, x: rawDatum } = this._interactionDatum(pick, event);
570
+ // A node with no data (an inset legend's backdrop, gridlines) is not a
571
+ // chart shape.
572
+ if (sourceDatum === undefined) return;
521
573
  // Shape-class-scoped handlers (`"click.Bar"`, `"mousemove.Circle"`): the
522
574
  // node's own shape type, then any composite it is a part of (`"click.Box"`
523
575
  // on a box's whisker). On the scene path this is the only place these fire
@@ -567,37 +619,23 @@ import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
567
619
  });
568
620
  }
569
621
  /**
570
- Tears down the visualization: disconnects the ResizeObserver, stops listening for web font loads, and removes DOM event listeners. Call this when unmounting to avoid memory leaks.
622
+ 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.
571
623
  */ destroy() {
572
624
  unregisterLink(this);
625
+ teardownKeyboardNav(this);
626
+ nearestHoverSurface(this, true);
627
+ unwatchPageTheme(this);
628
+ stopDataPolling(this);
573
629
  this._resizeObserver?.disconnect();
574
630
  this._fontsUnsubscribe?.();
575
631
  this._fontsUnsubscribe = undefined;
576
632
  this._tooltipClass.data([]).render();
577
633
  select("body").on(`touchstart.${this._uuid}`, null);
578
- // Clear the visibility/resize/scroll poll timers + scroll listener
579
- // so a destroyed chart doesn't keep firing intervals/timeouts that
580
- // hold the entire viz instance alive. Without this, an SPA that
581
- // mounts/unmounts charts on tab switches leaks the scene tree +
582
- // a 200ms-interval timer per leaked chart.
583
- if (this._visiblePoll) {
584
- this._visiblePoll = clearInterval(this._visiblePoll);
585
- }
586
- if (this._resizePoll) {
587
- this._resizePoll = clearTimeout(this._resizePoll);
588
- }
589
- if (this._scrollPoll) {
590
- this._scrollPoll = clearTimeout(this._scrollPoll);
591
- }
592
- this._visibleUnobserve?.();
593
- this._visibleUnobserve = undefined;
594
- this._unloadUnobserve?.();
595
- this._unloadUnobserve = undefined;
634
+ stopVisibilityWatch(this);
596
635
  if (this._sceneRepaintRAF != null) {
597
636
  if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(this._sceneRepaintRAF);
598
637
  this._sceneRepaintRAF = undefined;
599
638
  }
600
- if (this.schema.scrollContainer) select(this.schema.scrollContainer).on(`scroll.${this._uuid}`, null);
601
639
  // Destroy the active scene renderer (clears its own pointer-rect
602
640
  // listeners, overlay host, canvas/svg DOM, timers).
603
641
  if (this._sceneRenderer && typeof this._sceneRenderer.destroy === "function") {
@@ -1,21 +1,29 @@
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
- import { accessor, BaseClass, constant } from "../../utils/index.js";
5
+ import { BaseClass, constant } from "../../utils/index.js";
6
+ import { fieldAccessor } from "../../utils/fieldAccessor.js";
6
7
  import { coerceFacet } from "../facet/facetConfig.js";
8
+ import { groupDepthOf } from "./groupRow.js";
9
+ import { dropLegendHistory } from "./history.js";
7
10
  import { broadcastLink } from "./linkGroup.js";
8
11
  import { shapeHoverEnabled } from "./shapeHover.js";
12
+ import { setLoaderValue } from "./loaderFormat.js";
13
+ import { stopDataPolling } from "./vizDataPolling.js";
9
14
  import { isPlainObject, mergeConfigBag, resolvesReset } from "../../fluent.js";
10
15
  import validateShapeConfig from "../../shapes/validateShapeConfig.js";
16
+ import { displayName } from "../../utils/displayName.js";
11
17
  /**
12
18
  The fluent config accessors shared by every Viz chart that need more than
13
19
  storing their value (most are generated from `vizFields.ts`); `Viz` adds
14
20
  the render lifecycle.
15
21
  */ class VizBase extends BaseClass {
22
+ static _displayName = "VizBase";
16
23
  /**
17
24
  The active callback function for highlighting shapes.
18
25
  */ active(_) {
26
+ if (!arguments.length) return this._active;
19
27
  this._active = _;
20
28
  if (this.schema.shapeConfig.activeOpacity !== 1) {
21
29
  if (this.schema.legend) this._legendClass.active(_);
@@ -29,24 +37,33 @@ import validateShapeConfig from "../../shapes/validateShapeConfig.js";
29
37
  /**
30
38
  The primary data array used to draw the visualization. The value passed should be an *Array* of objects or a *String* representing a filepath or URL to be loaded. The following filetypes are supported: `csv`, `tsv`, `txt`, and `json`.
31
39
 
32
- If your data URL needs specific headers to be set, an Object with "url" and "headers" keys may also be passed.
40
+ 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.
33
41
 
34
- 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.
42
+ 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`.
35
43
 
36
- 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).
44
+ To re-fetch a URL on an interval and redraw when its data changes, set `dataPollingInterval`; each poll runs `dataFormat`.
37
45
 
38
46
  Defaults to an empty array (`[]`).
39
- @param f The data array or a URL string to load data from.
47
+ @param _ The data array or a URL string to load data from.
48
+ @param f Sets `dataFormat`.
40
49
  */ data(_, f) {
41
50
  if (arguments.length) {
42
- addToQueue.bind(this)(_, f, "data");
51
+ setLoaderValue(this, "data", arguments.length > 1 ? [
52
+ _,
53
+ f
54
+ ] : [
55
+ _
56
+ ]);
43
57
  this._hidden = [];
44
58
  this._solo = [];
59
+ dropLegendHistory(this);
45
60
  if (this._userData && JSON.stringify(_) !== JSON.stringify(this._userData)) {
46
61
  this.schema.timeFilter = false;
47
62
  this._timelineSelection = false;
48
63
  }
49
64
  this._userData = _;
65
+ this._dataSignature = undefined;
66
+ stopDataPolling(this);
50
67
  return this;
51
68
  }
52
69
  return this._data;
@@ -131,13 +148,12 @@ Defaults to an empty array (`[]`).
131
148
  return v.length === 1 ? v[0] : v;
132
149
  };
133
150
  }
134
- return accessor(k);
151
+ return fieldAccessor(k);
135
152
  }
136
153
  }), this;
137
154
  }
138
- /**
139
- The hover callback function for highlighting shapes on mouseover.
140
- */ hover(_) {
155
+ hover(_) {
156
+ if (!arguments.length) return this._hover;
141
157
  let hoverFunction = this._hover = _;
142
158
  if (this.schema.shapeConfig.hoverOpacity !== 1 && _ !== undefined) {
143
159
  if (typeof _ === "function") {
@@ -154,7 +170,13 @@ Defaults to an empty array (`[]`).
154
170
  activeIds.add(JSON.stringify(ids.slice(0, x)));
155
171
  }
156
172
  });
157
- if (activeIds.size) hoverFunction = (d, i)=>activeIds.has(JSON.stringify(this._ids(d, i)));
173
+ // A group row (see `groupRow.ts`) matches by its ids down to its
174
+ // own level, so it stays bright while any row in its group does.
175
+ if (activeIds.size) hoverFunction = (d, i)=>{
176
+ const ids = this._ids(d, i);
177
+ const depth = groupDepthOf(d);
178
+ return activeIds.has(JSON.stringify(depth === undefined ? ids : ids.slice(0, depth + 1)));
179
+ };
158
180
  }
159
181
  if (this.schema.legend) this._legendClass.hover(hoverFunction);
160
182
  }
@@ -191,12 +213,17 @@ Defaults to an empty array (`[]`).
191
213
  }
192
214
  shapeConfig(_) {
193
215
  if (!arguments.length) return this.schema.shapeConfig;
194
- if (isPlainObject(_)) validateShapeConfig(this.constructor.name, _);
216
+ if (isPlainObject(_)) validateShapeConfig(displayName(this), _);
195
217
  this.schema.shapeConfig = mergeConfigBag(this, "shapeConfig", _);
196
218
  return this;
197
219
  }
198
220
  /**
199
- The threshold value for bucketing small data points together.
221
+ The threshold value for bucketing small data points together, as a
222
+ share of the total. On a stacked Plot, the series whose summed value
223
+ across every position is under that share of the whole chart's total
224
+ merge into one series, stacked on top. A bucket needs at least two
225
+ items, and its tooltips list them. Off (`0`) by default on Plot
226
+ charts.
200
227
  */ threshold(_) {
201
228
  if (arguments.length) {
202
229
  if (typeof _ === "function") {
@@ -208,14 +235,15 @@ Defaults to an empty array (`[]`).
208
235
  } else return this.schema.threshold;
209
236
  }
210
237
  /**
211
- Accessor for the value used in the threshold algorithm.
238
+ Accessor for the value used in the threshold algorithm. A stacked Plot
239
+ defaults to its stacked value.
212
240
  @param key The data key used to group values for thresholding.
213
241
  */ thresholdKey(key) {
214
242
  if (arguments.length) {
215
243
  if (typeof key === "function") {
216
244
  this.schema.thresholdKey = key;
217
245
  } else {
218
- this.schema.thresholdKey = accessor(key);
246
+ this.schema.thresholdKey = fieldAccessor(key);
219
247
  }
220
248
  return this;
221
249
  } else return this.schema.thresholdKey;
@@ -227,7 +255,7 @@ Defaults to an empty array (`[]`).
227
255
  if (typeof _ === "function") {
228
256
  this.schema.time = _;
229
257
  } else if (_) {
230
- this.schema.time = accessor(_);
258
+ this.schema.time = fieldAccessor(_);
231
259
  if (!this.schema.aggs[_]) {
232
260
  this.schema.aggs[_] = (a, c)=>{
233
261
  const v = unique(a.map(c));
@@ -249,7 +277,7 @@ Defaults to an empty array (`[]`).
249
277
  } else return this.schema.time;
250
278
  }
251
279
  /**
252
- 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.
280
+ 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.
253
281
  */ timelineDefault(_) {
254
282
  if (arguments.length) {
255
283
  if (!(_ instanceof Array)) _ = [
@@ -265,7 +293,7 @@ Defaults to an empty array (`[]`).
265
293
  */ total(_) {
266
294
  if (arguments.length) {
267
295
  if (typeof _ === "function") this.schema.total = _;
268
- else if (_) this.schema.total = accessor(_);
296
+ else if (_) this.schema.total = fieldAccessor(_);
269
297
  else this.schema.total = false;
270
298
  return this;
271
299
  } else return this.schema.total;
@@ -1,17 +1,23 @@
1
- import { colorContrast } from "@d3plus/color";
2
- import { backgroundColor } from "@d3plus/dom";
1
+ import { inkBackground, inkGrid, inkText } from "../../utils/themeInk.js";
3
2
  /**
4
- The chart's background color, as detected behind its container (white
3
+ The chart's background: its theme's (the page's own in `"auto"` mode), or,
4
+ before the chart has drawn, the one detected behind its container (white
5
5
  before the chart is mounted).
6
6
  @private
7
7
  */ 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)";
8
+ return inkBackground(viz);
10
9
  }
11
10
  /**
12
11
  The text color that reads against the chart's own background: dark on a
13
- light page, light on a dark one.
12
+ light page, light on a dark one, or the theme's `text`.
14
13
  @private
15
14
  */ export function backgroundInk(viz) {
16
- return colorContrast(chartBackground(viz), viz.schema.colorDefaults);
15
+ return inkText(viz);
16
+ }
17
+ /**
18
+ The chart's gridline color: the theme's `gridline`, a faint step off the
19
+ chart's background.
20
+ @private
21
+ */ export function chartGridline(viz) {
22
+ return inkGrid(viz);
17
23
  }
@@ -0,0 +1,52 @@
1
+ /** Options for {@link createDataPoller}. */ /**
2
+ Calls `fetch` every `interval` ms, chaining each wait from the end of the
3
+ previous fetch so requests never overlap. A tick that comes due while
4
+ `paused()` is held until `resume()`. Errors are reported once per streak
5
+ and polling continues.
6
+ @private
7
+ */ export function createDataPoller(opts) {
8
+ let timer;
9
+ let stopped = false;
10
+ let inFlight = false;
11
+ let missed = false;
12
+ let failing = false;
13
+ const schedule = ()=>{
14
+ timer = setTimeout(tick, opts.interval);
15
+ };
16
+ const run = ()=>{
17
+ missed = false;
18
+ inFlight = true;
19
+ Promise.resolve().then(opts.fetch).then((value)=>{
20
+ if (stopped) return;
21
+ failing = false;
22
+ opts.onData(value);
23
+ }, (err)=>{
24
+ if (stopped) return;
25
+ if (!failing) opts.onError(err);
26
+ failing = true;
27
+ }).catch((err)=>{
28
+ if (!stopped) opts.onError(err);
29
+ }).finally(()=>{
30
+ inFlight = false;
31
+ if (!stopped) schedule();
32
+ });
33
+ };
34
+ function tick() {
35
+ timer = undefined;
36
+ if (stopped) return;
37
+ if (opts.paused()) missed = true;
38
+ else run();
39
+ }
40
+ schedule();
41
+ return {
42
+ stop () {
43
+ stopped = true;
44
+ clearTimeout(timer);
45
+ timer = undefined;
46
+ },
47
+ resume () {
48
+ if (stopped || !missed || inFlight || opts.paused()) return;
49
+ run();
50
+ }
51
+ };
52
+ }
@@ -0,0 +1,104 @@
1
+ /**
2
+ The ring drawn around the mark keyboard focus rests on.
3
+
4
+ @module
5
+ */ /** The radius of the ring around a series point, before padding. */ const POINT_RADIUS = 5;
6
+ /** A ring outline drawn as `type`, as a halo underneath a stroke. */ function strokes(geom, style, type) {
7
+ const base = {
8
+ fill: "none",
9
+ vectorEffect: "non-scaling-stroke"
10
+ };
11
+ return [
12
+ {
13
+ ...geom,
14
+ key: `viz-focus-halo-${type}`,
15
+ paint: {
16
+ ...base,
17
+ stroke: style.halo,
18
+ strokeWidth: style.strokeWidth + 2
19
+ }
20
+ },
21
+ {
22
+ ...geom,
23
+ key: `viz-focus-ring-${type}`,
24
+ paint: {
25
+ ...base,
26
+ stroke: style.stroke,
27
+ strokeWidth: style.strokeWidth
28
+ }
29
+ }
30
+ ].map((n)=>({
31
+ ...n,
32
+ interactive: false,
33
+ aria: {
34
+ hidden: true
35
+ }
36
+ }));
37
+ }
38
+ /** Whether a node paints a visible fill. */ function filled(node) {
39
+ const fill = node.paint?.fill;
40
+ return !!fill && fill !== "none" && fill !== "transparent";
41
+ }
42
+ /** Nests `children` in one group per transform, outermost first. */ function nest(chain, children) {
43
+ return chain.reduceRight((inner, transform, i)=>[
44
+ {
45
+ type: "group",
46
+ key: `viz-focus-t${i}`,
47
+ transform,
48
+ children: inner,
49
+ interactive: false
50
+ }
51
+ ], children);
52
+ }
53
+ /** The ring's own geometry, in surface coordinates unless it follows a path. */ function ringChildren(target, style) {
54
+ const { node, box, center, chain } = target;
55
+ const pad = style.padding;
56
+ if (target.pointIndex !== undefined) return strokes({
57
+ type: "circle",
58
+ cx: center[0],
59
+ cy: center[1],
60
+ r: POINT_RADIUS + pad
61
+ }, style, "circle");
62
+ if (node.type === "circle") return strokes({
63
+ type: "circle",
64
+ cx: center[0],
65
+ cy: center[1],
66
+ r: box.width / 2 + pad
67
+ }, style, "circle");
68
+ // A filled path's own outline (a pie wedge, a map region), through the
69
+ // same transforms that place the mark. A stroke-only path (a network link)
70
+ // is boxed instead, since tracing it would only redraw the line.
71
+ if (node.type === "path" && filled(node)) {
72
+ const full = node.transform ? [
73
+ ...chain,
74
+ node.transform
75
+ ] : chain;
76
+ return nest(full, strokes({
77
+ type: "path",
78
+ d: node.d
79
+ }, style, "path"));
80
+ }
81
+ return strokes({
82
+ type: "rect",
83
+ x: box.x - pad,
84
+ y: box.y - pad,
85
+ width: box.width + pad * 2,
86
+ height: box.height + pad * 2
87
+ }, style, "rect");
88
+ }
89
+ /**
90
+ The `viz-focus` scene group outlining `target`: a padded rectangle around
91
+ a rect-like mark or a stroke-only path, a circle around a circle or series
92
+ point, and the mark's own outline for a filled path. Inert and hidden from
93
+ assistive tech.
94
+ */ export function focusRingNode(target, style) {
95
+ return {
96
+ type: "group",
97
+ key: "viz-focus",
98
+ interactive: false,
99
+ aria: {
100
+ hidden: true
101
+ },
102
+ children: ringChildren(target, style)
103
+ };
104
+ }