@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
@@ -1,8 +1,3 @@
1
- /**
2
- @module discreteBuffer
3
- Adds left/right padding to a point or time scale.
4
- @private
5
- */
6
1
  import type { D3Scale } from "../../utils/index.js";
7
2
  declare const discreteBuffer: (scale: D3Scale, data: Record<string, unknown>[], discrete: string) => void;
8
3
  export default discreteBuffer;
@@ -1,5 +1,5 @@
1
1
  import type { DataPoint } from "@d3plus/data";
2
- import type { PickResult, Scene, SceneEvent } from "@d3plus/render";
2
+ import type { PickResult, Scene, SceneEvent, SceneNode } from "@d3plus/render";
3
3
  import VizBase from "./VizBase.js";
4
4
  import type { SizeLegendScale } from "../../components/SizeLegend/sizeLegendLayout.js";
5
5
  import type { InsetRegion } from "../features/insetState.js";
@@ -8,6 +8,7 @@ import type { FacetHooks } from "../facet/facetConfig.js";
8
8
  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, …).
9
9
  */
10
10
  export default class Viz extends VizBase {
11
+ static readonly _displayName: string;
11
12
  /**
12
13
  Invoked when creating a new class instance, and sets any default parameters.
13
14
  @private
@@ -48,12 +49,33 @@ export default class Viz extends VizBase {
48
49
  @private
49
50
  */
50
51
  _insetRegion(): InsetRegion | null;
52
+ /**
53
+ The table view's rows, when the chart shows more than its data (see
54
+ `ChartDefinition.tableData`). The base chart shows its data.
55
+ @private
56
+ */
57
+ _tableData(): DataPoint[] | null;
58
+ /**
59
+ The shape a colorScale row draws as (see
60
+ `ChartDefinition.colorScaleShape`): the row's `shape`, unless the chart
61
+ draws it as something else.
62
+ @private
63
+ */
64
+ _colorScaleShape(d: DataPoint, i: number): string;
51
65
  /**
52
66
  * Applies the threshold algorithm according to the type of chart used.
53
67
  * @param {Array} data The data to process.
68
+ * @param {Array} all Every row `data` was drawn from, legend-hidden ones included.
54
69
  * @private
55
70
  */
56
- _thresholdFunction(data: DataPoint[], _tree?: unknown): DataPoint[];
71
+ _thresholdFunction(data: DataPoint[], _tree?: unknown, _all?: DataPoint[]): DataPoint[];
72
+ /**
73
+ * The legend rows with the chart's threshold bucket folded in, so the
74
+ * legend shows the bucket rather than the items it holds.
75
+ * @param {Array} legendData Every legend row, legend-hidden ones included.
76
+ * @private
77
+ */
78
+ _thresholdLegend(legendData: DataPoint[]): DataPoint[];
57
79
  /**
58
80
  * Detects width and height and sets SVG properties
59
81
  * @private
@@ -61,15 +83,16 @@ export default class Viz extends VizBase {
61
83
  _setSVGSize(width?: number, height?: number): void;
62
84
  /**
63
85
  Draws the visualization given the specified configuration.
64
- @param callback Optional callback invoked after rendering completes.
86
+ @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.
65
87
  */
66
88
  render(callback?: () => void): this;
67
89
  /**
68
90
  Serializes the most recently rendered output to an SVG string. Returns
69
91
  `""` if the chart has not been rendered yet. Both backends support this:
70
92
  the SVG backend returns its live `<svg>`, the canvas backend re-renders the
71
- retained scene through a throwaway SVG backend. Primarily used for
72
- server-side rendering (see `@d3plus/ssr`).
93
+ retained scene through a throwaway SVG backend. Its root element carries
94
+ the chart's `className`. Primarily used for server-side rendering (see
95
+ `@d3plus/ssr`).
73
96
  */
74
97
  toSVGString(): string;
75
98
  /**
@@ -110,6 +133,13 @@ export default class Viz extends VizBase {
110
133
  i: number;
111
134
  x: unknown;
112
135
  };
136
+ /**
137
+ Whether a painted scene node is a point mark that nearest-point hover
138
+ (`hoverDistance`) resolves the pointer to. None in the base chart;
139
+ charts drawn with points (Plot, Network, Geomap) accept theirs.
140
+ @private
141
+ */
142
+ _pointMark(_node: SceneNode): boolean;
113
143
  /**
114
144
  Pointer hook run by `_routeSceneEvent` before any handler routing, for
115
145
  every event including ones over empty space. No-op here; Plot overrides
@@ -117,6 +147,14 @@ export default class Viz extends VizBase {
117
147
  @private
118
148
  */
119
149
  _sharedHover(_event: SceneEvent): void;
150
+ /**
151
+ The element the chart draws on: its root svg, or its canvas.
152
+ @private
153
+ */
154
+ _classNameTargets(): {
155
+ el: Element;
156
+ keep?: string[];
157
+ }[];
120
158
  /**
121
159
  The chart's small-multiple hooks (see `ChartDefinition.facet`). The base
122
160
  chart has none: each panel draws the way the whole chart does.
@@ -160,7 +198,7 @@ export default class Viz extends VizBase {
160
198
  */
161
199
  _scheduleSceneRepaint(): void;
162
200
  /**
163
- 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.
201
+ 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.
164
202
  */
165
203
  destroy(): this;
166
204
  }
@@ -19,6 +19,7 @@ interface VizBase extends VizFieldAccessors {
19
19
  the render lifecycle.
20
20
  */
21
21
  declare class VizBase extends BaseClass {
22
+ static readonly _displayName: string;
22
23
  [key: string]: any;
23
24
  /**
24
25
  The active callback function for highlighting shapes.
@@ -27,14 +28,15 @@ declare class VizBase extends BaseClass {
27
28
  /**
28
29
  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`.
29
30
 
30
- If your data URL needs specific headers to be set, an Object with "url" and "headers" keys may also be passed.
31
+ 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.
31
32
 
32
- 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.
33
+ 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`.
33
34
 
34
- 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).
35
+ To re-fetch a URL on an interval and redraw when its data changes, set `dataPollingInterval`; each poll runs `dataFormat`.
35
36
 
36
37
  Defaults to an empty array (`[]`).
37
- @param f The data array or a URL string to load data from.
38
+ @param _ The data array or a URL string to load data from.
39
+ @param f Sets `dataFormat`.
38
40
  */
39
41
  data(_?: DataPoint[] | string | {
40
42
  url: string;
@@ -67,6 +69,7 @@ declare class VizBase extends BaseClass {
67
69
  /**
68
70
  The hover callback function for highlighting shapes on mouseover.
69
71
  */
72
+ hover(): ((d: DataPoint, i: number) => boolean) | false | undefined;
70
73
  hover(_?: ((d: DataPoint, i: number) => boolean) | false): this;
71
74
  /**
72
75
  Persistently emphasizes the data points matching the given predicate: the
@@ -86,11 +89,17 @@ declare class VizBase extends BaseClass {
86
89
  shapeConfig(): D3plusConfig;
87
90
  shapeConfig(_: D3plusConfig): this;
88
91
  /**
89
- The threshold value for bucketing small data points together.
92
+ The threshold value for bucketing small data points together, as a
93
+ share of the total. On a stacked Plot, the series whose summed value
94
+ across every position is under that share of the whole chart's total
95
+ merge into one series, stacked on top. A bucket needs at least two
96
+ items, and its tooltips list them. Off (`0`) by default on Plot
97
+ charts.
90
98
  */
91
99
  threshold(_?: number | ((data: DataPoint[]) => number)): this | number | ((data: DataPoint[]) => number);
92
100
  /**
93
- Accessor for the value used in the threshold algorithm.
101
+ Accessor for the value used in the threshold algorithm. A stacked Plot
102
+ defaults to its stacked value.
94
103
  @param key The data key used to group values for thresholding.
95
104
  */
96
105
  thresholdKey(key?: string | ((d: DataPoint, i: number) => DataPoint[keyof DataPoint])): this | string | ((d: DataPoint, i: number) => DataPoint[keyof DataPoint]);
@@ -99,7 +108,7 @@ declare class VizBase extends BaseClass {
99
108
  */
100
109
  time(_?: string | ((d: DataPoint, i: number) => DataPoint[keyof DataPoint]) | false): this | string | ((d: DataPoint, i: number) => DataPoint[keyof DataPoint]) | false;
101
110
  /**
102
- 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.
111
+ 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.
103
112
  */
104
113
  timelineDefault(_?: Date | string | (Date | string)[]): this | Date[];
105
114
  /**
@@ -1,15 +1,22 @@
1
1
  import type { VizInstance } from "./vizTypes.js";
2
- type InkTarget = Pick<VizInstance, "schema"> & Partial<Pick<VizInstance, "_select">>;
2
+ type InkTarget = Pick<VizInstance, "schema"> & Partial<Pick<VizInstance, "_select" | "_theme">>;
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
  */
8
- export declare function chartBackground(viz: Partial<Pick<VizInstance, "_select">>): string;
9
+ export declare function chartBackground(viz: Partial<Pick<VizInstance, "_select" | "_theme">>): string;
9
10
  /**
10
11
  The text color that reads against the chart's own background: dark on a
11
- light page, light on a dark one.
12
+ light page, light on a dark one, or the theme's `text`.
12
13
  @private
13
14
  */
14
15
  export declare function backgroundInk(viz: InkTarget): string;
16
+ /**
17
+ The chart's gridline color: the theme's `gridline`, a faint step off the
18
+ chart's background.
19
+ @private
20
+ */
21
+ export declare function chartGridline(viz: InkTarget): string;
15
22
  export {};
@@ -0,0 +1,28 @@
1
+ /** Options for {@link createDataPoller}. */
2
+ export interface DataPollerOptions<T> {
3
+ /** Milliseconds between the end of one fetch and the start of the next. */
4
+ interval: number;
5
+ /** Fetches a fresh value. */
6
+ fetch: () => Promise<T>;
7
+ /** Receives each value fetched while the poller is running. */
8
+ onData: (value: T) => void;
9
+ /** Receives the first error of each run of consecutive failures. */
10
+ onError: (error: unknown) => void;
11
+ /** Whether ticks should wait (a hidden tab or an off-screen chart). */
12
+ paused: () => boolean;
13
+ }
14
+ /** A running poller, from {@link createDataPoller}. */
15
+ export interface DataPoller {
16
+ /** Stops the poller; a fetch still in flight is discarded. */
17
+ stop(): void;
18
+ /** Fetches at once if a tick came due while paused, then resumes the cadence. */
19
+ resume(): void;
20
+ }
21
+ /**
22
+ Calls `fetch` every `interval` ms, chaining each wait from the end of the
23
+ previous fetch so requests never overlap. A tick that comes due while
24
+ `paused()` is held until `resume()`. Errors are reported once per streak
25
+ and polling continues.
26
+ @private
27
+ */
28
+ export declare function createDataPoller<T>(opts: DataPollerOptions<T>): DataPoller;
@@ -0,0 +1,25 @@
1
+ /**
2
+ The ring drawn around the mark keyboard focus rests on.
3
+
4
+ @module
5
+ */
6
+ import type { GroupNode } from "@d3plus/render";
7
+ import type { FocusTarget } from "./focusTargets.js";
8
+ /** How the focus ring is drawn, resolved to plain values. */
9
+ export interface FocusRingStyle {
10
+ /** The ring's color. */
11
+ stroke: string;
12
+ /** The ring's width, in pixels. */
13
+ strokeWidth: number;
14
+ /** Space between the mark and a rectangular or circular ring, in pixels. */
15
+ padding: number;
16
+ /** A wider band drawn beneath the ring (the chart's background color), so the ring reads over any mark color. */
17
+ halo: string;
18
+ }
19
+ /**
20
+ The `viz-focus` scene group outlining `target`: a padded rectangle around
21
+ a rect-like mark or a stroke-only path, a circle around a circle or series
22
+ point, and the mark's own outline for a filled path. Inert and hidden from
23
+ assistive tech.
24
+ */
25
+ export declare function focusRingNode(target: FocusTarget, style: FocusRingStyle): GroupNode;
@@ -0,0 +1,56 @@
1
+ /**
2
+ The marks keyboard navigation moves between, read off a painted scene,
3
+ and the spatial rules for moving from one to the next.
4
+
5
+ @module
6
+ */
7
+ import type { Bounds } from "@d3plus/math";
8
+ import type { SceneNode, Transform } from "@d3plus/render";
9
+ /** A data mark (or one point of a Line/Area) keyboard focus can rest on. */
10
+ export interface FocusTarget {
11
+ /** Unique within a scene: the node's key, plus `@<point>` for a series point. */
12
+ id: string;
13
+ /** The scene node an event over this target picks. */
14
+ node: SceneNode;
15
+ /** Which of the node's `interactionPoints` this target is, for a series point. */
16
+ pointIndex?: number;
17
+ /** The target's center, in surface coordinates. */
18
+ center: [number, number];
19
+ /** The target's bounding box, in surface coordinates (zero-size for a series point). */
20
+ box: Bounds;
21
+ /** Whether events over it route to the chart's shape or legend handlers. */
22
+ group: "shape" | "legend";
23
+ /** The transforms above the node, outermost first (not its own). */
24
+ chain: Transform[];
25
+ }
26
+ /** The arrow-key directions. */
27
+ export type FocusDirection = "up" | "down" | "left" | "right";
28
+ /**
29
+ Sorts targets left to right by their left edge, then top to bottom: bars
30
+ and series points read along the x axis, a stack or a vertical legend
31
+ reads downward, and a treemap starts at its top-left cell.
32
+ */
33
+ export declare function readingOrder(targets: FocusTarget[]): FocusTarget[];
34
+ /**
35
+ Every mark keyboard focus can visit in a painted scene, chart marks first
36
+ and then legend items, each in reading order (see `readingOrder`).
37
+ Visits the chart cells and the legend only (not the colorScale, timeline,
38
+ or chrome), skipping `::hit` duplicates, inert or aria-hidden nodes,
39
+ text, axis/trend chrome, nodes without a datum, and marks a rectangular
40
+ clip hides (a zoomed chart's off-screen marks). A Line or Area node
41
+ becomes one target per point, and a row drawn by several nodes counts
42
+ once.
43
+ @param nodes The scene root's children (`viz._paintedScene.root.children`).
44
+ */
45
+ export declare function focusTargets(nodes: SceneNode[]): FocusTarget[];
46
+ /**
47
+ The target an arrow key moves to from `current`: the nearest one in that
48
+ direction whose center lies within a 45° cone of it, where two marks that
49
+ overlap across the direction of travel (bars sharing a baseline, cells
50
+ in one row) count as level with each other. Without one in the cone, the
51
+ nearest center anywhere in that half-plane. Returns `current` when
52
+ nothing lies that way, and the first target when there is no current
53
+ one. Moving along a series (Line/Area points), its own next point counts
54
+ as level, so the series is followed rather than a neighbor's point.
55
+ */
56
+ export declare function nextTarget(targets: FocusTarget[], current: FocusTarget | null | undefined, direction: FocusDirection): FocusTarget | null;
@@ -0,0 +1,24 @@
1
+ /**
2
+ Group rows: a row a chart draws for a whole group at a shallower `groupBy`
3
+ level than its marks (a Treemap's group header), merged from every row in
4
+ that group and stamped with its level under `GROUP_DEPTH_KEY`. Labels,
5
+ hover, and clicks read that level in place of the chart's drawn depth.
6
+ */
7
+ import type { DataPoint } from "@d3plus/data";
8
+ /** The row key holding a group row's `groupBy` level. */
9
+ export declare const GROUP_DEPTH_KEY = "__d3plusGroupDepth";
10
+ /** The row key holding a group row's own label, when its chart sets one. */
11
+ export declare const GROUP_LABEL_KEY = "__d3plusGroupLabel";
12
+ type GroupKey = (d: DataPoint, i: number) => unknown;
13
+ /** The `groupBy` level a group row stands for, or undefined for any other row. */
14
+ export declare function groupDepthOf(d: DataPoint | undefined | null): number | undefined;
15
+ /** A group row's key at each `groupBy` level, from the first down to its own. */
16
+ export declare function groupPath(groupBy: GroupKey[], d: DataPoint, depth: number): unknown[];
17
+ /**
18
+ Whether `d` belongs to the group at `path`: its key at each of the path's
19
+ levels is the group's, or for a merged row holds it.
20
+ */
21
+ export declare function inGroup(groupBy: GroupKey[], path: unknown[], d: DataPoint, i: number): boolean;
22
+ /** Whether `rows` hold any row outside the group at `path`, so zooming into it narrows the view. */
23
+ export declare function groupNarrows(groupBy: GroupKey[], path: unknown[], rows: DataPoint[]): boolean;
24
+ export {};
@@ -0,0 +1,35 @@
1
+ /**
2
+ The chart's Back history (`viz._history`): one stack holding drill-downs
3
+ and legend hide/solo clicks in the order they happened, so Back undoes
4
+ them in reverse.
5
+ */
6
+ import type { DrillDownHistoryEntry, HistoryEntry, LegendHistoryEntry, LegendState, VizInstance } from "./vizTypes.js";
7
+ /** Whether a Back history entry records a legend click. */
8
+ export declare function isLegendEntry(entry: HistoryEntry): entry is LegendHistoryEntry;
9
+ /** The newest drill-down entry on a Back history, skipping legend entries. */
10
+ export declare function latestDrillEntry(history: HistoryEntry[] | undefined): DrillDownHistoryEntry | undefined;
11
+ /** Removes and returns the newest drill-down entry, leaving the legend entries around it in place. */
12
+ export declare function removeLatestDrillEntry(history: HistoryEntry[] | undefined): DrillDownHistoryEntry | undefined;
13
+ /** Whether two legend id lists hold the same ids, in any order. */
14
+ export declare function sameLegendIds(a: (string | number)[], b: (string | number)[]): boolean;
15
+ /** The chart's current legend hide/solo state, as a Back history entry. */
16
+ export declare function legendSnapshot(viz: VizInstance): LegendHistoryEntry;
17
+ /**
18
+ Records a legend click on the Back history: pushes `before` (the state
19
+ the click started from) when the click changed what is hidden or solo'd
20
+ and `legendHistory` is on. Returns whether it pushed.
21
+ */
22
+ export declare function recordLegendChange(viz: VizInstance, before: LegendHistoryEntry): boolean;
23
+ /** Puts back the legend state a history entry recorded. */
24
+ export declare function restoreLegendEntry(viz: VizInstance, entry: LegendState): void;
25
+ /**
26
+ Clears the legend's hide/solo state for a drill to a deeper level, whose
27
+ legend lists other groups, and returns the state it cleared for the
28
+ drill's history entry (undefined when nothing was hidden or solo'd).
29
+ */
30
+ export declare function takeLegendState(viz: VizInstance): LegendState | undefined;
31
+ /**
32
+ Drops the legend's steps from the Back history: every legend entry, and
33
+ the legend state drill-down entries would put back. The drill-downs stay.
34
+ */
35
+ export declare function dropLegendHistory(viz: VizInstance): void;
@@ -17,7 +17,9 @@ import type { VizInstance } from "./vizTypes.js";
17
17
  by its bucket COLOR, not by id/value — so this only touches those nodes and
18
18
  leaves the colorScale title/axis/gradient at full opacity. A swatch stays
19
19
  bright when its color is "active" (its range contains a datum matching the
20
- current hover); every other swatch dims. No-op when nothing is hovered.
20
+ current hover); every other swatch dims. A chart without a hover
21
+ predicate of its own (shape hover off) lights the swatch of the value
22
+ its colorScale marks (see `hoveredSwatch`). No-op when nothing is hovered.
21
23
  */
22
24
  export declare function applyColorScaleBucketOpacity(nodes: SceneNode[], viz: VizInstance): SceneNode[];
23
25
  export declare function applyInteractionOpacity(nodes: SceneNode[], viz: VizInstance): SceneNode[];
@@ -0,0 +1,55 @@
1
+ /**
2
+ Keyboard navigation between a chart's data marks (`keyboardNav`). The
3
+ chart is one Tab stop: a focusable host beside its root svg (see
4
+ `keyboardNavHost.ts`). Arrow keys move between marks spatially, and each
5
+ move is replayed through the pointer bridge as the events a mouse would
6
+ send over that mark, so tooltips, hover highlights, the shared tooltip,
7
+ click handlers, and drill-down all behave as they do for the pointer.
8
+
9
+ @module
10
+ */
11
+ import type { SceneNode, Transform } from "@d3plus/render";
12
+ import type { FocusRingStyle } from "./focusRing.js";
13
+ import type { FocusTarget } from "./focusTargets.js";
14
+ import type { KeyboardNavHost } from "./keyboardNavHost.js";
15
+ import type { VizInstance } from "./vizTypes.js";
16
+ /** A chart's keyboard-navigation state, kept on `viz._keyboardNav`. */
17
+ export interface KeyboardNavState extends KeyboardNavHost {
18
+ /** The `id` of the focused target, or null when no mark is focused. */
19
+ current: string | null;
20
+ /** The target the replayed pointer last entered, for the matching leave. */
21
+ hovered: FocusTarget | null;
22
+ /** The chart scene and zoom the focused target was last resolved against. */
23
+ chartScene?: SceneNode[];
24
+ zoom?: Transform;
25
+ /** Set when a redraw moved or replaced the focused mark, so it is re-entered. */
26
+ stale: boolean;
27
+ /** Replayed events waiting for an animated transition to settle. */
28
+ queue: (() => void)[];
29
+ timer?: ReturnType<typeof setTimeout>;
30
+ /** The host's DOM listeners, for removal. */
31
+ listeners: [string, EventListener][];
32
+ }
33
+ /**
34
+ What the live region announces for a target: a series point's label from
35
+ the chart's `ariaLabel` accessor, a mark's own `aria-label`, or else its
36
+ label as the tooltip titles it.
37
+ */
38
+ export declare function targetLabel(viz: VizInstance, target: FocusTarget): string;
39
+ /** The focus ring's style for a target, from `keyboardNavConfig`. */
40
+ export declare function focusRingStyle(viz: VizInstance, target: FocusTarget): FocusRingStyle;
41
+ /** Removes the host and its listeners, clearing any replayed hover. */
42
+ export declare function teardownKeyboardNav(viz: VizInstance): void;
43
+ /**
44
+ Brings the host in line with the chart after a paint: creates it (or
45
+ removes it under `keyboardNav(false)`), refreshes its name and box, and
46
+ re-enters the focused mark when a redraw moved or replaced it.
47
+ */
48
+ export declare function syncKeyboardNav(viz: VizInstance): void;
49
+ /**
50
+ The focus ring for the scene being built, appended last so it draws above
51
+ everything. Resolves the focused mark by its id in `children`, falling
52
+ back to the first mark when a redraw removed it (and marking the state
53
+ stale so `syncKeyboardNav` re-enters it).
54
+ */
55
+ export declare function appendFocusRing(viz: VizInstance, children: SceneNode[]): void;
@@ -0,0 +1,53 @@
1
+ /**
2
+ The focusable element keyboard navigation listens on: one per chart,
3
+ beside its root svg (outside that svg's `aria-hidden` subtree), holding
4
+ the navigation instructions and the live region that announces the
5
+ focused mark.
6
+
7
+ @module
8
+ */
9
+ import type { VizInstance } from "./vizTypes.js";
10
+ /** The host's elements. */
11
+ export interface KeyboardNavHost {
12
+ /** The focusable element, laid over the chart without taking pointer events. */
13
+ host: HTMLDivElement;
14
+ /** Visually hidden instructions, referenced by the host's `aria-describedby`. */
15
+ desc: HTMLSpanElement;
16
+ /** Visually hidden `aria-live` region announcing the focused mark. */
17
+ live: HTMLSpanElement;
18
+ }
19
+ /**
20
+ A chart's own keys, consulted before mark navigation (a Geomap globe
21
+ turns on Shift and the arrow keys).
22
+ */
23
+ export interface KeyboardGesture {
24
+ /** Handles a keydown; true when the chart took the key. */
25
+ keydown(event: KeyboardEvent): boolean;
26
+ /**
27
+ The keys the chart takes now, as `aria-keyshortcuts` lists them, and
28
+ their translated instructions; null when it takes none.
29
+ */
30
+ keys(): {
31
+ shortcuts: string;
32
+ instructions: string;
33
+ } | null;
34
+ }
35
+ /** The instructions read when the chart gains focus. */
36
+ export declare const KEYBOARD_NAV_INSTRUCTIONS = "Use arrow keys to move between data points, Enter to select, and Escape to exit.";
37
+ /** The text of an HTML string, tags removed and whitespace collapsed. */
38
+ export declare function plainText(html: unknown): string;
39
+ /**
40
+ The chart's accessible name: its `svgTitle`, else its `title` text, else
41
+ the translated word "Chart".
42
+ */
43
+ export declare function chartName(viz: Pick<VizInstance, "schema">): string;
44
+ /**
45
+ Creates the host inside `parent`: a `tabindex="0"`, `role="application"`
46
+ element laid over the chart, with its instructions and live region.
47
+ */
48
+ export declare function createKeyboardNavHost(parent: HTMLElement, uuid: string): KeyboardNavHost;
49
+ /**
50
+ Refreshes the host's name, description, and box from the chart's current
51
+ config and size, laying it over the chart's root svg.
52
+ */
53
+ export declare function updateKeyboardNavHost(viz: VizInstance, { host, desc }: KeyboardNavHost): void;
@@ -0,0 +1,78 @@
1
+ import type { ConfigField } from "../../fluent.js";
2
+ /** The loaders whose payload a `<key>Format` config key transforms. */
3
+ export declare const FORMAT_KEYS: readonly ["data", "links", "nodes", "topojson"];
4
+ /** A loader with a matching `<key>Format` config key. */
5
+ export type FormatKey = (typeof FORMAT_KEYS)[number];
6
+ /** Transforms a loader's payload (a loaded file or an inline value). */
7
+ export type LoadFormatter = (data: unknown) => unknown;
8
+ /** A loader's last value, and the formatter its stored payload went through. */
9
+ export interface LoaderState {
10
+ source: unknown;
11
+ applied: LoadFormatter | undefined;
12
+ }
13
+ /** A queued load: `[load, paths, formatter, key]`. */
14
+ type QueueEntry = [unknown, unknown, unknown, string];
15
+ /** The chart state the loaders read and write. */
16
+ export interface LoaderHost {
17
+ schema: Record<string, unknown>;
18
+ config?(config: Record<string, unknown>): unknown;
19
+ _loaders?: Partial<Record<FormatKey, LoaderState>>;
20
+ _queue?: QueueEntry[];
21
+ }
22
+ /**
23
+ Whether `key` names a loader with a `<key>Format` config key.
24
+ @private
25
+ */
26
+ export declare function isFormatKey(key: string): key is FormatKey;
27
+ /**
28
+ The `<key>Format` function set on a chart, or `undefined` when none is set.
29
+ @private
30
+ */
31
+ export declare function formatterFor(viz: LoaderHost, key: FormatKey): LoadFormatter | undefined;
32
+ /**
33
+ Runs `formatter` over a payload the way a loaded file is formatted: a
34
+ `data` formatter may return `{data, ...config}`, whose config is applied to
35
+ the chart. Without a formatter the payload passes through.
36
+ @private
37
+ */
38
+ export declare function formatPayload(viz: LoaderHost, key: FormatKey, payload: unknown, formatter: LoadFormatter | undefined): unknown;
39
+ /**
40
+ Stores a loader's payload where its getter reads it: a `_<key>` slot when
41
+ the chart has one (`_data`), its schema otherwise.
42
+ @private
43
+ */
44
+ export declare function storePayload(viz: LoaderHost, key: string, value: unknown): void;
45
+ /**
46
+ Sets a loader's value (`data`, `links`, `nodes`, `topojson`): a URL or
47
+ request object is queued to load on the next render, and an inline value is
48
+ stored at once. Passing a formatter as the second argument sets
49
+ `<key>Format`; leaving it out keeps the current one.
50
+ @param viz The chart.
51
+ @param key The loader.
52
+ @param args The loader's arguments: the value, then an optional formatter.
53
+ @private
54
+ */
55
+ export declare function setLoaderValue(viz: LoaderHost, key: FormatKey, args: ArrayLike<unknown>): void;
56
+ /**
57
+ Brings each loader's stored payload in line with its current `<key>Format`
58
+ before a render draws: a URL whose formatter changed since it loaded is
59
+ queued to load again (from the chart's cache when it holds the response),
60
+ and an inline value is formatted in place from the
61
+ value it was given. Queued loads already use the current formatter.
62
+ @private
63
+ */
64
+ export declare function syncLoaderFormats(viz: LoaderHost): void;
65
+ /**
66
+ The formatter a queued load of `key` runs: the chart's current
67
+ `<key>Format` for a loader that has one (recorded as applied), otherwise
68
+ the formatter queued with it.
69
+ @private
70
+ */
71
+ export declare function queuedFormatter(viz: LoaderHost, key: string, queued: unknown): LoadFormatter | undefined;
72
+ /**
73
+ The `<key>Format` config fields for a chart's loaders. A new
74
+ `topojsonFormat` re-fits the map to the reformatted topojson.
75
+ @param keys The loaders the chart has.
76
+ */
77
+ export declare function loaderFormatFields(...keys: FormatKey[]): ConfigField[];
78
+ export {};
@@ -0,0 +1,57 @@
1
+ /**
2
+ Warns when a config key names a data field that no row of the chart's data
3
+ has (a typo like `y: "vlaue"` otherwise draws an empty chart in silence).
4
+ Only field names the user gave are checked: string config values become
5
+ accessors remembered by `fieldAccessor`, while function accessors,
6
+ constants, and defaults are never checked.
7
+ */
8
+ import type { DataPoint } from "@d3plus/data";
9
+ import type { VizInstance } from "./vizTypes.js";
10
+ /** A config key and the data field it names. */
11
+ export interface FieldUse {
12
+ key: string;
13
+ field: string;
14
+ }
15
+ /** The most field names a warning lists. */
16
+ export declare const MAX_LISTED_FIELDS = 10;
17
+ /**
18
+ The data fields a chart's config names, each under the first key that
19
+ holds its accessor (so `thresholdKey`, which some charts point at `sum` or
20
+ `y`, only names a field the user gave it alone).
21
+ @param viz The chart.
22
+ */
23
+ export declare function fieldUses(viz: VizInstance): FieldUse[];
24
+ /**
25
+ The rows a chart's field names are read from: its data (the user's rows,
26
+ when the chart derives `_data` from them), plus the `nodes` and `links`
27
+ arrays of a network chart.
28
+ @param viz The chart.
29
+ */
30
+ export declare function fieldRows(viz: VizInstance): DataPoint[][];
31
+ /**
32
+ Whether any row in `rowSets` has `field`.
33
+ @param rowSets Arrays of data rows.
34
+ @param field The field name.
35
+ */
36
+ export declare function rowsHaveField(rowSets: DataPoint[][], field: string): boolean;
37
+ /**
38
+ Every field name in `rowSets`, in the order first seen.
39
+ @param rowSets Arrays of data rows.
40
+ */
41
+ export declare function rowFields(rowSets: DataPoint[][]): string[];
42
+ /**
43
+ The warning for a config key whose field no row has, listing the first
44
+ `MAX_LISTED_FIELDS` fields the rows do have.
45
+ @param chart The chart's name.
46
+ @param use The config key and the field it names.
47
+ @param fields The fields the rows have.
48
+ */
49
+ export declare function missingFieldMessage(chart: string, { key, field }: FieldUse, fields: string[]): string;
50
+ /**
51
+ Warns, once per key and field for each chart, about every config key that
52
+ names a field none of the chart's rows have. Rows missing some fields are
53
+ normal (sparse data), so a field any row has never warns, and a chart with
54
+ no rows warns about nothing.
55
+ @param viz The chart.
56
+ */
57
+ export declare function warnMissingFields(viz: VizInstance): void;
@@ -0,0 +1,7 @@
1
+ /**
2
+ Resolves the element a renderer mounts into. A `<canvas>` cannot paint inside
3
+ an `<svg>`, so when the scene target is the compute svg, the canvas mounts
4
+ into that svg's parent (the user's element); the emptied, position:absolute
5
+ compute svg overlays the same top-left box. SVG mounts into the target as-is.
6
+ */
7
+ export declare function mountTargetFor(kind: string, target: Element): Element;