@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
@@ -44,6 +44,7 @@ declare const fields: {
44
44
  coerce: "const";
45
45
  };
46
46
  dataCutoff: {};
47
+ dataFormat: {};
47
48
  dataPollingInterval: {
48
49
  onSet: (viz: VizInstance) => void;
49
50
  };
@@ -63,9 +64,27 @@ declare const fields: {
63
64
  hiddenOpacity: {
64
65
  coerce: "const";
65
66
  };
67
+ hoverDistance: {
68
+ default: number;
69
+ };
70
+ keyboardNav: {
71
+ default: boolean;
72
+ onSet: (viz: VizInstance, value: unknown) => void;
73
+ };
74
+ keyboardNavConfig: {
75
+ merge: true;
76
+ default: {
77
+ padding: number;
78
+ strokeWidth: number;
79
+ };
80
+ };
66
81
  label: {
67
82
  coerce: "const";
68
83
  };
84
+ labelPosition: {
85
+ coerce: "const";
86
+ default: string;
87
+ };
69
88
  legend: {
70
89
  coerce: "const";
71
90
  };
@@ -75,6 +94,9 @@ declare const fields: {
75
94
  legendFilterInvert: {
76
95
  coerce: "const";
77
96
  };
97
+ legendHistory: {
98
+ default: boolean;
99
+ };
78
100
  legendInset: {};
79
101
  legendInsetConfig: {
80
102
  merge: true;
@@ -110,6 +132,15 @@ declare const fields: {
110
132
  coerce: "const";
111
133
  };
112
134
  noDataMessage: {};
135
+ pointLabelConfig: {
136
+ merge: true;
137
+ default: {
138
+ fontMin: number;
139
+ fontSize: number;
140
+ padding: number;
141
+ };
142
+ };
143
+ reducedMotion: {};
113
144
  saveControl: {};
114
145
  saveControlClassName: {};
115
146
  saveControlConfig: {
@@ -159,6 +190,7 @@ declare const fields: {
159
190
  tableViewDownload: {};
160
191
  tableViewPageSize: {};
161
192
  tableViewSort: {};
193
+ theme: {};
162
194
  thresholdName: {
163
195
  coerce: "const";
164
196
  };
@@ -2,7 +2,8 @@ import type Viz from "./Viz.js";
2
2
  /**
3
3
  Draws the visualization given the specified configuration.
4
4
  @param viz The Viz instance to render.
5
- @param callback Optional callback invoked after rendering completes.
5
+ @param callback Optional callback invoked after rendering completes, and
6
+ after every later render that doesn't pass one of its own.
6
7
  @private
7
8
  */
8
9
  export declare function vizRender(viz: Viz, callback?: () => void): Viz;
@@ -0,0 +1,40 @@
1
+ /**
2
+ Resolves a chart's `theme` once per draw and hands it to the chart's
3
+ components, and paints a forced theme's background into the scene.
4
+
5
+ @module
6
+ */
7
+ import type { PathNode, RectNode, SceneNode } from "@d3plus/render";
8
+ import type { ResolvedTheme, ThemeOverlayTokens } from "../../utils/theme.js";
9
+ import { unwatchPageTheme } from "./pageTheme.js";
10
+ export { unwatchPageTheme };
11
+ import type { VizInstance } from "./vizTypes.js";
12
+ /**
13
+ Resolves the chart's theme for this draw onto `viz._theme` and its
14
+ components, and keeps an `"auto"` chart watching its page for a flip
15
+ between light and dark (a forced theme stops watching).
16
+ */
17
+ export declare function applyVizTheme(viz: VizInstance): ResolvedTheme;
18
+ type BackgroundTarget = Pick<VizInstance, "_theme" | "schema"> & Partial<Pick<VizInstance, "_margin" | "_ssr" | "_tileGroup">>;
19
+ /**
20
+ The scene node a forced theme paints behind the chart, if it has one: a
21
+ rect over the whole chart, framing (not covering) a Geomap's basemap.
22
+ */
23
+ export declare function themeBackgroundNode(viz: BackgroundTarget): RectNode | PathNode | undefined;
24
+ /** The forced theme's background rect, as the scene's first children. */
25
+ export declare function themeBackground(viz: BackgroundTarget): SceneNode[];
26
+ /**
27
+ The `color-scheme` the chart's overlays use, so their native controls
28
+ (buttons, the search input, the download menu) match the theme: the
29
+ theme's own when forced or dark, and the page's otherwise.
30
+ */
31
+ export declare function themeColorScheme(theme: ResolvedTheme | undefined): string;
32
+ /** Sets the chart's overlay host's `color-scheme` (see `themeColorScheme`). */
33
+ export declare function applyOverlayColorScheme(viz: Pick<VizInstance, "_theme" | "_sceneRenderer">): void;
34
+ /**
35
+ An overlay style with each entry still at its built-in default swapped for
36
+ the theme's overlay color: `keys` maps a CSS property to the overlay token
37
+ it takes, and `format` wraps a token (`1px solid …`). Light charts keep
38
+ the built-in style (see `themed`).
39
+ */
40
+ export declare function themeOverlayStyle<T extends Record<string, unknown>>(viz: Pick<VizInstance, "_theme">, style: T, defaults: Record<string, unknown>, keys: Record<string, (overlay: ThemeOverlayTokens) => string>): T;
@@ -21,6 +21,7 @@
21
21
  @module
22
22
  */
23
23
  import type { PlotZoomBase, ZoomState } from "../Plot/plotZoom.js";
24
+ import type { GestureHoverState, ZoomGesture } from "../drawSteps/zoomGesture.js";
24
25
  import type { TrendFit, TrendLineType } from "../Plot/trendLines.js";
25
26
  import type { SwarmState } from "../Plot/swarm.js";
26
27
  import type { ShapeEmitter } from "../features/shapeEmit.js";
@@ -31,8 +32,12 @@ import type { AxisHoverState } from "../Plot/axisHover.js";
31
32
  import type { ZoomControlIconKey } from "../drawSteps/zoomControlsMarkup.js";
32
33
  import type { BottomRightBox } from "../drawSteps/bottomRightControlsMarkup.js";
33
34
  import type { ZoomTransform } from "d3-zoom";
35
+ import type { KeyboardNavState } from "./keyboardNav.js";
36
+ import type { KeyboardGesture } from "./keyboardNavHost.js";
37
+ import type { NearestHoverState } from "./nearestHover.js";
38
+ import type { ResolvedTheme } from "../../utils/theme.js";
34
39
  import type { DataPoint } from "@d3plus/data";
35
- import type { ClipShape, Scene, SceneNode, Transform, TransitionRect } from "@d3plus/render";
40
+ import type { ClipShape, Scene, SceneEvent, SceneNode, Transform, TransitionRect } from "@d3plus/render";
36
41
  import type { Axis, ColorScale, Legend, Message, SizeLegend, TextBox, Timeline, Tooltip } from "../../components/index.js";
37
42
  import type { SizeLegendScale } from "../../components/SizeLegend/sizeLegendLayout.js";
38
43
  import type { InsetKey, InsetPlacement, InsetRegion } from "../features/insetState.js";
@@ -56,15 +61,29 @@ export interface Padding {
56
61
  left: number;
57
62
  right: number;
58
63
  }
59
- /** One entry on the drill-down history stack (`Viz._history`), pushed by a click.shape drill-down and popped by Back. */
64
+ /** A drill-down entry on the Back history (`Viz._history`), pushed by a click.shape drill-down or a partition zoom and popped by Back. */
60
65
  export interface DrillDownHistoryEntry {
66
+ kind?: "drill";
61
67
  depth: number;
62
68
  filter?: (d: DataPoint, i: number) => boolean;
63
69
  /** `groupBy[groupDepth]`'s value for the clicked node — identifies the reunion node the Back morph grows back into. */
64
70
  groupId?: unknown;
65
71
  /** The groupBy index `groupId` was read at (== `_drawDepth` when the node was clicked). */
66
72
  groupDepth?: number;
73
+ /** The legend's hide/solo state a drill to a deeper level cleared, which Back puts back. */
74
+ legend?: LegendState;
67
75
  }
76
+ /** The legend's hide/solo state: the legend ids hidden, and the ones shown alone. */
77
+ export interface LegendState {
78
+ hidden: (string | number)[];
79
+ solo: (string | number)[];
80
+ }
81
+ /** A legend entry on the Back history (`Viz._history`): the legend's hide/solo state before a legend click changed it. */
82
+ export interface LegendHistoryEntry extends LegendState {
83
+ kind: "legend";
84
+ }
85
+ /** One entry on the Back history (`Viz._history`). */
86
+ export type HistoryEntry = DrillDownHistoryEntry | LegendHistoryEntry;
68
87
  /**
69
88
  D3-style selection — deliberately loose. d3-selection's element/datum
70
89
  generics are invariant, so a single typed alias can't accept every
@@ -139,6 +158,17 @@ export interface VizInstance {
139
158
  passes such rows without running `filter` on them again.
140
159
  */
141
160
  _filterApplied?: (d: DataPoint) => boolean;
161
+ /**
162
+ Shapes whose rows the pipeline keeps one by one instead of merging the
163
+ rows that share a group (Hexbin's observations, which it bins).
164
+ */
165
+ _unmergedShapes?: string[];
166
+ /**
167
+ The rows the colorScale lays out from, for a chart whose colored marks
168
+ aren't its rows (Hexbin's bins). The chart's rows rolled up by group
169
+ when unset.
170
+ */
171
+ _colorScaleRows?: () => DataPoint[];
142
172
  _timeFilter?: (d: DataPoint, i: number) => boolean;
143
173
  _groupBy: ((d: DataPoint, i: number) => DataPoint[keyof DataPoint])[];
144
174
  _depth?: number;
@@ -168,6 +198,11 @@ export interface VizInstance {
168
198
  _x2Config?: Record<string, unknown>;
169
199
  _y2Config?: Record<string, unknown>;
170
200
  _backgroundConfig?: Record<string, unknown>;
201
+ /**
202
+ Whether a chart other than a Plot can name every series along it, so
203
+ its default legend may stand aside (see `Plot/alongLegend.ts`).
204
+ */
205
+ _alongLabelsPossible?: (viz: VizInstance) => boolean;
171
206
  _chartScene?: SceneNode[];
172
207
  /** The whole scene last painted (chart, legend, colorScale, chrome). */
173
208
  _paintedScene?: Scene;
@@ -196,6 +231,17 @@ export interface VizInstance {
196
231
  returns false to fall back to picture zoom (Plot rescales its axes).
197
232
  */
198
233
  _zoomRescale?: (t: ZoomState, duration?: number) => boolean;
234
+ /** Chart-specific handling of zoom gestures (Geomap turns a globe on a drag). */
235
+ _zoomGesture?: ZoomGesture;
236
+ /** The zoom gesture holding off tooltips and hover, while one is in progress. */
237
+ _gestureHover?: GestureHoverState;
238
+ /** Whether a globe drag is turning the map (Geomap skips refitting meanwhile). */
239
+ _globeDragging?: boolean;
240
+ /** The rotation a Geomap globe had before it was first dragged, with its projection. */
241
+ _globeHome?: {
242
+ projection: unknown;
243
+ rotate: number[];
244
+ };
199
245
  /** Cleanup functions returned by `zoomControlIcons`' mount functions, keyed by button. */
200
246
  _zoomIconCleanup?: Partial<Record<ZoomControlIconKey, () => void>>;
201
247
  /** Cleanup function returned by an `attributionIcon` mount function. */
@@ -205,6 +251,12 @@ export interface VizInstance {
205
251
  _duration: number;
206
252
  _renderer?: "svg" | "canvas";
207
253
  _focus?: string | number | undefined;
254
+ /**
255
+ Runs when a click lands on no mark, given its point on the chart's
256
+ surface (see `routePointerEvent`): a Network or ArcDiagram clears its
257
+ focus there.
258
+ */
259
+ _backgroundClick?: (point: [number, number]) => void;
208
260
  _active?: ((d: DataPoint, i?: number) => boolean) | false;
209
261
  _hover?: ((d: DataPoint, i?: number) => boolean) | false;
210
262
  /** True while the current hover came from a colorScale bucket swatch. */
@@ -231,6 +283,10 @@ export interface VizInstance {
231
283
  _hoverDatum?: DataPoint | null;
232
284
  /** Epoch ms until which an animated transition is in flight (pointer routing pauses). */
233
285
  _transitionEndsAt?: number;
286
+ /** Keyboard navigation's host element and focused mark (see `keyboardNav.ts`). */
287
+ _keyboardNav?: KeyboardNavState;
288
+ /** A chart's own keys, taken before mark navigation (Geomap's globe keys). */
289
+ _keyboardGesture?: KeyboardGesture;
234
290
  _userHover?: number;
235
291
  _userDuration?: number;
236
292
  _brushing?: boolean;
@@ -257,8 +313,8 @@ export interface VizInstance {
257
313
  _trailSeq?: number;
258
314
  /** The user-set data, retained to detect changes across `.data()` calls. */
259
315
  _userData?: DataPoint[] | string;
260
- /** Drill-down history stack (back button). */
261
- _history?: DrillDownHistoryEntry[];
316
+ /** The Back history: drill-downs and legend clicks, newest last. */
317
+ _history?: HistoryEntry[];
262
318
  /**
263
319
  The local, chart-family-defined "body rect" flip-morph fractions are
264
320
  measured against — e.g. Treemap/Pack's margin-adjusted chart area at
@@ -418,6 +474,8 @@ export interface VizInstance {
418
474
  _stackOffset?: (series: number[][][], order: number[]) => void;
419
475
  /** d3-stack order: an accessor, or an explicit array of series keys. */
420
476
  _stackOrder?: ((series: number[][][]) => number[]) | unknown[];
477
+ /** The series of the last stacked draw in reading order, which the default legend follows (see `Plot/stackLegendOrder.ts`). */
478
+ _stackLegendOrder?: string[];
421
479
  /** The `confidence` bounds as `[lower, upper]` accessors (either may be `false`), or `false` when off. */
422
480
  _confidence?: [
423
481
  ConfidenceAccessor | false,
@@ -429,7 +487,6 @@ export interface VizInstance {
429
487
  _groupPadding?: number;
430
488
  _annotations?: Record<string, unknown>[];
431
489
  _axisPersist?: boolean;
432
- _labelPosition?: (d: DataPoint, i: number) => "auto" | "inside" | "outside";
433
490
  _labelConnectorConfig?: Record<string, unknown>;
434
491
  _lineMarkerConfig?: Record<string, unknown>;
435
492
  _confidenceConfig?: Record<string, unknown>;
@@ -511,6 +568,16 @@ export interface VizInstance {
511
568
  _legendDepth?: number;
512
569
  /** The color category each legend entry stands for, when the legend is labelled by color rather than groupBy. */
513
570
  _legendCategories?: WeakMap<DataPoint, string>;
571
+ /** The legend setting the chart starts with, which along labels may hide (see `Plot/alongLegend.ts`). */
572
+ _defaultLegend?: unknown;
573
+ /** Whether this draw hides the default legend for along labels. */
574
+ _alongLegendHide?: boolean;
575
+ /** This draw's along label counts (see `Plot/alongLegend.ts`). */
576
+ _alongStats?: {
577
+ series: number;
578
+ requested: number;
579
+ placed: number;
580
+ };
514
581
  _colorScalePosition?: (config: VizInstance) => string | false;
515
582
  _colorScale?: false | string | ((d: DataPoint, i: number) => string);
516
583
  _timeline?: boolean;
@@ -530,8 +597,10 @@ export interface VizInstance {
530
597
  _zoomSet?: boolean;
531
598
  /** Whether a Geomap's themed basemap resolved dark on the latest draw. */
532
599
  _basemapDark?: boolean;
533
- /** Whether a Geomap is watching its backdrop for theme changes. */
534
- _themeWatch?: boolean;
600
+ /** The chart's theme, resolved on its latest draw (see `applyVizTheme`). */
601
+ _theme?: ResolvedTheme;
602
+ /** Stops the `"auto"` theme's page watcher, while one is installed. */
603
+ _themeWatch?: () => void;
535
604
  /** The attribution d3plus last set from the tile URL (vs. a user-set one). */
536
605
  _tileAttribution?: string | false;
537
606
  /** Whether a compact (ⓘ) attribution was clicked open. */
@@ -560,6 +629,12 @@ export interface VizInstance {
560
629
  /** Plot's paint phase: builds `_chartScene` from the measured context. */
561
630
  _paint?(pCtx: PlotPaintContext): VizInstance;
562
631
  _drawSceneToTarget(durationOverride?: number): void;
632
+ /** Whether a painted node is a point mark nearest-point hover resolves to (see `hoverDistance`). */
633
+ _pointMark?(node: SceneNode): boolean;
634
+ /** Nearest-point hover's cached diagrams and resolved mark (see `nearestHover.ts`). */
635
+ _nearestHover?: NearestHoverState;
636
+ /** Routes a renderer pointer event (or a replayed one) to the chart's handlers. */
637
+ _routeSceneEvent?(event: SceneEvent): void;
563
638
  _scheduleSceneRepaint(): void;
564
639
  _sceneRepaintRAF?: number;
565
640
  _thresholdLegend?(legendData: DataPoint[]): DataPoint[];
@@ -571,6 +646,8 @@ export interface VizInstance {
571
646
  }): SizeLegendScale | null;
572
647
  /** The region chart chrome may be drawn inside, with the chart's marks as obstacles (see `ChartDefinition.insetRegion`). */
573
648
  _insetRegion?(): InsetRegion | null;
649
+ /** The table view's rows in place of the chart's data (see `ChartDefinition.tableData`). */
650
+ _tableData?(): DataPoint[] | null;
574
651
  /** The shape a colorScale row draws as (see `ChartDefinition.colorScaleShape`). */
575
652
  _colorScaleShape?(d: DataPoint, i: number): string;
576
653
  /** The chart's small-multiple hooks (see `ChartDefinition.facet`). */
@@ -32,3 +32,9 @@ export declare function vizReload(viz: Viz): void;
32
32
  @private
33
33
  */
34
34
  export declare function syncUnloadObserver(viz: Viz): void;
35
+ /**
36
+ Stops a chart's visibility, resize, and scroll polling and its visibility
37
+ observers, so a destroyed chart leaves no timer or listener holding it.
38
+ @private
39
+ */
40
+ export declare function stopVisibilityWatch(viz: Viz): void;
@@ -11,6 +11,7 @@ import type { D3Scale } from "../../utils/index.js";
11
11
  Creates an SVG scale based on an array of data.
12
12
  */
13
13
  export default class Axis extends BaseClass {
14
+ static readonly _displayName: string;
14
15
  [key: string]: any;
15
16
  _select: D3Selection;
16
17
  _data: unknown[];
@@ -3,6 +3,7 @@ import { default as Axis } from "./Axis.js";
3
3
  Axis preset whose ticks are drawn below the horizontal domain path. Accepts everything the base Axis class does.
4
4
  */
5
5
  export default class AxisBottom extends Axis {
6
+ static readonly _displayName: string;
6
7
  /**
7
8
  Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
8
9
  @private
@@ -3,6 +3,7 @@ import { default as Axis } from "./Axis.js";
3
3
  Axis preset whose ticks are drawn to the left of the vertical domain path. Accepts everything the base Axis class does.
4
4
  */
5
5
  export default class AxisLeft extends Axis {
6
+ static readonly _displayName: string;
6
7
  /**
7
8
  Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
8
9
  @private
@@ -3,6 +3,7 @@ import { default as Axis } from "./Axis.js";
3
3
  Axis preset whose ticks are drawn to the right of the vertical domain path. Accepts everything the base Axis class does.
4
4
  */
5
5
  export default class AxisRight extends Axis {
6
+ static readonly _displayName: string;
6
7
  /**
7
8
  Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
8
9
  @private
@@ -3,6 +3,7 @@ import { default as Axis } from "./Axis.js";
3
3
  Axis preset whose ticks are drawn above the horizontal domain path. Accepts everything the base Axis class does.
4
4
  */
5
5
  export default class AxisTop extends Axis {
6
+ static readonly _displayName: string;
6
7
  /**
7
8
  Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
8
9
  @private
@@ -44,6 +44,8 @@ export interface BreakStyle {
44
44
  }
45
45
  /** Reads the glyph settings from one of an axis's break configs. */
46
46
  export declare function breakStyle(axis: Axis, key?: "breakConfig" | "baselineBreakConfig"): BreakStyle;
47
+ /** Reads break glyph settings from a break config object (see `breakStyle`). */
48
+ export declare function breakStyleOf(config: unknown): BreakStyle;
47
49
  /** Reads the baseline break's glyph settings (`baselineBreakConfig`). */
48
50
  export declare const baselineBreakStyle: (axis: Axis) => BreakStyle;
49
51
  /**
@@ -0,0 +1,25 @@
1
+ import type Axis from "./Axis.js";
2
+ /**
3
+ Replaces a time axis's scale with a broken time scale when it has
4
+ `rangeBreaks`, and adds each marked gap inside the domain to
5
+ `axis._breaks`. Marked gaps take `breakConfig.space` pixels each.
6
+ */
7
+ export declare function applyAxisRangeBreaks(axis: Axis): void;
8
+ /** Drops the values a broken time axis hides (from its ticks or labels). */
9
+ export declare function visibleTimeValues(axis: Axis, values: unknown[]): unknown[];
10
+ /**
11
+ The day a broken time axis's tick opens: when the tick is the first
12
+ shown time of its day (everything from midnight up to it hidden, such
13
+ as by an `hours` rule), that day's midnight, so the tick can be labeled
14
+ as the day it starts. Otherwise `undefined`.
15
+ */
16
+ export declare function rangeBreakOpenedDay(axis: Axis, value: unknown): Date | undefined;
17
+ /** The distinct days (as midnights, ascending) of a list of dates. */
18
+ export declare function datesDays(dates: Date[]): Date[];
19
+ /**
20
+ The day label for a broken time axis's ticks: given a tick that opens
21
+ its day (see `rangeBreakOpenedDay`), the day, labeled among the axis's
22
+ days in the current default time locale; given any other tick,
23
+ `undefined`. The day formatter is built once per set of axis dates.
24
+ */
25
+ export declare function rangeBreakDayLabel(axis: Axis): (value: unknown) => string | undefined;
@@ -0,0 +1,51 @@
1
+ import type { D3Scale } from "../../utils/index.js";
2
+ import { type RangeBreakRule, type TimeGap } from "./rangeBreaks.js";
3
+ /** Options for `brokenTimeScale`. */
4
+ export interface BrokenTimeScaleOptions {
5
+ /** Read the rules' calendar in UTC instead of local time. */
6
+ utc?: boolean;
7
+ /** Pixels each marked gap inside the domain occupies (default 0). */
8
+ space?: number;
9
+ }
10
+ /** A hidden stretch inside the scale's domain, with the pixels it occupies. */
11
+ export interface ScaleTimeGap extends TimeGap {
12
+ /** Pixels the gap occupies: `space` for a marked gap, else 0. */
13
+ space: number;
14
+ }
15
+ /** A continuous time scale whose mapping skips hidden time. */
16
+ export interface BrokenTimeScale extends D3Scale {
17
+ /** The rules the scale hides time by. */
18
+ rangeBreaks: RangeBreakRule[];
19
+ /** The hidden stretches inside the domain, clipped to it, ascending. */
20
+ gaps(): ScaleTimeGap[];
21
+ /** Whether a time is hidden. */
22
+ isHidden(t: number | Date): boolean;
23
+ /** The visible time (ms) between two times, signed like `b - a`. */
24
+ visible(a: number | Date, b: number | Date): number;
25
+ /** The time `ms` of visible time after (or, when negative, before) `t`. */
26
+ offset(t: number | Date, ms: number): Date;
27
+ /** A d3 time tick format for the scale's domain. */
28
+ tickFormat(count?: number, specifier?: string): (d: Date) => string;
29
+ }
30
+ /** Whether `scale` is a broken time scale. */
31
+ export declare const isBrokenTimeScale: (scale: unknown) => scale is BrokenTimeScale;
32
+ /**
33
+ The time between `a` and `b` on `scale` (`b - a`, in ms): on a broken
34
+ time scale, only the time it shows.
35
+ */
36
+ export declare const scaleTimeStep: (scale: unknown, a: number | Date, b: number | Date) => number;
37
+ /**
38
+ The time `ms` after `t` (before it, when negative) on `scale`: on a
39
+ broken time scale, stepping over the time it hides.
40
+ */
41
+ export declare const scaleTimeShift: (scale: unknown, t: number | Date, ms: number) => Date;
42
+ /**
43
+ Builds a time scale that hides the time `rules` describe. It reads like
44
+ d3's `scaleTime` — `domain`, `range`, `ticks`, `tickFormat`, `invert`,
45
+ and `copy` — but visible time shares one pixel rate and hidden time
46
+ takes none (or a marked gap's `space`). A hidden time maps to where its
47
+ gap sits; a pixel at a closed gap inverts to the time after it. Times
48
+ past the domain extrapolate through the rules' gaps, so a scale can be
49
+ padded or zoomed out.
50
+ */
51
+ export declare function brokenTimeScale(rules: RangeBreakRule[], options?: BrokenTimeScaleOptions): BrokenTimeScale;
@@ -0,0 +1,82 @@
1
+ /** A time value a rule reads: a Date, a timestamp, or a date string. */
2
+ export type RangeBreakTime = Date | number | string;
3
+ /**
4
+ One stretch of time a time axis hides:
5
+
6
+ - `"weekends"`: every Saturday and Sunday.
7
+ - `{days: [6, 0]}`: every day of the week listed (0 is Sunday, 6 is Saturday).
8
+ - `{hours: [17, 9]}`: the same hours of every day, from the first hour to
9
+ the second (fractions are minutes, so `9.5` is 9:30); a start after the
10
+ end wraps past midnight, so `[17, 9]` hides 5pm to 9am.
11
+ - `{values: [date, …]}`: each listed date's whole day, such as holidays.
12
+ - `{bounds: [start, end]}`: one explicit range, from `start` up to `end`.
13
+
14
+ An object rule's `marker` draws the axis's break marker where its time
15
+ was removed, leaving a short gap there. It defaults to `true` for
16
+ `bounds` and `false` for the others, which recur too often to mark.
17
+ */
18
+ export type RangeBreakRule = "weekends" | {
19
+ days: number[];
20
+ marker?: boolean;
21
+ } | {
22
+ hours: [number, number];
23
+ marker?: boolean;
24
+ } | {
25
+ values: RangeBreakTime[];
26
+ marker?: boolean;
27
+ } | {
28
+ bounds: [RangeBreakTime, RangeBreakTime];
29
+ marker?: boolean;
30
+ };
31
+ /** A hidden stretch of time, from `start` (hidden) up to `end` (shown), in ms. */
32
+ export interface TimeGap {
33
+ start: number;
34
+ end: number;
35
+ /** Whether the gap draws a break marker. */
36
+ marker: boolean;
37
+ }
38
+ /** A rule value read as a timestamp, or `NaN` when it doesn't parse. */
39
+ export declare function rangeBreakTime(value: unknown): number;
40
+ /** Whether `rule` is a rule a time axis can read. */
41
+ export declare function isRangeBreakRule(rule: unknown): rule is RangeBreakRule;
42
+ /**
43
+ Reads a `rangeBreaks` setting — one rule, a list of them, or a falsy
44
+ value — into the list of rules a time axis can use, dropping any it
45
+ can't read.
46
+ */
47
+ export declare function normalizeRangeBreaks(input: unknown): RangeBreakRule[];
48
+ /** Whether a rule draws a break marker (see `RangeBreakRule`). */
49
+ export declare const ruleMarker: (rule: RangeBreakRule) => boolean;
50
+ /**
51
+ The stretches of time `rules` hide that overlap `[lo, hi]`: sorted,
52
+ with overlapping and touching gaps merged (a merged gap draws a marker
53
+ when any of its rules does). Gaps are not clipped to `[lo, hi]`.
54
+ @param utc Read the calendar in UTC instead of local time.
55
+ */
56
+ export declare function rangeBreakGaps(rules: RangeBreakRule[], lo: number, hi: number, utc?: boolean): TimeGap[];
57
+ /** The last gap starting at or before `t` (gaps sorted by start), or -1. */
58
+ export declare function gapIndex(gaps: TimeGap[], t: number): number;
59
+ /**
60
+ A test for whether a time between `lo` and `hi` is hidden by `rules`:
61
+ the gaps are found once, so the test is cheap to run over many values.
62
+ A time outside `[lo, hi]` is tested on its own.
63
+ */
64
+ export declare function rangeBreakTest(rules: RangeBreakRule[], lo: number, hi: number, utc?: boolean): (t: number | Date) => boolean;
65
+ /** Whether `rules` hide the time `t`. */
66
+ export declare function isHiddenTime(rules: RangeBreakRule[], t: number | Date, utc?: boolean): boolean;
67
+ /**
68
+ The visible time between `a` and `b` (in ms, `a <= b`): their distance
69
+ less every hidden stretch between them.
70
+ */
71
+ export declare function visibleBetween(rules: RangeBreakRule[], a: number, b: number, utc?: boolean): number;
72
+ /**
73
+ Whether `rules` hide all of time: a week (plus a day for DST) with no
74
+ visible moment, which repeating rules then repeat forever.
75
+ */
76
+ export declare function hidesAllTime(rules: RangeBreakRule[], utc?: boolean): boolean;
77
+ /**
78
+ The time `ms` of visible time after `t` (or before it, when `ms` is
79
+ negative), stepping over every hidden stretch on the way. Rules that
80
+ hide all of time leave `t` where it is.
81
+ */
82
+ export declare function offsetVisible(rules: RangeBreakRule[], t: number, ms: number, utc?: boolean): number;
@@ -33,7 +33,7 @@ export declare function axisTimeDomain(axis: Axis): Date[];
33
33
  */
34
34
  export declare function axisTimeLocale(axis: Axis): TimeLocaleDefinition;
35
35
  /**
36
- The ordered Dates a time axis picks its label interval from: its parsed `data`, else its domain.
36
+ The ordered Dates a time axis picks its label interval from: its parsed `data`, else the labels its scale offers (when two or more), else its domain.
37
37
  @private
38
38
  */
39
39
  export declare function axisTimeReference(axis: Axis): Date[];
@@ -13,6 +13,7 @@ import type { ColorScaleBarGeometry } from "./colorScaleHoverMark.js";
13
13
  Creates an SVG color scale based on an array of data.
14
14
  */
15
15
  export default class ColorScale extends BaseClass {
16
+ static readonly _displayName: string;
16
17
  [key: string]: any;
17
18
  _select: D3Selection;
18
19
  _axisClass: Axis;
@@ -3,10 +3,24 @@
3
3
  significant digits so float noise (`0.1 + 0.2`) doesn't count.
4
4
  */
5
5
  export declare function decimalPlaces(value: number): number;
6
+ /** The number of significant digits `value` is written with, at 15 digits. */
7
+ export declare function significantDigits(value: number): number;
8
+ /**
9
+ The decimal places bucket labels step at: the most any value is written
10
+ with. A computed value (a mean such as `1 / 3`) carries float precision
11
+ no label should step at, so its own places count only to the data's
12
+ display precision: three significant digits of the values' span. A value
13
+ within float noise of zero (`-1.4e-14`) counts as zero.
14
+ */
15
+ export declare function labelPlaces(allValues: number[]): number;
16
+ /** `value` rounded to the places bucket labels step at (see `labelPlaces`). */
17
+ export declare function labelValue(value: number, allValues: number[]): number;
6
18
  /**
7
19
  The `[lower, upper]` values a ColorScale label shows for the bucket
8
20
  `[ticks[i], ticks[i + 1])`: the first and last values the data's own
9
- precision can write inside it, so integer data reads "1 - 2", "3 - 4".
21
+ precision (see `labelPlaces`) can write inside it, so integer data reads
22
+ "1 - 2", "3 - 4", and computed values such as means don't step at float
23
+ precision (a bucket ending at 0 reads "-9.5 - -0.1", not "-9.5 - -1f").
10
24
  When `format` prints the upper bound the same as the next bucket's lower
11
25
  one (an abbreviation like "1.5k"), the upper bound drops a decimal place
12
26
  at a time until it reads differently ("1.49k").
@@ -8,6 +8,7 @@ import { BaseClass } from "../../utils/index.js";
8
8
  Creates an SVG legend based on an array of data.
9
9
  */
10
10
  export default class Legend extends BaseClass {
11
+ static readonly _displayName: string;
11
12
  [key: string]: any;
12
13
  _titleClass: TextBox;
13
14
  _data: DataPoint[];
@@ -41,6 +41,7 @@ new SizeLegend()
41
41
  .render();
42
42
  */
43
43
  export default class SizeLegend extends BaseClass {
44
+ static readonly _displayName: string;
44
45
  [key: string]: any;
45
46
  _layout: SizeLegendLayout;
46
47
  /** Drops values whose circles would outgrow this radius; set by a zoomed chart. */
@@ -7,6 +7,7 @@ import type { TextBoxDatum } from "./textBoxLayout.js";
7
7
  Creates a wrapped text box for each point in an array of data.
8
8
  */
9
9
  export default class TextBox extends BaseClass {
10
+ static readonly _displayName: string;
10
11
  [key: string]: any;
11
12
  _select: D3Selection;
12
13
  _data: DataPoint[];
@@ -6,6 +6,7 @@ import { Axis, TextBox } from "../index.js";
6
6
  Creates an interactive timeline brush component for selecting time periods within a visualization.
7
7
  */
8
8
  export default class Timeline extends Axis {
9
+ static readonly _displayName: string;
9
10
  _buttonBehaviorCurrent: string;
10
11
  _hiddenHandles: boolean;
11
12
  _playButtonClass: TextBox;
@@ -5,6 +5,11 @@ import type Timeline from "./Timeline.js";
5
5
  selections, defaults and playback run from earliest to latest.
6
6
  */
7
7
  export declare function byValue<T>(values: T[]): T[];
8
+ /**
9
+ The brush overlay's cursor: `brushCursor`, or what it returns when given
10
+ the presentation drawn (`"ticks"` or `"buttons"`).
11
+ */
12
+ export declare function brushOverlayCursor(tl: Timeline): string | null;
8
13
  /**
9
14
  Sets the Timeline-specific defaults that override the inherited Axis config,
10
15
  mirroring the original constructor body exactly.