@d3plus/core 4.10.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 (548) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +167 -8
  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 +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +3 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +2 -1
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +162 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +132 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +204 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +3 -3
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Network/applyLayout.js +138 -94
  70. package/es/src/charts/Network/bundle.js +81 -0
  71. package/es/src/charts/Network/clusterLabels.js +423 -0
  72. package/es/src/charts/Network/clusters.js +290 -0
  73. package/es/src/charts/Network/emit.js +253 -70
  74. package/es/src/charts/Network/graph.js +117 -0
  75. package/es/src/charts/Network/graphFluent.js +79 -0
  76. package/es/src/charts/Network/index.js +86 -106
  77. package/es/src/charts/Network/minNodeDistance.js +64 -0
  78. package/es/src/charts/Network/polygonRows.js +44 -0
  79. package/es/src/charts/Pack/index.js +5 -1
  80. package/es/src/charts/Pie/applyLayout.js +86 -27
  81. package/es/src/charts/Pie/arcFit.js +152 -0
  82. package/es/src/charts/Pie/curvedLabels.js +134 -0
  83. package/es/src/charts/Pie/emit.js +43 -96
  84. package/es/src/charts/Pie/index.js +64 -31
  85. package/es/src/charts/Pie/labelRoom.js +154 -0
  86. package/es/src/charts/Pie/outsideLabels.js +224 -0
  87. package/es/src/charts/Pie/outsideNodes.js +267 -0
  88. package/es/src/charts/Pie/pieLabels.js +137 -0
  89. package/es/src/charts/Pie/sectorBox.js +223 -0
  90. package/es/src/charts/Pie/straightLabels.js +96 -0
  91. package/es/src/charts/Pie/straightLayout.js +215 -0
  92. package/es/src/charts/Plot/alongLegend.js +76 -0
  93. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  94. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  95. package/es/src/charts/Plot/axisValues.js +43 -0
  96. package/es/src/charts/Plot/barWidth.js +59 -11
  97. package/es/src/charts/Plot/circleLabels.js +98 -0
  98. package/es/src/charts/Plot/connectGaps.js +237 -0
  99. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  100. package/es/src/charts/Plot/draw.js +8 -2
  101. package/es/src/charts/Plot/fillBetween.js +2 -1
  102. package/es/src/charts/Plot/forecastScene.js +3 -4
  103. package/es/src/charts/Plot/index.js +18 -10
  104. package/es/src/charts/Plot/labelPlacement.js +1 -1
  105. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  106. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  107. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  108. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  109. package/es/src/charts/Plot/pipeline.js +66 -19
  110. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  111. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  112. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  113. package/es/src/charts/Plot/pipelineScales.js +40 -8
  114. package/es/src/charts/Plot/plotFacet.js +12 -1
  115. package/es/src/charts/Plot/plotInit.js +34 -5
  116. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  117. package/es/src/charts/Plot/referenceDomains.js +133 -0
  118. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  119. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  120. package/es/src/charts/Plot/trendLabels.js +183 -0
  121. package/es/src/charts/Plot/trendLines.js +1 -0
  122. package/es/src/charts/Plot/trendScene.js +6 -3
  123. package/es/src/charts/Plot/trendTooltip.js +5 -1
  124. package/es/src/charts/PolarArea/index.js +2 -2
  125. package/es/src/charts/Priestley/applyLayout.js +14 -20
  126. package/es/src/charts/Priestley/index.js +4 -35
  127. package/es/src/charts/Priestley/timeAxis.js +100 -0
  128. package/es/src/charts/Radar/axisDecorations.js +49 -12
  129. package/es/src/charts/Radar/curvedLabels.js +187 -0
  130. package/es/src/charts/Radar/index.js +2 -3
  131. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  132. package/es/src/charts/RadialBar/emit.js +4 -1
  133. package/es/src/charts/RadialBar/index.js +16 -9
  134. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  135. package/es/src/charts/RadialMatrix/index.js +3 -7
  136. package/es/src/charts/Rings/applyLayout.js +41 -24
  137. package/es/src/charts/Rings/emit.js +174 -58
  138. package/es/src/charts/Rings/index.js +61 -28
  139. package/es/src/charts/Rings/ringsGraph.js +28 -9
  140. package/es/src/charts/Rings/ringsLoops.js +73 -0
  141. package/es/src/charts/Rings/ringsParallel.js +166 -0
  142. package/es/src/charts/Sankey/applyLayout.js +116 -39
  143. package/es/src/charts/Sankey/circularLayout.js +208 -0
  144. package/es/src/charts/Sankey/circularLinks.js +301 -0
  145. package/es/src/charts/Sankey/emit.js +164 -94
  146. package/es/src/charts/Sankey/index.js +72 -75
  147. package/es/src/charts/Sankey/labels.js +80 -0
  148. package/es/src/charts/Sankey/ribbons.js +88 -0
  149. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  150. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  151. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  152. package/es/src/charts/Scatter/index.js +25 -0
  153. package/es/src/charts/SlopeChart/index.js +116 -0
  154. package/es/src/charts/SlopeChart/slope.js +95 -0
  155. package/es/src/charts/Streamgraph/index.js +51 -0
  156. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  157. package/es/src/charts/Sunburst/emit.js +74 -63
  158. package/es/src/charts/Sunburst/index.js +3 -3
  159. package/es/src/charts/Tree/index.js +2 -6
  160. package/es/src/charts/Treemap/index.js +2 -5
  161. package/es/src/charts/Violin/inner.js +3 -5
  162. package/es/src/charts/definition/makeChart.js +10 -2
  163. package/es/src/charts/drawSteps/backControl.js +17 -5
  164. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  165. package/es/src/charts/drawSteps/minimap.js +6 -5
  166. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  167. package/es/src/charts/drawSteps/searchControls.js +2 -1
  168. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  169. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  170. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  171. package/es/src/charts/events/click.legend.js +7 -2
  172. package/es/src/charts/events/click.shape.js +8 -1
  173. package/es/src/charts/events/mousemove.shape.js +5 -2
  174. package/es/src/charts/facet/drawFacets.js +14 -5
  175. package/es/src/charts/features/annotationFrame.js +179 -0
  176. package/es/src/charts/features/annotationText.js +83 -0
  177. package/es/src/charts/features/annotationTypes.js +10 -0
  178. package/es/src/charts/features/attributionFeature.js +6 -11
  179. package/es/src/charts/features/axes.js +2 -1
  180. package/es/src/charts/features/axesFinal.js +3 -1
  181. package/es/src/charts/features/axesMeasure.js +7 -4
  182. package/es/src/charts/features/calloutLayout.js +121 -0
  183. package/es/src/charts/features/calloutScene.js +155 -0
  184. package/es/src/charts/features/chartGeometry.js +1 -1
  185. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  186. package/es/src/charts/features/circleLabels.js +207 -0
  187. package/es/src/charts/features/colorScaleBucket.js +2 -1
  188. package/es/src/charts/features/colorScaleHover.js +3 -2
  189. package/es/src/charts/features/colorScaleValue.js +97 -0
  190. package/es/src/charts/features/curvedArrows.js +158 -0
  191. package/es/src/charts/features/edgeArrows.js +160 -4
  192. package/es/src/charts/features/edgeBundling.js +442 -0
  193. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  194. package/es/src/charts/features/ensureZoomDom.js +32 -8
  195. package/es/src/charts/features/features.js +32 -14
  196. package/es/src/charts/features/featuresColorScale.js +20 -6
  197. package/es/src/charts/features/featuresLegend.js +15 -24
  198. package/es/src/charts/features/legendKeys.js +64 -0
  199. package/es/src/charts/features/lineLabels.js +55 -46
  200. package/es/src/charts/features/linkBundle.js +19 -0
  201. package/es/src/charts/features/linkColor.js +72 -0
  202. package/es/src/charts/features/linkFields.js +86 -0
  203. package/es/src/charts/features/linkFocus.js +118 -0
  204. package/es/src/charts/features/linkInteraction.js +312 -0
  205. package/es/src/charts/features/linkKeys.js +20 -0
  206. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  207. package/es/src/charts/features/linkLabelPath.js +162 -0
  208. package/es/src/charts/features/linkLabels.js +340 -0
  209. package/es/src/charts/features/linkWidths.js +32 -0
  210. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  211. package/es/src/charts/features/pathLabels.js +50 -0
  212. package/es/src/charts/features/plotAnnotations.js +68 -17
  213. package/es/src/charts/features/plotPaint.js +38 -11
  214. package/es/src/charts/features/polyline.js +129 -0
  215. package/es/src/charts/features/referenceAnnotations.js +403 -0
  216. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  217. package/es/src/charts/features/ringLabelNodes.js +93 -0
  218. package/es/src/charts/features/ringLabels.js +222 -0
  219. package/es/src/charts/features/sceneBounds.js +26 -6
  220. package/es/src/charts/features/selfLoops.js +306 -0
  221. package/es/src/charts/features/shapeEmit.js +47 -31
  222. package/es/src/charts/features/sharedFields.js +15 -2
  223. package/es/src/charts/features/textHalo.js +29 -0
  224. package/es/src/charts/index.js +8 -0
  225. package/es/src/charts/partition/chartFields.js +2 -2
  226. package/es/src/charts/partition/interaction.js +9 -5
  227. package/es/src/charts/partition/zoom.js +7 -6
  228. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  229. package/es/src/charts/pipeline/preDrawData.js +46 -3
  230. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  231. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  232. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  233. package/es/src/charts/polar/config.js +2 -3
  234. package/es/src/charts/viz/Viz.js +39 -36
  235. package/es/src/charts/viz/VizBase.js +18 -10
  236. package/es/src/charts/viz/backgroundInk.js +13 -7
  237. package/es/src/charts/viz/focusRing.js +104 -0
  238. package/es/src/charts/viz/focusTargets.js +208 -0
  239. package/es/src/charts/viz/history.js +74 -0
  240. package/es/src/charts/viz/keyboardNav.js +297 -0
  241. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  242. package/es/src/charts/viz/loaderFormat.js +114 -0
  243. package/es/src/charts/viz/missingFields.js +2 -1
  244. package/es/src/charts/viz/mountTarget.js +9 -0
  245. package/es/src/charts/viz/nearestHover.js +183 -0
  246. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  247. package/es/src/charts/viz/ordinalColor.js +14 -12
  248. package/es/src/charts/viz/pageTheme.js +83 -0
  249. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  250. package/es/src/charts/viz/pointVoronoi.js +124 -0
  251. package/es/src/charts/viz/reducedMotion.js +27 -0
  252. package/es/src/charts/viz/vizDataPolling.js +8 -3
  253. package/es/src/charts/viz/vizDefaults.js +15 -23
  254. package/es/src/charts/viz/vizFields.js +35 -0
  255. package/es/src/charts/viz/vizRender.js +43 -28
  256. package/es/src/charts/viz/vizTheme.js +96 -0
  257. package/es/src/charts/viz/vizVisibility.js +14 -0
  258. package/es/src/components/Axis/Axis.js +6 -0
  259. package/es/src/components/Axis/AxisBottom.js +1 -0
  260. package/es/src/components/Axis/AxisLeft.js +1 -0
  261. package/es/src/components/Axis/AxisRight.js +1 -0
  262. package/es/src/components/Axis/AxisTop.js +1 -0
  263. package/es/src/components/Axis/axisBreak.js +4 -1
  264. package/es/src/components/Axis/axisDefaults.js +5 -9
  265. package/es/src/components/Axis/axisLayoutScale.js +7 -1
  266. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  267. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  268. package/es/src/components/Axis/rangeBreaks.js +201 -0
  269. package/es/src/components/Axis/timeValues.js +19 -4
  270. package/es/src/components/ColorScale/ColorScale.js +15 -9
  271. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  272. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  273. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  274. package/es/src/components/Legend/Legend.js +3 -0
  275. package/es/src/components/Legend/legendConfig.js +2 -6
  276. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  277. package/es/src/components/TextBox.js +29 -65
  278. package/es/src/components/Timeline/Timeline.js +12 -3
  279. package/es/src/components/Timeline/timelineConfig.js +20 -10
  280. package/es/src/components/Timeline/timelineMode.js +26 -0
  281. package/es/src/components/Timeline/timelineRender.js +7 -3
  282. package/es/src/components/Tooltip.js +15 -5
  283. package/es/src/components/fontStack.js +20 -0
  284. package/es/src/components/textBoxLayout.js +58 -21
  285. package/es/src/components/textBoxPath.js +73 -0
  286. package/es/src/components/textBoxScene.js +223 -0
  287. package/es/src/components/textBoxWords.js +70 -0
  288. package/es/src/shapes/Area.js +1 -0
  289. package/es/src/shapes/Bar.js +1 -0
  290. package/es/src/shapes/Box.js +1 -0
  291. package/es/src/shapes/Circle.js +1 -0
  292. package/es/src/shapes/Line.js +1 -0
  293. package/es/src/shapes/Path.js +1 -0
  294. package/es/src/shapes/Rect.js +1 -0
  295. package/es/src/shapes/Shape.js +1 -0
  296. package/es/src/shapes/Whisker.js +1 -0
  297. package/es/src/utils/BaseClass.js +25 -12
  298. package/es/src/utils/configPrep.js +2 -1
  299. package/es/src/utils/constant.js +13 -1
  300. package/es/src/utils/displayName.js +12 -0
  301. package/es/src/utils/theme.js +190 -0
  302. package/es/src/utils/themeInk.js +68 -0
  303. package/package.json +14 -11
  304. package/types/index.d.ts +6 -2
  305. package/types/internal.d.ts +250 -8
  306. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  307. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  308. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  309. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  310. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  311. package/types/src/charts/Alluvial/index.d.ts +27 -0
  312. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  313. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  314. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  315. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  316. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  317. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  318. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  319. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  320. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  321. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  322. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  323. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  324. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  325. package/types/src/charts/Chord/labels.d.ts +66 -0
  326. package/types/src/charts/Donut/index.d.ts +2 -1
  327. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  328. package/types/src/charts/Gantt/emit.d.ts +17 -0
  329. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  330. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  331. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  332. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  333. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  334. package/types/src/charts/Gantt/index.d.ts +36 -0
  335. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  336. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  337. package/types/src/charts/Geomap/emit.d.ts +2 -2
  338. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  339. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  340. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  341. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  342. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  343. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  344. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  345. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  346. package/types/src/charts/Geomap/index.d.ts +3 -0
  347. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  348. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  349. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  350. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  351. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  352. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  353. package/types/src/charts/Hexbin/index.d.ts +25 -0
  354. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  355. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  356. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  357. package/types/src/charts/Histogram/binData.d.ts +20 -1
  358. package/types/src/charts/Histogram/index.d.ts +3 -2
  359. package/types/src/charts/Histogram/labels.d.ts +7 -0
  360. package/types/src/charts/Marimekko/index.d.ts +2 -1
  361. package/types/src/charts/Network/bundle.d.ts +67 -0
  362. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  363. package/types/src/charts/Network/clusters.d.ts +115 -0
  364. package/types/src/charts/Network/graph.d.ts +65 -0
  365. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  366. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  367. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  368. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  369. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  370. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  371. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  372. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  373. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  374. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  375. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  376. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  377. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  378. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  379. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  380. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  381. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  382. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  383. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  384. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  385. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  386. package/types/src/charts/Plot/index.d.ts +15 -8
  387. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  388. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  389. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  390. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  391. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  392. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  393. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  394. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  395. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  396. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  397. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  398. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  399. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  400. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  401. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  402. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  403. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  404. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  405. package/types/src/charts/Rings/emit.d.ts +50 -0
  406. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  407. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  408. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  409. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  410. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  411. package/types/src/charts/Sankey/emit.d.ts +58 -0
  412. package/types/src/charts/Sankey/labels.d.ts +19 -0
  413. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  414. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  415. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  416. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  417. package/types/src/charts/Scatter/index.d.ts +15 -0
  418. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  419. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  420. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  421. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  422. package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
  423. package/types/src/charts/definition/makeChart.d.ts +3 -2
  424. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  425. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  426. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  427. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  428. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  429. package/types/src/charts/events/click.legend.d.ts +2 -1
  430. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  431. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  432. package/types/src/charts/features/annotationText.d.ts +57 -0
  433. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  434. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  435. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  436. package/types/src/charts/features/calloutScene.d.ts +40 -0
  437. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  438. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  439. package/types/src/charts/features/circleLabels.d.ts +130 -0
  440. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  441. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  442. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  443. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  444. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  445. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  446. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  447. package/types/src/charts/features/legendKeys.d.ts +34 -0
  448. package/types/src/charts/features/lineLabels.d.ts +15 -12
  449. package/types/src/charts/features/linkBundle.d.ts +16 -0
  450. package/types/src/charts/features/linkColor.d.ts +48 -0
  451. package/types/src/charts/features/linkFields.d.ts +16 -0
  452. package/types/src/charts/features/linkFocus.d.ts +51 -0
  453. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  454. package/types/src/charts/features/linkKeys.d.ts +11 -0
  455. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  456. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  457. package/types/src/charts/features/linkLabels.d.ts +77 -0
  458. package/types/src/charts/features/linkWidths.d.ts +19 -0
  459. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  460. package/types/src/charts/features/pathLabels.d.ts +41 -0
  461. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  462. package/types/src/charts/features/plotPaint.d.ts +17 -0
  463. package/types/src/charts/features/polyline.d.ts +32 -0
  464. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  465. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  466. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  467. package/types/src/charts/features/ringLabels.d.ts +164 -0
  468. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  469. package/types/src/charts/features/selfLoops.d.ts +165 -0
  470. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  471. package/types/src/charts/features/sharedFields.d.ts +11 -2
  472. package/types/src/charts/features/textHalo.d.ts +14 -0
  473. package/types/src/charts/index.d.ts +8 -0
  474. package/types/src/charts/partition/interaction.d.ts +6 -3
  475. package/types/src/charts/partition/zoom.d.ts +4 -4
  476. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  477. package/types/src/charts/pipeline/stages.d.ts +7 -0
  478. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  479. package/types/src/charts/viz/Viz.d.ts +16 -2
  480. package/types/src/charts/viz/VizBase.d.ts +6 -6
  481. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  482. package/types/src/charts/viz/focusRing.d.ts +25 -0
  483. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  484. package/types/src/charts/viz/history.d.ts +35 -0
  485. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  486. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  487. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  488. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  489. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  490. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  491. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  492. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  493. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  494. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  495. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  496. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  497. package/types/src/charts/viz/vizFields.d.ts +32 -0
  498. package/types/src/charts/viz/vizRender.d.ts +2 -1
  499. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  500. package/types/src/charts/viz/vizTypes.d.ts +84 -7
  501. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  502. package/types/src/components/Axis/Axis.d.ts +1 -0
  503. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  504. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  505. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  506. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  507. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  508. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  509. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  510. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  511. package/types/src/components/Axis/timeValues.d.ts +1 -1
  512. package/types/src/components/ColorScale/ColorScale.d.ts +1 -0
  513. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  514. package/types/src/components/Legend/Legend.d.ts +1 -0
  515. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  516. package/types/src/components/TextBox.d.ts +1 -0
  517. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  518. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  519. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  520. package/types/src/components/Tooltip.d.ts +4 -3
  521. package/types/src/components/fontStack.d.ts +10 -0
  522. package/types/src/components/textBoxLayout.d.ts +18 -9
  523. package/types/src/components/textBoxPath.d.ts +59 -0
  524. package/types/src/components/textBoxScene.d.ts +51 -0
  525. package/types/src/components/textBoxWords.d.ts +33 -0
  526. package/types/src/shapes/Area.d.ts +1 -0
  527. package/types/src/shapes/Bar.d.ts +1 -0
  528. package/types/src/shapes/Box.d.ts +1 -0
  529. package/types/src/shapes/Circle.d.ts +1 -0
  530. package/types/src/shapes/Line.d.ts +1 -0
  531. package/types/src/shapes/Path.d.ts +1 -0
  532. package/types/src/shapes/Rect.d.ts +1 -0
  533. package/types/src/shapes/Shape.d.ts +1 -0
  534. package/types/src/shapes/Whisker.d.ts +1 -0
  535. package/types/src/utils/BaseClass.d.ts +9 -0
  536. package/types/src/utils/D3plusConfig.d.ts +981 -30
  537. package/types/src/utils/configPrep.d.ts +2 -0
  538. package/types/src/utils/constant.d.ts +8 -0
  539. package/types/src/utils/displayName.d.ts +10 -0
  540. package/types/src/utils/index.d.ts +1 -1
  541. package/types/src/utils/theme.d.ts +170 -0
  542. package/types/src/utils/themeInk.d.ts +56 -0
  543. package/umd/d3plus-core.full.js +86811 -61031
  544. package/umd/d3plus-core.full.min.js +2 -2
  545. package/umd/d3plus-core.js +28392 -6498
  546. package/umd/d3plus-core.min.js +2 -2
  547. package/es/src/components/Axis/gridStroke.js +0 -10
  548. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -12,13 +12,20 @@ import { unregisterLink } from "./linkGroup.js";
12
12
  import { stopDataPolling } from "./vizDataPolling.js";
13
13
  import { facetPanelAt, withFacetPanel } from "../facet/facetPanel.js";
14
14
  import { vizRender } from "./vizRender.js";
15
+ import { motionReduced } from "./reducedMotion.js";
15
16
  import { vizDraw } from "../pipeline/vizDraw.js";
16
17
  import { vizPreDraw } from "../pipeline/vizPreDraw.js";
17
18
  import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
18
19
  import { reportHandlerError } from "./reportHandlerError.js";
19
20
  import { vizClassNameTargets } from "./vizClassName.js";
21
+ import { themeBackground, unwatchPageTheme } from "./vizTheme.js";
22
+ import { stopVisibilityWatch } from "./vizVisibility.js";
20
23
  import { applyClassName, withRootClasses } from "../../utils/className.js";
21
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";
22
29
  /**
23
30
  Stamps `interactionGroup` onto a component's scene subtree so the pointer
24
31
  bridge can route its nodes to component-scoped handlers (e.g. legend) on
@@ -28,18 +35,10 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
28
35
  const kids = node.children;
29
36
  if (kids) for (const child of kids)tagInteractionGroup(child, group);
30
37
  }
31
- /**
32
- Resolves the element a renderer mounts into. A `<canvas>` cannot paint inside
33
- an `<svg>`, so when the scene target is the compute svg, the canvas mounts
34
- into that svg's parent (the user's element); the emptied, position:absolute
35
- compute svg overlays the same top-left box. SVG mounts into the target as-is.
36
- */ function mountTargetFor(kind, target) {
37
- if (kind === "canvas" && typeof Element !== "undefined" && target instanceof Element && target.tagName.toLowerCase() === "svg") return target.parentNode ?? target;
38
- return target;
39
- }
40
38
  /**
41
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, …).
42
40
  */ export default class Viz extends VizBase {
41
+ static _displayName = "Viz";
43
42
  /**
44
43
  Invoked when creating a new class instance, and sets any default parameters.
45
44
  @private
@@ -62,7 +61,7 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
62
61
  - chart-level components (Legend/ColorScale/Timeline) via their toScene
63
62
  - `_featurePanels` (from FeatureModule layouts) wrapped in viz-features
64
63
  */ toScene() {
65
- const children = [];
64
+ const children = themeBackground(this);
66
65
  // Chart cells stashed on _chartScene — via `chartDef.emit(ctx)` for
67
66
  // data-driven charts, or `Plot._paint` for the paint-driven Plot family.
68
67
  // Wraps in three groups:
@@ -169,6 +168,8 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
169
168
  children: this._featurePanels
170
169
  });
171
170
  }
171
+ // Keyboard navigation's focus ring, above everything else.
172
+ appendFocusRing(this, children);
172
173
  return {
173
174
  width: this.schema.width,
174
175
  height: this.schema.height,
@@ -200,6 +201,13 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
200
201
  */ _insetRegion() {
201
202
  return null;
202
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
+ }
203
211
  /**
204
212
  The shape a colorScale row draws as (see
205
213
  `ChartDefinition.colorScaleShape`): the row's `shape`, unless the chart
@@ -249,7 +257,7 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
249
257
  }
250
258
  /**
251
259
  Draws the visualization given the specified configuration.
252
- @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.
253
261
  */ render(callback) {
254
262
  return vizRender(this, callback);
255
263
  }
@@ -301,8 +309,9 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
301
309
  // `durationOverride` defaults to the chart's `_duration` for normal
302
310
  // re-renders. Interaction handlers (zoomed, hover, etc.) pass 0 to
303
311
  // skip the transition machinery — animating every wheel/drag tick
304
- // accumulates `setTimeout(duration+10)` per event.
305
- const drawDuration = durationOverride !== undefined ? durationOverride : this._instantNextDraw ? 0 : this.schema.duration;
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;
306
315
  // A duration>0 render (drill-down, zoom, re-center) must win over any
307
316
  // pending coalesced duration-0 repaint — otherwise that repaint fires on
308
317
  // the next frame and interrupts this transition, snapping shapes to their
@@ -375,6 +384,8 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
375
384
  applyZoomPointerEvents(this);
376
385
  if (this._select && kind === "canvas") this._select.selectAll("g.d3plus-viz-timeline, g.d3plus-viz-brush").style("pointer-events", "auto");
377
386
  if (kind === "canvas") bindCanvasZoom(this);
387
+ nearestHoverSurface(this);
388
+ syncKeyboardNav(this);
378
389
  // The timeline brush (d3-brush DOM, mounted in `g.d3plus-viz-timeline` in
379
390
  // the outer svg) must paint above the scene-rendered timeline buttons/ticks
380
391
  // so its selection tint + handles sit on top of them (matching v3). The
@@ -403,6 +414,14 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
403
414
  */ _interactionDatum(pick, _event) {
404
415
  return handlerDatum(pick.datum, pick.index ?? 0);
405
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
+ }
406
425
  /**
407
426
  Pointer hook run by `_routeSceneEvent` before any handler routing, for
408
427
  every event including ones over empty space. No-op here; Plot overrides
@@ -457,13 +476,12 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
457
476
  // tooltips never fire on the v4 scene-rendered path because
458
477
  // `shape.on(evt, fn)` in plotPaint only wires d3-selection
459
478
  // listeners on DOM nodes the scene renderer doesn't create.
460
- // Renderer events carry the picked scene node; the routing lives in
461
- // `_routeSceneEvent` (kept out of this method so the mount path stays
462
- // readable). `_lastScenePick` remembers the most recently hovered node
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
463
481
  // so `mouseleave` — fired with a null pick — can still tell the matching
464
482
  // handlers which shape/legend item was left (so the tooltip clears).
465
483
  this._lastScenePick = null;
466
- this._sceneRenderer.on((event)=>this._routeSceneEvent(event));
484
+ this._sceneRenderer.on((event)=>routePointerEvent(this, event));
467
485
  } else {
468
486
  this._sceneRenderer.resize(w, h);
469
487
  }
@@ -604,35 +622,20 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
604
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.
605
623
  */ destroy() {
606
624
  unregisterLink(this);
625
+ teardownKeyboardNav(this);
626
+ nearestHoverSurface(this, true);
627
+ unwatchPageTheme(this);
607
628
  stopDataPolling(this);
608
629
  this._resizeObserver?.disconnect();
609
630
  this._fontsUnsubscribe?.();
610
631
  this._fontsUnsubscribe = undefined;
611
632
  this._tooltipClass.data([]).render();
612
633
  select("body").on(`touchstart.${this._uuid}`, null);
613
- // Clear the visibility/resize/scroll poll timers + scroll listener
614
- // so a destroyed chart doesn't keep firing intervals/timeouts that
615
- // hold the entire viz instance alive. Without this, an SPA that
616
- // mounts/unmounts charts on tab switches leaks the scene tree +
617
- // a 200ms-interval timer per leaked chart.
618
- if (this._visiblePoll) {
619
- this._visiblePoll = clearInterval(this._visiblePoll);
620
- }
621
- if (this._resizePoll) {
622
- this._resizePoll = clearTimeout(this._resizePoll);
623
- }
624
- if (this._scrollPoll) {
625
- this._scrollPoll = clearTimeout(this._scrollPoll);
626
- }
627
- this._visibleUnobserve?.();
628
- this._visibleUnobserve = undefined;
629
- this._unloadUnobserve?.();
630
- this._unloadUnobserve = undefined;
634
+ stopVisibilityWatch(this);
631
635
  if (this._sceneRepaintRAF != null) {
632
636
  if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(this._sceneRepaintRAF);
633
637
  this._sceneRepaintRAF = undefined;
634
638
  }
635
- if (this.schema.scrollContainer) select(this.schema.scrollContainer).on(`scroll.${this._uuid}`, null);
636
639
  // Destroy the active scene renderer (clears its own pointer-rect
637
640
  // listeners, overlay host, canvas/svg DOM, timers).
638
641
  if (this._sceneRenderer && typeof this._sceneRenderer.destroy === "function") {
@@ -1,21 +1,25 @@
1
1
  import { select } from "d3-selection";
2
- import { addToQueue, unique } from "@d3plus/data";
2
+ import { unique } from "@d3plus/data";
3
3
  import { fontFamilyStringify } from "@d3plus/text";
4
4
  import { date } from "@d3plus/dom";
5
5
  import { BaseClass, constant } from "../../utils/index.js";
6
6
  import { fieldAccessor } from "../../utils/fieldAccessor.js";
7
7
  import { coerceFacet } from "../facet/facetConfig.js";
8
8
  import { groupDepthOf } from "./groupRow.js";
9
+ import { dropLegendHistory } from "./history.js";
9
10
  import { broadcastLink } from "./linkGroup.js";
10
11
  import { shapeHoverEnabled } from "./shapeHover.js";
12
+ import { setLoaderValue } from "./loaderFormat.js";
11
13
  import { stopDataPolling } from "./vizDataPolling.js";
12
14
  import { isPlainObject, mergeConfigBag, resolvesReset } from "../../fluent.js";
13
15
  import validateShapeConfig from "../../shapes/validateShapeConfig.js";
16
+ import { displayName } from "../../utils/displayName.js";
14
17
  /**
15
18
  The fluent config accessors shared by every Viz chart that need more than
16
19
  storing their value (most are generated from `vizFields.ts`); `Viz` adds
17
20
  the render lifecycle.
18
21
  */ class VizBase extends BaseClass {
22
+ static _displayName = "VizBase";
19
23
  /**
20
24
  The active callback function for highlighting shapes.
21
25
  */ active(_) {
@@ -35,25 +39,29 @@ import validateShapeConfig from "../../shapes/validateShapeConfig.js";
35
39
 
36
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.
37
41
 
38
- Additionally, a custom formatting function can be passed as a second argument to this method. This custom function will be passed the data that has been loaded, as long as there are no errors. This function should return the final array of obejcts to be used as the primary data array. For example, some JSON APIs return the headers split from the data values to save bandwidth. These would need be joined using a custom formatter.
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`.
39
43
 
40
- If you would like to specify certain configuration options based on the yet-to-be-loaded data, you can also return a full `config` object from the data formatter (including the new `data` array as a key in the object).
41
-
42
- To re-fetch a URL on an interval and redraw when its data changes, set `dataPollingInterval`; each poll runs the same formatter.
44
+ To re-fetch a URL on an interval and redraw when its data changes, set `dataPollingInterval`; each poll runs `dataFormat`.
43
45
 
44
46
  Defaults to an empty array (`[]`).
45
- @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`.
46
49
  */ data(_, f) {
47
50
  if (arguments.length) {
48
- addToQueue.bind(this)(_, f, "data");
51
+ setLoaderValue(this, "data", arguments.length > 1 ? [
52
+ _,
53
+ f
54
+ ] : [
55
+ _
56
+ ]);
49
57
  this._hidden = [];
50
58
  this._solo = [];
59
+ dropLegendHistory(this);
51
60
  if (this._userData && JSON.stringify(_) !== JSON.stringify(this._userData)) {
52
61
  this.schema.timeFilter = false;
53
62
  this._timelineSelection = false;
54
63
  }
55
64
  this._userData = _;
56
- this._userDataFormat = f;
57
65
  this._dataSignature = undefined;
58
66
  stopDataPolling(this);
59
67
  return this;
@@ -205,7 +213,7 @@ Defaults to an empty array (`[]`).
205
213
  }
206
214
  shapeConfig(_) {
207
215
  if (!arguments.length) return this.schema.shapeConfig;
208
- if (isPlainObject(_)) validateShapeConfig(this.constructor.name, _);
216
+ if (isPlainObject(_)) validateShapeConfig(displayName(this), _);
209
217
  this.schema.shapeConfig = mergeConfigBag(this, "shapeConfig", _);
210
218
  return this;
211
219
  }
@@ -269,7 +277,7 @@ Defaults to an empty array (`[]`).
269
277
  } else return this.schema.time;
270
278
  }
271
279
  /**
272
- The starting time or range for the timeline. Can be a single Date/String, or an Array of 2 values representing the min and max.
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.
273
281
  */ timelineDefault(_) {
274
282
  if (arguments.length) {
275
283
  if (!(_ instanceof Array)) _ = [
@@ -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,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
+ }
@@ -0,0 +1,208 @@
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
+ */ import { mapBox, mapper, ownBoxes } from "../features/sceneBounds.js";
7
+ import { MARK_TYPES } from "./sceneRows.js";
8
+ /** Root groups that hold navigable marks, and the handler group each routes to. */ const ROOT_GROUPS = {
9
+ "viz-chart-cells": "shape",
10
+ "viz-legend": "legend"
11
+ };
12
+ /** Interaction groups that are chart chrome rather than data marks. */ const CHROME_GROUPS = new Set([
13
+ "axis",
14
+ "timeline",
15
+ "trend"
16
+ ]);
17
+ /** Whether a node (and everything inside it) is out of keyboard reach. */ function skipped(node) {
18
+ const n = node;
19
+ return String(n.key).endsWith("::hit") || n.interactive === false || !!n.aria?.hidden || n.interactionGroup !== undefined && CHROME_GROUPS.has(n.interactionGroup);
20
+ }
21
+ /** The source row a node's datum wraps, so a mark drawn twice counts once. */ function rowOf(datum) {
22
+ const raw = datum;
23
+ return raw && raw.data ? raw.data : raw;
24
+ }
25
+ /** The box around a list of boxes. */ function union(boxes) {
26
+ const x = Math.min(...boxes.map((b)=>b.x)), y = Math.min(...boxes.map((b)=>b.y));
27
+ const x2 = Math.max(...boxes.map((b)=>b.x + b.width)), y2 = Math.max(...boxes.map((b)=>b.y + b.height));
28
+ return {
29
+ x,
30
+ y,
31
+ width: x2 - x,
32
+ height: y2 - y
33
+ };
34
+ }
35
+ /** Whether a point lies within a box, give or take a pixel. */ const inside = ([x, y], b)=>x >= b.x - 1 && x <= b.x + b.width + 1 && y >= b.y - 1 && y <= b.y + b.height + 1;
36
+ const finite = (b)=>[
37
+ b.x,
38
+ b.y,
39
+ b.width,
40
+ b.height
41
+ ].every(Number.isFinite);
42
+ /** One target per series point of a Line/Area node. */ function pointTargets(node, chain, group, seen) {
43
+ const map = mapper(chain);
44
+ const out = [];
45
+ (node.interactionPoints || []).forEach((p, pointIndex)=>{
46
+ if (seen.has(p.datum)) return;
47
+ seen.add(p.datum);
48
+ const center = map([
49
+ p.x,
50
+ p.y
51
+ ]);
52
+ const box = {
53
+ x: center[0],
54
+ y: center[1],
55
+ width: 0,
56
+ height: 0
57
+ };
58
+ if (!finite(box)) return;
59
+ const id = `${node.key}@${pointIndex}`;
60
+ out.push({
61
+ id,
62
+ node,
63
+ pointIndex,
64
+ center,
65
+ box,
66
+ group,
67
+ chain
68
+ });
69
+ });
70
+ return out;
71
+ }
72
+ /** The target for a single mark, or null when it has no finite geometry. */ function markTarget(node, chain, group) {
73
+ const full = node.transform ? [
74
+ ...chain,
75
+ node.transform
76
+ ] : chain;
77
+ const map = mapper(full);
78
+ const boxes = ownBoxes(node).filter(finite).map((b)=>mapBox(b, map));
79
+ if (!boxes.length) return null;
80
+ const box = union(boxes);
81
+ // A path's boxes are its outline's vertices; their mean sits inside a
82
+ // curved shape (a pie wedge) more often than its bounding box's center.
83
+ const center = node.type === "path" ? [
84
+ boxes.reduce((s, b)=>s + b.x, 0) / boxes.length,
85
+ boxes.reduce((s, b)=>s + b.y, 0) / boxes.length
86
+ ] : [
87
+ box.x + box.width / 2,
88
+ box.y + box.height / 2
89
+ ];
90
+ return {
91
+ id: String(node.key),
92
+ node,
93
+ center,
94
+ box,
95
+ group,
96
+ chain
97
+ };
98
+ }
99
+ /**
100
+ Sorts targets left to right by their left edge, then top to bottom: bars
101
+ and series points read along the x axis, a stack or a vertical legend
102
+ reads downward, and a treemap starts at its top-left cell.
103
+ */ export function readingOrder(targets) {
104
+ return [
105
+ ...targets
106
+ ].sort((a, b)=>Math.round(a.box.x) - Math.round(b.box.x) || Math.round(a.box.y) - Math.round(b.box.y));
107
+ }
108
+ /**
109
+ Every mark keyboard focus can visit in a painted scene, chart marks first
110
+ and then legend items, each in reading order (see `readingOrder`).
111
+ Visits the chart cells and the legend only (not the colorScale, timeline,
112
+ or chrome), skipping `::hit` duplicates, inert or aria-hidden nodes,
113
+ text, axis/trend chrome, nodes without a datum, and marks a rectangular
114
+ clip hides (a zoomed chart's off-screen marks). A Line or Area node
115
+ becomes one target per point, and a row drawn by several nodes counts
116
+ once.
117
+ @param nodes The scene root's children (`viz._paintedScene.root.children`).
118
+ */ export function focusTargets(nodes) {
119
+ const lists = {
120
+ shape: [],
121
+ legend: []
122
+ };
123
+ for (const top of nodes){
124
+ const group = ROOT_GROUPS[String(top.key)];
125
+ if (!group) continue;
126
+ const seen = new Set();
127
+ const walk = (node, chain, clips)=>{
128
+ if (skipped(node)) return;
129
+ if (node.type === "group") {
130
+ const next = node.transform ? [
131
+ ...chain,
132
+ node.transform
133
+ ] : chain;
134
+ const clip = node.clip;
135
+ const inner = clip && clip.type === "rect" ? [
136
+ ...clips,
137
+ mapBox(clip, mapper(next))
138
+ ] : clips;
139
+ for (const child of node.children)walk(child, next, inner);
140
+ return;
141
+ }
142
+ if (!MARK_TYPES.has(node.type) || node.datum === undefined) return;
143
+ if (node.paint?.opacity === 0) return;
144
+ const visible = (t)=>clips.every((c)=>inside(t.center, c));
145
+ if (node.interactionPoints?.length) {
146
+ const points = pointTargets(node, chain, group, seen);
147
+ lists[group].push(...points.filter(visible));
148
+ return;
149
+ }
150
+ const row = rowOf(node.datum);
151
+ if (seen.has(row)) return;
152
+ const target = markTarget(node, chain, group);
153
+ if (!target || !visible(target)) return;
154
+ seen.add(row);
155
+ lists[group].push(target);
156
+ };
157
+ walk(top, [], []);
158
+ }
159
+ return [
160
+ ...readingOrder(lists.shape),
161
+ ...readingOrder(lists.legend)
162
+ ];
163
+ }
164
+ /** The vertical (or horizontal) overlap of two boxes, in pixels. */ function overlap(a, b, axis) {
165
+ const size = axis === "x" ? "width" : "height";
166
+ return Math.min(a[axis] + a[size], b[axis] + b[size]) - Math.max(a[axis], b[axis]);
167
+ }
168
+ /** The axis a Line/Area node's points run along: the one they spread farther across. */ function seriesAxis(node) {
169
+ const points = node.interactionPoints || [];
170
+ const spread = (k)=>Math.max(...points.map((p)=>p[k])) - Math.min(...points.map((p)=>p[k]));
171
+ return spread("x") >= spread("y") ? "x" : "y";
172
+ }
173
+ /**
174
+ The target an arrow key moves to from `current`: the nearest one in that
175
+ direction whose center lies within a 45° cone of it, where two marks that
176
+ overlap across the direction of travel (bars sharing a baseline, cells
177
+ in one row) count as level with each other. Without one in the cone, the
178
+ nearest center anywhere in that half-plane. Returns `current` when
179
+ nothing lies that way, and the first target when there is no current
180
+ one. Moving along a series (Line/Area points), its own next point counts
181
+ as level, so the series is followed rather than a neighbor's point.
182
+ */ export function nextTarget(targets, current, direction) {
183
+ if (!current) return targets[0] ?? null;
184
+ const horizontal = direction === "left" || direction === "right";
185
+ const sign = direction === "right" || direction === "down" ? 1 : -1;
186
+ const across = horizontal ? "y" : "x";
187
+ const alongSeries = current.pointIndex !== undefined && seriesAxis(current.node) === (horizontal ? "x" : "y");
188
+ let cone = null, coneScore = Infinity;
189
+ let plane = null, planeScore = Infinity;
190
+ for (const t of targets){
191
+ if (t.id === current.id) continue;
192
+ const dx = t.center[0] - current.center[0], dy = t.center[1] - current.center[1];
193
+ const ahead = sign * (horizontal ? dx : dy);
194
+ if (ahead <= 0.5) continue;
195
+ const level = alongSeries && t.node === current.node || overlap(t.box, current.box, across) > 0;
196
+ const side = level ? 0 : Math.abs(horizontal ? dy : dx);
197
+ if (side <= ahead && ahead + 2 * side < coneScore) {
198
+ cone = t;
199
+ coneScore = ahead + 2 * side;
200
+ }
201
+ const dist = Math.hypot(dx, dy);
202
+ if (dist < planeScore) {
203
+ plane = t;
204
+ planeScore = dist;
205
+ }
206
+ }
207
+ return cone ?? plane ?? current;
208
+ }
@@ -0,0 +1,74 @@
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
+ */ /** Whether a Back history entry records a legend click. */ export function isLegendEntry(entry) {
6
+ return entry.kind === "legend";
7
+ }
8
+ /** The newest drill-down entry on a Back history, skipping legend entries. */ export function latestDrillEntry(history) {
9
+ if (!history) return undefined;
10
+ for(let i = history.length - 1; i >= 0; i--){
11
+ const entry = history[i];
12
+ if (!isLegendEntry(entry)) return entry;
13
+ }
14
+ return undefined;
15
+ }
16
+ /** Removes and returns the newest drill-down entry, leaving the legend entries around it in place. */ export function removeLatestDrillEntry(history) {
17
+ const entry = latestDrillEntry(history);
18
+ if (entry) history.splice(history.lastIndexOf(entry), 1);
19
+ return entry;
20
+ }
21
+ /** Whether two legend id lists hold the same ids, in any order. */ export function sameLegendIds(a, b) {
22
+ return a.length === b.length && a.every((id)=>b.includes(id));
23
+ }
24
+ /** The chart's current legend hide/solo state, as a Back history entry. */ export function legendSnapshot(viz) {
25
+ return {
26
+ kind: "legend",
27
+ hidden: [
28
+ ...viz._hidden
29
+ ],
30
+ solo: [
31
+ ...viz._solo
32
+ ]
33
+ };
34
+ }
35
+ /**
36
+ Records a legend click on the Back history: pushes `before` (the state
37
+ the click started from) when the click changed what is hidden or solo'd
38
+ and `legendHistory` is on. Returns whether it pushed.
39
+ */ export function recordLegendChange(viz, before) {
40
+ if (!viz.schema.legendHistory) return false;
41
+ if (sameLegendIds(before.hidden, viz._hidden) && sameLegendIds(before.solo, viz._solo)) return false;
42
+ (viz._history ??= []).push(before);
43
+ return true;
44
+ }
45
+ /** Puts back the legend state a history entry recorded. */ export function restoreLegendEntry(viz, entry) {
46
+ viz._hidden = [
47
+ ...entry.hidden
48
+ ];
49
+ viz._solo = [
50
+ ...entry.solo
51
+ ];
52
+ }
53
+ /**
54
+ Clears the legend's hide/solo state for a drill to a deeper level, whose
55
+ legend lists other groups, and returns the state it cleared for the
56
+ drill's history entry (undefined when nothing was hidden or solo'd).
57
+ */ export function takeLegendState(viz) {
58
+ if (!viz._hidden.length && !viz._solo.length) return undefined;
59
+ const state = {
60
+ hidden: viz._hidden,
61
+ solo: viz._solo
62
+ };
63
+ viz._hidden = [];
64
+ viz._solo = [];
65
+ return state;
66
+ }
67
+ /**
68
+ Drops the legend's steps from the Back history: every legend entry, and
69
+ the legend state drill-down entries would put back. The drill-downs stay.
70
+ */ export function dropLegendHistory(viz) {
71
+ if (!viz._history) return;
72
+ viz._history = viz._history.filter((e)=>!isLegendEntry(e));
73
+ for (const entry of viz._history)delete entry.legend;
74
+ }